Para dar aos usuários finais a capacidade de ver os dados mais atualizados disponíveis na Plataforma Workiva, é essencial atualizar as Conexões. Neste Caminho de Aprendizado Conectado, aprenderemos como criar uma Cadeia que atualiza uma Conexão entre a Plataforma Workiva e o Wdata usando o ID da Conexão. Nos caminhos subsequentes, aprenderemos como obter automaticamente o ID da conexão e atualizar a conexão usando cadeias.
| Caso de uso primário de negócios | Conectividade de dados entre Workiva e Wdata |
| Objetivo principal de aprendizado | Saiba como atualizar uma conexão usando cadeias |
| Pré-requisitos |
Configurar o Workiva Connector Complete o CLP | Upload de dados para um caminho de tabela Complete CLP | Create a Query with a Calculated Field (Criar uma consulta com um campo calculado) Fornecer permissões à planilha para o usuário associado do Workiva OAuth Grant |
| Modelo de suporte | CLP | Atualizar conexão usando ID |
Nota: Você precisa do CLP Employee Detail Query para essa conexão. Siga as instruções em CLP | Create a Query with a Calculated Field (Criar uma consulta com um campo calculado) para criar a consulta. Se todos os caminhos de gerenciamento de consultas tiverem sido concluídos, navegue até os parâmetros da consulta CLP Employee Details e siga estas etapas para excluir o parâmetro Country.
Etapa 1: criar uma conexão de entrada
Para saber como atualizar uma conexão usando uma cadeia, primeiro precisamos estabelecer uma conexão entre uma consulta Wdata e uma planilha.
- Navegue até a Workiva Platform para criar uma nova Spreadsheet
- Clique em Create e selecione Spreadsheet
- Dê um nome à planilha: CLP Employee Overview (Visão geral dos funcionários do CLP)
- Nomeie a primeira planilha: CLP Employee Details
- Adicione uma conexão de entrada à planilha CLP Employee Details:
- Abra o painel Connections à direita, clicando no ícone Connections
- Na guia Incoming Connections (Conexões de entrada), selecione Add Connection (Adicionar conexão)
- Selecionar consulta Wdata
- Selecione CLP Employee Detail Query
- Clicar em “Conectar”
- Abra o painel Connections à direita, clicando no ícone Connections
Etapa 2: Criar uma corrente
- Navegue até o Criador de cadeias
- Adicionar uma nova corrente
- Nomeie a cadeia: CLP | Atualizar conexão usando ID
- Salvar a corrente
Etapa 3: Entradas de tempo de execução
Usamos o evento de cadeia de entradas de tempo de execução para iniciar a cadeia. Isso nos permite especificar qual conexão queremos atualizar no tempo de execução da cadeia.
- Adicione um evento em cadeia de entradas de tempo de execução a partir dos eventos de disparo de cadeia do nó inicial
- Edite o evento de cadeia de entradas de tempo de execução clicando duas vezes no comando
- Type: TextField
- Nome de exibição: ID da conexão
- Obrigatório: Não verificado
- Salvar o comando
Etapa 4: Atualizar a conexão
Usaremos o comando Refresh Connection para atualizar nossa conexão usando o ID da conexão
- Adicione um comando Refresh Connection do Workiva Connector à tela Chain
- Conecte o comando Runtime Inputs ao comando Refresh Connection
- Clique duas vezes no comando para configurá-lo
- Nomeie o comando: Refresh Connection (Atualizar conexão)
- Use a variável Connection ID de Runtime Inputs - isso nos permite enviar o valor especificado no tempo de execução da cadeia para o comando Refresh Connections (Atualizar conexões)
- Clique no campo ID da conexão
- No painel esquerdo, expanda o menu suspenso Trigger
- Expanda o menu suspenso Runtime Inputs
- Selecione a variável Connection ID
- Deixe as opções de Parâmetro como estão, pois abordaremos os campos de Parâmetro em um caminho futuro
Etapa 5: Teste o exercício
Agora que a cadeia está concluída, teste o resultado.
- Publicar a cadeia
- Clique em Execute e, em seguida, selecione Run With Inputs
- Encontre o ID de conexão
- Navegue até a planilha CLP Employee Overview Spreadsheet
- No painel Connections, localize a conexão CLP Employee Detail Query Connection e clique na seta para cima. Quando o menu suspenso for exibido, selecione View Properties
- Copie o ID da conexão - certifique-se de que você não perdeu nenhum caractere nem adicionou nenhum espaço
- Navegue de volta ao Construtor de cadeias e cole o ID da conexão na entrada de tempo de execução do ID da conexão
- Clique em Iniciar.
- Após a conclusão da cadeia, volte para a tabela ou planilha e veja que a conexão foi atualizada com êxito!
Execução bem-sucedida da cadeia:
Atualização de conexão bem-sucedida:
Saiba mais sobre como atualizar conexões usando cadeias ao concluir o próximo caminho: Atualizar conexões com um parâmetro!