Comando IMPORT GRCRESULTS

Crea una tabla de Analytics mediante la importación de una tabla o interpretación de Resultados de Diligent One.

Sintaxis

IMPORT GRCRESULTS TO tabla nombrearchivo_importación PASSWORD núm FROM ruta_recursos_Resultados <FIELD nombre AS nombre_visible <...n>> <CHARMAX longitud_máx_campo>

Parámetros

Ejemplos

IMPORT GRCRESULTS TO Excepciones_gastos_representación "C:\Secondary Analysis\ Excepciones_gastos_representación.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" FIELD "metadata.status" AS "Estado" FIELD "Número empleado" AS "Número empleado" FIELD "DATE" AS "Fecha" FIELD "CARDNUM" AS "Número tarjeta" FIELD "CODES" AS "Códigos Mc" FIELD "AMOUNT" AS "Importe" FIELD "DESCRIPTION" AS "Descripción"

IMPORT GRCRESULTS TO Excepciones gastos representación "C:\Secondary Analysis\Excepciones_gastos_representación.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions"

IMPORT GRCRESULTS TO Excepciones_gastos_representación "C:\Secondary Analysis\Excepciones_gastos_representación.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" CHARMAX 200

IMPORT GRCRESULTS TO Excepciones_gastos_representación_filtradas "C:\Secondary Analysis\ Excepciones_gastos_representación_filtradas.fil" FROM "results/api/orgs/11594/control_tests/185699/interpretations/22699/exceptions

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Importar datos de Resultados de Diligent One.

Conservación de los filtros y el ordenamiento

Al importar datos desde Resultados, cualquier personalización de datos, como el ordenamiento o los filtros, se retiene o se ignora en la tabla de Analytics resultante según la manera en la que usted importe los datos:

• importar una tabla se ignora la personalización de datos. Se importan todos los datos de la tabla, excepto por los campos que usted decida omitir.
• importar una interpretación se conserva la personalización de los datos

Ruta de Resultados

La ruta de Resultados en el parámetro FROM tiene la siguiente forma general:Results

FROM "results <-código de región>/api/orgs/<ID org>/control_tests/<ID prueba de control>/exceptions

Por ejemplo:

FROM "results/api/orgs/11594/control_tests/4356/exceptions"

El valor de ID de la organización se muestra en la barra de direcciones del navegador al iniciar sesión en ACL Launchpad. El valor de ID de la prueba de control y de ID de la interpretación se muestran en la barra de direcciones al visualizar esas tablas en Resultados.

La tabla que se incluye a continuación proporciona variaciones de la ruta de Resultados.

FROM "results/api/orgs/11594/control_tests/4356/exceptions"

FROM "results/api/orgs/11594/control_tests/4356/audit_trail"

FROM "results/api/orgs/11594/control_tests/4356/comments"

FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions"

Columnas de información generadas por el sistema

Al importar datos desde Resultados, tiene la posibilidad de importar también una o más de las columnas de información generadas por el sistema que aparecen a continuación.

Las columnas generadas por el sistema son:

• parte de las tablas de Resultados y contienen información de procesamiento relacionada con los registros individuales; o bien
• información adicional: nombre de la colección, nombre de la tabla o número de ID del registro

Debe especificar los nombres de los campos de las columnas generadas por el sistema tal como aparecen a continuación. Los nombres visibles predeterminados se aplican al importar desde Resultados a través de la interfaz de usuario de Analytics. Puede cambiar los nombres visibles si está realizando un script del proceso de importación.

Consideraciones de los nombres de campos al importar y exportar datos de Resultados

Si va a intercambiar datos entre Resultados y Analytics, debe asegurarse de que todos los nombres de campos de la tabla de Resultados cumplan con los requisitos más estrictos de nombres de campos de Analytics. Si no lo hace, corre el riesgo de alinear incorrectamente los datos de Analytics y Resultados.

Por ejemplo, cualquier carácter especial en los nombres de campos de Resultados se convierte automáticamente en guiones bajos cuando se importa a Analytics y esto significa que los nombres ya no coincidirán con los nombres originales de Resultados. Si más tarde exporta los datos de Analytics nuevamente a la tabla original de Resultados, los campos ya no coinciden correctamente.

Para evitar este problema con los datos que planea intercambiar, asegúrese de que antes de cargar los datos a Resultados desde archivos CSV o de Excel, se cumplan los siguientes requisitos de nombres de campos de Analytics:

• no pueden tener caracteres especiales ni espacios
• no pueden comenzar con un número
• solo pueden tener caracteres alfanuméricos o el carácter de guion bajo (_)

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 importa una tabla o interpretación de Resultados de Diligent One, debe incluir una definición de contraseña con el comando IMPORT GRCRESULTS. 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

Adquirir un token de acceso de HighBond

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:

   • 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.

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.Diligent One

        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	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.

     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 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

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.

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

Capacidad de depuración para la importación

Existe una capacidad de depuración simple para las importaciones desde Diligent One.

Los datos importados se almacenan de manera temporal en un archivo JSON intermedio en la carpeta que contiene el proyecto de Analytics de destino. Puede crear un archivo de texto en cualquier carpeta que contenga un proyecto de Analytics, lo que hace que se conserve el archivo JSON en lugar de eliminarlo después de importar los datos a Analytics.

• El archivo JSON está presente Si la importación desde Diligent One falla y el archivo JSON está presente en su computadora, significa que el problema es de Analytics, y no de Diligent One.Diligent OneAnalyticsDiligent One
• El archivo JSON no está presente Si la importación desde Diligent One falla y el archivo JSON no está presente en su computadora, significa que el problema es de Diligent One.Diligent OneDiligent One

Esta información puede ayudar a resolver problemas.

Configure la retención del archivo JSON intermedio

En la carpeta que contiene el proyecto de Analytics de destino, cree un archivo de texto vacío que tenga exactamente este nombre: _grc_import_debug.txtAnalytics

Al importar desde Resultados o Proyectos en Diligent One, el archivo JSON intermedio se conserva con el nombre results.json. El archivo se sobrescribe con cada importación desde Diligent One.

Importación de tablas extensas

Tal vez no sea posible importar correctamente las tablas que tienen gran cantidad de campos con un comando IMPORT GRCRESULTS. Si necesita trabajar con una única tabla fuera de Resultados y la tabla contiene gran cantidad de campos, use una de las siguientes opciones:

• Divida la tabla use dos o más comandos IMPORT GRCRESULTS para importar un subconjunto de campos y después unir las tablas resultantes en Analytics utilizando el comando JOINAnalytics
• Exporte la tabla a un archivo use la exportación al formado CSV y, a continuación, importe el archivo que obtuvo a Analytics utilizando el comando IMPORT DELIMITEDAnalytics