Zum Hauptinhalt wechseln
Dokumentation
Dokumentation
Adaptive Planning
Zuletzt aktualisiert: 2023-06-23
Planning-Ebenen-Loader erstellen

Planning-Ebenen-Loader erstellen

Metadaten-Loader synchronisieren hierarchische Informationen aus Quellsystemen mit den Hierarchien Ihres Planungsmodells. Ihre Hierarchien sollten vor der Synchronisierung bereits im Quellsystem vorhanden sein.
Mit dem Planning-Ebenen-Loader können Sie Metadaten zu Organisationshierarchien aus dem Staging-Bereich mit mappen
Adaptive Planning
Verwenden Sie den Planning-Ebenen-Loader, um Ebenen in einer Massenaktion zu importieren, anstatt sie einzeln in der Ebenenverwaltung zu erstellen. Nachdem Sie einen Loader erstellt haben, können Sie ihn manuell ausführen oder die Ausführung als Teil von planen
Integration
 Aufgabe.
Video ansehen:
 1m 36s

Grundlegende Schritte

  • Datenquelleneinstellungen eingeben
  • Spalten-Mapping konfigurieren
  • Geschäftsregeln erstellen
  • Vorschau der Loader-Ausgabe erstellen
  • Loader ausführen oder planen

Voraussetzungen

Für den Planning-Ebenen-Loader sind Staging-Daten aus einem Import einer vorhandenen Datenquelle erforderlich. Notieren Sie sich, welche Datenquelle Sie verwenden möchten.
Erforderliche Berechtigungen: Integrationsoperator, Datendesigner

Navigation

Compass.png Wechseln Sie im Navigationsmenü zu
Integration
Integrationsdesign
.

Datenquelleneinstellungen eingeben

Über die Datenquelleneinstellungen können Sie die gewünschte Quelltabelle aus Integrations-Staging-Daten auswählen und angeben, ob neue Ebenen automatisch erstellt werden sollen.
Best Practice: Speichern Sie häufig, während Sie Ihren Loader erstellen und bearbeiten. Klicken Sie im Bereich "Aktionen" auf
Speichern
. Um nicht gespeicherte Änderungen zu verwerfen, klicken Sie auf
Schließen
 und dann auf
Nein
.
  1. Klicken Sie auf im Abschnitt "Loader" der Komponentenbibliothek auf
    Neuen Loader erstellen
    .
  2. Wählen Sie
    Planning-Ebenen-Loader
     als Loader-Art aus. Geben Sie einen Namen für den Loader ein.
  3. Klicken Sie auf
    Erstellen
    .
  4. Geben Sie Informationen zu den allgemeinen Eigenschaften des Planning-Ebenen-Loaders ein:
    • Quelltabelle
      : Wählen Sie die Quelltabelle aus der Dropdown-Liste. Die Quelltabellen in der Liste sind alle im Staging-Bereich verfügbare Tabellen, auf die Sie Zugriff haben.
    • Ebene erstellen, falls in Planning nicht gefunden
      : Wählen Sie diese Option, um automatisch neue Ebenen zu erstellen, die im Quellsystem gefunden wurden, aber nicht unter
      "Ebenen
      für das Modellmanagement
      "
      vorhanden sind. Deaktivieren Sie das Kontrollkästchen "Nur vorhandene Ebenen aktualisieren" in Ihrem Modell.
    • Anwendbare Aktualisierungen der Ebenen an untergeordnete Elemente weitergeben
      :
      Aktivieren Sie dieses Kontrollkästchen, um
      untergeordnete Ebenen zu aktualisieren, wenn die Änderung eine kaskadierende Eigenschaft betrifft. Wenn das Kontrollkästchen deaktiviert ist, wird nur die explizit aktualisierte Ebene geändert.
    • Workflow-Elemente beim Deaktivieren des Workflows löschen
      :
      Aktivieren Sie das Kontrollkästchen, um
      Elemente im Workflow zu löschen, wenn Sie Workflows deaktivieren. Wenn das Kontrollkästchen deaktiviert ist, werden Workflow-Elemente beim Deaktivieren des Workflows nicht gelöscht.
    • Nicht zugängliche Istzahlen beim Aktualisieren der Ebenenverfügbarkeit löschen
      : Wenn sich das Start- oder Enddatum für Istzahlen einer Ebene so ändert, dass Istzahlen nicht mehr zugänglich sind, löschen Sie die Istdaten, auf die nicht zugegriffen werden kann.
    • Admin-Veröffentlichung - anstehende Änderungen veröffentlichen
      : Wenn Konzept: Admin-Veröffentlichung Workflow-Änderungen anstehen, wählen Sie diese Option, um die Änderungen zu veröffentlichen.
    • Reihenfolge in Planning beibehalten
      : Wählen Sie diese Option, um die bereits in Adaptive Planning verwendete Sortierreihenfolge für Ebenen beizubehalten.
    • Mit Warnungen fortfahren
      : Wählen Sie diese Option, um trotz Warnmeldungen mit dem Laden fortzufahren.
    • Protokollebene
      : Wählen Sie die Art der Details aus, die beim Ausführen des Loaders erfasst werden sollen.
      • Aus
        : Es werden keine Fehler protokolliert.
      • Fehler
        : Es werden nur schwerwiegende Fehler protokolliert.
      • Info
        : Es werden Basisinformationen protokolliert, z. B. wann der Loader aktualisiert wurde.
      • Ausführlich
        : Detaillierte Informationen zu allen Phasen und Aktionen. Wird hauptsächlich für Fehlerbehebung oder Auditing verwendet.

Spalten-Mapping konfigurieren

Mit dem Spalten-Mapping können Sie Spalten aus der Datenquelle mit Ebenen mappen, die unter
Modellierung
-
Modellmanagementebenen
verfügbar sind. Sie können das Mapping für Spalten aufheben, um die Staging-Daten zu ignorieren, die Sie nicht laden möchten. Sie können das Mapping für Spalten auch nach der Ausführung des Loaders nacheinander aufheben, um zu bestimmen, welche Spalten Fehler in den Protokollen generieren.
Eine Liste der vorhandenen Ebenen-IDs kann ausschließlich über die exportLevels -API abgerufen werden. Die Ebenen-ID wird nirgendwo in der Anwendungsoberfläche angezeigt. Die Quell-ID-Spalte für Ebenen wird beim Laden zur Ebenen-ID.
Wenn mehrere Spalten gemappt werden sollen, verwenden Sie den Filter
Anzeigen
, um Folgendes auszuwählen:
  • Alle
    : Zeigt alle Planning-Spalten an.
  • Erforderlich
    : Zeigt alle erforderlichen Planning-Spalten an, z. B. "Übergeordnete ID" und "Ebene".
  • Nicht gemappt
    : Zeigt alle nicht gemappten Planning-Spalten an.
  • Gemappt
    : Zeigt alle gemappten Planning-Spalten an.
Verwenden Sie
Kategorie
, um Folgendes auszuwählen:
  • Ebenendetails
    : Zeigt Spalten an, die sich auf Ebenendetails beziehen, einschließlich "Kurzname", "Währung" und "Im Workflow". "Im Workflow" muss ein boolescher Wert "1" für "wahr" oder "0" für "falsch" sein.
  • Eliminierungseinstellungen
    : Zeigt Spalten an, die sich auf Eliminierungseinstellungen beziehen, einschließlich "Eliminierungsebene" und "Eliminierungshandelspartner". Diese booleschen Werte müssen entweder "1" für "wahr" oder "0" für "falsch" sein.
  • Versionseinstellungen
    : Zeigt Spalten an, die sich auf die Versionseinstellungen beziehen, einschließlich "Istzahlen-Start" und "Istzahlen-Ende". Diese Werte sollten Datumsformate wie 01.01.2010 haben.
  • Ebenenattribute
    : Zeigt Spalten an, die sich auf Ebenenattribute beziehen.
  • Ebenendimensionen
    : Zeigt Spalten an, die sich auf Ebenendimensionen beziehen.
Sie können das Feld
Suchen
verwenden, um Spalten zu suchen. Geben Sie einen Namen vollständig oder teilweise ein und klicken Sie auf die Lupe. Alle Staging-Spalten, die mit der Suche übereinstimmen, werden in den Ergebnissen angezeigt.
Spalten mappen
  1. Klicken Sie auf
    Spalten-Mapping
    .
  2. Wählen Sie eine nicht gemappte Spalte im Dropdown aus. Für das Mapping verfügbare Spalten werden in der Liste angezeigt. Beim Mapping der Spalten ändert sich die Statusanzeige von einem Ausrufezeichen IntegrationMappingUnmapped.png in ein Häkchen IntegrationMappingMapped.png.
Das Register "Spalten-Mapping" enthält folgende Spalten:
  • Status:
    Ein Häkchen Gemappte Spalte gibt eine gemappte Spalte an. Ein Ausrufezeichen Nicht gemappte Spalte gibt eine nicht gemappte Spalte an.
  • Planning-Spalte:
    Zeigt alle für das Mapping verfügbaren Planning-Spalten in einem Tabellenblatt an. Die Liste der Planning-Spalten enthält einen Satz obligatorischer Planning-Spalten, gefolgt von allen anderen Planning-Spalten. Obligatorische Planning-Spalten sind durch fett formatierten Text mit einem Sternchen gekennzeichnet und enthalten eine Wertespalte. Nicht obligatorische Spalten enthalten den Kurznamen und die Währung.
  • Quellspalte:
     Zeigt die Spalten in der Staging-Tabelle an, die in den Datenquelleneinstellungen ausgewählt wurden.
Wenn
Datenimport erstellt automatisch Dimensionswerte
 aktiviert ist, können Sie Attribute nach Code mappen. Der Attributname wird automatisch zum Code.
Übergeordnete Ebenen mappen
Die Spalte "ParentId" zeigt die ID der übergeordneten Ebene einer Ebene an. Um die oberste Ebene in einer Hierarchie zu laden, muss der Wert "ParentId" in den Quelldaten leer sein. "ParentId" muss ebenfalls leer sein, wenn Sie eine untergeordnete Ebene unterhalb der obersten Ebene erstellen möchten.
Unter Beispiel: Ebenen aus Tabellendatenquellen laden finden Sie ein Beispiel dafür, wie Ebenen und deren übergeordnete Elemente mit Planning gemappt werden.
Spalten-Mapping aufheben
Um das Mapping für Spalten aufzuheben, klicken Sie auf
Mapping aufheben
und wählen eine der folgenden Optionen:
  • Mappings für alle aufheben
    : Hebt das Mapping für alle Spalten auf.
  • Mappings für Auswahl aufheben
    : Hebt das Mapping nur für die ausgewählten Spalten auf.
Durch Aufheben des Mappings für eine Spalte ändert sich das Statussymbol in ein Ausrufezeichen IntegrationMappingUnmapped.png.
Best Practice: Neben dem Aufheben des Mappings zur Behebung von Fehlern und dem Ignorieren von Spalten können Sie das Aufheben des Mappings auch zur Unterstützung des Änderungsmanagements verwenden. Wenn neue Spalten in eine Datenquelle eingefügt werden, können Sie das Mapping für die älteren Spalten aufheben, um die neuen Spalten zu mappen.

Mappings herunter- und hochladen

Sie können Mappings für Loader herunterladen, ändern und dann hochladen, um Mapping-Fehler schnell zu beheben. Uploads bewirken eine Alles-oder-nichts-Aktion, bei der alle Daten ersetzt werden. Beim Hochladen wird jeweils nur ein Tabellenblatt mit Mappings aus der Datei verarbeitet. Weitere Tabellenblätter mit Mappings führen dazu, dass der Vorgang mit Fehler beendet und der Upload abgebrochen wird.
  1. Klicken Sie im Bereich
    Aktionen
     auf
    Element-Mappings herunterladen
    .
  2. Laden Sie die XLSX-Datei herunter. Sie erhalten außerdem eine E-Mail oder eine Workday-Benachrichtigung mit einem Download-Link für die Mappings-Datei.
  3. Öffnen Sie die Datei und suchen Sie die Staging-Tabellenwerte im Mappings-Tabellenblatt, die Fehler verursachen.
    Alle Zellen, die in den Spalten
    Planning-Code
     oder
    Planning-Name
     als (UNGÜLTIG) markiert sind, zeigen an, dass dieser Code in Workday Adaptive Planning nicht mehr vorhanden ist.
  4. Korrigieren Sie die Fehler und klicken Sie auf
    Element-Mappings hochladen
    , um die Datei zu laden. Die Spalte
    Schreibgeschützt
    wird nicht hochgeladen.
  5. Führen Sie den Loader erneut aus.
Klicken Sie nicht auf
Element-Mappings löschen
, es sei denn, Sie werden von Ihrem Implementierungspartner oder dem Workday Adaptive Planning Support dazu aufgefordert.

Geschäftsregeln erstellen

Mit Geschäftsregeln können Sie SQL-Ausdrücke erstellen, die die zum Laden verfügbaren Staging-Daten beschränken. Es werden nur Datensätze geladen, die Ihren Filterkriterien entsprechen.
Das Register
Geschäftsregeln
 enthält einen Textbereich für die Eingabe von SQL.
So erstellen Sie einen SQL-Filter:
  1. Wählen Sie auf dem Register
    Geschäftsregeln
     die Option
    SQL-Filter
    . Klicken Sie auf
    Bearbeiten
    .
  2. Geben Sie einen SQL-Ausdruck ein. Sie können auf ein Element in der Liste
    Verfügbare Spalten
     klicken, um diese Spalte in den SQL-Ausdruck zu übernehmen, anstatt sie einzugeben.
  3. Klicken Sie auf
    Anwenden
    , um Ihre SQL-Syntax zu prüfen. Bei Fehlern in Ihrer Syntax wird der Rahmen um den Ausdruck rot angezeigt. Bewegen Sie den Cursor über den SQL-Editor, um Informationen zu Syntaxfehlern anzuzeigen.
    Um detaillierte Hilfe zur SQL-Syntax zu erhalten, klicken Sie im Abschnitt "Hinweise" von "SQL-Filter bearbeiten" auf
    Online-Hilfe
    . Weitere Informationen finden Sie in der Referenz zu SQL-Ausdrücken .
  4. Korrigieren Sie alle Fehler in Ihrer Syntax und klicken Sie auf
    Anwenden
    . Nur Staging-Zeilen, die mit dem SQL-Ausdruck übereinstimmen, werden beim Ausführen des Loaders importiert.

Vorschau der Loader-Ausgabe erstellen

Sie können eine Vorschau der Loader-Ausgabe erstellen, um die Mappings zu prüfen und Validierungsfehler zu beheben, bevor Sie den Loader ausführen.
Bei der Ausführung der Vorschau der Loader-Ausgabe oder des manuellen Ladevorgangs werden die Quelldaten auf Fehler geprüft. Bei den Validierungen wird u. a. auf Folgendes geprüft:
  • Eine Unterebene wird ohne Angabe der übergeordneten Ebene erstellt.
  • Einem Ebenenattribut ist ein Attributwert zugewiesen, der nicht gefunden werden kann.
  • Der Quell-ID-Wert für die Ebene fehlt in den Daten (ist leer).
  • Die Daten enthalten doppelte Quell-IDs oder Ebenennamen. Quell-IDs müssen eindeutig sein.
  • Eine übergeordnete ID ist mit der Quell-ID in den Daten identisch. Wenn dies der Fall ist, verweist die Spalte auf sich selbst als übergeordnetes Element.
  • Beim Import von Unterebenen wird das Root der Unterebene mit einem vorhandenen Knoten in gemappt
    Adaptive Planning
    . Die übergeordnete ID ist nicht in den Quelldaten für einen in neu eingeführten Knoten enthalten
    Adaptive Planning
    .
  • Ein vorhandener Knoten wurde unter einen neuen Knoten verschoben und das Kennzeichen "Neu erstellen" ist deaktiviert. Eine vorhandene Ebene wird in einen neuen Knoten verschoben, obwohl für den Loader festgelegt wurde, dass keine neuen Ebenen erstellt werden.
  • Die Daten haben eine zyklische Referenz in ihrer Hierarchie. Eine übergeordnete ID verweist auf ihr eigenes untergeordnetes Element als übergeordnetes Element.
  • Eine Ebene wird als Eliminierungshandelspartner festgelegt und eine ihrer untergeordneten Ebenen wird als Eliminierungsebene festgelegt. Eine Ebene, die als Eliminierungshandelspartner festgelegt ist, kann keine untergeordnete Ebene haben, die eine Eliminierungsebene ist.
Sie können die Vorschauausgabe auch als XML-Datei herunterladen, um die Ebenen aus Ihrer Datenquelle vor dem Laden manuell mit Ihren Anforderungen zu vergleichen.
  1. Klicken Sie im Bereich "Aktionen" auf
    Vorschau der Loader-Ausgabe erstellen
    .
  2. (Optional) Geben Sie die Einstellungen für "Vorschau der Loader-Ausgabe erstellen" ein. Welche Informationen Sie eingeben können, hängt von der Datenquelle ab, die Sie für diesen Planning-Ebenen-Loader ausgewählt haben. Wenn Sie die Einstellungen hier ändern, werden neue Daten in Staging-Tabellen und -Spalten importiert.
  3. Klicken Sie auf
    Vorschau der Loader-Ausgabe erstellen
    .
Der Loader wird einschließlich aller Transformationen und Geschäftsregeln ausgeführt. Während der Ausführung des Loaders werden die Schritte in einem Status-Popup angezeigt. Wenn Ebenen zum Laden verfügbar sind, erstellt der Loader eine XML-Datei und sendet eine E-Mail-Benachrichtigung mit der Ausgabe als gezippten XML-Anhang. Wenn keine Ebenen geladen werden, enthält die ZIP-Datei eine Meldung, dass keine Ebenen geladen wurden.
Über ein weiteres Popup können Sie die Vorschau der Loader-Ausgabe als gezippte XML-Datei herunterladen, nachdem der Loader erfolgreich ausgeführt wurde. Je nach Anzahl der Ebenen und der Größe der Datei kann es einen Moment dauern, bis das Download-Popup angezeigt wird.

Loader ausführen

Nachdem Sie einen Planning-Ebenen-Loader mit den erforderlichen Einstellungen gespeichert haben, führen Sie den Loader manuell oder als geplante Integrationsaufgabe aus.
Warten Sie zwischen jeder Ausführung des Planning-Ebenen-Loaders ca. 15 bis 30 Minuten
Adaptive Planning
 hat Zeit für die Synchronisierung mit Ihrem Import. Bei größeren Importen dauert die Synchronisierung länger. Die Wartezeit hängt von der Modellgröße und anderen Faktoren ab.
Wenn Sie den Loader manuell ausführen möchten, klicken Sie im Bereich "Aktionen" auf
Manuell ausführen
.
Sie können Ebenen direkt aus dem Quellsystem laden oder den Loader mit Staging-Werten ausführen, die bereits importiert wurden. Wählen Sie für die Ausführung des Loaders eine der folgenden Optionen: Wählen Sie
Datenimport umgehen
, um die vorhandene Staging-Tabelle für den Ladevorgang zu verwenden. Der Datenimport kann nicht umgangen werden, wenn Tabellen als Datenquellen verwendet werden.
Im Rahmen des Ausführungsprozesses prüft der Loader, ob die Daten in der Staging-Tabelle korrekt gemappt wurden. Während des Ladevorgangs werden mehrere Validierungen angewendet. Für alle Fehler, die während des Ladens auftreten, ist angegeben, was für einen erfolgreichen Import behoben werden muss.
Planning-Ebenen-Loader in eine Integrationsaufgabe einschließen
Jede Integrationsaufgabe kann einen oder mehrere Loader haben. Eine Aufgabe kann auch andere Integrationsaufgaben enthalten, z. B. Skript-Loader.
Best Practice: Führen Sie für jeden Loader separate Integrationsaufgaben durch.
Wenn eine Aufgabe mehrere Loader enthält, werden die Parameter aus jedem Loader bei der Ausführung der Aufgabe in einer Werteliste angezeigt. Wenn es einen gemeinsamen oder geteilten Parameter in den Loadern innerhalb einer Aufgabe gibt, fragt die Aufgabe den Parameter nur einmal ab. Sie können wählen, dass Parameter-Wertelisten überschrieben werden.
Für geplante Ausführungen der Aufgabe werden Standardwerte der Parameter für die Loader verwendet.
Meldungen und Warnungen zur Fehlerbehebung
Siehe: Referenz: Meldungsprotokolle für Planning-Ebenen-Loader für Beschreibungen der während eines Ladevorgangs protokollierten Meldungen.