gestion des présentations - macros/routines.

 

Les macro-fonctions sont des routines standards qui permettent d'extraire des informations à partir des fichiers existants dans la base IRIS ou de réaliser des opérations telles que des calculs ou des requêtes SQL.

Les routines sont des sous programmes que vous pouvez définir et qui utilisent des instructions. En programmant une routine, vous pouvez intervenir sur toutes les informations avant impression.

 Les lignes de commande de la présentation en cours d'exploration pour lesquelles une de ces possibilités a déjà été affectée  vous sont proposées.

Vous pouvez créer de nouvelles associations soit avec des macro-fonctions, soit avec des routines.

Les macros appartiennent à ce que l'on appelle un environnement.  Vous avez l'environnement général, qui vous donne des macros de type standard.

Vous pouvez avoir également des macros spécifiques à vos environnements produits.

Pour obtenir les routines générales, vous laisserez blanc dans votre environnement.

Vous changerez d'environnement en fonction de vos besoins pour récupérer la macro-fonction qui vous intéresse.

Les macros ont toutes des paramètres en Entrée et en Sortie.

Pour associer une macro-fonction ou une routine, vous devez déterminer à quel moment elle

 sera exécutée. Il s'agit de la commande.

Vous devez ensuite définir le numéro d'ordre d'inclusion de la macro ou de la routine à l'intérieur d'un même traitement. Il est conseillé de saisir les séquences de 10 en 10 pour pouvoir insérer d'autres macro/routines ultérieurement.

Une invite vous donne les macros, invite à partir de laquelle, en fonction de l'environnement choisi, vous pouvez rapatrier une macro.

Après avoir choisi l'environnement de sélection, vous pouvez choisir une macro  ou visualiser ses paramètres.

En visualisation, vous obtenez  les paramètres en entrée et les paramètres en sortie.

Les zones en entrée n'ont pas besoin d'être placées sur la maquette pour que les zones en sortie soient alimentées par les bonnes valeurs.

A chaque paramètre est associé un critère d'obligation et le type du champ  utilisé en paramètre.

Si vous avez sélectionné une macro, vous pourrez  mettre à  jour les arguments Entrée et Sortie de celle-ci.

Vous avez au niveau des arguments une aide par [F4] vous donnant la liste des informations disponibles. Ces informations proviennent du ficher de travail associé à la présentation.

Les routines disponibles sont par contre visualisables, mais vous ne pouvez pas les rapatrier par sélection.

Les instructions de la routine sont accessibles  à partir des lignes de commandes au niveau présentation ou  à partir de la routine elle-même.

Vous pouvez également copier ou supprimer  une routine, cette dernière opération étant sécurisée par une confirmation de suppression. Ces deux possibilités sont accessibles uniquement à partir de la consultation des routines disponibles.

La modification d'une routine permet d'intervenir sur les instructions la constituant. Cela demande une bonne connaissance de la syntaxe.

Vos obtenez alors un éditeur de macro et vous pouvez insérer, copier et supprimer des lignes.

Vous pouvez également exécuter la copie d'instructions à partir d'une autre routine, dans dans l'éditeur ou à partir de la liste des routines disponibles.

Vous pouvez effectuer des copies d'instructions selon la technique indiquée précédemment, mais cela se passe alors entre deux routines.

 Vous pouvez ainsi récupérer des routines mises au point sur d'autres environnements.

Les instructions de la routine demandée sont affichées, vous sélectionner les lignes à copier, en validant cela vous fait revenir sur la routine en cours de modification, il faut alors que vous utilisiez les caractères de positionnement "A" ou "B" sur la ligne de votre choix.

Pour créer une nouvelle routine, il suffit de vous placer sur la première ligne disponible dans la liste des routines existantes et de donner un nom et un libellé à cette nouvelle routine.

Il vous suffira ensuite d'intervenir en modification ou par copie d'instruction.

Vous pouvez également utiliser l'option de copie, en mettant en nom de routine réceptrice, un code routine n'existant pas elle sera alors créée et initialisée avec les instructions de la routine à partir de laquelle vous avez effectué la copie.

Une sauvegarde de la routine est systématiquement proposée en sortie de l'éditeur. Si vous ne voulez pas conserver les modifications effectuées, il faut alors répondre "N", "O" étant proposé par défaut.

Lors de la mise à jour ou de la création d'une routine, une aide vous est proposée au niveau des codes opérateurs, une invite vous donne les codes disponibles.

Vous vous positionnez alors sur une ligne quelconque (déjà paramétrée ou vide).

Si la ligne est déjà renseignée, Vous obtiendrez le détail des éléments constituant l'instruction et présenté de façon structurée en fonction de l'opération indiquée.

Si vous êtes en train de créer une ligne, vous obtenez alors un guide hiérarchisé.

Les arguments disponibles  varient selon le code opération sélectionné.

Sur l'ensemble des arguments, la touche [F4] fait appel à une fenêtre  vous permettant de gérer la définition de l'argument.

Certains arguments acceptent des valeurs spéciales.

Votre instruction peut être modifiée en mode pleine page, par saisie directe sur la ligne. Le code opération est contrôlé.

Les zones de totalisations déclarées sur la maquette sont récupérables avec une routine de type  ZZZZ$, n où ZZZZ est le nom de la zone totalisée et n le niveau de rupture.

Vous pouvez déclarer des zones de travail.

Cela est intéressant dans les routines pour des calculs divers, pour mémoriser des informations, par exemple.Pour cela, choisissez une des instructions de déclaration à votre disposition, en fonction du type de zone (numérique ou alphanumérique). Vous pouvez également créer des tableaux et des DS externes.

Si vous déclarez une zone numérique, vous devez saisir aussi un nombre de décimales. S'il n'y a pas de décimales, saisissez un zéro au niveau du  nombre de décimale.

La taille d'une zone numérique ne peut pas excéder 30 positions et 9 décimales et celle d'une zone alphanumérique 256 positions.

Vous avez à votre disposition également les instructions d'appels de programmes. Cela vous permet d'intégrer des programmes développés de façon classique (en RPG/400 par exemple).

Ces objets doivent exister dans une des bibliothèques de votre environnement de travail. Le nom du programme est limité à 8 caractères.

Ces appels peuvent être effectués avec des passages de paramètres. Dans l'opération APPELS PROGRAMMES vous utiliserez alors l'instruction PASSER_ PARAMETRE. Les valeurs alphanumériques à passer seront définies entre guillemets, les valeurs numériques sans guillemet.

Vous avez accès aux instructions de calcul classique, mais aussi  de calcul sur date (nouvelle date à partir de, délai entre deux dates, …).

Vous pouvez utiliser des conditions en les imbriquant.

Vous pouvez également manipuler des chaînes de caractères (concaténation, extraction de sous-chaîne).

 Les zones utilisées sont obligatoirement alphanumériques.

Vous pouvez mouvementer des valeurs dans les zones.

Les  lectures de fichiers sont des instructions équivalentes aux instructions de lecture du RPG/400.

Pour les utiliser, demandez conseil à un développeur sur RPG. Ceci dit la description sommaire suivante vous permettra d'évaluer les possibilités.

Les fichiers de base de données demandent un minimum de connaissance techniques.

Vous avez également à votre disposition des instructions de débranchements.  Elle peut s'avérer utile et est souvent conditionnée.

Cette instruction ne peut être utilisée que s'il n'y a pas de traitement de valorisation.