Integrationsabruf einrichten (Englisch).

Administrator Guide

Sicherheit: Domänen Business Process Administration
und Manage: Business Process Definitions
im funktionalen Bereich „System“.

Um ein Integrationsdokument von einem externen Standort abzurufen, fügen

Sie

den Schritt Dokumentabrufservice
zum Integrationsgeschäftsprozess hinzu. Der Schritt beschreibt die Optionen für Dateiauswahl, Transport und Entschlüsselung für die Integrationsdatei.

Mit dem Dokumentabruf können Sie auch die Ausgabe eines benutzerdefinierten Berichts abrufen. In diesem Fall geschieht beim Dokumentabruf Folgendes:

Ruft die Daten aus Workday ab.

Die Berichtsausgabe wird im Repository Meine Berichte gespeichert, damit sie von einem nachfolgenden Integrationsschritt verwendet werden kann.

Öffnen Sie die Geschäftsprozessdefinition, der Sie den Schritt hinzufügen möchten.

Fügen Sie dem Geschäftsprozess einen Schritt Dokumentabrufservice
hinzu

wenn die Geschäftsprozessdefinition noch keinen enthält.

Wählen Sie

Dokumentabruf konfigurieren

Geben Sie im Feld

Aufbewahrungsrichtlinie für Dokument

die Anzahl der Tage ein, für die Workday die vom Geschäftsprozess importierten Dateien speichert.

Wählen Sie im Abschnitt

Dokument-Tags

alle Dokument-Tags aus, die Workday auf die eingehenden Dateien anwenden soll.

Geben Sie im Abschnitt

Abrufeinstellungen

die Abrufkonfiguration an:

Option	Bezeichnung
Für manuellen Dateianhang vorgesehene Gruppen	Um eine oder mehrere Dateien manuell für den Import anzuhängen, geben Sie eine Segmentsicherheitsgruppe an, die eine Geschäftsprozessanforderung erhält.
Datei(en) von externem Speicherort abrufen	Wählen Sie einen vorhandenen Service für die Integrationsübermittlung aus.

Wählen Sie die

Option für den Dateinamen

für den Abruf aus:

Option	Bezeichnung
Dateiname/Muster	Ermöglicht Workday die Suche nach Dateien mit einem bestimmten Namensmuster auf einem Remote-Endpunkt.
Sequenzgenerator	Ermöglicht Workday die Suche nach Dateien mit einem bestimmten sequenziellen Dateinamenmuster an einem Remote-Endpunkt.

(Nur Dateiname/Muster) Führen Sie im Abschnitt

Datei(en) folgende

Schritte aus:

Geben Sie den Dateinamen oder das Dateinamen-Muster als regulären Ausdruck für die Datei ein, die Sie von einem externen Endpunkt in Workday hochladen möchten.

In diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Workday unterstützt keine vollständige Regex-Syntax für den Dateiabruf. Workday unterstützt im Dateinamenmuster nur die Zeichen (*) und (?) als Wildcards.

Für den Amazon Simple Storage Service (S3) akzeptiert Workday (*) und (?).

Für S3-Transporte können Sie Dateien aus Ordnern mithilfe des Formats Ordner1/OrdnerN/Dateiname.Format
abrufen.

Geben Sie im Abschnitt

Datei(en)

den MIME-Typ unter Verwendung der Werteliste

Common Content Type

an, geben Sie einen

Benutzerdefinierten Inhaltstyp

an oder wählen Sie Keine der Optionen
aus.

Workday wendet den angegebenen MIME-Typ auf alle Dateien an, die vom Integrationssystem abgerufen werden.

(Nur Sequenzgenerator) Geben Sie Optionen für die Dateinamen-Sequenz an.

Wenn ein Prozess mehrere Anforderungen für die nächste Sequenznummer sehr nahe beieinander generiert, versucht Workday, die Sequenznummern zu generieren. Dieser Prozess kann zu übersprungenen, nicht fortlaufenden Nummern führen.

Option	Bezeichnung
Sequenz-ID erhöhen um	Geben Sie einen Wert ungleich 0 ein, um den die Sequenznummer jedes Mal erhöht wird, wenn Workday eine neue ID generiert.
Padding	Verwenden Sie Padding , um die Anzahl der in der Sequenz vorhandenen Stellen anzugeben. Geben Sie einen ausreichend großen Padding-Wert ein, damit in der Sequenz keine Überlaufbedingung auftritt. Workday empfiehlt einen Padding-Wert von mindestens 6. Wenn die Sequenz die Anzahl der hier eingegebenen Stellen überschreitet, bestimmt die Einstellung Überlaufverhalten für Sequenz-ID die nächste Zahl in der Sequenz. Wenn Sie 0 eingeben oder keinen Wert im Feld Padding eingeben, gilt Folgendes: Die Sequenznummer wird auf unbestimmte Zeit erhöht. Workday füllt für Überlaufverhalten für Sequenz-ID die Option Padding automatisch ignorieren aus .
Sequenz-ID-Format	Geben Sie ein Format für die ID an. Sie können jede Textzeichenfolge mit diesen vier speziellen Variablen verwenden. Die datumsbezogenen Werte stellen das Datum dar, an dem die Aufgabe die ID generiert. [seq] – Die Sequenznummer. Sie erhöht sich um den Wert, der im Feld Sequenz-ID erhöhen nach angegeben ist, mit der Anzahl der im Feld Padding angegebenen Stellen. Workday verwendet eine separate Sequenz für jede ID-Definition, die diese Variable verwendet. [day]: Tag des Monats im zweistelligen Format, 01 - 31. [month] – Monat im zweistelligen Format, 01 – 12. [year] – Jahr im vierstelligen Format. Beispiel: 2020. Wenn Sie das Intervall Neustartintervall festlegen, stellen Sie sicher, dass die generierte Sequenznummer eindeutig ist, indem Sie die spezifische Zeitperiode in das Format aufnehmen. Beispiel: Wenn die Zeitperiode Neustartintervall Monat ist, geben Sie [month] und [year] im Format an. Stellen Sie sicher, dass der Padding-Wert groß genug ist, damit beim Sequenzgenerator während der Zeitperiode keine Überlaufbedingung auftritt. Beispielsweise können Sie das Dateinamenformat definieren, indem Sie Folgendes eingeben: Eine Zeichenfolgenkonstante Ein Muster für Datum und Uhrzeit. Sequenznummermuster Die Dateierweiterung. Workday kann nur Datumswerte und eine Sequenznummer zur Verwendung im Dateinamen dynamisch generieren. Alle anderen Werte sind statisch. Sie sind für alle von der Integration generierten Dateien identisch. Bewegen Sie den Cursor über dieses Feld, um die vollständige Liste der gültigen Muster für Sequenzgenerator und Datum/Uhrzeit anzuzeigen.
Neustartintervall	(Optional) Um den Wert [seq] in regelmäßigen Zeitintervallen auf einen Anfangswert zurückzusetzen, geben Sie an, wie oft Workday die Sequenznummern zurücksetzen soll. Die Optionen sind „Tag“ , „Monat“ oder „Jahr “. Lassen Sie das Feld leer, wenn [seq] in dieser ID-Definition eindeutig sein soll. Die Tage beginnen um 00:01 Uhr. Die Monate beginnen um 00:01 Uhr am ersten dieses Monats. Die Jahre beginnen am 1. Januar um 00:01 Uhr.
Neustartnummer	(Optional) Um den Wert [seq] in regelmäßigen Zeitintervallen auf einen Anfangswert zurückzusetzen, geben Sie die Zahl an, die Workday beim Neustart von Sequenznummern verwendet. Sie können dieses Feld mit dem Feld Neustartintervall verwenden.
Zeitzonenverwendung	Eine alternative Zeitzone, auf der das im Feld Neustartintervall angegebene Intervall basieren soll. Dieser Wert gibt nicht an, wann die ID-Generierung tatsächlich erfolgt. Workday verwendet sie nur, um das Datum in der angegebenen Zeitzone zu lokalisieren. Wenn Sie keine Zeitzone angeben, verwendet Workday die nordamerikanische Westküsten-Normalzeit/Pacific Daylight Time (PST/PDT).
Überlaufverhalten für Sequenz-ID	Konfigurieren Sie, wie Workday mit potenziellen Überlaufbedingungen umgehen soll. Bei der Bearbeitung des Felds sind folgende Informationen zu beachten: Überlauf mit abgeschnittenen Sequenzen zulassen : Workday schneidet die höchstwertige Stelle der Sequenznummer ab, wenn eine Überlaufbedingung auftritt. Beispiel: Bei einem Padding- Wert von 3 ist die nächste Sequenznummer nach 999 1000, aber die „1“ wird abgeschnitten, sodass der nächste Wert als „000“ angezeigt wird. Padding automatisch ignorieren : Der Sequenzgenerator ignoriert den Padding -Wert, wenn eine Überlaufbedingung auftritt. Beispiel: Bei einem Padding -Wert von 3 ist die nächste Sequenznummer nach 999 1000. Wenn der Wert für Padding 0 ist, wählt Workday diese Option automatisch.
Gruppe von Überlaufbenachrichtigungen für Mandanten-Setup überschreiben	Geben Sie Sicherheitsgruppen an, die die Default-Gruppe für Überlaufbenachrichtigungen für Mandanten-Setup überschreiben sollen. Workday sendet automatisch eine Benachrichtigung an die Sicherheitsgruppen für Überlaufbenachrichtigungen, wenn sich die Sequenz dem durch den Wert Padding vorgegebenen Grenzwert nähert. Wenn Sie in diesem Feld keine Sicherheitsgruppen auswählen, sendet Workday diese Überlaufbenachrichtigungen an: Die Sicherheitsgruppen, die Sie im Feld Default Sequenzgenerator-Benachrichtigungsgruppe in der Aufgabe Mandanten-Setup bearbeiten - System auswählen. Die Standardsicherheitsgruppen, die Workday für Überlaufbenachrichtigungen angibt, wenn Sie in der Aufgabe Mandanten-Setup bearbeiten - System keine Standardsicherheitsgruppen für Überlaufbenachrichtigungen auswählen.
Standard für Gruppe von Überlaufbenachrichtigungen für Mandanten-Setup	Zeigt die Standardgruppe für Überlaufbenachrichtigungen für Mandanten-Setup an. Workday sendet automatisch eine Benachrichtigung an die Sicherheitsgruppen für Überlaufbenachrichtigungen, wenn sich die Sequenz dem durch den Wert Padding vorgegebenen Grenzwert nähert.
Letzte verwendete Sequenz	Setzt die letzte Sequenznummer manuell. Diese Option ist in folgenden Fällen hilfreich: Sie haben zuvor eine andere Anwendung zur ID-Generierung verwendet. Sie möchten dort fortfahren, wo die ID geendet hat. Wenn Sie die Nummer festlegen, ist die anfängliche Sequenznummer Ihre Nummer plus die Sequenz-ID erhöhen nach Wert.
Letztes verwendetes Datum	Geben Sie dieses Datum plus ein Intervall für Neustartintervall an, um zu bestimmen, ob das Datum vor oder nach dem letzten Neustartintervall liegt. Workday legt dann die Sequenznummer basierend auf dem Datum fest.
Kleine Datenmenge	(Optional) Wählen Sie diese Option, um sicherzustellen, dass vom Sequenzgenerator generierte Sequenzen keine Lücken enthalten. Verwenden Sie diese Option, wenn Sie beide der folgenden Situationen auftreten: Sie verwenden die Sequenz nicht für Transaktionen mit großen Datenmengen. In der generierten Sequenz treten unerwünschte Lücken auf.

Wählen Sie im Abschnitt

Transport

ein Transportprotokoll aus und konfigurieren Sie es:

Transport	Hinweise
Amazon Simple Storage Service	Fügen Sie Ihrem IAM-Benutzer für S3-Transporte ein Tag mit dem Schlüssel der Art Workday und dem Wert Integration hinzu . Dieses Tag unterscheidet zwischen Groß- und Kleinschreibung und ignoriert Leerzeichen nicht. Geben Sie den Namen Ihres S3-Bucket in das Feld Bucket ein. Sie können in diesem Feld keinen Ordner angeben. Geben Sie einen Schlüsselalias für die clientseitige AWS KMS-Verschlüsselung ein. Die PGP-Verschlüsselung (Pretty Good Privacy) ist für EIBs, die Amazon Simple Storage verwenden, nicht konfigurierbar. Aktivieren Sie das Kontrollkästchen Transferbeschleunigung aktivieren , um die Übertragungsgeschwindigkeit zu erhöhen. Wenn Sie eine Option aus der Werteliste Object Storage Class auswählen, müssen Sie die Speicherklasse nicht manuell in Amazon Simple Storage Service aktualisieren.
Benutzerdefinierter Bericht	Alle benutzerdefinierten Berichte, die als Webservice aktiviert sind, werden in der Werteliste Benutzerdefinierter Bericht angezeigt. Wertart und Wert : Geben Sie Wert an . Geben Sie den Wert ein, den Workday bei jeder Ausführung als Integrationskriterium verwenden soll. Wert zur Laufzeit festlegen . Wählen Sie das Feld aus, das Workday bei jeder Ausführung verwenden soll, um den Wert zu bestimmen. Systemstandard verwenden verwendet den Wert, der in der Definition der Enterprise-Schnittstelle konfiguriert wurde.
FTP	Geben Sie die Adresse in folgendem Format ein (wenn Sie keine Portnummer angeben, verwendet Workday die Standardvorgabe): ftp://xxxx:port-number . Für dieses Transportprotokoll müssen Sie die ausgehende Datei verschlüsseln, indem Sie ein PGP-Zertifikat mit öffentlichem Schlüssel aus der Werteliste Verschlüsseln mit auswählen. Bei Verzeichnisnamen muss die Groß-/Kleinschreibung beachtet werden. Verwenden Sie einen führenden Schrägstrich (/) nur für einen vollständigen Pfad, nicht für einen relativen Pfad. Aktivieren Sie das Kontrollkästchen Temp-Datei verwenden , um die Ausgabe in eine Datei mit zufälligem Namen zu schreiben. Workday benennt die Datei in den richtigen Namen um, wenn die Datenübertragung abgeschlossen ist. Diese Option verhindert, dass automatische Skripte die Datei vom FTP-Server abrufen, bevor die Datenübertragung abgeschlossen ist.
FTP/SSL	Verwenden Sie folgende Formate: Implicit SSL: ftpsi://x.x.x.x:port-number Explicit SSL: ftpse://x.x.x.x:port-number Wenn Sie keine Portnummer angeben, verwendet Workday Port 990 für implizites SSL und Port 21 für explizites SSL. Bei Verzeichnisnamen muss die Groß-/Kleinschreibung beachtet werden. Verwenden Sie einen führenden Schrägstrich (/) nur für einen vollständigen Pfad, nicht für einen relativen Pfad. Aktivieren Sie das Kontrollkästchen Temp-Datei verwenden , um die Ausgabe in eine Datei mit zufälligem Namen zu schreiben. Workday benennt die Datei in den richtigen Namen um, wenn die Datenübertragung abgeschlossen ist. Diese Option verhindert, dass automatische Skripte die Datei vom FTP-Server abrufen, bevor die Datenübertragung abgeschlossen ist.
REST	Geben Sie den Hostnamen oder die Serveradresse in folgendem Format ein: http://www.example.com/rest/ .
SFTP	Geben Sie die Adresse in folgendem Format ein (wenn Sie keine Portnummer angeben, verwendet Workday die Standardvorgabe): sftp://xxxx:port-number . Bei Verzeichnisnamen muss die Groß-/Kleinschreibung beachtet werden. Verwenden Sie einen führenden Schrägstrich (/) nur für einen vollständigen Pfad, nicht für einen relativen Pfad. Aktivieren Sie das Kontrollkästchen Temp-Datei verwenden , um die Ausgabe in eine Datei mit zufälligem Namen zu schreiben. Workday benennt die Datei in den richtigen Namen um, wenn die Datenübertragung abgeschlossen ist. Diese Option verhindert, dass automatische Skripte die Datei vom FTP-Server abrufen, bevor die Datenübertragung abgeschlossen ist. Sie können auch einen Fingerabdruck für Host-Schlüssel angeben, um den Verschlüsselungsschlüssel anzugeben, den der FTP-Server für die SSH-Kommunikation verwendet. Legen Sie die Blockgröße auf eine Blockgröße fest, die der SFTP-Endpunkt unterstützt. Wenn nicht angegeben, verwendet Workday 32K . Durch eine Erhöhung der Blockgröße kann die Übermittlungs-Performance verbessert werden. Wenn der Endpunkt die ausgewählte Blockgröße nicht unterstützt, schlägt die Integrationsübermittlung fehl. Workday empfiehlt dringend, die Blockgröße mit dem Feature Test Transport zu testen. Nachdem Sie die optimale Blockgröße gefunden haben, aktualisieren Sie die Konfiguration der Dokumentenübermittlung für diese Blockgröße.

(Nur erforderlich für Transport von benutzerdefinierten Berichten
.) Wählen Sie im Abschnitt

Berichtsoptionen

den Benutzer aus, dessen Zugangsdaten Workday zum Ausführen des benutzerdefinierten Berichts verwendet.

Workday zeigt die

Werteliste Bericht(e) ausführen als Benutzer

im Abschnitt

Berichtsoptionen

nur an, wenn Sie im vorherigen Schritt Benutzerdefinierter Bericht ausgewählt haben.

Geben Sie im Abschnitt

Dateidienstprogramme

eine oder mehrere der folgenden Optionen an:

Option	Bezeichnung
Nach Abruf löschen	Wenn Workday die Datei nicht vom S/FTP/S-Quellserver löschen kann, schlägt der Dokumentabruf fehl.
Dekomprimieren	Wählen Sie diese Option, um die eingehende Datei zu dekomprimieren.
Entschlüsseln mit	(Nur FTP, FTP/SSL und SFTP) Wenn Sie die hochgeladene Datei mit Pretty Good Privacy (PGP) entschlüsseln möchten, wählen Sie den privaten PGP-Schlüssel des Schlüsselpaars aus, das Sie zum Entschlüsseln der eingehenden Integrationsdatei generiert haben. Wenn Sie FTP-, FTP/SSL- oder SFTP-Protokolle zur Verschlüsselung einer ausgehenden Integrationsdatei verwenden, haben Sie folgende Möglichkeiten: Schließen Sie eine Integritätsprüfung der Daten in der Datei ein. Signieren Sie die Datei digital.
Integritätsprüfung erzwingen	(Nur FTP, FTP/SSL und SFTP) Aktivieren Sie dieses Kontrollkästchen, um zu prüfen, ob die verschlüsselte Datei während des Transports nicht verändert oder beschädigt wurde.
Digitale Signatur validieren mit	(Nur FTP, FTP/SSL und SFTP) Um den Ursprung der verschlüsselten eingehenden Datei zu verifizieren, wählen Sie einen öffentlichen PGP-Schlüssel aus, der von Ihrem Handelspartner bereitgestellt wird.

(Optional) Wählen Sie im Abschnitt

Umgebungsbeschränkungen

in der Werteliste

Beschränkt auf

die Zielumgebung für dieses Transportprotokoll.

Wenn Sie dieses Feld leer lassen, wendet Workday das Transportprotokoll auf jede Umgebung an, in der die Integration ausgeführt wird. Jede Umgebung (Produktion, Sandbox, Implementierung usw.) kann nur ein Transportprotokoll haben. Um zu vermeiden, dass Testdaten versehentlich in oder von einem Nicht-Test-Endpunkt hochgeladen werden, empfiehlt Workday dringend:

Erstellen Sie einen separaten Transport für jede Umgebung.

Beschränken Sie jeden Transport auf die vorgesehene Umgebung.

Nachdem die Integration ausgeführt wurde, ruft das Integrationsprozessereignis die ausgewählten Dateien basierend auf diesen Anweisungen von einem externen Server ab.