Skip to main content
Documentation
Documentation
Adaptive Planning
Last Updated: 2023-06-23
Reference: Log Messages for Planning Level Loaders

Reference: Log Messages for Planning Level Loaders

Details

The Planning Level Loader logs create, update, error, and warning messages generated during a load.
Each line item in the log contains a maximum of 100 Level entries. Hovering an item in the log shows the updated or created items. Click Planning Dimension Loader - Log - Export Logsto download the full log as a spreadsheet.
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 Levels
This message provides a URL you can use to download a zipped XML file of the updateLevels API response to your loader run.
Planning Level Loader Log URL Message
When you visit the URL, you go to a page with a description of the file and a link to download it. Downloads are deleted from your instance after seven day
The zip download contains the XML of the full response.

<?xml version='1.0' encoding='UTF-8'?>
<response success="true">
  <messages>
    <message type="INFO">Level was saved successfully.</message>
  </messages>
  <output>
    <levels deleteWorkflowSilently="0" deleteActualsSilently="0">
      <level id="1" name="Total Company" currency="USD" shortName="TotalCo" eliminationLevel="1" eliminationTradingPartner="0" inWorkflow="1" proceedWithWarnings="0" status="">
        <level id="201" name="Company A (100% owned)" currency="USD" shortName="Co.A" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="">
          <level id="164" name="Operations" currency="USD" shortName="Ops" eliminationLevel="1" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="">
            <level id="165" name="United States" currency="USD" shortName="US" eliminationLevel="0" eliminationTradingPartner="1" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="">
              <level id="166" name="Sales - North" currency="USD" shortName="Sales-N" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="" />
              <level id="167" name="Sales - South" currency="USD" shortName="Sales-S" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="">
                <level id="321" name="Sales - South East" currency="USD" shortName="Sales-S" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="" />
                <level id="322" name="Sales - South West" currency="USD" shortName="Sales-S" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="0" proceedWithWarnings="1" status="" />
              </level>
            </level>
          </level>
        </level>
      </level>
    </levels>
  </output>
</response>
Create or Update Message
Example Create or Update Message

Level was saved successfully.
Warning Message
The messages appear for levels when the loader encounters attributes in the source that are not found in . The Planning Level Loader does not automatically create attributes. To avoid this message, make sure the attributes already exist.
Example Warning

The following attributes were not recognized for the level HQ: Color
Error Message
These messages appear when the loader encounters a level in the source that already exists in .
Example Error

Following Source Level values have duplicate names: 1,8

Error and Warning Message Descriptions

Type
Message
Description
Error
Internal error.
An error occurred in your instance.
Error
System dimensions cannot be updated via API.
Only custom dimensions can be updated.
Error
Id "{0}" does not exist.
The ID "456" does not exist. The id indicated does not match any ID in your instance.
Error
{0} "{1}" must be an integer value within the range {2} (inclusive) to {3} (inclusive).
The 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 "a very long name" is too long. It cannot be more than
N
 characters in length.
Error
The {0} can not be empty.
The dimension name cannot be empty.
Error
A dimension with the name "{0}" already exists.
The dimension Product already exists in your instance.
Error
The "{0}" is too long. It cannot be more than {0} characters long.
The short name "a very long name" 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 for a dimension does not match any ID of a dimension in your instance.
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 a reserved word and cannot be used as a name.
Error
The {0} can not be empty.
The dimension value name must have a value.
Error
A dimension value with the name "{0}" already exists.
Dimension value names must be unique within a dimension.
Error
A dimension value with the name "{0}" already exists in the Planning instance for the dimension value ID {0}.
A dimension value"Computers" already exists in the instance for the dimension value ID "317".
Error
A dimension value with the name "{0}" exists in the payload {0} times.
A dimension value "Computers" was found twice in the payload.
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 is 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 set to become the child of its current direct or indirect child node "3". A parent is set to become the child of itself or one of its children.
Error
Invalid {0} "{1}".
The dimension name "foo(+)" contains the reserved character "+" and is invalid. + 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.
Error
The level "{0}" is duplicated in the payload or already exists in the systems with ID "{1}".
Multiple new levels contain the same name, ensure there is only one record {0}.
or
Levels rolling up to the top level have a value in the
Rolls up To
 field. Specify a blank value in the "Rolls up To" field for this record.
Warning
Both use OnLevels 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".
Values other than 1 or 0 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".
Dimension names and dimension value names that are too long generate warnings and leaves the element's property unchanged
Warning
Invalid "keepSorted" value "z". The value must be "1" or "0".
An attempt to change a listDimension or useOnLevels setting to an illegal combination generates a warning and leaves the flag unchanged.
Warning
Invalid "useOnLevels" value "y". The value must be "1" or "0".
An attempt to create an invalid version visibility combination (stating allVersions=true but then specifying versions) generates 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 "a very long phrase" 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. That attribute is not associated with the indicated dimension. Verify what attributes are associated with the dimension.