1.6 Actions

Une condition retourne la valeur Vrai ou la valeur Faux. Cette valeur est calculée différemment selon le type de condition. Pour les conditionnelles, seul le résultat (vrai ou faux) est retourné, tandis que pour les sélections de données ou les Pour chaque, la condition retourne la présence ou l’absence de valeur.

Cela a une importance pour l’exécution des actions, puisque celle-ci dépend de la valeur retour du booléen de la condition.

1.6.1 Actions sur les IHM

1.6.1.1 Affectation d'un contrôle

• Choisir un écran dans la liste des écrans, puis choisir un contrôle de cet écran.

• Créer une expression (souvent vide dans ce cas puisqu’il s’agit d’une affectation)

• Choisir un nouvel opérande (à affecter au contrôle) en cliquant sur Ajouter un opérande.

1.6.1.2 Redirection vers un écran

• Choisir un écran dans la liste des écrans.

1.6.1.3 Réinitialiser les contrôles d'un écran ou d'une boite de dialogue

• Choisir un écran dans la liste des écrans.

1.6.1.4 Afficher une boite de dialogue

• Sélectionner une boîte de dialogue dans la liste proposée.

1.6.1.5 Fermer une boite de dialogue

• Sélectionner une boîte de dialogue dans la liste proposée.

1.6.1.6 Afficher une boite de message ou de notification

• Choisir une boîte de message dans la liste proposée.

• Il est possible de personnaliser le message contenu dans une boîte de message en créant une expression, et en choisissant un nouvel opérande.

1.6.1.7 Charger une application

• Sélectionner l’application à exécuter parmi la liste d’applications disponibles sur la plateforme.

1.6.1.8 Ouvrir une URL Web

Renseigner un titre, une description optionnelle et l’URL web.

• Il est possible de choisir d’ouvrir l’URL dans un nouvel onglet ou dans l’onglet courant.

1.6.2 Actions sur les bases de données

1.6.2.1 Insertion de ligne dans une base de données

• Sélectionner un modèle de données, puis sélectionner une table du modèle.

• Sélectionner les colonnes (à renseigner).

• Sélectionner une colonne dans la liste des colonnes de la règle, puis créer une expression (souvent vide dans ce cas). Choisir un nouvel opérande (à insérer dans la base) ; en règle générale, un contrôle d’écran (depuis un formulaire d’insertion) est utilisé.

1.6.2.2 Mise à jour de ligne dans une base de données

• Sélectionner un modèle de données, puis une table du modèle où une ligne est à mettre à jour.

• Sélectionner les attributs (qui pourront faire l’objet d’une modification).

• Filtrer les résultats pour sélectionner la ligne à mettre à jour, en sélectionnant l’opérateur et les opérandes pour l’expression.

• Choisir une colonne à mettre à jour dans la liste des colonnes, puis créer une expression et choisir un nouvel opérande (à insérer dans la base).

Dans l’exemple, un opérateur de chaîne de caractères UPPER est utilisé pour mettre automatiquement les mots saisis en majuscule.

1.6.2.3 Suppression de ligne dans une base de données

• Sélectionner un modèle de données, puis sélectionner la table du modèle dans laquelle une ligne est à supprimer.

• Créer une expression logique pour comparer la valeur à supprimer. Se positionner sur l’expression et sélectionner les opérandes (le premier pointant sur une colonne de la table, et le deuxième indiquant la valeur de la colonne de laquelle la ligne sera supprimée).

1.6.3 Actions sur les jeux de données

1.6.3.1 Effacer un jeu de données (efface toutes les lignes contenues dans le jeu de données)

Sélectionner un jeu de données à effacer.

1.6.3.2 Sélection d'une ligne d'un jeu de données

• Sélectionner un jeu de données.

• Créer une expression et sélectionner un nouvel opérande.

1.6.3.3 Trier un jeu de données

• Sélectionner le jeu de données à trier.

• Cliquer sur Ordonner par à droite de l’écran. Sélectionner le champ du jeu de données sur lequel effectuer le tri, ainsi que le sens du tri.

1.6.3.4 Insertion de données dans un jeu de données

• Sélectionner un jeu de données.

• Sélectionner les champs à renseigner dans le jeu de données.

• Sélectionner un champ dans le jeu de données de l’action créée, et choisir le type d’expression (pas d’opérateur recommandé dans ce cas).

• Sélectionner un nouvel opérande dont la valeur sera affectée au champ sélectionné.

Vue d’ensemble d’une règle d’insertion dans un jeu de données

1.6.3.5 Mise à jour de données dans un jeu de données

• Sélectionner un jeu de données.

• Sélectionner les champs à mettre à jour dans le jeu de données.

• Créer une expression pour sélectionner la ligne à mettre à jour. Cliquer sur Filtrer les lignes pour sélectionner l’opérateur, puis les opérandes pour l’expression (Id et constante).

Sélectionner l’opérateur = et le champ Id de l’entité à mettre à jour

• Sélectionner un champ dans le jeu de données de l’action créée. Choisir le type d’expression (pas d’opérateur recommandé dans ce cas). Sélectionner un nouvel opérande (à insérer dans le jeu de données).

1.6.3.6 Suppression de données dans un jeu de données

• Sélectionner le jeu de données où la ligne est à supprimer.

• Créer une expression logique pour comparer la valeur à supprimer. Sélectionner les opérandes (le premier pointant sur une colonne du jeu de données, et le deuxième pour indiquer la valeur de la colonne de laquelle la ligne est supprimée).

1.6.4 Actions sur les fichiers

1.6.4.1 Télécharger un fichier

Voici un exemple servant à illustrer cette action. Un fichier est envoyé au serveur, puis celui-ci est ensuite téléchargé sur le poste client.

• L’interface de démonstration est la suivante :

Le composant Table Upload envoie le fichier au serveur, puis le bouton Télécharger récupère le fichier sur ce serveur.

• Téléchargement du fichier uploadé.

  L’action Télécharger un fichier permet de télécharger un fichier sur le poste client. Elle prend en paramètre l’identifiant du fichier. Il faut rattacher au déclencheur À la validation du bouton Télécharger le comportement adéquat.

La première action de la règle du comportement rattaché au bouton permet d’affecter une variable au contrôle Table upload. La variable contient l’identifiant du fichier envoyé. La seconde action de la règle permet de télécharger le fichier en récupérant la variable précédemment affectée.

Seul l’identifiant du fichier est supporté par l’action Télécharger un fichier. Il n’est pas possible de renseigner à l’action le chemin (/mondossier/monfichier.ext) vers un fichier quelconque sur le serveur.

1.6.4.2 Sauvegarder un fichier

Par défaut, les fichiers uploadés ne sont disponibles que pour la durée de la session. Ensuite, ils sont supprimés du serveur.

Pour éviter cela, il est possible de les sauvegarder. Utiliser l’action Sauvegarder un fichier et passer en paramètre l’identifiant du fichier à sauvegarder.

Si on prend l’exemple précédent (partie Télécharger un fichier), le fichier uploadé est sauvegardé sur le serveur.

Penser à sauvegarder l’identifiant du fichier (en base de données par exemple) sinon le fichier sauvegardé sur le serveur ne sera plus récupérable.

1.6.4.3 Supprimer un fichier

Il est possible de supprimer du serveur un fichier sauvegardé. Pour cela, il faut utiliser l’action Supprimer un fichier et lui passer en paramètre l’identifiant du fichier à supprimer.

1.6.4.4 Générer un rapport

Cette action permet de générer un rapport (cf. partie Gestion des rapports).

• Remplir les différents jeux de données et variables nécessaires au rapport.

• Utiliser l’action :

Plusieurs options sont disponibles :

• Un rapport peut être généré en différents formats (PDF, XLS, XLSX, DOCX, HTML, etc.). Pour cela, il suffit de choisir le bon format dans la liste Type.

• L’identifiant du rapport peut être récupéré dans une variable. Il est ainsi possible de le sauvegarder sur le serveur (non sauvegardé par défaut).

• Le rapport peut porter un nom dynamique. Pour ce faire, utiliser l’option Nommer le fichier généré située en haut à droite. Si cette option n’est pas renseignée, alors le fichier généré a le format suivant : nomrapport_num.type

Une fois l’action exécutée, le rapport est téléchargé sur le poste client (sauf dans le cas des services métiers et des planifications).

1.6.4.5 Lire un fichier

Cette action permet de Lire un fichier, c’est à dire de transférer les données d’un fichier Excel, CSV ou Access vers un jeu de données. Pour cela, des imports créés dans le module Gérer les imports de fichier sont utilisés (cf. partie Gestion des imports).

Lors de la création, il faut renseigner :

1.6.5 Actions d'appels externes

1.6.5.1 Appeler une méthode métier

Cette action permet d’appeler une méthode métier (cf. partie Conception : Création de services métiers).

• Sélectionner le service métier puis la méthode métier désirés :

Une fois cette étape validée, sélectionner les attributs passés afin de renseigner les paramètres de la méthode :

Ensuite, sélectionner les attributs retournés pour renseigner les attributs retournés de la méthode :

Renseigner les attributs passés et retournés :

1.6.5.2 Appeler une méthode Web

Cette action permet d’appeler une méthode web (cf. partie Conception : Gérer les services web).

• Sélectionner le service web puis la méthode web désirés.

• Une fois cette étape validée, cliquer sur Sélectionner les attributs passés pour renseigner les paramètres de la méthode.

• Ensuite, cliquer sur Sélectionner les attributs retournés pour renseigner les attributs retournés de la méthode.

• Puis, renseigner les attributs passés et retournés.

 

1.6.5.3. Exécuter une fonction

Cette action permet de faire appel à une librairie intégrée à la plateforme.

• Sélectionner l’action créée.

• Sélectionner une librairie et un opérateur.

Sélectionner un nouvel opérande.

1.6.6 Actions sur les utilisateurs et groupes

1.6.6.1 Ajouter un utilisateur à un groupe

Cette action permet d’ajouter un utilisateur déclaré dans la plateforme, à un groupe d’utilisateurs.

• Sélectionner le groupe auquel ajouter l’utilisateur.

Créer une expression contenant le login de l’utilisateur à ajouter.

Utilisation d’une opérande de type Constante contenant l’identifiant de l’utilisateur

1.6.6.2 Retirer un utilisateur d'un groupe

Cette action permet de retirer un utilisateur d’un groupe.

• Sélectionner le groupe duquel retirer l’utilisateur.

Créer une expression contenant le login de l’utilisateur à retirer.

Utilisation d’une opérande de type Constante contenant l’identifiant de l’utilisateur

1.6.6.3 Mettre à jour les paramètres d'un utilisateur

Cette action permet de modifier les paramètres d’un utilisateur suivants :

• Nom

• Prénom

• Adresse mail

• Ancien mot de passe

• Mot de passe

• Numéro de téléphone

• Adresse postale

• Code postal

• Ville

• Langue

• État (actif / inactif)

Sélectionner les attributs à modifier.

Pour sélectionner plusieurs attributs, laisser la touche Ctrl du clavier enfoncée lors du clic.

Créer pour chaque attribut, une expression contenant les modifications à apporter.

1.6.7 Autres actions

1.6.7.1 Affectation d'une variable

Choisir la variable dans la liste des variables.

Créer une expression (souvent vide dans ce cas), puis choisir un nouvel opérande (à affecter à la variable).

Vue d’ensemble d’une règle d’affectation de variable

1.6.7.2 Exécuter une sous-règle

Une sous-règle fonctionne de la même façon qu’une règle. Elle possède :

• une partie Liste des conditions

• une partie Liste des conditions vérifiées

• une partie Liste des conditions non vérifiées

1.6.7.3 Exécuter un comportement

Il est possible d’appeler un autre comportement à travers une règle.

La plateforme Ontomantics gère la récursivité, c’est-à-dire qu’il est possible d’appeler le comportement dans lequel l’action est située.

1.6.7.4 Interrompre l'exécution des comportements

Cette action permet d’interrompre l’exécution opérationnelle selon plusieurs niveaux :

• Tous les comportements de l’événement en cours en levant une exception : interrompt l’exécution de tous les comportements rattachés au déclencheur appelé et déclenche une exception.

• Tous les comportements de l’événement en cours : interrompt l’exécution de tous les comportements rattachés au déclencheur appelé.

• Comportement en cours (Actions): interrompt uniquement l’exécution du comportement en cours. Les comportements qui suivent sont exécutés.

• Toutes les règles parentes (Autres) : interrompt l’exécution de toutes les règles dont la règle en cours est l’enfante.

• Règle parente uniquement : interrompt l’exécution de la règle parente.

• Itération de la règle parente :

• Sous-Règle en cours : interrompt uniquement l’exécution de la règle en cours. Les autres règles du comportement sont exécutées, ainsi que tous les autres comportements rattachés au déclencheur.

1.6.7.5 Afficher un log

Cette action permet d’afficher un message dans le journal d’information système.

• Choisir le niveau de log dans lequel afficher le message :

  • Trace : niveau le plus fin de granularité du journal. Attention, le fichier de log à ce niveau de détail peut être très volumineux.

  • Debug : affiche les informations de débogage.

  • Info : affiche les informations.

  • Alerte : affiche uniquement les informations de type alerte.

  • Erreur : affiche uniquement les informations de type erreur.

L’action Afficher un log n’a pas pour effet d’afficher le contenu du journal, mais uniquement d’écrire un message dedans.

• Créer l’expression contenant le message à afficher.

• Le message s’affichera ensuite dans la console de débogage de la plateforme.

1.6.7.6 Prendre le verrou

Cette action permet de prendre un verrou (cf. partie Gestion des verrous).

Pour prendre un verrou, il faut sélectionner le verrou désiré et lui affecter une valeur. S’il est déjà pris, une exception est levée et l’exécution du comportement est interrompue.

1.6.7.7 Libérer le verrou

Cette action permet de libérer un verrou (cf. partie Gestion des verrous).

Pour libérer un verrou, il suffit de le sélectionner et lui spécifier la valeur à libérer. Si le verrou ne connaît pas cette valeur, une alerte est levée dans les logs de la plateforme mais l’exécution de la règle ou du comportement n’est pas interrompue.

1.6.7.8 Utilisation de fonctions sur les dates

Ontomantics permet d’utiliser diverses fonctions sur les dates. Elles sont disponibles lors de la création d’une expression, dans le menu Librairies (il s’agit de librairies importées dans Ontomantics). Dans la liste des librairies, sélectionner le sous-menu library.Date. Ce sous-menu donne accès à toutes les fonctions portant sur les dates. Chacune de ces fonctions prend un ou plusieurs arguments à renseigner, et retourne une valeur calculée à partir de ces arguments.

L’exemple ci-dessous consiste à insérer une heure dans une table de la base de données. La fonction stringtoDate permet, à partir d’une chaîne de caractère (utilisée dans un contrôle d’écran), d’obtenir un format date (utilisé dans la base de données). Dans les paramètres de la fonction, il faut sélectionner le contrôle concerné (qui renvoie un VarChar), et le format dans lequel la date est construite (comme il s’agit ici d’une heure, le format HH:mm:ss est utilisé). La fonction renvoie alors une heure au format date, exploitable par la base de données.

Il est à noter que toutes les utilisations de fonctions, quelles qu’elles soient, sont basées sur un modèle similaire, à savoir : la création d’une expression, la sélection de la fonction dans une librairie, et la sélection des arguments pour la fonction.