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

Creare caricatori livelli 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 livelli di Planning consente di mappare i metadati sulle gerarchie organizzative dall'area di gestione temporanea
Adaptive Planning
.Utilizzare il caricatore livelli di pianificazione per importare i livelli in blocco, invece di crearli uno alla volta nell'amministrazione dei livelli. Una volta creato un caricatore, è possibile eseguirlo manualmente o pianificarne l'esecuzione nell'ambito di un'applicazione
Integrazione
 attività
Guarda il video:
 1 minuto e 36 secondi

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 livelli 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

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 dell'integrazione e indicare se creare automaticamente nuovi livelli.
Best practice: salvare spesso il lavoro durante la creazione e la modifica del caricatore. Fare clic su
Salva
 nel pannello Azioni. Per ignorare eventuali modifiche non salvate, fare clic su
Chiudi
, quindi su
No
.
  1. Fare clic su
    Crea nuovo caricatore
     nella sezione Caricatori della Libreria dei componenti.
  2. Selezionare
    Caricatore livelli di Planning
     come tipo di caricatore. Immettere un nome per il caricatore.
  3. Fare clic su
    Crea
    .
  4. Immettere i dati delle proprietà generali del caricatore livelli di Planning:
    • Tabella di origine
      : selezionare la tabella di origine dall'elenco a discesa. Le tabelle di origine presenti nell'elenco sono tutte le tabelle disponibili nell'area di gestione temporanea alle quali è consentito accedere.
    • Crea livello se non trovato in Planning
      : selezionare questa opzione per creare automaticamente nuovi livelli trovati nel sistema di origine, ma non trovati in
      Modellazione
      livelli
      di gestione dei modelli
      . Deselezionare l'opzione per aggiornare solo i livelli esistenti nel modello.
    • Propaga aggiornamenti livello applicabili ai figli
      :
      selezionare
       per aggiornare i livelli figlio se la modifica riguarda una proprietà a cascata. Se questa opzione è deselezionata, verrà modificato solo il livello aggiornato in modo esplicito.
    • Elimina elementi durante la disabilitazione del workflow
      :
      selezionare per eliminare
      elementi all'interno del workflow quando i workflow vengono disabilitati. Se questa opzione è deselezionata, gli elementi del workflow non verranno eliminati quando il workflow è disabilitato.
    • Elimina importi effettivi inaccessibili durante l'aggiornamento della disponibilità dei livelli
      : se la data di inizio o di fine degli importi effettivi in un livello cambia per rendere gli importi effettivi inaccessibili, questa opzione consente di eliminare i dati degli importi effettivi a cui non è possibile accedere.
    • Pubblica le modifiche alla pubblicazione dell'amministratore in attesa
      : If Concetto: Pubblicazione amministratore ha modifiche al workflow in attesa, selezionare per pubblicare le modifiche.
    • Mantieni ordine nella pianificazione
      : selezionare questa opzione per mantenere l'ordinamento dei livelli esistente già utilizzato in Adaptive Planning.
    • Procedi con avvisi
      : selezionare questa opzione per continuare con il caricamento quando vengono visualizzati messaggi di avviso.
    • 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 colonne consente di mappare le colonne dell'origine dati ai livelli disponibili in
Modellazione
livelli
di gestione dei modelli
. È 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.
L'unico modo per ottenere un elenco degli ID livello esistenti è utilizzare l'API exportLevels . L'ID livello non viene visualizzato in nessun punto dell'interfaccia utente dell'applicazione. Al momento del caricamento, la Colonna ID di origine per i livelli diventa l'ID livello.
Se sono presenti più colonne da mappare, utilizzare il filtro
Mostra
 per selezionare:
  • Tutto
    : mostra tutte le colonne di Planning.
  • Obbligatorie
    : mostra tutte le colonne di pianificazione obbligatorie, ad esempio ID padre e Livello.
  • Non mappate
    : mostra tutte le colonne di Planning non mappate.
  • Mappatura completata
    : mostra tutte le colonne di Planning mappate.
Utilizzare la
Categoria
per selezionare:
  • Dettagli livello
    : mostra le colonne relative ai dettagli del livello, tra cui Nome abbreviato, Valuta e Nel workflow. Nel workflow deve essere un valore booleano pari a 1 se vero o pari a 0 se falso.
  • Impostazioni eliminazione
    : mostra le colonne relative alle impostazioni di eliminazione, tra cui il livello di eliminazione e il partner commerciale eliminazione. Questi valori booleani devono essere pari a 1 per vero o a 0 per falso.
  • Impostazioni versione
    : mostra le colonne relative alle impostazioni della versione, inclusi inizio e fine degli importi effettivi. Questi valori devono essere formati data, ad esempio 01/01/2010.
  • Attributi di livello
    : mostra le colonne relative agli attributi livello.
  • Dimensioni livello
    : mostra le colonne relative alle dimensioni livello.
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
    .
  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.
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 Nome abbreviato e Valuta.
  • Colonna di origine:
     visualizza le colonne all'interno della tabella di gestione temporanea scelta in Impostazioni origine dati.
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.
Mappare i livelli padre dei livelli
La colonna ID padre indica l'ID del livello padre di un livello. Per caricare nel livello più in alto in una gerarchia, è necessario che il valore ID padre nei dati di origine sia vuoto. Se si desidera creare un livello figlio al di sotto del primo livello, anche l'ID padre deve essere vuoto.
Consultare Esempio: Caricare i livelli dalle origini dati del foglio di calcolo per un esempio di mappatura dei livelli e dei relativi livelli padre alla pianificazione.
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. Per ulteriori informazioni, consultare 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 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 sottolivello senza indicare il livello padre.
  • A un attributo di livello viene assegnato un valore attributo che non è stato trovato.
  • Il valore dell'ID di origine per il livello è mancante (vuoto) nei dati.
  • I dati contengono ID origine o nomi di livello 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.
  • Quando si importano sottolivelli, la radice del sottolivello viene mappata a un nodo esistente in
    Adaptive Planning
    . Il parentID non è presente nei dati di origine per un nuovo nodo in cui è stato introdotto
    Adaptive Planning
    .
  • Un nodo esistente è stato spostato sotto un nuovo nodo e il flag Crea nuovo è disabilitato. Un livello esistente viene spostato in un nuovo nodo ma il caricatore è impostato in modo da non creare nuovi livelli.
  • I dati hanno un riferimento ciclico nella gerarchia. Un valore ParentId fa riferimento a un suo elemento figlio come padre.
  • Un livello viene impostato come partner commerciale di eliminazione e uno dei livelli figlio viene impostato come livello di eliminazione. Un livello impostato come partner commerciale di eliminazione non può avere un livello figlio che è un livello di eliminazione.
È anche possibile scaricare l'output di anteprima come file XML per verificare manualmente che i livelli 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 livelli 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 con tutte le trasformazioni e le regole aziendali. Un popup di stato mostra gli step eseguiti durante l'esecuzione del caricatore. Se sono disponibili livelli 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 livello, il file zip contiene un messaggio indicante che non è stato caricato nessun livello.
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 livelli e delle dimensioni del file.

Eseguire il caricatore

Dopo aver salvato un caricatore livelli 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 livelli 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 i livelli 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 livelli 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, come i 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.
Risoluzione dei problemi relativi a messaggi e avvisi
Consultare Riferimenti: Messaggi di registro per i caricatori livelli di Planning per le descrizioni dei messaggi registrati durante un caricamento.