Comando IMPORT GRCRESULTS

Crea una tabla de Analytics importando una tabla o interpretación de Resultados de HighBond.

Sintaxis

IMPORT GRCRESULTS TO tabla importar_nombredearchivo PASSWORD núm FROM Ruta_recursos_Resultados <FIELD nombre AS nombre_visible <...n>>

Parámetros

Nombre Descripción
TO tabla

El nombre de la tabla de Analytics a la que se importarán los datos.

Nota

Los nombres de tabla tienen un límite máximo de 64 caracteres alfanuméricos. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

nombrearchivo_importación

El nombre del archivo de datos de Analytics que se debe crear.

Especifique nombrearchivo_importación como una cadena entre comillas con una extensión de archivo .FIL. Por ejemplo: "Facturas.FIL".

Por valor predeterminado, el archivo de datos (.FIL) se guarda en la carpeta que contiene el proyecto de Analytics.

Utilice una ruta de archivo absoluta o relativa para guardar el archivo de datos en una carpeta existente o una diferente:

  • "C:\datos\Facturas.FIL"
  • "datos\Facturas.FIL"
PASSWORD núm

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:

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.

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

FROM Ruta_recursos_Resultados

La ruta a los datos que está importando.

La forma de la ruta varía según los datos que está importando. Si desea obtener información detallada acerca de la forma de la ruta, consulte Ruta de Resultados.

Nota

La forma de la ruta de Resultados es proporcionada por una API y está sujeta a cambios. La manera más sencilla y confiable de obtener la sintaxis correcta y actualizada para la ruta es realizar una importación manual de los datos de destino y copiar la ruta desde el log del comando.
FIELD nombre AS nombre_visible <...n>

opcional

Campos individuales de los datos de origen que se deben importar. Especifique el nombre.

Si omite FIELD, se importan todos los campos.

Nombre

nombre debe coincidir de forma exacta con el nombre del campo físico en la tabla de Resultados, lo cual incluye mayúsculas y minúsculas. Para ver el nombre del campo físico, complete una de las siguientes acciones:

  • En Resultados, haga clic en el encabezado de una columna en la Vista de la tabla. El nombre del campo físico aparece después de Nombre campo.
  • En Analytics, al importar una tabla de Resultados, el nombre del campo físico aparece entre paréntesis después del nombre visible en el cuadro de diálogo que le permite seleccionar campos.

Nota

El nombre del campo físico Resultados no es el nombre visible que se usa en los encabezados de las columnas de la Vista de la tabla.

Consulte también Consideraciones de los nombres de campos al importar y exportar datos de Resultados.

Nombre visible

nombre visible (título de columna alternativo) es el nombre visible para el campo en la vista de la nueva tabla de Analytics. Debe especificar un nombre visible para cada FIELD nombre. Especifique nombre_visible como una cadena entre comillas.

Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.

A diferencia de algunos otros comandos IMPORT de Analytics, no puede especificar nombre_visible en blanco para utilizar el nombre del campo como el nombre visible.

Ejemplos

Importación de campos especificados desde una tabla de Resultados

Usted importa campos especificados desde una tabla de Resultados a una tabla de Analytics denominada Excepciones gastos representació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" 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"

Importación de todos los campos desde una tabla de Resultados

Usted importa todos los campos desde una tabla de Resultados a una tabla de Analytics que tiene el nombre de Excepciones gastos representació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"

Importación de datos desde una interpretación en Resultados

Usted importa una interpretación de Resultados a una tabla de Analytics que tiene el nombre de Excepciones gastos representación filtradas:

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

Nota

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

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

Nota

La forma de la ruta de Resultados es proporcionada por una API y está sujeta a cambios. La manera más sencilla y confiable de obtener la sintaxis correcta y actualizada para la ruta es realizar una importación manual de los datos de destino y copiar la ruta desde el log del comando.

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

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 todas las variaciones de la ruta de Resultados.

Para importar: Utilice esta forma de la ruta de Resultados:
Datos de la prueba de control (tabla) FROM "results/api/orgs/11594/control_tests/4356/exceptions"
Pista de auditoría de la prueba de control (tabla) FROM "results/api/orgs/11594/control_tests/4356/audit_trail"
Comentarios de la prueba de control (tabla) FROM "results/api/orgs/11594/control_tests/4356/comments"
Interpretación FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions"
Datos de una región de HighBond que no es la región predeterminada (us)
  • Pacífico de Asia FROM "results-ap/api/orgs/11594/control_tests/4356/exceptions"
  • Australia FROM "results-au/api/orgs/11594/control_tests/4356/exceptions"
  • Canadá FROM "results-ca/api/orgs/11594/control_tests/4356/exceptions"
  • Europa FROM "results-eu/api/orgs/11594/control_tests/4356/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.

Nombre del campo

Nombre visible predeterminado

metadata.priority

Prioridad

metadata.status

Estado

metadata.publish_date

Publicado

metadata.publisher

Nombre del editor

metadata.assignee

Asignado
metadata.group Grupo
metadata.updated_at Actualizado/a
metadata.closed_at Cerrado/a
extras.collection Colección
extras.results_table Tabla de resultados
extras.record_id ID del registro

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

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.

Capacidad de depuración para la importación

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

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 HighBond falla, pero el archivo JSON está presente en su computadora, usted sabe que el problema es de Analytics y no de HighBond.
  • El archivo JSON no está presente Si la importación desde HighBond falla y el archivo JSON no está presente en su computadora, usted sabe que el problema es de HighBond.

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 el siguiente nombre: _grc_import_debug.txt

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

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 JOIN
  • 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 DELIMITED