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

Planning-Attribut-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-Attribut-Loader können Sie Metadaten mit Attributen aus dem Staging-Bereich mit mappen
Adaptive Planning
. Verwenden Sie den Attribut-Loader, um Attribute in einer Massenaktion aus einem externen System zu importieren und zu synchronisieren, anstatt Attribute einzeln in der Attributverwaltung zu erstellen. Nachdem Sie einen Loader erstellt haben, können Sie ihn manuell ausführen oder die Ausführung als Teil einer Integrationsaufgabe planen.
Video ansehen:
 1m 32s

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-Attribut-Loader sind Staging-Daten aus einem Import einer vorhandenen Datenquelle erforderlich. Notieren Sie sich, welche Datenquelle Sie verwenden möchten.
Erforderliche Berechtigungen: Integrationsoperator, Datendesigner, Modell

Navigation

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

Datenquelleneinstellungen eingeben

Über die Datenquelleneinstellungen können Sie die gewünschte Quelltabelle aus Staging-Daten auswählen und angeben, ob neue Attribute automatisch erstellt werden sollen.
Best Practice: Speichern Sie häufig, während Sie Ihren Loader erstellen und aktualisieren. Klicken Sie im Bereich "Aktionen" auf
Speichern
. Um nicht gespeicherte Änderungen zu verwerfen, klicken Sie auf
Schließen
 und dann auf
Nein
.
  1. Wählen Sie
    Neuen Loader erstellen
     im Abschnitt "Loader" der Komponentenbibliothek.
  2. Wählen Sie
    Planning-Attribut-Loader
     als Loader-Art aus. Geben Sie einen Namen für den Loader ein.
  3. Wählen Sie
    Erstellen
    .
  4. Geben Sie Informationen zu den allgemeinen Eigenschaften des Attribut-Loaders ein:
    • Quelltabelle
      : Wählen Sie die Quelltabelle aus der Dropdown-Liste. Die Liste enthält alle im Staging-Bereich verfügbare Tabellen, auf die Sie zugreifen können.
    • Planning-Attribut
      : Wählen Sie das Attribut in aus
      Adaptive Planning
       zu laden ist.
    • Attributwert erstellen, falls nicht in Planning gefunden
      : Wählen Sie diese Option aus, um automatisch neue Attributwerte zu erstellen, die im Quellsystem gefunden wurden, aber nicht unter "Modellierung > Modellmanagement > Attribute" vorhanden sind. Wenn Sie die Auswahl aufheben, werden nur vorhandene Attributwerte in Ihrem Modell aktualisiert.
    • Admin-Veröffentlichung - anstehende Änderungen veröffentlichen
      : Wenn Konzept: Admin-Veröffentlichung hat anstehende Workflow-Änderungen: Wählen Sie diese Option, um Änderungen zu veröffentlichen.
    • "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 Attributeigenschaften mappen, die unter
Modellierung
 >
Modellmanagement
>
Attribute
 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.
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 "Attribut".
  • Nicht gemappt
    : Zeigt alle nicht gemappten Planning-Spalten an.
  • Gemappt
    : Zeigt alle gemappten Planning-Spalten an.
Verwenden Sie
Kategorie
, um Folgendes auszuwählen:
  • Alle
    : Zeigt alle Spalten an. Attribute verwenden keine Kategorien.
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
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. Zu nicht obligatorischen Spalten gehört auch "Beschreibung".
  • Quellspalte:
     Zeigt die Spalten in der Staging-Tabelle an, die in den Datenquelleneinstellungen ausgewählt wurden.
  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.
Übergeordnete Attribute mappen
Die Spalte "ParentId" zeigt die ID des einem Attributwert übergeordneten Attributwerts an. Um das oberste Attribut in einer Hierarchie zu laden, muss der Wert "ParentId" in den Quelldaten leer sein. "ParentId" muss ebenfalls leer sein, wenn Sie untergeordnete Attributwerte unter der obersten Ebene erstellen möchten.
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 auf
    Online-Hilfe
     im Abschnitt "Hinweise" von "SQL-Filter bearbeiten". Weitere Informationen finden Sie unter Referenz: SQL-Ausdrücke .
  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:
  • Ein Attributwert wird ohne Angabe des übergeordneten Attributs erstellt.
  • Einem Attribut ist ein Attributwert zugewiesen, der nicht gefunden werden kann.
  • Der Quell-ID-Wert für das Attribut fehlt in den Daten (ist leer).
  • Die Daten enthalten doppelte Quell-IDs oder Attributnamen. 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.
  • Ein vorhandener Knoten wurde unter einen neuen Knoten verschoben und
    Attributwert erstellen, falls nicht in Planning gefunden,
     ist deaktiviert. Ein vorhandenes Attribut wird in einen neuen Knoten verschoben, obwohl für den Loader festgelegt wurde, dass keine neuen Attributwerte erstellt werden.
  • Die Daten haben eine zyklische Referenz in ihrer Hierarchie. Eine übergeordnete ID verweist auf ihr eigenes untergeordnetes Element als übergeordnetes Element.
Sie können die Vorschauausgabe auch als XML-Datei herunterladen, um die Attribute 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-Attribut-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 Attribute 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 Attribute geladen werden, enthält die ZIP-Datei eine Meldung, dass keine Attribute 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 Attribute und der Größe der Datei kann es einen Moment dauern, bis das Download-Popup angezeigt wird.

Loader ausführen

Nachdem Sie einen Planning-Attribut-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-Attribut-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 Attribute 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-Attribut-Loader in eine Integrationsaufgabe einschließen
Jede Integrationsaufgabe kann einen oder mehrere Loader haben. Eine Aufgabe kann auch andere Integrationsaufgaben enthalten, z. B.
Dashboards
 Metrik-Loader und 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.