# Les pièces logiques

# Condition : Si | Sinon si | Sinon

# Présentation

L’opérateur conditionnel Si | Sinon si | Sinon permet de vérifier une ou plusieurs conditions. Dans le cas où une condition est vérifiée, il permet d’exécuter des instructions. Il peut être résumé à

Si <condition>
    ...
    liste d’instruction (Si)
    ...
Sinon si condition
    ... liste d’instruction (Sinon Si)
    ...
Sinon
    ...
    liste d’instruction (Sinon)
    ...

• Si la condition de l’opérateur Si est vérifiée, la liste d’instructions (Si) est exécutée.
• Si la condition de l’opérateur Sinon si est vérifiée, la liste d’instructions (Sinon si) est exécutée.
• Si toutes les conditions précédentes ne sont pas vérifiées, la liste d’instructions (Sinon) est exécutée.

Les opérateurs Sinon si et Sinon sont optionnels.

L’opérateur Sinon si est répétable.

Sélecteur conditionnel

Le sélecteur du nombre d'éléments est accessible via la petite étoile bleue située sur la pièce, vous pouvez configurer la structure conditionnelle, en utilisant les éléments Si, Sinon si | Sinon en les glissant déposant dans la zone de droite.

Condition

La condition - cellule en forme de losange - est renseignée avec une pièces logiques booléennes.

Liste d’instructions

Vous pouvez mettre dans la zone d’instructions, l’ensemble des instructions qui seront exécutées si la condition est vérifiée.

# Exemple d’utilisation

Voici un exemple d’utilisation de l’opérateur conditionnel Si où dans le cas où le formulaire est à l’étape "en cours", le champ du formulaire dénommé Date de départ est remplacé par la date du jour, au moment de l’exécution de l’instruction.

# État de création du formulaire : en cours de création | déjà créé

# Présentation

L’opérateur le formulaire est vérifie l’état de création d’un formulaire, s’il est déjà créé ou en cours de création.

Cet opérateur booléen renvoie vrai si la condition paramétrée est vérifiée.

Cet opérateur est utile pour distinguer les traitements ou calculs à effectuer uniquement lors de la création, comme l’initialisation de valeurs de certains champs, des traitements ou vérifications faits au cours de la vie du formulaire.

Sélecteur

Vous pouvez sélectionner de vérifier si le formulaire est

• en cours de création: retourne vrai si le formulaire n’avait pas été créé précédemment, il s’agit alors d’une création de formulaire.
• déjà créé: retourne vrai si le formulaire a déjà été créé par l’utilisateur.

# Exemple d’utilisation

Voici un exemple d’utilisation où, dans le cas où le formulaire est en cours de création, le champ Date de création est renseigné avec la date du jour et le champ Rapporteur est renseigné avec le compte de l’utilisateur connecté.

Le titre du formulaire est par la suite recalculé systématiquement suite à l’enregistrement avec le texte fixe Convention de puis le nom de l’utilisateur renseigné comme rapporteur.

Suite à la création du formulaire, si l’utilisateur connecté s’appelle John Doe, le titre du formulaire sera Convention de John Doe

# Est vide

# Présentation

L’opérateur le champ est vide permet de vérifier si un champ du formulaire est vide. L’opérateur renvoie vrai si le champ ciblé est vide.

Sélecteur du champ

Sélectionner dans cette cellule tout type de champ ou colonne, du formulaire dont vous voulez vérifier la valeur.

Sélecteur

Vous pouvez choisir de vérifier si le champ sélectionné est ou n’est pas vide

• est: retourne vrai si le champ du formulaire est effectivement vide
• n’est pas: retourne vrai si le champ du formulaire est renseigné, non vide

# Exemple d’utilisation

Voici un exemple d’utilisation de l’instruction où dans le cas où le champ responsable est vide, la valeur du champ Commentraire du responsable est supprimée après l’exécution de l’instruction.

# Comparaison mathématique

# Présentation

L’opérateur de comparaison mathématique de deux entrées permet de comparer mathématiquement deux entrées, si elles sont égales, différentes ou si l’une des entrées est supérieure ou inférieure à l’autre. L’opérateur renvoie vrai l’assertion est vérifiée.

Sélecteur du champ

Sélectionnez dans cette cellule tout type de champ ou colonne du formulaire ciblé par la vérification.

Sélecteur

Sélectionnez la méthode de comparaison parmi déroulante des méthodes de comparaison du champ sélectionné et la cellule n°2

• =: les deux entrées sont identiques
• ≠: les deux entrées sont différentes
• <: la valeur du champ est inférieure à la valeur de l’entrée
• ⩽: la valeur du champ est inférieure ou égale à la valeur de l’entrée
• >: la valeur du champ est supérieure à la valeur de l’entrée
• ⩾: la valeur du champ est supérieure ou égale à la valeur de l’entrée instructions sont ignorées.

#Cellule

Déposez dans cette cellule une pièce typée dont valeur est comparée avec la valeur du champ sélectionné

• Type : le type doit être compatible au type du champ sélectionné dans la cellule n°1

# Exemple d’utilisation

Voici un exemple de règle où un message d’alerte est affiché à l’utilisateur s’il renseigne une date de visionnage supérieure à la date du jour, au moment de l’enregistrement du formulaire.

Autre exemple de règle où un message d’erreur est affiché à l’utilisateur s’il définit dans le formulaire un voyage dont le mode de transport est Voiture et que le coût total par personne dépasse 200€

# Comparaison booléenne

# Présentation

L’opérateur de comparaison booléen de deux entrées vérifie si les deux entrées sont vraies (ET) ou au moins une des deux est vraie (OU). L’opérateur renvoie vrai l’assertion est vérifiée.

#Cellule

Déposez dans cette cellule une pièce opérateur de conditionnel, de forme hexagonale, qui a une valeur vrai ou faux.

Sélecteur

Sélectionnez la méthode de comparaison parmi déroulante des méthodes de comparaison de la cellule n°1 et la cellule n°2

• ET: retourne vrai si les deux entrées sont vraies
• OU: retourne vrai si au moins une des deux entrées est vraie

#Cellule

Comme pour la première cellule, vous pouvez déposer dans cette cellule une pièce opérateur de logique, qui a une valeur vrai ou faux et sera comparée à la valeur de la première cellule

# Exemple d’utilisation

Voici un exemple d’utilisation de l’opérateur où dans le cas où le champ Description, est vide ou bien que la longueur du texte Description dépasse les 300 caractères, un message d’avertissement est affiché à l’utilisateur.

Le titre est par la suite renseigné avec la règle de calcul composée du texte fixe Fiche convention n° suivi de la valeur du champ numéro de convention, de la convention renseignée dans le champ lien vers la convention.

# Négation

# Présentation

L’opérateur Non sur une entrée permet de retourner l’inverse de la valeur booléenne de l’entrée. C’est-à-dire que si l’entrée est vrai, l’opérateur retourne faux et vice versa.

Cellule

Déposez dans cette cellule une pièce opérateur de conditionnel, de forme hexagonale, qui a une valeur vrai ou faux.

# Exemple d’utilisation

Voici un exemple d’utilisation de l’opérateur où une erreur est affichée à l’utilisateur dans le cas où la Date et heure de début de l’événement n’est pas comprise entre la date du jour et le 31/12/2023

# Intervalle

# Présentation

L’opérateur valeur du champ entre deux entrées permet de vérifier si la valeur d’un champ, de type date ou de type nombre, se situe dans une fourchette, entre deux valeurs entrées. L’opérateur retourne vrai si la valeur du champ est bien entre les deux entrées.

Sélecteur du champ

Sélectionner dans cette cellule un champ du formulaire dont vous voulez comparer la valeur.

Les champs disponibles sont uniquement les champs de type

• date
• nombre

Cellule n°1

Déposez dans cette cellule n°1 la fourchette basse, pièce typée dont valeur est comparée avec la valeur du champ sélectionné

Les types compatibles sont les types dates et nombres. La pièce doit être identique au type du champ sélectionné.

Cellule n°2

Déposez dans cette cellule n°2 la fourchette basse, pièce typée dont valeur est comparée avec la valeur du champ sélectionné

Les types compatibles sont les types dates de nombre. La pièce doit être identique au type du champ sélectionné et la cellule n°1.

# Exemple d’utilisation

Voici un exemple d’utilisation de l’opérateur où dans le cas où le champ Coût total a une valeur située entre 0 et 3 000, le champ commentaire budget est renseigné avec le texte multiligne suivant Devis acceptable \n - Commentaire renseigné automatiquement et renseigné avec un texte multiligne différent dans le cas contraire.

# Comparaison : commence par / contient / fini par

# Présentation

L’opérateur valeur du champ commence par / contient / fini par permet de comparer la valeur d’un champ, de type texte par rapport à une autre chaine de caractère. Il est possible de vérifier si la valeur du champ commence par, contient ou fini par la valeur textuelle. L’opérateur renvoie vrai si la condition est vérifiée.

Sélecteur du champ

Sélectionnez dans cette cellule un champ du formulaire, de type texte dont vous voulez comparer la valeur à la valeur de la cellule n°2.

Les champs disponibles sont uniquement les champs de type

• texte

Sélecteur

Sélectionnez le critère de comparaison parmi déroulante des méthodes suivantes :

• commence par: la valeur du champ sélectionné commence avec la chaine de caractères de la cellule
• contient: la valeur du champ sélectionné contient la chaine de caractères de la cellule
• fini par: la valeur du champ sélectionné fini avec la chaine de caractères de la cellule

Cellule

Déposez dans cette cellule chaine de caractère, de type texte que vous voulez comparer à la valeur du champ.

# Exemple d’utilisation

Voici un exemple d’utilisation de l’opérateur qui vérifie si le champ Corps du mail contient le terme ci-joint et si aucun fichier n’est attaché au formulaire. Dans ce cas, un avertissement est affiché à l’utilisateur.

# L'étape actuelle est|n'est pas

# Présentation

L’opérateur étape actuelle est|n'est pas permet de vérifier si le formulaire est ou n'est pas à une étape particulière du cycle de vie.

L’opérateur retourne vrai si le formulaire si la condition configurée est respectée.

Sélecteur du comparateur

Sélectionnez le critère de comparaison parmi déroulante des méthodes suivantes :

• est: permet de vérifier si le formulaire est bien à l'étape définie dans le sélecteur de l'étape
• n'est pas: permet de vérifier si le formulaire est bien à une étape différente de celle définie dans le sélecteur de l'étape

Sélecteur de l'étape

Le sélecteur d'étape propose la liste d'étapes configurées dans le cycle de vie.

Choisissez à travers ce sélecteur par rapport à quelle étape vous souhaitez comparer l'étape du formulaire.

# Exemple d’utilisation

Voici un exemple d'utilisation de l'opérateur où, dans le cas où le formulaire n'est pas à l'étape validé lors de l'enregistrement, un avertissement est affiché à l'utilisateur, le prévenant qu'aucun calcul n'est effectué.

# L'étape précédente est|n'est pas

# Présentation

L’opérateur étape précédente est|n'est pas permet de vérifier si le formulaire était ou n'était pas à une étape particulière du cycle de vie avant d'être à l'étape actuelle.

Cette pièce permet de vérifier un passage entre deux étapes et donc configurable uniquement dans les règles métier exécutées lors de l'arrivée d'une étape.

L’opérateur retourne vrai si le formulaire si la condition configurée est respectée.

Sélecteur du comparateur

Sélectionnez le critère de comparaison parmi déroulante des méthodes suivantes :

• est: permet de vérifier si le formulaire était bien à l'étape définie dans le sélecteur de l'étape avant d'être à l'étape actuelle
• n'est pas: permet de vérifier si le formulaire n'était pas à l'étape définie avant d'être à l'étape actuelle.

Sélecteur de l'étape

Le sélecteur d'étape propose la liste d'étapes configurées dans le cycle de vie.

Choisissez à travers ce sélecteur par rapport à quelle étape vous souhaitez comparer l'étape dans laquelle était le formulaire.

# Exemple d’utilisation

Voici un exemple d'utilisation de l'opérateur où, le formulaire passe à l'étape Validé. Dans le cas où l'étape précédente était l'étape dénommée Départ, le champ Date de validation est mis à jour avec la date du jour. Dans le cas où le formulaire était à une étape différente, le champ n'est pas mis à jour.

# Le formulaire d'origine existe|n'existe pas

# Présentation

L’opérateur Le formulaire d'origine existe|n'existe pas, accessible uniquement dans les règles métier de préremplissage, permet de vérifier si la demande de création provient d’un champ type Lien.

Si l’utilisateur a sélectionné le choix « Créer une nouvelle entrée » depuis un champ de type lien d'autre formulaire, cet opérateur booléen renvoie vrai.

Si le formulaire est créé depuis sa catégorie (et non depuis le champ lien d'un autre formulaire), la fonction retourne faux.

Cet opérateur est utile pour préremplir les champs avec un traitement différent en fonction de si le formulaire est créé à partir d'un autre formulaire ou depuis sa catégorie.

Sélecteur

Vous pouvez sélectionner de vérifier si un formulaire à l'origine de création :

• Existe: permet de vérifier si l’utilisateur a sélectionné le choix « Créer une nouvelle entrée » depuis un champ de type lien d'autre formulaire
• N'existe pas: permet de vérifier si le formulaire est créé depuis sa catégorie (et non depuis le champ lien d'un autre formulaire)

# Exemple d’utilisation

Voici un exemple d’utilisation où, lors de la création d'un formulaire de la catégorie Facture, où

• le champ Date de facturation est prérempli avec la date du jour,
• le contact est prérempli avec le compte de l'utilisateur connecté
• et dans le cas où le formulaire est créé à partir d'un formulaire d'origine, c'est-à-dire que la pièce Le formulaire d'origine existe renvoie vrai, et que le Formulaire d'origine, est de la catégorie Client, les informations du client sont alors préremplies dans la facture

# Le formulaire d'origine est de la catégorie

# Présentation

L’opérateur Le formulaire d'origine est de la catégorie, accessible uniquement dans les règles métier de préremplissage, permet de vérifier si le formulaire à l’origine de la demande de création est de la catégorie indiquée dans le sélecteur de catégorie.

Cette fonction renvoie vrai si le formulaire est créé depuis un lien et que ce lien est conforme à la catégorie indiquée. Cette fonction renvoie faux dans le cas contraire, c'est-à-dire que si la demande de création est faite depuis la page principale de la catégorie ou bien depuis un lien d'une catégorie différente.

Cet opérateur est utile pour préremplir les champs avec un traitement différent en fonction du type de formulaire à l'origine de la création.

Sélecteur de la catégorie

Le sélecteur de la catégorie, propose des catégories de formulaires ayant un lien vers la catégorie de formulaire courante.

Choisissez à travers ce sélecteur par rapport à quelle catégorie vous souhaitez vérifier l'origine de la création du formulaire.

# Exemple d’utilisation

Voici un exemple d’utilisation où, lors de la création d'un formulaire de la catégorie Facture, où

• le champ Date de facturation est prérempli avec la date du jour,
• le contact est prérempli avec le compte de l'utilisateur connecté
• et dans le cas où le formulaire est créé à partir d'un formulaire d'origine, et que ce formulaire d'origine, est de la catégorie Client, configurée dans la pièce, les informations du client depuis le formulaire client sont alors préremplies dans la facture