RpgForWeb Program Wizard (r4pw)

RpgForWeb Program Wizard (r4pw) es un complemento de RpgForWeb que permite crear un programa web completo en minutos.
El objetivo es que sirva como parte de la formación y para tener pequeños programas básicos para pruebas y verificacion del http server.


aviso

Importante: RpgForWeb Program Wizard (r4pw) no está autorizado ni creado para generar programas de uso empresarial continuado sino como formación y pruebas.


RpgForWeb Program Wizard (r4pw) ofrece

  • Guia paso a paso.
  • Genera todo Automáticamente:
    • Programas RPG IV (fuente y objeto)
    • Ficheros HTML con el diseño
    • rutinas javascript
  • permite puntos de entrada RPG para personalizar
  • plantillas de diseño (estilos, css) personalizables
  • Y además vale para aprender html y RpgForWeb
    • tras generar, pillamos los fuentes html y RPG y los curioseamos!
  • Con tu RPG, con tu as400, sin más historias!

ver aquí información general sobre Program Wizard.

Instalar Program Wizard

Ver pagina de instalacion: InstalarProgramWizard

y tras instalar...

Ahora se puede llamar al EntryPoint desde el navegador de internet:

IMPORTANTE: La carpeta o directorio que se use al definir el programa a generar debe existir definida en una aplicacion e instancia (con un puerto) en el menu/comando R4W en as400. El posible error R4F723 estará relacionado con este contexto.

Tutorial

llamar al EntryPoint desde el navegador de internet:

Primero definir el modo de comportamiento general,
CHGDTAARA DTAARA(CPIWEBF/R4W (1 2)) VALUE('G1')

El modo G2 (beta) permitirá otra alternativa de apariencia general.
CHGDTAARA DTAARA(CPIWEBF/R4W (1 2)) VALUE('G2')

Cuando quieras “limpiar” el codigo generado (quitar comentarios extra sobre puntos de entrada etc):
CHGDTAARA DTAARA(CPIWEBF/R4W (15 1)) VALUE('c')
Al principio, para aprender, viene bien vaciar ese valor, así es facil saber donde van los inserts (InsertPoint para codigo de usuario), etc.

Para ver la dtaara de configuracion:
DSPDTAARA DTAARA(CPIWEBF/R4W)


Para familiarizarte con r4pw puedes seguir el ejemplo de la web:
Guia paso a paso

-

Una vez termines el tutorial/guia, aquí tienes algunas notas.

campos de calculo

Al definir campos de calculo con r4pw ese campo se tiene disponible para colocarlo en query/form y para el programa generado.

Ejemplo para crear y usar un campo de calculo en el query/grid de consulta:

Dentro del Wizard, usar la opcion de campos de calculo.

Ahora con SEU o casiSEU añadir el calculo que queremos para el nuevo campo, para ello usar la opcion SEU.

  • puede usarse el “casiSeu” incorporado
  • o usar el SEU de verdad que es mas potente
    • para ello copiar el comando que aparece en el “casiSeu” incorporado y pegarlo en una pantalla de as400
      • strSeu bibDelPrograma/R4PWSRC srcMbr(nombreDelPrograma) type(RPGLE) option(2)
  • los calculos pueden asociarse a diversos InsertPoint (puntos de insercion de codigo) que permite el API de r4pw.
*PW-INSERT-file-qRead       
/free                       
     wMB = upMXSU / 1000000;
/end-free                   

este es el casiSEU

Estructura Base de Datos del Wizard

r4pw permite tener varios entornos (environments) en cualquier biblioteca, lo cual puede ser algo complicado, aunque, claro, es muy flexible.

El paso 82 del menu r4w permite verificar el repositorio de r4pw.

Con este comando se puede conocer en qué bibliotecas existen entornos r4pw:

  • WRKF FILE(*ALLUSR/R4PWENV)
  • Y con este se ven otros ficheros rlacionados con RpgForWeb Program Wizard: WRKF FILE(*ALLUSR/R4PW*)

El cualquier biblioteca que tenga un fichero R4PWenv tiene otros siempre comenzados con R4PW*

Una información ampliada puede imprimirse con CALL R4PWPGMINF.

Ubicacion de Fuentes

¿Donde genera los fuentes r4pw?

  • fuentes en el pf-src R4PWrpgle
  • codigo de usuario en puntos de entrada (entry-points) en el pf-src R4PWsrc

Ver Fuentes con WRKMBRPDM bib/R4PWrpgle MBR(nombrePrograma*). Se genera un programa para el Query/Consulta, otro para el Visor (terminado en V) y otro para el Editor (terminado en E).

El codigo fuente de usuario (InsertPoint) asociado a los programas se puede ver con WRKMBRPDM bib/R4PWsrc MBR(nombrePrograma)

8-O Importante: Con el paso 229 del comando/menu R4W se genera un listado con la lista de todos los programas generados, indicando por cada uno. Es muy útil ya que puede haber programas generados en diversas bibliotecas y entornos.

  • bib
  • entorno
  • programa
  • fichero primario y su bib
  • tipo (QV, QVE, etc)
  • titulo
  • fecha

Instrucciones base

Los programas se generan usando una plantilla de codigo/instrucciones base.

  • 8-o Sólo para uso interno CPI o para cambios en usuarios autorizados.
  • con una nueva instlación se perderían posibles cambios, si se hacen salvarlos y reponerlos
  • CPIWEB/QINCLUDE miembro R4PWINS

Notas

  • Evitar el uso de ficheros con muchos campos, ya que eso hace muy dificil la seleccion de campos.
    • Mejor usar o crear un LF o LF-Join asociado y definir en él los campos que susceptiblemente se usarán.
  • Una lista de Entornos y Programas puede imprimirse con paso 229.
  • para ver los trabajos de la instancia http para r4pw: Paso 228 o WRKACTJOB job(R4PGMWIZ).
  • Se puede abrir el navegador con r4pw usando paso 241, o con una direccion como: http://as400:5250/r4pw
    • recomendable grabar antes la IP del as400: CHGDTAARA DTAARA(TEXTCPIU/CPI@XL (721 15)) VALUE('192….') siendo value del tipo 192.168.1.1
      • se pueden ver las IP configuradas con el as400 con WRKTCPSTS OPTION(*IFC)

ERROR R4PW378

La primera vez que se crea un programa con r4pw en un entorno se puede recibir el Error R4PW378 con esta info:

  • ERROR R4PW378 no hay pgm nombre-biblioteca/nombre-entorno para nombre-de-programa-nuevo: ver R4PW_WIZ1 en paso312.

Esto9 recuerda que se debe hacer un programa que se llame igual que el entorno, el programa puede hacer cosas (addlible… etc) o no, pero debe existir.

Se puede ver un ejemplo en el miembro CPIWEB/QINCLUDE,R4PW_WIZ1.

  • STRSEU SRCFILE(CPIWEB/QINCLUDE) SRCMBR(R4PW_WIZ1) OPTION(5)

El programa puede hacerse con 3 areas diferenciadas:

  • cosas que se hacen siempre
  • cosas que se hacen solo al generar el programa
  • cosas que se hacen solo al ejecutar el programa

De forma que cada programa generado en un entorno ejecutan este programa como inicio para crear ficheros de trabajo, usar la libl, etc.

O simplemente se puede crear un programa CLP que no haga nada:

  • el programa debe llamarse como el entorno, y compilarse en la biblioteca indicada en la 1a pag de r4pw.
  • para crear el fuente usa el pf-src R4PWSRC o R4PWRPGLE en la bib del entorno
   PGM &MODE
        DCL &MODE *CHAR 1
   ENDPGM 

ERROR R4F723

IMPORTANTE: La carpeta o directorio que se use al definir el programa a generar debe existir definida en una aplicacion e instancia (con un puerto) en el menu/comando R4W en as400. El posible error R4F723 estará relacionado con este contexto.

r4pw supone que el puerto a usar para un programa generado es el puerto asociado a una aplicacion r4w que tenga la carpeta definida en el programa.

imagen ejemplo usando la carpeta/dir TEST

Basicamente se necesita crear una aplicacion (paso 50) y su instancia relacionada con paso 50 opcion 9.
Y luego con paso 15 arrancar esa instancia (opcion 13).

===== Sugerencias =====

  • pag final que dice compilado o error boton para recomenzar diseño de ese pgm (funciona ok con back)
  • pag de propiedades pgm campo/s observaciones para anotar posibles mejoras etc
  • ¿opcion de elegir tipo de grid?
 
/kunden/homepages/8/d674751560/htdocs/cpies/doc/data/pages/rpgforweb/programwizard.txt · Última modificación: 14/08/2018 12:56 por admin
[unknown button type]
 
Excepto donde se indique lo contrario, el contenido de este wiki esta bajo la siguiente licencia: CC Attribution-Noncommercial-Share Alike 4.0 International
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki