Commande EXPORT

Champs à exporter.

• nom_champ exportez le(s) champ(s) spécifié(s)

  Séparez les noms des champs par des espaces.

  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.

• ALL exportez tous les champs de la table

UNICODE

optionnel

Disponible dans l'édition Unicode d'Analytics uniquement. S'applique uniquement aux fichiers texte (ASCII), aux fichiers texte délimités (DELIMITED), et aux fichiers XML ainsi qu'à la sortie du Presse-papiers Windows (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 rubrique Produits Galvanize Unicode.

Format de fichier de sortie ou destination à l'aide de l'une des options suivantes :

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

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

• ACLGRC HighBond Résultats
• ASCII Texte brut ASCII (.txt)
• CLIPBOARD Presse-papiers Windows
• DBASE Fichier compatible dBASE (.dbf)
• DELIMITED fichier texte délimité (.del) ou de valeurs séparées par des virgules (.csv)
• EXCEL Fichier Microsoft Excel (.xls) compatible avec Excel 1997 à 2003
• JSON Fichier JSON (.json)
• LOTUS Fichiers Lotus 123
• WDPF6 Fichier Wordperfect 6
• WORD Fichier MS Word (.doc)
• WP Fichier Wordperfect
• XLS21 Fichier Microsoft Excel version 2.1
• XLSX Fichier Microsoft Excel .xlsx

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

• XML Fichier XML (.xml)

optionnel

S'applique uniquement à la sortie de fichier 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é.

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

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

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 Exportation dans HighBond Résultats.

Destination de l'exportation :

• TO nom_fichier exporter les données dans un fichier

  Si besoin, vous pouvez inclure un chemin d'accès absolu ou relatif, mais le dossier Windows doit déjà 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 de fichier. Par exemple : vendors.csv

  .
• TO aclgrc_id exporter des données vers HighBond Résultats

  La valeur aclgrc_id doit inclure le numéro d'ID du test de contrôle, 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 obtenir plus d'informations, consultez la section Exportation des exceptions vers HighBond Résultats.

  Le code du data center indique vers quel serveur régional d'HighBond vous exportez les données :

  • ap : Asie-Pacifique
  • au : Australie
  • ca : Canada
  • eu : Europe
  • us : Amérique du Nord

  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 est le data center par défaut, vous n'êtes donc pas obligé d'indiquer "@us".

optionnel

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

• OVERWRITE spécifié Les données exportées écrasent les données existantes lors du test de contrôle de la cible (table). 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.

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.

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.

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.

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.

optionnel

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

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

optionnel

S'applique uniquement aux fichiers texte (ASCII) ainsi qu'aux fichiers texte délimités et de valeurs séparées par des virgules (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 et aux fichiers 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 et aux fichiers 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).

Nom de la feuille de calcul Excel créée dans un nouveau fichier Excel ou dans un fichier Excel existant.

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.

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 (ACLGRC) uniquement.

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.

• Excel 2007 et versions suivantes (*.xlsx)un maximum de 1 048 576 enregistrements
• 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.

• 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

• un maximum de 64 caractères
• dans le cas d'Excel 2.1, un maximum de 248 caractères

• TO  nomdefichier la valeur ne correspond à aucun nom de fichier Excel existant

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

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

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.

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 facultatif, 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 obtenir plus d'informations, consultez la section Exportation des exceptions vers HighBond Résultats.

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.

Obtenir un 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, que les utilisateurs peuvent générer dans Barre de lancement.

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 se peut que vous deviez d'abord vous connecter à la Barre de lancement.

2. Effectuez l'une des actions suivantes :
   • Utiliser un jeton existant Dans la colonne Jeton, cliquez sur le jeton partiellement masqué que vous souhaitez utiliser et saisissez le mot de passe de votre compte HighBond. Le jeton démasqué s'affiche.

     Astuce

     Utilisez un jeton 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.

   • Créer un nouveau jeton Cliquez sur Créer un jeton > Analytics puis saisissez votre mot de passe de compte HighBond.

     Un nouveau jeton Analytics est créé.

     Remarque

     Si vous êtes Administrateur système de la Barre de lancement, vous avez également la possibilité de créer un jeton API. Vous devez réserver des jetons API pour l'objet prévu, qui est l'accès par programmation à la plateforme HighBond.

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.

4. Dans Analytics, effectuez l'une des opérations suivantes :
   • collez le jeton dans l'invite du mot de passe
   • collez le jeton à l'endroit approprié dans la syntaxe de la commande SET PASSWORD dans un script
5. Dans la Barre de lancement, fermez la boîte de dialogue 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.