Commande SET
Définit une option Analytics configurable.
Remarque
La commande SET définit une option Analytics pour la durée de la session Analytics uniquement. Ce comportement s'applique que vous utilisiez la commande SET dans la ligne de commande d'Analytics ou dans un script Analytics.
Pour définir les options ACL afin qu'elles soient conservées entre différentes sessions Analytics, vous devez utiliser la boîte de dialogue Options. Seul un sous-ensemble d’options est disponible dans la boîte de dialogue Options. Pour plus d'informations, consultez la section Configurer les options d'Analytics.
Syntaxe
Syntaxe |
Exemples et remarques |
||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SET BEEP 2 Paramètre par défaut : 0 Indique le nombre de bips émis lorsque le traitement de la commande est terminé. Le paramètre valeur doit être compris entre 0 et 255. Si vous spécifiez 0, le signal sonore est désactivé. Boîte de dialogue Options :Options d'interface |
|||||||||||||||||||||||||||||||||||||||||
SET CENTURY 40 Paramètre par défaut : 40 Indique l'année de début du siècle pour les années à deux chiffres. Le paramètre valeur doit être entre 0 et 99. La définition de la valeur de début de siècle à 40 signifie que les années à deux chiffres 40 à 99 sont interprétées comme 1940 à 1999, et que les années à deux chiffres 00 à 39 sont interprétées comme 2000 à 2039. Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET CLEAN ON Lorsque cette option est activée, Analytics remplace les données de type caractère non valides par des espaces et les données numériques non valides par des zéros. |
|||||||||||||||||||||||||||||||||||||||||
SET DATE "AAAA/MM/JJ" Paramètre par défaut : MM/JJ/AAAA Spécifie le format d’affichage des dates, et la portion heure de DateHeure, dans les vues, les rapports et les fichiers exportés.
Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET DELETE_FILE ON Paramètre par défaut : OFF Contrôle si le fichier de données (*.fil) associé à un format de table est automatiquement supprimé lorsque vous supprimez le format de table.
Attention Redoublez de prudence lorsque vous activez cette option. Il se peut que ce soit le fichier de données d'origine qui soit supprimé avec la table ! Les fichiers de données sont supprimés de manière définitive. Ils ne sont pas envoyés dans la Corbeille de Windows. Vous devez inclure le caractère de soulignement ( _ ) dans DELETE_FILE. Indiquer SET DELETE_FILE, sans aucun paramètre, dans la ligne de commande permet d'obtenir un affichage indiquant si DELETE_FILE est actuellement activée ou désactivée. Boîte de dialogue Options :Options de table |
|||||||||||||||||||||||||||||||||||||||||
SET DESIGNATION "Produit par ABC Corporation" Le paramètre valeur est une chaîne entre guillemets qui indique le libellé à afficher en haut de chaque page imprimée. Boîte de dialogue Options :Options de vue |
|||||||||||||||||||||||||||||||||||||||||
SET ECHO NONE Contrôle si les commandes et les résultats des scripts sont enregistrés dans la trace des commandes Analytics.
Remarque La commande SET ECHO s'applique uniquement à la journalisation des commandes et des résultats dans les scripts. Les commandes exécutées via l’interface utilisateur d’Analytics ou émises à partir de la ligne de commande, ainsi que les résultats qu’elles produisent, sont toujours enregistrés, quel que soit le paramétrage choisi pour ECHO. Indiquer SET ECHO, sans aucun paramètre, dans la ligne de commande permet d'obtenir un affichage indiquant si la journalisation des commandes et des résultats dans les scripts est actuellement activée ou désactivée. |
|||||||||||||||||||||||||||||||||||||||||
SET EXACT ON Paramètre par défaut : OFF Contrôle la façon dont Analytics compare les champs de type caractère, les expressions ou les valeurs littérales. Remarque Les espaces vides sont considérées comme des caractères.
Pour plus d'exemples illustrant SET EXACT, reportez-vous à « Comparaisons exactes de caractères » dans Options de table. Vous pouvez utiliser la fonction ALLTRIM( ) pour supprimer les espaces de début et de fin et vous assurer que seuls des caractères de type texte et des espaces internes sont comparés. Par exemple : ALLTRIM(" AB") = ALLTRIM("AB") est Vrai lorsque les valeurs sont renvoyées à la ligne avec ALLTRIM( ), mais est Faux sinon. Certaines commandes et fonctions d'Analytics sont affectées par SET EXACT et d'autres ne le sont pas :
Boîte de dialogue Options :Options de table |
|||||||||||||||||||||||||||||||||||||||||
SET FILTER TO NumProd = "070104347" SET FILTER TO FiltreNoProd Crée un filtre global (filtre de vue) sur la table ouverte et indique un test logique, ou le nom d'un filtre enregistré existant. Indiquer SET FILTER, sans paramètre, supprime des filtres de la table ouverte. |
|||||||||||||||||||||||||||||||||||||||||
SET FOLDER /Tables/Résultats Indique le répertoire du projet Analytics dans l'onglet Vue globale pour la sortie de la commande. Le dossier de sortie par défaut est le dossier contenant la table active. Le chemin de type DOS indique le format /nom de dossier/sous-dossier, où la première barre oblique (/) indique le niveau racine de l'onglet Vue globale. Vous devez indiquer un chemin de fichier.
Le dossier de sortie reste tel que vous l'avez défini, jusqu'à sa redéfinition ou la fermeture du projet. À l'ouverture du projet, le dossier de sortie revient aux paramètres par défaut du dossier contenant la table active. |
|||||||||||||||||||||||||||||||||||||||||
SET FORMAT ON Paramètre par défaut : OFF Contrôle si Analytics affiche automatiquement la disposition actuelle de la table et les définitions des champs calculés lorsque vous ouvrez une nouvelle table.
Boîte de dialogue Options :Options de table |
|||||||||||||||||||||||||||||||||||||||||
SET FUZZYGROUPSIZE TO 10 Paramètre par défaut : 20 éléments Indique le nombre maximal d'éléments qui peuvent figurer dans un groupe de doublons approximatifs dans les résultats de sortie. Le paramètre num ne peut pas être inférieur à 2 ni supérieur à 100. La taille indiquée demeure effective pendant la durée de la session Analytics. |
|||||||||||||||||||||||||||||||||||||||||
SET GRAPH LINE Indique le type de graphe à utiliser pour tous les graphes générés ultérieurement. L'exécution des commandes doit être compatible avec le type de graphe indiqué. Par exemple, la commande BENFORD ne peut pas produire un graphique PIE2D ou PIE3D. Si un type de graphe incompatible est indiqué, le type par défaut est utilisé (BAR3D). Le paramètre type doit avoir l'une des valeurs suivantes :
|
|||||||||||||||||||||||||||||||||||||||||
SET HISTORY TO 50 Indique le nombre maximal d'entrées historiques de table à conserver. Le paramètre valeur doit être compris entre 1 et 100. |
|||||||||||||||||||||||||||||||||||||||||
SET INDEX TO "CodeClient.INX" Indique l'index à appliquer à la table active. |
|||||||||||||||||||||||||||||||||||||||||
SET LEARN TO EnrInventaire Indique le nom du fichier de script utilisé par l'enregistrement des scripts pour enregistrer les commandes. |
|||||||||||||||||||||||||||||||||||||||||
SET LOCKAUTOSAVEFILE ON Paramètre par défaut : OFF Spécifie le mécanisme d'enregistrement des données dans le fichier trace Analytics (*.LOG).Analytics
|
|||||||||||||||||||||||||||||||||||||||||
SET LOG TO "analyse.log" SET LOG OFF La première commande permet de faire passer la journalisation sur la trace spécifiée. Si la trace spécifiée n'existe pas, elle est créée. La deuxième commande restaure la journalisation sur la trace des commandes Analytics d'origine. Remarque La longueur maximale du chemin d'accès et du nom de trace d'un projet Analytics est de 259 caractères. Cette longueur comprend le chemin d'accès du fichier, le nom de la trace et l'extension du fichier (.log). |
|||||||||||||||||||||||||||||||||||||||||
SET LOOP TO 100 Pour les enregistrements traités par la commande LOOP, spécifie le nombre maximum de commandes qui peuvent être exécutées pour un seul enregistrement. La plage num est comprise entre 0 et 32767. La valeur 0 désactive la limite d’exécution des commandes par enregistrement. Attention Si vous spécifiez 0, vous risquez de faire entrer le script dans une boucle infinie. Nous vous recommandons de toujours spécifier une limite SET LOOP. Comment sont calculées les exécutions de commandes par enregistrement Pour un enregistrement spécifique, le nombre utilisé pour la comparaison avec le maximum de SET LOOP est le total de toutes les commandes du bloc GROUP-LOOP qui traite l’enregistrement. La répartition des commandes est indiquée ci-dessous. Astuce Pour comprendre comment est calculé le nombre total de commandes pour un enregistrement, vous pouvez compter manuellement les commandes, ligne par ligne, dans un bloc GROUP-LOOP. Commencez par la commande GROUP et terminez par la commande END qui met fin à la commande GROUP. Lorsque vous arrivez à la commande LOOP, vous devez tenir compte du nombre d’itérations de la boucle pour un enregistrement particulier. Voir la répartition de la commande ci-dessous pour plus de détails. N’oubliez pas que les attributions de variables sont des commandes. Le mot-clé facultatif de la commande ASSIGN est souvent omis. Les commentaires sont également des commandes (COMMENT).
|
|||||||||||||||||||||||||||||||||||||||||
SET MARGIN TOP TO 100 Paramètre par défaut : 51 (51/100 de pouce) Indique LEFT, RIGHT, TOP ou BOTTOM pour le paramètre côté. Pour modifier la marge sur tous les côtés, indiquez chaque marge avec une commande SET MARGIN distincte. La spécification de la valeur 100 crée une marge de 1 pouce. Boîte de dialogue Options :Options d'impression |
|||||||||||||||||||||||||||||||||||||||||
SET MATH TO MIN Paramètre par défaut : MAX Indique le fonctionnement de la précision décimale lorsque deux opérandes sont évalués dans une expression numérique.
Dans les expressions contenant plusieurs opérandes, le paramètre SET MATH fonctionne par paires, en appliquant le paramètre spécifié à chaque paire d'opérandes, en l'arrondissant si nécessaire, à mesure qu'ils sont évalués dans l'ordre mathématique standard (BOMDAS). Si le paramètre SET MATH diminue le nombre de décimales dans un résultat, le résultat est arrondi et non tronqué. Pour plus d'informations, consultez la section Contrôle de l'arrondi et de la précision décimale dans les expressions numériques. Remarque Vous ne pouvez pas utiliser SET MATH pendant qu'une table Analytics est ouverte. |
|||||||||||||||||||||||||||||||||||||||||
SET MONTHS "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec" Indique les abréviations à trois caractères par défaut pour les noms de mois. Le paramètre chaîne correspond à la liste des abréviations de mois, séparées par des virgules. Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET NOTIFYFAILSTOP ON Paramètre par défaut : OFF Contrôle le comportement du script si la commande NOTIFY échoue.
Boîte de dialogue Options :Options de commande |
|||||||||||||||||||||||||||||||||||||||||
SET NOTIFYRETRYATTEMPTS TO 10 Paramètre par défaut : 5 tentatives Indique le nombre de fois où la commande NOTIFY tentera d'envoyer un message électronique en cas d'échec de la première tentative. Entrez un nombre compris entre 0 et 255. Si vous entrez 0, aucune autre tentative ne sera effectuée après un premier échec. Une raison possible d'échec d'envoi de message électronique par la commande NOTIFY est l'indisponibilité du serveur de messagerie. Boîte de dialogue Options :Options de commande |
|||||||||||||||||||||||||||||||||||||||||
SET NOTIFYRETRYINTERVAL TO 30 Paramètre par défaut : 10 secondes Indique la durée en secondes entre les NOTIFYRETRYATTEMPTS. Entrez un nombre compris entre 1 et 255. Boîte de dialogue Options :Options de commande |
|||||||||||||||||||||||||||||||||||||||||
SET ORDER TO aAbBcC... SET ORDER Paramètre par défaut : système par défaut Indique la séquence de tri des champs de type caractère. Le paramètre values liste tous les caractères pour l’ordre de tri spécifié. La deuxième commande ramène l’ordre de tri à son paramètre par défaut du système. Pour plus d'informations, consultez la section L'option Ordre de tri et les séquences de tri. |
|||||||||||||||||||||||||||||||||||||||||
SET OVERFLOW OFF Paramètre par défaut : ON Contrôle le comportement du script si un dépassement numérique se produit.
Boîte de dialogue Options :Options numériques |
|||||||||||||||||||||||||||||||||||||||||
SET PASSWORD 1 TO "motdepasse123" Crée une définition de mot de passe et spécifie une valeur de mot de passe pour l'exécution de scripts autonome. Le paramètre num identifie de façon unique la définition de mot de passe et doit être une valeur comprise entre 1 et 10. Indique la valeur de mot de passe sous forme de chaîne entre guillemets. Attention La commande SET PASSWORD affiche un mot de passe actuel en texte clair dans un script, ce qui peut ne pas convenir à votre situation. En tant qu'alternative plus sécurisée, vous pouvez utiliser la Commande PASSWORD pour inviter à saisir le mot de passe au début de l'exécution du script et stocker de façon temporaire et sécurisée la valeur du mot de passe en mémoire. |
|||||||||||||||||||||||||||||||||||||||||
SET PERIODS TO "0;30;90;180;10000" Paramètre par défaut : 0;30;60;90;120;10000 Indique les périodes d'antériorité par défaut utilisées par la commande AGE. Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET PICTURE "(9.999.999,99)" Paramètre par défaut : -999999,99 Indique le format par défaut des valeurs numériques. Boîte de dialogue Options :Options numériques |
|||||||||||||||||||||||||||||||||||||||||
SET READAHEAD TO 100 Paramètre par défaut : 33 kilo-octets Spécifie la taille du bloc de données lu (tampon de données) en kilo-octets. Entrez un nombre compris entre 5 et 255. Modifiez cette valeur uniquement si l'Assistance vous le demande. Boîte de dialogue Options :Options de table |
|||||||||||||||||||||||||||||||||||||||||
SET RETRYIMPORT <TO> num |
SET RETRY TO 20 Paramètre par défaut : 0 tentatives Indique le nombre de fois où Analytics tente d'exécuter une commande en cas d'échec de la première tentative. Entrez un nombre compris entre 0 et 255. Si vous entrez 0, aucune autre tentative ne sera effectuée après un premier échec. Il y a un temps d'attente d'une seconde entre les différentes tentatives. Il est utile de préciser le nombre de tentatives de connexion aux bases de données ou aux services de données cloud, ce qui peut être temporairement indisponible. Essayer une commande à nouveau peut également vous aider si vous rencontrez des problèmes avec l'écriture de données vers le disque ou la lecture de données à partir du disque. SET RETRY s'applique aux commandes suivantes :
Remarque L'option SET RETRYIMPORT est conservée pour la compatibilité ascendante. Les options SET RETRYIMPORT et SET RETRY effectuent des actions similaires. Boîte de dialogue Options :Options de commande |
||||||||||||||||||||||||||||||||||||||||
SET SAFETY OFF Par défaut : ON Contrôle si une boîte de dialogue de confirmation apparaît avant d’écraser l’un des éléments suivants :
Indiquer SET SAFETY, sans aucun paramètre, dans la ligne de commande permet d'obtenir un affichage indiquant si SAFETY est actuellement activée ou désactivée. Boîte de dialogue Options :Options d'interface |
|||||||||||||||||||||||||||||||||||||||||
SET SEPARATORS TO ",.;" Indique les séparateurs par défaut utilisés par Analytics pour les décimales, les milliers et les listes. Les valeurs SET SEPARATORS doivent être trois caractères de séparateur valides dans l'ordre suivant :
Parmi les trois séparateurs, le séparateur décimal doit être unique. Vous devez indiquer les trois séparateurs lorsque vous utilisez la commande. Le séparateur de liste est utilisé principalement pour séparer des paramètres de fonction. Boîte de dialogue Options :Options numériques |
|||||||||||||||||||||||||||||||||||||||||
SET SESSION SET SESSION "Analyse" Crée une nouvelle session dans la trace des commandes Analytics. La session est identifiée par l'horodatage actif. Le nom_session facultatif permet d'ajouter jusqu'à 30 caractères d'informations d'identification supplémentaires. Les guillemets sont autorisés, mais ils ne sont pas obligatoires. |
|||||||||||||||||||||||||||||||||||||||||
SET SORTMEMORY 800 Paramètre par défaut : 0 Indique la quantité maximale de mémoire allouée pour le tri et l'indexation des processus. Le paramètre num doit être une valeur comprise entre 0 et 2 000 mégaoctets (Mo), à saisir par incréments de 20 Mo. Si la mémoire de tri est définie sur 0, Analytics utilise la mémoire actuellement disponible. Boîte de dialogue Options :Options de table |
|||||||||||||||||||||||||||||||||||||||||
SET SUPPRESSTIME ON Paramètre par défaut : OFF Contrôle si Analytics supprime la partie horaire des données source DateHeure. Remarque Ce paramètre ne doit être utilisé que lors de la définition d’une table Analytics qui utilise une source de données ODBC (commande IMPORT ODBC) ou un accès direct à la base de données (commande DEFINE TABLE DB).
Vous pouvez exécuter la commande SET SUPPRESSTIME ON/OFF dans un script ou à partir de la ligne de commande. Indiquer SET SUPPRESSTIME, sans aucun paramètre, dans la ligne de commande permet d'afficher si la suppression de la portion correspondant à l'heure des données DateHeure est actuellement activée ou désactivée. |
|||||||||||||||||||||||||||||||||||||||||
SET SUPPRESSXML ON Paramètre par défaut : OFF Contrôle si la sortie de la commande apparaît à l’écran en texte brut ou en texte formaté.
La spécification de SET SUPPRESSXML, sans aucun paramètre, dans la ligne de commande affiche si le paramètre est actuellement activé ou désactivé. Boîte de dialogue Options :Options de commande |
|||||||||||||||||||||||||||||||||||||||||
SET TEST ON Paramètre par défaut : ON Contrôle si les résultats des tests IF, WHILE, FOR et NEXT associés aux commandes GROUP sont enregistrés dans la trace.
Boîte de dialogue Options :Options de commande |
|||||||||||||||||||||||||||||||||||||||||
SET TIME "hh:mm:ss PM" Paramètre par défaut : hh:mm:ss PM Spécifie le format d’affichage de la portion heure de la valeur DateHeure, et les valeurs heure autonomes dans les vues, les rapports et les fichiers exportés. Lorsque vous utilisez la commande SET TIME pour indiquer des formats d'heures personnalisés, vous devez utiliser 'h' pour Heure, 'm' pour Minute, et 's' pour Seconde, même si vous avez indiqué des caractères de format d'heure différents dans la boîte de dialogue Options. Par exemple : SET TIME TO "hh:mm" Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET UTCZONE OFF Paramètre par défaut : ON Contrôle l’affichage des données heure qui incluent un décalage UTC. UTC est le temps universel coordonné, le temps à zéro degré de longitude.
Par exemple :
Remarque La conversion des heures en UTC est uniquement destinée à l’affichage et n’affecte pas les données sources. Vous pouvez faire des allées et venues entre les deux modes d'affichage à chaque fois que vous le souhaitez. Boîte de dialogue Options :Options de date et d'heure |
|||||||||||||||||||||||||||||||||||||||||
SET VERIFY BLANK Paramètre par défaut : OFF Contrôle la vérification automatique des données chaque fois qu’une table est ouverte ou qu’un champ de la table est traité par une commande.
Boîte de dialogue Options :Options numériques |
|||||||||||||||||||||||||||||||||||||||||
SET WIDTH TO 20 Paramètre par défaut : 12 Indique la largeur d'affichage par défaut en caractères des champs calculés numériques ou des expressions numériques ad hoc lorsque Analytics ne peut pas déterminer la largeur maximale. Boîte de dialogue Options :Options numériques |