Você está na página 1de 36

de

AP5 IDE
Documentao e Guia do Usurio
CopyRight 1999 Microsiga Softare S!"!
"#$ %D& ' Documentao e Guia do Usurio
CopyRight 1999 Microsiga Softare S!"!
Sumrio
Documentao e Guia do Usurio..............................................................................................1
CopyRight 1999 Microsiga Sot!are S."................................................................................1
Sumrio........................................................................................................................................#
$ "%& 'D(...................................................................................................................................)
Conigurando o "%& 'D(............................................................................................................&
Configuraes do Debugger............................................................................................................... 5
Definindo o #adro de (ec)as de "ta)ho!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!$
Definindo o *+mero de "r,ui-os na .ista de Recentemente "/ertos!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!0
Uti)i1ando a R2gua com o *+mero de .inhas!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!0
Definindo a .oca)i1ao de "r,ui-os!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!0
%gnorando "r,ui-os *o &ncontrados!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!0
Configuraes de Cdigo.................................................................................................................... 7
&)ementos de (e3to!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!4
Definindo o &sti)o do (e3to!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!4
Definindo a Cor do (e3to!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!4
Definindo a Cor de 5undo do (e3to!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!4
Desa/i)itando a Diferenciao de Sinta3e!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!4
Configuraes de Controle de Verso...............................................................................................!
Uti)i1ando o Contro)e de 6erso!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!7
Softare Contro)ador de 6erso!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!7
#ath %nicia) do Softare Contro)ador de 6erso!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!7
.inha de Comando para 8/teno da 9)tima 6erso!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
.inha de Comando para Reser-ar "r,ui-o!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
.inha de Comando para Cance)ar Reser-a!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
.inha de Comando para Confirmar "r,ui-o!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
.inha de Comando para "dicionar "r,ui-o!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
.inha de Comando para Remo-er "r,ui-o!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!9
Uti*i+ando o "%& 'D(................................................................................................................1,
A Edio de Ar"ui#os....................................................................................................................... $%
Criando e &ditando "r,ui-os!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!1:
Recursos de &dio!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!11
&ru'os de Pro(etos e a Com'ilao de Ar"ui#os...........................................................................$)
(ra/a)hando com Grupos de #ro;etos!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!1<
Compi)ando "r,ui-os de C=digo>5onte!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!1$
Configura?es de um Grupo de #ro;etos!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10
*tili+ando o Debugger do AP5 IDE.................................................................................................$,
8s Comandos de De/ug!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!19
"s @ane)as de %nspeo do "#$ %D&!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!A1
Contro*ando -ers.es de "r/ui0os "tra01s do "%& 'D(.........................................................#2
-s Soft.ares 'ara Controle de Verses de Ar"ui#os...................................................................../0
- Controle de Verses Atra#1s do AP5 IDE.................................................................................../0
" Reser-a "utomtica de um "r,ui-o!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!A0
&3ecutando 8utras Macros de Contro)e de 6erso!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!A0
"#$ %D& ' Documentao e Guia do Usurio
CopyRight 1999 Microsiga Softare S!"!
Uti*i+ando os "ssistentes do "%& 'D(......................................................................................#9
- Assistente de &erao de Cdigo................................................................................................./,
- Assistente de Con#erso de Cdigo..............................................................................................2%
Se)ecionando os "r,ui-os!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!B:
Con-ertendo os "r,ui-os!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!B:
Diret=rio para Gra-ao dos "r,ui-os Con-ertidos!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!B:
Criao de #ro;eto e Compi)ao "utomticos!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!B1
3a4e*a de Macros.......................................................................................................................5#
G*ossrio....................................................................................................................................5)
"#$ %D& ' Documentao e Guia do Usurio
CopyRight 1999 Microsiga Softare S!"!
O AP5 IDE
8 "#$ %D& 2 um am/iente de desen-o)-imento integrado ,ue acompanha o "d-anced #rotheusC permitindo ao
usurio editarC compi)ar e depurar programas escritos na )inguagem "D6#.!
Como ferramenta de edioC possui todos os recursos das ferramentas mais popu)aresC como cortar e co)arC )e-ar o
cursor at2 determinada )inha do c=digoC )oca)i1ao e su/stituio de te3toC etc!C e recursos adicionaisC como
identao de c=digoC insero de comentrios de documentaoC etc!
Como ferramenta de de/ugC disp?e de a?es de de/ug como #ercorrer .inhaC #u)ar .inhaC &3ecutarC Seguir at2 o
RetornoC #ausar &3ecuoC Derru/ar C)ientC etc!C permitindo ao usurio e3ecutar e depurar suas rotinas de dentro
de seu am/iente integradoC inspecionando o am/iente de e3ecuo de suas rotinas atra-2s de di-ersas ;ane)as de
informa?esC como -ari-eis Ddi-ididas entre -ari-eis )ocaisC -ari-eis p+/)icasC -ari-eis pri-adas e -ari-eis
estticasEC e3press?es em FatchC ta/e)asC Gndices e camposC /reaH pointsC programas registrados Dinspetor de
o/;etosE e pi)ha de chamadas! ")2m dissoC os programas criados so compi)ados diretamente do "#$ %D&C onde
so mantidos em pro;etos e grupos de pro;etos! 8s grupos de pro;etos faci)itam a compi)ao de um ou mais
pro;etos de ar,ui-osC uti)i1ando conceitos de reposit=rios e direti-as de compi)aoC possi/i)itando inc)usi-e a
manuteno de /i/)iotecas de rotinas do usurio!
"#$ %D& ' Documentao e Guia do Usurio <
CopyRight 1999 Microsiga Softare S!"!
Configurando o AP5 IDE
"ntes de iniciar a uti)i1ao do "#$
%D&C de-e>se configur>)o para um
me)hor apro-eitamento de seus
recursos! *a opo de preferInciasC
encontrada no menu ArquivoC item
PrefernciasC so definidas as
informa?es ,ue inf)uenciam no
comportamento do "#$ %D&! "o
acionar este item do menuC a ;ane)a de
#referIncias 2 e3i/idaC contendo
informa?es di-ididas em trIs pastas!
(odas as informa?es das preferIncias
/em como as di-ersas informa?es
arma1enadas pe)o "#$ %D&C so
mantidas no ar,ui-o chamado
"#$%D&!%*% ,ue se encontra no mesmo
diret=rio de e3ecuo do %D&!
Configuraes do Debugger
" pasta de configura?es do de/ugger Dfigura 1EC e3i/e as op?es /sicas para o processamento do "#$ %D& em
modo de de/ug e do editor! ",ui so definidas as configura?es para a )oca)i1ao dos ar,ui-os de c=digo fonte
durante o processo de de/ugC se o "#$ %D& de-e ignorar automaticamente os ar,ui-os no encontradosC o
tamanho da ta/u)aoC do n+mero de UndoJsC etc!
Definindo o Padro de Teclas de Atalho
8 padro de tec)as uti)i1ado identifica ,uais sero as tec)as para o acionamento das principais fun?es de de/ug do
"#$ %D&! 8s padr?es possG-eis so os mesmos uti)i1ados pe)as )inguagens de programao 5i-eFinC 6isua) CKK
e De)phiC tornando fci) a assimi)ao para usurios de a)gumas destas ferramentas! #ara cada um dos padr?es
uti)i1adosC as com/ina?es de tec)as para o acionamento das a?es de de/ug seroL
FiveWin
Percorrer Linha F8 Seguir at o Retorno F7
Pular Linha F10 Localizar Ctrl+L
Executar F5 Localizar Prximo F
!"icionar #rea$ Point F% &r 'ara a linha (n( Ctrl+)
Visual C++
Percorrer Linha F11 Seguir at o Retorno Ctrl+F10
Pular Linha F10 Localizar Ctrl+F
Executar F5 Localizar Prximo F
!"icionar #rea$ Point F% &r 'ara a linha (n( Ctrl+)
Delphi
Percorrer Linha F7 Seguir at o Retorno F*
Pular Linha F8 Localizar Ctrl+F
Executar F% Localizar Prximo F
!"icionar #rea$ Point F5 &r 'ara a linha (n( Ctrl+)
"#$ %D& ' Documentao e Guia do Usurio $
CopyRight 1999 Microsiga Softare S!"!
3igura $ 4 A 'asta Debugger da (anela de Prefer5n6ias do AP5 IDE
Definindo a Tabulao
8 campo Tabulao indica o n+mero de caracteres ,ue sero usados para cada tec)a de ta/u)ao Dc=digo "SC %%
M9EC na identao do c=digo!
Definindo o Nmero de ndo!s
8 campo de Nmero Mximo de Undo's indica o n+mero m3imo de modifica?es no te3to ,ue o "#$ %D& ir
arma1enar para permitir o Undo eNou Redo! "s a?es so arma1enadas de modo ,ue assim ,ue 2 atingido o )imite
esta/e)ecido as +)timas a?es passam a ser descartadas a cada no-a ao!
8s UndoJs e RedoJs so mantidos por ar,ui-oC e so resetados ,uando o ar,ui-o 2 sa)-o! %ndicando 1ero D:EC o
arma1enamento m3imo torna>se infinito Ddependente apenas da mem=ria disponG-e)E!
Definindo o Nmero de Ar"ui#os na $ista de %ecentemente Abertos
8 campo Arquivos na Lisa de !ecenemene Aberos indica o n+mero m3imo de ar,ui-os ,ue sero mantidos na
)ista de recentemente a/ertosC ,ue se encontra no fina) do menu Arquivo" para possi/i)itar a a/ertura rpida dos
mesmos! %ndicando 1ero D:EC no ser mantida uma )ista dos ar,ui-os recentemente a/ertos!
tili&ando a %'gua com o Nmero de $inhas
" opo #xibir !$%ua com o Nmero de Lin&as indica se o "#$ %D& de-e e3i/ir uma r2gua com os n+meros das
)inhas em um no-o gutter na margem es,uerda de cada ar,ui-o a/ertoC para faci)itar a )oca)i1ao -isua) do
usurio!
Definindo a $ocali&ao de Ar"ui#os
Ouando em processo de de/ugC especificamente durante os comandos de Percorrer Lin&a e Pular Lin&aC a
e3ecuo 2 feita )inha>a>)inha do c=digo! #ara issoC o "#$ %D& )oca)i1a os ar,ui-os de c=digo fonteC a/re>os e
posiciona o cursor na )inha em e3ecuo! #ara os ar,ui-os no encontradosC o %D& ,uestionar o usurio por seu
caminho! Se no forem encontradosC no podero ser a/ertos para o posicionamento da )inha e sero co)ocados em
uma )ista de ar,ui-os ignorados Dat2 ,ue o %D& se;a reinicia)i1adoE! #ara faci)itar a )oca)i1aoC pode>se digitar
neste campo uma )ista de paths onde os ar,ui-os de-em ser procurados! 8s paths de-em ser separados com o sina)
de ponto>e>-Grgu)a DPE!
Ignorando Ar"ui#os No Encontrados
Ouando em processo de de/ugC especificamente durante os comandos de Percorrer Lin&a e Pular Lin&aC a
e3ecuo 2 feita inha>a>)inha do c=digo! #ara issoC o "#$ %D& )oca)i1a os ar,ui-os de c=digo fonteC a/re>os e
posiciona o cursor na )inha em e3ecuo! #or2m se no for possG-e) encontrar o ar,ui-o de c=digo fonteC o %D&
,uestionar o usurio pe)o caminho onde o ar,ui-o pode ser encontrado! Se o usurio rea)mente no ti-er o
ar,ui-o e cance)ar a )oca)i1ao do mesmoC o %D& no o ,uestionar mais Dat2 ,ue o %D& se;a reinicia)i1adoE! #ara
e-itar ,ue se;a ,uestionado a cada ar,ui-o no encontradoC pode>se marcar esta opo! "ssim todos os ar,ui-os
no encontrados sero adicionados automaticamente Q )ista de ar,ui-os ignorados!
*ote ,ue os /reaH points e-entua)mente contidos em um fonte no encontrado no faro com ,ue o
processamento pare! Do mesmo modoC e3ecutando o comando Percorrer Lin&a so/re uma funo
,ue este;a em um ar,ui-o de c=digo>fonte no encontradoC far com ,ue a funo se;a norma)mente
e3ecutada e a parada -o)te a ocorrer somente na pr=3ima )inhaC depois do retorno da funo!
"#$ %D& ' Documentao e Guia do Usurio 0
CopyRight 1999 Microsiga Softare S!"!
Configuraes de Cdigo
" pasta de configura?es do
c=digo Dfigura AEC e3i/e as op?es
para contro)e da diferenciao de
sinta3e no editor do "#$ %D&!
",ui -ocI pode ha/i)itar ou
desa/i)itar a diferenciao de
sinta3e /em como configurar as
cores para cada e)emento de te3to
,ue pode ser diferenciado!
Elementos de Te(to
8s e)ementos de te3to so tipos de e3press?es ,ue de-ido a sua fina)idade so c)assificados em grupos separados!
Como por e3emp)oC pa)a-ras reser-adas ao compi)adorC strings de caracteresC n+merosC etc! *esta )ista so
apresentados os diferentes e)ementos de te3to ,ue permitem a diferenciao de sinta3e no "#$ %D&! 8 e)emento
de-e ser se)ecionado nesta )ista para ,ue se possa configurar suas cores e esti)o! (odas as demais configura?es
nesta mesma pasta seroC entoC re)acionadas com o e)emento atua)mente se)ecionado!
Definindo o Estilo do Te(to
*esta )ista de op?es pode>se esco)her ,ua) o esti)o ser ap)icado ao e)emento de te3to se)ecionado na )ista de
e)ementos!
Definindo a Cor do Te(to
*esta )ista de cores pode>se esco)her ,ua) ser a cor ap)icada ao e)emento de te3to se)ecionado na )ista de
e)ementos!
Definindo a Cor de )undo do Te(to
*esta )ista de cores pode>se esco)her ,ua) ser a cor de fundo ap)icada ao e)emento de te3to se)ecionado na )ista de
e)ementos!
Desabilitando a Diferenciao de *inta(e
Se)ecionando>se esta opoC o "#$ %D& no se uti)i1ar da diferenciao de sinta3e no c=digo dos ar,ui-os
a/ertos! "pesar de ,ue o uso diferenciao de sinta3e no consuma muitos recursosC o atua)i1ao das ;ane)as
pode ficar mais rpida com esse recurso desa/i)itado! Desa/i)itando a diferenciaoC as cores de todo o te3to sero
a,ue)as definidas no Findos da estao!
#ara a a)terao da fonte do te3toC uti)i1e a opo #scol&a de 'one no menu Arquivo! " fonte no
pode ser diferenciada para os e)ementos de te3to do c=digo! "penas o esti)o e as cores!

"#$ %D& ' Documentao e Guia do Usurio 4
CopyRight 1999 Microsiga Softare S!"!
3igura / 4 A 'asta Cdigo da (anela de Prefer5n6ias do AP5 IDE
Configuraes de Controle de Verso
" pasta de configura?es de
Contro)e de 6erso Dfigura BEC e3i/e
as op?es para a integrao de um
softare de contro)e de -erso ao
"#$ %D&! *esta pasta so definidos
os comandos /sicos para
acionamento do softare
contro)ador de -erso atra-2s de
)inha de comando! &stes comandos
podem ser acionados
automaticamente pe)o "#$ %D& ou
pe)a re,uisio do usurio atra-2s
dos /ot?es da /arra de ferramentas
de contro)e de -erso!
tili&ando o Controle de +erso
" opo Uili(a )onrole de *erso indica ,ue ser uti)i1ado um softare de contro)e de -erso para contro)ar a
reser-a e a a)terao de ar,ui-os de c=digo>fonte! "o acionar esta opo uma ;ane)a com os softares
contro)adores de -erso compatG-eis Dfigura <E ser apresentada para ,ue o usurio esco)ha a,ue)e ,ue este;a
uti)i1ando! " confirmao desta ;ane)a tra1 nos campos das )inhas de comando as sinta3es uti)i1adas pe)o softare
esco)hido sugeridas! Caso o softare uti)i1ado no se encontre na )ista de softares compatG-eisC o usurio de-er
consu)tar a documentao ,ue o acompanha e fornecer manua)mente as sinta3es para as )inhas de comandos!
*oft,are Controlador de
+erso
8 campo +of,are indica o caminho
para o softare ,ue rece/er as )inhas
de comando en-iadas pe)o "#$ %D&
para as a?es de contro)e de -erso!
Path Inicial do *oft,are
Controlador de
+erso
8 campo -niciar #m indica o path
onde o softare contro)ador de -erso
ser iniciado ,uando rece/er as )inhas
de comando!
"#$ %D& ' Documentao e Guia do Usurio 7
CopyRight 1999 Microsiga Softare S!"!
3igura 2 4 A 'asta Controle de Verso da (anela de Prefer5n6ias do AP5
IDE
3igura ) 4 Seleo de um soft.are de 6ontrole de #erso 6om'at7#el. A
6onfirmao do dilogo 'reen68e os 6am'os de lin8as de 6omando de a6ordo
6om as sinta9es do soft.are es6ol8ido.
$inha de Comando -ara Obteno da .ltima +erso
8 campo .lima *erso indica os parRmetros passados para o Softare Contro)ador de 6erso para rea)i1ar uma
o/teno da +)tima -erso do ar,ui-o de c=digo a/erto no momento! #ode>se uti)i1ar macros para o/teno do
nome do ar,ui-o correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das macros disponG-eis no "#$
%D&!
$inha de Comando -ara %eser#ar Ar"ui#o
8 campo !eservar indica os parRmetros passados para o Softare Contro)ador de 6erso para rea)i1ar a reser-a
do ar,ui-o de c=digo fonte a/erto no momento! #ode>se uti)i1ar macros para a o/teno do nome do ar,ui-o
correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das macros disponG-eis no "#$ %D&!
*ote ,ue apesar desta )inha de comando poder ser acessada atra-2s da /arra de ferramentasC no se
de-e fugir de seu o/;eti-o Dreser-ar o ar,ui-o a/erto no ser-idor de ar,ui-osEC pois ,uando o uso de
contro)e de -erso est ha/i)itado no "#$ %D&C esta )inha de comando 2 e3ecutada automaticamente no
momento ,ue a)guma a)terao est prestes a ser efetuada em um ar,ui-o! Caso necessite e3ecutar a)go
diferenteC uti)i1e>se das ferramentas no menu 'erramenas!
$inha de Comando -ara Cancelar %eser#a
8 campo )ancelar indica os parRmetros passados para o Softare Contro)ador de 6erso para rea)i1ar o
cance)amento da +)tima reser-a efetuada pe)o usurioC do ar,ui-o de c=digo a/erto no momento! #ode>se uti)i1ar
macros para o/teno do nome do ar,ui-o correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das
macros disponG-eis no "#$ %D&!
$inha de Comando -ara Confirmar Ar"ui#o
8 campo )onfirmar indica os parRmetros passados para o Softare Contro)ador de 6erso para rea)i1ar a
confirmao do ar,ui-o de c=digo fonte a/erto no momento! #ode>se uti)i1ar macros para o/teno do nome do
ar,ui-o correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das macros disponG-eis no "#$ %D&!
$inha de Comando -ara Adicionar Ar"ui#o
8 campo Adicionar indica os parRmetros passados para o Softare Contro)ador de 6erso para adicionar o
ar,ui-o de c=digo fonte a/erto no momento no contro)e de -erso! #ode>se uti)i1ar macros para a o/teno do
nome do ar,ui-o correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das macros disponG-eis no "#$
%D&!
$inha de Comando -ara %emo#er Ar"ui#o
8 campo !emover indica os parRmetros passados para o Softare Contro)ador de 6erso para remo-er o ar,ui-o
de c=digo fonte a/erto no momento do contro)ador de -erso! #ode>se uti)i1ar macros para a o/teno do nome do
ar,ui-o correnteC pathC etc! 6e;a a (a/e)a de Macros para informa?es das macros disponG-eis no "#$ %D&!
"#$ %D& ' Documentao e Guia do Usurio 9
CopyRight 1999 Microsiga Softare S!"!
tili&ando o AP5 IDE
A Edio de Ar"ui#os
8 "#$ %D& suporta a edio de ar,ui-os no formato te3toC sendo ,ue as e3tens?es padr?es so #RFC #RS e #RG!
(odos os ar,ui-os gra-ados pe)o %D&C so gra-ados contendo como fina)i1adores de )inha os caracteres de c=digo
"SC %% 1: e 1B D.5 e CRE! "tra-2s das op?es dos menus o usurio tem um contro)e amp)o da formatao do
te3toC com faci)idades de c=pia e edio de m+)tip)os ar,ui-os como uma ap)icao MD%!
Criando e Editando Ar"ui#os
8 menu Arquivo Dfigura $E cont2m todas as op?es necessrias para a
criao e edio de ar,ui-os! " opo Novo criar um no-o ar,ui-o para
edio a/rindo>o em uma no-a ;ane)a de documento na rea de tra/a)ho
do "#$ %D&! " opo Abrir ir e3i/ir a cai3a de di)ogo de se)eo de
ar,ui-os padro do FindosC onde o usurio poder esco)her ou digitar o
nome do ar,ui-o ,ue dese;a editar! Se o usurio no digitar a e3tensoC a
e3tenso padro D!#RFE ou a e3tenso do tipo de ar,ui-o e3i/ido na cai3a
de di)ogo ser assumida na tentati-a de a/ertura do ar,ui-o! "p=s a
se)eo do ar,ui-oC o mesmo ser carregado em uma no-a ;ane)a de
documento na rea de tra/a)ho do "#$ %D&! 8 )imite para o tamanho dos
ar,ui-osC /em como para o n+mero de ar,ui-os a/ertosC 2 dependente
apenas da mem=ria disponG-e) na m,uina ,ue e3ecuta o "#$ %D&!
" gra-ao dos ar,ui-os 2 efetuada pe)os itens +alvar e +alvar )omo!
#ara um ar,ui-o no-oC a se)eo da opo +alvar ir e3i/ir a cai3a de
di)ogo de se)eo de ar,ui-os para a esco)ha do nome para gra-ao!
"p=s o ar,ui-o ter sido gra-adoC a se)eo da opo +alvar gra-ar o
ar,ui-o sem ,uestionar o usurio pe)o nome!
"o contrrioC a opo +alvar )omo sempre ,uestiona o usurio por um
nome de ar,ui-o e gra-a>o com o nome informado! "s op?es -m/rimir e
)onfi%urar -m/ressora permitem ao usurio imprimir o ar,ui-o corrente
ou uma se)eo de te3to atra-2s das impressoras definidas no Findos!
#ode>se tam/2m en-iar o ar,ui-o a/erto por e>mai) uti)i1ando a opo
#nviar via e0mail!
" opo #scol&a de 'one permite ao
usurio esco)her ,ua) a fonte grfica e ,ua) o
tamanho dos caracteres ,ue uti)i1ar para
editar seus ar,ui-os! " esco)ha de fonte no
fa1 parte da diferenciao de sinta3e! #ara
uma perfeita e3i/io dos caracteres grficos
uti)i1ados para a mo)dura de comentrios nos
ar,ui-os de c=digo>fonte criadosC e3iste um
ar,ui-o de fonte chamado .%*&DR"F!((5
DMS .ineDraE ,ue os e3i/e como so
e3i/idos em editores para am/iente D8S! 8
"#$ %D& est preparado para tentar detectar
a e3istIncia desse ar,ui-o no diret=rio de seu
e3ecut-e) e insta)>)o no am/iente do
usurio assim ,ue for iniciado!
#ara fina)i1ar a e3ecuo do "#$ %D&C o usurio pode esco)her a opo SairC uti)i1ar a com/inao de tec)as
")tK5< ou c)icar no Gcone em forma de 3 na /arra de tGtu)os da ;ane)a principa)! "o fina)i1arC o "#$ %D& gra-a
"#$ %D& ' Documentao e Guia do Usurio 1:
CopyRight 1999 Microsiga Softare S!"!
3igura 5 4 -s itens do menu "r/ui0o
3igura 0 4 Diferen6iao de Sinta9e em um ar"ui#o aberto no AP5 IDE:
utili+ando o fonte ;S <ineDra..
todas as informa?es das preferIncias /em como informa?es do am/iente do usurio Dcomo ;ane)as a/ertasC
posicionamentoC etc!E! #or2mC se o usurio esti-er com uma sesso de de/ug em progressoC o "#$ %D& ir
,uestion>)o para encerrar a sesso de de/ug antes de fina)i1ar!
#ara o en-io de um ar,ui-o -ia e>mai) o usurio de-e ter insta)ado e configurado em sua
m,uina um c)iente de e>mai) como por e3emp)o o Microsoft 8ut)ooH! 8 ar,ui-o fGsicoC
ou se;aC a c=pia gra-ada no disco ser en-iado como um TattachmentT -ia e>mai)!
#ortanto ,ua),uer a)terao efetuada no /uffer de edio ,ue no tenha sido gra-ada no
constar do TattachmentT no e>mai)!
;uito im'ortanteL Se o usurio fina)i1ar o "#$ %D& sem ,ue uma sesso de de/ug tenha sido
encerradaC o "#$ %D& ir tentar encerrar esta sesso antes de fina)i1ar en-iando ao Ser-er o comando
Derru/ar C)ient D,ue ser deta)hado mais a frente no t=pico so/re Uti)i1ao do De/ug do "#$ %D&E!
#or2mC a fina)i1ao do "#$ Remote nem sempre 2 imediata -isto ,ue o contro)e do en-io das
mensagens pode no estar com o "#$ %D& no momento da fina)i1ao! %sto pode acarretar na
fina)i1ao do "#$ %D& sem ,ue o "#$ Remote
se;a fina)i1adoC ou se;aC o processo de
e3ecuo do "#$ Remote ficar preso na mem=ria
da estao!
%ecursos de Edio
8 menu #diar Dfigura 4E cont2m todas as op?es
necessrias para a edio e formatao dos te3tos nos ar,ui-os
a/ertos! Contem os recursos de )o/iar" !ecorar e )olar
/)ocos de te3to uti)i1ando>se da rea de transferInciaC
permitindo tam/2m ,ue te3tos copiados de outros ar,ui-os
de c=digo>fonte se;am copiados para ar,ui-os a/ertos! #ossui
tam/2m os recursos de 1esfa(er e !efa(er a?esC ou se;aC as
modifica?es efetuadas no te3to podem ser desfeitas at2 o )imite
inicia) da a/ertura ou da +)tima gra-ao do ar,ui-o e refeitas
at2 o )imite do n+mero de a?es arma1enadas! 8 n+mero
de a?es ,ue o "#$ %D& pode arma1enar 2
configur-e)C como ; foi deta)hado no t=pico Configurando o "#$ %D&!
Modificaes de Texto
*o item TexoC e3istem op?es para transformar o te3to se)ecionado para caracteres mai+scu)os ou min+scu)os e
at2 mesmo uma opo para identar o ar,ui-o!
" identao modifica as ta/u)a?es do c=digo de maneira a tornar mais fci) a
-isua)i1ao do inGcio e do encerramento das estruturas de contro)e de f)u3o Dcomo -'0
#N1-'C 23-L#0#N114C etc!E! #or2m a identao no fa1 o pape) do compi)adorC
a-a)iando as e3press?es! #or esse moti-oC o "#$ %D& no 2 capa1 de identar ar,ui-os
,ue contenham a )inha de c=digo do comando -' dessa maneiraL
If(<Expresso>)
<Comando>
Endif
%sso se de-e ao fato de ,ue o comando -' seguido de um parInteses 2 confundido com a funo -'L
IF(<Expresso>,<Comando1>,<Comando2>) ,ue no 2 um indicador de inGcio de /)oco de
contro)e de f)u3oC ou se;aC no termina com um #N1-'! %sto 2 faci)mente corrigido inc)uindo>se um
caracter de espao entre o comando e o sina) de parIntesesL
If (<Expresso>)
"#$ %D& ' Documentao e Guia do Usurio 11
CopyRight 1999 Microsiga Softare S!"!
3igura 7 4 -s itens do menu (ditar
<Comando>
Endif
Se o "#$ %D& encontrar uma )inha como a descrita anteriormente simp)esmente e3i/ir uma
mensagem de erro na identaoC e3i/indo a )inha onde ta) erro foi encontradoC e cance)ar o processo
de identao! 8 usurio tam/2m pode cance)ar o processo de identao c)icando no /oto Cance)a
,ue aparece na /arra de status do "#$ %D&! &m ,ua),uer um dos casosC ,uando a identao 2
cance)adaC o c=digo no 2 a)terado!
Insero de Texto em um Arquivo
&3istem tam/2m op?es para inserir caracteres "SC %% e os comentrios padroni1ados para documentao no
c=digoC uti)i1ando a fonte configurada! (am/2m no menu #diar se encontram as op?es de na-egao no c=digo!
So as op?es para posicionamento do cursor em determinado n+mero de )inha e posicionamento do cursor na
)inha em e3ecuo Dsomente ,uando o "#$ %D& esti-er com uma sesso de de/ug a/ertaE no ar,ui-o se)ecionado!
" opo Locali(ar e3i/e a ;ane)a de )oca)i1ao de te3to!
Localizao e Substituio de Texto
U possG-e) )oca)i1ar te3tos no ar,ui-o corrente
ou rea)i1ar uma pes,uisa em mais de um
ar,ui-oC estando e)e a/erto ou no no "#$
%D&! " pasta .oca)i1ar Dfigura 7E pes,uisa por
e3press?es no ar,ui-o corrente! #ode>se
pes,uisar acima ou a/ai3o da posio do
cursor! "inda pode>se indicar se a pes,uisa
de-e considerar a coincidIncia dos caracteresC
ou se;aC encontrar e3atamente a e3presso
fornecidaC ou ignorar as diferenas entre
caracteres mai+scu)os ou min+scu)os! #ara isso
o usurio de-e marcar a cai3a )oincidir
Maisc56Minsc! #ode>se tam/2m indicar se a
e3presso de-e ser )oca)i1ada em ,ua),uer
)ugar do te3to ou somente se for uma pa)a-ra
inteira! Uma pa)a-ra inteira 2 o te3to
considerado entre dois de)imitadores!
"ssim ,ue o te3to 2 )oca)i1adoC o "#$ %D& mo-e o cursor at2 sua )oca)i1ao e marca o te3to encontradoC
fechando a ;ane)a de )oca)i1ao de te3to! #ode>se uti)i1ar a opo !e/eir Procura para continuar )oca)i1ando a
e3presso com as mesmas configura?es sem precisar a/rir a ;ane)a de )oca)i1ao no-amente!
" pasta .oca)i1ar em "r,ui-os Dfigura 9E
permite uma pes,uisa mais amp)a com todas
as op?es da )oca)i1ao deta)hada
anteriormente! #ode>se )oca)i1ar e3press?es
em ar,ui-os de um diret=rioC pode>se
)oca)i1ar e3press?es em todos os ar,ui-os
a/ertos e pode>se )oca)i1ar e3press?es em
todos os ar,ui-os do grupo de pro;etos a/erto
Da uti)i1ao de grupos de pro;etos ser
deta)hada no t=pico Criao de Grupos de
#ro;etos e Compi)ao de "r,ui-osE! #or2m
os resu)tados da pes,uisa sero e3i/idos na
@ane)a de Resu)tados da .oca)i1ao em
"r,ui-os Dfigura 1:E!
"#$ %D& ' Documentao e Guia do Usurio 1A
CopyRight 1999 Microsiga Softare S!"!
3igura ! 4 Pasta <o6ali+ar da (anela de lo6ali+ao do AP5 IDE.
3igura , 4 Pasta <o6ali+ar em Ar"ui#os da (anela de lo6ali+ao do AP5
IDE.
*esta pasta as op?es de direo so su/stituGdas pe)as op?es de )oca)i1aoC ou se;aC onde a pes,uisa de-e ser
efetuada! Se o usurio optar por pes,uisar em um diret=rioC o ,uadro de op?es Diret=rio de #es,uisa ser
ha/i)itadoC permitindo ao usurio digitar no campo Mscara de #es,uisa o diret=rio e a mscara de ar,ui-os ,ue
dese;a pes,uisar Dpor e3emp)oC CLV58*(&SVW!#RSE! " mscara padro de pes,uisa 2 W!#RX! Se o usurio dese;ar
uti)i1ar uma mscara diferente Dpor e3emp)oC pes,uisar em ar,ui-os te3to com e3tenso (S(EC de-er se)ecionar a
cai3a Usa Caracteres Curinga ,ue nesta pasta est ha/i)itada!
Se o path informado ;untamente com a mscara no for informadoC ser considerado o path atua)! Se o path for
in-)idoC no ha-er erros emitidos ao usurio! "penas nenhuma ocorrIncia da e3presso ser encontrada! Se o
usurio dese;ar pes,uisar a mesma mscara nos su/diret=riosC de-er marcar a opo #es,uisar Su/diret=rios! "
se)eo da opo Repetir #rocura no -a)e para a )oca)i1ao em ar,ui-os! Se for re,uisita a pes,uisa ser feita
como uma )oca)i1ao comum no ar,ui-o a/erto!
Durante a )oca)i1ao em ar,ui-osC uma ;ane)a de )oca)i1ao 2 e3i/ida! #ressionando>se a tec)a Y&SCZ ou
fechando>se esta ;ane)a a pes,uisa 2 interrompida! "p=s a fina)i1ao da )oca)i1ao em ar,ui-osC /asta efetuar um
dup)o c)i,ue em ,ua),uer uma das ocorrIncias encontradas para ,ue o ar,ui-o se;a editado e o cursor posicionado
na )inha da ocorrIncia! Diferentemente da )oca)i1ao simp)esC esta no tra1 o te3to se)ecionado no editor do "#$
%D&!
" opo +ubsiuir Dfigura 11E funciona
e3atamente como a )oca)i1ao simp)esC
por2m su/stituindo as e3press?es
encontradas por uma e3presso definida
pe)o usurio! (em as mesmas op?es de
pes,uisa e um campo para a digitao da
e3presso a ser su/stituGda! #ressionando
o /oto 47 o "#$ %D& ir su/stituir
apenas a primeira ocorrIncia da e3presso
encontrada!
#ara su/stituir todas as ocorrIncias o usurio de-e
pressionar o /oto Tudo! 8 "#$ %D& no perguntar
ao usurio se de-e su/stituir as e3press?es a menos
,ue a cai3a #erguntar "ntes de Su/stituir se;a
se)ecionada! *esse casoC para cada uma das
e3press?es encontradasC ser e3i/ido um di)ogo
perguntando ao usurio se dese;a su/stituir a
e3presso com os /ot?es +imC NoC )ancela e Tudo!
8 /oto +imC su/stitui a ocorrIncia e continua a
pes,uisaC o /oto No no su/stitui a ocorrIncia e
continua a pes,uisaC o /oto )ancela fina)i1a a
pes,uisa mantendo as su/stitui?es at2 ento
efetuadas e o /oto Tudo termina de su/stituir todas
as ocorrIncias sem ,uestionar o usurio!
" rotina de su/stituioC como a rotina de )oca)i1ao de e3press?esC tam/2m marca as ocorrIncias encontradas!
#or2mC para faci)itar a -isua)i1aoC o "#$ %D& tenta posicionar a cai3a de di)ogo ,ue ,uestiona o usurio so/re
a su/stituio das ocorrIncias de modo a permitir a -isua)i1ao do te3to marcado de um modo ,ue a cai3a de
"#$ %D& ' Documentao e Guia do Usurio 1B
CopyRight 1999 Microsiga Softare S!"!
3igura $% 4 =anela 6om os resultados da lo6ali+ao. *m du'lo 6li"ue abre
o ar"ui#o 'ara edio 'osi6ionando na lin8a onde a e9'resso foi
en6ontrada.
3igura $$ 4 =anela de substituio: 6om as mesmas o'es de
'es"uisa da lo6ali+ao sim'les.
di)ogo este;a tota)mente -isG-e)! Caso no se;a possG-e) posicion>)a de modo ,ue fi,ue tota)mente -isG-e) e ,ue
se;a possG-e) -isua)i1ar o te3toC a cai3a de di)ogo ser centra)i1ada!
Utilizando Boo Mars
&ste 2 recurso de edio /astante +ti) ,ue no se encontra disponG-e) atra-2s dos menus ou
/ot?es das /arras de ferramentas! Um /ooH marH 2 um ponto marcado em uma )inha ,ue
permite a rpida )oca)i1ao e posicionamento do cursorC permitindo ao usurio marcar
pontos importantes no c=digo para poder -o)tar o posicionamento do cursor no )oca)
marcado atra-2s de uma com/inao de tec)as! #ara adicionar ou remo-er um /ooH marH
em uma )inha de c=digoC o usurio de-e posicionar o cursor so/re a )inha dese;ada e uti)i1ar a
com/inao de tec)as C(R.KS[%5(KYnZC onde n 2 um n+mero de : a 9! #ode>se manter
apenas 1: /ooH marHs por ar,ui-o! #ara )oca)i1ar um /ooH marHC o usurio de-e uti)i1ar a
com/inao de tec)as C(R.KYnZ! 8s /ooH marHs e3istentes so indicados na /orda
es,uerda dos ar,ui-os atra-2s de imagens contendo o n+mero do /ooH marH Dfigura 1AE!
" )oca)i1ao simp)es e a su/stituio somente esto disponG-eis ,uando ao menos um
ar,ui-o se encontra a/erto no "#$ %D&! Caso contrrioC somente a )oca)i1ao em
ar,ui-os se encontrar disponG-e)!
(anto na ;ane)a de )oca)i1ao como na ;ane)a de su/stituioC os campos da e3presso a
)oca)i1ar e da e3presso a su/stituir so )istas Tdrop>donTC ou se;aC acumu)am as
+)timas $: e3press?es digitadas! &ssas informa?es tam/2m so gra-adas no ar,ui-o "#$%D&!%*%
,ue 2 mantido no diret=rio de insta)ao do Findos da estao!
&ru'os de Pro(etos e a Com'ilao de Ar"ui#os
Como um am/iente integradoC o "#$ %D& 2 o porta) de entrada para as
rotinas especGficas! ")2m de permitir a criao e edio dos ar,ui-os de
c=digo>fonteC 2 atra-2s do "#$ %D& ,ue tais ar,ui-os so en-iados e
compi)ados no "#$ Ser-er! #ara issoC foi criado o conceito de Grupo de
#ro;etos!
Trabalhando com /ru-os de Pro0etos
8 menu Pro8eos Dfigura 1BE e3i/e as op?es para se tra/a)har
com grupos de pro;etosC compi)ao de ar,ui-osC etc! Um grupo
de pro;etos 2 uma co)eo de pro;etos e pastas ,ue mant2m )istas
de ar,ui-os de c=digo De3tens?es W!#RXE e de defini?es
De3tenso W!C[E e tam/2m as configura?es de compi)ao! 8s
grupos de pro;etos so editados atra-2s da ;ane)a do Gerenciador
de #ro;etos Dfigura 1<E! Uti)i1ando as op?es do menu Pro8eos
pode>se criar no-os gruposC edit>)os e gra->)os! " e3tenso
padro para a gra-ao dos grupos de pro;etos 2 !#R@!
"#$ %D& ' Documentao e Guia do Usurio 1<
CopyRight 1999 Microsiga Softare S!"!
3igura $) 4 A (anela do &eren6iador de Pro(etos: 6om
di#ersos ar"ui#os de 6digo e de definies estruturados
em diferentes 'ro(etos e 'astas
3igura $2 4 - menu %ro6etos
3igura $/ 4 <in8as mar6adas 6om
>oo? ;ar?s
8 +nico meio de compi)ar um ar,ui-o de c=digo>fonte atra-2s do "#$ %D& 2 uti)i1ando um grupo de pro;etos! 8s
ar,ui-os de-em ser adicionados a pastas criadas para cada pro;eto! " di-iso dos ar,ui-os em pro;etos e pastas
organi1a o tra/a)hoC pois os ar,ui-os podem ser di-ididos de acordo com a uti)i1aoC com um tGtu)o e3p)anat=rio
em seu pro;eto ou pasta! " edio dos pro;etosC ou se;aC a criao de no-as pastasC no-os pro;etosC renomeaoC
adicionamento de ar,ui-osC edio das configura?esC etc!C 2 efetuada atra-2s do c)i,ue do /oto direito do mouse
so/re ,ua),uer rea da ;ane)a do gerenciador de pro;etos! #ode>se tam/2m editar os ar,ui-os atra-2s do dup)o
c)i,ue do mouse ou do pressionamento da tec)a Y&*(&RZ so/re um ar,ui-o na )ista!
*o menu acionado pe)o /oto direito do mouse ainda e3istem duas op?es para importao e e3portao do
Grupo de #ro;etos deNpara um ar,ui-o te3to! %sto permite ao usurio manter c=pias de segurana de grupos de
pro;etos )ongosC de modo ,ue se ocorrer a)gum pro/)ema no ar,ui-o /inrio onde os pro;etos so mantidosC as
informa?es possam ser faci)mente restauradas do ar,ui-o te3to formatado!
"dicionar um ar,ui-o em uma pasta significa adicionar o nome do ar,ui-o em uma )istaC e no
adicionar o ar,ui-o propriamente dito ao pro;eto! #ara ,ua),uer tratamento com o ar,ui-oC o "#$
%D& ir )oca)i1>)o no path gra-ado! "ssim os ar,ui-os podem ser mantidos em outros diret=rios ,ue
no o da e3ecuo do sistema! 8 Gerenciador de #ro;etos uti)i1a os seguintes Gcones de imagens para
indicar situa?es nos ar,ui-os mantidos na )istaL
Ouando o ar,ui-o for compi)ado com sucessoC o "#$ %D& indicar atra-2s deste Gcone! Ouando
o grupo de pro;etos 2 gra-adoC um f)ag de compi)ado 2 gra-ado para o ar,ui-o! %sto 2 necessrio para
e-itar a recompi)ao do ar,ui-o at2 ,ue o mesmo se;a a)terado ou ,ue o usurio acione o comando
TCompi)ar (udoT!
Ouando hou-er a)tera?es no ar,ui-oC o "#$ %D& indicar atra-2s deste Gcone! " identificao
de a)terao 2 efetuada atra-2s da data e hora do ar,ui-o ,ue 2 mantida no ar,ui-o de grupo de
pro;etos desde sua +)tima gra-ao! Desse modoC o "#$ %D& somente identificar ,ue o ar,ui-o te-e
modifica?es ,uando o mesmo for gra-ado! 8u se;aC a)tera?es efetuadas no /uffer de edio do
ar,ui-o ,ue no forem gra-adasC no sero consideradas na gra-ao! 8 "#$ %D& sempre compi)ar o
ar,ui-o encontrado no path indicado no Gerenciador de #ro;etos! Ouando o ar,ui-o 2 indicado como
modificadoC o f)ag de compi)ado Dse e3istirE ser remo-ido para indicar ,ue o ar,ui-o de-e ser
recompi)ado!
Se o ar,ui-o no for encontrado no path indicado no Gerenciador de #ro;etosC o "#$ %D&
indicar atra-2s deste Gcone! %sto pode acontecerC por e3emp)oC se o ar,ui-o for de)etado do diret=rio
sem ser remo-ido do pro;eto em ,ue se encontra!
" rea-a)iao do status dos ar,ui-os D,ue poder e3i/ir os Gcones acimaE 2 efetuada sempre ,ue
possG-e) nas principais opera?es referentes ao Gerenciador de #ro;etos! #or e3emp)oC ,uando um
ar,ui-o 2 adicionado ou remo-idoC ,uando o nome de um pro;eto ou pasta 2 modificadoC ,uando uma
pasta ou um pro;eto 2 criado ou remo-idoC ,uando um pro;eto 2 compi)adoC ,uando um ar,ui-o
contido no Gerenciador de #ro;etos 2 gra-adoC etc! Desse modoC por e3emp)o a de)eo de um ar,ui-o
no e3i/ir o Gcone de no encontrado imediatamenteC e sim ap=s a rea)i1ao da rea-a)iao do
status!
Com-ilando Ar"ui#os de C1digo2)onte
#ara a compi)aoC o "#$ %D& no poder estar em modo de de/ug! &3istem trIs op?es de compi)aoL
a compi)ao de tudoC ,ue ignora o f)ag de compi)ado nos ar,ui-osC simp)esmente en-iando no-amente todos
os ar,ui-os ao ser-er para serem compi)adosP
a compi)ao do pro;eto se)ecionadoC ,ue en-ia apenas os ar,ui-os do pro;eto se)ecionado na ;ane)a do
Gerenciador de #ro;etos ,ue no contenham o f)ag de compi)ado ao ser-erP
a compi)ao em \atchC na ,ua) o usurio pode se)ecionar ,uais os pro;etos ,ue dese;ar compi)ar com ,uais
configura?es de compi)ao!
"#$ %D& ' Documentao e Guia do Usurio 1$
CopyRight 1999 Microsiga Softare S!"!
(odas as mensagens de compi)ao geradasC como tam/2m a)gumas outras mensagens gen2ricas geradas pe)o
"#$ %D&C so en-iadas para a rea de mensagens Dfigura 1$E ,ue se encontra na /ase da ;ane)a principa) do "#$
%D&!

8 processo de compi)ao consiste em se)ecionar a configurao dese;ada no com/o de configura?es e3istente na
/arra de ferramentas do "#$ %D&C conectar>se ao ser-erC en-iar os ar,ui-os de defini?esC en-iar os ar,ui-os para
a compi)ao e encerrar a cone3o com o ser-er! Se a)gum erro ocorrer a compi)ao ser interrompida! 8 usurio
tam/2m pode interromper a compi)ao c)icando no /oto )ancelar ,ue aparece na /arra de status ;untamente
com uma /arra de percentua) conc)uGdo!
Configura3es de um /ru-o de
Pro0etos
"s configura?es so uti)i1adas para definir ,ua) o
#nvironmen ser uti)i1ado na compi)ao dos
pro;etos e na e3ecuo do "#$ Remote! Se no e3istir
ao menos uma configuraoC no ser possG-e) a
compi)ao! " @ane)a de Configura?es Dfigura 10EC
,ue pode ser acessada atra-2s do /oto direito do
mouse so/re o Gerenciador de #ro;etos ou no menu
Pro8eosC 2 uti)i1ada para a manuteno das
configura?es do grupo de pro;etos!!
8s /ot?es AdicionarC !emover e #diar
permitem ao usurio criar no-as configura?esC
a)terar informa?es ou remo-er configura?es
e3istentes! *o h )imite para a criao de
configura?es! Ouando for efetuada a
compi)aoC o "#$ %D& ir e3i/ir na rea de
mensagens a configurao ,ue estar uti)i1ando!
" configurao se)ecionada ser uti)i1ada para a
compi)ao de todo o grupo de pro;etos!
" configurao defau)t 2 a se)ecionada no
com/o e3istente na /arra de ferramentas do
"#$ %D&! U a configurao ,ue ser uti)i1ada
para a compi)ao De3ceto a compi)ao em
/atchE e para a e3ecuo do "#$ Remote!
"#$ %D& ' Documentao e Guia do Usurio 10
CopyRight 1999 Microsiga Softare S!"!
3igura $5 4 A rea de mensagens do AP5 IDE 6om uma mensagem de erro de 6om'ilao
3igura $0 4 A (anela de seleo e manuteno de
Configuraes de Com'ilao
3igura $7 4 Edio de uma 6onfigurao: onde 'ode4se identifi6ar o
re'ositrio utili+ado e e#entuais definies utili+adas no 6digo.
(odos os ar,ui-os compi)ados so registrados em um reposit=rio de programas no "#$! U atra-2s das
configura?es do Grupo de #ro;etos ,ue o "#$ Ser-er identifica ,ua) ser o reposit=rio de compi)ao e registro
dos ar,ui-os de programas D-e;a figura 14E! Criando configura?es diferentesC o usurio do "#$ pode compi)ar em
diferentes #nvironmensC ou se;aC compi)ar para diferentes idiomasC /ases de dadosC etc! 8s environmens so
se?es criadas nos ar,ui-os de configurao do "#$ Ser-er D-e;a documentao do "#$ Ser-er para maiores
deta)hesE ,ue )he permitiro no s= identificar o reposit=rio correto para arma1enar os programas compi)adosC
como para en-iar as defini?es corretas na compi)ao Dcomo por e3emp)oC a definio em )inha de comando
Nd(8# ,ue 2 en-iada ,uando um programa 2 compi)ado para (opConnectE! 8u se;aC para criar diferentes
configura?es o administrador de-e ter criado as se?es de configurao corretamente no ar,ui-o de configurao
do "#$ Ser-erC identificandoC por e3emp)oC o idiomaC a -erso e a interface! Depois de criadasC estas se?es
podem ser uti)i1adas para a compi)ao e e3ecuo do "#$ Remote atra-2s do "#$ %D& simp)esmente
identificando o nome da seo no campo #nvironmen da configurao!
(am/2m 2 atra-2s das configura?es onde o usurio pode inc)uir defini?es pr=prias ,ue identificaro /)ocos de
compi)ao condiciona) dentro do c=digo dos fontes Duso de direti-as M%5D&5 ou M%5*D&5E! (ais defini?es
de-em ser adicionadas no campo Par9meros e3atamente como seriam en-iadas na )inha de comando! &stas
defini?es sero adicionadas a,ue)as ; definidas pe)o "#$ Ser-er de acordo com o #nvironmen uti)i1ado!
8 usurio tam/2m pode uti)i1ar a Compi)ao em \atch Dfigura 17EC esco)hendo os pro;etos e as configura?es
,ue dese;a compi)ar! *esta ;ane)aC os pro;etos e as configura?es e3istentes so cru1adosC de modo ,ue um mesmo
pro;eto pode ser compi)ado uti)i1ando mais de uma configurao! "ssimC pode>se manter -ers?es dos programas
em (op Connect e em D\5 ou em %ng)Is e #ortuguIsC ; ,ue de acordo com o #nvironmen informado nas
configura?esC o "#$ Ser-er ir manter os "#8Js em reposit=rios diferentes!
*a ;ane)a de Compi)ao em \atchC o
usurio pode marcar os pro;etos e
configura?es dese;ados e c)icar no /oto
)om/ilar para compi)>)os! " diferena
entre este /oto e o /oto !ecom/ilarC 2
,ue a recompi)ao ignora o f)ag de ;
compi)ado nos ar,ui-os contidos nos
pro;etos se)ecionadosC fa1endo com ,ue
todos se;am compi)ados!
#ara a compi)aoC nenhum usurio poder estar tra/a)hando no reposit=rio configurado!
8 "#$ tentar a/rir o reposit=rio para uso e3c)usi-o e uma mensagem de erro ser
retornada caso a)gum usurio este;a tra/a)hando com o reposit=rio!
" compi)ao 2 efetuada no "#$ Ser-erC e este retornar o resu)tado da compi)ao ao
"#$ %D&! #ara a compi)aoC so necessrios os seguintes ar,ui-os D,ue so mantidos
em um diret=rio na m,uina onde o "#$ Ser-er est insta)ado! 8 diret=rio de-e ser indicado na cha-e
%*C.UD&#"([ do en-ironment definido no %*% do "#$ Ser-erEL S&(!C[C #R8(D&5!C[C
#R8([&US!C[C RFM"]&!C[C #RC8*S(!C[C S%G"F%*!C[C S(D!C[C S(DF%*!C[ e
#R(8#D&5!C[C (8#D&5!C[C (8#C8**!C[ Dse o programa for para o am/iente SO.E!
" )inguagem "D6#. foi criada seguindo o padro 3\ase para Findos uti)i1ando os recursos
criados pe)a Microsiga desde -ers?es anteriores do Siga "d-anced! Desse modoC o "#$ %D& procura
compati/i)i1ar ao m3imo todos os RdmaHes ,ue os usurios de -ers?es anteriores tenham criado!
#ara isso e3iste o "ssistente de Con-erso de C=digo ,ue ser deta)hado mais a frente! Uma dessas
mudanas importantes 2 ,ue todos os programas de usurios de-em comear com US&R 5U*C(%8*
Ynome do ar,ui-oZ Dcaso contrrio um erro de compi)ao ocorrerE! %sso se de-e por,ue o produto
"#$ %D& ' Documentao e Guia do Usurio 14
CopyRight 1999 Microsiga Softare S!"!
3igura $! 4 A (anela de Com'ilao em >at68
Siga "d-anced na -erso $!:4 2 todo criado uti)i1ando>se a )inguagem "D6#.! Como os usurios
tam/2m podero uti)i1ar>se desta )inguagem para criar suas rotinas especGficasC se todos se
uti)i1assem da c)usu)a 5U*C(%8* poderia ocorrer de a)guma no-a -erso do Siga "d-anced conter
fun?es ,ue por coincidIncia ti-essem o mesmo nome de a)guma funo criada por um usurio! %sto
ocasionaria a su/stituio das fun?es do usurio pe)as fun?es criadas pe)a Microsiga em uma
e-entua) atua)i1ao de -erso! Desse modoC 2 proi/ido ao usurio uti)i1ar>se de fun?es comuns
Dsem a c)usu)a US&RE! #ara o uso internoC a Microsiga disp?e de uma cha-e de autori1ao ,ue 2
fornecida atra-2s do menu "utori1aoC permitindo assim ,ue fun?es comuns se;am uti)i1adas!
Diferentemente do RDM"]&C a )inguagem "D6#. no 2 interpretada! U e3ecutada do mesmo modo
tanto para as rotinas criadas pe)a Microsiga como para as rotinas criadas pe)o usurio! "ssim no h
mais diferenas de -e)ocidade de e3ecuo entre os c=digos e todos os recursos da )inguagem esto
disponG-eis para os usurios!
8s ar,ui-os compi)ados so gerados com a e3tenso "#8 D"d-anced #rotheus 8/;ectE e mantidos
em um reposit=rio! &stes so ar,ui-os /inrios ,ue sero e3ecutados pe)o Ser-er! 8 "#$ Ser-er
iniciar a e3ecuo a partir de um ar,ui-o inicia)! Desse modoC no e3iste mais o conceito de m=du)oC
a e3ecuo ser efetuada a partir deste programa inicia) Dpor e3emp)o S%G"C8*C o Siga "d-anced
Cont/i)EC a/rindo os ar,ui-os e carregando as fun?es de acordo com o menu do usurio!
;uito im'ortante@ *esta -ersoC os ar,ui-os de defini?es De3tenso C[E ,ue forem adicionados no
Gerenciador de #ro;etos ainda no esto sendo en-iados ao ser-idor e de-em ser co)ocados em um
diret=rio no ser-idor ,ue este;a indicado na cha-e %*C.UD&#"([ do &n-ironment definido no %*%
do "#$ Ser-er!
"#$ %D& ' Documentao e Guia do Usurio 17
CopyRight 1999 Microsiga Softare S!"!
*tili+ando o Debugger do AP5 IDE
")2m de um editor de c=digoC o "#$ %D& 2 uma ferramenta de De/ug! 8u se;aC permite ao usurio e3ecutar passo>
a>passo suas rotinas para encontrar e remo-er erros de )=gica! Como em outras ferramentas de De/ugC no "#$
%D& o usurio encontra ;ane)as de FatchC ;ane)as de informa?es com o conte+do de -ari-eisC pi)ha de chamadasC
/reaH points e3istentesC etc! & com todos esses recursosC fica muito mais fci) ao usurio depurar seus c=digosC
inc)usi-e em pontos de entrada do sistema Siga "d-anced $!:4! " e3ecuo do "#$ Remote 2 a mesmaC e3ceto
pe)o fato de ,ue 2 efetuada atra-2s do "#$ %D&! Ouando o "#$ Remote 2 e3ecutadoC uma cone3o 2 a/erta
atra-2s do %D&C sendo encerrada somente ,uando a e3ecuo do "#$ Remote 2 terminada Datra-2s do pr=prio "#$
RemoteC ou forada dentro do %D&E!
Os Comandos de Debug
8 menu #xecuar Dfigura 19EC contem todos os comandos uti)i1ados para de/ugar rotinas no "#$ %D&! &ste
comando e3ecuta o "#$ RemoteC inicia)mente pe)o programa inicia) ou ,uando em processo de de/ugC a partir do
ponto atua)! " e3ecuo 2 norma) como se a rotina esti-esse sendo e3ecutada diretamente Dsem o Siga "d-anced
#rotheus %D&E! 8 processamento poder parar ,uando um /reaH
point for encontrado ou ,uando o usurio interrompI>)o!
8 programa inicia) de-e ser informado no com/o de se)eo
e3istente na /arra de ferramentas do "#$ %D&C como e3i/ido na
figura A:! Se por acaso o programa inicia) no for informadoC o "#$
Remote ,uestionar o usurio pe)o nome do programa inicia) ,uando
for e3ecutado!
Gera)mente o processo de de/ug consiste em adicionar um /reaH
point a rotina dese;adaC e3ecutar o "#$ Remote atra-2s do "#$ %D&
e e3ecutar o sistema at2 o momento em ,ue o /reaH point se;a
encontrado! &ntoC o usurio uti)i1a>se dos comandos de e3ecuo
passo>a>passo para acompanhar a e3ecuo da rotina criada! #ode>se
tam/2m e3ecutar o "#$ Remote e acionar o comando Pausa ,uando
a e3ecuo chegar na rotina dese;ada! " e3ecuo do comando
Pausa tam/2m pode ser efetuada atra-2s da com/inao de tec)as
".(KD efetuada no "#$ Remote em e3ecuo!
#ara a e3ecuo passo>a>passoC o "#$ )oca)i1a os ar,ui-os de c=digo fonte e posiciona o cursor na )inha em
e3ecuo de modo ,ue o usurio possa acompanhar a e3ecuo de suas rotinas! #ara isso de-e>se uti)i1ar os
comandos Percorre Lin&aC Pula Lin&aC #xecuar a$ o cursor ou os comandos de animao! 8 comando Percorre
Lin&a e3ecuta )inha por )inha do c=digoC entrando nas chamadas de fun?es! 8u se;aC a e3ecuo deste comando
so/re uma )inha ,ue contenha uma chamada
de funo far com ,ue o processo de de/ug
)inha>a>)inha continue no c=digo da funo e
o usurio ter ,ue percorrer todo o c=digo da
mesma para retornar ao ponto origina)! "o
contrrioC a e3ecuo do comando Pula
Lin&a em uma )inha ,ue contenha uma
chamada de funoC far com ,ue o c=digo
da funo se;a e3ecutado norma)mente Dsem
,ue o c=digo da funo se;a e3ecutado )inha>
a>)inhaE e o processo de de/ug continuar da
)inha seguinte!
"#$ %D& ' Documentao e Guia do Usurio 19
CopyRight 1999 Microsiga Softare S!"!
3igura $, 4 - menu E9e6utar: 6om as
o'es 'ara debug de rotinas.
3igura /% 4 Combo 'ara es6ol8a do 'rograma ini6ial. Pode4se
es6ol8er um dos mdulos do Siga Ad#an6ed ou digitar o nome
do 'rograma ini6ial dese(ado.
#ara ,ue o processo de de/ug se;a efetuadoC o "#$ %D& precisar )oca)i1ar os ar,ui-os onde as )inhas e3ecutadas
se encontramC a/ri>)os para o usurio e posicionar o cursor nas )inhas corretas! #or issoC o usurio de-e configurar
corretamente os diret=rios de )oca)i1ao de ar,ui-os Dcomo -isto em Configurando o "#$ %D&E! Se um ar,ui-o
no for )oca)i1adoC o "#$ %D& ,uestionar o usurio por sua )oca)i1ao a menos ,ue tenha sido configurado para
,ue os ar,ui-os no encontrados se;am ignorados! 8s ar,ui-os no encontrados tero seu c=digo e3ecutado
norma)mente at2 ,ue uma )inha -)ida se;a encontrada ou ,ue a rotina termine!
8 comando PausaC fa1 com ,ue o processamento ,ue este;a e3ecutando norma)mente Dap=s o comando #xecuarE
entre em modo de de/ugC permitindo a continuao em passo>a>passo! 8 comando Pra #xecuoC fina)i1a a
e3ecuo do "#$ RemoteC encerrando>o! 8 "#$ Remote 2 )itera)mente derru/ado e a cone3o com o Ser-er 2
encerrada! #ode ser uti)i1adoC por e3emp)oC ,uando determinada rotina est em )oop de e3ecuo!
" animao 2 uma ferramenta ,ue permite ao usurio e3ecutar )inha>a>)inha do c=digo de uma forma
automati1adaC sem necessitar acionar o comando Percorre Lin&a para todas as )inhas do c=digo! "o acionar o
comando "nimaoC o "#$ %D& iniciar a e3ecuo automtica do comando Percorre Lin&a a uma -e)ocidade
inicia)! (odas as informa?es so atua)i1adas e o usurio pode acompanhar o processamentoC aumentar ou
diminuir a -e)ocidade ou parar a animao!
8 usurio tam/2m pode adicionar /reaH points Dpontos de paradaE ao c=digo! 8s pontos de parada indicam )inhas
do c=digo ,ue faro com ,ue o "#$ %D& entre em modo de de/ug e3atamente como se o comando Percorrer
Lin&a ti-esse sido acionadoC assim ,ue a e3ecuo do c=digo no "#$ Remote atingir a )inha marcada! 8
acionamento do comando Li%a61esli%a Pono de ParadaC marca ou desmarca a )inha onde o cursor est
posicionado no ar,ui-o corrente! #or comodidadeC os pontos de parada so gra-ados pe)o "#$ %D& ,uando este 2
encerradoC de modo ,ue no 2 necessrio remarc>)os na pr=3ima e3ecuo! #ode>se definir condi?es para a
parada em um /reaH pointC por2m a definio destas condi?es e outros deta)hes sero e3p)icados mais a frente na
seo ,ue trata so/re a ;ane)a de e3i/io dos /reaH points e3istentes!
#or fimC o comando Auali(aC fora uma atua)i1ao de todas as ;ane)as de informa?es do "#$ %D&! (odas as
e3press?es ou -ari-eis so rea-a)iadas no "#$ Ser-er!
" e3ecuo dos comandos de de/ug 2 efetuada atra-2s da troca de mensagens entre o "#$
%D& e o "#$ Ser-er! #ortantoC ,uando o "#$ Remote esti-er sendo e3ecutado De
conse,^entemente o contro)e da e3ecuo est com o Ser-erC no com o %D&EC a e3ecuo
de um comandoC por e3emp)o o comando Para #xecuoC pode no ser efetuada
instantaneamenteC aguardando ,ue a)guma )inha do c=digo do "#$ Remote se;a processada!
8u se;aC se o "#$ Remote esti-er parado Dpor e3emp)oC aguardando uma inter-eno do
usurio para digitar um te3to ,ua),uer ou pressionar um /otoE o comando no ser e3ecutado at2 ,ue
a)gum processamento se;a efetuado Dpor e3emp)oC ,uando o usurio c)icar no /oto ou a -a)idao de
uma cai3a de edio for acionadaE!
&n,uanto o "#$ %D& est em processo de de/ugC o usurio pode o/ter o -a)or de -ari-eis
simp)esmente passando o ponteiro do mouse so/re o nome da -ari-e) dese;ada! Se o conte+do da
-ari-e) for diferente de nu)o ou espaos em /ranco e)e ser e3i/ido em um hint a/ai3o da )inha onde a
pa)a-ra se encontra! #ara a-a)iar e3press?esC o usurio pode se)ecionar o te3to de toda a e3presso e
mo-er o ponteiro do mouse so/re a e3presso se)ecionada! #ode>se tam/2m sa/er em ,ue ar,ui-o uma
funo se encontra uti)i1ando o mesmo recursoC contanto ,ue o mapa de o/;etos D,ue ser deta)hado
mais a frenteE ; tenha sido o/tido! &ste recurso de-e ser uti)i1ado com caute)aC pois se um comando for
se)ecionado e o ponteiro do mouse passado so/re a se)eoC ta) comando ser e3ecutado e pode
inf)uenciar no processo de de/ug!
Durante o processo de de/ugC o "#$ %D& indicar atra-2s de imagens na /orda es,uerda dos ar,ui-os
a)gumas informa?es! So uti)i1ados os seguintes sGm/o)osL
%ndica um /reaH point na )inha onde a imagem se encontraP
%ndica o ponto de e3ecuoC ou se;aC a )inha do ar,ui-o corrente 2 a )inha em e3ecuo
no processo de de/ug! &ste mesmo sGm/o)o na cor cin1a indica pontos por onde a
e3ecuo passou em outros ar,ui-osC ,uando o processo de de/ug entra nas chamadas
"#$ %D& ' Documentao e Guia do Usurio A:
CopyRight 1999 Microsiga Softare S!"!
de fun?es!
As 4anelas de Ins-eo do AP5 IDE
8 "#$ %D& cont2m di-ersas ;ane)as para inspeo
do am/iente de e3ecuo durante o processo de
de/ug! "ssimC o usurio pode acompanhar o -a)or
de -ari-eisC -erificar os /reaH points e3istentesC a
pi)ha de chamada das fun?esC etc! &stas ;ane)as
podem ser acessadas atra-2s do menu *isuali(ar
DfiguraA1E!
A !anela de Brea "oints
" ;ane)a de \reaH #oints Dfigura AAE
e3i/e todos os /reaH points
adicionados ao c=digo! *esta ;ane)a
so e3i/idos o nome do ar,ui-oC a
)inha onde o /reaH point se encontra
e a condio de e3ecuo! So trIs
os tipos de /reaH points e3istentes!
8 /reaH point comum cont2m
apenas o nome do ar,ui-o e a )inha
onde de-e parar o processamento e
pode ser adicionado atra-2s do
comando Li%a61esli%a Pono de
Parada do "#$ %D&C
ou atra-2s do menu acionado pe)o /oto
direito do mouse so/re a ;ane)a de \reaH
#oints! &ste tipo de /reaH point pode tam/2m ter uma condio de parada! %sto significa ,ue o processamento
somente ir parar neste ponto se a condio informada for satisfeita! #ara informar uma condioC o usurio de-e
primeiro adicionar um /reaH point e depois edit>)o atra-2s do menu acionado pe)o /oto direito do mouse! &3iste
tam/2m um /reaH point chamado de /reaH point condiciona)! &)e no cont2m nome de ar,ui-o ou )inhaC pois a
parada 2 efetuada na primeira )inha de c=digo onde a condio informada se;a satisfeita! &ste tipo de /reaH point
somente pode ser adicionado atra-2s do menu
acionado pe)o /oto direito do mouse na opo
Adicionar Dfigura ABE! *ote ,ue os /reaH points
adicionados a uma )inha de c=digoC pararo
somente ,uando a )inha for encontradaC sendo
,ue o processamento poder seguir
norma)mente nas )inhas seguintes! "o contrrioC
um /reaH point condiciona) far com ,ue o
processamento pre Dou se;aC entre em modo de
de/ugE en,uanto a condio for satisfeita!
#ortanto poder ser necessrio remo-er um
/reaH point condiciona) depois ,ue a condio
for atingida pe)a primeira -e1C para poder
continuar com o processamento norma)mente!
"#$ %D& ' Documentao e Guia do Usurio A1
CopyRight 1999 Microsiga Softare S!"!
3igura /$ 4 - menu -isua*i+ar 6om os 6omandos 'ara
e9ibio das (anelas de ins'eo.
3igura // 4 A (anela de >rea? Points 6om o menu a6ionado 'elo
'ressionamento do boto direito do mouse.
3igura /2 4 Adi6ionando um brea? 'oint 6ondi6ional
A #anela de "il$a de %$amadas
" ;ane)a de #i)ha de Chamadas Dfigura A<E cont2m informa?es so/re a se,^Incia de chamadas das fun?es
e3ecutadas pe)a rotina em processo de de/ug no "#$ %D&! &m ordem descendente de acordo com as chamadas
e3ecutadasC a )ista cont2m o n+mero da )inhaC o nome da funoC os parRmetros rece/idos e o nome do programa
onde a funo se encontra registrada no Ser-er!
")gumas chamadasC como de Code \)ocHs ou chamadas internas do Ser-erC no e3i/em o nome do programa! Se
um dup)o c)i,ue for efetuado so/re um item da )istaC o "#$ %D& ir )oca)i1ar o ar,ui-o e posicionar o cursor na
)inha da chamadaC reca)cu)ando as demais ;ane)as de inspeo de acordo com a funoC como ser -isto mais a
frente no t=pico so/re as ;ane)as de
inspeo de -ari-eis! " )oca)i1ao dos
ar,ui-os depende tam/2m das preferIncias
configuradas pe)o usurioC como -isto no
capGtu)o Configurando o "#$ %D&! "s
informa?es da ;ane)a de #i)ha de
Chamadas somente esto disponG-eis
durante o processo de de/ug do "#$ %D&!
A !anela de &atc$s
" ;ane)a de Fatchs Dfigura A$E 2 um )oca) onde o usurio pode
adicionar e3press?es para serem a-a)iadas durante o processo de
de/ug! #ode>se adicionarC remo-er ou editar as e3press?es atra-2s do
menu acionado pe)o /oto direito do mouse so/re a ;ane)a de Fatchs!
Como todas as e3press?es so a-a)iadas no Ser-er no momento em
,ue so adicionadas e durante o processo de de/ugC ,uando no se
esti-er em processo de de/ug s= ser possG-e) a e3c)uso de
e3press?es! #or comodidadeC as e3press?es adicionadas so gra-adas
,uando o "#$ %D& 2 encerrado!
So trIs as co)unas de informa?es e3i/idas na ;ane)a de Fatchs! "
co)una #x/resso cont2m a e3presso adicionada e as co)unas Ti/o e
!esulado cont2m respecti-amente o tipo de dado e o resu)tado
referentes Q a-a)iao da e3presso efetuada no Ser-er!
"s e3press?es de tipo 4b8eo e Arra: podem ter seu conte+do
e3i/ido atra-2s da e3pansoC efetuada pe)o dup)o c)i,ue so/re a
e3presso ou o c)i,ue no sina) de e3panso DKE no canto es,uerdo da
mesma Dfigura A0E! Durante o processo de de/ugC o usurio tam/2m
pode se)ecionar o te3to no ar,ui-o de c=digo eC atra-2s do /oto
direito do mouseC arrast>)o para a ;ane)a de FatchsC adicionando
automaticamente o te3to para a-a)iao!
Seme)hante Q uti)i1ao da ;ane)a de FatchC o usurio conta tam/2m com a rea de comandos do "#$ %D& Dfigura
A4E! *a rea de comandos o usurio pode digitar e3press?es Dcomo por e3emp)oC nome de -ari-eisC comandosC
etc!E ,ue ao se pressionar a tec)a Y&*(&RZ sero a-a)iadas no Ser-er e o resu)tado ser apresentado na )inha
seguinte! #ode>se tam/2m arrastar uma e3presso de um ar,ui-o a/erto para a rea de comandos do mesmo modo
,ue na ;ane)a de Fatchs!
"#$ %D& ' Documentao e Guia do Usurio AA
CopyRight 1999 Microsiga Softare S!"!
3igura /) 4 A (anela de Pil8a de C8amadas ACall Sta6?B
3igura /5 4 A (anela de Cat68s 6om duas
e9'resses adi6ionadas.
3igura /0 4 A (anela de Cat68s 6om uma
e9'resso Aresultante em ob(etoB e9'andida.
"s e3press?es informadas tanto na ;ane)a de Fatchs como na rea de comandos do "#$ %D& so
a-a)iadas no Ser-er! #ortantoC o uso de comandos 2 permitido e pode inf)uenciar na e3ecuo dos
programas Dpor e3emp)oC a digitao do comando S]%# mo-er o ponteiro na ta/e)a ati-aE! #or2mC uma
e3presso digitada na rea de comandos somente 2 a-a)iada uma -e1 D,uando o usurio pressiona a
tec)a Y&*(&RZE ao contrrio do ,ue ocorre na ;ane)a de FatchsC onde a e3presso 2 a-a)iada a cada
passo do processo de de/ug D,uando as informa?es so atua)i1adasE! #ortanto de-e>se e-itar uti)i1ar
comandos como parte de uma e3presso de Fatch!
Im'ortanteL Cuidado na a-a)iao de e3press?es )=gicas! 8 operador de igua)dade simp)es D_E tam/2m
2 um operador de atri/uio! #ortantoC e3ecutar lLef ; 5T5 atri/uir o -a)or -erdadeiro D!(!E Q -ari-e)
lLef! "o in-2s dissoC o usurio ,ue dese;ar a-a)iar uma e3presso )=gicaC de-er uti)i1ar o operador de
e3atido D__E ou uti)i1ar parInteses para en-o)-er toda a e3presso! #or e3emp)oC <lLef ; 5T5=!
As !anelas de Ins'eo de (ari)veis
#ara inspecionar o -a)or de -ari-eisC o "#$ %D& disp?e de ;ane)as diferentes para cada um dos ,uatro tipos de
-ari-eisL .ocaisC #ri-adasC #+/)icas e &stticas! "s ;ane)as de %nspeo de 6ari-eis Dfigura A7E tIm as seguintes
co)unas de informaoL *arivelC Ti/o e )onedo! Como a ;ane)a de FatchsC as -ari-eis dos tipos 8/;eto e
"rray podem ser e3pandidas e3i/indo seu conte+do!
*o se pode adicionar ou remo-er -ari-eis atra-2s das
;ane)as de %nspeoC por2m pode>se editar o conte+do das
-ari-eis ou dos e)ementos de um "rray ou 8/;etoC
atra-2s do menu de op?es acionado com o /oto direito
do mouse ,uando o cursor esti-er so/re a -ari-e)
dese;ada!
"s ;ane)as de %nspeo de 6ari-eis somente tero
conte+do e3i/ido en,uanto o "#$ %D& esti-er em
processo de De/ug!
A !anela de Ins'eo de Tabelas e
%am'os
Como as ;ane)as de %nspeo de 6ari-eisC o
"#$ %D& mant2m uma ;ane)a de %nspeo de
(a/e)as de Dados Dfigura A9E! *esta ;ane)a
"#$ %D& ' Documentao e Guia do Usurio AB
CopyRight 1999 Microsiga Softare S!"!
3igura /7 4 Drea de Comandos na 'arte inferior da (anela do AP5 IDE
3igura /! 4 =anela de #ari#eis 'ri#adas 4 uma das
(anelas de Ins'eo de Vari#eis.
so e3i/idos todos os ar,ui-os a/ertos at2 o momento do processo de de/ug! Cada ar,ui-o pode ser e3pandidoC
e3i/indo assim seus Gndices e todos os campos do registro do ar,ui-o onde se encontra o ponteiro! So trIs as
co)unas de informa?es e3i/idasL 4b8eoC Ti/o e )onedo! *a co)una )onedoC so e3i/idas as informa?es de
acordo com o tipo de o/;eto e3i/ido!
#ara as ta/e)asC so e3i/idos o ")iasC o fi)tro uti)i1adoC o n+mero do registro onde o ponteiro est posicionado
DRecnoEC o n+mero tota) de registros e a ordem do Gndice ati-o! " ta/e)a ,ue 2 a rea atua)mente se)ecionada na
e3ecuo Do retorno da funo Alias< = E 2 indicada com dois asteriscos DWWE!
#ara os GndicesC 2 e3i/ida a cha-e de inde3ao Do retorno da funo -ndex7e:< = E e o Gndice ati-o 2 marcado com
dois asteriscos DWWE!
#ara os camposC 2 e3i/ido o seu conte+do para o registro posicionado pe)o cursorC e3atamente como as -ari-eis
nas outras ;ane)as de inspeo!
8s itens da ;ane)a de Fatchs e as -ari-eis das ;ane)as de %nspeo de 6ari-eis .ocais e
&stticas so e3i/idos de acordo com a #i)ha de Chamadas! Se um dup)o c)i,ue for
efetuado so/re uma funo na pi)ha de chamadasC as ;ane)as sero atua)i1adas com a
situao das e3press?es e -ari-eis no momento da e3ecuo da,ue)a funo! %sto
permite ao usurio -erificar as mudanas ocorridas em -ari-eis em todos os momentos
de e3ecuo das suas rotinas! *o entantoC ,uando um passo de de/ug 2 efetuado Dpor
e3emp)oC com o comando Percorrer Lin&aEC as informa?es so rea-a)iadas para a situao atua)C ou
se;aC a +)tima chamada de funo efetuada Dprimeiro item na )ista da #i)ha de ChamadasE!
&m todas as ;ane)as de %nspeoC se;a FatchsC (a/e)as ou 6ari-eisC e3iste uma /arra de ro)agem na
/ase ,ue permite ao usurio -isua)i1ar todo o te3to da co)una )onedo Dou !esulado no caso da
;ane)a de FatchsE Tro)andoT o te3to ,ue se;a maior do ,ue o tamanho e3i/ido da ;ane)a!
#ara faci)itar a -isua)i1aoC as ;ane)as de inspeo se uti)i1am de imagens ,ue indicam o tipo de dado
-isua)i1ado! &ssas imagens Dcu;a )egenda tam/2m pode ser -isua)i1ada atra-2s do acionamento do
/oto direito do mouse so/re cada ;ane)aE soL
%ndicador de -ari-e) do tipo CaracterC *um2ricoC Data ou Memo
%ndicador de -ari-e) do tipo .=gico com -a)or 5a)so
%ndicador de -ari-e) do tipo .=gico com -a)or 6erdadeiro
%ndicador de -ari-e) do tipo "rray
%ndicador de -ari-e) do tipo 8/;eto
%ndicador de (a/e)a de Dados
%ndicador de `ndice
%ndicador de Campo
* Ins'etor de *b#etos
8 %nspetor de 8/;etos Dfigura
B:E e3i/e todas as fun?es
registradas no Ser-er! 8 usurio
no precisa estar em processo de
de/ug para o/ter do Ser-er o
mapa de o/;etos! "o acionar a
-isua)i1ao atra-2s do item
-ns/eor de 4b8eos no menu
*isuali(ar ou ao acionar a opo
Auali(ar no menu acionado
pe)o /oto direito do mouseC o
"#$ %D& ' Documentao e Guia do Usurio A<
CopyRight 1999 Microsiga Softare S!"!
3igura /, 4 =anela de Ins'eo de Eabelas de Dados
3igura 2% 4 A (anela do Ins'etor de -b(etos
%nspetor de 8/;etos ir conectar>se ao Ser-er e o/ter o mapa de o/;etos! 8 usurio pode optar por e3i/ir o mapa
em duas ordens diferentesL Por Pro%rama e Por 'uno!
&3i/indo Por Pro%ramaC as fun?es registradas sero agrupadas pe)o nome do programa na ,ua) foi criada ao ser
registrada no Ser-er! Caso contrrioC uma )ista de fun?es sem agrupamento ser e3i/ida! "o e3ecutar um dup)o
c)i,ue so/re o nome de uma funo Dou e3ecutar o comando Abrir no menu acionado pe)o /oto direito do
mouseEC o "#$ %D& tentar a/rir o ar,ui-o e posicionar o cursor na )inha onde a funo se encontra! #ode>se
tam/2m )oca)i1ar fun?es dentro do mapaC se)ecionando a opo Locali(ar 'uno no menu acionado pe)o /oto
direito do mouse! Se a funo for )oca)i1adaC o cursor ser posicionado so/re o n= da mesma na r-ore montada no
mapa de o/;etos!
8s o/;etos so os "#8Js D"d-anced #rotheus 8/;ectE registrados em reposit=rios no Ser-er! So todas as rotinas e
fun?es compi)adas e registradas! Desse modoC ao o/ter o mapa de o/;etosC ser necessrio indicar uma das
configura?es e3istentes no Gerenciador de #ro;etosC como -isto na compi)ao ou na e3ecuo do "#$ Remote
atra-2s do "#$ %D&! Do mesmo modoC se nenhuma configurao for criadaC o "#$ %D& ir considerar ,ue os
o/;etos de-em ser
o/tidos do
reposit=rio oficia)!
Se no for possG-e) conectar>se ao Ser-er para a o/teno do mapa de o/;etosC o "#$
%D& no e3i/ir a ;ane)a do %nspetor de 8/;etos! Sempre ,ue um ar,ui-o 2 compi)adoC
podem ha-er mudanas nos o/;etos registrados no Ser-er! " atua)i1ao do mapa de
o/;etos no 2 efetuada automaticamenteC ficando a cargo da necessidade do usurio!
#ara faci)itar a -isua)i1aoC o Mapa de 8/;etos conta com a seguinte )ista de imagens
indicadoras dos o/;etosL
%ndicador de "r,ui-o
%ndicador de 5uno
%ndicador de impossi/i)idade para o "#$ de a/rir o ar,ui-o Dar,ui-o no encontradoE
Como outros processamentos ,ue re,uerem cone3o ao Ser-er Dpor e3emp)oC a compi)ao ;
deta)hada anteriormenteEC durante a o/teno do mapa de o/;etosC o "#$ %D& e3i/e uma /arra de
percentua) de conc)uso acompanhada de um /oto para o cance)amento no )ugar da /arra de tatus de
sua ;ane)a principa) Dfigura B1E! 8 usurio pode cance)ar a o/teno do mapa de o/;etos c)icando no
/oto Cance)ar desta /arra!
"#$ %D& ' Documentao e Guia do Usurio A$
CopyRight 1999 Microsiga Softare S!"!
3igura 2$ 4 >arra de 'rogresso de 'ro6essamentos do AP5 IDE 6om o boto 'ara
6an6elamento.
Controlando +ers3es de Ar"ui#os Atra#'s do AP5 IDE
-s Soft.ares 'ara Controle de Verses de Ar"ui#os
8 "#$ %D& pode ser integrado a um softare para gerenciamento de -ers?es de ar,ui-os de c=digoC permitindo ao
usurio efetuar a reser-aC a confirmaoC a o/teno de +)timas -ers?es de ar,ui-osC etc!C diretamente de dentro do
am/iente de desen-o)-imento! 8s softares de contro)e de -erso tra/a)ham com uma /ase de dados dos ar,ui-os
,ue 2 mantida em um ser-idor especGfico e os usurios atra-2s de uma ap)icao c)ient deste softare o/t2m
c=pias )ocais dos ar,ui-os para poder a)ter>)osC test>)os e ento en-iar as c=pias com as no-as imp)ementa?es
para su/stituir as c=pias e3istentes na /ase de dados do ser-idor! U c)aro ,ue apenas um usurio pode a)terar um
ar,ui-o por -e1 e por isso o ar,ui-o de-e ser reser-ado antes de poder ser a)terado! #ara e-itar confus?es entre as
c=pias )ocais e as c=pias mantidas no ser-idorC os softares de contro)e de -erso gera)mente tra/a)ham atri/uindo
o atri/uto de somente )eitura D!ead 4nl:E aos ar,ui-os )ocaisC de modo ,ue o usurio no os poder a)terar a no
ser ,ue uma reser-a se;a efetuada antes! &ste 2 o mesmo conceito uti)i1ado pe)o "#$ %D& para permitir a a)terao
ou efetuar a reser-a automtica de um ar,ui-o!
- Controle de Verses Atra#1s do AP5 IDE
Como -isto no capGtu)o Configurando o "#$ %D&C o primeiro passo para a uti)i1ao do Contro)e de 6erso
%ntegrado 2 a configurao das )inhas de comando para e3ecuo das a?es do softare contro)ador de -erso! "
e3ecuo destas a?es so efetuadas atra-2s da e3ecuo de macros no "#$ %D& ,ue en-iam as )inhas de
comando configuradas ao softare contro)ador de -erso! "s macros uti)i1adas para o contro)e de -erso soL
>*#!+-4N?)3#)7?4UTC >*#!+-4N?)3#)7?-NC >*#!+-4N?@#T?LA+TC >*#!+-4N?A11?'-L#C
>*#!+-4N?!#M4*#?'-L#C >*#!+-4N?UN14?)3#)7?4UTC >*#!+-4N?A+7?'4!?)4MM#NT e
>+A+T#M?U+#!?A))#++! #ara maiores deta)hes so/re as macros e3istentes no "#$ %D&C -erifi,ue a (a/e)a de
Macros ao fina) desta documentao!
A %eser#a Autom5tica de um Ar"ui#o
Ouando o "#$ %D& est configurado para uti)i1ar o contro)e de -ersoC o usurio ser ,uestionado so/re a reser-a
assim ,ue ocorrer a primeira tentati-a de a)terao em um ar,ui-o com o atri/uto de somente )eitura! Se optar por
reser->)oC o "#$ %D& ir ento e3ecutar a macro para reser-a de ar,ui-o Da6&RS%8*bC[&C]b8U(E! Se o
usurio optar por no reser->)oC o atri/uto de somente )eitura permanecer na c=pia )oca) do ar,ui-o e
conse,^entemente o "#$ %D& no permitir ,ue ne)e se;am efetuadas a)tera?es!
E(ecutando Outras 6acros de Controle de +erso
"s macros de contro)e de -erso tam/2m podem ser e3ecutadas atra-2s da /arra de ferramentas de contro)e de
-erso Dfigura BAE ,ue 2 e3i/ida automaticamente ,uando o uso de contro)e de -erso 2 ha/i)itado nas
configura?es de preferIncias do "#$ %D&!
"tra-2s do am/iente do "#$ %D&C o usurio podeL
8/ter a +)tima -erso de um ar,ui-oC ou se;aC o softare de contro)e de
-erso gra-ar no diret=rio onde o ar,ui-o se encontra uma c=pia )oca)
com a +)tima -erso mantida em sua /ase de dados e nesta c=pia )oca)
co)ocar o atri/uto de somente )eituraP
Reser-ar um ar,ui-oC o ,ue tam/2m far com ,ue a +)tima -erso se;a
tra1ida para a c=pia )oca)C por2m o atri/uto de somente )eitura ser
remo-ido permitindo ,ue o usurio efetue as a)tera?es necessriasP
Confirmar as a)tera?es em um ar,ui-o reser-adoC ou se;aC a c=pia )oca) ser en-iada ao ser-er e o ar,ui-o
no mais ficar reser-ado para o usurio! Conse,^entementeC o atri/uto de somente )eitura ser atri/uGdo
no-amente Q copia )oca)P
"#$ %D& ' Documentao e Guia do Usurio A0
CopyRight 1999 Microsiga Softare S!"!
3igura 2/ 4 A barra de
ferramentas 'ara e9e6uo das
ma6ros de 6ontrole de #erso.
Desfa1er uma reser-a efetuadaC o ,ue far com ,ue a reser-a na /ase de dados do softare contro)ador de
-erso se;a desfeita e o atri/uto de somente )eitura se;a atri/uGdo no-amente ao ar,ui-oP
"dicionar ou remo-er ar,ui-os da /ase de dadosC ou se;aC atra-2s do "#$ %D& o usurio pode adicionar
ar,ui-os para ,ue tenha a -erso contro)ada pe)o softare contro)ador de -erso ou remo-er um ar,ui-o para
,ue no mais tenha sua -erso contro)ada por ta) softare!
*as )inhas de comando para o contro)e de -ersoC por defau)t so adicionadasC ,uando o usurio as configuraC as
macros especiais >*#!+-4N?A+7?'4!?)4MM#NT e >+A+T#M?U+#!?A))#++C ,ue respecti-amente o/t2m
do usurio o comentrio e o nome do usurio e senha para
as opera?es a serem efetuadas no ser-idor de -ers?es
Dfigura BBE! Dependendo do modo ,ue o softare de
contro)e de -erso uti)i1ado tra/a)haC o usurio pode
customi1ar estas )inhas de comando e at2 remo-er a
e3ecuo destas macros!

8 respons-e) pe)a remoo ou atri/uio do atri/uto de somente )eitura 2 o softare contro)ador de
-erso! #ortantoC ap=s a e3ecuo da macro para reser-a do ar,ui-oC o "#$ %D& ir esperar ,ue o
atri/uto de somente )eitura se;a remo-ido do ar,ui-o! Caso este atri/uto no se;a remo-ido dentro de
um inter-a)o de tempo de cinco segundos Dpor e3emp)oC se a reser-a do ar,ui-o ainda no te-e tempo
de ser efetuada pe)o softare contro)ador de -erso ou mesmo se a e3ecuo da )inha de comando
fa)hou ou no foi possG-e) reser-ar o ar,ui-o pois o mesmo est reser-ado para outro usurioE ser
e3i/ida uma mensagem ,uestionando o usurio se o %D& de-e aguardar mais cinco segundos pe)o
t2rmino da reser-a do ar,ui-o! Se o usurio no permitir ,ue o %D& aguarde mais cinco segundos e o
ar,ui-o permanecer com o atri/uto de somente )eitura o ar,ui-o ser fechado por segurana
Dgarantindo ,ue uma e-entua) c=pia )oca) o/tida do ser-idor cu;o processo de reser-a terminou
posteriormente no se;a so/rescrita por uma -erso com informa?es incorretas ,ue poderia estar
sendo mantida a/erta no %D&E!
"p=s a e3ecuo de macros como a de reser-a de ar,ui-o ou a de o/teno da +)tima -erso ,ue tem
a)tera?es efetuadas pe)o softare contro)ador de -erso na c=pia )oca) do ar,ui-oC o "#$ %D& ir
rea/rir o ar,ui-o para carregar as e-entuais diferenas! #ortantoC antes da e3ecuo de tais macrosC
caso o ar,ui-o contenha modifica?es no gra-adasC o usurio ser ,uestionado so/re a continuao da
e3ecuo da macro!
" estrutura de pastas do pro;eto na /ase de dados do softare de contro)e de -erso de-e ser a mesma
estrutura dos diret=rios dos ar,ui-os tra/a)hados! &ste conceito foi imp)antado para faci)itar a e3ecuo
das macros automaticamente pois o path dos ar,ui-os 2 informado na )inha de comando! &ntretantoC
isto 2 possG-e) de ser a)teradoC simp)esmente modificando as )inhas de comandos informadas na ;ane)a
de preferIncias Dpor e3emp)oC informando um nome de pro;eto fi3oE de acordo com a sinta3e de )inha
de comando do softare uti)i1ado! *ote ,ue a)guns softares contro)adores de -ersoC como o 6isua)
Source Safe da MicrosoftC permitem ao usurio criar diferentes /ancos de dados para arma1enamento
dos pro;etos mesmo ,ue isso no se;a aconse)h-e) pe)o pr=prio fa/ricante! #ara a e3ecuo das
macros de contro)e de -ersoC o "#$ %D& funcionar corretamente com apenas um /anco de dados
para arma1enagem!
#ara a e3ecuo de ,ua),uer um dos comandos de contro)e de -ersoC o usurio de-e ter os direitos
necessrios cadastrados no softare de contro)e de -erso uti)i1ado!
"#$ %D& ' Documentao e Guia do Usurio A4
CopyRight 1999 Microsiga Softare S!"!
3igura 22 4 A 6ai9a de dilogo 'ara digitao da sen8a
e9ibida 'ela ma6ro FSGSEE;H*SEIHACCESS durante a
e9e6uo da ma6ro 'ara reser#a de ar"ui#o
;uito im'ortanteL Caso o usurio dese;e efetuar testes )ocaisC e desse modo remo-er manua)mente
Dou mesmo atra-2s de op?es do softare de contro)e de -erso uti)i1adas nas )inhas de comando das
macrosE o atri/uto de somente )eituraC a e3ecuo automtica do pedido de reser-a no ser efetuada
pe)o "#$ %D& e as c=pias )ocais Dmesmo ,ue no este;am reser-adas ou no se;am a -erso correta
mantida no ser-idor de contro)e de -ersoE podero sempre ser editadas no "#$ %D&! "ssimC o contro)e
das reser-as e confirma?es dos ar,ui-os ser tota)mente do usurio pe)a e3ecuo atra-2s dos /ot?es
na /arra de ferramentas de contro)e de -erso ou diretamente em uma -erso c)ient do softare
contro)ador de -erso! *ote ,ue neste caso o usurio de-e -erificar sempre se o ar,ui-o est
corretamente reser-ado atra-2s do softare de contro)e de -ersoC pois no h garantias de ,ueC por
e3emp)oC uma )inha de comando e3ecutada atra-2s do "#$ %D& foi e3ecutada com sucesso e a -erso
do ar,ui-o ,ue o usurio est editando 2 a +)tima!
Do mesmo modoC se o softare de contro)e de -erso uti)i1ado no tra/a)har com o atri/uto de
somente )eitura nos ar,ui-osC apenas as e3ecu?es manuais das macros sero efetuadas no "#$ %D& e 2
e3tremamente aconse)h-e) neste caso ,ue as opera?es de reser-aC confirmaoC etc! se;am efetuadas
sempre atra-2s da -erso c)ient do softare de contro)e de -erso!
"#$ %D& ' Documentao e Guia do Usurio A7
CopyRight 1999 Microsiga Softare S!"!
tili&ando os Assistentes do AP5 IDE
"tra-2s do menu 'erramenas Dfigura B<E o usurio tem acesso aos assistentes do "#$ %D& e tam/2m as
ferramentas customi1adas ,ue sero deta)hadas mais a frente! 8 "#$ %D& disponi/i)i1a o "ssistente de Gerao
de C=digo e o "ssistente de Con-erso!
- Assistente de &erao de Cdigo
8 "ssistente de Gerao de C=digo do "#$ %D& Dfigura B$E permite a criao de rotinas /sicas atra-2s de
informa?es definidas pe)o usurio! 8 assistente cria rotinas especGficas com o c=digo /sico para o tipo de rotina
dese;adaC faci)itando ao usurio pois e)e de-er somente inc)uir a )=gica principa) de acordo com a sua
necessidade! 8 escopo do programaC com as fun?es em "D6#.C so montados pe)o assistente! 8s tipos de
rotinas ,ue so criados pe)o "ssistente de Gerao de C=digo so rotinas de re)at=riosC rotinas de cadastroC rotinas
para gerao e importao de ar,ui-o te3to e rotinas de processamento gen2rico!
#ara a gerao do escopo do programaC o "ssistente so)icita informa?es como o ar,ui-o principa)C os parRmetros
uti)i1adosC tGtu)os de re)at=rios ou /rosersC etc! Dpor e3emp)oC figura B0E!
"#$ %D& ' Documentao e Guia do Usurio A9
CopyRight 1999 Microsiga Softare S!"!
3igura 2) 4 - ;enu 7erramentas.
3igura 25 4 - Assistente de &erao de Cdigo
3igura 20 J Informaes ne6essrias ao Assistente de &erao
de Cdigo 'ara a gerao do es6o'o do 'rograma.
- Assistente de Con#erso de Cdigo
8s antigos RdmaHes mantidos pe)os usurios continuam compatG-eis na -erso do "#$! #or2mC a)gumas
a)tera?es so necessrias para o correto funcionamento destes programas! #ara au3i)iar na adaptao dos
RdmaHesC o "#$ %D& cont2m um "ssistente de Con-erso de C=digo!
*elecionando os Ar"ui#os
"cionando a opo Assisene de )onverso do
menu 'erramenasC o "ssistente iniciar de sua te)a
para se)eo de ar,ui-os para con-erso Dfigura
B4E!
"tra-2s dos /ot?es ao )ado direito da )istaC o
usurio pode adicionarC remo-er ou )impar a )ista de
ar,ui-os para a con-erso! "p=s um ou mais
ar,ui-os terem sido adicionados a )istaC o /oto
Avanar ser disponi/i)i1ado para ,ue o processo
continue! Se)ecionando AvanarC o processo de
compati/i)i1ao se iniciar Dfigura B7E!
Con#ertendo os Ar"ui#os
"p=s o t2rmino do processo de con-erso o /oto
Avanar se tornar no-amente disponG-e)!
8 "ssistente de Con-erso no efetuar diretamente
as a)tera?es nos ar,ui-os se)ecionados para
con-erso! Uti)i1ar uma c=pia em mem=ria de cada
ar,ui-o onde efetuar as mudanas necessrias!
*a te)a seguinte o "ssistente ,uestionar o usurio
pe)o diret=rio no ,ua) de-er gra-ar os ar,ui-os
con-ertidos Dfigura B9E!
Diret1rio -ara /ra#ao dos Ar"ui#os
Con#ertidos
*esta te)a o usurio poder tam/2m se)ecionar ,uais os
ar,ui-os ,ue no dese;a gra-ar e remo-I>)os da )ista de
ar,ui-os con-ertidos! (odos os ar,ui-os da )ista sero
gra-ados com o nome origina) no diret=rio informado!
"#$ %D& ' Documentao e Guia do Usurio B:
CopyRight 1999 Microsiga Softare S!"!
3igura 27 4 Seleo de ar"ui#os 'ara 6on#erso no
Assistente de Con#erso de Cdigo
3igura 2! 4 - Assistente em 'ro6esso de 6on#erso
dos ar"ui#os
#ortantoC 2 aconse)h-e) fornecer um diret=rio diferente
do diret=rio dos ar,ui-os originais para ,ue os mesmos
no se;am su/stituGdos!
Seguir uma te)a de processo da gra-ao dos ar,ui-os e
ento a te)a de fina)i1ao da con-erso Dfigura <:E ser
e3i/ida! *este momento os ar,ui-os con-ertidos ; se
encontram gra-ados no diret=rio informado!
Criao de Pro0eto e Com-ilao Autom5ticos
8 "ssistente de Con-erso do "#$ %D& tam/2m poder
criar automaticamente um grupo de pro;etos Dconforme
descrito em capGtu)o anteriorE com todos os ar,ui-os
con-ertidos! #ara isso /asta se)ecionar a opo )riar
um Novo Pro8eo e fornecer o nome do ar,ui-o! 8
ar,ui-o ser criado no mesmo diret=rio onde os
ar,ui-os con-ertidos foram gra-ados! 8 "ssistente
tam/2m poder compi)ar automaticamente o grupo de
pro;etos criadoC /astando ,ue o usurio se)ecione a
opo )om/ilar Todos os Arquivos!
"o se pressionar o /oto 'inali(arC o assistente ir ento e3ecutar as op?es se)ecionadas pe)o usurio! Caso no
se;a possG-e) criar o grupo de pro;etosC ou compi)ar os ar,ui-os Dpor e3emp)oC se no for possG-e) conectar ao
Ser-erE o usurio ser a-isado sem ,ua),uer interferIncia nos ar,ui-os con-ertidos gra-ados no diret=rio
informado anteriormente!
Como ; deta)hado anteriormenteC os c=digos criados por usurios do Siga "d-anced
de-ero uti)i1ar a c)usu)a US&R 5U*C(%8* Ynome do programaZC garantindo assim a
unicidade das fun?es criadas! %sto tam/2m permite ,ue a funo &S&C\.8C] e as op?es
de menus iniciadas com o caracter de c=digo "SC%% B$ DME se;am e3ecutadas norma)mente!
" inc)uso da c)usu)a US&R 5U*C(%8* 2 uma das a)tera?es efetuadas pe)o "ssistente
de Con-erso!
*os antigos RdmaHesC todas as -ari-eis eram criadas como #ri-ate no escopo do sistema! "ssimC uma
-ari-e) criada em uma funo chamada pe)a rotina principa)C permanecia durante toda a e3ecuo do
RdmaHe! Como agora o c=digo no 2 mais interpretadoC as -ari-eis #ri-ate permanecem durante toda
a e3ecuo at2 a fina)i1ao da rotina ,ue a criou! &ntoC por moti-os de compati/i)i1aoC todas as
-ari-eis sero dec)aradas no inGcio da rotina con-ertida!
5ina)menteC por ser um c=digo interpretado o RDM"]& uti)i1a-a>se da funo &S&CU(& para
e3ecutar fun?es nas a?es de /ot?es ou em outras ocasi?es! Como o usurio tem a sua disposio
todas caracterGsticas da )inguagem "D6#.C como por e3emp)o uso de parRmetros e retorno de -a)ores
em fun?esC as chamadas das fun?es &S&CU(&DYnome da funoZE so su/stituGdas pe)a chamada da
pr=pria funo nos programas con-ertidos!
@untamente com estas a)tera?esC ser inc)uGda nas rotinas especGficas con-ertidas a c)usu)a
M%*C.UD& TRFM"]&!C[T para manter a compati/i)idade dos comandos uti)i1ados no RdmaHe e
todas as c)usu)as M%*C.UD& ou MD&5%*& ; e3istentes na rotina especGfica sero mo-idas para o
inGcio do programa!
"#$ %D& ' Documentao e Guia do Usurio B1
CopyRight 1999 Microsiga Softare S!"!
3igura 2, 4 Seleo do diretrio 'ara gra#ao dos
ar"ui#os 6on#ertidos.
3igura )% 4 A tela de finali+ao da 6on#erso: onde
o usurio 'ode 6riar um gru'o de 'ro(etos e
6om'ilar os ar"ui#os automati6amente.
Tabela de 6acros
"s Macros imp)ementadas no "#$ %D& podem ser uti)i1adas para automati1ar a?es ou ferramentas! *o menu
'erramenasC ,ua),uer ferramenta adicionada pode uti)i1ar nos parRmetros ou no diret=rio inicia) uma ou mais
macros! \asta informar no te3to o nome da macro! #or e3emp)oC pode>se uti)i1ar macros na inc)uso de uma
ferramenta ,ue permita editar o ar,ui-o corrente no *8(&#"D do FindosL
*8(&#"D!&S& aS8URC&b*"M&!
")2m dessa uti)i1aoC a macro a6&RS%8*bC[&C]b%* pode ser e3ecutada automaticamente durante o
processamento do "#$ %D&!
"/ai3o encontram>se deta)hadas as macros suportadas no "#$ %D&!
Kome Des6rio
aa Retorna o caracter TaT!
a%D&b#"([ Retorna o path de e3ecuo do "#$ %D&!
a%*#U(b(&S(Dc(itCcMsgCcDefau)tE &3i/e a mensagem informada em cMsg em um di)ogo com tGtu)o c(itC
permitindo a digitao de um te3to! Retorna o te3to digitado caso o
di)ogo se;a confirmado ou o te3to em cDefau)t caso o di)ogo se;a
cance)ado!
aS8URC&b*"M& Retorna o nome comp)eto Dpath e nomeE do ar,ui-o corrente! Se nenhum
ar,ui-o esti-er a/erto retorna -a1io DTTE!
aS8URC&b*"M&b*8bDR%6& Retorna o nome comp)eto sem a )etra do dri-e do ar,ui-o corrente! Se
nenhum ar,ui-o esti-er a/erto retorna -a1io DTTE!
aS8URC&bS[8R(b*"M& Retorna somente o nome do ar,ui-o corrente Dsem path ou )etra do
dri-eE! Se nenhum ar,ui-o esti-er a/erto retorna -a1io DTTE!
aS8URC&bCURS8Rb.%*& Retorna a )inha onde o cursor est posicionado no ar,ui-o corrente! Se
nenhum ar,ui-o esti-er a/erto retorna T::T!
aS8URC&bCURS8RbC8.UM* Retorna a co)una onde o cursor est posicionado no ar,ui-o corrente! Se
nenhum ar,ui-o esti-er a/erto retorna T::T!
aS8URC&bCURS8RbF8RD Retorna a pa)a-ra ,ue se encontra onde o cursor est posicionado no
ar,ui-o corrente! Se nenhum ar,ui-o esti-er a/erto retorna -a1io DTTE!
Considera como pa)a-ra todo e ,ua),uer te3to entre os de)imitadores!
aS8URC&b&S&CU(%8*b.%*& Retorna a )inha de e3ecuo no ar,ui-o corrente! Se nenhum ar,ui-o
esti-er a/erto ou o "#$ %D& *o esti-er em modo de de/ugC retorna
T::T!
aS8URC&b#"([ Retorna o path do ar,ui-o corrente! Se nenhum ar,ui-o esti-er a/erto
retorna -a1io DTTE!
aS8URC&b&S( Retorna a e3tenso do ar,ui-o corrente! Se nenhum ar,ui-o esti-er
a/erto retorna -a1io DTTE!
aS8URC&bDR%6& Retorna a )etra do dri-e do ar,ui-o corrente! Se nenhum ar,ui-o esti-er
a/erto retorna -a1io DTTE!
aS8URC&bScS(&MbD"(& Retorna a data do sistema no padro ddNmmNyyyy!
aS8URC&bScS(&Mb(%M& Retorna a hora do sistema no padro hhLmmLss!
aScS(&MbUS&Rb*"M& Retorna o nome do )ogin do usurio na rede! Se o usurio no esti-er
)ogado ou no hou-er uma redeC retorna -a1io DTTE!
aScS(&MbUS&Rb"CC&SS &3i/e uma cai3a de di)ogo para identificao por %D e senhaC
retornando>os separados por uma -Grgu)a DPE ou -a1io DTTE se a cai3a de
di)ogo for cance)ada!
a6&RS%8*b"DDb5%.& "diciona o ar,ui-o corrente ao ser-idor de contro)e de -erso C atra-2s
da e3ecuo da )inha de comando informada nas preferIncias! &sta
macro s= tem funciona)idade ,uando o uso de contro)e de -erso esti-er
ha/i)itado no "#$ %D&! *ote ,ue a estrutura de pastas do pro;eto no
Contro)ador de 6erso de-e ser a mesma estrutura de diret=rios onde o
ar,ui-o se encontra!
a6&RS%8*b"S]b58RbC8MM&*( &3i/e uma cai3a de di)ogo para a digitao do comentrio para as
"#$ %D& ' Documentao e Guia do Usurio BA
CopyRight 1999 Microsiga Softare S!"!
opera?es de reser-aC confirmaoC etc! de contro)e de -erso! &sta
macro 2 uti)i1ada automaticamente pe)as macros ,ue e3ecutam a?es do
contro)ador de -erso!
a6&RS%8*bC[&C]b8U( Reser-a o ar,ui-o corrente para a)terao no Contro)ador de 6ersoC
atra-2s da e3ecuo da )inha de comando informada nas preferIncias!
&sta macro s= tem funciona)idade ,uando o uso de contro)e de -erso
esti-er ha/i)itado no "#$ %D&! *ote ,ue a estrutura de pastas do pro;eto
no Contro)ador de 6erso de-e ser a mesma estrutura de diret=rios onde
o ar,ui-o se encontra! "p=s reser-ar o fonteC o ar,ui-o 2 rea/erto para
carregar e-entuais modifica?es!
a6&RS%8*bC[&C]b%* Confirma as a)tera?es no ar,ui-o correnteC )e-ando>as para o ser-idor
do contro)e de -erso e desfa1 a reser-a efetuadaC atra-2s da e3ecuo da
)inha de comando informada nas preferIncias! &sta macro s= tem
funciona)idade ,uando o uso de contro)e de -erso esti-er ha/i)itado no
"#$ %D&! *ote ,ue a estrutura de pastas do pro;eto no Contro)ador de
6erso de-e ser a mesma estrutura de diret=rios onde o ar,ui-o se
encontra!
a6&RS%8*bG&(b."S( 8/t2m a +)tima -erso do ar,ui-o corrente no contro)ador de -erso!
&sta macro s= tem funciona)idade ,uando o uso de contro)e de -erso
esti-er ha/i)itado no "#$ %D&! "p=s a e3ecuo do comando o ar,ui-o 2
rea/erto para carregar e-entuais modifica?es! *ote ,ue a estrutura de
pastas do pro;eto no Contro)ador de 6erso de-e ser a mesma estrutura
de diret=rios onde o ar,ui-o se encontra!
a6&RS%8*bR&M86&b5%.& Remo-e o ar,ui-o corrente do contro)ador de -erso! &sta macro s= tem
funciona)idade ,uando o uso de contro)e de -erso esti-er ha/i)itado no
"#$ %D&! *ote ,ue a estrutura de pastas do pro;eto no Contro)ador de
6erso de-e ser a mesma estrutura de diret=rios onde o ar,ui-o se
encontra!
a6&RS%8*bU*D8bC[&C]b8U( Desfa1 a +)tima reser-a efetuada para o ar,ui-o corrente no contro)ador
de -erso! &sta macro s= tem funciona)idade ,uando o uso de contro)e
de -erso esti-er ha/i)itado no "#$ %D&! *ote ,ue a estrutura de pastas
do pro;eto no Contro)ador de 6erso de-e ser a mesma estrutura de
diret=rios onde o ar,ui-o se encontra!
"#$ %D& ' Documentao e Guia do Usurio BB
CopyRight 1999 Microsiga Softare S!"!
/loss5rio
E9'resso Definio
"D6#. "d-anced #rogram .anguage > .inguagem de programao desen-o)-ida pe)a
Microsiga Softare S!"!
")ias ")ias de um ar,ui-o 2 um Tape)idoT dado a um ar,ui-o a/ertoC de modo ,ue para
se)ecionar a rea de tra/a)ho e poder efetuar a)tera?es ou pes,uisasC o usurio pode se
referir ao ar,ui-o atra-2s deste ape)ido! *o Siga "d-ancedC os ar,ui-os tIm como
padro os ")ias referentes Qs trIs primeiras )etras de seu nomeC por e3emp)o S\1!
"#$ Remote #rograma do "#$ ,ue fa1 a interface com o usurioC atra-2s da comunicao com o
"#$ Ser-er!
"p)icao MD% Mu)tip)e Document %nterface D%nterface de Documentos M+)tip)osE! U uma ap)icao
cu;a interface consiste de uma ;ane)a principa) ,ue pode conter m+)tip)as ;ane)as fi)hasC
ou documentos! 8s tGtu)os das ;ane)as fi)has com/inam com o tGtu)o da ;ane)a pai
,uando a ;ane)a fi)ha 2 ma3imi1ada!
\reaH #oints #ontos de parada marcados nas )inhas do c=digo de um programa ,ue indicam pontos
onde o processamento de-e entrar em modo de de/ug ,uando forem a)canados!
\uffer de &dio U uma c=pia do ar,ui-o a/erto no "#$ %D& mantida em mem=ria para permitir a edio
do mesmo! &ssa c=pia 2 carregada ,uando o ar,ui-o 2 a/erto e gra-ada ,uando o
ar,ui-o 2 sa)-o!
De/ug #rocesso de depurao de erros atra-2s da e3ecuo )inha>a>)inha do c=digoC com a
a;uda de inspetores de am/iente ,ue e3i/em o conte+do de -ari-eisC camposC etc!
De/ugger #rograma ,ue encontra e e)imina erros de programao D/ugsE!
De)imitadores De)imitadores so caracteres especiais ou de pontuao uti)i1ados para separar as
pa)a-ras do c=digo! #or e3emp)oC o te3to T%5 d&85DET cont2m duas pa)a-rasL T%5T e
T&85T! " separao das pa)a-ras 2 necessria para a Diferenciao de Sinta3e! "/ai3o
est a )ista de de)imitadores de te3to considerados no "#$ %D&!
Caracter de (a/u)ao DC=digo "SC %% M9E
Caracter de .ine 5eed DC=digo "SC %% M1:E
Caracter de Carriage Return DC=digo "SC %% M1BE
Caracter de &spao DC=digo "SC %% MBAE
Caracter de #onto DC=digo "SC %% M<0E
Caracter de 6Grgu)a DC=digo "SC %% M<<E
Caracter de Dois>#ontos DC=digo "SC %% M$7E
Caracter de #onto>e>6Grgu)a DC=digo "SC %% M$9E
Caracter de "/ertura de Cha-es DC=digo "SC %% M1ABE
Caracter de 5echamento de Cha-es DC=digo "SC %% M1A$E
Caracter de "/ertura de Co)chetes DC=digo "SC %% M91E
Caracter de 5echamento de Co)chetes DC=digo "SC %% M9BE
Caracter de "/ertura de #arInteses DC=digo "SC %% M<:E
Caracter de 5echamento de #arInteses DC=digo "SC %% M<1E
Caracter de Sina) de %gua) DC=digo "SC %% M01E
Caracter de Sina) de "dio DC=digo "SC %% M<BE
Caracter de Sina) de Su/trao DC=digo "SC %% M<$E
Caracter de Sina) de Mu)tip)icao DC=digo "SC %% MW<AE
Caracter de Sina) de Di-iso DC=digo "SC %% M<4E
Caracter de \arra %n-ertida DC=digo "SC %% M9AE
Caracter de Sina) de Maior DC=digo "SC %% M0AE
Caracter de Sina) de Menor DC=digo "SC %% M0:E
Caracter de Sina) de #ercentua) DC=digo "SC %% MB4E
Caracter de Sina) de "rro/a DC=digo "SC %% M0<E
Caracter de &3c)amao DC=digo "SC %% MBBE
Caracter de Diferena DC=digo "SC %% MB$E
Caracter de Macro Su/stituio DC=digo "SC %% MB7E
Caracter de Cifro DC=digo "SC %% MB0E
Derru/ar C)ient 5ina)i1a a e3ecuo do "#$ Remote! " fina)i1ao do "#$ Remote somente ser
"#$ %D& ' Documentao e Guia do Usurio B<
CopyRight 1999 Microsiga Softare S!"!
efetuada assim ,ue a)guma )inha de c=digo for e3ecutada! #or e3emp)oC se o "#$
Remote esti-er em estado de espera Daguardando por uma digitao do usurioEC a
fina)i1ao pedida no %D& somente ser efetuada assim ,ue a)gum c=digo no "#$
Remote se;a e3ecutado Dpor e3emp)oC na -a)idao do te3to digitado pe)o usurioE!
Diferenciao de
Sinta3e
Diferenciao atra-2s de cores do te3to do c=digo de um programaC -isando faci)itar a
identificao de erros de digitao e me)horar o aspecto -isua)! Gera)mente so
diferenciados te3to comum de pa)a-ras reser-adasC n+meros ou strings!
%dentao U o a)inhamento das )inhas de te3toC atra-2s da inc)uso de ta/u)a?esC segundo a
estrutura )=gica do programa -isando faci)itar a )eitura do c=digo! #or e3emp)oC a/ai3o
esto demonstradas )inhas de c=digo sem e com identao de te3toL
if i Y 1:
for 3 L_ i to 1:
gra-aDE
ne3t 3
endif
if i Y 1:
for 3 L_ i to 1:
gra-aDE
ne3t 3
endif
&3ecutar &3ecuta o "#$ Remote norma)menteC mantendo o %D& em estado de espera! Desse
modoC o %D& somente entrar em modo de de/ug em uma das seguintes situa?esL
1! um /reaH point for encontradoP
A! o usurio se)ecionar o comando pause no %D&P
B! um /reaH point condiciona) for satisfeitoP
<! o usurio pressionar no "#$ Remote a com/inao de tec)as ".(KD!
8 modo de e3ecuo tam/2m se encerra se o usurio fina)i1ar o "#$ Remote!
Gutter erea nas margens de uma ;ane)a uti)i1ada para a e3i/io de informa?esC como por
e3emp)o a rea onde ficam marcados os Gcones de /reaH points ou a rea da r2gua de
n+meros de )inhas nas ;ane)as de documentos do "#$ %D&!
%D& %ntegrated De-e)opment &n-ironment D"m/iente de Desen-o)-imento %ntegradoE! U
uma ap)icao onde todo o desen-o)-imentoC e3ecuoC depurao e correo de
procedimentos pode ser desen-o)-ido!
#ausar #arada na e3ecuo do "#$ Remote ou na e3ecuo de uma animao! " parada do
"#$ Remote somente ser e3ecutada assim ,ue a)guma )inha de c=digo for e3ecutada!
#or e3emp)oC se o "#$ Remote esti-er em estado de espera Daguardando por uma
digitao do usurioEC a pausa efetuada no %D& somente ser efetuada assim ,ue a)gum
c=digo no "#$ Remote se;a e3ecutado Dpor e3emp)oC na -a)idao do te3to digitado
pe)o usurioE!
#ercorrer .inha &3ecuo )inha por )inha do c=digoC entrando no c=digo de fun?es!
#rogramas Registrados So todos os programas compi)ados atra-2s do "d-anced #rotheus %D&C ,ue so
mantidos em diferentes reposit=rios no "d-anced #rotheus Ser-erC de acordo com
opo do "dministrador!
#onto de &ntrada Conceito imp)ementado desde as -ers?es anteriores do sistema de &R# Siga "d-anced!
U uma rotina de nome fi3o e criada pe)o usurio! 8 sistema Siga "d-anced checa a
e3istIncia desta rotina em determinados pontos do c=digo e a e3ecuta se for encontradaC
permitindo assim ,ue o usurio customi1e processos fechados! *a -erso $!:4C o
usurio pode de/ugar estas rotinas chamadas automaticamente atra-2s do "#$ %D&
Dpor e3emp)oC adicionando /reaH pointsE!
#u)ar .inha &3ecuo )inha por )inha do c=digoC sem entrar no c=digo das fun?es!
RDM"]& .inguagem interpretada criada pe)a Microsiga Softare S!"! uti)i1ada no sistema de
&R# Siga "d-anced at2 a -erso 3!:4!
Seguir "t2 Retorno &3ecuo em modo norma) do "#$ Remote at2 o momento em ,ue a )inha em
"#$ %D& ' Documentao e Guia do Usurio B$
CopyRight 1999 Microsiga Softare S!"!
e3ecuo se;a a )inha onde o cursor est posicionado! #ara issoC o "d-anced #rotheus
%D& co)oca um /reaH point temporrio na )inha onde o cursor est posicionado!
Ser-er Ser-io do "#$ ,ue se encarrega de e3ecutar as rotinas dos programas registrados e
contro)ar o acesso dos usurios! Comunica>se com o "#$ Remote para permitir a
interface com o usurio!
String Cadeia de caracteres formadora de um te3to ,ua),uerC compreendida entre aspas dup)as
DTE ou aspas simp)es DJEC como por e3emp)o T"#$T!
6ari-eis &stticas 6ari-eis definidas com instRncia estticaC ou se;aC podero ser -isua)i1adas ou
a)teradas por ,ua),uer rotina dentro do mesmo programa!
6ari-eis .ocais 6ari-eis definidas com instRncia )oca)C ou se;aC podero ser -isua)i1adas ou a)teradas
somente dentro da rotina ,ue as dec)arou!
6ari-eis #ri-adas 6ari-eis definidas com instRncia pri-adaC ou se;aC podero ser -isua)i1adas ou
a)teradas apenas pe)a rotina ,ue as dec)arou e pe)as rotinas chamadas por esta!
6ari-eis #+/)icas 6ari-eis definidas com instRncia p+/)icaC ou se;aC podero ser -isua)i1adas ou
a)teradas por ,ua),uer rotina dos programas registrados!
Fatchs @ane)a de inspeo onde e3press?es digitadas pe)o usurio podem ser a-a)iadas no "#$
Ser-er durante o processo de de/ug!
"#$ %D& ' Documentao e Guia do Usurio B0
CopyRight 1999 Microsiga Softare S!"!