Vincular dados a Construtor de IUpáginas que usam controladores (recurso avançado)

Os controladores simplificam a vinculação de dados e lógica de evento para habilitar predefinições de componente no Construtor de IU.

Os controladores permitem que os construtores de páginas conectem facilmente dados e scripts às páginas no Construtor de IU. Um controlador é um tipo de recurso de dados que predefinições de componenteuse para vincular dados a componentes. Os controladores diferem de outros recursos de dados porque contêm dados e lógica de evento que habilita predefinições para componentes. Um controlador traz dados do servidor para um componente e traz dados atualizados de volta para o servidor com base nas interações com o componente. Para obter mais informações sobre predefinições de componente, consulte Configurar componentes automaticamente usando predefinições.

Os controladores são adicionados por padrão quando você usa um Construtor de IUmodelo de página. Você pode adicionar controladores a. Construtor de IUpáginas sem um controlador na gaveta de recursos de dados ou selecionando uma predefinição de componente após adicionar um componente a uma página. Você pode exibir quais controladores estão configurados em sua página abrindo a gaveta de recursos de dados.

Figura 1. Controlador na gaveta de recursos de dados

Tipos de controladores de dados em Construtor de IU

Controladores de dados

Os controladores de dados decidem em quais informações devem ser exibidas Construtor de IUpáginas. Os controladores de dados usam recursos de dados para sincronizar informações em tempo real e atualizar dados/tabelas quando um usuário insere informações. Você pode adicionar controladores de dados manualmente a uma página.

Controladores de IU

Os controladores de IU são adicionados às páginas ao usar Construtor de IUmodelos de página e não podem ser adicionados manualmente.

Usando controladores com predefinições em Construtor de IU

Você pode adicionar vários controladores a um Construtor de IU, mas você não pode usar a mesma duas vezes. Se você tentar usar uma predefinição de componente que precisa de um controlador, Construtor de IUsolicita que você o adicione.

Nem todos os componentes funcionam com controladores, mas você pode ver facilmente quais funcionam na biblioteca de componentes. Se você tiver um controlador configurado no Construtor de IU, você pode abrir a biblioteca de componentes para exibir quais componentes têm predefinições. Os componentes com predefinições disponíveis são realçados na biblioteca de componentes.

Figura 2. Componentes com predefinições

Adicione um controlador

Adicione um controlador de dados à sua página para usar predefinições de componente.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

O controlador de registro é o único controlador que você pode adicionar a uma página em Zurich.

Procedimento

1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
   Para obter mais informações, consulte Configure como os usuários interagem com suas aplicações no Construtor de IU.
3. Crie ou abra uma página ou variante de página.
   Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Crie uma página no Construtor de IU .
4. Selecione E no compartimento de recursos de dados.
5. Selecione Recurso de dados .
   
6. Entrar formulário no campo de pesquisa.
7. Selecione o controlador que você deseja adicionar à sua página.
8. Selecione Adicionar.
   
9. Preencha os campos para configurar o controlador.
   

Resultado

O controlador de formulário é exibido no Recursos de dados seção.

Edite um controlador

Configure um controlador para extrair dados de uma tabela.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
   Para obter mais informações, consulte Configure como os usuários interagem com suas aplicações no Construtor de IU.
3. Crie ou abra uma página.
   Para obter mais informações sobre como criar uma página no Construtor de IU, consulte Crie uma página no Construtor de IU .
4. Selecione o controlador que você deseja editar no Dados e scripts gaveta.
   
5. No formulário, preencha os campos.

   Tabela 1. Formulário do controlador de formulário

   Campo	Descrição
   Tipo	O controlador é predefinido como o tipo para todos os controladores.
   Tabela	Adicione uma tabela da qual você deseja que o controlador extraia dados.
   SYS ID	Insira o identificador exclusivo de um registro, forneça um valor ou use -1 para gerar um novo valor.

6. Feche o modal de edição do controlador.
7. Selecione Save (Salvar).

Exclua um controlador

Exclua um controlador que você não precisa mais em Construtor de IU.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Os controladores não podem ser excluídos de páginas criadas com um modelo de página.

Procedimento

1. Navegar até Tudo > Estrutura do Now Experience > Construtor de IU.
2. Abra uma experiência para trabalhar ou crie uma experiência selecionando Criar > Experiência.
   Para obter mais informações, consulte Configure como os usuários interagem com suas aplicações no Construtor de IU.
3. Abra a página com o controlador que você deseja excluir.
4. Selecione Menu ícone ( ) ao lado do controlador que você deseja excluir.
   
5. Selecione Excluir.
   
   O controlador é removido das instâncias de recurso de dados locais.

Exiba propriedades e eventos na API do controlador

A API pública do controlador define os dados de saída que um controlador fornece a uma predefinição. Isso inclui os valores de propriedade e os eventos manipulados usados por um componente quando uma predefinição é selecionada. As informações de propriedade e evento estão disponíveis para exibição no Construtor de IU.

Os valores de propriedade do componente em uma predefinição podem ser valores estáticos ou caminhos para os dados de saída do controlador. Você pode usar o inspetor de recursos de dados no Construtor de IU para exibir os valores da estrutura de dados do controlador usada por uma predefinição. Para exibir a carga transportada por um evento na predefinição, você pode pesquisar esse evento no seletor do manipulador de eventos.

Exibindo propriedades na API do controlador

Você pode exibir propriedades predefinidas no inspetor de dados do UIB. Conhecer os valores disponíveis ajuda a entender como um componente se comportará em seu design e ajuda a identificar todas as propriedades na predefinição que você deseja substituir.

Este procedimento pressupõe que você colocou um componente com uma predefinição na página e configurou um controlador. Para obter instruções, consulte Adicione um controlador .

A guia de configuração exibe valores de propriedade predefinidos como um caminho para a saída do controlador. O caminho de dados base é expresso como <controller_name> . O restante do caminho é criado usando o conteúdo das categorias na hierarquia de dados do controlador. Você pode usar este caminho para exibir os valores atuais do registro para o qual o controlador foi configurado.

1. Para exibir os recursos de dados de um componente, selecione o ícone de dados na barra lateral inferior esquerda.

   

   O inspetor de dados UIB de três colunas é exibido.

2. Na primeira coluna em que os recursos de dados estão listados, selecione o controlador cuja saída você deseja exibir.
   Os dados de configuração do controlador selecionado aparecem na guia Config da segunda coluna. Estas são as propriedades de entrada inseridas quando você configurou o controlador para o primeiro componente com uma predefinição que você colocou na página. Você pode editar esses valores de conexão aqui, se quiser.

   Nota:

   Configurando -1 para o valor em Sys ID o campo configura o controlador para um novo registro. Em seguida, o controlador gera um GUID completo que você pode usar para armazenar dados no registro antes que ele seja salvo. Isso permite que você execute ações em um registro recém-criado, como salvar anexos.
   
   
   
3. Selecione saídas de nível superior na terceira coluna.

   Este é o nível primário da hierarquia de dados do controlador, indicado com o prefixo em dados. , Seguido pelo ID do controlador. Esta combinação forma o caminho raiz para os dados. Os dados contidos nas saídas de nível superior são exibidos no campo de código adjacente e estão disponíveis para uso de predefinições e scripts. Outras propriedades nesse nível são algumas propriedades comuns que se aplicam a todos os registros.

   

   Quando a predefinição mapeia uma propriedade de componente para a saída do controlador, o caminho para a saída é mostrado em vez do valor. Os caminhos são indicados como . id do controlador . caminho do nível superior para a propriedade de saída > e podem ser usados como valores ou como parte de expressões de fórmula.

   Neste exemplo, o mapeamento na predefinição resulta em um caminho para gform.table .

   
   
   
4. Para exibir dados abaixo do nível superior, selecione a categoria secundária indicada pelo caminho no valor da propriedade predefinida.

   O nome da categoria secundária aparece no caminho como <controller ID>.<category> . Os dados dessa categoria são anexados a esse caminho. O caminho raiz acima do campo de código indica a categoria secundária que está sendo usada. Neste exemplo, o caminho para Exibição propriedade em formulário a categoria é expressa como gform.form.form.view . Esse valor predefinido exibe formulários no espaço exibição.

   
   
   

   Neste exemplo, várias propriedades de saída do controlador são usadas em uma expressão de fórmula para criar um objeto.

   
   
   
5. Para exibir um valor de propriedade com script, selecione o ícone de cadeado ao lado da propriedade.

   Isso coloca a propriedade no modo de edição e abre um modal para editar o script.

   

Exibindo eventos no controlador API

Você pode exibir eventos manipulados mapeados para um componente por uma predefinição e suas cargas úteis na guia Eventos no painel de configuração do Construtor de IU. Se o mapeamento de dados de um evento não for apropriado para seu caso de uso, você poderá adicionar manipuladores de dados adicionais.

Nota:

Os mapeamentos do manipulador de dados fornecidos com a predefinição não são editáveis.

1. Selecione a guia Eventos no Construtor de IU.
2. Para exibir o mapeamento de um evento predefinido, selecione o bloco de evento.

   Um modal é exibido mostrando as propriedades da carga do evento predefinido. Você pode Desabilitar o evento neste modal.

   
   
   
3. Para adicionar um manipulador de eventos ao evento, selecione - Adicionar manipulador de eventos no bloco evento.
   
   
   

   Um modal é exibido, mostrando uma lista de eventos manipulados disponíveis. Você pode selecionar qualquer ação da lista, incluindo um manipulador de eventos de um dos controladores listados.

4. Selecione um manipulador de eventos na lista e selecione Adicionar .

   O novo manipulador está listado no bloco de evento.