Introduzione
Il modello Data Dictionary Chain consente agli utenti di acquisire ed esportare in un foglio di calcolo i dettagli di alto livello di tabelle specifiche all'interno del loro spazio di lavoro. Gli utenti possono specificare una parola chiave per individuare le tabelle, definire il nome del foglio di calcolo di esportazione e creare una tabella nell'area di lavoro per memorizzare lo schema di ogni tabella.
Per ulteriori dettagli, consulta la documentazione sul processo Load Data to Wdata per una panoramica completa. Si raccomanda di consultare questa documentazione prima di utilizzare il modello Data Dictionary .
Prerequisiti
Questo modello presuppone che i seguenti oggetti siano già impostati nella tua applicazione Workiva:
- Sovvenzione API
- Per utilizzare le API di Workiva, un utente deve stabilire un OAuth API Grant all'interno del proprio spazio di lavoro. Fai riferimento a questo articolo per le pratiche principali per la gestione del Grant OAuth.
- I seguenti Connettori devono essere abilitati e configurati nel tuo spazio di lavoro:
Nota: Alcuni valori delle variabili possono contenere informazioni sensibili come nomi utente e password. Si consiglia di utilizzare l'opzione "Crittografa" per le variabili sensibili alle informazioni e di impostare i permessi appropriati per il tuo foglio di calcolo.
- Configurare le variabili
Nota: È consigliabile impostare il valore predefinito di questa variabile a 50 (che rappresenta 50MB), anche se può essere modificato se necessario.
-
- Inoltre, è necessario creare altre quattro variabili dell'area di lavoro prima di utilizzare la catena Data Dictionary.
Di seguito è riportata una descrizione di ogni variabile che deve essere impostata e popolata:
Crea la tua catena
Il modello Data Dictionary | ALL | Primary Chain si trova nella sezione Catene di Workiva della schermata Modelli.
Ecco come trovarlo:
- In Builder catene, vai alla scheda Template .
- Seleziona Catene di Workiva dal menu in alto
- Cerca Data Dictionary | ALL | Primary Chain Template in alto a destra e apri il modello.
Quando la catena Data Dictionary | ALL | Primary viene distribuita in un'area di lavoro, distribuirà automaticamente sei sotto-catene aggiuntive.
Gli utenti devono assicurarsi che tutte e sette le catene siano state distribuite e pubblicate nello stesso spazio di lavoro:
- Dizionario Dati | TUTTI | Primario
- Dizionario dati | Crea documento e sottosezioni | Creazione foglio elettronico
- Dizionario dei dati | Crea documento e sottosezioni | Creazione foglio
- Dizionario dei dati | Crea tabella
- Carica i dati in Wdata | Catena primaria
- Carica dati in Wdata | Sostituisci dataset
- Carica i dati in Wdata | Aggiungi un nuovo set di dati
Dopo aver individuato il tuo modello, configuralo per il tuo spazio di lavoro utilizzando le variabili create nella precedente sezione.
Nota: per istruzioni dettagliate sulla creazione di una catena da un template, consulta l'articolo Creare e gestire catene.
Input di runtime
Quando si esegue questa catena primaria (Data Dictionary | ALL | Primary), i seguenti input di esecuzione dovranno essere popolati o passati attraverso una catena chiamante:
| Input di runtime | Descrizione | Tipo di campo | È necessario? |
|---|---|---|---|
| NomeFoglioSpazzatura | Specifica il nome del foglio di calcolo in cui verrà scritto lo schema della tabella. | Testo | Sì |
| Valore di ricerca | Questo input viene utilizzato per individuare le tabelle che contengono la parola chiave specificata. | Testo | Sì |
| Nome tabella Wdata | Specifica il nome della tabella del dizionario dei dati creata durante l'esecuzione iniziale del modello. | Testo | Sì |
Tabella Wdata
Per utilizzare questa catena, deve esistere una tabella Wdata del Dizionario dei Dati all'interno dell'area di lavoro. La catena creerà automaticamente questa tabella, utilizzando la convenzione di denominazione "Tabella dizionario dati", a meno che l'utente non specifichi un nome diverso.
Per creare la tabella del dizionario dei dati verrà utilizzato il seguente schema di tabella:
| Nome della colonna | Descrizione della colonna | ID colonna | Tipo di colonna |
|---|---|---|---|
| Nome_tabella | N/D | nome_tavolo | testo |
| Alias | N/D | alias | testo |
| Modalità | N/D | modalità | testo |
| Nome | N/D | nome | testo |
| Tipo | N/D | tipo | testo |
Disclaimer sulle modifiche personalizzate: Se gli utenti riscontrano problemi di mancata corrispondenza delle intestazioni delle colonne quando importano i loro dati in una tabella Wdata, possono utilizzare la preparazione dei dati o altri comandi per correggerli. Tuttavia, se l'utente aggiunge modifiche personalizzate a questo modello, si consiglia di farne una copia prima di farlo. Qualsiasi modifica al modello ne ostacolerà la riutilizzabilità. Questo vale anche se si applica una configurazione di tag al modello.
Risoluzione dei problemi
I seguenti passaggi possono essere utilizzati per risolvere i problemi relativi al modello di catena:
Errori di esecuzione della catena
- Verifica che tutte le catene siano pubblicate.
- Assicurati che le credenziali OAuth2 (
wsv-Client IDewsv-Client Secret) siano valide e aggiornate. - Controlla i permessi dello spazio di lavoro dell'utente che esegue la catena.
Errori nell'importazione dei dati
- Conferma che le intestazioni delle colonne del tuo file sorgente corrispondano allo schema della tabella Wdata.
- Per le operazioni di sostituzione dei set di dati, assicurati che i nomi dei file corrispondano ai set di dati esistenti nella tabella.
- Per le operazioni di aggiunta di un nuovo set di dati, assicurati che i nomi dei file siano unici all'interno della tabella.
Creazione di tabelle o fogli di calcolo duplicati
- Usa nomi coerenti per
Wdata Table NameeSpreadsheetNametra le varie esecuzioni.
Schermata monitor
- Gli utenti possono diagnosticare la causa di un errore navigando nella schermata del monitor.
- La variabile DCV_Chain Result cattura lo stato della catena in base al risultato finale. Se si verifica un errore, il motivo del fallimento verrà applicato al testo di uscita della catena nella schermata di monitoraggio.
Gli utenti possono anche utilizzare la schermata di monitoraggio per determinare se il loro file è stato importato con successo.
Best practice
-
Evita di personalizzare il modello originale:
Crea una copia se sono necessarie delle modifiche. Le modifiche al modello possono ostacolare la riutilizzabilità. -
Tagging for Enhanced Context:
Aggiungi gli input di runtime (Tag-KeyeTag-Value) ai dataset di tag, se necessario. Aggiorna i nodi della catena per passare questi input. -
Gestione delle dimensioni dei file:
Monitora le dimensioni del dataset utilizzando la variabilewsv-WdataLoadWarningThreshold. Considera la possibilità di dividere i dataset di grandi dimensioni se vengono attivati degli avvisi.