Nous avons récemment développé un module pour un de nos clients, le groupe Eduservices, spécialiste de l’éducation supérieur privée.
Ce module devait permettre la récupération de l'identifiant de la convention collective d’une société ( IDCC ) à partir de son SIRET.
Rien de bien compliqué il suffit d’intérroger l’API du gouvernement Français « Siret2Idcc ».
https://www.data.gouv.fr/fr/reuses/api-siret2idcc/
L’occasion pour nous de développer très rapidement un add-on permettant de réutiliser de manière simple et rapide ce développement.
Nous vous offrons cet add-on en téléchargement libre ici
Nous en profitons pour vous décrire brièvement le contenu des fichiers généralement présents dans les dossiers de nos add-ons et pourquoi nous laissons certains fichiers et d’autres pas.
Tout d’abord un petit rappel pour installer l’add-on IUD_Siret2Idcc :
-
Fermer FileMaker Pro
-
Copier le dossier IUD_Siret2Idcc dans le répertoire suivant :
-
macOs : ~/Library/Application Support/FileMaker/Extensions/AddonModules/
-
Windows : AppData\Local\FileMaker\Extensions\AddonModules\
-
-
Dans FileMaker Pro, ouvrir la solution dans laquelle vous souhaitez ajouter le Add-On.
-
En mode modèle, ouvrir le panneau latéral gauche sur l'onglet Add-ons, cliquer sur le bouton ajouter.
-
Dans la catégorie IU-DATA, sélectionner Siret2Idcc puis cliquer sur Choisir.
-
Glisser-déposer le add-on Siret2Idcc sur le modèle.
Voici maintenant un court descriptif des fichiers contenus par défaut dans un dossier d'add-on généré par FileMaker Pro.
template.xml
template.xml est le fichier de définition principal du add-on il est obligatoire.
info.json
Le fichier info.json permet de définir entre autre l’identité de l’entité créatrice du add-on, il permet aussi d’associer un lien vers son site Internet.
info_[langue].json
Ces fichiers sont Tous très importants. Ils permettent de définir certaines informations propres aux add-ons comme sont nom, sa catégorie, ses fonctionnalités et les plateformes pour lesquelles il est optimisé.
La catégorie permet de grouper les add-ons dans le panneau de sélection.
Il est vivement conseillé de ne laisser que ceux dont vous avez besoin et de remplir chacun de ces fichiers qui vont être appelés selon la langue utilisée par FileMaker Pro sur le poste de l’utilisateur.
Si par exemple vous vous contentez uniquement de remplir le fichier info_fr.json en laissant tous les autres fichiers. Alors par défaut un utilisateur qui souhaitera ajouter votre add-on à son application avec FileMaker Pro en anglais trouvera votre add-on dans la catégorie «__…__» tout en bas de la liste des add-ons et la description du add-on affichera : *** DESCRIPTIONS MISSING *** - DNL.
Vous n’êtes absolument pas tenu de traduire les informations dans toutes les langues pour chaque fichier, par exemple nous traduisons en Français le fichier info_fr.json et tous les autres fichier info_[langue].json sont traduit en anglais.
[Langue].xml
Encore une fois il faut laisser tous ces fichiers même si votre add-on n’est traduit que dans une langue, ils sont eux aussi appelés en fonction de la langue de FileMaker Pro sur le poste utilisateur.
records_[Langue].xml
Ces fichiers contiennent tous les enregistrements des tables de votre add-on, ils permettent de traduire leur valeur dans différentes langues si nécessaire.
Si les enregistrements de votre add-on ne sont traduit qu’en une seule langue vous pouvez très bien n’en conserver qu’un, le poids total du dossier de votre add-on n’en sera que plus léger… Par défaut nous conservons toujours le fichier records_en.xml.
icon.png / preview.png
Les fichiers icon.png sont les fichiers utilisés comme icône de l’add-on.
Le fichier preview.png sera l’image d’exemple censé représenter le add-on.
