Documentação

6 Páginas

Esta seção é reservada para criação de páginas, em destaque na tela ficam os itens já criados separados por tipo e módulo. Para adicionar novas páginas basta acessar o link Nova página e selecionar o tipo desejado.

Para acessar está seção basta clicar no item PÁGINAS no menu superior.

Páginas

No centro da são apresentadas as páginas separadas por módulo. Em cada linha são exibidas algumas informações importantes como:

  1. Nome da página

  2. Nome do controller da página

  3. Autor da página

  4. Página pública (sim e não)

  5. Página exibida no menu (sim e não)

  6. Data da última modificação

Além de informações textuais é exibido um conjunto de ações conforme a imagem abaixo:

Ações das páginas

  1. Editar: Abre a tela de edição da página

  2. Mover para a lixeira: Remove a página. *Para realizar uma remoção permanente esta página também deve ser removida da lixeira.

  3. Clonar: Criar uma cópia da página. Deve ser informado um novo nome para item de menu e para classe de controle.

  4. Download: Realiza o download do código-fonte da página.

  5. Histórico: É exibido um histórico de modificações contendo desenvolvedor e data de modificação.

  6. Versões: É exibida uma lista contendo todas as versões da página, separadas por desenvolvedor e data. É possível restaurar a página em qualquer versão apresentada na lista. Ao restaurar uma página o Adianti Builder irá exibir a página em modo de edição, para que as alterações sejam salvas é necessário clicar em Restaurar.

Atenção: Ao restaurar uma versão as modificações sobrescreverão a página. Será possível reverter as mudanças restaurando a página para a versão desejada.

6.1 Tipos de páginas

Ao clicar em "nova página", um diálogo será aberto e o desenvolvedor poderá selecionar o tipo de página a ser criada. A seguir, os tipos são apresentados:

Tipos de páginas

  1. Formulário de cadastro, atua como agrupador lógico de campos para inserção de dados.

  2. Formulário de consulta, exibe conteúdos sem permitir edições.

  3. Listagem, geralmente apresenta uma coleção de registros vindos do banco de dados.

  4. Calendário, semelhante a uma agenda geralmente exibe eventos quaisquer.

  5. Relatório tabular, visualização de registros em formato de planilha.

  6. Gráfico, visualização de registros ou operações aritméticas em formatos gráficos diversos.

  7. Documento, arquivo em PDF que pode juntar textos fixos com informações do sistema em formatos de orçamento, certificados, etc.

  8. Desenho, seque os moldes de uma página do tipo documento sendo que com mais liberdade gráfica através de ferramentas específicas.

  9. Documentos em lote, geração de documentos em lote.

  10. Desenhos em lote, geração de desenhos em lote.

  11. Etiquetas (código barras), uma página com etiquetas no padrão código de barras.

  12. Etiquetas (qrcode), uma página com etiquetas no padrão Qr code.

6.2 Visão geral das páginas

Esta seção é a área de criação de páginas do Adianti Builder, ela pode apresentar diferenças dependendo do tipo de página selecionado.

Visão geral criar formulário

  • Logo abaixo do menu superior está alocada a barra de ferramentas, nela são encontrados diversas ferramentas para o desenvolvimento das páginas.

  • No centro da página fica uma demonstração da página em desenvolvimento.

  • Na lateral direita ficam as configurações do componente selecionado.

6.2.1 Barra de ferramentas

Barra de ferramentas

Da esquerda para a direita:

  1. Arquivo - menu que agrupa os seguintes atalhos:

    • Nova página - cria uma nova página.

    • Abrir página - Abre uma página existente.

    • Propriedades - Abre as propriedades de criação da página (opções exibidas podem variar confirme a página ativa).

    • Salvar - salva as modificações feitas na página ativa.

  2. Inserir - menu que agrupa os seguintes atalhos:

    • Nova aba - Cria abas no formulário, permitindo dividir melhor o espaço, colocando mais campos.

    • Novo separador - Permite criar uma linha horizontal separando conteúdos, sendo que ela pode ou não ter um título.

    • Nova linha - Adicionar nova linha no formulário, o usuário deve escolher entre dudas opções com duas ou quatro colunas.

    • Novo link - Adicionar um link, é apresentado visualmente como um botão na barra de ações, o link deve ser ligado a uma ação de alguma página já existente, exemplo

    • Nova ação - Adicionar uma ação, é apresentada como um botão na barra de ações, diferente de um link uma ação deve estar vinculada a um método especifico a ser criado pelo desenvolvedor. O código a ser desenvolvido é acessível no menu lateral direito na aba "Eventos".

    • Novo formulário detalhe - Adicionar detalhe, o sistema exibirá as tabelas que possuem referência para a tabela principal da página e adicionará uma listagem de detalhamento. Um exemplo seria um formulário de vendas e o detalhe seriam os itens da venda.

  3. Ferramentas - menu que agrupa os seguintes atalhos:

    • Importar campos - importa os campos de outra tela. Em alguns casos existem duas telas iguais mais com resultados diferentes. Um exemplo seriam telas de filtros de relatórios, dois relatórios poderiam ter os mesmos filtros mas o resultado seria exibido de forma diferente. Desta maneira só seria necessário criar a tela uma vez, na segunda bastaria importar os campos. Esta função exibe como opção apenas páginas montadas em cima da mesma tabela.

  4. Remover bordas pontilhadas - remove as bordas que delimitam às linhas da página.

  5. Visualizar como dispositivo móvel - Exibe a tela em dimensões mobile, facilitando a montagem das páginas.

  6. Tela cheia - Esconde a coluna de configurações aumentando o tamanho do modelo de página.

  7. Separador: Permite criar uma linha horizontal separando conteúdos, sendo que ela pode ou não ter um título.

  8. Linha: Adicionar nova linha no formulário, o usuário deve escolher entre dudas opções com duas ou quatro colunas.

  9. Link: Adicionar um link, é apresentado visualmente como um botão na barra de ações, o link deve ser ligado a uma ação de alguma página já existente, exemplo "Voltar para a listagem".

  10. Ação: Adicionar uma ação, é apresentada como um botão na barra de ações, diferente de um link uma ação deve estar vinculada a um método especifico a ser criado pelo desenvolvedor. O código a ser desenvolvido é acessível no menu lateral direito na aba "Eventos".

  11. Componente - Uma lista com todos os componentes disponíveis para serem adicionados em páginas.

  12. Deploy - Salva as modificações da página e envia diretamente para um servidor cadastrado (ver capítulo 24.6.1 Deploy.

  13. Download - Salva as modificações da página e oferece a opção de download da mesma.

  14. Propriedades - Abre as propriedades de criação da página (opções exibidas podem variar confirme a página ativa). Neste item é possível trocar o módulo da página.

  15. Salvar - Salva as modificações da página ativa.

  16. ? - Documentação do Adianti Builder.

Páginas do tipo formulário apresentam um ícone a mais: Aba: Cria abas no formulário, permitindo dividir melhor o espaço, colocando mais campos.

6.2.2 Propriedades dos campos

Ao selecionar qualquer campo do formulário a direita será exibido um painel com até três abas, dependendo do tipo do campo as informações podem variar:

Propriedades : Aqui são exibidas as configurações de cada campo presente no formulário

Eventos: Aqui são configuradas ações como eventos de saída de campo, e recarregamento de campos dependentes.

Filtros: Aqui são criadas regras de filtragem para limitar opções apresentadas em alguns campos como combos do banco de dados.

Para mais informações sobre as configurações dos campos ver capítulo 20 Propriedades de campos

6.3 Abrir páginas

O Adianti Builder permite que o desenvolvedor trabalhe com várias páginas abertas ao mesmo tempo. Para isso, basta acessar a opção Abrir página no menu Arquivo na barra de ferramentas e escolher a página desejada.

A ferramenta de abas é responsável por intercambiar as abas abertas concomitantes. Para evitar que trabalhos executados possam ser perdidos, sempre que uma nova aba é selecionada a página anterior é salva.

Páginas abas

6.4 Propriedades da página

As informações inseridas para criar uma página e algumas outras podem ser editadas acessando o ícone de engrenagem, como pode ser visto na imagem a seguir:

Propriedades página

Na aba de propriedades estão disponíveis diversas configurações da página em questão, algumas delas são as mesmas que foram definidas no momento de criar a página. Falaremos mais sobre as abas Pontos de edição e Métodos no capítulo 21 Edição de código-fonte.

Propriedade Descrição
Módulo Sob qual módulo do menu da aplicação essa página estará.
Nome da página Nome descritivo da página.
Nome da classe de controle Nome da classe do arquivo .php da página.
Tipo de apresentação Apresentação normal é a visualização de página padrão, já a window é uma página flutuante, estilo modal.
Largura da janela Tamanho da janela, caso tenha sido escolhido a apresentação window.
Exibir página no menu Informar se a página terá um link de acesso através do menu da aplicação.
Página pública Informar se a página poderá ser acessada sem estar logado na aplicação.
Ícone no menu Ícone exibido ao lado do nome da página no menu da aplicação.
Cor do ícone no menu Cor do ícone da página.
Breadcrumb Breadcrumb, informação exibida na parte superior da página, está destacado na imagem anterior.