Zum Inhalt springen

Workday

Einführung

Eine Workday Aktivität ruft Daten von einem ausgewählten Workday Webdienst ab und/oder sendet Daten an diesen und wird als Quelle oder Ziel in einer Operation verwendet. Nachdem Sie eine Workday-Verbindung konfiguriert haben, können Sie für jede Workday Verbindung beliebig viele Workday-Aktivitäten konfigurieren. Workday-Aktivitäten können sowohl mit Standard- als auch mit benutzerdefinierten Objekten verwendet werden.

Erstellen einer Workday Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

Auf Menüaktionen zugreifen

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Konfigurieren einer Workday Aktivität

Befolgen Sie diese Schritte, um eine Workday-Aktivität zu konfigurieren:

Im gezeigten Beispiel wird eine Workday Get-Aktivität konfiguriert. Andere Workday Aktivitäten folgen einem ähnlichen Muster.

Schritt 1: Einen Workday-Webdienst auswählen

Tab „Verbindungen“

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Workday Aktivität verwendet werden soll. Der Name muss für jede Aktivität (des gleichen Typs) eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Wählen Sie einen Dienst aus: In diesem Abschnitt werden die im Workday Endpoint verfügbaren Webdienste angezeigt. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur der ausgewählte Webdienst angezeigt, anstatt die gesamte Webdienstliste neu zu laden.

    Vorsicht

    Workday WSDL-Versionen v42.0 und v42.1 geben Fehler zurück, wenn versucht wird, Daten für bestimmte Dienste abzurufen. Siehe Einschränkungen für weitere Informationen.

    Wenn Sie einen dieser Dienste verwenden müssen, wählen Sie in der Workday-Verbindung eine andere Workday WSDL-Version.

    • Ausgewählter Workday Dienst: Nachdem ein Webdienst ausgewählt wurde, wird er hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Webdienste zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Webdienste angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Webdienste während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Webdienste vom Workday Endpoint neu zu laden. Dies kann nützlich sein, wenn Sie der Workday-Instanz kürzlich Webdienste hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle der Webdienste verwendet werden.

    • Dienst auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um einen Webdienst auszuwählen. Es kann nur ein Webdienst ausgewählt werden. Die für jeden Webdienst verfügbaren Informationen werden vom Workday Endpoint abgerufen:

      • Name: Der Webdienstname von Workday.
      • Beschreibung: Die Webdienstbeschreibung von Workday.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Webdiensten gefüllt ist, wird die Workday-Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Wählen Sie einen Workday Operation aus

Tab „Verbindungen“

  • Wählen Sie eine Operation aus: In diesem Abschnitt werden die für den ausgewählten Webdienst im Workday Endpoint verfügbaren Operationen angezeigt. Beim erneuten Öffnen einer vorhandenen Aktivitätskonfiguration wird nur die ausgewählte Operation angezeigt, anstatt die gesamte Operation neu zu laden.

    • Ausgewählter Workday Dienst: Der im vorherigen Schritt ausgewählte Webdienst wird hier aufgelistet.

    • Ausgewählter Workday: Nachdem ein Operation ausgewählt wurde, wird er hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Operationen zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Operationen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Operationen während der Suche vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Vorgänge vom Workday Endpoint neu zu laden. Dies kann nützlich sein, wenn Sie der Workday Instanz kürzlich Vorgänge hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Vorgangstabelle verwendet werden.

    • Operation auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um eine Operation auszuwählen. Es kann nur eine Operation ausgewählt werden. Die für jede Operation verfügbaren Informationen werden vom Workday Endpoint abgerufen:

      • Name: Der Operation vom Workday.

      • Beschreibung: Die Operation von Workday.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Vorgängen gefüllt ist, wird die Workday-Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Einstellungen festlegen

Tab „Verbindungen“

  • Bei Fehler fortfahren: Wählen Sie diese Option aus, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Charge-Anforderung ein Fehler auftritt. Wenn Fehler auftreten, werden sie in das Operation geschrieben.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Schema überprüfen

Tab „Verbindungen“

  • Datenschema: Die Anforderungs- und Antwortdatenschemata von Workday werden angezeigt. Wenn der Operation eine Transformation verwendet, werden die Datenschemata später während des Transformation erneut angezeigt, wo Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    Der Workday Connector verwendet die Workday Web Services (WWS) API Versionen 32.0 bis 43.0, abhängig von der in einer Workday-Verbindung ausgewählten Version. Informationen zu den Schema finden Sie in der API Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Endpoint aus neu zu generieren. Diese Aktion generiert das Schema auch an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Workday Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie weitere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Workday, die als Quelle verwendet werden, können mit diesen Operation verwendet werden:

Andere Muster sind bei Verwendung von Workday-Aktivitäten, die als Quelle verwendet werden, nicht gültig.

Als Ziel verwendete Workday können mit den folgenden Operation verwendet werden:

Andere Muster sind bei Verwendung von Workday-Aktivitäten, die als Ziel verwendet werden, nicht gültig.

Siehe die Validierungsmuster auf der Operationsgültigkeit Seite.

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Bei Vorgängen, die Workday-Aktivitäten verwenden, können auch Operation so konfiguriert werden, dass sie bei einem SOAP Fehler ausgelöst werden - einem Fehler, der auf ein falsches Nachrichtenformat, eine falsche Header-Verarbeitung oder eine Inkompatibilität zurückzuführen ist. Vorgangsaktionen können so konfiguriert werden, dass nach Auftreten eines SOAP Fehlers eine Operation Durchführen oder eine Email gesendet wird. Anweisungen zum Auslösen einer Aktion bei einem SOAP Fehler finden Sie unter Vorgangsaktionen.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation prüfen.