Centro assistenza di Workiva

Workiva Scripting offre un ambiente flessibile e sicuro per l'esecuzione di codice Python sulla piattaforma Workiva. Questo articolo tratta alcuni degli scenari più comuni che puoi incontrare durante la creazione del tuo script.

Workiva Scripting è incluso 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 necessarie.

Per argomenti non trattati in questa sede, consulta la nostra guida " ", gli altri articoli sullo scripting di Workiva oppure visita le comunità (API di Workiva) e (scripting di Workiva) .

Problemi con gli amministratori e i permessi

L'azione Esegui script non appare nelle Automazioni

L'azione "Esegui script" è disponibile solo per gli utenti in possesso di un ruolo di scripting " " appropriato . Contatta l'amministratore del tuo Workspace per farti assegnare il ruolo richiesto. Se il ruolo è già stato assegnato e l'azione non è ancora disponibile, contatta l'assistenza di Workiva.

Connettore Workiva Scripting non disponibile nelle catene

Questo indica che il connettore Workiva Scripting non è stato abilitato per il tuo spazio di lavoro. Se ritieni che debba essere attivata e non lo è, contatta il team di assistenza del tuo account Workiva.

Nessun ruolo di scripting è visibile all'amministratore dell'area di lavoro

Questo indica che la funzione di scripting non è stata abilitata per il tuo spazio di lavoro. Se ritieni che debba essere attivata e non lo è, contatta il team di assistenza del tuo account Workiva.

Problemi con il connettore Workiva Scripting e i comandi (catene)

L'esecuzione del comando si avvia ma l'esecuzione dello script non avviene

Verifica che la funzione di scripting sia stata abilitata per il tuo spazio di lavoro. Se ritieni che debba essere attivata e non lo è, contatta il team di assistenza del tuo account Workiva.

Se hai confermato che lo scripting è abilitato, l'utente di integrazione per il connettore Workiva Scripting potrebbe non avere il ruolo necessario. Contatta il tuo amministratore di Workspace per assegnare un ruolo di Scripting appropriato. Devi anche verificare che l'utente dell'integrazione abbia i permessi per accedere allo script lanciato dal comando.

L'esecuzione del comando è ancora in corso ma l'esecuzione dello script si interrompe in modo imprevisto

Se il comando a catena continua a essere in esecuzione dopo l'arresto dello script, verificare quanto segue:

• Verifica se la corsa è stata annullata:  

  La cronologia delle esecuzioni è disponibile nel pannello “Proprietà” dell’Editor di script e tramite GET /scripts/{scriptId}/runs oppure GET /scripts/{scriptId}/runs/{runId} . Le richieste API richiedono lo script :read e devono includere X-Version: 2026-01-01 . 

  Per istruzioni su come creare o aggiornare un'autorizzazione API, consultare Configurazione dell'API di Workiva .

  

• Verifica se lo script ha superato un limite di risorse:

  L'utilizzo di memoria, CPU, disco e tempo di esecuzione viene riportato automaticamente nei log di esecuzione degli script e nei dati di esecuzione degli script restituiti dall'API.

  Per ulteriori informazioni, consultare Gestione dei limiti delle risorse in Workiva Scripting e Limiti di Workiva Scripting .

• Verifica se lo script ha raggiunto il tempo massimo di esecuzione:

  In tal caso, ridurre la quantità di lavoro svolto in un unico ciclo oppure suddividere il lavoro in operazioni più piccole. Vedi Limiti dello scripting di Workiva .

• Verifica la presenza di funzioni che interrompono esplicitamente il processo Python:

  Verificare che lo script non chiami:

  quit() exit() sys.exit() os._exit()

  quit() , exit() , e sys.exit() raise SystemExit . os._exit() interrompe immediatamente il processo senza eseguire i normali gestori di pulizia.

Per ulteriori informazioni sulle operazioni dell'API di scripting, consultare la guida all'API di scripting di all'indirizzo .

Esecuzione di comandi e script fuori sincrono

Questo accade quando il comando viene completato e l'esecuzione dello script continua, o viceversa.

Se il comando viene completato prima dell'esecuzione dello script, assicurati che il timeout del comando sia superiore al tempo di esecuzione dello script (consulta Limiti di scripting di Workiva per informazioni sul tempo massimo di esecuzione dello script).

Se l'esecuzione dello script viene completata solo pochi secondi prima del comando, potrebbe trattarsi di un ritardo dovuto all'elaborazione delle informazioni da parte del sistema di scripting dopo il completamento dell'esecuzione dello script. Il comando segnalerà il completamento solo quando l'intero processo sarà terminato.

Editor di scripting

L'importazione di una libreria non funziona

Workiva Scripting supporta la libreria standard di Python out-of-the-box, così come i componenti disponibili nel Python Package Index (per maggiori informazioni, vedi Librerie e dipendenze di Workiva Scripting supportate ). I componenti PyPI che richiedono installazioni aggiuntive potrebbero non essere supportati.

Assicurati che la libreria che stai cercando di importare faccia parte della libreria standard di Python o del Python Package Index. Se è un componente di quest'ultimo, assicurati che non siano necessarie altre installazioni.