apps
2024.10
true
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
UiPath logo, featuring letters U and I in white
Guia do usuário do Apps
Automation CloudAutomation Cloud Public SectorAutomation Suite
Last updated 11 de nov de 2024

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ê
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<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()dt.ToListSource()

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

Processes.ALLDATATYPES.out_datatable.ToListSource()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>.ToListSourceProcesses.<process_name>.<datatable_output_argument>.ToListSource

    Por exemplo:

    Processes.Process_A.out_dt1.ToListSourceProcesses.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.

      docs image
    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>Processes.<process_name>.<datatable_output_parameter>

        Por exemplo:

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valor

        Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)Processes.<process_name>.<datatable_output_parameter>.AddRow(MainPage.EditGrid.NewItem)

        Por exemplo:

        Processes.Process_A.out_dt1.AddRow(MainPage.EditGrid.NewItem)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>Processes.<process_name>.<datatable_output_parameter>

        Por exemplo:

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valor

        Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)Processes.<process_name>.<datatable_output_parameter>.DeleteRowAt(MainPage.EditGrid.RowIndex)

        Por exemplo:

        Processes.Process_A.out_dt1.DeleteRowAt(MainPage.EditGrid.RowIndex)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>Processes.<process_name>.<datatable_output_parameter>

        Por exemplo:

        Processes.Process_A.out_dt1Processes.Process_A.out_dt1

        Valor

        Processes.<process_name>.<datatable_output_parameter>.UpdateRowAt(MainPage.EditGrid.RowIndex, MainPage.EditGrid.SelectedItem)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)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çãoDescription

    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")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".
      docs image

    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 NomeMainPage.EditGrid.NewItem.Name
      • Propriedade Data de adesãoMainPage.EditGrid.NewItem.Dateofjoining
      • Propriedade IdadeMainPage.EditGrid.NewItem.Age
      • Propriedade GêneroMainPage.EditGrid.NewItem.Gender
      • Propriedade EquipeMainPage.EditGrid.NewItem.Team
      • Propriedade IsFullTimeMainPage.EditGrid.NewItem.Isfulltime
      • Propriedade HabilidadesMainPage.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.IdMainPage.EditGrid.SelectedItem.Id
    4. No campo Valores a definir, atualize o seguinte:
      • Propriedade NomeMainPage.EditGrid.SelectedItem.Name
      • Propriedade Data de adesãoMainPage.EditGrid.SelectedItem.Dateofjoining
      • Propriedade IdadeMainPage.EditGrid.SelectedItem.Age
      • Propriedade GêneroMainPage.EditGrid.SelectedItem.Gender
      • Propriedade EquipeMainPage.EditGrid.SelectedItem.Team
      • Propriedade IsFullTimeMainPage.EditGrid.SelectedItem.Isfulltime
      • Propriedade HabilidadesMainPage.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.IdMainPage.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"})})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>.IdMainPage.EditGrid.SelectedItem.<entity_name>.Id

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.