O conector Workiva Chains fornece comandos comuns para espaços de trabalho, ambientes e cadeias. Isso inclui os comandos list and get usados para recuperar propriedades, detalhes de execuções de cadeias, eventos de atividade de login e muito mais.
Para obter uma lista completa de comandos compatíveis, consulte o artigo Workiva Chains commands.
Requisitos
Antes de usar o conector:
- O administrador de segurança da organização deve habilitar o conector Workiva Chains 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.
- Você deve criar um usuário de integração dedicado com e uma concessão OAuth2 em seu software.
- Para encontrar os IDs de sua cadeia, consulte este artigo em para encontrar IDs na Workiva.
Requisitos adicionais para o usuário de integração
Embora todos os proprietários de espaços de trabalho possam acessar cadeias que usam o conector, o próprio conector requer um usuário de integração dedicado para executar seus comandos. Usar um usuário de integração dedicado - em vez da conta de usuário de um colaborador - permite que você rastreie a atividade do conector e limite seu acesso apenas ao que ele precisa para executar seus comandos.
Você deve saber o ID de concessão e o segredo do OAuth2 do usuário de integração:
- Você deve conhecer a ID de concessão e o segredo do OAuth2 do usuário de integração.
- Você deve fornecer ao usuário de integração as permissões apropriadas para cada comando que o conector executará; por exemplo, ele pode ser o Proprietário da planilha ou do espaço de trabalho com o qual o conector interage.
- O usuário da integração deve fazer login no Chain Builder antes de executar qualquer comando. Isso é necessário para estabelecer a conta do usuário.
Configuração da conexão
Para configurar o conector Workiva Chains:
- Em Construtor de cadeia, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Conector Conexão, selecione Workiva Chains e o CloudRunner padrão.
- Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.
- Em Propriedades, digite os detalhes da conexão:
Propriedade Detalhes URL de base O URL de base; o padrão é https://h.app.wdesk.com/s/wdata/oc/api/ ID Insira o ID para a concessão do OAuth dos usuários de integração. Segredo Insira o segredo para a propriedade ID. Substituição do host do IAM Para substituir o host do URL e o caminho base para os pontos de extremidade do Identify and Access Management (IAM), como em um ambiente de teste, digite o URL a ser usado. - 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 da região dos EUA estão listadas para referência.
| 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 |
| Campo | Valor |
|---|---|
| Substituição do 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 |
| 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 |