Guião para criar aplicações simples em APEX (parte I) Guide to create simple Apex applications (part I)

Transcrição

1 Guião para criar aplicações simples em APEX (parte I) Guide to create simple Apex applications (part I) O guião que se segue usará uma base de dados que decorre do seguinte DER: The following script will use a database from the following DER: Ao qual correpondem as seguintes tabelas: Corresponding to the following tables:

2 Socio=(num_socio, nome_socio, bi_socio,data_nsc_socio, morada_socio, tlf_socio, sexo_socio) Genero=(cod_genero, nome_genero) Editora=(cod_editora, nome_editora) Actor=(cod_actor, nome_actor) Realizador=(cod_realizador, nome_realizador) Filme=(cod_filme, nome_filme, ano_filme, preço_dia_filme, dias_sem_multa_filme, multa_dia_filme, cod_genero, cod_editora) Filme_actor=(cod_filme,cod_actor) Filme_realizador=(cod_filme,cod_realizador) Copia=(cod_filme,num_copia) Aluguer=(cod_filme,num_copia,data_aluguer, num_socio, data_prev_dev_aluguer) Devolucao=(cod_filme, num_copia, data_aluguer, num_socio, data_devolucao, estado_devolucao) Estão também disponíveis sequências que foram criadas com os seguintes comandos SQL: Also available are sequences that were created with the following SQL commands: create sequence seq_socio increment by 1 start with 1; create sequence seq_genero increment by 1 start with 1; create sequence seq_editora increment by 1 start with 1; create sequence seq_filme increment by 1 start with 1; create sequence seq_actor increment by 1 start with 1; create sequence seq_realizador increment by 1 start with 1; So, enter you workspace, user and password in the oracle apex site and ater creating the tabels bove, in Sqlworkshop environment, click on App Builder and you will see:

3 Uma aplicação Apex assenta numa coleção de páginas ligadas usando tabs, buttons e links hypertext. An Apex application lies on a collection of linked pages using tabs, buttons and hypertext links. Clique em Create / Click on Create.

4 Escolha / choose New Application Give a name to your application (here is VideoClube). A blank (Home) page will be created to be a menu. Click Add Page.

5 Selecione Report / select Report Basicamente, uma página do tipo Report serve para mostrar conteúdos de tabelas, views ou resultados de queries; nesta página não é permitido alterar dados da base de dados. Basically, a Report page is used to display table contents, views, or query results; on this page it is not allowed to change data from the database. Now give a name to the report (Editora), chhose interactive Report, choose table editora and click add page.

6 Then click Create Application. Now click run application Enter user and password

7 Clike on the blue square and you will see the table content. You may now click on actions and filter to obtain answers to specific queries, for ex:

8 Which will give the following result Criação de um report sobre junção de tabelas

9 Building a report on a join of tables. Clique em Application nnn e Create page/ Click on Application nnn and Create page Now choose Report

10 and then choose Inteactive Report Now give a name (Filme) to the page. Choose table Filme and choose breadcrumb to indicate that you want to connect to other pages from this one. Then connect to page Home and Click Next.

11 Then include all attributes of the table to be viewed in the report, like the next picture After cliking Next, you will see

12 Then run the page by ckicking the blue arrow. You can hide the cod Filme attribute you you want.for that, click on Action, move that attribute to the left, and click Apply like this;

13 Assim, este é o resultado do SQL interno que é guiado pelo conjunto de atributos na tabela Filme. Para além dos outros atributos, são mostrados os códigos de editora e de género, que são valores núméricos que não permitem uma leitura digamos natural e imediata como a que se conseguiria se em vez deles, estivessem os nomes da editora e do género, respetivamente. Em face desta contingência, vamos contornar o problema. Clique em Edit Page n (o número desta última página). Thus, this is the result of the internal SQL that is guided by the set of attributes in table Filme, which shows in addition to the other attributes, the editora and género codes, which are numeric values that do not allow a reading to say "natural and immediate" as that would be obtained if the names of the editora and the género were present, instead of the codes. In face of this contingency, we will work around the problem. Click Edit Page n (the number of this last page)

14 Agora, na zona Content Body, clique em Filme e verá à direita o código SQL (na zona source, Sql query) que gerou a leitura do conteúdo da tabela Filme. Para aceder a uma janela de edição, clique no quadrado indicado pela seta vermelha. Now, in the zone Content Body, click on Filme and you will see the SQL code (next to the source zone, Sql query) that showed the table Filme content. To acess to an edition window, click on the square pointed by the red arrow. And then

15 Agora substitua aquele código SQL pelo seguinte, cuja alteração usa no report do Filme os nomes da editora e do género em vez dos respetivos códigos que são de leitura, à partida, não entendível. Now replace that SQL code with the following, which uses in the Filme report, the names of the editora and the género instead of their codes that are not easily readable. select nome_filme as nome,ano_filme as ano,preco_dia_filme as "preco dia",dias_sem_multa_filme as "dias sem multa",multa_dia_filme as "multa dia",nome_genero as genero,nome_editora as editorafrom filme natural inner join editora natural inner join genero

16 Quando não hover erros, corra a página para ver este resultado onde os códigos e os nomes dos atritutos foram visualmente substituídos por forma a permitir uma compreensão plena. When there are no errors, run the page to see this result where the codes and names of the attributes have been visually replaced in order to allow a full understanding.

17 Criar uma página Form para inserir e modificar dados Create a Form page to insert and modify data Clicar em Application nnn e Create Page / Click Application nnn and Create Page Click on Form Escolha Report with Form on Table / choose Report with Form on Table

18 Dê nomes ao Report e ao Form, e dê indicação de que quer que haja uma entrada no menú em Home para estas páginas, como indicado acima Name the Report and the Form, and indicate that you want an entry in the Home menu for these pages, as indicated above. And

19 Na janela seguinte escolha a tabela sobre a qual vai incidir este Report; neste caso é socio. Depois clique em Next. In the next window choose the table on which this report will focus; in this case it is socio. Then click Next. Agora, tal como se mostra no quadro seguinte, escolha select Primary Key Columns, carregue em >> para incluir no forms todas os atributos da tabela, aceite NUM_SOCIO como chave e escolha Existing sequence como forma de gerar um novo número para cada futuro novo tuplo na tabela socio. Depois faça Create. Now, as it is shown next, choose "select Primary Key Columns", click on >> to include all attributes of the table in the form, accept NUM_SOCIO as the key. Then click Create.

20 De seguida, é preciso tornar o attributo num_socio visível ja que, por ser primary key neste form, fiva invisível. Para tal, na última página criada (a página do form) clique em Create depois no item num_socio e depois substitua a característica hidden por number field para este attributo (num_socio), como mostram as setas vermelhas na figura seguinte: Next, you have to make the num_socio attribute a visible one because since it is primary key in this invisible form it was hidden by the APEX. To do this, on the last created page (the form page), click Create on the item num_socio, and then replace the hidden feature with number field for this attribute (num_socio), as shown by the red arrows in the following figure:

21 Na característica Label podemos escrever num_socio. Depois é preciso preencher o attributo num_socio com um valor automaticamente gerado pela sequência seq_socio. Para tal, na zona Processing, clique em Process form... e, na zona Settings à direita, troque a indicação Region Source para PL/SQL code como mostram aas setas na figura. Then you need to populate the attribute num_socio with a value automatically generated by the seq_socio sequence. To do this, in the Processing zone, click Process form... and, in the Settings area on the right, change the Region Source indication to PL / SQL code as shown by the arrows in the figure. Depois abrir-se-á uma janela onde se deve escrever o seguinte programa em PL/SQL: Then a window will open where the following PL / SQL program should be written: BEGIN IF :P20_NUM_SOCIO is NULL then select seq_socio.nextval into :P20_NUM_SOCIO from sys.dual; end if; end;

22 %NOTA: devido ao facto deste guião ter sido feito ao longo do tempo, o número da página do forms surge por vezes com o nº 18 (:P18) ou com o número 20 (:P20) com é no caso presente. % NOTE: Due to the fact that this script has been made over time, the page number of the forms sometimes appears with the number 18 (: P18) or with the number 20 (: P20) with is in the present case. Quando não houver mais erros sintáticos, corra a página. When there are no more syntactic errors, run the page.

23 Preencha valores e clique em create e verá o resultado: Fill in values and click on create and you will see the result: Joaquim Francisco Ferreira da Silva Maio de 2019