Comando EXPORT

Información de Concepto

Exportar datos

Exportación de excepciones a la aplicación Resultados en Diligent One

Exportación de datos a la aplicación Robots en Diligent One

Exporta datos desde Analytics al formato de archivo especificado o a la aplicación Resultados o la aplicación Resultados en Robots.

Nota

Debe tener instalado Microsoft 365 Access Runtime (32 bits) para que el comando EXPORTAR funcione con archivos de Excel (*.xls) y archivos de Microsoft Access (*.mdb). Para obtener más información, consulte Trabajar con archivos antiguos de Excel (*.xls) o Access (*.mdb).

Sintaxis

EXPORT {<FIELDS> nombre_campo <AS nombre_exportación> <...n>|<FIELDS> ALL <EXCLUDE nombre_campo <...n>>} <UNICODE> tipo_exportación <SCHEMA> PASSWORD núm TO {nombre_archivo|id_aclgrc|url_api_highbond} <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.

  • FIELDS nombre_campoExporta el o los campos especificados.

    Separe los nombres de campo con espacios. Los campos se exportan en el orden en el que usted los indica.

    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 Diligent One Resultados (ACLGRC), es posible combinar AS con el parámetro DISPLAYNAME. Para obtener más información, consulte Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de Diligent One.

  • FIELDS ALLExporte todos los campos de la tabla.

    Los campos se exportan en el orden en el que aparecen en el formato de tabla.
EXCLUDE nombre_campo

opcional

Solo tiene validez cuando se exporta utilizando FIELDS ALL.

El o los campos que se deben excluir del comando. EXCLUDE le permite ajustar la palabra clave de ALL, excluyendo campos especificados.

EXCLUDE debe estar inmediatamente después de FIELDS ALL o de la ocurrencia final de la palabra clave de ALL si incluye campos de una o más tablas relacionadas. Por ejemplo:

FIELDS ALL EXCLUDE campo_1 campo_2
FIELDS ALL nombre_tabla_relacionada.ALL EXCLUDE campo_1 campo_2

UNICODE

opcional

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

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

  • Especifique UNICODESi los datos que está exportando contienen caracteres no admitidos por ASCII (ANSI) extendido.
  • No especifique UNICODESi todos los caracteres de los datos que está exportando son admitidos por ASCII (ANSI) extendido.

    Los datos exportados se codifican como ASCII extendido (ANSI).

    Nota

    Los caracteres no admitidos se omiten del archivo exportado.

Para obtener más información, consulte Productos Unicode de Diligent.
tipo_exportación

El formato o el destino del archivo de salida.

Especifique una de las siguientes opciones:

  • ACCESS: Definición de los archivos de bases de datos Microsoft Access (*.mdb)

    Como opción predeterminada, los datos se exportan como Unicode.

  • ACLGRC: Diligent One Resultados
  • ASCII: 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
  • HBDATA: Archivo comprimido de valores separados por comas (*.csv.gz) en un Robot HighBond o en un Robot de flujo de trabajo de la aplicación Robots de Diligent One.
  • 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 (*.xls)
  • XLSX: Archivo de Microsoft Excel (*.xlsx)

    Como opción predeterminada, los datos se exportan como Unicode.

  • XML: Archivo XML (*.xml)

SCHEMA

opcional

Se aplica solo a la salida en archivos XML. (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

opcional

Solo se aplica a las aplicaciones de Diligent One. (ACLGRC, HBDATA)

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 script de estudio analítico, PASSWORD 2 especifica que se utiliza la contraseña número 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 Token de acceso de Diligent One. Para obtener más información, consulte Creación de una definición de contraseña y especificación de un valor de contraseña.

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

Entorno en el que se ejecuta el script Requisito PASSWORD núm
Analytics

(activación en línea)

El parámetro PASSWORD núm no es obligatorio.

Se utiliza automáticamente el token de acceso Token de acceso de Diligent One del usuario actual, que se almacena en su registro de Windows.
Analytics

(activación sin conexión)

El parámetro PASSWORD núm es obligatorio.
Robots
TO nombre_archivo

En el caso de exportaciones a un archivo, el nombre de ese archivo.

Si es necesario, puede incluir una ruta de archivo absoluta o relativa, pero ya debe existir la carpeta de Windows. Debe especificar el valor nombre_archivo como una cadena entre comillas.

Nota

Para realizar una exportación a un archivo de valores separados por comas (*.csv), debe especificar la extensión de archivo .csv como parte de nombre_archivo. Por ejemplo: vendors.csv

TO id_aclgrc

En el caso de exportaciones a la aplicación Resultados de Diligent One, el destino en Resultados. (ACLGRC)

El valor id_aclgrc debe incluir el número de ID de la prueba de control de Resultados y, si está realizando la exportación a un centro de datos ubicado fuera de América del Norte (EE. UU.), 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. Para obtener más información, consulte Exportación de excepciones a la aplicación Resultados en Diligent One.

El código del centro de datos especifica a qué servidor regional de Diligent One va a exportar los datos:

  • af – África (Sudáfrica)
  • ap – Asia-Pacífico (Singapur)
  • au – Asia-Pacífico (Australia)
  • ca – Norteamérica (Canadá)
  • eu – Europa (Alemania)
  • jp – Asia-Pacífico (Tokio)
  • sa – América del Sur (Brasil)
  • us – Norteamérica (EE. UU.)

Puede utilizar únicamente los códigos de centros de datos autorizados para la instancia de Diligent One de su organización. El centro de datos de Norteamérica (EE. UU.) es el valor predeterminado, por lo que especificar @us es opcional.

TO url_api_highbond

En el caso de exportaciones a la aplicación Resultados de Diligent One, el destino en Resultados. (HBDATA)

Nota

No puede realizar una exportación a un robot ACL. Debe realizarla a un robot Robot HighBond o a un robot de flujo de trabajo.

El valor url_api_highbond representa la URL de solicitud de API de API de HighBond para el robot de destino. En el ejemplo siguiente se exporta un archivo *.csv.gz a su destino:

  • el robot con el número de ID 52053

  • en la organización de Diligent One con número de ID 1000236

  • en el centro de datos de América del Norte (EE. UU) de

TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development"

Use el parámetro de cadena de consulta env para especificar si el archivo se exportará al modo de desarrollo o al modo de producción del robot:

Modo desarrollo

(predeterminado)

  • ?env=development

o

  • ninguna cadena de consulta especificada
Modo de producción

  • ?env=production

OVERWRITE

opcional

Solo se aplica a las aplicaciones de Diligent One. (ACLGRC, HBDATA)

  • OVERWRITE especificadoLos datos exportados sobrescriben los datos existentes en la prueba de control objetivo (tabla) o el robot. Debe tener el rol de Gerente profesional en la Colección para sobrescribir los datos.

  • OVERWRITE omitidoLos datos exportados se anexan a los datos existentes en la prueba de control objetivo (tabla). Para obtener más información, consulte Exportación a Resultados de Diligent One.

    La anexión no está disponible para los archivos *.csv.gz en Robots.

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:

  • FIRSTComienza a procesar desde el primer registro hasta que se llega al número de registros especificado.
  • NEXTComienza 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 y texto delimitado. (ASCII, 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, archivos de texto delimitado y archivos de valores separados por comas. (ASCII, 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 archivos de 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 archivos de 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. (XLSX)

El nombre de la hoja de cálculo de Excel que se creó en el archivo Excel nuevo o existente. Especifique un máximo de 31 caracteres.

Por valor predeterminado, Analytics utiliza el nombre de la tabla de Analytics que está exportando como el nombre de la hoja de cálculo. Los nombres con más de 31 caracteres están truncados.

El nombre_hoja_trabajo solo puede tener caracteres alfanuméricos o un carácter de guion 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

Aplicable solo a Resultados de Diligent One. (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. Para obtener más información, consulte Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de Diligent One.

Ejemplos

Ejemplos de Excel

Ejemplos de archivos delimitados

Ejemplo de archivo de valores separados por comas (CSV)

Ejemplo de la aplicación Resultados

Ejemplos de la aplicación Robots

Ejemplos de Excel

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

Ejemplos de archivos delimitados

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"

Exportar un subconjunto de campos a un archivo delimitado

Tiene dos opciones al exportar un subconjunto de campos de una tabla a un archivo externo:

  • especificar los campos individuales que se deben exportar
  • especificar FIELDS ALL y especificar los campos que se deben excluir de la exportación

Consejo

Use el método que implique menos trabajo manual.

Los siguientes ejemplos hacen referencia a la tabla Proveedor, que tiene ocho campos:

  • número de proveedor
  • nombre de proveedor
  • calle del proveedor
  • ciudad del proveedor
  • estado del proveedor
  • Código postal del proveedor
  • última fecha activa
  • fecha de revisión

Especificar los campos que se deben exportar

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

OPEN Proveedor
EXPORT FIELDS Núm_proveedor Nombre_proveedor DELIMITED TO "Proveedores" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

Especificar FIELDS ALL y especificar los campos que se deben excluir

Usted exporta todos los campos, excepto los campos última fecha activa y fecha de revisión, desde la tabla Proveedor a un archivo delimitado:

OPEN Proveedor
EXPORT FIELDS ALL EXCLUDE Proveedor_última_activa Fecha_revisión_proveedor DELIMITED TO "Domicilios_proveedores" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

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:

GRUPO
  EXPORT FIELDS Núm_Proveedor Nombre_Proveedor DELIMITED TO "AtoM" IF BETWEEN(UPPER(VENDOR_NAME); "A"; "M")
  EXPORT FIELDS Núm_Proveedor Nombre_Proveedor DELIMITED TO "NtoZ" IF BETWEEN(UPPER(VENDOR_NAME); "N"; "Z")
END

Ejemplo de archivo de valores separados por comas (CSV)

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"

Ejemplo de la aplicación Resultados

Exportar datos a la aplicación Resultados en Diligent One

Especificar los campos que se deben exportar

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

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

Crear una definición de contraseña obligatoria para ejecutar el comando en Robots

Usted crea una definición de contraseña de dos partes con una etiqueta de estudio analítico PASSWORD y un parámetro PASSWORD coincidente en el comando EXPORT.

La etiqueta de estudio analítico //PASSWORD 1 crea un parámetro de entrada de contraseña en una tarea del robot. El parámetro PASSWORD 1 coincidente en el comando EXPORT hace referencia al valor de contraseña almacenado y cifrado en la tarea. La contraseña obligatoria es un token válido de acceso a Token de acceso de Diligent One. Para obtener más información, consulte Creación de una definición de contraseña y especificación de un valor de contraseña.

COMENTARIO
//ANALYTIC Exportar datos a Resultados
//PASSWORD 1 Token de acceso de Token de acceso de Diligent One:
//RESULT LOG
END

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

Ejemplos de la aplicación Robots

Exportar datos a la aplicación Robots en Diligent One

Nota

No puede realizar una exportación a un robot ACL. Debe realizarla a un robot Robot HighBond o a un robot de flujo de trabajo.

Si desea más información sobre cómo acceder a los datos después de exportarlos a Robots, consulte el método load_working_file().

Especificar los campos que se deben exportar

Se exportan campos específicos de la tabla Trans_Mayo a un archivo CSV comprimido (*.csv.gz) en Diligent One de Robots. Si ya existe un archivo con el mismo nombre en el robot 52053, en el modo desarrollo, ese archivo se sobrescribe:

OPEN Trans_Mayo
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Crear una definición de contraseña obligatoria para ejecutar el comando en Robots

Usted crea una definición de contraseña de dos partes con una etiqueta de estudio analítico PASSWORD y un parámetro PASSWORD coincidente en el comando EXPORT.

La etiqueta de estudio analítico //PASSWORD 1 crea un parámetro de entrada de contraseña en una tarea del robot. El parámetro PASSWORD 1 coincidente en el comando EXPORT hace referencia al valor de contraseña almacenado y cifrado en la tarea. La contraseña obligatoria es un token válido de acceso a Token de acceso de Diligent One. Para obtener más información, consulte Creación de una definición de contraseña y especificación de un valor de contraseña.

COMENTARIO
//ANALYTIC Exportar datos de Analytics a Robots
//PASSWORD 1 Token de acceso de Token de acceso de Diligent One:
//RESULT LOG
END

OPEN Trans_Mayo
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA PASSWORD 1 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Exportar todos los campos

Se exportan todos los campos de la tabla Trans_Mayo a un archivo CSV comprimido (*.csv.gz) en Diligent One de Robots:

OPEN Trans_Mayo
EXPORT FIELDS ALL HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Especificar FIELDS ALL y especificar los campos que se deben excluir

Se exportan todos los campos, excepto los campos de última fecha activa y fecha de revisión, desde la tabla Proveedor a un archivo CSV comprimido (*.csv.gz) en Diligent One de Robots:

OPEN Proveedor
EXPORT FIELDS ALL EXCLUDE Proveedor_última_activa Fecha_revisión_proveedor HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Observaciones

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.

Límite Detalles
Número de registros
  • Excel 2007 y versiones posterioresr (*.xlsx)un máximo de 1,048,576 registros por 16,384 campos (tamaño máximo de hoja de cálculo admitido por Excel)
  • Excel 97 y 2003un 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 campo combinadas no pueden exceder el límite de longitud de registro general de 32 KB

    (32.765 caracteres en no Unicode Analytics, 16.382 caracteres en Unicode Analytics)

  • 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
Longitud de los nombres de las hojas de cálculo
  • un máximo de 31 caracteres

En el caso de que utilice el nombre de una tabla de Analytics para la hoja de cálculo, el nombre se truncará al exportarla a Excel si supera los 31 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 Diligent One

La tabla de 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 Diligent One 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 Diligent One y los administradores de Resultados obtienen automáticamente el rol de Gerente profesional sobre todas las colecciones de la organización de Administradores del sistema o las organizaciones que administran.

Para obtener más información, consulte Permisos de la aplicación Resultados.

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 un campo existente se agregan como columnas adicionales a la tabla de Resultados.

No se consideran los nombres visibles de los campos en Analytics ni en Resultados. Sin embargo, si utiliza el parámetro opcional AS export_name y no utiliza DISPLAYNAME, el valor export_name 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. Para obtener más información, consulte Exportación de excepciones a la aplicación Resultados en Diligent One.

Nota

Si está haciendo un proceso de ida y vuelta con los datos entre Resultados y Resultados, y los datos quedan mal alineados en Resultados, probablemente haya establecido una correspondencia incorrecta entre los nombres de los campos.

Para obtener más información, consulte Consideraciones de los nombres de campos al importar y exportar datos de Resultados.

Se necesita una contraseña

Consulte Creación de una definición de contraseña y especificación de un valor de contraseña.

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

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 Resultados. 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 Resultados. El nombre visible en Resultados es el nombre visible de Resultados. El nombre del campo en Resultados es el nombre del campo de Resultados. El nombre visible en Resultados es el nombre visible del parámetro AS.

Permisos necesarios para exportar a Diligent One de Robots

La capacidad de cargar un archivo CSV comprimido (*.csv.gz) en la aplicación Robots requiere una asignación de rol de robot específica o privilegios administrativos:

  • Los usuarios con un rol de Editor o Propietario de un robot pueden cargar un archivo CSV comprimido en el robot. Los usuarios con un rol de Revisor no pueden cargar el archivo.

  • Los administradores de Administradores de Robots son automáticamente un colaborador para cada robot, con el rol de Propietario.

  • Un Administrador del sistema de Diligent One con una suscripción profesional es automáticamente un Administrador de Robots.

Para obtener más información, consulte Permisos de la aplicación Robots.

Creación de una definición de contraseña y especificación de un valor de contraseña

Cuando ejecuta un script en Robots que exporta datos a la aplicación Resultados, o cuando carga un archivo CSV comprimido (*.csv.gz) en la aplicación Robots, debe incluir una definición de contraseña con el comando EXPORT. El mismo requisito se aplica a la ejecución de scripts en Analytics cuando usa la activación sin conexión.

Independientemente del método que utilice para crear una definición de contraseña, el valor de la contraseña requerida es un token de acceso a Token de acceso de Diligent One que puede generar en Launchpad. Para obtener más información, consulte Adquiera un token de acceso de Token de acceso de Diligent One

Métodos de definición de contraseñas

Método Descripción

Etiqueta de estudio analítico PASSWORD

(para scripts que se ejecutan en Robots)

Si utiliza la etiqueta de estudio analítico PASSWORD para crear la definición de contraseña numerada para conectarse a Diligent One, no se especifica ningún valor de contraseña en el script. Cuando crea una tarea para ejecutar el script en Robots, un campo de entrada del Diseñador de tareas le permite a usted o a otro usuario especificar la contraseña real.

Si desea obtener más información, consulte Etiqueta de estudio analítico PASSWORD.

Comando PASSWORD

(para scripts que se ejecutan en Analytics, activación sin conexión)

Si utiliza el comando PASSWORD para crear la definición de contraseña numerada para conectarse a Diligent One, no se especifica ningún valor de contraseña en el script. Cuando el script trata de conectarse, aparece una solicitud de contraseña.

Si desea obtener más información, consulte Comando PASSWORD.

Comando SET PASSWORD

(para scripts que se ejecutan en Analytics, activación sin conexión)

Si utiliza el comando SET PASSWORD para crear la definición de contraseña numerada para conectarse a Diligent One, se especifica un valor de contraseña en el script, por lo que no aparece ninguna solicitud de contraseña. Este método es apropiado para scripts diseñados para ejecutarse sin intervención. No obstante, se expone una contraseña real con texto claro en el script, por lo que puede que no sea conveniente para su situación.

Si desea obtener más información, consulte Comando SET PASSWORD.

Adquiera un token de acceso de Token de acceso de Diligent One

¡Precaución!

El token de acceso generado concuerda con la cuenta utilizada para iniciar sesión en Diligent One. Como escritor de scripts, puede no ser apropiado especificar su propio token de acceso si otras personas van a usar el script.

Proteja los tokens de acceso como cualquier contraseña de cuenta.

Utilice un token de acceso 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.

  1. Realice una de las siguientes acciones:

    • Desde el menú principal de Analytics, seleccione Herramientas > Token de acceso de Diligent One.

    • En el Editor de scripts, haga clic con el botón derecho del mouse y seleccione Insertar > Token de Diligent One.

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

    Acceder a la página Administrar tokens de API desde Analytics es una función muy práctica. También puede iniciar sesión en Diligent One para acceder a la página desde su perfil de usuario sin usar Analytics.

  2. Realice una de las siguientes acciones:

    • Usar un token existente

      1. En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar.

      2. Introduzca la contraseña de su cuenta de Diligent One y haga clic en Confirmar.

        Se muestra el token sin enmascarar.

      3. Haga clic en Copiar para copiar el token.

        Consejo

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

    • Cree un nuevo token

      1. Haga clic en Agregar token > Analytics.

      2. En el panel lateral Nuevo token de Analytics, especifique la siguiente información:

        Campo u opción Descripción
        Descripción

        Introduzca una descripción que proporcione información útil, por ejemplo:

        • El propósito del token
        • Dónde se utiliza el token, por ejemplo, el nombre y la ubicación del script de Analytics, o el nombre y la ubicación de la tarea del robot
        Caducidad del token
        • ActivadoEl token caduca después del número de días que especifique.
        • DesactivadoEl token nunca caduca.

        Nota

        Es posible que su organización tenga una política de seguridad que requiera que los tokens caduquen después de cierto tiempo. La creación de tokens con fecha de caducidad es una buena práctica. Diligent One le envía una notificación por correo electrónico automatizada antes de la fecha de caducidad.
        Caduca en Especifique los días que faltan para que el token caduque (de 1 a 365).
        Contraseña Introduzca la contraseña de su cuenta de Diligent One.

      3. Haga clic en Generar token.

      4. Haga clic en Copiar para copiar el token.

        Consejo

        No cierre el panel lateral que contiene el token hasta que haya pegado el token correctamente.

  3. En función del método de definición de contraseña que utilice, realice una de estas acciones:

    • Etiqueta de estudios analíticos PASSWORDEn el Diseñador de la tarea de un Robot ACL, pegue el token que ha copiado en un campo de parámetro de contraseña.

    • Comando PASSWORDEn Analytics, pegue el token que ha copiado en la solicitud de contraseña que aparezca durante la ejecución del script.

    • Comando SET PASSWORDEn Analytics, pegue el token en el lugar adecuado de la sintaxis de comando SET PASSWORD de un script.

  4. En Launchpad, cierre el cuadro de diálogo o el panel lateral 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.

    Para obtener más información, consulte Creación y administración Tokens de acceso de Diligent One.