documento genexus

Upload: leonildo-santiago-de-sobral

Post on 18-Jul-2015

683 views

Category:

Documents


19 download

TRANSCRIPT

1 Sumrio 1. Comandos GeneXus ................................................................................................................................... 7 1.1. Assign Atributo .................................................................................................................................. 7 1.2. Assign Varivel .................................................................................................................................. 7 1.3. Call ..................................................................................................................................................... 8 1.4. Change Page ....................................................................................................................................... 8 1.5. Commit ............................................................................................................................................... 8 1.6. Confirm .............................................................................................................................................. 9 1.7. Delete .................................................................................................................................................. 9 1.8. Do Nome Subrotina ....................................................................................................................... 10 1.9. Do While .......................................................................................................................................... 10

1.10. Eject .............................................................................................................................................. 10 1.11. Error_Handler ............................................................................................................................... 10 1.12. Exit ............................................................................................................................................... 11 1.13. Footer............................................................................................................................................ 11 1.14. For Each ....................................................................................................................................... 11 CLUSULA ORDER .............................................................................................................................. 12 CLUSULA WHERE.............................................................................................................................. 12 CLUSULA DEFINED BY .................................................................................................................... 13 1.15. For Each Line ............................................................................................................................... 13 1.16. For Each Selected line .................................................................................................................. 13 1.17. Graph ............................................................................................................................................ 13 1.18.

Header .......................................................................................................................................... 14 1.19. If ................................................................................................................................................... 15 1.20. Line Number ................................................................................................................................. 15 1.21. Load .............................................................................................................................................. 15 1.22. Margin Botton .............................................................................................................................. 15 1.23. Margin Top ................................................................................................................................... 16 1.24. Message ........................................................................................................................................ 16 1.25. New Record .................................................................................................................................. 16 1.26. NoSkip .......................................................................................................................................... 17 1.27. Page Length .................................................................................................................................. 17 1.28. Print If Detail ................................................................................................................................ 17 1.29.

PrinterCommand ........................................................................................................................... 17 1.30. Refresh .......................................................................................................................................... 18 1.31. Return ........................................................................................................................................... 18 1.32. RollBack ....................................................................................................................................... 18 1.33. Submit .......................................................................................................................................... 18 1.34. Subroutine .................................................................................................................................... 19 1.35. Xfor Each ..................................................................................................................................... 19 1.36. Xfor First ...................................................................................................................................... 19 1.37. Xnew ............................................................................................................................................ 19 2. Regras dos Objetos GeneXus ................................................................................................................... 20 2.1. ACCEPT ........................................................................................................................................... 20 2.2.

ADD ................................................................................................................................................. 21 2.3. ALLOWNULLS ............................................................................................................................... 21 2.4. ....................................................................................................................................... 21 2.5. CALL................................................................................................................................................ 21 2.6. COLOR ............................................................................................................................................ 22 2.7. DEFAULT ........................................................................................................................................ 22 2.8. DEFAULT MODE ........................................................................................................................... 23 2.9. EQUAL ............................................................................................................................................ 23 2.10. ERROR ......................................................................................................................................... 23 2.11. ERROR_HANDLER .................................................................................................................... 24

2 2.12. ........................................................................................................................................................ ...... 24

2.13. HIDDEN ....................................................................................................................................... 24 2.14. MSG ............................................................................................................................................. 25 2.15. NOACCEPT ................................................................................................................................. 25 2.16. NOCHECK ................................................................................................................................... 25 2.17. NOCONFIRM .............................................................................................................................. 25 2.18. NOREAD ..................................................................................................................................... 26 2.19. NOPROMPT ................................................................................................................................ 26 2.20. ORDER ........................................................................................................................................ 26 2.21. PARM ........................................................................................................................................... 26 2.22. PRINTER ..................................................................................................................................... 27 2.23. PROMPT ...................................................................................................................................... 27

2.24. REFCALL .................................................................................................................................... 27 2.25. REFMSG ...................................................................................................................................... 27 2.26. SEARCH ...................................................................................................................................... 28 2.27. SERIAL ........................................................................................................................................ 28 2.28. SUBMIT ....................................................................................................................................... 28 2.29. SUBTRACT ................................................................................................................................. 28 2.30. WORKFILE_LINES .................................................................................................................... 29 2.31. XORDER ...................................................................................................................................... 29 3. Funes Disponveis no GeneXus ............................................................................................................ 30 3.1. DAY ................................................................................................................................................. 30 3.2. MONTH ........................................................................................................................................... 30

3.3. YEAR ............................................................................................................................................... 31 3.4. TODAY ............................................................................................................................................ 31 3.5. NOW( ) ............................................................................................................................................. 31 3.6. HOUR, MINUTE, SECONDS ......................................................................................................... 31 3.7. DOW ................................................................................................................................................ 32 3.8. CDOW .............................................................................................................................................. 32 3.9. CMONTH ......................................................................................................................................... 32 3.10. CTOD ........................................................................................................................................... 32 3.11. CTOT............................................................................................................................................ 33 3.12. DTOC ........................................................................................................................................... 34 3.13. TTOC............................................................................................................................................ 34

3.14. YMDTOD .................................................................................................................................... 35 3.15. YmdHmstoT ................................................................................................................................. 35 3.16. ADDMTH .................................................................................................................................... 35 3.17. ADDYR ........................................................................................................................................ 36 3.18. AGE .............................................................................................................................................. 36 3.19. EOM ............................................................................................................................................. 36 3.20. TDIFF ........................................................................................................................................... 36 3.21. TADD ........................................................................................................................................... 37 3.22. ASK .............................................................................................................................................. 37 3.23. UDF .............................................................................................................................................. 37 3.24. UDP .............................................................................................................................................. 37

3.25. ROWS .......................................................................................................................................... 38 3.26. COLS ............................................................................................................................................ 38 3.27. TIME ............................................................................................................................................ 38 3.28. SYSTIME ..................................................................................................................................... 39 3.29. SYSDATE .................................................................................................................................... 39 3.30. USERCLS .................................................................................................................................... 39 3.31. USERID ........................................................................................................................................ 39 3.32. WRKST ........................................................................................................................................ 39 3.33. STR ............................................................................................................................................... 40 3.34. SUBSTR ....................................................................................................................................... 40 3.35. CONCAT ...................................................................................................................................... 40

3 3.36. SPACE .......................................................................................................................................... 41 3.37. LEN .............................................................................................................................................. 41 3.38. TRIM ............................................................................................................................................ 41 3.39. LTRIM .......................................................................................................................................... 41 3.40. RTRIM ......................................................................................................................................... 42 3.41. UPPER .......................................................................................................................................... 42 3.42. LOWER ........................................................................................................................................ 42 3.43. INT ............................................................................................................................................... 42 3.44. ROUND ........................................................................................................................................ 43 3.45. TRUNC ........................................................................................................................................ 43 3.46.

VAL .............................................................................................................................................. 43 3.47. COLOR ........................................................................................................................................ 43 3.48. RGB .............................................................................................................................................. 43 3.49. NULL ........................................................................................................................................... 44 3.50. NULLVALUE .............................................................................................................................. 44 3.51. LOADBITMAP ............................................................................................................................ 44 3.52. OLD .............................................................................................................................................. 45 3.53. PREVIOUS .................................................................................................................................. 45 3.54. AFTER ......................................................................................................................................... 45 3.55. LEVEL ......................................................................................................................................... 46 3.56. INSERT/UPDATE/DELETE ....................................................................................................... 46 4.

Operadores Disponveis no GeneXus ....................................................................................................... 47 5. Variveis Internas do GeneXus ................................................................................................................ 48 5.1. TODAY ............................................................................................................................................ 48 5.2. TIME ................................................................................................................................................ 48 5.3. PAGE................................................................................................................................................ 48 5.4. LINE ................................................................................................................................................. 48 5.5. OUTPUT .......................................................................................................................................... 48 5.6. PGMDESC ....................................................................................................................................... 49 5.7. PGMNAME ...................................................................................................................................... 49 5.8. MODE .............................................................................................................................................. 49 6. Propriedades do

GeneXus ........................................................................................................................ 50 6.1. VISIBLE ........................................................................................................................................... 50 6.2. TOLLTIP .......................................................................................................................................... 50 6.3. CAPTION ......................................................................................................................................... 51 6.4. ENABLE .......................................................................................................................................... 51 6.5. ACTIVEPAGE ................................................................................................................................. 51 6.6. PAGECOUNT .................................................................................................................................. 52 6.7. BACKCOLOR, FORECOLOR ........................................................................................................ 52 6.8. TOP, LEFT ....................................................................................................................................... 52 6.9. FILLSTYLE ..................................................................................................................................... 53 6.10. FILLCOLOR ................................................................................................................................ 53 6.11.

DEFAULT .................................................................................................................................... 53 6.12. BITMAP ....................................................................................................................................... 54 6.13. BACKSTYLE............................................................................................................................... 54 6.14. FONTNAME ................................................................................................................................ 54 6.15. FONTITALIC, FONTUNDERLINE, FONTBOLD, FONTSTRIKETHRU ............................... 55 6.16. FONTSIZE ................................................................................................................................... 55 6.17. WIDTH, HEIGHT ........................................................................................................................ 55 6.18. TITLE ........................................................................................................................................... 56 6.19. WINDOWSTATE ........................................................................................................................ 56 6.20. LINESELECTOR ......................................................................................................................... 56 6.21. REDRAW ..................................................................................................................................... 57 6.22.

TITLEFORECOLOR, TITLEBACKCOLOR .............................................................................. 57 6.23. TAG .............................................................................................................................................. 57 6.24. BORDERSTYLE ......................................................................................................................... 58

4 7. Eventos de Controle ................................................................................................................................. 58 7.1. DBCLICK ........................................................................................................................................ 58 7.2. CLICK .............................................................................................................................................. 58 7.3. ISVALID .......................................................................................................................................... 59 7.4. RIGHTBUTTON .............................................................................................................................. 59 8. Mtodos ................................................................................................................................................. ... 60 8.1. SETFOCUS ...................................................................................................................................... 60 8.2.

REPAINT ......................................................................................................................................... 60 8.3. CLEAR, ADDITEM ......................................................................................................................... 60 8.4. REMOVEITEM ............................................................................................................................... 61 8.5. LOAD ............................................................................................................................................... 61 8.6. SORT ................................................................................................................................................ 62 8.7. PRINTFORM ................................................................................................................................... 62 8.8. REFRESH ........................................................................................................................................ 62 9. Propriedades do Modelo Principal ........................................................................................................... 63 9.1. PREFERNCIAS ............................................................................................................................. 63 MAXIMUN NUMERIC LENGHT .......................................................................................................... 63 FUNCTIONS.......................................................................................................................................... .. 64 TIME FORMAT ....................................................................................................................................... 64

9.2. GERADORES .................................................................................................................................. 65 9.3. MODEL FORMS ............................................................................................................................. 65 9.4. PROMPTS ........................................................................................................................................ 66 10. Propriedades das Transaes ................................................................................................................ 67 10.1. TRANSACTION INTEGRITY INTEGRIDADE TRANSACIONAL .................................. 67 COMMIT ON EXIT ................................................................................................................................. 67 CONFIRM TRANSACTION ................................................................................................................... 68 10.2. USER INTERFACE INTERFACE COM USURIO .............................................................. 69 CONFIRMATION ................................................................................................................................. .. 69 WINDOWS INTERFACE ....................................................................................................................... 69 MenuBar ....................................................................................................................................... 69 Border Style .................................................................................................................................. 69

Maximize Button .......................................................................................................................... 70 Minimize Button ........................................................................................................................... 70 Form Icon ..................................................................................................................................... 70 Control Box .................................................................................................................................. 70 Modal Dialog ................................................................................................................................ 71 CHARACTER INTERFACE INTERFACE DE CARACTERES ........................................................ 71 Generate as a Popup Window ....................................................................................................... 71 Automatic Border Color ............................................................................................................ 72 Automatic Border Display Attribute.......................................................................................... 72 Automatic Border Characters .................................................................................................... 73 10.3. AS/400 SPECIFIC ESPECIFICAES AS/400 ...................................................................... 73

COMMITMENT ................................................................................................................................... ... 73 KEY ASSIGNMENT ............................................................................................................................... 74 Exit Key ........................................................................................................................................ 74 Prompt Key ................................................................................................................................... 74 Refresh Key .................................................................................................................................. 74 Insert Mode ................................................................................................................................... 74 Previous Record ............................................................................................................................ 75 Next Record .................................................................................................................................. 75 Retrieve ........................................................................................................................................ 75 Menu ............................................................................................................................................. 75 Update Mode ................................................................................................................................ 76

Cancel ........................................................................................................................................... 76 Delete Mode ................................................................................................................................. 76

5 Select ............................................................................................................................................ 76 First Record .................................................................................................................................. 77 Display Mode ............................................................................................................................... 77 More Keys .................................................................................................................................... 77 11. Propriedades das Work Panels ............................................................................................................. 78 11.1. LOADING .................................................................................................................................... 78 LOAD RECORDS ................................................................................................................................... 78 LOAD AT STARTUP .............................................................................................................................. 78 ALLOW USER TO CANCEL WHILE LOADING ................................................................................ 79 AUTOMATIC REFRESH ........................................................................................................................ 79

REFRESH TIMEOUT (Foxpro for Windows e Visual Basic) ................................................................. 79 11.2. WINDOWS INTERFACE ........................................................................................................... 80 MENUBAR ........................................................................................................................................... ... 80 BORDER STYLE .................................................................................................................................... 80 MAXIMIZE BUTTON ............................................................................................................................ 80 MINIMIZE BUTTON .............................................................................................................................. 81 FORM ICON ............................................................................................................................................ 81 CONTROL BOX ...................................................................................................................................... 81 MODAL DIALOG ................................................................................................................................... 81 11.3. CHARACTER INTERFACE ....................................................................................................... 82 GENERATE AS A POPUP WINDOW ................................................................................................... 82 AUTOMATIC BORDER ......................................................................................................................... 83 Automatic Border Color ............................................................................................................ 83

Automatic Border Display Attribute.......................................................................................... 83 Automatic Border Characters .................................................................................................... 83 11.4. AS/400 SPECIFIC ESPECIFICAES AS/400 ...................................................................... 84 KEY ASSIGNMENT ............................................................................................................................... 84 Exit Key ........................................................................................................................................ 84 Refresh Key .................................................................................................................................. 84 Cancel ........................................................................................................................................... 85 More keys ..................................................................................................................................... 85 12. Propriedades dos Relatrios ................................................................................................................. 86 12.1. OPTIONS ..................................................................................................................................... 86 REPORT OUTPUT .................................................................................................................................. 86 PROMPT FOR CONFIRMATION .......................................................................................................... 86

ALLOW USER TO CANCEL PROCESSING ........................................................................................ 86 FOOTER ON LAST PAGE ..................................................................................................................... 87 12.2. AS/400 SPECIFIC - ESPECIFICAES AS/400 ....................................................................... 87 KEY ASSIGNMENT ............................................................................................................................... 87 Exit Key ........................................................................................................................................ 87 Refresh Key .................................................................................................................................. 87 Cancel ........................................................................................................................................... 87 More keys ..................................................................................................................................... 88 13. Propriedades dos Procedimentos .......................................................................................................... 89 13.1. OPTIONS ..................................................................................................................................... 89 REPORT OUTPUT .................................................................................................................................. 89 PROMPT FOR CONFIRMATION .......................................................................................................... 89

ALLOW USER TO CANCEL PROCESSING ........................................................................................ 89 FOOTER ON LAST PAGE ..................................................................................................................... 90 13.2. TRANSACTION INTEGRITY INTEGRIDADE TRANSACIONAL ..................................... 90 COMMIT ON EXIT ................................................................................................................................. 90 13.3. AS/400 SPECIFIC ESPECIFICAES AS/400 ...................................................................... 92 COMMITMENT ................................................................................................................................... ... 92 KEY ASSIGNMENT ............................................................................................................................... 92 Exit Key ........................................................................................................................................ 92

6 Refresh Key .................................................................................................................................. 92 Cancel ........................................................................................................................................... 92 More keys ..................................................................................................................................... 93 14.

Propriedades das Web Panels ............................................................................................................... 94 14.1. FOOTER ...................................................................................................................................... 94 FOOTER IMAGE .................................................................................................................................... 94 WEBMASTERS MAIL ADDRESS ....................................................................................................... 94 15. Propriedades do Modelo Visual Basic ............................................................................................... 95 15.1. GENERAL ................................................................................................................................... 95 VISUAL BASIC VERSION .................................................................................................................... 95 GRID VERSION ...................................................................................................................................... 95 TARGET SYSTEM INTERFACE ........................................................................................................... 95 GENERATE MDI APPLICATION ......................................................................................................... 96 ALLOW COLUMN RESIZING .............................................................................................................. 97 SKIP READ-ONLY COLUMNS ............................................................................................................. 97 CONFIRM ............................................................................................................................................. ... 97 AUTOSKIP ............................................................................................................................................

.. 98 LOCK TYPE ............................................................................................................................................ 98 PSEUDO CONVERSATIONAL DIALOG ............................................................................................. 99 LOCAL DATABASE FILE ................................................................................................................... 100 MAIL FUNCTIONS .............................................................................................................................. 100 GRAPHIC FUNCTIONS ....................................................................................................................... 100 EXCEL OLE FUNCTIONS ................................................................................................................... 101 COMMOM DIALOG FUNCTIONS ..................................................................................................... 101 15.2. RIGHT BUTTON ....................................................................................................................... 103 CALCULATOR ON SECUNDARY NUMERIC FIELDS ................................................................... 103 CALENDAR ON DATE FIELDS ......................................................................................................... 103 15.3. PRINTING ................................................................................................................................. 103 LAN PRINTER ...................................................................................................................................... 104 SHOW PRINTER DIALOG ON REPORTS ......................................................................................... 104 PRINT METHOD ..................................................................................................................................

105 15.4. FORMAT ................................................................................................................................... 105 FIELD EXIT........................................................................................................................................... 105 ESC KEY ACTION ............................................................................................................................... 106 DECIMAL SEPARATOR ...................................................................................................................... 106 DATE FORMAT .................................................................................................................................... 106 DATE FORMAT IN CTOD FUNCTION (VISUAL BASIC) ............................................................... 107 TIME FORMAT ..................................................................................................................................... 107 FIRST YEAR OF 20 th CENTURY ........................................................................................................ 108 15.5. WEB INFORMATION .............................................................................................................. 108 PROTOCOL SPECIFICATION ............................................................................................................. 108 15.6. TYPE CHECKING .................................................................................................................... 109 CHECK TYPE ERRORS ....................................................................................................................... 109 FUNCTIONS.......................................................................................................................................... 112

15.7. KEY CONFIGURATION .......................................................................................................... 112 FIRST RECORD .................................................................................................................................... 112 LAST RECORD ..................................................................................................................................... 112 NEXT RECORD .................................................................................................................................... 112 PREVIOUS RECORD ........................................................................................................................... 112 REFRESH KEY ..................................................................................................................................... 112 PROMPT KEY ....................................................................................................................................... 112 15.8. ....................................................................................................................................................... ..... 113 15.9. OTHER ....................................................................................................................................... 113 MAXIMUN WORKFILE LINES .......................................................................................................... 113

7 1. Comandos GeneXus 1.1. Assign Atributo (Procedure) = Associa o valor de uma expresso para um atributo (Este comandoatualiza o banco de dados).A expresso associada a pode ser: um Atributo

uma Varivel uma Constante uma Funo uma Expresso Aritmtica (Data e tipo Numrico somente)A atualizao precisa ser feita dentro de um grupo FOR EACH ENDFOR.Vrias tabelas podem ser associadas a um grupo FOR EACH ENDFOR, porexemplo: Tabela Base Tabelas que podem ser acessadas pela Tabela Base (Tabelas Estendidas).Qualquer atributo dessas tabelas poder ser atualizado. 1.2. Assign Varivel (Transao, Procedure, Relatrio, Work Panel)& = Associa o valor de uma expresso para uma varivel.Algumas vezes necessrio definir clculos locais dentro de um objeto.GENEXUS torna isso possvel via VARIVEIS LOCAIS. Essas variveisexistem somente no ambiente do objeto correspondente e em nenhum outrolugar.A expresso associada a pode ser: Um Atributo 8 Uma Varivel Uma Constante Uma Funo (permitido quando uma associao utilizada) Uma Expresso Aritmtica (Data e tipo Numrico somente) 1.3. Call (Transao, Procedure, Relatrio, Work Panel)CALL([]Pgmname[],[parm1,parm2,...]Este

comando usado para chamar uma rotina externa ou um objetoGENEXUS. Parmetros podem ser atributos, variveis ou valores constantes.Todos os parmetros servem para entrada e sada, assim valores podem serretornados em qualquer dos parmetros.Se o programa que voc estiver chamando j existir, no ser necessrioescrever o nome entre apstrofos. GENEXUS ir checar se o programarealmente existe.O Nome do programa que ser chamado pode ser uma varivel ou umatributo. 1.4. Change Page (Procedure, Relatrio)CP Causa um salto de pgina quando faltarem menos linhas que napgina que est sendo impressa. Esse comando equivalente a: EJECT ifPagelenght Currentline for menor que . 1.5. Commit (Procedure, Relatrio, Work Panel)CommitFora um COMMIT quando includo em um programa.GENEXUS ir ativar o controle de Commitment para todas asProcedures e Transaes, se nenhum dos dois comandos NOCOMMITMENT ouNOENDTRN tiverem sido especificados, ser gerado um COMMIT no final daexecuo da Procedure ou Transao. 9 1.6. Confirm (Transao, Work Panel)Confirm(msg | & [,Y | N])Mostra uma mensagem e aguarda at o usurio informar Sim ou No.Mostra o texto/varivel (msg /&, respectivamente) em uma janela(ou linha de mensagem, dependendo do ambiente de trabalho) e aguarda umaresposta do usurio que pode ser Sim ou No. Em ambiente AS/400 osvalores possveis so F12=Cancel ou Reject e Enter=Accept ou Confirm. Parasaber se o operador confirmou ou rejeitou a mensagem, a funoCONFIRMED( ) usada. 1.7. Delete (Procedure)DeleteExclui o registro da Tabela Base associado ao grupo onde o comandoDELETE foi especificado.Regras: Um comando DELETE pode somente ser usado em um FOR EACH-ENDFOR. A Excluso executada exatamente no momento em que o comandoDELETE encontrado. A integridade referencial no automaticamente checada quando ocomando DELETE especificado.NOTA: Se o comando DELETE especificado em um grupo que contenhagrupos aninhados, os dados do grupo corrente podem ser usadosdentro dos grupos aninhados, embora eles no sero fisicamentedeletados.

Recomendao: primeiro exclua os nveis internos antes dos externos.Isto evita qualquer possvel cancelamento ou travamento do registro. 10 1.8. Do Nome Subrotina (Transao, Procedure, Relatrio, Work Panel e Web Panels)DO RoutineNamePermite voc chamar uma subrotina (definida usando o comando Sub).No permitida a passagem de parmetros; TODAS as variveis do mesmoprograma tambm podem ser utilizados pela subrotina. 1.9. Do While (Transao, Procedure, Relatrio, Work Panel e Web Panels)Do while EnddoSero executados todos os comandos entre o DO WHILE e o ENDDOenquanto a condio for verdadeira. Para forar a sada do grupo do DOWHILE pode ser usado o comando EXIT. 1.10. Eject (Procedure, Relatrio)EjectEste comando fora um salto de pgina no programa gerado, quando asada selecionada est associada a impressora, ou limpa a tela quando a sadaest associada a tela. 1.11. Error_Handler (Transao, Procedure, Relatrio, Work Panel)Implementado para tratamento de erros para Client/Server.A regra/comando error_handler prov uma maneira dinmica paraexecutar aes especficas quando um erro no database relatado em tempode execuo do programa.Quando usado como regra, a sintaxe : Error_handler(subname).Quando usado como comando, a sintaxe : Error_handler([subname]),onde, subname o nome de uma subrotina. 11 1.12. Exit (Transao, Procedure, Relatrio, Work Panel)ExitO comando Exit permite abandonar um grupo For Each, Xfor Each ou DoWhile. O prximo comando a ser executado aps um exit o prximo comandoaps o comando EndFor, XendFor ou EndDo correspondente ao grupo quecontm o comando Exit.NOTA: O comando Exit no valido dentro de um FOR EACH LINE. 1.13. Footer (Procedure, Relatrio)FooterEndDefine as linhas de rodap a serem impressas no final de cada pgina.Os comandos entre a clusula FOOTER e a clusula END so executadasquando chega-se ao final da pgina. FOOTERS podem tambm ser definidoscom um FOR EACH dentro, da mesma forma como HEADERS pode.Se existirem linhas de impresso entre o FOOTER e o END, elas iro serimpressas dentro da margem inferior (parmetro MB). Se as linhas deFOOTER no couberem dentro da rea da margem inferior a impresso ircontinuar na prxima pgina. 1.14. For Each (Procedure, Relatrio, Work Panel)For each [order ...][Where ] [Defined by ...]EndforDefine um grupo de atributos genricos por operaes, o comando ForEach usado para definir acesso ao Banco de Dados.No existem referncias explcitas para tabelas em um FOR EACH. Vocsomente precisa mencionar QUAIS os Atributos que voc precisa, e o Genexus 12 resolve o problema de COMO encontr-los. A maneira COMO GENEXUS vaiefetuar a navegao

pode ser vista no relatrio de Especificao. Para foraruma sada de um grupo FOR EACH voc pode usar o comando EXIT.Existem dois tipos de tabelas associadas a um grupo FOR EACH: Uma TABELA BASE. Tabelas que podem ser alcanadas pela Tabela Base, conhecidas comoTabelas Estendidas.Se existirem atributos que no faam parte da Tabela Base nem dasTabelas Estendidas ir aparecer uma mensagem de erro no relatrio deEspecificao e o programa no ser gerado. CLUSULA ORDER ORDER < Lista de Atributos >A ordem para acessar a Tabela Base de um for Each pode serespecificada por uma lista ordenada de atributos, informados logo aps ocomando FOR EACH.NOTA: A clusula ordem bastante usada para definir quebras (Break)em grupos For Each aninhados. Uma quebra definida sempre que ns temos amesma tabela base em dois grupos For Each, os atributos da Quebra estodefinidos pelo conjunto de atributos especificados na clusula Ordem. CLUSULA WHERE WHERE A clusula WHERE pode ser especificada para estabelecer uma condiopara o grupo For Each EndFor.Regras: Vrios comandos WHERE podem ser especificados aps um FOREACH. Neste caso, as condies WHERE funcionaro como se elasestivessem separadas por um operador .AND.. Um comando WHERE pode, somente, ser especificado imediatamenteaps um FOR EACH ou aps outro comando WHERE. 13 CLUSULA DEFINED BY DEFINED BY < Lista de Atributos >Este comando permite definir a Tabela Base de um grupo FOR EACH -ENDFOR.Geralmente quando se est definido Procedures/Reports/Work Panels,os atributos dentro do FOR EACH determinam a Tabela Base. Algumas vezes,os atributos dentro do grupo no determinam exatamente a Tabela Base (ex.:mais de uma tabela pode ser encontrada como Tabela Base). Assim necessrio declarar um grupo para determinar qual a Tabela Base que tem maisprioridade, informando uma Lista de Atributos na clusula DEFINED BY. 1.15. For Each Line (Work Panel)For each lineEndForFora o processamento de todas as linhas (carregadas) no subfile emuma Work panel.Esse comando pode ser usado, por exemplo, para marcar todas as linhasque satisfaam uma certa condio.FOR EACH LINE tem as seguintes restries: Ele somente ir processar os registros que foram carregados nosubfile. Se voc quiser processar

todos os registros do Subfile, aregra LOAD ALL precisa ser usada. Ele processa todas as linhas, tenham elas sido modificadas ou no. 1.16. For Each Selected line (Work Panel)For each select lineEndForEsse comando funciona de forma similar ao for each lline, pormsomente sero consideradas as linhas marcadas (selecionadas). 1.17. Graph (Work Panel)graph([,][]); 14 Permite gerar um grfico a partir das informaes contidas no Subfile.Isto pode somente ser utilizada por programas gerados para Foxpro forWindows ou Visual Basic. Quando gerado no Foxpro for Windows, o programaMS-GRAPH (Includo no Foxpro for Windows) executado sempre que essecomando for localizado. contedo do subfile usado como o dado para o grfico e o usurio podeescolher qual o tipo de grfico que ser usado. possvel alterar os valores,imprimir o grfico e v-lo em 3D, etc. Este comando ir armazenar todas asdefinies do grfico (portanto o Graph Wizard no precisa ser usadotodas as vezes).Onde: corresponde ao caminho e nome para o arquivo quecontm o grfico.Se o arquivo correspondente ao grfico no existir, o GraphWizard ser chamado. Uma vez que o grfico definido vocprecisar salv-lo com o mesmo nome usado em . Se vocquiser modificar a definio do grfico voc precisa dar um duploclique sobre a janela do grfico. uma lista com os atributos e variveis do Subfile que devemser includs no grfico. O eixo X pode receber qualquer type varivel(caractere, data ou numrico) e todas as outras variveis precisamser numricas (eixo Y). 1.18. Header (Procedure, Relatrio)HeaderEndDefine o cabealho a ser impresso no topo de cada pgina.O primeiro grupo no Layout padro das Procedures/Reports o grupoHEADER. Os dados dentro desse grupo so impressos no incio de cada pginado relatrio.Voc pode tambm definir um cabealho para cada FOR EACH definidono Layout. 15 1.19. If (Transao, Procedure, Relatrio, Work Panel)If [Else]EndifExecutam um bloco de comando se a condio for avaliada comoverdadeira. 1.20. Line Number (Procedure, Relatrio)Lineno Especifica o nmero da linha onde o dado ser impresso.

1.21. Load (Work Panel)LoadEste comando fora a carga de uma nova linha dentro do subfile.Ela bastante usada quando o Work Panel no tem uma tabela Base, econsequentemente a carga precisa ser feita na mo ou quando precisamosfazer filtros com atributos de vrias tabelas. 1.22. Margin Botton (Procedure, Relatrio)MB Configura o nmero de linhas em branco no final de uma pgina.Se margin Botton no for especificado, 6 linhas sero assumidas( = 6). 16 1.23. Margin Top (Procedure, Relatrio)MT Define o nmero de linhas em branco no topo da pgina. 1.24. Message (Transao, Procedure, Relatrio, Work Panel)Msg(msg | & [,nowait] [,status])Usado para mostrar mensagens de aviso. Pode mostrar um literal ou umavarivel contendo uma mensagem. Nowait: Armazena a mensagem em uma varivel interna e continua oprocessamento. O usurio no ir ver mensagem at que o processamento doprograma se encerre. Isto garante uma melhor performance com menos telasde I/O requeridas. Status: A mensagem mostrada no momento em que originada. Ela usadaprincipalmente para dar ao usurio informaes sobre status deprocessamento. Nenhuma Opo Especificada: Exibe a mensagem e aguarda pelopressionamento do . 1.25. New Record (Procedure)New[When Duplicate]EndNewO comando NEW insere um registro na Tabela Base determinada peloatributo no grupo NEW-ENDNEW. Chaves duplicadas so checadas.Se a chave j existir, todos os comandos entre o WHEN DUPLICATE e oENDNEW sero executados. Caso voc deseje fazer alguma alterao nesseregistro j existente, um grupo FOR EACH ENDFOR precisa ser especificadodentro do WHEN DUPLICATE. 17 1.26. NoSkip (Procedure, Relatrio)NoSkipInibe salto de linhas de impresso consecutivas.Este comando precisa ser colocado imediatamente aps o print block. 1.27. Page Length (Procedure, Relatrio)PL Configura o tamanho da pgina para Reports/Procedures.O nmero de linhas que sero impressos o nmero especificado por, menos a margem inferior (valor default 6). 1.28. Print If Detail (Procedure, Relatrio)Print if DetailEvita a impresso do registro se no existirem registros no Subfile.Este comando precisa ser especificado sempre que voc quiser inibir oprocessamento de um FOR EACH caso no haja registros de detalhe para ele.Ele pode ser colocado em qualquer lugar dentro de um grupo. 1.29. PrinterCommand

(Procedure, Relatrio)PrnCmd Manda seqncias de controle para a impressora. um string caracter contendo caracteres ou um cdigoASCII de 3 dgitos precedido por uma \ onde no mnimo um espao separa oPRNCMD and . Os parmetros dependem de cada impressora epodem ser encontrado no Manual da Impressora. 18 1.30. Refresh (Work Panel)Refresh [Keep]Atualiza as informaes mostradas no subfile. Opo KEEP: Este parmetro indica que quando o comando Refresh for executado, oSubfile ser posicionado sobre o registro que estava em foco anteriormente. 1.31. Return (Transao, Procedure, Relatrio, Work Panel)ReturnEncerra o programa e retorna a execuo ao programa que o chamou. 1.32. RollBack (Transao, Procedure, Relatrio, Work Panel)RollBackO comando ROLLBACK invalida um conjunto de alteraes do banco dedados em uma LWU (Logical work Unit).Consideraes:O comando ROLLBACK ignorado pelos ambientes que no usamIntegridade Transacional. 1.33. Submit (Transao, Procedure, Relatrio, Work Panel)SUBMIT(Usr-pgm,SubmitParms[ ...])Processa certas tarefas da aplicao em modo batch .Os ambientes que no permitem a execuo de tarefas batch (como oDOS) consideram o SUBMIT como se fosse um comando CALL e ignoram osparmetros especficos do SUBMIT. 19 1.34. Subroutine (Transao, Procedure, Relatrio, Work Panel)Sub RoutineNameEndSubPermite que sejam definidas rotinas que sero disparadas quando umcomando DO for executado. Todas as variveis do mesmo programa fonte podetambm ser usadas dentro da subrotina. 1.35. Xfor Each (Procedure, Relatrio, Work Panel)Xfor each [INDEX ]Where XendforDefine um loop interativo para um arquivo externo (File View), usandondice especificado (se existir) e filtra dados de acordo com a condiodeclarada na opo WHERE. 1.36. Xfor First (Procedure, Relatrio, Work Panel)Xfor first [INDEX ]Where XendforEste comando similar ao comando XFOR EACH, porm ele no fica emloop. Ele retorna o primeiro registro (se existir um registro) de um arquivoexterno utilizando o ndice especificado e filtrando dados de acordo com acondio declarada na opo WHERE. 1.37. Xnew (Procedure)Xnew Xendnew 20

O comando XNEW insere um registro em um File View (arquivo externo). 2. Regras dos Objetos GeneXus 2.1. ACCEPT (Transaes)Accept(&varivel, Atributo);Esta Regra permite aceitao de uma Varivel em Tela.A ordem da entrada do valor para a Varivel em um Nvel, depender daposio das Variveis e dos Atributos na Tela. 21 2.2. ADD (Transaes)Add( Atributo1, Atributo2) if Condio;Esta regra adiciona o valor de Atributo1 ao Atributo2, se a Condio foravaliada como verdadeira.Esta Adio leva em conta as operaes de Insero, Atualizao eRemoo.Exemplo:Add( Qtdcompra, Qtdestq);Se o atributo Qtdcompra for atualizado, o Atributo Qtdestq tambm oser, pelo valor diferencial da atualizao. 2.3. ALLOWNULLS (Transaes)Allownulls( Atrib1, Atrib2, ..., AtribN )Esta regra usada para permitir valores NULOS para atributos nosquais so feitos verificao da integridade referencial. 2.4. (Transaes, Relatrio/Procedimentos)Atributo | &Varivel = Expresso IF Condio;Esta regra usada para assinalar o valor de uma expresso a um dadoatributo. Em contraste com Frmulas , o valor atribudo ao Atributo ou varivel somente quando a Transao estiver sendo processada. 2.5. CALL (Transaes, Procedimentos, Relatrios, Work Panels)CALL(Prog_usurio,Par1,...,Parn) IF Condio;Desvia a execuo temporariamente para outro programa.O Prog_usurio, que pode ser: um nome de programa, atributo ouvarivel, ser chamado sempre que a Condio for avaliada como Verdadeira.Exemplo: 22 &Pgm = WProgCall(&Pgm, &V1,&V2); 2.6. COLOR (Transaes, Work Panels)Color( ); //Permite a definio das cores default para tela.Color(,[|)(if ]; //Define cores para atributosou variveis.Onde: = [,] = = = [/ ] = [ ] = WHT | BLK | RED | GRN | BRW | MGNBLU | CYN | YLW | RI | X = + | *Cada define a cor de frente e a cor de fundo.Abreviaturas de Cores: WHT = brancoBLK = pretoRED = vermelhoGRN = verdeBRW = marromMGN = magentaBLU = azulCYN = cinzaYLW = amareloRI = imagem reversaX = escondidoUm asterisco (*) em representa um elemento BLINKING eum sinal mais (+), em HIGHLIGHTS.Ex.: color(RED+, Saldo) if saldo < 0;Color(WHT, Saldo) if saldo > = 0; 2.7. DEFAULT (Transaes, Procedimentos/Relatrios, Work Panels)

23 Default( Atributo, xxx);Onde xxx pode ser: Atributo, Constante ou Funo.Esta Regra assinala o valor de xxx ao Atributo no momento da Insero,e permite que o usurio mude esse valor.Exemplo: Default(Peddat, today( ) ); Esta regra no vlida para um Atributo que faa parte de umaChave. 2.8. DEFAULT MODE (Transaes)Default_mode(Ao, Atributo); usada para forar um modo especfico em um Nvel de Transao.Ao: Pode ser uma das seguintes: INSERT, UPDATE ou DELETE.Atributo: usado para indicar o Nvel. Se no for especificado nenhumAtributo, ser assumido o primeiro Nvel. 2.9. EQUAL (Transaes)Equal( Atributo, xxx);Onde xxx pode ser: Atributo, Constante ou Funo.Esta Regra assinala o valor de xxx ao Atributo no momento da Insero .Esse valor no pode ser mudado pelo usurio. 2.10. ERROR (Transaes)Error(Texto de Mensagem) IF Condia; 24 Esta Regra faz com que a string definida em Texto de Mensagem sejaapresentada na Janela de Erro da Transao, se a condio for avaliada comoverdade.Todo processamento subsequente, inclusive outras regras, no seroexecutadas. Portanto, se muitas regras estiverem associadas a uma nicacondio, a regra Error dever ser a ltima, para que as outras possam serexecutadas. 2.11. ERROR_HANDLER (Transao, Procedure, Relatrio, Work Panel)Implementado para tratamento de erros para Client/Server.A regra/comando error_handler prov uma maneira dinmica paraexecutar aes especficas quando um erro no database relatado em tempode execuo do programa.Quando usado como regra, a sintaxe : Error_handler(subname);Quando usado como comando, a sintaxe : Error_handler([subname])Onde:Subname o nome de uma subrotina. 2.12.2.13. HIDDEN (Work Panels)Hidden(,,...,);Esta regra usada para incluir atributos ou variveis especficas noSubfile, que eventualmente no aparecem na tela. Ela bastante utilizadaquando precisa-se de um cdigo no Subfile, mas no se quer que ele aparea natela. 25 2.14. MSG (Transaes)Msg(Texto de Mensagem) IF Condio;Esta regra usada para enviar mensagens de aviso para o operador. Astring definida em Texto de Mensagem ser apresentada na Janela de erroda Transao se a for avaliada como verdade. 2.15. NOACCEPT (Transaes, Work Panels)Noaccept( Atributo | &Varivel) IF Condio;GeneXus avalia quais Atributos so entrada de dados, e quais Atributosso sada de dados. Todavia, pode haver ocasies em que no se deseja que ousurio introduza dados, dependendo de uma condio.Esta regra faz com que a Transao no aceite a digitao de dados parao Atributo ou varivel associado. 2.16. NOCHECK

(Transaes)Nocheck( Atributo1, Atributo2, ..., Atributon);A regra Nocheck usada para inibir a checagem de integridadereferencial. 2.17. NOCONFIRM (Transaes)Noconfirm(Atributo);A regra Noconfirm usada para evitar a confirmao no Nvel. Quandose passa de um Nvel para o seguinte, uma mensagem apresentada, pedindo aconfirmao dos dados. Para se evitar o pedido de confirmao, usa-se estaregra.Atributo: usado para indicar o nvel. Se no for especificado nenhumatributo, ser assumido o primeiro nvel. 26 2.18. NOREAD (Procedimentos/Relatrios, Work Panels)Noread(,,...,);Essa regra permite inibir a leitura de uma tabela que navegada emostrada no diagrama de navegao quando especificado. 2.19. NOPROMPT (Transaes)Noprompt( Atrib1, Atrib2, ..., AtribN)Atrib1, Atrib2, AtribN so identificadores da chave da tabela.Essa regra usada para evitar o Prompt (Visualizar) quando se entracom um valor para a Chave Estrangeira que no existe na Tabela. 2.20. ORDER (Work Panels)Order(,,...,);Estabelece a ordem de leitura da tabela base da Work Panel.Se essa regra omitida, a chave primria da tabela base ser usada. 2.21. PARM (Transaes, Procedimentos/Relatrios, Work Panels)Parm( Par1, Par2, ..., Parn);Recebe os programas enviados por outro programa. Obs.: Transaes que possuem a regra PARM( ) no aparecem noMenu. 27 Quando um Objeto chamado de outro programa, osparmetros recebidos pela regra PARM( ) so consideradoscomo uma regra Equal. 2.22. PRINTER (Procedimentos/Relatrios)Printer();Seleciona o arquivo de impresso a ser usado pelo AS/400 ou o nome daimpressora, definido por uma varivel de ambientes DOS, na gerao Xbase. 2.23. PROMPT (Transaes)Prompt(Programa, Atrib1, Atrib2, ... , AtribN);Chama o programa definido, ao invs do programa default criado peloGeneXus, quando seleciona-se Visualizar. 2.24. REFCALL (Transaes)Reffcall(Nome_prog, Atrib1, ... , AtribN);Esta regra usada para chamar um

Programa quando a integridadereferencial tenta ser quebrada. 2.25. REFMSG (Transaes)Refmsg(Texto, Atrib1, ..., AtribN) 28 Esta regra usada para mudar as mensagens geradas por GeneXusquando verificando as Integridades Referenciais em tempo de Insero ou Atualizao. Exemplo: Refmsg(O CLIENTE NO ESTA CADASTRADO, Clicod); 2.26. SEARCH (Work Panels)Search();Seleciona um posicionamento condicional para o subfile.A diferena dessa regra para uma condition que ela no filtra os dadosdo subfile, ela somente posiciona o ponteiro. 2.27. SERIAL (Transaes)Serial( Atributo1, Atributo2, Passo);Esta regra faz com que o Atributo1 seja incrementado para o valorcontido em Atributo2 mais o valor do Passo, toda vez que um novo registro foradicionado Tabela onde Atributo1 esteja.Se Atributo1 no faz parte do Identificador, o usurio dever digitarum valor que no existe, para que Atributo1 assuma o modo INSERO, ereceba o prximo valor serializado. 2.28. SUBMIT (Transaes)SUBMIT(Usr-pgm,SubmitParms[,,,...])[IF ];Processa relatrios e procedimentos em modo batch, desde que essesno tenham interaes com o usurio. 2.29. SUBTRACT (Transaes)Subtract( Atributo1, Atributo2) if condio; 29 Esta regra Subtrai o valor de Atributo1 do Atributo2, se a Condio foravaliada como verdadeira. Esta Subtrao leva em conta as operaes deInsero, Atualizao e Remoo.Exemplo: Subtract( Qtd, Qtdestq); 2.30. WORKFILE_LINES (Work Panels)Workfile_lines();Estabelece o tamanho mximo para o subfile.Os Subfiles em um ambiente PC so carregadas em um arquivotemporrio. O tamanho mximo para o subfile no AS/400 de 9.999 linhas,contudo, no existem restries quando PC ou LANs so usados.Esta liberdade pode causar problemas, por exemplo, se voc esttrabalhando com uma Work Panel ou Transao que carrega 300.000 registrosda tabela base e o usurio vai para o fim do arquivo (CtrlEnd). Neste caso umarquivo temporrio contendo 300.000 registros ser gerado. 2.31. XORDER (Work Panels)Essa regra utilizada em Work Panels que utilizam arquivos externos.Ela indica qual o arquivo base do subfile, e qual ndice ser usado paracarreg-lo (caso no seja indicado, a ordem fsica ser usada).

30 3. Funes Disponveis no GeneXus 3.1. DAY (Transaes, Procedimentos/Relatrios, Work Panels)Day()Tipo retornado: N(2)Retorna o dia de uma data informada. Se for uma data nula, ovalor 0 ser retornado. 3.2. MONTH (Transaes, Procedimentos/Relatrios, Work Panels)Month()Tipo retornado: N(2)Retorna o nmero do ms de uma data informada. Um valor nulo (0) serretornado se a no for uma data nula. 31 3.3. YEAR (Transaes, Procedimentos/Relatrios, Work Panels)Year()Tipo retornado: N(4)Retorna o ano de uma data informada. Se no for uma data vlida,um valor nulo ser retornado. 3.4. TODAY (Transaes, Procedimentos/Relatrios, Work Panels)Today( )Tipo retornado: DateRetorna a data do sistema operacional. 3.5. NOW( ) (Transaes, Procedimentos, Relatrios, Work Panels, Web Panels)Now( )Tipo retornado: DatetimeRetorna a data e a hora corrente. 3.6. HOUR, MINUTE, SECONDS (Transaes, Procedimentos, Relatrios, Work Panels, Web Panels)Hour( ) / Minute() / Seconds();Tipo retornado: NumricoRetorna um valor numrico representando as horas/minutos/segundosrespectivamente, no formato da hora informado do datetime. 32 3.7. DOW (Transaes, Procedimentos/Relatrios, Work Panels)Dow()Tipo retornado: N(1)Retorna um nmero entre 1 e 7. Este nmero est associado ao dia dasemana (Domingo=1).Se a data contida em for nula, o valor retornado ser 0. 3.8. CDOW (Transaes, Procedimentos/Relatrios, Work Panels)Cdow([])Tipo retornado: C(9)Retorna o nome do dia da semana de uma determinada data na linguagemselecionada. Espaos sero retornados se o valor de for invlido. deve ser uma das seguintes (caso no seja informada, serutilizada a linguagem selecionada no Model Properties):spa Espanholeng Inglspor Portugusita - Italiano 3.9. CMONTH (Transaes, Procedimentos/Relatrios, Work Panels)Cmonth([ , ])Tipo retornado: C(9)Retorna o nome do ms da data informada na linguagem selecionada. Senenhuma linguagem for selecionada, ser utilizada a que estiver definida emModel Properties. 3.10. CTOD

(Transaes, Procedimentos/Relatrios, Work Panels)Ctod(nn/nn/yy) 33 Converte uma String em Data.A string de caracteres pode ser mm/dd/yy ou dd/mm/yy dependendoda linguagem corrente, onde: mm representa o ms com dois dgitos; ddrepresenta o dia com 2 dgitos; yy representa a ano com 2 dgitos.Em ambiente Micro, o valor default depende da linguagem selecionada:Ingls mm/dd/yyPortugus/Espanhol dd/mm/yy 3.11. CTOT (Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)CtoT(nn/nn/yy hh[:mm[:ss]] [AM|PM])Tipo retornado: C(9)Converte uma String em DateTime. A primeira parte dos parmetrosrepresenta a data e a segunda parte a hora.nn/nn/yy tem o formato M/D/A ou o especificado na preferncia Dateformat in CTOD function.Se AM|PM especificado, hh pode variar de 0-12. Caso contrrio, irvariar entre 0-23.{00:00:00AM} equivalente a {12:00:00AM}, Meia-noite{00:00:00PM} equivalente a {12:00:00PM}, Meio-dia{00:00:00} a {11:59:59} equivalente a {12:00:00AM} a {11:59:59AM}{12:00:00} a {23:59:59} equivalente a {12:00:00PM} a {11:59:59PM}24:00:00 no uma hora vlida.Notas: A data e a hora da string de parmetros devem ser separados porpelo menos um branco. Se qualquer parte da string (data e hora) for omitido, assumidonulo. Se qualquer parte da string no vlida, o DateTime resultante sernulo. Se no for especificdo nem AM nem PM, o formato 24-horas assumido. 34 3.12. DTOC (Transaes, Procedimentos/Relatrios, Work Panels)Dtoc()Retorna a String associada a data especificada. 3.13. TTOC (Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)TtoC( [ ,M[ ,N]])Tipo retornado: CaractereRetorna caractere associado ao DateTime, com o formato especificadopor M e N.Os valores possveis para M e N so os mesmos usados na definio dotipo DateTime.Valores possveis para M:0 Data no pedida nem mostrada8 Data mostrada em 8 dgitos (99/99/99)9 Data mostrada em 10 dgitos (99/99/9999)Valores possveis para N:2 Somente a parte das horas

mostrado no formato 24 horas5 Hora e minuto so mostrados separados pelo smboloseparador de horas. O formato 24 horas utilizado.8 Hora completa mostrada (incluindo segundos). O formato24 horas usado. possvel tambm setar valor nulo (0) para N. Neste caso, somente aparte da data obtido.Exemplos: TtoC( DT, 8, 0)TtoC( DT, 10, 0)TtoC( DT, 0, 0) NO vlido.Notas: No caso de M e/ou N serem omitidos, seus valores default so osparmetros utilizados para definio do DateTime (primeiroparmetro). No caso da combinao M/N no ser vlida, os valores assumidos so:M=10 e N=8. 35 O formato da string retornada o mesmo da funo CtoT, ou seja, adata depende da preferncia Date format in CtoD function e a hora sempre no formato 24 horas. 3.14. YMDTOD (Transaes, Procedimentos/Relatrios, Work Panels)Ymdtod(,,)Retorna a data onde o ano, o ms e odia., e devem ser expresses numricas. 3.15. YmdHmstoT (Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)YmdHmstoT( , , [ , [ , [ ,]]])Tipo retornado: Date TimeRetorna um Date Time associado a data e hora especificados noparmetro. Parmetros omitidos assumem o valor zero. Todos os parmetrosso expresses numricas.NExp1 representa o ano. Este valor no se ajusta ao que for indicadona preferncia First year of 20 th century.NExp2 representa o ms.NExp3 representa o dia.NExp4 representa a hora. Hora deve ser especificado no formato 24-horas.NExp5 representa os minutos.NExp6 representa os segundos.Nota: Se somente um dos componentes (dat ou hora) vlido, somenteeste ser considerado. Por exemplo: YMDHMStoT(1990, 31, 2, 12, 10, 15) irretornar um datetime vlido com a parte da data nula. A hora ser 12:10:15. 3.16. ADDMTH (Transaes, Procedimentos/Relatrios, Work Panels)Addmth(,) 36 Retorna a data referente a adio de meses para .Um valor nulo retornado se for uma data invlida. 3.17. ADDYR

(Transaes, Procedimentos/Relatrios, Work Panels)Addyr(,)Retorna a data correspondente a mais anos. 3.18. AGE (Transaes, Procedimentos/Relatrios, Work Panels)Age([ ,])Retorna a quantidade de anos entre e .Se no for especificada, a funo Today( ) assumida. 3.19. EOM (Transaes, Procedimentos/Relatrios, Work Panels)Eom()Retorna o nmero do ltimo dia correspondente ao ms referente a datainformada. 3.20. TDIFF (Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)TDiff( , )Tipo retornado: Numrico.Retorna os segundos da diferena entre dois DateTime recebidos comoparmetros (DateTimeExpr1 DateTimeExpr2)Se DateTimeExpr2 for maior que DateTimeExpr1, um valor negativoser retornado. 37 3.21. TADD (Transaes, Procedimentos, Relatrios, Work Panels e Web Panels)TAdd( , )Tipo retornado: DateTimeSoma os segundos informados em ) ao datetime. 3.22. ASK (Transaes, Procedimentos/Relatrios, Work Panels)Ask(msg text)Pede ao usurio para que informe o valor de um Atributo ou varivelantes de entrar no objeto.msg text a mensagem que ser mostrada quando for solicitado o valor.Exemplo:&CliIni = ask(Cliente Inicial: );&CliFin = ask(Cliente Final: ); 3.23. UDF (Transaes, Procedimentos/Relatrios, Work Panels)Udf(Usr-Pgm, Par1, .., Parn)Chama uma rotina que no usa tabelas e retorna um resultado.Programas que NO USAM TABELAS podem ser referenciados usando afuno UDF.Quando voc escreve o cdigo para UsrPgm, deve incluir um parmetroa mais no final da lista de parmetros, que dever conter o valor retornadopara a funo. Os outros parmetros no podero retornar nenhum valor.Exemplo: TotalPoints = UDF(PCalPts, PilotNbr) 3.24. UDP (Transaes, Procedimentos/Relatrios, Work Panels)Udp(Usr-pgm, Paar1, ..., Parn) 38 A funo UDP chama um programa que pode USAR TABELAS e retornaum valor.Quando o cdigo para o programa UsrPgm for escrito, dever serincludo no final da lista de parmetros, um parmetro o qual conter o valorque ser retornado pela funo.Note que a funo UDP fecha as tabelas antes da chamada ser feita, eabre-as novamente aps retornar. Se Usr-Pgm no usa tabelas, a funo UDF recomendada para que ganhe performance. 3.25. ROWS (Procedimentos/Relatrios, Work Panels)Rows(&Array( ))Retorna o nmero de linhas definidas para um vetor.

3.26. COLS (Procedimentos/Relatrios, Work Panels)Cols(&Array( ))Retorna o nmero de colunas de um vetor bidimensional. 3.27. TIME (Transaes, Procedimentos/Relatrios, Work Panels)Time( )Retorna a hora no formato hh:mm:ss.No AS/400, esta funo retorna a hora inicial do JOB.No ambiente Micro/LAN, retorna a HORA DO SISTEMA, assim Time( )e SYSTIME( ) so equivalentes. 39 3.28. SYSTIME (Transaes, Procedimentos/Relatrios, Work Panels)Systime( )Retorna a hora do sistema no formato hh:mm:ss. 3.29. SYSDATE (Transaes, Procedimentos/Relatrios, Work Panels)Sysdate( )Retorna a data do sistema. 3.30. USERCLS (Transaes, Procedimentos/Relatrios, Work Panels)Usercls( )Retorna a classe do Usurio definida no User Profile. Esta regra vlidasomente no AS/400. 3.31. USERID (Transaes, Procedimentos/Relatrios, Work Panels)Userid( )No ambiente AS/400, esta funo retorna a identificao do usuriodefinida no User Profile.No ambiente Micro/Lan esta funo retorna o contedo da varivel deambiente do DOS chamada LOGNAME. Para habilitar o uso dessa funo, essavarivel dever ser criada para todas as estaes.Em um ambiente Client/Server esta funo retorna a identificao dousurio conectado ao servidor. 3.32. WRKST (Transaes, Procedimentos/Relatrios, Work Panels)Wrkst( ) 40 Retorna a identificao da Estao de Trabalho correspondente.Em ambiente Micro/Lan retorna o contedo da varivel de ambiente doDOS, PSTATION. Para habilitar o uso dessa funo, voc precisa setar estavarivel de ambiente. 3.33. STR (Transaes, Procedimentos/Relatrios, Work Panels)Str(N1 [ ,N2 [ ,N3]])Converte o valor da expresso numrica em para uma stringcaracter, alinhado pela direita, o tamanho total de (incluindo osinal e o ponto decimal), e o nmero de decimais. Se voc especificarmenos decimais do que a expresso numrica possui, o valor serarredondado.Notas: Zeros no significativos sero truncados. O valor Default para N2 = 10

O valor Default para N3 = 0 3.34. SUBSTR (Transaes, Procedimentos/Relatrios, Work Panels)Substr(S1,N1,N2)Retorna a substring de um dado informado.Retorna a substring de S1 comeando na Posio N1, com um tamanho deN2 caracteres. 3.35. CONCAT (Transaes, Procedimentos/Relatrios, Work Panels)Concat( S1, S2 [ ,S3])Concatena duas strings incluindo um separador se informado. 41 Retorna a string resultante da concatenao de S1 e S2 e o separadorS3. Os brancos das strings S1 e S2 so truncados. Se S3 no for especificado,no sero inseridos separadores. 3.36. SPACE (Transaes, Procedimentos/Relatrios, Work Panels)Space()Retorna uma string caracter com a quantidade informada de espaos embranco.No AS/400, o atributo ou varivel que recebe a funo, sercompletamente preenchido com espaos, independente do valor informado parao argumento. 3.37. LEN (Transaes, Procedimentos/Relatrios, Work Panels)Len(S1)Retorna o nmero de caracteres de uma expresso. 3.38. TRIM (Transaes, Procedimentos/Relatrios, Work Panels)Trim()Remove todos os brancos a esquerda e a direita da expresso caracter informada. 3.39. LTRIM (Transaes, Procedimentos/Relatrios, Work Panels)LTrim () 42 Remove todos os brancos a esquerda da expresso caracter . Estafuno especialmente til para remover os brancos que so inseridos quandovoc utiliza a funo Str( ) para converter um valor numrico para uma stringcaracter. 3.40. RTRIM (Transaes, Procedimentos/Relatrios, Work Panels)Rtrim()Remove os brancos a direita de uma string caracter informada. 3.41. UPPER (Transaes, Procedimentos/Relatrios, Work Panels)Upper()Retorna a correspondente maiscula da string . Cada letraminscula (a - z) convertida em letra maiscula (A - Z) no resultado dafuno, todos os outros caracteres permanecem inalterados. 3.42. LOWER (Transaes, Procedimentos/Relatrios, Work Panels)Lower( )Converte todas as letras maisculas (A Z) da expresso caracter para letras minsculas (a z). Todos os outros caracteres da expressopermanecero inalterados. 3.43. INT (Transaes, Procedimentos/Relatrios, Work Panels)Int( )Esta funo retorna a parte inteira da expresso .

43 3.44. ROUND (Transaes, Procedimentos/Relatrios, Work Panels)Round(,)Arredonda o valor de para casas decimais. 3.45. TRUNC (Transaes, Procedimentos/Relatrios, Work Panels)Trunc(,)Trunca o valor de para decimais. 3.46. VAL (Transaes, Procedimentos/Relatrios, Work Panels)Val()Esta funo converte um nmero de uma expresso caracter para umvalor do tipo numrico. Ela processa os nmeros em uma expresso caracter daesquerda para a direita at que um caracter no numrico encontrado. 3.47. COLOR (Procedimentos/Relatrios, Work Panels)Color();Color(,[|&]) [IF ];Permite o uso de cores para os atributos, variveis e tela.(Idem a regra COLOR). 3.48. RGB (Procedimentos/Relatrios, Work Panels)RGB( ,,) 44 Retorna um nmero representando um valor de cor RGB, dados os 3seguintes parmetros: Red : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente vermelho da cor. Green : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente verde da cor. Blue : Nmero na faixa de 0 at 255, inclusive, que representa ocomponente azul da cor.Um valor de cor RGB especifica a intensidade relativa de vermelho,verde e azul para gerar uma determinada cor. 3.49. NULL (Transaes, Procedimentos/Relatrios, Work Panels)Null()Retorna um valor Boleano true se o valor do atributo ou varivel fornulo. O valor nulo para campos do tipo Numrico zero, e para campos tipoCaracter e Data uma string em branco. 3.50. NULLVALUE (Transaes, Procedimentos/Relatrios, Work Panels)Nullvalue()Retorna um valor nulo do mesmo tipo da definio do Atributo/Varivel. 3.51. LOADBITMAP (Transaes, Procedimentos/Relatrios, Work Panels)LoadBitmap(< FileName|Att|Var>)Incorpora Bitmaps no design do Form.A funo LoaBitmap usada para definir qual bitmap ser associada auma varivel. 45

3.52. OLD (Transaes)Old()Retorna o ltimo valor armazenado de um dado atributo 3.53. PREVIOUS (Transaes)Previous( )Previous()Retorna o valor de usado na ltima insero da transao doprograma corrente. O valor no armazenado e ele perdido assim que ousurio deixa a Transao. Se o atributo no for especificado, o atributoque est sendo assinalado assumido. 3.54. AFTER (Transaes)After()Retorna Verdadeiro ou Falso dependendo de que estgio a transao seencontre.Retorna Verdadeiro se um evento especificado est acontecendo naquelemomento na transao.Este evento pode ser disparado porque a execuo de uma Transaopassou por um certo Nvel, um certo atributo foi informado, ocorreu uma Aoem uma Transao ou toda a transao foi finalizada. GeneXusautomaticamente realiza onde e como uma regra precisa ser executada.Entretanto, o usurio pode forar que o GeneXus execute uma determinadaregra depois que um dos eventos seja mencionado. pode ser: InsertUpdateDeleteConfirm 46 TrnLevel()Nota: Quando for includa a regra After em uma regra condicional, aregra ser executada SOMENTE imediatamente aps o evento After ocorrere em nenhum outro lugar. 3.55. LEVEL (Transaes)Level()Retorna Verdadeiro se a execuo da Transao est no Nvel de umdado Atributo. GeneXus automaticamente realiza onde e quando uma regraprecisa ser executada. Contudo o usurio pode forar GeneXus a executar umadada regra a um Nvel especificado da transao. 3.56. INSERT/UPDATE/DELETE (Transaes)InsertUpdateDeleteRetorna Verdadeiro quando a transao est em modo de,respectivamente, Insero/Alterao/Deleo, caso contrrio retorna Falso. 47 4. Operadores Disponveis no GeneXus Operadores aritmticos ....................: +, -, *, /, ^ Operadores lgicos .............................: .AND. .OR. .NOT. Operadores relacionais ......................: (, ), =, , , >=, o controle no ser visvel no form.1: Verdadeiro -> o controle ser visvel no form.NOTA: Uma vez que o controle foi assinalado invisvel(Controle.Visible=0) ele permanece dessa maneira at que

voc o torne visvelnovamente (Controle.Visible=1).Exemplo: bitmap.Visible = 0 if RoupaCat = 2;Bitmap.Visible = 1 if RoupaCat 2;Para mostrar a foto da roupa dependendo da categoria, deveramosfazer as regras acima. 6.2. TOLLTIP (Tipos de controle: Button, Edit, Check Box)Atribui um tip um controle quando o mouse estiver posicionado sobre omesmo. Uma string deve ser informada.Exemplo: Assinalando um tip ao boto cujo nome TESTE.Event startTeste.tooltiptext= informaes para testeEndEvent 51 6.3. CAPTION (Tipos de controle: Button, Frame, Text, Radio Button)Forms: Determina o texto a ser mostrado como ttulo na barra de ttulosdo form. Quando o form minimizado, o texto mostrado abaixo do cone doForm.Outros controles: Determina o texto a ser mostrado no controle.Exemplo: Form.Caption = My Form Update if update;Form.Caption = My Form Delete if delete;Form.Caption = My Form Insert if insert;Neste exemplo, o ttulo do form muda dependendo do modo corrente(ins., del. ou alt.). 6.4. ENABLE (Tipos de controle: Button, Edit, Check Box, Radio Button, Combo Box, Subfile,Frame, Text)Determina se o controle pode responder aos eventos de usurio.Valores:1: (Verdadeiro) Permite o objeto responder aos eventos.2: (Falso) Impede o objeto de responder aos eventos.Exemplos: 1) EvtBtn.Enabled = 0 if update;Este boto DESABILITADO se estiver em modo Update.2) Att2.Enabled = 0 if .not. Null(Att1);Atributo Att2 no pode ser editado se atributo Att1 nofor nulo.3) subfile.Enabled = 0 if update;O subfile no pode ser acessado se estiver em modoUpdate (Dados no subfile no podem ser modificados). 6.5. ACTIVEPAGE (Tipos de controle: Tab) usada para indicar qual a pgina ativa de um tab control. Esta servisvel para o usurio.Exemplo: MyTab.ActivePage = 1 // a primeira pgina ativada 52 MyTab.ActivePage = Mytab.Activepage + 1 // move para aprxima pgina.NOTA: esta propriedade no implementada no gerador Visual Basic 4.0 6.6. PAGECOUNT (Tipos de controle: Tab) usada para obter o nmero de pginas de um tab control. normalmente usada junto com a propriedade ActivePage.Exemplo: IF MyTab.ActivePage < MyTab.PageCountMyTab.ActivePage = MyTab.ActivePage + 1ELSEBtn_Next.Caption = FinishENDIFNOTA: esta propriedade no implementada no gerador Visual Basic 4.0 6.7. BACKCOLOR, FORECOLOR (Tipos de controle: Todos)Determina as cores de fundo e frente respecti