Reference: Log Messages for Planning Dimension Loaders

The Planning Dimension Loader requests are limited to updating a maximum of 10000 dimension values in a hierarchical dimension, or 40000 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

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.

When you visit the URL, you end up on a page that describes the file and lets you download it. Downloads are deleted after seven 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 . 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 .
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.