Comando EXPORT

Exporta datos desde Analytics al formato de archivo especificado o a Resultados de 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 Resultados de HighBond (ACLGRC), 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 Galvanize.

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 de 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), o archivo de valores separados por comas (.csv)
  • 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

Se aplica únicamente a Resultados de HighBond (ACLGRC).

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.

El valor de la contraseña obligatoria 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.

    Nota

    Para exportar un archivo de valores separados por comas (*.csv), debe especificar la extensión de archivo .csv como parte del nombre de archivo. Por ejemplo: proveedores.csv

  • 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 Exportación de excepciones a Resultados de HighBond.

    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 Resultados de HighBond (ACLGRC).

  • OVERWRITE especificado Los datos exportados sobrescriben los datos existentes en la prueba de control objetivo (tabla). Debe tener el rol de Gerente profesional en la Colección para sobrescribir los datos.
  • OVERWRITE omitido Los datos exportados se anexan a los datos existentes en la prueba de control objetivo (tabla). Si desea obtener más información, consulte Exportación a Resultados de HighBond.

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 archivos de texto delimitado y valores separados por comas (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

Se aplica únicamente a archivos de texto delimitado y valores separados por comas (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. Si está exportando un archivo de valores separados por comas, especifique únicamente una coma como carácter.

QUALIFIER carácter

opcional

Se aplica únicamente a archivos de texto delimitado y valores separados por comas (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 Resultados de HighBond (ACLGRC).

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 todos los campos a un archivo de valores separados por comas

Usted exporta todos los campos desde la tabla Proveedor a un archivo de valores separados por comas:

OPEN Proveedor
EXPORT FIELDS ALL DELIMITED TO "ExportacionesProveedor.csv"

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

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

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

(OVERWRITE sin especificar)

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.

Anexar funciona de manera diferente si la prueba de control objetivo tiene un campo clave primario especificado. Si desea obtener más información, consulte Exportación de excepciones a Resultados de HighBond.

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.

Adquirir un 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 que los usuarios pueden generar en Launchpad.

¡Precaución!

El token de acceso generado concuerda con la cuenta utilizada para iniciar sesión en Launchpad. Como escritor de scripts, puede no ser apropiado especificar su propio token de acceso si el script que será usado por otras personas.

  1. Realice una de las siguientes acciones:
    • Desde el menú principal de Analytics, seleccione Herramientas > Token de acceso HighBond.
    • En el Editor de scripts, haga clic con el botón derecho del ratón y seleccione Insertar > Token de HighBond.

    Se abre la página Administrar tokens API en el navegador. Es posible que primero deba iniciar sesión en Launchpad.

  2. Realice una de las siguientes acciones:
    • Utilizar un token existente En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar y escriba la contraseña de su cuenta de HighBond. Se muestra el token sin enmascarar.

      Consejo

      Utilice un token existente a menos que tenga un motivo para crear uno nuevo. Si el token existente no funciona, cree uno nuevo.

      El uso de un token existente reduce la cantidad de tokens que necesita administrar.

    • Crear un nuevo token Haga clic en Crear token > Analytics y escriba la contraseña de su cuenta de HighBond.

      Se crea un nuevo token de Analytics.

      Nota

      Si usted es administrador del sistema de Launchpad, también puede crear un token de la API. Debe reservar los tokens de API para la finalidad adecuada, que es contar con acceso de programación a la plataforma de HighBond.

  3. Haga clic en Copiarpara copiar el token.

    Consejo

    No cierre el cuadro de diálogo que contiene el token hasta que haya pegado correctamente el token en el script.

  4. En Analytics, complete una de las siguientes acciones:
    • pegue el token en la solicitud de la contraseña
    • pegue el token en el lugar adecuado del comando SET PASSWORD de un script
  5. En Launchpad, cierre el cuadro de diálogo que contiene el token.

    Si creó un nuevo token, se agrega una versión parcialmente enmascarada del token en la parte superior de su lista de tokens.

    Si desea más información, consulte Creación y administración de tokens de acceso.

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.