update(2021.1): docs/images/fr and docs/content/fr update

Bonitasoft-Community · Feb 3, 2021 · 191e875 · 191e875
1 parent 5c71cf0
commit 191e875
Show file tree

Hide file tree

Showing 32 changed files with 139 additions and 124 deletions.
diff --git a/docs/fr/01-bpmn-design.md b/docs/fr/01-bpmn-design.md
@@ -28,7 +28,10 @@ Le pool du processus devra contenir les éléments BPMN suivants :
 
 ## Instructions pas à pas
 1. Démarrer le Studio Bonita
-1. Créer un nouveau diagramme de processus
+1. Sur la page d'accueil du Studio, cliquer sur **Nouveau projet** dans le menu Concevoir
+1. Entrer le nom du projet *"DemandeConges"*
+1. Créer un nouveau diagramme de processus 
+    ![Nouveau diagramme](images/ex01/ex1_10.png)
 1. Spécifier le nom du diagramme et celui du processus :
    - Cliquer sur le menu **Fichier / Renommer le diagramme...** en haut du Studio
    - Entrer *DiagrammeDemandeConges* pour le nom du diagramme et *DemandeConges* pour celui du pool et *1.0.0* pour la version du diagramme et du pool  

diff --git a/docs/fr/02-data-contract.md b/docs/fr/02-data-contract.md
@@ -50,24 +50,27 @@ Ajouter un contrat sur l'étape *Valider demande* en utilisant l'assistant avec
    - Dans le menu supérieur du Studio, cliquer sur **Fichier / Dupliquer le diagramme...**
    - Mettre à jour les numéros de version du diagramme ET du processus (pool)
 1. Créer le BDM *DemandeConges* :
-   - Naviguer dans le menu **Développement / Modèle de Données Métier / Définir...**
-   - Cliquer sur **Nouvel Objet Métier** (A), dans la liste d'objets métiers
-   - Nommer l'objet *DemandeConges* (B) (il s'agit d'un nom technique, il faut donc omettre les espaces, accents et autres caractères spéciaux)
-   - Avec l'objet *DemandeConges* sélectionné, ajouter les attributs suivants (C) :
+   - Naviguer dans le menu **Développement / Modèle de Données Métier / Définir...** L'éditeur de Modèle de données métier s'ouvre.
+   - Renommer l'objet initialisé par défaut **BusinessObject** dans la liste d'objets métiers en *DemandeConges* (A) (il s'agit d'un nom technique, il faut donc omettre les espaces, accents et autres caractères spéciaux)
+   - Avec l'objet *DemandeConges* sélectionné, ajouter les attributs suivants (B) :
 
     Nom | Type | Multiple | Obligatoire
     --- | ---- | -------- | -----------
     *idDemandeur* | `Long` | ◻ | ☑
     *dateDebut* | `Date only` | ◻ | ☑
-    *nombreJours* | `Entier` | ◻ | ☑
-    *estApprouvee* | `Booléen` | ◻ | ◻
+    *nombreJours* | `Integer` | ◻ | ☑
+    *estApprouvee* | `Boolean` | ◻ | ◻
 
     ![définition du modèle de données métier](images/ex02/ex2_01.png)
 
-    - Cliquer sur **Terminer**
-    - Le message suivant s'affiche pour confirmer le déploiement du BDM
+    - Sauvegarder. Le message suivant s'affiche pour indiquer qu'il faut déployer le BDM
 
-    ![message d'information déploiement du BDM](images/ex02/ex2_10.png)
+    ![message d'information déploiement du BDM](images/ex02/ex2_09.png)
+
+    - Cliquer sur le bouton ![icone déploiement](images/ex02/ex2_11.png) dans l'éditeur de BDM pour déployer le BDM.  
+    Le message suivant indique que le BDM a été déployé avec succès.
+
+    ![message déploiement réussi du BDM](images/ex02/ex2_10.png)
 
     - Cocher l'option **Ne plus me montrer ce message**
     - Cliquer sur **Ok**
@@ -133,6 +136,7 @@ Ajouter un contrat sur l'étape *Valider demande* en utilisant l'assistant avec
 
    return demandeCongesVar
    ```
+   ![editeur expression script](images/ex02/ex2_12.png)
 
    - Le script va initialiser la variable métier en utilisant les données du contrat et l'identifiant de l'auteur de la demande
    - Cliquer sur le bouton **OK** pour fermer l'éditeur d'expression

diff --git a/docs/fr/03-forms.md b/docs/fr/03-forms.md
@@ -24,11 +24,14 @@ Créer les formulaires suivants :
    ![création d'un formulaire](images/ex03/ex3_01.png)
 
    - Cela va ouvrir l'UI Designer dans votre navigateur web avec un nouveau formulaire généré automatiquement à partir de la définition du contrat d'instanciation
+
+   ![Initialisation du formulaire dans UID](images/ex03/ex3_02.png)
+
 1. Renommer le formulaire :
    - Utiliser le champ texte en haut de l'écran pour renommer le formulaire depuis *newForm* vers *remplirDemandeConges* (il s'agit d'un nom technique, il faut donc omettre les espaces, accents et autres caractères spéciaux)
    - Cliquer sur le bouton **Enregistrer**
 1. Changer le titre du formulaire :
-   - Sélectionner le widget *Demande* en haut du formulaire.
+   - Sélectionner le widget **Titre** *Demande* en haut du formulaire.
    - Dans la section à droite de l'écran, éditer les propriétés suivantes :
 
    Propriété | Valeur
@@ -37,17 +40,17 @@ Créer les formulaires suivants :
    Niveau du titre | Niveau 2
    Alignement | au centre
 
-1. Changer le widget *Date Debut* :
+1. Changer le widget **Date Picker** *Date Debut* :
    - Sélectionner le widget *Date Debut* et éditer les propriétés suivantes :
 
    Propriété | Valeur
    --------- | ------
    Libellé | Date de début
    Format technique de la date | dd/MM/yyyy
    Placeholder | jj/mm/aaaa
-   Libellé du bouton Aujourd'hui | Aujourd'hui
+   Afficher le bouton Aujourd'hui | non
 
-1. Changer le widget *Nombre Jours* :
+1. Changer le widget **Input** *Nombre Jours* :
    - Sélectionner le widget *Nombre Jours* et éditer les propriétés suivantes :
 
    Propriété | Valeur
@@ -68,7 +71,7 @@ Créer les formulaires suivants :
    }
    ```
 
-1. Changer le widget *Submit* :
+1. Changer le widget **Button** *Submit* :
    - Sélectionner le widget *Submit*
    - Changer son libellé en *Soumettre*
 
@@ -85,8 +88,9 @@ Créer les formulaires suivants :
 
    - On notera les points suivants dans l'aperçu :
      - Le widget présentant l'erreur n'est pas visible
+     - Il est possible de tester l'aperçu sur différents périphériques, du mobile au grand écran
      - Le bouton *Soumettre* est désactivé par défaut (ceci est dû à la validation fournie par le conteneur de formulaire)
-     - Le bouton *Soumettre* est activé quand le contenu du formulaire est valide
+     - Le bouton *Soumettre* est activé quand le contenu du formulaire est valide  
 
    > **Note :** il n'est pas possible de soumettre le formulaire depuis l'aperçu même lorsque ce dernier est valide.
 
@@ -96,19 +100,17 @@ Créer les formulaires suivants :
    - Dans le Studio, sélectionner l'étape *Valider demande*
    - Naviguer dans l'onglet **Exécution / Formulaire**
    - Cliquer sur l'icône **Crayon** du champ **Formulaire cible** pour ouvrir l'UI Designer sur un nouveau formulaire
-   - Répondre **Oui** à la question concernant l'ajout de widgets en lecture seule
+   - Répondre **Oui** à la question concernant l'ajout de widgets en lecture seule 
+
+   > **Note :** le formulaire a été généré automatiquement à partir du BDM et du contrat, et affiche en lecture seule les données du BDM qui ne sont pas attendues par le contrat à cette étape.
 
 1. Renommer le formulaire :
    - Depuis le UI Designer, renommer le formulaire en  *validerDemandeConges* et l'enregistrer
 
 1. Récupérer les informations concernant le demandeur
    - Cliquer sur le bouton **Créer une nouvelle variable** pour définir une variable avec les propriétés suivantes :
 
-   Propriété | Valeur
-   --------- | ------
-   Nom | *demandeur*
-   Type | **External API**
-   URL d'API | `../API/identity/user/{{demande.idDemandeur}}`
+   ![propriétés variable demandeur](images/ex03/ex3_03.png)
 
 1. Modifier le titre du formulaire
    - Sélectionner le widget de type **Titre** situé en haut du formulaire
@@ -123,12 +125,10 @@ Créer les formulaires suivants :
    - Faire glisser un widget de type **Text**
    - Configurer le widget comme ceci :
 
-   Propriété | Valeur
-   --------- | ------
-   Texte | `<b>Demandeur :</b> {{demandeur.firstname}} {{demandeur.lastname}}`
+  ![propriétés texte demandeur](images/ex03/ex3_04.png)
 
 1. Ajouter un widget pour refuser la demande:
-   - Faire glisser un widget de type **Button** et ajouter le dans le form container (zone délimitée par une ligne pointillée épaisse)
+   - Faire glisser un widget de type **Button** et l'ajouter dans le form container (zone délimitée par une ligne pointillée épaisse)
    - Configurer le widget comme ceci :
 
    Propriété | Valeur

diff --git a/docs/fr/05-connectors.md b/docs/fr/05-connectors.md
@@ -77,13 +77,18 @@ BonitaUsers.getProcessInstanceInitiatorProfessionalContactInfo(apiAccessor,proce
    - Passer à la page de configuration du destinataire
    - Entrer *rh@acme.com* comme adresse email dans le champ expéditeur **De**
    - Utiliser l'icône **crayon** pour éditer l'expression sur le champ destinataire **A**
-   - Changer le **Type d'expression** à **Script**
    - Nommer le script *recupEmailDemandeur*
-   - Coller le code ci-dessous dans la zone d'édition du script :
+   - Dans l'éditeur de script, sélectionner *processInitiatorUser* dans le menu **Modèles de code/Utilisateurs Bonita**
+   - Glisser et déposer le modèle dans l'éditeur. Un modèle de script est automatiquement généré.
 
-   ```groovy
-   BonitaUsers.getProcessInstanceInitiatorProfessionalContactInfo(apiAccessor,processInstanceId).email
-   ```
+   ![récuperer l'initiateur du processus](images/ex05/ex5_04.png)
+
+   - Pour pouvoir retourner l'email de l'initiateur du processus, glisser et déposer *userProfessionalContact* depuis le menu **Modèles de code/Utilisateurs Bonita** entre `.getStartedBy()` et `}catch(UserNotFoundException e){`
+   - Remplacer *userId* par `processInitiator.id`
+   - Ajouter un "." et sélectionner *email : string* dans la liste déroulante
+   - On peut remplacer `def proContactData = ` par `return`
+
+   ![récuperer l'email de l'initiateur](images/ex05/ex5_05.png)
 
    - Cliquer sur le bouton **OK** pour fermer l'éditeur de script
    - Passer à la page suivante