ddk gui - sanderleisilveira.com.br · 4 importação exportação pesquisa vá para digitação...

1

DDK GUI

Parte 2

Tecnologia

2

Agenda

1 Parte

Nomenclatura

Estilos

Cadastro Simples

Cadastro Simples – Alteração

Cadastro Simples – Inclusão

Cadastro Complexo

Cadastro Complexo – Alteração

Pai x Filho – Atualiza Filho

Manutenção de Filhos

3

Pai x Filho – Atualiza Ambos

Manutenção de Pais

Consulta Simples

Consulta Complexa

Consulta Relacionamento

Relatórios / Cálculos / Fechamentos

Parâmetros Únicos

Parâmetros Múltiplos

Formação

Formação sem Navegação

Agenda

4

Importação

Exportação

Pesquisa

Vá Para

Digitação Rápida

Painéis

Funções – Relatórios Relacionados

Funções – Consultas Relacionadas

Menu de Barra

Agenda

5

Parte 2

Construção

SmartQuery

SmartViewer – Padrão

SmartViewer – Sem Campos de Tabela

SmartViewer – Só com Campos Chave

Parte 3

CustomBrowser Inclui/Modifica

CustomBrowser Zoom Wizard

Vá Para

Pesquisa

Agenda

6

Cadastro Simples

Parte 4

Cadastro Simples Alteração

Cadastro Simples Inclusão

Cadastro Complexo

Cadastro Inclui/Modifica Filho

Cadastro Pai x Filho – Atualiza Filho

Cadastro Inclui/Modifica Pai

Cadastro Pai x Filho – Atualiza Ambos

Parte 5

Consulta Simples

Agenda

7

Consulta Complexa

Consulta Relacionamentos

Parâmetros Únicos

Formação

Parte 6

Relatórios

Importação

Exportação

CustomBrowser Digitação

Digitação Rápida

Agenda

8

Parte 7

Includes e Utilitários Padrão

UT_FIELD.I

UT-RTLBL.I

UT-RUN.I

UT-MSGS.P

IND01-10.I, IND11-50.I E IND51500.I

UT-TABLE.I

UT-LITER.I

UT-LIMIT.P

Agenda

9

UT-GLOB.I

I-FREEAC.I

UT-DIR.P

BTB917ZX.P

BTB917ZY.P

BTB917ZZ.P

UT-VRBIN.P

UT-FINFO.P

UT-CMDLN.P

Agenda

10

UT-OSVER.I

I-COUNTDS.I

UT-WIN.I

UT-TRACE.P

Parte 8

Validações

Validações de Tela

Validações Triggers de Dicionário

Mensagens

Regras para Criação de Mensagens

Agenda

11

Mensagens em Outros Idiomas

Procedures Reutilizáveis

Portabilidade de RCODES

Customizações

API - Application Program Interface

UPC - User Program Call

Agenda

12

Construção

Construção

13

Passos

1. Em Arquivo | Novo, selecionar o estilo Custom Query Wizard;

SmartQuery

14

2. Se necessário, especificar uma tabela externa.

SmartQuery

15

Uma tabela externa complementa os critérios join para uma query. Por exemplo, uma query em 'Order OF Customer' exige uma tabela Customer externa. A tabela externa está preenchida por outra procedure object--tipicamente um SmartBrowser ou SmartViewer.

1. Clicar em ‘Add External Tables’

2. Dentro do Table Selector, selecione a tabela externa.

SmartQuery

16

3. Especificar as tabelas para a query. Deve-se marcar a opção INDEXED_REPOSITION.

Detalhes:

Não pode ter classificação (cláusula BY);

Não pode conter pré-seleção (cláusula preselect)

Deve ser sobre apenas uma tabela, não podendo haver joinentre tabelas (each,each).

SmartQuery

17

SmartQuery

18

4. Remover as Chaves Estrangeiras criadas pelo Wizard.

SmartQuery

19

5. Finalizar o Wizard

SmartQuery

6. Salvar a SmartQuery com o nome definido, de acordo com os Padrões de Nomenclatura;

20

Laboratório

Tabela: Customer

SmartQuery

21

De acordo com os objetos a serem instanciados na viewer, seguir a técnica correspondente:

Padrão;

Sem campos de tabela;

Só com campos chave;

SmartViewer

22

Padrão

É aquela que possui ao menos um campo não chave de tabela.

É necessário para uma Viewer Padrão possuir ao menos um campo de tabela habilitado. Esse campo não pode ser chave de tabela.

SmartViewer

23

Sem campos de tabela

É aquela que possui apenas objetos (widgets) não vinculados a uma base de dados, ou seja, são variáveis dispostas na tela de modo que o usuário possa alterar os seus valores em tempo de execução.

SmartViewer

24

Só com campos chave

É aquela que não possui campos não chave dispostos na tela. Esta viewer poderá conter variáveis dispostas para entrada de dados pelo usuário;

SmartViewer

25

1. Em Arquivo | Novo, selecionar o estilo Custom Viewer com AutoField;

SmartViewer - Padrão

26

2. Na dialog que se abrirá logo após a seleção do template, selecionar a(s) tabela(s) a serem utilizadas na viewer;

3. Na janela, após a seleção da(s) tabela(s), selecionar os campos a serem utilizados;


27


28

4. A seguir pode ou não ser apresentada uma mensagem questionando se a viewer deve suportar chaves estrangeiras. Caso aconteça, clicar em Cancel;


29

5. Se a viewer for utilizada em um cadastro do tipo simples, no início da procedure local-assign-records, é necessário substituir a linha contendo:

{include/i-valid.i}

por estas a seguir:

if not frame {&frame-name}:validate() thenreturn 'ADM-ERROR':U.


30


31

6. Alterar a altura de todos os atributos de tipo fill-in para 0.88;

7. Para os atributos que formam a chave de acesso da tabela, caso forem postos na tela:

1. Tornar os atributos desabilitados, através de propriedades, desmarcando o toggle-box 'Enable';

2. Em propriedades e Advanced, marcar o toggle-box '{&ADM-CREATE-FIELDS}';

3. Colocar o primeiro atributo na linha 1.17;


32

4. Caso exista mais de um atributo chave:

1. Colocá-los em espaçamento 1, ou seja, na linha 2.17, 3.17, etc.;

2. Alterar a altura do retângulo rt-key para o número de atributos chave + 0.25, ou seja, 2.25, 3.23, etc.;

3. Alterar a linha inicial do retângulo rt-mold para a altura do rt-key + 1.25;


33

8. Se não forem colocados atributos chave:1. Eliminar o retângulo rt-key;

2. Mover o retângulo rt-mold para a linha 1;

9. Para os atributos que não formam a chave de acesso da tabela, caso forem postos na tela:

1. Colocar o primeiro atributo na linha de rt-mold + 0.17 (Exemplo: 2.67);

2. Colocar os demais atributos com um espaçamento de 1 (Exemplo: 3.67, 4.67);

3. Alterar a altura do retângulo rt-mold de modo a apenas caber os atributos dentro;


34

10. Colocar na SmartViewer outros objetos, como, por exemplo, combo-box, que não estão associados aos campos no banco de dados;

11. Para os objetos não associados ao banco de dados e que devem ser atualizados pelo usuário, acessar as 'Property' e:

1. Tornar o objeto desabilitado (em propriedades, desmarcar o toggle-box 'Enable');


35

2. Em propriedades e Advanced, marcar o toggle-box '{&ADM-MODIFY-FIELDS}';

3. Customizar a procedure LOCAL-INITIALIZE para que as inicializações dos objetos sejam feitas. Essas inicializações das variáveis podem ser, atribuição de labels (para tradução automática), atribuição de itens para combo-boxes e radio-sets, etc., e devem ser feitas antes do dispatch padrão;


36

/* Code placed here will execute PRIOR to standard behavior. */

{utp/ut-liter.i Preço * R}assign fill-in_Price:label in frame {&frame-name} =

return-value

cb-country:list-items in frame {&frame-name} = {pdinc/i01pd001.i 03}.

/* Dispatch standard ADM method.*/

RUN dispatch IN THIS-PROCEDURE ( INPUT 'initialize':U ).

/* Code placed here will execute AFTER standard behavior. */


37

4. Na procedure LOCAL-ENABLE-FIELDS comentar a linha que contém a ocorrência:"if-adm-new-record=yesthen";

5. A procedure LOCAL-DISPLAY-FIELDS deve ser customizada para que o valor da variável seja exibido, para isso, antes do dispatch padrão deve-se atribuir àvariável o valor a ser exibido.


38

/* Code placed here will execute PRIOR to standard behavior. */

if avail order-line thenassign fill-in_Price = Order-Line.Price.

Elseassign fill-in_price = 0.

/* Dispatch standard ADM method. */

/* RUN dispatch IN THIS-PROCEDURE (INPUT 'display-fields':U).*/

/* Code placed here will execute AFTER standard behavior. */


39

12. Quanto à largura da SmartViewer:

1. Se a SmartViewer for usada dentro de um folder de Cadastro Inclui/Modifica Filho, alterar a largura de rt-key e rt-mold para 76,72;

2. Se a SmartViewer for usada dentro do Cadastro Inclui/Modifica Filho sem folder, alterar a largura de rt-key e rt-mold para 79,29;


40

3. Se for usada dentro de outro folder que não seja em um Cadastro Inclui/Modifica Filho, alterar a largura de rt-key e rt-mold para 85.72;

14. Acessar as propriedades da frame da SmartViewer, clicar em 'Tab

Order' e no combo-box 'Tabbing Options' escolher a opção 'Left-to-Right By Columns';


41

15. Salvar a SmartViewer, com o nome definido de acordo com os Padrões de Nomenclatura;


42


SmartViewer - Sem Campos de Tabela

43

2. Cancelar a tela de seleção de tabelas exibida após a escolha da template.

3. Se a viewer for utilizada em um cadastro do tipo simples, no início da local-assign-records é necessário substituir a linha:

{include/i-valid.i}

por estas a seguir:

if not frame {&frame-name}:validate() then

return 'ADM-ERROR':U.


44


45

4. Definir no Method-Library, que a include i-auxtab.i, deve ser a primeira da lista;


46


47

5. Definir ao menos uma tabela externa;

6. Inserir os objetos (fill-in´s, combo-boxes, radio-sets, retângulos, etc) na viewer. Esses objetos não podem ser campos de tabelas;

7. Desabilitar todos os objetos da tela que não devam ser mostrados habilitados;


48

8. Atenção: O controle de habilitação/desabilitação de campos deve ser feito pelo usuário. Para isso, deve-se colocar os campos nos pré-processadores de acordo com a tabela abaixo:


49


Habilitados nas operações de ADD, COPY e MODIFY.

Adm-modify-fieldsAdm-assign-fields

Outras Variáveis

Habilitados somente na criação de um novo registro.

Adm-create-fieldsChaves (variáveis que representam chaves)

FinalidadePreprocessadorTipo de Objetos

50

9. Customizar a procedure LOCAL-INITIALIZE para que as inicializações dos objetos sejam feitas. Essas inicializações das variáveis podem ser, atribuição de labels (preparação para tradução), atribuição de itens para combo-boxes e radio-sets, etc.;


51


52

10. Customizar a procedure LOCAL-DISPLAY-FIELDS, sendo que énessa procedure que os valores dos objetos serão exibidos:

1. Comentar o dispatch padrão;

2. Inserir os comandos para que os valores dos objetos sejam exibidos.


53


54

11. Customizar a procedure LOCAL-ENABLE-FIELDS, sendo que énessa procedure que os objetos são habilitados:


2. Comentar a linha em que consta a seguinte sentença: if adm-new-record then.

3. Caso seja uma viewer principal, incluir:RUN notify ('enable-fields, GROUP-ASSIGN-TARGET':U).


55


56

12. Customizar a procedure LOCAL-DISABLE-FIELDS, sendo que énessa procedure que os objetos são desabilitados:


2. Inserir as seguintes linhas:&if defined(ADM-CREATE-FIELDS) &then

disable {&ADM-CREATE-FIELDS} with frame {&frame-name}.&endif

3. Caso seja uma viewer principal, colocar:RUN notify ('disable-fields, GROUP-ASSIGN-TARGET':U).


57


58

13. Customizar a procedure LOCAL-ASSIGN-STANTEMENT, sendo que é nessa procedure que os objetos terão seus valores salvos:


2. Inserir a lógica de gravação dos valores das variáveis.


59


60

14. Alterar a altura de todos os atributos para 0.88;

15. Para os atributos que representam a chave de acesso a tabelas, caso forem postos na tela:


2. Caso existam mais atributos que represente uma chave:

1. Colocá-los com espaçamento 1, ou seja, na linha 2.17, 3.17, etc.;


61


3. Alterar a linha inicial do retângulo rt-mold para a altura do rt-key + 1.25;

16. Se não forem colocados atributos que representem chaves:

1. Eliminar o retângulo rt-key;

2. Mover o retângulo rt-mold para a linha 1;


62




3. Alterar a altura do retângulo rt-mold de modo a apenas caber os atributos dentro do mesmo;

18. Se não forem colocados atributos não chave, retirar o retângulo rt-mold;


63


1. Se a SmartViewer for usada dentro de um folder de Cadastro Inclui/Modifica, alterar a largura de rt-key e rt-mold para 76,72;

2. Se a SmartViewer for usada dentro do Cadastro Inclui/Modifica sem folder, alterar a largura de rt-key e rt-mold para 79,29;

3. Se for usada dentro de outro folder que não seja em um Cadastro Inclui/Modifica, alterar a largura de rt-key e rt-mold para 85.72;


64

20. Acessar as propriedades da frame da SmartViewer, clicar em 'Tab Order' e, no combo-box 'Tabbing Option‘, escolher a opção 'Left-to-Right By Columns';

21. Salvar a SmartViewer, com o nome definido, de acordo com os Padrões de Nomenclatura.


65


SmartViewer - Só com Campos Chave

66

2. No dialog que se abrirá logo após a seleção do template, selecionar a(s) tabela(s) a serem utilizadas na viewer;

3. Na janela, após a seleção da(s) tabela(s), selecionar os campos a serem utilizados;

4. A seguir, pode ou não ser apresentada uma mensagem questionando se a viewer deve suportar chaves estrangeiras. Caso aconteça, clicar em Cancel;

5. Definir, no Method-Library, que a include i-auxtab.i, deve ser a primeira da lista;


67


68

6. Desabilitar todos os campos da tela;

7. Colocar os campos nos pré-processadores, de acordo com a tabela abaixo:


Devem ser marcados os objetos que serão habilitados para a alteração de uma ocorrência na tabela. Observe que índices de tabelas não podem ser alterados.

Adm-modify-fields

Habilitados somente na criação deum novo registroExemplo: operações de ADD e COPY

Adm-create-fieldsAdm-assign-fields

FinalidadePreprocessador

69

8. Customizar a procedure LOCAL-INITIALIZE para que as inicializações dos objetos sejam feitas. Essas inicializaçõespodem ser atribuição de labels (preparação para tradução), atribuição de itens para combo-boxes e radio-sets, etc.;


70


71

9. Caso existam, na viewer, objetos não vinculados ao banco de dados (variáveis), customizar a procedure LOCAL-DISPLAY-FIELDS para que seus valores sejam exibidos.


72


73

10. Customizar a procedure LOCAL-ENABLE-FIELDS:


2. Comentar a linha em que apareça a sentença: if adm-new-record = yes then;

3. Caso seja uma viewer principal, incluir:RUN notify ('enable-fields, GROUP-ASSIGN-TARGET':U).


74


75

11. Caso existam, na viewer, objetos não vinculados ao banco de dados (variáveis), customizar a procedure LOCAL-ASSIGN-RECORD para que seus valores sejam salvos.


76


77

12. Criar e customizar a procedure LOCAL-ASSIGN-STATEMENT;

1. Inserir o seguinte código após o dispatch padrão:

do with frame {&frame-name} on error undo, return "ADM-ERROR":&if defined(ADM-CREATE-FIELDS) &then

if ADM-NEW-RECORD then assign {&ADM-CREATE-FIELDS}.&endif&if defined(ADM-MODIFY-FIELDS) &then

assign {&ADM-MODIFY-FIELDS}.&endif

end.


78


79

13. Alterar a altura de todos os atributos para 0.88;

14. Para os atributos que formam a chave de acesso da tabela:


2. Caso exista mais de um atributo chave:

1. Colocá-lo com espaçamento 1, ou seja, na linha 2.17, 3.17, etc.;


80


3. Alterar a linha inicial do retângulo rt-mold para altura do rt-key + 1.25;





81

16. Colocar na SmartViewer outros objetos, como por exemplo combo-box, que não estão associados ao banco de dados;

17. Se não forem colocados atributos não chave, retirar o retângulo rt-mold.Obs.: Apesar da viewer só com campos chave não conter outros campos, poderá conter variáveis;


82

18. Para os objetos não associados ao banco de dados e que devem ser atualizados pelo usuário, acessar as 'Property' e:

1. Tornar o objeto desabilitado (em propriedades, desmarcar o toggle-box 'Enable');

2. Em propriedades e Advanced, marcar o toggle-box '{&ADM-MODIFY-FIELDS}';


83


1. Se a SmartViewer for usada dentro de um folder de Cadastro Inclui/Modifica, alterar a largura de rt-key e rt-mold para 76,72;

2. Se a SmartViewer for usada dentro do Cadastro Inclui/Modifica sem folder, alterar a largura de rt-key e rt-mold para 79,29;

3. Se for usada dentro de outro folder que não seja em um Cadastro Inclui/Modifica, alterar a largura de rt-key e rt-mold para 85.72;


84

20. Acessar as propriedades da frame da SmartViewer, clicar em 'Tab Order' e, no combo-box 'Tabbing Option‘, escolher a opção 'Left-to-Right By Columns';

21. Salvar a SmartViewer, com o nome definido de acordo com os Padrões de Nomenclatura;


85

Laboratório

Tabela: CustomerCampos: Customer.Cust-Num;

Customer.NameCustomer.AddressCustomer.PhoneCustomer.CityCustomer.StateCustomer.Country

SmartViewer

86

Este material é de propriedade da DATASUL S.A., sendo proibida a sua reprodução em qualquer meio, total ou parcial, sem aprovação por escrito. Todos os direitos estão reservados. A informação contida aqui é confidencial

e não pode ser utilizada fora da empresa ou das franquias que fazem parte da nossa rede, não podendo ser divulgada para clientes, parceiros ou outra empresa ou indivíduo sem o prévio consentimento de um diretor da

DATASUL S.A. As opiniões expressas aqui estão sujeitas a modificação sem aviso prévio.

[email protected]

http://universidade.datasul.com.br

[email protected]

http://universidade.datasul.com.br

Obrigada!

Obrigada

ddk gui - sanderleisilveira.com.br · 4 importação exportação pesquisa vá para digitação...

Documents