IU-DATA

#iOS Switch

1 - Présentation & fonctionnalités

Cette extension "add-on" basée sur le célèbre switch iOS permet d'ajouter du style et une animation fluide à l'ergonomie des boutons radios de vos solutions 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 :

2 - Installation / Configuration / Paramètres

2.1 Automatique

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

  1. Lancer le fichier

  2. Cliquer sur Install the Add-on

  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 iOS Switch puis cliquer sur Choisir  

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

2.2 Manuelle

  1. Fermer FileMaker Pro

  2. Copier le dossier IUD_iOSSwitch 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 iOS Switch puis cliquer sur Choisir  

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

2.3 Configuration

Le Add-on peut fonctionner hors contexte grâce à l'utilisation de la rubrique globale IUD_iOSSwitch: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 ( "**Copiez votre rubrique cible ici**" ) ;
_valueList = "0¶1" ;
_1stValue_Color = "#F1F1F1";
_2ndValue_Color = "#8ce196" ;
_showLabel = 0 ;
_background_Color = "#FFFFFF" ;
_orientation = "horizontal";
_verticalTextOrientation = "";

_fieldValue = GetField ( _fieldName ) ;

_1stValue_FontColor = IUDATA_DarkenColorHEX ( _1stValue_Color ; 100 );
_2ndValue_FontColor = IUDATA_DarkenColorHEX ( _2ndValue_Color ; 100 );
_1stValue = GetValue ( _valueList ; 1 ) ; 
_2ndValue = GetValue ( _valueList ; 2 ) ;
_1stValue_Label = Case ( _showLabel ; _1stValue ; "" ) ;
_2ndValue_Label = Case ( _showLabel ; _2ndValue ; "" ) ;  

_isChecked = Case ( 
	_fieldValue = _1stValue ; "0" ; 
	_fieldValue = _2ndValue ; "1" ; 
	"0"
);

_jsTab = "['" & _1stValue & "','" & _2ndValue & "']";

_Code = z_IUD_IOSSWITCH::gct_WV_FinalCode ;

_FinalCode = Substitute ( _Code ; 

				[ "{{fieldName}}" ; _fieldName ];
				[ "{{isChecked}}" ; _isChecked ];
				[ "{{listValue}}" ; _jsTab ] ;
				[ "{{leftValue}}" ; _1stValue_Label ] ;
				[ "{{rightValue}}" ; _2ndValue_Label ];

				[ "{{color1}}" ; _1stValue_Color ] ;
				[ "{{color2}}" ; _2ndValue_Color ];
				[ "{{fontColor1}}" ; _1stValue_FontColor ];
				[ "{{fontColor2}}" ; _2ndValue_FontColor ]; 

				[ "{{orientation}}" ; _orientation ];
				[ "{{vertical-text-orientation}}" ; _verticalTextOrientation ];

				[ "{{background_Color}}" ; _background_Color ] 
			)	
]
;
	Case (
		Get ( SystemPlatform )  = 4 ;
		"data:text/html;base64," & Base64EncodeRFC ( 4648 ; _FinalCode ) ;
		"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_iOSSwitch::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_iOSSwitch::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

Aucune liste de valeur dans cet add-on.

4 - Dépendances

Aucune dépendance dans cet add-on.

5 - Compatibilité

Systèmes d'exploitations :

FileMaker :

FileMaker WebDirect :

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

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/01/2022 - iOS Switch v2.0.0 - Ajout des paramètres orientation et vertical text orientation et de la compatibilité avec Webdirect
16/02/2021 - iOS Switch v1.0.0 - 1st release


© IU-DATA 2021