Zum Hauptinhalt wechseln
Dokumentation
Dokumentation
Adaptive Planning
Zuletzt aktualisiert: 2025-09-05
Beim Datenagenten und Skripteditor mit Workday-Zugangsdaten anmelden

Beim Datenagenten und Skripteditor mit Workday-Zugangsdaten anmelden

Einige Links in diesem Artikel führen zur Workday Community. Wenn Sie kein Community-Konto haben, können Sie hier eines beantragen.
Sie können sich beim Erstellen eines Agenten unter den folgenden Voraussetzungen mit Workday Zugangsdaten beim Adaptive Datenagent anmelden:
  • Die Benutzersynchronisierung ist in Ihrem Workday-Mandanten abgeschlossen.
  • Sie registrieren einen API-Client für Ihren Datenagent und stellen dessen Informationen für den Data Agent Manager von Workday Adaptive Planning bereit.
Der Prozess erfordert zwei verschiedene Gewährungsarten für die Workday API-Registrierung:
  • Einen Autorisierungscode für die Provisionierung des Datenagent für die Anmeldung an der Benutzeroberfläche durch einen Adaptive Planning Benutzer.
  • Nach der Provisionierung des Agenten eine JWT Bearer Grant für den Token -Austausch von Nicht-Benutzeroberflächen als Integration - Konto , das nicht von der Anmeldung der Adaptive Planning Benutzeroberfläche abhängig ist.

Voraussetzungen

In Adaptive Planning
Sicherheit: Berechtigung
Datendesigner
.
In Workday
  • Sicherheit ist für die Registrierung eines API-Clients erforderlich.
  • Aktivieren Sie öffentliche APIs auf dem Register
    "Adaptive Planning"
     des Berichts
    "Mandanten-Setup
     ". Weitere Informationen finden Sie unter Schritte: Adaptive Planning für HCM und Financials konfigurieren .
  • Erstellen Sie für Datenagenten mit v12.0.240 und höher einen ISU (Integrationssystembenutzer). Weitere Informationen finden Sie unter Schritte: Planning Datenquellen nach Benutzersynchronisierung aktivieren .
    Bei Data Agent 12.0.240 und höher benötigt der Benutzer, der sich anmeldet, nicht die Sicherheitsrichtlinie für die Domäne
    „Setup: Adaptive Planning API Access“
     in Workday.
  • Weisen Sie den ISU der Sicherheitsgruppe „Adaptive ISU“ zu.
Im Netzwerk, das den Datenagenten und den Workday Adaptive Planning Data Agent Manager hostet
Vergewissern Sie sich, dass die Firewall- und Netzwerkeinstellungen auf Workday -IP-Adressen zugreifen können. Siehe:URLs und IP-Adressen für die Adaptive Planning Authentifizierung .

Geben Sie Workday API Client Details im Workday Adaptive Planning Data Agent Manager ein

  1. Vergewissern Sie sich, dass „Enable Public APIs“ auf dem Register
    Adaptive Insights
     im
    Workday-Mandanten-Setup
     aktiviert wurde.
  2. Registrieren Sie einen API-Client in Workday speziell für den Datenagent unter Verwendung
    von Gewährung des Autorisierungscodes
     mit einem
    Bearer
     -Zugriffs- Token. Die Gewährung dieses Autorisierungscodes wird verwendet, um sich beim Agentenservice anzumelden und den Agenten mit einer Benutzeroberfläche zu provisionieren. Siehe Register API Clients .
    1. Wählen Sie
      Non-Expiring Refresh Tokens
       .
    2. Legen Sie
      "Scope (Functional Areas)"
       auf
      System
       fest und fügen Sie
      Adaptive Planning
       hinzu.
    3. Wählen Sie
      OK
       , um den Schlüssel, den Geheimschlüssel und andere Details zu generieren, die Ihren neuen Integration -Client identifizieren.
    4. Kopieren Sie den
      Autorisierungsendpunkt, den Token-Endpunkt, die Client-ID
       und
      den Client-Geheimschlüssel
       , um sie beim Start des Data Agent Manager einzugeben.
  3. Starten Sie den Workday Adaptive Planning Data Agent Manager auf dem lokalen Computer.
  4. Wählen Sie
    Diagnose and Configure Network
    .
  5. Wählen Sie das Register
    Workday
    .
  6. Geben Sie die Informationen ein, die bei der Registrierung des API-Clients in Workday generiert wurden:
    • Autorisierungsendpunkt
    • Token-Endpunkt
    • Client-ID, die aus Workday kopiert wurde
    • Client-Geheimschlüssel, der aus Workday kopiert wurde
    • Die
      Umleitungs-URL
       muss mit der
      Umleitungs-URI
       übereinstimmen
      https://www.workday.com
       die bei der Registrierung des API-Clients eingegeben wurde.
  7. Wählen Sie
    Sign in with Workday
     und melden Sie sich beim Data Agent Manager an.
    Für Data Agent 12.0.240 und höher benötigt der Benutzer zur Anmeldung nicht die Domänensicherheitsrichtlinie
    Setup: Adaptive Planning API Access
     in Workday.
  8. Wenn Sie Data Agent 12.0.239 und älter verwenden, hören Sie hier auf. Für Data Agent 12.0.240 und höher, fahren Sie mit dem nächsten Schritt fort.
  9. Wählen Sie
    Diagnose and Configure Network Options
     .
  10. Wählen Sie das Register
    Workday Integration
    .
  11. Konfigurieren Sie das Register
    Workday Integration
     und registrieren Sie einen API-Client in Workday speziell für den Datenagent. Siehe Register API Clients . Wenn Sie den API-Client registrieren, verwenden Sie ein
    JWT Bearer-
     Zugriffs Token für den Token -Austausch von Nicht-Benutzeroberflächen, der nicht von den Anmeldebenutzern der Adaptive Planning Benutzeroberfläche abhängig ist:
    1. Wählen Sie im Abschnitt
      x509-Zertifikat
      die Option Create x509 Public Key
       , geben Sie einen Namen an und fügen Sie das vom Register
      Workday Integration
       im Workday Adaptive Planning Data Agent Manager kopierte
      Zertifikat
       ein.
    2. Legen Sie "Scope (Functional Areas)" auf
      System
       fest und fügen Sie
      Adaptive Planning
       hinzu.
    3. Wählen Sie
      OK
       aus, um die Client-ID, den Token-Endpunkt und andere Details zu generieren, die Ihren neuen Integration -Client identifizieren.
    4. Kopieren Sie die
      Client-ID
       und
      den Token-Endpunkt
       . Sie benötigen diese, sobald der Workday Adaptive Planning Data Agent Manager gestartet wird.
  12. Geben Sie die Informationen ein, die bei der Registrierung des API-Clients für Ihr
    JWT Bearer
    -Zugriffs-Token in Workday generiert wurden:
    • Client-ID
      , die aus Workday kopiert wurde.
    • ISU,
       der aus
      Workday Mandanten-Setup
      für öffentliche APIs
      von Adaptive Planning
       in Workday kopiert wurde. Möglicherweise müssen Sie Ihren Administrator um die Bereitstellung der ISU bitten.
    • Token-Endpunkt
      , der aus Workday kopiert wurde.
    • Zertifikat
       (schreibgeschützt).
  13. Wählen Sie
    Apply Workday Integration Settings
     .
Beim Adaptive Script Editor mit Workday-Zugangsdaten anmelden
Sobald Sie die API-Client-Informationen für Ihren Datenagenten eingegeben haben, können Sie sie in das Register „Workday“ im Adaptive Script Editor kopieren.
  1. Starten Sie den Adaptive Script Editor auf Ihrem lokalen Computer. Navigieren Sie zu
    Adaptive Data Agent
     >
    Adaptive Script Editor
     .
  2. Wählen Sie das Register
    Workday
     im Skripteditor.
  3. Fügen Sie die kopierten Informationen in folgende Felder in Ihrem Datenagenten ein:
    • Autorisierungsendpunkt
      .
    • Token-Endpunkt
      .
    • Client-ID
      , die aus Workday kopiert wurde.
    • Client-Geheimschlüssel
      , der aus Workday kopiert wurde.
    • Die
      Umleitungs-URL
       muss mit der
      Umleitungs-URI
       übereinstimmen
      https://www.workday.com
       die bei der Registrierung des API-Clients eingegeben wurde.
  4. Wählen Sie das Register
    Integration
     .
  5. Wählen Sie
    Sign In with Workday
     .
  6. Geben Sie Ihre Workday-Zugangsdaten an.
  7. Wenn Sie Data Agent 12.0.239 und älter verwenden, hören Sie hier auf.
  8. Für Data Agent 12.0.240 und höher konfigurieren Sie das Register "Workday Integration".
  9. Geben Sie die Informationen ein, die bei der Registrierung des API-Clients für Ihr
    JWT Bearer
    -Zugriffs-Token in Workday generiert wurden:
    • Client-ID
      , die aus Workday kopiert wurde.
    • ISU,
       der aus
      Workday Mandanten-Setup
      für öffentliche APIs
      von Adaptive Planning
       in Workday kopiert wurde. Möglicherweise müssen Sie Ihren Administrator um die Bereitstellung der ISU bitten.
    • Token-Endpunkt
      , der aus Workday kopiert wurde.
    • Zertifikat
       (schreibgeschützt).
Plugins "Adaptive Planning Input" und "Adaptive Planning Output" für Adaptive Script Editor von Adaptive Planning mit Workday-Zugangsdaten installieren
Die Plugins "Adaptive Planning Input" und "Adaptive Planning Output" im Skripteditor werden ohne Benutzeroberfläche ausgeführt. Sie erfordern ein JWT Bearer Grant und einen Integrationssystembenutzer (ISU), da sich eine Person nicht jedes Mal anmeldet.
  1. Öffnen Sie den Adaptive Script Editor auf dem lokalen Computer und melden Sie sich an.
  2. Erstellen Sie eine neue oder vorhandene Transformation oder einen neuen oder vorhandenen Job.
  3. Ziehen Sie das Plugin
    Adaptive Planning Output
     oder
    Adaptive Planning Input
     und klicken Sie mit der rechten Maustaste darauf, um
    Bearbeiten
     auszuwählen.
  4. Ändern Sie auf dem Register
    Instance Connection
    die Login method
     in
    Workday
     .
  5. Kopieren Sie den gesamten Inhalt des Felds
    Zertifikat
     . Dieses Zertifikat gibt an, dass dieses Plugin für die Kommunikation mit Workday autorisiert ist. Schließen Sie den Skripteditor erst, wenn Sie die API-Client-Registrierung in Workday und das Setup des Editor-Plugins abgeschlossen haben.
API-Client in Workday registrieren
  1. Öffnen Sie einen Browser und melden Sie sich bei Workday als Superuser an.
  2. Suchen Sie in Workday nach
    Register API Client
     .
  3. Legen Sie
    Client-Gewährungsart
     auf
    JWT Bearer Token
     fest.
  4. Wählen Sie im Abschnitt
    x509 Certificate
     die Option
    Create x509 Public Key
    , geben Sie einen Namen an und fügen Sie das
    Zertifikat
     ein, das Sie vom Register
    Workday Integration
     des Adaptive Planning Data Agent Service Manager kopiert haben.
  5. Legen Sie
    Bereich
     auf
    Adaptive Planning
     fest.
  6. Geben Sie ein
    https://www.workday.com
     für
    Umleitungs-URL
  7. Wählen Sie
    OK
     , um die Seite zu speichern und geöffnet zu belassen, damit Sie die
    Client-ID
     und
    den Token-Endpunkt
     kopieren können.
Plugin-Setup im Skripteditor abschließen
Verwenden Sie die API-Client-ID, den Token-Endpunkt und den ISU, um das Setup des Plugins abzuschließen.
  1. Kehren Sie zum Adaptive Script Editor zurück, um die
    Client-ID
     und
    den Token-Endpunkt
     aus Workday einzufügen.
  2. ISU,
     der aus
    Workday Mandanten-Setup
    für öffentliche APIs
    von Adaptive Planning
     in Workday kopiert wurde. Möglicherweise müssen Sie Ihren Administrator um die Bereitstellung der ISU bitten. Weitere Informationen zum Erstellen eines ISU finden Sie unter Schritte: Workday für Import von Daten in Adaptive Planning konfigurieren .
  3. Wählen Sie zum Speichern
    OK
     .

Benutzersynchronisierung und bereits vorhandene Datenagenten

Führen Sie die folgenden Schritte vor und nach der Benutzersynchronisierung in Workday aus, um sicherzustellen, dass Ihr Datenagent ohne Unterbrechungen ausgeführt wird.
Vor Ausführung der Benutzersynchronisierung
Bevor Sie die Benutzersynchronisierung aus Workday ausführen, aktualisieren Sie den Data Agent Manager für alle vorhandenen Datenagenten auf mindestens Version 12.0.240 und führen Sie die Schritte zum Konfigurieren des Registers "Workday" aus. Siehe Upgrade des Workday Adaptive Planning Data Agent Manager durchführen .
  1. Starten Sie den Workday Adaptive Planning Data Agent Manager auf dem lokalen Computer.
  2. Wählen Sie
    Diagnose and Configure Network
    .
  3. Wählen Sie das Register
    Workday
    .
  4. Geben Sie die Informationen ein, die bei der Registrierung des API-Clients in Workday generiert wurden:
    • Autorisierungsendpunkt
    • Token-Endpunkt
    • Client-ID, die aus Workday kopiert wurde
    • Client-Geheimschlüssel, der aus Workday kopiert wurde
    • Die
      Umleitungs-URL
       muss mit der
      Umleitungs-URI
       übereinstimmen
      https://www.workday.com
       die bei der Registrierung des API-Clients eingegeben wurde.
Nach Ausführung der Benutzersynchronisierung aus Workday
Konfigurieren Sie das Register
Workday Integration
 nach der Benutzersynchronisierung.
  1. Wählen Sie das Register
    Workday Integration
    .
  2. Registrieren Sie einen API-Client in Workday speziell für den Datenagent mit einem
    JWT Bearer
     -Zugriffs- Token. Siehe Register API Clients .
    1. Erstellen Sie
      den öffentlichen x509-Schlüssel
       und fügen Sie das vom Workday Adaptive Planning Data Agent Manager
      Workday Integration
       kopierte
      Zertifikat
       ein.
    2. Legen Sie „Scope (Functional Areas)“ auf
      System
       und
      Adaptive Planning
       fest.
    3. Wählen Sie
      OK
       aus, um die
      Client-D
      , den
      Token-Endpunkt
       und andere Details zu generieren und Ihren neuen Integration-Client zu identifizieren.
    4. Kopieren Sie die
      Client-ID
      , die
      ISU
      und den
      Token-Endpunkt
      . Sie benötigen diese, sobald der Workday Adaptive Planning Data Agent Manager gestartet wird.
  3. Starten Sie den Workday Adaptive Planning Data Agent Manager auf dem lokalen Computer.
  4. Wählen Sie
    Diagnose and Configure Network
    .
  5. Wählen Sie das Register
    Workday Integration
    .
  6. Geben Sie die Informationen ein, die bei der Registrierung des API-Clients für Ihr
    JWT Bearer
    -Zugriffs-Token in Workday generiert wurden:
    • Client-ID
      , die aus Workday kopiert wurde.
    • ISU,
       der aus
      Workday Mandanten-Setup
      für öffentliche APIs
      von Adaptive Planning
       in Workday kopiert wurde. Möglicherweise müssen Sie Ihren Administrator um die Bereitstellung der ISU bitten.
    • Token-Endpunkt
      , der aus Workday kopiert wurde.
    • Zertifikat
       (schreibgeschützt).
  7. Starten Sie den Datenagent und wählen Sie
    Sign in with Workday
     .