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
.
.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 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 inAdaptive 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 inAdaptive 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. |