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.
La funzionalità di scripting è inclusa in Customize Workiva. Per utilizzare lo scripting, nell'area di lavoro deve essere abilitata l'opzione "Personalizza Workiva/Scripting" e gli utenti dovranno disporre dei ruoli di scripting appropriati e delle autorizzazioni sui file.
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.
- Nella barra laterale destra, fai clic sull'icona a forma di fulmine delle automazioni di " ".
- Clicca su + oppure su Crea una nuova automazione per aggiungere una nuova automazione.
- Dal menu a tendina Trigger automazione, seleziona Esecuzione manuale.
- (Facoltativo) Consenti agli altri utenti di eseguire manualmente questa automazione inserendo i loro nomi e selezionandoli nel campo "Quando viene eseguita" ( ) della sezione " ".
- In Dettagli azione, seleziona Esegui script.
- Inserisci l'ID , che si trova alla fine dell'URL dello script , nel campo "ID script" di .
- (Facoltativo) Selezionare il foglio di calcolo e la sezione che contengono i dati di input dello script.
- 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:
# Benvenuti in 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("Parametri RAW:") print(os.environ) print("") print("ID effettivi:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Nota : Al momento, l’automazione non invia allo script alcuna credenziale dell’API pubblica di Workiva, come l’ID cliente o la chiave segreta. Potrebbe essere necessario codificare queste credenziali direttamente nello script.
Domande frequenti
Posso eseguire uno script ospitato in un altro spazio di lavoro, in un'altra organizzazione o in un'altra regione (APAC, CA, UE o Stati Uniti)?
Le automazioni di Workiva possono eseguire solo script che si trovano nello stesso spazio di lavoro del file. Per eseguire uno script in un altro spazio di lavoro, in un'altra organizzazione o in un'altra regione, utilizzare il connettore Workiva Scripting " " oppure l'API Workiva Scripting " " .
Quando si utilizza l'API di scripting, creare l'autorizzazione API nell'area di lavoro che ospita lo script di destinazione. La sovvenzione richiede script:execute ; se l'integrazione recupera lo stato di esecuzione, i log o l'output, richiede anche script:read . Per istruzioni su come creare o aggiornare un'autorizzazione API, consultare Configurazione dell'API di Workiva .
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 tramite un'automazione, vengono inviati i seguenti parametri:
- 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 nel foglio di calcolo "input".
- INPUT_SPREADSHEET_ID : l'ID del foglio di calcolo "input".
- INPUT_SPREADSHEET_SHEET_ID : l'ID della sezione nel foglio di calcolo "input".
Per ulteriori informazioni, consulta la pagina di assistenza di Workiva Eseguire script con le automazioni .
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.