Os scripts em seu site podem ser executados usando a ação Script Execution (Execução de script) no painel Automações (Automações). Isso permite que você execute scripts manualmente a partir de um documento, planilha ou apresentação.
A criação de scripts está incluída 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.
Requisitos
- O Roteiros da Workiva deve estar ativado em seu espaço de trabalho. Saiba mais sobre o Roteiros da Workiva.
- Os scripts só podem ser executados no mesmo espaço de trabalho em que estão hospedados. Saiba mais.
- Somente os proprietários de arquivos podem criar uma automação.
- A função Editor de roteiros é necessária para criar scripts.
Crie sua automação
Para criar uma automação a partir de um arquivo de sua propriedade:
- Em Home, abra um documento, uma apresentação ou uma planilha.
- Na barra lateral direita, clique no ícone de raio “ Automations”.
- Clique em + ou . Crie uma nova automação em para adicionar uma nova automação.
- No menu suspenso Acionador de automação, selecione Execução manual.
- (Opcional) Permita que outros usuários executem manualmente essa automação inserindo seus nomes e selecionando-os no campo “Quando executado” ( ) ao selecionar a opção “ ”.
- Em Detalhes da ação, selecione Executar script.
- Insira o ID , que se encontra no final da URL do script , no campo “ID do script” do .
- (Opcional) Selecione a planilha e a seção que contêm os dados de entrada do script.
- Clique em Create para concluir.
Execute e gerencie sua automação
Sua nova automação aparecerá como "Active" (Ativa) no painel Automações (Automações). Como proprietário do arquivo, você pode executar várias ações no menu suspenso:
- Executar: Executa manualmente o script da automação.
- Editar: Atualize os detalhes sobre a automação, como os critérios de acionamento.
- Desativsar/Ativar: Selecione se uma automação está disponível para execução.
- Exibir atividade: Abra o registro de atividades da automação.
- Excluir: Remover permanentemente a automação do arquivo.
Observação: Para evitar execuções duplicadas, a opção Executar é desativada por 20 segundos entre os cliques.
Informações que seu script recebe
Quando uma automação é executada, ela envia informações que o script lê como variáveis de ambiente:
- DOCUMENT_ID: A ID do documento em que a automação é executada.
- INPUT_SHEET_ID: O WURL da planilha usada para gerenciar os parâmetros de entrada da automação.
- INPUT_RESOURCE_ID: O WURL da seção na planilha mencionada anteriormente.
- INPUT_SPREADSHEET_ID: O ID da planilha mencionada anteriormente.
- INPUT_SPREADSHEET_SHEET_ID: O ID da seção na planilha mencionada anteriormente.
Um WURL é um URL proprietário e específico da Workiva que contém o ID e outras informações da planilha ou seção.
Para recuperar os IDs dos parâmetros, use este script:
# Bem-vindo ao 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("Parâmetros brutos:") print(os.environ) print("") print("IDs reais:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) Observação : Atualmente, a automação não envia nenhuma credencial da API pública do Workiva — como o ID do cliente ou o segredo — para o script. Talvez você precise codificar essas credenciais diretamente no script.
Perguntas frequentes
Posso executar um script hospedado em outro espaço de trabalho, organização ou região (APAC, CA, UE ou EUA)?
As automações do Workiva podem executar apenas scripts localizados no mesmo espaço de trabalho que o arquivo. Para executar um script em outro espaço de trabalho, organização ou região, use o conector de script do Workiva “ ” ou a API de script do Workiva “ ” .
Ao usar a API de Scripting, crie a autorização da API no espaço de trabalho que hospeda o script de destino. A concessão exige o script :execute ; caso a integração recupere o status da execução, os registros ou a saída, também é necessário o script :read . Para obter instruções sobre como criar ou atualizar uma autorização de API, consulte Configuração da API da Workiva .
Posso enviar entradas/parâmetros de tempo de execução na execução do script?
No momento, o recurso de automação não permite entradas em tempo de execução que são enviadas ao script quando ele é executado.
Quais metadados são enviados para a execução de um script a partir de uma automação?O ID do espaço de trabalho é enviado?
Quando um script é executado a partir de uma automação, os seguintes parâmetros são enviados:
- DOCUMENT_ID: A ID do documento em que a automação é executada.
- INPUT_SHEET_ID: O WURL da planilha usada para gerenciar os parâmetros de entrada da automação.
- INPUT_RESOURCE_ID : O WURL da seção na planilha “input”.
- INPUT_SPREADSHEET_ID : O ID da planilha de “entrada”.
- INPUT_SPREADSHEET_SHEET_ID : O ID da seção na planilha de “entrada”.
Para obter mais informações, consulte a página de suporte do Workiva Execute scripts com automações .
Como faço para acessar as credenciais dos sistemas Workiva e não Workiva a partir da execução do script?
Quando um script é executado a partir de uma automação, a única opção é codificar as credenciais no próprio código.
O mesmo script pode ser executado simultaneamente a partir de dois ou mais arquivos?
Sim, um script pode ser executado simultaneamente a partir do mesmo arquivo ou de vários arquivos.