Os parâmetros nas consultas Wdata são o que torna as consultas dinâmicas e utilizáveis em todos os períodos do relatório. Neste Caminho de Aprendizado Conectado, modificaremos nossa Consulta adicionando um Parâmetro, tornando-a dinâmica e, em seguida, editaremos nossa Cadeia para levar em conta o Parâmetro. Em seguida, exportaremos os resultados da consulta para uma planilha Workiva.
| Caso de uso primário de negócios | Relatórios sobre dados armazenados em Wdata |
| Objetivo principal de aprendizado | Execução de uma consulta com um parâmetro de uma cadeia |
| Objetivos de aprendizado secundários | Criação de um parâmetro em uma consulta |
| Pré-requisitos |
Configurar o Workiva Connector Complete o CLP | Create a Query with a Calculated Field (Criar uma consulta com um campo calculado) Preencha o formulário CLP | Run a Query and Export Results (Executar uma consulta e exportar resultados) Identificar o ID da consulta de detalhes do funcionário do CLPOpcional - Identifique o URL de uma planilha existente na qual você poderá gravar os resultados |
| Modelo de suporte | CLP | Executar uma consulta com um parâmetro |
Etapa 1: Editar a consulta existente
Primeiro, precisamos editar nossa consulta CLP Employee Detail Query para adicionar um parâmetro. Criaremos um parâmetro que nos permitirá decidir para qual país queremos ver a contagem total de funcionários.
- No Wdata, abra a consulta CLP Employee Detail Query para editá-la.
- Siga as instruções CLP | Create a Query with a Calculated Field para criar a consulta.
- No painel da extrema direita, clique no ícone Parâmetros
- 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 Create.
- 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: Editar a cadeia existente
- Navegue até o Construtor de cadeias e localize a cadeia CLP | Executar uma consulta e exportar resultados
- Clique no botão de lápis para editar a cadeia
- Clique em Configurações de cadeia no canto superior direito
- Renomeie a cadeia: CLP | Run a Query and with a Parameter (Executar uma consulta e com um parâmetro)
- 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 solicitar o ID da consulta a ser executada, o valor de seu parâmetro e o URL de uma planilha existente para gravar os resultados. O campo URL da planilha é opcional; se for deixado em branco, uma nova planilha será criada.
- Edite o evento de cadeia de entradas de tempo de execução clicando duas vezes no comando
- Clique no botão Add Input e adicione a seguinte entrada:
- Type: TextField
- Nome de exibição: Valor do parâmetro de consulta
- Obrigatório: Marcado
- Opcionalmente, arraste e solte esse novo input de modo que ele apareça após o input Query ID (ID da consulta) e antes do input Spreadsheet URL (URL da planilha)
- Salvar o comando
Etapa 4: Executar a consulta
Para recuperar os dados mais recentes, primeiro você precisa executar a consulta. Depois que a consulta for executada com êxito, você poderá exportar os resultados da consulta para usá-los em relatórios ou enviá-los a outros sistemas externos. Usaremos o comando Run Query para executar a consulta Wdata.
- Clique duas vezes no comando Run Query para configurá-lo
- Clique no botão ADD na seção Parameters
- No campo Name, digite o nome do parâmetro de consulta; neste caso, nosso parâmetro se chama Country
- No campo Type, selecione o Query Parameter Type (Tipo de parâmetro de consulta); nesse caso, nosso tipo de parâmetro é Text
- Clique no campo Value
- No painel Variables (Variáveis) à esquerda, clique na seta para baixo para expandir Trigger (Acionador)
- Clique na seta para baixo para expandir as entradas de tempo de execução
- Clique em Query Parameter Value (Valor do parâmetro de consulta)
- Salvar o comando
Etapa 5: Teste o exercício
Agora que a cadeia está concluída, teste o resultado.
- Publicar a cadeia
- Clique em Execute e selecione Run with Inputs (Executar com entradas)
- Adicione valores para seus Inputs de tempo de execução
- ID da consulta - ID da consulta de detalhes do funcionário do CLP no Wdata
- Valor do parâmetro de consulta - o valor que você gostaria que a consulta filtrasse
- Neste exemplo, estamos filtrando os dados para Brazil
- URL da planilha - URL completo da planilha para a qual você gostaria de exportar os resultados da consulta
- Depois que a cadeia for concluída com êxito, visualize a planilha para verificar os resultados
- Você pode verificar se os dados foram exportados para a planilha e filtrados corretamente navegando até o URL da planilha.
- Você pode verificar se os dados foram exportados para a planilha e filtrados corretamente navegando até o URL da planilha
Para saber mais sobre o uso de cadeias para simplificar a centralização de dados, confira o restante dos caminhos de coleta de dados em !