Commande IMPORT GRCRESULTS

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

Syntaxe

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

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.

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 :

IMPORT GRCRESULTS TO Exceptions_T_et_E "C:\Analyse secondaire\Exceptions_T_et_E.fil" PASSWORD 1 FROM "résultats/api/orgs/11594/tests_contrôle/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 :

IMPORT GRCRESULTS TO Exceptions_T_et_E "C:\Analyse secondaire\Exceptions_T_et_E.fil" PASSWORD 1 FROM "résultats/api/orgs/11594/tests_contrôle/185699/exceptions"

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 :

IMPORT GRCRESULTS TO Exceptions_T_et_E_filtrées "C:\Analyse secondaire\Exceptions_T_et_E_filtrées.fil" FROM "résultats/api/orgs/11594/tests_contrôle/185699/interprétations/22699/exceptions"

Remarques

Remarque

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

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 :

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

Par exemple : FROM "résultats/api/orgs/11594/tests_contrôle/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 toutes 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 "résultats/api/orgs/11594/tests_contrôle/4356/exceptions"
Piste d'audit des tests de contrôle (table) FROM "résultats/api/orgs/11594/tests_contrôle/4356/piste_audit"
Commentaires des tests de contrôle (table) FROM "résultats/api/orgs/11594/tests_contrôle/4356/commentaires"
Interprétation FROM "résultats/api/orgs/11594/tests_contrôle/4356/interprétations/1192/exceptions"
Données d'une région HighBond autre que la région par défaut (us)
  • Asie-Pacifique FROM "résultats-ap/api/orgs/11594/tests_contrôle/4356/exceptions"
  • Australie FROM "résultats-au/api/orgs/11594/tests_contrôle/4356/exceptions"
  • Canada FROM "résultats-ca/api/orgs/11594/tests_contrôle/4356/exceptions"
  • Europe FROM "résultats-eu/api/orgs/11594/tests_contrôle/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

Publié

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

Si vous exécutez des allers-retours de données entre Résultats et Analytics, vous devez vous assurer que tous les noms de champ dans la table de Résultats répondent aux conditions préalables des noms de champ Analytics. Si cela n'est pas le cas, vous risquez de ne pas aligner correctement les données entre Analytics et Résultats.

Par exemple, les caractères spéciaux des noms de champs de Résultats sont automatiquement convertis en caractères de soulignement lorsqu'ils sont importés dans Analytics, ce qui signifie que les noms de champ ne correspondent plus aux noms d'origine dans Résultats. Si vous réexportez ensuite les données Analytics dans la table d'origine dans Résultats, les champs ne correspondent plus comme il faut.

Pour éviter ce problème avec les données avec lesquelles vous prévoyez de faire des allers-retours, assurez-vous qu'elles répondent aux conditions préalables des noms de champ Analytics avant de charger les données dans Résultats à partir de fichiers CSV ou Excel :

  • ne contiennent aucun caractère spécial ni espace
  • ne commencent pas par un chiffre
  • contiennent uniquement des caractères alphanumériques ou le caractère de soulignement ( _ )

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.

Importation de tables volumineuses

Il se peut que les tables comportant un grand nombre de champs n'importent pas correctement à l'aide d'une seule commande IMPORT GRCRESULTS. Si vous devez travailler avec une seule table contenant un grand nombre de champs en dehors de Résultats, utilisez l'une des méthodes suivantes :

  • Diviser la table utilisez au moins deux commandes IMPORT GRCRESULTS pour importer un sous-ensemble de champs, puis joignez les tables ainsi créées dans Analytics à l'aide de la commande JOIN
  • Exporter la table dans un fichier utilisez l'exportation au format CSV, puis importez le fichier ainsi créé dans Analytics à l'aide de la commande IMPORT DELIMITED

[ Retour au début ]

Guide de création de scripts ACL 14.1