ERP Apostila SGI

Senior Gerenciador de Interface (SGI)

ElaboraoLus Carlos Seifert de Souza

[email protected]

Blumenau, Janeiro de 2002

Aviso

O contedo deste documento de propriedade exclusiva da Senior Sistemas Ltda e est sujeito a alteraes sem aviso prvio.

Nenhuma parte desta publicao pode ser reproduzida nem transmitida em qualquer forma ou meio, sem a autorizao prvia expressa da Senior Sistemas Ltda.

As informaes contidas neste documento destinam-se somente para uso em cursos ministrados pela Senior Sistemas Ltda. A Senior Sistemas Ltda no assume nenhuma responsabilidade pelo uso destas informaes se aplicadas a quaisquer outros fins.

Todos os nomes de empresas, produtos, marcas comerciais, pessoas, personagens, dados ou si -tuaes, citados neste documento so fictcios e tem somente objetivo didtico, no representan-do pessoas, empresas, produtos ou acontecimentos, salvo indicao em contrrio.

A posse deste documento no lhe confere nenhum direito sobre patentes, marcas comerciais, copyrights ou outros direitos de propriedade intelectual, eventualmente citados neste documento.

Copyright 2001 Senior Sistemas Ltda. Todos os direitos reservados.

Senior Sistemas LtdaRua Luiz Sachtleben, 115

Bairro Victor Konder89012530 Blumenau

SCFone: (047) 221-3300

www.senior.com.br

Senior Sistemas Ltda. Treinamento de Recursos de Sistema

Sumrio

1. Guia de Referncia do SGI..............................................................................................................................12. Elementos do SGI............................................................................................................................................93. Tutorial SGI...................................................................................................................................................29 Exerccios.........................................................................................................................................................50

Senior Sistemas Ltda. Treinamento de SGI

SGI 1

1. Guia de Referncia do SGI

1.1 ConceitoA sigla SGI significa Senior Gerenciador de Interfaces. A finalidade deste produto permitir que o usurio crie seus prprios formulrios para cadastramento de tabelas, e depois publique estes for-mulrios em ambientes X-Window e websites. Uma vez que os formulrios foram publicados, usu-rios regulares do sistema podero utiliz-los para operaes de cadastramento nas tabelas espe-cificadas.

A figura abaixo mostra o funcionamento do SGI:

A figura a seguir mostra a estrutura do SGI:


SGI 2

1.2 Menu Principal

1.2.1 Arquivo1.2.1.1 Gravar AlteraesGrava no banco todos os dados, informaes e alteraes do SGI. importante notar que o boto aplicar das telas no salvam as alteraes, por isso relevante o uso mais freqente da opo "Gravar alteraes".

1.2.1.2 ImportarNessa opo o usurio pode importar do diretrio fonte que ele especificar, qualquer interface ou formulrio que deseje utilizar.

1.2.1.2.1 Opes da TelaSelecionar: O usurio deve informar o diretrio fonte para importao.

Importar: Importa, como o prprio nome j diz, a interface/formulrio selecionado. Se a importa-o for realizada ser exibida a mensagem:

"Importao concluda com sucesso!"Se a interface selecionada j existe no SGI, ele pergunta se o usurio deseja substitu-la, dando trs opes:

Substituir: Substitui o arquivo existente. Manter: Mantm o arquivo existente. Cancelar: Cancela a operao.

Fechar: Sai do Importar.

1.2.1.3 ExportarAo contrrio da opo Importar, esta opo permite que o usurio exporte para o diretrio destino que ele especificar, qualquer interface ou formulrio que desejar.


SGI 3

1.2.1.3.1 Opes da TelaSelecionar: O usurio deve informar o diretrio destino para exportao.

Exportar: Exporta a interface selecionada. Se o arquivo j existe no diretrio destino, ele o substi -tui .

Fechar: Sai do Exportar.

1.2.1.4 SairSai do SGI.

Obs.: Se os dados foram alterados e no salvos, ao sair o SGI pergunta se o usurio deseja man-ter essas alteraes.

1.2.2 Sistemas

1.2.2.1 Configurar Menu X-Window...Faz o cadastro dos formulrios X-Window para os mdulos do sistema podendo dar ttulos (rtu-los) a eles.No campo Mdulo o usurio vai escolher o mdulo em que vai adicionar os Menus|Formulrios X-Window.

1.2.2.1.1 Opes da Tela


SGI 4

Adicionar: Adiciona um Menu|Formulrio X-window. Abre uma tela ao usurio para escolha des-se:

Rtulo: Deve ser informado um nome. Formulrio: Deve ser informado o Menu|Formulrio X-window desejado. Adicionar: Adiciona o Menu|Formulrio X-window escolhido. Fechar: Caso no queira adicionar mais nenhum Menu|Formulrio X-Window, esse boto sai da tela. Executar: Executa o formulrio X-window.

Editar: Abre a tela caso o usurio queira trocar o rtulo ou informar outro formulrio. Para ativ-lo deve-se selecionar um Menu|Formulrio X-Window na Lista de Menus e Formulrios.Remover: Remove Menu|Formulrio X-Window selecionado.Para Cima: Move o Menu|Formulrio X-Window para cima na lista..Para Baixo: Move o Menu|Formulrio X-Window para baixo na lista..OK :Confirma a operao.Cancela: Sai do Configurar Menu.

1.2.3 Ajuda1.2.3.1 SobreMostra uma caixa de dilogo com informaes sobre o produto. Se voc solicitar suporte tcnico, pode ser que o atendente solicite a verso exata do SGI e de alguns mdulos que o SGI est utili -zando. Caso voc no saiba, use o comando "Ajuda", "Sobre" para abrir esta caixa de dilogo.


SGI 5

1.3 Navegao no Editor 1.3.1 Adicionar Interfaces Adicionar uma interface. Basta dar um duplo clique em Adicionar Interface, como mostrado abai-xo:

1.3.2 Adicionar TabelasPermite adicionar uma ou mais tabelas na interface. Existem duas formas de definio, conforme visualizado na tela a seguir:

Adicionar Tabela Permite a configurao de apenas uma tabela por vez.Adicionar Tabelas Fsicas Permite a configurao de vrias tabelas de uma nica vez.

1.3.3 Adicionar Campos da Tabela

Permite adicionar tres tipos de campos da tabela, para isso, deve-se selecionar a tabela desejada e dar um duplo clique em Adicionar Campo Simples, Adicionar Campo Lookup ouAdicionar Campos da Tabela, conforme visualizado na tela a seguir.


SGI 6

Adicionar Campo Simple: Adiciona campos de uso simples na tabela.Adicionar Campo LooKup: Adiciona campos que listam contedos de campos de tabelas relacio-nadas a tabela definida na interface. A definio ser possvel somente aps a definio da liga-o entre estas tabelas. Adicionar Campos da Tabela: Adiciona campos diretos da Tabela que foi definida na Interface.

1.3.4 Campos da InterfacePermite adicionar um campo da interface. Para adicionar, deve-se selecionar a interface desejada e dar um duplo clique em Adicionar Campo Simples ou Adicionar um Campo Lookup.

1.3.5 Adicionar AesPermite definir ou criar aes na interface, sendo que para into deve dar um duplo clique em Adi-cionar Ao.


SGI 7

Obs: Podemos observar que pode ser adicionado aes aos campos da interface ou a campos de uma tabela.

1.3.6 Adicionar LigaesPermite definir ou criar uma ligao simples ou customizada, bastando clicar na opo Adicionar Ligao, conforme visualizado na tela a seguir.

Selecionar o item Simples ou Customizada, como nas figuras abaixo:

OK - Confirma a operao.Cancela - Cancela a operao.


SGI 8

1.3.7 Adicionar Formulrios X-WindowItem utilizado para adicionar um formulrio X_Window. Para adicionar basta dar um duplo clique em Adicionar Formulrio X-Window ou Adicionar Formulrios Automaticamente.

Adicionar Formulrio X-Window: Adiciona um formulrio configurado manualmente ou seja, in-serir os campos da tabela criada na interface manualmente.Adicionar Formulrios Automaticamente: Adiciona um formulrio automaticamente, bastando para isso ecolher a tabela que foi criada na interface.


SGI 9

2. Elementos do SGI

2.1 InterfaceItem utilizado pelo usurio para definir as tabelas, campos, ligaes, condies e regras que vai usar na sua interface, conforme visualizado na tela a seguir.

O campo que est em vermelho mostra a interface que acabou de ser criada ela ter um nome de-fault at que o usurio modifique suas propriedades. Toda alterao deixar o campo em verme-lho at que o usurio salve o formulrio na opo de menu Gravar Alteraes. Toda interface apresenta trs campos para sua manipulao:

Campos da Interface, Tabelas, Ligaes.

Opes da Tela

Nome: O nome da interface. Nomes no devem conter caracteres diferentes de letras, nmeros e underline, o espao no um caracter vlido.

Descrio/Objetivo: Uma pequena descrio sobre a interface gerada.

Informaes Adicionais: Qualquer informao adicional que pode ajudar no melhor entendimen-to da interface.

Aplicar: Confirma as alteraes.

Desfazer: Desfaz as alteraes feitas antes de Aplicar.

Regra... :Abre um editor para regras.

2.1.1 Tabelas2.1.1.1 Adicionar TabelaNessa opo o usurio insere as tabelas desejadas uma por vez, j visualizando suas proprieda-des, como demonstrado na tela a seguir.


SGI 10

Opes da Tela

Nome: Deve ser informado um nome para o campo.Tabela Fsica: Deve ser informado qual tabela fsica ser usada, clicando nos 3 pontinhos desse campo vai ser mostrada uma lista com as tabelas da sua base de dados.

Permitir Insero de Registros Permitir Alterao de Registros Permitir Excluso de Registros

As trs permisses acima devem ser ativadas ou no conforme a necessidade do usurio.Condio para ativar a insero de Registros : Expresso SQL. Condio usada para determi-nar quando se pode inserir registros.Condio para ativar a alterao do registro corrente: Expresso SQL. Condio usada para determinar quando se pode alterar registros.Condio de validao geral: Expresso SQL. Condio usada para validar todas as operaes da tabela.Condio para validar um novo registro: Expresso SQL. Condio usada para determinar quando um registro novo valido.Condio para validar um Registro sendo alterado: Expresso SQL. Condio usada para de-terminar quando uma alterao vlida.Condio para ativar a excluso do registro corrente: Expresso SQL. Condio usada para determinar a excluso de um registro corrente.Informaes Adicionais: Qualquer informao adicional que pode ajudar no melhor entendimen-to da tabela.Aplicar: Confirma a operao.Desfazer: Desfaz as alteraes feitas antes de Aplicar.Regra... : Abre um editor para regras

2.1.1.2 Adicionar Tabelas FsicasNessa opo pode-se escolher vrias tabelas para serem adicionadas, conforme visualizado na fi-gura a seguir.


SGI 11

Para adicionar tabelas fsicas deve-se selecionar a tabela desejada e clicar no boto > , para re-mover uma tabela adicionada s usar o boto < .

Opes da Tela

OK: Confirma a operao.Cancelar: Cancela a operao e sai da tela.

2.1.2 Campos Simples2.1.2.1 Adicionar Campo Simples (Tabela)Os campos que a Tabela vai ter, deve ter um campo fsico correspondente na tabela que foi defini -da.

Nessa opo o usurio vai adicionar um campo por vez, j visualizando suas propriedades.

Opes da Tela

Nome: Deve ser informado um nome para o campo.Lembrando que nomes no devem conter caracteres diferentes de letras, nme-ros e underline, o espao no um caracter vlido.

Campo Fsico Correspondente: Mostra uma lista com os campos das tabelas.Tipo de Dado: Deve ser informado o tipo do campo. Podem ser :

Boolean


SGI 12

Number String Date

Mscara Padro: Existe uma mscara padro para todos os tipos de dados, basta clicar nos 3 pontinhos e a mscara do tipo escolhido aparecer.Lista para escolha do valor: Para escolher uma valor para o campo.Frmula do valor padro: Usado para garantir um valor padro. Condio de Relevncia : Expresso SQL. Condio necessria para verificar se o campo real-mente importante para o sistema.Condio de editabilidade: Expresso SQL. Condio que determina se um campo pode ser edi-tado ou no.Valor do Campo no pode ser nulo: Com essa opo ativada ele no aceita valor nulo para o campo.

Lembrando que o zero aqui, no considerado um valor nulo, o vazio ( " " ) considerado nulo.

Condio de Validao: Expresso SQL. Condio para validar um campo. Avanado... : O boto avanado vai mostrar a seguinte tela ao usurio:

Opes da TelaAdicionar... : Adiciona uma nova condio a ser verificada e a mensagem de erro caso essa condio no seje respeitada.Alterar: Altera uma condio j existente.Remover: Remove uma condio.OK: Confirma a operao.Cancelar: Cancela a operao.

Informaes Adicionais: Qualquer informao que possa ajudar na compreenso do campo.Aplicar: Confirma a operao.Desfazer: Desfaz as alteraes feitas antes de Aplicar.

2.1.2.2 Adicionar Campo FsicoEsta opo permite que o usurio adicione vrios campos de uma s vez na tabela, conforme vi-sualizado na figura a seguir.


SGI 13

Para adicionar um campo, deve-se selecion-lo e atravs do boto > ele adiciona o campo. Para remover um campo adicionado s selecion-lo e clicar no boto > adiciona todos os campos e o

SGI 14

Opes da Tela

Adicionar... :Adiciona uma nova condio a ser verificada e a mensagem de erro caso essa condio no seje respeitada.

Alterar: Altera uma condio j existente.

Remover: Remove uma condio.

OK: Confirma a operao.

Cancelar: Cancela a operao.Informaes Adicionais: Qualquer informao que possa ajudar na compreenso do campo.Aplicar: Confirma a operao.Desfazer: Desfaz as alteraes feitas antes de Aplicar.

2.1.3 Campos Lookup2.1.3.1 Adicionar Campo Lookup (Tabela)Usado para criar um campo que tenha relao com campos de uma outra tabela, ou seja, com uma Ligao.

Opes da Tela

Nome: O nome do campo.Ligao: Para criar um campo Lookup necessrio ter uma Ligao. Para isto, basta selecionar a ligao desejada.Campo: O campo fsico do campo Lookup.Campo Vinculado: Um campo que vai estar vinculado ao campo Lookup..Informaes Adicionais: Qualquer informao que for importante na melhor compreenso do campo.Aplicar: Confirma a operao.Desfazer: Desfaz as alteraes feitas antes de Aplicar.


SGI 15

2.1.3.2 Adicionar Campo Lookup (Interface)Um campo especial que tem relao com campos de uma outra tabela, utilizando para isto uma li-gao.

Opes da Tela

Nome: Deve ser informado um nome para o campo.Ligao: Para criar um Campo Lookup, necessrio ter uma Ligao que selecionada neste item.Campo: O campo fsico do campo Lookup.Campo Vinculado: Um campo que vai estar vinculado ao campo Lookup.Informaes Adicionais: Qualquer informao que ajude na melhor compreenso do Campo.Aplicar: Confirma as operaes realizadas.Desfazer: Desfaz as alteraes antes de Aplicar.

2.1.4 Ligaes2.1.4.1 Ligaes SimplesUma ligao simples uma ligao entre duas tabelas atravs de seus campos.

Opes da Tela

Nome: Informar um nome para a ligao.Lembrando que nomes no devem conter caracteres diferentes de letras, nmeros e underline, o espao no um caracter vlido.

Tipo: Nesse campo o usurio vai definir o tipo da Ligao, so 4 opes: 1 para 1


SGI 16

1 para ( 1 -opcional ) 1 para n Referncia para tabela externa: Faz referncia a uma tabela que no foi adicio-

nada.Tabela da esquerda: Para escolher uma das tabelas que vai ser usada na ligao.Tabela da direita: Para escolher a outra tabela que vai fazer parte da ligaoAdicionar... : Adiciona os campos que o usurio desejar, das tabelas usadas na ligao.

O usurio deve escolher os campos respectivos, clicando nos 3 pontinhos: campos da esquerda na tabela da esquerda e campos da direita na tabela da direita.

OK: Confirma.Cancela: Cancela e sai.

Remover: Remove o campo adicionado.Informaes Adicionais: Qualquer informao que ajude na melhor compreenso da Ligao.Aplicar: Confirma a operao.Desfazer: Desfaz as alteraes feitas antes de Aplicar

2.1.4.2 Ligaes CustomizadasA ligao customizada tem um campo ( Expresso de Ligao ) que determina a ligao.

Na ligao customizada os campos funcionam como na Ligao Simples, com a diferena que aqui no temos os Campos de Ligao, mas temos o campo Expresso de Ligao.

Opes da Tela

Nome: Deve ser informado um nome para a ligao.Tipo: O tipo pode ser:

1 para 1 1 para (1 -opcional) 1 para n Referncia para tabela externa: Faz referncia para uma tabela que no foi adi-

cionada.Tabela da Esquerda: Informar uma tabela.Tabela da Direita: Informar uma tabela.


SGI 17

Expresso de Ligao: Expresso SQL. Determina a ligao das tabelas referenciadas.Informaes Adicionais: Qualquer informao adicional que pode ajudar no melhor entendimen-to da interface.

2.1.5 Adicionar Ao da TabelaEste item permite inserir uma ou mais aes em uma Tabela, conforme demonstrado na figura a seguir. Obs.: Para executar a ao deve-se ter um boto correspondente no formulrio.

Opes da TelaNome: Deve ser informado um nome para o campo. Lembrando que nomes no devem conter ca-racteres diferentes de letras, nmeros e underline, o espao no um caracter vlido.Condio de ativao: Deve ser informado uma condio para ativao atravs de uma expres-so SQL.Regra: Este boto vai mostrar o editor de regras, onde deve ser informada a regra em LSP (Lin-guagem Senior de Programao) que a ao executar. A regra deve ser relacionada com um campo da tabela (Tabela_Campo).

Informaes adicionais: Qualquer informao que possa ajudar na compreenso da ao.Aplicar: Aplica as Regras.

2.1.6 Adicionar Ao da Interface Idem item anterir (Adicionar Ao da Tabela).

2.2 Formulrios X-WindowUm formulrio X_Window o formulrio onde sero passados os dados da interface, informando como e de que forma esses dados vo ser dispostos na tela, apresentando assim o resultado final.


SGI 18

2.2.1 Adicionar Formulrios X-WindowA tela a seguir permite ao usurio fazer a configurao das propriedades neceassrias a configu-rao de um formulrio.

Opes da Tela

Nome do Cadastro: Nome do formulrioTtulo da Janela: Ttulo do formulrio ( que aparece na tela final ).Interface: A interface que ser usada.Tabela Base: A tabela base que ser usada.Campos Chave: Os campos chaves. Pode ter mais de um campo chave.Adicionar Pgina: Adiciona interface quantas pginas o usurio desejar.Remover Pgina: Remove as pginas adicionadas.Ttulo: O ttulo ( nome ) dado pgina.Cadastro de Tabela_Detalhe: Para cadastrar uma tabela adicional para quela pgina.Tabela : Informar a tabela que vai ser usada como Tabela_Detalhe. S vai estar ativo se o item Cadastro de Tabela_Detalhe estiver ativado.Chave: A chave da Tabela_detalhe. S vai estar ativo se o item Cadastro de Tabela_Detalhe esti-ver ativado.Inserir: Insere linhas de controle. Nessa opo ser mostrada ao usurio uma tela com os tipos de linha que ele pode inserir:


SGI 19

Uma linha com campos para exibio e/ou digitao de valores: permite adicionar um tipo de linha de dado que o usurio possa digitar ou mostrar seu contedo na tela, Conforme vi -sualizado na tela a seguir. Opes da Tela Linhas de Dados

Rtulo: Nome da linha de dado.Adicionar... :Ao clicar nesse boto ser apresentada uma tela ao usurio onde ele poder escolher os controles que sero

usados nessa linha de dados.Alterar... :Selecionando uma linha de dados e clicando nesta opo, o usurio poder alterar as informaes dessa linha de dados.Remover: Remove uma linha de dados, basta selecionar a linha a ser removida e clicar em Remover.Mover p/ cima: Ao selecionar uma linha de dados o usurio pode moviment-la para cima o quanto desejar, apenas clicando no boto Mover p/ cima.Mover p/ baixo: Ao selecionar uma linha de dados o usurio pode moviment-la para baixo o quanto desejar, apenas clicando no boto Mover p/ cima.OK: Confirma as linhas de dados que foram adicionadas.Cancelar: Cancela a operao.

Um separador de sees : Insere uma linha onde for adicionado. O separador de seo-chave : Separa a seo chave do formulrio. Uma Tabela (grid): Adiciona Tabela para visualizao e insero de dados.

Alterar: Altera uma linha de controle. Ser aberto ao usurio as mesmas telas que so apresenta-das na insero, para que o usurio altere qualquer informao que achar necessria.Remover: Remove a linha de controle selecionada.Mover p/ Cima: Move para cima a linha de controle selecionada.Mover p/ Baixo: Move para baixo a linha de controle selecionada.Inserir Todos: Insere todos os campos da tabela base, que foram informados na interface, como linhas com campos para exibio e/ou digitao de valores / Caixa de Edio ( Editbox ).Separar Chaves: Ao ativar esta opo o SGI usa um separador para separar as chaves.Aplicar: Confirma a operao. Depois de qualquer alterao necessrio Aplicar antes de Tes-tar. Lembrando que o Aplicar no salva as operaes no banco, sendo necessrio para isso o uso da opo de menu, Gravar Alteraes.Desfazer: Desfaz todas as alteraes feitas antes de Aplicar.Testar: Essa opo testa a interface produzida, se estiver tudo ok, mostra o resultado com os campos e propriedades informados na construo da interface.Compilar: Compila o formulrio e se no houver nenhum erro mostra a seguinte mensagem:

"Seu formulrio foi compilado com sucesso!"Editar Permisses... : O usurio escolhe quem ter permisses de acesso a seu formulrio.


SGI 20

Opes da TelaAdicionar... : Adiciona novos usurios.Remover: Remove usurios.Detalhes...: Mostra as permisses a serem liberadas ou no .OK: Confirma a operao.Cancelar: Cancela a oparao.

2.2.2 Adicionar Formulrios AutomaticamenteNesta opo o usurio escolhe entre as interfaces existentes, e adiciona os formulrios que deseja utilizar, podendo adicionar vrios formulrios de uma s vez, conforme visualizado na tela a se-guir.

Usando o boto > o usurio adiciona o formulrio selecionado, e < remove-o. Depois de adicionados, um clique sobre eles, mostram as suas propriedades.OK: Confirma a operao.Cancela: Cancela a operao.


SGI 21

2.2.3 Controles do Formulrio X-Windows2.2.3.1 Caixas de EdioControle utilizado para insero e visualizao de dados no formulrio criado. Como demonstrado na tela a seguir, esta insere o controle Caixa de Edio.

Aps a insero, dever ser informado as propriedades da Caixa de Edio, conforme demonstra-do na tela a baixo.

Opes da Tela

Campo Correspondente: Vai mostrar uma lista dos campos das tabelas usadas no formulrio correspondente, para a escolha de um campo para a caixa de edio.Mscara: - Usar mscara padro: Mscara padro do SGI.

- Especificar uma mscara: Se no optar por usar a mscara padro, deve especifi-car a mscara a ser usada.

Caracteres Visveis ( 0 = conforme a mscara ): Quantos caracteres vo ficar visveis na tela, o valor default dessa opo 0 ( zero ) que assumir o valor de caracteres visveis de acordo com a mscara padro.Maneira de ajudar o usurio a preencher: De que forma o usurio vai preencher os campos: au-tomtica, conforme os campos, ou se existir alguma ligao, conforme a ligao selecionada.OK: Confirma a operao.Cancelar: Cancela a operao.Exemplo de Tela usando uma caixa de edio com o campo Nome:


SGI 22

2.2.3.2 Texto EstticoO texto esttico corresponde a um label. Ao inserir um controle do tipo texto esttico em um formu-lrio X-Window, este deve ter suas propriedades informadas.

Opes da Tela

Frmula que retorna a string que ser colocada no texto: Nesse campo deve ser informado uma frmula que determinar se o texto vai ou no ser retornado.Tamanho aproximado ( em caracteres ): O tamanho do texto esttico que ser retornado.

Exemplo de um texto esttico ( label )colocado em um formulrio:

2.2.3.3 Caixa de VerificaoUma Caixa de Verificao um checkbox que vai ser inserido no formulrio, com as seguintes propriedades:

Opes da Tela

Rtulo: O nome, informao que dever ser mostrado ao usurio para verificao.Campo Correspondente: O campo fsico correspondente.Valor correspondente ao "true": O valor passado que deve ser considerado como verdadeiro.Valor correspondente ao "false": O valor passado que deve ser considerado como falso.OK: Confirma a operao.Cancelar: Cancela a operao.


SGI 23

2.2.3.4 Caixa de TextoUma caixa de texto o mesmo que um memo, onde ser visualizado ou inserido informaes com um tamanho superior a uma linha de dados.

Opes da Tela

Campo correspondente: Campo fsico correspondente.Nmeros de Linhas: Determina o nmero de linhas que essa caixa de textos pode ter.Nmeros de Colunas: Determina o nmero de colunas que essa caixa de textos pode ter.

Exemplo de como fica uma caixa de Edio Multi-linhas ou de texto:

2.2.3.5 BotoUm boto que executa uma ao correpondente a uma ao que vai ser inserida no formulrio, com as seguintes propriedades:

Opes da TelaAo Correspondente: Deve ser informada a ao correspondente no formato Tabela.Acao, quando for uma ao de um campo da Tabela; e somente a Ao, quando for uma ao de um campo da Interface.Rtulo: O nome, informao que dever ser mostrado ao usurio no boto.Tamanho estimado em caracteres (0=auto): Informe o tamanho do boto em caracteres.OK: Confirma a operao.Cancelar: Cancela a operao.

Obs.: Devemos prestar ateno: muitas vezes para que as aes funcionem assim como os bo-tes necessrio que nosso sistema (principalmente Regente e Sapiens) esteja habilitado. Para verificar essa situao vamos ao editor SQL e executamos o seguinte comando: INSERT INTO R900GPR(PRMID,PRMVAL) VALUES(8,'5')ou


SGI 24

UPDATE R900GPR SET PRMVAL = '5' WHERE PRMID=8Este recurso s ira funcionar adequadamente se estiver com a SVCL congelada atualizada, as DLLs atualizadas e o comando acima efetuado.

2.2.3.6 Grid (Grade de Registros)Utilizado quando o usurio for inserir uma linha de dados, o qual pode optar por uma tabela ou grid com as informaes que desejar.

Opes da Tela

Rtulo: Um ttulo para a a grid criada.Tabela-Base: A tabela que vai ser usada nessa grid.Campos-Chave: Os campos-chave que o usurio desejar especificar.Adicionar... : Adiciona uma coluna essa grid com a seguinte configurao:

Opes da Tela

Ttulo da Coluna: Um ttulo para a coluna criada.Campo Correspondente: O campo fsico corres-pondente.Mscara: A mscara desejada.Maneira de ajudar o usurio preencher: Como o usurio vai prencher o campo.OK: Confirma a operao.Cancelar: Cancela a operao.

Alterar...: Abre as prorpiedades da grid para qualquer alterao necessria.Remover: Remove a linha seleciona.Mover p/ cima: Move para cima a linha selecionada em Colunas.Mover p/ baixo: Move para baixo a linha selecionada em Colunas.Linhas Visveis: Determina quantas linhas da grid ficaro visveis.OK: Confirma a operao.Cancelar: Cancela a operao.


SGI 25

Exemplo de uma tela com uma grid:

2.3 Formulrios Web

Utilizado para adicionar um formulrio Web, como demonstrado na tela a seguir.

- Adicionar Formulrio Web (adiciona um formulrio Web novo a ser configurado);

- Adicionar Formulrios Automaticamente (adiciona um formulrio Web a partir de uma interface j existente);

- Adicionar Formulrios X-Window (adiciona um formulrio Web a partir de um formulrio X-Window j existente).

2.3.1 Adicionar Formulrios Web

Um formulrio Web o formulrio onde sero passados os dados da interface, informando como e de que forma esses dados vo ser dispostos em uma tela Web, apresentando assim o resultado fi-nal. A tela a seguir Propriedades do Formulrio Web, mostra onde o usurio poder fazer a con-figurao das propriedades.


SGI 26

Opes da TelaNome do Cadastro: Nome do formulrio.Ttulo da Janela: Ttulo do formulrio(que aparece na tela final).Interface: A interface que ser usada.Tabela Base: A tabela base que ser usada.Campos Chave: Os campos chaves. Pode ter mais de um campo chave.Inserir: Insere linhas de controle. Nessa opo ser mostrada ao usurio uma tela com os tipos de linha que ele pode inserir:

Uma linha com campos para exibio e/ou digitao de valores: Tipo de linha de dado que o usurio pode utilizar para informar ou visualisar:


SGI 27

Opes da Tela

Rtulo: Nome da linha de dado.Adicionar... : Ao clicar nesse boto ser apresentada uma tela ao usurio onde ele poder esco-lher os controles que sero usados nessa linha de dados.

Alterar... : Selecionando uma linha de dados e clicando nesta opo, o usurio poder alterar as informaes dessa linha de dados.Remover: Remove uma linha de dados, basta selecionar a linha a ser removida e clicar em Re-mover.Mover p/ cima: Ao selecionar uma linha de dados o usurio pode moviment-la para cima o quan-to desejar, apenas clicando no boto Mover p/ cima.Mover p/ baixo: Ao selecionar uma linha de dados o usurio pode moviment-la para baixo o quanto desejar, apenas clicando no boto Mover p/ baixo.OK: Confirma as linhas de dados que foram adicionadas.Cancelar: Cancela a operao.

Um separador de sees: Insere uma linha onde for adicionado. O separador de seo-chave: Separa a seo chave do formulrio. Uma Tabela (grid): Insere uma tabela no formulrio.

Alterar: Altera uma linha de controle.Ser aberto ao usurio as mesmas telas que so apresenta-das na insero, para que o usurio altere qualquer informao que achar necessria.Remover: Remove a linha de controle selecionada.Mover p/ Cima: Move para cima a linha de controle selecionada.Mover p/ Baixo: Move para baixo a linha de controle selecionada.Agrupar: Agrupa todas as linhas de controle.Inserir Todos: Insere todos os campos da tabela base, que foram informados na interface, como linhas com campos para exibio e/ou digitao de valores/ (Editbox).Separar Chaves: Ao ativar esta opo o SGI usa um separador para separar as chaves.Aplicar: Confirma a operao. Depois de qualquer alterao necessrio Aplicar antes de Tes-tar. Lembrando que o Aplicar no salva as operaes no banco, sendo necessrio para isso o uso da opo de menu, Gravar Alteraes.Desfazer: Desfaz todas as alteraes feitas antes de Aplicar.Testar: Essa opo testa a interfaceproduzida, se estiver tudo ok, mostra o resultado com os cam-pos e propriedades informados na construo da interface (ainda no funciona para os formulrios Web).Compilar: Compila o formulrio e se no houver nenhum erro mostra a seguinte mensagem: "Seu formulrio foi compilado com sucesso!"Editar Permisses: O usurio escolhe quem ter permisses de acesso a seu formulrio.


SGI 28

Opes da TelaAdicionar...: Adiciona novos usurios.Remover: Remove usurios.Detalhes...: Mostra as permisses a serem liberadas ou no.OK: Confirma a operao.Cancelar: Cancela a oparao.

2.3.2 Adicionar Formulrios Web AutomaticamenteNesta opo o usurio escolhe entre as interfaces (Interface.Tabela_Base) existentes, posiciona-das ao lado esquerdo, e adiciona aos formulrios que deseja utilizar, posicionados ao lado direito. Pode-se adicionar vrios formulrios de uma s vez.

Usando o boto > o usurio adiciona o formulrio selecionado, e < remove-o. Depois de adiciona-dos, um clique sobre eles, mostra as suas propriedades.Torna-se vlido lembrar que adicionando um formulrio Web automaticamente, ele est sendo adi-cionado a partir da interface escolhida, tendo necessidade de personaliz-lo ao seu gosto.OK: Confirma a operao.Cancel: Cancela a operao.

2.3.3 Adicionar Formulrios X-WindowNesta opo o usurio escolhe entre os formulrios X-Window existentes, posicionados ao lado esquerdo e adiciona os que deseja utilizar. Pode-se adicionar vrios formulrios de uma s vez.

Usando o boto > o usurio adiciona o formulrio selecionado, e < remove-o. Depois de adiciona-dos, um clique sobre eles, mostrar as suas propriedades.OK: Confirma a operao.Cancel: Cancela a operao.


SGI 29

3. Tutorial SGI

Este guia foi elaborado para ser usado por usurio iniciante, assim como para aquele que deseja conhecer um pouco mais sobre o SGI. Partimos de que j temos o SGI de-vidamente instalado na mquina.

3.1 Meu Primeiro Formulrio3.1.1 Criao de InterfaceTodo formulrio tem inicialmente uma interface. Para se criar uma interface, deve-se primeiramen-te clicar na opo Interfaces que se encontra no painel esquerdo da tela inicial do SGI, depois va-mos at o painel direito e damos uma duplo clique na opo Adicionar Interface. Como mostrado pela Figura abaixo.

Nesse momento j criamos uma interface com o nome Interface1 como pode ser observado na r-vore das interfaces, agora podemos configurar como quisermos a nossa interface. No campo Nome colocamos o nome que daremos a interface e que ir substituir o nome j existente (Interfa-ce1). Nomes no devem conter caracteres diferentes de letras, nmeros e underline, o espao no um caracter vlido. Em seguida podemos preencher o campo Descrio/Objetivo com uma pe-quena descrio explicativa. Ainda temos o campo Informaes Adicionais onde podem ser co-locadas informaes adicionais sobre a interface gerada.Podemos Desfazer caso o resultado no seja satisfatrio. Agora, resta-nos Aplicar as configura-es, clicando sobre o boto Aplicar.


SGI 30

3.1.2 Adio das TabelasPara guardar nossos campos e registros precisamos criar uma tabela. Para isso vamos na nossa interface, abrimos a rvore e clicamos sobre a opo Tabela de forma a obter a tela a seguir:

3.1.2.1 Adicionar TabelaVamos primeiro adicionar uma tabela simples, dando um duplo clique sobre a opo Adicionar Tabela. Obtendo assim a tela para a configurao da nossa primeira tabela. Preenchemos o cam-po Nome, e no campo Tabela fsica clicando sobre o boto elipse (...) escolheremos uma dentre as tabelas contidas na base de dados. A tabela fsica que servir de base para nossa interface.Temos ento que ver as permisses. Se a tabela fsica escolhida for uma tabela do sistema, pro-vavelmente no teremos opo de modificar as permisses, porm se for uma tabela do usurio (com o nome comeando com USU_xxx), podemos determinar as permisses setando as opes entre insero, alterao e excluso dos registros da tabela, conforme descrito na figura abaixo.

Podemos agora determinar as condies para ta-bela conforme a necessidade que se tenha.

Temos tambm o campo Informaes Adicio-nais onde podemos acrescentar informaes a nossa tabela.

Agora podemos aplicar nossas configuraes, cli-cando sobre o boto Aplicar.


SGI 31

3.1.2.2 Adicionar Tabelas FsicasPodemos ainda adicionar uma ou mais tabelas fsicas das contidas na base de dados. Vamos ao painel direito da tela do SGI, damos um duplo clique sobre a opo Adicionar Tabela Fsica ( Tela Anterior),obtendo a seguinte tela:

Devemos selecionar a(s) tabela(s) desejada(s) e clicar no boto ">" para adicionar. Para remover uma tabela que foi selecionada deve-se clicar sobre ela e usar o boto "

SGI 32

pondente, clicamos sobre o boto elipse (...) e vamos obter as opes de campos fsicos contidos na tabela que foi designada anteriormente como tabela fsica. Temos ainda que preencher o cam-po Tipo de dado, com uma das opes Boolean, Number, String e Date.O campo Informaes Adicionais deve conter qualquer informao que possa ajudar na compre-enso do campo, e aps j pode Aplicar.

3.1.3.1.2 Adio de um Campo LookupUm campo Lookup um campo que tem relao com campos de outra tabela. Geralmente usa-do para campos descritivos.Para podermos criar um campo lookup temos inicialmente que criar uma ligao, que ser visto posteriormente.Depois de fazermos a ligao podemos iniciar a criao do nosso campo Lookup da tabela. Clica-mos sobre sua opo no painel direito do SGI que conseqentemente nos leva a tela de configura-o. Preenchemos o campo Nome e vamos para o campo seguinte determinar a Ligao atravs do boto elipse(...). Feito isso podemos determinar o Campo fsico.Podemos ainda informar o Campo Vinculado e Informaes Adicionais se for necessrio.

3.1.3.1.3 Adio de um Campo da TabelaUm campo adicionado a partir dessa opo um campo que tem relao com campos do usurio. Ele j vem configurado e pronto para ser utilizado.


SGI 33

3.1.3.2 Adio de Campos da InterfaceQuando no possumos algum campo desejado entre os campos das tabelas, criamos nosso pr-prio campo da interface. Precisamos para isso ir at a rvore da nossa interface, posicionada no painel esquerdo do SGI e clicar sobre a opo Campos da Interface. Dessa forma sero mostrados as opes de campo para se adicionar. Clicando sobre uma das opes, abrir a tela para configurao do campo da interface, que ser a mesma tela dos campos da tabela, sejam eles simples ou lookup.

3.1.4 Adio de LigaoO que faremos agora uma ligao entre duas tabelas e seus campos, basicamente uma refern-cia para consulta. Para isso retornados a rvore do SGI e clicamos sobre a opo Ligaes que uma ramificao da nossa interface. No painel esquerdo do SGI vamos ter a opo Adicionar Li-gao e com um duplo clique sobre ela obtemos a tela a seguir:

Temos ento que escolher o tipo de ligao:Simples: uma ligao entre campos das tabelas designadas.Customizada: uma ligao atravs de uma expresso, por exemplo, quando desejarmos que al -gum campo da tabela seja igual a 1.Vamos fazer uma ligao simples, porm a customizada segue o mesmo estilo. Selecionamos Simples e clicamos em OK. Aps, passamos a ter a tela (figura a seguir) para configurao da nossa ligao.Preenchemos o campo Nome, o campo Tipo, onde devemos informar o tipo de ligao dentre as opo disponveis atravs do B2. O campo Tabela da esquerda que devemos preencher com uma das tabelas da interface que foi criada anteriormente e o campo Tabela da direita que vai va-riar de acordo com o Tipo que foi definido. Aqui deve ser observado que a tabela da esquerda e da direita devem obedecer a mesma ordem do tipo de ligao.Agora que j ligamos as tabelas, devemos ligar os campos das tabelas. Isto pode ser feito pela grid Campos de ligao. Clicando no boto Adicionar podemos informar os campos da esquerda e da direita, que estaro disponveis atravs do boto elipse (...), de acordo com as tabelas defini-das para a ligao. Aqui tambm temos o campo Informaes Adicionais que deve ser preenchido com dados adi-cionais sobre a ligao.


SGI 34

Somente aps definio da ligao possvel criar o campo Lookup...

3.1.5 Criao de FormulriosCriada a interface podemos comear a criao do nosso formulrio. O Formulrio um dos ele-mentos mais importantes do SGI, pois ele quem define o layout da nossa tela.

3.1.5.1 Formulrios X-WindowPara adicionar o formulrio necessrio um duplo click na opo Formulrio X-Window, como demonstrado na tela a seguir.

Em seguida ir aparecer no painel esquerdo da tela do SGI a opo Adicionar Formulrio X-Window, damos um duplo clique sobre ela e obtemos a tela para configurao da nossa interface (Tela Propriedades do Formulrio X-Window). Assim, vamos preenchendo os campos Nome, com o nome que chamaremos nossa interface e que ir substitur o nome Formulrio1 que foi dado como padro pelo SGI. Lembrando que os nomes no devem conter caracteres diferentes de le-tras, nmeros, underline e espao no um caracter vlido. Preenchemos tambm o Ttulo da Janela com o nome que desejamos que aparea na apresentao final da tela. Depois com os campos Interface, Tabela-Base e Campos Chave de acordo com o que foi criado anteriormente.Os formulrios X-Window permitem a criao de abas, que possibilitam a visualizao de mais p-ginas em uma tela. Elas podem ser adicionadas atravs do boto Adicionar Pg. e removidas pelo boto Remover Pg., os botes "" so utilizados para ordenar as pginas no formulrio. Deve ser observado que para a criao de pginas em um formulrios, estas pginas devem per-tencer ao mesmo nvel.Agora vamos preencher cada pgina individualmente com suas propriedades: Ttulo e se possuir uma Tabela Detalhe devemos inform-la tambm, junto a sua chave. vlido lembrar que os no-mes para estes campos devem ser exatamente os mesmos com que foram criados, obedecendo letras maisculas e minsculas. Preenchemos a grade linhas de controle com as linhas que de-


SGI 35

sejamos na nossa tela. Elas podem ser adicionadas atravs do boto Inserir que abrir a tela a seguir:

Podemos escolher o tipo da linha de dado que desejamos. Uma linha para exibio e/ou digita-o de valores, o mais comumente usado, pode ser adicionado pela primeira opo, podendo em seguida escolher os controles que sero usados nessa linha de dados, este procedimento est melhor detalhado na seo Melhorando a Apresentao no Item Linhas de Controle. Se optar por adicionar um separador de sees ser inserido uma linha e optando por separador de seo-chave, vamos separar o formulrio por uma seo-chave.Um fato importante a ser observado que todo formulrio deve possuir um separador de seo-chave, se existir mais uma pgina se faz necessrio somente na primeira ou na pgina que pos-sua tabela-detalhe.

Desta forma, o formulrio est configurado e pronto para a execuo e testes.


SGI 36

3.1.5.2 Formulrios X-Window AutomaticamentePodemos criar formulrios X-Window Automaticamente, isto , a partir de uma interface predefini -da. Voltamos a tela inicial do SGI, clicando sobre Formulrios X-Window aparecer no painel es-querdo as opes de formulrios, dessa vez damos duplo clique sobre Adicionar Formulrios Automaticamente, o qual mostrar a tela a seguir:

Temos condies de criar o formulrio a partir interface.tabela. Usamos o boto ">" para adicionar o formulrio selecionado, e "

SGI 37

3.1.6 Execuo e TestesCom as instrues para criao do formulrio executadas temos que Aplicar para que as configu-raes sejam aplicadas ao formulrio, e aps, podemos Testar para ver resultado. Exemplo de uma tela que foi testada ...

Se no precisamos fazer mais nenhuma alterao podemos Compilar o formulrio, e se no hou-ver nenhum erro ser mostrada a seguinte mensagem: "Seu formulrio foi compilado com suces-so!".

Torna-se vlido salientar que quando aplicamos um formulrio e seguidamente testamos e compi-lamos, como acabamos de fazer, estamos somente confirmando a operao, no significa que ter-minamos.

Depois de qualquer outra alterao necessrio Aplicar antes de Testar. Lembrando que essa operao no grava nada no banco.

Quando o cone de uma interface ou formulrio fica circundado por uma linha vermelha significa que fizemos uma alterao e no salvamos. Ento precisamos sempre gravar as alteraes para no perd-las, isto pode ser obtido atravs do menu Arquivo|Gravar alteraes.

3.2 Criando ConsistnciasO SGI fornece vrias maneiras de criar consistncias, para que tudo ocorra como previsto, deve-mos criar consistncias em lugares especficos.

3.2.1 Consistncias a Nvel de TabelaAs consistncias a nvel de tabela devem ser configuradas na prpria tela de configurao da ta -bela, que est sendo mostrada na figura a seguir.


SGI 38

Podemos iniciar nossas consistncias setando as permisses. Permitindo ou no a insero, alte-rao e excluso de registros na nossa tabela. Muitas vezes as tabelas do sistema no nos do essa liberdade, pois o SGI muitas vezes restringe essa configurao somente as tabelas do usurio (as que o nome comea com USU_xxx), isso deve ser observado para no causar mal entendimento.Ento podemos informar as outras consistncias a partir dos campos que ficaram habilitados.Muitas vezes queremos permitir insero, alterao e excluso, somente em alguns casos. Para isso temos as condies que devem ser preenchidas com expresses SQL correspondentes.

Condio para ativar a insero de Registros: Expresso SQL. Condi-o usada para determinar quando se pode inserir registros. Condio para ativar a alterao do registro corrente: Expresso SQL. Condio usada para determinar quando se pode alterar registros. Condio de validao geral: Expresso SQL. Condio usada para vali-dar todas as operaes da tabela. Condio para validar um novo registro: Expresso SQL. Condio usada para determinar quando um registro novo valido. Condio para validar um Registro sendo alterado: Expresso SQL. Condio usada para determinar quando uma alterao vlida. Condio para ativar a excluso do registro corrente: Expresso SQL. Condio usada para determinar a excluso de um registro corrente.

Alm destas consistncias, pode-se fazer algumas consistncias atravs do boto Onde podemos editar uma regra utilizando a linguagem LSP, tendo o cuidado apenas com alguns comandos especficos apenas ao editor de regras do SGI.

Alguns Comandos Utilizados neste item:

CodOpe: Varivel utilizada para identificar o estado em que a tela se encontra no momento. Os estados possveis so:

Iniciando - (Inicializao da Tela);


SGI 39

DepoisSelecionar (Depois de Selecionar um Registro); AntesInserir (Antes da Insero de um Registros); AntesAlterar (Antes da Alterao de um Registro); AntesExcluir (Antes da Excluso de um Registro); DepoisInserir (Depois da Insero de um Registros); DepoisAlterar (Depois da Alterao de um Registro); DepoisExcluir (Depois da Excluso de um Registro);

Exemplo:Se (CodOpe "Iniciando") Inicio /*** Bloco de Comandos ***/ Fim;

Se (CodOpe = "AntesInserir") Inicio /*** Bloco de Comandos ***/ Fim;SenaoSe (CodOpe = "AntesAlterar") Inicio /*** Bloco de Comandos ***/ Fim;SenaoSe (CodOpe = "AntesExcluir") Inicio /*** Bloco de Comandos ***/ Fim;

Cancel(1): Cancela a execuo do Estado que est sendo executado no momento.

Campos da Tabela: Os campos da Tabela que esto no formulrio, para serem identificados de-vem ter o seguinte formato NomeTabela_NomeCampo.Exemplo:

Definir Alfa VCodCar;Definir Alfa VClaSal;Definir Alfa VNivSal;

/**** Atribuio de Campos da Tabela HistFun, definida na Interface ****/VEstCar = HistFun_EstruturaCargo;VCodCar = HistFun_Cargo;VEstSal = HistFun_EstruturaSalarial;VClaSal = HistFun_Classe;VNivSal = HistFun_Nivel;VCodMot = HistFun_Motivo;

MsgErro: Permite mostrar uma mensagem de erro durante a execuo de um processo, desde que na sequncia do comando seja executado o comando Cancel(1).Exemplo:

Se (CodOpe = "AntesInserir") Inicio Se (HstFun_DataInicio = 0) Inicio MsgErro = "A Data Incio deve ser preenchida! "; Cancel(1); Fim; Fim;


SGI 40

Obs.: Todos os comandos disponveis nas regras, gerador e importao e exportao esto dis-ponveis tambm nas regras do SGI.

3.2.2 Consistncias a Nvel de CampoAs consistncias particulares do campo podem ser configuradas a partir da tela de configurao do campo, seja ele campo da tabela ou da interface. Contudo as consistncias de campo no podem ser aplicadas a campos lookup.Devemos primeiramente acessar o campo (da tabela ou da interface) e clicar sobre ele, que estar posicionado na rvore do SGI. Aps isso obtemos a tela a seguir:

Podemos iniciar a configurao das consistncias pelo campo Frmula do valor-padro que pode ser informado diretamente no campo, ou pelo boto Avanado. Esse valor informado no campo, o valor com o qual esse campo ir iniciar. Depois informamos a Condio de relevn-cia atravs de uma expresso SQL, essa condio determina a importncia do campo. Seguida-mente temos a Condio de editabilidade, preenchida tambm com uma expresso SQL, ela in-dica a condio para que o campo se torne editvel.

Temos ainda o checkbox para no permitir que o campo receba valor nulo.O campo Condio de Validao atravs do boto avanado, nos fornecer a tela a seguir para configurao das condies:

Nesta tela, atravs do boto Adicionar podemos criar a condio de validao. Preenchemos o campo Condio de forma que ele no permitir valor nulo nem zero e se um desses valores for


SGI 41

digitado, emitir a mensagem descrita no campo Mensagem. Voc pode preencher com outras condies tambm.

3.3 Melhorando a Apresentao

Agora que j sabemos as operaes bsicas do SGI, como criar interface, os campos e o formul-rio, podemos melhorar a apresentao incluindo alguns elementos disponveis nessa seo.O SGI possui alguns recursos que ajudam a tornar nossas telas mais fceis de serem utilizadas. So recursos simples e que atribuem grandes resultados.

3.3.1 Usando listasPodemos incrementar nossa tela adicionando listas de opes aos campos.

Para fazermos isso precisamos ir at a tela de Configurao do Campo, seja ele da tabela ou da interface. Alteramos o campo Lista para escolha do valor, atravs do boto elipse (...) temos v-rias opes de listas. Podemos citar como exemplo a lista de meses, LMesDes; lista apenas com valores, sim e no, LSimNao; dentre outras. Assim, podemos escolher a que melhor se adapta ao nosso formulrio.

Feita a escolha, temos que clicar sobre o boto Aplicar, para aplicarmos a lista a nossa interface. Se o formulrio j estiver criado, precisamos compil-lo e em seguida gravar, atravs da opo Ar -quivo|Gravar Alteraes.

Esta propriedade torna muito mais fcil a utilizao da tela pelo usurio.

3.3.2 Modificando o Rtulo dos FormulriosPara modificarmos o rtulo dos formulrios basta irmos na tela de Configurao do Formulrio e alterar o campo Ttulo da Janela para o nome que desejamos que aparea na tela pronta.Depois de alterado, precisamos Aplicar e em seguida Testar e verificar o resultado. Se o resulta-do ficou bom, podemos compil-lo, atravs do boto Compilar do formulrio e em seguida gravar, atravs da opo Arquivo|Gravar Alteraes.Lembrando que esse procedimento vlido tanto para formulrios X-Window como para formul-rios Web.

3.3.3 Linhas de ControlePodemos melhorar a apresentao do nosso formulrio oferecendo ao usurio tipos de campos que ajudem ele a preencher com valores vlidos. Estes recursos esto disponveis no SGI tam-bm, vejamos nesta seo.

3.3.3.1 Caixa de EdioA Caixa de Edio o recurso mais utilizado para inserir linhas de controle ao nosso formulrio, isso se deve ao motivo de poder ser utilizado praticamente em todo tipo de campo.Para adicionarmos as linhas de controle, vamos at a tela de Configurao do Formulrio e clica-mos sobre o boto Inserir, o SGI ento nos mostrar os modelos de linhas que podemos inserir, como j foi mostrado em parte na seo Criao Formulrio X-Window. Vamos optar por Uma li-nha com campos para exibio e/ou digitao de valores, em seguida teremos uma nova tela, conforme tela a seguir.


SGI 42

Devemos agora configur-la da seguinte maneira: no campo Rtulo colocamos o nome que que-remos que aparea na nossa tela para esse campo. Procure colocar nomes significativos. Em se-guida clicamos sobre o boto Adicionar e temos o menu que espervamos, no qual poderemos escolher o tipo da linha de dados.

Agora ento vamos optar por Uma caixa de edio(editbox) que a primeira opo. Abrir en-to uma segunda tela para configurao (tela a seguir). Preenchemos o Campo correspondente, com o campo da tabela que corresponder a este edit, podemos utilizar o boto elipse (...). Infor-mamos o tipo da Mscara a ser utilizada, lembrando que deve ser compatvel com a mscara do campo correspondente, se for informado diferente, a mscara informada aqui tem prioridade. De-pois podemos informamos a Quantidade de campos visveis e em seguida a Maneira que ajuda o usurio a preencher o campo, com a forma que o usurio vai preencher os campos: automti-ca, conforme os campos, ou se existir alguma ligao, conforme a ligao selecionada.Com nosso campo configurado adicionamos uma linha aos controle X-Window atravs do boto

OK, e em seguida aparecer a seguinte tela:

Retornamos ao formulrio, e clicamos sobre o boto Aplicar, e em seguida podemos Testar para verificar o resultado.


SGI 43

3.3.3.2 Caixa de VerificaoPara adicionarmos as linhas de controle, vamos at a tela de configurao do formulrio e clica-mos sobre o boto Inserir, o SGI ento nos mostrar os modelos de linhas que podemos inserir. Vamos optar por Uma linha com campos para exibio e/ou digitao de valores , em seguida teremos uma nova tela, como demosntrada na tela a seguir:


Agora ento vamos optar por Uma caixa de verificao(checkbox) que a segunda opo. Abri-r ento uma segunda tela para configurao (Figura abaixo). Preenchemos o campo Rtulo com o nome que desejamos que aparea para esse campo, em seguida informamos o Campo corres-pondente que pode ser pesquisado atravs do boto elipse (...) e nos campos Valor correpon-dente ao "true" informamos o valor que deve ser considerado verdadeiro e no campo Valor cor-repondente ao "false" informamos o valor que deve ser considerado falso.


SGI 44

3.3.3.3 Texto EstticoOs textos estticos so utilizados junto aos campos que necessitam de descrio para serem en-tendidos. Este tipo de linha de controle utilizada somente para visualizao, no podendo ser al -terada pelo usurio.Quando usamos um campo lookup vamos utilizar tambm um Texto Esttico, label.Para adicionarmos as linhas de controle, vamos at a tela de configurao do formulrio e clica-mos sobre o boto Inserir, o SGI ento nos mostrar os modelos de linhas que podemos inserir. Vamos optar por Uma linha com campos para exibio e/ou digitao de valores , em seguida teremos uma nova tela, como demonstrado na figura abaixo.

Devemos agora configur-la da seguinte maneira: no campo Rtulo colocamos o nome que que-remos que aparea na nossa tela para esse campo. Procure colocar nomes significativos. Em se-guida clicamos sobre o boto Adicionar e temos o menu que espervamos, no qual poderemos escolher o tipo da linha de dados .

Agora ento vamos optar por Um texto esttico (label) que a terceira opo. Abrir ento uma segunda tela para configurao (Figura abaixo). Preenchemos o campo Frmula que retorna a string que ser colocada no texto:, com o nome da Tabela.Campo e o campo Tamanho aproxi-mado, com o nmero de caracteres aproximado que aparecer na tela. No caso da listagem do contedo de um campo que lista a sintaxe Tabela.desc_CampoLista. Exemplo: R034FUN.desc_TipSex.


SGI 45

3.3.3.4 Caixa de Edio Multi-linhasUma Caixa de Edio Muti-linhas muito parecida com uma caixa de edio normal, porm ela pode ser melhor dimensionada. geralmente utilizada para campos que guardam observaes, detalhamentos, dentre outros.Para adicionarmos as linhas de controle, vamos at a tela de configurao do formulrio e clica-mos sobre o boto Inserir, o SGI ento nos mostrar os modelos de linhas que podemos inserir. Vamos optar por Uma linha com campos para exibio e/ou digitao de valores , em seguida teremos uma nova tela, como demonstrado na figura abaixo.


Agora ento vamos optar por Uma caixa de edio multi-linhas (memo) que a quarta opo. Abrir ento uma segunda tela para configurao (Figura abaixo). Preenchemos o Campo corres-pondente, com o campo da tabela a que nos referimos, em seguida o campo Nmero de Linhas com o nmero de linhas que desejamos no nosso memo e depois o Nmero de Colunas. Cada caracter represente uma linhaXcoluna.


SGI 46

3.3.3.5 Um Boto que executa uma Ao

Podemos criar botes no nosso formulrio para executar a ao criada anteriormente. Tomamos como base aqui que j temos o formulrio criado, porm podemos criar os botes a medida que estamos criando o formulrio.Vamos ao formulrio que utiliza a inteface na qual foi criada a ao e na sua tela de configurao, nas linhas de controle vamos at o campo para o qual foi criada a ao, posicionamos o cursor so-bre ele e clicando sobre o boto Alterar temos como incluir um boto que executar a Ao.Clicamos no boto Adicionar, na tela seguinte vamos escolher a ultima opo Um boto que executa uma ao.

Ento abrir a tela para configurao do boto. No campo Ao correpondente informamos a Ta-lela.Acao, no Rtulo informaremos o nome do boto e se for necessrio informe tambm o Tama-nho estimado em caracteres do boto.

Ento s clicar no boto OK.Retornamos a tela da Linha de dados e podemos observar que foi includa uma linha para o boto. Clicamos aqui tambm sobre o boto OK.

Retormanos ao nosso formulrio, aplicamos as alteraes clicando sobre o boto Aplicar e em seguida podemos Testar para verificar. Conforme a tela a seguir, esta mostra que foi includo um boto ao lado do campo especificado anteriormente:


SGI 47

3.4 Criando Grids no FormulrioPara melhorar nossa tela podemos acrescentar grids, que tornaro melhor a visualizao.Para adicionar uma grid devemos clicar sobre o nosso formulrio. Na tela direita do SGI ir apare-cer a tela de configurao, devemos ento clicar sobre o boto Inserir e escolher dentre as op-es, Uma tabela (grid), que nos fornecer a tela para configurao da grid. Informamos assim, o Rtulo, nome da nossa grid; a Tabela-base e o(s) Campo(s)-chave. Se j tivermos idia do tamanho da nossa grid podemos informar a quantidade de linhas a ser vi-sualizada pelo campo Linhas Visveis.

Para acrescentarmos as colunas, que sero as prprias colunas da grid na nossa tela, devemos primeiramente clicar sobre o boto Adicionar e ele nos fornecer uma tela (Figura a seguir) para que possamos configurar. Os demais botes Alterar, Remover, Mover p/ cima e Mover p/ baixo sero usados se houver a necessidade de arrumar na tela os campos que esto sendo adiciona-dos.


SGI 48

No campo Ttulo da coluna, informamos o nome que aparecer na grid para essa coluna que es-tamos configurando; seguidamente informamos o Campo correspondente, que o campo fsico; depois a Mscara que ir ajudar bastante, pois determinar o tamanho do campo exibido na tela (quando este campo for deixado em branco assume a mscara do campo fsico) e por ltimo a Maneira de ajudar o usurio a preencher, que pode ser escolhido atravs do boto B2, de acor-do com a sua preferncia.

Feito isso, a grid est quase pronta. Temos que retornar ao formulrio, Aplicar as alteraes e Testar.

Na tela a seguir, temos um exemplo de uma tela com a grid.

3.5 Criando Aes

O SGI no trabalhava com o conceito de botes, para tratar tal necessidade foram criadas as aes. Podemos incluir uma ao a nossa interface e seguidamente um boto ao nosso formul-rio. Precisamos ir at o painel principal SGI, clicar sobre a Interface que desejamos incluir a ao e abrir a rvore.

As aes podem ser includas tanto para os campos da interface, como para os campos da tabela.Vamos fazer no campo da tabela, que o mais usual, porm os mesmos passos podem ser segui-dos para os campos da interface. Abrimos a tabela e podemos observar que surgiu a opo Aes da Tabela. Clicamos sobre ela e no painel direito do SGI temos a opo Adicionar Ao.

Clicando sobre esta opo ir abrir a tela para configurao da Ao. No campo Nome informare-mos o nome da ao que ir substituir o nome padro dado pelo SGI, Acao1, Acao2... No campo Condio para ativao, devemos informar sempre uma condio atravs de uma expresso SQL, nesse caso o true permite que ao funcione sempre que acionada. Em seguida temos o bo -to para Exibir e Editar as regras, onde devem ser criadas as regras que designaro a funcionali-dade da ao.Nesse exemplo inclu apenas a linha: HstTit_Titulacao = HstTit_Titulacao + 1; que ir incrementar a titulao a cada vez que o boto for pressionado.


SGI 49

Ainda temos o campo Informaes Adicionais que pode ser preenchido com informaes que ajudam na compreenso da Ao.Depois s temos que clicar no boto Aplicar para confirmar a operao.

Obs.: Somente aps a criao da ao que ser possvel criar um boto que executa uma ao no formulrio.

3.6 Como Editar um FormulrioCom o nosso formulrio pronto e configurado a gosto podemos edit-lo em um aplicativo Senior, para isso devemos seguir os seguintes passos:Vamos at o menu do SGI, em Sistema|Configurar Menu X-Window. Ele ento abrir uma tela e no campo Mdulo informamos o mdulo no qual desejamos inserir nosso formulrio.Clicando em seguida no boto Adicionar vamos obter uma segunda tela chamada Propriedades do Menu, na qual informaremos o campo Rtulo, com o nome que gostaramos que aparecesse no menu do aplicativo Senior, e no campo Formulrio, informamos o formulrio por ns criado e compilado.

Obs.: Somente aps reiniciado o sistema que constar o formulrio no menu.


SGI 50

Exerccios

1) Definir no CBDS um cadastro de Vales para os colaboradores com os seguintes Campos: Cdigo Empresa - chave Tipo de Colaborador (1- Empregado, 2 Terceiro, 3 - Parceiro)- chave Cadastro do Colaborador - chave Competencia (MM/YYYY) chave Tipo de Vale (1- Vale Mercado, 2 Vale Alimentao) Valor do Vale Quantidade de Vales Valor Total.

Aps a definio da tabela, criar uma tela, conforme demonstrado abaixo:

Observaes a serem seguidas na construo da Tela:

- Mostrar os Registros somente na Empresa Ativa.

- Buscar o nome do Colaborador;

- Mostrar a descrio de todos os campos que possuem lista na Tabela.

- Colaborador tipo Empregado pode receber qualquer tipo de vale, j colaborador tipo Terceiro poder receber somente Vale Mercado. Tipo de Colaborador Parcei-ro no poder receber vales (neste caso quando o usurio digitar o Tipo 3 dever aparecer uma mensagem de aviso que Colaborador Parceiro no recebe Vale).

- Para Vale Alimentao, o Valor do Vale dever ser o unitrio.

- Para Vale Mercado, o campo Valor dever ter o total a ser entregue ao colaborador e o campo Quantidade de Vales dever estar desabilitado para o preenchimento.

- O Valor Total dever ser preenchido automaticamente com o seguinte clculo (quantidade de vales * valor do vale).


SGI 51

2) Criar uma Tabela de Estoque de Produtos Qumicos e outra tabela de Vendas de Produtos qumicos no CBDS com os seguintes Campos:

Estoque de Produtos Qumicos- Cdigo da Empresa - chave- Cdigo do Produto - chave- Nome Comercial do Produto- Tipo (agua,combustvel,solvente,cido,p,capsula)- Risco a Sade (inexistente,leve,mdio,alto)- Flamabilidade (inexistente,leve,mdio,alto)- Corrosividade (inexistente,leve,mdio,alto)- Unidade de Medida (mililitros, li-tros, gramas, quilos, toneladas)- Preo Unitrio de Compra

- Quantidade em EstoqueVendas de Produtos Qumicos

- Cdigo da Empresa - chave- Cdigo do Produto - chave- Data de Sada do Produto chave- Sequncia do Produto - chave- Quantidade Vendida- Preo Unitrio de Venda- Valor Total da Venda.

Aps criar as tabela de Estoque de Produtos Qumicos, definir no SGI as seguinte tela.

Observaes a serem seguidas na construo da Tela:- Cadastrar somente na Empresa Ativa.- Buscar as descries dos campos listas

Aps criar as tabela de Venda de Produtos Qumicos, definir no SGI as seguinte tela:

Observaes a serem seguidas na construo da Tela:- Cadastrar somente na Empresa Ativa.- Buscar o nome do Produto.- Calcular aotomaticamento o Valor Total da Venda.- Mostrar na tela a Quantidade de Produtos em Estoque, e o Valor de Compra do

Produto.- Calcular o Lucro.


SGI 52

- No permitir a venda de uma quantidade de produtos superior ao que existe em es-toque. Neste caso, mostrar uma mensagem de que no existe produtos suficientes em estoque .

- No permitir a venda de um produto com o valor de venda menor que o valor de compra. Neste caso, mostrar uma mensagem de que o valor de venda no poder ser menor que o valor de compra.

- No permitir Alterao de Registros nesta Tela.

3) Definir no CBDS duas tabelas, uma para cadastrar os Materiais de Segurana e Medicina, e outra para o cadastro da Aquisio de Materiais, conforme os campos descritos a baixo:

Materiais de Segurana e Medicina- Cdigo da Empresa - chave- Cdigo do Material - chave- Descrio do Material- Finalidade (1 - segurana do traba-lhador, 2 - Combate a Incndio, 3 Mdica, Clni-ca e Cirrgica)- Nome do Fabricante- Endereo- Cep- Telefone- Cidade

- EstadoAquisio de Materiais de Segurana e Medicina

- Cdigo da Empresa - chave- Cdigo do Material chave- Lote - chave- Data de Aquisio chave- Data de Validade- Quantidade Adquirida

Para a tabela de Materiais de Segurana e Medicina, criar uma tela como demonstrado na tela a seguir:

Na criao desta tela os seguintes procedimentos devem ser seguidos:- Cadastrar os materiais somente na empresa ativa.- Buscar as descries do nome da Cidade, Estado e do Tipo de Material.- Em caso de excluso de algum registro, deve-se excluir todos os registros relacio-

nados a este material na tabela de Aquisio de Materiais de Segurana e Medici -na.

Para a tabela de Aquisio de Materiais de Segurana e Medicina, criar uma tela como demons-trado na tela a seguir:


SGI 53

Observaes a serem seguidas na construo desta tela:

- Cadastrar as aquisies somente na Empresa Ativa.

- Buscar a descrio do Material.

- No adquirir materiais com data de validade inferior ou igual a data de aquisio.

Aps a construo das telas acima descritas, deve-se criar uma tela para a Consulta de Materiais de Segurana e Medicina, conforme a tela a baixo:

Observaes a serem seguidas na construo desta tela:

- Listar o nome da Empresa e Material, alm da descrio da Finalidade do Produto.

- Criar uma Tabela(Grid) como demostrado acima, sendo que a Descrio da Situa-o do Material deve ser verificada de acordo com a Data de Validade do Material e a Data do Sistema, mostrando uma mensagem como demostrado na tela anterior.

- Permitir Somente a consulta nas tabelas utilizadas na tela.

- Desabilitar para digitao os campos da tabela de Materiais e Aquisio.


1. Guia de Referncia do SGI1.1 Conceito1.2 Menu Principal1.2.1 Arquivo1.2.1.1 Gravar Alteraes1.2.1.2 Importar1.2.1.2.1 Opes da Tela

1.2.1.3 Exportar1.2.1.3.1 Opes da Tela

1.2.1.4 Sair

1.2.2 Sistemas1.2.2.1 Configurar Menu X-Window...1.2.2.1.1 Opes da Tela

1.2.3 Ajuda1.2.3.1 Sobre

1.3 Navegao no Editor 1.3.1 Adicionar Interfaces 1.3.2 Adicionar Tabelas1.3.3 Adicionar Campos da Tabela1.3.4 Campos da Interface1.3.5 Adicionar Aes1.3.6 Adicionar Ligaes1.3.7 Adicionar Formulrios X-Window

2. Elementos do SGI2.1 Interface2.1.1 Tabelas2.1.1.1 Adicionar Tabela2.1.1.2 Adicionar Tabelas Fsicas

2.1.2 Campos Simples2.1.2.1 Adicionar Campo Simples (Tabela)2.1.2.2 Adicionar Campo Fsico2.1.2.3 Adicionar Campo Simples (Interface)

2.1.3 Campos Lookup2.1.3.1 Adicionar Campo Lookup (Tabela)2.1.3.2 Adicionar Campo Lookup (Interface)

2.1.4 Ligaes2.1.4.1 Ligaes Simples2.1.4.2 Ligaes Customizadas

2.1.5 Adicionar Ao da Tabela2.1.6 Adicionar Ao da Interface

2.2 Formulrios X-Window2.2.1 Adicionar Formulrios X-Window2.2.2 Adicionar Formulrios Automaticamente2.2.3 Controles do Formulrio X-Windows2.2.3.1 Caixas de Edio2.2.3.2 Texto Esttico2.2.3.3 Caixa de Verificao2.2.3.4 Caixa de Texto2.2.3.5 Boto2.2.3.6 Grid (Grade de Registros)

2.3 Formulrios Web 2.3.1 Adicionar Formulrios Web2.3.2 Adicionar Formulrios Web Automaticamente2.3.3 Adicionar Formulrios X-Window

3. Tutorial SGI3.1 Meu Primeiro Formulrio3.1.1 Criao de Interface3.1.2 Adio das Tabelas3.1.2.1 Adicionar Tabela3.1.2.2 Adicionar Tabelas Fsicas

3.1.3 Adio dos Campos3.1.3.1 Adio de Campos da Tabela3.1.3.1.1 Adio de um Campo Simples3.1.3.1.2 Adio de um Campo Lookup3.1.3.1.3 Adio de um Campo da Tabela

3.1.3.2 Adio de Campos da Interface

3.1.4 Adio de Ligao3.1.5 Criao de Formulrios3.1.5.1 Formulrios X-Window3.1.5.2 Formulrios X-Window Automaticamente3.1.5.3 Criao de Formulrios Web

3.1.6 Execuo e Testes

3.2 Criando Consistncias3.2.1 Consistncias a Nvel de Tabela3.2.2 Consistncias a Nvel de Campo

3.3 Melhorando a Apresentao3.3.1 Usando listas3.3.2 Modificando o Rtulo dos Formulrios3.3.3 Linhas de Controle3.3.3.1 Caixa de Edio3.3.3.2 Caixa de Verificao3.3.3.3 Texto Esttico3.3.3.4 Caixa de Edio Multi-linhas3.3.3.5 Um Boto que executa uma Ao

3.4 Criando Grids no Formulrio3.5 Criando Aes3.6 Como Editar um Formulrio

Exerccios

ERP Apostila SGI

Documents

Transcript of ERP Apostila SGI