# Tutoriels divers Tutoriels pour l'utilisation d'autres logiciels que Hub3E # Création d'un formulaire PDF avec Acrobat PRO ### Introduction L'utilisation de plusieurs services Hub3E nécessite de créer un ou plusieurs formulaires PDF. Ce tutoriel explique comment créer un formulaire PDF simple avec différents types de champs. Ce tutoriel permet de créer des formulaires PDF pour permettre à un centre de formation de répondre à une majorité de cas d'utilisation. Créer un formulaire PDF permet d'utiliser les services Hub3E avec des documents personnalisés et permet par exemple de rajouter des champs spécifiques à un centre de formation, de gérer des processus administratifs supplémentaires, de stocker des informations dans un formulaire standardisé géré par le centre de formation. Liste des services concernés : - Document dynamique candidat - Document dynamique entreprise - Livret de l'apprentissage - Fiche de renseignement Pour suivre ce tutoriel, vous aurez besoin du logiciel [Adobe Acrobat Pro DC](https://acrobat.adobe.com/fr/fr/acrobat/acrobat-pro.html). ### Ajouter des champs dans un document PDF pour le transformer en formulaire PDF Commencez par ouvrir le logiciel Acrobat Pro. Puis cliquez sur **Fichier** > **Ouvrir** et sélectionnez un document PDF dans lequel créer des champs de formulaire PDF :
Cliquez ensuite sur **Outils** > **Préparer le formulaire PDF** :
Dans la page qui s'affiche, cliquez ensuite sur **Démarrer** :
L'interface de préparation du formulaire PDF s'affichera :
**1.**Bouton de sauvegarde, ce bouton permet d'enregistrer les modifications effectuées
**2.**Bouton d'ajout de champ textuel
**3.**Bouton d'ajout de case à cocher
**4.**Bouton d'ajout de liste déroulante
**5.**Liste des pages et des champs dans chaque pages
**6.**Aperçu du rendu du formulaire et pré-remplissage des champs si nécessaire.
### Création d'un champ textuel simple Ouvrez le document PDF puis dans l'interface de préparation de formulaire PDF, cliquez sur le bouton d'ajout de champ textuel :[![image-1590569909112.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/Z8kRy3dWu4sAABeb-image-1590569909112.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/Z8kRy3dWu4sAABeb-image-1590569909112.png) Cliquez ensuite sur l'endroit du document où créer le champ. [![image-1590570007760.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/nNHdebHldGIPUUuT-image-1590570007760.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/nNHdebHldGIPUUuT-image-1590570007760.png) Le nom du champ vous sera demandé, saisissez le nom du champ PDF.

Attention : saisissez toujours un nom unique pour chaque champ sinon, des comportements inattendus surviendront lors de l'utilisation du formulaire PDF.

Succès : Le champ est désormais ajouté dans le formulaire PDF, n'oubliez pas de sauvegarder le document.

Pour faciliter l'utilisation et l'impression du formulaire PDF, il est nécessaire d'effectuer un paramétrage supplémentaire, pour ce faire, effectuez un **clique droit sur le champ** et cliquez sur **Propriétés...** :
Dans la fenêtre qui s'affiche, cliquez sur **Options** puis décochez les cases **Vérifier l'orthographe** et **Faire défiler les longs textes**.
Cette configuration permet de s'assurer que le contenu des champs du formulaire PDF ne dépasse pas du document au cas où son impression sur papier est nécessaire.

Astuce : Si vous avez besoin de limiter la taille du contenu d'un champ en nombre de caractères (exemple pour un SIRET, ou un téléphone), cochez la case du paramètre (**Limité à**) visible sur l'image ci-dessus. Si vous souhaitez ajouter un champ multilingue, cochez l'option **Lignes multiples**.

### Création d'une liste déroulante Ouvrez le document PDF, puis dans l'interface de préparation de formulaire PDF, cliquez sur le bouton d'ajout de liste déroulante : [![image-1590572080818.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/3jaF16fkTCeBUkuX-image-1590572080818.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/3jaF16fkTCeBUkuX-image-1590572080818.png) Cliquez ensuite sur l'endroit du document où créer le champ. [![image-1590572163296.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/s3TQwuUJygwelhWh-image-1590572163296.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/s3TQwuUJygwelhWh-image-1590572163296.png) Le nom du champ vous sera demandé, saisissez le nom du champ PDF.

Attention : saisissez toujours un nom unique pour chaque champ sinon, des comportements inattendus surviendront lors de l'utilisation du formulaire PDF.

Succès : Le champ est désormais ajouté dans le formulaire PDF, n'oubliez pas de sauvegarder le document.

La liste créée est actuellement vide. Pour configurer le contenu de la liste déroulante, il est nécessaire d'effectuer un paramétrage supplémentaire, pour ce faire, effectuez un **clique droit sur le champ** et cliquez sur **Propriétés...** :
Dans la fenêtre qui s'affiche, cliquez sur **Options** puis suivez la procédure suivante :
Procédure d'ajout d'un élément dans une liste déroulante :
**1.**Saisissez le nom de l'élément à ajouter dans la liste déroulante. Ce nom est celui qui sera affiché à l'utilisateur lors de l'utilisation de la liste déroulante.
**2.**Saisissez la valeur de l'élément à ajouter dans la liste déroulante. Cette valeur est la valeur attribuée à l'élément et ne sera pas affichée à l'utilisateur lors de l'utilisation de la liste déroulante. Note : cette valeur sera utilisée lors du publipostage d'un champ d'un Cerfa à partir d'un champ de type liste déroulante dans une fiche de renseignements. Ce type de champ est très utile pour faciliter le remplissage des champs codifiés.
**3.**Cliquez sur **Ajouter** pour créer l'élément dans la liste déroulante.

Information : recommencez la procédure autant de fois que nécessaire pour ajouter d'autres éléments à une liste déroulante.

Astuce : pour réordonner les éléments dans une liste déroulante, utiliser les boutons **Monter** et **Descendre** ces boutons sont visible dans l'image ci-dessus.

### Création d'une case à cocher Ouvrez le document PDF puis dans l'interface de préparation de formulaire PDF, cliquez sur le bouton d'ajout de case à cocher : [![image-1590571106025.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/reykUUpVSdITmlg7-image-1590571106025.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/reykUUpVSdITmlg7-image-1590571106025.png) Cliquez ensuite sur l'endroit du document où créer le champ. [![image-1590571196985.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/scaled-1680-/2XjuydcLtgk8ZZUx-image-1590571196985.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-05/2XjuydcLtgk8ZZUx-image-1590571196985.png) Le nom du champ vous sera demandé, saisissez le nom du champ PDF.

Attention : saisissez toujours un nom unique pour chaque champ sinon, des comportements inattendus surviendront lors de l'utilisation du formulaire PDF.

Succès : Le champ est désormais ajouté dans le formulaire PDF, n'oubliez pas de sauvegarder le document.

Pour utiliser une case à cocher afin de cocher automatiquement une case à cocher sur un Cerfa (dans le cadre des fiches de renseignement), il est nécessaire d'effectuer un paramétrage supplémentaire. Pour ce faire, effectuez un **clique droit sur le champ** et cliquez sur **Propriétés...** :
Dans la fenêtre qui s'affiche, cliquez sur **Options** et modifiez la **Valeur d'exportation** par la valeur **on**.
# Détails sur l'organisation des tests d'un sprint ### Introduction Les tests des modifications effectuées sur un ou plusieurs projets en rapport avec LINKPART sont une partie importante des sprints hebdomadaires. ### Détails sur le processus de tests
Lors de la réalisation d'un sprint, les tickets dans l'étape **A faire** sont déplacés dans l'étape **En cours** lorsqu'ils sont en train d'être traités. Chaque ticket pour lequel le développement ou le travail est effectué est déplacé dans l'étape **À tester** où le travail sera testé par une autre personne que celle(s) qui ont fait le travail indiqué dans le ticket. Puis chaque ticket testé individuellement est déplacé dans l'étape **Release Sprint** où il est testé et validé une seconde fois par une autre personne.

Information : L'étape **À tester** concerne une phase de tests individuelle où les tickets d'un même projet sont testés et déployés sur un environnement de développement un par un. Tandis que l'étape **Release Sprint** symbolise une phase de test collective où les tickets d'un même projet sont tous déployés en même temps sur un même environnement de développement.

Une fois tous les tests validés, les tickets sont déplacés dans **À mettre en production** le lundi matin avant leur mise en production.

Important : un ticket est donc testé 2 fois par 2 personnes différentes. Un ticket ne doit jamais être testé par la personne qui a effectué le travail indiqué dans le ticket. Le test individuel (dans **À tester**) et le test commun (dans **Release Sprint**) doivent être effectués par une personne différente pour chaque étape. Un sprint a donc besoin d'au minimum 3 personnes au minimum pour en assurer son bon déroulement.

### Détails sur l'organisation d'un test de ticket individuel Chaque ticket dans l'étape **À tester** doit être testé individuellement par une personne différente que celle qui a travaillé sur le ticket à tester.

Information : chaque PR de test de ticket individuel pointe de **la branche réservée au ticket** vers la branche **release-sprint**.

Dans la **Pull Request** (PR) du ticket :
**1.**Commencez par déployer sur dev les modifications effectuées par le ticket Note : un ticket peut nécessiter le déploiement des modifications contenues par d'autres tickets pour pouvoir être testé.
**2.**Une fois le ticket testé, si aucun problème ou modification n'est à signaler à la personne qui a travaillée sur le ticket, cliquez sur le bouton **Approuver** pour indiquer la validation du travail effectué.
**3.**Puis cliquez sur le bouton **Fusionner** pour fusionner les changements sur la branche commune (branche release-sprint) des modifications du sprint pour le projet concerné par le ticket.
### Détails sur l'organisation de la phase de test collective Chaque ticket dans l'étape **Release Sprint** dois être déployé en même temps que les autres tickets d'un même projet sur l'environnement de développement et testé individuellement par une personne différente que celle qui a travaillé sur le ticket à tester et que celle qui a testé le ticket lors de la phase de test individuel. #### Préparation de la Pull Request Release Sprint d'un projet

Information : la préparation des PR release sprint pour tous les projets concernés par des modifications dans le sprint en cours est à faire en milieu - fin de journée le jeudi.

Dans chaque projet qui contient un ticket à tester pour le sprint en cours : - Créer une merge request intitulée : "WIP: Release sprint JJ MM AAAA" qui pointe de la branche **release-sprint** vers la branche **master**. - Assigner le label Release Sprint à la PR - Associer le milestone du sprint à la PR - Ajouter au début de la description une mention datée de la sorte **Release sprint JJ MM AAAA** - Mettre dans la description de la PR un lien vers chaque issues et classer les issue en deux catégories. - **Tickets à tester** (pour chaque issue dans **Release Sprint**) - **Tickets pas encore mergés dans Release Sprint** (pour chaque issue dans **A tester**) Une fois toutes les PR créées, mettre un commentaire dans le channel release-sprint du groupe de discution Hub3E sur discord pour indiqueer les projets concernés et le lien vers la PR sur chaque projets.

Succès : la PR d'un projet pour le **Release sprint** en cours est prête à être utilisée.

#### Utilisation de la Pull Request Release Sprint d'un projet Exemple de PR Release sprint:
**1.**Déployer la PR Release sprint du projet sur l'environnement de dev pour déployer en même temps toutes les modifications du projet testé apportées par ce sprint.
**2.**Chaque personne disponible qui peut effectuer des tests choisis un ticket et teste que les modifications de chaque ticket choisi correspondent bien au besoin et aux instructions spécifiées dans chaque ticket.
**3.**Une fois tous les tests terminés et que le débrief du vendredi est terminé, le créateur des PR release sprint clique sur le bouton approuver pour indiquer l'approbation collective des changements apportés au projet ciblé par la PR release sprint.
**4.**Puis le lundi matin, avant la mise en production, une personne déplace tous les tickets de l'étape **Release sprint** dans l'étape **A mettre en production**. Puis clique sur le bouton Fusionner de chaque PR Release sprint pour chaque projet. Une fois la PR fusionnée, le déploiement doit être lancé à partir du commit le plus récent dans la branche master de chaque projet du release sprint.
### Exemple de communication discord pour indiquer la liste des PR release sprint [![image-1595860814857.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-07/scaled-1680-/PJi0wceLI4yHTrVB-image-1595860814857.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2020-07/PJi0wceLI4yHTrVB-image-1595860814857.png)

Information : le record de projets simultanés dans un sprint est de **12 projets** et le record de **29 tickets testés en simultané** dans un sprint.

### Plus d'informations sur le Release Sprint Vous pouvez consulter les ressources annexes suivantes : - [https://gitlab.com/snippets/1940710 (procédure de création d'une PR release sprint + extrait de code pour créer un pipeline gitlab conforme au process du release sprint)](https://gitlab.com/snippets/1940710) - [https://drive.google.com/drive/u/0/folders/1UGsYVyCpWyLazy2dBMIlly5ZnuWCrw5N (dossier contenant les détails de l'organisation d'un sprint sur une semaine sous forme de documents et de schéma explicatifs)](https://drive.google.com/drive/u/0/folders/1UGsYVyCpWyLazy2dBMIlly5ZnuWCrw5N) # Convertir un fichier Excel en fichier d'import de contrat tout en un YParéo ### Introduction Les données de toutes les colonnes du fichier Excel à convertir doivent respecter le modèle de données d'import de contrat tout-en-un YParéo avant de pouvoir être converties. Pour plus d'informations sur le format des données attendues par l'import de contrat tout-en-un YParéo, nous vous invitons à contacter YMAG afin qu'ils transmettent leur documentation. Contraintes techniques liées au format d'import de contrat tout-en-un YParéo - Il doit y avoir 75 colonnes de données utilisées pour le format long et 57 colonnes de données utilisées pour le format court - Il ne doit pas y avoir de colonnes en trop. - Une fois le fichier d'import CSV généré, il doit en fait comporter 76 colonnes pour le format long et 58 pour le format long. - Le fichier CSV doit comporter le symbole du séparateur utilisé sur la 1re ligne du fichier suivi d'un saut de ligne. - Le fichier CSV doit être encodé en utilisant le codage des caractères au format ANSI (Windows-1252), sinon les caractères accentués ne s'afficheront pas correctement dans YParéo. - Les sauts de lignes doivent être au format Windows (CR+LF). - Le fichier CSV ne doit pas comporter de lignes vides (car elles risquent d'être importées dans YParéo) ### Prérequis Ce tutoriel nous nécessite de disposer des logiciels Notepad ++ et Microsoft Excel : - [Téléchargez Notepad ++ sur son site officiel](https://notepad-plus-plus.org). - [Téléchargez Excel sur son site officiel](https://www.microsoft.com/fr-fr/microsoft-365/excel). ### Procédure de conversion d'un fichier Excel #### Convertir un fichier Excel en fichier CSV standard Commencez par ouvrir le fichier Excel à convertir dans Microsoft Excel. Puis supprimez les colonnes en trop en utilisant la fonction "Supprimer..." de Microsoft Excel : [![image-1614585494693.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/5LmusS1m7q43Svhf-image-1614585494693.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/5LmusS1m7q43Svhf-image-1614585494693.png) Puis sur la 76ème colonne, insérez 1 caractère de votre choix (exemple : un espace ou tout autre caractère), puis répliquez cette valeur sur toutes les lignes jusqu'à la fin du jeu de donnée à importer : [![image-1614586182571.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/mEKd9VQTx4GC7C8e-image-1614586182571.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/mEKd9VQTx4GC7C8e-image-1614586182571.png) Puis exportez votre fichier au format CSV (Fichier > Enregistrer sous > .csv) : [![image-1614591349757.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/WDWtop7g5ZxY8VaR-image-1614591349757.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/WDWtop7g5ZxY8VaR-image-1614591349757.png)

Information : à partir de cette étape, vous disposez d'un fichier CSV standard, mais ce fichier n'est pas encore compatible avec l'import de contrat tout en un YParéo. Continuez la procédure en suivant les instructions ci-dessous pour rendre le fichier compatible avec YParéo.

#### Adapter un fichier CSV standard pour le rendre utilisable dans l'import de contrat tout-en-un YParéo Ouvrez le fichier CSV dans le logiciel Notepad ++ (Fichier > Ouvrir) : [![image-1614601711805.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/GTSwacKEM9noTR0B-image-1614601711805.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/GTSwacKEM9noTR0B-image-1614601711805.png) Ajoutez le séparateur utilisé dans le fichier CSV au début du fichier :

Information : dans l'exemple, le séparateur utilisé est le caractère **; (point-virgule).**

**Astuce : pour reconnaître le type de séparateur, observez le caractère qui sépare les valeurs dans le fichier CSV, exemple dans un fichier ou le séparateur est un ; (point-virgule) :**
Identifiez et supprimez les lignes vides dans le fichier CSV, exemple : Avant :
Après : [![image-1614602190333.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/DK1QciO6B1Pz2kAl-image-1614602190333.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/DK1QciO6B1Pz2kAl-image-1614602190333.png) Convertissez en ANSI l'encodage des caractères dans le fichier (Encodage > Convertir en ANSI) : [![image-1614602288346.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/BcRuOaPEUFV1SkWk-image-1614602288346.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/BcRuOaPEUFV1SkWk-image-1614602288346.png) Puis vérifiez que les sauts de lignes dans le fichier sont bien au format Windows (CR+LF) et que l'encodage des caractères dans le fichier est bien ANSI :
Sauvegardez les modifications pour rendre compatible le fichier CSV avec l'import de contrat tout-en-un YParéo : [![image-1614602552488.png](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/scaled-1680-/J9rkO4i3sYeNsZal-image-1614602552488.png)](https://documentation-bookstack-files.s3.eu-west-3.amazonaws.com/uploads/images/gallery/2021-03/J9rkO4i3sYeNsZal-image-1614602552488.png) ### Conclusion Cette procédure peut être utilisée avec tout logiciel ou toute plateforme fournissant un fichier Excel dont les données dans les colonnes correspondent au modèle de donnée attendu par l'import de contrat tout-en-un YParéo.