Introduzione

Questa esercitazione descrive i passi per generare e modificare file di mapping specifici di business object che possono quindi essere importati in Oracle Integration Cloud (OIC) per trasformare i dati nella forma del file di business object del programma di caricamento dati HCM.

Obiettivi

In questa esercitazione:

  • Abilita la generazione dei file di mapping.
  • Genera file di mapping generici e personalizzati.
  • Modifica i file di mapping generati.

Prerequisiti

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

  • Il task Configura programma di caricamento dati HCM per abilitare la generazione del file di mapping.
  • Il task Visualizza business object per generare file di mapping generici.
  • Programma di caricamento dati HCM per importare file di test e generare file di mapping personalizzati.

Per informazioni sulla configurazione di questo accesso, vedere l'esercitazione Configure Access to HCM Data Loader (HDL) and Understand HDL Security Options.


Task 1: Abilita generazione file di mapping

In questo passo verrà abilitata la generazione dei file di mapping OIC nel programma di caricamento dati HCM.

Esistono due metodi per generare i file di mapping:

  • Genera file business object generici completi.

    Utilizzare il task Visualizza business object per generare e scaricare i file di mapping che descrivono le gerarchie complete dei business object.

  • Genera file di business object personalizzati.

    Importa e carica i file di test per confermare la forma del file durante la generazione di un file di mapping nella forma del file importato.

Per abilitare la generazione dei file di mapping:

  1. Accedere all'applicazione Oracle HCM Cloud.
  2. Passare a Enterprise personale > Impostazione e manutenzione.
  3. Selezionare l'area funzionale Programma di caricamento dati HCM.
  4. Fare clic sul task Configura programma di caricamento dati HCM.
    5. Fare clic sul task Programma di caricamento dati HCM nell'area funzionale Programma di caricamento dati HCM.

  5. Cercare il parametro Genera file mapping business object.
    6. Utilizzare il campo Query By Example per cercare il parametro.

  6. Impostare Sostituisci su Sì.

    7. Quando si abilita la generazione dei file di mapping sono disponibili due opzioni di override:

    Valore di sostituzione Descrizione
    Solo personalizzati Consente di generare file di mapping per i file di dati dei business object caricati con il programma di caricamento dati HCM.
    Sì Consente la generazione di file di mapping generici dal task Visualizza business object oltre ai file personalizzati.

  7. Fare clic su Salva.

Suggerimento

Per ulteriori informazioni, cercare Genera file mapping business object nell'argomento Parametri di configurazione del programma di caricamento dati HCM.


Task 2: Genera file di mapping completi

In questo passo verrà generato un file di mapping per una gerarchia di business object completa.

  1. Accedere all'applicazione Oracle HCM Cloud.
  2. Passare a Gruppi clienti personali > Scambio dati > Visualizza business object.
  3. Cercare e selezionare il business object Record documento e fare clic su Aggiorna oggetto.
    4. Utilizzare la query per esempio per cercare Document Recor e fare clic su Aggiorna oggetto

  4. Aggiornare il contenuto della tabella fino a quando la colonna File mapping integrazione non visualizza un'icona del file di scaricamento per il business object Record documento.
    5. Aggiornare la tabella finché non viene visualizzata l'icona del file di scaricamento per l'oggetto Record documento.

  5. Fare clic sull'icona di download del file. Il file di mapping verrà scaricato.

Nota

Questo file verrà modificato in Task 4.


Task 3: Genera file di mapping personalizzati

Questo è l'approccio consigliato per generare i file di mapping per OIC. È innanzitutto necessario creare un file del programma di caricamento dati HCM nella forma in cui si desidera che l'integrazione OIC generi i file. Questo ha il vantaggio di verificare che la forma del file HDL sia corretta prima di creare l'integrazione.

  1. Definire un file di business object HDL. È possibile scaricare il file Mapping lavoratore File.zip ai fini di questa esercitazione.
  2. Accedere all'applicazione Oracle HCM Cloud.
  3. Passare a Gruppi clienti personali > Scambio dati > Importa e carica dati.
  4. Fare clic su Importa file.
  5. Trascinare il Mapping lavoratore File.zip scaricato nel pulsante Scegli file e fare clic su Rivedi parametri.
    6. Selezionare il file di origine e fare clic su Rivedi parametri

  6. Selezionare la casella di controllo Genera file mapping business object.
    7. Selezionare la casella di controllo Genera file mapping business object

  7. Fare clic su Sottometti.
  8. Fare clic su OK per chiudere la schermata di conferma Sottomesso.
  9. Aggiornare la tabella Data set fino a visualizzare il file di test.
  10. A volte, aggiornare la tabella Business object per il data set fino al completamento dell'importazione.
  11. Fare clic su Scarica file di mapping nella barra degli strumenti della tabella Business object per scaricare il file di mapping personalizzato.

    Questo pulsante viene abilitato dopo l'importazione del file del business object.

    12. Fare clic sul pulsante Scarica file di mapping

Suggerimento

Se si verificano errori di importazione, è probabile che la forma del file sia errata. Rivedere e correggere eventuali errori e scaricare il file di mapping solo dopo aver importato correttamente il file di test.


Task 4: Modifica dei file di mapping

È possibile modificare i file di mapping generati dal programma di caricamento dati HCM. In questo task verrà modificato il file di mapping dei record documento generato in Task 2.

Comprendere la forma del file

  1. Aprire il file DocumentsOfRecord.nxsd generato in Task 2.
  2. Esaminare il contenuto del file. Tutti i file di mapping seguono la stessa struttura; ci sono 3 tipi di gruppi di elementi:
    • Gruppo ObjectFileData

      Nella parte superiore del file è presente un gruppo ObjectFileData. Per ogni business object nella gerarchia, questo gruppo include un elemento ObjectLabel e un elemento oggetto:

      • L'elemento ObjectLabel definisce la linea METADATA.
      • L'elemento Oggetto definisce la linea MERGE (dati).

      Suggerimento

      Viene inoltre definita la formattazione per le linee.

    • Gruppo ObjectLabel

      Esiste un gruppo ObjectLabel per ogni business object nella gerarchia di oggetti. Il gruppo ObjectLabel include elementi per definire i nomi degli attributi disponibili per il business object. Quando OIC genera un file utilizzando questo mapping, i nomi e i terminatori degli attributi vengono aggiunti all'elemento ObjectLabel definito nel gruppo ObjectFileData precedente.

    • Gruppo Oggetto

      Esiste un gruppo di oggetti per ogni business object nella gerarchia di oggetti. Il gruppo oggetto include elementi per mappare i valori degli attributi disponibili al business object. Quando OIC genera un file utilizzando questo mapping, i valori degli attributi (e i terminatori) vengono aggiunti all'elemento dell'oggetto definito nel gruppo ObjectFileData precedente.

  3. Rivedere il gruppo ObjectFileData DocumentOfRecordFileData.

    4. La gerarchia di business object DocumentsOfRecord dispone di due oggetti: DocumentOfRecord e DocumentAttachment. Un elemento ObjectLabel e un elemento Object vengono generati per ogni business object nella gerarchia:


  4. Rivedere il gruppo ObjectLabel DocumentOfRecordsLabel.

    5. Questo gruppo include un elemento per definire il nome di ciascun attributo disponibile per il business object DocumentsOfRecord, inclusi gli attributi dei segmenti flexfield distribuiti.


    Nota

    Il gruppo completo è troppo grande per essere visualizzato qui.
  5. Rivedere il gruppo di oggetti DocumentOfRecord.

    6. Questo gruppo include un elemento per mappare i valori di ciascun attributo disponibile al business object DocumentsOfRecord.


    Suggerimento

    L'ordine degli attributi nei gruppi ObjectLabel e Oggetto per lo stesso business object deve corrispondere.
  6. Rivedere il gruppo ObjectLabel DocumentAttachmentLabel.

    7. Questo gruppo include un elemento per definire il nome di ciascun attributo disponibile per il business object DocumentAttachment.


  7. Rivedere il gruppo di oggetti DocumentAttachment.

    8. Questo gruppo include un elemento per mappare i valori di ciascun attributo disponibile al business object DocumentAttachment.


Modificare la forma DocumentOfRecord

OIC richiede di fornire un valore per ogni attributo definito dagli elementi nel file di mapping. Se non sono necessari attributi nel file HDL generato, rimuovere entrambi gli elementi per l'attributo dai gruppi ObjectLabel e Object.

  1. Eliminare gli elementi dai gruppi DocumentsOfRecordLabel e DocumentsOfRecord per tutti gli attributi tranne i seguenti:
    • DocumentName
    • DocumentCode
    • PersonNumber
    • DocumentType
  2. Riordinare gli elementi in questi gruppi in modo che vengano visualizzati in questo ordine di attributi:
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DocumentName

    Nota

    L'ultimo elemento del gruppo ha un valore terminatedBy diverso. La maggior parte degli elementi sono terminati dal carattere pipe, l'ultimo è terminato da un carattere di fine riga. Quando si modifica il file, assicurarsi che l'ultimo elemento di ciascun gruppo abbia il terminatore di fine riga.

    Suggerimento

    L'ordine degli elementi in questi gruppi determina l'ordine in cui gli attributi vengono inclusi nel file generato da OIC. Ad esempio, questa struttura genererà questa linea METADATA: 
    METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

Modificare la forma DocumentAttachment

  1. Eliminare gli elementi dai gruppi DocumentAttachmentLabel e DocumentAttachment per tutti gli attributi tranne i seguenti:
    • Titolo
    • File
    • DataTypeCode
    • DocumentCode
    • PersonNumber
    • DocumentType
    • URLorTextorFileName
  2. Riordinare gli elementi in questi gruppi in modo che vengano visualizzati in questo ordine di attributi:
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DataTypeCode
    • URLorTextorFileName
    • Titolo
    • File

    Questo tentativo genererà questa linea METADATA: 

    METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File

È ora possibile importare il file in OIC per generare un file HDL DocumentOfRecord.dat.

Nota

È possibile rimuovere intere definizioni di business object dai file di mapping generati se non è necessario fornire dati. A tale scopo, rimuovere i gruppi ObjectLabel e Oggetto per il business object, oltre agli elementi ObjectLabel e agli oggetti dal gruppo ObjectFileData.

Aggiunta di istruzioni SET alla forma del file

Potrebbe essere necessario includere le istruzioni SET nel file del business object. Il modo più semplice per farlo è modificare nxsd per creare un elemento che consenta di definire le istruzioni SET all'interno del mapping OIC.

In questo passaggio si modificherà il Worker.nxsd generato nel task 3.

  1. Aprire il file Worker.nxsd generato in Task 3 in un editor di testo.

    2. L'elemento WorkerFileData deve essere simile al seguente:


  2. Modificare questo elemento per introdurre una ref entry prima del riferimento WorkerLabel. Aggiungi: 
    3. <element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">
  3. Creare un nuovo elemento SetInstructions immediatamente sotto l'elemento WorkerFileData:
    4. <!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

    Suggerimento

    Supporta un'istruzione SET. Creare elementi aggiuntivi, ad esempio Instruction1, Instruction2, se è necessario definire più istruzioni SET all'interno del file da generare da OIC.


Passi successivi

Attenersi alla procedura descritta in questa esercitazione per generare un file di mapping utilizzato da OIC per generare i dati di origine nella forma del file del business object del programma di caricamento dati HCM.

Riconoscimenti

  • Autori - Ema Johnson (Senior Principal Product Manager)

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.