Commande IMPORT GRCRESULTS

Information de concept

Importation de données Diligent One Résultats

Crée une table Analytics en important une interprétation ou une table Diligent One Résultats.

Syntaxe

IMPORT GRCRESULTS TO table nom_fichier_importation PASSWORD num FROM chemin_ressource_Résultats <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.

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 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 à Diligent One. Pour plus d'informations, consultez la rubrique 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 Diligent 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 Chemin_ressources_résultats

Chemin d'accès permettant d'accéder aux données que vous importez.

La forme du chemin d'accès varie selon les données que vous importez. Pour obtenir des informations détaillées sur la forme du chemin d'accès, reportez-vous à la rubrique Chemin d'accès Résultats.

Remarque

La forme du chemin d'accès Résultats est fournie par une API et est susceptible d'être modifiée. Le moyen le plus simple et le plus fiable d'acquérir la syntaxe actuelle qui convient pour le chemin consiste à effectuer une importation manuelle des données cibles et de copier le chemin depuis la trace des commandes.
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

nom doit correspondre exactement au nom du champ physique dans la table Résultats, avec la casse correspondante. Pour afficher le nom de champ physique, effectuez l'une des actions suivantes :

  • Dans Résultats, cliquez sur un en-tête de colonne dans la Vue de la table. Le nom du champ physique apparaît après Nom du champ.
  • Dans l'interface utilisateur d'Analytics, lorsque vous importez une table Résultats, le nom du champ physique apparaît entre parenthèses après le nom d'affichage dans la boîte de dialogue vous permettant de sélectionner des champs.

Remarque

Le nom du champ physique Résultats n'est pas le nom d'affichage utilisé dans les en-têtes des colonnes dans la Vue de la table.Results

Voir aussi Considérations générales sur les noms des champs lors de l'importation et de l'exportation des données de Résultats.

Nom d'affichage

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.Analytics
CHARMAX longueur_champ_max

optionnel

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 ou l'interprétation Résultats.

Les données dans la table ou l'interprétation Résultats dépassant la longueur de champ maximale sont tronquées lors de l'importation dans Analytics.

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

Importation des champs spécifiés d'une table de Résultats

Vous importez des champs spécifiés d'une table de Résultats vers une table Analytics nommée Exceptions T et E :ResultsAnalytics

IMPORT GRCRESULTS TO Exceptions_T_et_E "C:\Analyse secondaire\Exceptions_T_et_E.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" FIELD "metadata.status" AS "Status" FIELD "EmpNo" AS "Numéro de l'employé" FIELD "DATE" AS "Date" FIELD "CARDNUM" AS "Numéro de carte" FIELD "CODES" AS "Codes MC" FIELD "AMOUNT" AS "Montant" FIELD "DESCRIPTION" AS "Description"

Importation de tous les champs d'une table de Résultats

Vous importez tous les champs d'une table de Résultats vers une table Analytics nommée Exceptions T et E :ResultsAnalytics

IMPORT GRCRESULTS TO Exceptions_T_et_E "C:\Analyse secondaire\Exceptions_T_et_E.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions"

Limiter la longueur de champ lors de l'importation à partir d'une table dans Résultats

Vous importez tous les champs d'une table de Résultats vers une table Analytics nommée Exceptions T et E. Vous utilisez le paramètre CHARMAX pour limiter la longueur de champ.

IMPORT GRCRESULTS TO Exceptions_T_et_E "C:\Analyse secondaire\Exceptions_T_et_E.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" 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.

Importation des données à partir d'une interprétation dans Résultats

Vous importez une interprétation de Résultats vers une table Analytics nommée Exceptions T et E filtrées :ResultsAnalytics

IMPORT GRCRESULTS TO Exceptions_T_et_E_filtrées "C:\Analyse secondaire\Exceptions_T_et_E_filtrées.fil" FROM "results/api/orgs/11594/control_tests/185699/interpretations/22699/exceptions"

Remarques

Pour plus d'informations sur le fonctionnement de cette commande, consultez Importation de données Diligent One Résultats.

Conserver l'ordre des tris et les filtres

Lorsque vous importez des données à partir de Résultats, la personnalisation de données, comme les tris ou les filtres, est conservée ou ignorée dans la table Analytics ainsi créée selon le mode d'importation des données :

  • importer une table la personnalisation des données est ignorée. Toutes les données de la table sont importées, à l'exception des champs que vous choisissez d'omettre.
  • importer une interprétation la personnalisation des données est conservée

Chemin d'accès Résultats

Remarque

La forme du chemin d'accès Résultats est fournie par une API et est susceptible d'être modifiée. Le moyen le plus simple et le plus fiable d'acquérir la syntaxe actuelle qui convient pour le chemin consiste à effectuer une importation manuelle des données cibles et de copier le chemin depuis la trace des commandes.

Le chemin d'accès Résultats dans le paramètre FROM prend la forme générale suivante :Results

FROM "results <-code région>/api/orgs/<ID org>/control_tests/<ID de test de contrôle>/exceptions

Par exemple :

FROM "results/api/orgs/11594/control_tests/4356/exceptions"

L'ID org s'affiche dans la barre d'adresse du navigateur lorsque vous vous connectez à la Barre de lancement. L'ID du test de contrôle et l'ID de l'interprétation s'affichent dans la barre d'adresse lorsque vous affichez ces tables dans Résultats.

Le tableau ci-dessous indique les variations du chemin d'accès Résultats.

Pour l'importation : Utilisez cette forme de chemin d'accès Résultats :
Données des tests de contrôle (table) 
FROM "results/api/orgs/11594/control_tests/4356/exceptions"
Piste d'audit des tests de contrôle (table) 
FROM "results/api/orgs/11594/control_tests/4356/audit_trail"
Commentaires des tests de contrôle (table) 
FROM "results/api/orgs/11594/control_tests/4356/comments"
Interprétation 
FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions"
Données d'une région Diligent One autre que la région par défaut – Amérique du Nord (US)
  • Afrique (Afrique du Sud)
    FROM "results-af/api/orgs/11594/control_tests/4356/exceptions"
  • Asie-Pacifique (Australie)
    FROM "results-au/api/orgs/11594/control_tests/4356/exceptions"
  • Asie-Pacifique (Singapour)
    FROM "results-ap/api/orgs/11594/control_tests/4356/exceptions"
  • Asie-Pacifique (Tokyo)
    FROM "results-jp/api/orgs/11594/control_tests/4356/exceptions"
  • Europe (Allemagne)
    FROM "results-eu/api/orgs/11594/control_tests/4356/exceptions"
  • Amérique du Nord (Canada)
    FROM "results-ca/api/orgs/11594/control_tests/4356/exceptions"
  • Amérique du Sud (Brésil)
    FROM "results-sa/api/orgs/11594/control_tests/4356/exceptions"

Colonnes d'informations générées par le système

Lorsque vous importez des données à partir de Résultats, vous avez la possibilité d'importer une ou plusieurs colonnes d'informations générées par le système parmi celles ci-dessous.

Les colonnes générées par le système :

  • font partie des tables Résultats et contiennent des informations de traitement liées aux enregistrements individuels OU
  • représentent des informations supplémentaires : nom de la collection, nom de la table ou numéro d'ID d'enregistrement

Vous devez spécifier les noms des champs des colonnes générées par le système exactement comme ils apparaissent ci-dessous. Les noms d'affichage par défaut s'appliquent lorsque vous effectuez une importation depuis Résultats via l'interface utilisateur Analytics. Vous êtes libre de modifier les noms d'affichage si vous écrivez un script pour le processus d'importation.

Nom de champ

Nom d'affichage par défaut

metadata.priority

Priorité

metadata.status

Statut

metadata.publish_date

Publication

metadata.publisher

Nom de l'éditeur

metadata.assignee

Assigné
metadata.group Groupe
metadata.updated_at Mis(e) à jour
metadata.closed_at Fermé(e)
extras.collection Collection
extras.results_table Table de résultats
extras.record_id ID enregistrement

Considérations générales sur les noms des champs lors de l'importation et de l'exportation des données de Résultats

If you are round-tripping data between Résultats and Analytics, you need to ensure that all field names in the Résultats table meet the more stringent Analytics field name requirements. If you do not, you risk misaligning your Analytics and Résultats data.

For example, any special characters in Résultats field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in Résultats. If you then export the Analytics data back to the original table in Résultats, fields are no longer correctly matched.

To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to Résultats from CSV or Excel files it meets these Analytics field name requirements:

  • no special characters or spaces
  • does not start with a number
  • contains only alphanumeric characters, or the underscore character ( _ )

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 ou une interprétation Diligent One Résultats, vous devez inclure une définition de mot de passe avec la commande IMPORT GRCRESULTS. 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 à Diligent One, que vous pouvez générer dans Barre de lancement. Pour plus d'informations, consultez la rubrique Obtenir un jeton d’accès Diligent 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'analyse de données 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, 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 section 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, 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 Diligent One

Attention

Le jeton d'accès généré correspond au compte utilisé pour se connecter à Diligent One. 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.

  1. Effectuez l'une des actions suivantes :

    • Dans le menu principal d’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 est possible que vous deviez d'abord vous connecter à Diligent One.

    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 passer par Analytics.

  2. 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 le mot de passe de votre compte Diligent One et cliquez sur Confirmer.Diligent One

        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

      1. Cliquez sur Ajouter un jeton > Analytics.

      2. 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ée le jeton expire au bout du nombre de jours que vous avez spécifié
        • Désactivée le jeton n'expire pas

        Remarque

        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.

      3. Cliquez sur Générer un jeton.

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

  3. 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 PASSWORD Dans leConcepteur de tâches d'un robot ACL, collez le jeton copié dans un champ de paramètre de mot de passe.ACL robot

    • Commande PASSWORD Dans Analytics, collez le jeton copié dans l'invite de mot de passe qui apparaît lors de l'exécution du script.Analytics

    • Commande SET PASSWORD Dans Analytics, collez le jeton copié à l'endroit approprié dans la syntaxe de la commande SET PASSWORD dans un scriptAnalytics

  4. 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 plus d’informations, consultez la rubrique Créer et gérer des jetons d’accès Diligent One.

Fonctionnalité de débogage pour les importations

Une fonctionnalité de débogage simple existe pour les importations à partir de 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ésent Si 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.Diligent OneAnalyticsDiligent One
  • Le fichier JSON est absent Si 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.Diligent OneDiligent 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.txtAnalytics

Lorsque vous importez des données 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 de Diligent One.

Importation de tables volumineuses

Tables that have a large number of fields may not successfully import using a single IMPORT GRCRESULTS command. If you need to work with a single table containing a large number of fields outside of Résultats, use one of the following approaches:

  • Split the table use two or more IMPORT GRCRESULTS commands to import a subset of fields and then join the resulting tables in Analytics using the JOIN command
  • Export the table to file use the export to CSV format and then import the resulting file into Analytics using the IMPORT DELIMITED command