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

Creare caricatori dimensioni 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.
Le richieste del caricatore dimensioni di Planning sono limitate all'aggiornamento di un massimo di 10.000 valori dimensione in una dimensione gerarchica o di 40.000 valori dimensione in una dimensione fissa. Questi limiti non si applicano alla creazione di nuovi valori dimensione all'interno di una richiesta del caricatore.
Il caricatore dimensioni di Planning consente di mappare i metadati sui valori dimensione dall'area di gestione temporanea
Adaptive Planning
. Il vantaggio principale del caricatore dimensioni di Planning è la possibilità di importare i valori delle dimensioni in blocco, anziché crearli singolarmente in Modellazione > Gestione dei modelli > Dimensioni. Una volta creato un caricatore, è possibile eseguirlo manualmente o pianificarne l'esecuzione nell'ambito di un'attivitàdi integrazione .

Per creare un caricatore dimensioni di Planning, attenersi alla procedura seguente:
  1. Immettere le impostazioni dell'origine dati
  2. Configurare la mappatura delle colonne
  3. Creare regole aziendali
  4. Visualizzare l'anteprima dell'output del caricatore
  5. Eseguire o pianificare l'esecuzione del caricatore

Prima di iniziare

Il caricatore dimensioni di Planning richiede i dati di gestione temporanea da un'importazione di un'origine datiesistente.

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, selezionare la Dimensione di pianificazione nella quale eseguire il caricamento e decidere se creare automaticamente nuovi valori dimensione.
  1. Passare a
    Integrazione > Progettazione integrazioni
    .
  2. Fare clic su
    Crea nuovo caricatore
    nell'area Caricatori della Libreria dei componenti.
  3. Selezionare
    Caricatore dimensioni di Planning
     come tipo di caricatore. Immettere un nome per il caricatore.
  4. Fare clic su
    Crea
    .
Best practice: salvare spesso il lavoro durante la creazione e la modifica del caricatore, facendo clic su
Salva
nel pannello Azioni. È possibile ignorare eventuali modifiche non salvate facendo clic su
Chiudi
, quindi su
No.
Immettere i dati delle proprietà generali del caricatore dimensioni di Planning:
  • Tabella di origine:
     selezionare la tabella di origine dall'elenco a discesa. Le tabelle di origine nell'elenco sono tutte le tabelle disponibili nell'area di gestione temporanea alle quali è consentito accedere.
  • Dimensione pianificazione:
     scegliere tra le dimensioni quella in cui caricare l'origine. Le dimensioni elencate provengono da Modellazione > Gestione dei modelli > Dimensioni.
  • Crea valore dimensione se non trovato nella pianificazione:
     selezionare la casella per creare automaticamente nuovi valori dimensione trovati nel sistema di origine ma non trovati in Modellazione > Gestione dei modelli > Dimensioni. Se questa opzione non è selezionata, vengono eseguiti solo gli aggiornamenti dei valori dimensione esistenti e non vengono create nuove dimensioni.
    • Se per la dimensione in cui si caricano i dati non è abilitata l'opzione "L'importazione dei dati crea automaticamente i valori dimensione" in Modellazione > Gestione dei modelli > Dimensioni, il caricatore visualizza un avviso.
  • Livello registro:
     scegliere il tipo di dettagli registrati durante l'esecuzione del caricatore.
    • Errore
      :
       vengono registrati solo gli errori gravi.
    • Info
      :
       vengono registrate le informazioni di base, ad esempio quando è stato aggiornato il caricatore.
    • Dettagli
      :
       specifica informazioni dettagliate su tutte le fasi e le azioni. Questo livello viene utilizzato principalmente per il debug o la verifica, perché può aggiungere al registro una quantità di informazioni eccessiva.

Configurare la mappatura delle colonne

La mappatura delle colonne consente di mappare le colonne dell'origine dati ai valori dimensione disponibili in Modellazione > Gestione dei modelli > Dimensioni.
Se sono presenti più colonne da mappare, è possibile utilizzare il filtro
Mostra
per selezionare:
  • Tutto
    : mostra tutte le colonne di Planning.
  • Obbligatorio
    : mostra tutte le colonne di Planning obbligatorie.
  • Non mappate
    : mostra tutte le colonne di Planning non mappate.
  • Mappatura completata
    : mostra tutte le colonne di Planning mappate.
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
  1. Fare clic su
    Mappatura colonne
    .
    La scheda Mappatura colonne contiene:
    • Stato:
      indica se una colonna di pianificazione è mappata. 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 il nome abbreviato e la descrizione.
    • Colonna di origine:
       visualizza le colonne all'interno della tabella di gestione temporanea scelta in Impostazioni origine dati.
  2. Selezionare una colonna non mappata e fare clic sull'elenco a discesa. L'elenco a discesa visualizza un elenco di colonne che è possibile mappare. Man mano che si mappano le colonne, l'indicatore di stato passa da rosso IntegrationMappingUnmapped.png a verde IntegrationMappingMapped.png.
Quando l'opzione
L'importazione dei dati crea automaticamente i valori dimensione
 è abilitata, è possibile mappare gli attributi in base al codice. Il nome dell'attributo diventa automaticamente il codice.
Consultare Esempio: Caricare valori dimensione da origini dati foglio di calcolo per un esempio di mappatura dei valori dimensione e dei relativi padre a Planning.
Modificare i nomi dei valori dimensione di pianificazione al caricamento
Per modificare il nome di un valore dimensione di pianificazione al momento del caricamento:
  1. Selezionare la Colonna di origine che identifica in modo univoco il valore dimensione nell'origine.
  2. Mappare la colonna ID all'ID del valore dimensione.
  3. Mappare il nome al nome del valore dimensione.
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 selezionate
    :
     annulla la mappatura solo delle colonne selezionate.
Se si annulla la mappatura di una colonna, l'icona dello stato della mappa diventa rossa IntegrationMappingUnmapped.png.
Mappare gli attributi associati alle dimensioni elenco
È possibile associare attributi a una dimensione elenco mappando le colonne da un'importazione di un'origine dati.
L'associazione di attributi alle dimensioni è possibile solo per le dimensioni elenco. Non è possibile associare attributi alle dimensioni gerarchiche.
Entro
Adaptive Planning
 è possibile visitare
Gestione modelli
 >
Dimensioni
 e fare clic su una dimensione per visualizzarne i dettagli e scoprire se si tratta di una dimensione elenco.
In Impostazioni origine dati, selezionare una dimensione elenco come
Dimensione pianificazione
.
Gli attributi diventano disponibili come colonne all'interno di Mappatura colonne, perché la dimensione è una dimensione elenco.
Dato che le dimensioni elenco non sono gerarchiche, parentId non è un'opzione disponibile per Colonna di origine.

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 della gestione temporanea disponibili per il caricamento. Verranno caricati solo i record che soddisfano i criteri del filtro.
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 su
    guida online
     nella sezione Note di Modifica filtro SQL. È anche possibile visitare i riferimenti alle espressioni SQL.
  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 in anteprima l'output del caricatore prima di eseguire un caricamento completo, per verificare che le mappature corrispondano alle esigenze. È anche possibile scaricare l'output come file XML per verificare manualmente che i valori dimensione 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 dimensioni di Planning in uso. 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 applicando tutte le trasformazioni e le regole aziendali. Un popup di stato mostra gli step eseguiti dal caricatore. Se sono presenti valori dimensione da caricare, il caricatore crea un file XML e invia una notifica e-mail allegando l'output XML come file zip.
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 valori dimensione e delle dimensioni del file.
Correggere gli errori di convalida
Quando i valori dimensione vengono caricati, i dati di origine vengono convalidati per rilevare l'eventuale presenza dei seguenti errori:
  • Il valore dell'ID di origine per il valore dimensione è mancante (vuoto) nei dati.
  • I dati contengono ID origine duplicati. Gli ID origine devono essere univoci.
  • Un nome valore dimensione è mancante (vuoto) nei dati.
  • I dati contengono nomi valore dimensione duplicati.
  • Nei dati, un valore ParentId è uguale all'ID origine. In tal caso, la colonna fa riferimento a se stessa come colonna padre.
  • Quando si importa una struttura ad albero secondaria, la radice della struttura secondaria viene mappata su un nodo esistente in Planning. In questo caso, parentID non è presente nei dati di origine per un nuovo nodo che viene introdotto in Planning.
  • Un nodo esistente è stato spostato sotto un nuovo nodo e il flag Crea nuovo è disabilitato. In questo caso, un valore dimensione esistente viene spostato in un nuovo nodo quando il caricatore è stato impostato esplicitamente in modo da non creare nuovi valori dimensione.
  • I dati hanno un riferimento ciclico nella gerarchia. In questo caso, un valore ParentId fa riferimento a un suo elemento figlio come padre.

Eseguire il caricatore

Dopo aver salvato un caricatore dimensioni di Planning con tutte le impostazioni di configurazione necessarie, è possibile eseguirlo manualmente o come attività di integrazione pianificata.
Attendere circa 15-30 minuti tra ogni esecuzione del caricatore dimensioni di Planning, in modo che il
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.
È possibile importare 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 dimensioni di Planning in un'attività di integrazione
Qualsiasi attività di integrazione può contenere uno o più caricatori. Un'attività può contenere anche altre attività di integrazione, nonché caricatori metriche di Discovery 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 al momento dell'esecuzione dell'attività. Se è presente un parametro comune/condiviso utilizzato nel o nei caricatori inclusi in un'attività, l'attività lo richiederà una sola volta. È possibile scegliere di sostituire le richieste di parametri.
Per le esecuzioni pianificate dell'attività, vengono utilizzati i valori predefiniti dei parametri archiviati al momento della creazione dei caricatori.
Risoluzione dei problemi relativi a messaggi e avvisi
Per una spiegazione dei messaggi registrati durante un caricamento, consultare Riferimenti: Messaggi di registro per i caricatori dimensioni di Planning.

Caricare le modifiche a un valore dimensione di origine

Il caricatore dimensioni di Planning può rinominare un valore dimensione al momento del caricamento, se è già stata stabilita una mappatura al valore dimensione di origine.
Questa tabella illustra le mappature già stabilite dal caricatore. Il valore dimensione di origine "USA" è mappato alla colonna ID di origine "1001".
Valore dimensione pianificazione
Colonna ID di origine
Valore dimensione di origine
USA
1001
USA
Canada
1002
Canada
Nel sistema di origine, se "USA" diventa "Stati Uniti", il caricatore dimensioni di Planning può applicare la modifica al momento del caricamento, perché gestisce la mappatura tra la colonna ID di origine "1001" e l'ID interno di Planning per il valore dimensione "USA".
Valore dimensione pianificazione
Colonna ID di origine
Valore dimensione di origine
USA
1001
Stati Uniti
Canada
1002
Canada
L'esecuzione del caricatore modificherà il valore dimensione in Planning da "USA" a "Stati Uniti".