Escolar Documentos
Profissional Documentos
Cultura Documentos
id=30921
Uma vez que criamos toda a estrutura das tabelas, podemos começar a pensar na nossa aplicação. Esta é a
função deste módulo.
Objetivos deste módulo
No final deste módulo você deverá ser capaz de:
Saber o que é necessário configurar nas tabelas criadas, para que ao rodarmos o assistente (wizard), as telas
sejam criadas com o menor nível de ajuste fino possível.
Preencher o assistente (wizard) para gerarmos nossa aplicação.
Entender tudo que foi criado na nossa aplicação.
Site: TCU - Tribunal de Contas da União
Curso: Curso Básico de Apex
Livro: Criando o Sistema Minha Escola
Impresso por: WILCIONE SOARES COSTA
Data: sexta, 3 Mai 2019, 13:17
1 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
2 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Este tópico visa ambientar o usuário à algumas terminologias utilizadas no Apex. São elas:
Lista de Valores (List Of Values). Pode ser encontrada em várias telas do Apex e pode ser criada pelo
desenvolvedor para tornar a vida do usuário final mais simples, sem haver necessidade de digitações de
valores. Um bom exemplo para utilizar uma LOV é quando temos uma chave estrangeira na tabela ou um
domínio fixo.
As LOVs dividem-se em dinâmicas e estáticas. No caso da nossa chave estrangeira, ela deveria ter uma
LOV dinâmica, ou seja, ela é baseada uma consulta (query) SQL que retorna dois campos, onde o primeiro
campo é o que a LOV irá exibir para o usuário escolher e o segundo campo é o valor associado.
Veja a imagem abaixo com duas LOV dinâmicas: Aluno e Turma.
Já no caso de um domínio fixo (como sexo), o ideal é usarmos uma LOV estática, onde na tela de criação
podemos definir o que será exibido e o valor associado.
É um formulário tradicional, onde o layout pode ser mais detalhado e só vemos um registro por vez.
3 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
É um formulário que se parece com uma planilha do Excel. Cada item presente neste formulário será uma
coluna com N linhas. É útil quando, de uma vez só, precisamos ver e editar valores de várias linhas de uma
tabela. Esse tipo de formulário tem menor possibilidades de adaptação e formatação que os Forms
tradicionais.
4 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
São informações que aparecem na tela como resultado de uma consulta (query) SQL. Dividem-se nas
categorias relatórios clássicos (tradicionais) e relatórios interativos.
Os relatórios clássicos têm mais opções de configuração e formatação, mas sua interatividade vai até um
determinado limite.
Já os relatórios interativos permitem que o usuário final altere várias coisas como a ordem de exibição das
colunas, rótulos (labels), adicione filtros, cálculos, somatórios, contadores, oculte colunas, crie gráficos, entre
outras coisas que abordaremos mais tarde neste curso.
Qual é o melhor? Se você precisa de mais controle, o clássico costuma ser melhor. Se você quer jogar o poder
de manipular os dados (sem alterá-los!) para o usuário, o interativo costuma prevalecer. Na dúvida, use o
interativo, que gera mais resultados com menor esforço.
Por padrão, ao se clicar no ícone o relatório muda a visão dos dados, mostrando apenas os detalhes do
registro escolhido, não dando opção de alteração nos dados.
5 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
No desenvolvimento rápido de aplicações, é a melhor opção. Toda a estrutura de criar, atualizar e deletar
dados é gerada automaticamente. Na parte superior do formulário fica a parte de cadastro, enquanto na parte
de baixo encontra-se o relatório. Outra implementação - a mais usada - é em duas telas, onde na primeira
temos o relatório e ao clicarmos no ícone o formulário é exibido automaticamente, com a opção de alterar
o registro.
6 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
É o código HTML que representa cada item ou região da tela. Por padrão, já existem vários modelos criados,
porém o Apex permite tanto a edição quanto a criação de novos modelos. Como não é o foco deste curso, este
assunto não será abordado profundamente. Cada tag marcada com # representa o ponto de exibição de uma
região. Isso significa que ao associarmos uma região a um determinado ponto de exibição, o conteúdo da
região irá aparecer naquela parte da tela. Para acessar este modelo, vá a Componentes Compartilhados e em
seguida em Modelo. Nesta página clique no ícone de Visualizar Modelo referente ao modelo da página
escolhido.
7 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
É uma área pré-definida da sua página, utilizada para dar uma ideia de posicionamento do conteúdo a ser
inserido. Uma página pode possuir uma ou várias regiões e a posição de cada região varia de acordo com o
modelo de página escolhido.
8 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Quando incluído na sua página, mostra a hierarquia de páginas percorridas para chegarmos na página atual.
O Caminho Detalhado também é muito usado pelo Apex, ficando no canto superior esquerdo da página.
Nas versões anteriores do APEX (< 5.0), você poderia utilizar Tabs para a navegação dentro da aplicação.
Este conceito foi substituído pelas listas de navegação a partir do APEX 5.0, pois torna mais flexível as
aplicações.
9 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Antes de iniciarmos a montagem de nossa aplicação, podemos utilizar uma ferramenta do Apex que facilitará
muito a nossa produção rápida de formulários e relatórios. Esta ferramenta é o Defaults da Interface do
Usuário, também conhecida como Defaults da UI (User Interface).
Basicamente, consiste em um conjunto de atributos visuais relativos a uma tabela ou campo. Toda vez que
criarmos um formulário ou relatório baseado em uma tabela ou campo com Defaults da UI previamente
definidos, o Apex passa a assumir que a identidade visual do campo a ser criado será aquela definida
no Defaults da UI. Caso não exista um Defaults da UI, os atributos visuais das tabelas e campos têm que ser
definidos a cada formulário ou relatório criado.
Esse é um recurso que também existe no MS Access desde suas primeiras versões, e nunca foi retirado, pois é
realmente muito útil.
10 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Com os defaults de UI criados antes da aplicação, temos uma garantia de que boa parte dos controles estéticos
e funcionais já serão gerados corretamente, com pequeno ou nenhum ajuste. Isso garante a qualidade do
sistema de forma rápida, que é o grande objetivo de se utilizar o Apex.
Você primeiro criará os defaults de interface e depois verá como alterá-los, se necessário.
Passo 2 - No exemplo que faremos vamos criar o Padrões da UI da tabela TURMA. Clique sobre a tabela e
em seguida na aba Padrões da UI em destaque na imagem.
11 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 3 - Agora veremos a tela seguinte, que informa que a tabela escolhida não possui Defaults da UI e
pergunta se nós desejamos criá-lo. Para isso clicamos no botão Criar Padrões.
Passo 4 - Quando clicamos no botão Criar Padrões, veremos a tela abaixo. Nesta tela definimos os nomes de
exibição dos títulos de uma região form ou relatório, além de podermos clicar nos links dos nomes das
12 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
colunas, podendo assim editar todos os atributos visuais daquela coluna.
Clique em Editar Padrões de Tabela.
Altere o Título da Região do Form para "Cadastro das Turmas" e o Título da Região de Relatório para "Lista
das Turmas". Em seguida clique em Aplicar Alterações.
13 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
14 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 6 – Após recebermos a mensagem que as alterações foram salvas com sucesso, escolha o
campo DESCRICAO e faça as alterações dos Padrões Gerais abaixo, mudando o seu Label e Texto de Ajuda.
Passo 7 – Dentro da aba "Padrões de Form", vamos deixar como na imagem abaixo:
Passo 8 – Dentro da aba "Padrões do Form Tabular e Relatório", mude o "Exibir Como" e depois clique em
Aplicar Alterações. Iremos explorar mais sobre esse modo de exibição no tópico 7.1 - Boas Práticas.
15 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 9 – Modifique as demais colunas da tabela para ficar igual à imagem abaixo.
Passo 10 – Perceba que o campo "COD" está marcado como "Exibir no Form". Vamos alterar para que ele
seja exibido apenas no Relatório. Clique em "COD" e dentro de Padrões de Form, altere o Visualizar para
"Não", conforme a imagem abaixo. Clique em Aplicar Alterações após a mudança.
16 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 11 – O campo "IND_ESTADO" é uma lista de valores. Clique no campo "IND_ESTADO" e depois na
aba "Lista de Valores". Clique em "Criar Lista de Valores Estática".
No modal que apareceu, digite os valores estáticos da lista conforme a imagem abaixo e clique em Criar. Não
se esqueça de seguir o que está especificado no DGA Minha Escola!
17 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Após clicar no botão Criar, a tela abaixo irá aparecer. Basta clicar em "Cancelar" para voltar à edição dos
padrões da tabela Turma.
18 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Coluna Atributo/Valor
19 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Matrícula Aberta 10
Em Andamento 20
Encerrada 30
Agora faça os Padrões da UI das demais tabelas. Siga abaixo os padrões dos campos de cada uma.
Tabela ALUNO
Título da Região do Form: Cadastro de Alunos
Título da Região de Relatório: Lista de Alunos
Coluna Atributo/Valor
20 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Masculino M
Feminino F
Tabela PROFESSOR
Título da Região do Form: Cadastro de Professores
Título da Região de Relatório: Lista de Professores
Coluna Atributo/Valor
21 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Básico 10
Médio 20
Superior 30
Pós-graduado 40
Doutorado 50
Tabela PARTICIPANTE_TURMA
Título da Região do Form: Cadastro de Participantes da Turma
Título da Região de Relatório: Lista de Participantes da Turma
Coluna Atributo/Valor
22 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Tabela PAGAMENTO
Título da Região do Form: Cadastro de Pagamentos
Título da Região de Relatório: Lista de Pagamentos
Coluna Atributo/Valor
23 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Tabela PROFESSOR_TURMA
Título da Região do Form: Cadastro de Professores na Turma
Título da Região de Relatório: Lista de Professores na Turma
Coluna Atributo/Valor
Com todos esses preparativos, sua infraestrutura está pronta para a aplicação Apex!
24 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Siga os passos abaixo para você mesmo criar boa parte do sistema MinhaEscola. Não se esqueça de ler as
explicações adicionais.
Passo 1 – Para iniciarmos, vamos clicar em na aba Application Builder.
Passo 2 – Agora seguiremos o wizard de criação de aplicação do APEX. Clique em Área de Trabalho.
25 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 4 – Aqui é o coração da nossa nova aplicação. Neste ponto, criaremos as páginas dos mais diversos
tipos e a hierarquia das mesmas no nosso sistema. Toda essa hierarquia idealmente já foi pensada antes de
chegarmos aqui.
26 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Clique em Adicionar Página. No modal que foi aberto, selecione o tipo de página como "Em Branco" e o
nome da página será "Turma com Vagas", confome imagem abaixo.
27 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 5 – Agora com a página inicial já criada, iremos adicionar o restante das páginas. Nossa segunda
página será a página de alunos. Para criá-la, clique novamente no botão Adicionar Página. No modal que
abriu, marque a opção Relatório e Form, defina a Página Mãe “Turmas com vagas (1)”, selecione o Nome da
Tabela como “ALUNO” deixando o Tipo de Relatório como “Interativo” e o Modo da Página do Formulário
como Normal. Clique em Adicionar Página. Veremos o porquê dessas escolhas no próximo item desta lição.
Confira na imagem abaixo como ficará as suas opções.
Passo 6 – Repetiremos o passo 5 apenas trocando apenas o Nome da tabela de ALUNO para PROFESSOR e
28 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
em seguida para TURMA.
Passo 7 – Na nossa última página a ser adicionada, iremos criar outro Relatório e Form, porém o tipo de
relatório será clássico. Clique em Adicionar Página e defina a Página Mãe como "Turma com Vagas (1)",
Nome da Tabela como "PROFESSOR_TURMA", Tipo de Relatório como "Clássico" e Modo da Página do
Formulário como "Normal". Confirma na imagem abaixo se as suas opções estão corretas e clique em
29 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Adicionar Página.
Passo 8 – A nossa lista de páginas deverá estar conforme a imagem abaixo. Se tudo estiver correto, clique em
Próximo.
Passo 10 – Não possuímos nenhum componente que precise ser copiado de outra aplicação, deixando a
opção Copiar Componentes Compartilhados de Outra Aplicação como NÃO e clicaremos em Próximo.
30 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 11 – Uma parte importante da nossa aplicação é quanto à sua segurança. Sempre devemos deixar
o Esquema de Autenticação como Contas do Application Express. Isso exigirá que o usuário seja um
desenvolvedor no Apex, evitando que qualquer um possa alterar seus dados sem ser identificado. Outros tipos
de autenticação, só na versão de produção.
Para nossa aplicação exibir todas as mensagens em português, marcaremos o campo Idioma como “Português
(Brasil) (pt-br)”, Preferência de Idioma do Usuário Derivada de "Idioma Principal da Aplicação" e o Formato
de Data como “dd/mm/yyyy” (ex: 30/01/1979). Com essas informações definidas, podemos clicar
em Próximo.
31 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Se você caprichou até agora, poderá ver todos os principais formulários e relatórios que compõem nossa
aplicação, sem que fosse necessário escrever uma linha de código sequer!
32 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Para facilitar o entendimento do que foi criado na lição anterior, é necessário que algumas tabelas já possuam
alguns dados. Foi feito um script que irá popular as tabelas ALUNO e PROFESSOR, tornando mais claro o
funcionamento dos relatórios.
Depois desta carga veremos os tipos de páginas que foram criadas.
Se você quiser deixar bem claro aos desenvolvedores que a sua aplicação MinhaEscola está em
desenvolvimento, siga os passos seguintes:
1. Acesse o Application Builder > selecione sua aplicação > Componentes Compartilhados.
2. Vá em Lógica da Aplicação > Atributos de Definição da Aplicação e procure acesse Notificação Global
conforme imagem abaixo.
Com esse campo preenchido, teremos em todas as telas da aplicação a mensagem digitada. No momento da
migração para a produção, lembre-se de removê-la. Para não lhe sobrecarregar de informações na tela, não
criamos a notificação global, mas sugerimos que você o faça!
33 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Veremos a seguir o passo a passo para a execução da carga de dados de exemplo para facilitar explicações
posteriores. De quebra, você verá na prática como utilizar os recursos de script do Apex.
Passo 1 – Clique neste link para baixar o script e salve-o em uma pasta que seja fácil de achá-lo.
Passo 2 – Dentro do Apex, clique em SQL Workshop, dentro dele clique em Scripts SQL.
Passo 3 - Na tela acima clique no botão Fazer Upload . Irá aparecer à tela abaixo onde devemos clicar no
botão Procurar, localizaremos o script salvo anteriormente e selecionaremos. Como o campo Nome do Script
é de preenchimento opcional, podemos diretamente clicar no botão Fazer Upload.
Passo 4 – Após o upload o Apex irá exibir a tela abaixo, mostrando que ao se clicar sobre o script poderemos
executá-lo, editá-lo ou excluí-lo.
34 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Passo 5 – Após clicarmos no lápis para editar o script, nos será exibido o código do mesmo, para
confirmamos as instruções SQL que serão executadas. Clique no botão Executar.
Passo 6 – Veremos então a tela de confirmação. Basta então clicarmos novamente no botão Executar Agora
para confirmamos a execução do script. Após esta confirmação, o script será executado.
35 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Nesta tela, veremos que o script foi executado corretamente, com o status "Concluído".
Para vermos o que foi inserido, podemos clicar na aba SQL Workshop e, em seguida, no ícone Browser de
Objetos (para lembrar, Capítulo 1, tópico 1.2.2, item d. SQL Workshop). Dentro do Browse de Objetos,
clicamos na tabela ALUNO e em seguida na aba Dados.
36 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
37 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Clicando na aba Application Builder, veremos todas as aplicações criadas até o momento e escolhendo
aplicação Minha Escola v1 veremos a tela mostrada abaixo. O número que precede a aplicação (neste caso,
42274) é o ID da aplicação que deve ser único dentro do Apex.
Na imagem abaixo, vemos alguns ícones diferentes entre os diversos formulários e relatórios que criamos.
Normalmente possui o id de página 1, por normalmente ser a primeira página criada e sempre será a primeira
página a ser mostrada no momento em que a aplicação for executada, após o Log-in.
38 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
39 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
40 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Diferente do relatório interativo, este não apresenta a barra de pesquisa, limitando a interatividade do usuário
com os dados. Usado quando o relatório possui um padrão, um conjunto de colunas pré-definidos, com uma
certa ordem, fonte ou filtro, não podendo ser alterado pelo usuário sob pena de ferir alguma regra de negócio.
41 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
Provavelmente sua tabela será um pouco diferente dessa, contendo apenas códigos. Para modificá-la acesse o
Designer de Página clicando na página desejada.
Gerada automaticamente na criação da aplicação, esta tela é responsável pela autenticação dos usuários no
sistema e por padrão o id dela é 101.
42 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
43 of 44 03/05/2019 13:18
Criando o Sistema Minha Escola https://contas.tcu.gov.br/ead/mod/book/tool/print/index.php?id=30921
44 of 44 03/05/2019 13:18