Centro de suporte da Workiva

Etapa 1: Copiar consulta existente

Primeiro, precisamos de uma consulta com um parâmetro. Criaremos uma cópia de nossa consulta existente e adicionaremos um parâmetro que nos permitirá decidir para qual país queremos ver a contagem total de funcionários.

• Na página inicial do Wdata, localize a consulta CLP Employee Detail Query e abra o menu
  • Selecione “Copiar”.

• Atualize o nome da consulta para CLP Employee Detail by Country Query (Consulta de detalhes de funcionários do CLP por país)

• Clique em Save Query (Salvar consulta)
• Na tela de edição da consulta, clique no ícone Parameters no painel da extrema direita

• Clique em Add Parameters e selecione Create New Parameter (Criar novo parâmetro)
  • Nomeie o parâmetro: Country (País)
  • Alterar a lista de opções para ativado
  • Na caixa List Options (Opções de lista), liste os seguintes países, cada país em sua própria linha:
    • Austrália
    • Brasil
    • Itália
    • Quênia
    • Estados Unidos
  • Atualize o padrão para None
  • Clique em Criar
• Para que o parâmetro controle os resultados da nossa consulta, precisamos conectar o parâmetro à coluna nos dados de origem usando filtros. Navegue até a guia Filtros na consulta. 
  • Localize a coluna Country dos dados de origem à esquerda, clique e arraste-a para a área de filtros no lado esquerdo
  • Clique no valor do filtro, onde está escrito Empty String (Cadeia de caracteres vazia), para preencher o valor do filtro.
    • À direita do campo de valor do filtro, clique no botão de parâmetros
    • Selecione o país
    • Clique em Aplicar

• • Agora você tem uma consulta com um parâmetro para Country. Ao clicar em Run Query (Executar consulta), você será questionado sobre qual país deseja que os resultados da consulta sejam exibidos.

• Clique em Salvar

Etapa 2: Criar uma conexão de entrada

Para que você saiba como atualizar uma conexão usando uma cadeia, primeiro precisamos estabelecer uma conexão entre uma consulta Wdata e uma planilha. 

• Navegue até a planilha CLP Employee Overview
• Adicione uma nova planilha clicando em
  • Renomeie-a para CLP Employee Details by Country
• Adicione uma conexão de entrada à planilha CLP Employee Details by Country:
  • 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 a consulta CLP Employee Detail by Country Query
    • Defina o parâmetro de país como Australia
    • Clicar em “Conectar”

• Agora há duas planilhas com conexões de entrada na planilha CLP Employee Overview Spreadsheet

Etapa 3: Editar a cadeia existente

• Navegue até o Criador de cadeias e localize a cadeia CLP | Atualizar conexão usando o ID
• Clique no botão de lápis para editar a cadeia
• Clique em Chain Settings no canto superior direito 
  • Renomeie a cadeia: CLP | Refresh Connections with a Parameter (Atualizar conexões com um parâmetro)
• Salvar a corrente

Etapa 4: Entradas de tempo de execução

Usamos o comando Runtime Inputs para iniciar a cadeia. Isso nos permite especificar qual conexão queremos atualizar no tempo de execução da cadeia, bem como o parâmetro para o qual queremos atualizar o valor.

• Edite o evento de cadeia de entradas de tempo de execução clicando duas vezes no comando
• Clique duas vezes no botão Add Input e adicione as seguintes entradas:
  • Input 1:
    • Type: TextField
    • Nome de exibição: Parameter Name (Nome do parâmetro)
    • Obrigatório: Não verificado
  • Entrada 2:
    • Tipo: TextField
    • Nome de exibição: Valor do parâmetro
    • Obrigatório: Desmarcada
• Salvar o comando

Etapa 5: Atualizar conexão

Para levar em conta o parâmetro adicionado, precisamos atualizar o comando Refresh Connections para levar em conta o parâmetro e o valor que devem ser enviados para a consulta.

• Edite a conexão Refresh Connection clicando duas vezes no comando Command
  • ID da conexão: Continue a usar a variável Connection ID das entradas de tempo de execução
  • Adicionar um parâmetro
    • Como nossos parâmetros são salvos na origem (na consulta), você deve preencher os parâmetros na origem. Clique no botão + ao lado de Source Parameters (Parâmetros de origem)
    • Parameter Name (Nome do parâmetro): Use a variável Parameter Name das entradas de tempo de execução - isso nos permite enviar o valor do Parameter Name especificado no tempo de execução da cadeia para o comando Atualizar conexões
      • Clique no campo Parameter Name
      • No painel esquerdo, expanda o menu suspenso Trigger
      • Expanda o menu suspenso Runtime Inputs
      • Selecione a variável Parameter Name
    • Valor do parâmetro: Use a variável Parameter Value das entradas de tempo de execução - isso nos permite enviar o valor do parâmetro especificado no tempo de execução da cadeia para o comando Atualizar conexões
      • Clique no campo Parameter Name (Nome do parâmetro )
      • No painel esquerdo, expanda o menu suspenso Trigger
      • Expanda o menu suspenso Runtime Inputs
      • Selecione a variável Parameter Value
• Salvar o comando

Etapa 6: 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 by Country 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 Chain Builder e cole o ID da conexão na entrada de tempo de execução do ID da conexão
• Preencher as entradas do parâmetro
  • Parameter Name: o nome do parâmetro na consulta - neste exercício, o nome do parâmetro é Country
  • Valor do parâmetro: o valor pelo qual a consulta precisa ser filtrada - neste exercício, filtraremos para Brazil
    • Observação: se você selecionar um valor de parâmetro diferente do que já está armazenado na planilha, a planilha será substituída e os dados mudarão da Austrália para o Brasil.
• Clique em Iniciar.
• Após a conclusão da cadeia, volte para a planilha e veja que a conexão foi atualizada com sucesso!

Execução bem-sucedida da cadeia:

Atualização bem-sucedida da conexão:

Para saber mais sobre como atualizar conexões usando cadeias, siga o próximo caminho: Atualizar lista de conexões!