IU-DATA

Progress Button



1 - Présentation & fonctionnalités

Cette extension "add-on" permet d'ajouter un bouton donnant une indication de progression lors de l'éxécution de la procédure qui lui sera associée.

Uniquement contenu à l'intérieur d'un Web Viewer, il est possible de paramétrer le Web Viewer de manière totalement indépendante avec un simple copier-coller. Responsive, il s'adapte automatiquement à la taille du Web Viewer.

Fonctionnalités :

Cet add-on utilise les bibliothèques JavaScript ladda.js et spin.js.


2 - Installation / Configuration / Paramètres

2.1 Installation

  1. Fermer FileMaker Pro

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

     - macOs : ~/Library/Application Support/FileMaker/Extensions/AddonModules/
     - 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 Add-ons, cliquer sur le bouton ajouter  

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

  6. Glisser-déposer le add-on Progress Button sur le modèle

2.1 Configuration

Le Add-on peut fonctionner hors contexte grâce à l'utilisation de la rubrique globale IUD_ProgressButton::gct_WV_FinalCode.

  1. Copier-coller le web viewer contenant la formule de calcul du Add-on sur le modèle souhaité.

  2. Modifier le paramètre _webViewerName dans le calcule du web viewer, pour spécifier le nom de votre webviewer

  3. Modifier le paramètre _scriptFMPToCall dans le calcule du web viewer, pour spécifier le nom du script FileMaker à appeler

  4. Modifier les autres paramètres

Exemple de code associé au web viewer :

Let (
[
_code = z_IUD_PROGRESSBUTTON::gct_WV_FinalCode;
_WebViewerName = "WV_ProgressButton";
_ScriptFMPToCall = "IUD_fmps_ProgressButton_action" ;

_button_Effect = "slide-down" ;
_button_Progress = 1 ;
_button_Color = "custom" ;
_button_Custom_Color = "#9AD0C0" ;
_button_Progress_Custom_Color = "#E1DD14" ;
_button_BorderRadius = 0 ;

_text = "IU-DATA" ;
_text_Size = "14vw" ;
_text_Weight = "normal" ;
_text_Color = "#FFFFFF" ;

_body_BackgroundColor = "#ffffff" ;

_button_Custom_Color_Hover = IUDATA_LightenColorHEX ( _button_Custom_Color ; 21 ) ;

_finalCode = Substitute ( _code ; 

		["{{button_Effect}}" ; _button_Effect ];
		["{{button_Color}}" ; _button_Color ];
		["{{button_Custom_Color}}" ; _button_Custom_Color ];
		["{{button_Custom_Color_Hover}}" ; _button_Custom_Color_Hover ];
		["{{button_Progress_Custom_Color}}" ; _button_Progress_Custom_Color ];
		["{{button_BorderRadius}}" ; _button_BorderRadius ];

		["{{WebViewerName}}" ; _WebViewerName ];
		["{{ScriptFMPToCall}}" ; _ScriptFMPToCall ];
		["{{isProgress}}" ; _button_Progress ];

		["{{text}}" ; _text ];
		["{{text_Color}}" ; _text_Color ];
		["{{text_Weight}}" ; _text_Weight ];
		["{{text_Size}}" ; _text_Size ];

		["{{body_backgroundColor}}" ; _body_BackgroundColor ]
)

]
;
"data:text/html;charset=utf-8,¶" & _finalCode
)

Veuillez noter : Si votre base de données sur laquelle vous souhaitez installer le module complémentaire est hébergée avec FileMaker Server. Vous devrez peut-être actualiser la rubrique de calcul global IUD_ProgressButton::gct_WV_FinalCode. Sinon, le webviewer qui contient le module complémentaire restera vide. Pour rafraîchir cette rubrique, vous pouvez définir la rubrique IUD_ProgressButton::WV_HTML par sa propre valeur dans un script qui est lancé au démarrage de votre application.

2.2 Paramètres

Valeurs de paramètres modifiables :

⚠️   si vous modifiez les noms des paramètres il faudra reporter vos modifications dans _finalCode le cas échant

⚠️   Paramètres à ne pas modifier :


3 - Tables / Scripts / Fonctions personnalisées / Listes de valeurs

3.1 - Tables

3.2 - Scripts

3.3 - Fonctions personnalisées

Les descriptions des fonctions suivantes sont présentes dans leurs calculs respectifs.

3.4 - Listes de valeurs


4 - Dépendances

Ladda 0.9.8 ( Licence MIT )

https://lab.hakim.se/ladda

Spin ( Licence MIT )

https://lab.hakim.se/ladda


5 - Compatibilité

Systèmes d'exploitations :

FileMaker :

FileMaker WebDirect :

Veuillez noter que sur FileMaker Go 19 l'activation du Progress Button dans le Web Viewer nécessite un double tap.


6 - Contrat de licence utilisateur final

Remarque importante : Veuillez lire attentivement le présent CLUF. Le fait de télécharger, d'installer, d'utiliser ou de modifier le présent add-on signifie que l'utilisateur final et son organisation acceptent le présent CLUF.

Définitions :

Termes du contrat :
IU-DATA autorise l'utilisateur final et son organisation ou son foyer à utiliser, modifier, copier le add-on à sa convenance. IU-DATA autorise, l'utilisateur final et son organisation, l'utilisation à des fins commerciales lorsque le add-on fait partie intégrante d'une solution dont le spectre d'utlisation est autrement plus large que celui définit par les fonctionnalités du add-on seul. En revanche IU-DATA n'autorise pas, l'utilisateur final et son organisation, l'utilisation à des fins commerciales ou de distribution du add-on, modifié ou non en tant que produit fini.

L'utilisateur final et son organisation / foyer disposent d'une assitance gratuite d'une durée de 2 mois à compter de la date d'achat, pour toute question relative à l'utilisation et la configuration de cet add-on.
L'accès intégral aux sources FileMaker ainsi qu'au code source utilisé dans le web viewer offre, à l'utilisateur final et son organisation / foyer, un contrôle total sur la modification de cet add-on. Il est donc naturel que nous ne puissions intervenir de manière gratuite sur un add-on dont le code aurait été altéré par rapport à la version d'origine qu'IU-DATA a délivré. De même IU-DATA ne serait être tenue responsable de tout dysfonctionnement des éventuelles bibliothèques mentionnées en paragraphe 4 - Dépendances, ainsi que des dysfonctionnements du add-on suite à une utilisation sur un système d'exploitation ou une plateforme FileMaker autre que ceux mentionné en paragraphe 5 - Compatibilités.

Contact :
Pour toute information, veuillez nous contacter à cette adresse : product@iu-data.com


7 - Réalisation

Création et développement :

Design de l'icône :


8 - Change Log

01/03/2022 - Progress Button v2.0.0 - ajout de la compatibilité avec FileMaker WebDirect

16/02/2021 - Progress Button v1.0.0 - 1st release



© IU-DATA 2021