Comando IMPORT DELIMITED

Crea una tabla de Analytics definiendo e importando un archivo de texto delimitado.

Sintaxis

IMPORT DELIMITED TO tabla nombrearchivo_importación FROM nombrearchivo_origen <SERVER nombre_perfil> codificación_car_origen SEPARATOR {car|TAB|SPACE} QUALIFIER {car|NONE} <CONSECUTIVE> STARTLINE número_de_línea <KEEPTITLE> <CRCLEAR> <LFCLEAR> <REPLACENULL> <ALLCHAR> {ALLFIELDS|[sintaxis_campo] <...n> <IGNORE núm_campo> <...n>}
sintaxis_campo ::=
FIELD nombre tipo AT posición_inicial DEC valor WID bytes PIC formato AS nombre_visible

Parámetros

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 del servidor para el Servidor de AX donde están ubicados los datos que desea importar.
codificación_car_origen

La codificación y el conjunto de caracteres de los datos de origen.

Según la edición de Analytics que esté utilizando, y la codificación de los datos de origen, especifique el código adecuado:

Código Edición de Analytics Codificación de datos de origen
0

Edición no Unicode

 todos los datos
0

edición Unicode

 Datos ASCII
2 edición Unicode Datos Unicode, codificación UTF-16 LE
3 código_numérico edición Unicode

Datos Unicode que no usan la codificación UTF-16 LE

Para determinar el código numérico que coincide con la codificación de los datos de origen, realice una importación utilizando el Asistente de Definición de Datos, seleccione Texto codificado y busque la codificación coincidente en la lista desplegable.

Para especificar el código, especifique 3, seguido de un espacio y luego el código numérico.
SEPARATOR car | TAB | SPACE

El carácter separador (delimitador) que se utilizó entre los campos en los datos de origen. Debe especificar el carácter como una cadena entre comillas.

Puede especificar un separador de espacio o tabulación escribiendo el carácter entre comillas o utilizando una palabra clave:

  • SEPARATOR "   " o SEPARATOR TAB
  • SEPARATOR " " o SEPARATOR SPACE
QUALIFIER car | NONE

El carácter calificador de texto que se debe utilizar en los datos de origen para encerrar e identificar los valores de los campos. Debe especificar el carácter como una cadena entre comillas.

Para especificar el carácter de comillas dobles como calificador de texto, encierre el signo de las comillas dobles entre comillas simples: QUALIFIER '"'.

Puede especificar que no haya calificadores de texto utilizando cualquiera de los siguientes métodos:

  • QUALIFIER ""
  • QUALIFIER NONE

CONSECUTIVE

opcional

Los calificadores de texto consecutivos se deben tratar como un solo calificador.
STARTLINE número_de_línea

El número de línea en el cual comenzar a leer el archivo.

Por ejemplo, si las primeras tres líneas de un archivo contienen información de encabezado que no desea, especifique STARTLINE 4 para comenzar a leer los datos en la cuarta línea.
KEEPTITLE

opcional
  • KEEPTITLE utilizado con ALLFIELDS Trate el número de línea especificado por STARTLINE como nombres de campo en lugar de datos.

    Si omite KEEPTITLE, se utilizan nombres de campo genéricos y el número de línea especificado por STARTLINE se trata como datos.

  • KEEPTITLE utilizado con la sintaxis FIELD individual No importe el número de línea especificado por STARTLINE. FIELD nombre especifica los nombres de campos.

    Si omite KEEPTITLE, el número de línea especificado por STARTLINE se trata como datos. FIELD nombre especifica los nombres de campos.
CRCLEAR

opcional

Reemplaza los caracteres de retorno de carro (CR) que aparecen entre los calificadores con caracteres de espacios. Debe especificar QUALIFIER con un valor car para usar CRCLEAR.

Si usa tanto el parámetro CRCLEAR como LFCLEAR, el parámetro CRCLEAR debe estar primero.
LFCLEAR

opcional

Reemplaza los caracteres de salto de línea (LF) que aparecen entre los calificadores con caracteres de espacios. Debe especificar QUALIFIER con un valor car para usar LFCLEAR.

Si usa tanto el parámetro CRCLEAR como LFCLEAR, el parámetro CRCLEAR debe estar primero.
REPLACENULL

opcional

Reemplaza todos los caracteres NUL que aparecen en el archivo delimitado por caracteres de espacio. La cantidad de caracteres NUL reemplazados se registra en el log.
ALLCHAR

opcional

Se asigna el tipo de datos de Carácter automáticamente a todos los campos importados.

Consejo

Asignar un tipo de datos de Carácter a todos los campos importados simplifica el proceso de importar archivos de texto delimitado.

Una vez que los datos se encuentran en Analytics, puede asignarles diferentes tipos de datos, como Numéricos o Fechahora, a los campos y especificar los detalles de formato.

ALLCHAR resulta útil al importar una tabla con campos identificadores a los que Analytics asigna automáticamente tipos de datos Numéricos cuando en realidad se deberían usar tipos de datos de Carácter.
ALLFIELDS

Se importan todos los campos del archivo de datos de origen.

Si desea obtener información sobre la manera en la que Analytics asigna los tipos de datos cuando usted utiliza ALLFIELDS, consulte Observaciones.

Nota

Si usted especifica ALLFIELDS, no especifique ninguna sintaxis FIELD individual o IGNORE.
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.

Nota

tipo se ignora si especifica ALLCHAR.
AT posición_inicial

La posición del byte de inicio para el campo en el archivo de datos de Analytics.

Nota

Analytics no Unicode 1 byte = 1 carácter
Analytics Unicode 2 bytes = 1 carácter

En general, en Analytics Unicode, debe especificar una posición de byte de inicio impar. Si especifica una posición de inicio par, es posible que los caracteres no se vean correctamente.
DEC valor

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

Nota

DEC se ignora si especifica ALLCHAR.
WID bytes

La longitud del campo en bytes en el formato de tabla de Analytics.

Nota

Analytics no Unicode 1 byte = 1 carácter
Analytics Unicode 2 bytes = 1 carácter

En Analytics 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.
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.

Nota

PIC se ignora si especifica ALLCHAR.
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.
IGNORE núm_campo <...n>

opcional

Excluye el campo del formato de tabla.

núm_campo especifica la posición del campo excluido en el archivo de datos de origen. Por ejemplo, IGNORE 5 excluye el quinto campo del archivo de datos de origen del formato de tabla de Analytics.

Nota

Los datos del campo se importan, pero no se definen y no aparecen en la nueva tabla de Analytics. Si es necesario, es posible definir los datos más tarde y agregarlos a la tabla.

Para excluir completamente a un campo para que no se lo importe, no lo especifique al especificar los campos de forma individual.

Ejemplos

Importar todos los campos

Usted importa todos los campos desde un archivo delimitado por comas a una tabla de Analytics llamada Empleados. El archivo utiliza comillas como calificador de texto. Los tipos de datos se asignan de manera automática sobre la base de un conjunto de reglas que se describen en Observaciones:

IMPORT DELIMITED TO Empleados "Empleados.fil" FROM "Empleados.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLFIELDS

Importar todos los campos, asignar automáticamente un tipo de datos de Carácter

Usted importa todos los campos desde un archivo delimitado por comas a una tabla de Analytics llamada Empleados. El archivo utiliza comillas como calificador de texto. Se asigna el tipo de datos de Carácter automáticamente a todos los campos importados:

IMPORT DELIMITED TO Empleados "Empleados.fil" FROM "Empleados.csv" 0 SEPARATOR "," QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR ALLFIELDS

Importar los campos especificados, asignar automáticamente un tipo de datos de Carácter

Usted importa los campos especificados desde un archivo delimitado por tabulaciones a una tabla de Analytics llamada Empleados. El archivo utiliza comillas como calificador de texto. Se asigna el tipo de datos de Carácter automáticamente a todos los campos importados:

IMPORT DELIMITED TO Empleados "Empleados.fil" FROM "Empleados.csv" 0 SEPARATOR TAB QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR FIELD "Nombre" C AT 1 DEC 0 WID 25 PIC "" AS "Nombre" FIELD "Apellido" C AT 26 DEC 0 WID 25 PIC "" AS "Apellido" FIELD "NúmTarj" C AT 51 DEC 0 WID 16 PIC "" AS "Número tarjeta" FIELD "NroEmpl" C AT 67 DEC 0 WID 6 PIC "" AS "Número Empleado" FIELD "FechaContratación" C AT 73 DEC 0 WID 10 PIC "" AS "Fecha de contratación" FIELD "Salario" C AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bono_2016" C AT 88 DEC 0 WID 10 PIC "" AS "Bono 2016"

Importar campos especificados, asignar tipos de datos de manera individual

Usted importa los campos especificados desde un archivo delimitado por punto y coma a una tabla de Analytics llamada Empleados. El archivo no utiliza calificadores de texto. Usted especifica el tipo de datos de cada campo importado:

IMPORT DELIMITED TO Empleados "Empleados.fil" FROM "Empleados.csv" 0 SEPARATOR ";" QUALIFIER "" CONSECUTIVE STARTLINE 1 KEEPTITLE FIELD "Nombre" C AT 1 DEC 0 WID 25 PIC "" AS "Nombre" FIELD "Apellido" C AT 26 DEC 0 WID 25 PIC "" AS "Apellido" FIELD "NúmTarj" C AT 51 DEC 0 WID 16 PIC "" AS "Número tarjeta" FIELD "NroEmpl" C AT 67 DEC 0 WID 6 PIC "" AS "Número empleado" FIELD "FechaContratación" D AT 73 DEC 0 WID 10 PIC "MM/DD/AAAA" AS "Fecha de contratación" FIELD "Salario" N AT 83 DEC 0 WID 5 PIC "" AS "" FIELD "Bono_2016" N AT 88 DEC 2 WID 10 PIC "" AS "Bono 2016"

Observaciones

Nota

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Guía de ayuda.

Cómo asigna Analytics los tipos de datos cuando usted utiliza ALLFIELDS

Al utilizar el parámetro ALLFIELDS, en lugar de definir los campos de manera individual, Analytics examina un subconjunto de registros al principio del archivo delimitado y les asigna tipos de datos a los campos sobre la base de un conjunto de reglas que se describen a continuación.

Si es necesario, una vez que los datos se encuentran en Analytics, puede asignarles diferentes tipos de datos, como Numéricos o Fechahora, a los campos y especificar los detalles de formato.

Descripción de los valores de campo en el archivo delimitado Ejemplos Tipo de datos asignado
Los valores se encierran entre calificadores de texto "Proveedores ABC"

"6.990,75"

 Carácter
Los valores incluyen un carácter no numérico en cualquier lugar del campo, con la excepción de las comas y los puntos que se utilizan como separadores numéricos y el signo negativo (-) $995

(995)

 Carácter
Los valores incluyen únicamente números, separadores numéricos o el signo negativo 6.990,75

-6.990,75

995

 Numérico
En un campo hay uno o más valores en blanco   Carácter
Valores de fechahora con separadores o meses alfabéticos

2016/12/31

31 dic 2016

 Carácter
Valores de fechahora que son solo números 20161231 Numérico

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 de 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)