IU-DATA

FMPlanner

1 - Présentation & fonctionnalités

Cette extension "add-on" est un module à part entière que vous pouvez intégrer à vos solutions FileMaker. Un véritable outil de plannification d'évènements par ressources disposant de plusieurs vues de travail.
Le point fort de FMPlanner est son interface épurée et lisible ainsi que son optimisation qui en fait un outil très performant, capable d'afficher un grand nombre d'enregistrements pour un délai de traitement minime.

Une fois importé dans votre solution, liberté vous est donnée d'associer vos données aux tables FMPlanner.

Fonctionnalités principales :

Planification et visualisation d'évènements par ressources selon 4 vues
Gestions des paramètres propres à chaque utilisateur
Gestions des paramètres générales du add-on
Vue Mois permet de visualiser tous les évènements sur un mois choisi
Vue Semaine permet de visualiser tous les évènements sur une semaine choisie
Vue Jour permet de visualiser tous les évènements par ressource sur un jour choisi
Vue Timeline permet de visualiser tous les évènements classés par catégories de ressource et par ressource sur un jour choisi en défilement horizontal
Navigation rapide entre les vues
Colonne supplémentaire pour le stockage des évènements en attente de planification
Colonne de sélection des ressources à afficher avec des sélections par catégories mémorisées pour chaque utilisateur
Script FileMaker pour interagir avec le add-on
Taille responsive

Fonctionnalités secondaires :

Création d'évènement par étirement sur le planning
Dupplication d'évènement à l'aide d'un alt + clic maintenu
Modification de la durée d'un évènement en l'étirant par le début ou la fin
Drag and drop des évènements sur le planning ou du planning à la colonne de planification et inversement
Navigation rapide vers une date à l'aide du DatePicker IU-DATA
Sélection de la couleur associée à une ressource à l'aide du ColorPicker IU-DATA
Modification des paramètres d'affichage du planning

2 - Installation

2.1 Automatique

Pour vous faciliter la tâche, IU-DATA fournit une petite solution FileMaker avec chaque Add-on, elle installe directement le add-on dans le bon répertoire de votre ordinateur.

Lancer le fichier
Cliquer sur Instal the Add-on
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 FMPlanner puis cliquer sur Choisir
Glisser-déposer le add-on FMPlanner sur le modèle

2.1 Manuelle

Fermer FileMaker Pro

Copier le dossier IUD_FMPlanner 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 FMPlanner puis cliquer sur Choisir
Glisser-déposer le add-on FMPlanner sur le modèle

Veuillez noter qu'il vous faudra associer le script A - OnFirstWindowOpen [TRIGGER] à votre procédure d'ouverture de fichier pour que FMPlanner se lance correctement. Il en va de même pour le script A - OnLastWindowClose [TRIGGER] à la fermeture du fichier

3 - Structures

3.1 - Tables

zIUD_FMPLANNER : Table principale à enregistrement unique de FMPlanner, contient le code source de FullCalendar et permet de générer le planning.
zIUD_FMPLANNER_ADMINPREF : Table à enregistrement unique contenant les préférences d'administration de FMPlanner
zIUD_FMPLANNER_EVENTS : Table contenant les évènements à afficher
zIUD_FMPLANNER_LOCALES : Table contenant les traductions de chaque éléments de FMPlanner, chaque enregistrement représente une langue sélectionnable pour chaque utilisateur
zIUD_FMPLANNER_RESOURCES : Table contenant les ressources à afficher
zIUD_FMPLANNER_USERPREF : Table contenant les préférences de chaque utilisateur
z_IUD_COLORPICKER : Table à enregistrement unique contenant le code source du module ColorPicker
z_IUD_DATEPICKER : Table à enregistrement unique contenant le code source du module DatePicker
z_IUD_IOSSWITCH : Table à enregistrement unique contenant le code source du module iOS Switch
z_IUD_SIDEBAR : Table à enregistrement unique contenant le code source du module SideBar
z_IUD_SPINNER : Table à enregistrement unique contenant le code source du module Spinner

3.2 - Modèles

A - Planning : Modèle principal du add-on
A - Loading : Modèle de chargement
A - Event settings [CARD] : Card de gestion des évènements
A - Resources settings [CARD] : Card de gestion des ressources
A - Planning prefs [CARD] : Card de gestion des préférences
A - Planning locales [CARD] : Card de gestion des langues

3.3 - Scripts

Tous les scripts de FMPlanner sont contenus dans le dossier de script IUDATA - FMPlanner.

La description des scripts et des paramètres se trouvent dans chaque en-tête de script.

3.4 - Fonctions personnalisées

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

IUD_DATE_DateRangeDscJSTab ( __FirstDate ; __LastDate )
IUD_DATE_FMPDateToJSDate ( __Date )
IUD_DATE_FMPDateToSQLDate ( __Date )
IUD_FullCalendar_GetEventsJA ( __Json ; __IdResource ; __date ; __view )
IUD_FullCalendar_GetResourceJA ( __IdResource )
IUD_Gen_EasyTime ( _Time )
IUD_Gen_GetFieldName ( _Field )
IUD_Gen_GetTableName ( _Field )
IUDATA_HexToRGB ( __HexColor ; __Option )
IUDATA_RGBToHex ( __R ; __G ; __B )
IUDATA_DarkenColorHEX ( __colorHEX ; __delta )
IUD_SideBar_categoryFormatHTML()
IUD_SideBar_GetCateroryResourcesObject()
IUD_SideBar_resourceFormatHTML (__Json)

3.5 - Listes de valeurs

Grl - timeStart : Liste de valeurs de l'heure de début d'affichage du planning
Grl - timeEnd : Liste de valeurs de l'heure de fin d'affichage du plannin
Grl - List slot duration : Liste de valeurs pour la durée des cellules du planning
Grl - List hours : Liste de valeurs des heures de la journée
Grl - List Resources Categories : Liste de valeurs des catégories de ressources
Grl - List locales : Liste de valeurs des langues disponibles
Grl - List Resources : Liste de valeurs des ressources
Grl - List day number : Liste de valeurs des numéros de jours de semaine
Grl - events icons : Liste de valeurs des icones pour les évènements
Grl - FullCalendar Locales : Liste des langues de FullCalendar disponibles

4 - Dépendances

FullCalendar Scheduler 5.8 ( Premium Licence )

locales-all.js
main.css
mais.js

https://fullcalendar.io

jQuery v3.5.1 ( Licence MIT )

jquery_3.5.1.slim.min.js

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

Bootstrap v3.2.0 ( Licence MIT )

bootstrap.min.css

https://getbootstrap.com

Bootstrap DatePicker v1.9.1 ( Licence MIT )

bootstrap-datepicker.js
bootstrap-datepicker3.css

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

Bootstrap Colorpicker v3.2.0 ( Licence MIT )

bootstrap-colorpicker.js
bootstrap-colorpicker.min.css

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

5 - Compatibilités

Systèmes d'exploitations :

macOS Monterey 12.0
macOS Big Sur 11.0
macOS Catalina 10.15
macOS Mojave 10.14
Windows 10 64-bit
iOS >13.2

FileMaker :

Claris FileMaker Pro 19.3 ou supérieur
Claris FileMaker Go 19.3 ou supérieur

Veuillez noter que sur FileMaker Go 19 l'activation de FMPlanner et des autres modules dans des Web Viewers nécessitent 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 :

Le add-on est FMPlanner v1.0.0.
L'utilisateur final est la personne physique qui a acheté le add-On sur le site Internet d'IU-DATA.
L'organisation est la structure ou la société pour laquelle travaille l'utilisateur final.
Le foyer désigne le foyer familial de l'utilisateur final.

Termes du contrat :
IU-DATA autorise l'utilisateur final et son organisation ou son foyer à utiliser, modifier, copier le add-on à sa convenance. Toutefois, avec une simple licence du add-on, IU-DATA n'autorise pas la modification du code source minifié utilisé pour la génération de FullCalendar conformément aux limites d'utilisation définit par FullCalendar pour cette licence Premium. Si l'utilisateur final et son organisation, souhaitent pouvoir modifier le code source de FullCalendar à leur convenance, il peut fournir une preuve d'achat d'une licence Premium FullCalendar Scheduler, auquel cas, IU-DATA fournira le code source non-minifié permettant un développement continue du add-on. IU-DATA n'autorise pas, l'utilisateur final et son organisation, l'utilisation à des fins commerciales.

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 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 :

Julien Rouard d'IU-DATA

Design de l'icône :

Christophe Gilet de Gilet Design

8 - Change Log

31/05/2021 - FMPlanner v1.0.0 - 1^st release