Você está na página 1de 36

AP5 IDE

Documentao e Guia do Usurio

CopyRight 1999 Microsiga Software S.A.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Sumrio
O AP5 IDE ................................................................................................................................... 4 Configurando o AP5 IDE ........................................................................................................... 5
Configuraes do Debugger ................................................................................................................ 5
Definindo o Padro de Teclas de Atalho ....................................................................................................... 5 Definindo o Nmero de Arquivos na Lista de Recentemente Abertos .......................................................... 6 Utilizando a Rgua com o Nmero de Linhas .............................................................................................. 6 Definindo a Localizao de Arquivos ........................................................................................................... 6 Ignorando Arquivos No Encontrados .......................................................................................................... 6

Configuraes de Cdigo ..................................................................................................................... 7


Elementos de Texto ....................................................................................................................................... 7 Definindo o Estilo do Texto .......................................................................................................................... 7 Definindo a Cor do Texto .............................................................................................................................. 7 Definindo a Cor de Fundo do Texto .............................................................................................................. 7 Desabilitando a Diferenciao de Sintaxe ..................................................................................................... 7

Configuraes de Controle de Verso ................................................................................................ 8


Utilizando o Controle de Verso ................................................................................................................... 8 Software Controlador de Verso ................................................................................................................... 8 Path Inicial do Software Controlador de Verso ........................................................................................... 8 Linha de Comando para Obteno da ltima Verso ................................................................................... 9 Linha de Comando para Reservar Arquivo ................................................................................................... 9 Linha de Comando para Cancelar Reserva .................................................................................................... 9 Linha de Comando para Confirmar Arquivo ................................................................................................. 9 Linha de Comando para Adicionar Arquivo ................................................................................................. 9 Linha de Comando para Remover Arquivo ................................................................................................... 9

Utilizando o AP5 IDE................................................................................................................ 10


A Edio de Arquivos ........................................................................................................................ 10
Criando e Editando Arquivos .......................................................................................................................10 Recursos de Edio.......................................................................................................................................11 Modificaes de Texto .........................................................................................................................11 Insero de Texto em um Arquivo .......................................................................................................12 Localizao e Substituio de Texto ....................................................................................................12 Utilizando Book Marks ........................................................................................................................14

Grupos de Projetos e a Compilao de Arquivos............................................................................ 14


Trabalhando com Grupos de Projetos...........................................................................................................14 Compilando Arquivos de Cdigo-Fonte .......................................................................................................15 Configuraes de um Grupo de Projetos ......................................................................................................16

Utilizando o Debugger do AP5 IDE.................................................................................................. 19


Os Comandos de Debug ...............................................................................................................................19 As Janelas de Inspeo do AP5 IDE.............................................................................................................21 A Janela de Break Points ......................................................................................................................21 A janela de Pilha de Chamadas ............................................................................................................22 A Janela de Watchs ..............................................................................................................................22 As Janelas de Inspeo de Variveis ....................................................................................................23 A Janela de Inspeo de Tabelas e Campos .........................................................................................24 O Inspetor de Objetos ...........................................................................................................................25

Controlando Verses de Arquivos Atravs do AP5 IDE ......................................................... 26


AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Os Softwares para Controle de Verses de Arquivos ..................................................................... 26 O Controle de Verses Atravs do AP5 IDE ................................................................................... 26
A Reserva Automtica de um Arquivo .........................................................................................................26 Executando Outras Macros de Controle de Verso ......................................................................................26

Utilizando os Assistentes do AP5 IDE ...................................................................................... 29


O Assistente de Gerao de Cdigo .................................................................................................. 29 O Assistente de Converso de Cdigo .............................................................................................. 30
Selecionando os Arquivos ............................................................................................................................30 Convertendo os Arquivos .............................................................................................................................30 Diretrio para Gravao dos Arquivos Convertidos .....................................................................................30 Criao de Projeto e Compilao Automticos ............................................................................................31

Tabela de Macros ...................................................................................................................... 32 Glossrio .................................................................................................................................... 34

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

O AP5 IDE

O AP5 IDE um ambiente de desenvolvimento integrado que acompanha o Advanced Protheus, permitindo ao usurio editar, compilar e depurar programas escritos na linguagem ADVPL. Como ferramenta de edio, possui todos os recursos das ferramentas mais populares, como cortar e colar, levar o cursor at determinada linha do cdigo, localizao e substituio de texto, etc., e recursos adicionais, como identao de cdigo, insero de comentrios de documentao, etc. Como ferramenta de debug, dispe de aes de debug como Percorrer Linha, Pular Linha, Executar, Seguir at o Retorno, Pausar Execuo, Derrubar Client, etc., permitindo ao usurio executar e depurar suas rotinas de dentro de seu ambiente integrado, inspecionando o ambiente de execuo de suas rotinas atravs de diversas janelas de informaes, como variveis (divididas entre variveis locais, variveis pblicas, variveis privadas e variveis estticas), expresses em Watch, tabelas, ndices e campos, break points, programas registrados (inspetor de objetos) e pilha de chamadas. Alm disso, os programas criados so compilados diretamente do AP5 IDE, onde so mantidos em projetos e grupos de projetos. Os grupos de projetos facilitam a compilao de um ou mais projetos de arquivos, utilizando conceitos de repositrios e diretivas de compilao, possibilitando inclusive a manuteno de bibliotecas de rotinas do usurio.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Configurando o AP5 IDE


Antes de iniciar a utilizao do AP5 IDE, deve-se configur-lo para um melhor aproveitamento de seus recursos. Na opo de preferncias, encontrada no menu Arquivo, item Preferncias, so definidas as informaes que influenciam no comportamento do AP5 IDE. Ao acionar este item do menu, a janela de Preferncias exibida, contendo informaes divididas em trs pastas. Todas as informaes das preferncias bem como as diversas informaes armazenadas pelo AP5 IDE, so mantidas no arquivo chamado AP5IDE.INI que se encontra no mesmo diretrio de execuo do IDE.
Figura 1 - A pasta Debugger da janela de Preferncias do AP5 IDE

Configuraes do Debugger
A pasta de configuraes do debugger (figura 1), exibe as opes bsicas para o processamento do AP5 IDE em modo de debug e do editor. Aqui so definidas as configuraes para a localizao dos arquivos de cdigo fonte durante o processo de debug, se o AP5 IDE deve ignorar automaticamente os arquivos no encontrados, o tamanho da tabulao, do nmero de Undo's, etc.

Definindo o Padro de Teclas de Atalho


O padro de teclas utilizado identifica quais sero as teclas para o acionamento das principais funes de debug do AP5 IDE. Os padres possveis so os mesmos utilizados pelas linguagens de programao FiveWin, Visual C++ e Delphi, tornando fcil a assimilao para usurios de algumas destas ferramentas. Para cada um dos padres utilizados, as combinaes de teclas para o acionamento das aes de debug sero: FiveWin Percorrer Linha Pular Linha Executar Adicionar Break Point Visual C++ Percorrer Linha Pular Linha Executar Adicionar Break Point Delphi Percorrer Linha Pular Linha Executar Adicionar Break Point

F8 F10 F5 F9

Seguir at o Retorno Localizar Localizar Prximo Ir para a linha "n"

F7 Ctrl+L F3 Ctrl+G

F11 F10 F5 F9

Seguir at o Retorno Localizar Localizar Prximo Ir para a linha "n"

Ctrl+F10 Ctrl+F F3 Ctrl+G

F7 F8 F9 F5

Seguir at o Retorno Localizar Localizar Prximo Ir para a linha "n"

F4 Ctrl+F F3 Ctrl+G

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Definindo a Tabulao
O campo Tabulao indica o nmero de caracteres que sero usados para cada tecla de tabulao (cdigo ASC II #9), na identao do cdigo.

Definindo o Nmero de Undo's


O campo de Nmero Mximo de Undo's indica o nmero mximo de modificaes no texto que o AP5 IDE ir armazenar para permitir o Undo e/ou Redo. As aes so armazenadas de modo que assim que atingido o limite estabelecido as ltimas aes passam a ser descartadas a cada nova ao. Os Undo's e Redo's so mantidos por arquivo, e so resetados quando o arquivo salvo. Indicando zero (0), o armazenamento mximo torna-se infinito (dependente apenas da memria disponvel).

Definindo o Nmero de Arquivos na Lista de Recentemente Abertos


O campo Arquivos na Lista de Recentemente Abertos indica o nmero mximo de arquivos que sero mantidos na lista de recentemente abertos, que se encontra no final do menu Arquivo, para possibilitar a abertura rpida dos mesmos. Indicando zero (0), no ser mantida uma lista dos arquivos recentemente abertos.

Utilizando a Rgua com o Nmero de Linhas


A opo Exibir Rgua com o Nmero de Linhas indica se o AP5 IDE deve exibir uma rgua com os nmeros das linhas em um novo gutter na margem esquerda de cada arquivo aberto, para facilitar a localizao visual do usurio.

Definindo a Localizao de Arquivos


Quando em processo de debug, especificamente durante os comandos de Percorrer Linha e Pular Linha, a execuo feita linha-a-linha do cdigo. Para isso, o AP5 IDE localiza os arquivos de cdigo fonte, abre-os e posiciona o cursor na linha em execuo. Para os arquivos no encontrados, o IDE questionar o usurio por seu caminho. Se no forem encontrados, no podero ser abertos para o posicionamento da linha e sero colocados em uma lista de arquivos ignorados (at que o IDE seja reinicializado). Para facilitar a localizao, pode-se digitar neste campo uma lista de paths onde os arquivos devem ser procurados. Os paths devem ser separados com o sinal de ponto-e-vrgula (;).

Ignorando Arquivos No Encontrados


Quando em processo de debug, especificamente durante os comandos de Percorrer Linha e Pular Linha, a execuo feita inha-a-linha do cdigo. Para isso, o AP5 IDE localiza os arquivos de cdigo fonte, abre-os e posiciona o cursor na linha em execuo. Porm se no for possvel encontrar o arquivo de cdigo fonte, o IDE questionar o usurio pelo caminho onde o arquivo pode ser encontrado. Se o usurio realmente no tiver o arquivo e cancelar a localizao do mesmo, o IDE no o questionar mais (at que o IDE seja reinicializado). Para evitar que seja questionado a cada arquivo no encontrado, pode-se marcar esta opo. Assim todos os arquivos no encontrados sero adicionados automaticamente lista de arquivos ignorados. Note que os break points eventualmente contidos em um fonte no encontrado no faro com que o processamento pare. Do mesmo modo, executando o comando Percorrer Linha sobre uma funo que esteja em um arquivo de cdigo-fonte no encontrado, far com que a funo seja normalmente executada e a parada volte a ocorrer somente na prxima linha, depois do retorno da funo.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Configuraes de Cdigo
A pasta de configuraes do cdigo (figura 2), exibe as opes para controle da diferenciao de sintaxe no editor do AP5 IDE. Aqui voc pode habilitar ou desabilitar a diferenciao de sintaxe bem como configurar as cores para cada elemento de texto que pode ser diferenciado.

Elementos de Texto

Figura 2 - A pasta Cdigo da janela de Preferncias do AP5 IDE

Os elementos de texto so tipos de expresses que devido a sua finalidade so classificados em grupos separados. Como por exemplo, palavras reservadas ao compilador, strings de caracteres, nmeros, etc. Nesta lista so apresentados os diferentes elementos de texto que permitem a diferenciao de sintaxe no AP5 IDE. O elemento deve ser selecionado nesta lista para que se possa configurar suas cores e estilo. Todas as demais configuraes nesta mesma pasta sero, ento, relacionadas com o elemento atualmente selecionado.

Definindo o Estilo do Texto


Nesta lista de opes pode-se escolher qual o estilo ser aplicado ao elemento de texto selecionado na lista de elementos.

Definindo a Cor do Texto


Nesta lista de cores pode-se escolher qual ser a cor aplicada ao elemento de texto selecionado na lista de elementos.

Definindo a Cor de Fundo do Texto


Nesta lista de cores pode-se escolher qual ser a cor de fundo aplicada ao elemento de texto selecionado na lista de elementos.

Desabilitando a Diferenciao de Sintaxe


Selecionando-se esta opo, o AP5 IDE no se utilizar da diferenciao de sintaxe no cdigo dos arquivos abertos. Apesar de que o uso diferenciao de sintaxe no consuma muitos recursos, o atualizao das janelas pode ficar mais rpida com esse recurso desabilitado. Desabilitando a diferenciao, as cores de todo o texto sero aquelas definidas no Windows da estao. Para a alterao da fonte do texto, utilize a opo Escolha de Fonte no menu Arquivo. A fonte no pode ser diferenciada para os elementos de texto do cdigo. Apenas o estilo e as cores.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Configuraes de Controle de Verso


A pasta de configuraes de Controle de Verso (figura 3), exibe as opes para a integrao de um software de controle de verso ao AP5 IDE. Nesta pasta so definidos os comandos bsicos para acionamento do software controlador de verso atravs de linha de comando. Estes comandos podem ser acionados automaticamente pelo AP5 IDE ou pela requisio do usurio atravs dos botes da barra de ferramentas de controle de verso.
Figura 3 - A pasta Controle de Verso da janela de Preferncias do AP5 IDE

Utilizando o Controle de Verso


A opo Utiliza Controle de Verso indica que ser utilizado um software de controle de verso para controlar a reserva e a alterao de arquivos de cdigo-fonte. Ao acionar esta opo uma janela com os softwares controladores de verso compatveis (figura 4) ser apresentada para que o usurio escolha aquele que esteja utilizando. A confirmao desta janela traz nos campos das linhas de comando as sintaxes utilizadas pelo software escolhido sugeridas. Caso o software utilizado no se encontre na lista de softwares compatveis, o usurio dever consultar a documentao que o acompanha e fornecer manualmente as sintaxes para as linhas de comandos.

Software Controlador de Verso


O campo Software indica o caminho para o software que receber as linhas de comando enviadas pelo AP5 IDE para as aes de controle de verso.

Path Inicial do Software Controlador de Verso


O campo Iniciar Em indica o path onde o software controlador de verso ser iniciado quando receber as linhas de comando.
Figura 4 - Seleo de um software de controle de verso compatvel. A confirmao do dilogo preenche os campos de linhas de comando de acordo com as sintaxes do software escolhido.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Linha de Comando para Obteno da ltima Verso


O campo ltima Verso indica os parmetros passados para o Software Controlador de Verso para realizar uma obteno da ltima verso do arquivo de cdigo aberto no momento. Pode-se utilizar macros para obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE.

Linha de Comando para Reservar Arquivo


O campo Reservar indica os parmetros passados para o Software Controlador de Verso para realizar a reserva do arquivo de cdigo fonte aberto no momento. Pode-se utilizar macros para a obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE. Note que apesar desta linha de comando poder ser acessada atravs da barra de ferramentas, no se deve fugir de seu objetivo (reservar o arquivo aberto no servidor de arquivos), pois quando o uso de controle de verso est habilitado no AP5 IDE, esta linha de comando executada automaticamente no momento que alguma alterao est prestes a ser efetuada em um arquivo. Caso necessite executar algo diferente, utilize-se das ferramentas no menu Ferramentas.

Linha de Comando para Cancelar Reserva


O campo Cancelar indica os parmetros passados para o Software Controlador de Verso para realizar o cancelamento da ltima reserva efetuada pelo usurio, do arquivo de cdigo aberto no momento. Pode-se utilizar macros para obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE.

Linha de Comando para Confirmar Arquivo


O campo Confirmar indica os parmetros passados para o Software Controlador de Verso para realizar a confirmao do arquivo de cdigo fonte aberto no momento. Pode-se utilizar macros para obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE.

Linha de Comando para Adicionar Arquivo


O campo Adicionar indica os parmetros passados para o Software Controlador de Verso para adicionar o arquivo de cdigo fonte aberto no momento no controle de verso. Pode-se utilizar macros para a obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE.

Linha de Comando para Remover Arquivo


O campo Remover indica os parmetros passados para o Software Controlador de Verso para remover o arquivo de cdigo fonte aberto no momento do controlador de verso. Pode-se utilizar macros para a obteno do nome do arquivo corrente, path, etc. Veja a Tabela de Macros para informaes das macros disponveis no AP5 IDE.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Utilizando o AP5 IDE

A Edio de Arquivos
O AP5 IDE suporta a edio de arquivos no formato texto, sendo que as extenses padres so PRW, PRX e PRG. Todos os arquivos gravados pelo IDE, so gravados contendo como finalizadores de linha os caracteres de cdigo ASC II 10 e 13 (LF e CR). Atravs das opes dos menus o usurio tem um controle amplo da formatao do texto, com facilidades de cpia e edio de mltiplos arquivos como uma aplicao MDI.

Criando e Editando Arquivos


O menu Arquivo (figura 5) contm todas as opes necessrias para a criao e edio de arquivos. A opo Novo criar um novo arquivo para edio abrindo-o em uma nova janela de documento na rea de trabalho do AP5 IDE. A opo Abrir ir exibir a caixa de dilogo de seleo de arquivos padro do Windows, onde o usurio poder escolher ou digitar o nome do arquivo que deseja editar. Se o usurio no digitar a extenso, a extenso padro (.PRW) ou a extenso do tipo de arquivo exibido na caixa de dilogo ser assumida na tentativa de abertura do arquivo. Aps a seleo do arquivo, o mesmo ser carregado em uma nova janela de documento na rea de trabalho do AP5 IDE. O limite para o tamanho dos arquivos, bem como para o nmero de arquivos abertos, dependente apenas da memria disponvel na mquina que executa o AP5 IDE. A gravao dos arquivos efetuada pelos itens Salvar e Salvar Como. Para um arquivo novo, a seleo da opo Salvar ir exibir a caixa de dilogo de seleo de arquivos para a escolha do nome para gravao. Aps o arquivo ter sido gravado, a seleo da opo Salvar gravar o arquivo sem questionar o usurio pelo nome. Ao contrrio, a opo Salvar Como sempre questiona o usurio por um nome de arquivo e grava-o com o nome informado. As opes Imprimir e Configurar Impressora permitem ao usurio imprimir o arquivo corrente ou uma seleo de texto atravs das impressoras definidas no Windows. Pode-se tambm enviar o arquivo aberto por e-mail utilizando a opo Enviar via e-mail.

Figura 5 - Os itens do menu Arquivo

A opo Escolha de Fonte permite ao usurio escolher qual a fonte grfica e qual o tamanho dos caracteres que utilizar para editar seus arquivos. A escolha de fonte no faz parte da diferenciao de sintaxe. Para uma perfeita exibio dos caracteres grficos utilizados para a moldura de comentrios nos arquivos de cdigo-fonte criados, existe um arquivo de fonte chamado LINEDRAW.TTF (MS LineDraw) que os exibe como so exibidos em editores para ambiente DOS. O AP5 IDE est preparado para tentar detectar a existncia desse arquivo no diretrio de seu executvel e instal-lo no ambiente do usurio assim que for iniciado. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Figura 6 - Diferenciao de Sintaxe em um arquivo aberto no AP5 IDE,


utilizando o fonte MS LineDraw.

10

Para finalizar a execuo do AP5 IDE, o usurio pode escolher a opo Sair, utilizar a combinao de teclas Alt+F4 ou clicar no cone em forma de x na barra de ttulos da janela principal. Ao finalizar, o AP5 IDE grava todas as informaes das preferncias bem como informaes do ambiente do usurio (como janelas abertas, posicionamento, etc.). Porm, se o usurio estiver com uma sesso de debug em progresso, o AP5 IDE ir question-lo para encerrar a sesso de debug antes de finalizar. Para o envio de um arquivo via e-mail o usurio deve ter instalado e configurado em sua mquina um cliente de e-mail como por exemplo o Microsoft Outlook. O arquivo fsico, ou seja, a cpia gravada no disco ser enviado como um "attachment" via e-mail. Portanto qualquer alterao efetuada no buffer de edio que no tenha sido gravada no constar do "attachment" no e-mail. Muito importante: Se o usurio finalizar o AP5 IDE sem que uma sesso de debug tenha sido encerrada, o AP5 IDE ir tentar encerrar esta sesso antes de finalizar enviando ao Server o comando Derrubar Client (que ser detalhado mais a frente no tpico sobre Utilizao do Debug do AP5 IDE). Porm, a finalizao do AP5 Remote nem sempre imediata visto que o controle do envio das mensagens pode no estar com o AP5 IDE no momento da finalizao. Isto pode acarretar na finalizao do AP5 IDE sem que o AP5 Remote seja finalizado, ou seja, o processo de execuo do AP5 Remote ficar preso na memria da estao.

Recursos de Edio
O menu Editar (figura 7) contm todas as opes necessrias para a edio e formatao dos textos nos arquivos abertos. Contem os recursos de Copiar, Recortar e Colar blocos de texto utilizando-se da rea de transferncia, permitindo tambm que textos copiados de outros arquivos de cdigo-fonte sejam copiados para arquivos abertos. Possui tambm os recursos de Desfazer e Refazer aes, ou seja, as modificaes efetuadas no texto podem ser desfeitas at o limite inicial da abertura ou da ltima gravao do arquivo e refeitas at o limite do nmero de aes armazenadas. O nmero de aes que o AP5 IDE pode armazenar configurvel, como j foi detalhado no tpico Configurando o AP5 IDE. Modificaes de Texto
Figura 7 - Os itens do menu Editar

No item Texto, existem opes para transformar o texto selecionado para caracteres maisculos ou minsculos e at mesmo uma opo para identar o arquivo. A identao modifica as tabulaes do cdigo de maneira a tornar mais fcil a visualizao do incio e do encerramento das estruturas de controle de fluxo (como IF-ENDIF, WHILE-ENDDO, etc.). Porm a identao no faz o papel do compilador, avaliando as expresses. Por esse motivo, o AP5 IDE no capaz de identar arquivos que contenham a linha de cdigo do comando IF dessa maneira: If(<Expresso>) <Comando> Endif Isso se deve ao fato de que o comando IF seguido de um parnteses confundido com a funo IF: IF(<Expresso>,<Comando1>,<Comando2>) que no um indicador de incio de bloco de controle de fluxo, ou seja, no termina com um ENDIF. Isto facilmente corrigido incluindo-se um caracter de espao entre o comando e o sinal de parnteses: If (<Expresso>) <Comando> Endif AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 11

Se o AP5 IDE encontrar uma linha como a descrita anteriormente simplesmente exibir uma mensagem de erro na identao, exibindo a linha onde tal erro foi encontrado, e cancelar o processo de identao. O usurio tambm pode cancelar o processo de identao clicando no boto Cancela que aparece na barra de status do AP5 IDE. Em qualquer um dos casos, quando a identao cancelada, o cdigo no alterado. Insero de Texto em um Arquivo Existem tambm opes para inserir caracteres ASC II e os comentrios padronizados para documentao no cdigo, utilizando a fonte configurada. Tambm no menu Editar se encontram as opes de navegao no cdigo. So as opes para posicionamento do cursor em determinado nmero de linha e posicionamento do cursor na linha em execuo (somente quando o AP5 IDE estiver com uma sesso de debug aberta) no arquivo selecionado. A opo Localizar exibe a janela de localizao de texto. Localizao e Substituio de Texto possvel localizar textos no arquivo corrente ou realizar uma pesquisa em mais de um arquivo, estando ele aberto ou no no AP5 IDE. A pasta Localizar (figura 8) pesquisa por expresses no arquivo corrente. Pode-se pesquisar acima ou abaixo da posio do cursor. Ainda pode-se indicar se a pesquisa deve considerar a coincidncia dos caracteres, ou seja, encontrar exatamente a expresso fornecida, ou ignorar as diferenas entre caracteres maisculos ou minsculos. Para isso o usurio deve marcar a caixa Coincidir Maisc./Minsc. Pode-se tambm indicar se a expresso deve ser localizada em qualquer lugar do texto ou somente se for uma palavra inteira. Uma palavra inteira o texto considerado entre dois delimitadores.

Figura 8 - Pasta Localizar da janela de localizao do AP5 IDE.

Assim que o texto localizado, o AP5 IDE move o cursor at sua localizao e marca o texto encontrado, fechando a janela de localizao de texto. Pode-se utilizar a opo Repetir Procura para continuar localizando a expresso com as mesmas configuraes sem precisar abrir a janela de localizao novamente. A pasta Localizar em Arquivos (figura 9) permite uma pesquisa mais ampla com todas as opes da localizao detalhada anteriormente. Pode-se localizar expresses em arquivos de um diretrio, pode-se localizar expresses em todos os arquivos abertos e pode-se localizar expresses em todos os arquivos do grupo de projetos aberto (a utilizao de grupos de projetos ser detalhada no tpico Criao de Grupos de Projetos e Compilao de Arquivos). Porm os resultados da pesquisa sero exibidos na Janela de Resultados da Localizao em Arquivos (figura 10).
Figura 9 - Pasta Localizar em Arquivos da janela de localizao do AP5 IDE.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

12

Nesta pasta as opes de direo so substitudas pelas opes de localizao, ou seja, onde a pesquisa deve ser efetuada. Se o usurio optar por pesquisar em um diretrio, o quadro de opes Diretrio de Pesquisa ser habilitado, permitindo ao usurio digitar no campo Mscara de Pesquisa o diretrio e a mscara de arquivos que deseja pesquisar (por exemplo, C:\FONTES\*.PRX). A mscara padro de pesquisa *.PR?. Se o usurio desejar utilizar uma mscara diferente (por exemplo, pesquisar em arquivos texto com extenso TXT), dever selecionar a caixa Usa Caracteres Curinga que nesta pasta est habilitada. Se o path informado juntamente com a mscara no for informado, ser considerado o path atual. Se o path for invlido, no haver erros emitidos ao usurio. Apenas nenhuma ocorrncia da expresso ser encontrada. Se o usurio desejar pesquisar a mesma mscara nos subdiretrios, dever marcar a opo Pesquisar Subdiretrios. A seleo da opo Repetir Procura no vale para a localizao em arquivos. Se for requisita a pesquisa ser feita como uma localizao comum no arquivo aberto. Durante a localizao em arquivos, uma janela de localizao exibida. Pressionando-se a tecla <ESC> ou fechando-se esta janela a pesquisa interrompida. Aps a finalizao da localizao em arquivos, basta efetuar um duplo clique em qualquer uma das ocorrncias encontradas para que o arquivo seja editado e o cursor posicionado na linha da ocorrncia. Diferentemente da localizao simples, esta no traz o texto selecionado no editor do AP5 IDE. A opo Substituir (figura 11) funciona exatamente como a localizao simples, porm substituindo as expresses encontradas por uma expresso definida pelo usurio. Tem as mesmas opes de pesquisa e um campo para a digitao da expresso a ser substituda. Pressionando o boto OK o AP5 IDE ir substituir apenas a primeira ocorrncia da expresso encontrada.
Figura 10 - Janela com os resultados da localizao. Um duplo clique abre o arquivo para edio posicionando na linha onde a expresso f oi

encontrada. Para substituir todas as ocorrncias o usurio deve pressionar o boto Tudo. O AP5 IDE no perguntar ao usurio se deve substituir as expresses a menos que a caixa Perguntar Antes de Substituir seja selecionada. Nesse caso, para cada uma das expresses encontradas, ser exibido um dilogo perguntando ao usurio se deseja substituir a expresso com os botes Sim, No, Cancela e Tudo. O boto Sim, substitui a ocorrncia e continua a pesquisa, o boto No no substitui a ocorrncia e continua a pesquisa, o boto Cancela finaliza a pesquisa mantendo as substituies at ento efetuadas e o boto Tudo termina de substituir todas as ocorrncias sem questionar o usurio.

Figura 11 - Janela de substituio, com as mesmas opes de pesquisa da localizao simples.

A rotina de substituio, como a rotina de localizao de expresses, tambm marca as ocorrncias encontradas. Porm, para facilitar a visualizao, o AP5 IDE tenta posicionar a caixa de dilogo que questiona o usurio sobre a substituio das ocorrncias de modo a permitir a visualizao do texto marcado de um modo que a caixa de dilogo esteja totalmente visvel. Caso no seja possvel posicion-la de modo que fique totalmente visvel e que seja possvel visualizar o texto, a caixa de dilogo ser centralizada. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 13

Utilizando Book Marks Este recurso de edio bastante til que no se encontra disponvel atravs dos menus ou botes das barras de ferramentas. Um book mark um ponto marcado em uma linha que permite a rpida localizao e posicionamento do cursor, permitindo ao usurio marcar pontos importantes no cdigo para poder voltar o posicionamento do cursor no local marcado atravs de uma combinao de teclas. Para adicionar ou remover um book mark em uma linha de cdigo, o usurio deve posicionar o cursor sobre a linha desejada e utilizar a combinao de teclas CTRL+SHIFT+<n>, onde n um nmero de 0 a 9. Pode-se manter apenas 10 book marks por arquivo. Para localizar um book mark, o usurio deve utilizar a combinao de teclas CTRL+<n>. Os book marks existentes so indicados na borda esquerda dos arquivos atravs de imagens contendo o nmero do book mark (figura 12). Figura 12 - Linhas marcadas com Book Marks A localizao simples e a substituio somente esto disponveis quando ao menos um arquivo se encontra aberto no AP5 IDE. Caso contrrio, somente a localizao em arquivos se encontrar disponvel. Tanto na janela de localizao como na janela de substituio, os campos da expresso a localizar e da expresso a substituir so listas "drop-down", ou seja, acumulam as ltimas 50 expresses digitadas. Essas informaes tambm so gravadas no arquivo AP5IDE.INI que mantido no diretrio de instalao do Windows da estao.

Grupos de Projetos e a Compilao de Arquivos


Como um ambiente integrado, o AP5 IDE o portal de entrada para as rotinas especficas. Alm de permitir a criao e edio dos arquivos de cdigo-fonte, atravs do AP5 IDE que tais arquivos so enviados e compilados no AP5 Server. Para isso, foi criado o conceito de Grupo de Projetos.

Figura 13 - O menu Projetos

Trabalhando com Grupos de Projetos


O menu Projetos (figura 13) exibe as opes para se trabalhar com grupos de projetos, compilao de arquivos, etc. Um grupo de projetos uma coleo de projetos e pastas que mantm listas de arquivos de cdigo (extenses *.PR?) e de definies (extenso *.CH) e tambm as configuraes de compilao. Os grupos de projetos so editados atravs da janela do Gerenciador de Projetos (figura 14). Utilizando as opes do menu Projetos pode-se criar novos grupos, edit-los e grav-los. A extenso padro para a gravao dos grupos de projetos .PRJ.
Figura 14 - A janela do Gerenciador de Projetos, com diversos arquivos de cdigo e de definies estruturados em diferentes projetos e pastas

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

14

O nico meio de compilar um arquivo de cdigo-fonte atravs do AP5 IDE utilizando um grupo de projetos. Os arquivos devem ser adicionados a pastas criadas para cada projeto. A diviso dos arquivos em projetos e pastas organiza o trabalho, pois os arquivos podem ser divididos de acordo com a utilizao, com um ttulo explanatrio em seu projeto ou pasta. A edio dos projetos, ou seja, a criao de novas pastas, novos projetos, renomeao, adicionamento de arquivos, edio das configuraes, etc., efetuada atravs do clique do boto direito do mouse sobre qualquer rea da janela do gerenciador de projetos. Pode-se tambm editar os arquivos atravs do duplo clique do mouse ou do pressionamento da tecla <ENTER> sobre um arquivo na lista. No menu acionado pelo boto direito do mouse ainda existem duas opes para importao e exportao do Grupo de Projetos de/para um arquivo texto. Isto permite ao usurio manter cpias de segurana de grupos de projetos longos, de modo que se ocorrer algum problema no arquivo binrio onde os projetos so mantidos, as informaes possam ser facilmente restauradas do arquivo texto formatado.

Adicionar um arquivo em uma pasta significa adicionar o nome do arquivo em uma lista, e no adicionar o arquivo propriamente dito ao projeto. Para qualquer tratamento com o arquivo, o AP5 IDE ir localiz-lo no path gravado. Assim os arquivos podem ser mantidos em outros diretrios que no o da execuo do sistema. O Gerenciador de Projetos utiliza os seguintes cones de imagens para indicar situaes nos arquivos mantidos na lista: Quando o arquivo for compilado com sucesso, o AP5 IDE indicar atravs deste cone. Quando o grupo de projetos gravado, um flag de compilado gravado para o arquivo. Isto necessrio para evitar a recompilao do arquivo at que o mesmo seja alterado ou que o usurio acione o comando "Compilar Tudo". Quando houver alteraes no arquivo, o AP5 IDE indicar atravs deste cone. A identificao de alterao efetuada atravs da data e hora do arquivo que mantida no arquivo de grupo de projetos desde sua ltima gravao. Desse modo, o AP5 IDE somente identificar que o arquivo teve modificaes quando o mesmo for gravado. Ou seja, alteraes efetuadas no buffer de edio do arquivo que no forem gravadas, no sero consideradas na gravao. O AP5 IDE sempre compilar o arquivo encontrado no path indicado no Gerenciador de Projetos. Quando o arquivo indicado como modificado, o flag de compilado (se existir) ser removido para indicar que o arquivo deve ser recompilado. Se o arquivo no for encontrado no path indicado no Gerenciador de Projetos, o AP5 IDE indicar atravs deste cone. Isto pode acontecer, por exemplo, se o arquivo for deletado do diretrio sem ser removido do projeto em que se encontra. A reavaliao do status dos arquivos (que poder exibir os cones acima) efetuada sempre que possvel nas principais operaes referentes ao Gerenciador de Projetos. Por exemplo, quando um arquivo adicionado ou removido, quando o nome de um projeto ou pasta modificado, quando uma pasta ou um projeto criado ou removido, quando um projeto compilado, quando um arquivo contido no Gerenciador de Projetos gravado, etc. Desse modo, por exemplo a deleo de um arquivo no exibir o cone de no encontrado imediatamente, e sim aps a realizao da reavaliao do status.

Compilando Arquivos de Cdigo-Fonte


Para a compilao, o AP5 IDE no poder estar em modo de debug. Existem trs opes de compilao: a compilao de tudo, que ignora o flag de compilado nos arquivos, simplesmente enviando novamente todos os arquivos ao server para serem compilados; a compilao do projeto selecionado, que envia apenas os arquivos do projeto selecionado na janela do Gerenciador de Projetos que no contenham o flag de compilado ao server; a compilao em Batch, na qual o usurio pode selecionar quais os projetos que desejar compilar com quais configuraes de compilao. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 15

Todas as mensagens de compilao geradas, como tambm algumas outras mensagens genricas geradas pelo AP5 IDE, so enviadas para a rea de mensagens (figura 15) que se encontra na base da janela principal do AP5 IDE.

Figura 15 - A rea de mensagens do AP5 IDE com uma mensagem de erro de compilao

O processo de compilao consiste em selecionar a configurao desejada no combo de configuraes existente na barra de ferramentas do AP5 IDE, conectar-se ao server, enviar os arquivos de definies, enviar os arquivos para a compilao e encerrar a conexo com o server. Se algum erro ocorrer a compilao ser interrompida. O usurio tambm pode interromper a compilao clicando no boto Cancelar que aparece na barra de status juntamente com uma barra de percentual concludo.

Configuraes de um Grupo de Projetos


As configuraes so utilizadas para definir qual o Environment ser utilizado na compilao dos projetos e na execuo do AP5 Remote. Se no existir ao menos uma configurao, no ser possvel a compilao. A Janela de Configuraes (figura 16), que pode ser acessada atravs do boto direito do mouse sobre o Gerenciador de Projetos ou no menu Projetos, utilizada para a manuteno das configuraes do grupo de projetos..

Figura 16 - A janela de seleo e manuteno de Configuraes de Compilao Os botes Adicionar, Remover e Editar permitem ao usurio criar novas configuraes, alterar informaes ou remover configuraes existentes. No h limite para a criao de configuraes. Quando for efetuada a compilao, o AP5 IDE ir exibir na rea de mensagens a configurao que estar utilizando. A configurao selecionada ser utilizada para a compilao de todo o grupo de projetos. A configurao default a selecionada no combo existente na barra de ferramentas do AP5 IDE. a configurao que ser utilizada para a compilao (exceto a compilao em batch) e para a execuo do AP5 Remote.

Figura 17 - Edio de uma configurao, onde pode-se identificar o repositrio utilizado e eventuais definies utilizadas no cdigo. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 16

Todos os arquivos compilados so registrados em um repositrio de programas no AP5. atravs das configuraes do Grupo de Projetos que o AP5 Server identifica qual ser o repositrio de compilao e registro dos arquivos de programas (veja figura 17). Criando configuraes diferentes, o usurio do AP5 pode compilar em diferentes Environments, ou seja, compilar para diferentes idiomas, bases de dados, etc. Os environments so sees criadas nos arquivos de configurao do AP5 Server (veja documentao do AP5 Server para maiores detalhes) que lhe permitiro no s identificar o repositrio correto para armazenar os programas compilados, como para enviar as definies corretas na compilao (como por exemplo, a definio em linha de comando /dTOP que enviada quando um programa compilado para TopConnect). Ou seja, para criar diferentes configuraes o administrador deve ter criado as sees de configurao corretamente no arquivo de configurao do AP5 Server, identificando, por exemplo, o idioma, a verso e a interface. Depois de criadas, estas sees podem ser utilizadas para a compilao e execuo do AP5 Remote atravs do AP5 IDE simplesmente identificando o nome da seo no campo Environment da configurao. Tambm atravs das configuraes onde o usurio pode incluir definies prprias que identificaro blocos de compilao condicional dentro do cdigo dos fontes (uso de diretivas #IFDEF ou #IFNDEF). Tais definies devem ser adicionadas no campo Parmetros exatamente como seriam enviadas na linha de comando. Estas definies sero adicionadas aquelas j definidas pelo AP5 Server de acordo com o Environment utilizado. O usurio tambm pode utilizar a Compilao em Batch (figura 18), escolhendo os projetos e as configuraes que deseja compilar. Nesta janela, os projetos e as configuraes existentes so cruzados, de modo que um mesmo projeto pode ser compilado utilizando mais de uma configurao. Assim, pode-se manter verses dos programas em Top Connect e em DBF ou em Ingls e Portugus, j que de acordo com o Environment informado nas configuraes, o AP5 Server ir manter os APO's em repositrios diferentes. Na janela de Compilao em Batch, o usurio pode marcar os projetos e configuraes desejados e clicar no boto Compilar para compil-los. A diferena entre este boto e o boto Recompilar, que a recompilao ignora o flag de j compilado nos arquivos contidos nos projetos selecionados, fazendo com que todos sejam compilados.

Figura 18 - A janela de Compilao em Batch

Para a compilao, nenhum usurio poder estar trabalhando no repositrio configurado. O AP5 tentar abrir o repositrio para uso exclusivo e uma mensagem de erro ser retornada caso algum usurio esteja trabalhando com o repositrio. A compilao efetuada no AP5 Server, e este retornar o resultado da compilao ao AP5 IDE. Para a compilao, so necessrios os seguintes arquivos (que so mantidos em um diretrio na mquina onde o AP5 Server est instalado. O diretrio deve ser indicado na chave INCLUDEPATH do environment definido no INI do AP5 Server): SET.CH, PROTDEF.CH, PROTHEUS.CH, RWMAKE.CH, PRCONST.CH, SIGAWIN.CH, STD.CH, STDWIN.CH e PRTOPDEF.CH, TOPDEF.CH, TOPCONN.CH (se o programa for para o ambiente SQL). A linguagem ADVPL foi criada seguindo o padro xBase para Windows utilizando os recursos criados pela Microsiga desde verses anteriores do Siga Advanced. Desse modo, o AP5 IDE procura compatibilizar ao mximo todos os Rdmakes que os usurios de verses anteriores tenham criado. Para isso existe o Assistente de Converso de Cdigo que ser detalhado mais a frente. Uma dessas mudanas importantes que todos os programas de usurios devem comear com USER FUNCTION <nome do arquivo> (caso contrrio um erro de compilao ocorrer). Isso se deve porque o produto AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 17

Siga Advanced na verso 5.07 todo criado utilizando-se a linguagem ADVPL. Como os usurios tambm podero utilizar-se desta linguagem para criar suas rotinas especficas, se todos se utilizassem da clusula FUNCTION poderia ocorrer de alguma nova verso do Siga Advanced conter funes que por coincidncia tivessem o mesmo nome de alguma funo criada por um usurio. Isto ocasionaria a substituio das funes do usurio pelas funes criadas pela Microsiga em uma eventual atualizao de verso. Desse modo, proibido ao usurio utilizar-se de funes comuns (sem a clusula USER). Para o uso interno, a Microsiga dispe de uma chave de autorizao que fornecida atravs do menu Autorizao, permitindo assim que funes comuns sejam utilizadas. Diferentemente do RDMAKE, a linguagem ADVPL no interpretada. executada do mesmo modo tanto para as rotinas criadas pela Microsiga como para as rotinas criadas pelo usurio. Assim no h mais diferenas de velocidade de execuo entre os cdigos e todos os recursos da linguagem esto disponveis para os usurios. Os arquivos compilados so gerados com a extenso APO (Advanced Protheus Object) e mantidos em um repositrio. Estes so arquivos binrios que sero executados pelo Server. O AP5 Server iniciar a execuo a partir de um arquivo inicial. Desse modo, no existe mais o conceito de mdulo, a execuo ser efetuada a partir deste programa inicial (por exemplo SIGACON, o Siga Advanced Contbil), abrindo os arquivos e carregando as funes de acordo com o menu do usurio. Muito importante: Nesta verso, os arquivos de definies (extenso CH) que forem adicionados no Gerenciador de Projetos ainda no esto sendo enviados ao servidor e devem ser colocados em um diretrio no servidor que esteja indicado na chave INCLUDEPATH do Environment definido no INI do AP5 Server.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

18

Utilizando o Debugger do AP5 IDE


Alm de um editor de cdigo, o AP5 IDE uma ferramenta de Debug. Ou seja, permite ao usurio executar passoa-passo suas rotinas para encontrar e remover erros de lgica. Como em outras ferramentas de Debug, no AP5 IDE o usurio encontra janelas de Watch, janelas de informaes com o contedo de variveis, pilha de chamadas, break points existentes, etc. E com todos esses recursos, fica muito mais fcil ao usurio depurar seus cdigos, inclusive em pontos de entrada do sistema Siga Advanced 5.07. A execuo do AP5 Remote a mesma, exceto pelo fato de que efetuada atravs do AP5 IDE. Quando o AP5 Remote executado, uma conexo aberta atravs do IDE, sendo encerrada somente quando a execuo do AP5 Remote terminada (atravs do prprio AP5 Remote, ou forada dentro do IDE).

Os Comandos de Debug
O menu Executar (figura 19), contem todos os comandos utilizados para debugar rotinas no AP5 IDE. Este comando executa o AP5 Remote, inicialmente pelo programa inicial ou quando em processo de debug, a partir do ponto atual. A execuo normal como se a rotina estivesse sendo executada diretamente (sem o Siga Advanced Protheus IDE). O processamento poder parar quando um break point for encontrado ou quando o usurio interromp-lo. O programa inicial deve ser informado no combo de seleo existente na barra de ferramentas do AP5 IDE, como exibido na figura 20. Se por acaso o programa inicial no for informado, o AP5 Remote questionar o usurio pelo nome do programa inicial quando for executado. Geralmente o processo de debug consiste em adicionar um break point a rotina desejada, executar o AP5 Remote atravs do AP5 IDE e executar o sistema at o momento em que o break point seja encontrado. Ento, o usurio utiliza-se dos comandos de execuo passo-a-passo para acompanhar a execuo da rotina criada. Pode-se tambm executar o AP5 Remote e acionar o comando Pausa quando a execuo chegar na rotina desejada. A execuo do comando Pausa tambm pode ser efetuada atravs da combinao de teclas ALT+D efetuada no AP5 Remote em execuo. Figura 19 - O menu Executar, com as opes para debug de rotinas. Para a execuo passo-a-passo, o AP5 localiza os arquivos de cdigo fonte e posiciona o cursor na linha em execuo de modo que o usurio possa acompanhar a execuo de suas rotinas. Para isso deve-se utilizar os comandos Percorre Linha, Pula Linha, Executar at o cursor ou os comandos de animao. O comando Percorre Linha executa linha por linha do cdigo, entrando nas chamadas de funes. Ou seja, a execuo deste comando sobre uma linha que contenha uma chamada de funo far com que o processo de debug linha-a-linha continue no cdigo da funo e o usurio ter que percorrer todo o cdigo da mesma para retornar ao ponto original. Ao contrrio, a execuo do comando Pula Linha em uma linha que contenha uma chamada de funo, far com que o cdigo da funo seja executado normalmente (sem que o cdigo da funo seja executado linhaa-linha) e o processo de debug continuar da Figura 20 - Combo para escolha do programa inicial. Podelinha seguinte. se escolher um dos mdulos do Siga Advanced ou digitar o nome do programa inicial desejado.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

19

Para que o processo de debug seja efetuado, o AP5 IDE precisar localizar os arquivos onde as linhas executadas se encontram, abri-los para o usurio e posicionar o cursor nas linhas corretas. Por isso, o usurio deve configurar corretamente os diretrios de localizao de arquivos (como visto em Configurando o AP5 IDE). Se um arquivo no for localizado, o AP5 IDE questionar o usurio por sua localizao a menos que tenha sido configurado para que os arquivos no encontrados sejam ignorados. Os arquivos no encontrados tero seu cdigo executado normalmente at que uma linha vlida seja encontrada ou que a rotina termine. O comando Pausa, faz com que o processamento que esteja executando normalmente (aps o comando Executar) entre em modo de debug, permitindo a continuao em passo-a-passo. O comando Pra Execuo, finaliza a execuo do AP5 Remote, encerrando-o. O AP5 Remote literalmente derrubado e a conexo com o Server encerrada. Pode ser utilizado, por exemplo, quando determinada rotina est em loop de execuo. A animao uma ferramenta que permite ao usurio executar linha-a-linha do cdigo de uma forma automatizada, sem necessitar acionar o comando Percorre Linha para todas as linhas do cdigo. Ao acionar o comando Animao, o AP5 IDE iniciar a execuo automtica do comando Percorre Linha a uma velocidade inicial. Todas as informaes so atualizadas e o usurio pode acompanhar o processamento, aumentar ou diminuir a velocidade ou parar a animao. O usurio tambm pode adicionar break points (pontos de parada) ao cdigo. Os pontos de parada indicam linhas do cdigo que faro com que o AP5 IDE entre em modo de debug exatamente como se o comando Percorrer Linha tivesse sido acionado, assim que a execuo do cdigo no AP5 Remote atingir a linha marcada. O acionamento do comando Liga/Desliga Ponto de Parada, marca ou desmarca a linha onde o cursor est posicionado no arquivo corrente. Por comodidade, os pontos de parada so gravados pelo AP5 IDE quando este encerrado, de modo que no necessrio remarc-los na prxima execuo. Pode-se definir condies para a parada em um break point, porm a definio destas condies e outros detalhes sero explicados mais a frente na seo que trata sobre a janela de exibio dos break points existentes. Por fim, o comando Atualiza, fora uma atualizao de todas as janelas de informaes do AP5 IDE. Todas as expresses ou variveis so reavaliadas no AP5 Server. A execuo dos comandos de debug efetuada atravs da troca de mensagens entre o AP5 IDE e o AP5 Server. Portanto, quando o AP5 Remote estiver sendo executado (e conseqentemente o controle da execuo est com o Server, no com o IDE), a execuo de um comando, por exemplo o comando Para Execuo, pode no ser efetuada instantaneamente, aguardando que alguma linha do cdigo do AP5 Remote seja processada. Ou seja, se o AP5 Remote estiver parado (por exemplo, aguardando uma interveno do usurio para digitar um texto qualquer ou pressionar um boto) o comando no ser executado at que algum processamento seja efetuado (por exemplo, quando o usurio clicar no boto ou a validao de uma caixa de edio for acionada). Enquanto o AP5 IDE est em processo de debug, o usurio pode obter o valor de variveis simplesmente passando o ponteiro do mouse sobre o nome da varivel desejada. Se o contedo da varivel for diferente de nulo ou espaos em branco ele ser exibido em um hint abaixo da linha onde a palavra se encontra. Para avaliar expresses, o usurio pode selecionar o texto de toda a expresso e mover o ponteiro do mouse sobre a expresso selecionada. Pode-se tambm saber em que arquivo uma funo se encontra utilizando o mesmo recurso, contanto que o mapa de objetos (que ser detalhado mais a frente) j tenha sido obtido. Este recurso deve ser utilizado com cautela, pois se um comando for selecionado e o ponteiro do mouse passado sobre a seleo, tal comando ser executado e pode influenciar no processo de debug. Durante o processo de debug, o AP5 IDE indicar atravs de imagens na borda esquerda dos arquivos algumas informaes. So utilizados os seguintes smbolos: Indica um break point na linha onde a imagem se encontra; Indica o ponto de execuo, ou seja, a linha do arquivo corrente a linha em execuo no processo de debug. Este mesmo smbolo na cor cinza indica pontos por onde a execuo passou em outros arquivos, quando o processo de debug entra nas chamadas de funes. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 20

As Janelas de Inspeo do AP5 IDE


O AP5 IDE contm diversas janelas para inspeo do ambiente de execuo durante o processo de debug. Assim, o usurio pode acompanhar o valor de variveis, verificar os break points existentes, a pilha de chamada das funes, etc. Estas janelas podem ser acessadas atravs do menu Visualizar (figura21).

Figura 21 - O menu Visualizar com os comandos para exibio das janelas de inspeo. A Janela de Break Points A janela de Break Points (figura 22) exibe todos os break points adicionados ao cdigo. Nesta janela so exibidos o nome do arquivo, a linha onde o break point se encontra e a condio de execuo. So trs os tipos de break points existentes. O break point comum contm apenas o nome do arquivo e a linha onde deve parar o processamento e pode ser adicionado atravs do comando Liga/Desliga Ponto de Parada do AP5 IDE, Figura 22 - A janela de Break Points com o menu acionado pelo ou atravs do menu acionado pelo boto pressionamento do boto direito do mouse. direito do mouse sobre a janela de Break Points. Este tipo de break point pode tambm ter uma condio de parada. Isto significa que o processamento somente ir parar neste ponto se a condio informada for satisfeita. Para informar uma condio, o usurio deve primeiro adicionar um break point e depois edit-lo atravs do menu acionado pelo boto direito do mouse. Existe tambm um break point chamado de break point condicional. Ele no contm nome de arquivo ou linha, pois a parada efetuada na primeira linha de cdigo onde a condio informada seja satisfeita. Este tipo de break point somente pode ser adicionado atravs do menu acionado pelo boto direito do mouse na opo Adicionar (figura 23). Note que os break points adicionados a uma linha de cdigo, pararo somente quando a linha for encontrada, sendo que o processamento poder seguir normalmente nas linhas seguintes. Ao contrrio, um break point condicional far com que o processamento pre (ou seja, entre em modo de debug) enquanto a condio for satisfeita. Portanto poder ser necessrio remover um break point condicional depois que a condio for atingida pela primeira vez, para poder continuar com o processamento normalmente. Figura 23 - Adicionando um break point condicional

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

21

A janela de Pilha de Chamadas A janela de Pilha de Chamadas (figura 24) contm informaes sobre a seqncia de chamadas das funes executadas pela rotina em processo de debug no AP5 IDE. Em ordem descendente de acordo com as chamadas executadas, a lista contm o nmero da linha, o nome da funo, os parmetros recebidos e o nome do programa onde a funo se encontra registrada no Server. Algumas chamadas, como de Code Blocks ou chamadas internas do Server, no exibem o nome do programa. Se um duplo clique for efetuado sobre um item da lista, o AP5 IDE ir localizar o arquivo e posicionar o cursor na linha da chamada, recalculando as demais janelas de inspeo de acordo com a funo, como ser visto mais a frente no tpico sobre as janelas de inspeo de variveis. A localizao dos arquivos depende tambm das preferncias configuradas pelo usurio, como visto no captulo Configurando o AP5 IDE. As informaes da janela de Pilha de Chamadas somente esto disponveis durante o processo de debug do AP5 IDE. Figura 24 - A janela de Pilha de Chamadas (Call Stack) A Janela de Watchs A janela de Watchs (figura 25) um local onde o usurio pode adicionar expresses para serem avaliadas durante o processo de debug. Pode-se adicionar, remover ou editar as expresses atravs do menu acionado pelo boto direito do mouse sobre a janela de Watchs. Como todas as expresses so avaliadas no Server no momento em que so adicionadas e durante o processo de debug, quando no se estiver em processo de debug s ser possvel a excluso de expresses. Por comodidade, as expresses adicionadas so gravadas quando o AP5 IDE encerrado. Figura 25 - A janela de Watchs com duas expresses adicionadas. So trs as colunas de informaes exibidas na janela de Watchs. A coluna Expresso contm a expresso adicionada e as colunas Tipo e Resultado contm respectivamente o tipo de dado e o resultado referentes avaliao da expresso efetuada no Server. As expresses de tipo Objeto e Array podem ter seu contedo exibido atravs da expanso, efetuada pelo duplo clique sobre a expresso ou o clique no sinal de expanso (+) no canto esquerdo da mesma (figura 26). Durante o processo de debug, o usurio tambm pode selecionar o texto no arquivo de cdigo e, atravs do boto direito do mouse, arrast-lo para a janela de Watchs, adicionando automaticamente o texto para avaliao. Figura 26 - A janela de Watchs com uma expresso (resultante em objeto) expandida. Semelhante utilizao da janela de Watch, o usurio conta tambm com a rea de comandos do AP5 IDE (figura 27). Na rea de comandos o usurio pode digitar expresses (como por exemplo, nome de variveis, comandos, etc.) que ao se pressionar a tecla <ENTER> sero avaliadas no Server e o resultado ser apresentado na linha AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 22

seguinte. Pode-se tambm arrastar uma expresso de um arquivo aberto para a rea de comandos do mesmo modo que na janela de Watchs.

Figura 27 - rea de Comandos na parte inferior da janela do AP5 IDE As expresses informadas tanto na janela de Watchs como na rea de comandos do AP5 IDE so avaliadas no Server. Portanto, o uso de comandos permitido e pode influenciar na execuo dos programas (por exemplo, a digitao do comando SKIP mover o ponteiro na tabela ativa). Porm, uma expresso digitada na rea de comandos somente avaliada uma vez (quando o usurio pressiona a tecla <ENTER>) ao contrrio do que ocorre na janela de Watchs, onde a expresso avaliada a cada passo do processo de debug (quando as informaes so atualizadas). Portanto deve-se evitar utilizar comandos como parte de uma expresso de Watch. Importante: Cuidado na avaliao de expresses lgicas. O operador de igualdade simples (=) tambm um operador de atribuio. Portanto, executar lLeft = .T. atribuir o valor verdadeiro (.T.) varivel lLeft. Ao invs disso, o usurio que desejar avaliar uma expresso lgica, dever utilizar o operador de exatido (==) ou utilizar parnteses para envolver toda a expresso. Por exemplo, (lLeft = .T.). As Janelas de Inspeo de Variveis Para inspecionar o valor de variveis, o AP5 IDE dispe de janelas diferentes para cada um dos quatro tipos de variveis: Locais, Privadas, Pblicas e Estticas. As janelas de Inspeo de Variveis (figura 28) tm as seguintes colunas de informao: Varivel, Tipo e Contedo. Como a janela de Watchs, as variveis dos tipos Objeto e Array podem ser expandidas exibindo seu contedo. No se pode adicionar ou remover variveis atravs das janelas de Inspeo, porm pode-se editar o contedo das variveis ou dos elementos de um Array ou Objeto, atravs do menu de opes acionado com o boto direito do mouse quando o cursor estiver sobre a varivel desejada. As janelas de Inspeo de Variveis somente tero contedo exibido enquanto o AP5 IDE estiver em processo de Debug.

Figura 28 - Janela de variveis privadas - uma das janelas de Inspeo de Variveis.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

23

A Janela de Inspeo de Tabelas e Campos Como as janelas de Inspeo de Variveis, o AP5 IDE mantm uma janela de Inspeo de Tabelas de Dados (figura 29). Nesta janela so exibidos todos os arquivos abertos at o momento do processo de debug. Cada arquivo pode ser expandido, exibindo assim seus ndices e todos os campos do registro do arquivo onde se encontra o ponteiro. So trs as colunas de informaes exibidas: Objeto, Tipo e Contedo. Na coluna Contedo, so exibidas as informaes de acordo com o tipo de objeto exibido. Para as tabelas, so exibidos o Alias, o filtro utilizado, o nmero do registro onde o ponteiro est posicionado (Recno), o nmero total de registros e a ordem do ndice ativo. A tabela que a rea atualmente selecionada na execuo (o retorno da funo Alias( ) ) indicada com dois asteriscos (**). Para os ndices, exibida a chave de indexao (o retorno da funo IndexKey( ) ) e o ndice ativo marcado com dois asteriscos (**). Para os campos, exibido o seu contedo para o registro posicionado pelo cursor, exatamente como as variveis nas outras janelas de inspeo. Figura 29 - Janela de Inspeo de Tabelas de Dados

Os itens da janela de Watchs e as variveis das janelas de Inspeo de Variveis Locais e Estticas so exibidos de acordo com a Pilha de Chamadas. Se um duplo clique for efetuado sobre uma funo na pilha de chamadas, as janelas sero atualizadas com a situao das expresses e variveis no momento da execuo daquela funo. Isto permite ao usurio verificar as mudanas ocorridas em variveis em todos os momentos de execuo das suas rotinas. No entanto, quando um passo de debug efetuado (por exemplo, com o comando Percorrer Linha), as informaes so reavaliadas para a situao atual, ou seja, a ltima chamada de funo efetuada (primeiro item na lista da Pilha de Chamadas). Em todas as janelas de Inspeo, seja Watchs, Tabelas ou Variveis, existe uma barra de rolagem na base que permite ao usurio visualizar todo o texto da coluna Contedo (ou Resultado no caso da janela de Watchs) "rolando" o texto que seja maior do que o tamanho exibido da janela. Para facilitar a visualizao, as janelas de inspeo se utilizam de imagens que indicam o tipo de dado visualizado. Essas imagens (cuja legenda tambm pode ser visualizada atravs do acionamento do boto direito do mouse sobre cada janela) so: Indicador de varivel do tipo Caracter, Numrico, Data ou Memo Indicador de varivel do tipo Lgico com valor Falso Indicador de varivel do tipo Lgico com valor Verdadeiro Indicador de varivel do tipo Array Indicador de varivel do tipo Objeto Indicador de Tabela de Dados Indicador de ndice Indicador de Campo

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

24

O Inspetor de Objetos O Inspetor de Objetos (figura 30) exibe todas as funes registradas no Server. O usurio no precisa estar em processo de debug para obter do Server o mapa de objetos. Ao acionar a visualizao atravs do item Inspetor de Objetos no menu Visualizar ou ao acionar a opo Atualizar no menu acionado pelo boto direito do mouse, o Inspetor de Objetos ir conectarse ao Server e obter o mapa de objetos. O usurio pode optar por exibir o mapa em duas ordens diferentes: Por Programa e Por Funo.

Figura 30 - A janela do Inspetor de Objetos

Exibindo Por Programa, as funes registradas sero agrupadas pelo nome do programa na qual foi criada ao ser registrada no Server. Caso contrrio, uma lista de funes sem agrupamento ser exibida. Ao executar um duplo clique sobre o nome de uma funo (ou executar o comando Abrir no menu acionado pelo boto direito do mouse), o AP5 IDE tentar abrir o arquivo e posicionar o cursor na linha onde a funo se encontra. Pode-se tambm localizar funes dentro do mapa, selecionando a opo Localizar Funo no menu acionado pelo boto direito do mouse. Se a funo for localizada, o cursor ser posicionado sobre o n da mesma na rvore montada no mapa de objetos. Os objetos so os APO's (Advanced Protheus Object) registrados em repositrios no Server. So todas as rotinas e funes compiladas e registradas. Desse modo, ao obter o mapa de objetos, ser necessrio indicar uma das configuraes existentes no Gerenciador de Projetos, como visto na compilao ou na execuo do AP5 Remote atravs do AP5 IDE. Do mesmo modo, se nenhuma configurao for criada, o AP5 IDE ir considerar que os objetos devem ser obtidos do repositrio oficial. Figura 31 - Barra de progresso de processamentos do AP5 IDE com o boto para cancelamento. Se no for possvel conectar-se ao Server para a obteno do mapa de objetos, o AP5 IDE no exibir a janela do Inspetor de Objetos. Sempre que um arquivo compilado, podem haver mudanas nos objetos registrados no Server. A atualizao do mapa de objetos no efetuada automaticamente, ficando a cargo da necessidade do usurio. Para facilitar a visualizao, o Mapa de Objetos conta com a seguinte lista de imagens indicadoras dos objetos: Indicador de Arquivo Indicador de Funo Indicador de impossibilidade para o AP5 de abrir o arquivo (arquivo no encontrado) Como outros processamentos que requerem conexo ao Server (por exemplo, a compilao j detalhada anteriormente), durante a obteno do mapa de objetos, o AP5 IDE exibe uma barra de percentual de concluso acompanhada de um boto para o cancelamento no lugar da barra de tatus de sua janela principal (figura 31). O usurio pode cancelar a obteno do mapa de objetos clicando no boto Cancelar desta barra. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A. 25

Controlando Verses de Arquivos Atravs do AP5 IDE

Os Softwares para Controle de Verses de Arquivos


O AP5 IDE pode ser integrado a um software para gerenciamento de verses de arquivos de cdigo, permitindo ao usurio efetuar a reserva, a confirmao, a obteno de ltimas verses de arquivos, etc., diretamente de dentro do ambiente de desenvolvimento. Os softwares de controle de verso trabalham com uma base de dados dos arquivos que mantida em um servidor especfico e os usurios atravs de uma aplicao client deste software obtm cpias locais dos arquivos para poder alter-los, test-los e ento enviar as cpias com as novas implementaes para substituir as cpias existentes na base de dados do servidor. claro que apenas um usurio pode alterar um arquivo por vez e por isso o arquivo deve ser reservado antes de poder ser alterado. Para evitar confuses entre as cpias locais e as cpias mantidas no servidor, os softwares de controle de verso geralmente trabalham atribuindo o atributo de somente leitura (Read Only) aos arquivos locais, de modo que o usurio no os poder alterar a no ser que uma reserva seja efetuada antes. Este o mesmo conceito utilizado pelo AP5 IDE para permitir a alterao ou efetuar a reserva automtica de um arquivo.

O Controle de Verses Atravs do AP5 IDE


Como visto no captulo Configurando o AP5 IDE, o primeiro passo para a utilizao do Controle de Verso Integrado a configurao das linhas de comando para execuo das aes do software controlador de verso. A execuo destas aes so efetuadas atravs da execuo de macros no AP5 IDE que enviam as linhas de comando configuradas ao software controlador de verso. As macros utilizadas para o controle de verso so: $VERSION_CHECK_OUT, $VERSION_CHECK_IN, $VERSION_GET_LAST, $VERSION_ADD_FILE, $VERSION_REMOVE_FILE, $VERSION_UNDO_CHECK_OUT, $VERSION_ASK_FOR_COMMENT e $SYSTEM_USER_ACCESS. Para maiores detalhes sobre as macros existentes no AP5 IDE, verifique a Tabela de Macros ao final desta documentao.

A Reserva Automtica de um Arquivo


Quando o AP5 IDE est configurado para utilizar o controle de verso, o usurio ser questionado sobre a reserva assim que ocorrer a primeira tentativa de alterao em um arquivo com o atributo de somente leitura. Se optar por reserv-lo, o AP5 IDE ir ento executar a macro para reserva de arquivo ($VERSION_CHECK_OUT). Se o usurio optar por no reserv-lo, o atributo de somente leitura permanecer na cpia local do arquivo e conseqentemente o AP5 IDE no permitir que nele sejam efetuadas alteraes.

Executando Outras Macros de Controle de Verso


As macros de controle de verso tambm podem ser executadas atravs da barra de ferramentas de controle de verso (figura 32) que exibida automaticamente quando o uso de controle de verso habilitado nas configuraes de preferncias do AP5 IDE. Atravs do ambiente do AP5 IDE, o usurio pode: Obter a ltima verso de um arquivo, ou seja, o software de controle de verso gravar no diretrio onde o arquivo se encontra uma cpia local Figura 32 - A barra de com a ltima verso mantida em sua base de dados e nesta cpia local ferramentas para execuo colocar o atributo de somente leitura; das macros de controle de Reservar um arquivo, o que tambm far com que a ltima verso seja verso. trazida para a cpia local, porm o atributo de somente leitura ser removido permitindo que o usurio efetue as alteraes necessrias; Confirmar as alteraes em um arquivo reservado, ou seja, a cpia local ser enviada ao server e o arquivo no mais ficar reservado para o usurio. Conseqentemente, o atributo de somente leitura ser atribudo novamente copia local; 26

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Desfazer uma reserva efetuada, o que far com que a reserva na base de dados do software controlador de verso seja desfeita e o atributo de somente leitura seja atribudo novamente ao arquivo; Adicionar ou remover arquivos da base de dados, ou seja, atravs do AP5 IDE o usurio pode adicionar arquivos para que tenha a verso controlada pelo software controlador de verso ou remover um arquivo para que no mais tenha sua verso controlada por tal software.

Nas linhas de comando para o controle de verso, por default so adicionadas, quando o usurio as configura, as macros especiais $VERSION_ASK_FOR_COMMENT e $SYSTEM_USER_ACCESS, que respectivamente obtm do usurio o comentrio e o nome do usurio e senha para as operaes a serem efetuadas no servidor de verses (figura 33). Dependendo do modo que o software de controle de verso utilizado trabalha, o usurio pode customizar estas linhas de comando e at remover a execuo destas macros.

Figura 33 - A caixa de dilogo para digitao da senha exibida pela macro $SYSTEM_USER_ACCESS durante a execuo da macro para reserva de arquivo O responsvel pela remoo ou atribuio do atributo de somente leitura o software controlador de verso. Portanto, aps a execuo da macro para reserva do arquivo, o AP5 IDE ir esperar que o atributo de somente leitura seja removido do arquivo. Caso este atributo no seja removido dentro de um intervalo de tempo de cinco segundos (por exemplo, se a reserva do arquivo ainda no teve tempo de ser efetuada pelo software controlador de verso ou mesmo se a execuo da linha de comando falhou ou no foi possvel reservar o arquivo pois o mesmo est reservado para outro usurio) ser exibida uma mensagem questionando o usurio se o IDE deve aguardar mais cinco segundos pelo trmino da reserva do arquivo. Se o usurio no permitir que o IDE aguarde mais cinco segundos e o arquivo permanecer com o atributo de somente leitura o arquivo ser fechado por segurana (garantindo que uma eventual cpia local obtida do servidor cujo processo de reserva terminou posteriormente no seja sobrescrita por uma verso com informaes incorretas que poderia estar sendo mantida aberta no IDE). Aps a execuo de macros como a de reserva de arquivo ou a de obteno da ltima verso que tem alteraes efetuadas pelo software controlador de verso na cpia local do arquivo, o AP5 IDE ir reabrir o arquivo para carregar as eventuais diferenas. Portanto, antes da execuo de tais macros, caso o arquivo contenha modificaes no gravadas, o usurio ser questionado sobre a continuao da execuo da macro. A estrutura de pastas do projeto na base de dados do software de controle de verso deve ser a mesma estrutura dos diretrios dos arquivos trabalhados. Este conceito foi implantado para facilitar a execuo das macros automaticamente pois o path dos arquivos informado na linha de comando. Entretanto, isto possvel de ser alterado, simplesmente modificando as linhas de comandos informadas na janela de preferncias (por exemplo, informando um nome de projeto fixo) de acordo com a sintaxe de linha de comando do software utilizado. Note que alguns softwares controladores de verso, como o Visual Source Safe da Microsoft, permitem ao usurio criar diferentes bancos de dados para armazenamento dos projetos mesmo que isso no seja aconselhvel pelo prprio fabricante. Para a execuo das macros de controle de verso, o AP5 IDE funcionar corretamente com apenas um banco de dados para armazenagem. Para a execuo de qualquer um dos comandos de controle de verso, o usurio deve ter os direitos necessrios cadastrados no software de controle de verso utilizado.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

27

Muito importante: Caso o usurio deseje efetuar testes locais, e desse modo remover manualmente (ou mesmo atravs de opes do software de controle de verso utilizadas nas linhas de comando das macros) o atributo de somente leitura, a execuo automtica do pedido de reserva no ser efetuada pelo AP5 IDE e as cpias locais (mesmo que no estejam reservadas ou no sejam a verso correta mantida no servidor de controle de verso) podero sempre ser editadas no AP5 IDE. Assim, o controle das reservas e confirmaes dos arquivos ser totalmente do usurio pela execuo atravs dos botes na barra de ferramentas de controle de verso ou diretamente em uma verso client do software controlador de verso. Note que neste caso o usurio deve verificar sempre se o arquivo est corretamente reservado atravs do software de controle de verso, pois no h garantias de que, por exemplo, uma linha de comando executada atravs do AP5 IDE foi executada com sucesso e a verso do arquivo que o usurio est editando a ltima. Do mesmo modo, se o software de controle de verso utilizado no trabalhar com o atributo de somente leitura nos arquivos, apenas as execues manuais das macros sero efetuadas no AP5 IDE e extremamente aconselhvel neste caso que as operaes de reserva, confirmao, etc. sejam efetuadas sempre atravs da verso client do software de controle de verso.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

28

Utilizando os Assistentes do AP5 IDE


Atravs do menu Ferramentas (figura 34) o usurio tem acesso aos assistentes do AP5 IDE e tambm as ferramentas customizadas que sero detalhadas mais a frente. O AP5 IDE disponibiliza o Assistente de Gerao de Cdigo e o Assistente de Converso.

Figura 34 - O Menu Ferramentas.

O Assistente de Gerao de Cdigo


O Assistente de Gerao de Cdigo do AP5 IDE (figura 35) permite a criao de rotinas bsicas atravs de informaes definidas pelo usurio. O assistente cria rotinas especficas com o cdigo bsico para o tipo de rotina desejada, facilitando ao usurio pois ele dever somente incluir a lgica principal de acordo com a sua necessidade. O escopo do programa, com as funes em ADVPL, so montados pelo assistente. Os tipos de rotinas que so criados pelo Assistente de Gerao de Cdigo so rotinas de relatrios, rotinas de cadastro, rotinas para gerao e importao de arquivo texto e rotinas de processamento genrico. Figura 35 - O Assistente de Gerao de Cdigo Para a gerao do escopo do programa, o Assistente solicita informaes como o arquivo principal, os parmetros utilizados, ttulos de relatrios ou browsers, etc. (por exemplo, figura 36).

Figura 36 Informaes necessrias ao Assistente de Gerao de Cdigo para a gerao do escopo do programa.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

29

O Assistente de Converso de Cdigo


Os antigos Rdmakes mantidos pelos usurios continuam compatveis na verso do AP5. Porm, algumas alteraes so necessrias para o correto funcionamento destes programas. Para auxiliar na adaptao dos Rdmakes, o AP5 IDE contm um Assistente de Converso de Cdigo.

Selecionando os Arquivos
Acionando a opo Assistente de Converso do menu Ferramentas, o Assistente iniciar de sua tela para seleo de arquivos para converso (figura 37). Atravs dos botes ao lado direito da lista, o usurio pode adicionar, remover ou limpar a lista de arquivos para a converso. Aps um ou mais arquivos terem sido adicionados a lista, o boto Avanar ser disponibilizado para que o processo continue. Selecionando Avanar, o processo de compatibilizao se iniciar (figura 38). Figura 37 - Seleo de arquivos para converso no Assistente de Converso de Cdigo

Convertendo os Arquivos
Aps o trmino do processo de converso o boto Avanar se tornar novamente disponvel. O Assistente de Converso no efetuar diretamente as alteraes nos arquivos selecionados para converso. Utilizar uma cpia em memria de cada arquivo onde efetuar as mudanas necessrias. Na tela seguinte o Assistente questionar o usurio pelo diretrio no qual dever gravar os arquivos convertidos (figura 39). Figura 38 - O Assistente em processo de converso dos arquivos

Diretrio para Gravao dos Arquivos Convertidos


Nesta tela o usurio poder tambm selecionar quais os arquivos que no deseja gravar e remov-los da lista de arquivos convertidos. Todos os arquivos da lista sero gravados com o nome original no diretrio informado. Portanto, aconselhvel fornecer um diretrio diferente do diretrio dos arquivos originais para que os mesmos no sejam substitudos. Seguir uma tela de processo da gravao dos arquivos e ento a tela de finalizao da converso (figura 40) ser exibida. Neste momento os arquivos convertidos j se encontram gravados no diretrio informado. 30

Figura 39 - Seleo do diretrio para gravao dos arquivos convertidos. AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Criao de Projeto e Compilao Automticos


O Assistente de Converso do AP5 IDE tambm poder criar automaticamente um grupo de projetos (conforme descrito em captulo anterior) com todos os arquivos convertidos. Para isso basta selecionar a opo Criar um Novo Projeto e fornecer o nome do arquivo. O arquivo ser criado no mesmo diretrio onde os arquivos convertidos foram gravados. O Assistente tambm poder compilar automaticamente o grupo de projetos criado, bastando que o usurio selecione a opo Compilar Todos os Arquivos.

Figura 40 - A tela de finalizao da converso, onde o usurio pode criar um grupo de projetos e compilar os arquivos automaticamente. Ao se pressionar o boto Finalizar, o assistente ir ento executar as opes selecionadas pelo usurio. Caso no seja possvel criar o grupo de projetos, ou compilar os arquivos (por exemplo, se no for possvel conectar ao Server) o usurio ser avisado sem qualquer interferncia nos arquivos convertidos gravados no diretrio informado anteriormente. Como j detalhado anteriormente, os cdigos criados por usurios do Siga Advanced devero utilizar a clusula USER FUNCTION <nome do programa>, garantindo assim a unicidade das funes criadas. Isto tambm permite que a funo EXECBLOCK e as opes de menus iniciadas com o caracter de cdigo ASCII 35 (#) sejam executadas normalmente. A incluso da clusula USER FUNCTION uma das alteraes efetuadas pelo Assistente de Converso. Nos antigos Rdmakes, todas as variveis eram criadas como Private no escopo do sistema. Assim, uma varivel criada em uma funo chamada pela rotina principal, permanecia durante toda a execuo do Rdmake. Como agora o cdigo no mais interpretado, as variveis Private permanecem durante toda a execuo at a finalizao da rotina que a criou. Ento, por motivos de compatibilizao, todas as variveis sero declaradas no incio da rotina convertida. Finalmente, por ser um cdigo interpretado o RDMAKE utilizava-se da funo EXECUTE para executar funes nas aes de botes ou em outras ocasies. Como o usurio tem a sua disposio todas caractersticas da linguagem ADVPL, como por exemplo uso de parmetros e retorno de valores em funes, as chamadas das funes EXECUTE(<nome da funo>) so substitudas pela chamada da prpria funo nos programas convertidos. Juntamente com estas alteraes, ser includa nas rotinas especficas convertidas a clusula #INCLUDE "RWMAKE.CH" para manter a compatibilidade dos comandos utilizados no Rdmake e todas as clusulas #INCLUDE ou #DEFINE j existentes na rotina especfica sero movidas para o incio do programa.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

31

Tabela de Macros
As Macros implementadas no AP5 IDE podem ser utilizadas para automatizar aes ou ferramentas. No menu Ferramentas, qualquer ferramenta adicionada pode utilizar nos parmetros ou no diretrio inicial uma ou mais macros. Basta informar no texto o nome da macro. Por exemplo, pode-se utilizar macros na incluso de uma ferramenta que permita editar o arquivo corrente no NOTEPAD do Windows: NOTEPAD.EXE $SOURCE_NAME. Alm dessa utilizao, a macro $VERSION_CHECK_IN pode ser executada automaticamente durante o processamento do AP5 IDE. Abaixo encontram-se detalhadas as macros suportadas no AP5 IDE. Nome $$ $IDE_PATH $INPUT_TEXT(cTit,cMsg,cDefault) Descrio Retorna o caracter "$". Retorna o path de execuo do AP5 IDE. Exibe a mensagem informada em cMsg em um dilogo com ttulo cTit, permitindo a digitao de um texto. Retorna o texto digitado caso o dilogo seja confirmado ou o texto em cDefault caso o dilogo seja cancelado. Retorna o nome completo (path e nome) do arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Retorna o nome completo sem a letra do drive do arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Retorna somente o nome do arquivo corrente (sem path ou letra do drive). Se nenhum arquivo estiver aberto retorna vazio (""). Retorna a linha onde o cursor est posicionado no arquivo corrente. Se nenhum arquivo estiver aberto retorna "00". Retorna a coluna onde o cursor est posicionado no arquivo corrente. Se nenhum arquivo estiver aberto retorna "00". Retorna a palavra que se encontra onde o cursor est posicionado no arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Considera como palavra todo e qualquer texto entre os delimitadores. Retorna a linha de execuo no arquivo corrente. Se nenhum arquivo estiver aberto ou o AP5 IDE No estiver em modo de debug, retorna "00". Retorna o path do arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Retorna a extenso do arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Retorna a letra do drive do arquivo corrente. Se nenhum arquivo estiver aberto retorna vazio (""). Retorna a data do sistema no padro dd/mm/yyyy. Retorna a hora do sistema no padro hh:mm:ss. Retorna o nome do login do usurio na rede. Se o usurio no estiver logado ou no houver uma rede, retorna vazio (""). Exibe uma caixa de dilogo para identificao por ID e senha, retornando-os separados por uma vrgula (;) ou vazio ("") se a caixa de dilogo for cancelada. Adiciona o arquivo corrente ao servidor de controle de verso , atravs da execuo da linha de comando informada nas preferncias. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra. 32

$SOURCE_NAME $SOURCE_NAME_NO_DRIVE $SOURCE_SHORT_NAME $SOURCE_CURSOR_LINE $SOURCE_CURSOR_COLUMN $SOURCE_CURSOR_WORD

$SOURCE_EXECUTION_LINE

$SOURCE_PATH $SOURCE_EXT $SOURCE_DRIVE $SOURCE_SYSTEM_DATE $SOURCE_SYSTEM_TIME $SYSTEM_USER_NAME $SYSTEM_USER_ACCESS

$VERSION_ADD_FILE

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

$VERSION_ASK_FOR_COMMENT

$VERSION_CHECK_OUT

$VERSION_CHECK_IN

$VERSION_GET_LAST

$VERSION_REMOVE_FILE

$VERSION_UNDO_CHECK_OUT

Exibe uma caixa de dilogo para a digitao do comentrio para as operaes de reserva, confirmao, etc. de controle de verso. Esta macro utilizada automaticamente pelas macros que executam aes do controlador de verso. Reserva o arquivo corrente para alterao no Controlador de Verso, atravs da execuo da linha de comando informada nas preferncias. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra. Aps reservar o fonte, o arquivo reaberto para carregar eventuais modificaes. Confirma as alteraes no arquivo corrente, levando-as para o servidor do controle de verso e desfaz a reserva efetuada, atravs da execuo da linha de comando informada nas preferncias. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra. Obtm a ltima verso do arquivo corrente no controlador de verso. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Aps a execuo do comando o arquivo reaberto para carregar eventuais modificaes. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra. Remove o arquivo corrente do controlador de verso. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra. Desfaz a ltima reserva efetuada para o arquivo corrente no controlador de verso. Esta macro s tem funcionalidade quando o uso de controle de verso estiver habilitado no AP5 IDE. Note que a estrutura de pastas do projeto no Controlador de Verso deve ser a mesma estrutura de diretrios onde o arquivo se encontra.

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

33

Glossrio
Expresso
ADVPL Alias

Definio
Advanced Program Language - Linguagem de programao desenvolvida pela Microsiga Software S.A. Alias de um arquivo um "apelido" dado a um arquivo aberto, de modo que para selecionar a rea de trabalho e poder efetuar alteraes ou pesquisas, o usurio pode se referir ao arquivo atravs deste apelido. No Siga Advanced, os arquivos tm como padro os Alias referentes s trs primeiras letras de seu nome, por exemplo SB1. Programa do AP5 que faz a interface com o usurio, atravs da comunicao com o AP5 Server. Multiple Document Interface (Interface de Documentos Mltiplos). uma aplicao cuja interface consiste de uma janela principal que pode conter mltiplas janelas filhas, ou documentos. Os ttulos das janelas filhas combinam com o ttulo da janela pai quando a janela filha maximizada. Pontos de parada marcados nas linhas do cdigo de um programa que indicam pontos onde o processamento deve entrar em modo de debug quando forem alcanados. uma cpia do arquivo aberto no AP5 IDE mantida em memria para permitir a edio do mesmo. Essa cpia carregada quando o arquivo aberto e gravada quando o arquivo salvo. Processo de depurao de erros atravs da execuo linha-a-linha do cdigo, com a ajuda de inspetores de ambiente que exibem o contedo de variveis, campos, etc. Programa que encontra e elimina erros de programao (bugs). Delimitadores so caracteres especiais ou de pontuao utilizados para separar as palavras do cdigo. Por exemplo, o texto "IF !EOF()" contm duas palavras: "IF" e "EOF". A separao das palavras necessria para a Diferenciao de Sintaxe. Abaixo est a lista de delimitadores de texto considerados no AP5 IDE. Caracter de Tabulao (Cdigo ASC II #9) Caracter de Line Feed (Cdigo ASC II #10) Caracter de Carriage Return (Cdigo ASC II #13) Caracter de Espao (Cdigo ASC II #32) Caracter de Ponto (Cdigo ASC II #46) Caracter de Vrgula (Cdigo ASC II #44) Caracter de Dois-Pontos (Cdigo ASC II #58) Caracter de Ponto-e-Vrgula (Cdigo ASC II #59) Caracter de Abertura de Chaves (Cdigo ASC II #123) Caracter de Fechamento de Chaves (Cdigo ASC II #125) Caracter de Abertura de Colchetes (Cdigo ASC II #91) Caracter de Fechamento de Colchetes (Cdigo ASC II #93) Caracter de Abertura de Parnteses (Cdigo ASC II #40) Caracter de Fechamento de Parnteses (Cdigo ASC II #41) Caracter de Sinal de Igual (Cdigo ASC II #61) Caracter de Sinal de Adio (Cdigo ASC II #43) Caracter de Sinal de Subtrao (Cdigo ASC II #45) Caracter de Sinal de Multiplicao (Cdigo ASC II #*42) Caracter de Sinal de Diviso (Cdigo ASC II #47) Caracter de Barra Invertida (Cdigo ASC II #92) Caracter de Sinal de Maior (Cdigo ASC II #62) Caracter de Sinal de Menor (Cdigo ASC II #60) Caracter de Sinal de Percentual (Cdigo ASC II #37) Caracter de Sinal de Arroba (Cdigo ASC II #64) Caracter de Exclamao (Cdigo ASC II #33) Caracter de Diferena (Cdigo ASC II #35) Caracter de Macro Substituio (Cdigo ASC II #38) Caracter de Cifro (Cdigo ASC II #36) 34

AP5 Remote Aplicao MDI

Break Points Buffer de Edio

Debug Debugger Delimitadores

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Derrubar Client

Diferenciao de Sintaxe Identao

Finaliza a execuo do AP5 Remote. A finalizao do AP5 Remote somente ser efetuada assim que alguma linha de cdigo for executada. Por exemplo, se o AP5 Remote estiver em estado de espera (aguardando por uma digitao do usurio), a finalizao pedida no IDE somente ser efetuada assim que algum cdigo no AP5 Remote seja executado (por exemplo, na validao do texto digitado pelo usurio). Diferenciao atravs de cores do texto do cdigo de um programa, visando facilitar a identificao de erros de digitao e melhorar o aspecto visual. Geralmente so diferenciados texto comum de palavras reservadas, nmeros ou strings. o alinhamento das linhas de texto, atravs da incluso de tabulaes, segundo a estrutura lgica do programa visando facilitar a leitura do cdigo. Por exemplo, abaixo esto demonstradas linhas de cdigo sem e com identao de texto: if i < 10 for x := i to 10 grava() next x endif

Executar

Gutter

IDE

Pausar

Percorrer Linha Programas Registrados

Ponto de Entrada

Pular Linha RDMAKE

if i < 10 for x := i to 10 grava() next x endif Executa o AP5 Remote normalmente, mantendo o IDE em estado de espera. Desse modo, o IDE somente entrar em modo de debug em uma das seguintes situaes: 1. um break point for encontrado; 2. o usurio selecionar o comando pause no IDE; 3. um break point condicional for satisfeito; 4. o usurio pressionar no AP5 Remote a combinao de teclas ALT+D. O modo de execuo tambm se encerra se o usurio finalizar o AP5 Remote. rea nas margens de uma janela utilizada para a exibio de informaes, como por exemplo a rea onde ficam marcados os cones de break points ou a rea da rgua de nmeros de linhas nas janelas de documentos do AP5 IDE. Integrated Development Environment (Ambiente de Desenvolvimento Integrado). uma aplicao onde todo o desenvolvimento, execuo, depurao e correo de procedimentos pode ser desenvolvido. Parada na execuo do AP5 Remote ou na execuo de uma animao. A parada do AP5 Remote somente ser executada assim que alguma linha de cdigo for executada. Por exemplo, se o AP5 Remote estiver em estado de espera (aguardando por uma digitao do usurio), a pausa efetuada no IDE somente ser efetuada assim que algum cdigo no AP5 Remote seja executado (por exemplo, na validao do texto digitado pelo usurio). Execuo linha por linha do cdigo, entrando no cdigo de funes. So todos os programas compilados atravs do Advanced Protheus IDE, que so mantidos em diferentes repositrios no Advanced Protheus Server, de acordo com opo do Administrador. Conceito implementado desde as verses anteriores do sistema de ERP Siga Advanced. uma rotina de nome fixo e criada pelo usurio. O sistema Siga Advanced checa a existncia desta rotina em determinados pontos do cdigo e a executa se for encontrada, permitindo assim que o usurio customize processos fechados. Na verso 5.07, o usurio pode debugar estas rotinas chamadas automaticamente atravs do AP5 IDE (por exemplo, adicionando break points). Execuo linha por linha do cdigo, sem entrar no cdigo das funes. Linguagem interpretada criada pela Microsiga Software S.A. utilizada no sistema de ERP Siga Advanced at a verso x.07. 35

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

Seguir At Retorno

Server

String

Execuo em modo normal do AP5 Remote at o momento em que a linha em execuo seja a linha onde o cursor est posicionado. Para isso, o Advanced Protheus IDE coloca um break point temporrio na linha onde o cursor est posicionado. Servio do AP5 que se encarrega de executar as rotinas dos programas registrados e controlar o acesso dos usurios. Comunica-se com o AP5 Remote para permitir a interface com o usurio. Cadeia de caracteres formadora de um texto qualquer, compreendida entre aspas duplas (") ou aspas simples ('), como por exemplo "AP5". Variveis definidas com instncia esttica, ou seja, podero ser visualizadas ou alteradas por qualquer rotina dentro do mesmo programa. Variveis definidas com instncia local, ou seja, podero ser visualizadas ou alteradas somente dentro da rotina que as declarou. Variveis definidas com instncia privada, ou seja, podero ser visualizadas ou alteradas apenas pela rotina que as declarou e pelas rotinas chamadas por esta. Variveis definidas com instncia pblica, ou seja, podero ser visualizadas ou alteradas por qualquer rotina dos programas registrados. Janela de inspeo onde expresses digitadas pelo usurio podem ser avaliadas no AP5 Server durante o processo de debug.

Variveis Estticas Variveis Locais Variveis Privadas Variveis Pblicas Watchs

AP5 IDE Documentao e Guia do Usurio CopyRight 1999 Microsiga Software S.A.

36