Macro Code Utilisateur (MCU)

Les Macro-Codes Utilisateur (MCU) sont des morceaux de code rédigés en W-Langage qui permettent à l’utilisateur final de personnaliser l’interface et d’étendre certaines fonctionnalités de l’application. Bien que la saisie du code soit largement simplifiée grâce à un assistant, cette technologie s’adresse particulièrement à des utilisateurs qui ont une bonne connaissance dans le domaine de la programmation.

Accessibilité

Si une fenêtre permet la saisie d’un Macro-Code Utilisateur (MCU), l’icône  apparaît :

  • jusqu’à Windows XP : à côté de l’icône de réduction de la fenêtre.
  • à partir de Windows Vista : en dessous de la barre de titre.

Lors du clic sur cette icône, un assistant apparaît et permet à l’utilisateur final de créer et d’utiliser ses macro-codes utilisateur.

Remarque :
  • Pour lancer le MCU, il est également possible d’utiliser le raccourci clavier [Windows] + [F2].
  • L’assistant peut également être lancé par un bouton personnalisé. Pour personnaliser le bouton MCU, créez un nouveau bouton, associé à l’action prédéfinie « Ouvrir la fenêtre d’édition du Macro-Code Utilisateur ». Dans ce cas, le bouton par défaut ne sera plus affiché. Le nouveau bouton pourra être positionné à n’importe quel endroit de la fenêtre.

Ajouter un Macro-Code Utilisateur

Pour ajouter un Macro-Code Utilisateur :

  1. Lancez l’assistant de gestion du MCU (icône  par défaut).
  2. Cliquez sur le bouton « Ajouter un Macro-Code ».
  3. Indiquez le type d’action concerné par le traitement personnalisé : Action sur un champ ou sur une combinaison de touches.
  4. Si vous effectuez un traitement sur un champ :
    • Sélectionnez le champ concerné. Un tableau liste les différents champs de l’application avec leur libellé. Vous pouvez également sélectionner directement le champ dans la fenêtre grâce au bouton « Choisir le champ ».
    • Sélectionnez l’action à personnaliser et le moment de l’exécution de l’action personnalisée.
    • Un éditeur de code simplifié apparaît, permettant de saisie le titre de la macro et le code WLangage du Macro-Code Utilisateur.
  5. Si vous effectuez un traitement sur une combinaison de touches :
    • Spécifiez la combinaison de touches concernée.
    • Un éditeur de code simplifié apparaît, permettant de saisir le titre de la macro, le moment d’exécution et le code WLangage du Macro-Code Utilisateur.
  6. Dans l’éditeur de code simplifié :
    • la coloration syntaxique est disponible.
    • l’aide des fonctions WLangage est disponible.
    • Il est possible de tester directement le code saisi.
    • Il est possible d’obtenir la liste des champs afin de manipuler un autre champ de la fenêtre.
  7. Validez. Le macro-code est ajouté et est disponible immédiatement.

Envoyer par email les Macro-Codes Utilisateur

Si la fonctionnalité a été autorisée par le développeur de l’application, il est possible d’envoyer par emails les Macro-Codes Utilisateur créés.

Pour envoyer les Macro-Codes Utilisateur par email :
  1. Lancez l’assistant.
  2. Cliquez sur le bouton « Envoyer le code ».
Attention : cette fonctionnalité n’est pas disponible pour les applications installées avec une mise à jour automatique depuis un répertoire réseau. Dans ce cas, les fichiers MCU sont copiés dans le répertoire réseau partagé.

Limitations

Code saisi dans les Macro-Codes Utilisateur

  • Les traitements d’exception (Quand Exception …) n’ont aucun effet en MCU.
  • Il n’est pas possible d’utiliser les fonctions HFSQL permettant la modification des fichiers de données (fonctions HAjouteHCréationHCréationSiInexistantHEcritHLibèreHModifieHRaye et HSupprime). Les fonctions Table* correspondantes sont également interdites.
  • La fonction Compile ne peut pas être utilisée.
  • Lors de la configuration de l’application, il est possible d’interdire l’utilisation des fonctions de parcours des fichiers de données.
  • La fonction RepriseSaisie peut avoir un comportement différent de celui attendu.