Anda di halaman 1dari 109

Sumrio

Sumrio..............................................................................................................................2 Objetivo.............................................................................................................................3 Pblico...............................................................................................................................3 Pr-requisitos.....................................................................................................................3 Verificao do ambie te....................................................................................................! Sistema O"eracio al......................................................................................................! #qui a Virtual $ava %$V#&.........................................................................................! ' stalao do (O(VS ) *evelo"er Studio.........................................................................+ Passo a "asso.................................................................................................................+ (ermo de aceite...............................................................................................................,.oas-vi das.....................................................................................................................,, (ela "ri ci"al...................................................................................................................,2 ' stalao de adicio ais...................................................................................................,3 Pers"ectivas.....................................................................................................................,! /ovo Projeto (O(VS......................................................................................................2#e u de co te0to........................................................................................................2, Projeto1 Pro"riedades...................................................................................................23 Pastas1 Pro"riedades....................................................................................................2! 2rquivos1 Pro"riedades...............................................................................................2+ 2dicio a do um servidor............................................................................................23 4o ecta do-se ao servidor...........................................................................................34o fi5urao do servidor............................................................................................3, Pastas e Projetos..............................................................................................................!, .sico..........................................................................................................................!3 2ssiste te de c6di5o1 4adastro....................................................................................+7 2ssiste te de c6di5o1 8erao de 2rquivo (e0to.......................................................93 2ssiste te de c6di5o1 'm"ortao de 2rquivo (e0to..................................................97 2ssiste te de c6di5o1 Processame to 5e rico...........................................................:2 Por com"arao...............................................................................................................72 Por "ro5rama...................................................................................................................7! Por 8ru"o de Projeto.......................................................................................................7! ' forma;es resumidas....................................................................................................33 ' formao detal<ada......................................................................................................3!

Todos os direitos reservados.


TDS

-2

Objetivo
O "TOTVS | Developer Studio", um conjunto de aplicaes e ferramentas que interagem entre si, disponibiliza aos desenvolvedores de produtos TOTVS, um ambiente de desenvolvimento gil, confort vel e poderoso!

Pblico
"esenvolvedores de produtos TOTVS, que utilizem uma ou mais das linguagens de programa#o abai$o% &'() &'(*) +dv,*( e +dv,*(-asp

Pr-requisitos
.on/ecimentos% o Sistema operacional adotado) o .onfigura#o e e$ecu#o da aplica#o servidora *rot/eus 0opcional1) o .on/ecimentos da linguagem a ser utilizada! Sistema Operacional 0qualquer um destes1% o 2S-3indo4s 56 ou 7& bits, vers#o 8* ou superior) o (inu$ 56 ou 7& bits! o 2 quina Virtual 9ava 09V21, 9:; vers#o 7 ou superior, de acordo com o sistema operacional em uso! Servidores *rot/eus com suporte <% o +dv,*(, vers#o =!>>!?>?6>6+ ou superior, de acordo com o sistema operacional em uso) o &'(, vers#o =!>>!?>?6>6+ ou superior, de acordo com o sistema operacional em uso) o &'(*, vers#o =!>>!?>>@?6* ou superior, de acordo com o sistema operacional em uso! o Anstalador do TOTVS | Developer Studio. O instalador pode ser obtido atravs do endereo% /ttp%,,suporte!totvs!com, na sess#o "downloads"!

Todos os direitos reservados.


TDS

-3

Verificao do ambiente
Sistema Operacional
.ertifique-se que o sistema operacional que ser utilizado, seja /omologado para uso do TOTVS | Developer Studio e devidamente atualizado!

Mquina Virtual ava !JVM"


;m ambientes 3indo4s, o instalador do TOTVS | Developer Studio efetuar uma verifica#o e se necess rio, a atualiza#o ou instala#o da 9V2 de forma autom tica, apBs confirma#o! Cotas% ?! "ependendo das diretrizes de segurana de sua rede, o procedimento pode n#o ser efetuado, neste caso efetue os procedimentos manualmente! 6! ;m alguns ambientes, apesar da 9V2 estar instalada e atualizada, o instalador n#o consegue recon/ecD-la! Se, l/e for solicitado a instala#o e vocD tem certeza que a 9V2 esta instalada e atualizada, n#o confirme o procedimento! .aso j a ten/a instalado, verifique a vers#o usando os procedimentos conforme seu sistema operacional! 3indo4s o +cesse "*ainel de .ontrole" o +cione o icone "9ava" o Ca aba "'eral", acione "Sobre" (inu$ o +cesse o terminal o "igite o cBdigo% java -version! .aso n#o ten/a ou a vers#o esteja desatualizava, acesse a p gina web do fornecedor e siga as instrues de instala#o ou atualiza#o fornecidas por ele! ;ndereo web onde pode ser obtido a 9V2% http%,,java!com,en,do4nload,manual!jsp

Todos os direitos reservados.


TDS

-4

#nstalao do TOTVS | Developer Studio


Passo a passo
?! Anicie o instalador do TOTVS | Developer Studio, conforme o seu sistema operacional! Todas as telas apresentadas s#o do TOTVS | Developer Studio sob sistema operacional 3indo4s =, porm pode-se us -las como referDncia para os demais sistemas operacionais, salvo se dito ao contr rio! 6! Selecione o idioma que deseja utilizar durante o processo de instala#o!

Tela 1: Seleo de idioma do instalador 5! (eia os termos e condies do licenciamento e selecione a op#o que corresponde ao aceite + n#o aceita#o dos termos e condies de uso implica no cancelamento da instala#o! e prossiga!

Tela 2: Termos e condi es de uso &! Selecione o local de instala#o e avance!

Todos os direitos reservados.


TDS

-5

Tela !: "ocal de instalao E! +guarde a instala#o e

Tela #: $nstalao 7! !! o aviso de trmino!

Todos os direitos reservados.


TDS

-6

Tela %: $nstalao conclu&da

Todos os direitos reservados.


TDS

-7

Aniciando o TOTVS F "eveloper Studio


*ara iniciar o uso do TOTVS | Developer Studio, e$ecute o procedimento adequado ao seu sistema operacional! +ssim que este iniciar, l/e ser solicitado que informe o local da rea de trabal/o 0wor'space1! $rea de trabal%o !workspace" G (ocal onde seus trabal/os podem ser armazenados e,ou acessados via liga#o simbBlica 0 s(mbolic lin'1 ou fisicamente, informaes de gerenciamento e organiza#o dos fontes e outras informaes necess rias ao funcionamento do TOTVS | Developer Studio. VocD pode manter quantas reas de trabal/o desejar, organizando seus trabal/os da forma que vocD ac/ar mais confort vel e natural! *or e$emplo, mantendo uma rea para cada produto,vers#o, cliente, projetos pessoais, etc! Hsando as ligaes simbBlicas 0s(mbolic lin's1, vocD pode compartil/ar diretBrios e arquivos, que s#o comuns a v rios projetos! Ca cai$a de te$to "wor'space) 0Tela = +1, selecione um diretBrio para ser o ponto de partida 0diretBrio raiz1 da sua rea! (ogo abai$o, vocD tem uma cai$a de marca#o 0Tela = I1 na qual vocD pode optar para que esta seja a sua rea de trabal/o padr#o! Se vocD a marcar, na prB$ima vez que entrar no TOTVS | Developer Studio, n#o l/e ser solicitado a rea! .aso o diretBrio selecionado n#o e$ista, este ser criado!

Tela *: Seleo da +rea de trabalho ,wor'spaceNOTA : .tili/e esta opo se voc0 no pretende ter v+rias +reas ou se ela 1or a +rea em 2ue voc0 costuma trabalhar. 3os menus do TOTVS | Developer Studio4 voc0 ter+ acesso a um 5erenciador de +reas de trabalho ou solicitar a troca da +rea em tempo de e6ecuo. :ecomenda-se que a rea de trabal/o seja colocada em diretBrio diferente do local de instala#o do TOTVS | Developer Studio. ;ste procedimento facilitar manter cBpias de segurana e futuras atualizaes do produto! +pBs a sele#o da rea de trabal/o, aguarde alguns instantes enquanto o TOTVS | Developer Studio inicializado e apresente a tela de boas-vindas!

Todos os direitos reservados.


TDS

-8

Tela 7: TOTVS | Developer Studio sendo iniciali/ado

Todos os direitos reservados.


TDS

-9

&ermo de aceite
*ara a plena utiliza#o do TOTVS | Developer Studio, necess rio que vocD aceite o termo de utiliza#o! (eia-a com aten#o e se estiver de acordo, preenc/a os campos solicitados, acione a op#o "+ceito os termos" e envie-o! ;ste ser validado por um de nossos servidores e se estiver correto, o TDS passar para a tela de "Ios Vindas", caso contr rio l/e ser apresentado o motivo da recusa!

Tela 8: Termo de aceite do TOTVS | Development Studio

Todos os direitos reservados.


TDS

- 10

'oas-vindas
VocD pode fec/ar a aba de boas-vindas acionando o 8 0Tela ?> +1! .aso deseje acessar esta aba novamente, acione menu Ajuda | Boas-vindas!

Tela 19: Tela de :oas;Vindas ;sta tela de boas vindas, contm indicaes de onde vocD pode obter documenta#o mais completa e com indicaes das primeiras tarefas a serem e$ecutadas por vocD, para customizar o T"S a suas necessidades de desenvolvimento! J prov vel, que vocD esteja vendo parte das telas em inglDs! ;ste o idioma padr#o do <clipse, que a base de constru#o do TDS! *ara coloc -lo em seu idioma veja o "+ne$o AAA% TOTVS "eveloper Studio no seu idioma", que est no final do manual!

Todos os direitos reservados.


TDS

- 11

&ela principal
Se ainda n#o o fez, fec/e a aba de boas-vindas! .omo j dito, o TOTVS | Developer Studio4 foi construKdo sob o <clipse ;ndereo web dos respons veis pelo <clipse: /ttp%,,444!eclipse!org,,0acessado em Levereiro,6>?61! Mue uma ferramenta de uso geral configur vel e e$tensKvel para v rias tarefas! .aso vocD ten/a familiaridade com o <clipse4 ver que o funcionamento do TOTVS | Developer Studio praticamente o mesmo de quando o utilizamos para desenvolvimento em 9ava ou outras linguagens suportadas por ele! Se vocD n#o con/ece o <clipse4 passaremos aqui as informaes primordiais, para que possa utilizar o TOTVS | Developer Studio e caso queira se aprofundar, recomendamos a leitura de "<clipse $ndi5o ,!.*- Documentation". *ara acesso a citada documenta#o 0em inglDs1, acesse% /ttp%,,/elp!eclipse!org,indigo,inde$!jsp 0acessado em Levereiro,6>?61 +tentar que algumas informaes disponKveis nesta documenta#o podem n#o e$istir ou ser diferentes no comportamento ou em algum detal/e em fun#o das especificidades do ambiente =rotheus e neste caso, trataremos aqui! *ara obter material sobre o <clipse em sue idioma, efetue uma busca em sites de busca, que / farto material disponibilizado por terceiros! O TOTVS | Developer Studio uma ferramenta de desenvolvimento integrada 0 $D<1! *or isso, vocD possui uma vasta gama de funcionalidades, tais como edi#o de programas, e$ecu#o, depura#o ,debu5-4 an lise de desempen/o, configura#o de servidores e muitas outras funcionalidades! *ara ativ -las necess rio instalar adicionais ao seu T"S!

Todos os direitos reservados.


TDS

- 12

#nstalao de adicionais
+cesse o "'erenciador de +tualizaes" do TOTVS | Developer Studio, acionando o menu Ajuda | Instalar novo software.... (/e ser apresentada uma janela semel/ante a%

Tela 11: $nstalao de adicionais ,plu5insOs adicionais ,plu5ins-4 s#o pacotes de soft4ares que adicionam capacidades ou estende funcionalidades j e$istente ao T"S! Tomaremos como e$emplo, que desejamos desenvolver aplicativos utilizado a linguagem de programa#o >dv?="!

,. Co campo "3orN 3it/" 0 Tela ?? +1, informe 0digitando ou colando1 o endereo do pacote a
ser adicionado, no nosso caso ser /ttp%,,ds!totvs!com,updates,advpl, que foi obtido no site /ttp%,,ds!totvs!com) 6! +cione ;CT;: e apBs alguns instantes, l/e ser apresentada uma rvore 0 Tela ?? I1, para a sele#o dos adicionais desejados! Selecione "+dv,*(") 5! +cione "+vanar" 0 Tela ?? .1 e siga as instrues do "'erenciador de +tualizaes"!

Todos os direitos reservados.


TDS

- 13

Perspectivas
+s funcionalidades adicionadas ou estendidas por adicionais 0 plu5ins1, s#o agrupadas em perspectivas 0perpectives1! +o instalar um dos adicionais do TOTVS | Developer Studio, ele vir com as perspectivas b sicas para o desenvolvedor de produtos TOTVS! Perspectivas !perspective" G S#o "configuraes" pr-definidas, que podem ser customizadas pelo desenvolvedor, que permite de uma forma r pida, modificar o seu ponto de vista 0perspectiva1 em rela#o ao trabal/o que esta sendo e$ecutado ou que seja necess rio fazer na perspectiva, vocD tem uma ou mais vises, que se relacionam de alguma forma entre si e com o trabal/o a ser e$ecutado! VocD pode selecionar uma perspectiva utilizando as opes disponKveis atravs dos botes e Kcones de sele#o, presentes na barra de ferramentas 0Tela ?6 .1!

Tela 12: Seletor de perspectiva Ou acessando o menu Janela | Abrir perspectiva | Outros..., vocD ter acesso a outras perspectivas! + perspectiva inicial a "Anformaes 0 @esources1", que neste momento n#o nos interessante! +cesse a sele#o de perspectivas 0conforme citado1 e selecione a perspectiva Totvs Developer 01!

Todos os direitos reservados.


TDS

- 14

Tela 1!: Seleo de perspectiva )TOTVS Developer) Ca janela principal, alm do seletor de perspectiva 0Tela ?& .1, tambm temos% 2enu principal 0Tela ?& +1, barra de ferramentas 0Tela ?& I1, navegador de projetos 0Tela ?& "1, estrutura de programas,classes 0Tela ?& ;1, rea de editores 0Tela ?& L1, abas informativas e retorno 0Tela ?& '1 e rea de trabal/o das abas informativas 0Tela ?& O1 e barra de status e menu de acesso r pido 0Tela ?& A1!

Todos os direitos reservados.


TDS

- 15

Tela 1#: =erspectiva )TOTVS Developer) selecionada Todos os elementos4 e6ceto o menu principal e barra de 1erramentas4 so denominados de vis es ,vie4s- e so acopl+veis ,docNable1! Viso !view" G +s vises s#o janelas acopl veis 0 doc'able1 que adicionam funcionalidades ou informaes a perspectiva atual! *ara ativar uma vis#o, acesse o menu "Janela | Viso | Outras" e na rvore de navega#o apresentada, localize a vis#o desejada e selecione-a! Se desejar, pode fec/ar uma vis#o acionando o 8 e$istente ao lado do titulo dela! anela acoplvel !dockable" - ;ssa caracterKstica permite que vocD configure o visual da forma que l/e for mais conveniente! ;$perimente arrastar uma das vises que est#o em abas informativas e vocD ver que conforme for se movimentando pela tela, aparece um quadro pontil/ado indicando onde vocD vai acopl -la se soltar o bot#o do mouse!

Todos os direitos reservados.


TDS

- 16

Aniciando um projeto
+ organiza#o inicial de um trabal/o, o projeto! ;m cada rea de trabal/o 0 wor'space1 vocD pode colocar quantos projetos desejar e faz a administra#o atravs da vis#o " TOTVS <6plorer)!

Tela ?E% Vis#o "TOTVS ;$plorer" (ogo abai$o do tKtulo da aba e da barra de ferramentas, acione o menu de conte$to e nas opes apresentadas acione Novo | Outras...! ou Importar! (/e ser apresentado o assistente de novos elementos ou assistente de importa#o 0conforme a op#o utilizada1!

Tela 1A: >ssistente de novos elementos Nota% Dependendo do licenciamento e verso do )TDS)4 al5umas op es podem estar indispon&veis ou no e6istirem. Htilizando a rvore de navega#o, localize )TOTVS Bi/ard), e$panda-o e obter as opes 0Tela ?7 destacado1! #mportar projeto (dv)P* G + partir de um arquivo de projetos 0prj1 l/e preparado um projeto "TOTVS". +ovo Projeto &O&VS G J inicializado um projeto "TOTVS" vazio, contendo uma estrutura b sica! +O&( , O arquivo de projeto 0P!prj1 utilizado somente no momento da importa#o! Mualquer modifica#o posterior neste arquivo, n#o ser refletido no projeto importado para o "T"S" e vice-versa! Selecione a op#o que mel/or l/e atende e prossiga com a e$ecu#o do assistente!

Todos os direitos reservados.


TDS

- 17

Amportar projeto +dv,*(

Tela ?=% +ssistente de importa#o de projetos "evStudio ?! Selecione o arquivo de projetos "evStudio 0P!*:91 0Tela ?= +1 desejado! *ara selecionar mais de um projeto, acione a tecla .ontrol junto com o bot#o direito, porm estes projetos devem estar sob o mesmo diretBrio) 6! Andique se vocD quer importa-lo como um novo projeto 0Tela ?= I1, ou n#o! .aso desmarque esta op#o, dever selecionar o ""estino" deste projeto! 5! Andique o mtodo de de importa#o0Tela ?= .1)

!. 2anter os fontes no diretBrio de origem 0legado1 G +o utilizar esta op#o, as pastas


01olders1 e arquivos ser#o ane$ados ao projeto TOVS por meio de uma liga#o simbBlica 0s(mbolic lin'1, ou seja, os arquivos continuam nos diretBrios de origem e uma referDncia a ele criada! Mualquer edi#o efetuada, usando-se o T"S ou qualquer outro editor e$terno, ser refletido em ambos os ambientes! .omo trata-se de uma liga#o simbBlica, ao acionar a remo#o, vocD ir apagar apenas a referDncia e n#o o arquivo fisico! +. .opiar arquivos para a area de trabal/o do T"S G ;sta op#o, efetua uma cBpia fKsica das pastas 01olders1 e arquivos referenciados pelo arquivo de projeto 0P!prj1 para dentro da rea de trabal/o 0wor'space1 em uso! Ceste caso, qualquer altera#o efetuada em uma das cBpias, n#o ser refletido no outro ambiente! 7! ;m ""iretBrios para Iusca" 0Tela ?= "1, adicione os diretBrios que dever#o ser pesquisados para resolu#o de arquivos de definies 0P!c/1 que s#o referenciados nos fontes! +o lado direito, vocD tem os botes para efetuar estas operaes! +lm disso, vocD pode adicionar referencia a outras configuraes desta lista de busca, que ser utilizada juntamente com os que informar! *ara detal/es, veja ".onfigura#o de diretBrios de busca"! =! +s ligaes 0Tela ?= ;1, l/e d#o acesso aos outros locais de defini#o de lista de busca)

Todos os direitos reservados.


TDS

- 18

@! Linalize a edi#o e aguarde o processamento! +o final, obter algo semel/ante a Tela ?@!

Tela 17: =erspectiva TOTVS Developer apCs a importao de um ar2uivo de proDetos ,.prj) 3a viso TOTVS <6plorer, vocD tem as pastas 0 1olders1 0Tela ?@ +1 e os arquivos do projeto! :epare que os arquivos est#o identificados com um Kcone contendo uma pequena seta, indicando que trata-se de uma liga#o simbBlica 0 s(mbolic lin'1! Ca vis#o Eonsole 0Tela ?@ I1, vocD tem as ocorrDncias durante o processo de importa#o!

Todos os direitos reservados.


TDS

- 19

+ovo Projeto &O&VS


;sta op#o inicializa um projeto TOTVS, com sugest#o de estrutura de pastas 0 1olders1.

Tela ?Q% +ssistente de novo projeto TOTVS ?! Anforme o nome do projeto 0Tela ?Q +1) 6! ;m ""iretBrios para Iusca" 0Tela ?Q I1, adicione os diretBrios que dever#o ser pesquisados para resolu#o de arquivos de definies 0P!c/1 que s#o referenciados nos fontes! +o lado direito, vocD tem os botes para efetuar estas operaes! +lm disso, vocD pode adicionar referencia a outras configuraes desta lista de busca, que ser utilizada juntamente com os que informar! *ara detal/es, veja ".onfigura#o de diretBrios de busca"! 5! +s ligaes 0Tela ?Q .1, l/e d#o acesso aos outros locais de defini#o de lista de busca) &! Linalize a edi#o e aguarde o processamento! +o final, obter algo semel/ante a%

Tela 29: 3ovo proDeto TOTVS iniciali/ado

Todos os direitos reservados.


TDS

- 20

'erenciamento de projetos
Ca aba TOTVS <6plorer, utilizando o menu de conte$to vocD pode gerenciar seus projetos! +s opes do menu de conte$to, depender do item da rvore de navega#o que esta selecionado!

Menu de conte-to

Tela 21: <lemento )=roDeto)

Tela 22: <lemento )pasta ,1older-)

Tela 2!: <lemento )>r2uivo)

O menu de conte$to, ser apresentado de acordo com o tipo de elemento! Veja abai$o as opes do menu de conte$to, conforme o elemento% Aplica-se a Opo Novo Projeto Descrio da funo Submenu para novos elementos. Inicializa um novo projeto TOTVS.

Todos os direitos reservados.


TDS

- 21

Arquivo Pasta Outros

Inicializa um novo arquivo. Inicializa uma nova pasta. Inicializa o assistente de novos elementos.

Vai para

Coloca o elemento selecionado, como sendo o elemento raiz do navegador temporariamente!. Para restaurar acione "Para cima" na barra de #erramentas, logo abai$o do titulo. Copia o elemento para a &rea de trans#er'ncia clipboard!. Cola o conte(do clipboard!. da &rea de trans#er'ncia

Copiar ctrl%C Colar ctrl%V )emover *+,+-+ )enomear ./ Importar... +$portar... Atualizar .3 Atualizar de#ini12o 4S*, .ec7ar projeto

)emove o elemento da &rvore. 0odi#ica o nome do elemento. Inicia o assistente de importa12o. Inicia o assistente de e$porta12o. Atualiza a &rvore de navega12o. No caso do arquivo5#onte conter uma de#ini12o de cliente de web-service, o mesmo 6 reprocessado. .ec7a o projeto, mas mantem o elemento. que n2o est2o

.ec7ar projetos .ec7a todos os projetos n2o relacionados relacionados entre si. )ecompilar 8elemento9 Compilar 8elemento9 +$ecutar como... Con#igurar e$ecu12o... *epurar como..

)ecompila todos os elementos do projeto ou pasta folder!. Compila todos os elementos que #oram modi#icados ou que n2o e$istam no reposit:rio RPO!.; Permite e$ecutar o projeto;. Permite editar con#igura1<es de e$ecu12o. Permite e$ecutar o projeto em modo depura12o debug!;.

Todos os direitos reservados.


TDS

- 22

Con#igurar depura12o... +quipe Comparar com...

Permite editar con#igura1<es de depura12o Op12o que permite gerenciar trabal7os em equipe. Inicia o processo elementos./ de compara12o entre

)estaurar do Permite recuperar vers<es anteriores a partir do 7ist:rico local... 7ist:rico local./ .onte .ormatar Propriedades alt%+N-+) Sub5op1<es relacionadas a #ontes do projeto +$ecuta a #ormata12o de arquivos5#onte. Apresenta uma janela com in#orma1<es sobre o elemento

Projeto, Propriedades

Tela 2#: =ropriedades do elemento )proDeto) +o acionar a op#o "*ropriedades altR;CT;: ", vocD pode verificar e editar algumas informaes sobre o projeto! *ara detal/es da op#o "Ancludes", veja " Eon1i5urao de diretCrios de buscas"! NOTA: >l5umas propriedades sero propa5adas para todas as pastas ,1olders- e ar2uivos.

Todos os direitos reservados.


TDS

- 23

+ op#o ".onstrutores", permite vocD desativar ou ativar o "TOTVS Verifica#o de sinta$e", que processado quando o "T"S" percebe que /ouve alteraes no arquivo! Muando isso ocorre, e$ecuta-se uma verifica#o da sinta$e dos arquivos-fontes!

Tela 2%: =ropriedade )Eonstrutores) do elemento )proDeto)

Pastas, Propriedades

Tela 2A: =ropriedade do elemento pasta ,1older+o acionar a op#o "*ropriedades altR;CT;: ", vocD pode verificar e editar algumas informaes sobre a pasta 01older1! *ara detal/es da op#o "@un?Debu5 Settin5s", veja "Trabal/ando com projetos% ;$ecu#o"! +lgumas propriedades ser#o propagadas para todas as subpastas e arquivos!

Todos os direitos reservados.


TDS

- 24

(rquivos, Propriedades

Tela 6=% *ropriedades do elemento arquivo +o acionar a op#o "*ropriedades altR;CT;: ", vocD pode verificar e editar algumas informaes sobre o arquivo! *ara detal/es da op#o " @un?Debu5 Settin5s", veja "Trabal/ando com *rojetos% "epura#o" e de "IreaNpoint *roperties", veja ""epura#o de *rojetos% "epura#o% *ontos de parada"!

Todos os direitos reservados.


TDS

- 25

+cessando o TOTVS Server


*ara acessar a perspectiva TOTVS Server, ou qualquer outra, selecione-a atravs do seletor de perspectiva 0Tela 6@ .1 ou pelo menu Janela | Abrir perspectiva | Outros e selecione TOTVS Server!

Tela 27: Seletor de perspectiva > perspectiva TOTVS Server semel/ante a:

Tela 28: =erspectiva )TOTVS Server) Onde temos% ?! Servers .-tension !&ela /0 (" G podemos definir quais servidores que vamos utilizar, permitindo tambm, efetuar configuraes e obter informaes sobre o processamento 0quando disponKvel1! 6! TOTVS ServerOutli e !&ela /0 ') G permite uma navega#o r pida entre as opes,abas de configura#o de um servidor previamente selecionado!

Todos os direitos reservados.


TDS

- 26

5! (bas informativas !&ela /0 1" G contm algumas vises 0views1 com informaes adicionais sobre o servidor, tais como usu rios conectados e pelo menu de conte$to desta, algumas operaes com o servidor!

Todos os direitos reservados.


TDS

- 27

Servers ;$tension% 2enu de conte$to


+ota, + partir da vers#o ??!?!6=!6>?6?>>??7>5 liberado em >?,>Q,6>?6, foi introduzido configura#o de segurana na edi#o de configuraes dos servidores! *or padr#o, a edi#o de configuraes negada a qualquer usu rio, e$ceto quando a cone$#o ao server for efetuada por "local/ost" 0?6=!>!>!?1! *ara liberar a edi#o% ?! +bra o arquivo "appServer!ini" com um editor de te$tos simples! ;ste arquivo encontrase no diretBrio do servidor de aplicaes *rot/eus 0appServer!e$e1) 6! (ocalize 0ou adicione1 a sess#o e c/aves abai$o% ST"ST +((O3;"ATUVestaes permitidasW 5! Salve o arquivo! Vestaes permitidasW U lista de ipXs ou nome das estaes, separados por vKrgula, que podem efetuar alteraes de configura#o no servidor!

Tela !9: Viso )Server <6tension) =ara acessar as a es dispon&veis4 acione o menu de conte6to sobre o elemento )Servidores" da rvore de navega#o! +s opes s#o% Opo Novo =rupo de Servidores Servidor Aplica12o Servidor ?=, Servidor ?=,P Servidor Adv@P, Servidor Interno Servidor *AAccess Servidor *AAccess de Descrio da funo Permite criar um elemento na &rvore que agrupa servidores. Apresenta a lista de tipos de servidores dispon>veis. Inicia a con#igura12o de um servidor com suporte a 4GL. Inicia a con#igura12o de um servidor com suporte a 4GLP. Inicia a con#igura12o de um servidor com suporte a Adv PL. Inicia a con#igura12o de um servidor com suporte a Adv@P,, pr65con#igurado e de uso e$clusivo a partir do -*S *eveloper Studio. Apresenta a lista de tipos de servidores dispon>veis. Inicia a con#igura12o de um servidor !"Access.

Todos os direitos reservados.


TDS

- 28

Cone$<es ativa

.or1a uma atualiza12o das abas in#ormativas, para os servidores conectados.

(dicionando um servidor
*ara adicionar um servidor, acione o menu de conte$to sobre o elemento " Servidores" da rvore de navega#o da vis#o Server <6tension 0Tela 5> +1, acione a op#o ervidor de Aplica!o | ervidor Adv"#$ 0ou o que l/e mel/or convier1! +guarde que ser inicializado um assistente semel/ante a%

Tela 5?% +ssistente para novo servidor Anforme os dados solicitados e finalize, obtendo algo semel/ante a%

Todos os direitos reservados.


TDS

- 29

Tela !2: =ropriedades de um servidor NOTA% =ara acessar a viso de edio de propriedades ,Tela !2 :- de um servidor4 e1etue um duplo;clic' no elemento 2ue identi1ica o servidor ,Tela !2 >-. VocD pode editar ou corrigir os dados de cone$#o deste servidor modificando os dados disponKveis nas p ginas 0na parte de bai$o da vis#o1 e acionando a salva atravs do atal/o ctrl R S ou ao trocar de p gina! Co menu de conte$to deste elemento, temos% Opo Conectar Servidor )emover Descrio da funo Conecta5se ao servidor con#orme as in#orma1<es constantes na con#igura12o -ela B/ A!. )emove as con#igura1<es do servidor, tornando5o inacess>vel.

+pBs efetuar a cone$#o com o servidor, o menu de conte$to passa a ter% Opo *esconectar Servidor Cone$<es ativas Para o Servidor *esabilita cone$2o Descrio da funo +ncerra a cone$2o com o servidor. .or1a uma atualiza12o das abas in#ormativas, para os servidores conectados. +nvia ao servidor um comando de parada s#utdown! +nvia ao servidor um comando para rejeitar novas cone$<es.

1onectando-se ao servidor
+pBs a configura#o de um servidor, acione o menu de conte$to sobre o elemento na rvore de navega#o e acione a op#o %&onectar ervidor"! NOTA :Os servidores com suporte a >dv?=" iro solicitar al5umas in1orma es antes de e1etuar a cone6o. $n1orme os dados solicitados. Se deseDar4 pode salvar o ).su+rio) e )Senha) em um local se5uro acionando a opo )Salvar as in1orma es de lo5in em local se5uro).

Todos os direitos reservados.


TDS

- 30

Tela !!: Eone6o com servidor >dv?=" Durante e apCs o processo de cone6o4 acompanhe as ocorr0ncias na viso console !

Tela

!#:

>ba

in1ormativa

console

+O&(S %e ela n#o estiver visKvel, acesse o menu Janela | Apresentar viso | Outros e na rvore de navega#o apresentada, abra 'eral e acione &onsole!

1onfi2urao do servidor
+pBs a cone$#o, na rea de editores, vocD ter algumas informaes 0Tela 5E I1 sobre o ambiente do servidor e acessando qualquer uma das p ginas 0Tela 5E .1 disponKveis, efetuar modificaes de configura#o e salvando-as ao acionar ctrlRS ou trocando-se a p gina! *ara saber como configurar e o que pode ser configurado em cada um dos servidores, consulte documenta#o especKfica!Servidor +dv,*(Servidor &'(Servidor +I(Servidor "I+ccess

Todos os direitos reservados.


TDS

- 31

Tela !%: Servidor conectado

Todos os direitos reservados.


TDS

- 32

.riando arquivos-fonte
*ara criar um novo arquivo-fonte, selecione o projeto e, opcionalmente, a pasta onde ser armazenado o arquivo-fonte! .aso n#o ten/a um projeto, acione o menu de conte$to na vis#o TOTVS <6plorer4 acessando a opo Novo | Projeto e na +rvore de nave5ao do assistente4 abra TOTVS Bi/ard e selecione Novo projeto !0Tela 57, Tela 5= e Tela 5@ 1

Tela !A: >ssistente de novo proDeto

Todos os direitos reservados.


TDS

- 33

Tela !*: $denti1icador do novo proDeto e lista de diretCrios para include

Tela !7: =roDeto iniciali/ado +cione o menu de conte$to na vis#o TOTVS <6plorer, acessando a op#o Novo | Ar(uivo, acionando o assistente de novos arquivos 0Tela 5Q1!

Todos os direitos reservados.


TDS

- 34

Tela 5Q% .riando um novo arquivo Ceste assistente, a pasta selecionada ser utilizada como "pasta pai" 0Tela 5Q +1 padr#o! Se quiser modificar o local, utilize a rvore de navega#o 0Tela 5Q I1! Co campo "Come do +rquivo" 0Tela 5Q .1 informe o nome do arquivo-fonte, incluindo a e$tens#o! (ogo abai$o, / um o bot#o "+vanadoWW", que se acionado apresenta op#o para criar uma liga#o simbBlica 0s(mbolic lin'1 com um arquivo j e$istente do seu sistema de arquivos! Se desejar criar como liga#o simbBlica, marque a op#o " "in' to 1ile in the 1ile s(stem" e selecione o arquivo acionando o bot#o "navegador"! Linalize e aguarde o processamento! +o final deste, ter algo semel/ante a Tela &>!

Tela #9: 3ovo pro5rama para edio +O&( , Easo tenha optado pela li5ao simbClica4 o ar2uivo;1onte D+ ir+ aparecer com conteFdo e o &cone de identi1icao do 1onte4 ter+ uma pe2uena seta a sua direita embai6o. "embre;se 2ue4 neste caso4 todas as altera es 2ue e1etuar sero 5ravadas no 1onte ori5inal. Ceste e$emplo, criamos o arquivo-fonte "programa!pr4", na pasta "src" do projeto

Todos os direitos reservados.


TDS

- 35

"meu*rojeto"! O uso do editor de fontes bastante semel/ante a outros que vocD deve estar acostumado, portanto saia digitando o seu cBdigo! Co ane$o A, vocD possui a lista dos principais comandos do editor! .opie o cBdigo 0sugest#o1, para continuar o aprendizado! user function meuTeste01 msgalert0"Lun#o do usu rio meuTeste e$ecutada"1 return

Obtendo algo semel/ante a%

Tela #1: <6emplo de ar2uivo;1onte em edio "urante a edi#o do fonte, a vis#o Outline 0Tela &? I1 ser atualizada com a identifica#o dos principais blocos do seu arquivo-fonte! Se vocD acionar o mouse sobre um destes itens, seu arquivo-fonte ser reposicionado para este elemento! Ca vis#o TOTVS <6plorer 0Tela &? +1, vocD tambm obtDm a lista dos principais blocos, se e$pandir o elemento 0 clic' no triYngulo vazado1!

Todos os direitos reservados.


TDS

- 36

;di#o de arquivos-fonte
+ edi#o de arquivos-fontes bem simples! (ocalize na rvore de navega#o do TOTVS <6plorer o arquivo desejado e efetue um duplo;clic' ou acione o menu de conte$to sobre o arquivo e a op#o Abrir!

Todos os direitos reservados.


TDS

- 37

+di#o de arquivos de recursos


;$tenses que n#o s#o recon/ecidas como de arquivos-fontes pelo TOTVS Developer Studio, por e$emplo a e$tens#o "!bmp" 0arquivo de imagem1, este adicionado como recurso e ao ser compilado ser ane$ado como tal, sendo possKvel acess -lo com o uso de funes especKficas da linguagem!

Todos os direitos reservados.


TDS

- 38

.ompila#o de arquivos e projetos


+ntes de efetuar a compila#o de um arquivo, pasta ou projeto, vocD precisa estar conectado a um servidor 0veja "*erspectiva TOTVS Server)1! Ca barra de ferramentas, vocD deve indicar qual servidor ser utilizado e no caso de +dv,*(, o ambiente 0Tela &61!

Tela #2: :ot es para seleo de servidor e ambiente4 para compilao e e6ecuo (rquivos *ara compilar, apBs indicar o servidor e ambiente, acione .trlRLQ ou acione o menu de conte$to sobre a rea do editor ou sobre o elemento do arquivo 0na rvore de navega#o1! O referido fonte ser compilado e na vis#o console 0Tela &5 +1, vocD obter informaes relativas a compila#o, tais como se foi ou n#o bem sucedida e neste caso, os motivos 0erros de compila#o1! + vis#o TOTVS <6plorer, tambm informa se / problemas de compila#o! 0Tela &5 I1, colocando um pequeno sinal indicativo!

Tela #!: @esultado da compilao de um ar2uivo;1onte Ca Tela &5, como e$emplo, temos o erro de arquivo de defini#o 0P!c/1 n#o encontrado! Ceste caso, selecione o elemento "projeto" na vis#o TOTVS <6plorer e acione alt)enter 0ou menu de conte$to, op#o #ropriedades1 e verifique a lista de diretBrios para busca de arquivo de defini#o!

Todos os direitos reservados.


TDS

- 39

Tela ##: >r2uivo;1onte com erro de sinta6e. 3a +rea do editor ,Tela ## >- h+ uma indicao da linha 2ue esta com erro. >o passar o mouse sobre a marca, obtDm-se uma janela popup indicando o erro! Co lado oposto 0Tela && I1 temos uma barra indicativa, que na sua altura, representa o seu arquivo-fonte e a as marcaes e$istentes indicam o local relativo de erro! +o clicar;se nesta marca, o editor ser posicionado nesta posi#o! ;sta barra tambm pode conter outras indicaes baseadas em cor, indicando alguma ocorrDncia, por e$emplo,avisos do compilador e mudanas ocorridas deste a Zltima salva! Ca rea de abas informativas, temos a vis#o "*roblemas" 0Tela && .1, que possui uma lista de todas as ocorrDncias da compila#o 0erros e avisos1! Se a lin/a de mensagem for acionada com um duplo;clic'4 o fonte ser aberto e posicionado no local indicado! *ara ativar a numera#o de lin/as e outros comportamentos do editor, acione o menu de conte$to do editor, acessando a op#o "*referDncias" e acione "S/o4 (ine Cumbers"!

Tela &E% +rquivo-fonte com avisos do compilar

Todos os direitos reservados.


TDS

- 40

Pastas e Projetos
*ara compilar pastas 01olders1 ou o projeto, acione o menu de conte$to sobre o elemento a ser compilado na rvore de navega#o da vis#o TOTVS <6plorer, e acione uma das opes% Recompilar <elemento > Compilar $elemento% Recompila todos os elementos do projeto ou pasta (folder). Compila todos os elementos que #oram modi#icados ou que n2o e$istam no reposit:rio RPO!.;

.omo estes processos podem levar algum tempo, l/e ser aberta a vis#o " =ro5resso", que efetua um retorno visual de como esta a e$ecu#o da tarefa 0Telas &7 e &=1!

Tela #A: Viso )=ro5resso) na barra de status ,posio padro-

Tela

#*:

Viso

)pro5resso)

acoplada

em

outra

posio

Todos os direitos reservados.


TDS

- 41

NOTA: > viso )=ro5resso) G utili/ada em diversas situa es4 normalmente na2uelas 2ue podem demandar al5um tempo de processamento.

Todos os direitos reservados.


TDS

- 42

;$ecu#o de projetos 'sico


Hma vez que o projeto esteja compilado e sem erros, vocD poder e$ecut -lo ou depurar 0debu51 seus programas! Tanto a e$ecu#o como a depura#o, s#o efetuados atravs de configuraes de e$ecutores 0lauchers1! *ara configur -los vocD deve acionar o menu suspens#o do bot#o ";$ecutar" ou ""epurar", selecionando a op#o ".onfigura#o !!!" 0Tela &@1!

Tela #7: Henu suspenso do boto )<6ecutar) Ca janela de configura#o, vocD pode adicionar, duplicar e remover e$ecutores! +cione a op#o "Covo" na barra de ferramentas 0Tela &Q +1!

Tela #8: Eon1i5urao de e6ecuo ou depurao

Todos os direitos reservados.


TDS

- 43

Ca tela apresentada 0Tela E>1, temos os campos% "Come" 0Tela E> +1, informe um identificador para o novo e$ecutor)

Tela E>% Tela de configura#o de e$ecutores O bloco "+mbiente de e$ecu#o +dv,*(" 0Tela E> I1, com%

"Htilizar servidor de aplica#o interno", se estiver marcado e$ige o uso de um servidor interno configurado e ser utilizado o e$ecut vel do Smart.lient 0remote1 que encontrase na instala#o do TOTVS Developer Studio. "*rograma Anicial", informe o nome do programa que ser e$ecutado 0programa principal1) "*arYmetros do programa", informe os parYmetros da lin/a de comando que ser utilizado na e$ecu#o do SmartElient ,remote-! "Oabilita pro1ile de e$ecu#o", se marcado, ao final da e$ecu#o l/e ser apresentada os resultados do pro1ile desta e$ecu#o! *ara salvar as configuraes e continuar a edi#o, acione "+plicar" 0Tela E> .1 ou se desejar cancelar as alteraes efetuadas, acione ":everter"! +o informar os dados mKnimos necess rios, o bot#o ";$ecutar" 0Tela E> "1 ser /abilitado e se acionado, iniciar a e$ecu#o! O bot#o "Lec/ar", encerra a edi#o! Se solicitar a e$ecu#o pelo acionamento do bot#o ";$ecutar" 0Tela E> "1, ou pelo menu suspenso dos botes ";$ecutar" ou ""epurar"0Tela ?51, l/e ser apresentada a tela de confirma#o! Ca cai$a suspensa, informe o nome do programa a ser e$ecutado!

Todos os direitos reservados.


TDS

- 44

.aso o campo "*rograma Anicial" 0Tela E> I1 preenc/ido, este ser usado como valor padr#o para a cai$a suspensa!

Tela E?% 9anela para e$ecu#o "epois que vocD criou e usou um e$ecutor, poder acion -lo diretamente pelo menu suspenso do botes ";$ecutar" ou ""epurar", selecionando a configura#o ou utilizando as teclas de atal/o L?? e .trlRL??, para e$ecutar a Zltima configura#o utilizada para depurar ou e$ecutar 0respectivamente1!

Todos os direitos reservados.


TDS

- 45

+vanado

Tela %2: >ba de con1i5urao do )code>vera5e) Ca configura#o avanada, utilizamos as demais abas 0telas E6, E51 com opes especKficas! Tela %2: >ba de con1i5urao do )code>vera5e) + aba "code>vera5e", permite /abilitar a "cobertura" do cBdigo e em quais fontes! *ara /abilitar, marque a op#o "Oabilitar cobertura de cBdigo" 0Tela E6 +1 e utilizando os botes a direita 0Tela E6 I1, informar quais os fontes que ser#o analisados!

Todos os direitos reservados.


TDS

- 46

Tela %!: >ba )Iontes) > aba )1ontes)4 voc0 in1orma onde o depurador deve produrar os 1ontes4 sendo o de1ault o seu projeto 0Tela E5 +1! Htilize os botes a direita 0Tela E5 I1, para adicionar outros diretBrios para a busca!

Todos os direitos reservados.


TDS

- 47

Tela %#: >ba )Eommom) + aba ".omum" 0Tela E&1, contm algumas opes de configura#o da visibilidade e outras opes ligadas diretamente com a configura#o do e$ecutor! Cesta aba, tempo% "Salvar como" 0Tela E& +1, indica se os dados de configura#o ser#o salvos localmente 0no seu wor'space1 ou em rea compartil/ada 0e$terna1! "+presentar como favorito" 0Tela E& I1, indique em qual menu suspenso vocD quer que a configura#o aparea! .aso n#o selecione nen/uma, esta ser apresentada em todos os menus suspensos! ";ncoding", permite vocD definir o formato da codifica#o do arquivo de configura#o! ";ntrada e saKda padr#o" 0Tela E& "1, permite configurar a apresenta#o ou n#o da vis#o console ou a sua grava#o em arquivo!

Todos os direitos reservados.


TDS

- 48

"epura#o de projetos
+ configura#o do e$ecutor 0laucher1 com depura#o e$atamente o mesmo utilizado na e$ecu#o, portanto, para configur -la utilize as instrues contidas em ".ompila#o de arquivos e projetos"! +O&( , Se voc0 D+ e1etuou a con1i5urao do e6ecutor4 D+ possuir+ a mesma con1i5urao para a depurao. *ara demonstrar o uso do depurador, usaremos o programa abai$o! Sugerimos que o copie e cole em um novo arquivo-fonte >dv?="!

user function calcLatorial01 local n ms2alert0".alculo de Latoriais"1 resultado %U "Cumero U Latorial" R c%r0?51 for n %U ? to E step 6 calcula0nP61 ne-t ms2(lert0resultado1 return static function calcula0anCumber1 local $ %U anCumber local total %U ? 3%ile 0$ W ?1 total %U total P $ $-end resultado RU str0anCumber,51 R " " resultado RU transform0total, "[; Q,QQQ,QQQ,QQQ"1 resultado RU c%r0?51 return

+pBs a compila#o do arquivo-fonte acima, e$ecute-o acionando o bot#o ";$ecutar" 0se necess rio configure um e$ecutor1! +pBs encerrar a e$ecu#o, ter algo semel/ante a%

Todos os direitos reservados.


TDS

- 49

Tela EE% *rograma sugerido para depura#o .om o editor ativo 0a aba fica destacada1, acione .trlRL?> e ative a numera#o de lin/as!

Tela E7% 2enu de opes do editor 0.trl R L?>1 ;fetue um duplo;clic' sobre o nZmero "7" 0lin/a 71! :epare que na barra cinza do lado esquerdo, aparece uma marca azul! ;sta marca indica um ponto de parada 0 brea'point1! Muando iniciarmos a depura#o, o depurador para a e$ecu#o nos pontos de parada e aguarda instrues do desenvolvedor!

Tela E=% *onto de parada definido na lin/a 7

Todos os direitos reservados.


TDS

- 50

Anicie o depurador, acessando o bot#o de menu suspenso ""epurar" e selecione o e$ecutor!

Tela E@% "isparando o depurador +guarde alguns instantes e l/e ser solicitado o programa inicial!

Tela EQ% Anforme o programa inicial Anforme o programa inicial e confirme, obtendo algo semel/ante a%

Tela A9: =ro5rama )calcIatorial) iniciado >cione )OJ). Devido ao ponto de parada de1inido ,Tela A9-4 o depurador ser+ selecionado. > perspectiva atual4 TOTVS Developer, n#o a mais indicada para depura#o! *or isso, vocD ser convidado a troc -la para a perspectiva TOTVS Debu5er 0Tela 7?1!

Todos os direitos reservados.


TDS

- 51

Tela 7?% .onvite para trocar a perspectiva atual para a de depura#o +ceite a troca e a perspectiva de depura#o l/e ser apresentada!

Tela A2: =erspectiva de depurao ,debu5- Ca perspectiva de depura#o 0debu51, temos% Viso 4debu24 !&ela 5/ (" G apresenta a pil/a de e$ecu#o, indicando o "camin/o" efetuado at c/egar ao ponto de parada! Tambm temos a barra de ferramentas desta vis#o, com as funcionalidades%

Todos os direitos reservados.


TDS

- 52

Tela 75% Iarra de ferramentas da vis#o debug

?! 6! 5! &! E!

:emove /istBrico de e$ecu#o j finalizadas) .ontinua a e$ecu#o at encontrar novo ponto de parado ou o trmino do programa) *ausa a e$ecu#o) ;ncerra a e$ecu#o) ;$ecuta um passo, se for c/amada de mtodo ou fun#o, para na primeira instru#o desta) 7! ;$ecuta um passo, se for c/amada de mtodo ou fun#o, e$ecute-a sem parar dentro desta) =! ;$ecuta at finalizar 0retornar1 do mtodo ou fun#o! Viso breakpoi ts !&ela 56 '" - apresenta a lista de pontos de paradas definidos! Tambm temos a barra de ferramentas desta vis#o, com as funcionalidades%

Tela A#: :arra de 1erramentas da viso brea'points ?! 6! 5! &! :emove os pontos de parada selecionados) :emove todos) +bre e posiciona-se no arquivo-fonte associado) Agnora todos os pontos de parada! (bas informativas !&ela 57 1" -diversas vises de apoio ao depurador!

Tela A%: >bas in1ormativas com vis es de apoio ao depurador &abela de dados -apresenta as tabelas abertas durante o processamento)

Todos os direitos reservados.


TDS

- 53

Tela AA: Viso Tabela de Dados (dv)P* 1ommands G permiti ao desenvolvedor e$ecutar comandos +dv,*( em tempo de e$ecu#o com resposta imediata)

Tela A*: Viso >dv?=" Eommands Variables G permiti verificar os valores das vari veis declaradas)

Tela 7@% Vis#o Vari veis +travs da barra de ferramentas, desta vis#o, vocD pode configurar a visibilidade, baseada em escopo, de quais vari veis ser#o apresentadas! .-pressions G permiti definir e$presses que s#o avaliadas a cada passo!

Tela A8: Viso <6presso Ceste momento, estamos parados na lin/a 7 do calcIatorial! +cione LE para e$ecutar um passo!

Todos os direitos reservados.


TDS

- 54

Tela *9: =erspectiva de depurao4 apCs avanar um passo :epare que na lin/a @, do lado esquerdo / uma pequena seta azul, indicando a prB$ima lin/a a ser e$ecutada! +cione LE, at que vocD entre na fun#o "calcula", tendo algo semel/ante a% :epare, que a vis#o Vari+veis teve seu conteZdo atualizado! ;stando dentro de um mtodo ou fun#o, se vocD acionar L= a e$ecu#o prosseguir , parando somente quando sair do mtodo ou fun#o! Ceste e$emplo, o depurador vai e$ecutar toda a fun#o "calcula", pararando somente na lin/a ?> 0logo apBs a c/amada1!

Todos os direitos reservados.


TDS

- 55

Tela *1: Depurando a 1uno calcula VocD tambm pode adicionar pontos de parada a qualquer momento, efetuando um duplo; clic' sobre o nZmero da lin/a! Laa isso na lin/a 67!

Tela =6% +dicionado um ponto de parada na lin/a 67 +cionando L@ 0continuar e$ecu#o1, o processamento ir ser e$ecutado at o prB$imo ponto de parada! +cione o L@ para continuar a e$ecu#o e ao final obter algo semel/ante a%

Todos os direitos reservados.


TDS

- 56

Tela =5% Tela final do calcLatorial *ara retornar a perspectiva de desenvolvimento selecione-a na rea de sele#o de perspectivas 0Tela ?> .1!

Todos os direitos reservados.


TDS

- 57

+ssistentes de .Bdigo
;ste assistente, ao ser acionado, o au$iliar na cria#o de programas +dv,*( com funcionalidades especKficas conforme as informaes fornecidas! ?! Selecione o (ocal 0Tela =& +1 onde o arquivo-fonte ser salvo)

Tela =&% Tipos de assistentes no +ssistente de .Bdigo

2. Anforme o +ome do 8onte 0Tela =& I1 3. Selecione o &ipo de (ssistente 0Tela =& .1
&! +cione o bot#o *rB$imo 0Tela =& "1! .onforme o &ipo de (ssistente selecionado, vocD ser guiado por uma ou mais p ginas para complementar os dados necess rios para a gera#o do arquivo-fonte!

(ssistente de c9di2o, 1adastro


;ste tipo de assistente o au$ilia a criar arquivos-fontes, capazes de efetuar manuten#o de dados em tabelas!

Todos os direitos reservados.


TDS

- 58

Tela *%: De1inio de tipo de template com in1orma es primordiais

,. Selecione o tipo template, em 1adastro - &ipo de arquivo0Tela =E +1, conforme a


origem da defini#o da tabela! a! +rquivo padr#o Kutilizado quando a defini#o da tabela a mesma do dicion rio de dados, preenc/endo os dados solicitados! b. Par:metros G identifica uma =er5unte definida no dicion rio de dados do =rotheus) c. (lias 0Tela =E I1 G no caso de arquivo padr#o, este ser utilizado para localizar as definies no dicion rio de dados, caso seja arquivo especKfico este ser utilizado para identificar a rea de trabal/o 0select area1) d! + ordem de apresenta#o dos dados definido por uma das opes%

e. ;tili<e =ndice padro 0Tela =E .1G indica qual o nZmero do Kndice do


dicion rio de dados, associado ao alias, que ser utilizado )

f. ;tili<a =ndice temporrio 0Tela =E "1 G informe uma e$press#o +dv,*( v lida
para indicar a ordem dos dados! ;ste Kndice de uso tempor rio, sendo eliminado apBs o seu uso! 6! +rquivo especKfico G utilizado para uma estrutura livre da tabela!

Todos os direitos reservados.


TDS

- 59

Tela *A: De1inio da estrutura para tipo de ar2uivo espec&1ico

a. Par:metros 0Tela =7 +1 G identifica uma =er5unte definida no dicion rio de dados


do =rotheus)

b. .strutura 0Tela =7 I1 - utilizado para definir a estrutura da tabela! Htilize os botes c.


a direita para adicionar ou remover atributos 0campos1! #nde-ado 0Tela =7 .1 G se marcado indica que a tabela ser ordenada pela e$press#o >dv?=" informada em 1%ave!

6! +pBs preenc/er os dados, avance para a p gina seguinte) 5! Cesta p gina do assistente de cBdigo, vocD complementa os dados, podendo detal/ar funcionalidades!

Todos os direitos reservados.


TDS

- 60

Tela

**:

De1inio

do

template

de

cadastro

#. Selecione o templatede cadastro 0Tela =7 +1, conforme a visualiza#o e comportamento desejado% a- a6Eadastro K Eadastro =adroni/ado , ir utilizar a fun#o a6Eadastro da biblioteca +dv,*( b- Hbrowse K de1inindo op es4 ir utilizar a fun#o m:rowse da biblioteca +dv,*( E! Cas abas logo abai$o, vocD efetua algumas customizaes% a1+ba "Iotes" 0Tela =@1- utilizada somente pela op#o de template 2bro4se e permite adicionar ou remover funcionalidades a tela utilizando os botes do lado direito)

Tela =@% .onfigura#o de botes para mIro4se b1+ba ".ampos" 0Tela =Q1 - permiti vocD indicar quais campos e customizar alguns atributos! .aso n#o especifique, ser utilizado todos os campos definidos no dicion rio de dados ou na defini#o de tabela customizada!

Todos os direitos reservados.


TDS

- 61

Tela =Q% Sele#o de campos e atributos c1 .onfiguraes 0Tela @>1G permiti definir propriedades opcionais!

Tela 79: Eon1i5ura es opcionais do assistente Titulo G informe o titulo a ser utilizado na janela) .ampo "iferenciador G e$press#o >dv?=", utilizada pela m:rowse para agrupar os dados +o preenc/er todos os dados obrigatBrios solicitados, finalize! VocD obter algo semel/ante a Tela @?! (ocalize a entrada de fun#o user 1unction e coloque um nome mais significativo, salve e compile!

Todos os direitos reservados.


TDS

- 62

Tela 71: <6emplo de cCdi5o 5erado pelo >ssistente

+ssistente de cBdigo% 'era#o de +rquivo Te$to


;ste tipo de assistente o au$ilia a criar arquivos-fontes, capazes de gerar arquivos te$tos a partir de uma tabela de dados!

Todos os direitos reservados.


TDS

- 63

Tela 72: >ssistente para Lerao de >r2uivo Te6to

,. Selecione o tipo template, em >erao de &?& - &ipo de arquivo 0Tela @6 +1,


conforme a origem da defini#o da tabela! a! +rquivo padr#o Kutilizado quando a defini#o da tabela a mesma do dicion rio de dados, preenc/endo os dados solicitados!

b. Par:metros G identifica uma =er5unte definida no dicion rio de dados


do =rotheus) c. (lias 0Tela @6 I1 G no caso de arquivo padr#o, este ser utilizado para localizar as definies no dicion rio de dados, caso seja arquivo especKfico este ser utilizado para identificar a rea de trabal/o 0select area1) d! + ordem de leitura dos dados definido por uma das opes%

e. ;tili<e =ndice padro 0Tela @6 .1G indica qual o nZmero do Kndice do f.


dicion rio de dados, associado ao alias, que ser utilizado ) ;tili<a =ndice temporrio 0Tela @6 "1 G informe uma e$press#o +dv,*( v lida para indicar a ordem dos dados! ;ste Kndice de uso tempor rio, sendo eliminado apBs o seu uso!

Todos os direitos reservados.


TDS

- 64

Tela @5% "efini#o de arquivo especKfico a! +rquivo especKfico G utilizado para uma estrutura livre da tabela!

b. Par:metros 0Tela @5 +1G identifica uma =er5unte definida no dicion rio de dados
do =rotheus)

c. .strutura 0Tela @5 I1 - utilizado para definir a estrutura da tabela! Htilize os botes


a direita para adicionar ou remover atributos 0campos1!

d. #nde-ado 0Tela @5 .1 G se marcado indica que a tabela ser ordenada pela


e$press#o >dv?=" informada em 1%ave! ?! +pBs preenc/er os dados, avance para a p gina seguinte) 6! Cesta p gina do assistente de cBdigo, vocD complementa os dados detal/ando como ser o arquivo te$to!

Todos os direitos reservados.


TDS

- 65

+rquivo

Te$to 0Tela

@&1

Andique

origem

dos

demais

dados,

podendo

ser%

Tela @&% "efini#o do formato do arquivo te$to definido "efinido 0Tela @& +1 G os valores s#o fi$os e informados logo abai$o) *arametrizado 0Tela @E +1G os valores ser#o lidos a partir de uma vari vel 0normalmente de escopo privado 0private1!

Tela @E% "efini#o do formato do arquivo-te$to parametrizado

Todos os direitos reservados.


TDS

- 66

Anforme os demais campos conforme solicitado 0Tela @& I e ., Tela @E I e .1 b1 *osies G ser utilizado para definir o la(out do arquivo de saKda! "efina o la(out informando os dados .ampo, posi#o, taman/o, nZmero de decimais e tipo! *ara adicionar ou remover campos, utilize os botes do lado direito!

Tela @7% "efini#o do la(out do arquivo de saKda +o preenc/er todos os dados obrigatBrios solicitados, finalize! VocD obter algo semel/ante a Tela @=! (ocalize a entrada de fun#o user function e coloque um nome mais significativo, salve e compile!

Todos os direitos reservados.


TDS

- 67

Tela 7*: Tela apCs a e6ecuo do >ssistente de Lerao de >r2uivo Te6to

(ssistente de c9di2o, #mportao de (rquivo &e-to


;ste tipo de assistente o au$ilia a criar arquivos-fontes, capazes de importar arquivos te$tos e gravando-os em uma tabela de dados!

Todos os direitos reservados.


TDS

- 68

Tela 77: >ssistente para importao de ar2uivos te6tos

,. Selecione o tipo template, em #mportao de &?& - &ipo de arquivo0Tela @@ +1, conforme


a origem da defini#o da tabela! a! +rquivo padr#o Kutilizado quando a defini#o da tabela a mesma do dicion rio de dados, preenc/endo os dados solicitados!

b. Par:metros G identifica uma =er5unte definida no dicion rio de dados


do =rotheus)

c. (lias 0Tela @@ I1 G no caso de arquivo padr#o, este ser utilizado para localizar as
definies no dicion rio de dados, caso seja arquivo especKfico este ser utilizado para identificar a rea de trabal/o 0select area1) d! + ordem de leitura dos dados definido por uma das opes%

e. ;tili<e =ndice padro 0Tela @@ .1G indica qual o nZmero do Kndice do dicion rio de
dados, associado ao alias, que ser utilizado )

f. ;tili<a =ndice temporrio 0Tela @@ "1 G informe uma e$press#o +dv,*( v lida para
/.

indicar a ordem dos dados! ;ste Kndice de uso tempor rio, sendo eliminado apBs o seu uso! +rquivo especKfico G utilizado para uma estrutura livre da tabela!

Todos os direitos reservados.


TDS

- 69

Tela 78: =arMmetros para importao do ar2uivo te6to de1inido

a. Par:metros 0Tela @Q +1 G identifica uma =er5unte definida no dicion rio de dados


do =rotheus) b. .strutura 0Tela @Q I1 - utilizado para definir a estrutura da tabela! Htilize os botes a direita para adicionar ou remover atributos 0campos1! c. #nde-ado 0Tela @Q .1 G se marcado indica que a tabela ser ordenada pela e$press#o >dv?=" informada em 1%ave! 6! +pBs preenc/er os dados, avance para a p gina seguinte) 5! Cesta p gina do assistente de cBdigo, vocD complementa os dados detal/ando como o arquivo te$to de entrada! a! +rquivo Te$to 0@Q1 - Andique a origem dos demais dados, podendo ser% b! "efinido 0Tela @Q +1 G os valores s#o fi$os e informados logo abai$o) c. *arametrizado 0Tela Q> +1 G os valores ser#o lidos a partir de uma vari vel 0normalmente de escopo privado 0private11!

Todos os direitos reservados.


TDS

- 70

Tela Q>% "efini#o dos parYmetros para importa#o de arquivo te$to 6! Anforme os demais campos conforme solicitado 0Tela @Q I e ., Tela Q> I e .1 b1 *osies G ser utilizado para definir o la(out do arquivo de saKda!

. Tela Q?% "efini#o do la(out do arquivo de saKda "efina o la(out informando os dados .ampo, posi#o, taman/o, nZmero de decimais e tipo! *ara adicionar ou remover campos, utilize os botes do lado direito!

Todos os direitos reservados.


TDS

- 71

Tela 82: ECdi5o 5erado pelo assistente para importao de ar2uivos te6tos >o preencher todos os dados obri5atCrios solicitados4 1inali/e. Voc0 obter+ al5o semelhante a Tela 82. "ocali/e a entrada de 1uno user 1unction e coloque um nome mais significativo, salve e compile!

(ssistente de c9di2o, Processamento 2enrico


;ste tipo de assistente o au$ilia a criar arquivos-fontes, com um esqueleto para processamentos genricos!

Todos os direitos reservados.


TDS

- 72

Tela 8!: $niciando o assistente de cCdi5o para processamento 5enGrico

,.
a!

Selecione o tipo template, em Processamento >enrico - &ipo de arquivo 0Tela Q5 +1, conforme a origem da defini#o da tabela! +rquivo padr#o Kutilizado quando a defini#o da tabela a mesma do dicion rio de dados, preenc/endo os dados solicitados! Par:metros G identifica uma =er5unte definida no dicion rio de dados do =rotheus) (lias 0Tela Q5 I1 G no caso de arquivo padr#o, este ser utilizado para localizar as definies no dicion rio de dados, caso seja arquivo especKfico este ser utilizado para identificar a rea de trabal/o 0select area1) + ordem de leitura dos dados definido por uma das opes% ;tili<e =ndice padro 0Tela Q5 .1G indica qual o nZmero do Kndice do dicion rio de dados, associado ao alias, que ser utilizado ) ;tili<a =ndice temporrio 0Tela Q5 "1 G informe uma e$press#o >dv?=" v lida para indicar a ordem dos dados! ;ste Kndice de uso tempor rio, sendo eliminado apBs o seu uso!

Todos os direitos reservados.


TDS

- 73

b!

+rquivo especKfico G utilizado para uma estrutura livre da tabela!

Tela 8# : Eon1i5urao de ar2uivo espec&1ico

Par:metros 0Tela Q& +1G identifica uma =er5unte definida no dicion rio de dados do =rotheus) .strutura 0Tela Q& I1 - utilizado para definir a estrutura da tabela! Htilize os botes a direita para adicionar ou remover atributos 0campos1! #nde-ado 0Tela Q& .1 G se marcado indica que a tabela ser ordenada pela e$press#o >dv?=" informada em 1%ave! 6! +pBs preenc/er os dados, finalize! +o preenc/er todos os dados obrigatBrios solicitados, finalize! VocD obter algo semel/ante a Tela QE! (ocalize a entrada de fun#o user 1unction e coloque um nome mais significativo, salve e compile!

Todos os direitos reservados.


TDS

- 74

Tela 8% : Nanela apCs e6ecuo do assistentes para processamento 5enGrico

Todos os direitos reservados.


TDS

- 75

Cova .lasse +dv*(


;ste tipo de assistente o au$ilia na cria#o de arquivos-fontes, com um esqueleto para defini#o de uma classe em >dv?="!

Tela Q7% "efini#o de uma classe +dv,*( via +ssistente de .Bdigo Anforme os dados solicitados% *ocal 01older1 0Tela Q7 +1 G indica o local 01older1 onde o arquivo-fonte ser salvo +ome da 1lasse 0Tela Q7 I1 @ nome da classe Aerda a classe 0Tela Q7 .1 G nome da classe pai, quando tratar-se de classe com /erana 1riar arquivo como referBncia 0Tela Q7 "1 G o arquivo ser gravado no "iretBrio de "estino e no local ser criado uma liga#o simbBlica 0lin'1! +pBs informar os dados solicitados, finalize e obter algo semel/ante a%

Todos os direitos reservados.


TDS

- 76

Tela Q=% Tela apBs e$ecutar o +ssistente de .Bdigo para uma nova classe +dv,*(

Todos os direitos reservados.


TDS

- 77

Cova Lun#o +dv*(


;ste tipo de assistente o au$ilia na cria#o de arquivos-fontes, com um esqueleto para defini#o de uma fun#o em >dv?="!

Tela Q@% +ssistente para uma nova fun#o +dv,*( Anforme os dados solicitados% *ocal 01older1 0Tela Q@ +1G indica o local 01older1 onde o arquivo-fonte ser salvo +ome da funo 0Tela Q@ I1 @ nome da fun#o 1riar arquivo como referBncia 0Tela Q@ .1 G o arquivo ser gravado no "iretBrio de "estino e no local ser criado uma liga#o simbBlica 0lin'1! +pBs informar os dados solicitados, finalize e obter algo semel/ante a%

Todos os direitos reservados.


TDS

- 78

Tela QQ% Tela apBs a e$ecu#o do assistente de nova fun#o

Todos os direitos reservados.


TDS

- 79

Covo Lonte 3S"( +dv*(


<ste tipo de assistente o au6ilia na criao de ar2uivos;1ontes4 com a de1inio de um cliente de servio web ,4eb service client- a partir da sua de1inio BSD"!

Tela 199: <6ecuo do assistente de 5erao de clientes de servios web ,web service client;ste assistente depende de uma defini#o de servidor =rotheus e o selecionamento deste na barra de ferramentas! .aso o servio 4eb a ser utilizado esteja fora da rede do usu rio, o servidor =rotheus dever ter privilgios de acesso! Anforme os dados solicitados% *ocal 01older1 0Tela ?>> +1 G indica o local 01older1 onde o arquivo-fonte ser salvo +ome do fonte 0Tela ?>> I1@ nome do arquivo-fonte que conter a defini#o BSD" ;C* 0Tela ?>> .1G informe a H:( de onde esta o servio 4eb desejado 1riar arquivo como referBncia 0Tela ?>> "1 G o arquivo ser gravado no "iretBrio de "estino e no local ser criado uma liga#o simbBlica 0lin'1! +pBs informar os dados solicitados, finalize e obter algo semel/ante a%

Todos os direitos reservados.


TDS

- 80

Tela 191: Tela apCs a 5erao de um cliente de servio web

Todos os direitos reservados.


TDS

- 81

'era#o de pacote de atualiza#o 0*atc/1


+cione o bot#o de gera#o de pacote de atualiza#o 0 patch1 0Tela ?>6 +1!

Tela ?>5% *arYmetros iniciais para a gera#o de pacotes de atualiza#o 0patc/1 Cas cai$as de sele#o, indique qual a mel/or op#o para vocD% Servidor 0Tela ?>5 +1 - selecione o servidor =rotheus que ser utilizado para a gera#o do pacote! Todos os servidores registrados na vis#o TOTVS Server ser#o listados! (mbiente 0Tela ?>5 I1- selecione o ambiente 0obtido a partir do servidor selecionado1! Processo0Tela ?>5 .1 - indica qual procedimento ser adotado na gera#o dos pacotes! .ompara#o G este procedimento compara o seu :*O com um :*O mestre, gerando um pacote pela diferena entre eles) *rograma G este procedimento permitir que vocD indica qual ou quais programas ser#o colocados no pacote) 'rupo de *rojetos G permite que vocD escol/a um ou mais projetos que ir#o fazer parte do pacote! Salvar em 0Tela ?>5 "1 G selecione onde o arquivo de atualiza#o ser salvo apBs a sua gera#o! *ode ser na m quina local ou no servidor!

Por comparao
;ste processo compara o :*O atual do servidor,ambiente selecionado com um :*O denominado "mestre", que encontra-se em um diretBrio do servidor! *ara efetuar o procedimento%

Todos os direitos reservados.


TDS

- 82

?!

Anforme os dados solicitados% Servidor 0Tela ?>5 +1 G selecione o servidor que ser utilizado na compara#o (mbiente 0Tela ?>5 I1 G selecione o ambiente Processo 0Tela ?>5 .1 G #or compara!o *rossiga para a prB$ima etapa!

a. b. c.
6!

Tela ?>&% .onfigura#o da gera#o de pacote de atualiza#o por compara#o

3.

Selecione o diretBrio no qual encontra-se o :*O "mestre" 0Tela ?>& I1!

Tela ?>E% *acote de atualiza#o por compara#o realizado com sucesso!

!.

+cione %*inali+ar" e aguarde o final do processamento!

Todos os direitos reservados.


TDS

- 83

Por pro2rama
;ste processo permite vocD selecionar os programas que ser#o gravados no pacote de atualiza#o! Os procedimentos s#o% ?! Anforme os dados solicitados% Servidor 0Tela ?>5 +1 G selecione o servidor que ser utilizado na compara#o (mbiente 0Tela ?>5 I1 G selecione o ambiente Processo 0Tela ?>5 .1 G #or pro,rama *rossiga para a prB$ima p gina 0pode levar algum tempo1!

a. b. c.
6!

Tela 19A: Lerao do pacote de atuali/ao por pro5rama 5! Selecione os programas ou recursos,arquivos 0Tela ?>71 que far#o parte do pacote de atualiza#o utilizando o campo Procurar fonte ou Procurar recurso 0Tela ?>7 +1 e acionando o bot#o Liltrar correspondente, vocD pode localizar rapidamente um arquivo ou v rios, utilizando os caracteres coringa P e \! &! +cione "*inali+ar" e aguarde o final do processamento!

Por >rupo de Projeto


;ste processo permite gerar o pacote de atualiza#o, selecionando projetos da sua rea de trabal/o 0wor'space1! Os procedimentos s#o%

Todos os direitos reservados.


TDS

- 84

?!

Anforme os dados solicitados% Servidor 0Tela ?>5 +1 G selecione o servidor que ser utilizado na compara#o (mbiente 0Tela ?>5 I1 G selecione o ambiente Processo 0Tela ?>5 .1 G #or 'rupo de #rojetos *rossiga para a prB$ima p gina!

a. b. c.
6!

Tela ?>=% Sele#o de projetos para a gera#o do pacote de atualiza#o 5! Selecione os projetos na lista apresentada! +cione "*inali+ar" e aguarde o final do processamento!

!.

Todos os direitos reservados.


TDS

- 85

+plica#o de pacote de atualiza#o


+ota, + partir da vers#o ??!?!6=!6>?6?>>??7>5 liberado em >?,>Q,6>?6, foi introduzido configura#o de segurana na aplica#o pacotes de atualizaes 0 patch1! *or padr#o, a aplica#o pacotes de atualizaes 0patch1 negada a qualquer usu rio, e$ceto quando a cone$#o ao server for efetuada por "local/ost" 0?6=!>!>!?1! *ara liberar a aplica#o pacotes de atualizaes 0patch1% +bra o arquivo "appServer!ini" com um editor de te$tos simples! ;ste arquivo encontra-se no diretBrio do servidor de aplicaes *rot/eus 0appServer!e$e1) ?! +dicione a sess#o e c/aves abai$o% ST"ST allo4+ppl]*atc/UVestaes permitidasW 6! Salve o arquivo! Vestaes permitidasW U lista de ipXs ou nome das estaes, separados por vKrgula, que podem aplicar pacotes de atualizaes 0patch1! *ara liberar a aplica#o a partir de qualquer esta#o, informe "P" 0asterisco, sem aspas1!

+cione o bot#o de aplica#o de pacote de atualiza#o 0patch1 0Tela ?>6 I1 e preenc/a os dados solicitados!

Tela 197: >plicao de pacote de atuali/ao

Todos os direitos reservados.


TDS

- 86

?! Anforme os dados solicitado% a" Servidor 0Tela ?>@ +1 - selecione o servidor =rotheus que ser utilizado para a gera#o do pacote! Todos os servidores registrados na vis#o TOTVS Server ser#o listados! b" (mbiente 0Tela ?>@ I1- selecione o ambiente 0obtido a partir do servidor selecionado1! c" Pacote 0Tela ?>@ .1 G selecione onde o arquivo de atualiza#o a ser aplicado encontra-se! *ode ser na m quina local ou no servidor!

6! +cione "*inali+ar" e aguarde o final do processamento!

Tela 198: >plicao de pacote de atuali/ao 1inali/ada.

Todos os direitos reservados.


TDS

- 87

.ompila#o de vers#o
*ara efetuar um o processo de ".ompila#o de vers#o", use o bot#o e$istente na barra de ferramentas!

Tela ??>% Iot#o para acionamento ".ompila#o de vers#o" em destaque! ;ste processo permite que seja efetuado a gera#o de pacotes de atualiza#o 0 patch-, com a op#o de compilar ou n#o os fontes envolvidos, em mZltiplos ambientes! ?! +cione o bot#o de compila#o de vers#o!

Tela ???% *arYmetros iniciais para a compila#o de vers#o 6! a! Anforme os dados solicitados%

Servidor 0Tela ??? +1 - selecione o servidor =rotheus que ser utilizado para a compila#o e gera#o do pacote! Todos os servidores registrados na vis#o TOTVS Serverser#o listados! b! (mbiente 0Tela ??? I1- selecione o0s1 ambiente0s1 0obtido a partir do servidor selecionado1 no qual o processo ser e$ecutado!

Todos os direitos reservados.


TDS

- 88

c!

*er confi2uraDes 0Tela ??? .1 G permite recuperar as configuraes de um arquivo e$terno, gerado pelo acionamento do bot#o "Salvar .onfigura#o" 0Tela ??6 L1!

Tela ??6% Sele#o de projetos e fontes na compila#o de vers#o 5! a! +cione "*rB$imo" e na tela apresentada informe os dados solicitados%

#tens do pacote 0Tela ??6 I1 G na rvore de sele#o apresentada, selecione os itens que deseja que faam parte do pacote a ser compilado,gerado) b! 1ompilar selecionados 0Tela ??6 .1 G quando acionada esta op#o, os itens selecionados ser#o compilados em todos os ambientes selecionados na tela anterior! c! >erar patc! da seleo de projetos 0Tela ??6 "1 G ser e$ecutado o processo de gera#o de pacote de atualiza#o, para todos os ambientes selecionados) COT+% Laz-se necess rio selecionar uma delas ou as duas opes acima! d! *ocal 0Tela ??6 ;1 G selecione onde ser gravado o pacote de atualiza#o 0se a op#o anterior estiver marcada1! e! Salvar confi2uraDes 0Tela ??6 L1 G permite salvar as configuraes efetuadas em um arquivo e$terno, para posterior reutiliza#o carregando este arquivo atravs do acionamento do bot#o "(er .onfigura#o" 0Tela ??6 .1! &! +cione "Linalizar" e aguarde o trmino do processamento!

Todos os direitos reservados.


TDS

- 89

Tela ??5% ;$emplo de ocorrDncias durante o processo de compila#o de vers#o

Todos os direitos reservados.


TDS

- 90

"esempen/o de programas 0*rofile1 Obtendo perfil


+travs de uma configura#o de e$ecutor 0laucher1, podemos ativ -la quando necess rio! ?! +cesse a configura#o de e$ecutores 0laucher1 para depura#o!

Tela 11#: >cessando a con1i5urao de e6ecutor para depurao

6! +dicione uma nova configura#o e preenc/a os dados solicitados da mesma forma que uma e$ecu#o normal!

Tela 11%: <6ecuo do calcIatorial 1inali/ado.

!. Oabilite a e6ecuo do pro1ile marcando a op#o 0Tela ??E +1! E#1( %:epare que temos duas configuraes! Hma "padr#o" onde n#o esta /abilitado o pro1ile e a "profile"! .om isso fica f cil e r pido us -lo ou n#o! &! +cione a configura#o com o pro1ile ativado e e$ecute seu programa normalmente at o final!

Todos os direitos reservados.


TDS

- 91

Tela 11A: <6ecuo do calcIatorial 1inali/ado

E! +bra a vis#o =ro1ile, acessando 9anela F +presentar vis#o F Outras, na janela apresentada digite "*rofile" 0sem aspas1 e selecione a op#o +dv,*( *rofile!

Tela ??=% +brindo a vis#o +dv,*( *rofile

7! Obtendo algo semel/ante a%

Tela 117: Viso >dv?=" =ro1ile aberta

*. <1etue um duplo;clic' sobre o nome da vis#o 0Tela ??@ +1 para ma$imiz -la!

Todos os direitos reservados.


TDS

- 92

Tela 118: =er1il de e6ecuo do pro5rama calcIatorial

+nalisando *erfil
Hsando o perfil de e$ecu#o obtido 0Tela ??Q1, temos diversas informaes que nos au$iliaram a detectar onde pode estar ocorrendo o gargalo e onde podemos mel/orar! Cesta tela, temos% 8ontes 0Tela ??Q +1 - lista de arquivos-fontes que foram carregados para a e$ecu#o do teste) Eados 0Tela ??Q I1 - dados estatKsticos de cada programa,fun#o e$ecutada)

#nformaDes resumidas
+s informaes resumidas, l/e d uma vis#o geral do perfil da e$ecu#o que acabou de fazer! +nalisando 8ontes, vemos que o arquivo-fonte calcIatorial.prw4 consumiu cerca de 7=^ do tempo total de processamento! 9 os identificados como internal 0funes internas do =rotheus1, consumiram cerca de 55^ e os demais, a medi#o foi insignificante 0>^1! Selecione, em 8ontes, o arquivo-fonte calcIatorial, obtendo algo semel/ante a%

Tela 129: Dados do per1il 1iltrados pelo ar2uivo;1onte calcTutorial.prw Ca rea de dados 0Tela ?6> +1, temos% Pro2rama)8uno, identifica o nome do programa ou fun#o) 1%amadas, nZmero de vezes que foi c/amado) *in%a, identifica a lin/a do fonte 0ver "Anforma#o detal/ada"1) &empo Mdio !ms", tempo mdio de e$ecu#o por c/amada) &empo &otal !ms"F tempo total de todas as c/amadas) 8onte, arquivo-fonte onde esta definida a entrada da fun#o!

Todos os direitos reservados.


TDS

- 93

#nformao detal%ada
+o passar o mouse sobre a rea de dados, aparecer do lado esquerdo de cada nome do programa,fun#o 0Tela ?6> I1 uma pequena seta! +cionando-a, vocD obter um detal/amento daquela fun#o,programa!

Tela 121: Detalhes do per1il de e6ecuo do uPcalcIatorial Se voc0 acionar um duplo;clic' sobre uma lin/a dos dados, o editor abrir o fonte e posicionando-o na lin/a do arquivo-fonte! + coluna 1%amadas4 indica o nZmero de vezes que a lin/a foi e$ecutada e a coluna *in%a identifica o nZmero da lin/a do fonte! +nalisando-se os tempos e nZmero de c/amadas,e$ecues, podemos efetuar alteraes no fonte, visando mel/orar o seu desempen/o! Lunes,programa que possuem intera#o com o usu rio, por e$emplo a Hs5>lert e entrada de dados 05et e similares1, podem gerar distores em fun#o da velocidade de resposta do usu rio!

Todos os direitos reservados.


TDS

- 94

.obertura de cBdigo 0coverage code1


1obertura de c9di2o ou no inglDs, covera5e code - um programa testado aquele em que TO"+S as suas instrues foram e$ecutadas ao menos uma vez!Asso efetuado por testes sucessivos, tentando "cobrir" todas as situaes tratadas no cBdigo!

O TOTVS Developer Studio disponibiliza aos desenvolvedores uma ferramenta que os ajudar no processo de testes, identificando qual parte do cBdigo j foi e$ecutado!

*assar por todas as lin/as do seu cBdigo, n#o significa que ele esteja livre de erros, apenas minimiza as c/ances disto ocorrer!

Todos os direitos reservados.


TDS

- 95

+tiva#o da cobertura de cBdigo


*ara ativar este recurso, acesse a configura#o de um e$ecutor!

Tela 122: >cessando o con1i5urador de e6ecutor Ca janela apresentada, selecione a aba Eobertura de ECdi5o 0Tela ?65 +1

Tela ?65% Oabilita#o da cobertura de cBdigo 0coverade code1 Cesta p gina, preenc/a os dados solicitados% Aabilitar cobertura de c9di2o 0Tela ?65 I1 - /abilita ou n#o a cobertura de cBdigo! #nforme os fontes para cobertura 0Tela ?65 .1 - lista de arquivos-fontes aos quais vocD desejar efetuar a cobertura de cBdigo! *ara selecion -los, utilize os botes a direita 0Tela ?65 "1! +pBs selecionar os fontes e ativar a cobertura, inicie a e$ecu#o acionando o bot#o Debu5 0Tela ?67 ;1!

Todos os direitos reservados.


TDS

- 96

*lano de teste
+o e$ecutar o programa sugerido, teremos%

Tela ?6&% Tela do programa sugerido escol/eCum .om base nele, elaboramos os planos de testes! Muando a e$ecu#o for encerrada, e$ecute-a novamente para o novo teste! ?! Teste ? ?!?! +cionar bot#o "?") ?!6! +cionar bot#o "E") ?!5! +cionar bot#o "VencerrarW") Teste 6 6!?! +cionar bot#o "5") 6!6! +cionar bot#o "&") 6!5! +cionar bot#o "Vnen/umW") 6!&! +cionar bot#o "VencerrarW") ;$ecute o plano de teste!

6!

Todos os direitos reservados.


TDS

- 97

+nalisando a cobertura de cBdigo


+cione a vis#o Eovera5e, acessando Janela | Apresentar viso | Outras ... , localize TOTVS =ro1ile e acione Eovera5e! Obtendo algo semel/ante a%

Tela ?6E% Tela apBs e$ecu#o com a a op#o de cobertura de cBdigo ativado Ca vis#o recm-aberta 0Tela ?6E +1, teremos o registro dos testes efetuados! ;$panda o primeiro registro acionando a seta a esquerda 0Tela ?6@ I1 da cai$a de sele#o! .om a e$pans#o, obter uma lista de fontes que tiveram sua e$ecu#o monitorada! Selecione o arquivo-fonte escolhe3um.prw 0Tela ?6Q +1 e as lin/as que foram processadas ao menos uma vez, ser#o destacadas no editor!

Todos os direitos reservados.


TDS

- 98

Tela 12A: >pCs selecionar um ar2uivo;1onte4 na viso Eovera5e Se utilizarmos o plano de teste ? como referDncia e analisarmos o cBdigo destacado, vemos que / coerDncia entre eles! Ou seja, o cBdigo esperado para o teste ?, foi e$ecutado de forma satisfatBria! Ca lin/a de identifica#o do fonte 0Tela ?67 +1, / algumas informaes, que s#o% 1obertura G, indicando o percentual de lin/as que foram e$ecutadas) .-ecutado, o nZmero de lin/as e$ecutada) &otal *in%as, total de lin/as e$ecutado! ;$panda o registro de e$ecu#o do segundo teste e selecione a lin/a do arquivofonte escolhe3um.prw 0Tela ?6=1! "a mesma forma que o ?_ teste, vemos em destaque o cBdigo que foi e$ecutado e este esta coerente com o nosso teste!

Todos os direitos reservados.


TDS

- 99

Tela ?6=% Tela apBs selecionar o arquivo-fonte do 6_ teste :epare que, em ambos, e$iste um indicador do percentual de cBdigo coberto 0.obertura ^1! Muanto mais alto o Kndice de cobertura 0individual1 os erros s#o minimizados ainda mais! .obrir um programa em ?>>^, pode ser bastante difKcil ou mesmo invi vel devido as regras de negBcios! *or isso, temos que efetuar planos de testes o mais abrangente possKvel e depois de e$ecutados, verificamos a cobertura de cada um isoladamente e depois em conjunto! *ara efetuar a analise em conjunto, e$ecutamos um processo de fus#o 0 mer5e1 dos registros de testes!

Tela 127: Ia/endo 1uso ,mer5e- entre re5istros de testes Selecione os re5istros de testes e acione o boto ,Tela 127 >- para iniciar a 1uso , merge1 e aguarde! Os registros de testes selecionados ser#o fundidos em um Znico registro! ;$panda-o e selecione o arquivo-fonte e veja como fica a cobertura!

Todos os direitos reservados.


TDS

- 100

Se vocD verificar, o Kndice de cobertura representa o percentual coberto agregado! +nalisando o que esta destacado com os planos de testes, vemos que continuam coerentes! Ol/ando o arquivo-fonte, vemos que a lin/a ?E n#o esta destacada! Asso demonstra que em nen/um dos testes anteriores este cBdigo foi e$ecutado! .om base nestas informaes montamos mais um teste de forma que este cBdigo seja e$ecutado!

Tela ?6Q% Tela apBs a fus#o 0merge1 dos testes ?! a! b! Teste 5 0em adi#o ao criado em *lano de teste1 +cionar bot#o "6") +cionar bot#o "VencerrarW"! ;$ecute este novo teste e obtemos algo semel/ante a Tela ?5>, apBs selecionar o arquivofonte! +nalisando o cBdigo destacado, vemos que esta coerente com o nosso testes! +gora devemos efetuar a fus#o 0mer5e1 deste teste com o registro da fus#o anterior e obteremos como resultado algo semel/ante a Tela ?5?! Ca lin/a do registro do arquivo-fonte, obtemos um novo Kndice de cobertura!

Todos os direitos reservados.


TDS

- 101

Tela 1!9: Trecho de cCdi5o ainda no coberto .riamos um novo plano de testes, e$ecutamos, verificamos o seu registro de cobertura 0se esta coerente1, efetuamos a fus#o deste novo teste com os anteriores e verificamos o Kndice de cobertura!

Tela 1!1: Tela apCs a e6ecuo do !Q plano de teste Lazemos estes procedimentos at que ten/amos coberto o m $imo possKvel de cBdigo! Htilizando-se de v rias planos de testes e possKvel c/egarmos a ?>>^ de cobertura!

Todos os direitos reservados.


TDS

- 102

Tela 1!2: Tela apCs a 1uso ,mer5e- de todos os testes

Todos os direitos reservados.


TDS

- 103

2onitoramento de servidores
+o selecionar a perspectiva TOTVS Server , o desenvolvedor pode monitorar os servidores registrados e conectados 0Tela ?551!

Tela 1!!: =erspectiva TOTVS Server admin com as vis es de monitoramento +O&( , Easo no esteDa dispon&vel a viso de monitoramento do tipo de servidor conectado4 voc0 pode adicion+;lo acessando Janela | Abrir Viso | Outras4 locali/ando;a na +rvore apresentada e selecionando;a em se5uida! +o selecionar o nB principal 0Servers, Tela ?55 destaque1, todas as vises de monitoramento dos servidores abai$o dele, ser#o atualizados! .aso selecione um servidor especKfico 0Tela ?5& ou Tela ?5E1, em destaque1, somente a vis#o de monitoramento deste ser atualizado e os demais ficaram sem informa#o!

Tela 1!#: Honitoramento do servidor )localhost)

Todos os direitos reservados.


TDS

- 104

Tela 1!%: Honitoramento do servidor )dbaaccess)

Todos os direitos reservados.


TDS

- 105

TOTVS "eveloper Studio no seu idioma


O processo de tradu#o, tanto dos adicionais do TOTVS F "eveloper Studio, como o prBprio ;clipse 0base do TOTVS F "eveloper Studio1 est#o em andamento! +o selecionar outros idiomas, podem aparecer partes no idioma selecionado, partes em *ortuguDs 0Irasileiro1 ou em AnglDs! O TOTVS | Developer Studio, j esta preparado para trabal/ar em v rios idiomas e o <clipse 0base do TOTVS F "eveloper Studio1, pode ser utilizando em um nZmero de idiomas bem maior 0mais 6>1! O idioma nativo do <clipse o AnglDs, n#o sendo necess rio nen/uma configura#o especKfica! 9 outros idiomas, vocD deve instalar o adicional que contm o idioma desejado!

,.

+cesse -elp | Install new software...

Tela 1!A: >dicionar novo so1tware ou pacote ,adicional-

2.

3.
&! E! 7!

:.
@!

3o campo )Bor' with:) ,Tela 1!A >-4 in1orme o endereo do proDeto ):abel)4 2ue G o respons+vel pelo 5erenciamento de internacionali/ao do <clipse ) 0copie a urlhttp:??download.eclipse.or5?technolo5(?babel?update;site?@9.19.9?indi5o?4 acessado em Outubro?29121 (ocalize o adicional ":abel "an5ua5e =ac's 1or eclipse" e e$panda-o) Co item e$pandido 0Tela ?57 I1, selecione os idiomas desejados) +cione "Ce$t" 0Tela ?57 .1 e prossiga com as instrues fornecidas) +o solicitar a reinicializa#o, n#o o faa! ;ncerre o TOTVS | Developer Studio) ;dite o atal/o 0conforme seu sistema operacional1, acrescentando o parYmetro ;nl locale 0localiza#o1 na lin/a de comando)

Todos os direitos reservados.


TDS

- 106

Tela 1!*: Eon1i5urao para e6ecutar em =ortu5u0s do :rasil ,ptP:@O parMmetro de iniciali/ao nl, necessita da informa#o locale, que indica qual o idioma a ser utilizado! ;ste valor composto por uma ou mais siglas, que formam um cBdigo! OTOTVS | Developer Studio suporta os seguintes idiomas com seus respectivos cBdigos! Idioma Portugu's Arasil! Ingl's +span7ol C di!o locali"ao ptCA) en es

Q! Anicie o TOTVS | Developer Studio normalmente!

Todos os direitos reservados.


TDS

- 107

*rincipais comandos do editor


Atalho Edio
4trl = 2lt = >" 4trl = 2lt = *o? 4trl = .ac@ 4trl = *el 2lt = >" 2lt = *o? 4trl = S<ift = B 4trl = S<ift = C 4trl = ' ' sert *elete 4trl = E3 2lt = F

Funo
*u"lica o bloco acima. *u"lica o bloco abai0o. A0clui "alavra a terior. A0clui "r60ima "alavra. #ove a li <a "ara cima. #ove a li <a "ara bai0o. 4oloca bloco selecio ado em maisculo. 4oloca bloco selecio ado em mi sculo. Afetua a ide tao do arquivo-fo te ou do trec<o selecio ado. 2lter a e tre modo de i sero e sobrescrita. Demove uma letra a direita ou o bloco selecio ado. ' icia com"ilao %requer servidor& 4om"leta as "alavras sem mostrar a ja ela popup de o";esG "ressio e ovame te "ara alter ar as o";es dis"o Hveis. 2tiva ja ela popup de com"letarFautocom"letar. Demove a li <a atual 2lter a e tre ja ela m0ima e mH ima da viso corre te. 2bre a viso outline em uma ja ela popup. 2bre um me u popup com al5umas o";es. Afetua a ide tao do "ro5rama-fo te ou bloco selecio ado.

4trl = As"ao 4trl = * 4trl = # 4trl = O 4trl = E,4trl = S<ift = '

Busca
4trl = E 4trl = K 4trl = S<ift=K 4trl = S<ift = > 4trl = I 4trl = S<ift = D IocaliJao e substituio de te0to IocaliJa "r60ima ocorrL cia IocaliJa ocorrL cia a terior Iista todas as ocorrL cias da "alavra selecio ada ou que esta sob o cursor. #ove cursor "ara uma li <a es"ecHfica A0ibe lista de DecursosG e tre eles os fo tes do "rojeto.

Navegao
4trl=Pa5e*o? 4trl=Pa5e>" 4trl = 3 #ove "ara a "r60ima aba do editor #ove "ara a aba a terior do editor A0ibe o ave5ador r"ido. *i5ite uma "alavra "ara i iciar a busca em todas as vis;esG me us e barra de ferrame tas. /ave5ar e tre os eleme tos em edio

4trl=A

Todos os direitos reservados.


TDS

- 108

4trl=E9 4trl=E: 4trl=E7

2lter a e tre os arquivos aberto o editor. 2lter a e tre as vis;es abertas. 2lter a e tre as "ers"ectivas abertas.

Depurao
E+ E9 E7 Percorre li <a Pula li <a A0ecuta

Diversos
4trl=S<ift=I A0ibe lista de atal<os. Selecio a do 4trl=S<ift=I duas veJes se5uidas ser e0ibida a tela de co fi5urao de atal<osG este e0em"lo ser alterada a o"o IocaliJar Pr60imo o atal<o 4(DI=K "ara o atal<o E3. 2"rese ta lista de vis;es dis"o Hveis. O ONO re"rese ta uma das letras da cai0a ao lado. A0ecuta a ltima co fi5urao de e0ecuo utiliJada. A0ecuta a ltima co fi5urao de de"urao utiliJada. 2bre e fec<a com o "ar corres"o de teG "or e0em"lo1 O S OO %S %&

2lt=S<it=M -N 4trl=E,, E,, O ou P ou Q ou R ou % ou

Opera es e! B"ocos
Tbloco selecio adoU = (ab Tbloco selecio adoU = S<it = (ab Tbloco selecio adoU = O Tbloco selecio adoU = P Tbloco selecio adoU = Q Tbloco selecio adoU = R Tbloco selecio adoU = % Tbloco selecio adoU = ) 2dicio a uma tabulao o i icio de cada li <a do bloco selecio ado. Demove uma tabulao o i icio de cada li <a do bloco selecio ado. 4oloca o bloco selecio ado e tre as"as du"lasG resulta do em OTbloco selecio adoUO. 4oloca o bloco selecio ado e tre as"as sim"lesG resulta do em PTbloco selecio adoUP. 4oloca o bloco selecio ado e tre c<avesG resulta do em QTbloco selecio adoUV. 4oloca o bloco selecio ado e tre colc<etesG resulta do em RTbloco selecio adoUW. 4oloca o bloco selecio ado e tre "are tesesG resulta do em %Tbloco selecio adoU&. 4oloca o bloco selecio ado e tre barras verticaisG resulta do em )Tbloco selecio adoU).

Todos os direitos reservados.


TDS

- 109