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 ACLGRC (HighBond), 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 ACL 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 Résultats dans HighBond
• ASCII Texte brut ASCII (.txt)
• CLIPBOARD Presse-papiers Windows
• DBASE Fichier compatible dBASE (.dbf)
• DELIMITED Fichier texte délimité (.del)
• 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é.

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

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

  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 à l'exportation vers HighBond Résultats uniquement.

Des données existantes dans le test de contrôle cible (table) sont écrasées par les données exportées. Vous devez avoir un rôle de Responsable professionnel dans la collection cible pour écraser des données.

Si vous omettez OVERWRITE et que les données existent déjà dans le test de contrôle cible (table), les données exportées sont ajoutées aux données existantes. Pour plus d'informations sur l'ajout dans Résultats, consultez les « Remarques » ci-dessous.

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) et fichiers texte délimités (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 (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.

QUALIFIER caractère

optionnel

S'applique uniquement aux fichiers texte délimités (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 à ACLGRC (HighBond) 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

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.

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.