Esta función permite extraer todos los párrafos de una documentación con formato de fichero XML.

Para extraer un fichero XML para su traducción, hay que emplear la función plan de trabajo documentación.

La extracción se realiza por defecto en una carpeta xml creada, si no existe ya, en la carpeta de documentación definida por el parametro DIRDOC.

Una función de integración de documentación permite realizar la operación inversa.

Prerequisitos

SEEREFERTTO Consulta la documentación de Puesta en marcha

Gestión de Pantalla

Pantalla de captura

Se capturan en la pantalla los criterios de selección para definir lo que hay que extraer, sabiendo que puede extraerse:

  • la documentación sobre funciones, objeto funcional u objeto (definido por su tipo ).
  • la documentación sobre el campo (que puede extraerse por separado o junto con la documentación funcional, puesto que las ayudas de campo incluídas en la ayuda se extraen como ficheros por separado).
  • todo fichero vinculado que se extraiga tal cual.

Extracción

Para (re)traducción (campo EXTRETRA)
Para traducción (campo EXTTRA)
Idioma de traducción (campo LANTRA)
Idioma de referencia (campo LANREFTRA)

Extracción

Por idioma (campo EXTLAN)
Todos idiomas (campo ALLLAN)

Si esta casilla está marcada, para la operación se tendrán en cuenta todas las lenguas.

Idioma de extracción (campo LANEXT)

Define el código lengua a tratar si es único.
Extracto también en idioma de referencia (campo ENLANREF)
Idioma de referencia (campo LANREFEXT)
Documentación considerada (campo VALDOC)

Extracción XML

Directorio (campo REPERT)

Indica la carpeta desde la que se realizará la documentación, sabiendo que las ayudas de campos serán extraídas en la sub carpeta FLD, y los ficheros vinculado en la sub carpeta FILE.

Subdirectorio por tipo (campo REPERTTYP)
Para todos los grupos (campo ALLCREGRP)

Selecciones

Todos los tipos (campo ALLTYP)

Marca esta casilla para incluir todos los tipos. Déjala desmarcada si quieres ejecutar el proceso para un único tipo.
Tipo (campo TYP)

Define el tipo de documentación a tratar (si es única).

Exclusión APM, AT*, AML (campo EXCTYP)
Todos los códigos (campo ALLCOD)
Código de (campo CODDEB)

Permite definir un rango de inicio según el criterio para determinar los datos tenidos en cuenta por la operación.

a (campo CODFIN)

Permite definir un rango de fin según el criterio para determinar los datos tenidos en cuenta por la operación.

Todos los códigos de actividad (campo ALLACV)
Código actividad (campo ACV)
Todos módulos (campo ALLMOD)
Módulo (campo MODULE)
Excluir un módulo (campo EXCMOD)
Módulo (campo MODTOEXC)

Opciones

Ficheros vinculados (campo HLPFIL)
Ayudas en campo vinculadas (campo HLPLNKFLD)

Si esta casilla está marcada, se tratará de forma independiente las ayudas de campo relativas a la documentación sobre la función y objeto tratado. Para saber cuales son las ayudas de campo a tratar, se exploran las pantallas asociadas a los párrafos de documentación que les corresponden.
Ayudas en campo (campo HLPFLD)

Si esta casilla está marcada, se tratará del mismo modo la documentación de campo.
De (campo FLDDEB)
campo FILLER6
A (campo FLDFIN)

Mensajes de Error

No hay ningún mensaje de error aparte de los mensajes de error genéricos.

Tablas en ejecución

SEEREFERTTO Consulta la documentación de Puesta en marcha

Annexe : formato ficheros creados

El formato del fichero XML de documentación en función u objeto tal y como se encuentra en la carpeta XML, es el siguiente:

  • un encabezamiento normalizado en xml
  • una baliza DOC con los atributos TYPE, NOMBRE (define el tipo del código de la documentación).
  • dentro de la baliza DOC hay, en cada párrafo, una baliza PAR con lo atributos LAN. LEV, SUBLEV, PAR, MSK, STY, VLDDAT, VLDFLG, ACT, et MOD (que definen la lengua, el nivel, el subnivel, el código de párrafo, la pantalla, el estilo, la fecha de validez, el indicador de validez, el código de actividad y el módulo).
  • Dentro de la baliza PAR hay una baliza TIT para dar título al párrafo (si lo hay).
  • Dentro de la baliza PAR, una baliza HTML contiene el texto del párrafo en XHTML.

Los ficheros de documentación de campo aparecen situados en la sub carpeta FLD de la carpeta XML de extracción. El formato es el siguiente:

  • un encabezamiento normalizado en xml
  • una baliza FLD con los atributos NAME, LAN, MOD, GEN, LNKHLP, LNKORD, CREDAT, UPDDAT (que definen el nombre, el idioma, el módulo, el atributo genérico de la documentación, la ayuda vinculada, el vínculo, la fecha de creación y la de modificación).
  • Dentro de la baliza FLD, una baliza HTML contiene el texto del párrafo en XHTML.

Los ficheros vinculados a una documentación aparecen en la sub carpeta FILE de la carpeta XML de extracción. El nombre del fichero se construye de la forma siguiente:

COD_LAN_TYP_LEV_SUBLEV_LIG_NOMFICHIER_LGCLE.EXT, o:

  • COD_LAN_TYP_LEV_SUBLEV_LIG se constituye a partir de la clave del fichero ligado a la tabla ADOCBLB (esto sirve para garantizar que el nombre sea único).
  • LGLE contiene toda la clave precedente para poder extraer correctament el código de documentación
  • NOMBREFICHERO y EXT corresponde al nombre del fichero (nombre y extensión) si se indica en ADOCBLB o en un nombre compuesto con los caracteres "IMG", seguidos del número de línea de 3 caracteres (precedido de ceros si es necesario), y seguido de la extensión ".jpg".