Editar Grade

O controle Editar grade permite a você listar, editar, paginar ou pesquisar registros tabulares.

Demonstrações

Editar grade: trabalhando com entidades

Introdução

Este aplicativo mostra como trabalhar com entidades usando o controle Editar grade .

Aplicativo de demonstração – experimente você

Baixar aplicativo de demonstração do GitHub

Visualizar aplicativo de demonstração na nuvem

Aplicativo de demonstração — instruções para usar

1. Baixe o arquivo zip com o aplicativo de demonstração. Ele contém:

   • Schema.json - o esquema para as entidades que o aplicativo usa

   • EditGridEntity_DemoApp.uiapp - o arquivo do UiPath^® Apps

2. No UiPath^® Data Service, importe o arquivo Schema.json. Certifique-se de importar tanto Entidades (País e Funcionários) quanto Conjuntos de Escolhas (Gênero e Habilidades).
3. Preencha suas entidades e conjuntos de escolhas com dados.
4. No UiPath^® Apps, crie um novo aplicativo e importe o aplicativo baixado.
5. Você pode notar alguns erros. Para corrigi-los, substitua a entidade Funcionários referenciada por aquela que você importou recentemente na etapa 2.
6. Visualize o aplicativo e interaja com os dados em Editar grade.

Geral

• Origem de dados — a origem dos dados que você deseja editar dentro da grade. Você deve fazer referência a um objeto do tipo AppsDataSource, como uma entidade do Data Service ou um processo do Orchestrator.

  Depois que você buscar a origem dos dados, a grade detecta automaticamente as colunas de dados. Clicar no ícone Mais de cada coluna leva você até as seguintes propriedades:

  • Nome — o nome de exibição do cabeçalho da coluna.

  • Origem — o campo da entidade referenciada.

  • Visualização em modo de edição — determina como interagir com a coluna:

    Opção de visualização em modo de edição	Description
    Caixa de texto	As células na coluna comportam-se como um controle de Caixa de texto.
    Seletor de Data	As células na coluna comportam-se como um controle de Datepicker.
    Caixa de seleção	As células na coluna comportam-se como um controle de Caixa de seleção.
    Lista suspensa	As células na coluna comportam-se como um controle de Lista suspensa.
    Seleção múltipla	As células na coluna comportam-se como um controle de seleção múltipla.

  • Oculto — se verdadeiro, oculta a coluna no tempo de execução.

  • Editável — se falso, marca o conteúdo da coluna como somente leitura.

• Adicionar nova coluna — adicione novas colunas aos seus dados clicando no ícone de mais "+".

• Oculto — se verdadeiro, oculta a coluna no tempo de execução.

• Editável — se falso, marca o controle como somente leitura.

• Adicionar linhas — se verdadeiro, permite que os usuários de aplicativos adicionem novas linhas no tempo de execução. Se falso, os usuários não podem adicionar novas linhas.

• Excluir linhas — se verdadeiro, permite que os usuários de aplicativos excluam linhas. Se falso, os usuários não podem excluir linhas.

• Pesquisa — se verdadeiro, expõe uma capacidade de pesquisa integrada.

Events

• Linha selecionada — configure o que deve acontecer quando uma linha é selecionada.

• Linha adicionada — configure o que deve acontecer quando uma linha é adicionada.

• Linha modificada — configure o que acontece quando uma linha é modificada.

• Linha excluída — configure o que deve acontecer quando uma linha é excluída.

Observação:

Para acessar os erros nas operações de atualização, adição ou edição, use a seguinte sintaxe:

<PageName>.<ControlName>.<RuleName>.Error.Message

Por exemplo, MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message.

Estilo

• Alinhamento de controle — Por padrão, herda o alinhamento pai. É possível definir outro alinhamento que não o pai. Para voltar ao alinhamento padrão pai, desmarque as opções substituídas.

  Observação: o alinhamento depende do layout selecionado para o pai (Vertical vs Horizontal).

• Cor de fundo — define a cor de fundo para o Cabeçalho da grade e o Corpo da grade.

• Borda — define a borda do controle. Espessura, cor e raio da borda podem ser configurados.

• Fonte — os atributos de fonte para o texto do Cabeçalho da coluna e Corpo da coluna, como família de fontes, tamanho, cor ou estilo (negrito, itálico e sublinhado) Por padrão, o controle herda a família de fontes do contêiner pai imediato, que é indicado pela palavra-chave “herdado”.

• Margem — a margem do controle. Por padrão, uma margem de 4px é definida. As propriedades de margem Top/Bottom (Superior/Inferior) e Left/Right (Esquerda/Direita) são combinadas. Essas propriedades podem ser desanexadas usando o botão Link no lado direito da seção Margem.

• Tamanho — a largura e a altura do controle. Por padrão, o tamanho é definido como auto. Para definir valores mínimos ou máximos, clique no ícone de três pontos (...). Se o tamanho do controle for menor que as opções, será exibida uma barra de rolagem.

Propriedades VB

Propriedade do VB	Tipo de dados	Description
SelectedItem	Apps.Controls.TabularInitClass	Faz referência ao item atualmente selecionado no controle.
Fonte de Dados	Apps.Controls.ListSource(Of Apps.Controls.TabularInitClass)	Faz referência à origem de dados para os valores dentro do controle Tabela.
NovoItem	Apps.Controls.TabularInitClass	Faz referência ao item que está sendo criado pela opção Adicionar linha . O evento Linha adicionada faz referência a essa propriedade.
Editável	Booleano	Determina se Editar grade é editável.
Adicionar linhas	Booleano	Determina se linhas podem ser adicionadas em Editar Grade.
Delete Rows	Booleano	Determina se as linhas podem ser excluídas de Editar Grade.
ÍndiceDeLinha	Número inteiro	Referencia o índice da linha para atualizar e excluir operações. Deve ser usado para integração de processos em que todo o conjunto de dados está na memória.
Pesquisar	Booleano	Habilita ou desabilita a função de pesquisa. Se verdadeiro, a pesquisa é habilitada.
Valor	Apps.Controls.TabularInitClass	O valor atualmente selecionado do controle.
Oculto	Booleano	Se verdadeiro, oculta o controle no tempo de execução.
Desabilitado	Booleano	Se verdadeiro, desabilita o controle no tempo de execução.

Conversão de dados complexos em AppsDataSource

Para converter uma tabela de dados ou um tipo de dados complexo em um AppsDataSource: salve a tabela de dados em uma variável e, em seguida, use o método .ToListSource, que converte dados da tabela de dados em AppsDataSource.

1. Salve os dados em uma variável do tipo DataTable. Por exemplo, nomeie a variável "dt".
2. No campo Origem de dados de controles de tabela, use a seguinte expressão:

   dt.ToListSource()

Genericamente, objetos complexos podem ser convertidos em AppsDataSource usando-se a sintaxe:

Processes.ALLDATATYPES.out_datatable.ToListSource()

Uso de TabelaDeDados em controles de Editar grade

Certifique-se de que você já tenha um objeto DataTable em seu aplicativo.

Objetos TabelasDeDados podem ser definidos como argumentos de entrada, saída ou entrada/saída de um processo. Para usar esses objetos TabelaDeDados, você precisa fazer referência ao processo no qual eles são usados como argumentos.

Observação:

TabelaDeDados é compatível somente com primitivos em uma coluna. Os argumentos de tipo complexo em uma coluna não funcionam na TabelaDeDados.

Digamos que você tenha um processo chamado "Process_A", que tem objetos TabelaDeDados como argumentos:

Argumentos de entrada	in_dt1
Argumentos de saída	out_dt1
Argumentos de entrada/saída	inout_dt

Editar Grade

1. Navegue até a guia Geral do seu controle Editar grade .

2. No campo Origem de dados do controle, abra o editor de expressão e escreva a seguinte expressão:

   Processes.<process_name>.<datatable_output_argument>.ToListSource

   Por exemplo:

   Processes.Process_A.out_dt1.ToListSource

3. Para realizar operações nas linhas da TabelaDeDados, como adicionar, editar ou excluir:

   1. Certifique-se de que as propriedades Editável, Adicionar linhas e Excluir linhas estejam definidas como true.

      

   2. Alterne para a guia Eventos do controle Editar grade e, em seguida, configure as regras correspondentes:

      1. Para adicionar linhas, clique em Criar regra para Linha adicionada e, em seguida, use a regra Definir valor :

         Item a ser definido	Processes.<process_name>.<datatable_output_parameter> Por exemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem) Por exemplo: Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)

      2. Para excluir linhas, clique em Criar regra para Linha excluída e, em seguida, use a regra Definir valor :

         Item a ser definido	Processes.<process_name>.<datatable_output_parameter> Por exemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex) Por exemplo: Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)

      3. Para modificar linhas, clique em Criar regra para Linha modificada e, em seguida, use a regra Definir valor :

         Item a ser definido	Processes.<process_name>.<datatable_output_parameter> Por exemplo: Processes.Process_A.out_dt1
         Valor	Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem) Por exemplo: Processes.Process_A.out_dt1.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)

Uso de entidades com controles de Editar grade

O seguinte exemplo mostra como associar uma entidade a um controle Editar grade e, em seguida, realizar operações CRUD usando o controle e regras específicas de entidade.

A entidade usada é chamada de "Employee" e tem os seguintes campos:

• Name

• Idade

• Data de nascimento

• Gênero

• Equipe

• Data de adesão

• IsFullTime

• Habilidades

Exibição de registros de entidade

1. Crie um novo aplicativo VB e, em seguida, adicione a entidade Employee ao aplicativo.
2. Adicione o controle Editar grade ao aplicativo.
3. No campo Origem de dados do controle Editar grade, use o Construtor de consultas e selecione a entidade Employee. As colunas do controle são preenchidas automaticamente com os campos da entidade.
4. Para cada coluna, certifique-se de que a lista suspensa Visualização em modo de edição esteja definida como o tipo de dados correto, da seguinte forma:

   Opção	Description
   Data de nascimento	Seletor de Data
   Idade	Caixa de texto
   Name	Caixa de texto
   Gênero	Lista suspensa
   Equipe	Lista suspensa
   Data de adesão	Seletor de Data
   IsFullTime	Caixa de seleção
   Habilidades	Seleção múltipla

   Gênero e Equipe são conjuntos de escolhas de entidade. Quando você seleciona Lista suspensa na visualização em modo de edição para essas colunas, duas novas propriedades são exibidas: Origem da lista e Coluna.
5. Para buscar as opções em um conjunto de escolhas:
   1. No campo Origem da lista, use a sintaxe a seguir.

      GetChoiceSet("Choiceset Name")

      Por exemplo, para as colunas Gênero e Equipe, o campo Origem da lista deve ter:

      • Gênero — GetChoiceSet("Gender")
      • Equipe — GetChoiceSet("Team")
   2. No campo Coluna, escreva "Name".
      

   Habilidades é um conjunto de escolhas de entidade que permite seleção múltipla. Quando você seleciona Seleção múltipla na Visualização em modo de edição para essas colunas, duas novas propriedades são exibidas: Origem da lista e Coluna.

6. Configure a coluna Habilidades como você fez para Gênero e Equipe.
7. Vá para a guia Evento do controle Editar grade.
8. Para o evento Linha adicionada, crie a seguinte regra:
   1. Adicione a regra Criar registro de entidade.
   2. No campo Em qual entidade o registro deve ser criado?, selecione a entidade Employee.
   3. No campo Valores a definir, atualize o seguinte:
      • Propriedade Nome — MainPage.EditGrid.NewItem.Name
      • Propriedade Data de adesão — MainPage.EditGrid.NewItem.Dateofjoining
      • Propriedade Idade — MainPage.EditGrid.NewItem.Age
      • Propriedade Gênero — MainPage.EditGrid.NewItem.Gender
      • Propriedade Equipe — MainPage.EditGrid.NewItem.Team
      • Propriedade IsFullTime — MainPage.EditGrid.NewItem.Isfulltime
      • Propriedade Habilidades — MainPage.EditGrid.NewItem.Skills
9. Para o evento Linha modificada, crie a seguinte regra:
   1. Adicione a regra Atualizar registro de entidade.
   2. No campo Qual registro de entidade deve ser atualizado?, selecione a entidade Employee.
   3. No campo ID do registro de entidade, escreva a seguinte expressão:

      MainPage.EditGrid.SelectedItem.Id

   4. No campo Valores a definir, atualize o seguinte:
      • Propriedade Nome — MainPage.EditGrid.SelectedItem.Name
      • Propriedade Data de adesão — MainPage.EditGrid.SelectedItem.Dateofjoining
      • Propriedade Idade — MainPage.EditGrid.SelectedItem.Age
      • Propriedade Gênero — MainPage.EditGrid.SelectedItem.Gender
      • Propriedade Equipe — MainPage.EditGrid.SelectedItem.Team
      • Propriedade IsFullTime — MainPage.EditGrid.SelectedItem.Isfulltime
      • Propriedade Habilidades — MainPage.EditGrid.SelectedItem.Skills
10. Para o evento Linha excluída, crie a seguinte regra:
    1. Adicione a regra Excluir registro de entidade.
    2. No campo Qual registro de entidade deve ser excluído?, selecione a entidade Employee.
    3. No campo ID do registro de entidade, escreva a seguinte expressão:

       MainPage.EditGrid.SelectedItem.Id

11. Visualize seu aplicativo e interaja com os vários recursos de Editar grade, como paginação, pesquisa, adicionar nova linha, atualizar linha ou excluir linhas.

Uso de relacionamentos nos controles Editar grade

Para usar campos de entidade do tipo Relacionamento em um controle Editar grade:

1. No campo Visualização em modo de edição, defina os campos de relacionamento como uma Lista suspensa.
2. Na propriedade Origem da lista subsequente, use a seguinte expressão:

   Fetch(of <entity_name>)(Nothing, Nothing, Nothing, Nothing, New ExpansionFieldOption(){addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

3. Na propriedade Coluna subsequente, escreva "Name".
4. Em regras relacionadas à entidade, como Criar, Atualizar ou Excluir registros de entidade, passe o ID do campo de relacionamento da seguinte forma:

   MainPage.EditGrid.SelectedItem.<entity_name>.Id