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

1

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

2

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

3

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

4

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

5

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 20th 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

6

1. Comandos GeneXus1.1. Assign Atributo(Procedure) = Associa o valor de uma expresso para um atributo (Este comando atualiza 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, por exemplo: 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 variveis existem somente no ambiente do objeto correspondente e em nenhum outro lugar. A expresso associada a pode ser: Um Atributo

7

Uma Uma Uma Uma

Varivel Constante Funo (permitido quando uma associao utilizada) 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 objeto GENEXUS. Parmetros podem ser atributos, variveis ou valores constantes. Todos os parmetros servem para entrada e sada, assim valores podem ser retornados em qualquer dos parmetros. Se o programa que voc estiver chamando j existir, no ser necessrio escrever o nome entre apstrofos. GENEXUS ir checar se o programa realmente existe. O Nome do programa que ser chamado pode ser uma varivel ou um atributo.

1.4. Change Page(Procedure, Relatrio) CP Causa um salto de pgina quando faltarem menos linhas que na pgina que est sendo impressa. Esse comando equivalente a: EJECT if Pagelenght Currentline for menor que .

1.5. Commit(Procedure, Relatrio, Work Panel) Commit Fora um COMMIT quando includo em um programa. GENEXUS ir ativar o controle de Commitment para todas as Procedures e Transaes, se nenhum dos dois comandos NOCOMMITMENT ou NOENDTRN tiverem sido especificados, ser gerado um COMMIT no final da execuo da Procedure ou Transao.

8

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 uma resposta do usurio que pode ser Sim ou No. Em ambiente AS/400 os valores possveis so F12=Cancel ou Reject e Enter=Accept ou Confirm. Para saber se o operador confirmou ou rejeitou a mensagem, a funo CONFIRMED( ) usada.

1.7. Delete(Procedure) Delete Exclui o registro da Tabela Base associado ao grupo onde o comando DELETE foi especificado. Regras: Um comando DELETE pode somente ser usado em um FOR EACHENDFOR. A Excluso executada exatamente no momento em que o comando DELETE encontrado. A integridade referencial no automaticamente checada quando o comando DELETE especificado. NOTA: Se o comando DELETE especificado em um grupo que contenha grupos aninhados, os dados do grupo corrente podem ser usados dentro dos grupos aninhados, embora eles no sero fisicamente deletados. Recomendao: primeiro exclua os nveis internos antes dos externos. Isto evita qualquer possvel cancelamento ou travamento do registro.

9

1.8. Do Nome Subrotina(Transao, Procedure, Relatrio, Work Panel e Web Panels) DO RoutineName Permite voc chamar uma subrotina (definida usando o comando Sub). No permitida a passagem de parmetros; TODAS as variveis do mesmo programa tambm podem ser utilizados pela subrotina.

1.9. Do While(Transao, Procedure, Relatrio, Work Panel e Web Panels) Do while Enddo Sero executados todos os comandos entre o DO WHILE e o ENDDO enquanto a condio for verdadeira. Para forar a sada do grupo do DO WHILE pode ser usado o comando EXIT.

1.10. Eject(Procedure, Relatrio) Eject Este comando fora um salto de pgina no programa gerado, quando a sada selecionada est associada a impressora, ou limpa a tela quando a sada est 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 para executar aes especficas quando um erro no database relatado em tempo de 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.

10

1.12. Exit(Transao, Procedure, Relatrio, Work Panel) Exit O comando Exit permite abandonar um grupo For Each, Xfor Each ou Do While. O prximo comando a ser executado aps um exit o prximo comando aps o comando EndFor, XendFor ou EndDo correspondente ao grupo que contm o comando Exit. NOTA: O comando Exit no valido dentro de um FOR EACH LINE.

1.13. Footer(Procedure, Relatrio) Footer End Define as linhas de rodap a serem impressas no final de cada pgina. Os comandos entre a clusula FOOTER e a clusula END so executadas quando chega-se ao final da pgina. FOOTERS podem tambm ser definidos com um FOR EACH dentro, da mesma forma como HEADERS pode. Se existirem linhas de impresso entre o FOOTER e o END, elas iro ser impressas dentro da margem inferior (parmetro MB). Se as linhas de FOOTER no couberem dentro da rea da margem inferior a impresso ir continuar na prxima pgina.

1.14. For Each(Procedure, Relatrio, Work Panel) For each [order ...] [Where ] [Defined by ...] Endfor Define um grupo de atributos genricos por operaes, o comando For Each usado para definir acesso ao Banco de Dados. No existem referncias explcitas para tabelas em um FOR EACH. Voc somente precisa mencionar QUAIS os Atributos que voc precisa, e o Genexus

11

resolve o problema de COMO encontr-los. A maneira COMO GENEXUS vai efetuar a navegao pode ser vista no relatrio de Especificao. Para forar uma 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 como Tabelas Estendidas. Se existirem atributos que no faam parte da Tabela Base nem das Tabelas Estendidas ir aparecer uma mensagem de erro no relatrio de Especificao e o programa no ser gerado.

CLUSULA ORDER ORDER < Lista de Atributos > A ordem para acessar a Tabela Base de um for Each pode ser especificada por uma lista ordenada de atributos, informados logo aps o comando FOR EACH. NOTA: A clusula ordem bastante usada para definir quebras (Break) em grupos For Each aninhados. Uma quebra definida sempre que ns temos a mesma tabela base em dois grupos For Each, os atributos da Quebra esto definidos pelo conjunto de atributos especificados na clusula Ordem.

CLUSULA WHERE WHERE A clusula WHERE pode ser especificada para estabelecer uma condio para o grupo For Each EndFor. Regras: Vrios comandos WHERE podem ser especificados aps um FOR EACH. Neste caso, as condies WHERE funcionaro como se elas estivessem separadas por um operador .AND.. Um comando WHERE pode, somente, ser especificado imediatamente aps um FOR EACH ou aps outro comando WHERE.

12

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 mais prioridade, informando uma Lista de Atributos na clusula DEFINED BY.

1.15. For Each Line(Work Panel) For each line EndFor Fora o processamento de todas as linhas (carregadas) no subfile em uma Work panel. Esse comando pode ser usado, por exemplo, para marcar todas as linhas que satisfaam uma certa condio. FOR EACH LINE tem as seguintes restries: Ele somente ir processar os registros que foram carregados no subfile. Se voc quiser processar todos os registros do Subfile, a regra 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 line EndFor Esse comando funciona de forma similar ao for each lline, porm somente sero consideradas as linhas marcadas (selecionadas).

1.17. Graph(Work Panel) graph([,][]);13

Permite gerar um grfico a partir das informaes contidas no Subfile. Isto pode somente ser utilizada por programas gerados para Foxpro for Windows ou Visual Basic. Quando gerado no Foxpro for Windows, o programa MS-GRAPH (Includo no Foxpro for Windows) executado sempre que esse comando for localizado. contedo do subfile usado como o dado para o grfico e o usurio pode escolher 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 as definies do grfico (portanto o Graph Wizard no precisa ser usado todas as vezes). Onde: corresponde ao caminho e nome para o arquivo que contm o grfico. Se o arquivo correspondente ao grfico no existir, o Graph Wizard ser chamado. Uma vez que o grfico definido voc precisar salv-lo com o mesmo nome usado em . Se voc quiser modificar a definio do grfico voc precisa dar um duplo clique sobre a janela do grfico. uma lista com os atributos e variveis do Subfile que devem ser includs no grfico. O eixo X pode receber qualquer type varivel (caractere, data ou numrico) e todas as outras variveis precisam ser numricas (eixo Y).

1.18. Header(Procedure, Relatrio) Header End Define o cabealho a ser impresso no topo de cada pgina. O primeiro grupo no Layout padro das Procedures/Reports o grupo HEADER. Os dados dentro desse grupo so impressos no incio de cada pgina do relatrio. Voc pode tambm definir um cabealho para cada FOR EACH definido no Layout.

14

1.19. If(Transao, Procedure, Relatrio, Work Panel) If [Else] Endif Executam um bloco de comando se a condio for avaliada como verdadeira.

1.20. Line Number(Procedure, Relatrio) Lineno Especifica o nmero da linha onde o dado ser impresso.

1.21. Load(Work Panel) Load Este comando fora a carga de uma nova linha dentro do subfile. Ela bastante usada quando o Work Panel no tem uma tabela Base, e consequentemente a carga precisa ser feita na mo ou quando precisamos fazer 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).

15

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 uma varivel contendo uma mensagem. Nowait: Armazena a mensagem em uma varivel interna e continua o processamento. O usurio no ir ver mensagem at que o processamento do programa se encerre. Isto garante uma melhor performance com menos telas de I/O requeridas. Status: A mensagem mostrada no momento em que originada. Ela usada principalmente para dar ao usurio informaes sobre status de processamento. Nenhuma Opo Especificada: Exibe a mensagem e aguarda pelo pressionamento do .

1.25. New Record(Procedure) New [When Duplicate] EndNew O comando NEW insere um registro na Tabela Base determinada pelo atributo no grupo NEW-ENDNEW. Chaves duplicadas so checadas. Se a chave j existir, todos os comandos entre o WHEN DUPLICATE e o ENDNEW sero executados. Caso voc deseje fazer alguma alterao nesse registro j existente, um grupo FOR EACH ENDFOR precisa ser especificado dentro do WHEN DUPLICATE.

16

1.26. NoSkip(Procedure, Relatrio) NoSkip Inibe 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 Detail Evita a impresso do registro se no existirem registros no Subfile. Este comando precisa ser especificado sempre que voc quiser inibir o processamento 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 cdigo ASCII de 3 dgitos precedido por uma \ onde no mnimo um espao separa o PRNCMD and . Os parmetros dependem de cada impressora e podem ser encontrado no Manual da Impressora.

17

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, o Subfile ser posicionado sobre o registro que estava em foco anteriormente.

1.31. Return(Transao, Procedure, Relatrio, Work Panel) Return Encerra o programa e retorna a execuo ao programa que o chamou.

1.32. RollBack(Transao, Procedure, Relatrio, Work Panel) RollBack O comando ROLLBACK invalida um conjunto de alteraes do banco de dados em uma LWU (Logical work Unit). Consideraes: O comando ROLLBACK ignorado pelos ambientes que no usam Integridade 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 o DOS) consideram o SUBMIT como se fosse um comando CALL e ignoram os parmetros especficos do SUBMIT.

18

1.34. Subroutine(Transao, Procedure, Relatrio, Work Panel) Sub RoutineName EndSub Permite que sejam definidas rotinas que sero disparadas quando um comando DO for executado. Todas as variveis do mesmo programa fonte pode tambm ser usadas dentro da subrotina.

1.35. Xfor Each(Procedure, Relatrio, Work Panel) Xfor each [INDEX ] Where Xendfor Define um loop interativo para um arquivo externo (File View), usando ndice especificado (se existir) e filtra dados de acordo com a condio declarada na opo WHERE.

1.36. Xfor First(Procedure, Relatrio, Work Panel) Xfor first [INDEX ] Where Xendfor Este comando similar ao comando XFOR EACH, porm ele no fica em loop. Ele retorna o primeiro registro (se existir um registro) de um arquivo externo utilizando o ndice especificado e filtrando dados de acordo com a condio declarada na opo WHERE.

1.37. Xnew(Procedure) Xnew Xendnew

19

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 da posio das Variveis e dos Atributos na Tela.

20

2.2. ADD(Transaes) Add( Atributo1, Atributo2) if Condio; Esta regra adiciona o valor de Atributo1 ao Atributo2, se a Condio for avaliada como verdadeira. Esta Adio leva em conta as operaes de Insero, Atualizao e Remoo. Exemplo: Add( Qtdcompra, Qtdestq); Se o atributo Qtdcompra for atualizado, o Atributo Qtdestq tambm o ser, pelo valor diferencial da atualizao.

2.3. ALLOWNULLS(Transaes) Allownulls( Atrib1, Atrib2, ..., AtribN ) Esta regra usada para permitir valores NULOS para atributos nos quais 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 dado atributo. 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 ou varivel, ser chamado sempre que a Condio for avaliada como Verdadeira. Exemplo:

21

&Pgm = WProg Call(&Pgm, &V1,&V2);

2.6. COLOR(Transaes, Work Panels) Color( ); //Permite a definio das cores default para tela. Color(,[|)(if ]; //Define cores para atributos ou variveis. Onde: = [,] = = = [/ ] = [ ] = WHT | BLK | RED | GRN | BRW | MGN BLU | CYN | YLW | RI | X = + | * Cada define a cor de frente e a cor de fundo. Abreviaturas de Cores: WHT = branco BLK = preto RED = vermelho GRN = verde BRW = marrom MGN = magenta BLU = azul CYN = cinza YLW = amarelo RI = imagem reversa X = escondido Um asterisco (*) em representa um elemento BLINKING e um 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)22

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 uma Chave.

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 nenhum Atributo, 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;

23

Esta Regra faz com que a string definida em Texto de Mensagem seja apresentada na Janela de Erro da Transao, se a condio for avaliada como verdade. Todo processamento subsequente, inclusive outras regras, no sero executadas. Portanto, se muitas regras estiverem associadas a uma nica condio, a regra Error dever ser a ltima, para que as outras possam ser executadas.

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 para executar aes especficas quando um erro no database relatado em tempo de 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 no Subfile, que eventualmente no aparecem na tela. Ela bastante utilizada quando precisa-se de um cdigo no Subfile, mas no se quer que ele aparea na tela.

24

2.14. MSG(Transaes) Msg(Texto de Mensagem) IF Condio; Esta regra usada para enviar mensagens de aviso para o operador. A string definida em Texto de Mensagem ser apresentada na Janela de erro da 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 Atributos so sada de dados. Todavia, pode haver ocasies em que no se deseja que o usurio introduza dados, dependendo de uma condio. Esta regra faz com que a Transao no aceite a digitao de dados para o Atributo ou varivel associado.

2.16. NOCHECK(Transaes) Nocheck( Atributo1, Atributo2, ..., Atributon); A regra Nocheck usada para inibir a checagem de integridade referencial.

2.17. NOCONFIRM(Transaes) Noconfirm(Atributo); A regra Noconfirm usada para evitar a confirmao no Nvel. Quando se passa de um Nvel para o seguinte, uma mensagem apresentada, pedindo a confirmao dos dados. Para se evitar o pedido de confirmao, usa-se esta regra. Atributo: usado para indicar o nvel. Se no for especificado nenhum atributo, ser assumido o primeiro nvel.

25

2.18. NOREAD(Procedimentos/Relatrios, Work Panels) Noread(,,...,); Essa regra permite inibir a leitura de uma tabela que navegada e mostrada 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 entra com 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 no Menu.

26

Quando um Objeto chamado de outro programa, os parmetros recebidos pela regra PARM( ) so considerados como uma regra Equal.

2.22. PRINTER(Procedimentos/Relatrios) Printer(); Seleciona o arquivo de impresso a ser usado pelo AS/400 ou o nome da impressora, 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 pelo GeneXus, quando seleciona-se Visualizar.

2.24. REFCALL(Transaes) Reffcall(Nome_prog, Atrib1, ... , AtribN); Esta regra usada para chamar um Programa quando a integridade referencial tenta ser quebrada.

2.25. REFMSG(Transaes) Refmsg(Texto, Atrib1, ..., AtribN)

27

Esta regra usada para mudar as mensagens geradas por GeneXus quando 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 dados do 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 valor contido em Atributo2 mais o valor do Passo, toda vez que um novo registro for adicionado Tabela onde Atributo1 esteja. Se Atributo1 no faz parte do Identificador, o usurio dever digitar um valor que no existe, para que Atributo1 assuma o modo INSERO, e receba o prximo valor serializado.

2.28. SUBMIT(Transaes) SUBMIT(Usr-pgm,SubmitParms[,,,...])[IF ]; Processa relatrios e procedimentos em modo batch, desde que esses no tenham interaes com o usurio.

2.29. SUBTRACT(Transaes) Subtract( Atributo1, Atributo2) if condio;

28

Esta regra Subtrai o valor de Atributo1 do Atributo2, se a Condio for avaliada como verdadeira. Esta Subtrao leva em conta as operaes de Insero, 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 arquivo temporrio. 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 est trabalhando com uma Work Panel ou Transao que carrega 300.000 registros da tabela base e o usurio vai para o fim do arquivo (Ctrl-End). Neste caso um arquivo 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 para carreg-lo (caso no seja indicado, a ordem fsica ser usada).

29

3. Funes Disponveis no GeneXus3.1. DAY(Transaes, Procedimentos/Relatrios, Work Panels) Day() Tipo retornado: N(2) Retorna o dia de uma data informada. Se for uma data nula, o valor 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) ser retornado se a no for uma data nula.

30

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: Date Retorna a data do sistema operacional.

3.5. NOW( )(Transaes, Procedimentos, Relatrios, Work Panels, Web Panels) Now( ) Tipo retornado: Datetime Retorna a data e a hora corrente.

3.6. HOUR, MINUTE, SECONDS(Transaes, Procedimentos, Relatrios, Work Panels, Web Panels) Hour( ) / Minute() / Seconds(); Tipo retornado: Numrico Retorna um valor numrico representando as horas/minutos/segundos respectivamente, no formato da hora informado do datetime.

31

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 da semana (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 linguagem selecionada. Espaos sero retornados se o valor de for invlido. deve ser uma das seguintes (caso no seja informada, ser utilizada a linguagem selecionada no Model Properties): spa Espanhol eng Ingls por Portugus ita - 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. Se nenhuma linguagem for selecionada, ser utilizada a que estiver definida em Model Properties.

3.10. CTOD(Transaes, Procedimentos/Relatrios, Work Panels) Ctod(nn/nn/yy)

32

Converte uma String em Data. A string de caracteres pode ser mm/dd/yy ou dd/mm/yy dependendo da linguagem corrente, onde: mm representa o ms com dois dgitos; dd representa 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/yy Portugus/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 parmetros representa a data e a segunda parte a hora. nn/nn/yy tem o formato M/D/A ou o especificado na preferncia Date format in CTOD function. Se AM|PM especificado, hh pode variar de 0-12. Caso contrrio, ir variar 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 por pelo menos um branco. Se qualquer parte da string (data e hora) for omitido, assumido nulo. Se qualquer parte da string no vlida, o DateTime resultante ser nulo. Se no for especificdo nem AM nem PM, o formato 24-horas assumido.

33

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: Caractere Retorna caractere associado ao DateTime, com o formato especificado por M e N. Os valores possveis para M e N so os mesmos usados na definio do tipo DateTime. Valores possveis para M: 0 Data no pedida nem mostrada 8 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 horas 5 Hora e minuto so mostrados separados pelo smbolo separador de horas. O formato 24 horas utilizado. 8 Hora completa mostrada (incluindo segundos). O formato 24 horas usado. possvel tambm setar valor nulo (0) para N. Neste caso, somente a parte 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 os parmetros utilizados para definio do DateTime (primeiro parmetro). No caso da combinao M/N no ser vlida, os valores assumidos so: M=10 e N=8.

34

O formato da string retornada o mesmo da funo CtoT, ou seja, a data 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 o dia. , e devem ser expresses numricas.

3.15. YmdHmstoT(Transaes, Procedimentos, Relatrios, Work Panels e Web Panels) YmdHmstoT( , , [ , [ , [ ,]]]) Tipo retornado: Date Time Retorna um Date Time associado a data e hora especificados no parmetro. Parmetros omitidos assumem o valor zero. Todos os parmetros so expresses numricas. NExp1 representa o ano. Este valor no se ajusta ao que for indicado na preferncia First year of 20th century. NExp2 representa o ms. NExp3 representa o dia. NExp4 representa a hora. Hora deve ser especificado no formato 24horas. NExp5 representa os minutos. NExp6 representa os segundos. Nota: Se somente um dos componentes (dat ou hora) vlido, somente este ser considerado. Por exemplo: YMDHMStoT(1990, 31, 2, 12, 10, 15) ir retornar um datetime vlido com a parte da data nula. A hora ser 12:10:15.

3.16. ADDMTH(Transaes, Procedimentos/Relatrios, Work Panels) Addmth(,)

35

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 data informada.

3.20. TDIFF(Transaes, Procedimentos, Relatrios, Work Panels e Web Panels) TDiff( , ) Tipo retornado: Numrico. Retorna os segundos da diferena entre dois DateTime recebidos como parmetros (DateTimeExpr1 DateTimeExpr2) Se DateTimeExpr2 for maior que DateTimeExpr1, um valor negativo ser retornado.

36

3.21. TADD(Transaes, Procedimentos, Relatrios, Work Panels e Web Panels) TAdd( , ) Tipo retornado: DateTime Soma 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 varivel antes 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 a funo UDF. Quando voc escreve o cdigo para UsrPgm, deve incluir um parmetro a mais no final da lista de parmetros, que dever conter o valor retornado para 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)

37

A funo UDP chama um programa que pode USAR TABELAS e retorna um valor. Quando o cdigo para o programa UsrPgm for escrito, dever ser includo no final da lista de parmetros, um parmetro o qual conter o valor que ser retornado pela funo. Note que a funo UDP fecha as tabelas antes da chamada ser feita, e abre-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.

38

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 vlida somente no AS/400.

3.31. USERID(Transaes, Procedimentos/Relatrios, Work Panels) Userid( ) No ambiente AS/400, esta funo retorna a identificao do usurio definida no User Profile. No ambiente Micro/Lan esta funo retorna o contedo da varivel de ambiente do DOS chamada LOGNAME. Para habilitar o uso dessa funo, essa varivel dever ser criada para todas as estaes. Em um ambiente Client/Server esta funo retorna a identificao do usurio conectado ao servidor.

3.32. WRKST(Transaes, Procedimentos/Relatrios, Work Panels) Wrkst( )

39

Retorna a identificao da Estao de Trabalho correspondente. Em ambiente Micro/Lan retorna o contedo da varivel de ambiente do DOS, PSTATION. Para habilitar o uso dessa funo, voc precisa setar esta varivel de ambiente.

3.33. STR(Transaes, Procedimentos/Relatrios, Work Panels) Str(N1 [ ,N2 [ ,N3]]) Converte o valor da expresso numrica em para uma string caracter, alinhado pela direita, o tamanho total de (incluindo o sinal e o ponto decimal), e o nmero de decimais. Se voc especificar menos decimais do que a expresso numrica possui, o valor ser arredondado. 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 de N2 caracteres.

3.35. CONCAT(Transaes, Procedimentos/Relatrios, Work Panels) Concat( S1, S2 [ ,S3]) Concatena duas strings incluindo um separador se informado.

40

Retorna a string resultante da concatenao de S1 e S2 e o separador S3. 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 em branco. No AS/400, o atributo ou varivel que recebe a funo, ser completamente preenchido com espaos, independente do valor informado para o 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 ()

41

Remove todos os brancos a esquerda da expresso caracter . Esta funo especialmente til para remover os brancos que so inseridos quando voc utiliza a funo Str( ) para converter um valor numrico para uma string caracter.

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 letra minscula (a - z) convertida em letra maiscula (A - Z) no resultado da funo, 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 expresso permanecero inalterados.

3.43. INT(Transaes, Procedimentos/Relatrios, Work Panels) Int( ) Esta funo retorna a parte inteira da expresso .

42

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 um valor do tipo numrico. Ela processa os nmeros em uma expresso caracter da esquerda 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( ,,)

43

Retorna um nmero representando um valor de cor RGB, dados os 3 seguintes parmetros: Red : Nmero na faixa de 0 at 255, inclusive, que representa o componente vermelho da cor. Green : Nmero na faixa de 0 at 255, inclusive, que representa o componente verde da cor. Blue : Nmero na faixa de 0 at 255, inclusive, que representa o componente 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 for nulo. O valor nulo para campos do tipo Numrico zero, e para campos tipo Caracter 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 a uma varivel.

44

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 do programa corrente. O valor no armazenado e ele perdido assim que o usurio deixa a Transao. Se o atributo no for especificado, o atributo que est sendo assinalado assumido.

3.54. AFTER(Transaes) After() Retorna Verdadeiro ou Falso dependendo de que estgio a transao se encontre. Retorna Verdadeiro se um evento especificado est acontecendo naquele momento na transao. Este evento pode ser disparado porque a execuo de uma Transao passou por um certo Nvel, um certo atributo foi informado, ocorreu uma Ao em uma Transao ou toda a transao foi finalizada. GeneXus automaticamente realiza onde e como uma regra precisa ser executada. Entretanto, o usurio pode forar que o GeneXus execute uma determinada regra depois que um dos eventos seja mencionado. pode ser: Insert Update Delete Confirm

45

Trn Level() Nota: Quando for includa a regra After em uma regra condicional, a regra ser executada SOMENTE imediatamente aps o evento After ocorrer e em nenhum outro lugar.

3.55. LEVEL(Transaes) Level() Retorna Verdadeiro se a execuo da Transao est no Nvel de um dado Atributo. GeneXus automaticamente realiza onde e quando uma regra precisa ser executada. Contudo o usurio pode forar GeneXus a executar uma dada regra a um Nvel especificado da transao.

3.56. INSERT/UPDATE/DELETE(Transaes) Insert Update Delete Retorna Verdadeiro quando a transao est em modo de, respectivamente, Insero/Alterao/Deleo, caso contrrio retorna Falso.

46

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 visvel novamente (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, deveramos fazer as regras acima.

6.2. TOLLTIP(Tipos de controle: Button, Edit, Check Box) Atribui um tip um controle quando o mouse estiver posicionado sobre o mesmo. Uma string deve ser informada. Exemplo: Assinalando um tip ao boto cujo nome TESTE. Event start Teste.tooltiptext= informaes para teste EndEvent

50

6.3. CAPTION(Tipos de controle: Button, Frame, Text, Radio Button) Forms: Determina o texto a ser mostrado como ttulo na barra de ttulos do form. Quando o form minimizado, o texto mostrado abaixo do cone do Form. 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.Capt