API Word

API Word es una parte de API Office que permite la generación de doumentos Microsoft Word desde Listados, Ficheros y Programas de as400.

Una función bastante requerida es usar documentos Word como plantillas con “huecos” o “variables” que se completan desde programas.
Además la api permite generar un documento final docx o pdf.
Y para el trabajo de la api, leer la plantilla Word, rellenarlas y generar fichero final, no se requiere Word instalado.

¿y a pdf? también tenemos una api para rellenar variables/campos en documentos pdf…
Esta es otra api que permite rellenar campos de formulario en documentos puros pdf)

Para ello tenemos un modo de api Word muy simple:

• Creamos un documento Word con la estructura del documento.
• las variables las definimos simplemente tal como &nombre&
• colocamos el documento Word en una ubicación de red accesible, tal como una carpeta ifs del as400
• En el programa (ver ApiWordProgramaEjemplo) de as400 hacemos una llamada a la easyApiWord
• Se permite enviar el trabajo de la api a un pc Coprint Server o en el propio pc donde corre la emulación 5250 (Client Access, Mocha o similar)

Tenemos una forma de probar rápidamente esta easy api:

• crea un docum word con nombre demoword.docx, con el texto que quieras
• añade donde quieras las variables (con minusculas) &varuno&, &vardos&, &vartres&, &varcuatro& y &textofinal&
• guarda o copia el demoword.docx en la carpeta /tmp del as400
  • para ello abre el explorador de archivos en esa carpeta: Tecla Windows + R y teclea \\as400\tmp (siendo as400 la IP o nombre de tu as400)
  • Ojo: acceso a ifs a veces es puñetero: ¿problemas? ver Seguridad IFS
• En el menú/comando APIOFFICE, paso 11 (en submenu M1=Demo o desde cualquier sitio)
• Para saber cómo hacer tu propio programa: easy Api Word Programa Ejemplo

Para saber cómo hacer tu propio programa: easy Api Word Programa Ejemplo

Algunas funciones extra pueden personalizarse con el fichero ini asociado

• la última versión usa el fichero cpiApiWord.ini
• la version anterior cpiSplW.ini.

Este ini, como todos los de productos CPI se pueden ver/editar con cpiInfo.exe (el programa amarillo) o explorando la carpeta %appdata%.

En general este ini no es necesario.

[ApiWord]
Log=Y
WinInfo=1

Si el pc donde rueda API Word se usa para actividades personales normales puede evitarse la salida de informacion para minimizar el impacto, para ello usar el valor winInfo con M para visualizacion Minimizada, o 0 (cero) para ocultarlo.

Debe ponerse la dir ip del as400 en la posic 721 de la dtaara TEXTCPIU/CPI@XL.

• esto se puede hacer con paso 161 o con chgdtaara TEXTCPIU/CPI@XL
• puede verse con DSPDTAARA TEXTCPIU/CPI@XL

Se usa la parte de ifs para amacenar los trabajos,

• '/tmp/apiWord-NUMJOB.txt'
• es recomendable poner una espera si se generan multiples documentos

Si en el prm2 de la api se pasa el nombre de un coprint pc se genera un mbr de trabajo en textcpiu/qapixcpi con nombre APIWnnnnn siendo nnnnn un numerador.

API Word puede generar ficheros log, que generalmente se almacenan en la carpeta temporal de Windows, con nombre de fichero tal como

• cpiApiWord-año.log.txt
• cpisplw_año.log.txt

En el as400 también se crea un log

* WRKMBRPDM FILE(TEXTCPIU/LOGCPI) MBR(APIWORD*)

Formato PDF:
Si se quiere salvar el documento final (con las variables “rellenadas”) en modo pdf debe tenerse en cuenta que pdf puede no admitir toda clase de formateos, estilos o funciones de un Word, por lo que recomendamos “simplificar” el formateo de la plantilla, salvarla en formato nativo docx y probar bien cualquier cambio visual.

Variables repetidas:
Una variable puede estar varias veces en la plantilla, y se rellenan todas como si fuera una.
Por ejemplo, puede ponerse la variable &cliente& al inicio y al final de la plantilla.