Importation de données Diligent One Résultats

Information de concept

Commande IMPORT GRCRESULTS

Vous pouvez créer une table Analytics en important les données des collections avec lesquelles vous êtes autorisé à travailler dans Diligent One Résultats. Vous pouvez importer des tables de données ou des interprétations à partir de tests de contrôle individuels.

Remarque

Dans Résultats, un test de contrôle est désigné par « Outil d'analyse de données ».

Comment exploiter les informations

La possibilité d'importer des données de Résultats vers Analytics vous permet d'effectuer une analyse secondaire ou une analyse de suivi sur les exceptions. Une fois que vous avez réalisé l'analyse, vous pouvez exporter les données à nouveau vers Résultats via un processus d'aller-retour. Pour plus d'informations, consultez la rubrique Exportation des exceptions vers l’application Résultats dans Diligent One.

Considérations générales sur les noms des champs lors des allers-retours 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 ( _ )

Restriction de longueur d'enregistrement

La longueur d'enregistrement maximale que vous pouvez importer dans Analytics est égale à 32 767 caractères ou 16 383 caractères Unicode.

Si vous essayez d'importer des données de Résultats dont la longueur dépasse le nombre maximal, un message d'erreur s'affiche et l'importation échoue. Essayez de supprimer les champs descriptifs volumineux de l'importation afin de réduire la longueur de l'enregistrement.

Une autre approche consiste à réaliser l'importation à l'aide de la commande IMPORT GRCRESULTS dans la ligne de commande Analytics. Lorsque vous utilisez la commande, vous pouvez inclure le paramètre CHARMAX, qui permet d'indiquer un nombre maximal de caractères dans chaque fichier importé. Pour plus d'informations, consultez la section Commande IMPORT GRCRESULTS.

Étapes

Remarque

Il est possible que vous soyez invité à indiquer un mot de passe lorsque vous vous connectez à Diligent One. Pour plus d'informations, consultez la rubrique Obligation de mot de passe.

  1. Sélectionnez Importer > Diligent One > Résultats.
  2. Dans la boîte de dialogue Sélectionner les données à importer, double-cliquez sur le dossier de l'organisation.
  3. Naviguez jusqu'au test de contrôle approprié.

    Remarque

    Vous ne disposez pas des autorisations nécessaires pour accéder aux données si :

    • la collection contenant le test de contrôle ne s'affiche pas
    • le message Erreur lors de l'extraction de la liste des interprétations s'affiche lorsque vous essayez d'accéder au test de contrôle

    Pour plus d'informations, consultez la rubrique Affecter des privilèges et des rôles dans Résultats.

    Pour obtenir de l'aide au sujet des autorisations, contactez l'administrateur du compte Diligent One de votre entreprise ou l'administrateur Résultats.

  4. Sélectionnez l'une des tables suivantes à importer dans Analytics :
    • une interprétation, si une existe
    • piste d'audit
    • commentaires
    • table des résultats (double-cliquez sur le dossier Sélection du champ de table)

    Remarque

    Vous ne pouvez importer qu'une table à la fois vers Analytics.

    Astuce

    Vous pouvez joindre la table de résultats, la piste d'audit et les commentaires dans Analytics en utilisant ID enregistrement comme champ clé. Utilisez la table de résultats comme la table primaire dans la jointure.

  5. Si vous importez la table des résultats, sélectionnez les champs individuels que vous souhaitez importer dans les catégories suivantes :
    • Les champs de Métadonnées contenant des informations de flux de travail générés par le système et générés par l'utilisateur
    • Collection Extras et noms de test de contrôle, et Identifiant d'enregistrement

      Assurez-vous de sélectionner l'Identifiant d'enregistrement si vous essayez de joindre la table des résultats dans Analytics.

    • Les champs de Données qui contiennent des données qui ont été importées vers Résultats, ou des réponses vers un questionnaire Résultats
    • Sélectionner Tout importe toute la table
  6. Cliquez sur OK.

    Les données sont importées de Résultats.

  7. Dans la boîte de dialogue Enregistrer le fichier de données sous, saisissez un nom pour le fichier de données Analytics, et, si nécessaire, modifiez l'emplacement d'enregistrement du fichier, puis cliquez sur Enregistrer.Analytics
  8. Saisissez un nom pour la table Analytics que vous êtes en train d'ajouter au projet Analytics ou conservez le nom par défaut, et cliquez sur OK.AnalyticsAnalytics

    Remarque

    La longueur des noms des tables Analytics est limitée à 64 caractères alphanumériques, sans l’extension .FIL. 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.

Obligation de mot de passe

Mot de passe non obligatoire

Il est inutile d'indiquer un mot de passe à importer à partir de Diligent One si vous avez utilisé l'activation en ligne pour activer votre copie d'Analytics. Le mot de passe est créé et envoyé automatiquement à Diligent One en fonction des informations d'activation stockées sur votre ordinateur.

Mot de passe obligatoire

Vous devez indiquer un mot de passe pour importer des données à partir de Diligent One dans les situations suivantes :

  • vous avez utilisé l'activation hors ligne pour activer votre copie d'Analytics

  • vous utilisez un script pour importer des données à partir de Diligent One, et vous l'exécutez dans Robots

La valeur du mot de passe obligatoire est un jeton d’accès à Diligent One.

Obtenir un jeton d’accès Diligent One

Attention

Protégez votre jeton d'accès comme n'importe quel mot de passe de compte. Il contient des informations propres à votre compte Diligent One. Il n'est pas recommandé de partager des jetons d'accès.

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 d’accès aux données et la méthode de définition de mot de passe utilisée, effectuez l’une des actions suivantes :

    Interface utilisateur Analytics

    Collez le jeton copié dans l’invite de mot de passe qui apparaît lorsque vous accédez à Diligent One manuellement.

    Script d’analyse de données

    • Commande PASSWORD Collez le jeton copié dans l’invite de mot de passe qui apparaît lors de l’exécution du script.

    • Commande SET PASSWORD Collez le jeton copié à l’endroit approprié dans la syntaxe de la commande SET PASSWORD dans un script.

  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.