O conector Workiva Scripting fornece uma maneira simples de executar scripts Python dentro da plataforma Workiva. Funciona independentemente da experiência completa de criação de scripts, permitindo que usuários não técnicos executem scripts sem se aprofundar no código-fonte subjacente.
Para obter uma lista completa de comandos compatíveis, consulte o artigo Workiva Scripting commands.
No momento, o recurso de criação de scripts está disponível apenas como parte de um programa Early Adopter. Se você estiver interessado em adicionar scripts ao seu espaço de trabalho, entre em contato com o Gerente de Sucesso do Cliente para discutir a participação no programa.
Saiba mais sobre os requisitos de scripts em.
Requisitos
Antes de usar o conector da Workiva:
- O administrador de segurança da organização deve ativar o conector Workiva Scripting por meio da tela Configurations (Configurações).
- Para executar a cadeia em um ambiente de teste, você precisará dos URLs para substituir os hosts e os caminhos de base da API.
Por que você deve usar o conector Workiva Scripting em HTTP Request?
O conector HTTP Request requer lógica adicional para atualizar os tokens do portador e pesquisar o status do script. Esses requisitos são eliminados com o uso do conector Workiva Scripting.
Além disso, o conector Workiva Scripting oferece funcionalidades adicionais, como a capacidade de usar saídas de comando (como stdout e logs) em outras partes de uma cadeia.
Configuração da conexão
Para configurar o conector do Workiva Scripting:
- Acesse Chain Builder.
- Clique em Connections na área de navegação à esquerda e, em seguida, em Create no canto superior direito da página.
- Em “ ” (Conector de conexão), selecione “ ” (Scripting do Workiva) e o CloudRunner padrão.
- Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
-
Em “ ” (Propriedades), insira os detalhes da conexão:
Propriedade Detalhes ID do cliente Insira o ID para a concessão do OAuth do usuário de integração.
Ele é gerado aleatoriamente.Segredo do cliente Digite o segredo da propriedade ID.
Ele é gerado aleatoriamente.API do servidor de scripts (Opcional) Digite o URL que substituirá o host de URL padrão e o caminho de base da API do servidor de scripts. Substituição do host do IAM (Opcional) Digite o URL que substituirá o host e o caminho base padrão do URL para os pontos de extremidade do Identify and Access Management (IAM). Versões da API de script Selecione a versão da API a ser usada.
A versão V1 é a padrão e é recomendada para a maioria dos usuários.
A V0 será removida em um futuro próximo. - Selecione os ambientes para usar a conexão e clique em Save.
Substituições de URL
Dependendo da região do seu ambiente de produção, pode ser aplicado um URL de substituição. Você pode verificar isso comparando com o URL usado para fazer login no Wdesk. Se o URL contiver EU ou APAC, você precisará substituí-lo.
Observação: As informações sobre a região dos EUA do site são apresentadas a título de referência. Se você estiver nessa região, não precisa aplicar nenhuma substituição.
| Campo | Valor |
|---|---|
| Substituição de host cerebral | https://h.app.wdesk.com/s/cerebral |
| Substituição do host de planilhas | https://api.app.wdesk.com/spreadsheets/v1/ |
| Substituição de host do IAM | https://api.app.wdesk.com/iam/v1/oauth2/token |
| Substituição do host do administrador | https://api.app.wdesk.com/admin/v1 |
| Substituição do host do Graph DB | https://api.app.wdesk.com/graphdb/v1/ |
| Substituição do host da API da plataforma | https://api.app.wdesk.com/platform/v1 |
| Substituição da API do Scripting Server | https://h.app.wdesk.com/s/scripting |
| Campo | Valor |
|---|---|
| Substituição de host cerebral | https://h.apac.wdesk.com/s/cerebral |
| Substituição do host de planilhas | https://api.apac.wdesk.com/spreadsheets/v1/ |
| Substituição de host do IAM | https://api.apac.wdesk.com/iam/v1/oauth2/token |
| Substituição do host do administrador | https://api.apac.wdesk.com/admin/v1 |
| Substituição do host do Graph DB | https://api.apac.wdesk.com/graphdb/v1 |
| Substituição do host da API da plataforma | https://api.apac.wdesk.com/platform/v1 |
| Substituição da API do Scripting Server | https://h.apac.wdesk.com/s/scripting |
| Campo | Valor |
|---|---|
| Substituição de host cerebral | https://h.ca.wdesk.com/s/cerebral |
| Substituição do host de planilhas | https://api.ca.wdesk.com/spreadsheets/v1/ |
| Substituição de host do IAM | https://api.ca.wdesk.com/iam/v1/oauth2/token |
| Substituição do host do administrador | https://api.ca.wdesk.com/admin/v1 |
| Substituição do host do Graph DB | https://api.ca.wdesk.com/graphdb/v1/ |
| Substituição do host da API da plataforma | https://api.ca.wdesk.com/platform/v1 |
| Substituição da API do Scripting Server | https://h.ca.wdesk.com/s/scripting |
| Campo | Valor |
|---|---|
| Substituição de host cerebral | https://h.eu.wdesk.com/s/cerebral |
| Substituição do host de planilhas | https://api.eu.wdesk.com/spreadsheets/v1/ |
| Substituição de host do IAM | https://api.eu.wdesk.com/iam/v1/oauth2/token |
| Substituição do host do administrador | https://api.eu.wdesk.com/admin/v1 |
| Substituição do host do Graph DB | https://api.eu.wdesk.com/graphdb/v1/ |
| Substituição do host da API da plataforma | https://api.eu.wdesk.com/platform/v1 |
| Substituição da API do Scripting Server | https://h.eu.wdesk.com/s/scripting |