Skip to main content
Adaptive Planning
Last Updated: 2025-11-14
Reference: Log Messages for Planning Dimension Loaders

Reference: Log Messages for Planning Dimension Loaders

The Planning Dimension Loader requests are limited to updating a maximum of 10,000 dimension values in a hierarchical dimension, or 40,000 dimension values in a flat dimension. These limits do not apply to creation of new dimension values within a loader request.

Details

The Planning Dimension Loader logs the create, update, error, and warning messages generated during a load.
Each line item in the log contains a maximum of 100 dimension value entries. Hovering an item in the log shows the updated or created items. You can download the full log of the load as a spreadsheet by clicking Planning Dimension Loader - Log - Export Logs.
Best Practice: Download your logs if you need them at a later date. They remain available up to 1 week following a loader run.
Details for Import Dimension Values
This message provides a URL you can use to retrieve a zipped XML file of the full updateDimensions API response to your loader run.
Planning Dimension Loader Details for Import Dimension Values
When you visit the URL, you end up on a page that describes the file and lets you download it. Downloads are deleted after 7 days.
The Zip download contains the XML of the full response.
<?xml version='1.0' encoding='UTF-8'?> <response success="true"> <messages> <message type="INFO">Dimension was saved successfully.</message> </messages> <output> <dimensions> <dimension id="4" name="CountryRegion" shortName="" autoCreate="0" listDimension="0" keepSorted="0" useOnLevels="0" status=""> <dimensionValue id="132" name="Venezuela" shortName="VEN" description="Land of the Anaconda" status="updated" /> </dimension> </dimensions> </output> </response>
Create/Update Message
These messages appear for successful creation or update of dimension values.
Example Create/Update Message
The following dimension values were updated Product A3, Product A1, Product A2.
Warning Message
These messages appear for list dimensions when the loader encounters attribute values in the source that are not found in
Adaptive Planning
. The Planning Dimension Loader does not automatically create attribute values.
Example Warning
The following values were not recognized for attribute Color: Mauve
Error Message
These messages appear when the loader encounters a dimension value in the source that already exists in
Adaptive Planning
.
Example Error
Following Source Dimension values have duplicate name: 2,3

Error and Warning Message Descriptions

Type
Message
Example/Description
Error
Internal error.
An error occurred in the system.
Error
System dimensions cannot be updated via API.
Only custom dimensions can be updated.
Error
Id "{0}" does not exist.
Id "456" does not exist. The id indicated does not match any id in the system.
Error
{0} "{1}" must be an integer value within the range {2} (inclusive) to {3} (inclusive).
Dimension id "-3" must be an integer value within range from 1 (inclusive) to 2,147,483,647 (inclusive).
Error
The {0} "{1}" cannot be more than {2} characters long.
The dimension name "more-than-5-chars" is too long. It cannot be more than X characters in length.
Error
The {0} can not be empty.
The dimension name can not be empty.
Error
A dimension with the name "{0}" already exists.
A dimension with the name "Product" already exists.
Error
The "{0}" is too long. It cannot be more than {0} characters long.
The short name "more-than-5-chars" is too long. It cannot be more than 5 characters in length.
Error
A dimension with id "{0}" does not exist.
A dimension with id "123" does not exist." The id indicated for a dimension does not match any id of a dimension in the system.
Error
{0} "{1}" must be an integer value within the range {2} (inclusive) to {3} (inclusive).
Dimension value id "-3" must be an integer value within range from 1 (inclusive) to 2,147,483,647 (inclusive).
Error
The {0} "{1}" cannot be more than {2} characters long.
The dimension value name "more-than-5-chars" is too long. It cannot be more than X characters in length.
Error
"{0}" is NOT allowed as name.
"This" is not allowed as a name. "This" is a reserved word that cannot be used as a name. Applies to dimension value names only.
Error
The {0} can not be empty.
The dimension value name cannot be empty.
Error
A dimension value with the name "{0}" already exists.
Dimension value names must be unique within a dimension.
Error
"{0}" is duplicated for IDs {1}.
"Computers 2A" is duplicated for IDs 50, 69.
Error
Found {0} new entities in the payload with value "{1}".
Found 2 new entities in the payload with value "Computers".
Error
Missing Dimension/Dimension value in provided input.
No dimension or dimension value was defined.
Error
Illegal Input. Input data must be an XML document.
The input was not XML.
Error
A dimension value cannot be its own parent.
A dimension value referred to itself as a parent.
Error
Parent node "{0}" is becoming the child of its current direct/indirect child node "{1}".
Parent node "2" is becoming child of its current direct/indirect child node "3". A parent is set to become the child of itself or one of its children.
Error
Invalid {0} "{1}".
Invalid dimension name "foo(+)". Invalid dimension name "foo(-)." + and - are invalid characters for a dimension name.
Error
Invalid {0} "{1}".
Invalid dimension value name "foo(+)". Invalid dimension value name "foo(-)." + and - are invalid characters for a dimension value name.
Warning
Both useOnLevels and listDimension cannot be "1" at the same time.
List dimensions cannot have parents.
Warning
Invalid "autoCreate" value "x". The value must be "1" or "0".
Illegal values for fixed-value properties (e.g. listDimension="1999") leaves the property unchanged and generates a warning.
Warning
Invalid "listDimension" value "w". The value must be "1" or "0".
Illegal dimension names and dimension value names (length restrictions and character restrictions) are warnings and leaves the element's property unchanged
Warning
Invalid "keepSorted" value "z". The value must be "1" or "0".
Attempting to change a listDimension or useOnLevels setting to an illegal combination will be a warning and leaves the flag unchanged.
Warning
Invalid "useOnLevels" value "y". The value must be "1" or "0".
Attempting to create an invalid version visibility combination (stating allVersions=true but then specifying versions) is a warning and will ignore the conflicting "visible" setting, and will respect the allVersions setting.
Warning
A list dimension value cannot have parents.
List dimensions are not hierarchical and should not have parents.
Warning
A dimension value name cannot be the same as its dimension name.
Dimension values cannot have the same name as their dimension.
Warning
The {0} "{1}" cannot be more than {2} characters long.
The dimension value short name "more-than-5-chars" is too long. It cannot be more than 5 characters in length.
Warning
The provided dimension attribute {0} is not associated with the dimension {1}.
An attribute was provided in the input, but that attribute is not associated with the indicated dimension.
Warning
Planning Loader is in a Status of Warning.
This message occurs when the dimensions are missing mappings.