Modelos importación/exportación

• Modelo (campo EXT)

Este código identifica el modelo de importación o exportación.

• Descripción (campo INTIT)

Permite definir una descripción asociada a cada ficha.

• Activo (campo ENAFLG)

Marca esta casilla para activar el registro en curso.

Los registros no seleccionados conservan su contenido y parametrización, pero no se pueden utilizar mediante otra llamada a su código en:

• otros registros como los documentos y parámetros
• los procesos en masa

Las habilitaciones en una función determinada pueden prohibir la creación de un registro activo. En ese caso, la casilla se desactiva por defecto. Solo se puede modificar por un usuario autorizado o mediante un Workflow de firma.

• Propietario (campo AFACTORYOW)

Este campo indica el nombre del propietario del modelo de importación o de exportación.

Si el propietario es SAGE, los datos de la pantalla no se pueden modificar.

• Objeto (campo OBJ)

Este campo define el código del objeto que se va a importar o exportar. Se trata de un campo opcional en el caso de las exportaciones. El bloque de identificación muestra el nombre de la tabla principal que se va a exportar.

• Función (campo FONCTION)

Este campo inicializa el contexto y verifica los derechos de acceso. Es de utilidad cuando se utiliza el mismo objeto en varias funciones. Para poder utilizar el modelo, los usuarios deben disponer de los derechos de acceso adecuados para la función.

Este campo es obligatorio.

• Módulo (campo MODULE)

Selecciona un módulo para la parametrización.

Este campo permite indicar si la pantalla se debe crear en la base de datos del dossier. Se crea si el módulo al que está asociada la pantalla está activo en el dossier.

• Código actividad (campo CODACT)

Un código de actividad permite:

• definir como opcional un elemento del diccionario si el valor asociado al código de actividad es nulo;
• identificar elementos específicos si se marcan con un código que comienza por X, Y o Z;
• asignar un número máximo de líneas cuando el código de actividad marca elementos desde una tabla.

Si el código de actividad está desactivado:

• el elemento marcado no se puede utilizar;
• el código asociado no se puede gestionar ni activar.

• Cód. de acceso (campo ACS)

Este código de acceso permite prohibir el acceso a la ficha en curso a ciertos usuarios.

Si el campo se alimenta, solo los usuarios con derechos de lectura en este código de acceso pueden visualizar el registro y solo los usuarios con derechos de escritura pueden modificarlo.

Este código de acceso permite prohibir el acceso a la ficha en curso a ciertos usuarios.

Si el campo se alimenta, solo los usuarios con derechos de lectura en este código de acceso pueden visualizar el registro y solo los usuarios con derechos de escritura pueden modificarlo.

El permiso de ejecución vinculado a un código de usuario se trata de forma especial en el caso de los modelos de importación o exportación: si un usuario no tiene permiso de ejecución, no podrá utilizar el modelo para importar o exportar datos.

• Script estándar (campo TRTIMP)

Este campo define el proceso estándar que incluye las etiquetas de las acciones que se ejecutan en los procesos de importación y exportación.

Estos procesos permiten realizar inicializaciones, controles complementarios y actualizaciones de ser necesario. La estructura de este programa se describe en el anexo técnico. Nota: Los procesos estándar por lo general denominados IMPXXX (donde XXX es el código de importación) se proporcionan para un determinado número de importaciones.

Para más información, consulta la documentación anexa correspondiente.

• Script específico (campo SPEIMP)

Este campo define el proceso específico, que se inicia antes que el proceso estándar, y que permite realizar las mismas acciones desactivando, si es necesario, lo que hace el proceso estándar.

Estos procesos permiten realizar inicializaciones, controles complementarios y actualizaciones de ser necesario.

Para más información, consulta la documentación anexa correspondiente.

• Tipo de fichero (campo TYPFIL)

Este campo define la estructura utilizada para generar los datos en el fichero que se va a importar o exportar. Para más información, consulta el párrafo correspondiente.

• Separador de campo (campo SEPFLD)

Indica el carácter que se utiliza como separador entre dos campos.

Para introducir un carácter no imprimible, introduce el símbolo "\" (barra inversa) seguido de 3 cifras que representan el código ASCII del carácter en base decimal.

• Separador registro (campo SEPREC)

Indica el separador entre dos registros (grupos de datos).

Para introducir un carácter no imprimible, introduce el símbolo "\" (barra inversa) seguido de 3 cifras que representan el código ASCII del carácter en base decimal.

Los separadores más utilizados son estos:

• el carácter de "avance de línea" (\010), que corresponde al final de la línea en los ficheros de texto Unix;
• la combinación de dos caracteres de "retorno de carro" y de "avance de línea" (\013\010), que corresponde al final de la línea en los ficheros de texto Windows.

• Delimitador de campo (campo FLDLIM)

El delimitador de campo se incluye en la primera y en la última posición de los campos de tipo alfanumérico. Para los campos numéricos y los campos de fecha, no se necesita ningún separador.

Suele ser uno de estos caracteres:

• comillas simples: '...'
• comillas dobles: "..."

• Formato fichero (campo CODDBA)

Indica el formato de los caracteres utilizados en el fichero:

• ASCII es el formato clásico en el que un carácter equivale a un byte en el fichero. Este tipo de formato permite tratar los caracteres occidentales clásicos, con varios conjuntos de caracteres posibles, definidos en el campo correspondiente.
• UTF-8 corresponde a un formato UNICODE en el que el número de caracteres es variable (de 1 a 4; 1 es el conjunto de caracteres latinos no acentuados). Este formato permite gestionar todos los tipos de caracteres, especialmente los chinos.
• UCS-2 corresponde a un formato estándar de Microsoft, en el que los caracteres se almacenan sistemáticamente en 2 bytes.

• Export. (campo EXPORT)

Si esta casilla está marcada, se puede utilizar este modelo para exportar datos.

• Contador export. (campo CHRNUM)

Este campo, que no se puede modificar, almacena el valor del número de secuencia en la última exportación. En las exportaciones cronológicas, esto permite procesar solo lo que se ha modificado desde la última exportación.

• Juego de caracteres (campo OPTCHA)

Con el conjunto de caracteres ASCII, puedes utilizar diferentes formatos estandarizados:

• el código ISO 8859 (que es, por otro lado, el conjunto interno de Adonix cuando se trabaja en ASCII)
• el código del tercero IBM
• el código ASCII de 7 bits sin acentos (las letras acentuadas se convierten en letras en minúscula sin acento)

• Separador decimal (campo SEPDEC)

Este campo define el separador decimal utilizado para las cifras. Si está en blanco, el separador decimal que se tiene en cuenta es el punto (".").

• Formato de fechas (campo OPTDAT)

Este campo determina el tipo de codificación de los campos de fechas.

Solo puedes definir el orden de los datos y el número de cifras del año. En la importación se filtran todos los caracteres de separación entre campos; por ejemplo, los formatos de fecha DD-MM-AA o DD/MM/AAAA se interpretarán correctamente.

Los programas secundarios de codificación de fechas tienen en cuenta la variable adxdcs del motor. Esta variable se define en el parámetro general DCS y permite definir la manera en que se decodifican los años en dos caracteres. DCS representa un año puente con el que se determina el siglo correspondiente;

por ejemplo, si DCS es igual a 1940 y el año se define en dos caracteres:

• un valor inferior o igual a 40 se considera parte del siglo XXI;
• un valor superior a 40 se considera parte del siglo XX.

Por lo tanto, los años comprendidos entre 1940 y 2039 se pueden expresar con dos cifras.

• campo LIBDAT

Descripción asociada al código anterior.

• Formato menús locales (campo OPTMNL)

Los campos de tipo menú local se almacenan con un número que representa su rango en la tabla.

Según el valor de este campo, el modelo va a exportar o intentar encontrar una importación:

• 0 : 0. La elección es un número que indica el rango del menú en la tabla. 1 para la primera opción, 2 para la segunda, etc. Esto también corresponde al formato interno donde se almacena el menú local en la base de datos.
• 1 : 1. La elección se introduce utilizando el código, en un carácter, asociado a cada elección del menú local. Este código no se puede visualizar en la gestión de menús locales. Se puede definir en la gestión de mensajes de las funciones de desarrollo, donde se puede introducir este código interno. Esta es la única utilidad de este código interno, a diferencia de las versiones anteriores de los caracteres, donde se utilizaba como acelerador de entrada.
• n : (n>1). Los n primeros caracteres de la descripción que aparecen en la introducción. Cuando se utiliza esta opción, el algoritmo de reconocimiento busca en el primer carácter, después en el segundo y así sucesivamente hasta que se encuentra aquel al que corresponde el título. De esta forma, si se quiere buscar CHQ en un menú local cuyos campos son Metálico, Transferencia, Cheque, Letra, Tarjeta, el algoritmo reconocerá Cheque, al coincidir en las dos primeras letras.

Los títulos de los menús locales son los textos que se muestran en la pantalla y el valor almacenado en la base de datos es el rango en la tabla. En el momento de la importación, el título del menú local se puede cambiar para que el algoritmo de búsqueda funcione correctamente. Esta modificación solo se puede implementar en modos monousuario. Esta operación no se ha concebido para las transferencias normales ni automatizadas.

• campo LIBMNL

Descripción asociada al código anterior.

• Import. (campo IMPORT)

Si este campo está seleccionado, se puede utilizar este modelo para importar los datos.

• Actualización autorizada (campo OPTUPD)

Utiliza este campo para modificar un registro que ya exista durante la importación.

• Sas (campo AOWSTA)

Cuando esta casilla está marcada, la importación de datos alimenta el espacio de almacenamiento de importación/exportación con datos erróneos. A pesar de esto, se crea un fichero de errores.

• Importación especial (campo OPTSPE)

Este campo indica que la introducción de datos en la base se realiza mediante acciones específicas definidas en el proceso cuyo nombre aparece en el campo Proceso importación. Este proceso posee un número limitado de puntos de entrada, por lo que es necesario escribir un proceso que incluya todos los controles que se quieran realizar.

Su uso permite agrupar los controles para optimizar el programa de importación. La estructura de las importaciones personalizadas se describe en el anexo. Están disponibles las siguientes acciones:

• $RAZCRE con llamada directa desde la importación
• $SAIMSK con llamada directa desde la importación en cada registro leído (reemplaza la llamada SAIMSK estándar; asignación y control de los campos de la pantalla a partir de la clase [F])

• Workflow (campo ENAWRK)

Si esta casilla está desmarcada, dejan de ejecutarse los eventos de workflow relativos a las operaciones básicas (creación o modificación en gestión de objetos). Si se inicializan importaciones que generan actualizaciones masivas, esta opción también evita que se desencadenen numerosos eventos. De hecho, esto podría afectar al rendimiento de la importación y conllevar una generación masiva de mensajes.

No obstante, no se desactivan los eventos de workflow relativos al desencadenamiento de la importación.

• N.º (campo NUMFLG)

Línea en curso de la tabla.

• Nivel (campo FLGLEV)

Este campo define el nivel de anidación del grupo. El nivel 1 es el principal. Un nivel N+1 representa un nivel inferior al nivel N, que lo precede.

• Indicador (campo FLGREC)

Este campo identifica el grupo mediante un código de hasta 5 caracteres. Una referencia a este código se incluye en la tabla de los campos de la sección siguiente y en el propio fichero, como cabecera de grupo.

• Tabla (campo FLGFIL)

Esta tabla de indicadores define la estructura de los grupos de registros. Consulta el párrafo correspondiente.

• Clave (campo FLGKEY)

Este campo define la clave de la tabla vinculada que se utiliza para acceder a los registros detallados del grupo, a partir de los valores de los campos de las tablas de niveles superiores utilizadas en la expresión de vínculo.

• Vínc. (campo FLGLNK)

Este campo define la expresión de vínculo. Esta expresión se compone de valores, separados por punto y coma, que aporta los valores clave que vinculan la tabla de detalle con el registro de cabecera.

• Longitud (campo RECLEN)

En el caso de un tipo de fichero de longitud fija, es necesario indicar el número de caracteres de cada registro.

• N.º (campo NUMLIG)

Línea en curso de la tabla.

• Indicador (campo TYP)

Este campo se introduce solamente cuando la tabla de los identificadores de grupos de la pestaña precedente no está vacía. Permite asociar los datos que se van a exportar o importar a un grupo de datos.

• Tabla (campo FIL)

Este campo indica la tabla de la base de datos donde se definen los datos que se van a importar o exportar. Notas:

• Este campo es obligatorio, incluso si no se utiliza. Si, en el modelo de exportación, se indica una expresión del cálculo, esta puede hacer referencia a campos de tablas diferentes.
• La tabla correspondiente no siempre es la tabla principal del grupo; puede tratarse se una tabla vinculada a la tabla principal de este grupo o de uno de los grupos anteriores del nivel superior. Si no se encuentra ningún vínculo, se muestra un mensaje de advertencia: Enlace automático no gestionado. Esto significa que el proceso de importación o de exportación (indicado en la primera sección) debe establecer el vínculo manualmente, por ejemplo, definiendo la tabla en la acción IMP_OUVRE y la lectura de la tabla en la acción IMP_LIENS.

• Campo (campo FLD)

Este campo permite indicar el nombre del campo de la tabla que se va a importar o exportar. Se pueden utilizar varias sintaxis para definir los datos que se van a extraer o integrar:

• La barra (/) indica que un indicador de grupo se introduce en la exportación o se busca durante este proceso. Cuando hay varios grupos en un modelo compatible con la importación, este separador es obligatorio para cada uno. Si se utiliza un modelo de tipo Delimitado, el separador de grupo se considera un campo normal acotado por separadores de campos y delimitadores.
• La sintaxis más sencilla es FIELD(index); cuando se importa o exporta un campo procedente de la tabla referenciada en la columna anterior. Una ventana de selección muestra las opciones disponibles.
• Si aquí se introduce una cadena de caracteres constante entre comillas dobles, el campo se incluirá tal y como consta en el fichero que se va a exportar y se omitirá en la importación.
• Si no se introduce nada, habrá un campo en blanco en el fichero exportado acotado por delimitadores de campo si el modelo es de tipo Delimitado. En el modo de importación, esto significa que el campo correspondiente se debe ignorar.
• La sintaxis *N, donde N equivale a un número entre 1 y 99, también se puede utilizar. Esta permite asignar (en la importación) o leer (en la exportación) la variable GIMP(N). GIMP es una variable global que consta de una cadena de hasta 100 caracteres, y hay que asignarla a un proceso personalizado asociado a la importación o la exportación.
• La última opción, aplicable únicamente a la exportación, consiste en definir una expresión calculada cualquiera precedida del signo igual (=). Esta expresión permite realizar llamadas a constantes, funciones, variables, operadores o campos que proceden de otras tablas. La sintaxis se verifica en el momento en que se introduce. El control del contexto, que por ejemplo permite comprobar la existencia de variables, no se puede verificar.

• Descripción (campo COM)

Añade un comentario que ayude a entender mejor la configuración.

• Límite (campo SEL)

Hay tres opciones posibles en este campo:

• No entrada implica que no se introducirá ningún rango de inicio y de fin al inicializar la exportación.
• Entrada implica que se introducirá un rango de inicio y de fin al inicializar la exportación.
• No transferido implica que se podrá introducir un rango de inicio y de fin al inicializar la exportación sin que el campo se transfiera durante el proceso.

• Posición (campo LOC)

Esta columna solo se utiliza para los formatos con longitud fija. En este caso, la posición condiciona el distanciamiento con respecto al inicio del bloque o del registro. Las posiciones se expresan en bytes, donde 1 representa el inicio del bloque o del registro. Las posiciones han de ser compatibles con el tamaño del registro.

• Longitud (campo LNG)

Esta zona determina el tamaño del campo en el fichero secuencial.

• Formato (campo FMT)

Esta columna solo se introduce si el formato es de longitud fija. En el caso de los importes numéricos, el formato introducido es nnn o nnn,mmm teniendo en cuenta lo siguiente:

• Las cifras pueden tener el prefijo < o > y justificación izquierda o derecha completada con ceros (la derecha se debe utilizar por defecto).
• Las cifras pueden tener + como prefijo o sufijo. Este signo es obligatorio antes o después de la cifra.
• Las cifras pueden tener el prefijo *. El separador decimal no debe aparecer. En la siguiente tabla se muestran ejemplos de cómo se formatea un importe. Los espacios se sustituyen por #:

En un formato alfanumérico, las únicas directivas de formateo posibles son < o > (justificación derecha o izquierda, sabiendo que las cadenas de caracteres se completan con espacios).

• Modelo (campo PATTERN)

Este campo se utiliza al importar o exportar en formato XML.

Cuando se crea un fichero XML, hay que proporcionar más información; por ejemplo, al crear un fichero XSD que describa la estructura del fichero XML para controlar su validez con las herramientas de verificación de sintaxis integradas en los software ETL.

Este campo define si un modelo debe estar asociado a la descripción introducida en el fichero XSD.

Si este campo se completa, el fichero XSD contiene una especificación de tipo:
pattern value='value_entered_in_the_pattern_field'

Para mayor información sobre las sintaxis que se pueden utilizar en los modelos, consulta los tutoriales en línea (como este).

• Etiqueta (campo BAL)

Este campo se utiliza al importar o exportar en formato XML.

Cuando se crea un fichero XML, hay que proporcionar más información; por ejemplo, al crear un fichero XSD que describa la estructura del fichero XML para controlar su validez con las herramientas de verificación de sintaxis integradas en los software ETL.

Este campo define el código de la etiqueta que describe el campo exportado en el modelo, tal y como aparecerá en el fichero XML.

• Obligatorio (campo OBL)

Este campo se utiliza al importar o exportar en formato XML.

Cuando se crea un fichero XML, hay que proporcionar más información; por ejemplo, al crear un fichero XSD que describa la estructura del fichero XML para controlar su validez con las herramientas de verificación de sintaxis integradas en los software ETL.

Este campo define si el campo es obligatorio. Si tiene asignado el valor Sí, el fichero XSL contiene una especificación de tipo minOccurs='1'.

• Número tabla (campo NUMTAB)

Este número, de existir, hace referencia a una tabla de transcodificación que codifica los campos leídos y los formatea según lo esperado.

• campo TYPEXP

Selecciona el tipo de exportación que quieras realizar. Las opciones son:

• cliente
• servidor

• Fichero de datos (campo FILEXT)

Este campo define la ruta del fichero de datos por defecto, propuesta al inicio del proceso de exportación o importación. Este fichero de datos se utiliza en modo automático para las cadenas de importaciones o exportaciones y su ruta puede ser relativa. En ese caso, el directorio de la base de datos es el directorio de instalación del software.

La ruta también puede integrar el carácter #, en cuyo caso, se aplica la gestión de los números secuenciales (contador):

• En el modo de importación, se buscan todos los ficheros cuyo modelo coincide con la ruta y el # representa 5 cifras. Los ficheros se integran en orden ascendente según el número.
• En el modo de exportación, se crea un fichero con el valor formateado del contador [C]EXPORT en 5 cifras. Esto implica que la casilla Gestión contador esté marcada al iniciar la función de exportación.

Por ejemplo, si el contador de exportación es igual a 156, /u/tmp/fic# permite generar el fichero /u/tmp/fic00156.

• Directorio final (campo REPFIN)

Este campo impone el directorio final al que se transfiere el fichero una vez importado. Cuando no tiene asignado ningún valor, se utiliza el directorio definido en los parámetros generales de la importación o exportación.