Zum Hauptinhalt wechseln
Dokumentation
Dokumentation
Workday User Guide
Zuletzt aktualisiert: 2023-11-03
Schritte: Dataset mit externen Daten erstellen (SFTP Server)

Schritte: Dataset mit externen Daten erstellen (SFTP Server)

Sicherheit: Domäne
Prism Datasets: Create
 im funktionalen Bereich „Prism Analytics“.
Sie können ein Basis-Dataset mit externen Daten erstellen, indem Sie Daten von einem SFTP-Server übertragen. Möglicherweise möchten Sie ein Basis-Dataset erstellen, das seine Daten von einem externen Server abruft, wenn der Server regelmäßig neue Daten erfasst oder hinzufügt. Sie konfigurieren, wie oft das Dataset neue Daten vom Server erhält.
Wenn Sie neu in Workday sind, haben Sie keinen Zugriff, um Basis-Datasets zu erstellen oder zu bearbeiten.
Für Integrationsläufe, die Daten vom SFTP-Server übertragen, gilt Folgendes:
  • Die Anzahl der Dateien muss kleiner als 5.000 sein.
  • Die Zeit bis zur Übermittlung der Daten muss weniger als 5 Stunden betragen.
Jede Datei auf dem Server sollte weniger als 1 GB komprimiert haben (ungefähr weniger als 10 GB unkomprimiert).
  1. Öffnen Sie den Bericht
    Datenkatalog
     .
  2. Wählen Sie
    Create
    from SFTP aus
    .
    In der Aufgabe
    Dataset-Abruf erstellen - Datei-Abruf konfigurieren
     konfigurieren Sie, wie die Daten vom SFTP-Server importiert werden.
  3. Geben Sie im Abschnitt
    Dateien
     den Dateinamen oder ein Dateinamensmuster ein, das für eine oder mehrere Dateien steht.
    Beim Dateinamen wird zwischen Groß- und Kleinschreibung unterschieden. Sie können die Zeichen „Sternchen (*)“ und „Fragezeichen“ (?) als Wildcards verwenden, um ein Dateinamensmuster anzugeben. Verwenden Sie das Sternchen (*), um 0 oder mehr Zeichen anzugeben, und das Fragezeichen (?), um genau 1 Zeichen anzugeben.
  4. Geben Sie im Abschnitt
    Transport
    an, wie die Verbindung zum SFTP-Server hergestellt werden soll:
    Option Bezeichnung
    SFTP-Adresse
    Verwenden Sie dieses Format:
    sftp://
    domain_name
    oder
    sftp://
    IP_address
    Um eine Portnummer anzugeben, fügen Sie diese am Ende des Domänennamens oder der IP-Adresse hinzu. Wenn Sie keine Portnummer angeben, verwendet Workday Port 22.
    Verzeichnis
    (Optional) Das Verzeichnis auf dem Server, in dem sich die Dateien befinden. Bei Verzeichnisnamen wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie einen führenden Schrägstrich (/) nur für einen vollständigen Pfad, nicht für einen relativen Pfad.
    Temp-Datei verwenden
    Die importierten Daten werden mit einem zufällig generierten Namen in eine temporäre Datei in Workday geschrieben. Nach Abschluss des Datenimports benennt Workday die Datei automatisch in den richtigen Namen um.
    Sie sollten diese Option aktivieren, wenn der Datenimport sehr lange dauert und möglicherweise nicht vor dem nächsten geplanten Zeitpunkt für den Datenimport von demselben Server abgeschlossen wird.
    Authentifizierungsmethode und Details
    Wählen Sie die Art der Sicherheitsauthentifizierung aus, die der SFTP-Server verwendet:
    • Benutzername/Kennwort
      .
    • SSH-Authentifizierung
      . Diese Option verwendet die sichere Shell-Schlüssel-Authentifizierung mithilfe von X.509-Zertifikaten.
  5. (Optional) Berücksichtigen Sie im Abschnitt
    Dateidienstprogramme
     die folgenden Optionen:
    Option Bezeichnung
    Nach Abruf löschen
    Die Dateien auf dem SFTP-Server werden gelöscht, nachdem die Daten in das Dataset importiert wurden. Wenn Workday die Dateien nicht vom SFTP-Server löschen kann, schlägt der Datenabruf fehl.
    Drucken Sie dekomprimieren
    Aktivieren Sie diese Option nicht für Datasets.
    Sie können Dateien übertragen, die komprimiert sind oder nicht. Für komprimierte Dateien unterstützt Workday nur die gzip-Komprimierung.
    Entschlüsseln mit
    Wenn Sie die importierten Dateien mit Pretty Good Privacy (PGP) entschlüsseln möchten, wählen Sie ein privates PGP-Schlüsselpaar.
  6. (Optional) Wählen Sie im Abschnitt
    Umgebungsbeschränkungen
     aus der Werteliste
    Beschränkt auf
     die Umgebung, in der Sie die im Abschnitt
    Transport
     definierten Einstellungen verwenden möchten.
    Wenn Sie diese Option leer lassen, wendet Workday die Transporteinstellungen auf jede Umgebung an, in der die Dataset-Integration ausgeführt wird. Wenn eine Dataset-Integration in einer bestimmten Umgebung ausgeführt wird, z. B. Implementierung oder Produktion, funktionieren die Transporteinstellungen nur, wenn die Option
    Beschränkt auf
     mit der aktuellen Umgebung übereinstimmt. Wenn die aktuelle Umgebung und die konfigurierte Umgebung nicht übereinstimmen, schlägt die Dataset-Integration fehl und es werden keine Dateien vom SFTP-Server abgerufen. Möglicherweise möchten Sie die Transporteinstellungen auf eine bestimmte Umgebung beschränken, um zu vermeiden, dass Testdaten versehentlich an einen Nicht-Test-Endpunkt übertragen werden.
    Beispiel: Sie erstellen das Dataset in einer Implementierungsumgebung und wählen Implementierung in
    Beschränkt auf
    . Wenn Sie dieses Dataset später in eine Produktionsumgebung migrieren, schlägt die Integration bei der nächsten Ausführung der Dataset-Integration fehl. Um sicherzustellen, dass die Dataset-Integration in der Produktionsumgebung erfolgreich ausgeführt wird, bearbeiten Sie die Details der Dataset-Integration und deaktivieren Sie entweder das Kontrollkästchen
    Beschränkt auf
     oder ändern Sie es in "Produktion".
  7. Geben Sie in der Aufgabe
    Dataset-Abruf erstellen - Anforderungsart planen
     unter
    Laufintervall
    an, wie oft Daten vom SFTP-Server importiert werden sollen.
    Wenn Sie die Daten einmal in der Zukunft oder nach einem Zeitplan importieren, geben Sie die Kriterien für beide in der Aufgabe
    Dataset-Abruf erstellen - Integration mit Zeitplan an
     .
    Nachdem das Dataset erstellt wurde, können Sie die Integration ausführen, um Daten ad hoc in das Dataset zu übertragen. In den möglichen Aktionen für den Bericht
    Dataset-Details anzeigen
     wählen Sie
    Dataset
    Run Integration Now
    .
    Sie können Daten nicht zu Zeiten in dasselbe Dataset übertragen, die sich überschneiden.
  8. Geben Sie einen eindeutigen Namen für das Dataset an.
    Der Name des Datasets wird im Datenkatalog angezeigt. Sie können den Namen ändern, wenn Sie das Dataset erstellen, bearbeiten oder kopieren.
  9. (Optional) Ändern Sie den API-Namen des Datasets. Workday wählt automatisch einen API-Namen basierend auf dem von Ihnen eingegebenen Dataset-Namen aus und ändert ihn, damit er den Namensanforderungen entspricht. Sie können diesen Namen nicht mehr ändern, nachdem Sie das Dataset erstellt haben.
  10. (Optional) Erstellen oder bearbeiten Sie ein oder mehrere Tags, um das Dataset im Datenkatalog zu organisieren.
  11. (Optional) Fügen Sie eine Beschreibung hinzu, damit andere die Daten in diesem Dataset besser verstehen. Sie können die Beschreibung ändern, wenn Sie das Dataset bearbeiten.
  12. Wählen Sie aus, wie die Daten im Dataset aktualisiert werden sollen, wenn dieses neue Daten aus einem Integrationslauf erhält.
    Option Bezeichnung
    Ersetzen
    Workday löscht die vorhandenen Daten im Dataset und ersetzt sie durch die Daten, die vom SFTP-Server importiert werden.
    Anhängen
    Workday behält die vorhandenen Daten im Dataset und fügt sie zu den neuen Daten hinzu, die vom SFTP-Server importiert werden.
    Workday importiert bei jedem Integrationslauf alle Daten in allen Dateien. Der Anhängen-Modus unterscheidet sich von der schrittweisen Aktualisierung von Daten in einem Dataset. Ob die Daten im Dataset schrittweise aktualisiert werden, hängt davon ab, ob der SFTP-Server seit dem letzten Integrationslauf nur inkrementelle Aktualisierungen enthält.
    Das Dateischema muss die folgenden Anforderungen erfüllen:
    • Alle Dateien in jedem Integrationslauf müssen dieselben Parsing-Optionen verwenden (einschließlich der Konfiguration der Header-Zeile), die beim ersten Integrationslauf verwendet wurden.
    • Die Felder müssen in allen Dateien bei jedem Integrationslauf in derselben Reihenfolge sein.
    • Wenn das Schema in einem nachfolgenden Integrationslauf neue Felder enthält, müssen sich die neuen Felder am Ende aller vorherigen Felder befinden.
    • Wenn das Dateischema in einem nachfolgenden Integrationslauf ein oder mehrere Felder löscht, müssen sich die gelöschten Felder am Ende befinden.
    • Stellen Sie sicher, dass, wenn das Schema Felder löscht, in keinem zukünftigen Schema neue Felder hinzugefügt werden. Andernfalls schlägt der Integrationslauf fehl. Um sicherzustellen, dass alle zukünftigen Integrationen erfolgreich ausgeführt werden, lassen Sie immer vorhandene Felder im Schema und fügen Sie nur neue Felder hinzu. Bei Bedarf können Sie leere Werte (NULL) in vorhandene Felder aufnehmen.
    • Alle Dateien in einer einzelnen Integration müssen dasselbe Schema verwenden.
    Eine Integration schlägt fehl, wenn das Schema der neuen Daten kein Feld enthält, das derzeit im Dataset vorhanden ist, und das entfernte Feld in einer Phase im Dataset verwendet wird. Beispiel: Wenn das Dataset eine Phase „Felder verwalten“ enthält und die Integration Daten einschließt, für die ein Feld im Dataset fehlt, schlägt die Integration fehl. Dies liegt daran, dass die Phase „Felder verwalten“ für jedes Feld im Dataset ausgeführt wird.
  13. Klicken Sie auf
    Speichern
    .
    Workday erstellt das Dataset, es enthält jedoch keine Daten, bis Workday die Daten und Felder während des ersten Integrationslaufs vom SFTP-Server importiert. Je nachdem, wann Sie den Datenimport geplant haben, ist das Dataset möglicherweise für einige Zeit leer. Workday fügt außerdem zwei Felder hinzu, die Informationen zu jedem Integrationslauf enthalten. Siehe: Referenz: WPA_Felder.
  14. (Optional) Ändern Sie den Namen Ihres Integrationszeitplans. Siehe: Zeitpläne für Dataset-Integration verwalten.
  15. Öffnen Sie den Bericht
    Datenkatalog
     , klicken Sie mit der rechten Maustaste auf das gerade erstellte Dataset und wählen Sie
    „Bearbeiten“
    .
  16. Konfigurieren Sie, wie die Daten in den Dateien des SFTP-Servers geparst werden.
  17. Sie können nur einige Phasenarten zu Basis-Datasets hinzufügen.
  18. Sie können zu jeder Phase ein berechnetes Prism-Feld hinzufügen.

Dieser Inhalt ist nicht Teil des Workday Administrator Guides.