updateLevels

HTTP	Beschreibung
Method	Post
Content-Type	text/xml

Beispiel für Locken


curl -H "Content-Type: text/xml" -d @C:/temp/updateLevels.xml -X POST https://api.adaptiveplanning.com/api/v19

updateLevels.xml contents

Anforderungsformat

<?xml version='1.0' encoding='UTF-8'?>
<call method="updateLevels" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd"/>
<levels>
<level id="1" name="HQ">
 <level id="2" name="Engineering" currency="USD" shortName="Engr">
   <level id="8" name="Development" currency="USD" shortName="Dev" inWorkflow="0"/>
   <level id="9" name="QA" currency="INR" eliminationTradingPartner="1"/>
   <level id="10" name="Documentation" currency="PKR" shortName="Doc" actualsStart="05/2013" actualsEnd="12/2018" inWorkflow="1" propagateToDescendants="1">
      <version name="Budget 2011" available="1"/>
      <version name="Budget 2012" available="0"/>
      <version name="Budget 2013" available="1"/>
   </level>
 </level>
 <level id="3" name="Professional Services" currency="USD" shortName="Prof.Srv" eliminationLevel="1">
     <attribute name="Corporate Discount" value="Available"/>
     <attribute name="Transfers Restricted" value="Yes"/>
     <dimension name="Region" value="C-US"/>
 </level>
</level>
</levels>
</call>

Bei großen Nutzlasten können Sie zusammengefasste XML-Dateien (gezippt) hochladen. Siehe: Massenaktualisierung von Metadaten.

Die folgenden Bedingungen gelten für updateLevels:

Ebenen werden für die Aktualisierung über ihre interne ID-Nummer identifiziert.

Um neue Ebenen zu erstellen, geben Sie diesen eine leere oder fehlende ID-Eigenschaft.

Sie können ein vorhandenes (nicht neues) Element verschieben, sodass es zu einem untergeordneten Element eines neuen Elements wird. Dadurch wird das neue Element erstellt und das vorhandene Element wird als untergeordnetes Element darunter verschoben.

Tabellenblattverfügbarkeit und Benutzerzugriff können nicht über aktualisiert werden

updateLevels

.

Anforderungsformat für das Erstellen einer neuen Ebene

Um eine neue Ebene zu erstellen, fügen Sie die übergeordnete Ebene anhand der ID ein. Beispiel: Um eine neue untergeordnete Ebene hinzuzufügen

Engr

Wert, der hat

id 7

können Sie Folgendes verwenden:

<?xml version='1.0' encoding='UTF-8'?>
<call method="updateLevels" callerName="Steve C">
 <credentials login="stevec@greenco.com" password="password"/>
 <levels>
   <level id="7">
     <level id="" name="Documentation" description="docs" shortName="" >
     </level>
   </level>
 </levels>
</call>

Diese Methode ändert nichts an der Ebene

id 7

. Es wird ein neues untergeordnetes Element mit dem Namen erstellt

Documnentation

für

id 7

. Alle nicht erwähnten untergeordneten Elemente von

Engr

an das Ende der untergeordneten Liste verschoben. Dies entspricht „Übergeordnete Ebene festlegen“ für die neue Ebene.

Eingabeformat 1: Nutzlast enthält gesamten Baum

Die updateLevels-API funktioniert am besten, wenn ein Aufrufer den neuen Baumstatus bereitstellen möchte, ohne sich um Änderungen sorgen zu müssen.

Die updateLevels API ermittelt Änderungen in der Ebenenstruktur und nur die neu hinzugefügten oder geänderten Ebenen werden aktualisiert. Beachten Sie, dass die

levels

-Element enthält nur 1 direktes untergeordnetes Element

level

-Element. Dieses untergeordnete Element enthält dann den Rest der Hierarchie.

<?xml version="1.0" encoding="UTF-8"?>
<call method="updateLevels" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd" />
<levels>
   <level id="1" name="HQ">
      <level id="2" name="Engineering" currency="USD" shortName="Engr">
         <level id="8" name="Development" currency="USD" shortName="Dev" inWorkflow="0" />
         <level id="9" name="QA" currency="INR" eliminationTradingPartner="1" />
         <level id="10" name="Documentation" currency="PKR" shortName="Doc" actualsStart="05/2013" actualsEnd="12/2018" inWorkflow="1" propagateToDescendants="1" />
      </level>
      <level id="3" name="Professional Services" currency="USD" shortName="Prof.Srv" eliminationLevel="1" />
   </level>
</levels>
</call>

Eingabeformat 2: Nutzlast enthält Ebenenunterbaumstruktur

Dieses Format unterstützt Anwendungsfälle, in denen Änderungen nur auf einen Teil der Ebenenbaumstruktur beschränkt sind.

Änderungen erfolgen beispielsweise auf der Engineering-Ebene. Wiederum die

levels

-Element enthält nur 1 direktes untergeordnetes Element

level

-Element. Diese Ebene enthält die restlichen Ebenen der Unterbaumstruktur. Der kleinste Unterbaum für dieses Format enthält nur einen übergeordneten Baum und einen untergeordneten Baum.

<?xml version="1.0" encoding="UTF-8"?>
<call method="updateLevels" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd" />
<levels>
   <level id="2" name="Engineering" currency="USD" shortName="Engr">
      <level id="8" name="Development" currency="USD" shortName="Dev" inWorkflow="0" />
      <level id="9" name="QA" currency="INR" eliminationTradingPartner="1" />
      <level id="10" name="Documentation" currency="PKR" shortName="Doc" actualsStart="05/2013" actualsEnd="12/2018" inWorkflow="1" propagateToDescendants="1" />
   </level>
</levels>
</call>

Eingabeformat 3: Einzelne Ebene aktualisieren

Dieses Format unterstützt die Behandlung des Anwendungsfalls, wenn Änderungen auf nur eine Ebene beschränkt sind. Die

levels

-Element enthält nur 1 direktes untergeordnetes Element

level

-Element.

Verwenden Sie beim Aktualisieren einer einzelnen Ebene nur das Eingabeformat 3. Eingabeformat 3 ist nicht das bevorzugte Format für die Aktualisierung mehrerer Ebenen. Sie können mit diesem Format keine neue Ebene erstellen. Verwenden Sie das Eingabeformat 2, um neue untergeordnete Ebenen hinzuzufügen.

<?xml version="1.0" encoding="UTF-8"?>
<call method="updateLevels" callerName="a string that identifies your client application">
<credentials login="sampleuser@company.com" password="my_pwd" />
<levels>
   <level id="10" name="Documentation" currency="PKR" shortName="Doc" actualsStart="05/2013" actualsEnd="12/2018" inWorkflow="1" propagateToDescendants="1" />
</levels>
</call>

Eingabeformat 4: Flaches Format mit allen Ebenen-Tags unter dem Ebenen-Tag

Dieses Format enthält

level

Tags unter

levels

-Tag in einem flachen Format ohne Hierarchie Sie aktualisieren nur die Eigenschaften jeder aufgeführten Ebene, ohne die Ebenenhierarchien zu ändern.

Verwenden Sie das flache Format nur für Deltas oder inkrementelle Änderungen für sehr kleine Teile der Hierarchie. Eingabeformat 1 bietet die beste Performance beim Laden der gesamten Ebenenhierarchie.

<?xml version="1.0" encoding="UTF-8"?>
<call method="updateLevels" callerName="a string that identifies your client application">
<credentials login="steve@steveco.com" password="" />
<levels>
   <level id="2" name="Engineering" currency="USD" shortName="Engr" />
   <level id="8" name="Development" currency="USD" shortName="Dev" inWorkflow="0" />
   <level id="9" name="QA" currency="INR" eliminationTradingPartner="1" />
   <level id="10" name="Documentation" currency="PKR" shortName="Doc" actualsStart="05/2013" actualsEnd="12/2018" inWorkflow="1" propagateToDescendants="1">
      <version name="Budget 2011" available="1" />
      <version name="Budget 2012" available="0" />
      <version name="Budget 2013" available="1" />
   </level>
</levels>
</call>

Verarbeitung mehrerer Umbenennungen in einem einzigen updateLevels-Aufruf

Zwischendurch können mehrere Umbenennungen derselben Entität in einem Remote-System stattfinden

updateLevels

-Anrufe. Die Namen von Entitäten im Remote-System können durch dieselben Entitäts-IDs ersetzt werden. Wann

updateLevels

-Aufrufe erfolgen nach dem Namenstausch

updateLevels

aufrufen verwaltet diese Änderungen, indem die IDs bei Namensänderungen verfolgt werden. Der Aufruf kann auch die Einführung einer neuen ID verarbeiten, die einen vorhandenen Namen verwendet.

Damit jedes der Beispiele erfolgreich ist, muss der vollständige Tausch der IDs mit den eindeutigen Werten erfolgen.

Beispiel 1: Ein einfacher Namenstausch im Remote-System.


ID     Unique Value   New Unique Value
1      AA             BB
2      BB             AA

Beispiel 2: Eine Sequenz von drei Umbenennungen im Remote-System.


ID     Unique Value   New Unique Value
1      AA             BB
2      BB             CC
3      CC             AA

Beispiel 3: Eine neue Entität, die einen vorhandenen eindeutigen Wert verwendet.


ID     Unique Value   New Unique Value
4                     AA
1      AA             BB
2      BB             Old BB

Element „Zugangsdaten“.
Tag-Name		-Zugangsdaten
Beschreibung		Alle API-Aufrufe müssen ein einzelnes Element mit den Zugangsdaten enthalten, um den Benutzer zu identifizieren, der die API aufruft. Der API-Aufruf wird dann als dieser Benutzer ausgeführt (jeder Audit-Trail oder jede Aktionshistorie im System zeigt, dass dieser Benutzer die Aktion ausgeführt hat). Daher muss der Benutzer über die erforderlichen Berechtigungen zum Ausführen der Aktion verfügen, damit der API-Aufruf ausgeführt werden kann erfolgreich ist.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
login	J	Der Anmeldename des Benutzers, der die API-Methode aufruft. Dieser Benutzer muss über die erforderlichen Berechtigungen zum Aufrufen der Methode verfügen.	sampleuser@company.com
Kennwort	J	Das Kennwort des Benutzers, der die API-Methode aufruft.	my_password
Gebietsschema	N	Geben Sie das Gebietsschema an, das verwendet werden soll, um eingehende Zahlen und Datumsangaben zu interpretieren und ausgehende Zahlen und Datumsangaben zu formatieren (mit dem entsprechenden Tausendertrennzeichen, den Monatsnamen und der Datumsformatierung). Das Gebietsschema wird auch verwendet, um die Sprache anzugeben, in der Systemmeldungen in der Antwort angezeigt werden sollen. Wenn nicht angegeben, wird en_US (amerikanisches Englisch) verwendet.	fr_FR
instanceCode	N	Wenn der in den Zugangsdaten angegebene Benutzer Zugriff auf mehr als eine Instanz von Adaptive Planning hat, kann dieses Attribut verwendet werden, um anzugeben, dass der Benutzer auf eine andere Instanz als seine Standardinstanz zugreifen möchte. Wenn nicht angegeben, wird die Standardinstanz des Benutzers verwendet. Verwenden Sie die exportInstances-API, um die verfügbaren Instanzcodes zu ermitteln.	MYINSTANCE1
Inhalt des Elements
(Keine)

Element „Ebenen“.
Tag-Name		Ebene(n)
Beschreibung		Pro Nutzlast ist nur eine Anforderung von Ebenenelement zulässig. Es enthält ein oder mehrere Ebenenelemente.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
retainExisitingOrder Verfügbar in API v26 und höher	N	RetainExistingOrder = "1" gibt an, dass die updateLevels API die Reihenfolge der Elemente in der XML-Nutzlast ignorieren soll und die vorhandene definierte Reihenfolge beibehalten wird. RetainExistingOrder = "0" gibt an, dass die updateLevels API die Reihenfolge der Elemente basierend auf der Tag-Position relativ zu anderen gleichgeordneten Elementen in der XML-Nutzlast aktualisieren soll. Das Attribut „retainExistingOrder“ wird in der API-Version vor API v26 ignoriert. Der Standardwert für RetainExistingOrder ist für Version 26 „0“. Für die API-Version v27 und höher ist der Standardwert für „retainExistingOrder“ „1“.	1
displayNameEnabled Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	displayNameEnabled=1 gibt an, dass updateLevels die Eigenschaften des Anzeigenamens von berücksichtigen soll code , displayNameType und description wenn Enable Anzeige Name für die Instanz EIN ist. displayNameEnabled=0 gibt an, dass die updateLevels API weiterhin den API-Vertrag vor v30 einhalten soll, auch wenn "Anzeigenamen aktivieren" für die Instanz auf EIN gesetzt ist. Die updateLevels API ignoriert die Eigenschaften des Anzeigenamens code , displayNameType und description . Der Standardwert für displayNameEnabled ist „0“.	1
Inhalt des Elements
Enthält ein oder mehrere Ebenenelemente.

Ebenenelement
Tag-Name		level
Beschreibung		Gibt eine zu erstellende Ebene an.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
id	J	Die ID der zu aktualisierenden Ebene.	34
-Code Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	Der eindeutige Code der Ebene. Diese Eigenschaft ist nur verfügbar, wenn "Anzeigename aktivieren" für die Instanz auf EIN gesetzt ist.	NewLevelName
Name	N	Der Name der Ebene. Wenn Anzeigename aktivieren für eine Instanz mit API v30 oder höher auf EIN gesetzt ist, lässt der Name doppelte Werte zu. Wenn Anzeigename aktivieren für eine Instanz auf AUS gesetzt ist, ist Code nicht verfügbar und der Name muss eindeutig sein.	NewLevelName
shortName aktualisiert in API v30	N	Anzeigbarer Titel der Spalte, wie im Tabellenblatt angezeigt.	NewLevelShortName
Währung	N	Der Währungscode für die Währung, die dieser Ebene der Organisation zugewiesen ist. Die Währung ist eine der konfigurierten Währungen für die Instanz, die im Aufruf exportActiveCurrencies gefunden wurde.	USD
publishCurrency Verfügbar in API v24 und höher	N	Veröffentlichungswährung legt beim Veröffentlichen eines Finanzplans die Währung des Workday-Unternehmens fest. Die Veröffentlichungswährung wird über den Planning-Ebenen-Loader in Workday Adaptive Planning Integration als zusätzliches Währungsattribut für eine Ebene geladen. PublishCurrency gibt eine der konfigurierten Währungen für die Instanz an, die im Aufruf exportActiveCurrencies und in der Ebenenverwaltung gefunden wurden. Nur verfügbar, wenn Sie Adaptive Planning für Workday einrichten. Weitere Informationen finden Sie im Abschnitt Pläne veröffentlichen unter Schritte: Adaptive Planning für HCM und Financials konfigurieren.	CAD
inWorkflow	N	Gibt an, ob diese Ebene an einem Workflow teilnimmt.	1
propagateToDescendants	N	Gibt an, ob Änderungen an untergeordnete Ebenen dieser Ebene weitergegeben werden. 0 für „Nein“ und „1“ für „Ja“. Nicht alle Ebeneneigenschaften werden von propagateToDescendants abgedeckt. Eine Liste der Eigenschaften, die von betroffen sind propagateToDescendants , siehe propagateToDescendants-Verhalten bei UpdateLevels-Anforderungen.	0
eliminationLevel	N	Gibt an, ob diese Ebene eine Eliminierungsebene für Intercompany-Eliminierungen ist. Eine Ebene kann eine Eliminierungsebene oder ein Eliminierungshandelspartner sein, aber nicht beides.	1
eliminationTradingPartner	N	Gibt an, ob diese Ebene ein Eliminierungshandelspartner ist. Eine Ebene kann entweder ein Eliminierungshandelspartner oder eine Eliminierungsebene sein, aber nicht beides.	0
actualsStart	N	Gibt den Beginn der Istzahlen für diese Ebene an. Muss ein vorhandener Zeitcode aus der Zeitverwaltung in der Standardzeitschicht sein.	May-2013
actualsEnd	N	Gibt das Ende der Istzahlen für diese Ebene an. Muss ein vorhandener Zeitcode aus der Zeitverwaltung in der Standardzeitschicht sein.	Dec-2018
Beschreibung Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	Die Beschreibung der Ebene. Diese Eigenschaft ist nur verfügbar, wenn "Anzeigename aktivieren" für die Instanz auf EIN gesetzt ist.	Die oberste Abteilung.
Inhalt des Elements
Ein oder mehrere Attributelemente, wenn Sie ein oder mehrere Ebenenattribute festlegen möchten, die der Ebene zugeordnet sind.

-Versionselement
Tag-Name		Version
Beschreibung		Gibt die Versionsverfügbarkeit einer Ebene an. Erfordert eine vorhandene Version.
Attribute des Elements
Name des Attributs	erforderlich?		Beispiel
Name	J	Der Name der Version, wie er in der Versionsverwaltung angezeigt wird.	Budget 2015
verfügbar	J	Wenn 1, ist diese Version in dieser Ebene verfügbar.	1
Inhalt des Elements
Ein oder mehrere Versionselemente für jede Ebene

Attributelement
Tag-Name		Attribut
Beschreibung		Gibt ein zu aktualisierendes Attribut an.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
Name aktualisiert in API v30	J	Der Name des Attributs.	Standort
Wert aktualisiert in API v34	J	Der Attributwert für dieses Attribut. Für API v32 und v33 ist dieses Attribut nur sinnvoll, wenn die Einstellung „Anzeigename“ für die Instanz auf „AUS“ gesetzt ist. Für API v34 und höher: Wird unterstützt, wenn die Einstellung Effektiver Anzeigename auf EIN gesetzt ist. Das Vorhandensein von valueCode und valueName führt zu einem Fehler. Wenn Ebenenimport automatisch Attributwerte erstellt in der Benutzeroberfläche für die Attributeverwaltung aktiviert ist, wird die Wertezeichenfolge zum Code und Namen, wenn der Wert noch nicht vorhanden ist. Setzen Sie value="", um dieses Attribut-Tagging zu entfernen.	170
valueCode Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	J	Der Code des Attributwerts für dieses Attribut. Die Eingabe valueCode ist nur sinnvoll, wenn displayNameEnabled=1 und die Einstellung Anzeigename für die Instanz in API v32 und API v33 auf EIN gesetzt ist. Setzen Sie valueCode="", um dieses Attribut-Tagging zu entfernen.	SFO
valueName Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	N	Das AttributwertName ist nur in folgenden Fällen sinnvoll: valueCode enthält einen nicht vorhandenen Attributwert. Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1 API v32 und API v33 werden aufgerufen. valueName wird ignoriert, wenn valueCode einen vorhandenen Attributwert enthält.	San Francisco
Inhalt des Elements
(Keine)

Dimensionselement
Tag-Name		Dimension
Beschreibung		Gibt die Zuweisungen der Ebenendimensionswerte an.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
Name aktualisiert in API v30	J	Der Name der Dimension.	Budget 2015
Wert aktualisiert in API v34	J	Der Dimensionswert für diese Dimension, der in dieser Ebene verfügbar ist. Für API v32 und API v33 ist der Wert nur sinnvoll, wenn die Einstellung „Anzeigename“ für die Instanz auf „AUS“ gesetzt ist. Für API v34 und höher: Wird unterstützt, wenn die Einstellung Effektiver Anzeigename auf EIN gesetzt ist. Das Vorhandensein von valueCode und valueName führt zu einem Fehler. Wenn Datenimport automatisch Dimensionswerte erstellt in der Verwaltungsoberfläche für Dimensionen aktiviert ist, wird die Wertezeichenfolge zum Code und zum Namen, wenn der Wert noch nicht vorhanden ist.	Lahore
valueCode Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	J	Der Code des Dimensionswerts für diese Dimension, der in dieser Ebene verfügbar ist. Für API v32 und API v33 ist valueCode nur in folgenden Fällen sinnvoll: Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1	LHE
valueName Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	N	Der Name für einen neu automatisch erstellten Dimensionswert. Für API v32 und API v33 ist valueName nur in folgenden Fällen sinnvoll valueCode enthält einen nicht vorhandenen Dimensionswert. Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1	Lahore
Inhalt des Elements
(Keine)

Verarbeitung der Nutzlast von oben nach unten

Attribute für Ebenen gruppieren Werte logisch und taggen Ebenen. Da die updateLevels API die XML-Nutzlast von oben nach unten verarbeitet, weisen Sie der übergeordneten Ebene ein Ebenenattribut zu, bevor Sie die Ebenenwerte des untergeordneten Attributs ändern. Untergeordnete Ebenen können mit einem beliebigen Attributwert getaggt werden, wenn der Attributwert der übergeordneten Ebene leer ist. Wenn Ebenenattribute nicht am übergeordneten Attribut ausgerichtet werden können, tritt ein Kompatibilitätsvalidierungsfehler auf.

Beachten Sie die Baumstruktur unten, in der das übergeordnete Element „Kalifornien“ zwei untergeordnete Ebenen hat: „Palo Auszahlung“ und „Pleasanton“. Die Ebenenattribute „Palo Auszahlung“ und „Pleasanton“ sind gleichgeordnet.


Location
|__USA                              
|__California
   |__Palo Alto
   |__Pleasanton

Beispiel für ursprüngliche Anforderungs-XML mit Ebenenattributen

Beachten Sie, dass der Standortattributwert „Palo Auszahlung“ sowohl „Engineering“ als auch „Entwicklung“ zugewiesen ist.


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <attribute name="Location" value="" />
   <level id="2" name="Engineering">
      <attribute name="Location" value="Palo Alto" />
      <level id="8" name="Development">
         <attribute name="Location" value="Palo Alto" />
      </level>
   </level>  
</level>
</levels>

Beispiel für falsche Reihenfolge bei Nutzlastverarbeitung

Die folgende XML-Nutzlast generiert den folgenden Fehler:

The attribute value Pleasanton is not compatible with the parent's attribute value

". Bei der Verarbeitung der Nutzlast von oben nach unten wird davon ausgegangen, dass die übergeordnete Ebene „Engineering“ den Standortattributwert „Palo Auszahlung“ aus dem vorherigen Codeblock hat und verarbeitet „Pleasanton“ als untergeordnetes Element von „Palo Alternativ“. Der Fehler wird generiert, weil die untergeordnete Ebene „Entwicklung“ nur das Standortattribut „Palo-Alto“ haben kann, wie in der Baumstruktur angegeben.


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <level id="2" name="Engineering">
      <level id="8" name="Development">
         <attribute name="Location" value="Pleasanton" />
      </level>
      <attribute name="Location" value="California" /> <!-- Level Attribute change ignored due to placement order-->
   </level>
   <attribute name="Location" value="" />
</level>
</levels>

Beispiel für gültige Reihenfolge bei Nutzlastverarbeitung

Wenn Sie die Platzierungsreihenfolge des Attributs „Kalifornien“ unter „Engineering“ neu anordnen, kann die API zuerst das Attribut der übergeordneten Ebene verarbeiten, sodass die untergeordnete Ebene „Entwicklung“ den Attributwert „Palo Saldo“ oder „Pleasanton“ haben kann. .


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <attribute name="Location" value="" /> <!-- Level Attribute change processed due to correct placement order-->
   <level id="2" name="Engineering">
      <attribute name="Location" value="California" />
      <level id="8" name="Development">
         <attribute name="Location" value="Pleasanton" />
      </level>
   </level>
</level>
</levels>

Die Versionsverfügbarkeit einer Ebene funktioniert genauso. Legen Sie die Versionsverfügbarkeit einer Ebene fest, bevor Sie die untergeordneten Ebenen ändern, um Kompatibilitätsfehler zu vermeiden.

Beispiel für ursprünglichen Anforderungs-XML mit Versionen

Beachten Sie, dass die Verfügbarkeit der Version „Budget 2020“ für die Ebenen „Engineering“ und „Entwicklung“ auf „0“ gesetzt ist.


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <version name="Budget 2020" available="0" />
   <level id="2" name="Engineering">
      <version name="Budget 2020" available="0" />
      <level id="8" name="Development">
         <version name="Budget 2020" available="0" />
      </level>
   </level>
</level>
</levels>

Beispiel für falsche Reihenfolge bei Nutzlastverarbeitung

Die folgende XML-Nutzlast generiert einen Fehler, da bei der Verarbeitung der Nutzlast von oben nach unten das übergeordnete Element "Engineering" als nicht verfügbar angesehen wird ("

available=0")

für die Version „Budget 2020“ aus dem vorherigen Codeblock und verarbeitet die Verfügbarkeit der untergeordneten Ebene „Entwicklung“ als „1“. Die untergeordnete Ebene "Entwicklung" kann nicht verfügbar sein, wenn die übergeordnete Ebene "Engineering" nicht verfügbar ist.


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <level id="2" name="Engineering">
      <level id="8" name="Development">
         <version name="Budget 2020" available="1" />
      </level>
      <version name="Budget 2020" available="1" /><!-- Parent version availability change ignored due to placement order-->
   </level>
   <version name="Budget 2020" available="1" />
</level>
</levels>

Beispiel für gültige Reihenfolge bei Nutzlastverarbeitung

Wenn Sie die Platzierungsreihenfolge für die Version „Budget 2020“ unter der übergeordneten Ebene „Engineering“ neu anordnen, kann die API zuerst die übergeordnete Verfügbarkeit verarbeiten, sodass „Entwicklung“ den Versionsverfügbarkeitswert „1“ oder „0“ haben kann.


<levels deleteWorkflowSilently="0" deleteActualsSilently="0">
<level id="1" name="HQ" proceedWithWarnings="0">
   <version name="Budget 2020" available="1" />
   <level id="2" name="Engineering"><!-- Parent Version availability change processed due to correct placement order-->
      <version name="Budget 2020" available="1" />
      <level id="8" name="Development">
         <version name="Budget 2020" available="1" />
      </level>
   </level>
</level>
</levels>

Antwortformat


<?xml version='1.0' encoding='UTF-8'?>
<response success="true">
<output>
<levels>
  <level id="1" name="HQ" currency="CAD" shortName="" eliminationLevel="1" eliminationTradingPartner="0" inWorkflow="0" status="">
    <level id="2" name="Engineering" currency="USD" shortName="Engr" eliminationLevel="0" eliminationTradingPartner="1" inWorkflow="0" status="updated">
      <level id="8" name="Development" currency="USD" shortName="Dev" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="0" status="updated" />
      <level id="9" name="QA" currency="INR" shortName="" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="0" status="updated" />
      <level id="10" name="Documentation" currency="PKR" shortName="Doc" eliminationLevel="0" eliminationTradingPartner="0" inWorkflow="1" propagateToDescendants="1" actualsStart="05/2013" actualsEnd="12/2018" status="updated">
        <version name="Budget 2011" available="1" status="" />
        <version name="Budget 2012" available="0" status="updated" />
        <version name="Budget 2013" available="1" status="" />
      </level>
    </level>
    <level id="3" name="Professional Services" currency="USD" shortName="Prof.Srv" eliminationLevel="1" eliminationTradingPartner="0" inWorkflow="0" status="updated">
      <attribute name="Corporate Discount" value="Available" status="" />
      <attribute name="Transfers Restricted" value="Yes" status="" />
      <dimension name="Region" value="C-US" status="" />
    </level>
  </level>
</levels>
</output>
</response>

Ausgabeelement
Tag-Name	Ausgabe
Attribute des Elements
(Keine)
Inhalt des Elements
Ein einzelnes erforderliches Ebenenelement. Dieser Ausgabe-Wraper ist ein Standard für alle API-Antworten und schließt die gültige Ausgabe jedes erfolgreichen API-Aufrufs ein.

Element „Ebenen“.
Tag-Name		Ebene(n)
Beschreibung		Container für ein oder mehrere Ebenenelemente.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
BeibehaltenVorhandener Beschluss	N	0 updateLevels API sollte die Sortierreihenfolge basierend auf dem Inhalt der XML-Nutzlast aktualisieren. Eine updateLevels API sollte die vorhandene Sortierreihenfolge beibehalten.	1
displayNameEnabled Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	displayNameEnabled=1 gibt an, dass updateLevels die Eigenschaften des Anzeigenamens von berücksichtigen soll code , displayNameType und description wenn Enable Anzeige Name für die Instanz EIN ist.	1
Inhalt des Elements
Ein oder mehrere Ebenenelemente. Wenn die Anforderung unzugängliche Ebenen enthält, gibt es nur ein Ebenenelement, das die oberste Ebene der Organisation darstellt.

Ebenenelement
Tag-Name		level
Beschreibung		Stellt eine einzelne Organisationsebene dar, die in der Antwort auf einen updateLevels-API-Aufruf zurückgegeben wird.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
id	J	Die interne System-ID der Ebene.	7
-Code Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	Der eindeutige Code der Ebene. Diese Eigenschaft ist nur verfügbar, wenn "Anzeigename aktivieren" für die Instanz auf EIN gesetzt ist.	HQ
Name	J	Der Name der Ebene, wie er in Berichten und Tabellenblättern angezeigt wird.	Entwicklung
Währung	J	Der Währungscode für die Währung, die dieser Ebene der Organisation zugewiesen ist. Die Währung ist eine der konfigurierten Währungen für die Instanz, die im Aufruf exportActiveCurrencies gefunden wurde.	INR
publishCurrency Verfügbar in API v24 und höher	N	Veröffentlichungswährung legt beim Veröffentlichen eines Finanzplans die Währung des Workday-Unternehmens fest. Die Veröffentlichungswährung wird über den Planning-Ebenen-Loader in Workday Adaptive Planning Integration als zusätzliches Währungsattribut für eine Ebene geladen. Die Veröffentlichungswährung gibt eine der konfigurierten Währungen für die Instanz an, die im Aufruf exportActiveCurrencies gefunden und in der Ebenenverwaltungsoberfläche angegeben wurden. Erfordert durch Provisionierung aktiviertes Workday Power of One.	CAD
shortName	N	Die Abkürzung für die Ebene, falls vorhanden, wie in der Ebenenverwaltung eingegeben.	Dev
eliminationLevel	N	Gibt an, ob die Ebene eine Eliminierungsebene ist. 0 für „Nein“ und „1“ für „Ja“.	1
eliminationTradingPartner	N	Beschreibung	1
inWorkflow	N	Gibt an, ob sich die Ebene in einem Workflow befindet. 0 für „Nein“ und „1“ für „Ja“.	1
propagateToDescendants	N	Gibt an, ob Änderungen an die untergeordneten Ebenen dieser Ebene weitergegeben werden. 0 für „Nein“ und „1“ für „Ja“. Weitere Informationen zum Verhalten von propagateToDescendants finden Sie unter propagateToDescendants-Verhalten bei UpdateLevels-Anforderungen.	1
actualsStart	N	Der Zeitcode, wie in der Zeitverwaltung für den Start der Istzahlen-Version für diese Ebene definiert.	05/2013
actualsEnd	N	Der Zeitcode, wie in der Zeitverwaltung für das Ende der Istzahlen-Version für diese Ebene definiert.	12/2018
Beschreibung Nur in API v30 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	Die Beschreibung der Ebene. Diese Eigenschaft ist nur verfügbar, wenn "Anzeigename aktivieren" für die Instanz auf EIN gesetzt ist.	Die oberste Abteilung.
status	J	Status der Ebene nach dem Aktualisieren Bei Warnungen und Fehlern enthält das Nachrichtenelement den Nachrichteninhalt. Der Status "Aktualisiert" gibt keine Nachrichteninhalte zurück. Fehler: In der Entität wurde ein Fehler gefunden Warnung: In der Entität wurde eine Warnung gefunden Erstellt: Die Entität wurde erfolgreich erstellt Aktualisiert: Die Entität wurde erfolgreich aktualisiert	Aktualisiert
Nachricht	N	Die Fehlermeldung für eine ungültige Ebeneneingabe	Die Ebene UKregion2 ist entweder in der Nutzlast doppelt oder im System bereits mit ID 6 vorhanden.
Inhalt des Elements
Ein verschachteltes Ebenenelement für jede direkt untergeordnete Ebene dieser Ebene. Ein Attributelement, wenn dieser Ebene mindestens ein Attribut zugeordnet ist.

Attributelement
Tag-Name		Attribut
Beschreibung		Container für ein Ebenenattributelement.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
Name	J	Der Name des Ebenenattributs	Standort
Wert	J	Wert des Ebenenattributs.	SFO
valueCode Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	J	Der Code des Attributwerts für dieses Attribut. Für API v32 und höher ist valueCode nur in folgenden Fällen sinnvoll: Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1	SFO
valueName Nur in API v32 und API v33 für Instanzen verfügbar, die den Anzeigenamen aktivieren. Wird in API v34 nicht unterstützt.	N	Der Name für einen neu automatisch erstellten Attributwert. Das AttributwertName ist nur in folgenden Fällen sinnvoll: valueCode enthält einen nicht vorhandenen Attributwert. Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1value Der Name wird ignoriert, wenn valueCode einen vorhandenen Attributwert enthält.	San Francisco
status	J	Status des Attributs nach der Aktualisierung Bei Warnungen und Fehlern enthält das Nachrichtenelement den Nachrichteninhalt. Der Status "Aktualisiert" gibt keine Nachrichteninhalte zurück. Fehler: In der Entität wurde ein Fehler gefunden Warnung: In der Entität wurde eine Warnung gefunden Erstellt: Die Entität wurde erfolgreich erstellt Aktualisiert: Die Entität wurde erfolgreich aktualisiert	aktualisiert
Nachricht	N	Die Fehlermeldung für eine ungültige Attributeingabe.	Die Ebene UKregion2 ist entweder in der Nutzlast doppelt oder im System bereits mit ID 6 vorhanden.
Inhalt des Elements
(Keine)

-Versionselement
Tag-Name		Version
Beschreibung		Gibt die Versionsverfügbarkeit einer Ebene an.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
Name	J	Der Name der Version, wie er in der Versionsverwaltung angezeigt wird.	Budget 2015
Wert	J	Wenn 1, ist diese Ebene in dieser Version verfügbar.	1
status	J	Status der Version nach dem Update. Bei Warnungen und Fehlern enthält das Nachrichtenelement den Nachrichteninhalt. Der Status "Aktualisiert" gibt keine Nachrichteninhalte zurück. Fehler: In der Entität wurde ein Fehler gefunden Warnung: In der Entität wurde eine Warnung gefunden Erstellt: Die Entität wurde erfolgreich erstellt Aktualisiert: Die Entität wurde erfolgreich aktualisiert	aktualisiert
Inhalt des Elements
Ein oder mehrere Versionselemente für jeden Dimensionswert.

Dimensionselement
Tag-Name		Dimension
Beschreibung		Stellt eine einzelne benutzerdefinierte Dimension dar, die in der Antwort auf einen updateLevels-API-Aufruf zurückgegeben wird.
Attribute des Elements
Name des Attributs	erforderlich?	Wert	Beispiel
Name	J	Der Name der Dimension, wie er in Berichten und Tabellenblättern angezeigt wird.	Region
Wert	N	Der für diese Ebene verfügbare Dimensionswert.	C-USA
valueCode Nur in API v32 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	J	Der Code des Dimensionswerts für diese Dimension. Für API v32 und höher ist valueCode nur in folgenden Fällen sinnvoll: Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1	CUS
valueName Nur in API v32 und höher für Instanzen verfügbar, die den Anzeigenamen aktivieren.	N	Der Name für einen neu automatisch erstellten Dimensionswert. Für API v32 und höher ist valueName nur in folgenden Fällen sinnvoll: valueCode enthält einen nicht vorhandenen Dimensionswert. Die Einstellung "Anzeigename" ist für die Instanz EIN. displayNameEnabled=1 valueName wird ignoriert, wenn valueCode einen vorhandenen Dimensionswert enthält.	C-USA
status	N	Status der Version nach dem Update. Bei Warnungen und Fehlern enthält das Nachrichtenelement den Nachrichteninhalt. Der Status "Aktualisiert" gibt keine Nachrichteninhalte zurück. Fehler: In der Entität wurde ein Fehler gefunden Warnung: In der Entität wurde eine Warnung gefunden Erstellt: Die Entität wurde erfolgreich erstellt Aktualisiert: Die Entität wurde erfolgreich aktualisiert	Aktualisiert
Inhalt des Elements
(Keine)

Fehler- und Warnmeldungen – Beschreibungen

Art	Meldung	Beispiel/Beschreibung
Fehler	Ein Systemfehler ist aufgetreten. Für weitere Informationen wenden Sie sich an den Support.	Systemfehler
Fehler	Datei "content.xml" kann nicht gefunden werden.	Ist bereits in updateDimensions API vorhanden
Fehler	Die Eingabe enthält keine Ebenen-Tags.	Für die Nutzlast fehlt das Ebenen-Tag.
Fehler	"{0}" wird nicht als definiertes Element "{1\}" erkannt.	Wird verwendet, wenn der Versionsname oder -wert unbekannt ist.
Fehler	"{0}" darf nicht leer sein.	Versionsname ist leer.
Fehler	Versionsverfügbarkeit kann für Ist-Zahlen nicht geändert werden.	Wenn der Benutzer versucht, die Versionssichtbarkeit für die Istzahlen-Version zu ändern.
Fehler	Versionsverfügbarkeit kann für die Root-Ebene "{0}" nicht geändert werden.	Wenn der Benutzer versucht, die Versionssichtbarkeit für die Root-Ebene zu ändern.
Fehler	Die Sichtbarkeit von Version "{0}" in der Ebene "{1\}" ist nicht kompatibel mit der übergeordneten Ebene von "{1\}".	Wenn die bereitgestellte Versionssichtbarkeit der Ebene nicht mit der übergeordneten Ebene kompatibel ist.
Fehler	Sie sind nicht berechtigt, eine oder mehrere Ebenen oder Versionen zu aktualisieren, die in dieser Anforderung angegeben sind.	Wenn der Benutzer versucht, Informationen auf nicht zugänglicher Ebene zu aktualisieren.
Fehler	"{0}" wird nicht als definiertes Element "{1\}" erkannt.	Wird verwendet, wenn der Dimensionsname oder -wert unbekannt ist.
Fehler	"{0}" darf nicht leer sein.	Der Name der Dimension ist leer.
Fehler	Listendimension kann in Ebene nicht verwendet werden.	Der Benutzer versucht, einen flachen Dimensionswert für eine Ebene zu mappen.
Fehler	Die Dimension "{0}" ist für die Ebene deaktiviert.	Die Dimension ist für diese Ebene deaktiviert.
Fehler	Der Dimensionswert "{0}" ist nicht kompatibel mit dem Dimensionswert des übergeordneten Elements.	Wenn das bereitgestellte Dimensions-Mapping der Ebene nicht mit der übergeordneten Ebene kompatibel ist.
Fehler	"{0}" wird nicht als definiertes Element "{1\}" erkannt.	Wird verwendet, wenn der Name oder Wert des Attributs unbekannt ist.
Fehler	Der Attributwert "{0}" ist nicht mit dem Attributwert des übergeordneten Elements kompatibel.	Wenn der angegebene Ebenenattributwert der Ebene nicht mit der übergeordneten Ebene kompatibel ist.
Fehler	"{0}" darf nicht leer sein.	Der Name des Attributs ist leer.
Fehler	Bei der Verarbeitung der API-Anforderung updateLevels ist eine Ausnahme aufgetreten.	Systemfehler
Fehler	ID "{0}" ist nicht vorhanden.	Nicht vorhandene Ebenen-ID, die in der Nutzlastanfrage angegeben wurde.
Fehler	"{0}" kann nicht dieselbe ID wie das übergeordnete Element haben.	Untergeordnete und übergeordnete Ebene haben dieselbe ID.
Fehler	"{0}" kann nicht untergeordnet von "{1\}" sein.	Eine bestimmte Ebene kann nicht untergeordnetes Element einer anderen bestimmten Ebene sein.
Fehler	ID der Root-Ebene fehlt.	Die ID für die Root-Ebene wurde nicht angegeben.
Fehler	Die Root-Ebenen-ID "{0}" mit dem Ebenennamen "{1"" kann nicht zu einer untergeordneten Ebene werden.	Die Root-Ebene kann nicht zu einer untergeordneten Ebene werden.
Fehler	Die Währung der Root-Ebene kann nicht geändert werden.	Die Währung kann für die Root-Ebene nicht geändert werden.
Fehler	Die Währung "{0}" ist ungültig.	Unbekannter Währungsname im Ebenen-Tag.
Fehler	Die Ebene "{0}" ist für IDs "{1"" doppelt vorhanden.	Doppelter Name der Ebene angegeben.
Fehler	Die Ebene "{0}" ist in der Nutzlast {1\} {2} doppelt vorhanden.	Mehrere neue Ebenen enthalten denselben Namen.
Fehler	Der Workflow der Root-Ebene kann nicht geändert werden.	Der Status "InWorkflow" kann für die Root-Ebene nicht geändert werden.
Fehler	Die Attributzuweisung der Ebene "{0}" ist nicht kompatibel mit dem Attributwert des übergeordneten Elements.	Der angegebene Ebenenattributwert ist nicht mit der übergeordneten Ebene kompatibel.
Fehler	Die Ebene mit ID "{0}" ist nicht vorhanden.	In Planning ist keine Ebene mit der angegebenen ID vorhanden.
Fehler	Sie sind nicht berechtigt, eine oder mehrere Ebenen oder Versionen zu aktualisieren, die in dieser Anforderung angegeben sind.	Für eine in der Nutzlast angegebene Ebene fehlt die Benutzerberechtigung.
Fehler	Die Versionssichtbarkeit der Ebene "{0}" ist nicht kompatibel mit dem {0} übergeordneten Element "{1\}".	Die angegebene Versionssichtbarkeit der Ebene ist nicht mit der übergeordneten Ebene kompatibel.
Fehler	Die Ebene "{0}" hat eine Istzahlen-Verfügbarkeit, die mehr Zeitperioden enthält als die übergeordnete Ebene "{1\}".	Der Istzahlen-Bereich der aktuellen Ebene wurde geändert. Durch den modifizierten Istzahlen-Bereich ist er kleiner als einer der Istzahlen-Bereiche seines Nachfolgers.
Fehler	Sie können den Workflow für die Ebene "{0}" nicht deaktivieren, wenn deleteWorkflowSilently, 0. Wenn Sie deleteWorkFlowSilently auf 1 setzen, werden alle Ihre Workflow-Aufgaben, die dieser Ebene zugeordnet sind, gelöscht.	Wenn „Workflow lautlos löschen“ deaktiviert ist, können Sie den Workflow nicht deaktivieren. Wenn Workflow lautlos löschen aktiviert ist, werden alle Workflow-Aufgaben für die Ebene gelöscht.
Fehler	Start- und Enddatum der Istzahlen für "{0}" konnten nicht aktualisiert werden, da der Datumsbereich kleiner ist als das für die Istzahlen-Version definierte Start- und Enddatum und deleteActualsSilently auf "false" gesetzt ist, um zu verhindern, dass Istzahlen für {1\} gelöscht werden.	Benutzer versucht, Istzahlen-Bereich zu verkleinern, ohne das Kennzeichen deleteActualsSilently zu setzen.
Fehler	Workflow kann für die Ebene "{0}" nicht aktiviert werden, da in der übergeordneten Ebene der Workflow deaktiviert ist.	Workflow kann für die Ebene nicht aktiviert werden, da in der übergeordneten Ebene der Workflow deaktiviert ist.
Fehler	"Handelspartner" oder "Eliminierungsebene" kann für die Ebene "{0}" nicht aktiviert werden, da für die übergeordnete Ebene "Handelspartner" aktiviert ist.	Wenn „Handelspartner“ bereits für ein übergeordnetes Element aktiviert ist, können die untergeordneten Elemente „Handelspartner“ oder „Eliminierungsebene“ nicht aktiviert werden.
Fehler	Ein übergeordnetes Element mit ID "{0}" ist nicht vorhanden.	Für eine übergeordnete Ebene wurde eine nicht vorhandene ID angegeben.
Fehler	Der übergeordnete Knoten "{0}" wird seinem aktuellen direkt/indirekt untergeordneten Knoten "{1\}" untergeordnet.	Eine periodische Beziehung zwischen einem übergeordneten Element und untergeordneten Elementen wird erstellt.
Fehler	Eine Ebene kann nicht ihre eigene übergeordnete Ebene sein.	Eine Ebene kann nicht zu einer eigenen übergeordneten Ebene in einer Nutzlast werden.
Fehler	Eine Ebene mit ID "{0}" ist nicht vorhanden.	Die angegebene Entität ist in Planning nicht vorhanden.
Fehler	Eliminierung und Handelspartner können nicht gleichzeitig aktiviert sein.	Eine Ebene kann eine Eliminierungsebene oder ein Handelspartner sein, aber nicht beides gleichzeitig.
Fehler	Sie können "Eliminierung" nur auf dieser Ebene ändern, während "Handelspartner" in der übergeordneten Ebene deaktiviert ist.	Die Eliminierung für eine Ebene kann nur geändert werden, wenn für die übergeordnete Ebene dieser Ebene „Handelspartner“ deaktiviert ist.
Fehler	Eine Unterebene unter dieser Ebene ist eine Eliminierungsebene, daher kann diese Ebene nicht als Handelspartner markiert werden.	Die aktuelle Ebene kann nicht als Handelspartner markiert werden, da eine darunter liegende Ebene eine Eliminierungsebene ist.
Fehler	Sie können den Workflow in dieser Ebene nicht aktivieren, wenn der Workflow in der übergeordneten Ebene deaktiviert ist.	Für die übergeordnete Ebene der Ebene ist der Workflow deaktiviert.
Fehler	"{0}" kann für einen Knoten und seine Nachfolger nur zusammen aktiviert werden. Um Änderungen daran vorzunehmen, setzen Sie propagateToDescendants = 1.	Weitere Informationen zum Verhalten von propagateToDescendants finden Sie unter propagateToDescendants-Verhalten bei UpdateLevels-Anforderungen.
Fehler	Ebene "{0}" kann nicht in eine Eliminierungsebene geändert werden, da sie Daten in einem oder mehreren Intercompany-Konten enthält.	Eine Ebene kann nicht zu einer Eliminierungsebene werden, wenn sie Daten in Intercompany-Konten enthält.
Fehler	Istzahlen-Start oder Istzahlen-Ende können für die Root-Ebene "{0}" nicht geändert werden.	Der Benutzer versucht, den Istzahlen-Bereich für die Root-Ebene zu ändern.
Fehler	Sie können zu einer verknüpften Ebene keine untergeordnete Ebene hinzufügen.	Der Benutzer versucht, eine untergeordnete Ebene für eine verknüpfte Ebene hinzuzufügen.
Fehler	Ein Zeiteingabecode "{0}" ist nicht vorhanden.	Der angegebene Zeiteingabecode ist nicht vorhanden.
Fehler	Das Startdatum der Istzahlen "{0}" darf nicht nach dem Enddatum der Istzahlen liegen {1\}.	Die angegebene Startzeit für die Istzahlen liegt nach der Endzeit. Die Startzeit der Istzahlen muss vor der Endzeit liegen.
Fehler	Ungültiger Zeiteingabecode "{0}". Die für Istzahlen-Start und -Ende festgelegten Zeiteingabecodes müssen den niedrigsten Schichten in der Zeitverwaltung entsprechen.	Der angegebene Zeitcode befindet sich nicht auf der untersten Schichtebene.
Fehler	Ungültiger Zeiteingabecode "{0}". Der Istzahlen-Start "{0}" liegt vor dem Istzahlen-Start "{1\}" der übergeordneten Ebene.	Die angegebene Istzahlen-Startzeit liegt vor der Istzahlen-Startzeit der übergeordneten Ebene.
Fehler	Ungültiger Zeiteingabecode "{0}". Das Istzahlen-Ende "{0}" liegt nach dem Istzahlen-Ende "{1"" der übergeordneten Ebene.	Die angegebene Istzahlen-Endzeit geht über die Istzahlen-Endzeit der übergeordneten Ebene hinaus.
Fehler	Der Istzahlen-Start von "{0}" liegt vor dem Istzahlen-Versionsstart von "{1\}". Der Istzahlen-Start muss nach dem "{1"" liegen.	Die angegebene Zeit für Istzahlen-Start liegt vor der Startzeit der Istzahlen-Version.
Fehler	Das Istzahlen-Ende von "{0}" liegt nach dem Istzahlen-Versionsende von "{1\}". Das Istzahlen-Ende muss vor dem "{1"" liegen.	Die angegebene Zeit für "Istzahlen-Ende" geht über die Endzeit der Istzahlen-Version hinaus.
Fehler	Ungültiger "{0}" Wert "{1}". Der Wert muss "1" oder "0" sein.	Der Benutzer hat einen anderen Wert als "0" oder "1" als Wert für eine boolesche Eigenschaft angegeben.
Fehler	Ungültig: {0} {1}.	Der Benutzer hat einen ungültigen Wert angegeben.
Fehler	"{0}" ist als Name NICHT zulässig.	Das reservierte Wort "this", ein Wort, das mit "(+)" oder "(-)" endet, wurde als Name der Ebene angegeben.
Fehler	ID "{0}" ist nicht vorhanden.	Die angegebene Entität ist in Planning nicht vorhanden.
Warnung	Die Ebene "{0}" kann bei proceedWithWarnings = 0 nicht in eine andere übergeordnete Ebene verschoben werden.	Benutzer versucht, Ebene ohne proceedWithWarning="1" zu verschieben. proceedWithWarning = "1" bedeutet, dass Versionssichtbarkeit, Attribut-Mapping und Daten an die neue übergeordnete Ebene angepasst werden.
Warnung	Der Verfügbarkeitsbereich der Istzahlen wurde für Ebene "{0}" reduziert. Aus dem Bereich ausgeschlossene Istdaten wurden gelöscht.	Der Verfügbarkeitsbereich für Istzahlen wurde reduziert. Daten außerhalb des Bereichs werden gelöscht.
Warnung	deleteWorkflowSilently ist ein globales Kennzeichen. Es muss im Ebenen-Tag vorhanden sein.	Workflow lautlos löschen ist ein globales Kennzeichen. Es gehört zum Ebenen-Tag, nicht zu einem anderen Tag.
Warnung	deleteActualsSilently ist ein globales Kennzeichen. Es muss im Ebenen-Tag vorhanden sein.	Istzahlen lautlos löschen ist ein globales Kennzeichen. Es gehört zum Ebenen-Tag, nicht zu einem anderen Tag.
Warnung	Ebenen können nicht geändert werden, da unveröffentlichte Änderungen vorliegen.	Für Planning gibt es anstehende Änderungen für die Admin-Veröffentlichung.

Kategorie	Änderung von Metadaten
Beschreibung	Aktualisieren Sie eine Reihe vorhandener Ebenen oder erstellen Sie neue Ebenen und deren Eigenschaften. Mehrere Ebenen mit mehreren Werten können in einem einzigen Aufruf aktualisiert werden. Bei erfolgreicher Ausführung gibt die API Details zu den Ebenen zurück, die aktualisiert/erstellt wurden. Wenn die API fehlschlägt, wird eine umfassende Liste der Fehler und deren Ursachen zurückgegeben.
Zum Aufrufen sind Berechtigungen erforderlich	Modell und Berechtigungen auf jeder Ebene
Auf Anforderung erforderliche Parameter	Zugangsdaten