Apostila TDS

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"!

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

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!

TDS
-5
Tela !: "ocal de instalao E! +guarde a instala#o e
Tela #: $nstalao 7! !! o aviso de trmino!

TDS
-6
Tela %: $nstalao conclu&da

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!

TDS
-8
Tela 7: TOTVS | Developer Studio sendo iniciali/ado

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

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!

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!

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"!

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!

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!

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!

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!

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)

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!

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

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.

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!;.

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.

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!

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"!

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!

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!

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.

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%

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).

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

TDS
- 31
Tela !%: Servidor conectado

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

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!

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

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!

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!

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!

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!

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

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

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

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

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!

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!

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!

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!

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!

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%

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

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!

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%

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)

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!

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!

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%

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!

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!

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!

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!

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!

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!

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!

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!

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!

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

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!

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!

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!

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!

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!

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!

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!

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!

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

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%

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

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%

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

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%

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

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%

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!

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%

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!
!.

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

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.

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!

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!

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

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!

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!

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!

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!

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!

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!

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!

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!

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!

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!

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!

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!

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

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)

TDS
- 104
Tela 1!%: Honitoramento do servidor )dbaaccess)

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)

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!

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

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).

TDS
- 109

Apostila TDS

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Apostila TDS

Enviado por

Direitos autorais:

Formatos disponíveis

Sumrio

Todos os direitos reservados.

Todos os direitos reservados.

Mquina Virtual ava !JVM"

Todos os direitos reservados.

#nstalao do TOTVS | Developer Studio

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

Todos os direitos reservados.

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

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

Todos os direitos reservados.

Tela %: $nstalao conclu&da

Todos os direitos reservados.

Aniciando o TOTVS F "eveloper Studio

Todos os direitos reservados.

Tela 7: TOTVS | Developer Studio sendo iniciali/ado

Todos os direitos reservados.

Tela 8: Termo de aceite do TOTVS | Development Studio

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Amportar projeto +dv,*(

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

Todos os direitos reservados.

Todos os direitos reservados.

+ovo Projeto &O&VS

Tela 29: 3ovo proDeto TOTVS iniciali/ado

Todos os direitos reservados.

Tela 21: <lemento )=roDeto)

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

Tela 2!: <lemento )>r2uivo)

Todos os direitos reservados.

Arquivo Pasta Outros

Todos os direitos reservados.

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

Todos os direitos reservados.

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

Todos os direitos reservados.

Todos os direitos reservados.

+cessando o TOTVS Server

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

Todos os direitos reservados.

Todos os direitos reservados.

Servers ;$tension% 2enu de conte$to

Todos os direitos reservados.

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

Todos os direitos reservados.

Todos os direitos reservados.

Todos os direitos reservados.

Tela !%: Servidor conectado

Todos os direitos reservados.

Tela !A: >ssistente de novo proDeto

Todos os direitos reservados.

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

Todos os direitos reservados.

Todos os direitos reservados.

Obtendo algo semel/ante a%

Todos os direitos reservados.

Todos os direitos reservados.