Commande IMPORT GRCPROJECT

Crée une table Analytics en important une table HighBond Projets.

Syntaxe

IMPORT GRCPROJECT TO table nom_fichier_importation PASSWORD num FROM id_org/id_type <FIELD nom AS nom_affichage <...n>>

Paramètres

Nom Description
TO table

Nom de la table Analytics dans laquelle les données doivent être importées.

Remarque

La longueur des noms des tables est limitée à 64 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

nom_fichier_importation

Nom du fichier de données Analytics à créer.

Indiquez nom_fichier_importation sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple, "Factures.FIL".

Par défaut, le fichier de données (.FIL) est enregistré dans le dossier contenant le projet Analytics.

Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :

  • "C:\données\Factures.FIL"
  • "données\Factures.FIL"
PASSWORD num

Définition de mot de passe à utiliser.

Vous n'utilisez pas PASSWORD num pour inviter à saisir ou pour spécifier un mot de passe réel. La définition de mot de passe renvoie à un mot de passe fourni ou défini auparavant à l'aide de la commande PASSWORD, de la commande SET PASSWORD ou de la balise d'outil d'analyse PASSWORD.

num correspond au numéro de la définition de mot de passe. Par exemple, si deux mots de passe ont été fournis ou définis auparavant dans un script, ou lors de la planification d'un outil d'analyse, PASSWORD 2 indique que le mot de passe n° 2 est utilisé.

Pour plus d'informations sur la fourniture ou définition de mots de passe, consultez les rubriques :

Remarque

Selon l'environnement d'exécution du script, PASSWORD peut être requis ou non :

Analytics

(activation en ligne)

PASSWORD n'est pas obligatoire.

Le jeton d'accès HighBond de l'utilisateur actuel est utilisé automatiquement.

Analytics

(activation hors ligne)

PASSWORD est obligatoire.

Robots
Analytics Exchange
Fenêtre App Analyse

FROM id_org/id_type

Organisation et type d'information définissant les données en cours d'importation :

  • id_org l'organisation Projets à partir de laquelle vous importez des données
  • id_type le type d'information que vous importez

Les valeurs id_org et id_type doivent être séparées par une barre oblique, sans espace intermédiaire : FROM "125@eu/audits".

La chaîne de caractères complète doit être entourée de guillemets.

ID d'organisation

id_org doit inclure le numéro ID de l'organisation, et si vous effectuez l'importation à partir d'un data center qui n'est pas en Amérique du Nord, cette valeur doit inclure le code du data center. Le numéro ID de l'organisation et le code du data center doivent être séparés par une arobase (@) : FROM "125@eu".

Le code du data center indique à partir de quel serveur régional d'HighBond vous importez les données :

  • ap : Asie-Pacifique
  • au : Australie
  • ca : Canada
  • eu : Europe
  • us : Amérique du Nord

Vous pouvez uniquement utiliser le ou les codes de data center autorisés pour l'instance HighBond de votre organisation. Le data center nord américain est le data center par défaut, vous n'êtes donc pas obligé d'indiquer "@us".

Si vous ne connaissez pas le numéro d'ID de l'organisation, utilisez l'interface utilisateur d'Analytics pour importer une table depuis Projets. Le numéro d'ID de l'organisation se trouve dans la commande dans la trace. Pour plus d'informations, consultez la rubrique Définition des données ACL GRC.

ID type

id_type le type d'information que vous importez. Les informations dans Projets sont contenues dans une série de tables associées.

Pour id_type, utilisez l'une des valeurs ci-après. Saisissez la valeur telle qu'elle apparaît et incluez des tirets bas, le cas échéant :

  • audits : Projets
  • control_test_plans : Plans de test de contrôle
  • control_tests : Test de contrôle
  • controls : Contrôles
  • finding_actions : Actions
  • findings : Problèmes
  • mitigations : Associations du contrôle de risque
  • narratives : Descriptions
  • objectives : Objectifs
  • risks : Risques
  • walkthroughs : Revues générales

Astuce

Pour plus d'informations sur la façon dont les tables de Projets sont associées et sur les champs clés que vous pouvez utiliser pour joindre les tables une fois qu'elles ont été importées dans Analytics, consultez la rubrique Définir les données ACL GRC.

FIELD nom AS nom_affichage <...n>

optionnel

Champs individuels dans les données source à importer. Indiquez le nom.

Si vous ignorez FIELD, tous les champs sont importés.

  • nom doit correspondre exactement au nom du champ physique dans la table Projets, avec la casse correspondante
  • nom_affichage (autre titre de colonne) est le nom d'affichage du champ dans la vue dans la nouvelle table Analytics. Vous devez indiquer un nom d'affichage pour chaque FIELD nom. Indiquez le nom_affichage sous forme de chaîne entre guillemets.

    Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne.

    À la différence de certaines autres commandes IMPORT dans Analytics, vous ne pouvez pas spécifier de nom_affichage vide comme moyen d'utiliser le nom FIELD comme nom d'affichage.

Astuce

Pour obtenir les noms de champs physiques, utilisez l'interface utilisateur Analytics pour importer la table appropriée à partir de Projets. Les noms de champs physiques se trouvent dans la commande dans la trace.

Les importations suivantes peuvent être rédigées à l'aide d'un script.

Exemples

Importer tous les champs à partir de la table Projets

Vous importez tous les champs de la table Projets pour tous les projets actifs relevant de l'organisation 286 vers une table Analytics nommée Tous_projets. Vous incluez une définition de mot de passe numérotée pour authentifier la connexion :

IMPORT GRCPROJECT TO Tous_projets "C:\ACL GRC Project Data\Tous_projets.fil" PASSWORD 1 FROM "286@us/audits"

Importer certains champs à partir de la table Projets

Vous importez certains champs de la table Projets pour tous les projets actifs relevant de l'organisation 286 vers une table Analytics nommée Tous_projets :

IMPORT GRCPROJECT TO Tous_projets "C:\ACL GRC Project Data\Tous_projets.fil" FROM "286@us/audits" FIELD "id" AS "Id" FIELD "description" AS "Description" FIELD "nom" AS "Nom" FIELD "date_début" AS "Date de début" FIELD "état" AS "État" FIELD "créé_le" AS "Créé à"

Importer tous les champs à partir de la table Problèmes

Vous importez tous les champs de la table Problèmes pour tous les projets actifs relevant de l'organisation 286 vers une table Analytics nommée Tous_problèmes :

IMPORT GRCPROJECT TO Tous_problèmes "C:\ACL GRC Project Data\Tous_problèmes.fil" FROM "286@us/découvertes"

Remarques

Remarque

Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.

Création d'une définition de mot de passe et spécification d'une valeur de mot de passe

Commande PASSWORD

Si vous utilisez la commande PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à HighBond, aucune valeur de mot de passe n'est indiquée, et l'utilisateur est invité à saisir le mot de passe lorsque le script tente de se connecter.

Pour plus d'informations, consultez la section Commande PASSWORD.

Commande SET PASSWORD

Si vous utilisez la commande SET PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à HighBond, une valeur de mot de passe est indiquée, et l'utilisateur n'est pas invité à saisir le mot de passe, ce qui convient aux scripts conçus pour s'exécuter sans surveillance.

Pour plus d'informations, consultez la rubrique Commande SET PASSWORD.

Jeton d'accès à HighBond

Quelle que soit la méthode que vous utilisez pour créer la définition de mot de passe, la valeur de mot de passe requise est un jeton d'accès à HighBond :

  • Méthode PASSWORD - Les utilisateurs peuvent acquérir un jeton d'accès en sélectionnant Outils Jeton d'accès à HighBond, puis en se connectant à HighBond. Un jeton d'accès est renvoyé, et les utilisateurs peuvent le copier et le coller dans la demande de mot de passe.
  • Méthode SET PASSWORD : pour insérer un jeton d'accès dans la syntaxe de la commande SET PASSWORD dans un script Analytics, cliquez avec le bouton droit de la souris dans l'Éditeur de script, sélectionnez Insérer > Jeton HighBond, puis connectez-vous à HighBond. Un jeton d'accès est inséré dans le script à l'emplacement du curseur.

Attention

Le jeton d'accès renvoyé correspond au compte utilisé pour se connecter à HighBond. En tant que rédacteur de scripts, il se peut qu'il ne soit pas très approprié d'utiliser votre propre jeton d'accès si vous écrivez un script qui sera utilisé par d'autres personnes.

Fonctionnalité de débogage pour les importations

Une fonctionnalité de débogage simple existe pour les importations à partir d'HighBond.

Les données importées sont stockées temporairement dans un fichier intermédiaire JSON dans le dossier contenant le projet Analytics cible. Dans un dossier contenant un projet Analytics, vous pouvez créer un fichier texte entraînant la conservation du fichier JSON, plutôt que sa suppression après l'importation des données dans Analytics.

  • Le fichier JSON est présent Si l'importation à partir d'HighBond échoue, mais que le fichier JSON est présent sur votre ordinateur, vous savez que le problème est du côté d'Analytics et non du côté d'HighBond.
  • Le fichier JSON n'est pas présent Si l'importation à partir d'HighBond échoue, et que le fichier JSON n'est pas présent sur votre ordinateur, vous savez que le problème est du côté d'HighBond.

Ces informations peuvent être utiles pour résoudre des problèmes.

Configurer la conservation du fichier intermédiaire JSON

Dans le dossier contenant le projet Analytics cible, créez un fichier texte vide comportant ce nom exactement : _grc_import_debug.txt

Lorsque vous importez à partir de Résultats ou de Projets vers HighBond, le fichier intermédiaire JSON est conservé avec le nom results.json. Le fichier est écrasé à chaque nouvelle importation à partir d'HighBond.

Guide de création de scripts ACL 14.1