Jump to content

Add-On : description du contenu d'un dossier


Julien Rouard

113 views

 Share

Vous pouvez retrouver le contenu de cet article sur notre site IU-DATA.

 

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

preview.png.43ca4f960bc27b225b85934dccad9c86.png

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.

 

liste_fichiers_utiles.thumb.png.50ddbeb2b2981e0683bc35d511d92258.png

 


Tout d’abord un petit rappel pour installer l’add-on IUD_Siret2Idcc :

  1. Fermer FileMaker Pro

  2. Copier le dossier IUD_Siret2Idcc dans le répertoire suivant :

    1. macOs : ~/Library/Application Support/FileMaker/Extensions/AddonModules/

    2. Windows : AppData\Local\FileMaker\Extensions\AddonModules\

  3. Dans FileMaker Pro, ouvrir la solution dans laquelle vous souhaitez ajouter le Add-On.

  4. En mode modèle, ouvrir le panneau latéral gauche sur l'onglet Extensions, cliquer sur le bouton ajouter.

  5. Dans la catégorie IU-DATA, sélectionner Siret2Idcc puis cliquer sur Choisir.

  6. 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 importants. Ils permettent de définir certaines informations propres aux add-ons comme son 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.

panneau_addon_siret2idcc4.png.6c5ae54db9460e314e131e280d75a467.png

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.

 

 

panneau_addon_probleme.png.27e02b73e5c3b34a49ea83fc0361d8fe.png

 

Vous n’êtes absolument pas tenus de traduire les informations dans toutes les langues pour chaque fichier, par exemple nous traduisons en français le fichier info_fr.json et en anglais le fichier info_en.json et nous supprimons les autres fichiers de langues. Ainsi si le fichier info_[langue].json n'est pas disponible pour la langue utilisé par FileMaker, c'est le fichier info_en.json qui sera appelé. 

Si en revanche vous ne souhaitez utiliser que le français, alors vous pouvez très bien traduire info_en.json en français et supprimer tous les autres fichiers info_[langue].json. Attention info_en.json est obligatoire.

 

[Langue].xml

Cette 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 traduits 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 / icon@2x.png / preview.png

Les fichiers icon.png, icon@2x.png sont les fichiers utilisés comme icône de l’add-on.

Le fichier preview.png sera l’image d’exemple censée représenter le add-on.

 

Voila en espérant que ces informations vous seront utiles !

 

A bientôt,

Julien 

IU-DATA

 Share

0 Comments


Recommended Comments

There are no comments to display.

Guest
Add a comment...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
×
×
  • Create New...