Mestre Detalhe

View video

Este recurso permite exibir/manipular informações em dois níveis. O nível mestre, exibe a informação principal a ser mostrada já o nível detalhe exibe informações mais específicas sobre o ítem selecionado no mesmo.

Para exemplificar a estrutura de um Mestre/Detalhe basta imaginar um sistema de loja, onde existe uma aplicação com a lista de pedidos (Mestre) e outra com a lista de produtos do pedido (Detalhe).

Novo Mestre

No menu de aplicação, clicando sobre o item Novo Mestre/Detalhe da pasta Mestre/Detalhes poderá ser criada uma nova ligação de detalhe.

Criando um novo detalhe.

Nome e Label

Interface para definição o Name e a Label do detalhe, o nome não pode conter espaços em caracteres especiais. Após criado, o detalhe será exibido como um campo e pode ser reposicionado no opção Posicionamento dos campos.

Ao marcar a opção Criar um novo bloco para posicionar este campo, o detalhe será adicionado automaticamente a um bloco. Este bloco pode ser removido posteriormente na configuração dos blocos da aplicação.

Interface para definir o nome e o rótulo do link.

Lista de aplicações

Exibe a lista de aplicações disponíveis para a criação do mestre detalhe, este recurso permite a utilização apenas de aplicações do tipo: Formulário e Consulta.

Ainda é possível agrupar as aplicações por Pasta e Por Tipo.

• Por pasta - As aplicações serão agrupadas de acordo com a pasta que foram criadas, no Projeto Explorer.
• Por Tipo - Neste opção as aplicações serão agupadas de acordo com seu tipo.
• Todas - Serão listadas todas as aplicações disponíveis para a criaçãod o recuros.

Interface para configurar a aplicação detalhe.

Chaves Estrangeiras

O Desenvolvedor deve vincular os campos que são chave estrangeria entre a aplicação Mestre e a detalhe, os demais campos deverão permanecer em branco.

Na coluna da esquerda estão listados todos os campos da aplicação master e no campo select, à direita, a lista de todos os campos da aplicação selecionada para o Detalhe.

Esta etapa é habilitada ao cria um mestre/detalhe entre duas aplicações formulário.

Definição dos parâmetros

Nesta etapa serão listadas as variáveis globais definidas na aplicação selecionada para o detalhe.

Caso a aplicação detalhe seja uma consulta, é fundamental definir um parâmetro na where da aplicação, para que os registros serão exibidos corretamente.

Clique aqui para acessar a documentação relacionada à criação de parâmetros na grade.

Sem este parâmetro, todos os registros serão exibidos na aplicação de detalhe, sem a vinculação correção com o registo mestre.

Interface para configurar os parâmetros da ligação.

O desenvolvedor deve informar o Tipo do valor que será enviado no parâmetro.

Campos

Ao selecionar esta opção será exibido um combobox com a lista de campos da aplicação mestre.

Valor fixo

Permite que o desenvolvedor defina um valor fixo para ser enviado para o detalhe.

Não é permitido o uso de variáveis.

Sem valor

Nesta opçao a variável não receberá valores.

Configurações gerais

Ao finalizar a criação do mestre detalhe, será exibida a tela com algumas opções de configuração para o mestre detalhe.

Label

Define o nome mostrado no aplicativo. Este atributo aceita texto ou variável de idioma.

Etiqueta abaixo do campo

Define o texto que será mostrado abaixo do campo detalhe. Este atributo aceita texto ou variável de idioma.

Propriedade da grade

• Initial Mode - Define se a aplicação detalhe será iniciada pelo módulo pesquisa ou pelo módulo grid.
• Somente visualização -
• Número de Linhas - Define a quantidade de linhas que a aplicação irá mostrar no início.
• Number of Columns - Define o número de colunas que a aplicação irá mostrar no início.
• Display Header - Define se o cabeçalho da aplicação será exibido.
• Active Navigation Buttons - Define se os Botões de Navegação da aplicação serão exibidos.

Este bloco de configuração só é exibido no detalhe mestre entre uma grade e um formulário.

Propriedades do formulário

Dentro desta opção você pode selecionar os botões que serão exibidos no formulário de detalhe.

• Habilite o botão inserir no aplicativo de destino
• Habilite o botão de atualização no aplicativo de destino
• Habilite o botão excluir no aplicativo de destino
• Habilite o botão de navegação no aplicativo de destino
• Manter a cláusula WHERE na aplicação de destino

Este bloco de configuração só é exibido no detalhe mestre entre dois formulários

Propriedades do iframe

Esta opção permite configurar a altura e largura do iframe (em pixels) onde será exibido o formulário detalhado.

• Largura do Iframe - Define a largura do iframe
• Altura do iframe - Define a altura do iframe
• Remover margem da aplicação - Remove a margem do aplicativo dentro do iframe
• Remover borda da aplicação - Remove as bordas do aplicativo dentro do iframe

Propriedades de detalhe

• Tipo de formulário - A opção “Form Type” só funciona para alterar aplicações já configuradas com orientação horizontal, utilizadas dentro do detalhe. Por exemplo. Várias linhas ou grade editável. Este atributo só é exibido em links entre dois formulários.
• Paginação: Permite que você selecione a paginação de detalhes do formulário. As opções são:
  • Partial : Esta opção definirá o layout da página como parcial, com limite de registros por página, de acordo com a quantidade informada na opção abaixo “Linhas por página”
  • Total : Esta opção definirá a página para exibir todos os registros em uma página.
• Quantidade de registros : Aqui você pode definir a quantidade de registros que serão exibidos no formulário de detalhe, você precisará definir isso apenas se a paginação for parcial.Este atributo só é exibido em links entre dois formulários.
• Na exclusão : Esta opção permite escolher como as dependências de detalhes do formulário serão tratadas em uma exclusão. Este atributo só é exibido em links entre dois formulários. As opções são:
  • Avisar quando houver dependências : Exibe uma mensagem de erro se houver dependência no registro do formulário detalhado que está sendo excluído do formulário mestre.
  • Excluir dependências sem aviso: Exclui todas as dependências existentes no formulário detalhado sem avisar o usuário.