Con una soluzione collegata a Workiva, ci sono diversi modi per aggiornare i dati in un foglio elettronico Workiva. Quando si usa Wdata, è possibile creare una connessione in entrata per aggiornare i dati in un foglio di calcolo da una query Wdata. In questo articolo analizziamo l'uso delle catene per aggiornare i dati in un foglio di calcolo utilizzando i comandi Write Sheet Data e Overwrite Sheet Data.
Ingressi comuni dei comandi
I comandi Scrivi dati del foglio e Sovrascrivi dati del foglio hanno diversi input che sono gli stessi per entrambi i comandi.
| Input | Scopo |
| ID del foglio di calcolo | L'ID del foglio elettronico di Workiva in cui verranno scritti i dati. |
| ID/Nome del foglio |
Il nome o ID del foglio all'interno del foglio di calcolo in cui vengono scritti i dati. I nomi sono CASE-SENSITIVE. |
| File dati |
Il file contenente i dati delimitati che devono essere scritti nel foglio. CSV è il formato di file più comune ma sono supportati anche altri delimitatori. I dati JSON devono essere convertiti in un formato delimitato per poter utilizzare questo comando. |
| Delimitatore |
Il delimitatore del file. La virgola (,) è il più comune ma è supportato qualsiasi delimitatore, compresi il punto e virgola (;), la pipe (|) o la tabulazione (\t). Assicurati che i campi i cui dati contengono il delimitatore specificato siano racchiusi tra virgolette doppie. Ad esempio, in un file delimitato da virgole: Workiva, "Ames, IA, USA",WK |
| Regione (Scrivi dati foglio) / Cella iniziale (Sovrascrivi dati foglio) |
L'indirizzo della cella iniziale in cui verranno scritti i dati. Ulteriori informazioni sui valori validi si trovano nella sezione specifica di ciascun comando. |
| Usa Async |
Quando è selezionata, il comando eseguirà un aggiornamento asincrono del foglio. Ciò significa che la Catena procederà all'operazione successiva mentre l'operazione di aggiornamento del foglio è ancora in corso all'interno della piattaforma. Questa opzione è consigliata per gli insiemi di dati di grandi dimensioni, ma solo se le operazioni successive della catena non dipendono dall'aggiornamento del foglio. |
| Usa l'API della piattaforma |
Quando è selezionata, il comando utilizza l'API della piattaforma per eseguire l'aggiornamento anziché l'API del foglio di calcolo tradizionale. L'API della piattaforma è consigliata in quanto è la più recente delle API e continua a essere migliorata con ulteriori funzioni. |
Scrivi dati del foglio
Il comando Scrivi dati foglio è il più indicato quando è necessario aggiornare regioni specifiche di un foglio preservando i dati di altre regioni del foglio. La seguente tabella illustra il comportamento di cancellazione per ogni formato di regione specificato.
| Formato | Esempio | Effetto |
| Indirizzo di una singola cella | B2 |
Aggiorna una singola cella all'interno del foglio, senza influenzare i valori delle altre celle. Questo formato è non consigliato a meno che non si scriva il valore di una singola cella. Se il file di dati contiene più di un singolo punto di dati, il comando fallirà quando si utilizza questo formato. |
| Indirizzo della cella iniziale, nessuna cella o colonna finale | B2: |
Aggiorna il foglio a partire dall'indirizzo della cella iniziale. I valori del foglio a sinistra (colonna) e sopra (riga) l'indirizzo della cella iniziale vengono conservati; tutti gli altri valori vengono cancellati anche se il file di dati non contiene valori di celle nella riga o nella colonna. |
| Indirizzo della cella iniziale, colonna finale senza riga finale | B2:D |
Aggiorna il foglio a partire dall'indirizzo della cella iniziale. I valori del foglio a sinistra (colonna) e sopra (riga) l'indirizzo della cella iniziale vengono conservati; tutti gli altri valori vengono cancellati anche se il file di dati non contiene valori di celle nella riga o nella colonna. |
| Indirizzo della cella iniziale, indirizzo della cella finale | B2:D5 |
Sostituisce tutte le celle all'interno dell'intervallo specificato. Nota: se l'intervallo specificato nel comando è più piccolo (meno righe o colonne) del file di dati caricato, il comando fallisce. |
Sovrascrivi dati foglio
Il comando Sovrascrivi dati foglio è il più indicato quando è necessario cancellare un intero blocco all'interno di un foglio. La seguente tabella illustra il comportamento di cancellazione per ogni formato di cella iniziale specificato.
| Formato | Esempio | Effetto |
| Indirizzo di una singola cella | B2 |
I valori del foglio a sinistra (colonna) e sopra (riga) l'indirizzo della cella iniziale vengono conservati; tutti gli altri valori del foglio vengono cancellati e i dati del file di dati vengono scritti a partire dall'indirizzo di cella specificato. |
| Indirizzo della cella iniziale, nessuna cella o colonna finale | B2: |
I valori del foglio a sinistra (colonna) e sopra (riga) l'indirizzo della cella iniziale vengono conservati; tutti gli altri valori del foglio vengono cancellati e i dati del file di dati vengono scritti a partire dall'indirizzo di cella specificato. |
| Indirizzo della cella iniziale, colonna finale senza riga finale | B2:D |
Questo formato è supportato da non da e comporta un errore nell'esecuzione del comando. |
| Indirizzo della cella iniziale, indirizzo della cella finale | B2:D5 |
I valori del foglio a sinistra (colonna) e sopra (riga) l'indirizzo della cella iniziale vengono conservati; tutti gli altri valori del foglio vengono cancellati e i dati del file di dati vengono scritti a partire dall'indirizzo di cella specificato. La larghezza (colonne) e l'altezza (righe) del file di dati sono irrilevanti. |
Prova
Sono stati creati un modello di catena e un foglio di calcolo di prova che ti permettono di vedere i risultati di ciascuno dei formati Cella iniziale/Regione sopra elencati. Per testare:
- Scarica il foglio di calcolo di prova da questo link (25 KB) e importalo nel tuo spazio di lavoro.
- Crea una catena di test utilizzando le catene d'uso per aggiornare un foglio di calcolo Workiva Modello che si trova all'interno della cartella 4. Guida rapida -> Esempi di abilitazione e utilizzo cartella Template.
- Si consiglia di mappare la variabile template Spreadsheet ID come variabile di catena .
- Aggiorna l'ID del foglio di calcolo Variabile di catena prima di eseguire la catena nell'area di lavoro.
- Assicurati che l'utente della connessione Workiva Chains abbia il file :write scope e che l'utente sia stato assegnato al foglio di calcolo importato.
- Esegui la Catena ed esamina i risultati. I risultati attesi sono indicati nel foglio Risultati attesi del foglio di calcolo importato.