Passa al contenuto principale
Documentazione
Documentazione
Workday User Guide
Ultimo aggiornamento: 2023-11-03
Procedura: Creare un set di dati con dati esterni (server SFTP)

Procedura: Creare un set di dati con dati esterni (server SFTP)

Criteri di sicurezza: dominio
Prism Datasets: Create
 nell'area funzionale Prism Analytics.
È possibile creare un set di dati di base utilizzando dati esterni trasferendo i dati da un server SFTP. È possibile creare un set di dati di base che ottenga i dati da un server esterno quando il server raccoglie o aggiunge regolarmente nuovi dati. È possibile configurare la frequenza con cui il set di dati riceve i nuovi dati dal server.
I nuovi utenti di Workday non dispongono dell'accesso per creare o modificare i set di dati di base.
Affinché le esecuzioni di integrazione che trasferiscono i dati dal server SFTP abbiano esito positivo:
  • Il numero di file deve essere inferiore a 5.000.
  • Il tempo necessario per il trasferimento dei dati deve essere inferiore a 5 ore.
Ogni file del server deve contenere meno di 1 GB compresso (meno di 10 GB non compressi circa).
  1. Accedere al report
    Catalogo dati
     .
  2. Selezionare
    Crea
    da SFTP
    .
    Nell'attività
    Creazione recupero set di dati - Configurazione recupero file
     , si configura come importare i dati dal server SFTP.
  3. Nella sezione
    File
     , immettere il nome del file o un modello di nome file che rappresenti uno o più file.
    Il nome del file fa distinzione tra maiuscole e minuscole. È possibile utilizzare l'asterisco (*) e il punto interrogativo (?) come caratteri jolly per specificare un modello di nome file. Utilizzare l'asterisco (*) per specificare zero o più caratteri e utilizzare il punto interrogativo (?) per specificare esattamente un carattere.
  4. Nella sezione
    Trasporto
    , specificare come connettersi al server SFTP:
    Opzione Descrizione
    Indirizzo SFTP
    Utilizzare questo formato:
    sftp://
    domain_name
    o
    sftp://
    IP_address
    Per specificare un numero di porta, aggiungerlo alla fine del nome di dominio o dell'indirizzo IP. Se non si specifica un numero di porta, il sistema utilizza la porta 22.
    Directory
    (Facoltativo) Directory sul server che contiene i file. I nomi delle directory fanno distinzione tra maiuscole e minuscole. Includere una barra iniziale (/) solo per un percorso completo, non un percorso relativo.
    Utilizzare file temporaneo
    Scrive i dati importati in un file temporaneo in Workday con un nome generato in modo casuale. Al termine dell'importazione dei dati, il sistema rinomina automaticamente il file con il nome corretto.
    È possibile abilitare questa opzione se l'importazione dei dati richiede molto tempo e potrebbe non terminare prima dell'ora pianificata successiva per importare i dati dallo stesso server.
    Metodo e dettagli di autenticazione
    Selezionare il tipo di autenticazione di sicurezza utilizzata dal server SFTP:
    • Nome utente/Password
      .
    • Autenticazione SSH
      . Questa opzione utilizza l'autenticazione con chiave shell protetta tramite certificati X.509.
  5. (Facoltativo) Nella sezione
    Utilità file
     , considerare le seguenti opzioni:
    Opzione Descrizione
    Elimina dopo il recupero
    Elimina i file nel server SFTP dopo l'importazione dei dati nel set di dati. Se il sistema non è in grado di eliminare i file dal server SFTP, il recupero dei dati non riesce.
    Decomprimere
    Non abilitare questa opzione per i set di dati.
    È possibile trasferire file compressi o meno. Per i file compressi, il sistema supporta solo la compressione gzip.
    Decrittografare utilizzando
    Se si desidera decrittografare i file importati utilizzando Pretty Good Privacy (PGP), selezionare una coppia di chiavi private PGP.
  6. (Facoltativo) Nella sezione
    Limitazioni ambiente
     , all'elenco
    valori Limitato a
     , selezionare l'ambiente in cui si desidera utilizzare le impostazioni definite nella sezione
    Trasporto
     .
    Se si lascia vuota questa opzione, il sistema applica le impostazioni di trasporto a ogni ambiente in cui viene eseguita l'integrazione del set di dati. Quando un'integrazione di set di dati viene eseguita in un determinato ambiente, ad esempio Implementazione o Produzione, le impostazioni di trasporto funzionano solo se l'opzione
    Limitato
     a corrisponde all'ambiente corrente. Quando l'ambiente corrente e l'ambiente configurato non corrispondono, l'integrazione del set di dati non riesce e non recupera alcun file dal server SFTP. È possibile limitare le impostazioni di trasporto a un determinato ambiente per evitare di trasferire inavvertitamente i dati di test a un endpoint non di test.
    Esempio: si crea il set di dati in un ambiente di implementazione e si seleziona Implementazione in
    Limitato a
    . Successivamente, si esegue la migrazione del set di dati a un ambiente di produzione e alla successiva esecuzione dell'integrazione del set di dati, l'integrazione avrà esito negativo. Per garantire che l'integrazione del set di dati venga eseguita correttamente nell'ambiente di produzione, modificare i dettagli dell'integrazione del set di dati e deselezionare l'opzione
    Limitato a
     o impostarlo su Produzione.
  7. Nell'attività
    Creazione recupero set di dati - Pianificazione tipo richiesta
     , in
    Frequenza esecuzione
    , specificare la frequenza con cui importare i dati dal server SFTP.
    Se si importano i dati una volta in futuro o in base a una pianificazione, specificare i criteri per l'attività
    Creazione recupero set di dati - Integrazione pianificazione
     .
    Dopo aver creato il set di dati, è possibile eseguire l'integrazione per importare i dati nel set di dati ad hoc. Dal menu delle azioni correlate del report
    Visualizzazione dettagli set di dati
     , selezionare
    Set di dati
    Esegui integrazione ora
    .
    Non è possibile importare dati nello stesso set di dati in momenti che si sovrappongono.
  8. Specificare un nome univoco per il set di dati.
    Il nome del set di dati è ciò che viene visualizzato nel Catalogo dati. È possibile modificare il nome quando si crea, si modifica o si copia il set di dati.
  9. (Facoltativo) Modificare il nome dell'API del set di dati. Il sistema seleziona automaticamente un nome API in base al nome del set di dati immesso, modificandolo per soddisfare i requisiti del nome. Non è possibile modificare questo nome dopo aver completato la creazione del set di dati.
  10. (Facoltativo) Creare o modificare uno o più tag per organizzare il set di dati nel Catalogo dati.
  11. (Facoltativo) Aggiungere una descrizione per aiutare gli altri a comprendere i dati in questo set di dati. È possibile modificare la descrizione quando si modifica il set di dati.
  12. Selezionare la modalità di aggiornamento dei dati nel set di dati quando riceve nuovi dati da un'esecuzione dell'integrazione.
    Opzione Descrizione
    Sostituisci
    Il sistema elimina i dati esistenti nel set di dati e li sostituisce con i dati importati dal server SFTP.
    Aggiungi
    Il sistema mantiene i dati esistenti nel set di dati e vi aggiunge i nuovi dati importati dal server SFTP.
    Il sistema importa tutti i dati in tutti i file durante ogni esecuzione dell'integrazione. La modalità di aggiunta è diversa dall'aggiornamento incrementale dei dati in un set di dati. Il fatto che i dati nel set di dati vengano aggiornati in modo incrementale dipende dal fatto che il server SFTP contenga solo aggiornamenti incrementali dall'ultima esecuzione dell'integrazione.
    Lo schema del file deve soddisfare i seguenti requisiti:
    • Tutti i file in ogni esecuzione dell'integrazione devono utilizzare le stesse opzioni di analisi (inclusa la configurazione della riga di intestazione) utilizzate durante la prima esecuzione dell'integrazione.
    • I campi devono essere nello stesso ordine in tutti i file in ogni esecuzione dell'integrazione.
    • Se lo schema in un'esecuzione di integrazione successiva contiene nuovi campi, i nuovi campi devono trovarsi alla fine di tutti i campi precedenti.
    • Se lo schema del file in un'esecuzione di integrazione successiva elimina uno o più campi, i campi eliminati devono trovarsi alla fine.
    • Assicurarsi che se lo schema elimina i campi, nessuno schema futuro aggiunga nuovi campi, altrimenti l'esecuzione dell'integrazione avrà esito negativo. Per garantire che tutte le integrazioni future vengano eseguite correttamente, mantenere sempre i campi esistenti nello schema e aggiungere solo nuovi campi. Se necessario, è possibile includere valori vuoti (NULL) nei campi esistenti.
    • Tutti i file in una singola integrazione devono utilizzare lo stesso schema.
    Un'integrazione non riesce quando lo schema dei nuovi dati non contiene un campo attualmente esistente nel set di dati e il campo rimosso viene utilizzato in una fase del set di dati. Esempio: se il set di dati include una fase Gestione campi e l'integrazione importa dati a cui manca un campo nel set di dati, l'integrazione non riesce. Questo perché la fase Gestione campi funziona su tutti i campi del set di dati.
  13. Fare clic su
    Salva
    .
    Il sistema crea il set di dati, ma non contiene dati fino a quando i dati e i campi non vengono importati dal server SFTP durante la prima esecuzione dell'integrazione. A seconda di quando è stata pianificata l'importazione dei dati, il set di dati potrebbe essere vuoto per un po' di tempo. Il sistema aggiunge anche due campi che forniscono informazioni su ogni esecuzione dell'integrazione. Consultare Riferimenti: WPA_ Fields.
  14. (Facoltativo) Modificare il nome del piano di integrazione. Consultare Gestire i piani di integrazione dei set di dati.
  15. Accedere al report
    Catalogo dati
     , fare clic con il pulsante destro del set di dati appena creato e selezionare
    Modifica
    .
  16. Configurare la modalità di analisi dei dati nei file dal server SFTP.
  17. È possibile aggiungere solo alcuni tipi di fase ai set di dati di base.
  18. È possibile aggiungere un campo calcolato Prism a qualsiasi fase.

Questo contenuto non fa parte della Guida per l'amministratore di Workday.