workshop datasul 11 - customizacao

8/9/2019 Workshop Datasul 11 - Customizacao

1/58

Customizao Datasul 11

Ricardo Menna / Maro - 2011


2/58


I) Reviso

II) EPC

III) Metadados

NDICE

2


3/58


4/58


5/58

5

Evo&o Prodto Datas&

Reviso

E. /

E. 0 'inaneiro

E. / 'inaneiro

'oundation

'oundation

'oundation

Customizao em Progress (EPC)


6/58

6

Evo&o Prodto Datas&

Reviso

E. /

E. 0 'inaneiro

E. / 'inaneiro


'oundation

e% erver 2 $pp erver 2 Connetion !or e%


7/58

'oundation

E. 0 'inaneiro

E. /


DATASUL 11

Reviso

Evo&o Prodto Datas&



8/58

'oundation

E. 0 'inaneiro

E. /


R3$

R3$

DATASUL 11

Reviso


Customizao em 'lex (EPC) e Regra de *eg4io em Progress (EPC)8

Evo&o Prodto Datas&


9/58

'oundation

E. 0'inaneiro

E. /


R3$

R3$

.eta-dados

.eta-dados

D$5$U 11#0

Reviso


Customizao em 'lex (EPC) e Regra de *eg4io em Progress(EPC)Customizao em .eta-dados e Regra de *eg4io em Progress

9

Evo&o Prodto Datas&


10/58

Reviso

Customizao em .eta-dados e Regra de *eg4io em Progress10

Evo&o Prodto Datas&

'oundation

.eta-dados

.eta-dados


DATASUL ??


11/58

$ 5657 reomenda sempre o uso de$oas 'r%ticas e das tnias por eladivulgadas para o desenvo&vi#ento decsto#i(aes# *o aso de

desenvolvimentos em linguagens u8apropriedade inteletual pertene atereiros9 om o aso do 'lex9 a 5657no 'ode *arantir :ue as migra"espara releases mais novas de seusprodutos no preisem de uma reviso e

eventuais retra%alos nestesdesenvolvimentos espe;


12/58

Pontos de ustomizao do produto9'revia#ente de.nidos pelos desenvolvedoresdas !ran:uias

Podem ser adiionadas l4gias de neg4ioexlusivas do liente

UPC (User Program Call ) - EPCs ustomizadaspelo liente

EPC

12

De.nio


13/58

Co#o nciona a EPC e# &e"

EPC

13


14/58

Co#o nciona a EPC e# &e"

EPC

7ie=

Controller>EPC(name?@saveA###)Bpu%li!untiondoCon


15/5815

Co#nicao &e Pro*ress

EPC

Prox,en

ProgramaFava

ProgramaProgress

Remote6%8et

Dataervies

Programa'lex

$pp erver


16/58

5odo programa utiliza .7C (.odel-7ie=-Controller)

Disp"e de uma %i%liotea om o seguinte nome&

No#e da 3nciona&idade4 5 6-'c-s7c8

Esta %i%liotea sai vazia da 56579 e deve ser so%resritapelo programa EPC riado pela 'D3GCliente

EPC

16

,rqitetra &ado &e


17/58

EPC

17

Estrtra de Diret9rios


18/5818

Identi.cando Pontos de Csto#i(ao

EPC

Como deso%rir os eventos pr-de


19/5819

De.nindo #a


20/5820

Pontos de Csto#i(ao

+tt'>//sd?@datas&@co#@$r/conAence/dis'&aB/:D1/Eventos5de5EPC


21/5821

Csto#i(ao &e

$ lasse de tratamento de ustomizao deverH&

Estender da lasse EPCIandler

5er o nome


22/5822

C&asse EPCFand&er

EPC

Paote&

co#@datas&@3ra#e7or?@i@e'c@EPCFand&er

$ssinatura&

EPCFand&er e'c>O$GectHn&& na#e>:trin*Hn&& 3nc>nctionHn&&)

Exemplo&

package com.datasul.epc.myepc {

import com.datasul.framework.ui.epc.EPCHandler;

public class UPCBeforeLoad extends EPCHandler {

public function UPCBeforeLoad(epc:Object=null, name:Strn!=null, func:"uncton=null#

{

c!ama o construtor do EPCHandler

super"epc# name# func$;

%

%

%


23/5823

ari%veis Dis'onveis

EPC

Durante a exeuo so disponi%ilizadas as seguintesvariHveis&

7ariHvel Desrio 5ipo

epClass*ame *ome da lasse :ue estH sendo ustomizada tring

ep*ame *ome do evento tring

epContainer 3nstKnia da 7ie= :ue estH sendo ustomizada Displa6%8et

epPaLage Paote :ue estH sendo ustomizado tring

ep.odel 3nstKnia do model 6%8et

ep3tems Relao de o%8etos da tela :ue devem ser

enviados e retornados do Progress

.ap

epController 3nstKnia do ontroller 6%8et

ep.etod*ame

*ome do mtodo :ue disparou a EPC tring

ep'unParam

s

ista om todos os parKmetros passados para o

mtodo :ue disparou a EPC

$rra


24/58


25/58

25

M!todo *etEPCO$Gect=BId do EPCFand&er

EPC

Retorna um o%8eto da tela (Displa6%8et)re!erente a um 3D previamente in!ormado

$ssinatura&

*etEPCO$Gect=BIdna#e>:trin*)>Dis'&aBO$Gect

Exemplo&

/lert.s!ow" Button"t!is.!etEPCObjectB)*d"0myButton1$$.label $;


26/58

26

M!todo *etMode&,ttri$tes doEPCFand&er

EPC

Retorna uma oleo om os atri%utos do MODEK9:uando este !or espei,rraBCo&&ection

Exemplo&

&ar lin'2tring 3 44;for eac!"&ar st'2tring in !et+odelttrbutes(#${ lin53 st 5 06n4;

%/lert.s!ow"4/tributos do 7odel 3 45 lin$;


27/58

27

M!todo sendEPC do EPCFand&er

EPC

Envia o onteMdo da e'cIte#s tt-e'c) para olado Progress e dispara o mtodo e'cNoti3B) noretorno do mesmo

$ssinatura&

sendEPC)>void

Exemplo&

t!is.sendEPC(#;


28/58

28

M!todo e'cNoti3B do EPCFand&er

EPC

Este mtodo deve ser so%resrito pelo ustomizador9 onde aEPC serH noti


29/58

29

Lrans'ortando dados do &e 'araPro*ress

EPC

Deve ser utilizada a variHvel e'cIte#so paraadiionar dados de neg4io do lado 'lex para olado Progress#

$ssinatura&

e'cIte#s@'tna#e>:trin* va&e>:trin*H)>void


30/58

30

Ee#'&o de so da e'cIte#s

EPC

::: 7etodo obrigatorio a ser sobrescrito

:

public o&erride function !andlee?4$; t$s'epc*tems'put"4Codigo@Aornecedor4# 4D4$;

t$s'epc*tems'put"42aldo4# 4F.FF4$; t$s'epc*tems'put"4Estabelecimento4# 4EL,4$;

en&ia as informa*Ges para o Progress atra&=s da ,,EPC t$s'sendEPC"$;

%

::

: 7etodo e-ecutado no retorno do Progress:

public o&erride function epc-otf)"$'&oid { recebe a notifica*+o


31/58

31

Csto#i(ao &ado Pro*ress

EPC

Criar9 no propat do apperver Progress9 umprograma om o seguinte nome& no#e da3nciona&idade4 5 6-'c@'8@

Este programa9 deverH possuir N parKmetros 'EventO o Evento :ue estH sendo exeutado9 omo

parKmetro de entrada

Lt-e'cO temp-ta%le om dados a seremenviadosGree%idos9 utilizando a inlude Jinc&de/i-e'c200@i1 ttE'c

Ro7ErrorsO temp-ta%le de retorno de erros para oJex#

Este programa deve ser adastrado no adastro de


32/58

32

Le#'-La$&es a sere# ti&i(adas noPro*ress

EPC

Utiliza duas inludes :ue so&

Jinc&de/i-e'c200@i1 ttE'c

J#et+od/d$otterr@i

define tempItable ttIepc noIundo

field codIe&ent as c!ar format 4-">J$4

field codIparameter as c!ar format 4-"J$4 field &alIparameter as c!ar format 4-"?$4

inde- id is primary codIparameter codIe&ent ascending.

EA8KE ,E7PI,/BLE owErrors KIUK

A8EL Error2e


33/58

33

Pro*ra#a de EPC no Pro*ress

EPC

Dentro deste programa9 !eito o tratamento9de aordo om o evento disparado dispon;vel

em 'Event

Este programa pode amar outras $P3s9 6s9et

*o neessHrio exeutar o 'roBeneratorneste programa

C


34/58

34

Ee#'&o de Csto#i(ao no Pro*ress

EPC

: definicao da ttIepc para o E72J :

{includeiIepcJFF.i> ttEpc%

: definicao da owErrors para o E72J :

{7E,Hdbotterr.i%

: recebe os tres parametros do do lado fle- :

EA 8KPU, P//7 pE&ent as C!aracter noIundo.EA 8KPU,IU,PU, P//7 ,/BLE A ttIepc.

EA U,PU, P//7 ,/BLE A owErrors.

EA 9/ cEstabel L8NE estabelec.codIestabel KIUK.

: gera um ar


35/58

35

Ee#'&o de Csto#i(ao no Pro*ress

EPC

8A pE&ent 3 4UPCfterC$an!e4 ,HEK '

A8K A82, ttIepc

OHEE ttIepc.codIe&ent 3 pE&ent /K ttIepc.codIparameter 3 4codIestabelecimento4

KILCN KIE.

8A /9/8L ttIepc ,HEK ' /228MK cEstabel 3 ttIepc.&alIparameter.

EK.

A8K A82, estabelec

OHEE estabelec.codIestabel 3 cEstabel KILCN KIE.

8A /9/8L estabelec ,HEK '

CE/,E ttIepc.

/228MK ttIepc.codIe&ent 3 pE&ent

ttIepc.codIparameter 3 4descricaoIestabelecimento4

ttIepc.&alIparameter 3 estabelec.nome.

EK.

EL2E '

CE/,E owErrors. /228MK owErrors.Error2e

owErrors.ErrorKumber 3 >>>>

owErrors.Errorescription 3 4Estabelecimento nao encontrado4

owErrors.ErrorParameters 3 44

owErrors.Error,ype 3 4E4

owErrors.ErrorHelp 3 4Aorneca um estabelecimento &alido.4

owErrors.Error2ub,ype 3 4E4.

EK.

EK.: fim :

EPC


36/58

36

Cadastro de Pro*ra#as

EPC

EPC


37/58

Kin?s de Doc#entao

EPC

Q

5rila do Desenvolvedor de EPC

+tt'>//sd?@datas&@co#@$r/conAence/dis'&aB/:D1/Lri&+a5Desenvo&vedor5de5EPC

Eventos de EPC

+tt'>//sd?@datas&@co#@$r/conAence/dis'&aB/:D1/Eventos5de5EPC

.anual de Customizao de EPC O 'D3

+tt'>//sd?@datas&@co#@$r/conAence/'a*es/vie7'a*e@action"'a*eIdH0QSQ;

. t d d


38/58

38

O qe ! Metadados "

.etadados

iLipdia& :o dados so$re otrosdados@

Meta& $lgo :ue se auto explia#

Con8unto de 3erra#entas:ue permitem aes'eci.caoe desenvo&vi#entode uma'&icativode !orma dinW#ica#

A partir do Datasul 11.5

. t d d


39/58

39

Para qe :erve "

.etadados

oa parte dos sistemas possuem !unionalidadesomuns9 :ue podem ser reaproveitadasGreutilizadas

Com o reaproveitamento9 gana-se produtividade9!ailidade na manuteno e padronizao dosprogramas

Diminuir a urva de aprendizado9 !azendo om :ue odesenvolvedor se onentre na l4gia de neg4io eno nas vHrias amadas internas da apliao#

. t d d


40/58

40

Nova P&ata3or#a de Desenvo&vi#ento

.etadados

O metadados a nova plataforma de desenvolvimentona linha Datasul e oferece produtividade esimplicidade semelhante a plataforma do Protheus.

.etadados continagerando telas em 'lex

.etadados


41/58

41

Desenvo&vi#ento co# Metadados

.etadados

Especificao Prora!ao "estes

Dese#$ol$i!e#to "radicio#al

Especificao%adastra!e#tos

&etadados"estes

Dese#$ol$i!e#to co! &etadados

Prora!ao


42/58

.etadados


43/58

43

Introdo a Metadados

.etadados

%adastra!e#to de

&etadados

&etadados

D'

(erao de "elas

)DE de

&etadadosAplicati$o

A#alista de

*iste!as A#alista de

+e,cios Dese#$ol$edor

-surio

Dicio#rio


44/58

E l d CRUD i l , id d


45/58

Exemplo de CRUD imples om ,rid dePes:uisa

CRUD i l $lt d


46/58

CRUD imples O $lterao deRegistro


47/58

Exemplo de Zoom


48/58

Exemplo de FreeForm

.etadados


49/58

49

Caractersticas *erais

.etadados

3DE ,rH


50/58

50


.etadados

inguagem de sript (,=K:cri't) para de


51/58

51


.etadados

uporte a riao de 5emplates de 'ormulHrios#5emplates novos ou riados a partir de !ormulHriosexistentes#

izard de .enu para adastramentos de !ormulHriosriados via metadados no menu do produto Datasul#

3mportadorGExportador de 'ormulHrios#

Possi%ilidade de de


52/58

Editor ABLScript

.etadados


53/58

53

Caractersticas do ,=K:cri't

.etadados

6 $ript uma linguagem de sript:ue permite a de


54/58

54


.etadados

intaxe do Progress (linguagem utilizadana onstruo das l4gias de neg4io nolado servidor)

u%set de omandosG!un"es do Progress

6rientada a Eventos

Exeuta 1QQ no lado Cliente (%ro=ser)

.etadados


55/58

55


.etadados

Editor om syntax highlighte codecomplete

uporte a ST omandosG!un"es (naverso N#/#Q do .etadados)

uporte a 5E.P-5$E e '6R E$CI

uporte a 3nludes e Proedures

.etadados


56/58

56

Doc#entao do ,=K:cri't

.etadados

+tt'>//sd?@datas&@co#@$r/conAence/dis'&aB/:D1/,=K:cri't

Doc#entao do


57/58

Doc#entao doMetadados

57

IM,OEM

LOL:

+tt'>//sd?@datas&@co#@$r/conAence/dis'&aB/:D1/Metadados

Doc#entao do Metadados



58/58

Ricardo Menna

Desenvolvimento

'rame=orLG'oundation

ricardo@#ennaYtotvs@co#@$r

Z

workshop datasul 11 - customizacao

Documents