Commande SET

SET BEEP valeur

SET BEEP 2

Indique le nombre de bips émis lorsque le traitement de la commande est terminé.

Le paramètre valeur doit être compris entre 1 et 255.

SET CENTURY valeur

SET CENTURY 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.

SET CLEAN {ON | OFF}

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 <TO> {0 | 1 | 2 | chaîne}

SET DATE "AAAA/MM/JJ"

Indique le format d'affichage des dates dans Analytics, et la portion correspondant à la date des DateHeures, dans les vues, les rapports et les fichiers exportés.

• SET DATE 0 définit la date au format MM/JJ/AAAA

• SET DATE 1 définit la date au format MM/JJ/AA

• SET DATE 2 définit la date au format JJ/MM/AA

• SET DATE "<chaîne>" définit la date au format personnalisé que vous indiquez

  Lorsque vous utilisez la commande SET DATE pour spécifier des formats de date personnalisés, vous devez utiliser J pour Jour, M pour Mois et A pour Année, même si vous avez spécifié des caractères de format de date différents dans la boîte de dialogue Options. Par exemple :

  SET DATE "JJ MMM AAAA"

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

Paramètre par défaut : OFF

Spécifiez ON pour supprimer automatiquement le fichier de données associé lorsque vous supprimez un format de table.

Spécifiez OFF pour éviter la suppression du fichier de données associé lorsque vous supprimez un format de table.

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.

SET DESIGNATION valeur

SET DESIGNATION "Produit par l'entreprise ABC"

Le paramètre valeur est une chaîne entre guillemets qui indique le libellé à afficher en haut de chaque page imprimée.

SET ECHO {ON | NONE}

SET ECHO NONE
Commandes COM et résultats des scripts exclus de la trace.
SET ECHO ON

Indiquez NONE pour arrêter l'écriture des commandes et des résultats dans les scripts vers la trace de commande Analytics. Indiquez ON pour reprendre l'écriture dans la trace.

La commande SET ECHO s'applique uniquement à la journalisation des commandes et des résultats dans les scripts. Les commandes réalisées à travers l'interface utilisateur ou émises à partir de la ligne de commande, ainsi que tous résultats qu'elles produisent, sont toujours journalisées, quelle que soit la manière dont la commande ECHO est définie.

Vous pouvez exécuter la commande SET ECHO NONE/ON dans un script ou à partir de la ligne de commande, mais quel que soit l'endroit où vous émettez la commande, cela affecte uniquement la journalisation des commandes et des résultats dans les scripts.

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 | OFF}

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.

• SET EXACT est sur OFF Pour comparer deux chaînes de caractères de longueur inégale, Analytics utilise la plus petite chaîne de caractères. La comparaison commence par les caractères les plus à gauche et se déplace vers la droite.

  Par exemple, la chaîne « AB » est égale à « AB » et elle aussi considérée comme égale à « ABC ».

• SET EXACT est sur ON les chaînes de comparaison doivent être exactement identiques pour constituer un rapprochement. Lors de la comparaison de deux chaînes de caractères de longueur inégale, Analytics complète la chaîne la plus courte avec des espaces de fin pour faire correspondre les deux chaînes avec la longueur de la chaîne la plus longue.

  Par exemple, la chaîne « AB » est égale à « AB », mais elle n'est pas considérée comme égale à « ABC ».

Pour plus d'exemples illustrant SET EXACT, reportez-vous à « Comparaisons exactes de caractères » dans l'onglet Table (boîte de dialogue Options).

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 :

SET FILTER <TO> {test | nom_filtre}

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 chemin dossier

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.

• SET FOLDER /Tables/Résultats définit le dossier de sortie dans le sous-dossier Résultats. Si le sous-dossier Résultats n'existe pas, il est créé.

• SET FOLDER / définit le dossier de sortie au niveau racine dans l'onglet Vue globale

• SET FOLDER définit le dossier de sortie sur les paramètres par défaut (le dossier de la table active)

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 | OFF}

SET FORMAT ON

Paramètre par défaut : OFF

Si vous utilisez le paramètre ON, Analytics affiche automatiquement les définitions de format de table et de champ calculé actuelles lorsque vous ouvrez une nouvelle table. Les résultats s'affichent dans la trace des commandes.

SET FUZZYGROUPSIZE <TO> num

SET FUZZYGROUPSIZE TO 10

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 par défaut est 20. La taille indiquée demeure effective pendant la durée de la session Analytics.

SET GRAPH type

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 :

• PIE2D

• PIE3D

• BAR2D

• BAR3D : type de graphe par défaut.

• STACKED2D

• STACKED3D

• LAYERED

• LINE

• BENFORD : combine un graphe à barres 2D et un graphe linéaire 2D.

SET HISTORY <TO> valeur

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> valeur

SET INDEX TO "CodeClient.INX"

Indique l'index à appliquer à la table active.

SET LEARN <TO> script

SET LEARN TO EnrInventaire

Indique le nom du fichier de script utilisé par l'enregistrement des scripts pour enregistrer les commandes.

SET LOG <TO> {fichier | OFF}

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.

SET LOOP <TO> num

SET LOOP TO 20

Indique le nombre maximum de boucles qui peuvent être exécutées par la commande LOOP avant la fin de la commande.

La plage num est comprise entre 0 et 32 767 (0 désactive le test de boucle).

SET MARGIN côté <TO> valeur

SET MARGIN TOP TO 100

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.

SET MATH <TO> {FIRST | LAST | MIN | MAX}

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.

• FIRST utilise le nombre de décimales du premier opérande d'une paire d'opérandes
• LAST utilise le nombre de décimales du dernier opérande d'une paire d'opérandes
• MIN utilise le plus petit nombre de décimales dans une paire d'opérandes
• MAX utilise le plus grand nombre de décimales dans une paire d'opérandes

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 dans les expressions numériques.

SET MONTHS <TO> chaîne

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.

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

Paramètre par défaut : OFF

• NOTIFYFAILSTOP est sur OFF Analytics autorise la poursuite du script même en cas d'échec d'une commande NOTIFY dans le script.
• NOTIFYFAILSTOP est sur ON Analytics arrête le traitement d'un script et écrit un message dans la trace si une commande NOTIFY échoue dans le script. Le script s'arrête après le premier échec ou après le nombre NOTIFYRETRYATTEMPTS spécifié, si aucune des tentatives n'aboutit.

SET NOTIFYRETRYATTEMPTS <TO> num

SET NOTIFYRETRYATTEMPTS TO 10

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. La valeur par défaut est 5.

Une raison possible d'échec d'envoi de message électronique par la commande NOTIFY est l'indisponibilité du serveur de messagerie.

SET NOTIFYRETRYINTERVAL <TO> secondes

SET NOTIFYRETRYINTERVAL TO 30

Indique la durée en secondes entre les NOTIFYRETRYATTEMPTS. Entrez un nombre compris entre 1 et 255. La valeur par défaut est 10 secondes.

SET ORDER <TO> valeurs

Indique la séquence de tri des champs de type caractère. Le paramètre valeurs répertorie tous les caractères pour l'ordre de tri sélectionné.

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

Paramètre par défaut : ON

Si OFF est indiqué, Analytics n'arrête pas le traitement en cas d'erreur de dépassement.

SET PASSWORD num <TO> chaîne

SET PASSWORD 1 TO "motdepasse123"

Sert à créer une définition de mot de passe et à spécifier 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.

SET PERIODS <TO> valeur <;...n>

SET PERIODS TO "0;30;90;180;10000"

Indique les périodes d'antériorité par défaut utilisées par la commande AGE.

SET PICTURE format

SET PICTURE "(9.999.999,99)"

Indique le format par défaut des valeurs numériques.

SET READAHEAD <TO> taille

Indique la taille de lecture de blocs de données. Modifiez cette valeur uniquement si l'Assistance vous le demande.

SET RETRY <TO> num

SET RETRYIMPORT <TO> num

SET RETRY TO 50

Indique le nombre de fois qu'Analytics tente d'importer ou d'exporter des données 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. La valeur par défaut est 0.

Il n'y a pas de temps d'attente entre les différentes tentatives. Chaque tentative successive a lieu tout de suite après l'échec précédent.

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.

S'applique aux commandes suivantes :

• ACCESSDATA
• IMPORT GRCPROJECT
• IMPORT GRCRESULTS
• IMPORT SAP
• RETRIEVE
• REFRESH

  (uniquement dans le cas des tables initialement créées à l'aide des options ACCESSDATA ou IMPORT SAP)

• EXPORT . . . ACLGRC

  (export vers HighBond Résultats)

SET SAFETY {ON | OFF}

SET SAFETY OFF

Indiquez ON pour afficher une boîte de dialogue de confirmation lors du remplacement de l'un des éléments suivants :

• champs d'un format de table

• tables Analytics

• fichiers, y compris les fichiers de données Analytics (.fil)

Indiquez OFF pour empêcher l'affichage de la boîte de dialogue.

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.

SET SEPARATORS <TO> valeurs

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 :

• décimales (point, virgule ou espace)

• milliers (point, virgule ou espace)

• liste (point-virgule, virgule ou espace)

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.

SET SESSION nom_session

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 num

SET SORTMEMORY 800

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.

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

Paramètre par défaut : OFF

Uniquement pour une utilisation lorsque vous définissez une table Analytics qui utilise une source de données ODBC (commande IMPORT ODBC), ou l'accès direct à la base de données (commande DEFINE TABLE DB).

Si vous utilisez le paramètre ON, lorsque vous définissez la table Analytics supprime la portion correspondant à l'heure des valeurs DateHeure. Par exemple, 20141231 235959 est lu, affiché dans les vues, et ensuite traité en tant que 20141231.

Inclure cette commande dans un script Analytics pré-DateHeure (pre v.10.0) qui suppose que la portion correspondant à l'heure des données DateHeure sera tronquée permet au script de s'exécuter dans les versions avec DateHeure activée d'Analytics.

Analytics supprime la portion correspondant à l'heure en utilisant uniquement la portion correspondant à la date du format DateHeure. Les données heure sont toujours présentes dans le fichier .fil ou dans la table de la base de données. Si nécessaire, vous pouvez redéfinir le champ ou définir un nouveau champ pour inclure la portion des données correspondant à l'heure.

Si SET SUPPRESSTIME = OFF, les tables Analytics définies à l'aide d'ODBC ou de l'accès direct à la base de données incluent les valeurs de DateHeure complètes.

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 | OFF}

SET SUPPRESSXML ON

Paramètre par défaut : OFF

Indique que la sortie de la commande est en texte brut, et non en texte formaté.

SET TEST {ON | OFF}

SET TEST ON

Indique si les résultats des tests IF, WHILE, FOR et NEXT associés à des commandes GROUP doivent être enregistrés dans la trace.

SET TIME <TO> chaîne

SET TIME "hh:mm:ss PM"

Indique le format d'affichage de la portion correspondant à l'heure des DateHeures et les valeurs heure autonomes dans Analytics, 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"

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

Paramètre par défaut : ON

• UTCZONE est sur ON Analytics modifie l'affichage des heures locales avec un décalage horaire UTC pour l'équivalent UTC de l'heure locale. (L'heure UTC est l'heure universelle coordonnée à zéro degré de longitude.)
• UTCZONE est sur OFF Analytics affiche les heures locales avec un décalage UTC sans les convertir en UTC.

Par exemple :

• 01 jan 2015 04:59:59 (SET UTCZONE ON)
• 31 déc 2014 23:59:59-05:00 (SET UTCZONE OFF)

La conversion de l'heure locale en UTC est effectuée à des fins d'affichage uniquement, et elle n’affecte pas les données source. Vous pouvez faire des allées et venues entre les deux modes d'affichage à chaque fois que vous le souhaitez.

SET VERIFY {ON | OFF | BLANK}

SET VERIFY ON

Lorsque ON est indiqué, à chaque ouverture d'une table Analytics vérifie automatiquement si le contenu d'un champ de données correspond au type de données du champ dans le format de table. Lorsque BLANK est indiqué, Analytics remplace des données de type caractère non valides par des espaces et les données numériques non valides par des zéros, en plus de la vérification décrite pour le paramètre ON.

SET WIDTH <TO> caractères

SET WIDTH TO 20

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.