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

Creare caricatori associazioni di Planning

Il caricatore associazioni di Planning consente di mappare i metadati sulle associazioni di dimensioni e livelli utente dall'area di gestione temporanea
Adaptive Planning
. Le associazioni connettono i livelli e le dimensioni personalizzate agli utenti. La proprietà del livello è un tipo di associazione utente che connette gli utenti ai livelli. A differenza delle normali associazioni di livello, la proprietà del livello include anche altri privilegi. Consultare
Una volta creato un caricatore, è possibile eseguirlo manualmente o pianificarne l'esecuzione nell'ambito di un'attività di integrazione. Consultare Creare attività di integrazione.

Prerequisiti

  • Il caricatore associazioni di Planning richiede i dati di gestione temporanea da un'importazione di un'origine datiesistente.
  • Autorizzazioni richieste: Modello, Operatore di integrazione, Designer dati

Procedura di base

  1. Immettere le impostazioni dell'origine dati
  2. Configurare la mappatura delle colonne
  3. Creare le regole aziendali
  4. Visualizzare l'anteprima dell'output del caricatore
  5. Eseguire o pianificare l'esecuzione del caricatore

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 selezionare le associazioni da caricare.
  1. Selezionare
    Crea nuovo caricatore
    nel pannello
    Caricatori
     della Libreria dei componenti.
  2. Selezionare
    Caricatore
    associazioni 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 associazioni nella scheda
    Impostazioni origine dati
    :
    • 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.
    • Profilo di mappatura
      : è possibile creare un collegamento a un profilo di mappatura nell'ambito del processo di creazione del caricatore. Selezionare il profilo di mappatura dall'elenco a discesa. I profili di mappatura nell'elenco sono quelli ai quali è consentito accedere. Consultare la sezione del profilo di mappatura nel caricatore dati di Pianificazione. Questo profilo di mappatura, insieme a tutte le mappature caricate insieme ai caricatori di metadati, mappano i livelli e le dimensioni di Planning. Consultare Creare caricatori dati di Planning. Esempio: se il caricatore di associazioni ha il valore della colonna livello (o per Workday, l'ID Workday) "999999", il profilo di mappatura determina il livello di Planning a cui fa riferimento.
    • Livello o dimensione
      : selezionare il livello per la proprietà o l'associazione del livello. Selezionare una dimensione per caricare le associazioni di dimensione.
    • Attributo:
       (facoltativo) selezionare un attributo di Adaptive Planning per il livello o la dimensione. In questo modo è possibile mappare e caricare le associazioni per gli attributi di livello o dimensione.
    • Modalità
      : selezionare
      Aggiorna
       per modificare le associazioni o le assegnazioni di proprietà per un sottoinsieme di livelli. Questa selezione aggiorna il livello, non l'utente. Gli aggiornamenti del livello richiedono la presenza di tutti gli utenti associati al livello nel payload. Selezionare
      Sostituisci tutto
       per eliminare tutti gli utenti delle associazioni citati nel payload e sostituirli.
      • Se si utilizza Adaptive Planning con Workday Human Capital Management o Workday Financials, l'opzione
        Modalità
         viene impostata automaticamente su
        Aggiorna
        .
      • Se non si utilizza Adaptive Planning con Workday Human Capital Management o Workday Financials, l'opzione
        Modalità
         viene impostata automaticamente su
        Sostituisci tutto
        .
    • Procedi con avvisi
      : selezionare per continuare a eseguire il caricatore quando vengono generati avvisi. Se non si seleziona l'opzione, l'esecuzione del caricatore si interrompe quando viene visualizzato un avviso. Se si seleziona l'opzione, il caricatore ignora le dimensioni o i livelli non mappati, crea un avviso nei registri e prosegue con l'elaborazione.
    • 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 alle associazioni disponibili in
Modellazione > Gestione dei modelli > Livelli
 o in
Modellazione > Gestione dei modelli > Dimensioni
. È necessario mappare l'
Utente
 e le
Colonne di pianificazione
.
Se l'utente è un cliente Workday che esegue una sincronizzazione utenti in questo ambiente, la colonna Utente deve essere mappata alla colonna di origine che contiene gli ID Workday. Se l'utente non ha eseguito la sincronizzazione utenti o non è un cliente Workday, la colonna utente deve essere mappata alla colonna di origine che contiene i nomi utente o le e-mail.
Se sono presenti più
colonne di pianificazione
 da mappare, utilizzare il filtro
Mostra
per selezionare una delle seguenti opzioni:
  • Tutte:
     mostra tutti gli utenti.
  • Obbligatorie
    :
    mostra tutte le colonne di Planning obbligatorie, ad esempio Utente e Livello.
  • 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 sulla scheda
    Mappatura 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 Planning disponibili per la mappatura. Le colonne di Planning obbligatorie appaiono in grassetto con un asterisco.
    • 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.
Mappare le colonne per la proprietà del livello
Se si desidera caricare solo la proprietà del livello, non mappare un ID per il codice di associazione del livello nella
Colonna di origine
. L'impostazione della proprietà del livello in
Amministrazione
 >
Associazioni
 deriva dal fatto che il codice di associazione rimane vuoto.
Mappare colonne per associazioni di livelli e dimensioni
Se si desidera caricare associazioni di livelli e dimensioni, mappare un identificativo come
ID riferimento
 per il codice di associazione nella
Colonna di origine.
Non è possibile caricare sia la proprietà del livello sia l'associazione del livello in un singolo caricatore. Creare un caricatore per la proprietà del livello e un caricatore separato per l'associazione del livello.
Mappatura colonne per associazione attributi
Se si desidera caricare gli attributi di livello o dimensione con associazioni, mapparli nella
Colonna di origine
. Gli attributi vengono visualizzati nella parte inferiore delle mappature, sotto Nome associazione.
Annullare la mappatura delle colonne
È 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 colonna alla volta dopo l'esecuzione del caricatore, per risolvere i problemi relativi alle colonne che generano errori nei registri.
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.

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 su
    guida online
    nella sezione Note di Modifica filtro SQL. Consultare Riferimenti: 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 funzionino nel modo desiderato. È anche possibile scaricare l'output come file XML per verificare manualmente che le associazioni di proprietà del livello utente dell'origine dati siano conformi ai requisiti prima di caricarle.
Fare clic su
Anteprima output caricatore
 nel riquadro Azioni.
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 di associazione utente 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 di associazione e delle dimensioni del file.
Correggere gli errori di convalida
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:
  • Il valore ID origine per Utente o Livello e Dimensione è mancante (vuoto) nei dati.
  • L'ID origine non è mappato.

Eseguire il caricatore

Dopo aver salvato un caricatore associazioni 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 associazione di Planning, in modo che il file
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 associazioni 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.