Comando IMPORT GRCPROJECT

Crea una tabla de Analytics importando una tabla de Proyectos de HighBond.

Sintaxis

IMPORT GRCPROJECT TO tabla nombrearchivo_importación PASSWORD núm FROM id_org/id_tipo <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 id_org id_tipo

La organización y el tipo de información que define los datos que se están importando:

  • id_org la organización de Proyectos de la cual está importando datos
  • id_tipo el tipo de información que está importando

El valor id_org y el valor id_tipo deben estar separados por una barra, sin espacios: FROM "125@eu/audits".

La cadena completa debe estar encerrada entre comillas.

Identificador de la organización

id_org debe incluir el número de ID de la organización y, si está realizando la importación desde un centro de datos ubicado fuera de América del Norte, el código del centro de datos. El número de ID de la organización y el código del centro de datos deben estar separados por el signo (@): FROM "125@eu".

El código del centro de datos especifica desde qué servidor regional de HighBond va a importar 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.

Si no conoce el número de ID de la organización, utilice la interfaz de usuario de Analytics para importar una tabla desde Proyectos. El número de ID de la organización está incluido en el comando en el log. Si desea obtener más información, consulte Importar datos de Proyectos de HighBond.

ID tipo

id_tipo especifica el tipo de información que está importando. La información en Proyectos está contenida en una serie de tablas relacionadas.

Para id_tipo, utilice uno de los valores que se incluyen a continuación. Escriba el valor exactamente como aparece e incluya guiones bajos, según corresponda:

  • auditorías: Proyectos
  • planes_prueba_control: Planes de prueba de controles
  • prueba_control: Prueba de controles
  • controles: Controles
  • buscar_acciones: Acciones
  • hallazgos: Problemas
  • mitigaciones: Asociaciones de Control de riesgos
  • narrativas: Narrativas
  • objetivos: Objetivos
  • riesgos: Riesgos
  • revisiones de confiabilidad: Revisiones de confiabilidad

Consejo

Si desea obtener información sobre cómo se relacionan las tablas en Proyectos y los campos claves que puede utilizar para unir las tablas una vez que las haya importado a Analytics, consulte Importar datos de Proyectos de HighBond.
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 debe coincidir de forma exacta con el nombre del campo físico en la tabla Proyectos, lo cual incluye mayúsculas y minúsculas
  • 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.

Consejo

Para obtener los nombres de campos físicos, utilice la interfaz de usuario de Analytics para importar la tabla apropiada de Proyectos. Los nombres de campos físicos están contenidos en el comando en el log.

Las importaciones posteriores se pueden incluir en scripts.

Ejemplos

Importación de todos los campos de la tabla Proyectos

Usted importa todos los campos de la tabla Proyectos para todos los proyectos activos que pertenecen a la organización 286 a una tabla de Analytics denominada Todos_los_proyectos. Usted incluye una definición de contraseña numerada para autenticar la conexión:

IMPORT GRCPROJECT TO Todos_los_proyectos "C:\HighBond Projects Data\Todos_los_proyectos.fil" PASSWORD 1 FROM "286@us/audits"

Importación de campos especificados desde la tabla Proyectos

Usted importa los campos especificados de la tabla Proyectos para todos los proyectos activos que pertenecen a la organización 286 a una tabla de Analytics denominada Todos_los_proyectos:

IMPORT GRCPROJECT TO Todos_los_proyectos "C:\HighBond Projects Data\Todos_los_proyectos.fil" FROM "286@us/audits" FIELD "id" AS "Id" FIELD "descripción" AS "Descripción" FIELD "nombre" AS "Nombre" FIELD "fecha_inicio" AS "Fecha inicio" FIELD "estado" AS "Estado" FIELD "creado_en" AS "Creado en"

Importación de todos los campos de la tabla Asuntos

Usted importa todos los campos de la tabla Asuntos para todos los proyectos activos que pertenecen a la organización 286 a una tabla de Analytics denominada Todos_los_asuntos:

IMPORT GRCPROJECT TO Todos_los_asuntos "C:\HighBond Projects Data\Todos_los_asuntos.fil" FROM "286@us/findings"

Observaciones

Nota

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

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.