Um diesen Inhalt richtig anzuzeigen, müssen Sie JavaScript aktivieren
Einführung
In diesem Tutorial wird eine Oracle Integration Cloud-(OIC-)Integration erstellt, um Daten mit HCM Data Loader (HDL) in Oracle HCM Cloud hochzuladen. Die Quelldatei wird von einem FTP-Server gelesen, entschlüsselt, entpackt, in die Ausprägung der HDL-Geschäftsobjektdatei transformiert, bevor sie komprimiert, verschlüsselt und in Oracle WebCenter hochgeladen wird. Schließlich wird HCM Data Loader initiiert, um die Daten in die Datei zu importieren und zu laden.
Die in diesem Tutorial angegebenen Schritte können für jede eingehende Integration mit HDL verwendet werden. Führen Sie die Schritte mithilfe der bereitgestellten Dateien aus, um eine Integration für Neueinstellungen zu erstellen.
Ziele
In diesem Tutorial erfahren Sie, wie Sie:
Entschlüsseln und entpacken Sie Quelldateien, die auf einem FTP-Server gehostet werden.
Transformieren Sie Quelldaten in eine HDL-Geschäftsobjektdateiausprägung.
Komprimieren, verschlüsseln und laden Sie die transformierte Datei in Oracle WebCenter hoch.
HCM DataLoader initiieren.
Voraussetzungen
Um die Schritte in diesem Tutorial auszuführen, benötigen Sie Zugriff auf Folgendes:
Oracle Integration Cloud (OIC), um diese Integration zu erstellen.
Ein FTP-Server zum Hosten von Quelldateien.
PGP-Verschlüsselungsschlüsselpaar zum Verschlüsseln der Quelldatei.
Sicherheitskonsole zum Erstellen von Benutzeraccounts.
Außerdem müssen Sie die folgenden Setupaufgaben für die Integration ausführen:
Generieren Sie das PGP-Zertifikat fusion-key, und laden Sie den Public Key herunter.
Sie müssen eine benutzerdefinierte Zuordnungsdatei für die HDL-Geschäftsobjektdateiausprägung generieren, die Sie mit Ihrer Integration erstellen (siehe Aufgabe 3: Benutzerdefinierte Zuordnungsdateien generieren).
Wenn Sie die Tutorialschritte mit den bereitgestellten Ressourcendateien ausführen, können Sie diese Datei Worker.dat verwenden, um die benutzerdefinierte Zuordnungsdatei zu generieren.
Wenn Sie SET-Anweisungen in die generierte Datei aufnehmen müssen, müssen Sie die Zuordnungsdatei auch bearbeiten, um die Konfiguration einer SET-Anweisung zu aktivieren. (Befolgen Sie die Schritte unter SET-Anweisungen zu Ihrer Dateiform hinzufügen in Aufgabe 4.)
Aufgabe 1: Integration erstellen
In diesem Schritt erstellen Sie eine Zeitplanintegration.
Melden Sie sich bei OIC an, und navigieren Sie zu Design > Integrationen.
Klicken Sie auf Erstellen, und wählen Sie Terminieren aus.
Geben Sie einen Namen und optional eine Beschreibung an.
Klicken Sie auf Erstellen. Sie werden zur Integrationsleinwand navigiert.
Aufgabe 2: Quelldatei herunterladen und entschlüsseln
In diesem Schritt rufen Sie Ihre FTP-Verbindung auf, um die Quelldatei zu lesen und sie optional zu entschlüsseln.
Klicken Sie auf das Symbol + nach Planen, um das Feld "Vorschläge" zu öffnen. Wählen Sie auf der Registerkarte Aufrufe Ihre FTP-Verbindung aus.
Tipp:
Die FTP-Verbindungsdefinition enthält den privaten PGP-Schlüssel zum Entschlüsseln Ihrer Dateien.
Geben Sie den Namen DownloadFile und optional eine Beschreibung an. Klicken Sie auf Erstellen.
Wählen Sie den Vorgang Datei herunterladen, und wählen Sie den Übertragungsmodus.
Geben Sie das Eingabeverzeichnis als Pfad auf dem FTP-Server an, auf dem die Quelldatei gefunden wird, zusammen mit dem Namen der Quelldatei.
Geben Sie einen Verzeichnisnamen an, in den die Datei heruntergeladen wird, z.B. /newHires.
Wenn die Datei verschlüsselt ist, aktivieren Sie das Kontrollkästchen PGP-Entschlüsselung an einer verschlüsselten Datei ausführen, die vom externen FTP-Server heruntergeladen wurde.
Tipp:
Die von der folgenden Aufgabe erstellte Aktion entschlüsselt die entschlüsselte Datei. Wenn Ihre Datei nicht verschlüsselt ist, können Sie die Datei beim Herunterladen dekomprimieren, indem Sie Dekomprimierung bei komprimierter Datei ausführen, die vom externen FTP-Server heruntergeladen wurde aktivieren.
Hinweis:
Wenn Sie sowohl die Entpackungs- als auch die Entschlüsselungsoptionen prüfen, wird Ihre Datei zuerst entpackt und dann der Inhalt entschlüsselt. Bei den Schritten in diesem Tutorial wird davon ausgegangen, dass Sie zuerst die Quelldatei entschlüsseln und dann entpacken müssen.
Klicken Sie auf Fortfahren und Fertigstellen.
Tipp:
Vor der Aktion DownloadFile wird automatisch eine Zuordnungsaktion generiert. Sie müssen dies nicht konfigurieren.
Aufgabe 3: Quelldatei dekomprimieren
In dieser Aufgabe entpacken Sie die vom FTP-Server heruntergeladene Datei. Wenn Ihre Datei nicht komprimiert ist oder Sie sie beim Download entpackt haben, können Sie diesen Schritt überspringen.
Klicken Sie im rechten Navigationsbereich auf Aktion. Wählen Sie Stage-Datei aus, und ziehen Sie sie nach der Aktion DownloadFile aufrufen auf das Symbol +.
Geben Sie den Namen UnzipFile an, und geben Sie optional eine Beschreibung an. Klicken Sie auf "Weiter".
Wählen Sie den Staging-Dateivorgang Datei entpacken aus.
Klicken Sie auf die Symbole Entwickleransicht rechts neben den Feldern "ZIP-Dateiname" und "Verzeichnis".
Blenden Sie die Quellhierarchie $DownloadFile vollständig ein. Ziehen Sie das Quellattribut Dateiname in das Feld ZIP-Dateiname und das Quellattribut directory in das Feld Zip File Directory.
Geben Sie das Verzeichnis an, in dem die extrahierte Datei abgelegt werden soll. Beispiel: '/newhires' (mit Anführungszeichen).
Klicken Sie auf Fortfahren und Fertigstellen.
Aufgabe 4: Quelldatei lesen
In dieser Aufgabe lesen Sie den gesamten Dateiinhalt, der bereit ist, ihn in die Form der HDL-Geschäftsobjektdatei zu transformieren.
Erstellen Sie eine Stage File-Aktion als letzte Aktion in Ihrer aktuellen Integrationsdefinition. Geben Sie den Namen ReadFile und optional eine Beschreibung an. Klicken Sie auf "Weiter".
Wählen Sie den Staging-Dateivorgang Gesamte Datei lesen.
Klicken Sie rechts neben den Feldern "Dateiname" und "Verzeichnis" auf die Symbole der Entwickleransicht.
Blenden Sie die Quellhierarchie vollständig ein.
Tipp:
Wenn Sie eine UnzipFile-Aktion erstellt haben, lautet der Quellname $UnzipFile. Wenn nicht, blenden Sie stattdessen die Quelle $DownloadFile ein.
Ziehen Sie das Quellattribut Dateiname in das Feld Dateiname und das Quellattribut directory in das Feld Directory.
Klicken Sie auf "Weiter".
Wählen Sie den Dateityp aus, der Ihre Quelldateistruktur beschreibt.
Wenn Sie die angegebenen Ressourcendateien verwenden, wählen Sie Begrenztes Beispieldokument (z.B. CSV) aus. Klicken Sie auf "Weiter".
Ziehen Sie die Datei, die ein Beispiel für die Quelldateistruktur enthält, per Drag-and-Drop.
Tipp:
Die Datei NewHireSample.csv, wenn Sie die bereitgestellten Ressourcendateien verwenden, um diese Schritte auszuführen.
Geben Sie einen Wert für den Datensatznamen an, z.B. NewHire.
Geben Sie einen Wert für den Datensatzsetnamen an, z.B. AllNewHires.
Prüfen Sie die aus der Definition der hochgeladenen Datei generierten Informationen. Nehmen Sie die erforderlichen Änderungen vor, und klicken Sie auf Weiter und Fertigstellen.
Aufgabe 5: Schreiben in Datei
In dieser Aufgabe erstellen Sie die HCM Data Loader-Datei, die für das zu aktualisierende HDL-Geschäftsobjekt benannt werden muss.
Konstantenwerte zuweisen
Das Erstellen von Variablen für Attributwerte, die innerhalb der Dateidefinition mehrmals verwendet werden, vereinfacht den Zuordnungsprozess. Anstatt diese wiederholt manuell einzugeben, kann die Variable zugeordnet und bei Bedarf einmal geändert werden, um alle zugeordneten Felder zu aktualisieren. Hier erstellen Sie Konstanten für Attribute wie ActionCode und SourceSystemOwner.
Erstellen Sie eine Zuweisungsaktion nach der Aktion ReadFile, und nennen Sie sie AssignFileConstants.
Erstellen Sie stringbasierte Variablen für Konstantenwerte, auf die Sie regelmäßig verweisen. Definieren Sie für die Integration von Neueinstellungen Folgendes:
Name
Beschreibung
Datum
SourceSystemOwner
Der Name des Quellsystemeigentümers.
Name des Quellsystemeigentümers. Beispiel: "VISION"
Gültig bis
Das Gültigkeitsende für neue datumsabhängige Datensätze.
'4.712/12/31'
ActionCode
Der Aktionscode.
'HIRE'
LegislationCode
Der Gesetzgebungscode.
'USA'
Schreiben der HDL-Geschäftsobjektdatei
Erstellen Sie eine Stage File-Aktion nach der AssignFileConstants-Aktion, die den Namen WriteFile und optional eine Beschreibung angibt. Klicken Sie auf "Weiter".
Wählen Sie den Staging-Dateivorgang Datei schreiben aus.
Legen Sie den Namen der Datei fest, in die transformierte Daten geschrieben werden sollen. Geben Sie den Namen der HDL-Geschäftsobjektdatei an, z.B. 'Worker.dat'.
Geben Sie ein temporäres Ausgabeverzeichnis für Ihre Datei an, wie 'WorkerOutput'. Klicken Sie auf "Weiter".
Geben Sie das XSD-Dokument (XML-Schema) an, um die Struktur des Dateiinhalts zu beschreiben. Klicken Sie auf "Weiter".
Ziehen Sie die Datei, die ein Beispiel für die Quelldateistruktur enthält, per Drag-and-Drop.
Tipp:
Dies ist die nxsd-Zuordnungsdatei, die Sie als Teil der Voraussetzungen für dieses Tutorial generiert haben.
Setzen Sie das Schemaelement auf das Element, das oben in der nxsd-Datei definiert ist. Der Name dieses Elements endet normalerweise mit "FileData". Klicken Sie auf "Weiter".
Klicken Sie auf Fertigstellen.
Eine Zuordnungsaktion WriteFile wird automatisch generiert. Sie konfigurieren dies im nächsten Schritt.
6. Aufgabe: WriteFile-Zuordnung abschließen
In dieser Aufgabe führen Sie das Mapping aus, um die Quelldaten in die Ausprägung der Geschäftsobjektdatei zu transformieren. Worker.dat, in diesem Beispiel.
Die Geschäftsobjekthierarchie des Mitarbeiters ist besonders komplex. Die Datei, die Sie mit dem Beispiel für Neueinstellungen generieren, erstellt Datensätze für diese Komponenten in der Hierarchie:
Sie müssen Zuordnungen sowohl für die Labels als auch für die Werte für jede Komponente definieren.
Hinweis:
Die Werte, die den "Label"-Elementen bereitgestellt werden, werden zum Generieren der METADATA-Zeilen verwendet. Daher müssen die angegebenen Werte gültige Attributnamen für die von Ihnen erstellte Geschäftsobjektdatei sein.
Tipp:
Nachdem Sie mit der Erstellung von Mappings für die Felder in einem Zielelement begonnen haben, müssen Sie Werte für jedes Feld in diesem Element definieren. Andernfalls kann OIC die Daten nicht transformieren.
Tipp:
Beim Zuordnen von HDL-Dateien wie Worker sind viele Konfigurationen abzuschließen. Validieren Sie Ihre Mappings regelmäßig, und speichern Sie Ihre Integration.
Mitarbeiter
Bearbeiten Sie die Zuordnungsaktion WriteFile, um den Mapper zu öffnen.
Im linken Bereich Quellen werden alle verfügbaren Werte und Felder angezeigt, die in diesem Mapping verwendet werden können. Der Fensterbereich Ziel auf der rechten Seite veranschaulicht die Schreibhierarchie. Dies ist eine Darstellung der Struktur der HDL-Geschäftsobjektdatei, in diesem Beispiel Worker.dat. Die Ausprägung wird durch die nxsd-Zuordnungsdatei bestimmt, die Sie mit HDL generiert und in die Aktion WriteFile hochgeladen haben.
Klicken Sie auf die Schaltflächen Entwickler und XSLT, um die technischen Namen der Elemente anzuzeigen.
Blenden Sie im Bereich Ziel die Elemente WorkerFileData und WorkerLabel ein.
Tipp:
Sie müssen die für jede Komponente anwendbaren HDL-Geschäftsobjektattributnamen mit den "Label"-Elementen definieren.
Weisen Sie diese Ausdrücke den folgenden WorkerLabel-Zielelementen zu:
Zielattribut WorkerLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonNumberLabel
'PersonNumber'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
StartDateLabel
'StartDate'
ActionCodeLabel
'ActionCode'
DateOfBirthLabel
'DateOfBirth'
Tipp:
So erstellen Sie einen Ausdruck für ein Element:
Klicken Sie mit der rechten Maustaste auf das Zielfeld, und wählen Sie Zielknoten erstellen aus.
Wechseln Sie im Bereich Ausdruck zu Entwickleransicht.
Geben Sie den Ausdruckswert einschließlich der Anführungszeichen an.
Klicken Sie auf das Häkchensymbol, um den Ausdruck zu speichern.
Blenden Sie die Hierarchie $ReadFile ein.
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement Worker zu.
Tipp:
Wenn Sie die Zuordnung abschließen, wird eine for-each-Schleife mit dem sich wiederholenden Worker-Element im Inneren generiert. Dies wird nur angezeigt, wenn Sie auf die Schaltfläche XSLT geklickt haben.
Die Worker-Zielhierarchie ist jetzt mit der NewHire-Quellhierarchie verknüpft. Worker ist ein untergeordnetes Element der for-each-Schleife. Das bedeutet, dass für jeden NewHire-Datensatz in der Quelldatei ein Ziel-Worker-Datensatz erstellt wird.
Erstellen Sie diese Zuordnung zwischen den definierten Variablen, der Quelle NewHire und den Zielelementen von Worker:
Quellattribut NewHire
Zielattribut WorkerLabel
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
employeeExternalNumber
PersonNumber
hireDate
Gültig von
(x) EffectiveEndDate $
Gültig bis
hireDate
StartDate
(x) ActionCode $
ActionCode
Geburtsdatum
DateOfBirth
Tipp:
Wenn mehrere Komponenten zugeordnet werden müssen, z.B. bei Neueinstellungen, sollten Sie die verbleibende Zuordnung abschließen, nachdem Sie die Integrationsdefinition so weit abgeschlossen haben, dass die Datei in Oracle WebCenter geschrieben wird. Anschließend können Sie die Dateizuordnung iterativ aktivieren und testen, indem Sie die generierte Datei prüfen, die in Oracle WebCenter hochgeladen wurde, bevor Sie HCM Data Loader zur Verarbeitung der Datei initiieren.
Person - Gesetzgebungsdaten
Blenden Sie das Zielelement PersonLegislativeDataLabel ein.
Weisen Sie diese Ausdrücke den folgenden PersonLegislativeDataLabel-Attributen zu:
Zielattribut PersonLegislativeDataLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
LegislationCodeLabel
'LegislationCode'
SexLabel
'Geschlecht'
Ordnen Sie das sich wiederholende Quellelement NewHire in der Hierarchie $ReadFile dem sich wiederholenden Zielelement PersonLegislativeData zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen den definierten Variablen, der Quelle NewHire und den Zielelementen PersonLegislativeData:
Quellattribut NewHire
Zielattribut PersonLegislativeData
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('LD', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
Gültig von
(x) EffectiveEndDate $
Gültig bis
(x) LegislationCode $
LegislationCode
Geschlecht
Geschlecht.
Tipp:
Das Quellelement employeeExternalNumber wird als Wert SourceSystemId verwendet, um den Worker eindeutig zu identifizieren. Das gleiche Feld wird verwendet, um die SourceSystemId für die anderen Komponenten zu generieren. Es empfiehlt sich jedoch, die SourceSystemId für alle Komponenten eindeutig zu machen. Dadurch wird das Debugging einfacher. Nachdem Sie das Quellelement employeeExternalNumber in das Zielelement SourceSystemId gezogen haben, ändern Sie den Ausdruck in das Präfix concat('LD', . Platzieren Sie eine ) am Ende des Ausdrucks. Dies sollte in etwa wie folgt aussehen:
Personenname
Blenden Sie das Zielelement PersonNameLabel ein.
Weisen Sie diese Ausdrücke den folgenden PersonNameLabel-Attributen zu:
Zielattribut PersonNameLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
LegislationCodeLabel
'LegislationCode'
NameTypeLabel
'NameType'
FirstNameLabel
'FirstName'
MiddleNamesLabel
'MiddleNames'
LastNameLabel
'LastName'
TitleLabel
'Titel'
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement PersonName zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen der Quelle NewHire und den Zielelementen PersonName:
Quellattribut NewHire
Zielattribut WorkerLabel
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('PN', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
Gültig von
(x) EffectiveEndDate $
Gültig bis
(x) LegislationCode $
LegislationCode
NameType
'GLOBAL'
firstName
FirstName
MiddleNames
''
lastName
LastName
title
Anrede
Tipp:
Alle Zielfelder in einem Element müssen über eine Zuordnung verfügen. Wenn kein Wert zuzuweisen ist, wie MiddleNames in diesem Beispiel, erstellen Sie einen Ausdruck mit zwei Anführungszeichen, d.h. ''.
E-Mail-Adresse der Person
Blenden Sie das Zielelement PersonEmailLabel ein.
Weisen Sie diese Ausdrücke den folgenden PersonEmailLabel-Attributen zu:
Zielattribut PersonEmailLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
DateFromLabel
'DateFrom'
EmailTypeLabel
'EmailType'
EmailAddressLabel
'EmailAddress'
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement PersonEmail zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen der Quelle NewHire und den Zielelementen PersonEmail:
Quellattribut NewHire
Zielattribut PersonEmail
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('EM', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
DateFrom
E-Mail-Typ
'W1'
email
EmailAddress
Arbeitsbeziehung
Blenden Sie das Zielelement WorkRelationshipLabel ein.
Weisen Sie diese Ausdrücke den folgenden WorkRelationshipLabel-Attributen zu:
Zielattribut WorkRelationshipLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PersonId_SourceSystemId_Label
'PersonId(SourceSystemId)'
DateStartLabel
'DateStart'
WorkerTypeLabel
'WorkerType'
LegalEmployerNameLabel
'LegalEmployerName'
ActionCodeLabel
'ActionCode'
PrimaryFlagLabel
'PrimaryFlag'
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement WorkRelationship zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen der Quelle NewHire und den Zielelementen WorkRelationship:
Quellattribut NewHire
Zielattribut WorkRelationship
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('WR', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
hireDate
DateStart
WorkerType
'E'
legalEmployerName
LegalEmployerName
(x) ActionCode $
ActionCode
PrimaryFlag
'J'
Beschäftigungsbedingungen
Blenden Sie das Zielelement WorkTermsLabel ein.
Weisen Sie diese Ausdrücke den folgenden WorkTermsLabel-Attributen zu:
Zielattribut WorkTermsLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
PeriodOfServiceId_SourceSystemId_Label
'PeriodOfServiceId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
EffectiveSequenceLabel
'EffectiveSequence'
EffectiveLatestChangeLabel
'EffectiveLatestChange'
ActionCodeLabel
'ActionCode'
AssignmentNameLabel
'AssignmentName'
AssignmentNumberLabel
'AssignmentNumber'
PrimaryWorkTermsFlagLabel
'PrimaryWorkTermsFlag'
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement WorkTerms zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen der Quelle NewHire und den Zielelementen WorkTerms:
Quellattribut NewHire
Zielattribut WorkTerms
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('ET', {employeeExternalNumber} )
employeeExternalNumber
PeriodOfServiceId_SourceSystemId_
concat('WR',{employeeExternalNumber})
hireDate
Gültig von
(x) EffectiveEndDate $
Gültig bis
EffectiveSequence
'1'
EffectiveLatestChange
'J'
(x) ActionCode $
ActionCode
employeeExternalNumber
AssignmentName
concat('ET', {employeeExternalNumber} )
employeeExternalNumber
Arbeitsstellennummer
concat('ET', {employeeExternalNumber} )
PrimaryWorkTermsFlag
'J'
Zuweisung
Blenden Sie das Zielelement AssignmentLabel ein.
Weisen Sie diese Ausdrücke den folgenden AssignmentLabel-Attributen zu:
Zielattribut AssignmentLabel
Ausdruck
SourceSystemOwnerLabel
'SourceSystemOwner'
SourceSystemIdLabel
'SourceSystemId'
WorkTermsAssignmentId_SourceSystemId_Label
'WorkTermsAssignmentId(SourceSystemId)'
EffectiveStartDateLabel
'EffectiveStartDate'
EffectiveEndDateLabel
'EffectiveEndDate'
EffectiveSequenceLabel
'EffectiveSequence'
EffectiveLatestChangeLabel
'EffectiveLatestChange'
ActionCodeLabel
'ActionCode'
AssignmentNameLabel
'AssignmentName'
AssignmentNumberLabel
'AssignmentNumber'
PrimaryAssignmentFlagLabel
'PrimaryAssignmentFlag'
BusinessUnitShortCodeLabel
'BusinessUnitShortCode'
AssignmentStatusTypeCodeLabel
'AssignmentStatusTypeCode'
PersonTypeCodeLabel
'PersonTypeCode'
ProjectedStartDateLabel
'ProjectedStartDate'
Ordnen Sie das sich wiederholende Quellelement NewHire dem sich wiederholenden Zielelement Zuweisung zu, um eine for-each-Schleife zu generieren.
Erstellen Sie diese Zuordnung zwischen den Quellelementen NewHire und Zuweisung:
Quellattribut NewHire
Zielarbeitsstellenattribut
Ausdruck
(x) SourceSystemOwner $
SourceSystemOwner
employeeExternalNumber
SourceSystemId
concat('E', {employeeExternalNumber} )
employeeExternalNumber
PersonId_SourceSystemId_
concat('ET', {employeeExternalNumber} )
hireDate
Gültig von
(x) EffectiveEndDate $
Gültig bis
EffectiveSequence
'1'
EffectiveLatestChange
'J'
(x) ActionCode $
ActionCode
employeeExternalNumber
AssignmentName
concat('E', {employeeExternalNumber} )
employeeExternalNumber
Arbeitsstellennummer
concat('E', {employeeExternalNumber} )
PrimaryAssignmentFlag
'J'
businessUnit
BusinessUnitShortCode
AssignmentStatusTypeCode
'ACTIVE_PROCESS'
PersonTypeCode
'Mitarbeiter'
hireDate
ProjectedStartDate
SET-Anweisung
Wenn Sie eine SET-Anweisung in Ihre Datei aufnehmen müssen, führen Sie diese Schritte aus.
Blenden Sie das Zielelement SetInstructions ein.
Erstellen Sie einen Ausdruck, um die vollständige SET-Anweisung für das Attribut Instruction aufzunehmen.
Aufgabe 7: Generierte Datei komprimieren
In dieser Aufgabe komprimieren Sie die von Ihnen generierte Datei.
Fügen Sie direkt unter der Aktion WriteFile eine Stage File-Aktion hinzu, und nennen Sie sie ZipFile.
Wählen Sie den Staging-Dateivorgang ZIP-Datei aus.
Geben Sie einen Dateinamen für die ZIP-Datei an, z.B. NewHires.zip.
Klicken Sie auf das Symbol Entwickleransicht für das Verzeichnisfeld, und wählen Sie Verzeichnis aus der $WriteFile-Quellhierarchie .
Geben Sie 'outputdirectory' für das Ausgabeverzeichnis an.
Klicken Sie auf Fortfahren und Fertigstellen.
Aufgabe 8: Datei verschlüsseln
Es empfiehlt sich, alle Dateien zu verschlüsseln, die in Oracle WebCenter geladen werden.
In dieser Aufgabe erstellen Sie einen Switch, mit dem Sie steuern können, wann die Datei verschlüsselt werden soll. Sie können die Datei während der Entwicklung unverschlüsselt lassen, um die Integrationsdefinition und die Dateitransformation zu testen.
Variablen für HCM Data Loader-Parameter definieren
Klicken Sie im rechten Navigationsbereich auf Aktionen, und wählen Sie Zuweisen aus. Ziehen Sie dies nach dem Zeitplan auf das Symbol +, damit es die erste Aktion in Ihrer Integration ist.
Benennen Sie die Aktion AssignHDLParameters um.
Erstellen Sie eine Variable mit dem Namen FileEncryption, und weisen Sie den Wert 'NONE' zu.
Erstellen Sie eine 2. Variable namens DeleteSourceFile, und weisen Sie den Wert 'N' zu.
Tipp:
Wiederholen Sie den Vorgang für alle anderen HDL-Parameter, die Sie zwischen Entwicklung und Produktion ändern möchten.
Hinweis:
Diese Variablen werden jetzt erstellt, da die Variable FileEncryption von dem im nächsten Schritt erstellten Switch referenziert wird.
Switch zur Kontrolldateiverschlüsselung erstellen
Klicken Sie im rechten Navigationsbereich auf Aktionen, und wählen Sie unter der Überschrift Logik die Option Switch aus. Ziehen Sie das Symbol + nach der Aktion ZipFile. Die Seite Route konfigurieren wird angezeigt.
Geben Sie EncryptHDLFile als Routennamen an.
Klicken Sie im Feld Wert auf die Schaltfläche Entwickleransicht, um die Eingabequellen anzuzeigen.
Ziehen Sie die Variable $FileEncryption in das Feld Wert. Setzen Sie den Operator auf =, und geben Sie den Wert 'PGPUNSIGNED' an.
Datei verschlüsseln
Klicken Sie im Feld "Wechseln" auf das Symbol +, und wählen Sie die Aktion Stage-Datei aus.
Geben Sie den Namen EncryptFile und optional eine Beschreibung an. Klicken Sie auf "Weiter".
Wählen Sie den Staging-Dateivorgang Datei verschlüsseln aus.
Klicken Sie rechts neben den Feldern Dateireferenz und Dateiname auf die Symbole für die Entwickleransicht.
Blenden Sie die Quellhierarchie $ZipFile vollständig ein.
Ziehen Sie das Quellelement FileReference in das Feld Dateireferenz.
Ziehen Sie das Quellelement Dateiname in das Feld Dateiname.
Geben Sie einen Verzeichnisnamen für die OutputDirectory an, z.B. "/WorkerOutput".
Wählen Sie das Fusion-Schlüssel-PGP-Zertifikat aus, um die Datei zu verschlüsseln.
Klicken Sie auf Fortfahren und Fertigstellen.
Tipp:
Sie erstellen die Aufrufaktion, um die Datei als Nächstes in Oracle WebCenter hochzuladen. Dazu müssen zwei Mappings erstellt werden, eine für jede Route in diesem Switch.
Aufgabe 9: Datei in Oracle WebCenter hochladen
In dieser Aufgabe rufen Sie die Oracle HCM Cloud-Verbindung auf, um die Datei in Oracle WebCenter hochzuladen.
Aktion "Datei hochladen" erstellen
Klicken Sie nach dem Switch auf das Symbol +, und suchen Sie nach "web". Wählen Sie die Oracle WebCenter HDL Import-Verbindung aus.
Geben Sie den Namen UploadFile und optional eine Beschreibung an. Klicken Sie auf "Weiter".
Wählen Sie Dateien an HCM Cloud senden aus, und klicken Sie auf Weiter.
Wählen Sie die Sicherheitsgruppe FAFusionImportExport und den Dok.-Account hcm$/dataloader$/import$ aus.
Klicken Sie auf Fortfahren und Fertigstellen.
Tipp:
Eine UploadFile-Map wird vor der Aufrufaktion und nach dem Switch automatisch generiert.
Uploaddateizuordnung für verschlüsselte Dateien definieren
In dieser Aufgabe erstellen Sie die UploadFile-Map für die verschlüsselte Dateiroute.
Wenn noch nicht erweitert, erweitern Sie den Switch.
Klicken Sie auf die Aktion Map UploadFile, und wählen Sie Cut aus.
Klicken Sie direkt nach der Aktion EncryptFile auf das Symbol +, und klicken Sie auf Einfügen.
Bearbeiten Sie die Zuordnung UploadFile.
Klicken Sie auf die Schaltflächen Entwickler und XSLT, und blenden Sie die Quellelementhierarchie $EncryptFile vollständig ein.
Erstellen Sie diese Zuordnungen zwischen dem Element ICSFile der Quelle $EncryptFile und den Zielelementen FileUpload:
Quellelement $EncryptFile
Zielelement FileUpload
Ausdruck
FileReference
fileReference
Dateiname
docTitle
docType
'Dokument'
Validieren Sie die Karte, und kehren Sie zur Integrationsleinwand zurück.
Uploaddateizuordnung für unverschlüsselte Dateien definieren
In dieser Aufgabe erstellen Sie die UploadFile-Map für die unverschlüsselte Dateiroute.
Erstellen Sie die Route Andernfalls, indem Sie auf das Menü für den Switch klicken und Hinzufügen > Andernfalls auswählen.
Klicken Sie auf das Symbol + in der Route Sonstige, und wählen Sie Zuordnen aus.
Wählen Sie UploadFile aus, wenn Sie gefragt werden, welchem Endpunkt Daten zugeordnet werden sollen, und klicken Sie auf Erstellen.
Klicken Sie auf die Schaltflächen Entwickler und XSLT, und blenden Sie die Quellelementhierarchie $ZipFile vollständig ein.
Erstellen Sie diese Zuordnungen zwischen dem Element ICSFile der Quelle $ZipFile und den Zielelementen FileUpload:
Quellelement $ZipFile
Zielelement FileUpload
Ausdruck
FileReference
fileReference
Dateiname
docTitle
docType
'Dokument'
Validieren Sie die Karte, und kehren Sie zur Integrationsleinwand zurück.
Aufgabe 10: HCM Data Loader initiieren
In diesem Schritt rufen Sie Ihre REST-Verbindung für HCM Data Loader auf, um den Import und das Laden für die Datei zu initiieren, die mit der Aktion UploadFile in Oracle WebCenter hochgeladen wurde.
Erstellen Sie direkt nach der Aktion UploadFile eine Invoke-Aktion.
Wählen Sie die Aktion "Aufrufen" für Ihre HDL-REST-Verbindung aus.
Geben Sie einen Namen und optional auch eine Beschreibung an.
Geben Sie den Endpunkt als /action/createFileDataSet an, und setzen Sie die Aktion auf POST.
Aktivieren Sie dieses Kontrollkästchen:
Anforderungs-Payload für diesen Endpunkt konfigurieren
Diesen Endpunkt für den Empfang der Antwort konfigurieren
Klicken Sie auf "Weiter".
Füllen Sie die folgenden Felder auf der Seite Anforderung konfigurieren aus:
Klicken Sie auf "Weiter". Klicken Sie auf Fertigstellen.
Die Zuordnungsaktion ImportAndLoad wird automatisch generiert.
Konfigurieren Sie die ImportAndLoad-Map
In diesem Schritt konfigurieren Sie die ImportAndLoad-Map, um die in Oracle WebCenter hochgeladene Datei zu referenzieren und bei Bedarf die HCM Data Loader-Parameter außer Kraft zu setzen.
Bearbeiten Sie die Zuordnung ImportAndLoad.
Klicken Sie auf die Schaltflächen Developer und XSLT.
Erweitern Sie das Zielelement "Request-Wrapper".
Tipp:
Diese Felder füllen die createFileDataSets-Parameter auf.
Blenden Sie die Quellelementhierarchie $UploadFile vollständig ein.
Ordnen Sie folgende Felder zu:
Quellattribut FileUploadResponse
Ziel-Request-Wrapper-Attribut
Ausdruck
dDocName
contentId
$FileEncryption
fileEncryption
$DeleteSourceFile
deleteSourceFileFlag
Tipp:
Das Standardverhalten von HDL besteht darin, die Quelldatei aus Oracle WebCenter zu löschen, sobald HDL die Daten in die Staging-Tabellen übertragen hat. Setzen Sie deleteSourceFileFlag auf "N", bis Sie die Datei geprüft und validiert haben.
Validieren Sie das Mapping, und speichern Sie die Integration.
Aufgabe 11: Verfolgung
Der letzte Schritt bei der Konfiguration einer Integration ist das Festlegen der Geschäfts-ID. Dadurch wird ein eindeutiger Wert für Monitoring und Reporting generiert.
Klicken Sie rechts in der Menüleiste auf Business-IDs.
Ziehen Sie die Quelle startTime per Drag-and-Drop in das erste Feld für die Geschäfts-ID.
Speichern Sie Ihre Integration.
Aufgabe 12: Integration aktivieren und ausführen
Verschlüsseln Sie die Quelldatei, und laden Sie sie in dem in der Aktion DownloadFile angegebenen Ordner auf den FTP-Server hoch. Beispiel: /inbound/nh, wenn Sie die Integration "Neueinstellungen" erstellt haben.
Tipp:
Zu diesem Zweck können Sie die Datei NewHires.csv verwenden.
Beenden Sie die Integration, wenn Sie sich noch in der Integrationsleinwand befinden.
Suchen Sie Ihre Integration auf der Seite Design > Integrationen.
Tipp:
Der Status muss Konfiguriert lauten. Wenn es noch Entwurf ist, weist Ihre Integration Fehler auf, und Sie müssen Ihre Integration bearbeiten, prüfen und beheben.
Wählen Sie Ihre Integration aus, und ein Menü auf Zeilenebene wird angezeigt. Klicken Sie auf Aktivieren.
Geben Sie die Tracing-Ebene an, und klicken Sie auf Aktivieren.
Aktualisieren Sie die Integrationsinformationen, bis der Status Aktiv lautet.
Klicken Sie im Zeilenmenü auf das Aktionssymbol, und wählen Sie Run aus.
Klicken Sie auf Ausführen
Der Aktivitätsstream wird angezeigt.
Aktualisieren Sie gelegentlich, bis die Verarbeitung abgeschlossen ist.
Datei in Oracle WebCenter validieren
Während der Ausführung der Integration können Sie die Dateiform validieren, indem Sie sie aus Oracle WebCenter abrufen.
Melden Sie sich bei der Oracle Cloud an.
Navigieren Sie zu Tools > Dateiimport und -export.
Setzen Sie den Account auf hcm/dataloader/import, und klicken Sie auf Suchen.
Tipp:
Das Standardverhalten von HDL besteht darin, die Quelldatei aus Oracle WebCenter zu löschen, sobald HDL die Daten in die Staging-Tabellen übertragen hat. Dieses Verhalten wird durch die von Ihnen definierte Variable deleteSourceFile außer Kraft gesetzt.
HDL-Datei verschlüsseln
Denken Sie nach Abschluss der Tests daran, die Dateiverschlüsselung zu aktivieren und HDL zuzulassen, die Quelldatei nach dem Lesen aus Oracle WebCenter zu löschen.
Bearbeiten Sie die Aktion AssignHDLParameters.
Aktualisieren Sie den Wert FileEncryption in 'PGPUNSIGNED'.
Aktualisieren Sie den Wert DeleteSourceFile in 'Y'.
