Commande EXPORT

Information de Concept

Exportation des données

Exportation des exceptions vers l'application Résultats dans Diligent One

Exportation de données vers l'application Robots dans Diligent One

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

Note

Vous devez avoir installé Microsoft 365 Access Runtime (32 bits) pour que la commande EXPORT puisse fonctionner avec des fichiers Excel utilisant l’ancien format (*.xls) et des fichiers Microsoft Access (*.mdb). Pour de plus amples informations, consultez la section Utilisation d'anciens fichiers Excel (*.xls) ou Access (*.mdb)..

Syntaxe

EXPORT {<FIELDS> nom_champ <AS nom_exportation> <...n>|<FIELDS> ALL <EXCLUDE nom_champ <...n>>} <UNICODE> type_exportation <SCHEMA> PASSWORD num TO {nom_fichier|id_aclgrc|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>

Paramètres

Nom Description
FIELDS nom_champ AS nom_export <...n> | FIELDS ALL

Champs à exporter.

  • FIELDS nom_champExporte le(s) champ(s) spécifié(s)

    Séparer 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 Diligent One Résultats (ACLGRC), il est possible de combiner AS au paramètre DISPLAYNAME. Pour de plus amples informations, reportez-vous à la section Comment DISPLAYNAME interagit avec AS lors de l'exportation dans Diligent One Résultats.

  • FIELDS ALLExportez tous les champs de la table

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

facultatif

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 le mot-clé ALL, en excluant les champs spécifiés.

EXCLUDE doit suivre immédiatement FIELDS ALL, ou la dernière occurrence du mot-clé ALL si vous incluez des champs d'une ou de plusieurs tables associées. Par exemple :

FIELDS ALL EXCLUDE champ_1 champ_2
FIELDS ALL nom_table_associée.ALL EXCLUDE champ_1 champ_2

UNICODE

facultatif

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 UNICODESi les données que vous exportez contiennent des caractères non pris en charge par le format ASCII (ANSI) étendu
  • Ne spécifiez pas UNICODESi 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.

    Note

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

Pour de plus amples 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 au format Unicode.

  • ACLGRC – Diligent One Résultats
  • 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 Diligent One
  • 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

facultatif

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

facultatif

S’applique aux applications Diligent One 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 à Jeton d’accès Diligent One One. Pour de plus amples 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 Jeton d’accès Diligent One One 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.

Note

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 Diligent One, la destination est Résultats. (ACLGRC)

La valeur id_aclgrc 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 id_aclgrc 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 l'application Résultats dans Diligent One.

Le code du data center indique vers quel serveur régional de Diligent One One 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 Diligent One 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 Résultats Diligent One, la destination est Résultats. (HBDATA)

Note

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

La valeur highbond_api_url correspond à l'URL de requête d'API 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 Diligent One One avec le numéro ID 1000236

  • dans le data center Diligent One One 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 production

  • ?env=production

OVERWRITE

facultatif

S’applique aux applications Diligent One 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 omisLes données exportées sont concaténées avec les données existantes lors du test de contrôle de la cible (table). Pour obtenir plus d'informations, consultez la section Exportation dans Diligent One 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

facultatif

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

Note

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

facultatif

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.

Note

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

facultatif

Le nombre d'enregistrements à traiter :

  • FIRSTPour commencer le traitement à partir du premier enregistrement jusqu’à ce que le nombre d’enregistrements spécifié soit atteint
  • NEXTPour 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

facultatif

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.

Note

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

facultatif

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

facultatif

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

facultatif

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

facultatif

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

facultatif

S'applique uniquement à Diligent One One Résultats. (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 de plus amples informations, reportez-vous à la section Comment DISPLAYNAME interagit avec AS lors de l'exportation dans Diligent One Résultats.

Exemples

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 :

GROUPE
  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 "ExportFournisseur.csv"

Exemple de l'application Résultats

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

Indiquer les champs à exporter

Vous exportez des champs spécifiques de la table Exceptions_Ar vers Diligent One One 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 valide à Jeton d’accès Diligent One One. Pour de plus amples informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

COMMENTAIRE
//ANALYTIC Exporter des données et Résultats
//PASSWORD 1 Jeton d’accès Jeton d’accès Diligent One One :
//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 Diligent One

Note

Vous ne pouvez pas exporter vers un robot ACL. Vous devez exporter vers un robot 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_Mai vers un fichier CSV compressé (*.csv.gz) dans Diligent One Robots. Si un fichier portant le même nom existe déjà dans le robot 52053 en mode développement, il est remplacé :

OPEN Trans_Mai
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 valide à Jeton d’accès Diligent One One. Pour de plus amples informations, consultez la section Création d'une définition de mot de passe et spécification d'une valeur de mot de passe.

COMMENTAIRE
//ANALYTIC Exporter des données d'analyse et Robots
//PASSWORD 1 Jeton d’accès Jeton d’accès Diligent One One :
//RESULT LOG
END

OPEN Trans_Mai
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_Mai vers un fichier CSV compressé (*.csv.gz) dans Diligent One Robots :

OPEN Trans_Mai
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 (*.csv.gz) compressé dans Diligent One Robots :

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

Remarques

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 2003Un 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 Diligent One 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 Diligent One spécifique ou des privilèges d'administateur :

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

    Note

    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'Diligent One et les administrateurs de Résultats reçoivent automatiquement le rôle de responsable professionnel dans toutes les collections des organisations Admins système 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 qui ne correspondent pas au nom d'un champ existant sont ajoutés 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 export_name optionnel, la valeur export_name 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 l'application Résultats dans Diligent One.

Note

Si vous bouclez les données entre Résultats et Résultats, 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 de plus amples informations, consultez 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 section Cré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 Diligent One 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 Résultats. 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 Résultats sont identiques. Le nom d'affichage dans Résultats et celui dans Résultats sont identiques Le nom du champ dans Résultats et celui dans Résultats 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 Diligent One One Robots

Pour pouvoir télécharger un fichier CSV (*.csv.gz) compressé 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 de Admins Robots sont automatiquement désignés comme collaborateurs pour chaque robot, avec le rôle Propriétaire.

  • Un Admin système de Diligent One qui dispose d'un abonnement professionnel est automatiquement un Admin 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 (*.csv.gz) compressé 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 à Jeton d’accès Diligent One One, que vous pouvez générer dans Barre de lancement. Pour de plus amples informations, consultez la section Obtenir un jeton d’accès Jeton d’accès Diligent One One.

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 à Diligent One, 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 afin de créer la définition de mot de passe numéroté pour la connexion à Diligent One One, 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 rubrique Commande PASSWORD.

Commande SET PASSWORD

(Pour les scripts exécutés dans Analytics, activation hors ligne)

Si vous utilisez la commande SET PASSWORD pour créer la définition de mot de passe numéroté pour la connexion à Diligent One One, 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 Jeton d’accès Diligent One One

Attention

Le jeton d'accès généré correspond au compte utilisé pour se connecter à la Barre de lancement. 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 Analytics, sélectionnez Outils > Jeton d’accès Diligent One.

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

    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.

    L'accès à la page Gérer des jetons API via Analytics est une fonctionnalité d'ordre pratique. Vous pouvez également vous connecter à Diligent One 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 Diligent One 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éLe jeton expire au bout du nombre de jours que vous avez spécifié
        • DésactivéLe jeton n’expire pas

        Note

        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. Diligent One 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 le mot de passe de votre compte Diligent One One.

      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 PASSWORDDans le Concepteur de tâches d’un robot ACL, collez le jeton copié dans un champ de paramètre de mot de passeRobot ACL robot

    • Commande PASSWORDDans Analytics, collez le jeton copié dans l’invite de mot de passe qui apparaît lors de l’exécution du script.

    • Commande SET PASSWORDDans Analytics, collez le jeton à 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 de plus amples informations, consultez la section Créer et gérer Jetons d’accès Diligent One.