STUDIO ADM

A quoi servent les Actions Directes Métiers (ADM) ? 🧐

On veut lancer une requête REB pour pouvoir réaliser une action depuis une application standard ou paramétrée.

Par exemple :

depuis les articles, on veut pouvoir lancer une action au clic, qui vérifiera le stock de l’article courant et mettra à jour une variable spécifique suivant sa valeur
depuis les devis, on veut pouvoir sélectionner un devis en en créer une nouvelle version
…

Les actions directes métiers ADM répondent à ces besoins !

Comment les utiliser ?

Les ADM peuvent être insérées dans toute application standard ou paramétrée, au même titre par exemple qu'un tableur, une PSD ou une commande système.

Un message de confirmation peut être paramétré.

Créer une ADM

Dans cet exemple, on souhaite créer une ADM, lancée depuis l’application des « Articles Standards », qui vérifiera le stock de l’article courant et suivant sa valeur mettra à jour une variable spécifique.

Etape 1 : créer la requête

Tout d’abord, il faut créer la requête REB que l’ADM va exécuter. Notre requête s’appellera « StkArtNul ». Voici le détail des opérations effectuées par cette requête :

COMMENTAIRE : "Recherche du stock global pour l'article courant."

RECH TBD/SOC STO STGlobal AVEC STO STGlobal.RefArt = SCR.GenRefArt :

VLO.RefArt = STO STGlobal.RefArt

VLO.Valeur = CGL.NON

SI STO STGlobal.QtePhyInt <= CLO.0

VLO.Valeur = CGL.OUI

FIN_BLOC

VLO.FCT = MAJ-VAR-SPE( TYPE-VARIABLE= VAS , TYPE= LOGIQUE , NOM-VARIABLE=

StockNul , CLE-1= CLO."R" , CLE-2= VLO.RefArt , CLE-3= CLO."" , VALEUR= VLO.Valeur )

FIN_BLOC

Contexte exécution en entrée :

Contexte classique des « documents et tableurs » : SCR.CRICle (ou remplaçante définie sur application), SCR.CRIListeCles, SCR.DIATab, SCR.DiaIde.
Variables paramétrées par défaut sur ADM.

En sortie :

LC-ERREUR
LC-WARNING

VBP.IAP_ModeRea : alimenter la variable dans la règle REB avec la valeur « ACT » pour actualiser la liste (apparition des nouvelles lignes et disparition des lignes supprimées) ou « RAF » pour la rafraîchir (mise à jour des enregistrements déjà affichés seulement)

Il est à noter que les ADM permettent de recevoir le contexte de l’application appelante, on récupère donc dans notre cas la SCR.GenRefArt des « Articles standards ».

Etape 2: Créer l’ADM

Puis, il faut créer une ADM, en remplissant les champs obligatoires, telle que la référence (Action Métier).

Action Métier: Désigne la référence de l’action métier.
Désignation: Définit une désignation de l’ADM, correspond à une description de l’action.
Libellé Court: Définit un libellé de l’ADM, qui sera affiché dans l’application qui appellera cette action.
Mot Directeur: Mot Directeur.
Domaine: Domaine de classement.
Famille: Famille de classement. Disponible depuis « Paramètres Toute Société / Famille Domaine ».
Sous-Famille: Sous-famille de classement. Disponible depuis « Paramètres Toute Société / Sous-Famille Domaine ».
Commentaire: Permet d’ajouter un commentaire de l’ADM.

Volet « Démarrage »

Confirmation ? : Si vous souhaitez avoir un message de confirmation avant de lancer la requête, il vous suffit de cocher le champ « Confirmation ? » et de remplir le champ « Message » ci-dessous par le texte que vous voulez afficher.
Message: Contenu du message de confirmation.

Requête DIALOG: On entre ici la requête qui gère l’action, créée lors de l'étape précédente
Intégrité MAJ: Permet d'indiquer si on gère ou non l'intégrité des mises à jour dans lors de l'exécution de la requête.
- Si l'intégrité des mises à jour est gérée, si une instruction LC-ERREUR est rencontrée lors de l'exécution de la requête, toutes les mises à jour faites dans cette requête sont annulées.
- Si l'intégrité des mises à jour n'est pas gérée, si une instruction LC-ERREUR est rencontrée lors de l'exécution de la requête, les mises à jour faites ne sont pas annulées.
Critère Défaut: Espace d’initialisation des variables SCR et VCR de l’ADM.
Détail: Visualisation des variables SCR avec leurs valeurs respectives.

Etape 3 : Intégrer l’action dans l’Application

Comment intégrer une ADM dans une application ?

Pour les applications paramétrées

Pour les applications paramétrées (Tableur Dynamique, Liste Paramétrée, Couplage, etc…) il faut passer par la liste des actions métier de l’onglet « Actions ».

Voir sur les fiches relatives à l’application paramétrée en question !

Pour les applications standard

Par exemple dans l’application des « Articles Standards »: on commence par faire clic droit dans le coin haut gauche de la liste des Articles, puis on clique sur “Définition des Actions”:

Dans l’écran qui s’affiche ensuite, on peut venir ajouter l’ADM:

Les actions “Monter” et “Descendre” permettent d’ordonner les actions dans l’ordre souhaité:

➡️ Il ne reste plus qu’à fermer la liste et redémarrer l’application pour voir la ou les nouvelles actions !

Comment exécuter une ADM ?

Depuis la Barre de Commande :

Depuis le menu contextuel :