Passa al contenuto principale
Documentazione
Documentazione
Adaptive Planning
Ultimo aggiornamento: 2023-06-23
Creare caricatori attributi di Planning

Creare caricatori attributi di Planning

I caricatori di metadati sincronizzano le informazioni gerarchiche dai sistemi di origine alle gerarchie del modello di pianificazione. Le gerarchie dovrebbero già esistere nel sistema di origine prima di tentare la sincronizzazione.
Il caricatore attributi di Planning consente di mappare i metadati degli attributi dall'area di gestione temporanea
Adaptive Planning
. Invece di creare i singoli attributi nell'amministratore attributi, è possibile utilizzare il caricatore attributi per importarli in blocco da un sistema esterno e sincronizzarli. Una volta creato un caricatore, è possibile eseguirlo manualmente o pianificarne l'esecuzione nell'ambito di un'attività di integrazione.
Guarda il video:
 1m 32s

Procedura di base

  • Immettere le impostazioni dell'origine dati
  • Configurare la mappatura delle colonne
  • Creare le regole aziendali
  • Visualizzare l'anteprima dell'output del caricatore
  • Eseguire o pianificare l'esecuzione del caricatore

Prerequisiti

Il caricatore attributi di Planning richiede i dati di gestione temporanea da un'importazione di un'origine dati esistente. Prendere nota dell'origine dati che si desidera utilizzare.
Autorizzazioni richieste: Operatore di integrazione, Designer dati, Modello.

Navigazione

Compass.png Dal menu di navigazione, accedere a
Integrazione
Progettazione integrazioni

Immettere le impostazioni dell'origine dati

In Impostazioni dell'origine dati è possibile scegliere la tabella di origine che si desidera utilizzare nei dati di gestione temporanea e indicare se creare automaticamente nuovi attributi.
Best practice: salvare spesso il lavoro durante la creazione e l'aggiornamento del caricatore. Fare clic su
Salva
 nel pannello Azioni. Per ignorare eventuali modifiche non salvate, fare clic su
Chiudi
, quindi su
No
.
  1. Selezionare
    Crea nuovo caricatore
     nella sezione Caricatori della Libreria dei componenti.
  2. Selezionare
    Caricatore attributi di Planning
     come tipo di caricatore. Immettere un nome per il caricatore.
  3. Selezionare
    Crea
    .
  4. Immettere i dati delle proprietà generali del caricatore attributi:
    • Tabella di origine
      : selezionare la tabella di origine dall'elenco a discesa. L'elenco contiene tutte le tabelle disponibili nell'area di gestione temporanea a cui l'utente può accedere.
    • Attributo di pianificazione
      : selezionare l'attributo all'interno
      Adaptive Planning
       in cui caricare
    • Crea valore attributo se non trovato nella pianificazione
      : selezionare questa opzione per creare automaticamente nuovi valori attributo trovati nel sistema di origine, ma non in Modellazione > Gestione modelli > Attributi. Se si deseleziona questa opzione, vengono aggiornati solo i valori attributo esistenti nel modello.
    • Pubblica le modifiche alla pubblicazione dell'amministratore in attesa
      : If Concetto: Pubblicazione amministratore ha modifiche al workflow in attesa, selezionare questa opzione per pubblicare le modifiche.
    • Livello registro: scegliere il tipo di dettagli da acquisire durante l'esecuzione del caricatore.
      • Disattivato
        : non viene registrato nessun errore.
      • Errore
        : vengono registrati solo gli errori gravi.
      • Info
        : vengono registrate le informazioni di base, ad esempio quando è stato aggiornato il caricatore.
      • Dettagli
        : vengono registrate informazioni dettagliate su tutte le fasi e le azioni. Questa opzione è utilizzata principalmente per il debug o il controllo.

Configurare la mappatura delle colonne

La mappatura delle colonne consente di mappare le colonne dall'origine dati alle proprietà degli attributi disponibili in
Modellazione
 >
Gestione dei modelli
 >
Attributi
. È possibile annullare la mappatura delle colonne per ignorare i dati di gestione temporanea che non si desidera caricare. È anche possibile annullare la mappatura delle colonne una alla volta dopo l'esecuzione del caricatore, per risolvere i problemi delle colonne che generano errori nei registri.
Se sono presenti più colonne da mappare, utilizzare il filtro
Mostra
per selezionare:
  • Tutto
    : mostra tutte le colonne di Planning.
  • Obbligatorio
    : mostra tutte le colonne di Planning obbligatorie, come ID padre e Attributo.
  • Non mappate
    : mostra tutte le colonne di Planning non mappate.
  • Mappatura completata
    : mostra tutte le colonne di Planning mappate.
Utilizzare
Categoria
per effettuare la selezione.
  • Tutto
    : mostra tutte le colonne. Gli attributi non utilizzano le categorie.
Per trovare le colonne desiderate è possibile utilizzare il campo
Cerca
. Immettere un nome completo o parziale da cercare e fare clic sulla lente di ingrandimento. Le colonne di gestione temporanea corrispondenti alla ricerca vengono visualizzate nei risultati.
Mappa colonne
La scheda Mappatura colonne contiene le seguenti colonne:
  • Stato:
    un segno di spunta Colonna mappata indica una colonna mappata. Un punto esclamativo Colonna non mappata indica una colonna non mappata.
  • Colonna di pianificazione:
    visualizza tutte le colonne di pianificazione disponibili per la mappatura in un foglio. L'elenco delle colonne di Planning include un insieme di colonne di Planning obbligatorie, seguite da tutte le altre colonne. Le colonne di Planning obbligatorie sono indicate in grassetto con un asterisco e includono una colonna valore. Le colonne non obbligatorie includono Descrizione.
  • Colonna di origine:
     visualizza le colonne all'interno della tabella di gestione temporanea scelta in Impostazioni origine dati.
  1. Fare clic su
    Mappatura colonne
    .
  2. Selezionare una colonna non mappata dall'elenco a discesa. Le colonne disponibili per la mappatura vengono visualizzate nell'elenco. Man mano che si mappano le colonne, l'indicatore di stato cambia da un punto esclamativo IntegrationMappingUnmapped.png a un segno di spunta IntegrationMappingMapped.png.
Mappare gli attributi padre degli attributi
La colonna ID padre indica l'ID del padre di un valore attributo. Per caricare nell'attributo più in alto in una gerarchia, è necessario che il valore ID padre nei dati di origine sia vuoto. Se si desidera creare valori attributo figli al di sotto del primo livello, anche l'ID padre deve essere vuoto.
Annullare la mappatura delle colonne
Per annullare la mappatura delle colonne, fare clic su
Annulla mappatura
 e scegliere:
  • Annulla tutte le mappature
    : annulla la mappatura di tutte le colonne.
  • Annulla mappatura elementi selezionati
    : annulla solo la mappatura delle colonne selezionate.
L'annullamento della mappatura di una colonna modifica l'icona di stato in un punto esclamativo. IntegrationMappingUnmapped.png.
Best practice: oltre che per risolvere i problemi e ignorare le colonne, l'annullamento della mappatura può essere utilizzato per facilitare la gestione delle modifiche. Quando vengono inserite nuove colonne in un'origine dati, è possibile annullare la mappatura delle colonne precedenti per mappare quelle nuove.

Scaricare e caricare mappature

È possibile scaricare, modificare e quindi caricare mappature per i caricatori, per risolvere rapidamente gli errori di mappatura. L'operazione di caricamento ha esito positivo solo se non si verificano errori. Al momento del caricamento viene elaborato solo un foglio di mappature del file. Eventuali fogli di mappature aggiuntivi generano errori e comportano l'annullamento del caricamento.
  1. Fare clic su
    Scarica mappature membri
     nel riquadro
    Azioni
    .
  2. Scaricare il file .XLSX. L'utente riceverà anche un'e-mail o una notifica Workday con un collegamento per il download del file delle mappature.
  3. Aprire il file e cercare i valori della tabella di gestione temporanea nel foglio delle mappature che causano errori.
    Eventuali celle contrassegnate come non valide nella colonna
    Codice di pianificazione
     o
    Nome pianificazione
     indicano che il codice non esiste più in Workday Adaptive Planning.
  4. Correggere gli errori e fare clic su
    Carica mappature membri
     per caricare il file. La colonna
    Sola lettura
     non viene caricata.
  5. Eseguire nuovamente il caricatore.
Non fare clic su
Cancella mappature membri
, se non diversamente indicato dal partner di implementazione o dall'assistenza di Workday Adaptive Planning.

Creare regole aziendali

È possibile utilizzare le regole aziendali per creare espressioni SQL che limitano i dati di gestione temporanea disponibili per il caricamento. Verranno caricati solo i record che soddisfano i criteri del filtro.
La scheda
Regole aziendali
 contiene un'area di testo per l'immissione di codice SQL.
Per creare un filtro SQL:
  1. Nella scheda
    Regole aziendali
    , selezionare
    Filtro SQL
    . Fare clic su
    Modifica
    .
  2. Immettere un'espressione SQL. Per inserire una colonna nell'espressione SQL anziché digitarla, fare clic sulla colonna nell'elenco Colonne disponibili.
  3. Fare clic su
    Applica
     per verificare la sintassi SQL. In caso di errori di sintassi, il bordo intorno all'espressione diventerà di colore rosso. Passare il puntatore del mouse sull'editor SQL per visualizzare informazioni sugli errori di sintassi.
    Per informazioni dettagliate sulla sintassi SQL, fare clic sulla
    guida online
     nella sezione Note di Modifica filtro SQL. Consultare Riferimenti: Espressioni SQL per ulteriori informazioni.
  4. Correggere eventuali errori della sintassi e fare clic su
    Applica
    . Quando si esegue il caricatore, verranno caricate solo le righe di gestione temporanea corrispondenti all'espressione SQL.

Visualizzare l'anteprima dell'output del caricatore

È possibile visualizzare l'anteprima dell'output del caricatore, per verificare le mappature e correggere gli errori di convalida prima dell'esecuzione del caricatore.
Quando viene eseguita l'anteprima dell'output del caricatore o il caricamento manuale, i dati di origine vengono convalidati per rilevare eventuali errori. Ad esempio, il sistema verifica se:
  • Viene creato un valore attributo senza indicare l'attributo padre.
  • A un attributo viene assegnato un valore attributo che non è stato trovato.
  • Il valore dell'ID di origine per l'attributo è mancante (vuoto) nei dati.
  • I dati contengono ID origine o nomi attributo duplicati. Gli ID origine devono essere univoci.
  • Nei dati, un valore ParentId è uguale all'ID origine. In tal caso, la colonna fa riferimento a se stessa come colonna padre.
  • Un nodo esistente spostato sotto un nuovo nodo e
    Crea valore attributo se non trovato in Planning
     è disabilitato. Un attributo esistente viene spostato in un nuovo nodo ma il caricatore è impostato in modo da non creare nuovi valori attributo.
  • I dati hanno un riferimento ciclico nella gerarchia. Un valore ParentId fa riferimento a un suo elemento figlio come padre.
È anche possibile scaricare l'output di anteprima come file XML per verificare manualmente che i gli attributi dell'origine dati siano conformi ai requisiti prima di caricarli.
  1. Fare clic su
    Anteprima output caricatore
     nel pannello Azioni.
  2. (Facoltativo) Immettere le impostazioni di Anteprima output caricatore. Le informazioni che è possibile immettere variano a seconda dell'origine dati scelta per il caricatore attributi di Planning. La modifica delle impostazioni in questa fase determina l'importazione di nuovi dati nelle tabelle e nelle colonne di gestione temporanea.
  3. Fare clic su
    Anteprima output caricatore
    .
Il caricatore viene eseguito con tutte le trasformazioni e le regole aziendali. Un popup di stato mostra gli step eseguiti durante l'esecuzione del caricatore. Se sono disponibili attributi per il caricamento, il caricatore crea un file XML e invia una notifica e-mail allegando l'output XML come file zip. Se non viene caricato nessun attributo, il file zip contiene un messaggio indicante che non è stato caricato nessun attributo.
Dopo il completamento dell'esecuzione del caricatore, un popup aggiuntivo consente di scaricare l'anteprima dell'output del caricatore come file XML compresso. La visualizzazione del popup per il download potrebbe richiedere un certo tempo, a seconda del numero di attributi e delle dimensioni del file.

Eseguire il caricatore

Dopo aver salvato un caricatore attributi di Planning con le impostazioni obbligatorie, eseguire il caricatore manualmente o come attività di integrazione pianificata.
Attendere circa 15-30 minuti tra ogni esecuzione del caricatore attributi di Planning
Adaptive Planning
 ha tempo per sincronizzarsi con l'importazione. Maggiore è la dimensione delle importazioni, maggiore sarà il tempo necessario per la sincronizzazione. Il tempo di attesa dipende dalle dimensioni del modello e da altri fattori.
Per eseguire manualmente il caricatore, fare clic su
Esegui manualmente
 nel pannello Azioni.
È possibile caricare gli attributi direttamente dal sistema di origine oppure eseguire il caricatore utilizzando valori di gestione temporanea già importati. Al momento dell'esecuzione del caricatore, selezionare il comportamento desiderato tra i seguenti. Scegliere
Ignora importazione dati
 per utilizzare la tabella di gestione temporanea esistente per il caricamento. L'opzione per ignorare l'importazione dei dati non è disponibile quando si utilizzano come origini dati i fogli di calcolo.
Nell'ambito del processo di esecuzione, il caricatore verifica che i dati nella tabella di gestione temporanea siano stati mappati correttamente. Durante il caricamento vengono eseguite varie convalide. Eventuali errori visualizzati durante il caricamento indicano cosa è necessario risolvere per completare l'importazione.
Includere il caricatore attributi di Planning in un'attività di integrazione
Qualsiasi attività di integrazione può avere uno o più caricatori. Un'attività può contenere altre attività di integrazione, ad esempio
Dashboard
 caricatori di metriche e caricatori con script.
Best practice: impostare un'attività di integrazione separata per ciascun caricatore.
Se un'attività contiene più caricatori, i parametri di ciascun caricatore vengono visualizzati in un messaggio a comparsa al momento dell'esecuzione dell'attività. Se nei caricatori inclusi in un'attività è presente un parametro comune o condiviso, l'attività richiede il parametro una sola volta. È possibile scegliere di sostituire le richieste di parametri.
Per le esecuzioni pianificate dell'attività vengono utilizzati i valori predefiniti dei parametri per i caricatori.