Comando EXPORT

Exporta datos desde Analytics al formato de archivo especificado o a Resultados en HighBond.

Sintaxis

EXPORT {<FIELDS> nombre_campo <AS nombre_exportación> <...n> |<FIELDS> ALL} <UNICODE> tipo_exportación <SCHEMA> PASSWORD núm TO {nombre_archivo|aclgrc_id} <OVERWRITE> <IF prueba> <WHILE prueba> <{FIRST rango|NEXT rango}> <APPEND> <KEEPTITLE> <SEPARATOR carácter> <QUALIFIER carácter> <WORKSHEET nombre_hoja_trabajo> <DISPLAYNAME>

Parámetros

Nombre

Descripción

FIELDS nombre_campo as nombre_exportación <...n> | FIELDS ALL

Los campos que se deben exportar.

nombre_campo exporte el o los campos especificados
Separe los nombres de campo con espacios.
Puede incluir un nombre diferente para el campo en el archivo de exportación utilizando AS nombre_exportación. Encierre nombre_exportación entre comillas.
Si está exportando a ACLGRC (HighBond), es posible combinar AS con el parámetro DISPLAYNAME. Si desea obtener más información, consulte Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de HighBond.
ALL exporte todos los campos de la tabla

UNICODE

opcional

Disponible únicamente en la edición Unicode de Analytics. Se aplica solo a archivos de texto (ASCII), texto delimitado (DELIMITED) y XML y a la salida del Portapapeles de Windows.

Exporta los datos de Analytics con la codificación de caracteres Unicode UTF-16 LE aplicada.

Especifique UNICODE si los datos que está exportando contienen caracteres no admitidos por ASCII (ANSI) extendido
No especifique UNICODE si todos los caracteres de los datos que está exportando son admitidos por ASCII (ANSI) extendido
Los datos exportados están codificados como ASCII (ANSI) extendido.
Nota
Los caracteres no admitidos se omiten del archivo exportado.

Si desea obtener más información, consulte Productos Unicode de ACL.

tipo_exportación

El destino o el formato de archivo de salida con una de las siguientes opciones:

ACCESS archivo de base de datos Microsoft Access (.mdb)
De forma predeterminada, los datos se exportan como Unicode.
ACLGRC Resultados en HighBond
ASCII archivo de texto sin formato ASCII (.txt).
CLIPBOARD portapapeles de Windows
DBASE archivo compatible con dBASE (.dbf)
DELIMITED archivo de texto delimitado (.del).
EXCEL archivo de Microsoft Excel (.xls) compatible con Excel 1997 a 2003
JSON archivo JSON (.json)
LOTUS archivo de Lotus 123
WDPF6 archivo de Wordperfect 6
WORD archivo de MS Word (.doc)
WP archivo de Wordperfect
XLS21 archivo de Microsoft Excel versión 2.1
XLSX archivo de Microsoft Excel .xlsx
De forma predeterminada, los datos se exportan como Unicode.
XML archivo XML (.xml)

SCHEMA

opcional

Se aplica solo a la salida en archivos XML.

Incluya el esquema XML en el archivo XML exportado. El esquema XML contiene metadatos que describen la estructura del archivo XML, incluido el tipo de datos de los campos.

Puede validar el archivo con el esquema una vez que el archivo se haya exportado.

PASSWORD núm

Nota

Se aplica únicamente a Resultados de HighBond.

La definición de contraseña que se debe usar.

No se utiliza PASSWORD núm para solicitar o especificar una contraseña real. La definición de contraseña hace referencia a una contraseña proporcionada o configurada previamente con el comando PASSWORD, el comando SET PASSWORD o la etiqueta de estudio analítico PASSWORD.

núm es el número de la definición de contraseña. Por ejemplo, si se proporcionaron o configuraron dos contraseñas previamente en un script, o al programar un estudio analítico, PASSWORD 2 especifica que se utiliza la contraseña #2.

Si desea obtener más información acerca de la especificación o configuración de contraseñas, consulte:

PASSWORD núm se debe colocar inmediatamente antes de TO o al final de la cadena de la sintaxis del comando. La contraseña es un token de acceso a HighBond. Si desea obtener más información, consulte Exportación a Resultados de HighBond.

Nota

El parámetro PASSWORD puede ser obligatorio o no, según el entorno en el que se ejecute el script:

Analytics (activación en línea)	No se necesita PASSWORD. Se utiliza automáticamente el token de acceso HighBond del usuario actual.
Analytics (activación sin conexión)	Se necesita PASSWORD.
Robots
Analytics Exchange
Ventana Aplicación de análisis

TO nombre_archivo | aclgrc_id

El destino de la exportación:

TO nombre_archivo exporta los datos a un archivo
Si es necesario, puede incluir una ruta de acceso absoluta o relativa al archivo, pero la carpeta de Windows ya debe existir. Debe especificar el valor nombre_archivo como una cadena entre comillas.
TO aclgrc_id exporta datos a Resultados de HighBond
El valor aclgrc_iddebe incluir el número de ID de la prueba de control y, si está realizando la exportación a un centro de datos ubicado fuera de América del Norte, el código del centro de datos. El valor id_aclgrc debe estar entre comillas.
El número de identificación de la prueba de control y el código del centro de datos deben estar separados por la arroba (@). Por ejemplo, TO "99@eu".
Si no conoce el número de ID de la prueba de control, utilice la interfaz de usuario de Analytics para comenzar una exportación a Resultados. Cancele la exportación una vez que haya identificado el número de ID de la prueba de control. Si desea obtener más información, consulte Exportar excepciones a ACL GRC.
El código del centro de datos especifica a qué servidor regional de HighBond va a exportar los datos:
- ap: Pacífico asiático
- au: Australia
- ca: Canadá
- eu: Europa
- us: Norteamérica
Puede utilizar únicamente los códigos de centros de datos autorizados para la instancia de HighBond de su organización. El centro de datos de Norteamérica es el valor predeterminado, por lo que especificar "@us" es opcional.

OVERWRITE

opcional

Se aplica únicamente a la exportación a Resultados de HighBond.

Cualquier dato existente en la prueba de control objetivo (tabla) se sobrescribe con los datos exportados. Debe tener el rol de Gerente profesional en la Colección para sobrescribir los datos.

Si omite OVERWRITE y los datos ya existen en la prueba de control de destino (tabla), los datos exportados se anexan a los datos existentes. Si desea obtener más información sobre la anexión en Resultados, consulte "Observaciones", más adelante.

Cualquier interpretación relacionada con la prueba de control de destino (tabla) se actualiza de manera dinámica para reflejar los datos importados, ya sea que sobrescriba o anexe.

IF prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta únicamente en los registros que cumplen la condición.

Nota

El parámetro IF se evalúa únicamente con los registros que quedan en la tabla después de aplicar los parámetros de alcance (WHILE, FIRST, NEXT).

WHILE prueba

opcional

Una expresión condicional que debe ser verdadera para procesar cada registro. El comando se ejecuta hasta que la condición se evalúa como falsa o hasta que se llega al final de la tabla.

Nota

Si usa WHILE junto con FIRST o NEXT, el procesamiento de registros se detiene al llegar a un límite.

FIRST rango | NEXT rango

opcional

La cantidad de registros que se procesarán:

FIRST comienza a procesar desde el primer registro hasta que se llega al número de registros especificado
NEXT comienza a procesar desde el registro seleccionado actualmente hasta que se llega al número de registros especificado

Utilice intervalo para especificar la cantidad de registros que se deben procesar.

Si omite FIRST y NEXT, se procesan todos los registros de forma predeterminada.

APPEND

opcional

Se aplica únicamente a archivos de texto (ASCII) y texto delimitado (DELIMITED).

Anexa la salida del comando al final de un archivo existente en lugar de sobrescribir el archivo.

Nota

Debe asegurarse de que la estructura de la salida del comando y del archivo existente sean idénticas:

los mismos campos
el mismo orden de campos
los campos coincidentes son de la misma longitud
los campos coincidentes tienen el mismo tipo de datos

Analytics anexa la salida a un archivo existente sin importar cuál sea su estructura. Si la estructura de la salida y la del archivo existente no coinciden, es posible que los datos que se obtengan estén incompletos, mezclados o sean imprecisos.

KEEPTITLE

opcional

Se aplica únicamente a archivos de texto (ASCII) y texto delimitado (DELIMITED).

Incluya los nombres de campo de Analytics con los datos exportados. Si los omite, no aparecerá ningún nombre de campo en el archivo de salida.

SEPARATOR carácter

opcional

Solo se aplica a archivos de texto delimitado (DELIMITED).

El carácter que se debe utilizar como separador entre campos. Debe especificar el carácter como una cadena entre comillas.

Como opción predeterminada, Analytics utiliza una coma.

QUALIFIER carácter

opcional

Solo se aplica a archivos de texto delimitado (DELIMITED).

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

Como opción predeterminada, Analytics utiliza comillas dobles.

WORKSHEET nombre_hoja_trabajo

opcional

Solo se aplica a archivos de Microsoft Excel (.xlsx).

El nombre de la hoja de cálculo de Excel que se creó en el archivo Excel nuevo o existente.

Por valor predeterminado, Analytics utiliza el nombre de la tabla de Analytics que está exportando como el nombre de la hoja de cálculo.

El nombre_hoja_trabajo solo puede tener caracteres alfanuméricos o un carácter de guión bajo ( _ ). El nombre no puede contener caracteres especiales, espacios ni comenzar con un número. Puede encerrar el valor entre comillas.

Si desea obtener información detallada acerca de la sobrescritura de los libros y las hojas de cálculo de Excel al exportar, consulte El parámetro WORKSHEET y la sobrescritura.

DISPLAYNAME

opcional

Se aplica únicamente a ACLGRC (HighBond).

Exporta los nombres de campo como nombres de campo y nombres visibles para que los nombres visibles aparezcan en los encabezados de las columnas en Resultados sin afectar el nombre del campo real.

Es posible combinar DISPLAYNAME con AS. Si desea obtener más información, consulte Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de HighBond.

Ejemplos

Exportar datos a un archivo de Excel .xlsx

Usted exporta campos específicos desde la tabla Proveedor a un archivo de Excel .xlsx:

OPEN Proveedor
EXPORT FIELDS Núm_Proveedor Nombre_Proveedor Ciudad_Proveedor XLSX TO "ExportacionesProveedor"

Exportar datos a un archivo Excel .xlsx y especificar un nombre de hoja de cálculo

Usted exporta campos específicos desde la tabla Proveedor a un hoja de cálculo denominada Proveedores_US de un archivo de Excel .xlsx:

OPEN Proveedor
EXPORT FIELDS Núm_Proveedor Nombre_Proveedor Ciudad_Proveedor XLSX TO "ExportacionesProveedor" WORKSHEET Proveedores_US

Exporte todos los campos a un archivo delimitado

Usted exporta todos los campos desde la tabla Proveedor a un archivo delimitado:

OPEN Proveedor
EXPORT FIELDS ALL DELIMITED TO "ExportacionesProveedor"

Exporte los datos a varios archivos delimitados usando GROUP

Usted exporta campos específicos desde la tabla Proveedor a dos archivos delimitados:

un archivo para los nombres de proveedores de la "A" a la "M"
un archivo para los nombres de proveedores de la "N" a la "Z"

Con el comando GROUP, usted prueba el nombre de proveedor de cada registro con una condición IF:

GROUP
  EXPORT FIELDS Núm_Proveedor Nombre_Proveedor DELIMITED TO "AaM" IF BETWEEN(UPPER(VENDOR_NAME); "A"; "M")
  EXPORT FIELDS Núm_Proveedor Nombre_Proveedor DELIMITED TO "NaZ" IF BETWEEN(UPPER(VENDOR_NAME); "N"; "Z")
END

Exportar datos a Resultados de HighBond

Usted exporta campos específicos desde la tabla Excepciones_AR a Resultados de HighBond. Sobrescribe los datos existentes en la prueba de control de destino (tabla):

OPEN Excepciones_AR
EXPORT FIELDS Tipo Importe Ref Sin Vencimiento ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE

Observaciones

Nota

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

Uso de EXPORT con el comando GROUP

Para la mayoría de los formatos de exportación, puede exportar datos a varios archivos simultáneamente utilizando el comando GROUP.

Sólo se puede crear un archivo a la vez cuando se exportan datos a Microsoft Excel y Microsoft Access.

Exportación a Excel

Al exportar datos a un archivo de Excel, se aplican los siguientes límites:

Número de registros	Excel 2007 y versiones posteriores (*.xlsx) un máximo de 1,048,576 registros Excel 97 y 2003 un máximo de 65,536 registros Las tablas de Analytics que superan estos máximos se exportan con éxito, pero los registros sobrantes se ignoran y no se exportan.
Longitud de los campos	sin límite específico de longitud de los campos las longitudes de campos combinadas no pueden exceder el límite de registros general de 32 KB (32,765 caracteres en Analytics no Unicode, 16,382 caracteres en Analytics Unicode) para Excel 2.1, un máximo de 247 caracteres
Nombres de los campos	un máximo de 64 caracteres para Excel 2.1, un máximo de 248 caracteres

Número de registros

Excel 2007 y versiones posteriores (*.xlsx) un máximo de 1,048,576 registros
Excel 97 y 2003 un máximo de 65,536 registros

Las tablas de Analytics que superan estos máximos se exportan con éxito, pero los registros sobrantes se ignoran y no se exportan.

Longitud de los campos

sin límite específico de longitud de los campos
las longitudes de campos combinadas no pueden exceder el límite de registros general de 32 KB
(32,765 caracteres en Analytics no Unicode, 16,382 caracteres en Analytics Unicode)
para Excel 2.1, un máximo de 247 caracteres

Nombres de los campos

un máximo de 64 caracteres
para Excel 2.1, un máximo de 248 caracteres

El parámetro WORKSHEET y la sobrescritura

A continuación, se explica el resultado de usar o no usar el parámetro WORKSHEET al exportar desde una tabla de Analytics a una tabla de Excel:

Coincidencia	Descripción	Con el uso del parámetro WORKSHEET	Sin el uso del parámetro WORKSHEET
No hay coincidencias en el nombre de archivo de Excel	El valor TO nombre_archivo no coincide con ningún nombre de archivo de Excel existente	Se crea un nuevo archivo de Excel con una hoja de cálculo con el nombre especificado	Se crea un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada
Hay coincidencia en el nombre de archivo de Excel No hay coincidencias en el nombre de la hoja de cálculo	El valor TO nombre_archivo y un nombre de archivo de Excel existente son idénticos WORKSHEET nombre_hoja_trabajo no coincide con el nombre de ninguna hoja de cálculo del archivo de Excel	Se agrega una hoja de cálculo con el nombre especificado al archivo de Excel existente	El archivo de Excel existente se sobrescribe con un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada
Hay coincidencia en el nombre de archivo de Excel y en el nombre de la hoja de cálculo	El valor TO nombre_archivo y un nombre de archivo de Excel existente son idénticos WORKSHEET nombre_hoja_trabajo coincide con el nombre de una hoja de cálculo del archivo de Excel	Si la hoja de cálculo existente fue originalmente creada desde Analytics, se sobrescribe con una hoja de cálculo con el nombre especificado. Si la hoja de cálculo existente fue creada originalmente en Excel, aparece un mensaje de error y se cancela la operación de exportación.	El archivo de Excel existente se sobrescribe con un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada

Coincidencia

Descripción

Con el uso del parámetro WORKSHEET

Sin el uso del parámetro WORKSHEET

No hay coincidencias en el nombre de archivo de Excel

El valor TO nombre_archivo no coincide con ningún nombre de archivo de Excel existente

Se crea un nuevo archivo de Excel con una hoja de cálculo con el nombre especificado

Se crea un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada

Hay coincidencia en el nombre de archivo de Excel

No hay coincidencias en el nombre de la hoja de cálculo

El valor TO nombre_archivo y un nombre de archivo de Excel existente son idénticos
WORKSHEET nombre_hoja_trabajo no coincide con el nombre de ninguna hoja de cálculo del archivo de Excel

Se agrega una hoja de cálculo con el nombre especificado al archivo de Excel existente

El archivo de Excel existente se sobrescribe con un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada

Hay coincidencia en el nombre de archivo de Excel y en el nombre de la hoja de cálculo

El valor TO nombre_archivo y un nombre de archivo de Excel existente son idénticos
WORKSHEET nombre_hoja_trabajo coincide con el nombre de una hoja de cálculo del archivo de Excel

Si la hoja de cálculo existente fue originalmente creada desde Analytics, se sobrescribe con una hoja de cálculo con el nombre especificado.

Si la hoja de cálculo existente fue creada originalmente en Excel, aparece un mensaje de error y se cancela la operación de exportación.

El archivo de Excel existente se sobrescribe con un nuevo archivo de Excel, con una hoja de cálculo que utiliza el nombre de la tabla de Analytics exportada

Exportación a Resultados de HighBond

La tabla abajo contiene información adicional acerca de la exportación a una prueba de control en Resultados.

Elemento	Detalles
Permisos necesarios	La capacidad de exportar resultados a una prueba de control en Resultados requiere una asignación específica de roles de HighBond o privilegios de administrador: Los usuarios con el rol de Usuario profesional o Gerente profesional para una colección de Resultados pueden exportar resultados a cualquier prueba de control de la colección. Nota Únicamente los usuarios con el rol de Gerente profesional pueden exportar y sobrescribir los datos existentes en una prueba de control. Los administradores del sistema de HighBond y los administradores de Resultados obtienen automáticamente el rol de Gerente profesional sobre todas las colecciones de la organización de HighBond o las organizaciones que administran.
Límites de la exportación	Los siguientes límites se aplican cuando se exporta a una prueba de control: Un máximo de 100.000 registros por exportación Un máximo de 100.000 registros por prueba de control. Un máximo de 500 campos por registro Un máximo de 256 caracteres por campo Puede exportar la misma prueba de control varias veces, pero no puede superar los límites generales.
Anexar archivos	Sin importar cuál sea su orden en una tabla de Analytics, los campos exportados se anexan a los campos existentes de una prueba de control si tienen nombres de campo físicos coincidentes. En Analytics, el nombre de campo físico es el nombre en el formato de la tabla. Los campos exportados que no coinciden con el nombre de ningún campo existente se agregan como columnas adicionales a la tabla en Resultados. No se consideran los nombres visibles de los campos en Analytics ni en Resultados. Sin embargo, si utiliza el parámetro opcional AS nombre_exportación y no utiliza DISPLAYNAME, el valor nombre_exportación se utiliza como el nombre del campo físico . Al anexar datos a los campos de cuestionario, el nombre visible de la columna en Resultados continúa siendo el nombre que se especificó en la configuración del cuestionario. Nota Si está haciendo un proceso de ida y vuelta con los datos entre Resultados y Analytics, y los datos quedan mal alineados en Resultados, probablemente haya establecido una correspondencia incorrecta entre los nombres de los campos. Si desea obtener más información, consulte Consideraciones de los nombres de campos al importar y exportar datos de Resultados.
Creación de una definición de contraseña y especificación de un valor de contraseña	Comando PASSWORD Si utiliza el comando PASSWORD para crear la definición de contraseña numerada para conectarse a HighBond, no se especifica ningún valor de contraseña, por lo que aparece una solicitud de contraseña cuando el script intenta conectarse. Si desea obtener más información, consulte Comando PASSWORD. Comando SET PASSWORD Si utiliza el comando SET PASSWORD para crear la definición de contraseña numerada para conectarse a HighBond, se especifica un valor de contraseña, por lo que no aparece una solicitud de contraseña, lo cual es adecuado para scripts diseñados para ejecutarse sin supervisión del usuario. Si desea obtener más información, consulte Comando SET PASSWORD. Token de acceso de HighBond Independientemente del método que utilice para crear la definición de la contraseña, el valor de la contraseña requerida es un token de acceso a HighBond: Método PASSWORD: los usuarios pueden obtener un token de acceso seleccionando Herramientas Token de acceso a HighBond e iniciando sesión en HighBond. Se devuelve un token de acceso, que los usuarios pueden copiar y pegar en la solicitud de contraseña. Método SET PASSWORD: Para insertar un token de acceso en la sintaxis del comando SET PASSWORD en un script de Analytics, haga clic con el botón derecho del ratón en el Editor de scripts, seleccione Insertar > Token de HighBond e inicie sesión en HighBond. Se inserta un token de acceso en el script en la posición del cursor. ¡Precaución! El token de acceso devuelto concuerda con la cuenta utilizada para iniciar sesión en HighBond. Como escritor de scripts puede no ser apropiado que utilice su propio token de acceso si está escribiendo un script que será usado por otras personas.

Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de HighBond

La siguiente matriz muestra de qué manera interactúa el parámetro DISPLAYNAME con AS al exportar nombres de campos desde Analytics a Resultados.

	Sin AS	Con AS
Sin DISPLAYNAME	El nombre del campo y el nombre visible en Resultados son el nombre del campo de Analytics.	El nombre del campo y el nombre visible en Resultados son el nombre visible del parámetro AS.
Con DISPLAYNAME	El nombre del campo en Resultados es el nombre del campo de Analytics. El nombre visible en Resultados es el nombre visible de Analytics.	El nombre del campo en Resultados es el nombre del campo de Analytics. El nombre visible en Resultados es el nombre visible del parámetro AS.

[ Volver al inicio ]