Gli script del tuo sito possono essere eseguiti utilizzando l'azione Esecuzione script nel pannello Automazioni. Questo ti permette di eseguire manualmente gli script da un documento, un foglio di calcolo o una presentazione.
Nota: Al momento lo scripting è disponibile solo attraverso la funzione Customize Workiva. Per saperne di più.
Requisiti
- Workiva Scripting deve essere abilitato per il tuo workspace. Scopri di più su Workiva Scripting.
- Gli script possono essere eseguiti solo nello stesso workspace in cui sono ospitati. Ulteriori informazioni.
- Solo i proprietari dei file possono creare un'automazione.
- Il ruolo Editor script è necessario per creare gli script.
Crea la tua automazione
Per creare un'automazione da un file di tua proprietà:
- Da Home, apri un documento, una presentazione o un foglio di calcolo.
- All'estrema destra dello schermo, seleziona Automazioni dal pannello.
- Clicca su + o Crea per aggiungere una nuova automazione.
- Dal menu a tendina Trigger automazione, seleziona Esecuzione manuale.
- In Quando l'esecuzione è selezionata da, dai la possibilità ad altri utenti di eseguire manualmente questa automazione.
- In Dettagli azione, seleziona Esegui script.
- In Script ID, inserisci l'ID dalla fine dell'URL dello script.
- Seleziona il foglio di calcolo e la sezione che contengono gli input dello script. Questa opzione è facoltativa.
- Clicca su Crea per terminare.
Esegui e gestisci la tua automazione
La nuova automazione apparirà come "Attiva" nel pannello delle Automazioni. In qualità di proprietario del file, puoi eseguire diverse azioni dal menu a tendina:
- Esegui: Esegui manualmente lo script dell'automazione.
- Modifica: Aggiorna i dettagli dell'automazione, come i criteri di attivazione.
- Disattiva/Attiva: Seleziona se un'automazione è disponibile per essere eseguita.
- Visualizza attività: Apri il registro delle attività dell'automazione.
- Elimina: Rimuovi definitivamente l'automazione dal file.
Nota: Per evitare duplicazioni, l'opzione Esegui è disattivata per 20 secondi tra un clic e l'altro.
Informazioni che il tuo script riceve
Quando un'automazione viene eseguita, invia informazioni che lo script legge come variabili dell'ambiente:
- DOCUMENT_ID: L'ID del documento in cui viene eseguita l'automazione.
- INPUT_SHEET_ID: Il WURL del foglio di calcolo utilizzato per gestire i parametri di input dell'automazione.
- INPUT_RESOURCE_ID: Il WURL della sezione del foglio di calcolo sopra citato.
- INPUT_SPREADSHEET_ID: L'ID del foglio di calcolo sopra citato.
- INPUT_SPREADSHEET_SHEET_ID: L'ID della sezione del foglio di calcolo sopra citato.
Un WURL è un URL proprietario, specifico di Workiva, che contiene l'ID e altre informazioni del foglio o della sezione.
Per recuperare gli ID dai parametri, usa questo script:
# Welcome to Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("RAW parameters:") print(os.environ) print("") print("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Nota: Attualmente l'automazione non invia allo script le credenziali dell'API pubblica di Workiva, come l'ID o il segreto del client. Potrebbe essere necessario codificare queste credenziali direttamente nello script.
DOMANDE FREQUENTI
Posso eseguire uno script ospitato in un altro workspace, organizzazione o ambiente (APAC, EU, US)?
La funzione automazioni in Workiva può eseguire gli script solo nello stesso workspace in cui si trova il file. Tuttavia, il connettore Workiva Scripting o l'API Workiva Scripting possono essere utilizzati per eseguire uno script ospitato in un altro luogo.
Se usi l'API di scripting, devi creare e ospitare uno script nel workspace principale il cui unico scopo è chiamare l'API di scripting ed eseguire lo script nel workspace secondario.
Posso inviare input/parametri di runtime durante l'esecuzione dello script?
Al momento, la funzione di automazione non consente di inviare input di runtime allo script quando questo viene eseguito.
Quali metadati vengono inviati all'esecuzione di uno script da un'automazione?L'ID del workspace viene inviato?
Quando uno script viene eseguito da un'automazione, l'unico parametro inviato è l'ID del documento in cui è configurata l'automazione.
Come si accede alle credenziali dei sistemi Workiva e non Workiva dall'esecuzione dello script?
Quando uno script viene eseguito da un'automazione, l'unica possibilità è quella di codificare le credenziali nel codice stesso.
Lo stesso script può essere eseguito contemporaneamente da due o più file?
Sì, uno script può essere eseguito contemporaneamente dallo stesso file o da più file.