Introduzione

Questa esercitazione crea un'integrazione Oracle Integration Cloud (OIC) per caricare i dati in Oracle HCM Cloud utilizzando il programma di caricamento dati HCM (HDL). Il file di origine viene letto da un server FTP, decifrato, non compresso, trasformato nella forma del file del business object HDL, prima di essere compresso, cifrato e caricato in Oracle WebCenter. Infine, viene avviato il programma di caricamento dati HCM per importare e caricare i dati nel file.

Il flusso di azioni per definire l'integrazione

I passi forniti in questa esercitazione possono essere utilizzati per qualsiasi integrazione in entrata mediante HDL. Completare i passi utilizzando i file forniti per creare un'integrazione Nuova assunzione.

Obiettivi

In questo tutorial, imparerai come:

  • Decifra e decomprimi i file di origine ospitati su un server FTP.
  • Trasforma i dati di origine in una forma di file del business object HDL.
  • Comprimere, cifrare e caricare il file trasformato in Oracle WebCenter.
  • Avviare il programma di caricamento dati HCM.

Prerequisiti

Per completare i passaggi di questa esercitazione, è necessario accedere a quanto segue:

  • Oracle Integration Cloud (OIC) per creare questa integrazione.
  • Server FTP per l'hosting dei file di origine.
  • Coppia di chiavi di cifratura PGP per la cifratura del file di origine.
  • Console sicurezza per creare account utente.

È inoltre necessario completare i task di impostazione dell'integrazione riportati di seguito.

  • Generare il certificato PGP fusion-key e scaricare la chiave pubblica.

    • Suggerimento

    HDL decritta i file utilizzando la chiave di fusione privata. Il task 5 nell'esercitazione Configura accesso al programma di caricamento dati HCM (HDL) e Comprendi opzioni di sicurezza HDL spiega come generare il certificato PGP e scaricare la chiave pubblica utilizzata dall'integrazione per cifrare il file.
  • Completare i passi nell'esercitazione su Task di impostazione per le integrazioni HDL (HCM Data Loader) in Oracle Integration Cloud (OIC) che illustra i passi di impostazione comuni necessari per tutte le integrazioni OIC che utilizzano il programma di caricamento dati HCM.

    • Nota

    Questa esercitazione fa riferimento alle connessioni create nell'esercitazione di configurazione.
  • Generare il file di mapping OIC per la forma del file HDL che si desidera generare.

    • Suggerimento

    The Generate the Oracle Integration Cloud (OIC) mapping files for HCM Data Loader (HDL) tutorial provides the steps to complete this.
    • È necessario generare un file di mapping personalizzato per la forma di file del business object HDL che si sta creando con l'integrazione (vedere Task 3: generazione di file di mapping personalizzati).
    • Se si stanno completando i passi dell'esercitazione con i file delle risorse forniti, è possibile utilizzare questo file Worker.dat per generare il file di mapping personalizzato.
    • Se è necessario includere le istruzioni SET nel file generato, sarà inoltre necessario modificare il file di mapping per abilitare la configurazione di un'istruzione SET (seguire la procedura Aggiunta di istruzioni SET alla forma del file all'interno del Task 4).

Task 1: Creazione dell'integrazione

In questo passo verrà creata un'integrazione della pianificazione.

  1. Eseguire il login a OIC e andare a Progettazione > Integrazioni.
  2. Fare clic su Crea, quindi selezionare Programma.
    3. Lista dei tipi di integrazione disponibili.

  3. Specificare un nome e, facoltativamente, una descrizione.
    4. Specificare nome e descrizione per l'integrazione

  4. Fare clic su Crea. Verrà visualizzata l'area di creazione dell'integrazione.


Task 2: Scaricare e decifrare il file di origine

In questo passaggio richiamerai la tua connessione FTP per leggere il file di origine e facoltativamente decifrarlo.

  1. Fare clic sull'icona + dopo Pianifica per aprire la casella Suggerimenti. Nella scheda Richieste selezionare la connessione FTP.

    2. Suggerimento

    La definizione di connessione FTP include la chiave privata PGP utilizzata per decifrare i file.
    Selezionare la connessione FTP per il file server di origine

  2. Specificare un nome DownloadFile e, facoltativamente, una descrizione. Fare clic su Crea.
    3. Specificare un nome e una descrizione per l'azione di richiamo FTP

  3. Selezionare l'operazione Scarica file e selezionare Modalità trasferimento.
  4. Specificare la directory di input come percorso nel server FTP in cui verrà trovato il file di origine, insieme al nome del file di origine.
  5. Specificare il nome di una directory in cui verrà scaricato il file, ad esempio /newHires.

  6. Se il file è cifrato, selezionare la casella di controllo Esegui decifrazione PGP su un file crittografato scaricato dal server FTP esterno.

    7. Suggerimento

    L'azione creata dal task seguente consente di estrarre il file decifrato. Se il file non è cifrato, è possibile decomprimerlo durante il download selezionando Esegui decompressione su file compresso scaricato da un server FTP esterno.

    Nota

    Se si selezionano entrambe le opzioni di decrittazione e decrittazione, il file verrà decrittato prima e il contenuto verrà decrittato. I passi di questa esercitazione presuppongono che sia prima necessario decifrare e quindi decomprimere il file di origine.
  7. Fare clic su Continua e su Fine.

    8. Suggerimento

    Un'azione Mappa verrà generata automaticamente prima dell'azione DownloadFile. Non è necessario configurare questa opzione.


Task 3: Decomprimi file di origine

In questo task verrà decompresso il file scaricato dal server FTP. Se il file non è compresso o è stato decompresso durante il download, è possibile saltare questo passaggio.

  1. Nel riquadro di navigazione a destra fare clic su Azione. Selezionare Fase file e trascinarlo sull'icona + dopo l'azione Richiama DownloadFile.
  2. Specificare il nome UnzipFile e, facoltativamente, specificare una descrizione. Fare clic su Continua.
  3. Scegliere l'operazione del file temporaneo Unzip File.
  4. Fare clic sulle icone Vista sviluppatore a destra dei campi Nome file ZIP e Directory.
  5. Espandere completamente la gerarchia di origini $DownloadFile. Trascinare l'attributo di origine filename nel campo Zip File Name e l'attributo di origine directory nel campo Zip File Directory.
    mapping dei campi di origine e di destinazione.

  6. Specificare la directory in cui deve essere posizionato il file estratto. Ad esempio, '/newhires' (con i preventivi).
  7. Fare clic su Continua e su Fine.


Task 4: Lettura del file di origine

In questo task verrà letto l'intero contenuto del file pronto per trasformarlo nella forma del file del business object HDL.

  1. Creare un'azione File stadio come ultima azione nella definizione di integrazione corrente. Specificare un nome ReadFile e, facoltativamente, una descrizione. Fare clic su Continua.
  2. Scegliere l'operazione di staging file Read Entire File.
  3. Fare clic sulle icone Vista sviluppatore a destra dei campi Nome file e Directory.
  4. Espandere completamente la gerarchia di origine.

    5. Suggerimento

    Se è stata creata un'azione UnzipFile, il nome dell'origine sarà $UnzipFile, altrimenti espandere l'origine $DownloadFile.
  5. Trascinare l'attributo di origine nome file nel campo Nome file e l'attributo di origine directory nel campo Directory.
    6. mapping dei campi di origine e di destinazione.

  6. Fare clic su Continua.
  7. Selezionare il tipo di file che descriverà la struttura del file di origine.

    Se si utilizzano i file delle risorse forniti, selezionare Documento delimitato da campioni (ad esempio CSV). Fare clic su Continua.


  8. Trascinare e rilasciare il file che include un esempio della struttura del file di origine.

    9. Suggerimento

    Il file NewHireSample.csv, se si utilizzano i file delle risorse forniti, per effettuare le operazioni indicate di seguito.

  • Specificare un valore per il nome record, ad esempio NewHire.
  • Specificare un valore per Nome recordset, ad esempio AllNewHires.

  • Rivedere le informazioni generate dalla definizione del file caricato. Apportare le modifiche necessarie e fare clic su Continua e Fine.

    • Task 5: Scrittura su file

    In questo task verrà creato il file del programma di caricamento dati HCM che deve essere denominato per il business object HDL che si sta aggiornando.

    Assegna valori costanti

    La creazione di variabili per i valori di attributo utilizzati più volte nella definizione del file semplifica il processo di mapping. Invece di digitarli ripetutamente manualmente, la variabile può essere mappata e, se necessario, modificata una volta per aggiornare tutti i campi mappati. Qui creerai costanti per attributi come ActionCode e SourceSystemOwner.

    1. Creare un'azione Assegna dopo l'azione ReadFile e denominarla AssignFileConstants.
    2. Creare variabili basate su stringhe per valori costanti a cui si fa riferimento regolarmente. Per l'integrazione delle nuove assunzioni, definire i seguenti elementi:
      3. Nome Descrizione Valore
      SourceSystemOwner Il nome del proprietario del sistema di origine. Nome del proprietario del sistema di origine. Ad esempio, 'VISION'
      Data fine validità Data di fine validità per i nuovi record con data di validità. '4.712/12/31'
      ActionCode Codice azione. 'HIRE'
      LegislationCode Il codice legislazione 'US'

    Scrivere il file del business object HDL

    1. Creare un'azione File stadio dopo l'azione AssignFileConstants specificando un nome di WriteFile e facoltativamente una descrizione. Fare clic su Continua.
    2. Scegliere l'operazione del file di fase Scrivi file.
    3. Specificare il nome del file in cui scrivere i dati trasformati. Specificare il nome del file del business object HDL, ad esempio 'Worker.dat'.
    4. Specificare una directory di output temporanea del file, ad esempio 'WorkerOutput'. Fare clic su Continua.

    5. Specificare il documento XSD (XML Schema) per descrivere la struttura del contenuto del file. Fare clic su Continua.
      6. Specificare il tipo di file che definisce la struttura del file.

    6. Trascinare e rilasciare il file che include un esempio della struttura del file di origine.

      7. Suggerimento

      Questo è il file di mapping nxsd generato come parte dei prerequisiti di questa esercitazione.

    7. Impostare l'elemento schema sull'elemento definito nella parte superiore del file nxsd. Il nome di questo elemento termina normalmente 'FileData'. Fare clic su Continua.

    8. Fare clic su Fine.

      Verrà generata automaticamente un'azione di mapping WriteFile. La configurazione verrà eseguita nel passo successivo.


    Task 6: Completare il mapping WriteFile

    In questo task verrà completato il mapping per trasformare i dati di origine nella forma del file del business object. Worker.dat, in questo esempio.

    La gerarchia di business object Lavoratore è particolarmente complessa. Il file che si sta generando con l'esempio Nuova assunzione crea i record per questi componenti nella gerarchia:

    È necessario definire i mapping sia per le etichette che per i valori per ciascun componente.

    Nota

    I valori forniti agli elementi 'Etichetta' vengono utilizzati per generare le righe METADATA, pertanto i valori forniti devono essere nomi di attributo validi per il file del business object che si sta creando.

    Suggerimento

    Dopo aver iniziato a creare mapping per i campi in un elemento target, è necessario definire i valori per ogni campo in tale elemento oppure OIC non riuscirà a trasformare i dati.

    Suggerimento

    Sono disponibili numerose configurazioni da completare durante la mappatura dei file HDL, ad esempio Worker. Convalidare e salvare regolarmente i mapping e l'integrazione.

    Lavoratore

    1. Modificare l'azione Mappa WriteFile per aprire il mapper.

      2. Il pannello di sinistra Origini mostra tutti i valori e i campi disponibili che è possibile utilizzare in questo mapping. Il pannello Destinazione a destra illustra la gerarchia di scrittura. Si tratta di una rappresentazione della struttura del file del business object HDL, in questo esempio, Worker.dat. La sua forma è determinata dal file di mapping nxsd generato mediante HDL e caricato nell'azione WriteFile.

    2. Fare clic sui pulsanti Sviluppatore e XSLT per visualizzare i nomi tecnici degli elementi.
    3. Nel pannello Destinazione espandere gli elementi WorkerFileData e WorkerLabel.

      4. Suggerimento

      È necessario definire i nomi degli attributi del business object HDL applicabili a ciascun componente utilizzando gli elementi 'Etichetta'.
    4. Assegnare queste espressioni ai seguenti elementi di destinazione WorkerLabel:
      5. Attributo WorkerLabel di destinazione Espressione
      SourceSystemOwnerLabel 'SourceSystemOwner'
      SourceSystemIdLabel 'SourceSystemId'
      PersonNumberLabel 'PersonNumber'
      EffectiveStartDateLabel 'EffectiveStartDate'
      EffectiveEndDateLabel 'EffectiveEndDate'
      StartDateLabel 'StartDate'
      ActionCodeLabel 'ActionCode'
      DateOfBirthLabel 'DateOfBirth'

      Suggerimento

      Per creare un'espressione per un elemento, procedere come segue.
      • Fare clic con il pulsante destro del mouse sul campo di destinazione e selezionare Crea nodo di destinazione.
      • Nel pannello Espressione passare a Vista sviluppatore.
      • Specificare il valore dell'espressione, comprese le virgolette.
      • Fare clic sull'icona di spunta per salvare l'espressione.
    5. Espandere la struttura gerarchica $ReadFile.
    6. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto Lavoratore.

      7. Suggerimento

      Quando si completa il mapping, viene generato un loop for-each con l'elemento Lavoratore ripetuto all'interno. Questa opzione è rappresentata automaticamente solo se è stato fatto clic sul pulsante XSLT.

      La gerarchia di destinazione Lavoratore è ora collegata alla gerarchia di origine NewHire e Lavoratore è un elemento figlio del loop for-each. Ciò significa che per ogni record NewHire nel file di origine verrà creato un record Lavoratore di destinazione.

    7. Creare il mapping tra le variabili definite, l'origine NewHire e gli elementi di destinazione Worker:
      8. Attributo NewHire origine Attributo WorkerLabel di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId
      employeeExternalNumber PersonNumber
      hireDate Data inizio validità
      (x) $EffectiveEndDate Data fine validità
      hireDate StartDate
      (x) $ActionCode ActionCode
      dob DateOfBirth

    Suggerimento

    Quando sono presenti più componenti da mappare, ad esempio nel caso di nuove assunzioni, considerare la possibilità di completare il mapping rimanente dopo aver completato la definizione di integrazione al punto di scrivere il file in Oracle WebCenter. È quindi possibile attivare e sottoporre a test il mapping dei file in modo iterativo, esaminando il file generato caricato in Oracle WebCenter prima di avviare il programma di caricamento dati HCM per elaborare il file.

    Dati legislativi persona

    1. Espandere l'elemento target PersonLegislativeDataLabel.
    2. Assegnare queste espressioni ai seguenti attributi PersonLegislativeDataLabel:
      3. Attributo PersonLegislativeDataLabel di destinazione Espressione
      SourceSystemOwnerLabel 'SourceSystemOwner'
      SourceSystemIdLabel 'SourceSystemId'
      PersonId_SourceSystemId_Label 'PersonId(SourceSystemId)'
      EffectiveStartDateLabel 'EffectiveStartDate'
      EffectiveEndDateLabel 'EffectiveEndDate'
      LegislationCodeLabel 'LegislationCode'
      SexLabel Sesso

    3. Mappare l'elemento di origine ripetuto NewHire nella struttura gerarchica $ReadFile all'elemento di destinazione ripetuto PersonLegislativeData per generare un loop for-each.
    4. Creare questi mapping tra le variabili definite, l'origine NewHire e gli elementi di destinazione PersonLegislativeData:
      5. Attributo NewHire origine Attributo PersonLegislativeData di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('LD', {employeeExternalNumber} )
      employeeExternalNumber PersonId_SourceSystemId_
      hireDate Data inizio validità
      (x) $EffectiveEndDate Data fine validità
      (x) $LegislationCode LegislationCode
      sesso Sesso

      Suggerimento

      L'elemento di origine employeeExternalNumber viene utilizzato come valore SourceSystemId per identificare in modo univoco il lavoratore. Lo stesso campo viene utilizzato per generare SourceSystemId sugli altri componenti. Tuttavia, è buona norma rendere SourceSystemId unico tra i componenti, semplificando il debug. Dopo aver trascinato l'elemento di origine employeeExternalNumber nell'elemento di destinazione SourceSystemId, modificare l'espressione impostandola come prefisso concat('LD', . Posizionare un ) alla fine dell'espressione. Deve essere simile al seguente:


    Nome persona

    1. Espandere l'elemento target PersonNameLabel.
    2. Assegnare queste espressioni ai seguenti attributi PersonNameLabel:
      3. Attributo PersonNameLabel di destinazione Espressione
      SourceSystemOwnerLabel 'SourceSystemOwner'
      SourceSystemIdLabel 'SourceSystemId'
      PersonId_SourceSystemId_Label 'PersonId(SourceSystemId)'
      EffectiveStartDateLabel 'EffectiveStartDate'
      EffectiveEndDateLabel 'EffectiveEndDate'
      LegislationCodeLabel 'LegislationCode'
      NameTypeLabel 'NameType'
      FirstNameLabel 'FirstName'
      MiddleNamesLabel 'MiddleNames'
      LastNameLabel 'LastName'
      TitleLabel 'Titolo'

    3. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto PersonName per generare un loop for-each.
    4. Creare questi mapping tra l'origine NewHire e gli elementi di destinazione PersonName:
      5. Attributo NewHire origine Attributo WorkerLabel di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('PN', {employeeExternalNumber} )
      employeeExternalNumber PersonId_SourceSystemId_
      hireDate Data inizio validità
      (x) $EffectiveEndDate Data fine validità
      (x) $LegislationCode LegislationCode
      NameType 'GLOBALE'
      firstName FirstName
      MiddleNames ''
      lastName LastName
      title Titolo

      Suggerimento

      Tutti i campi target di un elemento devono avere un mapping. Se non è presente alcun valore da assegnare, ad esempio MiddleNames in questo esempio, creare un'espressione con due virgolette, ad esempio ''.

    E-mail persona

    1. Espandere l'elemento target PersonEmailLabel.
    2. Assegnare queste espressioni ai seguenti attributi PersonEmailLabel:
      3. Attributo PersonEmailLabel di destinazione Espressione
      SourceSystemOwnerLabel 'SourceSystemOwner'
      SourceSystemIdLabel 'SourceSystemId'
      PersonId_SourceSystemId_Label 'PersonId(SourceSystemId)'
      DateFromLabel 'DateFrom'
      EmailTypeLabel 'EmailType'
      EmailAddressLabel 'EmailAddress'

    3. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto PersonEmail per generare un loop for-each.
    4. Creare questi mapping tra l'origine NewHire e gli elementi di destinazione PersonEmail:
      5. Attributo NewHire origine Attributo PersonEmail di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('EM', {employeeExternalNumber} )
      employeeExternalNumber PersonId_SourceSystemId_
      hireDate DateFrom
      EmailType 'W1'
      email EmailAddress

    Relazione di lavoro

    1. Espandere l'elemento target WorkRelationshipLabel.
    2. Assegnare queste espressioni ai seguenti attributi WorkRelationshipLabel:
      3. Attributo WorkRelationshipLabel di destinazione Espressione
      SourceSystemOwnerLabel 'SourceSystemOwner'
      SourceSystemIdLabel 'SourceSystemId'
      PersonId_SourceSystemId_Label 'PersonId(SourceSystemId)'
      DateStartLabel 'DateStart'
      WorkerTypeLabel 'WorkerType'
      LegalEmployerNameLabel 'LegalEmployerName'
      ActionCodeLabel 'ActionCode'
      PrimaryFlagLabel 'PrimaryFlag'

    3. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto WorkRelationship per generare un loop for-each.
    4. Creare questi mapping tra l'origine NewHire e gli elementi di destinazione WorkRelationship:
      5. Attributo NewHire origine Attributo WorkRelationship di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('WR', {employeeExternalNumber} )
      employeeExternalNumber PersonId_SourceSystemId_
      hireDate DateStart
      WorkerType "E"
      legalEmployerName LegalEmployerName
      (x) $ActionCode ActionCode
      PrimaryFlag 'S'

    Condizioni di impiego

    1. Espandere l'elemento target WorkTermsLabel.
    2. Assegnare queste espressioni ai seguenti attributi WorkTermsLabel:
      3. Attributo WorkTermsLabel di destinazione Espressione
      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'

    3. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto WorkTerms per generare un loop for-each.
    4. Creare questi mapping tra l'origine NewHire e gli elementi di destinazione WorkTerms:
      5. Attributo NewHire origine Attributo WorkTerms di destinazione Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('ET', {employeeExternalNumber} )
      employeeExternalNumber PeriodOfServiceId_SourceSystemId_ concat('WR',{employeeExternalNumber})
      hireDate Data inizio validità
      (x) $EffectiveEndDate Data fine validità
      EffectiveSequence '1'
      EffectiveLatestChange 'S'
      (x) $ActionCode ActionCode
      employeeExternalNumber AssignmentName concat('ET', {employeeExternalNumber} )
      employeeExternalNumber NumeroAssegnazione concat('ET', {employeeExternalNumber} )
      PrimaryWorkTermsFlag 'S'

    Assegnazione

    1. Espandere l'elemento target AssignmentLabel.
    2. Assegnare queste espressioni ai seguenti attributi AssignmentLabel:
      3. Attributo AssignmentLabel di destinazione Espressione
      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'

    3. Mappare l'elemento di origine ripetuto NewHire all'elemento di destinazione ripetuto Assegnazione per generare un loop for-each.
    4. Creare questi mapping tra gli elementi di origine NewHire e di destinazione Assegnazione:
      5. Attributo NewHire origine Attributo assegnazione target Espressione
      (x) $SourceSystemOwner SourceSystemOwner
      employeeExternalNumber SourceSystemId concat('E', {employeeExternalNumber} )
      employeeExternalNumber PersonId_SourceSystemId_ concat('ET', {employeeExternalNumber} )
      hireDate Data inizio validità
      (x) $EffectiveEndDate Data fine validità
      EffectiveSequence '1'
      EffectiveLatestChange 'S'
      (x) $ActionCode ActionCode
      employeeExternalNumber AssignmentName concat('E', {employeeExternalNumber} )
      employeeExternalNumber NumeroAssegnazione concat('E', {employeeExternalNumber} )
      PrimaryAssignmentFlag 'S'
      businessUnit BusinessUnitShortCode
      AssignmentStatusTypeCode 'ACTIVE_PROCESS'
      PersonTypeCode 'Dipendente'
      hireDate ProjectedStartDate

    Istruzione SET

    Se è necessario includere un'istruzione SET nel file, attenersi alla procedura riportata di seguito.

    1. Espandere l'elemento target SetInstructions.
    2. Creare un'espressione per includere l'istruzione SET completa per l'attributo Istruzione.



    Task 7: Zip del file generato

    In questa attività comprimi il file che hai generato.

    1. Aggiungere un'azione File stadio direttamente sotto l'azione WriteFile e denominarla ZipFile.
    2. Scegliere l'operazione del file di fase Zip File.
    3. Specificare un nome file per il file zip, ad esempio NewHires.zip.
    4. Fare clic sull'icona Vista sviluppatore per il campo della directory e selezionare directory dalla gerarchia di origine $WriteFile

    5. Specificare 'outputdirectory' per la directory di output.
    6. Fare clic su Continua e su Fine.


    Task 8: Critta file

    È consigliabile cifrare tutti i file caricati in Oracle WebCenter.

    In questo task verrà creato uno switch che consente di controllare quando cifrare il file. È possibile lasciare il file non cifrato durante lo sviluppo per eseguire il test della definizione di integrazione e della trasformazione del file.

    Definisci variabili per parametri programma di caricamento dati HCM

    1. Nel pannello di navigazione a destra fare clic su Azioni e selezionare Assegna. Trascinare questa operazione sull'icona + dopo Pianifica in modo che sia la prima azione dell'integrazione.
    2. Rinominare l'azione AssignHDLParameters.
    3. Creare una variabile denominata FileEncryption e assegnare un valore 'NONE'.
    4. Creare una 2a variabile denominata DeleteSourceFile e assegnare un valore 'N'.

      5. Suggerimento

      Ripetere l'operazione per qualsiasi altro parametro HDL che si desidera modificare tra sviluppo e produzione.

      Nota

      Stiamo creando queste variabili ora poiché lo switch creato nel passo successivo fa riferimento alla variabile FileEncryption.

    Creare un passaggio alla cifratura dei file di controllo

    1. Nel pannello di navigazione a destra fare clic su Azioni e selezionare Cambia nell'intestazione Logic. Trascinare questa opzione sull'icona + dopo l'azione ZipFile. Verrà visualizzata la pagina Configura instradamento.
    2. Specificare EncryptHDLFile come nome instradamento.
    3. Fare clic sul pulsante Vista sviluppatore nel campo Valore per visualizzare le origini di input.
    4. Trascinare la variabile $FileEncryption nel campo Valore. Impostare l'operatore su = e specificare il valore 'PGPUNSIGNED'.

    Cifra il file

    1. Fare clic sull'icona + nella casella Cambia e selezionare l'azione File stadio.
    2. Specificare un nome EncryptFile e, facoltativamente, una descrizione. Fare clic su Continua.
    3. Scegliere l'operazione del file di fase Cifra file.
    4. Fare clic sulle icone Vista sviluppatore a destra dei campi Riferimento file e Nome file.
    5. Espandere completamente la gerarchia di origini $ZipFile.
    6. Trascinare l'elemento di origine FileReference nel campo Riferimento file.
    7. Trascinare l'elemento di origine nome file nel campo Nome file.
    8. Specificare un nome di directory per OutputDirectory, ad esempio '/WorkerOutput'.
    9. Selezionare il certificato PGP fusion-key per cifrare il file.

    10. Fare clic su Continua e su Fine.

    Suggerimento

    Verrà creata l'azione di richiamo per caricare il file in Oracle WebCenter. Ciò richiederà la creazione di due mapping, uno per ogni instradamento in questo switch.

    Task 9: Carica file in Oracle WebCenter

    In questo task verrà richiamata la connessione a Oracle HCM Cloud per caricare il file in Oracle WebCenter.

    Crea l'azione Carica file

    1. Fare clic sull'icona + dopo lo switch e cercare "web". Selezionare la connessione Oracle WebCenter HDL Import.

    2. Specificare un nome UploadFile e, facoltativamente, una descrizione. Fare clic su Continua.
    3. Selezionare Invia file a HCM Cloud e fare clic su Continua.

    4. Selezionare il gruppo di sicurezza FAFusionImportExport e l'account doc hcm$/dataloader$/import$.
    5. Fare clic su Continua e su Fine.

      Suggerimento

      Una mappa UploadFile verrà generata automaticamente prima dell'azione Richiama e dopo lo switch.

    Definire la mappa di caricamento file per i file cifrati

    In questo task verrà creata la mappa UploadFile per l'instradamento dei file cifrati.

    1. Se non è già stato espanso, espandere lo switch.
    2. Fare clic sull'azione Mappa UploadFile e selezionare Taglia.

    3. Fare clic sull'icona + direttamente dopo l'azione EncryptFile e fare clic su Incolla.

    4. Modificare la mappa UploadFile.
    5. Fare clic sui pulsanti Sviluppatore e XSLT ed espandere completamente la gerarchia degli elementi di origine $EncryptFile.
    6. Creare questi mapping tra l'elemento ICSFile dell'origine $EncryptFile e gli elementi di destinazione FileUpload:
      7. Elemento $EncryptFile di origine Elemento FileUpload di destinazione Espressione
      FileReference fileReference
      filename docTitle
      docType 'Documento'


    7. Convalidare la mappa e tornare allo sfondo di integrazione.

    Definire la mappa di caricamento file per i file non cifrati

    In questa procedura verrà creata la mappa UploadFile per l'instradamento dei file non cifrati.

    1. Creare l'instradamento Altrimenti facendo clic sul menu per lo switch e selezionando Aggiungi > Altrimenti.

    2. Fare clic sull'icona + nell'instradamento Altro e selezionare Mappa.

    3. Selezionare UploadFile quando viene richiesto a quale endpoint mappare i dati e fare clic su Crea.

    4. Fare clic sui pulsanti Sviluppatore e XSLT ed espandere completamente la gerarchia degli elementi di origine $ZipFile.
    5. Creare questi mapping tra l'elemento ICSFile dell'origine $ZipFile e gli elementi di destinazione FileUpload:
      6. Elemento $ZipFile di origine Elemento FileUpload di destinazione Espressione
      FileReference fileReference
      filename docTitle
      docType 'Documento'

    6. Convalidare la mappa e tornare allo sfondo di integrazione.


    Task 10: Avvia programma di caricamento dati HCM

    In questo passo verrà richiamata la connessione REST del programma di caricamento dati HCM per avviare l'importazione e il caricamento del file caricato in Oracle WebCenter mediante l'azione UploadFile.

    1. Creare un'azione Richiama direttamente dopo l'azione UploadFile.
    2. Selezionare l'azione Richiama per la connessione REST HDL.

    3. Specificare un nome e, facoltativamente, una descrizione.

    4. Specificare l'endpoint come /action/createFileDataSet e impostare l'azione su POST.

    5. Selezionare la casella di controllo seguente:
      • Configurare un payload di richieste per questo endpoint
      • Configurare questo endpoint per la ricezione della risposta

    6. Fare clic su Continua.
    7. Completare i seguenti campi nella pagina Configura richiesta:
      8. Prompt Valore
      Selezionare il formato del payload della richiesta Esempio JSON
      Trascinamento della selezione Utilizzare il file JSON createFileDataSet payload.txt.
      Qual è il tipo di supporto del corpo della richiesta? Altro tipo di supporto
      Tipo di supporto applicazione/vnd.oracle.adf.action+json


    8. Fare clic su Continua
    9. Completare questi campi nella pagina Configura risposta:
      10. Prompt Valore
      Selezionare il formato del payload della risposta Esempio JSON
      Trascinamento della selezione Utilizzare JSON createFileDataSet response.txt.
      Qual è il tipo di supporto del corpo della richiesta? JSON

    10. Fare clic su Continua. Fare clic su Fine.

      11. L'azione Mappa ImportAndLoad verrà generata automaticamente.


    Configurare la mappa ImportAndLoad

    In questo passo si configurerà la mappa ImportAndLoad per fare riferimento al file caricato in Oracle WebCenter e sostituire i parametri del programma di caricamento dati HCM, se necessario.

    1. Modificare la mappa ImportAndLoad.
    2. Fare clic sui pulsanti Developer e XSLT.
    3. Espandere l'elemento target request-wrapper.

      4. Suggerimento

      Questi campi popolano i parametri createFileDataSets.
    4. Espandere completamente la gerarchia di elementi di origine $UploadFile.
    5. Eseguire il mapping dei campi seguenti:
      6. Attributo FileUploadResponse origine Attributo wrapper richiesta di destinazione Espressione
      dDocName contentId
      $FileEncryption fileEncryption
      $DeleteSourceFile deleteSourceFileFlag

      Suggerimento

      Il comportamento HDL predefinito prevede l'eliminazione del file di origine da Oracle WebCenter non appena HDL ha trasferito i dati nelle relative tabelle intermedie. Prendere in considerazione l'impostazione di deleteSourceFileFlag su 'N' finché il file non è stato rivisto e convalidato.
    6. Convalidare il mapping e salvare l'integrazione.


    Task 11: Registrazione

    L'ultimo passo della configurazione di qualsiasi integrazione consiste nell'impostazione dell'identificativo business. Ciò genera un valore univoco per il monitoraggio e la generazione di report.

    1. Fare clic su Identificativi aziendali a destra della barra dei menu.
    2. Trascinare e rilasciare l'origine startTime nel primo campo identificativo business.

    3. Salva l'integrazione.


    Task 12: Attivazione ed esecuzione dell'integrazione

    1. Cifrare e caricare il file di origine nel server FTP nella cartella specificata nell'azione DownloadFile. Ad esempio, /inbound/nh se è stata creata l'integrazione Nuove assunzioni.

      Suggerimento

      A questo scopo, è possibile utilizzare NewHires.csv.
    2. Uscire dall'integrazione se si è ancora nell'area di creazione dell'integrazione.
    3. Trovare l'integrazione nella pagina Progettazione > Integrazioni.

      4. Suggerimento

      Lo stato deve essere Configurato. Se è ancora Bozza, l'integrazione contiene errori ed è necessario modificarli, esaminarli e risolverli.
    4. Selezionare l'integrazione e viene visualizzato un menu a livello di riga. Fare clic su Attiva.

    5. Specificare il livello di trace e fare clic su Attiva.
    6. Aggiornare le informazioni sull'integrazione finché lo stato non è Attivo.
    7. Fare clic sull'icona Azioni nel menu Riga e selezionare Esegui.

    8. Fare clic su Esegui

      9. Verrà visualizzato il flusso di attività.

    9. Aggiorna occasionalmente fino al completamento dell'elaborazione.

    Convalida del file in Oracle WebCenter

    Durante l'esecuzione dell'integrazione, è possibile convalidare la forma del file recuperandola da Oracle WebCenter.

    1. Eseguire il login a Oracle Cloud.
    2. Passare a Strumenti > Importazione ed esportazione file.
    3. Impostare Conto su hcm/dataloader/import e fare clic su Cerca.

      4. Suggerimento

      Il comportamento HDL predefinito prevede l'eliminazione del file di origine da Oracle WebCenter non appena HDL ha trasferito i dati nelle relative tabelle intermedie. Questo comportamento viene sostituito dalla variabile deleteSourceFile definita.

    Cifratura del file HDL

    Al termine del test, ricordarsi di abilitare la cifratura dei file e di consentire a HDL di eliminare il file di origine da Oracle WebCenter una volta letto.

    1. Modificare l'azione AssignHDLParameters.
    2. Aggiornare il valore FileEncryption su 'PGPUNSIGNED'.
    3. Aggiornare il valore DeleteSourceFile su 'Y'.


    Esercitazioni:

    Altre risorse di apprendimento

    Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visitare education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

    Per la documentazione del prodotto, visitare Oracle Help Center.