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.
Observação: No momento, a criação de scripts só está disponível por meio do Customize Workiva. Saiba mais.
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.
- No lado direito da tela, selecione Automações no painel.
- Clique em + ou Criar para adicionar uma nova automação.
- No menu suspenso Acionador de automação, selecione Execução manual.
- Em Quando a execução é selecionada por, opcionalmente, dê a outros usuários a capacidade de executar manualmente essa automação.
- Em Detalhes da ação, selecione Executar script.
- Em Script ID, digite o ID
- Selecione a planilha e a seção que contêm as entradas do script. Isso é opcional.
- 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 à Roteiros da Workiva 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) Observação: No momento, a automação não envia nenhuma credencial da API pública da Workiva, como o ID ou o segredo do cliente, 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 ambiente (APAC, UE, EUA)?
O recurso de automações na Workiva só pode executar scripts no mesmo espaço de trabalho em que o arquivo está localizado. Entretanto, o conector Roteiros da Workiva ou a API Roteiros da Workiva podem ser usados para executar um script hospedado em outro local.
Se estiver usando a API de script, você deverá criar e hospedar um script no espaço de trabalho principal cuja única finalidade seja chamar a API de script e executar o script no espaço de trabalho secundário.
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, o único parâmetro enviado é o ID do documento em que a automação está configurada.
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.