Introduzione

You can use HCM Data Loader (HDL) to bulk-load data into your descriptive and extensible flexfield segments and to upload attachments and images for those HDL objects that support it.

Nota

Si prevede di comprendere come creare e caricare file utilizzando il programma di caricamento dati HCM. Se non hai familiarità con HDL, devi prima completare i tutorial elencati nella sezione Prerequisiti.

Obiettivi

In questa esercitazione:

  • Comprendere come fornire i dati per i segmenti dei flexfield descrittivi.
  • Caricare i dati nei segmenti flexfield estensibili.
  • Scopri come fornire immagini e allegati.
  • Caricare le immagini persona utilizzando l'oggetto Lavoratore.

Prerequisiti

Per completare questo tutorial è necessario:

Si consiglia di completare questi tutorial prima di provare questo tutorial:


Task 1: Ricerca dei nomi degli attributi flexfield

In questo passo verrà descritto come trovare i nomi degli attributi HDL per i segmenti flexfield configurati. Si suppone che la configurazione del flexfield sia stata completata e che le modifiche siano state distribuite.

  1. Eseguire il login all'applicazione con un utente con accesso al programma di caricamento dati HCM.
  2. Passare a Scambio dati > Visualizza business object.
  3. Utilizzare i campi Query per esempio per cercare il business object Job.
  4. Selezionare il business object e fare clic su Aggiorna oggetto.
    5. Fare clic su Aggiorna oggetto

  5. Fare clic su Sottometti nella pagina Schedula richiesta.
  6. Fare clic su Visualizza risultati processo nell'intestazione della pagina.
  7. Aggiornare la tabella fino al completamento del processo di aggiornamento dell'oggetto, quindi tornare alla pagina Visualizza business object.

    8. Suggerimento

    È necessario aggiornare un oggetto solo se sono stati configurati nuovi segmenti flexfield. Questo processo aggiorna l'elenco degli attributi disponibili per l'oggetto.
  8. Fare clic sul nome del business object Job per andare alla pagina Dettagli business object.
  9. Verrà visualizzata la gerarchia di oggetti a sinistra, quindi fare clic sul componente nella gerarchia per il quale si desidera trovare le informazioni sugli attributi del flexfield.
  10. Fare clic sulla scheda Attributi flexfield.
  11. Modificare il contesto nel contesto per il quale si desidera trovare gli attributi e fare clic su Cerca.
    Scheda Attributi flexfield

  12. Viene visualizzato l'elenco dei nomi di attributo da utilizzare nel file del programma di caricamento dati HCM:
    13. Attributi flexfield

Task 2: Caricamento dei dati flexfield

In questo passo verrà descritto come fornire le righe METADATA e MERGE per caricare i dati nei segmenti flexfield.

Contesto flexfield

Durante il caricamento dei segmenti flexfield, HDL deve comprendere il contesto dei dati flexfield in fase di caricamento. È possibile caricare i dati solo per un contesto in una linea MERGE, anche se per i flexfield descrittivi, i segmenti globali possono essere popolati insieme a segmenti specifici del contesto.

  1. Per i flexfield descrittivi ed estensibili, il contesto viene definito utilizzando l'attributo seguente:
    2. FLEX:{flexfield code}

    Esempi: FLEX:PER_JOBS_DFF e FLEX:PER_JOBS_LEG_EFF

  2. Quando si forniscono segmenti flexfield, il nome dell'attributo include un suggerimento che assegna un nome al codice flexfield e al contesto:
    3. {flexfield attribute name}({flexfield code}={context code})

    Ad esempio, clearanceLevel(PER_JOBS_DFF=US_JOB_REQ). Questo formato indica a HDL che il segmento del livello svendita appartiene al flexfield PER_JOBS_DFF all'interno del contesto US_JOB_REQ.


Caricamento dei segmenti flexfield descrittivi

I flexfield descrittivi estendono un componente oggetto aziendale. Specificare gli attributi del flexfield descrittivo nella stessa riga MERGE degli attributi di base del componente oggetto aziendale. Nella linea METADATA è necessario includere sia il codice flexfield che gli attributi del flexfield descrittivo per i quali si desidera caricare i dati.

Poiché i segmenti dei flexfield descrittivi non sono preconfigurati, non è possibile fornire un esempio che è possibile caricare. Attenersi alla procedura riportata di seguito per comprendere come caricare i dati dei flexfield descrittivi, ma i nomi e i valori degli attributi dovranno essere sostituiti con i dati pertinenti alla configurazione.

  1. Creare un nuovo file e fornire una linea METADATA che definisca gli attributi di base, insieme agli attributi del flexfield descrittivo per cui si desidera includere i dati. Ad esempio:
    2. METADATA|Job|SourceSystemOwner|SourceSystemId|EffectiveStartDate|SetCode|JobCode|Name|FLEX:PER_JOBS_DFF|clearanceLevel(PER_JOBS_DFF=US_JOB_REQ)
  2. Aggiungere linee MERGE al file per specificare i valori degli attributi di base, il contesto flexfield e i valori dei segmenti flexfield, ad esempio:
    3. MERGE|Job|VISION|SMGR|2000/01/01|COMMON|SNR_MGR|Senior Manager|US_JOB_REQ|HIGH

    Verrà caricato un valore ALTO nel segmento del flexfield descrittivo Livello di liquidazione esistente nel contesto del flexfield US_JOB_REQ.


Caricamento dei segmenti flexfield estensibili

Oltre a un codice flexfield e a un contesto, i flexfield estensibili dispongono anche di un codice categoria che deve essere fornito all'attributo EFF_CATEGORY_CODE.

  1. Creare un nuovo file e aggiungere la seguente riga METADATA:
    2. METADATA|JobLegislative|SourceSystemOwner|SourceSystemId|JobId(SourceSystemId)|EffectiveStartDate|LegislationCode|InformationCategory|FLEX:PER_JOBS_LEG_EFF|EFF_CATEGORY_CODE|_EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS)|_FLSA_STATUS(PER_JOBS_LEG_EFF=HRX_US_JOBS)
  2. Aggiungi la seguente riga MERGE al tuo file:
    3. MERGE|JobLegislative|VISION|MGR_JOB_LEG|MGR|2000/01/01|US|HRX_US_JOBS|HRX_US_JOBS|JOB_LEG|PROFESSIONAL|NONEXEMPT

    In questa tabella vengono descritti gli attributi flexfield forniti in questo file:

    Nome attributo Valore Descrizione
    FLEXFIELD:PER_JOBS_LEG_EFF HRX_US_JOBS Codice contesto del flexfield.
    EFF_CATEGORY_CODE JOB_LEG Codice categoria del flexfield.
    _EEO1_CATEGORY(PER_JOBS_LEG_EFF=HRX_US_JOBS) PROFESSIONISTA Segmento categoria EEO1 nel contesto HRX_US_JOBS del flexfield PER_JOBS_LEG_EFF.
    _FLSA_STATUS(PER_JOBS_LEG_EFF=HRX_US_JOBS) NON ESENTE Segmento di stato FLSA nel contesto HRX_US_JOBS del flexfield PER_JOBS_LEG_EFF.

    Suggerimento

    Questi segmenti flexfield sono convalidati dalla ricerca. Viene fornito il codice di lookup, ma se è necessario fornire il significato a un attributo flexfield, aggiungere _Display al nome dell'attributo, ad esempio: _EEO1_CATEGORY_Display(PER_JOBS_LEG_EFF=HRX_US_JOBS)

  3. Salvare il file assegnando un nome a Job.dat.
  4. Comprimi (zip) il tuo file Job.dat in un nome file a tua scelta.
  5. Importare e caricare i dati dei flexfield mansione utilizzando il task Importa e carica dati.

Task 3: Caricamento di immagini e allegati

In questo passo verrà creato un file per caricare le immagini persona. Gli allegati vengono caricati nello stesso modo.

Si estenderà l'esempio Nuova assunzione creato nell'esercitazione Crea e carica nuove assunzioni con programma di caricamento dati HCM (HDL).

  1. Creare un nuovo file e aggiungere quanto segue:
    2. METADATA|PersonImage|SourceSystemOwner|SourceSystemId|PersonId(SourceSystemId)|ImageName|Image|PrimaryFlag
MERGE|PersonImage|EMP|HDL001_IMG|HDL001|Chris Wells Profile|chris_wells.png|Y
MERGE|PersonImage|EMP|HDL002_IMG|HDL002|Lorraine Hugh Profile|lorraine_hugh.jpg|Y

    Il componente PersonImage viene utilizzato per caricare l'immagine del dipendente.

    • Ogni record PersonImage è identificato da una chiave di origine. Ad esempio, EMP, HDL001_IMG.
    • Il record padre viene identificato utilizzando l'attributo PersonId. Poiché l'ID del sistema di origine viene utilizzato per identificare il record padre, l'attributo contiene il suggerimento (SourceSystemId).
    • L'attributo ImageName viene utilizzato per fornire un nome per l'immagine.
    • L'attributo Immagine viene utilizzato per specificare il nome del file da caricare.
  2. Salvare il file assegnando un nome a Worker.dat.

    3. Suggerimento

    Sebbene il file contenga solo record PersonImage, è comunque necessario assegnare un nome alla gerarchia di oggetti a cui appartiene il componente PersonImage.
  3. Nella stessa directory del file Worker.dat, creare una sottodirectory e denominarla BlobFiles.

    4. Suggerimento

    I file immagine e allegati vengono caricati in attributi con tipo di dati BLOB o CLOB. È necessario fornire i file immagine e allegato in una directory denominata per il tipo di dati dell'attributo in uso. Ad esempio, BlobFiles o ClobFiles.
  4. Aggiungere i file specificati all'attributo Image all'interno del file Worker.dat nella directory BlobFiles. Ad esempio, chris_wells.png e lorraine_hugh.jpg.

    5. Suggerimento

    È possibile utilizzare file personalizzati o scaricare chris_wells.png e lorraine_hugh.jpg.
  5. Comprimere (zip) il file Worker.dat con la sottodirectory BlobFiles, in un nome file a scelta oppure scaricare e modificare il file Person Images.zip.
  6. È ora possibile caricare il file con il programma di caricamento dati HCM.

Passi successivi

Le esercitazioni riportate di seguito amplieranno ulteriormente le conoscenze del programma di caricamento dati HCM:

Gli ultimi tutorial per HDL e HSDL sono pubblicati in questo argomento su Cloud Customer Connect:

Per ulteriori informazioni, consultare i seguenti argomenti della Guida:

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.