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 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 propriedades dos componentes diferenciam maiúsculas de minúsculas e devem corresponder precisamente aos nomes de colunas no arquivo CSV, bem como aos nomes de 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. Crie uma variável TabelaDeDados para armazenar o arquivo CSV de saída.

      Para este exemplo, nomeie-o dataGridDataTable.

   2. Volte para o seu formulário e defina o Nome da propriedade do componente da 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 Grade de dados 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 da 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 campoChangedTrigger, responsável por definir o status de um aluno como reprovado ou aprovado, de acordo com seu resultado no exame.

   1. Adicione uma atividade Form Trigger e defina o evento quando o campo examResults mudar.

   2. Adicione uma atividade Construir tabela de dados para criar uma TabelaDeDados em que os valores da Grade de dados serão armazenados quando o gatilho for disparado.

      Nomeie a variável de saída como editedDataTable.

   3. Adicione uma atividade Get Form Values para recuperar a Grade de dados para a TabelaDeDados que você criou na subetapa b (editedDataTable).

   4. Adicione uma atividade For Each Row para iterar por cada resultado de exame e definir o campo Status adequadamente. 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 e minúsculas. Esta é a razão pela qual 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 seu resultado no exame for F.

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

   7. No corpo do Else , adicione uma atividade Assign novamente, desta vez para a situação em que o status de um aluno é "aprovado", porque seu resultado no 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 extract clicked, responsável por extrair o DataGrid e enviá-lo como String em um formato CSV.

   1. Adicione uma atividade de disparo de formulário 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 TabelaDeDados. 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 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 você mesmo, consulte o exemplo de fluxo de trabalho.