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

Creare caricatori conti 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 conti di Planning consente di mappare i metadati dei conti CoGe dall'area di gestione temporanea
Adaptive Planning
.Utilizzare il caricatore conti per importare i conti in blocco da un sistema esterno e sincronizzarli, invece di creare conti uno alla volta nell'amministrazione conti. 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 dei conti 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: Modello, 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 conti.
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 conti di Planning
    come tipo di caricatore. Immettere un nome per il caricatore.
  3. Selezionare
    Crea
    .
  4. Immettere i dati delle proprietà generali del caricatore conti:
    • 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.
    • Conto pianificazione
      : selezionare il conto CoGe in cui caricare i conti figlio. Per caricare un'intera struttura di conti CoGe, selezionare Conti CoGe dall'elenco a discesa Conti. Il caricamento dell'intera struttura dei conti CoGe richiede che l'origine dati contenga tutti i nodi radice CoGe definiti in
      Adaptive Planning
      .
    • Pubblica le modifiche alla pubblicazione dell'amministratore in attesa
      : If Concetto: Pubblicazione amministratore ha modifiche al workflow in attesa, selezionare questa opzione per pubblicare tali modifiche durante l'esecuzione del caricatore.
    • Crea un conto se non trovato nella pianificazione
      : selezionare questa opzione per creare automaticamente nuovi conti trovati nel sistema di origine ma non trovati in Modellazione > Gestione dei modelli > Conti. Se si deseleziona questa opzione, vengono aggiornati solo i conti CoGe esistenti nel modello.
    • Mantieni ordine nella pianificazione:
      selezionare questa opzione per mantenere l'ordinamento dei conti esistente già utilizzato in Adaptive Planning.
    • Procedi con avvisi
      : selezionare questa opzione per assegnare un nuovo padre ai conti e rendere i valori degli attributi compatibili con l'attributo del conto padre. Se l'opzione non è selezionata, il caricatore genera un errore quando il payload contiene valori attributo del conto figlio non compatibili con l'attributo del conto padre.
    • 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à dei conti disponibili in
Modellazione
>
Gestione dei modelli
>
Conti
. È 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, ad esempio ID padre e Conto.
  • 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 conto
    :
    mostra le colonne relative ai dettagli del conto:
    • Codice conto
    • Nome abbreviato
    • Esegue il rollup a
    • Descrizione
    • Tipo
    • Ponderato in base a
    • Testo visualizzato
    • Pianificazione in base a
    • Importi effettivi in base a
    • Sovrapposizione importi effettivi
    • Tipo di saldo
    • Nel workflow
      Nel workflow deve essere un valore booleano pari a 1 se vero o pari a 0 se falso.
  • Tutto
    : mostra tutte le colonne. È possibile visualizzare solo il
    Tipo di immissione dati
    nella categoria
    Tutto
    :
    • I valori validi per
      Tipo di immissione dati
      sono STANDARD, CUBO o vuoto.
    • Se il valore è vuoto, il
      Tipo di immissione dati
      eredita il tipo dal conto padre.
    • Se il
      Tipo di immissione dati
      padre è CUBO, il valore predefinito di un nuovo conto sarà CUBO. In caso contrario, per impostazione predefinita, i nuovi conti assumono il valore STANDARD.
    • Le modifiche al
      Tipo di immissione dati
      apportate ai conti non foglia vengono ignorate. Il sistema calcola automaticamente il nuovo
      Tipo di immissione dati
      per tutti i conti non foglia.
  • Tipo di dati
    : mostra le colonne relative alle impostazioni dei tipi di dati del conto, tra cui Strato temporale conto, Visualizza come, Formula predefinita, Conversione con media ponderata, Reimposta saldo, Trasferisci saldo alla reimpostazione, Posizioni decimali e Tassi di cambio.
  • Fogli
    : mostra le colonne relative alla visualizzazione dei conti nei fogli, incluse le opzioni Elimina in fogli e Avvia visualizzazione espansa.
  • Attributi conto
    : mostra le colonne relative agli attributi del conto, incluso l'elenco di tutti gli attributi associati al conto.
  • Privacy dati
    : mostra le colonne inerenti al livello pubblico o privato dei dati di un conto, tra cui Contiene dettagli sullo stipendio.
  • Consolidamento
    : mostra le colonne relative alle impostazioni di consolidamento, tra cui le Interaziendale, Partner commerciale eliminazione e Azienda controllata. Disponibile solo per istanze con il consolidamento abilitato.
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 Planning disponibili per la mappatura. 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 ID di origine:
    visualizza le colonne all'interno della tabella di gestione temporanea scelta in Impostazioni origine dati.
  • Colonna codice conto di origine:
    indica la colonna del codice conto, per semplificare il processo di mappatura. Ogni conto in
    Adaptive Planning
    richiede un codice conto.
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 conti padre dei conti
La colonna ID padre indica l'ID del conto padre di un conto. Per caricare nel conto più in alto in una gerarchia, è necessario che il valore ID padre nei dati di origine sia vuoto. Se si desidera creare un conto figlio 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. 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 conto secondario senza indicare il conto padre.
  • A un attributo conto viene assegnato un valore attributo che non è stato trovato.
  • Il valore dell'ID di origine per il conto è mancante (vuoto) nei dati.
  • I dati contengono ID origine o nomi di conto 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 i conti secondari, la radice del conto secondario 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 conto esistente viene spostato in un nuovo nodo ma il caricatore è impostato in modo da non creare nuovi conti.
  • 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 conti 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 conti 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 conti 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 conto, il file zip contiene un messaggio indicante che non è stato caricato nessun conto.
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 conti e delle dimensioni del file.
Questo è un esempio di file XML di output decompresso scaricato:
Anteprima output caricatore - XML dei metadati

Eseguire il caricatore

Dopo aver salvato un caricatore conti di Planning con le impostazioni richieste, eseguire il caricatore manualmente o come attività di integrazione pianificata.
Attendere circa 15-30 minuti tra ogni esecuzione del caricatore conti 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 conti 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 conti 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 un caricatore dei dati di Planning o un caricatore 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.