Information de concept

Exportation des données

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

Exportation de données vers l’application Robots dans HighBond

Exporte des données depuis Analytics vers le format de fichier spécifié ou vers l'application Résultats ou Robots dans HighBond.

Remarque

La version 32 bits du moteur de base de données Microsoft Access doit être installée pour que la commande EXPORT puisse fonctionner avec des fichiers Excel utilisant l'ancien format (*.xls) et des fichiers Microsoft Access (*.mdb). Pour plus d'informations, consultez la section Exclure le moteur de base de données Microsoft Access facultatif.

EXPORT {<FIELDS> nom_champ <AS nom_exportation> <...n>|<FIELDS> ALL <EXCLUDE nom_champ <...n>>} <UNICODE> type_exportation <SCHEMA> PASSWORD num TO {nom_fichier|aclgrc_id|highbond_api_url} <OVERWRITE> <IF test> <WHILE test> <{FIRST plage|NEXT plage}> <APPEND> <KEEPTITLE> <SEPARATOR caractère> <QUALIFIER caractère> <WORKSHEET nom_feuille_de_calcul> <DISPLAYNAME>
Nom Description
FIELDS nom_champ AS nom_export <...n> | FIELDS ALL

Champs à exporter.

  • FIELDS nom_champ exporte le(s) champ(s) spécifié(s)

    Séparez les noms des champs par des espaces. Les champs sont exportés dans l'ordre dans lequel vous les indiquez.

    Si nécessaire, vous pouvez inclure un autre nom pour le champ du fichier d'exportation à l'aide de AS nom_export. Entourez nom_export de guillemets.

    Si vous effectuez une exportation vers HighBond Résultats (ACLGRC), il est possible de combiner AS au paramètre DISPLAYNAME. Pour plus d'informations, consultez la rubrique Comment DISPLAYNAME interagit avec AS lors de l'exportation dans HighBond Résultats.

  • FIELDS ALL exporte tous les champs de la table

    Les champs sont exportés dans leur ordre d'apparition dans le format de table.
EXCLUDE nom_champ

optionnel

Valide uniquement dans le cas d'une exportation à l'aide de FIELDS ALL.

Le ou les champs à exclure de la commande. EXCLUDE vous permet de personnaliser FIELDS ALL, en excluant les champs spécifiés.

EXCLUDE doit suivre immédiatement FIELDS ALL. Par exemple :

FIELDS ALL EXCLUDE champ_1 champ_2

UNICODE

optionnel

Disponible dans l'édition Unicode d'Analytics uniquement. S’applique uniquement aux fichiers texte, aux fichiers texte délimités, aux fichiers XML et à la sortie du Presse-papiers Windows. ( ASCII , DELIMITED , XML , CLIPBOARD )

Exporte les données Analytics en appliquant le codage de caractères Unicode UTF-16 Little Endian (petit-boutiste).

  • Indiquez UNICODE si les données que vous exportez contiennent des caractères non pris en charge par le format ASCII (ANSI) étendu
  • Ne spécifiez pas UNICODE si tous les caractères dans les données que vous exportez sont pris en charge par le format ASCII (ANSI) étendu

    Les données exportées sont codées au format ASCII (ANSI) étendu.

    Remarque

    Les caractères non pris en charge sont omis du fichier exporté.

Pour plus d'informations, consultez la section Produits Unicode Diligent.
type_export

Format du fichier de sortie ou destination.

Indiquez l'une des options suivantes :

  • ACCESS – Fichier de base de données Microsoft Access (*.mdb)

    Par défaut, les données sont exportées en tant qu'Unicode.

  • ACLGRC – Résultats HighBond
  • ASCII – Texte brut ASCII (*.txt)
  • CLIPBOARD – Presse-papiers Windows
  • DBASE – Fichier compatible dBASE (*.dbf)
  • DELIMITED – Fichier texte délimité (*.del) ou valeurs séparées par des virgules (*.csv)
  • EXCEL – Fichier Microsoft Excel (*.xls) compatible avec Excel 1997 à 2003
  • HBDATA – Fichier de valeurs séparées par des virgules compressé (*.csv.gz) vers un robot HighBond ou un robot de flux de travail dans l'application Robots HighBond
  • JSON – Fichier JSON (*.json)
  • LOTUS – Fichier Lotus 123
  • WDPF6 – Fichier Wordperfect 6
  • WORD – Fichier MS Word (*.doc)
  • WP – Fichier Wordperfect
  • XLS21 – Fichier Microsoft Excel version 2.1 (*.xls)
  • XLSX – Fichier Microsoft Excel (*.xlsx)

    Par défaut, les données sont exportées au format Unicode.

  • XML – Fichier XML (*.xml)

SCHEMA

optionnel

S'applique uniquement à la sortie de fichier XML. (XML)

Inclure le schéma XML dans le fichier XML exporté. Le schéma XML contient des métadonnées qui décrivent la structure du fichier XML, notamment le type de données des champs.

Vous pouvez valider le fichier par rapport au schéma une fois que le fichier a été exporté.

PASSWORD num

optionnel

S’applique aux applications HighBond uniquement. (ACLGRC, HBDATA)

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 :

PASSWORD num doit être placé directement avant TO ou à la fin de chaîne de caractères de la syntaxe de commande.

La valeur du mot de passe obligatoire est un jeton d'accès à HighBond. Pour plus d'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 HighBond de l'utilisateur actuel stocké dans son registre Windows est utilisé automatiquement
Analytics

(activation hors ligne)

Le numéro de PASSWORD est obligatoire.
Robots
TO nom_fichier

Pour les exportations vers un fichier, le nom du fichier.

Si besoin, vous pouvez inclure un chemin d'accès absolu ou relatif, mais le dossier Windows doit exister. Vous devez indiquer la valeur nom_fichier sous forme de chaîne entre guillemets.

Remarque

Pour exporter vers un fichier dont les valeurs sont séparées par des virgules (*.csv), vous devez spécifier l'extension de fichier .csv dans le nom_fichier. Par exemple : vendors.csv.

TO aclgrc_id

Pour les exportations vers l'application Résultats HighBond, la destination est Résultats. (ACLGRC)

La valeur aclgrc_id doit inclure le numéro d'ID du test de contrôle Résultats et, si vous effectuez votre exportation vers un data center qui n'est pas en Amérique du Nord, cette valeur doit inclure le code du data center. La valeur aclgrc_id doit être entourée de guillemets.

Le numéro ID du test de contrôle et le code du centre de données doivent être séparés par une arobase (@). Par exemple, TO "99@eu".

Si vous ne connaissez pas le numéro d'ID du test de contrôle, utilisez l'interface utilisateur d'Analytics pour commencer une exportation dans Résultats. Annulez l'exportation après avoir identifié le numéro d'ID du test de contrôle. Pour plus d'informations, consultez la section Exportation des exceptions vers l’application Résultats dans HighBond.

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.

TO highbond_api_url

Pour les exportations vers l'application Robots HighBond, la destination est Robots. (HBDATA)

Remarque

Vous ne pouvez pas exporter vers un robot ACL. Vous devez exporter vers un robot HighBond ou un robot de flux de travail.

La valeur highbond_api_url correspond à l'URL de requête d'API HighBond pour le robot de destination. L'exemple ci-dessous exporte un fichier *.csv.gz vers cette destination :

  • robot avec le numéro ID 52053

  • dans l'organisation HighBond avec le numéro ID 1000236

  • dans le data center HighBond d'Amérique du Nord (États-Unis)

TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development"

Utilisez le paramètre de chaîne de requête env pour indiquer si le fichier est exporté vers le mode développement ou le mode de production dans le robot :

Mode développement

(par défaut)

  • ?env=development

ou

  • aucune chaîne de requête spécifiée
Mode de production

  • ?env=production

OVERWRITE

optionnel

S’applique aux applications HighBond uniquement. (ACLGRC, HBDATA)

  • OVERWRITE spécifié Les données exportées écrasent les données existantes lors du test de contrôle de la cible (table) ou le robot. Vous devez avoir un rôle de responsable professionnel dans la collection cible pour écraser des données.

  • OVERWRITE omis Les données exportées sont concaténées avec les données existantes lors du test de contrôle de la cible (table). Pour plus d'informations, consultez la section Exportation dans HighBond Résultats.

    La concaténation n'est pas prise en charge pour les fichiers *.csv.gz dans Robots.

Les interprétations associées au test de contrôle cible (table) s'actualisent de manière dynamique pour refléter les données importées, qu'il s'agisse d'un écrasement ou d'un ajout.
IF test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée uniquement sur les enregistrements remplissant la condition.

Remarque

La condition IF est évaluée uniquement par rapport aux enregistrements restant dans une table après application des options relevant du champ d'application (WHILE, FIRST, NEXT).
WHILE test

optionnel

Expression conditionnelle qui doit être vraie afin de traiter chaque enregistrement. La commande est exécutée jusqu'à ce que la condition soit évaluée comme fausse ou lorsque la fin de la table est atteinte.

Remarque

Si vous utilisez WHILE conjointement avec FIRST ou NEXT, le traitement des enregistrements s'arrête dès qu'une limite est atteinte.
FIRST plage | NEXT plage

optionnel

Le nombre d'enregistrements à traiter :

  • FIRST pour commencer le traitement à partir du premier enregistrement jusqu'à ce que le nombre d'enregistrements spécifié soit atteint
  • NEXT pour commencer le traitement à partir de l'enregistrement actuellement sélectionné jusqu'à ce que le nombre d'enregistrements spécifié soit atteint

Utilisez plage pour indiquer le nombre d'enregistrements à traiter.

Si vous ignorez FIRST et NEXT, tous les enregistrements sont traités par défaut.

APPEND

optionnel

S’applique uniquement aux fichiers texte et fichiers texte délimités. (ASCII, DELIMITED)

Ajoute la sortie de commande à la fin d'un fichier existant au lieu de remplacer ce fichier.

Remarque

Vous devez vous assurer que la structure de la sortie de la commande et du fichier existant est identique :

  • les mêmes champs
  • le même ordre des champs
  • les champs correspondants ont la même longueur
  • les champs correspondants ont le même type de données

Analytics ajoute la sortie à un fichier existant sans tenir compte de sa structure, ce qui peut désordonner les données si la structure de la sortie et du fichier existant ne correspond pas.

KEEPTITLE

optionnel

S’applique uniquement aux fichiers texte, ainsi qu’aux fichiers texte délimités et de valeurs séparées par des virgules. (ASCII, DELIMITED)

Inclure les noms des champs Analytics avec les données exportées. Si vous ignorez ce paramètre, aucun nom de champ n'apparaît dans le fichier de sortie.

SEPARATOR caractère

optionnel

S’applique uniquement aux fichiers texte délimités et de valeurs séparées par des virgules. (DELIMITED)

Caractère à utiliser comme séparateur de champs. Vous devez indiquer le caractère sous forme de chaîne entre guillemets.

Par défaut, Analytics utilise une virgule. Ne spécifiez pas d'autre caractère qu'une virgule si vous exportez vers un fichier de valeurs séparées par des virgules.

QUALIFIER caractère

optionnel

S’applique uniquement aux fichiers texte délimités et de valeurs séparées par des virgules. (DELIMITED)

Caractère à utiliser en tant qu'identificateur de texte pour renvoyer à la ligne et identifier des valeurs de champs. Vous devez indiquer le caractère sous forme de chaîne entre guillemets.

Par défaut, Analytics utilise des guillemets doubles.

WORKSHEET nom_feuille_de_calcul

optionnel

S’applique uniquement aux fichiers Microsoft Excel *.xlsx. (XLSX)

Nom de la feuille de calcul Excel créée dans un nouveau fichier Excel ou dans un fichier Excel existant. Spécifiez 31 caractères au maximum.

Par défaut, Analytics utilise le nom de la table Analytics que vous êtes en train d'exporter comme nom de la feuille de calcul. Les noms dont la longueur dépasse les 31 caractères sont tronqués.

nom_feuille_de_calcul peut contenir uniquement des caractères alphanumériques ou le caractère de soulignement ( _ ). Le nom ne peut pas contenir de caractères spéciaux ni d'espaces et il ne peut pas commencer par un chiffre. Il n'est pas obligatoire de placer la valeur entre guillemets.

Pour plus d'informations sur l'écrasement de classeurs et de feuilles de calcul Excel lors de l'exportation, consultez la rubrique Paramètre WORKSHEET et écrasement.

DISPLAYNAME

optionnel

S'applique à HighBond Résultats uniquement. (ACLGRC)

Exporte les noms des champs sous forme de noms de champs et exporte les noms d'affichage sous forme de noms d'affichage. Ainsi, les noms d'affichage apparaissent dans les en-têtes des colonnes dans Résultats sans incidence sur le nom de champ réel.

Il est possible de combiner DISPLAYNAME à AS. Pour plus d'informations, consultez la section Comment DISPLAYNAME interagit avec AS lors de l'exportation dans HighBond Résultats.

Exemples Excel

Exemples de fichier délimité

Exemple de fichier CSV (valeurs séparées par des virgules)

Exemple de l'application Résultats

Exemples de l'application Robots

Exemples Excel

Exportation de données vers un fichier Excel .xlsx

Vous exportez des champs spécifiques à partir de la table Fournisseur vers un fichier Excel *.xlsx :

OPEN Fournisseur
EXPORT FIELDS No_Fournisseur Nom_Fournisseur Ville_Fournisseur XLSX TO "ExportFournisseur"

Exportation de données vers un fichier Excel .xlsx et choix d'un nom de feuille de calcul

Vous exportez des champs spécifiques de la table Fournisseur vers une feuille de calcul nommée Fournisseurs_États-Unis dans un fichier Excel *.xlsx :

OPEN Fournisseur
EXPORT FIELDS No_Fournisseur Nom_Fournisseur Ville_Fournisseur XLSX TO "ExportFournisseur" WORKSHEET Fournisseurs_États-Unis

Exemples de fichier délimité

Exportation de tous les champs vers un fichier délimité

Vous exportez tous les champs à partir de la table Fournisseur vers un fichier délimité :

OPEN Fournisseur
EXPORT FIELDS ALL DELIMITED TO "ExportFournisseur"

Exportation d'un sous-ensemble de champs vers un fichier délimité

Deux options s'offrent à vous lorsque vous exportez un sous-ensemble de champs d'un tableau vers un fichier externe :

  • indiquer les champs individuels à exporter
  • indiquer FIELDS ALL et indiquer les champs à exclure de l'exportation

Astuce

Utilisez la méthode qui demande le moins de main-d’œuvre.

Les exemples ci-dessous renvoient à la table Fournisseur qui comporte 8 champs :

  • numéro fournisseur
  • nom du fournisseur
  • rue du fournisseur
  • ville du fournisseur
  • état du fournisseur
  • code postal du fournisseur
  • dernière date active
  • date de l'examen

Indiquer les champs à exporter

Vous exportez deux champs à partir de la table Fournisseur vers un fichier délimité :

OPEN Fournisseur
EXPORT FIELDS Num_Fournisseur Nom_Fournisseur DELIMITED TO "Fournisseurs" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

Indiquer FIELDS ALL et indiquer les champs à exclure

Vous exportez tous les champs à l'exception des champs Dernière date active et Date de l'examen à partir de la table Fournisseur vers un fichier délimité :

OPEN Fournisseur
EXPORT FIELDS ALL EXCLUDE Fournisseur_Dernière_active Fournisseur_Date_Examen DELIMITED TO "Adresses_fournisseur" KEEPTITLE SEPARATOR "|" QUALIFIER '"'

Exportation de données vers plusieurs fichiers délimités à l'aide de GROUP

Vous exportez des champs spécifiques à partir de la table Fournisseur vers deux fichiers délimités :

  • un fichier pour les noms des fournisseurs de « A » à « M »
  • un fichier pour les noms des fournisseurs de « N » à « Z »

À l'aide de la commande GROUP, vous testez le nom du fournisseur de chaque enregistrement avec une condition IF :

GROUP
  EXPORT FIELDS No_Fournisseur Nom_Fournisseur DELIMITED TO "AàM" IF BETWEEN(UPPER(Nom_Fournisseur); "A"; "M")
  EXPORT FIELDS No_Fournisseur Nom_Fournisseur DELIMITED TO "NàZ" IF BETWEEN(UPPER(Nom_Fournisseur); "N"; "Z")
END

Exemple de fichier CSV (valeurs séparées par des virgules)

Exporter tous les champs vers un fichier de valeurs séparées par des virgules

Vous exportez tous les champs à partir de la table Fournisseur vers un fichier de valeurs séparées par des virgules :

OPEN Fournisseur
EXPORT FIELDS ALL DELIMITED TO "VendorExport.csv"

Exemple de l'application Résultats

Exporter des données vers l'application Résultats dans HighBond

Indiquer les champs à exporter

Vous exportez des champs spécifiques de la table Exceptions_Ar vers HighBond Résultats. Vous écrasez les données existante dans le test de contrôle cible (table) :

OPEN Exceptions_Ar
EXPORT FIELDS Aucune date d’échéance Réf Montant Type ACLGRC PASSWORD TO "10926@us" OVERWRITE

Créer une définition de mot de passe requise pour exécuter la commande dans Robots

Vous créez une définition de mot de passe en deux parties avec une balise d’analyse PASSWORD et un paramètre PASSWORD correspondant dans la commande EXPORT.

La balise d’analyse //PASSWORD 1 crée un paramètre d’entrée de mot de passe dans une tâche du robot. Le paramètre PASSWORD 1 correspondant dans la commande EXPORT fait référence à la valeur du mot de passe stocké et crypté dans la tâche. Le mot de passe obligatoire est un jeton d'accès à HighBond valide. Pour plus d'informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

COMMENT
//ANALYTIC Exporter des données et Résultats
//PASSWORD 1 jeton d’accès HighBond :
//RESULT LOG
END

OPEN Exceptions_Ar
EXPORT FIELDS Aucune date d’échéance Réf Montant Type ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE

Exemples de l'application Robots

Exporter des données vers l'application Robots dans HighBond

Remarque

Vous ne pouvez pas exporter vers un robot ACL. Vous devez exporter vers un robot HighBond ou un robot de flux de travail.

Pour plus d’informations sur la manière d’accéder aux données après les avoir exportées vers Robots, reportez-vous à la méthode load_working_file().

Indiquer les champs à exporter

Vous exportez des champs spécifiques à partir de la table Trans_May vers un fichier compressé CSV (*.csv) dans Robots HighBond. Si un fichier portant le même nom existe déjà dans le robot 52053 en mode développement, il est remplacé :

OPEN Trans_May
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Créer une définition de mot de passe requise pour exécuter la commande dans Robots

Vous créez une définition de mot de passe en deux parties avec une balise d’analyse PASSWORD et un paramètre PASSWORD correspondant dans la commande EXPORT.

La balise d’analyse //PASSWORD 1 crée un paramètre d’entrée de mot de passe dans une tâche du robot. Le paramètre PASSWORD 1 correspondant dans la commande EXPORT fait référence à la valeur du mot de passe stocké et crypté dans la tâche. Le mot de passe obligatoire est un jeton d'accès à HighBond valide. Pour plus d'informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

COMMENT
//ANALYTIC Exporter des données d’analyse et Robots
//PASSWORD 1 jeton d’accès HighBond :
//RESULT LOG
END

OPEN Trans_May
EXPORT FIELDS CARDNUM AS 'CARDNUM' CODES AS 'CODES' DATE AS 'DATE' CUSTNO AS 'CUSTNO' DESCRIPTION AS 'DESCRIPTION' AMOUNT AS 'AMOUNT' HBDATA PASSWORD 1 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Exporter tous les champs

Vous exportez tous les champs à partir de la table Trans_May vers un fichier CSV compressé (*.csv) dans Robots HighBond :

OPEN Trans_May
EXPORT FIELDS ALL HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Indiquer FIELDS ALL et indiquer les champs à exclure

Vous exportez tous les champs à l’exception des champs Dernière date active et Date de l’examen à partir de la table Fournisseur vers un fichier CSV compressé (*.csv) dans Robots HighBond :

OPEN Fournisseur
EXPORT FIELDS ALL EXCLUDE Vendor_Last_Active Vendor_Review_Date HBDATA PASSWORD 3 TO "https://apis-us.highbond.com/v1/orgs/1000236/robots/52053/working_files?env=development" OVERWRITE

Utilisation d'EXPORT avec la commande GROUP

Avec la plupart des formats d'exportation, vous pouvez exporter les données simultanément vers plusieurs fichiers à l'aide de la commande GROUP.

Un seul fichier peut être créé à la fois lorsque vous exportez des données vers Microsoft Excel et Microsoft Access.

Export vers Excel

Les limitations suivantes s'appliquent lors de l'exportation de données vers un fichier Excel.

Limite Détails
Nombre d'enregistrements
  • Excel 2007 et versions ultérieures (.xlsx) 1 048 576 enregistrements au maximum par 16 384 champs (taille maximale de feuille de calcul prise en charge par Excel)
  • Excel 97 et 2003 un maximum de 65 536 enregistrements

Les tables Analytics qui dépassent ces valeurs maximales sont exportées, mais les enregistrements en excès sont ignorés et ne sont pas exportés.
Longueur des champs
  • aucune limite de longueur pour un champ spécifique
  • les longueurs des champs spécifiques ne peuvent dépasser la limite de longueur globale des enregistrements qui est de 32 Ko

    (32 765 caractères dans Analytics non-Unicode, 16 382 caractères dans Analytics Unicode)

  • dans le cas d'Excel 2.1, un maximum de 247 caractères
Longueur des noms des champs
  • un maximum de 64 caractères
  • dans le cas d'Excel 2.1, un maximum de 248 caractères
Longueur des noms de feuilles de calcul
  • 31 caractères au maximum

Si vous utilisez un nom de table Analytics comme nom de feuille de calcul, le nom est tronqué lorsqu'il est exporté vers Excel s'il dépasse 31 caractères.

Paramètre WORKSHEET et écrasement

Le résultat de l'utilisation ou non du paramètre WORKSHEET lors de l'exportation à partir d'une table Analytics vers un fichier Excel est expliqué ci-dessous :

Correspondance

Description

 Paramètre WORKSHEET utilisé Paramètre WORKSHEET non utilisé
Aucun nom de fichier Excel correspondant
  • TO  nomdefichier la valeur ne correspond à aucun nom de fichier Excel existant
 Un nouveau fichier Excel est créé, avec une feuille de calcul portant le nom spécifié Un nouveau fichier Excel est créé, avec une feuille de calcul utilisant le nom de la table Analytics exportée

Nom de fichier Excel correspondant

Aucun
  • TO  nomdefichier la valeur, et un nom de fichier Excel existant, sont identiques
  • WORKSHEET nom_feuilledecalcul ne correspond à aucun nom de feuille de calcul dans le fichier Excel
 Une feuille de calcul avec le nom spécifié est ajoutée au fichier Excel existant Le fichier Excel existant est écrasé par un nouveau fichier Excel, comportant une feuille de calcul qui utilise le nom de la table Analytics exportée
Nom de fichier Excel et nom de feuille de calcul correspondants
  • TO  nomdefichier la valeur, et un nom de fichier Excel existant, sont identiques
  • WORKSHEET nom_feuilledecalcul correspond à un nom de feuille de calcul dans le fichier Excel

Une feuille de calcul portant le nom spécifié écrase la feuille de calcul existante si elle a été créée dans Analytics à l'origine.

Un message d'erreur s'affiche et l'opération d'exportation est annulée si la feuille de calcul existante a été créée directement dans Excel à l'origine.

 Le fichier Excel existant est écrasé par un nouveau fichier Excel, comportant une feuille de calcul qui utilise le nom de la table Analytics exportée

Exportation dans HighBond Résultats

Le tableau ci-dessous contient des informations supplémentaires sur l'exportation dans un test de contrôle dans Résultats.

Élément

Détails

Autorisations requises

La fonctionnalité permettant d'exporter les résultats dans 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 exporter et écraser les données existantes dans un test de contrôle.

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

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

Limites d'exportation

Les limites suivantes s'appliquent lors de l'exportation vers un test de contrôle :

  • 100 000 enregistrements maximum par exportation
  • 100 000 enregistrements maximum par test de contrôle
  • 500 champs maximum par enregistrement
  • 256 caractères maximum par champ

Vous pouvez lancer plusieurs exportations vers un même test de contrôle, mais vous ne devez pas sortir de ces limites générales.

Ajout de champs

(OVERWRITE non spécifié)

Indépendamment de leur ordre dans une table Analytics, les champs exportés sont ajoutés aux champs existants dans un test de contrôle si leurs noms de champs physiques correspondent.

Dans Analytics, le nom de champ physique correspond au nom dans le format de table. Les champs exportés dont le nom ne correspond pas à celui des champs existants s'ajoutent sous forme de colonnes supplémentaires à la table dans Résultats.

Les noms d'affichage pour les champs dans Analytics et dans Résultats ne sont pas pris en compte. Toutefois, si vous utilisez le paramètre AS nom_export optionnel, la valeur nom_export est utilisée comme nom de champ physique si vous n'utilisez pas DISPLAYNAME.

Lorsque vous concaténez des données aux champs du questionnaire, le nom d'affichage de la colonne dans Résultats reste le nom spécifié dans la configuration du questionnaire.

La concaténation fonctionne différemment si le champ de clé primaire du test de contrôle de la cible est spécifié. Pour plus d'informations, consultez la section Exportation des exceptions vers l’application Résultats dans HighBond.

Remarque

Si vous bouclez les données entre Résultats et Analytics, et que les données apparaissent mal alignées dans Résultats, c'est que vous n'avez probablement pas fait correspondre les noms des champs.

Pour plus d'informations, consultez la section Considérations générales sur les noms des champs lors de l'importation et de l'exportation des données de Résultats.

Obligation de mot de passe

Consultez la rubriqueCréation d'une définition de mot de passe et spécification d'une valeur de mot de passe.

Comment DISPLAYNAME interagit avec AS lors de l'exportation dans HighBond Résultats

La matrice ci-dessous illustre comment le paramètre DISPLAYNAME interagit avec AS lors de l'exportation des noms des champs d'Analytics vers Résultats.

  Sans AS Avec AS
Sans DISPLAYNAME Le nom du champ et le nom d'affichage dans Résultats sont identiques au nom du champ dans Analytics. Le nom du champ et le nom d'affichage dans Résultats sont identiques au nom d'affichage dans le paramètre AS.
Avec DISPLAYNAME Le nom du champ dans Résultats et celui dans Analytics sont identiques. Le nom d'affichage dans Résultats et celui dans Analytics sont identiques Le nom du champ dans Résultats et celui dans Analytics sont identiques. Le nom d'affichage dans Résultats est identique au nom d'affichage dans le paramètre AS.

Autorisations requises pour effectuer une exportation vers HighBond Robots

Pour pouvoir télécharger un fichier CSV compressé (*.csv.gz) vers l'application Robots, vous devez être doté d'un rôle Robots spécifique ou de privilèges d'administration :

  • Les utilisateurs dotés d'un rôle Éditeur ou Propriétaire peuvent télécharger un fichier CSV compressé vers le robot. Les utilisateurs dotés du rôle Examinateur ne le peuvent pas.

  • Les administrateurs Robots sont automatiquement désignés comme collaborateurs pour chaque robot, avec le rôle Propriétaire.

  • Un administrateur système HighBond qui dispose d'un abonnement professionnel est automatiquement un administrateur Robots.

Pour plus d'informations, consultez la rubrique Permissions de l'application Robots.

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 exporte des données vers l’application Résultats ou charge un fichier CSV compressé (*.csv) vers l’application Robots, vous devez inclure une définition de mot de passe avec la commande EXPORT. 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 à HighBond, que vous pouvez générer dans Barre de lancement. Pour plus d'informations, consultez la section Obtenir un jeton d'accès à HighBond.

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

Attention

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

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

    • Commande SET PASSWORD Dans Analytics, 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.