Comando IMPORT PRINT

Información de concepto

Definir e importar un archivo de imagen de impresión

Crea una tabla de Analytics definiendo e importando un archivo de imagen de impresión (reporte).

Sintaxis

IMPORT PRINT TO tabla nombrearchivo_importación FROM nombrearchivo_origen <SERVER nombre_perfil> valor_conjunto_caracteres <número_página_código> {[sintaxis_registro] [sintaxis_campo] <...n>} <...n>
sintaxis_registro ::=
RECORD nombre_del_registro tipo_de_registro líneas_en_el_registro transparente [sintaxis_prueba]<...n>
sintaxis_prueba ::=
TEST incluir_excluir tipo_de_coincidencia AT línea_de_inicio;posición_inicial;rango lógica texto
sintaxis_campo ::=
FIELD nombre tipo AT línea_de_inicio; posición_inicial SIZE longitud; líneas_en_el_campo DEC valor WID bytes PIC formato AS nombre_visible

Parámetros

Parámetros generales

Nombre Descripción
TO tabla

El nombre de la tabla de Analytics a la que se importarán los datos.

Nota

Los nombres de tabla tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

nombrearchivo_importación

El nombre del archivo de datos de Analytics que se debe crear.

Especifique nombrearchivo_importación como una cadena entre comillas con una extensión de archivo .FIL. Por ejemplo: "Facturas.FIL".

Por valor predeterminado, el archivo de datos (.FIL) se guarda en la carpeta que contiene el proyecto de Analytics.

Utilice una ruta de archivo absoluta o relativa para guardar el archivo de datos en una carpeta existente o una diferente:

  • "C:\datos\Facturas.FIL"
  • "datos\Facturas.FIL"

FROM nombrearchivo_origen

El nombre del archivo de datos de origen. nombrearchivo_origen debe ser una cadena entre comillas.

Si el archivo de datos de origen no está ubicado en el mismo directorio que el proyecto Analytics, debe utilizar una ruta de acceso absoluta o una ruta de acceso relativa para especificar la ubicación del archivo:

  • "C:\datos\nombrearchivo_origen"
  • "datos\nombrearchivo_origen"
SERVER nombre_perfil

opcional

 El nombre de perfil para el servidor que contiene los datos que desea importar.
valor_conjunto_caracteres

El conjunto de caracteres utilizado para codificar el archivo de imagen de impresión (reporte). Se admiten los siguientes valores:

  • 0: ASCII
  • 1: EBCDIC
  • 2: Unicode
  • 3: Texto codificado
número_página_código

opcional

Si especificó 3 (Texto codificado) para valor_conjunto_caracteres, también debe ingresar un número de página de códigos.

Parámetro RECORD

Información de la definición del registro general.

Nota

Parte de la información de definición del registro se especifica utilizando códigos numéricos que coinciden con las opciones del Asistente de Definición de Datos.

En los scripts, especifique el código numérico, no el nombre de la opción.

Nombre Descripción

RECORD nombre_del_registro

El nombre del registro en el Asistente de Definición de Datos.

Es necesario especificar el nombre_del_registro en el comando IMPORT PRINT, pero el valor nombre_del_registro no aparece en la tabla de Analytics que se obtiene como resultado.

En el Asistente de Definición de Datos, Analytics proporciona nombres predeterminados sobre la base del tipo de registro:

  • Detalle
  • Encabezadon
  • Pie de páginan

Puede usar los nombres predeterminados o especificar nombres diferentes.

tipo_de_registro

Los tres tipos de registro posibles al definir un archivo de Imagen de impresión:

  • 0: detalle
  • 1: encabezado
  • 2: pie de página

Nota

Puede definir varios conjuntos de registros de encabezado y pie de página en una única ejecución de IMPORT PRINT, pero solo un conjunto de registros de detalle.

líneas_en_el_registro

La cantidad de líneas que ocupa un registro en el archivo de imagen de impresión.

Puede definir registros de una o varias líneas para que coincidan con los datos del archivo.

transparente

El ajuste de transparencia para un registro de encabezado.

Nota

Se aplica únicamente a los registros de encabezado.

  • 0: no transparente
  • 1: transparente

Los registros de encabezado transparentes no separan los registros de detalle de varias líneas.

Si un registro de encabezado separa un registro de detalle de varias líneas del archivo de imagen de impresión de origen, lo cual puede ocurrir cuando hay un salto de página, al especificar 1 (transparente), se unifica el registro de detalle de la tabla de Analytics resultante.

Parámetro TEST

Los criterios para definir un conjunto de registros en el archivo de imagen de impresión. Puede tener una o más instancias de TEST (hasta 8) para cada instancia de RECORD.

Nota

Algunos de los criterios se especifican utilizando códigos numéricos que asignan las opciones del Asistente de Definición de Datos (los nombres de las opciones se muestran a continuación entre paréntesis).

En los scripts, especifique el código numérico, no el nombre de la opción.

Nombre Descripción
TEST incluir_excluir

Cómo tratar los datos coincidentes:

  • 0: (Incluir) los datos que reúnen los criterios se incluyen en el conjunto de registros
  • 1: (Excluir) los datos que reúnen los criterios se excluyen del conjunto de registros
tipo_de_coincidencia

El tipo de coincidencia que se debe aplicar:

  • 0: (Concordancia exacta) los registros coincidentes deben contener el carácter o la cadena de caracteres especificados en la línea de inicio especificada, comenzando en la posición inicial especificada
  • 2: (Alfabético) los registros coincidentes deben contener uno o más caracteres alfabéticos en la línea de inicio especificada, en la posición inicial especificada o en todas las posiciones del rango especificado
  • 3: (Numérico) los registros coincidentes deben contener uno o más caracteres numéricos en la línea de inicio especificada, en la posición inicial especificada o en todas las posiciones del rango especificado
  • 4: (En blanco) los registros coincidentes deben contener uno o más espacios en blanco en la línea de inicio especificada, en la posición inicial especificada o en todas las posiciones del rango especificado
  • 5: (No en blanco) los registros coincidentes deben contener uno o más espacios de caracteres que no estén en blanco (incluidos los caracteres especiales), en la línea de inicio especificada, en la posición inicial especificada o en todas las posiciones del rango especificado
  • 7: (Buscar en línea) los registros coincidentes deben contener el carácter o la cadena de caracteres especificados en cualquier lugar de la línea de inicio especificada
  • 8: (Buscar en rango) los registros coincidentes deben contener el carácter o la cadena de caracteres especificados en la línea de inicio especificada, en cualquier lugar del rango especificado
  • 10: (Búsqueda con comodines) los registros coincidentes deben contener caracteres que coincidan con el patrón de caracteres especificado, en la línea de inicio especificada, comenzando en la posición especificada
AT línea_de_inicio; posición_inicial; rango
  • línea_de_inicio la línea del registro a la que se aplican los criterios

    Por ejemplo, si crea una búsqueda con comodines para que coincidan con códigos postales y los códigos postales aparecen en la tercera línea de un registro de tres líneas, debe especificar 3 en línea_de_inicio.

    Nota

    En el caso de registros de una sola línea, el valor de línea_de_inicio es siempre 1.

  • posición_inicial la posición inicial en bytes del archivo de imagen de impresión para la comparación con los criterios
  • rango la cantidad de bytes a partir de la posición inicial de bytes en el archivo de imagen de impresión que se debe usar en la comparación con los criterios

    Si está utilizando únicamente la posición de bytes de inicio, sin un rango, especifique 0 para rango.

    Nota

    Analytics no Unicode1 byte = 1 carácter
    Analytics Unicode, datos ASCII (ANSI) extendido1 byte = 1 carácter
    Analytics Unicode, datos Unicode2 bytes = 1 carácter

    Para los datos Unicode, el rango debe ser un número par de bytes. Por ejemplo, 50;59 (10 bytes). Si especifica un número de bytes impar, tal vez no sea posible lograr una coincidencia correcta con los criterios.
lógica

Las relaciones lógicas entre los criterios:

  • 0: (Y) el criterio actual y el siguiente se relacionan con un AND lógico
  • 1: (O) el criterio actual y el siguiente se relacionan con un OR lógico
  • 4: (Nuevo grupo > Y) el criterio actual es el último de un grupo de criterios lógicos y el grupo actual y el grupo siguiente están relacionados con un AND lógico
  • 5: (Nuevo grupo > O) el criterio actual es el último de un grupo de criterios lógicos y el grupo actual y el siguiente se relacionan con un OR lógico
  • 7: (Fin) el criterio actual es el último de un grupo de criterios lógicos
texto

Caracteres literales o comodín con los que se debe buscar una coincidencia:

  • Para Concordancia exacta, Buscar en línea o Buscar en rango, especifica el carácter o la cadena de caracteres que identifican de manera exclusiva al conjunto de registros del archivo de imagen de impresión.
  • Para Búsqueda con comodines, especifica el patrón de caracteres que identifican de manera exclusiva el conjunto de registros del archivo de imagen de impresión

    La opción Búsqueda con comodines usa la misma sintaxis que la Función MAP( ).

Para otros tipos de coincidencias, texto es una cadena vacía "".

Parámetros FIELD

Información de la definición de campo.

Nombre Descripción
FIELD nombre tipo

Los campos individuales para importar desde el archivo de datos de origen, incluidos el nombre y el tipo de datos del campo. Para excluir un campo de la importación, no lo especifique.

Si desea obtener información acerca de los tipos, consulte Identificadores de los tipos de datos de los campos.
AT línea_de_inicio; posición_inicial
  • línea_de_inicio la línea de inicio del campo del registro del archivo de imagen de impresión

    En el caso de registros de varias líneas en un archivo de imagen de impresión, línea_de_inicio le permite comenzar un campo en cualquier línea del registro. línea_de_inicio siempre es 1 si líneas_en_el_registro es 1.

  • posición_inicial la posición inicial en bytes del campo del archivo de imagen de impresión

    Nota

    Analytics no Unicode1 byte = 1 carácter
    Analytics Unicode, datos ASCII (ANSI) extendido1 byte = 1 carácter
    Analytics Unicode, datos Unicode2 bytes = 1 carácter
SIZE longitud; líneas_en_el_campo
  • longitud la longitud del campo en bytes en el formato de tabla de Analytics

    Nota

    Analytics no Unicode1 byte = 1 carácter
    Analytics Unicode, datos ASCII (ANSI) extendido1 byte = 1 carácter
    Analytics Unicode, datos Unicode2 bytes = 1 carácter

    Para los datos Unicode, especifique solo un número par de bytes. Si especifica un número de bytes impar, es posible que los caracteres no se vean correctamente.

  • líneas_en_el_campo la cantidad de líneas ocupadas por un valor de campo individual en el archivo de imagen de impresión

    Puede definir campos de una o varias líneas para hacer coincidir con los datos del archivo.

    Nota

    La cantidad de líneas especificadas para un campo no puede superar la cantidad de líneas especificadas para el registro que contiene el campo.
DEC valor

La cantidad de lugares decimales para los campos numéricos.
WID bytes

El ancho visible del campo en bytes.

El valor que se especifica controla el ancho visible del campo en las vistas y reportes de Analytics. El ancho visible nunca altera los datos; sin embargo, si es más pequeño que la longitud del campo, es posible que oculte datos.
PIC formato

Nota

Se aplica solo a campos numéricos o de fechahora.

  • campos numéricos el formato de visualización de los valores numéricos en las vistas y los reportes de Analytics
  • campos de fechahora el formato físico de los valores de fechahora en los datos de origen (orden de los caracteres de fecha y hora, los separadores, etc.)

    Nota

    Para los campos de fechahora, el formato debe coincidir exactamente con el formato físico de los datos de origen. Por ejemplo, si los datos de origen son 12/31/2014, debe ingresar el formato como MM/DD/AAAA.

formato debe estar encerrado entre comillas.
AS nombre_visible

El nombre visible (título de columna alternativo) para el campo en la vista de la nueva tabla de Analytics.

Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.

AS es obligatorio cuando se está definiendo un FIELD. Para que el nombre visible sea el mismo que el nombre del campo, introduzca un valor en blanco en nombre_visible con la siguiente sintaxis: AS "". Asegúrese de que no haya un espacio entre las dos comillas.

Ejemplos

Importación de datos desde un archivo de imagen de impresión (Reporte)

Usted importa datos desde el archivo de imagen de impresión (Reporte), Reporte.txt.

Se crea un registro de encabezado y un conjunto de registros de detalles, con cinco campos, en la tabla de Analytics resultante, Reporte_inventario:

IMPORT PRINT TO Reporte_inventario "Reporte_inventario.FIL" FROM "Reporte.txt" 0 RECORD "Encabezado1" 1 1 0 TEST 0 0 AT 1;17;0 7 ":" FIELD "Campo_1" C AT 1;19 SIZE 2;1 DEC 0 WID 2 PIC "" AS "Clase Prod" FIELD "Campo_2" C AT 1;24 SIZE 31;1 DEC 0 WID 31 PIC "" AS "Descripción Prod" RECORD "Detalle" 0 1 0 TEST 0 0 AT 1;59;59 7 "." FIELD "Campo_3" X AT 1;6 SIZE 9;1 DEC 0 WID 9 PIC "" AS "ID Elemento" FIELD "Campo_4" C AT 1;16 SIZE 24;1 DEC 0 WID 24 PIC "" AS "Desc. elemento" FIELD "Campo_5" N AT 1;40 SIZE 10;1 DEC 0 WID 10 PIC "" AS "Disponible" FIELD "Campo_6" N AT 1;50 SIZE 12;1 DEC 2 WID 12 PIC "" AS "Costo" FIELD "Campo_7" N AT 1;62 SIZE 12;1 DEC 2 WID 12 PIC "" AS "Total"

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Definición e importación de archivos de imagen de impresión (reporte) y archivos PDF.

Identificadores de los tipos de datos de los campos

La siguiente tabla incluye las letras que debe usar al especificar el tipo para FIELD. Cada letra corresponde a un tipo de datos de Analytics.

Por ejemplo, si está definiendo un campo Apellido, que necesita tipos de datos de carácter, especificará "C": FIELD "Apellido" C.

Si desea obtener más información, consulte Tipos de datos en Analytics.

Nota

Cuando utilice el Asistente de definición de datos para definir una tabla que incluya campos EBCDIC, Unicode o ASCII, se le asignará la letra "C" automáticamente a los campos (correspondiente al tipo CHARACTER [carácter]).

Al ingresar manualmente un enunciado IMPORT o editar un enunciado IMPORT existente, puede utilizar los valores más específicos de las letras "E" o "U" en lugar de los campos EBCDIC o Unicode.

Letra

Tipo de datos de Analytics

A

ACL

B

BINARY (binario)

C

CHARACTER (carácter)

D

DATETIME

E

EBCDIC

F

FLOAT (flotante)

G

ACCPAC

I

IBMFLOAT

K

UNSIGNED

L

LOGICAL

N

PRINT

P

PACKED (compactado)

Q

BASIC

R

MICRO

S

CUSTOM

T

PCASCII

U

UNICODE

V

VAXFLOAT

X

NUMERIC (numérico)

Y

UNISYS

Z

ZONED (zonado)