Zum Inhalt springen

Workday-Aktivität

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 einem Vorgang verwendet. Nach der Konfiguration einer Workday-Verbindung können Sie beliebig viele Workday-Aktivitäten für jede Workday-Verbindung konfigurieren. Workday-Aktivitäten können sowohl mit Standard- als auch mit benutzerdefinierten Objekten verwendet werden.

Erstellen einer Workday-Aktivität

Eine Instanz einer Aktivität wird aus einer Verbindung unter Verwendung eines Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

Zugriff auf Menüaktionen

Menüaktionen für eine Aktivität sind über den Projektbereich und die Entwurfsfläche zugänglich. Für Details siehe Aktivitätsaktionsmenü 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: Wählen Sie einen Workday-Webdienst

  • Name: Geben Sie einen Namen ein, um die Workday-Aktivität zu identifizieren. Der Name muss für jede Aktivität (des gleichen Typs) eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Wählen Sie einen Dienst: In diesem Abschnitt werden die in der Workday-Endpunkt verfügbaren Webdienste angezeigt. Beim erneuten Öffnen einer bestehenden Aktivitätskonfiguration wird nur der ausgewählte Webdienst angezeigt, anstatt die gesamte Liste der Webdienste neu zu laden.

    Vorsicht

    Die 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 eine andere Workday WSDL-Version in der Workday-Verbindung.

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

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Webdienste zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Webdienste bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Webdienste vom Endpunkt beim Suchen 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-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich Webdienste zur Workday-Instanz hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle der Webdienste verwendet werden.

    • Wählen Sie einen Dienst aus: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um einen Webdienst auszuwählen. Es kann nur ein Webdienst ausgewählt werden. Die Informationen, die für jeden Webdienst verfügbar sind, werden vom Workday-Endpunkt abgerufen:

      • Name: Der Name des Webdienstes aus Workday.
      • Beschreibung: Die Beschreibung des Webdienstes aus Workday.

    Tipp

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

  • Speichern & Beenden: Wenn aktiviert, klicken Sie, 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 zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Wählen Sie eine Workday-Operation

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

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

    • Ausgewählte Workday-Operation: Nachdem eine Operation ausgewählt wurde, wird sie hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Operationen zu filtern. Die Suche ist nicht groß-/kleinschreibungssensitiv. Wenn Operationen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Operationen vom Endpunkt beim Suchen 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 die Operationen vom Workday-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich Operationen zur Workday-Instanz hinzugefügt haben. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle von Operationen verwendet werden.

  • Wählen Sie eine Operation aus: Klicken Sie innerhalb der Tabelle auf eine Zeile, um eine Operation auszuwählen. Es kann nur eine Operation ausgewählt werden. Die Informationen zu jeder Operation werden vom Workday-Endpunkt abgerufen:

    -   **Name:** Der Operationsname von Workday.

-   **Beschreibung:** Die Operationsbeschreibung von Workday.

    Hinweis

    Wenn die Tabelle nicht mit verfügbaren Operationen gefüllt wird, könnte die Workday-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

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

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

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Einstellungen festlegen

  • Bei Fehlern fortfahren: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im Operationsprotokoll protokolliert.

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

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

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Datenschema überprüfen

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

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Endpunkt neu zu generieren. Diese Aktion regeneriert auch das Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie, 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: Nach Änderungen klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Workday-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Workday-Aktivitäten, die als Quelle verwendet werden, können mit diesen Betriebsmustern verwendet werden:

Andere Muster sind nicht gültig, wenn Workday-Aktivitäten als Quelle verwendet werden.

Workday-Aktivitäten, die als Ziel verwendet werden, können mit diesen Betriebsmustern verwendet werden:

Andere Muster sind nicht gültig, wenn Workday-Aktivitäten als Ziel verwendet werden.

Siehe die Validierungsmuster auf der Betriebsvalidität 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.

Operationen, die Workday-Aktivitäten verwenden, können auch Betriebsaktionen konfiguriert haben, die bei einem SOAP-Fehler ausgelöst werden — ein Fehler, der aus einem falschen Nachrichtenformat, der Verarbeitung von Headern oder Inkompatibilität resultiert. Betriebsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine Email senden, nachdem ein SOAP-Fehler aufgetreten ist. Für Anweisungen zum Auslösen einer Aktion bei einem SOAP-Fehler siehe Betriebsaktionen.

Wenn Sie bereit sind, implementieren und führen Sie die Operation aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.