Comando EXPORT
Concept Information
Exportar excepciones a la aplicación Resultados de Diligent One
Exporta datos desde Analytics al formato de archivo especificado o a la aplicación Resultados o la aplicación Robots en Diligent One.
Nota
Para que el comando EXPORT funcione con archivos de Excel de versiones anteriores (*.xls) y archivos de Microsoft Access (*.mdb), debe estar instalado el motor de base de datos de Microsoft Access de 32 bits. Si desea obtener más información, consulte Excluir el motor de base de datos de Microsoft Access opcional.
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.
|
|||||||
| 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.
Si desea 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:
|
|||||||
|
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. |
|||||||
|
opcional |
Aplicable solo a 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 HighBond. Si desea 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.
|
|||||||
| 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: proveedores.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. Si desea obtener más información, consulte Exportar excepciones a la aplicación Resultados de Diligent One. El código del centro de datos especifica a qué servidor regional de Diligent One va a exportar los datos:
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 (US) es el valor predeterminado, por lo que especificar "@us" es opcional. |
|||||||
|
TO url_api_highbond |
En el caso de exportaciones a la aplicación Robots de Diligent One, el destino en Robots. ( HBDATA ) Nota No puede realizar una exportación a un robot ACL. Debe realizarla a un robot HighBond o a un robot de flujo de trabajo. El valor url_api_highbond representa la URL de solicitud de API de HighBond para el robot de destino. En el ejemplo siguiente se exporta un archivo *.csv.gz a su destino:
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:
|
|||||||
|
OVERWRITE opcional |
Aplicable solo a aplicaciones de Diligent One. ( ACLGRC , HBDATA )
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:
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:
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. Si desea obtener más información, consulte Cómo interactúa DISPLAYNAME con AS al exportar a Resultados de Diligent One. |
Ejemplos
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
Se exportan 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
Se exportan campos específicos desde la tabla Proveedor a una 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:
GROUP
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_CC
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 HighBond. Si desea obtener más información, consulte Creación de una definición de contraseña y especificación de un valor de contraseña.
COMMENT
//ANALYTIC Exportar datos a Resultados
//PASSWORD 1 Token de acceso de HighBond:
//RESULT LOG
END
OPEN Excepciones_CC
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 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().Robots
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 Robots de Diligent One. 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 HighBond. Si desea obtener más información, consulte Creación de una definición de contraseña y especificación de un valor de contraseña.
COMMENT
//ANALYTIC Exportar datos de Analytics a Robots
//PASSWORD 1 Token de acceso de HighBond:
//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 Robots de Diligent One.Diligent OneRobots
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 Robots de Diligent One:Diligent OneRobots
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 |
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 |
|
| Nombres de los campos |
|
| Longitud de los nombres de las hojas de cálculo |
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 |
|
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 |
|
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 |
|
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 |
Exportar 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 o privilegios de administrador de Diligent One:
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:
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 Exportar excepciones a la aplicación Resultados de Diligent One. 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. |
|
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 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. |
Permisos necesarios para exportar a Robots de Diligent One
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:Robots
-
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 Robots son automáticamente un colaborador para cada robot, con el rol de Propietario.
-
Un administrador del sistema 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 HighBond que puede generar en Launchpad. Si desea obtener más información, consulte Adquirir un token de acceso de HighBond.
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. |
Adquirir un token de acceso de HighBond
¡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.
-
Realice una de las siguientes acciones:
-
En el menú principal de Analytics, seleccione Herramientas > Token de acceso HighBond.AnalyticsHighBond Access Token
-
En el Editor de scripts, haga clic con el botón derecho del ratón y seleccione Insertar > Token de HighBond.HighBond Token
Se abre la página Administrar tokens de API en el navegador. Es posible que deba iniciar sesión primero 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.
-
-
Realice una de las siguientes acciones:
-
Usar un token existente
-
En la columna Token, haga clic en el token parcialmente enmascarado que desea utilizar.
-
Introduzca la contraseña de su cuenta de Diligent One y haga clic en Confirmar.Diligent One
Se muestra el token sin enmascarar.
-
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
-
Haga clic en Agregar token > Analytics.
-
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 - Activado el token caduca después del número de días que especifique
- Desactivado el 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 por correo electrónico una notificación 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. -
Haga clic en Generar token.
-
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.
-
-
-
En función del método de definición de contraseña que utilice, realice una de estas acciones:
-
Etiqueta de estudios analíticos PASSWORD En 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.ACL robot
-
Comando PASSWORD En Analytics, pegue el token que ha copiado en la solicitud de contraseña que aparezca durante la ejecución del script. Analytics
-
Comando SET PASSWORD En Analytics, pegue el token que ha copiado en el lugar adecuado de la sintaxis del comando SET PASSWORD de un script.Analytics
-
-
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.
Si desea más información, consulte Creación y administración de tokens de acceso de HighBond.HighBond access tokens
