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

Planning-Dimensions-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.
Die Anforderungen des Planning-Dimensions-Loaders sind auf die Aktualisierung von maximal 10.000 Dimensionswerten in einer hierarchischen Dimension oder von 40.000 Dimensionswerten in einer flachen Dimension beschränkt. Diese Grenzwerte gelten nicht für die Erstellung neuer Dimensionswerte in einer Loader-Anforderung.
Mit dem Planning-Dimensions-Loader können Sie Metadaten zu Dimensionswerten aus dem Staging-Bereich mit mappen
Adaptive Planning
. Der Hauptvorteil des Planning-Dimensions-Loaders besteht darin, dass Sie Dimensionswerte mit einer Massenaktion importieren können, anstatt sie einzeln in "Modellierung > Modellmanagement > Dimensionen" zu erstellen. Nachdem Sie einen Loader erstellt haben, können Sie ihn manuell ausführen oder die Ausführung als Teil einer Integrationsaufgabeplanen.

Um einen Planning-Dimensions-Loader zu erstellen, gehen Sie folgendermaßen vor:
  1. Datenquelleneinstellungen eingeben
  2. Spalten-Mapping konfigurieren
  3. Geschäftsregeln erstellen
  4. Vorschau der Loader-Ausgabe erstellen
  5. Loader ausführen oder planen

Bevor Sie beginnen

Für den Planning-Dimensions-Loader sind Staging-Daten aus einem Import einer vorhandenen Datenquelleerforderlich.

Datenquelleneinstellungen eingeben

In den "Datenquelleneinstellungen" können Sie auswählen, welche Quelltabelle aus den Staging-Daten Sie verwenden möchten, welche Planning-Dimension geladen werden soll und ob neue Dimensionswerte automatisch erstellt werden sollen.
  1. Navigieren Sie zu
    Integration > Integrationsdesign
    .
  2. Klicken Sie im Bereich "Loader" der Komponentenbibliothek auf
    Neuen Loader erstellen
    .
  3. Wählen Sie
    Planning-Dimensions-Loader
     als Loader-Art. Geben Sie einen Namen für den Loader ein.
  4. Klicken Sie auf
    Erstellen
    .
Best Practice: Speichern Sie häufig, während Sie den Loader erstellen und bearbeiten. Klicken Sie dazu im Bereich "Aktionen" auf
Speichern
. Sie können nicht gespeicherte Änderungen verwerfen, indem Sie auf
Schließen
 und dann auf
Nein
 klicken.
Geben Sie Informationen zu den allgemeinen Eigenschaften des Planning-Dimensions-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.
  • Planning-Dimension:
     Wählen Sie aus allen Dimensionen eine Dimension aus, in die die Quelle geladen werden soll. Die aufgeführten Dimensionen stammen aus "Modellierung > Modellmanagement > Dimensionen".
  • Dimensionswert erstellen, falls nicht in Planning gefunden:
     Aktivieren Sie das Kontrollkästchen, um automatisch neue Dimensionswerte zu erstellen, die im Quellsystem gefunden wurden, aber nicht in "Modellierung > Modellmanagement > Dimensionen" vorhanden sind. Wenn diese Option nicht aktiviert ist, werden nur Aktualisierungen vorhandener Dimensionswerte durchgeführt und keine neuen Dimensionen erstellt.
    • Wenn für die Dimension, in die Sie laden, "Datenimport erstellt automatisch Dimensionswerte" unter "Modellimport > Modellmanagement > Dimensionen" nicht aktiviert ist, gibt der Loader eine Warnung aus.
  • Protokollebene:
     Wählen Sie die Art der Details aus, die beim Ausführen des Loaders protokolliert werden sollen.
    • Fehler
      :
       Es werden nur schwerwiegende Fehler protokolliert.
    • Info
      :
       Es werden Basisinformationen protokolliert, z. B. wann der Loader aktualisiert wurde.
    • Ausführlich
      :
       Es werden detaillierte Informationen zu allen Phasen und Aktionen bereitgestellt. Diese Ebene wird hauptsächlich für Fehlerbehebung oder Auditing verwendet, da sie möglicherweise mehr Protokollinformationen liefert, als für die normale Verwendung praktikabel ist.

Spalten-Mapping konfigurieren

Mit dem Spalten-Mapping können Sie Spalten aus der Datenquelle mit Dimensionswerten mappen, die unter "Modellierung > Modellmanagement > Dimensionen" verfügbar sind.
Wenn mehrere Spalten gemappt werden müssen, können Sie den Filter
Anzeigen
 verwenden, um Folgendes auszuwählen:
  • Alle
    : Zeigt alle Planning-Spalten an.
  • Erforderlich
    : Zeigt alle erforderlichen Planning-Spalten an.
  • Nicht gemappt
    : Zeigt alle nicht gemappten Planning-Spalten an.
  • Gemappt
    : Zeigt alle gemappten Planning-Spalten an.
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
    .
    Das Register "Spalten-Mapping" enthält Folgendes:
    • Status:
      Gibt an, ob eine Planning-Spalte gemappt ist. 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 Beschreibung.
    • Quellspalte:
       Zeigt die Spalten in der Staging-Tabelle an, die in den Datenquelleneinstellungen ausgewählt wurden.
  2. Wählen Sie eine nicht gemappte Spalte aus und klicken Sie auf das Dropdown. Eine Liste der Spalten, die Sie mappen können, wird in der Dropdown-Liste angezeigt. Beim Mapping der Spalten ändert sich die Statusanzeige von rot IntegrationMappingUnmapped.png in grün IntegrationMappingMapped.png.
Wenn
Datenimport erstellt automatisch Dimensionswerte
 aktiviert ist, können Sie Attribute nach Code mappen. Der Attributname wird automatisch zum Code.
Unter Beispiel: Dimensionswerte aus Tabellendatenquellen laden finden Sie ein Beispiel dafür, wie Dimensionswerte und deren übergeordnete Elemente mit Planning gemappt werden.
Namen von Planning-Dimensionswerten beim Laden ändern
So ändern Sie den Namen eines Planning-Dimensionswerts beim Laden:
  1. Wählen Sie die Quellspalte aus, die den Dimensionswert in der Quelle eindeutig identifiziert.
  2. Mappen Sie die ID-Spalte mit dem Dimensionswert-ID.
  3. Mappen Sie den Namen mit dem Namen des Dimensionswerts.
Spalten-Mapping aufheben
Um das Mapping für Spalten aufzuheben, klicken Sie auf
Mapping aufheben
und wählen eine der folgenden Optionen:
  • Mapping für alle aufheben
    :
     Hebt das Mapping für alle Spalten auf.
  • Mapping für Auswahl aufheben
    :
     Hebt das Mapping nur für die ausgewählten Spalten auf.
Durch Aufheben des Mappings für eine Spalte wird das Mapping-Statussymbol rot IntegrationMappingUnmapped.pngangezeigt.
Listendimensionen zugeordnete Attribute mappen
Sie können Attribute einer Listendimension zuordnen, indem Sie Spalten aus einem Datenquellenimport mappen.
Die Zuordnung von Attributen zu Dimensionen ist nur für Listendimensionen möglich. Sie können keine Attribute zu hierarchischen Dimensionen zuordnen.
Innerhalb von
Adaptive Planning
 Sie können
Modellmanagement
 >
Dimensionen
 aufrufen und auf eine Dimension klicken, um deren Details anzuzeigen und herauszufinden, ob es sich um eine Listendimension handelt.
Wählen Sie in den "Datenquelleneinstellungen" eine Listendimension als
Planning-Dimension
 aus.
Attribute werden als Spalten im Spalten-Mapping verfügbar, da die Dimension eine Listendimension ist.
Da Listendimensionen nicht hierarchisch sind, ist "ParentId" keine Option für die Quellspalte.

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 Daten in Staging beschränken. Es werden nur Datensätze geladen, die Ihren Filterkriterien entsprechen.
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, können Sie auf
    Online-Hilfe
     im Abschnitt "Hinweise" von "SQL-Filter bearbeiten" klicken. Sie können auch die Referenz zu SQL-Ausdrückenaufrufen.
  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 vor dem vollständigen Laden eine Vorschau der Loader-Ausgabe anzeigen, um zu prüfen, ob die Mappings Ihren Anforderungen entsprechen. Sie können die Vorschauausgabe auch als XML-Datei herunterladen, um die Dimensionswerte aus Ihrer Datenquelle vor dem Laden manuell mit Ihren Anforderungen abzugleichen.
  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-Dimensions-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
    .
Bei der Ausführung des Loaders werden alle Transformationen und Geschäftsregeln angewendet. Die vom Loader ausgeführten Schritte werden in einem Status-Popup angezeigt. Wenn Dimensionswerte geladen werden müssen, erstellt der Loader eine XML-Datei und sendet eine E-Mail-Benachrichtigung mit der Ausgabe des Loaders als gezippten XML-Anhang.
Ü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 Dimensionswerte und der Größe der Datei kann es einen Moment dauern, bis das Download-Popup angezeigt wird.
Validierungsfehler beheben
Beim Laden von Dimensionswerten werden die Quelldaten auf folgende Fehler überprüft:
  • Der Quell-ID-Wert für den Dimensionswert fehlt in den Daten (ist leer).
  • Die Daten enthalten doppelte Quell-IDs. Quell-IDs müssen eindeutig sein.
  • Ein Name für einen Dimensionswert fehlt in den Daten (ist leer).
  • Es sind doppelte Namen für Dimensionswerte in den Daten enthalten.
  • Eine übergeordnete ID ist mit der Quell-ID in den Daten identisch. In diesem Fall verweist die Spalte auf sich selbst als übergeordnetes Element.
  • Beim Importieren eines Unterbaums wird das Root des Unterbaums mit einem vorhandenen Knoten in Planning gemappt. In diesem Fall ist die übergeordnete ID nicht in den Quelldaten für einen neuen Knoten enthalten, der in Planning eingeführt wird.
  • Ein vorhandener Knoten wird unter einen neuen Knoten verschoben und das Kennzeichen "Neu erstellen" ist deaktiviert. In diesem Fall wird ein vorhandener Dimensionswert in einen neuen Knoten verschoben, wenn der Loader explizit angewiesen wurde, keine neuen Dimensionswerte zu erstellen.
  • Die Daten haben eine zyklische Referenz in ihrer Hierarchie. In diesem Fall verweist "ParentId" auf ihren eigenen untergeordneten Wert als übergeordneten Wert.

Loader ausführen

Nachdem Sie einen Planning-Dimensions-Loader mit allen erforderlichen Konfigurationseinstellungen gespeichert haben, kann der Loader manuell oder als geplante Integrationsaufgabe ausgeführt werden.
Warten Sie zwischen jeder Ausführung des Planning-Dimensions-Loaders ca. 15 bis 30 Minuten, damit
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.
Sie können direkt aus dem Quellsystem importieren 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-Dimensions-Loader in eine Integrationsaufgabe einschließen
Jede Integrationsaufgabe kann einen oder mehrere Loader enthalten. Eine Aufgabe kann auch andere Integrationsaufgaben sowie Discovery-Metrik-Loader und Skript-Loader enthalten.
Best Practice: Führen Sie für jeden Loader eine separate Integrationsaufgabe durch.
Wenn eine Aufgabe mehrere Loader enthält, werden bei der Ausführung der Aufgabe Parameter aus jedem Loader angezeigt. Wenn in den Loadern innerhalb einer Aufgabe ein allgemeiner/gemeinsamer Parameter verwendet wird, fordert die Aufgabe nur einmal zur Eingabe des Parameters auf. Sie können wählen, dass Parameter-Wertelisten überschrieben werden.
Für geplante Ausführungen der Aufgabe werden die Standardwerte der Parameter verwendet, die beim Erstellen der Loader gespeichert wurden.
Meldungen und Warnungen zur Fehlerbehebung
Eine Erläuterung zu den während eines Ladevorgangs protokollierten Meldungen finden Sie unter Referenz: Meldungsprotokolle für Planning-Dimensions-Loader.

Änderungen an Quelldimensionswert laden

Der Planning-Dimensions-Loader kann einen Dimensionswert beim Laden umbenennen, wenn bereits ein Mapping mit dem Quelldimensionswert eingerichtet wurde.
Diese Tabelle zeigt die Mappings, die der Loader bereits eingerichtet hat. Der Quelldimensionswert "USA" wird mit der Quell-ID-Spalte "1001" gemappt.
Planning-Dimensionswert
Quell-ID-Spalte
Quelldimensionswert
USA
1001
USA
Kanada
1002
Kanada
Wenn im Quellsystem "USA" in "Vereinigte Staaten" geändert wird, kann der Planning-Dimensions-Loader diese Änderung beim Laden anwenden, da der Loader das Mapping zwischen der Quell-ID-Spalte "1001" und der internen Planning-ID für den Dimensionswert "USA" verwaltet.
Planning-Dimensionswert
Quell-ID-Spalte
Quelldimensionswert
USA
1001
Vereinigte Staaten
Kanada
1002
Kanada
Wenn Sie den Loader ausführen, wird der Dimensionswert in Planning von "USA" in "Vereinigte Staaten" geändert.