Commande IMPORT GRCPROJECT

Information de Concept

Importer les données Diligent One Projets

Crée une table Analytics en important une table Diligent One Projets.

Syntaxe

IMPORT GRCPROJECT TO tablenom_fichier_importation PASSWORD num FROM id_org/id_type <FIELD nom AS nom_affichage <...n>> <CHARMAX longueur_champ_maximale>

Paramètres

Nom

Description

TO table

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

Note

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, "Invoices.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:\data\Invoices.FIL"
"data\Invoices.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 script d'analyse de données, 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 :

La valeur du mot de passe obligatoire est un jeton d’accès à Jeton d’accès Diligent One One. Pour de plus amples informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

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

Environnement d'exécution du script

Condition requise relative à PASSWORD num

Analytics

(activation en ligne)

Le numéro de PASSWORD n'est pas obligatoire.

Le jeton d’accès Jeton d’accès Diligent One One de l’utilisateur actuel stocké dans son registre Windows est utilisé automatiquement.

Analytics

(activation hors ligne)

Le numéro de PASSWORD est obligatoire.

Robots

FROM id_org/id_type

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

id_org organisation Diligent One One à partir de laquelle vous importez des données
id_type 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 de l'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 (USA), 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 (@) et un trait d'union (-) :

FROM "125@-eu"

Note

Si vous indiquez le code du data center Amérique du Nord (US), un code au format légèrement différent sera utilisé, sans trait d'union :

FROM "125@us"

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

af – Afrique (Afrique du sud)
ap – Asie-Pacifique (Singapour)
au – Asie-Pacifique (Australie)
ca – Amérique du Nord (Canada)
eu – Europe (Allemagne)
jp – Asie-Pacifique (Tokyo)
sa – Amérique du sud (Brésil)
us – Amérique du Nord (USA)

Vous pouvez uniquement utiliser le ou les codes de data center autorisés pour l'instance Diligent One de votre organisation. Le data center nord-américain (USA) 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 Importer les données Diligent One Projets.

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 du 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 Projets, consultez la rubrique Importer les données Diligent One Projets.

FIELD nom AS nom_affichage <...n>

facultatif

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.

CHARMAX longueur_champ_max

facultatif

La longueur maximale en caractères d'un champ de la table Analytics qui provient d'une donnée de type caractère dans la table Projets.

Les données de la table Projets dépassant la longueur de champ maximale sont tronquées lors de l'importation dans Projets.

La fonctionnalité de troncature de champs empêche les valeurs longues occasionnelles d'augmenter la longueur de l'enregistrement au-delà de ce que le processus d'importation prend en charge :

32 767 caractères (analyse non Unicode)
16 383 caractères (analyse Unicode)

Exemples

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(région US) vers une table Analytics nommée Tous_projets :

IMPORT GRCPROJECT TO Tous_projets "C:\Projects 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 Projets

Vous importez tous les champs de la table Projets pour tous les projets actifs relevant de l'organisation 286 (région US) 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:\Projects Data\Tous_projets.fil" PASSWORD 1 FROM "286@us/audits"

Limiter la longueur de champ lors de l'importation à partir de la table Projets

Vous importez tous les champs de la table Projets vers une table Analytics nommée Tous_projets. Vous utilisez le paramètre CHARMAX pour limiter la longueur de champ.

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

Dans la table Analytics obtenue, tous les champs provenant de données de type caractère dans Résultats sont limités à la longueur spécifiée de 200 caractères. Toute valeur de champ dépassant la limite est tronquée à 200 caractères.

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 11594 (région européenne) vers une table Analytics nommée Tous_problèmes :

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

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez la section Importer les données Diligent One Projets.

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

Lorsque vous exécutez un script dans Robots qui importe une table Diligent One One Projets, vous devez inclure une définition de mot de passe avec la commande IMPORT GRCPROJECT. La même condition requise s'applique aux scripts exécutés dans Analytics si vous avez utilisé l'activation hors connexion.

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 à Jeton d’accès Diligent One One, que vous pouvez générer dans Barre de lancement. Pour de plus amples informations, consultez la section Obtenir un jeton d’accès Jeton d’accès Diligent One One.

Méthodes de définition de mot de passe

Méthode	Description
Balise d'outil d'analyse PASSWORD (Pour les scripts exécutés dans Robots)	Si vous utilisez la balise d'outils d'analyse PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One, aucune valeur de mot de passe n'est indiquée dans le script. Lorsque vous créez une tâche pour exécuter le script dans Robots, un champ d'entrée dans le Concepteur de tâches permet d'indiquer le mot de passe réel. Pour plus d'informations, consultez la section Balise d'outils d'analyse PASSWORD.
Commande PASSWORD (Pour les scripts exécutés dans Analytics, activation hors ligne)	Si vous utilisez la commande PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script. Une invite de mot de passe est affichée lorsque le script tente de se connecter. Pour plus d'informations, consultez la rubrique Commande PASSWORD.
Commande SET PASSWORD (Pour les scripts exécutés dans Analytics, activation hors ligne)	Si vous utilisez la commande SET PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script et aucune invite de mot de passe n'est affichée. Cette approche convient pour les scripts conçus pour être exécutés sans assistance, mais elle dévoile un mot de passe réel en texte clair dans le script, ce qui risque de ne pas être adapté à votre situation. Pour plus d'informations, consultez la rubrique Commande SET PASSWORD.

Méthode

Description

Balise d'outil d'analyse PASSWORD

(Pour les scripts exécutés dans Robots)

Si vous utilisez la balise d'outils d'analyse PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One, aucune valeur de mot de passe n'est indiquée dans le script. Lorsque vous créez une tâche pour exécuter le script dans Robots, un champ d'entrée dans le Concepteur de tâches permet d'indiquer le mot de passe réel.

Pour plus d'informations, consultez la section Balise d'outils d'analyse PASSWORD.

Commande PASSWORD

(Pour les scripts exécutés dans Analytics, activation hors ligne)

Si vous utilisez la commande PASSWORD afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script. Une invite de mot de passe est affichée lorsque le script tente de se connecter.

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

Commande SET PASSWORD

(Pour les scripts exécutés dans Analytics, activation hors ligne)

Si vous utilisez la commande SET PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à Diligent One One, aucune valeur de mot de passe n'est indiquée dans le script et aucune invite de mot de passe n'est affichée. Cette approche convient pour les scripts conçus pour être exécutés sans assistance, mais elle dévoile un mot de passe réel en texte clair dans le script, ce qui risque de ne pas être adapté à votre situation.

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

Obtenir un jeton d’accès Jeton d’accès Diligent One One

Attention

Le jeton d'accès généré correspond au compte utilisé pour se connecter à la Barre de lancement. En tant que rédacteur de scripts, indiquer votre propre jeton d'accès dans un script n'est peut-être pas très approprié si le script sera utilisé par d'autres personnes.

Protégez les jetons d’accès comme n’importe quel mot de passe de compte.

Utilisez un jeton d'accès existant sauf si vous avez une bonne raison d'en créer un nouveau. Si le jeton existant ne fonctionne pas, créez-en un nouveau. L'utilisation d'un jeton existant réduit le nombre de jetons que vous devez gérer.

Effectuez l'une des actions suivantes :
- Dans le menu principal Analytics, sélectionnez Outils > Jeton d’accès Diligent One.
- Dans l'Éditeur de script, cliquez avec le bouton droit de la souris, puis sélectionnez Insérer > Jeton Diligent One.
La page Gérer des jetons API s'ouvre dans votre navigateur. Il se peut que vous deviez d'abord vous connecter à la Barre de lancement.

L'accès à la page Gérer des jetons API via Analytics est une fonctionnalité d'ordre pratique. Vous pouvez également vous connecter à Diligent One et accéder à la page via votre profil utilisateur sans l'aide d'Analytics.

Effectuez l'une des actions suivantes :

Utiliser un jeton existant
1. Dans la colonne Jeton, cliquez sur le jeton en partie masqué que vous voulez utiliser.
2. Saisissez votre mot de passe Diligent One et cliquez sur Confirmer
  
  Le jeton démasqué s'affiche.
3. Cliquez sur Copier pour copier le jeton.
  
  Astuce
  
  Ne fermez pas la boîte de dialogue contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

Créer un nouveau jeton

Cliquez sur Ajouter un jeton > Analytics.

Dans le panneau latéral Nouveau jeton Analytics, indiquez les informations suivantes :

Champ ou option	Description
Description	Saisissez une description qui fournit des informations utiles, telles que : L'objet du jeton L'emplacement d'utilisation du jeton : par exemple, le nom et l'emplacement du script Analytics, ou le nom et l'emplacement des tâches du robot
Expiration du jeton	ActivéLe jeton expire au bout du nombre de jours que vous avez spécifié DésactivéLe jeton n’expire pas Note Votre organisation dispose peut-être d'une politique de sécurité qui demande à ce que les jetons expirent au bout d'un certain temps. Créer des jetons avec une date d'expiration est une bonne pratique. Diligent One vous envoie une notification automatique par e-mail quelques jours avant la date d'expiration.
Expire dans	Indiquez le nombre de jours avant l'expiration du jeton (de 1 à 365)
Mot de passe	Saisissez le mot de passe de votre compte Diligent One One.

Cliquez sur Générer un jeton.
Cliquez sur Copier pour copier le jeton.

Astuce

Ne fermez pas le panneau latéral contenant le jeton tant que vous n'avez pas fini de copier-coller le jeton.

Selon la méthode de définition de mot de passe utilisée, effectuez l'une des actions suivantes :
- Balise d’analyse de données PASSWORDDans le Concepteur de tâches d’un robot ACL, collez le jeton copié dans un champ de paramètre de mot de passeRobot ACL robot
- Commande PASSWORDDans Analytics, collez le jeton copié dans l’invite de mot de passe qui apparaît lors de l’exécution du script.
- Commande SET PASSWORDDans Analytics, collez le jeton à l’endroit approprié dans la syntaxe de la commande SET PASSWORD dans un script
Dans la barre de lancement, fermez la boîte de dialogue ou le panneau latéral contenant le jeton.

Si vous avez créé un nouveau jeton, une version partiellement masquée du jeton est ajoutée en haut de votre liste de jetons.

Pour de plus amples informations, consultez la section Créer et gérer Jetons d’accès Diligent One.

Fonctionnalité de débogage pour les importations

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

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ésentSi l’importation à partir de Diligent One échoue, mais que le fichier JSON est présent sur votre ordinateur, vous savez que le problème se trouve du côté d’Analytics et non de celui de Diligent One.
Le fichier JSON est absentSi l’importation à partir de Diligent One échoue et que le fichier JSON est absent de votre ordinateur, vous savez que le problème se trouve du côté de Diligent One.

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 Diligent One, le fichier intermédiaire JSON est conservé avec le nom results.json. Le fichier est écrasé à chaque nouvelle importation à partir d'Diligent One.