Exportation des exceptions vers l’application Résultats dans HighBond

Si vous utilisez HighBond, vous pouvez exporter les données d'exception d'une table Analytics vers une table dans le module Résultats. Pour exporter les exceptions, vous utilisez la procédure standard pour l'exportation de données à partir d'Analytics, à quelques petites différences près.

Résultats est une application d’automatisation du flux de travail et de remédiation qui gère les données d’exception, ajoute du contexte humain via des questionnaires et perpétue le suivi grâce aux déclencheurs et aux mesures. Pour plus d’informations, consultez la rubrique Utilisation des données dans Résultats.

Exigences de sécurité

La fonctionnalité permettant d’exporter des données d’exception vers un test de contrôle dans Résultats nécessite une affectation de rôle HighBond spécifique ou des privilèges d’administrateur :

• Les utilisateurs ayant un rôle d'utilisateur professionnel ou de responsable professionnel pour une collection de Résultats peuvent exporter les résultats vers n'importe quel test de contrôle dans la collection.

  Remarque

  Seuls les utilisateurs ayant le rôle responsable professionnel peuvent écraser les données existantes dans un test de contrôle.

• Les admins de compte d'HighBond et les admins de Résultats reçoivent automatiquement le rôle de responsable professionnel dans toutes les collections des instances HighBond qu'ils gèrent.

Pour plus d'informations, consultez la rubrique Autorisations de l'application Résultats.

Limites d'exportation

Les limites qui s'appliquent lors de l'exportation d'un test de contrôle dans Résultats sont indiquées ci-après.

Dans la mesure où vous respectez ces limites, vous pouvez lancer plusieurs exportations vers un même test de contrôle. Si le test de contrôle comporte déjà des données, vous avez la possibilité de les écraser ou d'ajouter de nouvelles données.

Élément	Maximum
Nombre d'enregistrements par exportation	100 000
Nombre d'enregistrements par test de contrôle	100 000
Nombre de champs par enregistrement	500
Nombre de caractères par champ	256

Assurer l'alignement des champs entre Analytics et 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 requises 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 sont plus associés correctement.

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 requises des noms de champ Analytics ci-dessous avant de charger les données dans Résultats à partir de fichiers CSV ou Excel :

• aucun caractère spécial ni espace
• aucun chiffre au début
• uniquement des caractères alphanumériques ou le caractère de soulignement ( _ )

Option Écraser et clé primaire de Résultats

Lorsque vous exportez des données d'exception d'Analytics dans une table Résultats existante, vous avez la possibilité de concaténer les données exportées dans la table ou d'écraser complètement celle-ci.

Si la table Résultats comporte un champ spécifié comme clé primaire et que les données que vous exportez comportent un champ correspondant, le comportement de l'exportation diffère légèrement. (Pour plus d'informations sur la spécification d'une clé primaire dans Résultats, voir Spécification d'une clé primaire.)

Les différentes possibilités sont résumées ci-dessous.

	Pas de clé primaire dans Résultats	Clé primaire dans Résultats
Option Écraser non sélectionnée	les données exportées sont concaténées avec la table Résultats existante	valeur correspondante s'il existe une valeur correspondante dans le champ de la clé primaire de Résultats et si le champ correspondant est exporté depuis Analytics, l'enregistrement dans Résultats est mis à jour avec les valeurs présentes dans l'enregistrement exporté pas de valeur correspondante s'il n'existe pas de valeur correspondante dans le champ de la clé primaire de Résultats et si le champ correspondant est exporté depuis Analytics, l'enregistrement dans Résultats n'est pas mis à jour et l'enregistrement exporté est concaténé avec la table
Option Écraser sélectionnée	les données exportées remplacent (écrasent) la table Résultats existante	les données exportées remplacent (écrasent) la table Résultats existante

Exportation des exceptions vers Résultats

Indiquer les champs à exporter

1. Ouvrez la table avec les données d'exception que vous souhaitez exporter.
2. Sélectionnez Données > Exporter.
3. Dans l'onglet Principal, sélectionnez l'une des opérations suivantes :
   • Champs indiquez les champs à exporter

     Lors de la sélection de cette option, les champs sont exportés à l'aide des noms de champ physique dans le format de table.

     Pour plus d'informations sur les champs renommés, consultez la rubrique Renommer un champ dans un format de table.

   • Vue exportez tous les champs dans la vue courante

     Lors de la sélection de cette option, les champs sont exportés à l'aide des noms d'affichage des colonnes. Les champs sont exportés dans le même ordre que celui dans lequel ils apparaissent dans la vue.

     Pour plus d'informations sur les champs renommées, consultez la rubrique Renommer les colonnes d'une vue.

4. Si vous avez choisi Champs, effectuez l'une des opérations suivantes :
   • Sélectionnez les champs à exporter dans la liste Exporter les champs.

     Astuce

     Vous pouvez utiliser la combinaison Ctrl+clic pour sélectionner plusieurs champs non adjacents, et Maj+clic pour sélectionner plusieurs champs adjacents.

   • Cliquez sur Exporter les champs pour sélectionner les champs ou créer une expression.

Sélectionner les options d'exportation

1. Dans la liste déroulante Exporter en tant que, sélectionnez HighBond.
2. Effectuez l'une des actions suivantes :
   • Concaténer avec la table Résultats

     Si vous souhaitez concaténer les données exportées avec la table existante de Résultats, laissez l'option Écraser désélectionnée.

     Note

     Des champs Analytics peuvent être ajoutés aux champs Résultats existants seulement s'ils ont des noms de champ physique identiques, indépendamment de leur nom d'affichage dans chaque application. Dans Analytics, le nom de champ physique correspond au nom dans le format de table.

     L'ordre des champs dans les deux applications est sans effet sur la concordance des noms de champ.

     Les champs exportés dont le nom physique ne correspond pas au nom physique d'un autre champ dans la table Résultats créent de nouvelles colonnes dans la table.

   • Remplacer (écraser) la table Résultats

     Si vous souhaitez remplacer la table existante de Résultats, sélectionnez Écraser.

   Pour plus d'informations, consultez la section Option Écraser et clé primaire de Résultats.

3. (Facultatif) Si vous souhaitez exporter les noms d'affichage des colonnes dans Résultats, sélectionnez Inclure le nom d'affichage des champs.

   Lorsque cette option est sélectionnée, le nom de d'affichage des colonnes et le nom physique dans Résultats sont identiques aux noms dans Analytics.

   Si vous ne sélectionnez pas Inclure le nom d'affichage des champs, le résultat varie selon que vous exportez en fonction des champs ou de la vue :

   	Exportation de champs	Exportation de vue
   Inclure le nom d'affichage des champsle	Nom de champ sélectionné dans Résultats est identique au nom de champ dans d'Analytics. Le nom d'affichage dans Résultats et celui dans Analytics sont identiques
   Inclure le nom d'affichage des champs non sélectionné	Le nom de champ et le nom d'affichage dans Résultats sont identiques au nom de champ dans Analytics.	Le nom du champ, le nom d'affichage dans Résultats sont identiques au nom d'affichage dans Analytics.

   Remarque

   Ne sélectionnez pas Inclure le nom d'affichage des champs si vous concaténez une vue avec une table de Résultats initialement créée en exportant une vue d'une version d'Analytics antérieure à la version 14.1. Vous risquez alors d'exporter des colonnes dont les noms de champ diffèrent de ceux de Résultats, ce qui a pour effet de créer de nouvelles colonnes dans Résultats et de provoquer un désalignement des données entre les applications.

Finaliser l'export

1. Si vous souhaitez exclure du traitement certains enregistrements de la vue en cours, saisissez une condition dans la zone de texte Si, ou cliquez sur Si pour créer une instruction IF à l'aide du Générateur d'expression.

   Remarque

   La condition Si est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (Premiers, Suivants, Tant que).

   L'instruction IF prend en compte tous les enregistrements de la vue et exclue ceux qui ne correspondent pas à la condition spécifiée.

2. Effectuez l'une des actions suivantes :

   Si vous connaissez le numéro ID de la table vers laquelle vous effectuez l'exportation :

   Entrez-le dans la zone de texte Vers.

   • Entrez le numéro sans guillemets, par exemple, 99
   • Saisissez uniquement le numéro. N'entrez pas de nom de fichier.
   • Si vous exportez vers un data center ne se trouvant pas en Amérique du nord (USA), vous devez aussi indiquer le code du data center. Le numéro ID du test de contrôle et le code du data center doivent être séparés par un arobase (@), par exemple, 99@eu. Le code du data center indique vers quel serveur régional d'HighBond vous exportez 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 HighBond 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'identification de la table que vous exportez, ou si vous souhaitez créer une nouvelle table :

   1. Cliquez sur À, et dans la boîte de dialogue Sélectionner la Destination Test, allez jusqu'au bon dossier d'analyse.
   2. Effectuez l'une des actions suivantes :
      • Sélectionnez une table existante et cliquez sur OK.
      • Entrez un nom dans le champ Nouvel outil d'analyse de données et cliquez sur Créer.

      Vous revenez à la boîte de dialogue Exporter où le numéro d'ID du test de contrôle et le code du centre de données sont préremplis dans la case À.

3. Cliquez sur l'onglet Plus.

4. Dans le panneau Étendue, sélectionnez l'option appropriée :

   • Tous
   • Premiers
   • Suivants
   • Instruction WHILE
   En savoir plus

   Option d'étendue	Détails
   Tous	(Par défaut) Indique que tous les enregistrements de la vue sont traités.
   Premiers	Entrez un numéro dans la zone de texte. Commence le traitement au niveau du premier enregistrement de la vue et inclut uniquement le nombre d'enregistrements indiqué.
   Suivants	Entrez un numéro dans la zone de texte. Commence le traitement au niveau de l'enregistrement actuellement sélectionné de la vue et inclut uniquement le nombre d'enregistrements indiqué. Vous devez sélectionner le nombre d'enregistrements réel dans la colonne la plus à gauche de la vue, et non pas les données dans la ligne.
   Instruction WHILE	Utilisez une instruction WHILE pour limiter le traitement des enregistrements de la vue à un critère spécifique ou à un ensemble de critères. Saisissez une condition dans la zone de texte Tant que ou cliquez sur Tant que pour créer une instruction WHILE en utilisant le générateur d'expression. Une instruction WHILE permet de traiter les enregistrements de la vue uniquement tant que la condition indiquée est vraie. Dès que la condition est fausse, le traitement s'arrête et aucun autre enregistrement n'est pris en compte. Vous pouvez utiliser l'option Tant que en conjonction avec les options Tous, Premiers ou Suivants. Le traitement des enregistrements s'arrête dès qu'une limite est atteinte.

   Remarque

   Les options Premiers et Suivants font référence soit à l'ordre physique soit à l'ordre d'indexation des enregistrements d'une table. Les options Premiers ou Suivants ignorent tout filtrage ou tri express appliqué à une vue de table. Toutefois, les résultats de sortie des opérations analytiques tiennent compte de tous les filtres appliqués.

   Si un tri express est appliqué à une vue, l'option Suivant se comporte comme l'option Premier.

5. Cliquez sur OK.

   Un indicateur d'avancement s'affiche pendant l'exportation des données d'exception vers Résultats. Lorsque l'opération d'exportation est terminée, le système crée une entrée dans le journal.

Obligation de mot de passe

Mot de passe non obligatoire

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

Mot de passe obligatoire

Vous devez indiquer un mot de passe pour exporter vers Résultats dans les situations suivantes :

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

• vous utilisez un script pour exporter vers Résultats, et vous l'exécutez dans Robots

La valeur du mot de passe obligatoire est un jeton d'accès à HighBond.

Obtenir un jeton d'accès à HighBond

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 à HighBond.

   • Dans l'Éditeur de script, cliquez avec le bouton droit de la souris, puis sélectionnez Insérer > Jeton HighBond.

   La page Gérer des jetons API s'ouvre dans votre navigateur. Il est possible que vous deviez vous connecter d'abord à HighBond.

   L'accès à la page Gérer des jetons API via Analytics est une fonctionnalité d'ordre pratique. Vous pouvez également vous connecter à HighBond et accéder à la page via votre profil utilisateur sans l'aide d'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 votre mot de passe HighBond 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

     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. HighBond 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 votre mot de passe HighBond.

     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 à HighBond 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 section Créer et gérer des jetons d'accès HighBond.