Centro de suporte da Workiva

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:

1. No site , na seção “Chain Builder” (Criador de cadeias), clique em compare_arrows “Connections” (Conexões) na barra lateral esquerda e, em seguida, em “Create” (Criar) compare_arrows no canto superior direito.
2. Em “ ” (Conector de integração) “Connection” (Conexão), selecione “ ” (Cadeias de trabalho) e o CloudRunner padrão.
3. Em Basic Info, digite um nome e uma descrição exclusivos para ajudar a identificar o conector.

4. Em Propriedades, digite os detalhes da conexão:

   Propriedade	Detalhes
   URL de base	A URL base; o valor 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.

5. 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 a URL contiver .apac, .ca ou .eu, será necessária uma substituição.

Observação: As informações da região dos EUA estão listadas para referência.