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

Planning-Zuordnungs-Loader erstellen

Mit dem Planning-Zuordnungs-Loader können Sie Metadaten zu Zuordnungen von Dimensionen und Ebenen zu Benutzern aus dem Staging-Bereich mit mappen
Adaptive Planning
. Zuordnungen verknüpfen Ebenen und benutzerdefinierte Dimensionen mit Benutzern. Die Ebeneneigentümerschaft ist eine Art Benutzerzuordnung, die Benutzer mit Ebenen verknüpft. Im Gegensatz zu regulären Ebenenzuordnungen umfasst die Ebeneneigentümerschaft auch andere Berechtigungen. Siehe:
Nachdem Sie einen Loader erstellt haben, können Sie ihn manuell ausführen oder die Ausführung als Teil einer Integrationsaufgabe planen. Siehe Integrationsaufgaben erstellen.

Voraussetzungen

  • Für den Planning-Zuordnungs-Loader sind Staging-Daten aus einem Import einer vorhandenen Datenquelleerforderlich.
  • Erforderliche Berechtigungen: Modell, Integrationsoperator, Datendesigner

Grundlegende Schritte

  1. Datenquelleneinstellungen eingeben
  2. Spalten-Mapping konfigurieren
  3. Geschäftsregeln erstellen
  4. Vorschau der Loader-Ausgabe erstellen
  5. Loader ausführen oder planen

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 wählen, welche Zuordnungen geladen werden sollen.
  1. Klicken Sie auf
    Neuen Loader erstellen
    im Bereich
    Loader
     der Komponentenbibliothek.
  2. Wählen Sie
    Planning
    -
    Zuordnungs-Loader
    als Loader-Art aus. Geben Sie einen Namen für den Loader ein.
  3. Klicken Sie auf
    Erstellen
    .
  4. Geben Sie die Informationen für
    Allgemeine Eigenschaften
     des Zuordnungs-Loaders auf dem Register
    Datenquelleneinstellungen
     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.
    • Mapping-Profil
      : Sie können im Rahmen des Loader-Erstellungsprozesses eine Verknüpfung mit einem Mapping-Profil erstellen. Wählen Sie das Mapping-Profil aus der Dropdown-Liste. Die Mapping-Profile in der Liste sind die, auf die Sie Zugriff haben. Siehe den Abschnitt "Mapping-Profil" des Planning-Daten-Loaders. Dieses Mapping-Profil mappt neben den als Teil von Metadaten-Loadern geladenen Mappings die Planning-Ebenen und -Dimensionen. Siehe Planning-Daten-Loader erstellen. Beispiel: Wenn der Zuordnungs-Loader den Ebenenspaltenwert "999999" (oder für Workday eine WID) hat, bestimmt das Mapping-Profil, auf welche Planning-Ebene sich dieser bezieht.
    • Ebene oder Dimension
      : Wählen Sie die Ebene für die Ebeneneigentümerschaft oder die Ebenenzuordnung aus. Wählen Sie eine Dimension aus, um Dimensionszuordnungen zu laden.
    • Attribut:
       (Optional) Wählen Sie ein Adaptive Planning-Attribut für die Ebene oder Dimension aus. Auf diese Weise können Sie Zuordnungen für Ebenen- oder Dimensionsattribute mappen und laden.
    • Modus
      : Wählen Sie
      Aktualisieren
      , um Zuordnungen oder Eigentümerschaft auf einer Teilmenge von Ebenen zu ändern. Dadurch wird die Ebene aktualisiert, nicht der Benutzer. Für Aktualisierungen der Ebene sind alle Benutzer erforderlich, die dieser Ebene in der Nutzlast zugeordnet sind. Wählen Sie
      Alle ersetzen
       aus, um alle Benutzer in den in der Nutzlast genannten Zuordnungen zu löschen und zu ersetzen.
      • Wenn Sie Adaptive Planning mit Workday Human Capital Management oder Workday Financials verwenden, wird in
        Modus
         automatisch die Option
        Aktualisieren
         angezeigt.
      • Wenn Sie Adaptive Planning nicht mit Workday Human Capital Management oder Workday Financials verwenden, wird in
        Modus
         automatisch
        Alle ersetzen
         angezeigt.
    • Mit Warnungen fortfahren
      : Aktivieren Sie diese Option, um den Loader weiterhin mit Warnungen auszuführen. Bei deaktivierter Option wird der Loader gestoppt, wenn eine Warnung auftritt. Das Aktivieren dieser Option bewirkt, dass der Loader nicht gemappte Dimensionen oder Ebenen überspringt und eine Warnung in den Protokollen generiert, während der Loader die Verarbeitung fortsetzen kann.
    • 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 den Zuordnungen mappen, die unter
Modellierung > Modellmanagement > Ebenen
 oder
Modellierung > Modellmanagement > Dimensionen
 verfügbar sind. Sie müssen
Benutzer-
 und
Planning-Spalten
 mappen.
Wenn Sie ein Workday-Kunde sind, der in dieser Umgebung eine Benutzersynchronisierung ausführt, muss die Spalte "Benutzer" mit der Quellspalte gemappt werden, die WIDs enthält. Wenn Sie die Benutzersynchronisierung nicht ausgeführt haben oder kein Workday-Kunde sind, muss die Benutzerspalte mit der Quellspalte gemappt werden, die Benutzernamen oder E-Mail-Adressen enthält.
Wenn mehrere
Planning-Spalten
 gemappt werden müssen, verwenden Sie den Filter
Anzeigen
, um Folgendes auszuwählen:
  • Alle:
     Zeigt alle Benutzer an.
  • Erforderlich
    :
    Zeigt alle erforderlichen Planning-Spalten an, z. B. "Benutzer" und "Ebene".
  • 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 das Register
    Spalten-Mapping
    . 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 an. Obligatorische Planning-Spalten sind durch fett formatierten Text mit einem Sternchen gekennzeichnet.
    • 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.
Spalten für Ebeneneigentümerschaft mappen
Wenn Sie nur die Ebeneneigentümerschaft laden möchten, mappen Sie für die Ebene in der
Quellspalte
 keine ID für den Zuordnungscode. Die Ebeneneigentümerschaft in
Verwaltung
 >
Zuordnungen
 ergibt sich daraus, dass der Zuordnungscode leer gelassen wird.
Spalten für die Ebenen- und Dimensionszuordnung mappen
Wenn Sie Ebenen- und Dimensionszuordnungen laden möchten, mappen Sie eine ID, z. B. eine
Referenz-ID
, für den Zuordnungscode in der
Quellspalte
.
Sie können Ebeneneigentümerschaft und Ebenenzuordnung nicht gleichzeitig in einem einzelnen Loader laden. Erstellen Sie einen Loader für die Ebeneneigentümerschaft und einen separaten Loader für die Ebenenzuordnung.
Spalten für die Attributzuordnung mappen
Wenn Sie Ebenen- oder Dimensionsattribute mit Zuordnungen laden möchten, mappen Sie sie in der
Quellspalte
. Attribute werden unten in den Mappings unter „Zuordnungsname“ angezeigt.
Spalten-Mapping aufheben
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.
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.

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. Klicken Sie auf dem Register
    Geschäftsregeln
     auf 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
    . Siehe 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 vor dem vollständigen Laden eine Vorschau der Loader-Ausgabe erstellen, um zu prüfen, ob die Mappings wie gewünscht funktionieren. Sie können die Ausgabe auch als XML-Datei herunterladen, um die Zuordnungen der Ebeneneigentümerschaft zu Benutzern aus Ihrer Datenquelle vor dem Laden manuell mit Ihren Anforderungen zu vergleichen.
Klicken Sie im Bereich "Aktionen" 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 Benutzerzuordnungswerte zum Laden vorhanden sind, 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 Zuordnungswerte und der Größe der Datei kann es einen Moment dauern, bis das Download-Popup angezeigt wird.
Validierungsfehler beheben
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:
  • Der Quell-ID-Wert für "Benutzer" oder "Ebene" und "Dimensionswert" fehlt in den Daten (ist leer).
  • Die Quell-ID ist nicht gemappt.

Loader ausführen

Nachdem Sie einen Planning-Zuordnungs-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-Zuordnungs-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-Zuordnungs-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 separate Integrationsaufgaben 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.