Comando IMPORT GRCPROJECT

Información de concepto

Importar datos de Proyectos de Diligent One

Crea una tabla de Analytics mediante la importación de una tabla de Proyectos de Diligent One.

Sintaxis

IMPORT GRCPROJECT TO tabla nombrearchivo_importación PASSWORD núm FROM id_org/id_tipo <FIELD nombre AS nombre_visible <...n>> <CHARMAX longitud_máx_campo>

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

El valor de la contraseña obligatoria es un token de acceso a Diligent One. 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.

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

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 Diligent One desde la cual está importando datosDiligent One
  • 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 ( @ ) y un guion ( - ) .

FROM "125@-eu"

Nota

Si especifica el código del centro de datos de América del Norte (US), el formato es levemente distinto, sin un guion:

FROM "125@us"

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

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:

  • audits: Proyectos
  • control_test_plans: Planes de prueba de controles
  • control_tests: Prueba de controles
  • controls: Controles
  • finding_actions: Acciones
  • findings: Problemas
  • mitigations: Asociaciones de Control de riesgos
  • narratives: Narrativas
  • objectives: Objetivos
  • risks: Riesgos
  • walkthroughs: Revisiones de confiabilidad

Consejo

Para 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 Diligent One.ProjectsAnalytics
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úsculasProjects
  • 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.
CHARMAX longitud_campo_máx

opcional

La longitud máxima en caracteres de cualquier campo de la tabla de Analytics que se origina como datos de carácter en la tabla Proyectos.

Los datos de la tabla Proyectos que superan la longitud de campo máxima se truncan al importarlos a Analytics.

La posibilidad de truncar campos impide que posibles valores demasiado largos se expandan más allá de la longitud total del registro permitida por el proceso de importación:

  • 32 767 caracteres (Analytics no Unicode)

  • 16 383 caracteres (Analytics Unicode)

Ejemplos

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 (región de Estados Unidos) a una tabla de Analytics denominada Todos_los_proyectos:Analytics

IMPORT GRCPROJECT TO Todos_los_proyectos "C:\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 Proyectos

Usted importa todos los campos de la tabla Proyectos para todos los proyectos activos que pertenecen a la organización 286 (región de Estados Unidos) 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:\Projects Data\Todos_los_proyectos.fil" PASSWORD 1 FROM "286@us/audits"

Limitación de la longitud de campos al importar desde la tabla Proyectos

Usted importa todos los campos de la tabla Proyectos a una tabla de Analytics denominada Todos_los_proyectos. Utiliza el parámetro CHARMAX para limitar la longitud de los campos.

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

En la tabla resultante de Analytics, todos los campos que se originan como datos de carácter en Proyectos tienen la limitación de la longitud especificada de 200 caracteres. Los valores de campos que superan ese límite se truncan a 200 caracteres.

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 (región de Europa) a una tabla de Analytics denominada Todos_los_asuntos:Analytics

IMPORT GRCPROJECT TO Todos_los_asuntos "C:\Projects Data\Todos_los_asuntos.fil" FROM "11594@eu/findings"

Observaciones

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

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 de Proyectos de Diligent One, debe incluir una definición de contraseña con el comando IMPORT GRCPROJECT. 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 Diligent One que puede generar en Launchpad. Si desea obtener más información, consulte Adquiera un 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 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:

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

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

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

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.