Centro de suporte da Workiva

O Workiva Scripting oferece um ambiente flexível e seguro para a execução de código Python na plataforma Workiva. Este artigo aborda alguns dos cenários mais comuns que você pode encontrar ao criar seu script.

O Workiva Scripting está incluído no Customize Workiva. Para usar o Scripting, seu espaço de trabalho deve ter a opção “Personalizar Workiva/Scripting” ativada, e os usuários precisarão das funções de Scripting adequadas e das permissões de arquivo necessárias.

Para questões não abordadas aqui, consulte nosso guia “ ”, outros artigos sobre scripts do Workiva em ou visite as comunidades (APIs do Workiva) e (scripts do Workiva) .

Problemas de administração e permissão

A ação Executar script não aparece em Automações

A ação “Executar script” está disponível apenas para usuários com a função de script apropriada do . Entre em contato com o administrador do seu Workspace para atribuir a função necessária. Se a função já estiver atribuída e a ação ainda não estiver disponível, entre em contato com o Suporte da Workiva.

O conector Workiva Scripting não está disponível em Chains

Isso indica que o conector Workiva Scripting não foi ativado para seu espaço de trabalho. Se você acredita que esse recurso deveria estar ativado e não está, entre em contato com a equipe de atendimento da sua conta na Workiva.

Nenhuma função de script está visível para o administrador do espaço de trabalho

Isso indica que o recurso de script não foi ativado para o seu espaço de trabalho. Se você acredita que esse recurso deveria estar ativado e não está, entre em contato com a equipe de atendimento da sua conta na Workiva.

Problemas com o conector e o comando do Workiva Scripting (cadeias)

A execução do comando é iniciada, mas a execução do script não

Verifique se o recurso de script foi ativado em seu espaço de trabalho. Se você acredita que esse recurso deveria estar ativado e não está, entre em contato com a equipe de atendimento da sua conta na Workiva.

Se você confirmou que o script está ativado, o usuário de integração do conector Workiva Scripting pode não ter a função necessária atribuída. Entre em contato com o administrador do espaço de trabalho para atribuir uma função de scripting apropriada. Você também deve verificar se o usuário de integração tem permissão para acessar o script disparado pelo comando.

A execução do comando ainda está em andamento, mas a execução do script é interrompida inesperadamente

Se a sequência de comandos continuar em execução após o script ser interrompido, verifique o seguinte:

• Verifique se a corrida foi cancelada:  

  O histórico de execuções está disponível no painel “Propriedades” do Editor de Scripts e por meio de GET /scripts/{scriptId}/runs ou GET /scripts/{scriptId}/runs/{runId} . As solicitações de API exigem o escopo script:read e devem incluir X-Version: 2026-01-01 . 

  Para obter instruções sobre como criar ou atualizar uma autorização de API, consulte Configuração da API da Workiva .

  

• Verifique se o script ultrapassou algum limite de recursos:

  O uso de memória, CPU, disco e tempo de execução é relatado automaticamente nos registros de execução dos scripts e nos dados de execução dos scripts retornados pela API.

  Para obter mais informações, consulte , “Como lidar com limites de recursos no Workiva Scripting” e , “Limites do Workiva Scripting” .

• Verifique se o script atingiu seu tempo máximo de execução:

  Se for o caso, reduza a quantidade de trabalho realizado em uma única execução ou divida o trabalho em operações menores. Consulte e as restrições de scripts do Workiva em .

• Verifique se há funções que interrompam explicitamente o processo do Python:

  Verifique se o script não chama:

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

  quit() , exit() , e sys.exit() raise SystemExit . os._exit() interrompe o processo imediatamente, sem executar os manipuladores de limpeza normais.

Para obter mais informações sobre as operações da API de script, consulte o guia da API de script do em .

Execução de comando e script fora de sincronia

Isso ocorre quando o comando é concluído e a execução do script continua, ou vice-versa.

Se o comando for concluído antes da execução do script, certifique-se de que o tempo limite do comando “ ” seja maior do que o tempo de execução do script (consulte Limites de scripts do Workiva para saber mais sobre o tempo máximo de execução do script).

Se a execução do script for concluída apenas alguns segundos antes do comando, isso pode ser um atraso esperado causado pelo sistema de script que processa as informações após a conclusão da execução do script. O comando só informará a conclusão quando todo o processo estiver concluído.

Editor de scripts

Importar uma biblioteca não funciona

O Workiva Scripting é compatível com a biblioteca padrão do Python out-of-the-box, bem como com os componentes disponíveis no Python Package Index (consulte Supported Workiva Scripting libraries and dependencies para obter mais informações). Os componentes do PyPI que exigem instalações adicionais podem não ser suportados.

Certifique-se de que a biblioteca que você está tentando importar faz parte da biblioteca padrão do Python ou do Python Package Index. Se ela for um componente do último, certifique-se de que nenhuma instalação adicional seja necessária.