Ajout d'éléments personnalisés au menu principal Analytics

Vous pouvez ajouter au menu principal Analytics des éléments personnalisés tels que vos propres scripts Analytics et les commandes souvent utilisées. Les éléments personnalisés apparaissent sous le menu Applications. Cette fonctionnalité est particulièrement utile si vous créez des scripts destinés à être utilisés par d'autres utilisateurs et que vous souhaitez un emplacement unique et facile d'utilisation permettant d'accéder aux scripts.

Accès au niveau du projet ou accès global

Vous pouvez créer des éléments de menu personnalisés qui sont limités à des projets Analytics individuels ou vous pouvez rendre les éléments disponibles globalement, chaque fois qu'Analytics est ouvert.

• accès au niveau du projet permet de localiser le fichier texte (*.mnu) contenant les éléments de menu personnalisés dans le même dossier que le projet Analytics (*.acl)
• accès global permet de localiser le fichier texte (*.mnu) contenant les éléments de menu personnalisés dans le même dossier que le fichier exécutable Analytics (ACLWin.exe)

Vous pouvez également combiner les approches et créer des éléments de menu personnalisés tant au niveau du projet qu'au niveau global.

Le fichier de menu configurable (*.mnu)

Vous utilisez un ou plusieurs fichiers texte portant une extension de fichier .mnu pour créer vos éléments de menu personnalisés.

Entrées de sous-menu

Chaque fichier *.mnu crée une entrée de sous-menu distincte sous le menu Applications. Par exemple, Scripts compte.mnu crée l'entrée de sous-menu Scripts compte et cette structure de menu : Applications > Scripts de compte.

Les entrées de sous-menu apparaissent dans l'ordre alphanumérique dans le menu Applications.

Éléments de menu personnalisés

À l'intérieur de chaque entrée de sous-menu se trouvent les différents éléments de menu personnalisés. Par exemple, vous pouvez avoir deux éléments exécutant les scripts suivants :

• Analyse des comptes fournisseurs

  (Applications > Scripts de comptes > Analyse des comptes fournisseurs)

• Analyse des comptes clients

  (Applications > Scripts de comptes > Analyse des comptes clients)

Les éléments de menu personnalisés apparaissent dans les sous-menus dans l'ordre dans lequel les éléments sont répertoriés dans le fichier *.mnu.

À l'aide du ou des fichiers *.mnu, vous pouvez créer des sous-menus en cascade sur plusieurs niveaux en fonction de vos besoins.

Nombre maximal d'éléments de menu personnalisés

Le menu Applications peut contenir un maximum de 179 éléments de menu personnalisés. Le maximum s'applique au nombre total d'éléments de menu personnalisés dans tous les niveaux des sous-menus et dans tous les fichiers *.mnu.

Syntaxe du fichier de menu

Un exemple de fichier de menu, Modèle.mnu, se trouve dans le dossier Exemples de fichiers de données installé avec Analytics.

• Modèle.mnu crée l'entrée de sous-menu Modèle dans le menu Applications dans Exemple de projet.acl, et dans les trois autres exemples de projets Analytics contenus dans le dossier Exemples de fichiers de données.
• Le sous-menu Modèle contient six éléments de menu personnalisés au premier niveau.
• L'un des éléments de menu personnalisés de premier niveau, Analyse des marges, contient quatre éléments de menu personnalisés au deuxième niveau.
• La plupart des éléments de menu personnalisés dans Modèle.mnu sont simplement des espaces réservés pour illustrer le concept des fichiers de menu.

Le contenu de Modèle.mnu est reproduit ci-dessous, avec les exigences syntaxiques qui l'accompagnent.

Contenu de Modèle.mnu

MENU PRINCIPAL                        6                                                  .
Analyse des marges                    8 menu_def                                         .
Analyse d'inventaire                  PAUSE 'BATCH EXEMPLE D'ANALYSE D'INVENTAIRE'       .
Analyse de compte fournisseur         PAUSE 'LANCER VOS BATCHES C/F'                     .
Analyse de compte client              PAUSE 'CREER BATCHES C/C ICI'                      .
Fonctions d'audit interne             PAUSE 'EXEMPLE DE PROCESSUS D'AUDIT INTERNE'       .
Quitter ACL                           QUIT                                               .
                                                                             
ANALYSE DES MARGES                    4                                                  .
Liste des exceptions                  PAUSE 'CREER Batch  où marge <=0'                  .
Produits à marge élevée               PAUSE 'Exemple de batch des 5 marges supérieures'  .
Produits à marge basse                PAUSE 'Calculer les 5 marges les plus basses'      .
Statistiques des marges               STATISTICS                                         .

Exigences relatives à la syntaxe des fichiers de menu

Propriétés	Condition préalable
Longueur de ligne	Chaque ligne du fichier de menu doit avoir exactement la même longueur. Bien que cela ne soit pas obligatoire, il est recommandé d'utiliser un point (.) pour marquer visuellement la fin de chaque ligne, immédiatement avant le saut de ligne.
Numérotation de ligne	Les lignes dans le fichier de menu sont comptées à partir de zéro (0). Gardez ce schéma de numérotation à l'esprit chaque fois que vous indiquez des références de numéro de ligne dans la syntaxe du fichier de menu. Si l'éditeur de texte que vous utilisez affiche et compte les numéros de ligne à partir de 1, vous devez décrémenter le numéro de ligne de l'éditeur de texte de 1 lorsque vous spécifiez des références de numéro de ligne de fichier de menu. Dans l'exemple ci-dessus, l'élément de menu Analyse des marges apparaît sur la ligne 1 et le bloc syntaxique du sous-menu ANALYSE MARGINS apparaît sur les lignes 8 à 12.
Lignes vides	Des lignes vides peuvent apparaître entre les blocs de syntaxe mais pas à l'intérieur des blocs de syntaxe. Les lignes vides, composées d'espaces, doivent avoir la même longueur que les autres lignes du fichier de menu. Bien que cela ne soit pas obligatoire, une ou plusieurs lignes vides entre les blocs de syntaxe offrent une séparation visuelle dans le fichier de menu.
Blocs de syntaxe	Les blocs de syntaxe définissent chaque groupe d'éléments de menu personnalisés. Vous pouvez utiliser plusieurs blocs de syntaxe pour créer plusieurs niveaux de menu. Le côté gauche du bloc contient les noms des éléments de menu, un par ligne. Ce sont les noms qui apparaissent dans le menu dans Analytics. Les noms peuvent contenir 35 caractères au maximum. Le côté droit du bloc contient soit une commande ACLScript, soit une référence de ligne à un bloc de syntaxe de niveau inférieur. Les lignes du côté droit du bloc doivent toutes commencer à la position de caractère 37. Utilisez uniquement des espaces pour aligner les éléments de texte. N'utilisez pas de caractères de tabulation. Remarque Même un seul caractère de tabulation dans un fichier de menu fera que le fichier sera ignoré. Utilisez un éditeur de texte qui peut afficher les caractères de tabulation afin que vous puissiez vérifier leur présence.
En-tête du bloc	Chaque bloc de syntaxe commence par une seule ligne d'en-tête. Le côté gauche de la ligne contient l'identifiant du bloc en majuscules et le côté droit contient le nombre de lignes contenues dans le bloc. Dans l'exemple précédent, la ligne 0 contient l'identifiant de bloc MAIN MENU et indique que le bloc contient 6 lignes. La ligne d'en-tête n'est pas comptée. Les identificateurs de bloc sont facultatifs. Ils gardent des blocs syntaxiques organisés dans le fichier de menu. Ils n'apparaissent nulle part dans la structure du menu Applications Analytics. Si vous omettez un identificateur de bloc, le nombre de lignes spécifié dans le bloc doit toujours commencer à la position de caractère 37.
Référence à un bloc de syntaxe de niveau inférieur	Une référence d'un élément de menu à un bloc de syntaxe de niveau inférieur prend la forme num menu_def. num indique le numéro de ligne à laquelle commence le bloc de syntaxe de niveau inférieur, c'est-à-dire la ligne d'en-tête du bloc de syntaxe de niveau inférieur. Dans l'exemple ci-dessus, la ligne 1 contient l'élément de menu Analyse des marges, qui fait référence à la ligne à laquelle commence le bloc de syntaxe de niveau inférieur MARGINS ANALYSIS ( 8 menu_def ).
Éléments de menu personnalisés	Des éléments de menu personnalisés peuvent être spécifiés : toute commande ACLScript valide une référence de ligne à un bloc de syntaxe de niveau inférieur Pour créer un élément de menu personnalisé qui exécute un script Analytics, spécifiez DO SCRIPT nom_script. Par exemple : Script Calculer la valeur médiane       DO SCRIPT Calculer_valeur_médiane Remarque Le script doit être inclus dans le projet Analytics dans lequel l'élément de menu personnalisé apparaît. Les commandes courtes peuvent être saisies directement dans le fichier.mnu. Les commandes plus longues contenant plusieurs paramètres doivent être enregistrées dans un script, qui peut être référencé à l'aide de la commande DO SCRIPT.

Créer ou modifier un fichier de menu

La méthode la plus simple pour créer un fichier de menu consiste à copier l'exemple de fichier de menu Analytics (Modèle.mnu) et de le modifier.

Gardez à l'esprit les points suivants lorsque vous modifiez un fichier de menu déjà utilisé :

• Avant de modifier un fichier de menu, faites-en une copie de sauvegarde.
• Si vous ajoutez ou supprimez des lignes, assurez-vous d'ajuster les références des numéros de lignes de façon appropriée.
• Lorsque cela est possible, ajoutez les nouveaux éléments à la fin du fichier de menu afin de conserver les références de ligne.

1. Copiez le fichier Modèle.mnu du dossier Exemples de fichiers de données Analytics vers un emplacement de travail.

   Attention

   Ne modifiez pas le fichier modèle d'origine. Si vous rencontrez des problèmes, vous pouvez recopier le fichier d'origine et recommencer.

2. Renommez le fichier copié de manière appropriée.

   Le nom que vous donnez au fichier devient le nom de l'entrée de sous-menu du menu Applications Analytics.

   Remarque

   Si vous créez un fichier de menu depuis le tout début, remplacez l'extension de fichier par .mnu.

3. Ouvrez le fichier renommé dans un éditeur de texte tel que Notepad+++ et modifiez-le pour créer des sous-menus et des éléments de menu personnalisés.

   Suivez exactement la section Exigences relatives à la syntaxe des fichiers de menu ci-dessus.

4. Effectuez l'une des actions suivantes :
   • Enregistrez le fichier dans le dossier contenant le projet Analytics dans lequel vous voulez que les éléments de menu personnalisés apparaissent.
   • Enregistrez le fichier dans le dossier exécutable Analytics pour rendre les éléments de menu personnalisés accessibles dans tous les projets Analytics ouverts sur l'ordinateur.

   Astuce

   Vous pouvez créer des fichiers de menu tant au niveau du projet qu'au niveau global, si nécessaire.

5. Fermez et rouvrez Analytics pour rafraîchir le menu Applications.

   L'entrée de sous-menu et les éléments de menu personnalisés devraient maintenant être disponibles dans le menu Applications.

   Si le sous-menu et les éléments de menu personnalisés n'apparaissent pas, vérifiez soigneusement le contenu de votre fichier de menu par rapport aux exigences syntaxiques ci-dessus. Rendez tous les caractères non imprimables visibles dans l'éditeur de texte que vous utilisez. Une espace supplémentaire à la fin d'une ligne, ou un caractère de tabulation dans le fichier de menu, fait que le fichier est ignoré.