IU-DATA

ColorPicker v1.0.0



1 - Présentation & fonctionnalités

Cette extension "add-on" permet de sélectionner une couleur et d'en récupérer son code au format hexadécimal directement dans une solution FileMaker.

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 jQuery et bootstrap-colorpicker.js.


2 - Installation / Configuration / Paramètres

2.1 Installation

  1. Fermer FileMaker Pro

  2. Copier le dossier IUD_ColorPicker_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 ColorPicker puis cliquer sur Choisir  

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

2.1 Configuration

Le Add-on peut fonctionner hors contexte grâce à l'utilisation de la rubrique globale IUD_ColorPicker::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 _fieldName dans le calcule du web viewer, pour spécifier la rubrique qui recevra le code couleur

  3. Modifier les autres paramètres

Exemple de code associé au web viewer :

Let (
    [
        _fieldName = GetFieldName ( Table1::Rubrique1 ) ;
        _defaultColor = "#7731B2" ; 
        _alpha = 1 ; 
        _button_Label = "Validate" ; 
        _button_LabelColor = "" ;
        _button_Color = "#97CFC2" ;
        _body_BackgroundColor = "white" ;

        _code = IUD_ColorPicker::gct_WV_FinalCode;
        _finalCode = Substitute ( _code ; 
                ["{{colorPicker_fieldName}}" ; _fieldName ];
                ["{{colorPicker_defaultColor}}" ; _defaultColor ];
                ["{{colorPicker_backgroundColor}}" ; _body_BackgroundColor ];
                ["{{colorPicker_alpha}}" ; _alpha ];
                ["{{colorPicker_isAlpha}}" ; _alphaNum ];
                ["{{colorPicker_button_Label}}" ; _button_Label ];
                ["{{colorPicker_button_LabelColor}}" ; _button_LabelColor ];
                ["{{colorPicker_button_Color}}" ; _button_Color ]
        )
    ]
;
    "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_ColorPicker::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_ColorPicker::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

Aucunes fonctions personnalisées dans cet add-on.

3.4 - Listes de valeurs

Aucunes listes de valeurs dans cet add-on.


4 - Dépendances

jQuery v3.5.1 ( Licence MIT )

https://code.jquery.com/jquery-3.5.1.slim.min.js

Bootstrap Colorpicker v3.2.0 ( Licence MIT )

https://itsjavi.com/bootstrap-colorpicker/


5 - Compatibilités

Systèmes d'exploitations :

Plateformes :

Veuillez noter que sur FileMaker Go 19 l'activation du ColorPicker 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

16/02/2021 - ColorPicker v1.0.0 - 1st release



© IU-DATA 2021