92370658 Genexus x Quick Start Pt

7/31/2019 92370658 Genexus x Quick Start Pt

1/63

GeneXus X : Quick StartOutubro 2011


2/63

GeneXus X: Quick

Pg

Copyright ARTech Consultores S. R. L. 1988-2011.

Todos os direitos reservados. Fica totalmente proibida a reproduo deste documento, por qualquer meio, semautorizao expressa da Artech Consultores SRL. A informao contida neste documento exclusivamente parauso pessoal.

Marcas Registradas

Artech e Genexus so marcas ou marcas registradas da Artech Consultores SRL. Todas as outras marcas citadasneste trabalho pertencem a seus respectivos donos.


3/63

GeneXus X: Quick

Pg

Introduo .............................................................................................................................................. 3 GeneXus Trial Version ............................................................................................................................. 3 Restries Funcionais .............................................................................................................................. 3 Restries de Licena .............................................................................................................................. 3 License Agreement ................................................................................................................................. 3 Suporte Tcnico ...................................................................................................................................... 4

Instalao e Autorizao ........................... .......................... ........................... .......................... ............... 4 Requerimentos de Instalao ................................................................................................................... 4 Requerimentos do Gerador .NET ............................................................................................................... 5 Autorizao ............................................................................................................................................ 6

PRIMEIROS PASSOS: Tutorial passo a passo ....................... ........................... .......................... ............... 8 Simbologia utilizada ................................................................................................................................ 8

PARTE 1: Descobrindo o GeneXus ........................................................................................................... 9 O que o GeneXus? ................................................................................................................................ 9

PARTE 2: Sua primeira aplicao ............................ ........................... ........................... ......................... 10 Desenho de aplicaes baseado no conhecimento ..................................................................................... 10

Passo 0: Caso de estudo .................................................................................................................... 10 Passo 1: Entorno de desenvolvimento .................................................................................................. 11 Passo 2: Criao de uma Base de Conhecimento e definio do Environment ............................................ 11 Passo 3: Criao de um Objeto Transao ............................................................................................ 13 Passo 4: Descrio da Estrutura da Transao (Structure) ...................................................................... 14 Passo 5: Definio do Campos Calculados Frmulas ........................................................................... 18 Passo 6: Visualizao do Modelo de Dados inferido pelo GeneXus ............................................................ 19 Passo 7: Visualizao dos Formulrios do Objeto Transao.................................................................... 21 Passo 8: Execuo de sua Aplicao .................................................................................................... 23 Passo 9: Teste de sua Aplicao .......................................................................................................... 25 Passo 10: Adicionar Regras do Negcio Regras .................................................................................. 26 Passo 11: Criao do Objeto Transao Cliente ..................................................................................... 28 Passo 12: Reviso das Mudanas efetuadas ao Modelo de Dados ............................................................. 30 Passo 13: Visualizao do Reporte de Especificao ............................................................................... 32 Passo 14: Criao dos Formulrios Atraentes Temas .......................................................................... 34

PARTE 3: Manuteno ........................................................................................................................... 35 Desenvolvimento Incremental e Manuteno da Aplicao ......................................................................... 35

Passo 15: Incluso de Novos Objetos: Transao Produto ...................................................................... 35 Passo 16: Anlise e reorganizao da BD ............................................................................................. 37

PARTE 4: Adicionando funcionalidade .............................................. ............................ ......................... 39 Utilizao de Padres no desenvolvimento ............................................................................................... 39

Passo 17: Aplicar um pattern .............................................................................................................. 39 PARTE 5: Dilogos interativos ............................................................................................................... 41

Desenho de Consultas e Dilogos Interativos (Web Panels) ........................................................................ 41 Passo 18: Criao de um Web Panel: Nota fiscal por cliente. ................................................................... 41 Passo 19: Execuo do Web Panel modificando a instncia do Pattern ..................................................... 44

PARTE 6: Enriquecendo a aplicao ........................ .......................... ............................ ......................... 47 Controles de usurios ............................................................................................................................ 47

Passo 20: Implementao de um User Control ...................................................................................... 47 PARTE 7: Procedimentos ....................................................................................................................... 50

Desenho de Processos No Interativos (Procedimentos) ............................................................................ 50

Passo 21: Implementao de um Procedimento para impresso .............................................................. 51 Passo 22: Implementao de um Procedimento para atualizao............................................................. 55 PARTE 8: Multiplataforma ..................................................................................................................... 57

Desenvolvimento Multiplataforma ........................................................................................................... 57 Resumo ................................................................................................................................................. 58 FAQ ....................................................................................................................................................... 59 Contatos e Recursos ......................... .......................... ........................... .......................... ...................... 62

A Comunidade GeneXus ........................................................................................................................ 62 Suporte ............................................................................................................................................... 62 Como Comprar ..................................................................................................................................... 62

Links recomendados.............................................................................................................................. 62


4/63

GeneXus X: Quick

Pg

IntroduoO objetivo deste documento ajud-lo a descobrir o potencial da metodologia de desenvolvimentobaseada no conhecimento proposta pelo GeneXus atravs de suas principais funcionalidades:

Desenho automtico de modelo de dados Gerao automtica de cdigo Manuteno automtica de base de dados e cdigo Desenvolvimento e instalao multiplataforma

GeneXus Trial VersionRestries FuncionaisA GeneXus Trial Version completamente funcional e o gerador disponvel (.NET) autorizadomediante uma nica Site Key (com validade at 60 dias aps sua ativao). Entretanto, aplicam-sealgumas restries a respeito do nmero mximo de objetos e atributos GeneXus que possvel criarpara uma Base de Conhecimento dada:

90 atributos 140 objetos.

Restries de LicenaA GeneXus Trial Version destina-se exclusivamente para avaliao e capacitao. Sua instalao local e para um nico usurio.

License Agreement Condies de Uso da Licena de Propriedade Intelectual GeneXus X Trial Version

1. O presente acordo se refere licena da propriedade intelectual de exemplares da GeneXus X Trial Version,criao inteligente baseada em conhecimento, que desenha, gera e mantm automaticamente bases de dados eaplicaes.2. Artech Consultores S.R.L. (doravante Artech) declara e o USURIO reconhece que a criao intelectualGeneXus , assim como os nomes e logotipos GeneXus, GXflow, GXplorer, GXportal, GXquery e Artech como

qualquer outra marca comercial (trademark) que introduzir a Artech em conexo com o GeneXus ,independentemente do fato de estarem registrados ou no, so propriedade da Artech. Este convnio no implicadireta nem indiretamente transferncia alguma dessa propriedade e no habilita o USURIO a transferir aslicenas objeto do presente documento.3. O USURIO compromete-se a utilizar a GeneXus X Trial Version sem divulgar nem usar em proveito prprionenhuma das idias e tcnicas que fazem possvel GeneXus . Em particular, obriga-se a no usar procedimentos deengenharia inversa para interpretar seu cdigo, nem a facilitar a outrem a faz-lo.4. Em hiptese nenhuma o USURIO poder duplicar ou desativar os mecanismos de proteo contra uso noautorizado do GeneXus. A Artech reserva-se o direito de mudar a qualquer momento estes mecanismos e/ouadicionar outros novos.5. Observando as bases gerais, a Artech licencia ao USURIO a ferramenta GeneXus X Trial Version , nosseguintes termos e condies:


5/63

GeneXus X: Quick

Pg

a) Cada exemplar licenciado poder funcionar em um microcomputador por separado. O USURIO compromete-se a no utilizar nenhum deles em mais de um microcomputador simultaneamente.b) A licena no exclusiva e intransfervel. Os programas gerados pela GeneXus X Trial Version no poderoser utilizados com fins comerciais.c) O USURIO utilizar os programas e documentao do GeneXus para seu uso exclusivo, com fins deavaliao exclusivamente e comprometendo-se a no entregar cpias de nenhum deles a terceiros.d) No existe responsabilidade alguma, implcita ou explcita, para a Artech, sobre eventuais prejuzos quepuderem resultar para usurios em relao, direta ou indireta, com o uso da GeneXus X Trial Version.e) O USURIO compromete-se a utilizar a licena, seguindo as instrues e especificaes constantes domaterial associado ao mesmo.f) proibido qualquer uso comercial da GeneXus X Trial Version, em forma parcial ou completa. Para

desenvolver esse tipo de aplicaes, dever contratar a verso comercializvel.g) A verso GeneXus X Trial ser ativada por 60 dias. Inclui unicamente o gerador .NET e suporta SQL comobase de dados. Permite criar um mximo de 90 atributos e 140 objetos.

6. A instalao do produto de software licenciado implica a aceitao dos termos que antecedem.

Suporte TcnicoSe precisar ajuda para a instalao e autorizao de sua verso trial, entre em contato com:[email protected]

Se estiver nos Estados Unidos ou no Canad poder enviar consultas de suporte a:[email protected]

Para saber mais sobre os diversos servios e recursos de suporte tcnico e capacitao do GeneXusvisite: http://www.genexus.com/support e http://www.genexus.com/training

Por informao adicional, entre em contato com seu distribuidor local:

http://www.genexus.com/distributors ou escreva-nos a [email protected]

Instalao e Autorizao Requerimentos de InstalaoA GeneXus Trial Version inclui os seguintes produtos:

Modelador GeneXus um ambiente integrado de desenvolvimento (Integrated Development Environment ou IDE) parao desenho, desenvolvimento, e manuteno de aplicaes de negcios, independentemente daplataforma de produo utilizada.

Geradores GeneXusGeneXus gera cdigo nativo para as principais plataformas do mercado. Para conhecer a listacompleta dos Geradores GeneXus visite: http://www.genexus.com/technologies . O geradordisponvel na GeneXus Trial Version o Gerador .NET.
mailto:[email protected]:[email protected]:[email protected]:[email protected]://www.genexus.com/supporthttp://www.genexus.com/supporthttp://www.genexus.com/supporthttp://www.genexus.com/traininghttp://www.genexus.com/traininghttp://www.genexus.com/traininghttp://www.genexus.com/distributorshttp://www.genexus.com/distributorsmailto:[email protected]:[email protected]:[email protected]://www.genexus.com/technologieshttp://www.genexus.com/technologieshttp://www.genexus.com/technologiesmailto:[email protected]://www.genexus.com/distributorshttp://www.genexus.com/traininghttp://www.genexus.com/supportmailto:[email protected]:[email protected]


6/63

GeneXus X: Quick

Pg

A seguir encontrar a lista do hardware e software necessrio para executar GeneXus e as aplicaesgeradas pelo GeneXus.

Requerimentos deHardware

Processador: mnimo 1 GHz (recomendado multi core)

Memria: mnimo 1 GB de RAM (recomendado 2 GB)

Disco rgido: Mnimo de 300 MB de espao em disco para a instalao.

Para criar aplicaes GeneXus precisa-se espao adicional ou um discocompartilhado para criar as Bases de Conhecimento e o cdigo gerado.

Requerimentos deSoftware Microsoft Windows 2000, XP SP2, ou superior

Microsoft .NET Framework 3.5 SP1 ou superior

Microsoft Internet Explorer 6.0 SP1 ou superior

Microsoft SQL Server 2005 ou 2008 (Express, Standard ou qualquer outraEdio) 1

1 Microsoft SQL Server Express Edition a verso redistribuvel e gratuita.

Requerimentos do Gerador .NET

Esta seo contm os requerimentos para gerar e executar aplicaes com o Gerador GeneXusdisponvel na GeneXus Trial Version.

Gerador Requerimentos

.NET Microsoft .NET Framework 2.0 ou superior IIS 5.0 ou superior (disponvel no Windows 2000 ou XP) Fornecedor do ADO .NET para o DBMS utilizado

Para criar a base de dados de sua aplicao e executar as aplicaes geradas, requerer um dos

seguintes DBMS: SQL Server (Em qualquer de suas edies). Sim a primeira vez que instala SQL, creara-

se aut omaticamente uma Base de dados com o usuario sa e a clave genexustrial


7/63

GeneXus X: Quick

Pg

Autorizao1. Execute o arquivo de setup da GeneXus Trial Version (genexusxtrial.exe) do menu de Incio do

Windows ou selecionando a opo apropriada no CD de sua Verso Trial.

Figura: Assistente de Instalao da GeneXus X Trial Version

2. Siga os passos indicados pelo setup de instalao.3. A primeira vez que usar a GeneXus Trial Verso dever autorizar o produto para poder inici-lo.

A autorizao pode ser feita Online ou By Mail. A autorizao online recomendada se tiver umaconexo a Internet.

Figura: Dialog box para o Registro da GeneXus Trial Version


8/63

GeneXus X: Quick

Pg

4. Complete os campos solicitados: Nome, email e pas so obrigatrios enquanto que Companhia eTelefone so opcionais.

5. Em caso de ter requerido a opo Online e de ter ingressado os dados corretamente, a GeneXusX Trial Version ir se ativar em forma imediata por um perodo de 60 dias.

6. Se tiver escolhido a opo By Mail, GeneXus pedir inserir Nome e pas em forma obrigatria. Oscampos Telefone e Companhia so opcionais. Dever confirmar os dados inseridos. Se os mesmosforem corretos pressione CONTINUAR. Se desejar modificar os valores inseridos pressioneANTERIOR. Esta ativao exige ter o Outlook configurado como email padro. O administrador delicenas gerar um mail com o Site Code correspondente. Voc receber seu Site Key via mail.

7. Se o Outlook no for seu email padro, pode solicitar ativao Manual , enviando de qualqueremail os dados gerados pelo ativador de licenas. O Site Key de ativao ser enviada ao mesmoemail. Copie e cole seu Site Key no campo de Site Key da janela Authorization Required e cliqueem Continuar .

8. Voc j est preparado para comear a usar sua GeneXus Trial Version!

9. Se precisar de ajuda para ativar a GeneXus X Trial Version escreva-nos a [email protected].
mailto:[email protected]:[email protected]:[email protected]:[email protected]


9/63

GeneXus X: Quick

Pg

PRIMEIROS PASSOS: Tutorial passo a passoO objetivo deste tutorial lhe oferecer uma primeira experincia prtica com o GeneXus medida quefor aprendendo os fundamentos da Metodologia GeneXus. Ao finalizar, voc saber como possvelcriar aplicaes de negcios complexas com uma rapidez jamais imaginada.

Neste exerccio passo a passo voc criar uma aplicao de negcios simples para instalar em umadas plataformas suportadas pela GeneXus Trial Version: .NET. Para conhecer a lista completa deplataformas suportadas pelo GeneXus visite: http://www.genexus.com/technologies/

medida que for trabalhando com este guia, usar as funcionalidades chaves do GeneXus: Desenho de aplicaes baseado no conhecimento Gerao inteligente de base de dados Gerao automtica de cdigo Aplicaes completamente funcionais Desenvolvimento incremental e manuteno automtica da aplicao Desenho de Processos no interativos (Procedimentos) Desenvolvimento em mltiplas plataformas

Simbologia utilizada

! Este smbolo introduz um conceito chave para o desenvolvimento do tutorial .

Este smbolo introduz um TIP. Recomendamos ler o que este dentro do quadro .

Este smbolo especifica o tempo requerido.

Este smbolo introduz uma NOTA.
http://www.genexus.com/technologies/http://www.genexus.com/technologies/http://www.genexus.com/technologies/http://www.genexus.com/technologies/


10/63

GeneXus X: Quick

Pg

PARTE 1: Descobrindo o GeneXus

Tempo estimado: 5 minutos

O que o GeneXus? Basicamente, o GeneXus um programa que faz programas.

uma ferramenta que parte das vises de usurios, e a partir da encapsula o conhecimento no quechamaremos Base de Conhecimento . GeneXus sistematiza esse conhecimento, e da automatiza odesenho, construo e manuteno da BD e dos programas.

! Resumindo, o GeneXus uma ferramenta baseada no conhecimento que desenha ,gera e mantm em forma automtica os programas e a base de dados para obter odesenvolvimento rpido de aplicaes crticas em mltiplas plataformas.


11/63

GeneXus X: Quick

Pgin

PARTE 2: Sua primeira aplicaoTempo estimado: 1:40

Desenho de aplicaes baseado no conhecimento Nesta seo aprender a criar uma Base de Conhecimento GeneXus e a desenhar uma aplicao embase aos requerimentos dos usurios. Neste caso em particular, comearemos por desenhar umanota fiscal e outros componentes necessrios em um Sistema de Gesto de Vendas.

!

Analistas de Negcios versus Desenvolvedores Entender as necessidades do usurio final uma das poucas tarefas que no se podemautomatizar no desenvolvimento de software. Referimo-nos aos desenvolvedores doGeneXus como analistas de negcios em lugar de programadores, codificadores oudesenvolvedores.

!

Programar versus declarar a aplicaoA Metodologia GeneXus baseia-se na descrio das entidades do usurio final (objetosreais, tanto tangveis quanto intangveis) com as que sua aplicao deve lidar. Isto sefaz descrevendo as vises dos usurios finais sobre estas entidades, com alto nvel deabstrao. Por este motivo, realizaremos uma programao declarativa e osanalistas de negcios descrevero a realidade para que o GeneXus crie o modelo dedados em uma BD especificada e construa os programas de aplicao para cobrir asnecessidades funcionais requeridas. Quando essa realidade mudar, os analistas denegcios simplesmente devero descrever a nova realidade e ser GeneXus quem seencarregar de realizar as mudanas necessrias no modelo de dados e os programaspara representar a nova realidade descrita .

Passo 0: Caso de estudoSuponhamos que uma empresa precisa uma aplicao que gerencie seu sistema de faturamento. Hojeno conta com um e o faturamento feito manualmente, com os grandes catlogos de cdigos deprodutos. Trabalharemos com as notas fiscais, os clientes, os produtos ao tempo que iremosintroduzindo os fundamentos dos conceitos bsicos da metodologia do GeneXus.

Durante este tutorial, conseguir descrever a realidade apresentada no GeneXus para gerar um casotipo de sistema de faturamento em uma plataforma Web utilizando o Gerador .NET e BD SQL.


12/63

GeneXus X: Quick

Pgin

Passo 1: Entorno de desenvolvimento

Uma vez aberto o GeneXus, descobrir uma interface como na imagem anexa. Esta interface recebe onome da IDE (Integrated Development Environment ou Ambiente integrado de Desenvolvimento). um IDE intuitivo, simples e parametrizvel por cada desenvolvedor.

Divide-se em janelas:

Figura: Ambiente integrado de Desenvolvimento (IDE)

Janela principal: Est composta pela Start Page ou Pgina de Incio a qual, atravs de umRSS em forma dinmica, oferece informao tcnica relacionada com a ferramenta e acomunidade de usurios. Para obter esta informao necessrio estar conectado. Se suaequipe estiver desligada da Internet no poder acessar as novidades publicadas noGeneXus Community.

Janela de ferramentas

Barras de ferramentas

Passo 2: Criao de uma Base de Conhecimento e definio do Environment

O primeiro passo para criar uma aplicao com o GeneXus criar uma Base de Conhecimento e definiro ambiente de trabalho.

! Base de Conhecimento ou Knowledge Base (KB) um repositrio que contm toda a informao necessria para gerar uma aplicao emmltiplas plataformas. Em outras palavras, um repositrio de toda a descrio darealidade .


13/63

GeneXus X: Quick

Pgin

!

EnvironmentPara gerar e manter uma aplicao de trabalho em uma plataforma de softwareespecfica, devemos definir um Environment . Um Environment integra todo orelacionado plataforma de execuo (Gerador, acesso a BD, interface de usurio eoutras propriedades da plataforma). Para isto, especificamos um DBMS, uma linguagemalvo e alguns parmetros adicionais por cada Environment. GeneXus gerar e manter oesquema da base de dados e todos os programas na plataforma selecionada. Destamaneira, o analista do GeneXus no precisa ter um conhecimento profundo daplataforma alvo.

Se for a primeira vez que abre a GeneXus Trial e no executou previamente em sua equipe umaverso comercial do produto, GeneXus lhe indicar que proceder a executar a criao de uma basede conhecimento em forma automtica. A primeira vez que abrir a verso trial automaticamente ir secriar uma Base de Conhecimentos em um ambiente em .NET com o SQL.

Se quiser criar uma base de conhecimento e um novo environment, dever:

1. Clicar na opo NewKnowledge Base .

2. Dar um nome Base deConhecimento: Demo.

3. Selecionar um diretrio ondecriar a KB.

4. Selecionar a linguagem agerar.

5. Clicar em CREATEparacontinuar. Figura: Dialog box para a criao de uma Base de Conhecimento


14/63

GeneXus X: Quick

Pgin

Passo 3: Criao de um Objeto Transao Nosso objetivo ser definir as vises de nossos usurios em objetos GeneXus.

!

Objeto TransaoRepresenta os objetos da realidade que dirige sua aplicao. Das transaes definidasinfere-se o modelo de dados da aplicao (3. forma normal). GeneXus tambm usa oobjeto transao para gerar o programa da aplicao que permitir ao usurio final, emforma interativa, inserir, apagar e atualizar registros na base de dados fsica.

O seguinte passo, uma vez criada a base de conhecimento ser criar a primeira transao, querepresenta uma nota fiscal. Para isso siga os seguintes passos:

1. Clique direito sobreObjects/New/Objectou v ao menuFILE/NEW OBJECT.Tambm pode criar umnovo objeto utilizando oshortcut CTRL N.

2. Selecione o tipo deobjeto que deseja criar:Transaction

3. D nome ao Objeto:Invoice .

4. Clique em CREATE.

Figura: Criao de um objeto novo

Figura: Dialog box New Object 5.


15/63

GeneXus X: Quick

Pgin

Passo 4: Descrio da Estrutura da Transao (Structure)

O prximo passo ser descrever o objeto nota fiscal definindo quais atributos integram a mesma ecomo esto relacionados.

!

Estrutura do objeto TransaoAEstrutura do Objeto Transao uma descrio dos dados requeridos paraconhecer o objeto real que este representa. Na estrutura, devemos declarar os atributos(campos) que formam a transao (os dados com os que o usurio ir interagir) e asrelaes entre eles. Baseando-se nesta estrutura, o GeneXus desenha e mantmautomaticamente a base de dados correspondente (tabelas, chaves, ndices, restriesde integridade, etc.) em 3. forma normal. O mesmo atributo dever ter sempre omesmo nome em cada lugar que aparecer. ao tempo que dois atributos diferentes no

podero ter o mesmo nome.Os elementos chaves para definir a estrutura da transao so os seguintes: Nome, tipo e descrio : Cada atributo definido por seu nome, tipo de dados

e descrio. Nveis : Os atributos agrupam-se em um ou mais nveis, e estes nveis podem

ser aninhados ou paralelos (pode haver mltiplos nveis aninhados). Porexemplo: as linhas de uma nota fiscal representam um nvel aninhado em nvelde raiz. O nvel das linhas da nota fiscal demonstra o fato de que uma nota fiscalpode ter muitas linhas, ou seja, define uma relao de uma a muitas entre anota fiscal e as linhas da nota fiscal.

Atributos de Chave Primria (PK) : Em cada nvel, um ou mais atributosdevem ser definidos como a Chave Primria do nvel.o A Chave Primria um identificador de cada instncia do nvel.o Os valores da Chave Primria so nicos e uma vez inseridos no podem ser

atualizados.o Se no existir uma Chave Primria natural para seu objeto, deve criar uma artificial; por exemplo, CustomerID.

1. Insira o nome, tipo de dado e descrio dos atributos na aba Structure da transao Invoice, comoindicado na tabela a seguir. Use a tecla TAB para mover-se entre o nome, o tipo de dado e adescrio do atributo. Use a tecla ENTER para adicionar um novo atributo.

ATRIBUTO TIPO DESCRIOInvoiceID Numeric(4.0) Invoice ID

InvoiceDate Date Invoice DateCustomerID Numeric(4.0) Customer ID

CustomerName Character(20) Customer Name

At aqui inserimos os campos do cabealho da nota fiscal. Agora iremos inseriras linhas. Para isso, pressione CTRL + Seta Direita para adicionar um Novo nvel estrutura de dados


16/63

GeneXus X: Quick

Pgin

ProductID Numeric(4.0) Product ID

ProductName Character(20) Product NameProductPrice Numeric(8.2) Product Price

LineQuantity Numeric(4.0) Line Quantity

LineTotal Numeric(8.2) Line Total

Pressione ENTER e depois CTRL+ Seta Esquerda para voltar para o nvel docabealho e comear os dados do rodap.

InvoiceSubtotal Numeric(8.2) Invoice Subtotal

InvoiceTax Numeric(8.2) Invoice Tax

InvoiceTotal Numeric(8.2) Invoice Total

Tips para aumentar sua produtividade:

Quando comear a escrever o nome de um novo atributo oprimindo a tecla ponto GeneXus escrever o nome da transao no campo de nome do atributo Use CamelCase para nomear seus atributos, de forma tal que as descries dosmesmos se infiram automaticamente e faam sentido. Ex.: Pr InvoiceTotal como nome de atributo, para que se infira automaticamente a descrio InvoiceTotal. Quando estiver posicionado no combo box de tipo de dados (Type), escreva aletra inicial do tipo de dados apropriado para selecion-lo. Se for um tipo de dadovarivel (Character, LongVarChar, Numeric ou VarChar), insira o valor apropriadoda dimenso de varivel para configur-lo.

O primeiro atributo de cada nvel definido por defeito como chave primria desse nvel, mas possvel mudar isto clicando direito sobre o atributo e escolhendo a opo Toggle Key (Ctrl+K). Osatributos de Chave Primria se identificam por uma pequena chave esquerda de seus nomes( ). Neste exemplo, InvoiceID o identificador de primeiro nvel, e o atributo ProductID oidentificador de segundo nvel. Isto significa que, para um nmero de notas fiscal dado(InvoiceID), o valor do atributo ProductID no se repetir em linhas diferentes.

2. Movendo o Mouse na rea direita da tela ir sedesdobrar o menu de propriedades(Properties).


17/63

GeneXus X: Quick

Pgin

Figura: Janela de Definio do Atributo

3. Expanda a opo Type Definition e configure apropriedade Autonumber do InvoiceID noTrue . Os programas gerados atribuiroautomaticamente um valor do InvoiceID a cadanova instncia da nota fiscal.

Figura: Propriedade Autonumber

4. Salve a nova estrutura da transao oprimindo o boto comforma de diskette ( Save ) na barra de ferramentasStandard. Se esta barra no estiver visvel, desdobre-aclicando direito sobre a barra de menu (Opo Edit)

Voc acaba de criar a estrutura de uma transao Nota Fiscalcomposta de dois nveis:

Um nvel bsico (Invoice ou Nota Fiscal), no qual seespecifica toda a informao necessria para oCabealho da Nota Fiscal.

Um nvel aninhado, no qual se especifica a informaoque se ir se repetir em cada linha de nota fiscal.

Observe que no utilizamos um nmero de linha como chaveprimria das linhas de nota fiscal. Esta uma deciso dedesenho voluntria. Usando o ID de Produto como chaveprimria das linhas da nota fiscal, estamos definindo que nohaver duas linhas na mesma nota fiscal para o mesmo produto.

Figura: Estrutura da nota fiscal

!

Universal Relationship Assumption (URA)Um elemento chave da Metodologia GeneXus a hiptese de que atributos com omesmo nome so o mesmo atributo. Isto se chama Universal Relationship Assumption(URA) e, conforme essa hiptese:

Tudo o que for conceitualmente igual deve ter o mesmo nome. Os conceitos diferentes NO devem ter o mesmo nome.


18/63

GeneXus X: Quick

Pgin

Isto nos permitir usar o mesmo atributo em outros objetos GeneXus (outrastransaes, procedimentos, reportes, etc.) simplesmente fazendo referncia a seu nome.GeneXus estabelece as relaes (chaves forneas) entre as tabelas do modelo de dadoscom base nos nomes dos atributos.

!

Nomenclatura GIK: GeneXus Incremental KnowledgeGIK uma nomenclatura padro definida pela Artech no intuito de dotar os atributos deum nome que transmita seu conceito da forma mais clara possvel. Nesta nomenclatura,o nome de um atributo est formado por 4 componentes. Alguns deles so opcionais:

Objeto + Categoria [+ Qualificador] [+ Complemento] Objeto: a entidade real descrita pelo atributo. Geralmente (mas nem sempre) o

nome da transao na qual um atributo foi definido para poder ser armazenado emuma das tabelas associadas a essa transao (isto significa que no deveria inferir-se nessa transao especfica). Exemplos: Nota Fiscal, Cliente, Produto, Linha.

Categoria: a categoria semntica do atributo. Define o papel que o atributo terdentro do objeto e no ambiente da transao. Exemplos: Identificao, Data, NotaFiscal, Descrio, etc.

O Qualificador e o Complemento so componentes opcionais. Exemplos: Incio, Fim,Mnimo, Mximo, etc.


19/63

GeneXus X: Quick

Pgin

Passo 5: Definio do Campos Calculados Frmulas

!

FrmulasSo atributos que podem se inferir do valor de outros atributos. Um atributo frmula definido da mesma forma que um atributo normal, ou seja , tem um nome, um tipo dedados e uma descrio, alm de uma frmula que define como se calcula.

Salvo especificao contrria, os atributos definidos como frmulas no soarmazenados na base de dados (so atributos virtuais ).

As frmulas so globais ; so vlidas em toda a base de conhecimento e noapenas dentro da transao na qual foram definidas. Isto significa que a frmula calculada cada vez que o atributo invocado de uma transao ou de outrosobjetos GeneXus (Reportes, Work Panels, etc.)

Variveis Definidas pelo Usurio. No podem participar de uma frmulaporque so locais em relao aos objetos nos quais foram definidas e no tmvalor fora deles.

Agora definiremos os seguintes atributos frmula:

LineTotal =ProductPrice * LineQuantityInvoiceSubTotal = SUM(LineTotal)InvoiceTaxes = InvoiceSubTotal * 0.11 (ou o nmero que corresponder)InvoiceTotal = InvoiceSubtotal + InvoiceTax

1.

Clique duplo no campo Formula do atributo LineTotal ( direita da descrio do atributo).

2. Escreva o seguinte: ProductPrice * LineQuantity . Tambm possvel clicar no boto sobre o campo dafrmula para abrir o Editor de Frmula.

3. Repita os Passos 1 e 2 para o resto das frmulas que aparecem na lista no incio desta seo.

4. Clique Save para salvar as novas frmulas.


20/63

GeneXus X: Quick

Pgin

Ao finalizar, deveramos ter a descrio da nota fiscal da forma seguinte:

Figura 1 Transao nota fiscal com frmulas

Passo 6: Visualizao do Modelo de Dados inferido pelo GeneXusVoc pode ver o modelo de dados inferido pelo GeneXus e inclusive modific-lo.

!

Gerao de Modelo de Dados InteligenteToda vez que clicar no boto Salvar, GeneXus inferir o modelo de dados timo (3.forma normal sem redundncias) que suporte as entidades do usurio finalrepresentadas pelos objetos de sua transao GeneXus. Embasado neste modelo dedados, GeneXus gerar uma base de dados fsica quando voc definir um DBMS objetivopara um modelo.

!

Gerao de Modelo de Dados InteligenteA estrutura dos objetos transao determina as tabelas e ndices a serem criados:

Os nomes das tabelas e ndices so atribudos automaticamente pelo GeneXuspelo nome da transao, mas podem ser modificados se for necessrio.

GeneXus infere um modelo de dados em 3. forma normal, sem redundncias.No obstante, podem definir-se redundncias que sero automaticamentegerenciadas pelo GeneXus.

A chave primria da tabela correspondente a uma transao de nvel N se obtmconcatenando identificadores dos N-1 nveis aninhados previamente com oidentificador de nvel N.


21/63

GeneXus X: Quick

Pgin

1. No menu da esquerda, selecione Tables .

2. GeneXus mostrar a estrutura de dados inferidas a partir da transao.

Figura: Tabela de Nota fiscal

Figura: Tabela de Produtos

O Rol da Base de dados acima mostra que GeneXus inferiu automaticamente um modelo de dadosnormalizado, criando duas tabelas para suportar o objeto transao Invoice, Invoice (o cabealho danota fiscal) e InvoiceProduct (as linhas da nota fiscal), com a seguinte estrutura:

Invoice

InvoiceID

InvoiceDate

CustomerID

CustomerName

InvoceProduct

InvoiceID

ProductID

ProductName

ProductPrice

LineQuantity


22/63

GeneXus X: Quick

Pgin

Observe que:

A chave primria da tabela InvoceProduct est formada por dois atributos: InvoiceID eProductID (a concatenao do identificador de primeiro nvel, InvoiceID, com o identificadordo segundo nvel, ProductID).

GeneXus eliminou automaticamente das tabelas os atributos que se definiram como frmulase os converteu em frmula globais para poder acess-las de qualquer lugar dentro da base deconhecimento.

Na tabela Invoice:o No pode haver duas notas fiscais com o mesmo InvoiceID.o Para cada InvoiceID h um nico valor do InvoiceDate, CustomerID e

CustomerName. Na tabela InvoceProduct:

o No pode haver duas linhas de nota fiscal com a mesma InvoiceID e ProductID.o Para cada par do InvoiceID e ProductID h um nico valor do ProductName,

ProductPrice e LineQuantity.

Passo 7: Visualizao dos Formulrios do Objeto Transao Visualize o formulrio Web predeterminado que foi gerado automaticamente pelo GeneXus para seurecm criado objeto transao (deve estar posicionado dentro do objeto Nota fiscal).

!

Formulrio WebDepois de salvar um novo Objeto Transao, o GeneXus cria automaticamente umFormulrio Web predeterminado para especificar como o usurio final ir acessar osdados na aplicao. Estes formulrios podem ser personalizados pelo analista do negciomais tarde.

Para o formulrio Web siga os passos seguintes:

1. Selecione a aba WebForm da transao Nota Fiscal.


23/63

GeneXus X: Quick

Pgin

Figura: Formulrio (predeterminado) da Transao Nota fiscal

Error Viewer: ctlError o controle predeterminado onde se desdobram mensagens de erro. Pode selocalizar em qualquer lugar do formulrio e configurar-lhe propriedades. As mensagens possveis soas que se desdobram no Msg e regras de Erro, e os controles automticos do GeneXus (quer dizer,integridade referencial, erros tipo de dados, etc.).

Estes formulrios habilitaro os usurios finais a entrar novas notas fiscais que iro se inserir como

novos registros nas tabelas correspondentes. Os usurios tambm podero atualizar ou eliminar asnotas fiscais existentes, desde que tiverem os direitos para faz-lo.

O analista do GeneXus no precisa programar nenhuma destas aes porque esto implcitas na lgicada transao. GeneXus gerar automaticamente o cdigo nativo correspondente na linguagemselecionada.

Tenha em conta que ao definir transaes GeneXus se est: Explicitamente: descrevendo a interface de usurio para a apresentao e captura de dados. Implicitamente: desenhando o modelo de dados da aplicao (tabelas, ndices, etc.)


24/63

GeneXus X: Quick

Pgin

Passo 8: Execuo de sua Aplicao

!

Gerao da BD em 3. Forma Normal GeneXus gera os programas executveis requeridos para criar sua base de dados no

DBMS selecionado com base no modelo de dados inferido. Quando voc est atualizando sua estrutura de dados, GeneXus gera os

programas executveis requeridos para reorganizar a base de dados; ou seja, criaum novo esquema e converte os dados do velho esquema para o novo.

Nestes casos ir se desdobrar um Reporte de Criao de Base de dados ou umReporte de Anlise de Impacto respectivamente, que lhe mostrar o que oGeneXus ir fazer.

Neste passo, executaremos a aplicao em .NET usando SQL Server como nosso DBMS. Na versocomercial voc pode usar qualquer um dos DBMS suportados pelo GeneXus. Consulte a lista completados DMBS suportados pelo GeneXus aqui:

http://www.genexus.com/technologies

!

Reporte de Criao de Base de dados : o reporte que descreve oesquema da base de dados que GeneXus gerar no DBMS selecionado. Contm toda ainformao sobre o modelo de dados inferido e o esquema de base de dados proposto

para ser gerado. A informao sobre cada tabela est dividida em cinco sees: Cabealho : Contm a nome da tabela, as aes a realizar nele, advertncias e

erros, Se o modelo de dados contm erros, o boto de Reorganizao estardesabilitado.

Estrutura da Tabela : Mostra os atributos da tabela, suas relaes e as aes arealizar sobre eles.

ndices : Descreve os ndices da tabela que GeneXus usa para manter aintegridade referencial de sua base de dados e para acessar as tabelaseficientemente.

Restries da Chave Fornea : Descreve as restries de integridade databela.

Statements : Descreve as sentenas que iro se executar.
http://www.genexus.com/technologieshttp://www.genexus.com/technologieshttp://www.genexus.com/technologies


25/63

GeneXus X: Quick

Pgin

1. Pressione F5 ou v atravs do menu opo BUIL /RUN DEVELOPER MENU.

2. O Ajudante vai gui-lo naconfigurao da BD. Configure oseguinte:

Database name: Demo Server name: localhost Use trusted connection: Yes

Clique no boto Finish paracontinuar.

Figura: Detalhe da Barra de Ferramentas do Modelo

3. GeneXus mostrar o reporte decriao da BD.

Figura: Dialog box para a Criao da Base de dados

4. Clique em CREATE. GeneXusescrever o cdigo para a criaodas tabelas e os programasnecessrios na linguagemselecionada para acessar a BD.

Figura: Output


26/63

GeneXus X: Quick

Pgin

Passo 9: Teste de sua Aplicao

1. O Menu doDesenvolvedor umarquivo XML que incluitodos seus objetosexecutveis. ummenu auxiliar paratestar sua aplicao.Clique na opoInvoice .

Figura: Menu do Desenvolvedor

2. Insira algumasinstncias de nota fiscal.Graas tecnologiaAJAX, as frmulas secalculamautomaticamente, semnecessidade derecarregar a pginainteira.

3. Quando tiver finalizado,clique no boto Fechar .

Figura: Instncia da Transao Invoice


27/63

GeneXus X: Quick

Pgin

Passo 10: Adicionar Regras do Negcio RegrasAdicionemos um pouco de lgica bsica de negcios a sua aplicao.

!

Regras GeneXusAs Regras GeneXus so o meio para definir a lgica do negcio associada a cada objeto.So escritas em forma declarativa e GeneXus decide de maneira inteligente qual regraaplicar e quando aplic-la.

As regras desempenham um papel muito importante nos objetos transao porquepermitem programar seu comportamento (por exemplo: atribuindo valorespredeterminados, definindo controles de dados, etc.).

Podem envolver atributos definidos na estrutura da transao, bem comovariveis e funes.

As Regras so programadas em forma declarativa , isto , a ordem na qual seescrevem no necessariamente a ordem na qual vo ser executadas. A ordemde execuo adequada automaticamente determinada pelo GeneXus.

So vlidas unicamente na transao em que foram definidas. Por isso falamos que solocais .

Agora iremos adicionar uma regra simples que configura por defeito a Data da Nota fiscal como a datado dia de hoje:

1. Selecione a aba Regras da transao Invoice.2. Utilizaremos a regra Default que atribui um valor predeterminado a um atributo ou varivel.3. Complete a frmula do modo seguinte: Default (InvoiceDate , &today ); o que indica que o

valor predeterminado da Data da nota fiscal ser a data do dia de hoje 1.4. Clique no boto de salvar .

1 Tenha em conta que voc poder tambm usar as opes Inserir / Atributo e Inserir / Frmula do menu Inserirpara completar a regra.


28/63

GeneXus X: Quick

Pgin

Figura: Regra da Transao

Eis outra regra simples que estabelece uma mensagem de erro se a quantidade de produtos inseridafor nula:

5. Adicione a seguinte regra: Error ( "The product cannot be empty") if LineQuantity.IsEmpty();

6. Clique no boto de salvar .

Figura: Declarao de regras

7. Teste as regras inseridas, executando a aplicao (F5).

Figura: Execuo da aplicao


29/63

GeneXus X: Quick

Pgin

Passo 11: Criao do Objeto Transao ClienteOs clientes so conceitos que correspondem a entidades independentes da nota fiscal, portantocorresponde que seja definidos como um transao em si mesma.

1. Crie o objeto Transao Cliente seguindo o Passo 2: Criao de um Objeto Transao e o Passo 3:Descrever a Estrutura da Transao .

2. Adicione os seguintes atributos Estrutura Cliente:

ATRIBUTO TIPO DESCRIO

CustomerID --------- --------------------

CustomerName --------- --------------------

CustomerAddress Character(50) Customer Address

CustomerEmail Character(50) Customer Email

Observe que quando comea a escrever os atributos CustomerID e CustomerName, GeneXus lheindica o nome completo do atributo e seu tipo e descrio. Isto acontece porque estes atributos jesto definidos em sua base de dados.

3. Pressione o boto direito do mouse sobre oatributo CustomerID e selecionePropriedades .

4. Dentro do Type Definition configure apropriedade Autonumber do CustomerIDcomo True . Desta forma, os programasgerados atribuiro automaticamente um valorCustomerID a cada nova instncia de Cliente.

5. Ative o suggest para o cdigo do cliente,posicionando-se sobre as propriedades doCustomer ID, dentro da opo InputType,

definir Description e adicionar comoItemDescription: CustomerName.

Assim, em vez de inserir o ID de um clientepara identific-lo, poderemos inserir seunome e a aplicao automaticamente inferirseu ID. A propriedade suggest lhe sugerirtodos os nomes de clientes que concordemcom o nome inserido pelo usurio. Estas

Figura: Janela de propriedades


30/63

GeneXus X: Quick

Pgin

propriedades so parte da implementao doAJAXque o GeneXus faz automaticamente.

O Formulrio Web da transao Cliente ser visto como exibe a seguinte figura.

Figura: Estrutura da transao Cliente

Figura: Formulrio Web da transao Cliente

Observe (a seguir) que o Formulrio Web da Nota fiscal tambm mudou, refletindo as mudanas naspropriedades do atributo CustomerID: o atributo CustomerName agora o da descrio do atributoCustomerID. Isto melhorar notavelmente a Usabilidade da aplicao como veremos rapidamente!

Figura: Formulrio Web da transao Nota fiscal


31/63

GeneXus X: Quick

Pgin

Passo 12: Reviso das Mudanas efetuadas ao Modelo de Dados Pressione a tecla F5. Isto gerar um Reporte de Anlise de Impacto.

! Anlise de ImpactoDescreve as mudanas fsicas que devero se realizar para atualizar o novo modelo dedados inferido pelo GeneXus.

Comprovar que GeneXus normalizou automaticamente seu modelo de dados depois de ter includo anova transao.

Mostra-nos que a tabela Invoice ser afetada, eliminando o atributo CustomerName da tabela Invoice j que o mesmo pode ser inferido atravs do CustomerID.

Aparece uma nova tabela, Customer:

N O T E Em warning de especificao refere se a que pode haver valores duplicados de clientes na tabela

Invoice que ao serem normalizados, pode afetar. Tambm se mostra outro warning indicando que osregistros que iro se criar tm valor nulo nas tabelas.


32/63

GeneXus X: Quick

Pgin

Figura: Lista da Base de dados (Modelo de Dados)

Observe que:

GeneXus adicionou uma nova tabela: a tabela Customer (associada transao Customer). O atributo CustomerName eliminou-se da tabela Invoice (este atributo est armazenadounicamente na tabela Cliente), deixando a base de dados normalizada.

Na tabela Customer:o No pode haver dois clientes com o mesmo CustomerID.o Por cada CustomerID h um nico valor do CustomerName, CustomerAddress e

CustomerEmail. Na tabela Invoice:

o No pode haver duas notas fiscais com o mesmo InvoiceID.o O atributo CustomerID na tabela Invoice uma chave fornea tirada da tabela Cliente.

portanto, existe uma relao de um a muitos entre Clientes e notas fiscais: Por cada InvoiceID existe unicamente um CustomerID. Cada CustomerID pode ter muitas notas fiscais (InvoiceID).


33/63

GeneXus X: Quick

Pgin

Passo 13: Visualizao do Reporte de EspecificaoJ est preparado para proceder com a reorganizao da BD. Selecione a opo REORGANIZE. Osprogramas de reorganizao criam um novo esquema de base de dados na base de dados fsica domodelo objetivo e transportam os dados do esquema velho para o novo. Executada a reorganizao, o GeneXus desdobra um Reporte de Especificao composto por umasrie de Reportes de Navegao, um para cada programa que ir gerar.

! Reporte de EspecificaoDescreve como se executar o programa, quais tabelas acessar (e como) e quaisoperaes realizar.

Figura: Reporte de Navegao de Transao do Customer

Referential Integrity controls on delete (Controles de integridade referencial ao e xcluir) significaque quando voc exclui um cliente da transao Cliente, o programa verificar que no existamnotas fiscais para esse cliente. Para realizar esta busca com eficincia, usa-se o ndice de foraCustomerID da tabela Nota fiscal.


34/63

GeneXus X: Quick

Pgin

Figura: Reporte de Navegao da transao Invoice

Integridade Referencial na transao Nota fiscal: A chave fornea CustomerID no nvel INVOICE significaque quando voc insere ou atualiza uma nota fiscal usando a Transao INVOICE automaticamente secontrolar se o valor inserido na chave fornea CustomerID j existe como chave primria de um registro natabela Cliente. Para realizar esta busca com eficincia, usa-se o ndice primrio CustomerID da tabelaCliente.

O controle de integridade referencial valida que um atributo inserido (por exemplo, CustomerID em umaNota fiscal) vlido, mas no proporciona informao sobre quais so os valores vlidos. Para facilitar abusca dos valores vlidos, GeneXus cria objetos Lista de Seleo (prompts) que mostram o grupo completode valores vlidos para escolher os que correspondam.


35/63

GeneXus X: Quick

Pgin

Passo 14: Criao dos Formulrios Atraentes TemasNesta seo criar um novo Tema baseado em um modelo predefinido e o configurar como o Temade sua aplicao.

!

Objeto TemaO objeto GeneXus Tema melhora o desenvolvimento e manuteno das aplicaes Webseparando as tarefas do analista do negcio das do desenhador Web.

Criam-se Formulrios Web baseados num Objeto Tema predeterminado. Voc pode criar novos Temas e associ-los totalidade de sua Base de

Conhecimento ou a objetos especficos dentro dela.

1. No menu da esquerda, dentro do menuCustomization selecione a opoThemes (clicando duplo).

2. Abra a formulrio GeneXusX

3. Mude a cor de fundo dos Formsselecionando Form e depois editandoas propriedades direita. Para mudar acor de fundo deve selecionar a opoBACKGROUNDCOLOR

4. Salve as mudanas realizadaspressionando o boto de gravar ( )

Figura: GeneXus Theme Editor

5. Se voltar a abrir o objeto INVOICE naaba da Web Form ver refletidos asmudanas realizadas.

Nota : para ver a mudanas, caso no oconsiga, dever fechar e abrir atransao se ela estava previamenteaberta.

Figura: Formulrio Web da transao Invoice com o novo Tema


36/63

GeneXus X: Quick

Pgin

PARTE 3: Manuteno


Desenvolvimento Incremental e Manuteno da AplicaoAt o momento criamos uma aplicao de trabalho baseada em alguns objetos transao e regras donegcio. Agora veremos como manter uma aplicao GeneXus simplesmente editando os objetosGeneXus existentes e/ou adicionando novos e depois atualizando sua base de dados e regenerando osprogramas da aplicao em forma automtica.

!

Desenvolvimento Incremental com o GeneXus

medida que a realidade muda, os requerimentos do sistema evoluem e isto se traduzem mudanas nos objetos GeneXus e/ou novos objetos. Com base nos novos objetos,GeneXus atualizar sua base de dados automaticamente (criando um novo esquema debase de dados e migrando os dados do velho esquema para o novo) e regenerar osprogramas da aplicao que devam ser modificados.Falamos que a Metodologia GeneXus incremental porque se baseia no pressuposto deque o desenvolvimento do sistema um processo iterativo que acontece em sucessivasaproximaes. O desenvolvimento incremental possvel porque GeneXus pode mantero esquema de sua base de dados e os programas de sua aplicao automaticamente.

Passo 15: Incluso de Novos Objetos: Transao ProdutoAo provar a aplicao, certamente ter notado que deve inserir a Identificao, Descrio e Preo deProduto em cada linha da nota fiscal. Isto no o que esperaria de um sistema de gesto de vendas.E nem sequer de um sistema simples como esta aplicao de exemplo!

Devemos contar com a possibilidade de adicionar, atualizar e eliminar produtos de nosso sistema.Para faz-lo, adicionaremos o transao Produto em nossa Base de Conhecimento:


37/63

GeneXus X: Quick

Pgin

1. Crie a transao Produto seguindo o Passo 3: e o Passo 4: . Insira os seguintes atributos naEstrutura da transao Produto:

ATRIBUTO TIPO DESCRIO

ProductID --------- --------------------

ProductName --------- --------------------

ProductPrice --------- --------------------

Notar que assim que comear a escrever estes nomes de atributo, o GeneXus lhe indicar o

nome completo. Isto acontece porque estes atributos j esto definidos em sua Base deConhecimento.

A estrutura (Structure) da transao Product e seu Formulrio Web iro se ver da seguinte forma.

Figura: Estrutura da transao Product

Figura: Formulrio Web da transao Produto


38/63

GeneXus X: Quick

Pgin

Passo 16: Anlise e reorganizao da BD

Quando voc salvar seu objeto Transao Product, GeneXus normalizar o modelo de dadosnovamente. A reviso do modelo de dados revela que GeneXus normalizou automaticamente omodelo de dados movendo os atributos ProductName e ProductPrice da tabela InvoiceProduct (Detalhede Nota fiscal) para a nova tabela Produto.

Figura: Lista de Base de dados (Modelo de Dados) para o InvoiceProduct e tabelas Produto

1. Selecione Reorganize.


39/63

GeneXus X: Quick

Pgin

2. GeneXus realizar a reorganizao daBD e especificar as mudanasnecessrias sobre os programas deaplicao

Figura: Dialog box para a Execuo da Reorganizao eEspecificao

3. Chegou a hora de executar suaaplicao!

Figura: Execuo de sua aplicao


40/63

GeneXus X: Quick

Pgin

PARTE 4: Adicionando funcionalidade Tempo estimado: 10 minutos.

Utilizao de Padres no desenvolvimentoTivemos a possibilidade de testar nossa aplicao e comprovar como inserir dados atravs dastransaes. Seria conveniente ter uma viso mais general da informao, no apenas de inserir,apagar e modificar Clientes, notas fiscais ou Produtos, mas tambm filtr-los por algum critrio emparticular, orden-los, etc. Para implementar esta funcionalidade em forma rpida e simples, utilizam-

se os Patterns.

! Patterns ou PadresSo aes similares aplicadas a diferentes elementos. Os padres permitem criarautomaticamente todos os objetos necessrios para cumprir a funcionalidadeespecificada, evitando ter que faz-lo manualmente.

Passo 17: Aplicar um patternAplicaremos o pad ro Work With sobre as transaes criadas.1. Atravs do menu View , selecione a

opo Work with Objetcs.

2. Selecionar as transaes Customer,Invoice e Products.

Figura 2 Dilogo para a Seleo de Transaes


41/63

GeneXus X: Quick

Pgin

3. Sobre as transaes selecionadosclique direito, opo Apply Pattern,Work With.

4. Grave as mudanas.

5. Pressione F5 para executar aaplicao. Observamos que j notemos acesso s transaes. O quetemos um acesso a nosso Trabalharcom Customer, Invoice e Product. Figura: Seleo do TRN

6. Execute a aplicao

O pattern adicionou a seguintefuncionalidade: Filtro por data, sem necessidade

de refrescar a aplicao. Pode-se ordenar pelas colunas

clicando no cabealho dasmesmas.

Pode-se paginar a grade. Clicando em um link vamos ao

view de um objeto, onde semostram os dados relacionados.

Guarda o histrico com os linksvisitados.



42/63

GeneXus X: Quick

Pgin

PARTE 5: Dilogos interativosTempo estimado: 15 minutos

Desenho de Consultas e Dilogos Interativos (Web Panels)

! Web PanelsOs Web Panels so usados para fazer dilogos e consultas interativos base de dadosem ambientes Web. Permitem implementar diferentes tipos de consultas e visualizar osdados de formas bem diversas.

Os Web Panels so programados usando uma linguagem simples dirigida por eventos.

Passo 18: Criao de um Web Panel: Nota fiscal por cliente.

Vamos criar um Web Panel que nos permita ver para cada cliente as Notas fiscais que tem associadas.Para isso siga os passos seguintes:

1. No menu Objeto , clique emNovo Objeto .

2. Selecione o Tipo de Objetoque deseja criar: WebPanel .

3. D ao Objeto o nome: InvoicesPerCustomer

4. Clique em OK.

Figura: Dialog box para Definir Objeto


43/63

GeneXus X: Quick

Pgin

5. Aparecer o Formulriovazio do Web Panel. Nomenu View , selecioneOther Tool Windows ,opo Toolbox . Arrastarum controle Free StyleGrid.

6. Expanda a grade.

7. Localizados dentro dagrade, selecione a opoInsert , Attribute .

8. Selecione o atributoCustomerName e cliqueem OK.

Figura: Janela do Seletor do Free Style Grid

Figura: Web Panel


44/63

GeneXus X: Quick

Pgin

9. Queremos adicionar asnotas fiscaiscorrespondentes por cliente.Para isso, insira uma grade,e selecione os atributosInvoiceIO, InvoiceDate,InvoiceTotal. O GeneXusencontra a relao entre astabelas de maneira tal dearrolar as notas fiscais porcada Cliente.

10. Na janela Arrange Columns(Arrumar Colunas) cliqueem OK.

11. Gravar as mudanasoprimindo o diskette.

12. Executar pressionando F5.

Figura: Janela Insert Grid

Figura: Janela Web Panel com Grid

Figura: Execuo da Aplicao


45/63

GeneXus X: Quick

Pgin

Passo 19: Execuo do Web Panel modificando a instncia do Pattern

Vamos mod ificar a instncia Pattern Trabalhar com Clientes na transao Customer de forma tal apoder acessar o Web Panel InvoicesPerCustomer.

1. Abrir a TransaoCustomer e vamos aoPattern pressionando oboto Work With .

Figura: Transao Customer

2. Vamos adicionar umaao a esta instncia doPattern e vamos associ-la a um boto fora dagrade convocando o WebPanel Nota fiscal porCliente.

3. Posicionar o boto direitosobre a opo Selection(Work With Customers) eescolher a opo ADD,Actions.

Figura: Trabalhar com Clientes

4. Adicionar uma nova ao(boto direito sobre aopo Action, Add,


46/63

GeneXus X: Quick

Pgin

Action)

5. Editamos suaspropriedadespressionando F4.

6. Como Name colocamosViewInvoicesPer

Customer, como Captiontambm e no GXObjectselecionamos o WebPanelInvoicesPerCustomer.

7. Salvamos as mudanas

8. Executamos a aplicaopressionando F5.

9. Em execuo, selecionara opo Work withCustomers para ver oboto que invoca o Webpanel criado.

Figura: Modificao da instncia do Pattern

Figura: Seleo de Objetos


47/63

GeneXus X: Quick

Pgin



48/63

GeneXus X: Quick

Pgin

PARTE 6: Enriquecendo a aplicaoTempo estimado: 15 minutos

Controles de usurios

!

User ControlsSo controles Web que podem ser inseridos no form de qualquer objeto Web doGeneXus e que vo aumentar notoriamente a funcionalidade e aparncia de nossaaplicao. alm dos user controls padres providos (Chart, Image Galery, Map,Treeview), GeneXus nos prov de um Editor do User Controls atravs do qual poderemosmodificar os user controls j existentes e criar nossos prprios user controls e incorpor-los ao GeneXus.

Nosso objetivo ser representar em forma grfica as vendas por produto. Para cumprir esterequerimento vamos usar o User Control Chart .

Passo 20: Implementao de um User Control

1. Criar um novo objeto do tipo Web Panelque chamaremos SalesxProd.

Figura: Web Panel VentasxPrd


49/63

GeneXus X: Quick

Pgin

2. Ative o Menu Toolbox, atravs do MenuView, Other Tool Windows,Toolbox

3. Arraste o user control Chart para a WebPanel

Figura: Chart

4. Na aba Events, apague o cdigo gerado etranscreva o seguinte:

Figura: Eventos


50/63

GeneXus X: Quick

Pgin

5. Grave o Web Panel

6. Execute a aplicao pressionando F5.


PARABNS!Voc criou com sucesso primeira aplicao com o GeneXus.

Nosso prximo passo oferecer-lhe maior informao sobre as coisas que podem ser feitas com oGeneXus.


51/63

GeneXus X: Quick

Pgin

PARTE 7: ProcedimentosTempo estimado: 15 minutos

Desenho de Processos No Interativos (Procedimentos)

!

ProcedimentosAt o momento trabalhamos com os Objetos Transao que so objetos GeneXus querequerem a interveno do usurio para inserir, atualizar e eliminar registros na base dedados. No obstante, muitas vezes precisamos realizar tarefas sem a interveno dousurio. Para isso, usamos outro tipo de Objetos GeneXus:

Procedimentos : Definem processos no interativos para consultar e atualizar abase de dados. Os procedimentos so usados para definir funes e sub-rotinas.

Uma funcionalidade chave dos Procedimentos GeneXus que com eles usamos a mesmametodologia baseada no conhecimento que usamos para definir os Objetos Transao.Isto significa que a definio destes objetos baseia-se em nomes de atributos e no nastabelas da base de dados onde os atributos so armazenados. Portanto, a definio deseus Procedimentos permanece vlida desde que os atributos declarados dentro dosmesmos estejam presentes na Base de Conhecimento.

Em nosso exemplo criaremos um Reporte simples (que mostre todos os dados de uma nota fiscal).

!

Caractersticas dos Procedimentos Processo de alto nvel: Os Procedimentos especificam-se em um processo de

muito alto nvel. A seqncia de execuo determinada pelo analista usando umalinguagem de processo simples que inclui controle, impresso, acesso a dados eoutros comandos.

Baseado s em Conhecimento : O cdigo fonte dos Procedimentos refere-se anomes de atributos na Base de Conhecimento, no a sua localizao na base dedados fsica (do Modelo de Prottipo ou Produo). Portanto:

o O GeneXus sabe onde encontrar os atributos na base de dados fsica.o O GeneXus conhece as relaes entre as tabelas na base de dados fsica.o Os Atributos Frmula so inferidos automaticamente pelo GeneXus.

As mudanas na base de dados fsica no afetam o comportamento dos Procedimentos


52/63

GeneXus X: Quick

Pgin

Nosso objetivo ser criar um procedimento que arrole todos nossos clientes junto a seu total e outroque permita modificar em 10% os preos vigentes.

Passo 21: Implementao de um Procedimento para impresso

1. Criar um novo objeto do tipoProcedimento chamado CustomerReport

Figura: Procedimento CustomerReport2. Dentro da aba Source insira o seguintecdigo:

For each &Total =SUM(InvoiceTotal)Print printBlock1

Endfor

Figura: Source do Procedimento CustomerReport 3. Ir aba de Layout. Inserir o atributoCustomer Name (para isso v opoInsert/Attribute).


53/63

GeneXus X: Quick

Pgin

Figura: Layout do procedimento 4. Insira uma varivel chamada Total, dotipo numrica de 6 dgitos.

Figura: Insero de variveis 5. Utilizando o Toolbox voc pode botardesenho em seu reporte (inserir Labels,Linhas, etc.). Por exemplo, com o boto direitosobre o PrintBlock1 insira outro PrintBlock eadicione os ttulos correspondentes (CLIENTE eTOTAL) utilizando a opo Label do Toolbox.Depois, mova o PrintBlock2 para cima,

utilizando a opo que se desdobrar aopressionar o boto direito do mouse.

Dever adicionar no Source o seguinte cdigo:

6. Grave o procedimento.

Figura: Layout do Procedimento


54/63

GeneXus X: Quick

Pgin

7. Nas propriedades do procedimento que sedesdobram a sua direita, defina a propriedadeMain Program como TRUE eCall Protocol noHTTP.

Figura: Propriedades do procedimento 8. Na aba de Regras insira a seguintesentena para definir o nome e tipo dearquivo:

Output_file ( 'Customers.PDF' , 'PDF' );

Figura: Regras do Procedimento 9. Para chamar este procedimento queimprime os totais por cliente deveremos inserirum boto na transao de notas fiscais. Paraisso, abra o objeto INVOICE. Dentro da abaWeb, abra o Tollbox e arraste um boto dentroda transao.

Figura: Transao de notas fiscais


55/63

GeneXus X: Quick

Pgin

10. Edite as propriedades clicando direitosobre o boto inserido. No Caption insiraImprimir, no On clic Event define New, definaImprimir.

Figura: Propriedades da transao 11. Na aba de Eventos adicione o seguintecdigo:

Event 'Imprimir' CustomerReport. Call

EndEvent

Figura: Eventos da transao 12. Salve e execute pressionando F5. Insirauma nova nota fiscal para testar a novafuncionalidade inserida.



56/63

GeneXus X: Quick

Pgin

Passo 22: Implementao de um Procedimento para atualizao

Agora realizaremos um procedimento que permita modificar em 10%.os preos vigentes1. Criar um novo objeto do tipo Procedimento

chamado Discount_of_prices.

Figura: Procedimento Atualizao de preos 2. Na aba de Source adicione o seguinte

cdigo:

For each ProductPrice =

ProductPrice+ProductPrice*0.10

Endfor

Figura: Source do Procedimento 3. Grave o procedimento criado.

4. Para chamar este procedimento, criaremosum Web Panel. O Web Panel ser nomeadoControl_Panel.


57/63

GeneXus X: Quick

Pgin

Figura: Web Panel Control_Panel 5. Na aba da Web Form insira um Button (do

menu Toolbox)

Figura: Web Form 6. Edite as propriedades do boto clicando

direito sobre o boto inserido. No captioninsira Modificar preos.

7. Posicionado sobre o boto, clique direito paraEditar o Evento (opo Go to Event). Noevento dever realizar a chamada aoprocedimento:

Event Enter Discount_of_prices. call()

EndEvent

Figura: Evento 8. Grave o Web Panel e execute pressionando

F5.



58/63

GeneXus X: Quick

Pgin

PARTE 8: Multiplataforma


Desenvolvimento MultiplataformaGeneXus uma ferramenta que permite gerar aplicaes de misso crtica em mltiplas plataformas.Uma vez que gerou e executou uma aplicao em um desses ambientes, gerar e executar a mesmaaplicao em outro ambiente to simples quanto definir um novo ambiente.

A GeneXus Trial Version oferece unicamente o gerador GeneXus .NET. No entanto, a verso completado GeneXus suporta as plataformas lderes do mercado. Visite http://www.genexus.com/technologies para obter uma lista completa das tecnologias suportadas pelo GeneXus.
http://www.genexus.com/technologieshttp://www.genexus.com/technologieshttp://www.genexus.com/technologieshttp://www.genexus.com/technologies


59/63

GeneXus X: Quick

Pgin

ResumoEsperamos que este tutorial lhe tenha permitido experimentar as funcionalidades e benefcios chavesdo GeneXus:

Desenho de Aplicaes baseado em Conhecimento

Comeamos por criar uma Base de Conhecimento e descrever os requerimentos de dados de nossaaplicao como uma srie de componentes do negcio chamados Objetos Transao no Modelo deDesenho da Base de Conhecimento. GeneXus usou esta informao para inferir o modelo de dadostimo (3. forma normal) requerido para suportar todas suas Transaes. Tambm adicionamos

algumas regras do negcio nas que GeneXus se baseou para gerar o cdigo da lgica do negcio daaplicao.

Gerao Automtica da Base de dados

Escolhemos uma plataforma de execuo especfica (Web, linguagem de programao, DBMS, etc.) ecriamos um Modelo no qual GeneXus gerou automaticamente uma base de dados fsica com o modelode dados do Modelo de Desenho.

Gerao Automtica de Cdigo e Prottipo Completamente Funcional

Geramos o cdigo fonte para os programas de nossa aplicao e testamos a aplicao no ambiente deprottipo.

Manuteno da Aplicao

Vimos como simples manter/expandir uma aplicao, simplesmente editando os objetos GeneXusexistentes e/ou adicionando novos, e depois GeneXus atualiza a base de dados e regenera osprogramas da aplicao em forma automtica.

Desenho de Processos No Interativo

Proporcionamos uma viso geral sobre o que so os procedimentos independentemente da estruturada base de dados da aplicao.

Desenvolvimento Multiplataforma

Finalmente, descrevemos como migrar facilmente sua aplicao GeneXus de um ambiente para outro.


60/63

GeneXus X: Quick

Pgin

FAQ

Question GeneXus gera 100% do cdigo?

Sim, GeneXus desenha, gera e mantm a base de dados e o cdigo da aplicao.

Question O cdigo gerado usa runtimes?

No. GeneXus gera cdigo nativo na plataforma selecionada e no requer runtimes.

Question possvel utilizar estruturas de dados j existentes?

Sim, no GeneXus existe uma ferramenta (DBRET: Data Base Reverse Engineering) que permiteacessar BD existentes em distintas tecnologias.

Question possvel tocar o cdigo gerado?

Sim, embora no recomendvel visto que se perdem os benefcios de manuteno automtica eindependncia da tecnologia. Em caso de querer utilizar cdigo j existente, possvel fazer chamadasdentro do GeneXus sem necessidade de modificar o cdigo gerado.

Question Posso integrar controles (flash/Silverlight/JavaScript) em uma aplicao?

Sim, GeneXus permite integrar diferentes tipos de controles. Veja mais emhttp://gallery.genexus.com/catalog.aspx?3 e emhttp://wiki.gxtechnical.com/commwiki/servlet/hwiki?category%3AUser+Controls ,
http://gallery.genexus.com/catalog.aspx?3http://gallery.genexus.com/catalog.aspx?3http://wiki.gxtechnical.com/commwiki/servlet/hwiki?category%3AUser+Controlshttp://wiki.gxtechnical.com/commwiki/servlet/hwiki?category%3AUser+Controlshttp://wiki.gxtechnical.com/commwiki/servlet/hwiki?category%3AUser+Controlshttp://gallery.genexus.com/catalog.aspx?3


61/63

GeneXus X: Quick

Pgin

Question Qual o conceito de Tabela Estendida?

Dada uma tabela base , sua tabela estendida o grupo de atributos que so direta ouindiretamente determinados pela chave da tabela base:

Atributos que pertencem tabela base. Atributos que pertencem a todas as tabelas que esto direta ou indiretamente relacionadas em

uma relao N a 1 com a tabela base.Usos:

O conceito de tabela estendida permite que os reportes e procedimentos GeneXuspermaneam vlidos quando a estrutura da base de dados muda.

A tabela estendida tambm tambm usada pelos objetos transao que podem inserir,atualizar e eliminar atributos que pertencem s tabelas estendidas das tabelas basereferenciadas na estrutura da transao.

Para encontrar a tabela estendida de uma tabela dada possvel usar o Diagrama de Bachmann domodelo de dados da base de conhecimento:

1. Sobre a opo Objects, crie um novo objeto do tipo Diagrams 2. Selecione as tabelas que deseja desdobrar e arraste-as.

Figura 3 Diagrama de Bachmann do Modelo de Dados

Neste exemplo, podemos identificar a tabela estendida de cada uma das tabelas de nosso projeto:

Tabela Base Tabela EstendidaCustomer CustomerInvoice Invoice, CustomerInvoiceProduct InvoiceProduct, Invoice, Customer


62/63

GeneXus X: Quick

Pgin

Question Qual o conceito de For Each?

O comando For Each o corao da linguagem de procedimentos usado pelo GeneXus para definirreportes e procedimentos. Recupera e atualiza informao (mediante procedimentos online) a partirde sua base de dados.

Com o comando For Each voc pode definir a informao que deseja acessar e nomear os atributosque deseja usar. GeneXus inferir automaticamente as tabelas apropriadas em tempo de gerao.Quando a estrutura da base de dados mudar, as definies do For Each permanecero vlidas.

A sintaxe bsica do For Each a seguinte:

for each

print endfor

Cada comando For Each tem uma tabela de modelo de dados associada que ser navegada. Estcomposto da tabela base do For Each e sua tabela estendida (as tabelas de que GeneXusnecessita para procurar os atributos mencionados no comando).

As tabelas que sero acessadas so determinadas pelos atributos contidos no comando ForEach.

Para este grupo de atributos, GeneXus inferir a mnima tabela estendida.A tabela base deste grupo de atributos ser a tabela base do For Each


63/63

GeneXus X: Quick

Contatos e Recursos A Comunidade GeneXusA Comunidade GeneXus lhe oferece diversas formas de obter respostas a suas perguntas e solues aseus problemas, bem como tambm oportunidades para compartilhar suas prprias experincias.Encontrar uma lista completa dos recursos disponveis da Comunidade emhttp://www.genexus.com/community/

SuporteA Artech oferece uma ampla variedade de servios e recursos de suporte:

Suporte Auto-Servio OnlineEstes recursos esto disponveis para todos online. No entanto, a informao que cada um possaacessar depende de seu Nvel de Acesso ao GXtechnical (Usurio Registrado ou Cliente).

Servios de Suporte InterativoInteratue com outros membros da Comunidade ou com a Equipe de Suporte.

Visite http://www.genexus.com/support/

Se voc mora nos Estados Unidos ou Canad pode nos enviar suas perguntas [email protected]

Como Comprar As Tecnologias GeneXus so vendidas atravs da rede de distribuidores no mundo todo.

Encontre seu distribuidor mais prximo aqui http://www.genexus.com/distributors

Ou entre em contato com [email protected]

Links recomendadosWeb site: http://www.genexus.com G X X d i h // i i
http://www.genexus.com/community/http://www.genexus.com/community/http://www.genexus.com/support/http://www.genexus.com/support/http://www.genexus.com/support/mailto:[email protected]:[email protected]://www.genexus.com/distributorshttp://www.genexus.com/distributorshttp://www.genexus.com/distributorsmailto:[email protected]:[email protected]:[email protected]://www.genexus.com/http://www.genexus.com/http://www.genexus.com/http://training.genexus.com/http://training.genexus.com/http://training.genexus.com/http://training.genexus.com/http://www.genexus.com/mailto:[email protected]://www.genexus.com/distributorsmailto:[email protected]://www.genexus.com/support/http://www.genexus.com/community/

Documents

92370658 Genexus x Quick Start Pt