Grade de Dados

Este tutorial fornece instruções passo a passo sobre como criar e usar um componente de Grade de dados. Você aprenderá a passar dados para a Grade de Dados, atualizá-la em tempo real e extrair as informações. O tutorial utiliza um arquivo CSV para a entrada de dados na Grade de Dados.

Essa automação usa um registro CSV dos alunos e seus resultados nos exames e o exibe em um formulário onde você pode atualizar os resultados do exame e seu status correspondente ("aprovado" ou "reprovado") em tempo real. Além disso, a automação permite disparar a extração do registro e da saída no console.

1. Crie um novo Formulário. Para este exemplo, nomeie-o como DataGrid.
   1. Adicione um componente de Grade de dados dentro do formulário.
   2. Adicione os componentes correspondentes para cada coluna no arquivo CSV que você deseja passar para o formulário.
      Para este exemplo, adicione um Campo de Texto (fullName), uma Caixa de Seleção (seniorYear) e uma Lista Suspensa (examResults).
      
      

      

      
      
      Observação: observe que os Nomes de propriedade dos componentes diferenciam maiúsculas de minúsculas e devem corresponder exatamente aos nomes das colunas no arquivo CSV, bem como aos nomes das colunas das Tabelas de dados.
   3. Além disso, adicione um Campo de Texto extra dentro da Grade de Dados chamado Status. Isso será usado para atualizações do formulário.
   4. Adicione um Botão fora da Grade de Dados. Este botão disparará a extração da Grade de Dados.
   
   

   

   
   
2. No fluxo de trabalho Principal , adicione e configure as seguintes atividades:
   1. Ler CSV - Insira o arquivo CSV contendo os dados para a Grade de Dados. Criar uma variável DataTable para armazenar o arquivo CSV de saída.
      Para este exemplo, nomeie-o dataGridDataTable.
   2. Volte para seu formulário e defina o Nome de Propriedade do componente de Grade de Dados como a variável DataTable que você criou na subetapa a, onde você armazena o arquivo CSV de saída. Para este exemplo, defina o Nome da propriedade como dataGridDataTable.
   3. Mostrar formulário — selecione o formulário GradeDeDados e passe os dados da TabelaDeDados para a Grade de Dados.
   4. No Dicionário de argumentos , adicione uma entrada para o argumento dataGrid com o tipo System.Data.DataTable e direção In e defina o valor como dataGridDataTable.

      Chave	Tipo	Direction	Valor
      dataGrid (o Nome de Propriedade da Grade de Dados)	System.Data.DataTable	In	dataGridTable

   5. Executar Gatilhos Locais - Habilite todos os gatilhos dentro do projeto.
3. Crie um fluxo de trabalho de gatilho chamado FieldChangedTrigger, responsável por definir o status de um aluno como reprovado ou aprovado, de acordo com o resultado no exame.
   1. Adicione uma atividade Form Triggere defina o evento quando o campo examResults for alterado.
   2. Adicione uma atividade Build Data Table para criar uma DataTable onde os valores do DataGrid serão armazenados quando o gatilho for acionado.
      Nomeie a variável de saída como editedDataTable.
   3. Adicione uma atividade Get Form Values para recuperar a Grade de dados na TabelaDeDados que você criou na subetapa b (editedDataTable).
   4. Adicione uma atividade For Each Row para iterar por cada resultado de exame e defina o campo Status de acordo. Insira a TabelaDeDados que você criou na subetapa b (editedDataTable) no campo Tabela de dados .
   5. No corpo da atividade For Each Row, adicione uma atividade If e defina a condição como CurrentRow("examResults").ToString="f".
      Observe que os Valores diferenciam maiúsculas de minúsculas. É por isso que usamos "f" minúsculo dentro da condição, em vez do "F" maiúsculo.

      
      

      

      
      
   6. No corpo Then , adicione uma atividade Assign para atribuir o status do aluno como "reprovado" quando o resultado do exame for F.

      Salvar em	Valor a ser salvo
      CurrentRow("status")	"failed"

   7. No corpo Else , adicione uma atividade Assign novamente, desta vez para a situação em que o status de um aluno é "aprovado", porque o resultado do exame não foi F.

      Salvar em	Valor a ser salvo
      CurrentRow("status")	"passed"

   8. Fora da atividade For Each Row , adicione uma atividade Set Form Values , para passar a Grade de dados atualizada de volta para o formulário. No campo Chave , use dataGrid com o Tipo System.Data.DataTable e defina o valor como editedDataTable.

      Chave	Tipo	Valor
      dataGrid	System.Data.DataTable	editedDataTable

4. Crie um fluxo de trabalho de gatilho chamado extrair clicado, responsável por extrair o DataGrid e enviá-lo como String em um formato CSV.
   1. Adicione uma atividade Form disparar e defina o evento quando o botão extract for clicado.
   2. Adicione uma atividade Get Form Values para extrair a Grade de Dados para uma DataTable. Adicione uma entrada no dicionário de Argumentos para dataGrid com o Tipo System.Data.DataTable e defina o Valor como output.

      dataGrid	System.Data.DataTable	output

   3. Adicione uma atividade Output Data Table para gerar a Grade de Dados extraída como String em um formato CSV. No campo Tabela de Dados , insira a variável que você usou para extrair a Grade de dados na subetapa b (output). Insira uma variável String que você registrará em log no console de saída no campo Texto
   4. Adicione uma atividade Log Message para gerar a Grade de Dados extraída.
   5. Adicione uma atividade Stop Local Triggers para fechar o formulário e parar a execução, supondo que você não deseja interagir com o formulário após extraí-lo.

A imagem abaixo mostra o resultado da atualização de dados enquanto o formulário ainda está sendo exibido.

Exemplo de fluxo de trabalho

Para seguir as etapas e experimentar o tutorial, consulte o fluxo de trabalho do exemplo.