apps
latest
false
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 17 de jun de 2024

Editar Grade

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

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

  • SelectedItem (T) — faz referência ao item atualmente selecionado pelo usuário do aplicativo

  • DataSource (ListSource de T) — faz referência aos dados disponíveis no controle.

  • NewItem (T) — faz referência ao item que está sendo criado pela opção Adicionar linha. Para ser usado no evento Linha adicionada.

  • Oculto (booleano) — faz referência à propriedade Oculto do controle.

  • Editável (booleano) — faz referência à propriedade Editável do controle.

  • AddRows (booleano) — faz referência à propriedade Adicionar linhas do controle.

  • DeleteRows (booleano) — faz referência à propriedade Excluir linhas do controle.

  • Pesquisar (booleano) — faz referência à propriedade Pesquisar do controle.

  • RowIndex (Integer) — faz referência ao item na coluna para operações de atualização e exclusão.

Importante:

Use essa propriedade para integração de processos em que todo o conjunto de dados está na memória.

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.

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

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 — 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.

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.