IU-DATA

#DatePicker v1.0.0

1 - Présentation & fonctionnalités

Cette extension "add-on" permet de sélectionner une date dans un widget permettant de naviguer facilement entre les mois / années / décennies / siècles et d'en récupérer la date au format filemaker choisit directement dans une solution FileMaker.

Uniquement contenu à l'intérieur d'un webviewer, 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, bootstrap-datepicker.js et la feuille de style bootstrap.min.css.

2 - Installation / Configuration / Paramètres

2.1 Installation

  1. Fermer FileMaker Pro

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

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

2.1 Configuration

Le Add-on peut fonctionner hors contexte grâce à l'utilisation de la rubrique globale IUD_DatePicker: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 ) ;
_language = IUD_DatePicker::language ;
_format = IUD_DatePicker::format ;
_multidate = IUD_DatePicker::multidate ;

_weekStart = IUD_DatePicker::weekStart ;
_calendarWeeks = IUD_DatePicker::calendarWeeks ;
_todayHighlight = IUD_DatePicker::todayHighlight ;

_startView = IUD_DatePicker::startView ;
_minViewMode = IUD_DatePicker::minViewMode ;
_maxViewMode = IUD_DatePicker::maxViewMode ;

_startDate = IUD_DatePicker::startDate ;
_endDate = IUD_DatePicker::endDate ;

_daysOfWeekDisabled = IUD_DatePicker::daysOfWeekDisabled ;
_daysOfWeekHighlighted = IUD_DatePicker::daysOfWeekHighlighted ;
_datesDisabled = IUD_DatePicker::datesDisabled ;

_activeDateColor = IUD_DatePicker::activeDateColor ;
_todayDateColor = IUD_DatePicker::todayDateColor ;
_borderRadius = IUD_DatePicker::borderRadius ;
_background_Color = IUD_DatePicker::background_Color ;


_nbCol = Case ( _calendarWeeks = "true" ; 8 ; 7 ) ; 

_Code = IUD_DatePicker::gct_WV_FinalCode ;

_FinalCode = Substitute (
               _Code ; 

               [ "{{fieldName}}" ; _fieldName ] ;
               [ "{{language}}" ; _language ] ;
               [ "{{format}}" ; _format ] ;
               [ "{{multidate}}" ; _multidate ] ;

               [ "{{weekStart}}" ; _weekStart ] ;
               [ "{{startDate}}" ; _startDate ] ;
               [ "{{endDate}}" ; _endDate ] ;

               [ "{{daysOfWeekDisabled}}" ; _daysOfWeekDisabled ] ;
               [ "{{daysOfWeekHighlighted}}" ; _daysOfWeekHighlighted ] ;
               [ "{{datesDisabled}}" ; _datesDisabled ] ;

               [ "{{calendarWeeks}}" ; _calendarWeeks ] ;
               [ "{{todayHighlight}}" ; _todayHighlight ] ;

               [ "{{startView}}" ; _startView ] ;
               [ "{{minViewMode}}" ; _minViewMode ] ;
               [ "{{maxViewMode}}" ; _maxViewMode ] ;

               [ "{{nb_Col}}" ; _nbCol ];
               [ "{{activeDateColor}}" ; _activeDateColor ];
               [ "{{todayDateColor}}" ; _todayDateColor ];
               [ "{{borderRadius}}" ; _borderRadius ];
               [ "{{background_Color}}" ; _background_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_DatePicker::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_DatePicker::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 add-on.

3.4 - Listes de valeurs

4 - Dépendances

jQuery v3.5.1 ( Licence MIT )

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

Bootstrap DatePicker v1.9.1 ( Licence MIT )

https://bootstrap-datepicker.readthedocs.io/en/latest/

Bootstrap v3.2.0 ( Licence MIT )

https://getbootstrap.com

5 - Compatibilités

Systèmes d'exploitations :

Plateformes :

Veuillez noter que sur FileMaker Go 19 l'activation du DatePicker 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 - DatePicker v1.0.0 - 1st release


© IU-DATA 2021