Guía de creación de scripts de ACL 14.1

Comando IMPORT MULTIDELIMITED

Crea varias tablas de Analytics definiendo e importando varios archivos delimitados.

IMPORT MULTIDELIMITED <TO carpeta_de_importación> FROM {nombre_de_archivo_de_origen|carpeta_de_origen} codificación_car_origen SEPARATOR {car|TAB|SPACE} QUALIFIER {car|NONE} <CONSECUTIVE> STARTLINE número_de_línea <KEEPTITLE> <CRCLEAR> <LFCLEAR> <REPLACENULL> <ALLCHAR>

Nota

Debe especificar los parámetros de IMPORT MULTIDELIMITED exactamente en el mismo orden que más atrás y en la tabla que se incluye a continuación.

Para importar varios archivos delimitados correctamente, la estructura de todos los archivos debe coincidir antes de la importación.

Si desea obtener más información, consulte Es necesario que los archivo tengan la misma estructura.

Nombre Descripción
TO carpeta_de_importación

opcional

La carpeta a la cual se importarán los datos.

Para especificar la carpeta, use una ruta de archivo absoluta o una ruta de archivo relativa a la carpeta que contiene el proyecto de Analytics. Especifique carpeta_de_importación como una cadena entre comillas.

Ejemplo

TO "C:\Auditoría del punto de venta\Datos\Datos de trabajo de transacciones"
TO "Datos\Datos de trabajo de transacciones"

Si omite TO, los datos se importan a la carpeta donde se encuentra el proyecto de Analytics.

FROM nombre_de_archivo_de_origen | carpeta_de_origen

El nombre de los archivos de datos de origen o de la carpeta donde se encuentran los archivos de datos de origen.

Especifique nombre_de_archivo_de_origen o carpeta_de_origen como una cadena entre comillas.

El comando permite importar cuatro tipos de archivos delimitados:

  • *.csv
  • *.dat
  • *.del
  • *.txt

Los archivos de datos de origen de la carpeta raíz del proyecto de Analytics

Para especificar varios archivos de Excel, use un comodín (*) en lugar de caracteres exclusivos en los nombres de los archivos. El carácter comodín representa cero (0) o más instancias de cualquier letra, número o carácter especial.

Ejemplo

FROM "Transacciones_FY*.csv"

selecciona:

Transacciones_FY18.csv

Transacciones_FY17.csv

Puede usar un comodín en más de un lugar del nombre del archivo y en la extensión de archivo.

Ejemplo

FROM "Transacciones_FY*.*"

selecciona:

Transacciones_FY18.txt

Transacciones_FY17.csv

Los archivos de datos de origen que no se encuentran en la carpeta raíz del proyecto de Analytics

Si los archivos de datos de origen no están ubicados en la mima carpeta que el proyecto de Analytics, debe utilizar una ruta de acceso absoluta o una ruta de acceso relativa a la carpeta donde se encuentra el proyecto para especificar la ubicación de los archivos:

Ejemplo

FROM "C:\Auditoría del punto de venta\Datos\Archivos maestros de transacciones\Transacciones_FY*.csv"
FROM "Datos\Archivos maestros de transacciones\Transacciones_FY*.csv"

Carpeta que contiene los archivos de datos de origen

En lugar de especificar nombres de archivo, puede especificar simplemente el nombre de la carpeta donde se encuentran los archivos de datos de origen. Se importan todos los archivos delimitados admitidos que se encuentran en la carpeta (*.csv, *.dat, *.del, *.txt).

Para especificar una carpeta de datos de origen, use una ruta de archivo absoluta o una ruta de archivo relativa a la carpeta que contiene el proyecto de Analytics.

Ejemplo

FROM "C:\Auditoría del punto de venta\Datos\Archivos maestros de transacciones"
FROM "Datos\Archivos maestros de transacciones"
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.

Nota

Si no especifica un código, Analytics no Unicode utiliza automáticamente 0 y Analytics Unicode utiliza automáticamente 2 .

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

La línea en la que comienzan los datos.

Por ejemplo, si las primeras cuatro líneas de datos contienen información de encabezado que usted no desea, especifique 5 en número_de_línea.

Nota

Lo ideal es que la línea de inicio sea la misma en todos los archivos delimitados que usted importa con una única ejecución de IMPORT MULTIDELIMITED.

Si las líneas de inicio son diferentes, consulte Es necesario que los archivo tengan la misma estructura.

KEEPTITLE

opcional

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.

Nota

Los nombres de campo deben estar en el mismo número de línea en todos los archivos delimitados que importe con una única ejecución de IMPORT MULTIDELIMITED.

Si los nombres de campo están en diferentes números de línea, consulte Es necesario que los archivo tengan la misma estructura.

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.

Los siguientes ejemplos dan por sentado que usted cuenta con datos de transacciones mensuales almacenados en doce archivos delimitados:

  • Transacciones_ene.csv a Transacciones_dic.csv

Nota

Se crea una tabla de Analytics independiente para cada archivo delimitado que importa.

Importar todos los archivos delimitados

Usted desea importar los 12 archivos delimitados. Utiliza el símbolo comodín (*) en el lugar en el que aparece el mes en el nombre de cada archivo.

Analytics intenta asignar el tipo de dato adecuado a cada campo.

IMPORT MULTIDELIMITED FROM "Transacciones_*.csv" 0 SEPARATOR ";" QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Importar todos los archivos delimitados como datos de caracteres

Este ejemplo es igual al anterior, excepto que Analytics asigna automáticamente el tipo de datos Carácter a todos los campos importados.

IMPORT MULTIDELIMITED FROM "Transacciones_*.csv" 0 SEPARATOR ";" QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE ALLCHAR

Importar todos los archivos delimitados desde una carpeta específica

Desea importar todos los archivos delimitados de la carpeta C:\Auditoría del punto de venta\Datos\Archivos maestros de transacciones.

IMPORT MULTIDELIMITED FROM "C:\Auditoría del punto de venta\Datos\Archivos maestros de transacciones" 0 SEPARATOR ";" QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Importar todos los archivos delimitados de una carpeta específica y guardar las tablas de Analytics en otra carpeta

Este ejemplo es igual que el anterior, pero en lugar de guardar las tablas de Analytics en la carpeta raíz del proyecto, desea guardarlas en la carpeta C:\Auditoría del punto de venta\Datos\Datos de trabajo de transacciones.

IMPORT MULTIDELIMITED TO "C:\Auditoría del punto de venta\Datos\Datos de trabajo de transacciones" FROM "C:\Auditoría del punto de venta\Datos\Archivos maestros de transacciones" 0 SEPARATOR ";" QUALIFIER '"' CONSECUTIVE STARTLINE 1 KEEPTITLE

Es necesario que los archivo tengan la misma estructura

Para importar un grupo de archivos delimitados correctamente usando IMPORT MULTIDELIMITED, la estructura de todos los archivos del grupo debe coincidir.

Puede importar archivos delimitados que no tienen la misma estructura y luego realizar la limpieza y estandarización de los datos en Analytics. Sin embargo, este enfoque puede ser muy trabajoso. En muchos casos, es más sencillo hacer coincidir los archivos delimitados antes de la importación.

Para importar correctamente varios archivos delimitados, es necesario que los siguientes elementos sean iguales en todos los archivos:

Elemento Palabra clave de ACLScript Problema Solución

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

código numérico

(solamente en la edición Unicode de Analytics)

Los archivos delimitados de origen utilizan diferentes codificaciones de caracteres. Por ejemplo, algunos archivos tienen codificación ASCII y otros archivos tienen codificación Unicode.

Agrupe los archivos de origen por tipo de codificación e importe cada grupo por separado.
Carácter delimitador SEPARATOR Los archivos delimitados de origen usan diferentes caracteres separadores (delimitadores) entre los campos.

Realice una de las siguientes acciones:

  • Estandarice el carácter separador en los archivos de origen antes de importarlos.
  • Agrupe los archivos de origen por carácter separador e importe cada grupo por separado.
Carácter calificador de texto QUALIFIER Los archivos delimitados de origen usan diferentes caracteres calificadores de texto para encerrar e identificar los valores de los campos.

Realice una de las siguientes acciones:

  • Estandarice el carácter calificador en los archivos de origen antes de importarlos.
  • Agrupe los archivos de origen por carácter calificador e importe cada grupo por separado.
Línea de inicio de los datos STARTLINE

Los archivos delimitados de origen tienen diferentes líneas de inicio de los datos.

Realice una de las siguientes acciones:

  • Estandarice la línea de inicio en los archivos de origen antes de importarlos.
  • Agrupe los archivos de origen que tienen la misma línea de inicio e importe cada grupo por separado.
  • Haga que número_de_línea sea igual a la menor línea de inicio en todos los archivos. Una vez que se hayan importado los archivos a las tablas de Analytics, puede usar el Comando EXTRACT para extraer únicamente los registros de las tablas con información de encabezado no deseada.
Nombres de campo KEEPTITLE Los archivos delimitados de origen tienen los nombres de campos en diferentes números de línea.

Realice una de las siguientes acciones:

  • Estandarice el número de línea con los nombres de campos en los archivos de origen antes de importarlos.
  • Agrupe los archivos de origen que tienen los nombres de campo en la misma línea e importe cada grupo por separado.
Nombres de campo KEEPTITLE Algunos archivos delimitados de origen tienen nombres de campos y otros no.

Realice una de las siguientes acciones:

  • Antes de importar los archivos, agregue los nombres de campos a los archivos de origen que los necesiten.
  • Agrupe los archivos de origen que tienen nombres de campo y los que no los tienen e importe cada grupo por separado.
  • Omita KEEPTITLE para importar todos los archivos que utilizan nombres de campos genéricos. Una vez que se hayan importado los archivos a las tablas de Analytics, puede usar el Comando EXTRACT para extraer únicamente los datos que desee de las tablas.

Comandos IMPORT DELIMITED múltiples

En realidad, el comando IMPORT MULTIDELIMITED ejecuta varios comandos IMPORT DELIMITED individuales; uno para cada archivo importado. Si hace doble clic en la entrada IMPORT MULTIDELIMITED del log, se muestran los comandos IMPORT DELIMITED individuales en el área de visualización.

Combinación de varios archivos delimitados después de importarlos

Después de importar varios archivos delimitados a tablas de Analytics individuales, es posible que quiera combinarlos en una sola tabla de Analytics. Por ejemplo, podría combinar los datos de doce tablas mensuales en una única tabla anual que contenga todos los datos.

Si desea obtener información sobre la combinación de varias tablas de Analytics, consulte Comando APPEND.