- Introdução
- Antes de começar
- Como fazer
- Acessar o URL de produção de um aplicativo
- Build a mobile-friendly app
- Incorporar aplicativos
- Incorporar mapas
- Definir contexto externo
- Use matrizes para preencher os controles Lista suspensa, Lista suspensa multiseleção e Botão de rádio
- Usar TabelaDeDados com controles de Tabela e de Editar Grade
- Usar máscara de entrada
- Notificações
- Uso de expressões VB
- Desenvolvimento de aplicativos
- Eventos e Regras
- Regra: If-Then-Else
- Regra: abrir uma página
- Regra: Abrir o URL
- Regra: fechar planilha pop-over/inferior
- Regra: mostrar mensagem
- Regra: exibir/ocultar o controle giratório
- Regra: definir valor
- Regra: iniciar o processo
- Regra: redefinir valores
- Regra: upload de arquivo no compartimento de armazenamento
- Regra: baixar arquivo do bucket de armazenamento
- Regra: criar registro de entidade
- Regra: atualizar registro de entidade
- Regra: excluir registro da entidade
- Regra: adicionar à fila
- Regra: fluxo de trabalho de gatilho
- Aproveitamento do RPA no aplicativo
- Aproveitamento de entidades no aplicativo
- Aproveitando filas em seu aplicativo
- Aproveitamento da mídia no aplicativo
- Aproveitamento de ações no aplicativo
- Gerenciamento do ciclo de vida do aplicativo (ALM)
- Guia básico de solução de problemas
Editar Grade
O controle Editar grade permite a você listar, editar, paginar ou pesquisar registros tabulares.
Introdução
Este aplicativo mostra como trabalhar com entidades usando o controle Editar grade .
Aplicativo de demonstração – experimente você
Aplicativo de demonstração — instruções para usar
-
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.
-
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.
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
MainPage.EmployeeDetailsGrid.UpdateEntityRecord.Error.Message
.
-
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.
Propriedade do VB |
Tipo de dados |
Description |
---|---|---|
SelectedItem |
|
Faz referência ao item atualmente selecionado no controle. |
Fonte de Dados |
|
Faz referência à origem de dados para os valores dentro do controle Tabela. |
NovoItem |
|
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 |
| 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. |
.ToListSource
, que converte dados da tabela de dados em AppsDataSource.
Genericamente, objetos complexos podem ser convertidos em AppsDataSource usando-se a sintaxe:
Processes.ALLDATATYPES.out_datatable.ToListSource()
Processes.ALLDATATYPES.out_datatable.ToListSource()
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.
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 |
-
Navegue até a guia Geral do seu controle Editar grade .
-
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
Processes.<process_name>.<datatable_output_argument>.ToListSourcePor exemplo:
Processes.Process_A.out_dt1.ToListSource
Processes.Process_A.out_dt1.ToListSource -
Para realizar operações nas linhas da TabelaDeDados, como adicionar, editar ou excluir:
-
Certifique-se de que as propriedades Editável, Adicionar linhas e Excluir linhas estejam definidas como true.
-
Alterne para a guia Eventos do controle Editar grade e, em seguida, configure as regras correspondentes:
-
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_dt1
Processes.Process_A.out_dt1Valor
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) -
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_dt1
Processes.Process_A.out_dt1Valor
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) -
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_dt1
Processes.Process_A.out_dt1Valor
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)
-
-
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
- Demonstrações
- Editar grade: trabalhando com entidades
- Geral
- Events
- Estilo
- Propriedades VB
- Conversão de dados complexos em AppsDataSource
- Uso de TabelaDeDados em controles de Editar grade
- Editar Grade
- Uso de entidades com controles de Editar grade
- Exibição de registros de entidade
- Uso de relacionamentos nos controles Editar grade