Centro de suporte da Workiva

Com o conector Workiva, você pode usar os comandos em cadeias para interagir com a plataforma Workiva, incluindo outros recursos do Wdata, Spreadsheets e GraphDB. Por exemplo, com esse conector, você pode:

• Criar e gerenciar tabelas, consultas e exibições
• Listar os conjuntos de dados de uma tabela ou erros de importação
• Criar e gerenciar planilhas ou suas folhas
• Gerenciar registros e relatórios

Requisitos

Para interagir com a plataforma Workiva, o conector usa as APIs REST da Workiva. Para configurar o conector, você precisará de:

• Um usuário dedicado à integração com o Workiva com uma autorização OAuth2.

  Observação: Esse usuário de integração precisa ter as permissões adequadas para os comandos executados pelo conector, como, por exemplo, ser o proprietário das planilhas ou do espaço de trabalho com os quais ele interage.

• O ID de concessão e o segredo OAuth2 do usuário da integração.
• Para executar a cadeia em um ambiente de teste, as URLs que substituem os hosts e os caminhos base da API.

Observação: Embora os proprietários do espaço 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. O uso de um usuário de integração dedicado - em vez da conta de usuário de um colaborador - permite que você acompanhe a atividade do conector e limite seu acesso apenas ao que é necessário para executar seus comandos.

Configure o conector Workiva

1. No Chain Builder do , clique em compare_arrows Connections na barra lateral esquerda e, em seguida, em compare_arrows Create no canto superior direito.
2. Em Criar conexão, selecione Workiva 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 “ ” (Recursos), selecione os recursos a serem associados a esta conexão.
   Esta seção oferece um local seguro para quaisquer arquivos (scripts, tokens de segurança, certificados etc.) de que o conector necessita para funcionar, seja para fins de autenticação ou para atender a requisitos de ambiente. Ao salvar a conexão, esses arquivos são automaticamente criptografados com AES-256. Para obter mais informações, consulte a página de suporte “ ” (Arquitetura de segurança do Workiva Chain Builder) em.

   Vantagens:

   • Armazenamento seguro: Como esses arquivos são criptografados ao serem salvos e armazenados no nível da conexão, eles são ideais para dados de configuração confidenciais ou estáticos que não devem ser codificados diretamente na própria blockchain.
   • Portabilidade: Se você mover sua cadeia de um espaço de trabalho “Teste” para um espaço de trabalho “Produção”, os recursos permanecerão vinculados às configurações de conexão, o que significa que você não precisará reescrever os caminhos dos arquivos nos nós da sua cadeia.
   • Acessibilidade: Armazenar os arquivos aqui torna-os disponíveis para o Runner (o agente que executa a tarefa), sem a necessidade de colocá-los manualmente na máquina física do runner.

   Desvantagens:

   • Como estão criptografados, não podem ser editados diretamente; é preciso excluir o arquivo e enviar a versão alterada.

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

   Propriedade	Detalhes
   ID	Insira o ID para a concessão do OAuth dos usuários de integração.
   Segredo	Digite o segredo para a propriedade ID.
   Substituição do host do Cerebral	Para substituir o host do URL e o caminho base para os pontos de extremidade Wdata, como em um ambiente de teste, digite o URL a ser usado.
   Substituição do host do Spreadsheets	Para substituir o host do URL e o caminho base para os pontos de extremidade do Spreadsheets, como em um ambiente de teste, digite o URL a ser usado.
   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.
   Substituição do host do administrador	Para substituir o host do URL e o caminho base para os pontos de extremidade do Admin, como em um ambiente de teste, digite o URL a ser usado.
   Substituição do host do GraphDB	Para substituir o host da URL e o caminho base dos pontos de extremidade do GraphDB, como em um ambiente de teste, digite a URL a ser usada.
   Substituição do host da API da plataforma	Para substituir o host do URL e o caminho base para os pontos de extremidade da plataforma Workiva, como em um ambiente de teste, digite o URL a ser usado.

   Observação: Todas as credenciais confidenciais são criptografadas automaticamente e armazenadas com criptografia AES-256.

6. Selecione os ambientes para usar a conexão e clique em Save.
7. Para testar a conexão, crie e execute uma cadeia com o comando Listar arquivos do conector e verifique se ele retorna uma saída válida.

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.

Solução de problemas

Se a conexão com a plataforma Workiva falhar:

• Verifique se as credenciais OAuth do aplicativo do conector estão presentes, corretas e válidas. As credenciais do OAuth têm datas de validade definidas, e o certificado pode ter expirado. Se esse for o caso, você precisará criar um novo certificado e inserir o novo segredo do cliente no Conector. 
• Certifique-se de que o usuário de integração tenha as permissões adequadas para o comando que está sendo executado.
• Se estiver usando uma substituição de host, verifique se a URL inserida para o conector está correta.

• Verifique se o ID do arquivo do Workiva —como a tabela, a consulta ou a planilha— com o qual está interagindo está correto.

  Observação: O ID de um arquivo aparece em seu URL quando você o abre na Workiva. Por exemplo, o ID de uma planilha aparece depois de spreadsheet/ em seu URL; o ID de uma tabela aparece depois de tables/.