advertisement
FileMaker
®
Pro 8 Advanced
Guide de développement
© 2005 FileMaker, Inc. Tous droits réservés.
FileMaker, Inc.
5201 Patrick Henry Drive
Santa Clara, California 95054, Etats-Unis
FileMaker est une marque commerciale de FileMaker, Inc., déposée aux Etats-Unis et dans d’autres pays, et ScriptMaker et le logo du dossier sont des marques de FileMaker, Inc.
La documentation de FileMaker est protégée par les lois sur les droits d’auteur. Vous n’êtes pas autorisé à créer des copies supplémentaires ou à distribuer cette documentation sans l’accord
écrit de FileMaker. Vous devez posséder une copie sous licence valide de FileMaker pour utiliser cette documentation.
Toutes les personnes et sociétés citées dans les exemples sont fictives, et toute ressemblance avec des personnes et des sociétés existantes ne serait que pure coïncidence.
La liste des auteurs est disponible dans le document Remerciements fourni avec ce logiciel.
Pour plus d’informations, rendez-vous sur notre site Web à l’adresse www.filemaker.com.
Edition : 01
Table des Matières
Chapitre 1
Démarrage
A propos de FileMaker Pro Advanced
Conception et développement de bases de données personnalisées et avancées
Débogage et dépannage des solutions de base de données
Maintenance et modification des bases de données
Nouvelles fonctions de FileMaker Pro 8 Advanced
Fonctions de partage des schémas
Personnalisation des fonctions
Débogage et dépannage des fonctions
Utilisation de la documentation de FileMaker Pro Advanced
Emplacement de la documentation PDF
Enregistrement et assistance technique
Respect du contrat de licence pour les solutions d’exécution
A propos de la base de connaissances TechInfo
Chapitre 2
Personnalisation des solutions de base de données
Ajout d’infobulles pour les objets du modèle
Copie des scripts, des actions de script ou des rubriques
Copie ou importation des tables dans un fichier
Importation du schéma de table
Utilisation des fonctions personnalisées
Création de fonctions personnalisées
Modification des fonctions personnalisées
Suppression de fonctions personnalisées
Copie de fonctions personnalisées
13
7
A propos du mode Borne de communication
Navigation en mode Borne de communication
Fermeture de solutions en mode Borne de communication
Création de solutions en mode Borne de communication
Utilisation des scripts et des boutons pour contrôler votre solution
Chapitre 3
Personnalisation des menus
A propos de la personnalisation des menus
Comment les menus personnalisés affectent-ils d’autres fonctions ?
Terminologie des menus personnalisés
Création et modification des menus personnalisés
Création et modification des éléments de menu
Personnalisation des jeux de menus
Création et modification des jeux de menus
Installation des jeux de menus
Spécification d’un jeu de menus par défaut
Spécification des jeux de menus pour les modèles individuels
Création de scripts pour modifier les jeux de menus
Utilisation des menus A propos de, Aide ou Script des versions précédentes
25
4
Guide de développement FileMaker Pro Advanced
Chapitre 4
Création de thèmes de modèle personnalisés
Modification des thèmes de FileMaker Pro Advanced
Conditions requises pour les fichiers de thème
Eléments XML indispensables pour un thème
Suppression d’éléments dans un fichier de thème
Eléments XML de parties de modèle
Eléments XML et leurs attributs
Valeurs correctes des attributs
Définition des valeurs par défaut des thèmes
Utilisation des valeurs de couleur et de motif
Ajout de commentaires aux fichiers de thème
Vérification des fichiers de thème
Chapitre 5
Développement de modules FileMaker tiers
A propos des fonctions externes
Installation, activation et configuration de l’exemple de module
Description des fonctions externes du module FMExample
Personnalisation du module exemple
Personnalisation des ressources exemple
Personnalisation de FMPluginExample.cpp
Personnalisation de FMPluginPrefs.cpp
Personnalisation de FMPluginFunctions.cpp
Consignes pour l’écriture des modules de fonction externe
Conventions d’appellation des fonctions externes
49
37
Messages FileMaker envoyés au module
Suppression des conflits de ressources potentiels
sous Mac OS X
Documentation du module externe
Enregistrement de votre module
Révision d’un module externe enregistré
Chapitre 6
Débogage, analyse et optimisation des fichiers
Débogage et dépannage des scripts
Passage d’un script à un autre
Surveillance des rubriques, des variables et des calculs
Désactivation des actions du script
Documentation des schémas de base de données
Dépannage des fichiers avec le rapport DDR HTML
Compression et optimisation des fichiers
Chapitre 7
Utilisation des Utilitaires Developer
Présentation de la préparation des fichiers de votre solution
Modification des fichiers de la solution
Création d’un journal d’erreurs
Remarques sur la solution d’exécution
Vérification des références externes
Liaison de fichiers aux deux plates-formes
69
61
59
Liaison des bases de données dans la solution d’exécution
Attribution de noms aux solutions d’exécution
Attribution d’extensions à trois caractères
Définition de la clé de liaison
Modification des fichiers d’exécution liés
Enregistrement et réutilisation des paramètres des
Modification du jeu de paramètres d’une solution
Conversion et mise à jour des fichiers de la solution
Importation des données dans des solutions d’exécution mises à jour
Suppression des privilèges d’accès intégral des bases de données
Chapitre 8
Diffusion des solutions d’exécution
Organisation des composants de la solution
Lot d’application d’exécution Mac OS X
Fichiers DLL des solutions d’exécution Windows
Dossier Extensions des solutions Windows
Choix de la méthode de diffusion
Réduction de la taille de la solution
Utilisation d’un programme d’installation personnalisé
Utilisation d’un utilitaire de compression
Partage de solutions en réseau
Configuration utilisateur requise
Documentation des procédures d’installation
Démarrage d’une solution d’exécution
Récupération des fichiers endommagés
Documentation destinée aux utilisateurs
Création d’un modèle A propos de
Création d’un modèle d’Aide personnalisé
Ajout d’une documentation papier
81
|
Table des Matières
5
Vos responsabilités de développeur
Test de votre solution avant et après sa création
Diffusion de mises à jour de solutions d’exécution
Annexe A
Comparaison de la fonctionnalité de l’application d’exécution et de FileMaker Pro
Préférences de l’application et du document
Comparaison des barres d’outils
Comparaison des commandes de menu
Préférences ou paramètres de registre mémorisés
Index
91
99
6
Guide de développement FileMaker Pro Advanced
Chapitre 1
Démarrage
Bienvenue dans FileMaker
®
Pro Advanced. Ce produit propose des outils de développement et de personnalisation avancés tout particulièrement conçus pour les développeurs de bases de données.
Vous pouvez utiliser FileMaker Pro ou FileMaker Pro Advanced pour créer et tester des solutions de base de données.
A propos de FileMaker Pro Advanced
FileMaker Pro Advanced utilise toutes les fonctions et fonctionnalités de FileMaker Pro, mais également les outils impliqués dans les actions suivantes :
Conception et développement de bases de données personnalisées et avancées
1
Création de menus personnalisés aptes à répondre aux besoins de votre base de données et de vos utilisateurs. Reportez-vous à
la rubrique « Personnalisation des menus », page 25.
1
Ajout d’infobulles personnalisées destinées à modéliser les objets pour rendre votre base de données plus intuitive et faciliter la saisie
des données. Reportez-vous à la rubrique « Ajout d’infobulles pour les objets du modèle », page 13.
1
Création de solutions d’exécution autonomes. Reportez-vous à la
rubrique « Liaison des bases de données dans la solution d’exécution », page 74.
1
Affichage de votre base de données en mode Borne de communication
plein écran. Reportez-vous à la rubrique « A propos du mode Borne de communication », page 19.
1
Elaloration de formules centralisées et récursives avec des
1
Utilisation des modules externes pour étendre et personnaliser vos solutions et du langage C++ dans vos calculs. Reportez-vous à
la rubrique « Développement de modules FileMaker tiers », page 49.
Débogage et dépannage des solutions de base de données
1
Surveillance des rubriques, des variables et des expressions avec le
Visualiseur de données, en même temps que le débogage des scripts et le dépannage des bases de données. Ou, calculs des tests sans modification des schémas de votre base de données. Reportez-vous
à la rubrique « Surveillance des rubriques, des variables et des calculs », page 63.
1
Utilisation de Script Debugger pour identifier les zones à problèmes et revoir les scripts étape par étape au moment de
leur exécution. Reportez-vous aux rubriques « Passage d’un script
à un autre », page 61 et « Affichage des sous-scripts », page 62.
1
Désactivation des actions de script pour tester les parties d’un
script. Reportez-vous à la rubrique « Désactivation des actions du script », page 64.
Maintenance et modification des bases de données
1
Copie de l’intégralité des scrips, d’actions de script spécifiques ou des rubriques d’un fichier et collage dans un même fichier ou
1
Consolidation des tables dans un fichier, depuis une solution multifichier, en copiant ou en important le schéma de la table.
Reportez-vous à la rubrique « Copie ou importation des tables dans un fichier », page 15.
8
Guide de développement FileMaker Pro Advanced
1
Utilisation du rapport sur les structures de bases de données (DDR) pour regrouper des informations complètes sur le schéma de la base de données et des options, telles que les rubriques, les tables, les actions de script, les tables externes, les rubriques de fusion, les menus personnalisés et les infobulles. Ces rapports vous aident également à dépanner les références manquantes, les liens rompus, les calculs, etc.
Reportez-vous à la rubrique « Documentation des schémas de base de données », page 65.
1
Utilisation des outils de maintenance des fichiers pour optimiser les performances, récupérer l’espace inutilisé et le valoriser. Reportez-
vous à la rubrique « Compression et optimisation des fichiers », page 66.
Nouvelles fonctions de
FileMaker Pro 8 Advanced
FileMaker Pro 8 Advanced utilise les nouvelles fonctions et améliorations décrites ci-après. Pour une liste complète des nouvelles fonctions introduites dans FileMaker Pro 8, reportez-vous au
Guide de l’utilisateur FileMaker Pro
ou à l’Aide.
Fonctions de partage des schémas
Pour plus d’informations sur cette fonction
Copie et importation des tables sur plusieurs fichiers ou dans le même fichier
Copie des scripts, des actions de script ou des rubriques
Consultez la rubrique
« Copie ou importation des tables dans un fichier », page 15
« Copie des scripts, des actions de script ou des rubriques », page 14
Personnalisation des fonctions
Pour plus d’informations sur cette fonction
Ajout d’infobulles
Création de menus personnalisés
Consultez la rubrique
« Ajout d’infobulles pour les objets du modèle », page 13
« Personnalisation des menus », page 25
Débogage et dépannage des fonctions
Pour plus d’informations sur cette fonction Consultez la rubrique
Surveillance des rubriques, des variables et des calculs à l’aide du Visualiseur de données
« Surveillance des rubriques, des variables et des calculs », page 63
Affichage des sous-scripts au moment du parcours pas à pas
Désactivation des actions du script
« Affichage des sous-scripts », page 62
« Désactivation des actions du script », page 64
Rapport amélioré sur la structure des bases de données
Reportez-vous au PDF intitulé
Database Design Report XML
Output Grammar
disponible sur le site www.filemaker.com/ downloads
Remarque
Si votre solution utilise des modules externes tiers, contactez leurs fabricants respectifs afin de vérifier leur fonctionnement avec les produits FileMaker 8. Les modules de fonction externes sont rétro-compatibles, alors que les modules externes dépendent parfois de fonctions qui ont subi des modifications depuis les versions précédentes.
Utilisation de la documentation de
FileMaker Pro Advanced
Ce
Guide de développement
fait partie de l’ensemble de la documentation fournie avec FileMaker Pro Advanced. Certains documents sont fournis au format papier et PDF, d’autres au format
PDF uniquement. FileMaker Pro Advanced intègre également un système d’aide en ligne qui fournit des détails sur des fonctions
FileMaker Pro.
Ce guide propose des informations sur les fonctions disponibles dans FileMaker Pro Advanced. Il suppose que vous connaissez déjà
FileMaker Pro ou FileMaker Pro Advanced et que vous avez créé une solution de base de données que vous souhaitez retravailler à l’aide des fonctions de FileMaker Pro Advanced. Si vous n’êtes pas familier avec les produits de la gamme FileMaker, consultez tout d’abord le
Guide de l’utilisateur FileMaker Pro
.
Remarque
Dans cette documentation, des instructions et des illustrations spécifiques sont fournies pour les fonctions ou les procédures propres à une plate-forme particulière. Pour les fonctions ou les procédures similaires sur les deux plates-formes, les illustrations seront indifféremment fournies pour les systèmes d’exploitation Windows ou Mac.
Les manuels suivants sont inclus :
1
Guide de développement FileMaker Pro Advanced
(ce manuel) : décrit l’utilisation des fonctionnalités de FileMaker Pro Advanced
1
Guide d’installation pour FileMaker Pro et FileMaker Pro
Advanced
: contient des instructions d’installation.
1
Manuel de l’utilisateur FileMaker Pro
: contient les principaux concepts et les procédures de base.
1
Manuel
Database Design Report XML Output Grammar
: décrit la syntaxe d’émission du rapport sur la structure des bases de données de
FileMaker Pro Advanced et s’adresse aux utilisateurs souhaitant créer des outils pour analyser ou traiter la structure des bases de données.
Chapitre 1
|
Démarrage
9
1
Guide de la publication Web instantanée FileMaker
: explique comment rendre les bases de données FileMaker Pro et FileMaker Pro Advanced accessibles aux utilisateurs de navigateurs Web via un réseau intranet ou Internet
1
Installation des pilotes FileMaker sur les clients ODBC et JDBC
: décrit l’installation des fichiers de pilotes pour l’utilisation des produits FileMaker avec des applications ODBC et JDBC.
1
Guide du développeur ODBC et JDBC FileMaker
: décrit l’utilisation d’ODBC et de JDBC avec les produits FileMaker.
Emplacement de la documentation PDF
Vous trouverez la plupart des manuels PDF dans le dossier d’installation de FileMaker Pro Advanced. Si vous avez installé
FileMaker Pro Advanced dans le dossier d’installation par défaut, vous trouverez les manuels au format PDF aux emplacements suivants :
1
Windows :
C:\Program files\FileMaker\FileMaker Pro 8
Advanced\Extras en français\Documentation électronique
1
Mac OS :
Disque dur Macintosh/Applications/FileMaker
Pro 8 Advanced/Extras en français/Documentation électronique
Les manuels au format PDF pour ODBC et JDBC se trouvent sur le
CD FileMaker Pro Advanced, dans le dossier /xDBC/Documentation
électronique.
Pour lire les fichiers PDF, un lecteur de PDF est nécessaire. Sous
Mac OS X, vous pouvez utiliser l’application d’aperçu intégrée ou
Adobe
®
Reader
®
. Les utilisateurs Windows doivent utiliser Adobe
Reader. Si l’application Adobe Reader n’est pas installée sur votre poste, vous pouvez la télécharger depuis le site Web d’Adobe
à l’adresse www.adobe.com.
Important
Vous pouvez télécharger la version PDF de la documentation de FileMaker à l’adresse suivante : www.filemaker.fr/ downloads. Les mises à jour de ce document sont également disponibles sur le site Web.
10
Guide de développement FileMaker Pro Advanced
Enregistrement et assistance technique
Lors de l’installation, veuillez prendre le temps d’enregistrer votre produit sur le site Web FileMaker, à l’adresse www.filemaker.fr/ register, ou en choisissant le menu Aide > S’enregistrer maintenant dans FileMaker Pro Advanced.
Pour plus d’informations sur l’assistance technique et le service clientèle, consultez : www.filemaker.com (Amérique du Nord) www.filemaker.com/intl (clients ne résidant pas en Amérique du Nord) ou choisissez le menu Aide > FileMaker sur le Web . Sur le site Web, vous trouverez le dossier d’assistance technique FileMaker, dans lequel sont présentées toutes les options disponibles (clients résidant en Amérique du Nord). Ce site vous propose également des liens renvoyant aux sites internationaux de FileMaker, des réponses aux questions les plus fréquentes et un accès à la base de connaissances et d’informations techniques, TechInfo, utilisée par les membres du service d’assistance technique. Les clients n’ayant pas accès à Internet peuvent se reporter au dossier d’assistance technique FileMaker livré avec le logiciel. Les clients résidant en Amérique du Nord peuvent aussi composer le (800) 965-9090 pour en savoir plus sur les différentes options disponibles.
A propos du numéro de licence
Le logiciel FileMaker est livré avec un numéro de licence unique de
35 caractères. Ne perdez pas ce numéro de licence car il ne peut pas
être remplacé. Nous vous recommandons de le conserver dans un lieu sûr au cas où vous devriez réinstaller le logiciel.
Important
Vous devez entrer le numéro de licence durant l’installation, sinon le logiciel ne s’installe pas.
Le numéro de licence garantit le respect d’une licence utilisateur unique, autorisant généralement l’utilisation d’une (1) copie du logiciel sur un seul ordinateur à la fois (reportez-vous à votre contrat de licence). Si ce numéro n’est pas valide ou qu’une autre copie de l’application installée avec ce même numéro fonctionne sur le réseau, l’application FileMaker Pro affiche le message d’erreur suivant :
« Le nombre maximal d’utilisateurs autorisé par cette licence
FileMaker Pro Advanced est déjà atteint. Veuillez consulter la section
Numéro de licence de la documentation de votre logiciel pour plus d’informations. »
Si ce message s’affiche, cela signifie que vous avez saisi un numéro de licence déjà utilisé. Pour installer FileMaker Pro Advanced sur plusieurs ordinateurs, vous devez disposer d’un numéro de licence unique pour chaque utilisateur ou acquérir une licence pour plusieurs ordinateurs. Vous devez posséder une licence FileMaker Pro Advanced pour chaque ordinateur.
Respect du contrat de licence pour les solutions d’exécution
Le contrat de licence FileMaker Pro Advanced vous autorise à diffuser, en franchise de droits, un nombre illimité de solutions d’exécution FileMaker Pro. Néanmoins, vous devez respecter un certain nombre de termes et conditions du contrat de licence.
1
Vous devez assurer l’ensemble de l’assistance technique aux utilisateurs.
1
Vous devez fournir un modèle « A propos de » contenant vos nom et adresse, ainsi que le numéro de téléphone de l’assistance technique.
Pour plus d’informations, consultez la rubrique « Création d’un modèle A propos de », page 85.
Remarque
Avant toute utilisation de FileMaker Pro Advanced, vous devez lire attentivement et accepter les termes et conditions de la licence qui est affichée par le programme d’installation de
FileMaker Pro Advanced.
A propos de la base de connaissances TechInfo
La base de connaissances TechInfo est une source essentielle d’informations techniques sur les produits de FileMaker, Inc.
La base de données FileMaker Pro est utilisée en premier lieu par les techniciens de l’assistance technique de la société pour répondre aux demandes des clients. Elle contient des questions/réponses, des astuces, des rapports d’anomalies, des notes de mise à jour, des communiqués de presse et de nombreux autres éléments très utiles pour les membres de l’assistance technique.
La base de connaissances TechInfo est accessible depuis les pages d’assistance du site www.filemaker.fr.
Chapitre 1
|
Démarrage
11
12
Guide de développement FileMaker Pro Advanced
Chapitre 2
Personnalisation des solutions de base de données
Vous pouvez utiliser FileMaker Pro Advanced personnaliser plus encore vos solutions qu’avec FileMaker Pro. Utilisez cette solution pour :
1
ajouter des infobulles et fournir des informations sur les objets du modèle ;
1
1
créer des fonctions personnalisées à utiliser au sein d’un fichier ; copier et coller des scripts, des actions de script ou des rubriques et les utiliser au sein du même fichier ou dans d’autres fichiers de la base de données ;
1
copier ou importer les tables existantes dans votre fichier de base de données ;
1
créer une solution qui affiche votre base de données en mode Borne de communication.
Ajout d’infobulles pour les objets du modèle
Vous pouvez utiliser FileMaker Pro Advanced pour ajouter des infobulles aux objets du modèle. Les infobulles s’affichent lorsqu’un utilisateur déplace le curseur sur un objet en mode Utilisation ou
Recherche. Les infobulles peuvent correspondre à du texte statique ou provenir d’un calcul.
Pour ajouter, modifier ou supprimer des infobulles :
1.
En mode Modèle, sélectionnez l’objet auquel vous souhaitez ajouter une infobulle.
2.
Choisissez le menu Format > Définir infobulle.
Conseil
Vous pouvez également cliquer sur l’objet avec le bouton droit de la souris et sélectionner Définir infobulle.
3. Dans la boîte de dialogue Définir infobulle, procédez aux actions décrites ci-après, puis cliquez sur OK:
Pour Procédure
Créer une infobulle qui affiche du texte statique
Saisissez le texte que vous souhaitez voir apparaître.
Créer une infobulle qui affiche les résultats d’un calcul
Cliquez sur Définir.
Dans la boîte de dialogue Calcul, élaborez votre formule de calcul. Cliquez sur OK.
Modifier l’infobulle Modifiez le texte de l’infobulle tel que souhaité.
Supprimer l’infobulle Supprimez le texte de l’infobulle.
Conseil
En mode Modèle, sélectionnez le menu Affichage > Afficher >
Infobulles pour identifier les objets liés aux infobulles. Les objets associés à des infobulles utilisent l’icône en mode Modèle.
Infobulle
14 Guide de développement FileMaker Pro Advanced
Notez les points suivants :
1
Les infobulles s’affichent dans FileMaker Pro, FileMaker Pro
Advanced, et dans les solutions d’exécution et les bases de données publiées sur Internet à l’aide de la publication Web instantanée. Vous devez utiliser FileMaker Pro Advanced pour ajouter, modifier ou supprimer des infobulles.
1
Si vous ouvrez un fichier contenant un objet associé à une infobulle dans FileMaker Pro 7 ou FileMaker Developer 7 et que vous copiez cet objet, puis que vous rouvrez le fichier dans FileMaker Pro Advanced, l’icône de l’infobulle s’affiche pour l’objet copié mais sans le texte qui lui est associé. Sélectionnez l’objet, choisissez le menu Format > Définir infobulle, puis saisissez le texte de l’infobulle ou cliquez sur OK pour supprimer l’icône. En dupliquant des objets dans FileMaker 7, vous conservez le texte de l’infobulle.
1
Les infobulles s’affichent en modes Utilisation et Recherche, ainsi qu’en modes affichage sous forme de formulaire, de liste et de table.
1
Vous pouvez sélectionner plusieurs objets du modèle et leur affecter à chacun la même infobulle. Si vous sélectionnez plusieurs objets, la boîte de dialogue Définir infobulle affiche l’infobulle relative à l’objet du haut.
1
Vous pouvez ajouter une infobulle à des objets groupés.
Tous les objets du groupe afficheront alors la même infobulle.
1
Tous les résultats d’un calcul s’affichent sous forme de texte et utilisent des dates, des heures et des nombres.
1
Si le calcul d’une infobulle d’objet renvoie une chaîne vide, aucune infobulle ne s’affiche. Par exemple, si votre infobulle affiche les données concernées et que la relation est absente, l’infobulle sera vide. Si une erreur survient dans le calcul, l’infobulle affiche les résultats non valides ou partiellement valides accompagnés de points d’interrogation.
1
Si vous copiez ou dupliquez un objet lié à une infobulle, FileMaker applique cette infobulle au nouvel objet.
1
Le texte de l’infobulle est automatiquement renvoyé à la ligne s’il dépasse 40 % de la largeur de l’écran.
Copie des scripts, des actions de script ou des rubriques
Vous pouvez copier l’intégralité des scripts, des actions de script spécifiques ou des rubriques d’un fichier et les coller dans le même fichier ou dans un fichier différent.
1. Effectuez l’une des opérations suivantes :
Pour copier un(e)
Script
Action de script
Rubrique
Procédure
Choisissez le menu Scripts > ScriptMaker.
Choisissez le menu Scripts > ScriptMaker. Sélectionnez ensuite le script dans la liste, puis cliquez sur Modifier pour ouvrir la boîte de dialogue Modifier le script.
Choisissez Fichier > Définir > Base de données > onglet Rubriques.
2. Sélectionnez le script, l’action de script ou la rubrique à copier.
3. Cliquez sur Copier.
4. Ouvrez la boîte de dialogue appropriée dans le fichier dans lequel vous souhaitez coller le script, l’action de script ou la rubrique copiée.
5. Cliquez sur Coller.
Remarque
Sélectionnez le script ou l’action de script après laquelle vous souhaitez que le script ou l’action de script collée s’affiche, puis cliquez sur Coller.
Notez les points suivants :
1
Aucun privilège ne reste associé aux objets collés. Pour cette raison, vous devez redéfinir les jeux de privilèges dans le fichier de destination.
1
Pour plus de détails sur les références et les composants non résolus et renommés en raison d’un conflit de nom, ouvrez le fichier
Import.log, normalement situé dans le dossier contenant votre base de données de destination. Si vous avez ouvert la base de données de destination à distance ou que vous ne disposez pas de droits d’écriture sur ce dossier, vérifiez le dossier Mes documents (Windows) ou
Documents (Mac OS).
1
FileMaker Pro Advanced conserve les références aux scripts, aux actions de script et aux rubriques si elles sont valides au moment du collage. Si vous copiez plusieurs scripts, actions de script ou rubriques qui font référence les un(e)s aux autres, effectuez cette action en une seule étape pour conserver les références. Si vous les copiez de manière individuelle, ces mêmes références seront perdues.
Vérifiez toutes les références après le collage pour vous assurer qu’elles sont valides.
1
Pour copier et coller des scripts, vous devez disposer de droits en écriture sur le script source et de privilèges particuliers pour créer des scripts dans le fichier de destination.
1
Pour copier et coller des actions de script, vous devez disposer d’un droit en écriture sur les scripts source et de destination.
1
Pour copier et coller des rubriques, vous devez disposer d’autorisations d’accès intégrales sur les fichiers source et de destination.
1
Lorsque vous copiez des scripts dont certaines actions ont été désactivées, vous ne réactivez pas celles-ci au moment où vous les collez à un nouvel emplacement. Pour plus d’informations,
reportez-vous à la rubrique « Désactivation des actions du script », page 64.
1
Les points d’arrêt ne sont pas copiés au moment de la copie des scripts ou des actions de script. Toutefois, ces mêmes points d’arrêt sont conservés lorsque vous dupliquez des scripts ou des actions de script.
Chapitre 2
|
Personnalisation des solutions de base de données 15
Copie ou importation des tables dans un fichier
FileMaker Pro Advanced vous aide à consolider des tables dans un fichier unique, à partir d’une solution multifichier. Il existe deux méthodes de consolidation des solutions :
1
Copie des schémas de table : ouvrez les fichiers source pour sélectionner et copier les tables voulues. Collez ensuite les schémas de table dans le fichier de destination.
1
Importation des schémas de table : importez les schémas de table directement dans le fichier de destination. Vous pouvez importer les schémas seulement ou les données dans un schéma unique.
(Pour importer les données dans un schéma unique, choisissez le menu Fichier > Importer des enregistrements > Fichier. Pour plus d’informations, consultez l’Aide.)
Lorsque vous copiez ou importez des tables :
1
FileMaker Pro Advanced conserve les références aux scripts, aux actions de script et aux rubriques si elles sont valides au moment où vous les collez. Si vos tables font référence les unes aux autres au sein des rubriques, copiez-les ou importez-les en une seule fois pour conserver ces références. Si vous les copiez ou les importez de manière individuelle, ces mêmes références seront perdues. Vérifiez toutes les références après le collage ou l’importation pour vous assurer qu’elles sont valides.
1
Pour plus de détails sur les références et les composants non résolus et renommés en raison d’un conflit de nom, ouvrez le fichier
Import.log, normalement situé dans le dossier contenant votre base de données de destination. Si vous avez ouvert la base de données de destination à distance ou que vous ne disposez pas de droits d’écriture sur ce dossier, vérifiez le dossier Mes documents (Windows) ou
Documents (Mac OS).
1
Vous devez disposer d’autorisations d’accès intégrales pour les fichiers source et de destination.
16 Guide de développement FileMaker Pro Advanced
1
Les privilèges associés au fichier source ne sont pas conservés.
Vous devez redéfinir les jeux de privilèges dans le fichier de destination.
1
Les liens entre les occurrences d’une table ne sont pas conservés.
1
Avant d’importer les tables, vous devez convertir les fichiers de base de données créés dans des versions de FileMaker Pro antérieures
à la version 7.0. Pour plus d’informations sur la conversion des bases de données, consultez le Manuel de l’utilisateur FileMaker Pro.
Copie d’un schéma de table
Pour copier un schéma de table :
1. Ouvrez le fichier de base de données contenant la table que vous souhaitez copier.
2. Choisissez le menu Fichier > Définir > Base de données > onglet Tables.
3. Sélectionnez la table à copier.
4. Cliquez sur Copier.
5. Ouvrez le fichier de base de données dans lequel vous souhaitez coller la table.
6. Choisissez le menu Fichier > Définir > Base de données > onglet Tables.
7. Cliquez sur Coller.
Importation du schéma de table
1. Ouvrez le fichier de base de données dans lequel vous voulez importer une table.
2. Choisissez le menu Fichier > Définir > Base de données > onglet Tables.
3. Cliquez sur Importer.
4. Dans la boîte de dialogue Ouvrir fichier, sélectionnez le fichier source.
5. Dans la boîte de dialogue Importer des tables, sélectionnez les tables à importer dans la liste, puis cliquez sur OK.
6. Dans la boîte de dialogue Récapitulatif d’importation, cliquez sur
Ouvrir Fichier journal pour accéder à un fichier journal de la procédure plus détaillé, puis cliquez sur OK pour fermer la boîte de dialogue.
Remarque
Si vous avez créé des rubriques ou des tables et que vous souhaitez les importer dans le même fichier, fermez la boîte de dialogue Définir la base de données avant de lancer l’importation.
Utilisation des fonctions personnalisées
Utilisez les fonctions personnalisées pour créer des fonctions personnalisées réutilisables en n’importe quel endroit du fichier de base de données dans lequel elles ont été créées. Une fois les formules
écrites pour la fonction, il est inutile de les réécrire afin de les appliquer à d’autres rubriques ou de les utiliser dans d’autres scripts.
Vous pouvez conserver et modifier les fonctions personnalisées et les formules qu’elles contiennent dans un emplacement centralisé. Toute modification apportée à une fonction personnalisée sera reproduite dans toutes les instances qui l’utilisent.
1
Tous les utilisateurs du fichier de base de données contenant une fonction personnalisée peuvent utiliser celle-ci s’ils disposent des autorisations appropriées.
1
Les fonctions personnalisées s’exécuteront sur FileMaker Pro et
FileMaker Pro Advanced, ainsi que sur des plates-formes différentes, mais elles ne pourront être créées et modifiées que dans
FileMaker Pro Advanced.
1
Les fonctions nouvellement définies apparaissent sous leur propre catégorie dans la liste des fonctions des boîtes de dialogue Calcul et
Définir les fonctions personnalisées.
1
Si vous ne voulez pas que vos fonctions personnalisées soient visibles, vous pouvez désactiver leur affichage dans ces boîtes de dialogue.
1
Si vous ne disposez pas d’un droit d’accès intégral et tentez de modifier le calcul d’un script ou d’une rubrique utilisant une fonction personnalisée réservée aux comptes à accès intégral, la chaîne
<Fonction privée> s’affiche à la place de la fonction personnalisée.
Dans ce cas, vous ne pourrez pas modifier le calcul lorsque la chaîne <Fonction privée> apparaîtra dans la formule.
Création de fonctions personnalisées
Pour utiliser les fonctions personnalisées, vous devez disposer d’un droit d’accès intégral pour la base de données active.
Pour créer une fonction personnalisée :
1. Sélectionnez Fichier > Définir > Fonctions personnalisées.
2. Dans la boîte de dialogue Définir les fonctions personnalisées pour, cliquez sur Créer.
3. Dans la boîte de dialogue Modifier la fonction personnalisée, entrez un nom dans la zone Nom de la fonction.
Chapitre 2
|
Personnalisation des solutions de base de données 17
Les noms de fonctions personnalisées doivent présenter les caractéristiques suivantes :
1
Ils doivent nécessairement être uniques.
1
Ils ne doivent pas contenir plus de 100 caractères.
1
Ils peuvent contenir des espaces mais les caractères de soulignement sont à bannir.
4. Elaborez la formule.
Pour plus d’informations sur la création des formules, consultez l’Aide.
5. Si la formule requiert des paramètres, entrez le nom du paramètre dans la zone Paramètres de la fonction et cliquez sur le bouton Plus.
Pour modifier ou supprimer un nom de paramètre, sélectionnez-le dans la liste et cliquez sur le bouton Modifier ou Supprimer.
6. Cliquez à l’endroit où vous souhaitez qu’un élément apparaisse dans la zone de la formule.
Affichage sous forme de liste (ouvert)
Liste des paramètres
Liste des fonctions
Zone de la formule Les paramètres personnalisés s’affichent dans cet espace
Boîte de dialogue Modifier la fonction personnalisée
18 Guide de développement FileMaker Pro Advanced
7. Choisissez l’une des actions suivantes.
Elément à ajouter
Référence à un paramètre
Procédure
Dans la liste des paramètres, double-cliquez sur un paramètre.
Opérateur mathématique ou de texte
Cliquez sur un opérateur du clavier.
Opérateur logique ou comparatif
Choisissez un opérateur dans la liste Opérateurs.
Constante
Fonction
Entrez sa valeur.
Double-cliquez sur une fonction de la liste Fonctions.
Dans la zone de formule, remplacez le paramètre exemple par une valeur ou une expression.
Vous pouvez également taper les noms des paramètres, les opérateurs et les fonctions dans la boîte de dialogue Modifier la fonction personnalisée au lieu d’utiliser les listes et les touches de clavier.
8. L’option Tous les comptes définie par défaut pour l’option
Disponibilité permet à tous les utilisateurs de la base de données active de voir et d’utiliser la fonction personnalisée.
9. Pour que cette fonction soit disponible uniquement pour les comptes disposant d’un droit d’accès intégral, sélectionnez l’option
Uniquement les comptes dotés de tous les privilèges.
10. Cliquez sur OK.
Modification des fonctions personnalisées
Les modifications apportées à une fonction personnalisée s’appliquent
à toutes les utilisations de cette fonction.
Pour modifier une fonction personnalisée :
1. Sélectionnez Fichier > Définir > Fonctions personnalisées.
2. Dans la liste des fonctions personnalisées, sélectionnez la fonction
à modifier, puis cliquez sur Modifier.
3. Effectuez les modifications nécessaires dans la boîte de dialogue
Modifier la fonction personnalisée, puis cliquez sur OK.
Pour modifier le classement des fonctions dans la boîte de dialogue
Définir les fonctions personnalisées pour, choisissez une catégorie dans la liste Affichage.
Suppression de fonctions personnalisées
Une fonction personnalisée supprimée n’est plus disponible.
Si vous disposez de droits d’accès intégral pour une base de données et que vous modifiez un calcul utilisant une fonction personnalisée qui a été supprimée, le nom de cette fonction est remplacé par la chaîne
<Fonction manquante>.
Pour supprimer une fonction personnalisée :
1. Sélectionnez Fichier > Définir > Fonctions personnalisées.
2. Dans la liste des fonctions personnalisées, sélectionnez la fonction
à supprimer, puis cliquez sur Supprimer.
3. Poursuivez votre travail avec les fonctions personnalisées ou cliquez sur OK.
Copie de fonctions personnalisées
Vous pouvez dupliquer une fonction personnalisée, puis modifier la copie pour effectuer une opération similaire.
Pour dupliquer une fonction personnalisée :
1. Sélectionnez Fichier > Définir > Fonctions personnalisées.
2. Dans la liste des fonctions personnalisées, sélectionnez la fonction
à dupliquer, puis cliquez sur Dupliquer.
La copie de la fonction s’affiche dans la liste avec la mention
« Copie » située en regard de son nom.
3. Poursuivez votre travail avec les fonctions personnalisées ou cliquez sur OK.
A propos du mode Borne de communication
Le mode Borne de communication permet d’afficher votre solution de base de données ou d’exécution en plein écran, sans barres d’outils ni menus. Comme son nom l’indique, le mode Borne de communication peut être utilisé pour présenter une base de données aux utilisateurs sous forme de Borne de communication. Vous pouvez concevoir votre base de données de sorte qu’elle s’exécute via un écran tactile.
Les fichiers de bases de données qui s’ouvrent dans FileMaker Pro et
FileMaker Pro Advanced, ou dans l’application d’exécution, peuvent
être transformés en fichiers que vous ouvrez en mode Borne de communication au moyen de comptes disposant de jeux de privilèges particuliers. Lorsque vous créez une solution pour le mode Borne de communication, vous devez tenir compte de la façon dont les utilisateurs vont la parcourir et la fermer. Pour plus d’informations sur les comptes et privilèges, consultez l’Aide.
Chapitre 2
|
Personnalisation des solutions de base de données 19
Navigation en mode Borne de communication
Dans la solution en mode Borne de communication, les utilisateurs voient en premier le fichier principal. Ce mode de présentation n’affichant aucune barre de menu, ni contrôle de fenêtre, votre fichier principal doit contenir des boutons sur lesquels les utilisateurs cliquent pour naviguer dans l’application, fermer les fichiers et quitter
FileMaker Pro, FileMaker Pro Advanced ou l’application d’exécution.
Nous vous conseillons de planifier au préalable par écrit les modalités de navigation dans la solution en mode Borne de communication. Vous devez définir les actions associées à chaque bouton et donner aux utilisateurs un moyen de revenir au début de la solution à partir de l’ensemble des modèles. Pour contrôler encore davantage les éléments présentés aux utilisateurs, vous pouvez créer des scripts de démarrage qui affichent un modèle spécifique à l’ouverture d’un fichier.
1
Si votre Borne de communication doit fonctionner avec un
écran tactile, nous vous conseillons d’utiliser des boutons de grande dimension et très espacés.
1
Il est également conseillé de limiter le nombre d’options disponibles sur chaque écran.
1
Les boutons étant désactivés en mode Prévisualisation, vous devez vous assurer que toutes les actions de script conduisant au mode
Prévisualisation sont suivies d’une action Suspendre/reprendre script et indiquent la durée pendant laquelle le script doit demeurer en mode
Prévisualisation. Après l’action Suspendre/reprendre script, placez une action conduisant au Mode navigation.
Remarque
Lors de l’ouverture d’une solution en mode Borne de communication, l’accès au système d’exploitation est limité. Sur les ordinateurs fonctionnant sous Windows, la combinaison de touches
Alt+Tab vous permet d’ouvrir une autre application depuis une solution en mode Borne de communication.
20 Guide de développement FileMaker Pro Advanced
Fermeture de solutions en mode Borne de communication
Si vous n’avez pas prévu de bouton Sortie ou Quitter, les utilisateurs devront appuyer sur les touches Alt+F4 (Windows) pour effectuer une sortie forcée. Sous Mac OS X version 10.3 (v10.3), l’utilisateur peut sortir d’une solution fonctionnant en mode Borne de communication en appuyant sur F9 ou sur F11. Il accède ainsi à une autre fenêtre d’application ouverte. Sous Mac OS X versions 10.3 et 10.4, l’utilisateur peut accéder aux autres applications en appuyant sur
Ctrl-F2. Cette procédure n’est pas recommandée car elle risque d’altérer les données ou d’endommager les fichiers ouverts.
Pour vous assurer que les utilisateurs puissent toujours accéder au fichier principal et quitter l’application de la manière appropriée, vous devez :
1
fournir un script de démarrage permettant d’ouvrir le fichier principal dans chacun des fichiers auxiliaires ;
1
placer dans chaque fichier auxiliaire un bouton « Menu principal » qui exécute le script d’ouverture du fichier principal ;
1
ajouter un bouton Quitter dans le fichier principal.
Pour plus d’informations sur la création de boutons et de scripts permettant d’émuler les options de menus et les contrôles de fenêtre
Création de solutions en mode Borne de communication
Le mode Borne de communication est ignoré si la solution est ouverte
à l’aide de comptes associés à des autorisations d’accès intégral, à un jeu de privilèges autorisant la gestion des privilèges étendus ou à un jeu de privilèges autorisant la modification des modèles, des listes de valeurs et des scripts.
Pour afficher votre solution en mode Borne de communication, procédez comme suit :
1
Créez un compte associé à un jeu de privilèges restreint ou créez un compte spécifique pour le mode Borne de communication.
1
Activez le mode Borne de communication. Pendant cette opération vous pouvez lier la base de données en tant que solution d’exécution.
1
Désactivez l’option par défaut consistant à se connecter au fichier avec le compte Admin.
Pour créer un compte Borne de communication :
1. Veillez à disposer d’un compte à accès limité.
2. Lorsque la base de données est ouverte, choisissez le menu Fichier >
Définir > Comptes et privilèges.
3. Dans la boîte de dialogue Définir les comptes et privilèges, cliquez sur Créer.
4. Dans la boîte de dialogue Modifier compte, entrez un nom de compte, activez l’option Actif pour l’Etat du compte, puis sélectionnez
Nouveau jeu de privilèges dans la liste Jeu de privilèges.
5. Dans la boîte de dialogue Modifier le jeu de privilèges, donnez un nom au nouveau jeu et entrez une description.
6. Dans les rubriques Modèles, Listes de valeurs et Scripts, sélectionnez Tous visualisables uniquement ou Accès refusé pour tous.
7. Désactivez la case à cocher Gérer les autorisations étendues.
8. Au besoin, sélectionnez d’autres options.
9. Cliquez sur OK.
Pour activer le mode Borne de communication :
1. Suivez les étapes 1 à 9 de la rubrique « Modification des fichiers de la solution », page 70.
2. Dans la boîte de dialogue Options de solution, sélectionnez Activer le mode Borne de communication pour les comptes non Admin.
3. Au besoin, sélectionnez d’autres options.
4. Cliquez sur OK.
5. Pour pouvoir reproduire rapidement cette procédure, cliquez sur
Enregistrer paramètres et choisissez le dossier et l’emplacement de votre fichier de paramètres.
6. Cliquez sur Créer.
Si vous ne liez pas les fichiers à une application d’exécution, les Utilitaires Developer copient les fichiers de la base de données sélectionnée dans le Dossier de projet. Si vous liez les fichiers à une application d’exécution, les Utilitaires Developer copient tous les fichiers d’exécution dans un nouveau dossier, créé dans le Dossier de projet et nommé d’après la solution d’exécution.
Pour modifier l’option par défaut consistant à se connecter au fichier avec le compte Admin :
1. Lorsque la base de données est ouverte, choisissez le menu
Fichier > Options de fichier.
2. Dans l’onglet Ouvrir/Fermer, désactivez l’option Connexion via.
3. Cliquez sur OK.
Chapitre 2
|
Personnalisation des solutions de base de données 21
Utilisation des scripts et des boutons pour contrôler votre solution
Vous pouvez utiliser des scripts et des boutons pour automatiser une grande partie de votre solution, contrôler le démarrage, émuler les commandes de menu et les contrôles de fenêtre, la navigation, et bien plus encore. Pour plus d’informations sur la création de scripts pour l’automatisation de tâches, consultez l’Aide.
Conseil
Utilisez Script Debugger pour tester les scripts. Reportez-
vous à la rubrique « Passage d’un script à un autre », page 61.
Centrage des fenêtres de base de données en mode Borne de communication
Si vous optimisez un modèle destiné à s’afficher en 640 x 480 sur un écran dont la résolution est supérieure à 640 x 480, le modèle ne sera pas centré. Il s’affichera dans l’angle supérieur gauche et sera entouré d’un espace vide. Pour de meilleurs résultats, n’optimisez pas les fenêtres en mode Borne de communication. Utilisez Ajuster fenêtre[Ajuster la taille au contenu] et les actions de script Déplacer/ redimensionner fenêtre au lieu de centrer les fenêtres en fonction de la résolution d’écran de l’utilisateur. Utilisez les fonctions d’obtention pour déterminer la résolution.
Important
Avant d’utiliser l’action de script Ajuster fenêtre, vous devez exécuter toutes les autres actions qui affectent la zone de la fenêtre d’affichage (comme Activer modèle ou Afficher/Masquer zone d’état). Lorsque la zone de la fenêtre est définie, vous pouvez ajouter l’action de script Ajuster fenêtre.
L’action de script Ajuster fenêtre peut couvrir une fenêtre disposant d’un bouton Quitter application. Vous devez donc vous assurer que les utilisateurs pourront toujours fermer la Borne de communication aisément.
22 Guide de développement FileMaker Pro Advanced
Emulation des commandes de menu et des contrôles de fenêtre
Utilisez les actions de scripts suivantes pour émuler des commandes de menu et des contrôles de fenêtre.
Pour émuler ces éléments de l’interface
Commandes de menu
Contrôles du zoom Ajuster fenêtre ou Agrandir/réduire
Contrôle de la zone d’état Afficher/masquer zone d’état
Menu local Mode
Créez des boutons comportant les actions suivantes
Action de script pour chaque commande (par exemple, Trier enregistrements, Imprimer et
Ouvrir Préférences)
Barre de défilement verticale
Barre de défilement horizontale
Taille et position de la fenêtre
Mode Utilisation, Mode Recherche ou Mode
Prévisualisation
Faire défiler fenêtre (si le modèle est plus large que l’écran)
Faire défiler fenêtre (si les objets du modèle sont plus larges que l’écran)
Déplacer/redimensionner fenêtre
Boutons à états multiples
En utilisant des scripts et des calculs pour évaluer l’état des rubriques de bouton, vous pouvez créer des boutons à états multiples qui changent lorsque l’on clique dessus.
Pour créer des boutons à états multiples :
1. Définissez la rubrique du bouton à états multiples.
2. Créez le script du bouton à états multiples.
3. Reliez la rubrique et le script.
Voici un exemple de création de bouton qui change dès que l’on clique dessus.
Pour définir la rubrique du bouton à états multiples :
1. Choisissez Fichier > Définir > Base de données > onglet Rubriques.
2. Créez une rubrique nommée
Icônes
et choisissez le type Multimédia.
3. Cliquez sur Options > onglet Autres options.
4. Activez la case à cocher Utiliser le stockage global et entrez le nombre d’états du bouton dans la zone Nombre maximal de répétitions.
5. Cliquez sur OK.
6. En mode Utilisation, sélectionnez la rubrique Icônes et cliquez sur Insertion > Image pour lui ajouter des graphiques.
Rubrique multivaluée Global
Nombre de répétitions
Boutons graphiques ajoutés à une rubrique multivaluée
Conseil
Assurez-vous que toutes les images ont la même taille.
7. Choisissez Fichier > Définir > Base de données > onglet Rubriques.
8. Créez une rubrique multimédia nommée
Boutons
.
9. Cliquez sur Options > onglet Entrée automatique.
10. Dans la zone Résultat de calcul, cliquez sur Définir et entrez la fonction
GetRepetition (Icônes; 1)
11. Cliquez sur OK.
Pour créer le script du bouton à états multiples :
1. Choisissez le menu Scripts > ScriptMaker et cliquez sur Créer.
2. Nommez le script
Inverser boutons
.
3. Ajouter une action de script
Définir rubrique
.
4. Dans la zone Rubrique cible, cliquez sur Définir.
5. Double-cliquez sur Boutons.
6. Dans la zone Résultat du calcul, cliquez sur Définir.
7. Ecrivez une fonction Test qui évalue chaque expression de test
GetRepetition pour le nombre d’icônes et incrémente ce nombre de 1.
Chapitre 2
|
Personnalisation des solutions de base de données 23
Fonction Test pour les boutons à états multiples
8. Cliquez sur OK.
Pour relier la rubrique et le script :
1. Choisissez le menu Affichage > Mode Modèle.
2. Sélectionnez la rubrique Boutons et choisissez le menu Format >
Rubrique/Contrôle > Comportement.
3. Désactivez les deux cases à cocher Autoriser la saisie et cliquez sur OK.
4. Choisissez Format > Configuration du bouton.
5. Sélectionnez Exécuter script et Inverser boutons.
6. Cliquez sur OK.
Vous pouvez revenir en mode Utilisation et tester votre bouton à états multiples. Pour plus d’informations sur l’utilisation de boutons et de scripts, consultez l’Aide.
24 Guide de développement FileMaker Pro Advanced
Chapitre 3
Personnalisation des menus
Avec FileMaker Pro Advanced, vous pouvez créer des menus personnalisés pour vos solutions de base de données. Vous pouvez ajouter, modifier, dupliquer ou supprimer des menus et des éléments de menu de bien des façons :
1
Vous pouvez modifier le nom d’un élément de menu.
1
Vous pouvez exécuter un script ou une étape de script depuis un élément de menu. Vous avez également la possibilité d’exécuter des scripts depuis une icône de la barre d’outils associée et depuis le menu contextuel.
1
Vous pouvez affecter des raccourcis clavier et des touches d’accès personnalisées.
1
Vous pouvez indiquer une plate-forme pour les menus et les éléments des menus.
1
Vous pouvez définir un mode pour vos menus.
1
Vous pouvez indiquer des jeux de menu pour les fichiers et les modèles.
A propos de la personnalisation des menus
Vous pouvez personnaliser les menus en :
1
éditant une copie d’un menu FileMaker standard. Utilisez cette méthode pour procéder à des modifications mineures dans les menus existants, par exemple pour modifier les propriétés de quelques éléments de menu. Reportez-vous à la rubrique
« Personnalisation des menus », page 27.
1
commençant par un menu vide. Utilisez cette méthode pour procéder
à des modifications importantes dans les menus, par exemple pour ajouter des menus ou modifier les propriétés des éléments de menu.
Il vous faudra peut-être modifier les jeux de menu et indiquer à quel moment FileMaker doit les installer. Reportez-vous aux rubriques
« Personnalisation des jeux de menus », page 32 et « Installation
L’exemple qui suit montre comment personnaliser l’élément de menu
Nouvel enregistrement qui s’affiche dans le menu Enregistrements. Vous pouvez renommer l’élément de menu Nouvel enregistrement en Nouvelle facture, puis y joindre un script qui s’exécute lorsque l’utilisateur choisit l’élément de menu Nouvelle facture. Enfin, vous pouvez modifier le jeu de menus par défaut de sorte que votre nouveau jeu de menus personnalisés s’affiche lorsqu’un utilisateur ouvre la base de données.
Cet exemple part du principe que la base de données contient un script appelé Ma nouvelle facture. Le script Ma nouvelle facture automatise plusieurs tâches, comme par exemple le passage au modèle Factures et la création d’un enregistrement vide. Consultez l’Aide pour plus d’informations sur la création des scripts.
1. Ouvrez une base de données, choisissez le menu Fichier > Définir >
Menus personnalisés. Double-cliquez sur le menu Enregistrements copie pour modifier une copie du menu Enregistrements standard.
Reportez-vous à la rubrique « Création et modification des menus personnalisés », page 27.
2. Sélectionnez l’élément de menu Nouvel enregistrement pour modifier ses propriétés. Modifiez le titre de l’élément de menu
Nouvel enregistrement en Nouvelle facture. Reportez-vous à la rubrique
« Création et modification des éléments de menu », page 29.
3. Modifiez l’action de cet élément de menu pour exécuter le
26 Guide de développement FileMaker Pro Advanced
4. Définissez le jeu de menus par défaut du fichier sur Jeu de menus
5. Cliquez sur OK.
Comment les menus personnalisés affectent-ils d’autres fonctions ?
Les menus personnalisés peuvent avoir une incidence sur d’autres fonctions du produit. Notez les points suivants :
1
Les menus personnalisés s’affichent dans FileMaker Pro ainsi que dans les solutions d’exécution, mais ne peuvent pas être modifiés.
1
Les bases de données publiées sur le Web n’acceptent pas les commandes de menus personnalisés. Par exemple, si vous personnalisez la commande Nouvel enregistrement pour quitter l’application, vous n’observerez aucune incidence sur la publication
Web instantanée ; les utilisateurs Web auront accès à la commande
Nouvel enregistrement par défaut.
1
Les fonctions de FileMaker ne sont opérationnelles que si elles font partie d’un menu. Par exemple, si vous supprimez le menu Affichage du jeu des menus et que vous ne disposez d’aucun bouton de script sur le modèle pour passer d’un affichage à un autre, les boutons de mode de la zone d’état seront désactivés, interdisant ainsi aux utilisateurs de passer d’un mode à un autre.
1
Si le menu Edition ne fait pas partie d’un jeu de menus installé, les raccourcis Couper, Copier et Coller ne fonctionneront pas.
1
Il est important de fournir à l’utilisateur la documentation accompagnant votre solution car les menus personnalisés ne correspondront pas à la documentation du produit.
1
Les menus et les éléments de menu standard de FileMaker peuvent
être localisés en fonction de la langue du système d’exploitation.
Toutefois, si vous personnalisez le titre d’un menu ou d’un élément de menu, il ne sera pas localisé au moment où vous adopterez une langue différente dans votre système.
1
Les éléments de menu standard FileMaker apparaissent en grisé si les utilisateurs ne possèdent aucune autorisation pour exécuter la commande de menu. Les menus n’apparaissent pas en grisé si vous attachez un script à l’élément de menu.
1
L’action de script Ouvrir Aide affiche l’aide de FileMaker Pro et non l’aide personnalisée.
Terminologie des menus personnalisés
Avant de commencer à utiliser les menus personnalisés, vous devez vous familiariser avec les termes suivants.
Terme
Barre de menus
Jeu de menus
Menu
Elément de menu
Propriétés de l’élément de menu
Sous-menu
Raccourci
Touche d’accès
(Windows)
Description
Zone située en haut de l’écran (Mac OS) ou de la fenêtre (Windows) et affichant le jeu de menus installé.
Ensemble de menus s’installant sur la barre de menus.
Liste des éléments d’un menu. Chaque menu possède un titre qui s’affiche dans la barre de menus. Les menus s’affichent selon la plate-forme indiquée et les réglages du mode.
Elément unique répertorié dans un menu sur la barre de menus. Un élément de menu permet d’effectuer une action ou constitue un sous-menu ou bien un séparateur. Les éléments de menu s’affichent en fonction des paramètres de plate-forme indiqués.
Ensemble des paramètres d’un élément de menu, y compris la plate-forme, le titre qui s’affiche, le raccourci et l’action.
Menu qui développe un autre élément de menu.
Egalement appelé raccourci clavier. Indique la combinaison de touches du clavier pouvant être utilisée en remplacement de l’élément de menu de la commande.
Les utilisateurs ont la possibilité de sélectionner un menu ou un élément de menu en appuyant sur la touche d’accès tout en maintenant la touche Alt enfoncée.
Terme
Action
Commande
Titre d’écran
Séparateur
Menus FileMaker standard
Description
Ignore l’action de l’élément de menu pour exécuter un script ou une action de script spécifique.
Indique la tâche à exécuter, par exemple la suppression d’un enregistrement.
Texte ou nom apparaissant sur la barre de menus ou sur le menu pour identifier un menu ou un élément de menu.
Ligne au sein du menu destinée à séparer ou à regrouper les éléments de la liste.
Jeu de menus contenant tous les menus FileMaker par défaut, non personnalisés.
Menu
Titre d’écran du menu
Terminologie des menus personnalisés
Séparateur
Jeu de menus
(pour cette fenêtre de fichier)
Elément de menu
Sous-menu
Barre de menus
Chapitre 3
|
Personnalisation des menus 27
Personnalisation des menus
Vous pouvez utiliser FileMaker Pro Advanced pour créer des menus personnalisés. Les actions suivantes sont possibles :
1
Création d’un menu ou modification d’un menu existant
1
Duplication ou suppression d’un menu
1
Ajout, duplication ou suppression des éléments de menu
1
Spécification des propriétés des éléments de menu, comme par exemple le titre d’écran, le raccourci et l’action
Remarque
Vous devez disposer d’autorisations d’accès intégrales pour personnaliser les menus.
Création et modification des menus personnalisés
Vous pouvez créer un menu en commençant avec un menu vide ou en modifiant une copie d’un menu FileMaker standard.
Vous pouvez dupliquer un menu pour procéder à des modifications, sans pour autant intervenir sur le menu d’origine ni supprimer des menus dont les utilisateurs ont encore besoin.
Pour dupliquer ou supprimer un menu :
1. Choisissez le menu Fichier > Définir > Menus personnalisés > onglet
Menus personnalisés.
2. Effectuez l’une des actions décrites ci-après dans la boîte de dialogue Définir menus personnalisés, puis cliquez sur OK :
Pour
Dupliquer un menu
Supprimer un menu
Procédure
Sélectionnez le menu dans la liste, puis cliquez sur
Dupliquer.
Sélectionnez le menu dans la liste, puis cliquez sur
Supprimer.
Important
Au moment de supprimer un menu, vous supprimez également ses éléments.
28 Guide de développement FileMaker Pro Advanced
Pour créer ou modifier un menu :
1. Choisissez le menu Fichier > Définir > Menus personnalisés > onglet
Menus personnalisés.
Les menus figurant entre parenthèses ne sont pas personnalisables ; ils sont verrouillés.
Onglet Menus personnalisés de la boîte de dialogue
Définir menus personnalisés.
2. Effectuez l’une des actions décrites ci-après dans la boîte de dialogue Définir menus personnalisés :
Pour Procédure
Créer un menu Cliquez sur Créer.
Dans la boîte de dialogue Créer un menu personnalisé, effectuez l’une des actions suivantes, puis cliquez sur OK :
1
Cliquez sur Commencer avec un menu vide.
1
Cliquez sur Commencer avec un menu standard de
FileMaker, puis sélectionnez un menu dans la liste.
Remarque
Vous pouvez cliquer en même temps sur la touche Maj et sur Créer pour créer un menu vide.
Modifier un menu existant
Sélectionnez le menu dans la liste, puis cliquez sur Modifier.
3. Dans la boîte de dialogue Modifier le menu personnalisé, précisez les options relatives au menu personnalisé.
Pour
Préciser le nom du menu
Procédure
Dans Nom de menu personnalisé, saisissez un nom décrivant le menu (jusqu’à 100 caractères). Ce nom s’affiche alors dans la colonne Menu personnalisé de la boîte de dialogue Définir menus personnalisés.
En revanche, il n’apparaît pas dans le menu ni dans la barre de menus.
Préciser le titre que vous souhaitez afficher dans la barre de menus.
Dans Titre d’écran par défaut, sélectionnez Ignorer le titre, puis saisissez son nom (jusqu’à 30 000 caractères).
Pour indiquer une touche d’accès (Windows), insérez le caractère & avant le caractère que vous souhaitez utiliser comme touche d’accès. Par exemple, entrez
&Fichier pour afficher le menu Fichier à l’aide de la touche F du clavier.
Pour faire reposer le titre du menu sur le résultat d’un calcul, cliquez sur Définir, puis élaborez une formule dans la boîte de dialogue Calcul.
Remarque
Vous ne pouvez pas modifier le nom de l’Aide ni des menus FileMaker Pro.
Insérer un commentaire dans la boîte de dialogue Définir menus personnalisés
Entrez un commentaire relatif au menu (jusqu’à
30 000 caractères).
Choisir une plate-forme pour un menu
Sélectionnez Windows, Macintosh ou les deux.
Votre menu s’affiche alors sur les plates-formes sélectionnées.
Indiquer les modes dans lesquels afficher le menu
Dans Mode Menu, indiquez dans quels modes vous souhaitez que le menu apparaisse (Parcourir,
Rechercher ou Visualisation). Lorsque les utilisateurs passent d’un mode à un autre, le jeu de menus disponible change et affiche uniquement les menus désignés pour ce mode.
4. Pour ajouter ou modifier les éléments d’un menu dans le menu lui-
même, passez à l’étape 3 de la rubrique « Création et modification des
Ces options s’appliquent
à l’intégralité du menu
Boîte de dialogue Modifier le menu personnalisé
Création et modification des éléments de menu
Après avoir créé un menu, passez aux éléments de ce menu. Vous pouvez également créer ou modifier les éléments de menu qui sont des copies de menus FileMaker standard. Les éléments de menu peuvent
être des commandes, des sous-menus ou des séparateurs. Créez un
élément de menu qui dépend d’une commande FileMaker standard ou auquel aucune commande n’est affectée à l’origine.
Lorsque vous basez un élément de menu sur une commande
FileMaker, il hérite de toutes les propriétés de la commande.
Vous pouvez ignorer ces propriétés (titre, raccourci ou action) afin de personnaliser l’élément du menu.
Au moment de créer un élément de menu ne possédant aucune commande attitrée, un élément de menu sans titre s’affiche dans la liste Eléments de menu de la boîte de dialogue Modifier le menu personnalisé. Vous avez alors la possibilité de personnaliser les propriétés de l’élément de menu.
1. Choisissez le menu Fichier > Définir > Menus personnalisés > onglet Menus personnalisés.
2. Dans la boîte de dialogue Définir menus personnalisés, sélectionnez le menu dans la liste, puis cliquez sur Modifier.
Chapitre 3
|
Personnalisation des menus 29
3. Dans la boîte de dialogue Modifier le menu personnalisé, sélectionnez les éléments du menu à insérer dans le menu :
Pour Procédure
Ajouter une commande Cliquez sur Commande.
Dans la boîte de dialogue Spécifier une commande
FileMaker, effectuez l’une des actions décrites ci-après, puis cliquez sur OK.
1
Cliquez sur Aucune commande affectée.
FileMaker Pro Advanced ajoute un élément de menu Sans titre dans la liste Eléments de menu.
Vous devez préciser les propriétés de cette
1
Cliquez sur Utiliser une commande FileMaker, puis sélectionnez une commande dans la liste.
Cette commande détermine l’action ou le comportement de l’élément de menu.
Conseil
Vous pouvez maintenir la touche Maj enfoncée et cliquer sur Commande pour créer un élément de menu commande Sans titre.
Ajouter un sous-menu Cliquez sur Sous-menu pour ajouter d’autres commandes de menu au menu actuel.
Dans la boîte de dialogue Spécifier le sous-menu, sélectionnez le menu à intégrer, puis cliquez sur OK.
Remarque
Vous pouvez ajouter jusqu’à 100 menus dans la barre de menus. Si vous ajoutez un menu qui s’insère comme un sous-menu, il se peut que vous atteigniez rapidement la limite fixée.
Ajouter une ligne de séparation
Sélectionnez l’élément du menu dans la liste dans laquelle vous souhaitez que la ligne de séparation apparaisse, puis cliquez sur Séparateur.
Dupliquer un élément de menu
Supprimer un élément de menu
Sélectionnez un élément de menu dans la liste, puis cliquez sur .
Sélectionnez un élément de menu dans la liste, puis cliquez sur .
30 Guide de développement FileMaker Pro Advanced
Les éléments s’affichent dans le menu, dans l’ordre indiqué dans la liste. Faites glisser une flèche vers le haut ou vers le bas pour modifier l’ordre.
Boîte de dialogue Modifier le menu personnalisé
4. Sélectionnez chaque élément de menu dans la liste Eléments de menu, puis indiquez ses propriétés.
Pour
Modifier une commande d’un
élément de menu
Procédure
Cliquez sur Définir. Dans la boîte de dialogue Spécifier une commande FileMaker, sélectionnez une commande, puis cliquez sur OK.
Choisir une plate-forme pour un élément de menu
Sélectionnez Windows, Macintosh ou les deux. Votre
élément de menu s’affiche alors sur les plates-formes sélectionnées.
Remarque
Certaines commandes sont valides uniquement sur une plate-forme.
Pour
Modifier le titre d’un
élément de menu
Modifier un raccourci d’un élément de menu
Procédure
Sélectionnez Titre et saisissez le texte. Pour indiquer une touche d’accès (Windows), tapez le caractère & avant le caractère que vous souhaitez utiliser comme touche d’accès. Par exemple, entrez
&Ouvrir
pour afficher le menu Ouvrir à l’aide de la touche O du clavier.
Pour faire reposer le titre du menu sur le résultat d’un calcul, cliquez sur Définir, puis élaborez une formule dans la boîte de dialogue Calcul.
Remarque
Les éléments de menu sans titre ne sont associés à aucune case à cocher.
Sélectionnez Raccourci. Dans la boîte de dialogue
Définir un Raccourci, entrez la combinaison de touches souhaitée, puis cliquez sur OK.
Générer un script ou une action de script qui sera utilisée lorsqu’un utilisateur sélectionnera un élément de menu.
Sélectionnez Action, effectuez l’une des opérations ci-après, puis cliquez sur OK.
1
Sélectionnez Script. Dans la boîte de dialogue
Options « Script », sélectionnez un script, puis saisissez les paramètres de script facultatifs si nécessaire.
1
Sélectionnez Etape du script. Dans la boîte de dialogue Définir une action de script, sélectionnez une étape, précisez les options si nécessaire, puis cliquez sur OK.
Remarque
Les éléments de menu sans titre ne sont associés à aucune case à cocher de type Action.
Conseil
Pour intervenir sur le comportement d’un script en cours d’exécution (par exemple, arrêter, quitter, reprendre le script ou le mettre en pause), choisissez Etape du script, puis utilisez l’action de script Exécuter script.
Pour plus d’informations sur les scripts et les actions de script, consultez l’Aide.
Spécification des propriétés d’un élément de menu
Informations d’utilisation au sujet de la commande sélectionnée
Boîte de dialogue Modifier le menu personnalisé
Notez les points suivants :
1
Pour ignorer le comportement d’une commande (titre, raccourci ou action), vous devez activer sa case à cocher. Si la case à cocher n’est pas activée, le comportement de la commande d’origine est celui qui prévaut.
1
Les icônes de la barre d’outils sont liées aux éléments de menu. Si vous personnalisez un élément de menu associé à une icône dans la barre d’outils, vous personnalisez également cette icône. Par exemple, l’icône Nouvel enregistrement est liée à l’élément de menu du même nom. Si vous personnalisez l’élément de menu Nouvel enregistrement en le renommant Nouveau contact et que vous indiquez un script à exécuter, l’icône de la barre d’outils exécutera le script Nouveau contact et l’infobulle de cette icône affichera Nouveau contact. La zone d’utilisation de la boîte de dialogue Modifier le menu personnalisé indique que vous procédez à la personnalisation d’un élément de menu qui est lié à une icône de la barre d’outils.
Chapitre 3
|
Personnalisation des menus 31
1
Les menus contextuels s’affichent lorsqu’un utilisateur clique avec le bouton droit de la souris (Windows) ou avec la touche Contrôle
(Mac OS) sur un objet ou sur une zone donnée. Si vous personnalisez un élément de menu qui possède un élément de menu contextuel, vous personnalisez également le comportement associé à ce même élément.
1
FileMaker Pro Advanced met à jour les menus et les éléments de menu lorsqu’un jeu de menus doit être modifié à l’aide du basculement entre les modes, des fenêtres, des modèles ou de l’exécution d’un script qui conduit à un résultat similaire. Les titres des menus et des éléments de menu qui varient en fonction du contenu de la rubrique ou des fonctions se mettent à jour uniquement lorsque les jeux de menus changent.
1
Si vous saisissez le même raccourci ou les mêmes touches d’accès pour ces deux éléments de menu, FileMaker reconnaîtra la première occurrence dans la barre de menu (de la droite vers la gauche et du haut vers le bas).
1
Pour faire apparaître un caractère & dans le titre d’un menu ou d’un élément de menu, vous devez le saisir deux fois. Par exemple, si vous souhaitez qu’un titre de menu apparaisse sous la forme
Enregistrements & Rapports, il vous faudra le saisir sous la forme
Enregistrements && Rapports
.
1
Vous pouvez modifier les jeux de privilèges dans la boîte de dialogue Modifier le jeu de privilèges pour contrôler les éléments de menu activés.
1
Si vous avez défini Commandes disponibles sur Edition uniquement ou Minimum, les éléments de menu dépendant de commandes
FileMaker sont activés ou désactivés en fonction de ce paramètre.
Tous les autres éléments de menu, y compris les éléments associés
à des actions personnalisées, sont désactivés. Par exemple, si vous choisissez Edition uniquement, toutes les commandes d’édition de base de FileMaker sont activées mais tous les autres éléments
(y compris les éléments associés à des actions personnalisées) sont désactivés.
32 Guide de développement FileMaker Pro Advanced
1
Si vous définissez Commandes disponibles sur Tous, tous les éléments de menu sont activés normalement. Pour plus d’informations sur les autorisations d’accès, consultez l’Aide.
1
FileMaker utilise des raccourcis qui n’apparaissent pas dans la barre de menus. Par exemple, Commande-Option-Z dans une fenêtre
Mac OS. En outre, le système d’exploitation définit les raccourcis.
Les deux types de raccourcis écrasent ceux que vous définissez dans la boîte de dialogue Définir un Raccourci.
1
Les raccourcis pour Windows et Mac OS sont différents. Par exemple, si vous utilisez FileMaker Pro Advanced pour Windows pour définir le raccourci Ctrl+H, puis que vous ouvrez le fichier dans Mac OS, une correspondance est établie entre ce raccourci et Commande-H, ce qui crée un conflit avec le raccourci Mac OS destiné à masquer une application ouverte. Le raccourci fonctionne comme prévu sous Windows, mais sous Mac OS, le raccourci du système d’exploitation écrase le raccourci personnalisé.
1
Veillez à tester les raccourcis personnalisés sur les deux platesformes. Pour plus d’informations sur les raccourcis, consultez la documentation fournie avec votre système d’exploitation.
1
Mac OS : Vous pouvez affecter des raccourcis clavier aux applications utilisant les préférences système clavier et souris de
Mac OS X. Si vous définissez un raccourci clavier pour un menu
FileMaker Pro dans les préférences système, il devient le raccourci par défaut de la commande de menu dans Menus personnalisés, y compris dans le jeu Menus FileMaker standard. Cet élément de menu figurera toujours dans le menu et les utilisateurs ne pourront pas modifier le raccourci en effectuant des modifications dans les boîtes de dialogue de menu personnalisé.
Personnalisation des jeux de menus
Vous pouvez créer des jeu de menus personnalisés pour insérer les menus souhaités. Libre à vous également de spécifier un jeu de menus pour un fichier donné ou pour des modèles individuels.
Notez les points suivants :
1
Mac OS : Si vous n’insérez aucun menu Aide dans votre jeu de menus, le système d’exploitation installera un menu Aide vide. Vous ne pouvez pas supprimer ce menu, modifier sa position dans la barre de menu ni changer son titre.
1
Mac OS : Le menu FileMaker est ajouté après le menu Pomme.
Vous ne pouvez pas personnaliser les éléments du menu Quitter ou Préférences. Les seuls éléments que vous êtes en mesure de personnaliser sont les éléments de menu A propos de FileMaker Pro et Partage.
1
Windows : L’élément de menu Quitter est ajouté à la fin du premier menu non verrouillé (modifiable). Vous ne pouvez pas personnaliser l’élément de menu Quitter.
Création et modification des jeux de menus
Vous pouvez créer un nouveau jeu de menus, et modifier ou dupliquer un jeu existant. Vous pouvez également supprimer les jeux de menus dont vos utilisateurs n’ont plus besoin.
Important
La duplication d’un jeu de menus personnalisé crée une copie de ce jeu de menus et référence les mêmes menus personnalisés en tant que jeu de menus d’origine. Cette action ne duplique pas les menus personnalisés. Si vous modifiez un élément de menu, vous intervenez sur ce menu pour tous les jeux de menus dans lesquels ce menu intervient.
Pour créer et modifier des jeux de menus :
1. Choisissez le menu Fichier > Définir > Menus personnalisés > onglet Jeux de menu.
Chapitre 3
|
Personnalisation des menus 33
3. Dans la boîte de dialogue Modifier le jeu de menus, procédez comme suit :
Pour
Préciser le nom du jeu de menu
Procédure
Dans Nom du jeu de menus, saisissez un nom décrivant le jeu de menus (jusqu’à 100 caractères). Ce nom apparaît dans la liste de l’onglet Jeux de menus de la boîte de dialogue Définir menus personnalisés.
Insérer un commentaire dans la boîte de dialogue Définir menus personnalisés (onglet
Jeux de menu)
Entrez un commentaire relatif au jeu de menus
(jusqu’à 30 000 caractères).
Onglet Jeux de menus de la boîte de dialogue Définir menus personnalisés.
2. Effectuez l’une des opérations décrites ci-après dans la boîte de dialogue Définir menus personnalisés :
Pour Procédure
Créer un jeu de menus Cliquez sur Créer.
Modifier un jeu de menus existant
Sélectionnez le jeu de menus dans la liste, puis cliquez sur Modifier.
Cliquez pour supprimer tous les menus du jeu de menus.
Les menus s’affichent dans la barre de menus, dans l’ordre indiqué dans la liste. Faites glisser une flèche vers le haut ou vers le bas pour modifier l’ordre.
Boîte de dialogue Modifier le jeu de menus
34 Guide de développement FileMaker Pro Advanced
4. Indiquez les menus à insérer dans le jeu de menus, puis cliquez sur OK.
Pour
Ajouter un menu au jeu de menus
Procédure
1
Sélectionnez le menu dans la liste Menus personnalisés disponibles, puis cliquez sur Ajouter.
1
Double-cliquez sur le menu dans la liste Menus personnalisés disponibles.
Supprimer un menu du jeu de menus
Sélectionnez le menu à supprimer du jeu de menus, puis cliquez sur Effacer.
Créer un menu
Dupliquer un menu
Cliquez sur Créer, puis suivez la procédure décrite
dans la rubrique « Création et modification des menus personnalisés », page 27.
Remarque
Vous pouvez cliquer en même temps sur la touche Maj et sur Créer pour créer un menu vide.
Sélectionnez le menu dans la liste, puis cliquez sur Dupliquer.
Modifier un menu Sélectionnez le menu, puis cliquez sur Modifier.
Modifiez le menu dans la boîte de dialogue Modifier le menu personnalisé, puis cliquez sur OK. Reportez-
vous à la rubrique « Création et modification des menus personnalisés », page 27.
Pour dupliquer ou supprimer un jeu de menus :
1. Choisissez le menu Fichier > Définir > Menus personnalisés > onglet Jeux de menu.
2. Effectuez l’une des opérations décrites ci-après dans la boîte de dialogue Définir menus personnalisés, puis cliquez sur OK.
Pour
Dupliquer un jeu de menus
Supprimer un jeu de menus
Procédure
Sélectionnez le jeu de menus dans la liste, puis cliquez sur Dupliquer.
Sélectionnez le jeu de menus dans la liste, puis cliquez sur Supprimer.
Installation des jeux de menus
Une fois que vous aurez créé les jeux de menus, vous devrez indiquer les options nécessaires à leur installation. Vous pouvez effectuer les actions suivantes :
1
Indiquer un jeu de menus par défaut pour un fichier.
1
Indiquer des jeux de menus pour des modèles individuels.
1
Créer les scripts qui modifient les jeux de menus.
1
Indiquer les menus au sein du jeu de menus pour obtenir un affichage selon le mode désigné. Pour plus d’informations, consultez la rubrique
« Création et modification des menus personnalisés », page 27.
1
Basculer d’un jeu de menus à un autre en utilisant le menu
Outils de FileMaker Pro Advanced.
Chapitre 3
|
Personnalisation des menus 35
Spécification d’un jeu de menus par défaut
Vous pouvez spécifier un jeu de menus par défaut pour tous les modèles d’un fichier.
1. Dans le menu Fichier, sélectionnez Définir > Menus personnalisés.
2. Dans Menus par défaut du fichier, sélectionnez un jeu de menus.
Indiquez le jeu de menus par défaut du fichier
Boîte de dialogue Définir menus personnalisés
Spécification des jeux de menus pour les modèles individuels
Vous pouvez indiquer des jeux de menus différents pour des modèles individuels.
1. En mode Modèle, choisissez le menu Modèles > Format de modèle > onglet Général.
2. Dans Jeu de menus, sélectionnez un jeu de menus, puis cliquez sur OK.
Choisissez un jeu de menus pour le modèle
Boîte de dialogue Format de modèle
Notez les points suivants :
1
Si vous sélectionnez un jeu de menus autre que [Fichier par défaut], ce jeu de menus écrase la sélection effectuée dans la boîte de dialogue
Définir menus personnalisé à l’affichage du modèle.
1
En mode Modèle, choisissez le menu Modèles > Ordre des modèles pour afficher la boîte de dialogue Ordre des modèles et revoir le jeu de modèle affecté à chacun des modèles.
Création de scripts pour modifier les jeux de menus
Vous pouvez créer des scripts qui modifient les jeux de menus en fonction des conditions définies. Pour plus d’informations sur les scripts ou sur l’action de script Installer jeu de menu, consultez l’Aide.
Vous pouvez utiliser Obtenir (NomJeuMenuPersonnalisé) pour vérifier le nom du jeu de menus personnalisés actif. Vous pouvez
également utiliser la fonction Obtenir (DerrièreErreur) pour vérifier les jeux de menus manquants. Vérifiez le statut de la fonction Obtenir
(DernièreErreur) après avoir exécuté l’action de script Installer jeu de menus. Si un jeu de menus est absent, la fonction renverra un code erreur 115. Pour plus d’informations, consultez l’Aide.
36 Guide de développement FileMaker Pro Advanced
Test des jeux de menus
Avant de diffuser une base de données contenant des menus personnalisés, testez l’ensemble des menus et de leurs éléments sur les deux plates-formes disponibles, pour chacun des comptes utilisateur.
Veillez à ce que tous les menus et éléments de menus nécessaires soient disponibles de sorte que les utilisateurs ne soient pas gênés dans leurs tâches. Veillez également à ce que les utilisateurs aient toujours accès au menu Affichage ou proposez-leur une méthode (par exemple, des boutons) pour naviguer entre les modes Utilisation, Recherche et
Prévisualisation.
Vous pouvez également revoir le rapport de création de bases de données pour vérifier les raccourcis ou accéder aux conflits générés par les touches d’accès.
Dans FileMaker Pro Advanced, vous pouvez temporairement basculer d’un jeu de menus à un autre ou restaurer les menus FileMaker standard
à l’aide du menu Outils, qui est toujours ajouté à la barre de menus :
1. Choisissez le menu Outils > Menus personnalisés.
2. Sélectionnez le jeu de menus souhaité.
A l’aide de FileMaker Pro ou de FileMaker Pro Advanced, vérifiez si les menus personnalisés sont installés :
1
Windows : Choisissez le menu Aide > A propos de FileMaker Pro, puis cliquez sur Infos.
1
Mac OS : Choisissez le menu FileMaker Pro > A propos de
FileMaker Pro, puis cliquez sur Infos.
Une fois les menus personnalisés installés, la boîte de dialogue affiche
Menus personnalisés actifs.
Utilisation des menus A propos de, Aide ou Script des versions précédentes
Les versions précédentes de FileMaker Developer permettaient aux utilisateurs de personnaliser les menus Aide, A propos de et Script pour les solutions d’exécution. Ces menus étaient les seuls à pouvoir
être modifiés.
Si vous utilisez FileMaker Pro Advanced pour ouvrir un fichier d’exécution créé dans FileMaker Developer, tous les menus A propos de, Aide et Script personnalisés s’afficheront dans le cadre du jeu
Menus FileMaker standard. Vous ne pouvez pas les modifier. Jeu de menus personnalisés #1 fournit une copie des menus standard
FileMaker Pro Advanced.
Chapitre 4
Création de thèmes de modèle personnalisés
FileMaker Pro et FileMaker Pro Advanced utilisent une grande variété de thèmes de modèles pour décrire les couleurs, les motifs, les polices et les cadres (textes, rubriques, éléments) d’un nouveau modèle.
Un thème est un document XML (Langage de balisage extensible) qui peut être lu et modifié dans un éditeur de texte (tel que le Bloc-notes de Windows ou BBEdit pour Mac OS X) ou dans un éditeur XML
(comme XML SPY ou XMetaL). Vous pouvez personnaliser un thème existant ou en créer un nouveau, puis utiliser l’Assistant
Nouveau modèle/rapport pour l’appliquer aux modèles de votre solution. Après la création du modèle, les attributs définis par le thème peuvent être modifiés en Mode modèle. Néanmoins, il n’est pas possible d’appliquer un thème à un modèle existant.
Remarque
Les thèmes de FileMaker ne sont pas des feuilles de style ; ils ne contiennent pas d’informations relatives à la position des éléments dans le modèle.
Pour plus d’informations sur :
1
l’utilisation de thèmes de modèles et leur conception, consultez l’Aide ;
1
le langage XML et son utilisation, consultez www.filemaker.
com/xml ;
1
la publication de bases de données sur le Web au format XML, consultez le manuel PDF intitulé Guide de la publication Web
instantanée FileMaker.
Couleur et motif de fond de l’en-tête
Titre de rubrique
Texte de l’en-tête
Couleur et motif de fond du corps
Rubrique texte
Fond, cadre et effet d’ombrage de rubrique
Couleur et motif de fond du pied de page
Texte du pied de page
Les thèmes permettent d’appliquer automatiquement différents styles au texte et aux motifs de fond des éléments, des rubriques ou des titres.
38 Guide de développement FileMaker Pro Advanced
Modification des thèmes de
FileMaker Pro Advanced
FileMaker Pro et FileMaker Pro Advanced comprennent des fichiers de thème que vous pouvez modifier. Un même fichier peut contenir plusieurs thèmes. Le fichier Blue_gold.fth, par exemple, contient deux thèmes : Bleu et or - Ecran (pour l’affichage écran) et Bleu et or - Impression (pour l’impression).
Important
Le code XML qui compose le thème du modèle doit être conçu avec soin et respecter la syntaxe imposée. Consultez les
rubriques « Conditions requises pour les fichiers de thème », page 39
et « Vérification des fichiers de thème », page 47.
Pour modifier un thème :
1. Faites une copie de l’un des fichiers de thème situés dans le dossier
Themes.
Windows : FileMaker Pro 8 Advanced\Extensions\French\Themes\ ou
Mac OS X : FileMaker Pro 8 Advanced/ FileMaker Pro 8
Advanced.app/Contents/Resources/French.lproj/Themes/
Important
Le nombre total de fichiers de thème est limité à 50.
2. Renommez la copie et ajoutez-lui l’extension .fth.
Le nouveau fichier doit demeurer dans le dossier Themes. Pour que l’Assistant Nouveau modèle/rapport puisse proposer une option de modèle, le fichier de thème doit être stocké dans le dossier Themes et porter l’extension .fth.
3. Ouvrez le fichier de thème dans un éditeur de texte.
Elément à une ligne
Elément multilignes
Attributs
4. Pour modifier le nom du thème, remplacez la valeur de l’élément
THEMENAME.
<THEMENAME VALUE="Mauve et blanc - Ecran" />
Remarque
Si cette valeur contient des caractères ASCII supérieurs, utilisez l’attribut HINT pour vous assurer que le nom du thème apparaîtra sur les plates-formes Windows et Mac OS X. Pour plus
d’informations, reportez-vous à la rubrique « Valeurs correctes des attributs », page 44.
5. Modifiez la valeur des autres éléments et attributs.
Par exemple, pour modifier la couleur de fond du corps du modèle en mauve clair, vous devez changer la valeur hexadécimale en #9933CC :
<BODYPART>
<FILL COLOR = "#9933CC" PATTERN = "2" />
motif », page 46 pour obtenir les directives.
6. Supprimez tous les éléments que vous ne souhaitez pas configurer.
Assurez-vous de supprimer l’intégralité de l’élément à une ligne ou multilignes, y compris les balises de début et de fin. Pour plus
7. Faites défiler le texte jusqu’à l’élément FMTHEME suivant et répétez les étapes précédentes afin de modifier la valeur de
THEMENAME et des autres éléments.
8. Enregistrez le fichier au format texte avec l’extension .fth dans le dossier Themes du dossier FileMaker Pro 8 Advanced.
Les nouvelles valeurs de THEMENAME deviennent des options de Thème de modèle dans l’Assistant Nouveau modèle/rapport.
9. Pour utiliser votre thème dans FileMaker Pro Advanced, choisissez Modèles > Nouveau modèle/rapport.
Suivez les instructions de l’Assistant Nouveau modèle/rapport.
Le troisième écran de cet Assistant présente la liste des thèmes disponibles.
Chapitre 4
|
Création de thèmes de modèle personnalisés 39
Si le nom de votre thème n’apparaît pas dans l’Assistant, vous avez probablement commis une erreur de syntaxe. Pour plus d’informations,
reportez-vous à la rubrique « Vérification des fichiers de thème », page 47.
Conditions requises pour les fichiers de thème
Les thèmes de modèle FileMaker Pro Advanced sont décrits dans un document XML enregistré au format texte. Chaque fichier texte doit porter l’extension .fth et résider dans le dossier Themes du dossier de l’application FileMaker Pro Advanced.
Le langage XML ressemble beaucoup au langage HTML. Toutefois, contrairement à ce dernier, les thèmes de modèle en langage XML doivent être conçus avec soin et respecter la syntaxe imposée. En cas d’omission d’un élément, d’un attribut ou d’une balise de début ou de fin, le document sera inutilisable et FileMaker Pro Advanced ne pourra pas l’analyser, ni afficher le thème dans l’Assistant Nouveau modèle/rapport.
Eléments XML indispensables pour un thème
Chaque fichier de thème doit commencer par une instruction de traitement l’identifiant en tant que document XML utilisant des spécifications XML 1.0. En outre, un document de thème de modèle
XML doit contenir les balises de début et de fin <FMTHEMES> et
</FMTHEMES>. L’élément racine FMTHEMES peut contenir un ou plusieurs éléments FMTHEME.
Les noms des thèmes personnalisés s’affichent sous forme d’options de l’Assistant Nouveau modèle/rapport.
40 Guide de développement FileMaker Pro Advanced
Eléments indispensables d’un fichier de thème
Pour contrôler la façon dont les thèmes apparaissent dans l’Assistant
Nouveau modèle/rapport, placez-les tous dans le même fichier
(éléments FMTHEME). L’ordre des éléments FMTHEME dans le fichier détermine l’ordre d’apparition des valeurs THEMENAME.
Remarque
La valeur de l’élément THEMENAME peut comporter n’importe quel caractère ASCII. Néanmoins, si vous utilisez un
éditeur XML pour concevoir vos thèmes ou si vous prévoyez d’utiliser ces derniers sur différentes plates-formes, certaines précautions sont nécessaires.
Les éditeurs XML ont besoin que les caractères suivants soient codifiés en tant qu’entités :
Caractère
Et commercial (&)
Inférieur à (<)
Supérieur à (>)
Apostrophe (')
Guillemet (")
Codifié comme
&
<
>
'
"
L’utilisation du caractère au lieu de son entité génère une erreur dans l’éditeur XML. Toutefois, FileMaker Pro et FileMaker Pro Advanced ne réinterprètent pas les entités de caractères. La valeur saisie pour l’élément THEMENAME s’affiche telle quelle. Pour éviter ce problème, vous pouvez utiliser un éditeur de texte pour créer vos thèmes ou ignorer les erreurs signalées par l’éditeur XML. Les noms des thèmes apparaissent dans l’Assistant Nouveau modèle/rapport au fur et à mesure de leur écriture.
Si vous devez utiliser vos thèmes sous Windows et Mac OS X, utilisez l’attribut HINT pour vous assurer que les caractères ASCII supérieurs
(accentués) s’affichent correctement sur les deux plates-formes.
Pour plus d’informations, consultez la rubrique « Valeurs correctes des attributs », page 44.
Suppression d’éléments dans un fichier de thème
Les fichiers de thème contiennent des éléments à plusieurs lignes portant sur toutes les parties d’un modèle (rubriques, titres, texte, etc.). Chacun de ces éléments contient à son tour des éléments à une et plusieurs lignes. Tous ces éléments peuvent être supprimés, sous réserve qu’ils le soient dans leur intégralité (y compris les balises de début et de fin).
FileMaker Pro Advanced utilise la valeur par défaut de tous les
Un élément à ligne unique, comme l’élément PEN, commence par <PEN, finit par /> sur la même ligne et se présente de la façon suivante :
<PEN COLOR="#000066" PATTERN="2" SIZE="0" />
Un élément multilignes dispose de balises de début et de fin :
<BORDER>
</BORDER>
Chapitre 4
|
Création de thèmes de modèle personnalisés 41
Pour supprimer un élément multilignes, vous devez effacer sa balise de début, celle de fin et tout ce qui se trouve entre les deux. Par exemple, pour supprimer un élément BORDER multilignes dans le fichier Blue_gold.fth, vous devez effacer les trois lignes suivantes :
<BORDER>
<PEN COLOR="#000000" PATTERN="2" SIZE="1" />
</BORDER>
Eléments XML de parties de modèle
Pour décrire les différentes parties d’un modèle, un élément
FMTHEME peut contenir n’importe lequel des éléments multilignes suivants. Chaque partie du modèle peut contenir des informations additionnelles, relatives au motif de fond, au texte, aux titres des rubriques et aux rubriques elles-mêmes.
Dans le document XML, les éléments décrivant les différentes parties du modèle peuvent être disposés dans n’importe quel ordre au sein d’un élément FMTHEME. Néanmoins, si la liste comporte deux
éléments identiques (BODYPART par exemple),
FileMaker Pro Advanced utilisera uniquement les attributs du dernier.
Elément multilignes utilisé
<TITLEHEADERPART>
</TITLEHEADERPART>
<HEADERPART>
</HEADERPART>
<LEADGRANDSUMPART>
</LEADGRANDSUMPART>
Pour décrire cette partie des modèles
En-tête initial. Une seule occurrence, au début du premier écran ou de la première page.
En-tête. Au début de chaque écran ou page, sauf le premier en cas d’en-tête initial.
Récapitulatif d’en-tête. Au début d’un rapport, affiche une rubrique statistique concernant le jeu d’enregistrements trouvés.
Un modèle ne peut comporter qu’un seul
élément récapitulatif d’en-tête.
Elément multilignes utilisé
<LEADSUBSUMPART>
</LEADSUBSUMPART>
<BODYPART>
</BODYPART>
<TRAILSUBSUMPART>
</TRAILSUBSUMPART>
<TRAILGRANDSUMPART>
</TRAILGRANDSUMPART>
<FOOTERPART>
</FOOTERPART>
<TITLEFOOTPART>
</TITLEFOOTPART>
Pour décrire cette partie des modèles
Sous-récapitulatif d’en-tête. Situé avant l’élément corps, affiche une rubrique récapitulant un sous-ensemble d’enregistrements (en fonction d’une rubrique de regroupement). Vous pouvez décrire jusqu’à neuf sous-récapitulatifs d’en-tête. Pour se distinguer des autres, chaque élément LEADSUBSUMPART doit contenir un élément PARTNUMBER.
Corps. Partie centrale de chaque écran ou page. Un modèle ne peut comporter qu’un seul élément corps.
Sous-récapitulatif de pied de page.
Situé après l’élément corps, affiche une rubrique récapitulant un sous-ensemble d’enregistrements (en fonction d’une rubrique de regroupement). Vous pouvez décrire jusqu’à neuf sous-récapitulatifs de pied de page. Pour se distinguer des autres, chaque élément TRAILSUBSUMPART doit contenir un élément PARTNUMBER.
Récapitulatif de pied de page. A la fin d’un rapport, affiche une rubrique statistique concernant le jeu d’enregistrements trouvés.
Un modèle ne peut comporter qu’un seul
élément récapitulatif de pied de page.
Pied de page. A la fin de chaque écran ou page, sauf le premier, en cas de pied de page initial.
Pied de page initial. Une seule occurrence à la fin du premier écran ou de la première page.
Remarque
Un thème peut contenir la description de toutes les parties d’un modèle. Néanmoins, le type de modèle sélectionné dans l’Assistant Nouveau modèle/rapport détermine les
éléments que comportera votre nouveau modèle/rapport.
42 Guide de développement FileMaker Pro Advanced
Pour plus d’informations sur les éléments de modèle, consultez l’Aide.
Eléments XML du texte
Toutes les parties du modèle peuvent comporter des éléments FIELD,
TEXTLABEL et TEXT, utilisés pour décrire les caractéristiques du texte ou des données.
L’élément FIELD est utilisé pour décrire le texte (données) contenu dans les rubriques et les cadres. L’élément TEXTLABEL est utilisé pour les titres des rubriques. Les titres sont affichés dans le corps du modèle ou dans l’en-tête des rapports à colonnes. L’élément TEXT s’applique à tous les textes du modèle, par exemple au texte du titre de l’en-tête.
Eléments XML et leurs attributs
Les tableaux suivants présentent les éléments XML mono ou multilignes pris en charge par les thèmes de modèle FileMaker Pro Advanced. Les
éléments inconnus sont ignorés par FileMaker Pro Advanced.
Eléments multilignes
Eléments multilignes
FMTHEMES
(requis)
FMTHEME
(requis)
Eléments pouvant être insérés
FMTHEME
L’élément racine FMTHEMES peut contenir plusieurs éléments FMTHEME.
VERSION
THEMENAME (requis)
THEMEDEFAULT
Tout ou partie des éléments les éléments des parties du modèle
Eléments multilignes
TITLEHEADERPART
HEADERPART
LEADGRANDSUMPART
BODYPART
TRAILGRANDSUMPART
FOOTERPART
TITLEFOOTPART
LEADSUBSUMPART
TRAILSUBSUMPART
Eléments pouvant être insérés
FILL
FIELD
TEXT
TEXTLABEL
FIELD
(données d’une rubrique)
TEXT
(texte d’une partie, sauf titre ou données d’une rubrique)
TEXTLABEL
(texte d’un titre de rubrique)
BASELINE
(soulignement des données d’une rubrique)
BORDER
(cadre de rubrique)
FILL
FIELD
PARTNUMBER
TEXT
TEXTLABEL
BASELINE
BORDER
CHARSTYLE
EFFECT
FILL
CHARSTYLE
EFFECT
FILL
PEN
CHARSTYLE
EFFECT
FILL
PEN
ONOFF
PEN
PEN
SIDES
Chapitre 4
|
Création de thèmes de modèle personnalisés 43
Les éléments BORDER et EFFECT partagent la même épaisseur.
Lorsqu’ils sont utilisés ensemble, la valeur de l’épaisseur définie pour BORDER s’applique également à EFFECT. La valeur minimale d’épaisseur doit être supérieure à zéro pour que l’effet ou le cadre apparaisse.
Eléments à ligne unique
Le tableau suivant indique la syntaxe à employer pour tous les
éléments à ligne unique et leurs attributs. Les valeurs d’attributs données en exemple sont indiquées en caractères gras. Pour obtenir la liste de toutes les valeurs possibles de ces attributs, reportez-vous
à la rubrique « Valeurs correctes des attributs ».
Eléments à ligne unique
CHARSTYLE
EFFECT
FILL
ONOFF
PARTNUMBER
Attributs à inclure
COLOR
FONT
SIZE
STYLE
Par exemple :
<CHARSTYLE FONT="Verdana, Helvetica,
Arial" SIZE="18" STYLE="BOLD, ITALIC"
COLOR="#FFFFFF" />
<EFFECT VALUE="EMBOSS" />
COLOR
PATTERN
Par exemple :
<FILL COLOR= "#000066" PATTERN= "2" />
<ONOFF VALUE="OFF" />
<PARTNUMBER VALUE="0" />
Eléments à ligne unique
PEN
SIDES
THEMENAME
THEMEDEFAULT
VERSION
Attributs à inclure
COLOR
PATTERN
SIZE
Par exemple :
<PEN COLOR="#000066" PATTERN="2"
SIZE="0" />
<SIDES VALUE="BOTTOM" />
HINT (optionnel)
VALUE
Par exemple :
<THEMENAME VALUE="Fern Green Print" />
<THEMENAME HINT="MAC" VALUE="Grün
Druck" />
VALUE
Par exemple :
<THEMEDEFAULT VALUE="CURRENT"/>
Pour plus d’informations, consultez la rubrique
« Définition des valeurs par défaut des thèmes », page 46.
VALUE
Par exemple :
<VERSION VALUE="ver. 1.0"/>
L’élément VERSION n’est pas utilisé dans la version actuelle de FileMaker Pro Advanced, mais pourra l’être ultérieurement.
44 Guide de développement FileMaker Pro Advanced
Valeurs correctes des attributs
Le tableau suivant décrit les valeurs d’attribut reconnues par les thèmes de modèle FileMaker Pro Advanced. Les valeurs doivent être placées entre guillemets (" "). Si l’un des guillemets est manquant,
FileMaker Pro Advanced est dans l’impossibilité d’analyser la syntaxe XML et ne peut pas afficher le thème dans l’assistant
Nouveau modèle/rapport.
Attribut
COLOR
Description des caractéristiques Valeurs acceptées
Valeurs hexadécimales des couleurs RVB du fond, des textes et des cadres des
éléments de modèle, des rubriques, des blocs de texte et des titres de rubrique.
Pour afficher une couleur, l’attribut PATTERN ne doit pas avoir pour valeur 1
(transparent).
Les thèmes
FileMaker Pro Advanced utilisent une palette de couleurs
Web de sorte que les couleurs soient retranscrites de la même façon sur tous les systèmes.
Reportez-vous à la rubrique
« Utilisation des valeurs de couleur et de motif », page 46.
COLOR = "#FFFFFF"
COLOR = "#33FF00"
COLOR = "#CC9966"
Ou toute valeur hexadécimale sur
6 caractères (combinaison de chiffres entre 0 et 9 et de lettres entre A et F, pour coder les nombres en base
16) précédée du caractère #.
Attribut
EFFECT
FONT
HINT
Description des caractéristiques Valeurs acceptées
Effets 3D de relief, d’empreinte ou d’ombre portée, appliqués à une rubrique, du texte ou un titre de rubrique.
En cas d’utilisation conjointe avec un cadre de rubrique, l’épaisseur de l’effet sera la même que celle définie pour le trait. La valeur minimale d’épaisseur doit être supérieure
à zéro pour que l’effet ou le cadre apparaisse.
VALUE = "EMBOSS"
VALUE = "ENGRAVE"
VALUE =
"DROPSHADOW"
VALUE = "NONE"
Nom de la police. Il est possible d’indiquer plusieurs noms de polices en les séparant par des virgules. La première police disponible sur le système de l’utilisateur est adoptée par le modèle.
Remarque
Les valeurs de police tiennent compte de la casse et doivent être saisies en mode phrase avec une seule majuscule au début.
FONT = "Times New
Roman"
FONT = "Geneva"
FONT = "New York,
Times, Helvetica, Arial"
Ou toute autre police disponible (dans
FileMaker Pro Advanced, choisissez le menu Format >
Police pour voir l’ensemble des polices disponibles.)
Nom de la plate-forme sur laquelle le thème est modifié et le caractère défini. Cet attribut permet de s’assurer que tous les caractères supérieurs ASCII de la valeur THEMENAME
(par exemple, un caractère accentué dans le nom du thème) apparaissent dans
FileMaker Pro Advanced sous Windows et Mac OS X.
Les caractères japonais sont pris en charge si la valeur
SHIFTJIS est définie.
HINT = "WIN"
HINT = "MAC"
HINT = "WIN/ROMAN"
HINT = "MAC/ROMAN"
HINT = "WIN/ROMAN"
HINT = "MAC/SHIFTJIS"
Attribut
ONOFF
Description des caractéristiques
Activation et désactivation de l’affichage du cadre d’une rubrique.
Valeurs acceptées
VALUE ="ON"
VALUE ="OFF"
PARTNUMBER Permet de faire la différence entre plusieurs sousrécapitulatifs d’en-tête ou de pied de page d’un modèle.
Cet attribut est ignoré pour toutes les autres parties.
FileMaker Pro Advanced accepte des valeurs comprises entre 0 et 9 et ignore toutes les autres.
VALUE ="0"
VALUE ="1"
VALUE ="2"
VALUE ="3"
VALUE ="4"
VALUE ="5"
VALUE ="6"
VALUE ="7"
VALUE ="8"
VALUE ="9"
PATTERN Un des 64 motifs valables de la palette de motifs de
FileMaker Pro Advanced.
Utilisé pour remplir le fond des modèles, des rubriques, du texte et des titres, de même que de leurs cadres.
Reportez-vous à la rubrique
« Utilisation des valeurs de couleur et de motif », page 46.
PATTERN = "1"
PATTERN = "47"
PATTERN = "64"
PATTERN = "NONE"
PATTERN = "SOLID"
PATTERN = "LTGRAY"
PATTERN = "GRAY"
PATTERN = "DKGRAY"
SIDES Affichage un à quatre côtés du cadre d’une rubrique.
Pour définir les quatre côtés, les quatre valeurs peuvent être combinées.
VALUE="TOP"
VALUE="BOTTOM"
VALUE="LEFT"
VALUE="RIGHT"
Ou toute combinaison telle que :
VALUE= "TOP BOTTOM
LEFT RIGHT"
VALUE= "LEFT TOP"
Chapitre 4
|
Création de thèmes de modèle personnalisés 45
Attribut
SIZE
(pour l’élément
FONT)
SIZE
(pour l’élément
PEN)
Description des caractéristiques Valeurs acceptées
Taille de la police en points.
Toute valeur correcte peut
être indiquée.
Si une taille de police n’est pas disponible dans le système,
FileMaker Pro Advanced lui substituera la taille la plus proche.
SIZE = "36"
SIZE = "12"
SIZE = "9"
Epaisseur de surlignage en pixels des blocs de texte, des titres et des cadres de rubrique.
SIZE = "0"
SIZE = "-1"
SIZE = "1" jusqu’à
La valeur de NONE est 0 et la valeur de HAIRLINE -1.
Quand l’épaisseur du trait est appliquée aux cadres de la rubrique, elle s’applique
également aux attributs
EFFECT (comme
DROPSHADOW) et doit avoir une valeur supérieure à zéro.
SIZE = "8"
SIZE = "12"
46 Guide de développement FileMaker Pro Advanced
Attribut
STYLE
Description des caractéristiques Valeurs acceptées
Styles des caractères des rubriques, des blocs de texte et des titres de rubrique. Il est possible de définir plusieurs styles, séparés par des virgules ou des espaces.
Il n’existe aucune vérification des erreurs éventuelles
(styles incompatibles comme UPPERCASE et LOWERCASE).
La valeur de style PLAIN prend le pas sur toutes les autres valeurs.
Les valeurs STRIKEOUT et STRIKETHRU sont identiques.
STYLE = "PLAIN"
STYLE = "BOLD"
STYLE = "ITALIC"
STYLE = "STRIKEOUT"
STYLE = "STRIKETHRU"
STYLE = "SMALLCAPS"
STYLE = "UNDERLINE"
STYLE =
"WORDUNDERLINE"
STYLE =
"DBLUNDERLINE"
STYLE = "UPPERCASE"
STYLE = "LOWERCASE"
STYLE = "TITLECASE"
STYLE =
"SUPERSCRIPT"
STYLE = "SUBSCRIPT"
STYLE = "CONDENSE"
STYLE = "EXTEND"
STYLE = "ITALIC,
BOLD, SMALLCAPS"
Définition des valeurs par défaut des thèmes
FileMaker Pro et FileMaker Pro Advanced remplacent les attributs manquants ou incorrects par des valeurs par défaut. Pour chaque thème, vous pouvez indiquer si les valeurs par défaut sont déterminées par les paramètres actuels du modèle (qui varient selon les modifications apportées par l’utilisateur) ou par des valeurs standard (utilisées par
FileMaker pour créer un fichier pour la première fois).
<THEMEDEFAULT VALUE="CURRENT"/>
<THEMEDEFAULT VALUE="STANDARD"/>
Si vous n’indiquez pas de valeur pour l’élément THEMEDEFAULT,
FileMaker Pro Advanced utilise les valeurs standard par défaut.
Utilisation des valeurs de couleur et de motif
Les motifs des palettes de FileMaker Pro et FileMaker Pro Advanced sont numérotés de façon consécutive, de haut en bas et de gauche
à droite, en partant du motif situé en haut à gauche et portant le numéro 1. Cinq motifs de la première ligne peuvent également être définis par des mots : NONE (= 1), SOLID (= 2), DKGRAY (= 6),
GRAY (= 7) et LTGRAY (= 8).
Remarque
Le premier motif (valeur = 1) est transparent et le second
(valeur = 2) est plein. Pour les objets comportant une couleur de fond, pensez à utiliser un motif plein.
1 2 3 4 5 6 7 8
57 58 59 60 61 62 63 64
La numérotation des attributs commence par 1 en haut à gauche et se termine par 64 en bas à droite.
Pour les couleurs, les thèmes utilisent des valeurs hexadécimales à
6 chiffres (comme #CC9966), qui peuvent être obtenues avec la plupart des programmes graphiques disposant d’une palette de couleurs.
Il est préférable d’utiliser des couleurs Web pour les bases de données qui seront utilisées sur plusieurs types de systèmes, avec des résolutions différentes ou en réseau. Néanmoins, si votre solution doit être affichée en haute résolution ou sur un seul type de plate-forme vous pouvez profiter de la richesse du spectre de couleurs RVB.
La palette de couleurs de FileMaker Pro et FileMaker Pro Advanced ne contient que des couleurs Web. Pour plus d’informations sur l’utilisation des palettes de couleurs, consultez l’Aide. Pour plus d’informations sur l’utilisation des motifs et des couleurs d’une palette, consultez l’Aide.
Chapitre 4
|
Création de thèmes de modèle personnalisés 47
Ajout de commentaires aux fichiers de thème
Vous pouvez ajouter des commentaires aux fichiers de thème XML en les positionnant entre des balises de commentaires :
<!- - mon commentaire - ->
FileMaker Pro et FileMaker Pro Advanced ignoreront tous les
éléments XML inconnus (mais syntaxiquement corrects) que vous pourriez ajouter. Cela permet à vos fichiers de thème de conserver une compatibilité ascendante et descendante avec les autres versions de
FileMaker Pro et FileMaker Pro Advanced.
Vérification des fichiers de thème
FileMaker Pro et FileMaker Pro Advanced ne peuvent pas analyser ni valider les documents XML mal formulés. Si un élément requis manque ou est incorrect, FileMaker Pro Advanced ignorera l’ensemble du document.
Voici la liste des éléments à vérifier attentivement si votre nouveau thème de modèle n’apparaît pas dans l’assistant Nouveau modèle/ rapport :
1
Le nom du fichier doit porter l’extension .fth.
1
Le fichier doit être au format texte.
1
Le fichier doit résider dans le sous-dossier Themes du dossier de l’application FileMaker Pro Advanced.
48 Guide de développement FileMaker Pro Advanced
1
Il doit comporter tous les éléments requis, y compris les balises de début et de fin :
<?xml version="1.0" standalone="yes" ?>
<FMTHEMES>
<FMTHEME >
<THEMENAME VALUE="Ecran blanc et mauve" />
</FMTHEME>
</FMTHEMES>
1
Tous les éléments doivent être complets. Il ne doit manquer aucun attribut, valeur, guillemet, balise de début ou de fin.
1
Les valeurs doivent être placées entre guillemets (“ ”). Il ne doit manquer aucun guillemet d’ouverture ni de fermeture, ni aucune valeur (pas de guillemet vierge “ ”).
1
Tous les éléments et attributs doivent être orthographiés correctement.
1
Toutes les valeurs doivent être correctes et orthographiées correctement.
1
Chaque élément à ligne unique doit se terminer par />.
1
Tous les éléments multilignes doivent être orthographiés correctement et disposer de balises cohérentes de début et de fin (par exemple, <BODYPART> et </BODYPART)>.
Chapitre 5
Développement de modules FileMaker tiers
Si vous programmez en C ou C++ et que vous connaissez bien les fonctions de calcul avancées de FileMaker Pro et
FileMaker Pro Advanced, vous pouvez créer des modules de fonctions externes qui viendront compléter le jeu de fonctionnalités des applications. Les modules bénéficient de formules de calcul qui exploitent des boucles, des récursions ou qui font appel à d’autres interfaces de programmation. Les utilisateurs pourront activer vos modules externes dans FileMaker Pro, FileMaker Pro Advanced et
FileMaker Server Advanced, et utiliser vos fonctions externes dans des scripts ou des rubriques Calcul.
Les modules doivent être enregistrés auprès de FileMaker. Vous trouverez un formulaire d’enregistrement de module et une base de données de tous les modules enregistrés sur le site Web de FileMaker
(www.filemaker.com). Vous pouvez parcourir cette base de données pour vous faire une idée des modules existants et y répertorier vos propres modules externes. Pour plus d’informations, consultez la
rubrique « Enregistrement de votre module », page 60.
Vous pouvez utiliser FileMaker Server et FileMaker Server Advanced pour veiller à ce que les clients FileMaker Pro disposent toujours du module externe le plus récent sur leurs ordinateurs. Reportez-vous au
Guide la mise à jour des modules FileMaker Server disponible sur le site www.filemaker.fr/downloads.
A propos des fonctions externes
Le CD FileMaker Pro Advanced contient un exemple de projet de module que vous pouvez modifier pour y inclure vos propres fonctions externes. Les utilisateurs peuvent accéder à vos modules à partir de la boîte de dialogue Calcul.
Suivez les étapes ci-dessous pour préparer vos modules personnalisés :
1. Modifiez les fichiers du module exemple pour y ajouter votre code de programmation personnalisé.
2. Compilez le module personnalisé et testez-le.
3. Enregistrez votre module auprès de FileMaker.
4. Installez le fichier du module compilé pour vos utilisateurs.
Pour accéder aux fonctions externes, vos utilisateurs doivent :
1. activer votre module dans la boîte de dialogue Préférences ;
2. configurer votre module, si nécessaire ;
3. définir ou modifier une rubrique de calcul ;
4. choisir la formule de calcul Nom_Fonction(paramètre 1 ...) dans la boîte de dialogue Calcul.
Pour voir toutes les fonctions externes, sélectionnez Externes dans la liste déroulante Affichage.
A propos du module exemple
Cet exemple de projet a pour but d’illustrer un module complet standard. Vous pouvez compiler les fichiers du projet exemple pour créer un module présentant plusieurs fonctions externes auxquelles les utilisateurs pourront accéder via la boîte de dialogue Calcul. Pour examiner et modifier le code source des fichiers exemple, utilisez un
éditeur de texte.
L’exemple de module contient sept fonctions externes. Reportez-
vous à la rubrique « Description des fonctions externes du module
50 Guide de développement FileMaker Pro Advanced
Les fichiers du module exemple contiennent l’intégralité du code source nécessaire à la compilation du module sur les plates-formes
Windows et Mac OS X. Outre le code source du module externe,
FileMaker Pro Advanced propose des fichiers projet pour
Metrowerks CodeWarrior Development Studio, Microsoft Visual
Studio .NET 2003 (également appelé Microsoft Visual C++) et
Apple Xcode.
Vous trouverez des fichiers exemple de modules dans le dossier Extras en français\Examples\FMExample du CD de FileMaker Pro Advanced.
Les fichiers de code source du module exemple sont situés dans des sous-dossiers du dossier du module FMExample. Les tableaux suivants décrivent certains de ces fichiers et dossiers.
Contenu du dossier FMExample
Dossier
Dossier Exemples
Dossier En-têtes
Dossier Bibliothèques
Description
Contient tous les fichiers de FMExample.
Contient les fichiers de définition des fonctions de l’API FileMaker. A ne pas distribuer aux utilisateurs qui ne possèdent pas de licence
FileMaker Pro Advanced.
Contient les bibliothèques pour l’API FileMaker. A ne pas distribuer aux utilisateurs qui ne possèdent pas de licence FileMaker Pro Advanced.
Contenu du dossier Exemples
Fichier/dossier
FMPluginExample.cpp
MacExample.fmplugin
MacExample.mcp
MacExample.xcode
WinExample.sln
Description
Contient le code d’implémentation de FMExample.
Lot de modules Mac OS X compilés.
Fichier du projet CodeWarrior 8
Fichier du projet Apple Xcode
Fichier de projet Microsoft Visual Studio .NET
Fichier/dossier
WinExample.vcproj
Description
Fichier de projet Microsoft Visual C++ utilisé par
WinExample.sln.
WinExample.fmx
Module Windows 2000, XP compilé.
Dossier Support technique Contient toutes les autres ressources et le code utilisé par FMPluginExample.cpp.
Contenu du dossier Support technique
Fichier/dossier
FMPluginExample.rc
FMPluginExample.nib
Description
Contient les ressources pour la plate-forme
Windows.
Contient les ressources pour la plateforme
Mac OS X.
FMPluginExample.strings
Contient les chaînes pour la plateforme Mac OS X.
FMPluginFunctions.cpp
Contient le code d’implémentation des fonctions externes dans FMExample.
FMPluginFunctions.h
FMPluginGlobalDefines.h
Contient les constantes utilisées par FMExample, y compris les directives permettant de contrôler la compilation du code.
FMPluginPrefs.cpp
Contient les définitions des fonctions externes, y compris les identificateurs de fonction.
FMPluginPrefs.h
Contient le code d’implémentation d’une boîte de dialogue de configuration dans FMExample.
Contient des définitions pour la boîte de dialogue de configuration.
info.plist
MacExample.plc
Resource.h
Contient les informations regroupées des sorties
Apple Xcode
Contient une définition liée à la plate-forme Mac.
Contient des définitions pour le fichier de ressources.
Installation, activation et configuration de l’exemple de module
Pour pouvoir être utilisés, les fichiers de modules de fonctions externes doivent d’abord être installés dans le dossier approprié et activés dans FileMaker Pro, FileMaker Pro Advanced ou
FileMaker Server Advanced. Certains modules doivent
également être configurés par l’utilisateur.
Certains modules externes (et les bibliothèques qu’ils référencent) ne se chargent qu’à l’exécution du processus par un utilisateur qui se connecte au système ; FileMaker Server et FileMaker Server
Advanced s’exécutent alors comme un service et non comme un processus utilisateur. En conséquence, il faut écrire les modules externes de manière différente pour une utilisation avec
FileMaker Server ou FileMaker Server Advanced. Les utilisateurs devront alors consulter la documentation relative à leur système d’exploitation pour rechercher les bibliothèques habituellement accessibles.
Pour plus d’informations sur l’installation des modules de publication
Web instantanée, reportez-vous au
Guide d’installation de la
Publication Web
de FileMaker Server Advanced.
Pour installer un module, faites glisser le fichier du module dans le dossier Extensions du dossier FileMaker Pro 8 Advanced. Sous
Windows, l’extension de module doit être .fmx. Sous Mac OS X, l’extension de module doit être .fmplugin.
Pour activer un module :
1.
Ouvrez la boîte de dialogue Préférences.
Windows : Choisissez Edition > Préférences .
Mac OS X : Choisissez le menu d’application FileMaker Pro Advanced >
Préférences .
2.
Sélectionnez l’onglet
Modules
.
3.
Sélectionnez le module dans la liste.
Chapitre 5
|
Développement de modules FileMaker tiers
51
Pour figurer dans la liste, le module doit être installé dans le dossier approprié du dossier de l’application FileMaker Pro Advanced.
Le texte de description est défini dans une chaîne de ressource.
Sélection d’un module pour l’activer
Pour configurer un module :
1.
Sélectionnez le module dans la boîte de dialogue Préférences.
2.
Cliquez sur Configurer .
Le bouton Configurer n’est disponible que si le sixième caractère de
la chaîne d’options du module sélectionné est Y. Voir « Syntaxe des chaînes d’options », page 56.
3.
Pour configurer le module, suivez les instructions de la boîte de dialogue de configuration.
4.
Cliquez sur OK .
52 Guide de développement FileMaker Pro Advanced
Description des fonctions externes du module
FMExample
Le module FMExample (proposé en Microsoft Visual C++,
Apple Xcode et Code Warrior) ajoute les fonctions externes suivantes à FileMaker Pro, FileMaker Pro Advanced et
FileMaker Server Advanced.
Nom et paramètres de la fonction
XMpl_Add
(nombre1; nombre2)
XMpl_Append
(textToAppend ...)
XMpl_Evaluate
(calcToEvaluate)
XMpl_NumToWords
(nombre)
XMpl_StartScript
(nom_du_fichier; nom_du_script)
Description de la fonction externe
Additionne nombre1 et nombre2 et renvoie le résultat. La fonction correspond à l’opérateur plus dans le moteur de calcul.
Prend plusieurs listes de paramètres, les concatène et renvoie le résultat. La fonction correspond à l’opérateur Et commercial dans le moteur de calcul.
Prend un calcul simple ou complexe, l’évalue et renvoie le résultat. Tous les calculs pris en charge par FileMaker peuvent passer par cette fonction.
La fonction correspond à la fonction Evaluer dans le moteur de calcul.
Renvoie un nombre au format monétaire bancaire.
Par exemple, 44,345 renvoie la valeur Quarante quatre euros et 34 centimes. Les chiffres placés après la deuxième décimale et tous les caractères alphabétiques sont ignorés.
Exécute le script défini par le paramètre nom_du_script du fichier spécifié par le paramètre nom_du_fichier.
Nom et paramètres de la fonction Description de la fonction externe
XMpl_UserFormatNumber
(textOrNumber)
Renvoie le paramètre sous forme de chaîne de texte formatée de la manière indiquée dans la boîte de dialogue de configuration. Utilisez cette fonction pour formater les nombres, tels que les numéros de téléphone, les codes postaux, etc.
Le formatage s’effectue de droite à gauche. Chaque symbole # de la chaîne de formatage est remplacé par le caractère suivant dans la chaîne de paramètres.
Tous les symboles # restants sont remplacés par des zéros.
Cette fonction décrit à la fois la fonctionnalité côté client et la boîte de dialogue de configuration du module.
XMpl_FormatNumber
(formatString; textOrNumber)
Même chose que pour XMpl_UserFormatNumber, mais formatString est fourni sous forme de paramètre. Cette fonction illustre une fonction visible dans la boîte de dialogue Calcul pour la saisie automatique et prend également en charge les appels provenant de FileMaker Server,
FileMaker Server Advanced et de la Publication
Web instantanée.
Utilisation du module exemple
Pour accéder aux fonctions externes :
1. Ouvrez la boîte de dialogue Préférences.
Windows : Choisissez Edition > Préférences.
Mac OS X : Choisissez le menu d’application FileMaker Pro Advanced >
Préférences.
2. Sélectionnez l’onglet Modules.
3. Sélectionnez FMExample.
Le module exemple comprenant une fonction nécessitant une configuration, le bouton Configurer est activé.
Chapitre 5
|
Développement de modules FileMaker tiers 53
4. Cliquez sur Configurer.
La boîte de dialogue de configuration qui apparaît dépend du mode d’écriture du code source du module. La fonction
XMpl_UserFormatNumber du module FMExample affiche la boîte de dialogue de configuration suivante.
Boîte de dialogue de configuration du module exemple
5. Cliquez sur OK pour utiliser le format par défaut, ou entrez un nouveau format.
Les symboles # sont remplacés par des numéros. Tout autre texte dans la chaîne de formatage est conservé.
6. Pour refermer la boîte de dialogue Préférences, cliquez sur OK.
7. Dans FileMaker Pro Advanced, choisissez le menu Définir > Base de données > onglet Rubriques.
8. Créez une rubrique Calcul.
9. Dans la boîte de dialogue Calcul, choisissez Externes dans la liste déroulante Affichage.
10. Double-cliquez sur une fonction externe pour l’ajouter dans la zone de formule.
Tous les appels de fonction externe requièrent le nom de la fonction externe à appeler et la valeur du paramètre de la fonction, même si cette valeur est nulle.
54 Guide de développement FileMaker Pro Advanced
11. Remplacez le terme paramètre par le(s) paramètre(s) requis par la fonction.
12. Poursuivez le développement de la formule, puis cliquez sur OK lorsque vous avez terminé.
13. Cliquez sur OK pour fermer la boîte de dialogue Définir la base de données.
Personnalisation du module exemple
L’exemple de module de FileMaker Pro Advanced est conçu pour être facilement modifié, de sorte que vous puissiez ajouter vos propres fonctions personnalisées. Vous devez modifier les éléments suivants :
1
informations relatives à la version dans FMPluginExample.strings et FMPluginExample.rc ;
1
noms du module et de la fonction dans FMPluginExample.strings et FMPluginExample.rc ;
1
fonction de configuration dans FMPluginPrefs.cpp ;
1
définitions des fonctions externes et codage dans
FMPluginFunctions.cpp.
Personnalisation des ressources exemple
Pour créer un module de fonction externe personnalisé, vous devez modifier les fichiers de ressources des modules de la manière suivante :
1
modifiez les chaînes et les variables de la version en fonction de vos besoins ;
1
modifiez la boîte de dialogue de configuration en fonction de vos besoins ;
1
spécifiez des valeurs de chaîne d’options appropriées ;
1
modifiez les noms et la description des modules ;
1
définissez vos noms et prototypes de fonction.
Personnalisation de FMPluginExample.cpp
Apportez vos modifications de FMPluginExample.cpp dans les fonctions du tableau suivant.
Nom de fonction
Do_PluginInit
Do_PluginIdle
Do_PluginShutdown
Personnalisation
Donnez votre propre ID de module unique pour pluginID. Enregistrez chaque fonction, en précisant son nom, sa description et la fonction à utiliser.
Pour enregistrer vos fonctions, appelez fmx::ExprEnv::RegisterExternalFunction.
Ajoutez n’importe quel traitement inactif nécessaire.
Révisez les appels UnRegisterExternalFunction pour inverser l’enregistrement fait dans Do_PlugInit. Pour annuler l’enregistrement de vos fonctions, appelez fmx::ExprEnv::UnRegisterExternalFunction.
Personnalisation de FMPluginPrefs.cpp
Ce fichier contient la fonction Do_PluginPrefs pour l’implémentation de la boîte de dialogue de configuration. Modifiez ou supprimez ce code selon vos besoins.
Personnalisation de FMPluginFunctions.cpp
Modifiez ou supprimez les fonctions fournies dans le fichier
FMPluginFunctions.cpp et définissez les vôtres. Do_PluginInit se réfère à ces fonctions lors de l’évaluation des fonctions externes dans les calculs.
Chapitre 5
|
Développement de modules FileMaker tiers 55
Consignes pour l’écriture des modules de fonction externe
Les modules FileMaker sont particulièrement utiles lorsqu’ils contiennent une fonction unique ou un ensemble de fonctions similaires. Lors de la conception de votre module, gardez à l’esprit que les développeurs qui l’utiliseront ne connaissent peut-être pas les conventions de programmation évidentes pour vous. L’utilisateur de base doit pouvoir comprendre le format de chaque paramètre des fonction.
Si vous créez un module externe FileMaker avec des fonctions qui ne nécessitent pas de paramètres, assurez-vous que le prototype de fonction enregistré pour cette fonction n’inclut pas de parenthèses. Par exemple, enregistrez « FaireCeci » plutôt que « FaireCeci( ) » comme nom de prototype de fonction.
Fichiers de code API
Le dossier En-têtes contient dix fichiers de code API : FMXExtern.h,
FMXCalcEngine.h, FMXBinaryData.h, FMXDateTime.h,
FMXTextStyle.h FMXTypes.h, FMXFixPt.h, FMXClient.h,
FMXText.h et FMXData.h. Ces fichiers ne peuvent pas être redistribués en code source (ou simplement lisible), ni modifiés, et ne sont fournis que pour permettre aux détenteurs de licences
FileMaker Pro Advanced de compiler des modules utilisables avec des produits FileMaker. Le développement de tous les types de modules ne nécessite pas tous les fichiers.
Le fichier FMXExtern.h est absolument obligatoire. Le fichier
FMXExtern.h définit le bloc paramètre (structure des données partagées entre votre module et FileMaker Pro, FileMaker Pro Advanced,
FileMaker Server Advanced) et des appels à certaines fonctions partagées. Les appels de fonctions sont utilisés pour manipuler des paramètres et les résultats du bloc paramètre.
56 Guide de développement FileMaker Pro Advanced
Le fichier FMXExtern.h définit les fonctions de rappel pour les opérations de compatibilité ascendante et les différents types d’événements (messages FileMaker Pro, FileMaker Pro Advanced,
FileMaker Server ou FileMaker Server Advanced) envoyés au module dans une définition FMExternCallSwitch.
FMExternCallStruct définit la structure du bloc paramètre.
FMExternCallPtr pointe sur cette structure et gFMExternCallPtr est une variable globale qui doit être définie dans votre code.
Le fichier FMXCalcEngine.h contient les fonctions enregistrées et non enregistrées. Il sera utilisé dans la plupart des modules car ces derniers devront probablement enregistrer des fonctions.
La fonctionnalité des fichiers API restants est décrite dans les commentaires inclus dans les fichiers eux-mêmes.
Syntaxe des chaînes d’options
Une chaîne d’option doit comporter 11 caractères.
Les quatre premiers caractères de la chaîne d’options contiennent l’ID du module. Cet identifiant doit être unique pour chaque module et ne doit pas débuter par
F
,
FM
ou
Web
. Sous Mac OS X, il est recommandé de donner la même valeur au paramètre type créateur. L’ID ne peut contenir que des caractères alphanumériques ASCII inférieurs
(tels que
0-9
,
A-Z
et a-z
).
Remarque
Pour augmenter vos chances de disposer d’un identifiant unique, vous devez l’enregistrer sur le site Web de support aux développeurs Apple (même si vous ne devez pas créer de version
Mac OS X de votre module). Pour enregistrer ces identifiants de modules sous forme de codes créateur, consultez les pages de support aux développeurs du site Web d’Apple Computer sur www.apple.com. Pour plus d’informations, reportez-vous
à la rubrique « Enregistrement de votre module », page 60.
Le cinquième caractère de la chaîne d’options est toujours
1
et le huitième, le dixième et le onzième sont toujours n
. Les autres valeurs de ces indicateurs sont réservées à l’usage de FileMaker uniquement.
Par exemple,
Moc31YnnYnn
est une chaîne d’options pour un module dont l’identifiant
Moc3
(caractères 1 à 4) requiert une configuration
(caractère 6 =
Y
), utilise l’enregistrement du nouveau style et des rappels de fonctions (caractère 7 = n
) et requiert un délai d’inactivité particulier (caractère 9 =
Y
).
Tableau des caractères de chaîne d’options
8
9
5
6
Caractères de la chaîne d’options Description des caractères
1-4
Les caractères 1 à 4 contiennent l’ID du module. Enregistrez cet identifiant sous forme de code créateur sur le site Web de support aux développeurs Apple (www.apple.com).
Le cinquième caractère est toujours 1.
Donnez au sixième caractère de la chaîne la valeur Y si vous voulez que le bouton Configurer s’affiche dans la boîte de dialogue Préférences. Utilisez n si ce module externe ne nécessite aucune configuration. Si l’indicateur est paramétré sur Y, assurez-vous de traiter le message kFMXT_DoAppPreferences. Pour plus d’informations,
consultez la rubrique « Messages FileMaker envoyés au module », page 57.
7
Définissez la valeur sur n pour l’enregistrement du nouveau style et les rappels de fonctions décrits dans FMExample.
Définissez la valeur sur Y uniquement si votre module requiert la liste des fonctions héritées et un seul rappel externe.
Le caractère 8 est toujours n.
10
11
Paramétrez le neuvième caractère sur Y si le message kFMXT_Idle est requis. Pour les fonctions externes simples, ce paramètre peut être désactivé (caractère n).
Le caractère 10 est toujours n.
Le caractère 11 est toujours n.
Conventions d’appellation des fonctions externes
Le préfixe des noms de toutes les fonctions externes du module doit
être une valeur unique, contenant quatre ou cinq caractères, et ne doit pas commencer par les caractères
FM
ou
Web
. Les préfixes à quatre caractères sont réservés par FileMaker. Par exemple, le préfixe du nom de la fonction du module FMPluginExample est XMpl.
FileMaker gère les conventions de noms des modules externes, des fichiers et les préfixes des fonctions. C’est pourquoi vous devez enregistrer votre module. FileMaker a réservé certaines conventions d’appellation pour les fonctions externes. Pour plus d’informations,
consultez la rubrique « Enregistrement de votre module », page 60.
Messages FileMaker envoyés au module
FileMaker Pro, FileMaker Pro Advanced, FileMaker Server ou
FileMaker Server Advanced peut adresser six types d’appel à votre module externe. Les messages adressés à votre module externe sont fournis dans la rubrique whichCall
du bloc paramètre
FMExternCallStruct
, défini dans le fichier FMXExtern.h.
1
kFMXT_Init
: message d’initialisation
1
kFMXT_Shutdown
: message de fermeture
1
kFMXT_Idle
: message d’inactivité
1
kFMXT_DoAppPreferences
: message de préférences
1
kFMXT_External
: message Externe reçu par les modules hérités dont le caractère 7 de la chaîne d’option est défini sur Y et qui enregistrent leurs fonctions à l’ancienne (méthode externe)
1
kFMXT_GetString
: message GetString reçu par les modules qui utilisent le nouveau style d’enregistrement lorsque les modules fournissent la chaîne d’options, leur nom et une description
Chapitre 5
|
Développement de modules FileMaker tiers 57
Message d’initialisation
Le message d’initialisation
kFMXT_Init
est adressé au module externe chaque fois que ce dernier est activé dans FileMaker Pro,
FileMaker Pro Advanced, FileMaker Server ou FileMaker Server
Advanced. Si le module est activé dans la boîte de paramétrage
Préférences, cela peut correspondre au démarrage de l’application.
En réponse à ce message, le module externe peut retourner deux valeurs :
1
kBadExtnVersion
, si le numéro de version reçu est inférieur à la valeur de kMinExtnVersion
ou supérieur à celle de kMaxExtnVersion
.
Ceci permet d’interdire le lancement du module externe avec une version de l’API incompatible avec son environnement de compilation.
1
kCurrentExtnVersion
est la seule autre valeur qui puisse être retournée par le module externe. Elle déclenche l’activation du module externe.
Dans le cas du module FMPluginExample, la fonction
Do_PluginInit est appelée à la réception du message d’initialisation. La fonction
Do_PluginInit
vérifie d’abord la version d’API dans laquelle le module externe a été compilé afin de s’assurer qu’elle est compatible avec la version de FileMaker Pro, FileMaker Pro Advanced, FileMaker Server ou FileMaker Server Advanced utilisée. La fonction vérifie ensuite l’existence de préférences et, le cas échéant, les définit. S’il n’en existe pas, elle les crée avec des valeurs par défaut.
Sous Windows, ces préférences sont enregistrées dans les entrées du registre. Sous OS X, elles sont enregistrées dans un fichier du dossier
Préférences du dossier Système. En raison des différences de stockage des informations sur les deux plates-formes, la fonction
Do_PluginInit utilise les instructions d’un pré-processeur pour sélectionner le code adapté lors de la compilation.
Si les préférences sont correctement définies et la version de l’API appropriée, la fonction
Do_PluginInit
du module FMPluginExample renvoie kCurrentExtnVersion.
58 Guide de développement FileMaker Pro Advanced
Après avoir défini les préférences, enregistrez chaque fonction externe en précisant son nom, sa description et la fonction à utiliser. Pour enregistrer vos fonctions, appelez fmx::ExprEnv::RegisterExternalFunction
.
Message de fermeture
Le message de fermeture
kFMXT_Shutdown
est adressé au module externe chaque fois que ce dernier est désactivé dans
FileMaker Pro, FileMaker Pro Advanced, FileMaker Server ou
FileMaker Server Advanced. Si le module est désactivé dans la boîte de paramétrage Préférences, cela peut correspondre à la fermeture de l’application.
Le module externe FMPluginExample n’effectuant pas d’allocation permanente de mémoire, il ne réalise aucune opération opération lorsqu’il reçoit le message de fermeture. Vous devez cependant développer une fonction de nettoyage dans vos modules externes afin de restituer les allocations diverses et quitter les services du système d’exploitation utilisés. Un module externe pouvant être activé et désactivé plusieurs fois au cours d’une même session, il est très important qu’il sache effacer et libérer les ressources mémoire.
Annulez l’enregistrement de chaque fonction externe enregistrée lors du message d’initialisation avec fmx::ExprEnv::UnRegisterExternalFunction
.
Message d’inactivité
Le message d’inactivité kFMXT_Idle
n’est envoyé au module externe qu’en cas d’inactivité, si l’indicateur de la chaîne d’options a été paramétré sur
Y
et que le module est activé.
Ce message est appelé à cinq occasions par l’application FileMaker.
Si le paramètre idleLevel
n’est pas nul, la routine a été appelée pendant que l’application exécute un script ou est contrôlée par l’utilisateur.
L’un des quatre messages suivants a été envoyé :
Message
kFMXT_UserNotIdle = 1
Signification
L’utilisateur a effectué une opération dans les
30 dernières secondes.
kFMXT_ScriptPaused = 2 L’utilisateur exécute un script mis en pause.
kFMXT_ScriptRunning = 3 L’utilisateur exécute un script.
kFMXT_Unsafe = 4 Identique si le paramètre de unsafeCalls est défini sur true.
N’effectuez aucun traitement lourd d’interface ou d’événements lorsque le paramètre idleLevel
est différent de zéro.
Le message d’inactivité est également envoyé lorsque l’application détecte un temps libre et effectue sa propre gestion interne d’inactivité.
Message
kFMXT_UserIdle = 0
Signification
L’utilisateur n’a effectué aucune opération depuis 30 secondes au moins.
Message de préférence
Le message de préférence kFMXT_DoAppPreferences
est envoyé lorsqu’un utilisateur clique sur le bouton Configurer du module externe sélectionné dans la boîte de dialogue Préférences.
Le module externe doit afficher une boîte de dialogue permettant
à l’utilisateur de configurer les données requises par le module.
Si le module externe fait appel à des préférences définissables par l’utilisateur, c’est ici que vous devez implémenter l’interface utilisateur.
Le bouton Configurer n’est disponible que lorsque le sixième caractère de la chaîne d’options est Y. Pour plus d’informations, reportez-vous
à la rubrique « Syntaxe des chaînes d’options », page 56.
Toutes les options qui doivent être sauvegardées doivent être placées dans leur propre entrée du registre (Windows) ou fichier de préférences (Mac OS X).
Le module FMExample devant proposer une boîte de dialogue de configuration pour la fonction
XMpl_UserFormatNumber
, l’indicateur a
été paramétré dans la chaîne d’options (
Xmpl1Ynnnnn
) et la fonction
Do_PluginPrefs
est appelée à la réception du message de préférence.
Message de fonctions externes
Le message de fonction externe kFMXT_External
est un message hérité des modules de style ancien. Il est inutile lorsque les modules ont été enregistrés dans le nouveau style.
Message GetString
Le message GetString kFMXT_GetString
est envoyé au module lorsque
FileMaker Pro, FileMaker Pro Advanced, FileMaker Server ou
FileMaker Server Advanced souhaite récupérer l’une des chaînes suivantes du module. Le développeur du module peut choisir l’emplacement de stockage des chaînes.
String
kFMXT_OptionsStr = 131
Signification
Chaîne d’options kFMXT_NameStr = 128 Nom du module kFMXT_AppConfigStr = 129 Texte d’aide à afficher dans la boîte de dialogue Préférences
Suppression des conflits de ressources potentiels sous Mac OS X
Sur les machines Mac OS X, des problèmes risquent de survenir si une ressource de votre module externe possède le même ID qu’une ressource utilisée par FileMaker Pro, FileMaker Pro Advanced,
FileMaker Server, FileMaker Server Advanced ou un autre module externe pour le même type de ressource.
Chapitre 5
|
Développement de modules FileMaker tiers 59
Pour éviter ce type de conflit entre le module externe et d’autres applications ou d’autres modules externes, respectez les instructions suivantes :
1
Utilisez des numéros ID compris entre 23 000 et 24 999
Utilisez des ID non paramétrables, situées dans cette plage pour vos boîtes de dialogue, sons, icônes et autres ressources (afin d’éviter les conflits avec les ressources de FileMaker Pro, FileMaker Pro Advanced,
FileMaker Server ou FileMaker Server Advanced). FileMaker n’utilise aucun ID de cette plage pour ses ressources.
1
Paramétrez le fichier de ressources actuel pour votre module externe.
Pour éviter les conflits avec d’autres modules externes utilisant les mêmes ID de ressources, utilisez la boîte à outils Mac OS X du gestionnaire de ressources pour paramétrer le fichier de ressources actuel sur votre module externe avant d’obtenir des objets du fichier de ressources.
Ajoutez la ligne suivante avant chaque ligne se référant à une ressource ou l’utilisant :
UseResFile (pb -> resourceID) ;
Lorsque FileMaker Pro, FileMaker Pro Advanced, FileMaker Server ou FileMaker Server Advanced charge votre module, l’application donne l’ID de la ressource (dans le bloc paramètre, à proximité des variables param2 et param3 du fichier FMExtern.h).
Pour plus d’informations, consultez la rubrique « Fichiers de code
Documentation du module externe
Votre module externe doit comporter un exemple de fichier de base de données contenant les rubriques et les scripts nécessaires pour démontrer l’utilisation de ses fonctions externes. En outre, vous devez fournir une documentation décrivant chaque fonction externe et ses paramètres.
60 Guide de développement FileMaker Pro Advanced
Pour obtenir des suggestions sur la façon de documenter votre module externe, examinez les modules enregistrés auprès de FileMaker
(www.filemaker.com).
Enregistrement de votre module
Pour vous assurer que votre module est unique et n’est pas utilisé par un autre module, vous devez l’enregistrer auprès de FileMaker.
Cet enregistrement permet également de promouvoir votre solution auprès de clients à la recherche d’un module externe.
Avant d’enregistrer votre module externe, vous pouvez effectuer des recherches afin de vérifier que son nom ou son ID de chaîne d’options n’a pas déjà été affecté.
Vous devez enregistrer chaque module séparément. Pour enregistrer votre module externe, rendez-vous sur le site www.filemaker.com/ developers.
Révision d’un module externe enregistré
Si vous devez modifier les informations concernant un module externe que vous avez déjà enregistré, vous devez envoyer un message
électronique à FileMaker à l’adresse [email protected] en fournissant les informations suivantes :
1
le numéro d’enregistrement qui vous a été affecté lors de l’enregistrement initial ;
1
votre nom ;
1
le nom complet de votre société ;
1
votre numéro de téléphone (professionnel) ;
1
le nom du produit et les informations que vous souhaitez modifier.
Ajoutez toute autre modification souhaitée. Si nécessaire, envoyez le fichier du module externe mis à jour. Une confirmation de la prise en compte de cette mise à jour vous sera adressée.
Chapitre 6
Débogage, analyse et optimisation des fichiers
Les fonctions de FileMaker Pro Advanced décrites dans ce chapitre sont les suivantes :
1
Script Debugger pour le test et le débogage systématiques des scripts FileMaker
1
Visualiseur de données pour la surveillance des rubriques, des variables et des calculs
1
Désactivation de l’action de script pour tester les parties d’un script
1
Rapport sur la structure des bases de données pour la publication d’une documentation complète sur les schémas de base de données et les options
1
Maintenance des fichiers pour la réduction de la taille des fichiers de bases de données et l’amélioration de leurs performances
Débogage et dépannage des scripts
FileMaker Pro Advanced vous permet :
1
de faire défiler les scripts action par action ;
1
d’afficher et de suivre les sous-scripts ;
1
de surveiller les rubriques, les variables et les calculs ;
1
de désactiver des actions de script.
Passage d’un script à un autre
Script Debugger vous permet de passer d’un script à un autre dans les bases de données FileMaker. Il permet d’exécuter les scripts pas à pas afin d’identifier les problèmes pouvant survenir lors de leur exécution.
Fenêtre Script Debugger
Script Debugger reconnaît les autorisations associées à chaque script.
Un script ne s’affiche donc dans Script Debugger que si vous êtes autorisé à le modifier et que ses droits d’accès sont définis sur
Modifiable.
Lorsqu’un script dont les droits d’accès sont définis sur Modifiable exécute un script en accès Exécutable uniquement, ce dernier s’exécute entièrement sans afficher ses étapes dans Script Debugger.
Lorsqu’un script Exécutable uniquement exécute un script dont les droits d’accès sont définis sur Modifiable, seules les étapes de ce dernier s’affichent dans Script Debugger. Pour plus d’informations sur les autorisations associées aux scripts et l’exécution de scripts avec droit d’accès complet, consultez l’Aide.
Pour exécuter des scripts en mode débogage, sélectionnez le menu
Outils > Mise au point des scripts.
Conseil
Pour activer Script Debugger à partir de la boîte de dialogue de définition des scripts, appuyez sur Maj et cliquez sur le bouton
Exécuter. Pour désactiver Script Debugger, appuyez sur Ctrl
(Windows) ou Commande (Mac OS) et cliquez sur le bouton
Exécuter. Pour plus d’informations sur les raccourcis clavier, consultez l’Aide.
62 Guide de développement FileMaker Pro Advanced
Choisissez
Etape
Commencer la procédure
Terminer la procédure
Exécuter
Pour
Exécuter le script pas à pas.
Si l’étape est Exécuter script, Script Debugger exécutera le sous-script et passera à la ligne suivante du script d’appel.
Script Debugger exécutera toutes les étapes du sous-script jusqu’à ce qu’il rencontre un point d’arrêt.
Exécuter le script pas à pas.
Si l’étape du script est Exécuter script, Script Debugger passera à la première ligne du sous-script et attendra une entrée de l’utilisateur avant de passer à la ligne suivante.
Exécuter tous les étapes du script en cours et, dans le cas d’un sous-script, revenir à la ligne qui suit l’étape Exécuter script du script d’appel.
S’il ne s’agit pas d’un sous-script, la commande Terminer la procédure indique à Script Debugger d’exécuter toutes les étapes du script et des sous-scripts jusqu’à ce qu’il rencontre un point d’arrêt.
Exécuter toutes les étapes du script jusqu’à un point d’arrêt.
Interrompre script Interrompre l’exécution d’un script et fermer Script
Debugger.
Définir l’action suivante
Régler le pointeur d’exécution des étapes sur l’action de script en surbrillance.
Cette commande passe le contrôle à l’étape en surbrillance, mais ne l’exécute pas. L’action en surbrillance s’exécute
à la reprise de l’exécution du script. Toutes les actions de script comprises entre la dernière étape exécutée et la suivante désignée ne sont pas exécutées. Cliquez sur une action pour la mettre en surbrillance, puis sur le bouton
Définir l’étape suivante.
Choisissez
Définir/Effacer le point d’arrêt
Supprimer les points d’arrêt
ScriptMaker
Pour
Définir ou effacer un point d’arrêt pour la ligne sélectionnée.
Vous pouvez définir ou effacer des points d’arrêt à l’aide de Script Debugger ou de ScriptMaker. Les points d’arrêt sont enregistrés avec le fichier contenant le script. Ils sont ignorés par FileMaker Pro et lorsque Script Debugger n’est pas utilisé. Ils permettent à Script Debugger d’exécuter de larges sections de script qu’il n’est pas nécessaire d’examiner minutieusement.
Effacer tous les points d’arrêt du script en cours.
La commande Supprimer les points d’arrêt est uniquement disponible dans le menu Outils > Commandes de débogage.
Interrompre l’exécution du script et ouvrir le ScriptMaker pour modifier le script.
Visualiseur de données
Ouvrir (ou fermer) la fenêtre Visualiseur de données pour surveiller des rubriques, des variables et des calculs particuliers.
Remarque
Pour simplifier la mise au point, Script Debugger ignore certaines actions du script. L’action Autor. annulation utilisateur avec une option définie sur Non ne vous empêchera pas d’arrêter l’exécution d’un script. L’action Ajuster fenêtre associée aux options
Masquer ou Réduire ne masquera ni ne réduira la fenêtre lors d’une exécution via les boutons Pas à pas ou Commencer l’exécution.
Affichage des sous-scripts
Vous pouvez afficher les sous-scripts au moment où vous naviguez entre les scripts de Script Debugger. Par exemple, si le script A appelle le script B, qui ensuite appelle à son tour le script C, vous pouvez visualiser les actions de chacun de ces trois scripts.
Pour afficher des sous-scripts :
1. Activez Script Debugger. Reportez-vous à la rubrique « Passage d’un script à un autre », page 61.
2. Sélectionnez une action de script qui appelle un sous-script
3. Cliquez sur le bouton Commencer la procédure.
La liste Scripts actifs affiche le sous-script.
4. Sélectionnez un script dans la liste Scripts actifs pour afficher les actions de ce script dans la zone d’affichage.
Remarque
La fonction Définir l’étape suivante est uniquement disponible pour le script en cours d’exécution.
Surveillance des rubriques, des variables et des calculs
Vous pouvez utiliser le Visualiseur de données pour surveiller des expressions du type valeurs de rubrique, rubriques globales et calculs.
Vous pouvez surveiller des expressions tout en exécutant des scripts ou en les testant dans le Script Debugger. Vous pouvez également surveiller les valeurs des rubriques et les variables dans le fichier de base de données.
Pour surveiller les rubriques, les variables et les calculs :
1. Choisissez le menu Outils > Visualiseur de données ou cliquez sur dans la fenêtre Script Debugger.
Chapitre 6
|
Débogage, analyse et optimisation des fichiers 63
2. Effectuez les actions suivantes :
Pour
Ajouter une expression
Procédure
Cliquez sur
.
Modifier une expression Cliquez sur ou double-cliquez sur l’expression dans la liste.
Dupliquer une expression Sélectionnez une ou plusieurs expressions, puis cliquez sur
.
Supprimer une expression Sélectionnez une ou plusieurs expressions, puis cliquez sur
.
3. Dans la boîte de dialogue Modifier l’expression, sélectionnez le fichier de base de données contenant l’expression, puis régénérez ou modifiez l’expression à surveiller.
Sélectionnez les opérateurs mathématiques et de texte
Sélectionnez les opérateurs logiques et de comparaison
Choisissez la façon dont les fonctions sont listées dans la boîte de dialogue
Sélectionnez les fonctions
Choisissez les références de rubriques
Faites glisser une flèche vers le haut ou vers le bas pour modifier l’ordre
Boîte de dialogue
Expression
Résultats de l’expression
Evaluez le contenu de l’expression
Ajoutez l’expression au Visualiseur de données
64 Guide de développement FileMaker Pro Advanced
4. Cliquez sur Evaluer maintenant pour afficher les résultats d’une expression ou sur Surveiller pour ajouter l’expression au Visualiseur de données.
5. Dans la fenêtre Visualiseur de données, cliquez sur Rafraîchir les valeurs pour rafraîchir les calculs de la liste.
Notez les points suivants :
1
Pour surveiller les rubriques, les variables et les calculs d’un script en cours d’exécution, ajoutez-les à la liste du Visualiseur de données avant d’exécuter le script dans Script Debugger.
1
Les valeurs de la colonne Expression dans le Visualiseur de données se mettent automatiquement à jour au moment où vous lancez Script Debugger.
1
Les expressions contenues dans la fenêtre Visualiseur de données ne sont pas retirées tant que vous ne les retirez pas vous-même.
1
Vous pouvez ajouter des variables locales et globales dans le
Visualiseur de données. Les variables locales commencent par $ et les variables globales par $$. Pour plus d’informations sur les variables, consultez l’Aide.
1
Cliquez sur Rafraîchir les valeurs pour mettre à jour les valeurs des calculs visibles dans la liste. Les valeurs sont mises à jour dès que vous faites défiler la liste.
Désactivation des actions du script
Vous pouvez désactiver et activer des actions de script pour tester les parties d’un script. Au moment d’exécuter un script, les actions de script désactivées sont alors ignorées.
Pour désactiver des actions de script :
1. Choisissez le menu Scripts > ScriptMaker.
Vous avez également la possibilité de cliquer sur le bouton
ScriptMaker dans la fenêtre Script Debugger.
2. Dans la boîte de dialogue Scripts de, sélectionnez le script, puis cliquez sur Modifier (ou double-cliquez sur son nom).
3. Dans la boîte de dialogue Modifier le script, sélectionnez une ou plusieurs actions de script, puis cliquez sur Désactiver ou sur Activer.
Notez les points suivants :
1
Pour désactiver des actions de script, vous devez disposer d’une autorisation de modification sur le script concerné dans votre jeu de privilèges.
1
Vous ne pouvez pas modifier les options pour les actions de script désactivées.
1
Si le fichier est ouvert dans FileMaker Pro, les utilisateurs voient les actions de script désactivées mais ne peuvent pas les activer.
1
Si vous désactivez une action de script Si, vous devez également désactiver l’action de script Fin de si correspondante. Cela s’applique
également aux actions de script Boucle, Sinon, Fin de boucle si et
Sinon si.
1
Script Debugger n’arrête pas l’exécution aux points d’arrêt sur les actions de script désactivées.
1
Vous ne pouvez pas utiliser la fonction Définir l’action suivante pour déplacer une action de script désactivée.
1
Si vous copiez, collez ou importez des scripts dont des actions ont
été désactivées, ces mêmes actions restent désactivées sur le nouvel
1
Les scripts désactivés sont précédés de //. Les actions de script désactivées affichent « <inconnu> » si vous les ouvrez ou si vous les importez dans un fichier FileMaker 7.
1
Les actions de script désactivées s’impriment en italique.
Documentation des schémas de base de données
Utilisez la fonction Rapport sur la structure des bases de données
(DDR) pour documenter le schéma de votre base de données et le publier dans un fichier HTML ou XML. Vous pouvez choisir les
éléments et tables des bases de données que le rapport doit traiter.
La version HTML du rapport contient un lien hypertexte et peut
être affichée et imprimée dans un navigateur Web autorisant les scripts Java.
La fonction Rapport sur la structure des bases de données vous permet :
1
d’examiner la représentation textuelle du schéma de votre base de données ;
1
de réunir des statistiques sur la structure de votre base de données ;
1
d’utiliser les informations du rapport pour recréer la structure de votre base de données en cas de perte des fichiers d’origine ;
1
de dépanner les références manquantes, les liens rompus, les calculs, etc.
Le Rapport sur la structure des bases de données au format HTML comprend une Présentation du rapport qui fournit un instantané des
éléments de chaque fichier de base de données. Cette Présentation du rapport contient des liens hypertexte pointant vers les détails relatifs aux éléments de chaque fichier de base de données. Le Rapport sur la structure des bases de données au format XML contient les mêmes informations, transformables au format souhaité, quel qu’il soit.
Vous pouvez créer des outils utilisant le rapport DDR XML pour analyser ou traiter la structure des bases de données. Pour plus d’informations, téléchargez le PDF Database Design Report XML
Output Grammar de FileMaker Pro Advanced, disponible à l’adresse www.filemaker.com/downloads.
Chapitre 6
|
Débogage, analyse et optimisation des fichiers 65
Pour créer un rapport sur la structure des bases de données :
1. Ouvrez tous les fichiers de bases de données pour lesquels vous souhaitez générer le Rapport.
Vous devez pour cela disposer de droits d’accès complets pour chaque fichier concerné et ce fichier doit être ouvert dans
FileMaker Pro Advanced. Vous pouvez générer un Rapport sur la structure des bases de données sur des fichiers locaux ou distants.
2. Sélectionnez Outils > Rapport sur la structure des bases de données.
3. Dans la liste Fichiers disponibles, retirez les fichiers à exclure du rapport en désactivant les cases à cocher associées au fichier.
4. Si certains fichiers contiennent des tables à exclure du rapport, sélectionnez le fichier dans la liste Fichiers disponibles.
Boîte de dialogue Rapport sur la structure des bases de données
Les tables du fichier s’affichent dans la liste Incl. rubriques de tab. ds fichier sélec. Vous pouvez alors désélectionner les tables souhaitées dans la liste.
66 Guide de développement FileMaker Pro Advanced
Par défaut, toutes les tables de tous les fichiers sélectionnés sont activées.
5. Désactivez les éléments à exclure du rapport.
Par défaut, tous les éléments de tous les fichiers sélectionnés sont activés. Chaque élément sélectionné, s’il est présent, sera traité dans le rapport pour les fichiers sélectionnés.
6. Si vous ne souhaitez pas publier le rapport au format HTML par défaut, activez l’option XML dans la section Format du rapport.
7. Pour ne pas ouvrir automatiquement le rapport après sa création, désactivez la case à cocher de cette option dans la section Gestion des fichiers.
8. Cliquez sur Créer.
Dépannage des fichiers avec le rapport DDR HTML
Vous pouvez utiliser le rapport sur la structure des bases de données
(DDR) pour identifier les zones problématiques de votre base de données. Par exemple, vous pouvez rechercher la sortie DDR du texte suivant pour localiser les problèmes existants :
1
rubrique manquante ;
1
occurrence de table manquante
1
table de base manquante ;
1
référence de fichier manquante ;
1
modèle manquant ;
1
liste de valeurs manquante ;
1
fonction personnalisée manquante ;
1
script manquant ;
1
compte manquant ;
1
jeu de privilèges manquant ;
1
privilège étendu manquant ;
1
menu personnalisé manquant ;
1
jeu de menus personnalisés manquant.
Notez les points suivants :
1
Si vous possédez des comptes inactifs avec un mot de passe vide, le rapport DDR HTML affichera ****** comme masque du mot de passe. Dans le fichier XML, le nœud emptyPassword="" indique
FALSE (FAUX). Pour obtenir des informations de mot de passe précises pour ces comptes inactifs, activez ces comptes, puis sélectionnez Afficher la source.
1
Mac OS : Pour afficher le rapport HTML, utilisez les navigateurs
Web du type Safari, Mozilla et Firefox. Internet Explorer pour
Mac OS n’est pas pris en charge.
1
Mac OS : Pour afficher un rapport DDR au format XML en utilisant un navigateur Web Safari, ouvrez le fichier dans Safari, puis choisissez le menu Affichage > Afficher la source.
1
La fonction Rapport sur la structure des bases de données crée des fichiers XML au format UTF-16. Pour afficher un rapport dans ce format, utilisez un éditeur de texte ou un navigateur de texte prenant en charge le texte UTF-16.
Compression et optimisation des fichiers
La fonction Maintenance des fichiers vous permet d’améliorer les performances de vos fichiers de base de données. L’option Compacter le fichier supprime l’espace inutilisé dans un fichier, ce qui réduit sa taille et rationalise l’accès aux données. L’option Optimiser le fichier accroît la vitesse d’accès aux fichiers en rapprochant les données liées logiquement. Ces deux fonctionnalités réduisent le déplacement des têtes de lecture. Les améliorations sont particulièrement perceptibles avec les fichiers volumineux et quand vous effectuez des requêtes ou des tris ou quand vous exécutez des scripts exploitant la totalité des enregistrements.
L’option Compacter le fichier compresse le fichier en supprimant l’espace libre, en combinant les pages de disques partiellement utilisées et en éliminant les espaces vides entre les données. Cette fonctionnalité est très utile pour réduire la taille d’un fichier de base de données. Il est cependant préférable de ne pas l’utiliser lorsque d’autres données doivent encore être ajoutées au fichier car cela augmente la fragmentation survenant lors de l’écriture de nouvelles données. Si vous devez ajouter des données à un fichier déjà compacté, commencez par le défragmenter avec la fonction
Optimiser le fichier.
L’option Optimiser le fichier défragmente le fichier de sorte que l’organisation physique de ses données corresponde à l’organisation logique. Cette fonction se révèle particulièrement utile pour accroître la vitesse d’exécution des recherches et des tris sur les fichiers comportant un grand nombre d’enregistrements. Vous pouvez utiliser la fonction Optimiser le fichier à tout moment, même sur des bases de données qui recevront de nouvelles données.
Les deux options de maintenance des fichiers fonctionnent sur le fichier de base de données ouvert, sans créer de copie supplémentaire.
Si vous hébergez des fichiers, les clients en réseau n’auront pas accès aux fonctions de maintenance des fichiers pour ces fichiers.
Vous pouvez utiliser les options ensemble ou séparément.
Vous pouvez annuler l’opération à tout moment, la compression et la défragmentation demeurant jusqu’au point d’annulation.
Chapitre 6
|
Débogage, analyse et optimisation des fichiers 67
1. Ouvrez un fichier de base de données.
2. Choisissez le menu Outils > Maintenance des fichiers.
3. Sélectionnez l’une des options ou les deux, puis cliquez sur OK.
Boîte de dialogue Maintenance des fichiers
Une boîte de dialogue d’état de maintenance des fichiers présente la progression des fonctions. Une autre boîte de dialogue vous signale la fin de l’opération.
68 Guide de développement FileMaker Pro Advanced
Chapitre 7
Utilisation des Utilitaires Developer
Les Utilitaires Developer de FileMaker Pro Advanced permettent de :
1
relier vos fichiers de base de données entre eux au sein d’une solution d’exécution autonome ne nécessitant pas l’application
FileMaker Pro ou FileMaker Pro Advanced sur l’ordinateur ;
1
renommer tous vos fichiers de base de données et mettre automatiquement à jour les liens internes (vers des fichiers et des scripts) ;
1
afficher vos fichiers de base de données en mode Borne de communication ;
1
supprimer un accès administratif de tous les comptes et empêcher les utilisateurs de modifier la plupart des éléments structurels ou la structure de vos bases de données ;
1
ajouter l’extension FileMaker Pro au nom de vos fichiers ;
1
ajouter votre propre logo ou graphique à l’écran de clôture de votre solution d’exécution autonome.
Avant de commencer à développer vos solutions, vous devez déterminer le mode d’interaction des utilisateurs. Votre solution peut comporter l’un des éléments suivants :
1
un fichier principal de base de données, relié à tous les fichiers auxiliaires ;
1
des scripts et des boutons permettant d’ouvrir et de fermer les fichiers auxiliaires, de revenir au fichier principal, d’afficher un modèle d’écran de démarrage ou de quitter l’application d’exécution ;
1
des éléments communs et un aspect homogène pour les solutions multiplates-formes ;
1
un thème de modèle personnalisé utilisé par tous les fichiers de la solution ;
1
un modèle A propos de pour présenter votre solution ;
1
un système d’Aide spécifique donnant des conseils pour utiliser votre solution ;
1
plusieurs jeux de privilèges pouvant spécifier les niveaux d’accès aux affichages, menus, tables spécifiques, enregistrements, rubriques, etc. ;
1
des comptes protégés par mot de passe et auxquels sont affectés des jeux de privilèges déterminant le niveau d’accès des utilisateurs.
Remarque
FileMaker Pro et FileMaker Pro Advanced vous permettent maintenant d’inclure autant de tables de bases de données que nécessaire dans un fichier de base de données. Cette capacité
élimine la principale cause d’utilisation des fichiers multiples.
Toutefois, d’autres éléments, comme les scripts et les autorisations d’accès, sont stockés au niveau du fichier et certaines solutions complexes continueront à utiliser avantageusement plusieurs fichiers.
Présentation de la préparation des fichiers de votre solution
Gardez à l’esprit le type d’interaction des utilisateurs avec votre solution au moment où vous la concevez, la construisez et la testez. Cela comprend aussi les scripts et les boutons de navigation, l’utilisation efficace des modèles et des thèmes, ainsi que l’Aide pour l’utilisateur.
Les Utilitaires Developer permettent de modifier les jeux de fichiers d’une solution. Ce chapitre présente les trois étapes principales du processus :
1. Pour modifier les fichiers d’une solution sans créer de solution
d’exécution, reportez-vous à la rubrique « Modification des fichiers de la solution », page 70.
70 Guide de développement FileMaker Pro Advanced
2. Pour préparer les fichiers d’une solution d’exécution et vérifier que leurs références fonctionneront avec la solution, reportez-vous à la
rubrique « Remarques sur la solution d’exécution », page 73.
3. Pour créer une solution d’exécution, reportez-vous à la rubrique
« Liaison des bases de données dans la solution d’exécution », page 74.
Voici quelques remarques générales sur la préparation des fichiers de la solution :
1
Si nécessaire, créez un thème personnalisé pour tous les modèles de votre solution. Pour plus d’informations, reportez-vous à la rubrique
« Création de thèmes de modèle personnalisés », page 37.
1
Si votre solution comporte des versions différentes pour Windows et Mac OS X, testez chaque version sur sa plate-forme respective.
Pour plus d’informations, consultez l’Aide.
1
Si vous avez utilisé plusieurs fichiers et non plusieurs tables au sein d’un seul fichier, tous les fichiers de votre solution doivent se trouver dans le même dossier avant d’être liés à une solution d’exécution.
Lorsque cela n’est pas faisable, assurez-vous d’inclure une référence correspondant simplement au nom du fichier vers chaque fichier.
Reportez-vous à la rubrique « Vérification des références externes », page 74.
1
Assurez-vous d’indiquer tous les fichiers liés à la solution afin que toutes les références soient mises à jour en cas de modification des noms de fichier.
1
Si vous avez utilisé plusieurs fichiers de base de données, choisissez le fichier principal que les utilisateurs ouvriront en premier.
Le fichier principal renferme les paramètres personnalisés. Intégrez à ce fichier des boutons de navigation ou des scripts vers les fichiers auxiliaires, un modèle A propos de, un modèle ou un fichier Aide personnalisé et une option pour quitter l’application.
1
Créez des scripts et des boutons pour que les utilisateurs puissent naviguer entre le fichier principal, les fichiers auxiliaires et les
1
Créez une documentation sur votre solution. Reportez-vous à la
rubrique « Documentation destinée aux utilisateurs », page 85.
1
Remarque : Bien que les Utilitaires Developer utilisent une copie de fichier et non l’original, il est parfois judicieux d’en effectuer une copie supplémentaire avant de commencer.
Modification des fichiers de la solution
Les Utilitaires Developer permettent de produire un nouveau jeu de fichiers de base de données, de personnaliser ceux-ci ou de créer une solution d’exécution.
Remarque
Il est impératif de convertir les fichiers de bases de données issus de versions de FileMaker Pro antérieures à 7.0 avant de les utiliser avec les Utilitaires Developer. Pour plus d’informations sur la conversion des fichiers, consultez les informations contenues dans le Manuel de l’utilisateur FileMaker Pro.
Pour utiliser les Utilitaires Developer :
1. Fermez tous les fichiers de bases de données à personnaliser.
2. Choisissez le menu Outils > Utilitaires Developer.
3. Si vous avez déjà utilisé les Utilitaires Developer pour la même solution et enregistré vos paramètres, cliquez sur Charger paramètres.
La boîte de dialogue Sélectionner un fichier qui apparaît vous permet de rechercher votre fichier de paramètres. Reportez-vous
à la rubrique « Enregistrement et réutilisation des paramètres des
Utilitaires Developer », page 78.
4. Pour définir les fichiers à personnaliser, cliquez sur Ajouter.
Chapitre 7
|
Utilisation des Utilitaires Developer 71
5. Lorsque tous les fichiers à personnaliser ont été ajoutés, choisissez une ou plusieurs des actions suivantes :
Pour
Sélectionner le fichier principal
Procédure
Double-cliquez sur le fichier dans la liste.
Renommer un fichier Sélectionnez le fichier dans la liste, entrez le nouveau nom dans la zone Renommer le fichier et cliquez sur
Modifier.
Remarque
N’indiquez pas d’extension de fichier.
Reportez-vous à la rubrique « Attribution de noms aux solutions d’exécution », page 76.
Supprimer un fichier Sélectionnez le fichier dans la liste et cliquez sur
Supprimer.
6. Pour choisir l’emplacement d’enregistrement de la copie de la solution, cliquez sur Définir sous Dossier de projet.
7. Dans la boîte de dialogue Rechercher un dossier (Windows) ou
Choisissez un dossier (Mac OS X), sélectionnez ou créez un dossier et cliquez sur OK (Windows) ou Choisir (Mac OS X).
8. Pour conserver les versions précédentes, désactivez la case à cocher Ecrasement des fichiers correspondants dans le dossier de projet.
Important
Si l’option Ecrasement des fichiers correspondants dans le dossier de projet est activée, les Utilitaires Developer remplacent les fichiers par les mêmes noms que ceux apparaissant dans la liste des fichiers.
9. Effectuez l’une des opérations suivantes :
1
Pour personnaliser vos fichiers de base de données ou les lier à une solution d’exécution, cliquez sur Définir sous Options de la solution.
Boîte de dialogue Options de solution
1
Pour créer une copie de vos fichiers de base de données à l’aide
de nouveaux noms, passez à l’étape 13.
10. Dans la boîte de dialogue Options de solution, sélectionnez une ou plusieurs options.
Pour
Lier des bases de données à des applications d’exécution
Procédure
Sélectionnez Créer une ou plusieurs applications de solution d’exécution
Reportez-vous à la rubrique « Liaison des bases de données dans la solution d’exécution », page 74.
Remarque
Cette option peut être combinée à toutes les autres à l’exception de Extension de fichier FileMaker requise pour les bases de données.
72 Guide de développement FileMaker Pro Advanced
Pour
Interdire définitivement les accès admin à votre solution
Procédure
Sélectionnez Supprimer définitivement l’accès admin des fichiers
Important
Une fois supprimé, l’accès admin ne peut pas être restauré pour la solution personnalisée.
Forcer les comptes ne disposant pas de droit d’accès intégral à ouvrir votre solution en mode Borne de communication
Sélectionnez Activer le mode Borne de communication pour les comptes non admin
Reportez-vous à la rubrique « A propos du mode Borne de communication », page 19.
Ajouter l’extension
FileMaker aux noms de fichiers des bases de données
Créer un fichier journal afin d’enregistrer les erreurs survenant pendant le traitement
Sélectionnez Extension de fichier FileMaker requise pour les bases de données
Remarque
Cette option n’est pas disponible si vous avez sélectionné Créer une ou plusieurs applications de solution d’exécution. Vous pouvez utiliser cette fonction pour ajouter des extensions aux fichiers qui n’en n’ont pas.
Sélectionnez Créer un journal d’erreurs pour les erreurs de traitement
Reportez-vous à la rubrique suivante « Création d’un journal d’erreurs ».
11. Cliquez sur OK.
12. Pour pouvoir reproduire rapidement cette procédure, cliquez sur Enregistrer paramètres et choisissez le dossier et l’emplacement de votre fichier de paramètres.
13. Cliquez sur Créer.
Les Utilitaires Developer copient tous les fichiers de la base de données, avec les modifications apportées par les Utilitaires, dans le dossier Dossier de projet. Si l’option par défaut permettant de remplacer les fichiers de destination est toujours activée, le Dossier de projet spécifié sera utilisé pour stocker les fichiers copiés par les
Utilitaires Developer. Si cette option a été désactivée, le Dossier de projet spécifié n’est utilisé que lorsqu’il est vide ou qu’un nouveau dossier doit être créé à partir du nom du Dossier de projet.
Création d’un journal d’erreurs
Certaines erreurs n’entraînent pas l’apparition de messages d’erreur.
Un journal d’erreurs conservera davantage de détails sur les erreurs survenues pendant le traitement.
Pour créer un modèle de journal d’erreurs :
1. Dans la boîte de dialogue Options de solution, activez l’option
Créer un journal d’erreurs pour les erreurs de traitement.
2. Cliquez sur Définir.
Si vous n’indiquez aucun nom ni aucun emplacement, le journal d’erreurs sera enregistré dans le dossier de projet sous le nom
Logfile.txt
.
3. Pour sélectionner un emplacement et nommer le journal, utilisez la boîte de dialogue Spécifier un fichier.
Si une erreur survient lors du traitement des options, elle est alors enregistrée dans le journal. Il est également possible qu’un message signale l’erreur rencontrée.
Remarques sur la solution d’exécution
Il est préférable d’envisager l’ensemble des points suivants avant de relier les fichiers à une solution d’exécution.
1
Les utilisateurs doivent-ils pouvoir ouvrir et fermer les fichiers auxiliaires ?
L’application d’exécution ne présente aucune option de menu permettant d’ouvrir ou de fermer les fichiers. Pour que les utilisateurs puissent ouvrir et fermer les fichiers auxiliaires, vous devez ajouter des scripts à votre solution pour effectuer ces opérations. Vous devez placer un bouton ou un script de démarrage permettant à l’utilisateur de revenir au fichier principal dans chaque fichier auxiliaire.
1
Les utilisateurs doivent-ils pouvoir modifier la base de données ?
Si les fichiers de vos solutions d’exécution ne sont pas protégés par un mot de passe, les utilisateurs peuvent les ouvrir et les modifier dans
FileMaker Pro ou FileMaker Pro Advanced. Vous pouvez également interdire définitivement toute modification de vos fichiers. Reportez-
vous à la rubrique « Suppression des privilèges d’accès intégral des bases de données », page 80.
1
Cette solution d’exécution sera-t-elle utilisée sur les deux plates-formes ?
Reportez-vous à la rubrique « Liaison de fichiers aux deux platesformes », page 74.
1
Comment assurerez-vous la mise à jour de la solution ?
Vous pouvez simplifier la mise à jour des fichiers de votre solution d’exécution en permettant aux utilisateurs d’exporter leurs données, puis de les réimporter dans la solution mise à jour,
à partir de scripts placés dans votre fichier principal. Reportez-
vous à la rubrique « Importation des données dans des solutions d’exécution mises à jour », page 79.
Chapitre 7
|
Utilisation des Utilitaires Developer 73
1
Les utilisateurs doivent-ils imprimer des rapports ou des données depuis votre solution d’exécution ?
Si votre solution doit faire l’objet d’impressions sur différentes imprimantes, il peut être judicieux de définir des marges. Pour plus d’informations, consultez l’Aide.
1
Voulez-vous que les utilisateurs puissent vérifier l’orthographe des enregistrements ?
Vous pouvez modifier la langue du dictionnaire orthographique principal de votre solution en sélectionnant l’un des dictionnaires fournis avec FileMaker Pro Advanced. Vos utilisateurs peuvent ajouter ou modifier un dictionnaire personnalisé à l’application d’exécution. Pour plus d’informations, consultez l’Aide.
1
Les fichiers d’origine de votre solution sont-ils répartis dans plusieurs dossiers ?
Reportez-vous à la rubrique suivante, « Vérification des références externes ».
Fichier principal d’une solution d’exécution
74 Guide de développement FileMaker Pro Advanced
Vérification des références externes
Une référence externe stocke le ou les chemins d’accès que recherche l’application d’exécution pour accéder à une table externe, un script ou une liste de valeurs. Chaque référence externe peut comporter un ou plusieurs chemins d’accès, séparés par un retour chariot. Les chemins d’accès au fichier sont traités dans leur ordre d’apparition.
L’application d’exécution ouvre le premier fichier qu’elle peut localiser. Pour plus d’informations, consultez l’Aide.
Conseil
Vous pouvez placer plusieurs tables dans un seul fichier et éviter ainsi les difficultés généralement inhérentes aux fichiers multiples.
Lors du développement d’une base de données comportant plusieurs fichiers, ces derniers peuvent être placés dans des dossiers séparés.
Toutefois, lors de la création d’une solution d’exécution, tous les fichiers sont réunis dans le même dossier que l’application d’exécution. Que votre solution commence dans un seul dossier ou non, vos références externes doivent tenir compte de cet élément.
De ce fait, toutes les références externes doivent inclure un chemin d’accès correspondant simplement au nom du fichier référencé. Même si l’application vérifie les autres références, elle décèle les fichiers réunis dans le dossier même où elle réside. Vous pouvez toujours conserver des chemins d’accès absolus ou relatifs dans la même référence externe pour le cas où les fichiers sont également utilisés dans FileMaker Pro ou FileMaker Pro Advanced.
Pour vérifier les références externes :
1. Dans le menu Fichier, sélectionnez Définir > Références externes.
La boîte de dialogue Définir les références externes présente la liste de toutes les références de la base de données en cours. Assurez-vous qu’une référence s’affiche dans la Liste de chemins d’accès pour chaque fichier nommé, c’est-à-dire le nom du fichier, sans les dossiers. La référence doit ressembler à celle-ci : file:MyFile.fp7
.
2. Si l’un des fichiers ne comporte pas de référence à son nom uniquement, cliquez sur Créer dans la boîte de dialogue Définir les références externes.
3. Dans la Liste des chemins d’accès, entrez le nom du fichier avec son extension.
4. Dans la zone Nom de la référence, tapez un nom. Il s’agit du nom qui apparaît dans toutes les listes affichant les références externes.
5. Pour enregistrer la référence externe, cliquez sur OK.
Liaison de fichiers aux deux plates-formes
Si votre solution doit être utilisée sous Windows, utilisez les
Utilitaires Developer pour Windows pour relier ses composants. Si votre solution doit être utilisée sous Mac OS X, utilisez les Utilitaires
Developer pour Mac OS X. Si vous créez une solution devant être utilisée sous Windows et Mac OS X, créez deux solutions d’exécution distinctes en reliant deux fois les fichiers de la solution d’origine : d’abord à l’aide des Utilitaires FileMaker Developer pour Windows, puis à l’aide des Utilitaires FileMaker Developer pou Mac OS X.
Utilisez la même clé de liaison sur les deux plates-formes.
N’oubliez pas que les clés de liaison tiennent compte de la casse des caractères saisis.
Liaison des bases de données dans la solution d’exécution
Servez-vous des Utilitaires Developer pour générer une solution d’exécution autonome à laquelle les utilisateurs peuvent accéder sans exécuter FileMaker Pro ni FileMaker Pro Advanced. Les Utilitaires
Developer créent une copie de vos fichiers, puis lient le ou les fichiers de base de données à une application d’exécution portant le nom que vous indiquez.
Chapitre 7
|
Utilisation des Utilitaires Developer 75
Aucune des commandes du sous-menu Définir du menu Fichier n’est disponible dans l’application d’exécution. Reportez-vous
FileMaker Pro Advanced sont également supprimées de l’application d’exécution.
Une base de données d’exécution peut cependant être ouverte dans
FileMaker Pro ou FileMaker Pro Advanced. La fonctionnalité complète de ces applications sera activée, sauf si les privilèges d’accès
Les solutions d’exécution ne peuvent être publiées en réseau, sur Internet ou un intranet que si vous utilisez FileMaker Pro ou FileMaker Pro Advanced au lieu de l’application d’exécution.
Pour obtenir la liste complète des différences entre l’application
Il peut être nécessaire de lier vos fichiers de base de données plusieurs fois avant de les préparer pour vos utilisateurs. Lorsque le développement est terminé et que la version définitive est liée et prête
à être diffusée, testez minutieusement votre solution d’exécution pour vous assurer qu’elle se comporte comme prévu. Reportez-vous à
la rubrique « Remarques sur la solution d’exécution », page 73.
Ecran d’introduction ouvert depuis un script de démarrage du fichier principal.
Pour plus d’informations sur les conditions requises pour l’utilisation
Pour lier des fichiers de base de données à une solution d’exécution :
1. Suivez les étapes 1 à 9 de la rubrique « Modification des fichiers de la solution », page 70.
2. Dans la boîte de dialogue Options de solution, sélectionnez Créer une ou plusieurs applications de solution d’exécution.
3. Dans la zone Nom d’exécution, entrez le nom de votre application d’exécution.
Ce nom est utilisé pour le nom du fichier de l’application d’exécution et pour le nom du dossier contenant les fichiers de la solution.
Reportez-vous à la rubrique suivante « Attribution de noms aux solutions d’exécution ».
76 Guide de développement FileMaker Pro Advanced
4. Dans la zone Extension, entrez une extension de fichier à trois caractères.
Cette extension associe les fichiers de la solution aux applications
d’exécution. Reportez-vous à la rubrique « Attribution d’extensions
à trois caractères », page 76.
5. Dans la zone Clé de liaison, entrez une clé comprenant 1 à
24 caractères.
La clé de liaison relie l’application d’exécution aux fichiers de la base de données et garantit l’ouverture des fichiers liés dans l’application
d’exécution appropriée. Reportez-vous à la rubrique « Définition de la clé de liaison », page 77.
Important
L’opération de liaison installe les fichiers système appropriés à chaque plate-forme.
6. Pour ajouter le logo d’une société ou une autre image personnalisée
à l’écran de clôture, cliquez sur Définir, sélectionnez l’image de clôture, puis cliquez sur Sélectionner.
La taille minimale de l’image est 382 x 175 pixels (72 ppp) ; en dessous, l’image est déformée lors de son affichage. Les formats pris en charge sont les formats JPEG et GIF.
7. Dans la zone Délai, indiquez le nombre de secondes durant lesquelles l’écran doit s’afficher.
Pour avoir un aperçu de l’effet obtenu, cliquez sur le bouton
Prévisualisation.
8. Lorsque la définition des options est terminée, cliquez sur OK.
9. Pour pouvoir reproduire rapidement cette procédure, cliquez sur
Enregistrer paramètres et choisissez le dossier et l’emplacement de votre fichier de paramètres.
10. Cliquez sur Créer.
Les Utilitaires Developer copient tous les fichiers d’exécution dans un nouveau dossier, créé dans le Dossier de projet et nommé après la solution d’exécution. Pour plus d’informations sur la liaison des fichiers requis et sur la diffusion de la solution d’exécution aux
utilisateurs, consultez la rubrique « Diffusion des solutions d’exécution », page 81.
Attribution de noms aux solutions d’exécution
Les noms de fichiers peuvent contenir jusqu’à 31 caractères. Lorsque vous choisissez les noms des fichiers de vos solutions d’exécution, vous devez prendre en considération les plates-formes sur lesquelles elles seront déployées afin d’assurer le bon fonctionnement des scripts et des références externes.
Les noms de fichiers sous Windows ne doivent pas commencer par un espace. Pour assurer la compatibilité multiplates-forme de vos solutions, n’utilisez pas les caractères suivants dans les noms de fichiers : guillemets ("), barre oblique (/), barre oblique inversée
(\), crochets (<>), astérisque (*), point d’interrogation (?), deux-points (:), barre verticale (|).
Attribution d’extensions à trois caractères
L’extension de fichier, à trois caractères, associe tous les fichiers de la solution à l’application d’exécution. Si un utilisateur dispose de plusieurs solutions d’exécution sur la même machine, les extensions et la clé de liaison permettent de s’assurer du lancement de la bonne solution d’exécution lorsque l’utilisateur double-clique sur un fichier.
Vous devez utiliser une extension unique sur les systèmes de vos utilisateurs.
Les Utilitaires Developer mettent automatiquement à jour tous les fichiers et leur ajoutent l’extension à trois caractères que vous avez indiquée. Les références internes utilisées par des liens, des scripts et des listes de valeurs externes sont mises à jour pour intégrer les nouveaux noms de fichiers.
Remarque
Quelles que soient les extensions, les fichiers de base de données d’applications d’exécution peuvent toujours être ouverts dans FileMaker Pro et FileMaker Pro Advanced. Pour éviter que les utilisateurs puissent modifier vos solutions d’exécution, définissez des autorisations d’accès spécifiques à l’aide de mots de passe, ou sélectionnez l’option Supprimer définitivement l’accès admin des fichiers des Utilitaires Developer avant de lier les fichiers à une solution
Attribution d’une extension aux solutions Windows
L’extension à trois caractères enregistre votre application d’exécution
à l’aide du système d’exploitation Windows. Celui-ci utilise l’extension pour déterminer l’application à lancer lorsque vous double-cliquez sur un fichier de la solution. Les Utilitaires Developer ajoutent une extension à tous les noms des fichiers des bases de données de la solution d’exécution lors de la procédure de liaison.
Attribution d’une extension aux solutions Mac OS X
En environnement Mac OS X, l’extension à trois caractères devient le code créateur de l’application d’exécution. Ce code créateur doit
être unique pour que le Finder de Mac OS X puisse déterminer quelle application a servi à créer un document en particulier. Le code créateur est enregistré dans les fichiers de la solution et dans l’application d’exécution.
Les codes créateur ayant quatre caractères, les Utilitaires Developer insèrent la lettre F majuscule après le premier caractère. Par exemple, l’extension par défaut à trois caractères USR devient le code créateur
UFSR. Les codes créateur tiennent compte de la casse des caractères.
Chapitre 7
|
Utilisation des Utilitaires Developer 77
Remarque
Les codes créateur doivent être enregistrés auprès d’Apple Computer, Inc. afin de garantir leur unicité. Si le code créateur n’est pas unique, les fichiers de la solution ne pourront pas s’ouvrir avec l’application d’exécution appropriée. Vous pouvez utiliser l’extension USR à trois caractères, car FileMaker a enregistré le code créateur UFSR auprès d’Apple Computer, Inc. Pour enregistrer d’autres codes, contactez les services de support aux développeurs d’Apple ou visitez le site Web www.apple.com.
Conflits liés aux extensions non uniques dans Windows
Si l’extension à trois caractères n’est pas unique, des conflits de registre peuvent survenir dans Windows. Par exemple, si vous utilisez l’extension .fp7 pour votre solution d’exécution et que vos utilisateurs ont installé FileMaker Pro sur leur disque dur, toutes les icônes de leurs documents FileMaker Pro se transforment en icônes de la solution d’exécution. En outre, les documents FileMaker Pro n’ouvrent plus automatiquement l’application FileMaker Pro.
Pour restaurer l’icône FileMaker Pro des documents :
1. Supprimez l’application d’exécution.
2. Ouvrez un document dans FileMaker Pro, puis refermez-le et quittez l’application.
3. Redémarrez votre système.
Définition de la clé de liaison
Le nom que vous indiquez dans les Utilitaires Developer est donné
à l’application d’exécution et peut être également donné au nouveau dossier de la solution contenant les fichiers liés de la solution.
La clé de liaison est un code utilisé par les Utilitaires Developer lors de la procédure de liaison pour établir un lien interne entre les fichiers et l’application d’exécution. S’il vous faut ensuite ajouter des fichiers auxiliaires à une solution d’exécution, liez de nouveau les fichiers avec la même clé de liaison.
78 Guide de développement FileMaker Pro Advanced
Si vous développez une solution pour les deux plates-formes, utilisez la même clé pour lier la solution sous Windows et sous Mac OS X. De même, n’oubliez pas que la clé de liaison respecte la casse sous
Windows comme sous Mac OS X.
Remarque
Utilisez une clé de liaison facile à retenir et gardez-en une copie dans un endroit sûr. (Vous pouvez pour cela enregistrer le fichier de paramètres des Utilitaires Developer : reportez-vous
à la rubrique « Enregistrement et réutilisation des paramètres des
Utilitaires Developer », page 78.) Si vous oubliez cette clé de liaison
et que vous souhaitez modifier la solution d’exécution, vous devez relier tous les fichiers de bases de données à l’aide d’une nouvelle clé, puis distribuer à nouveau toute la solution, y compris la nouvelle application d’exécution.
Modification des fichiers d’exécution liés
Vous pouvez ouvrir un fichier d’exécution lié dans FileMaker Pro et FileMaker Pro Advanced pour le modifier. Toutefois, si vous avez sélectionné l’option Supprimer définitivement l’accès admin des fichiers au moment de lier les fichiers, vous ne pourrez pas réaccéder à
Dans ce cas, ouvrez les fichiers de base de données d’origine dans
FileMaker Pro Advanced pour apporter les modifications de conception ou de structure nécessaires, puis liez-les de nouveau
à l’aide de la clé de liaison que vous avez affecté à la solution.
Reportez-vous à la rubrique « Diffusion de mises à jour de solutions d’exécution », page 89.
Enregistrement et réutilisation des paramètres des Utilitaires Developer
Vous pouvez enregistrer les paramètres définis dans les Utilitaires
Developer pour les réutiliser ultérieurement. Ces paramètres comprennent la liste des fichiers à modifier. Après avoir saisi vos spécifications dans les Utilitaires Developer, cliquez sur Enregistrer paramètres. Choisissez l’emplacement et le nom du fichier de paramètres. L’extension .sav est ajoutée automatiquement et ne doit pas
être modifiée. Vous pouvez enregistrer autant de fichiers de paramètres que nécessaire, en changeant les emplacements et les noms.
Le fichier de paramètres permet de reproduire la même procédure sur les fichiers de bases de données à l’aide des Utilitaires Developer. A l’ouverture des Utilitaires Developer, cliquez sur Charger paramètres, localisez le fichier de paramètres, puis cliquez sur Charger.
Modification du jeu de paramètres d’une solution
Pour modifier un fichier de paramètres :
1. Ouvrez les Utilitaires Developer.
2. Cliquez sur Charger paramètres.
3. Localisez, puis sélectionnez le fichier de paramètres à modifier.
4. Cliquez sur Charger.
5. Définissez les options.
6. Cliquez sur Enregistrer paramètres, puis sur Enregistrer.
7. Cliquez sur Oui pour remplacer le fichier.
Vos modifications ont été enregistrées et peuvent être réutilisées.
Conversion et mise à jour des fichiers de la solution
Si vous avez développé une solution d’exécution FileMaker Pro à l’aide de FileMaker Pro 3.0 SDK (ou d’une version antérieure), de l’utilitaire de groupement de FileMaker Pro 4.0 Developer Edition ou de FileMaker Developer Tool dans FileMaker Developer 5.x et 6.0, vous pouvez la mettre à jour et fournir aux utilisateurs des fichiers convertis. Les fichiers liés à une application d’exécution à l’aide des outils précédents doivent être liés à nouveau à l’aide des
Utilitaires Developer.
Vous devez convertir les fichiers FileMaker Pro créés dans la version 6.0 ou les versions précédentes au nouveau format. Vous pouvez convertir un seul fichier ou plusieurs fichiers à la fois.
Pour plus d’informations sur la conversion des fichiers, consultez les informations contenues dans le Manuel de l’utilisateur
FileMaker Pro.
Après leur conversion, vous pouvez mettre à niveau les fichiers afin de profiter des dernières fonctions de FileMaker Pro et
FileMaker Pro Advanced. Si nécessaire, créez des scripts pour importer les données des anciennes versions dans la nouvelle solution.
Pour relier les fichiers à une nouvelle solution d’exécution, utilisez
Distribuez la nouvelle version en l’accompagnant d’instructions sur les modalités de mise à jour des fichiers (conversion des anciens fichiers et importation des données).
Chapitre 7
|
Utilisation des Utilitaires Developer 79
Importation des données dans des solutions d’exécution mises à jour
Pour que les utilisateurs puissent importer des enregistrements de l’ancienne version, vous pouvez inclure des scripts dans les fichiers de la nouvelle solution d’exécution. Les anciens fichiers doivent d’abord
être convertis au nouveau format.
Remarque
Lors de la création de votre solution d’exécution mise
à jour, choisissez une extension différente de celle de l’ancienne solution.
Pour préparer la nouvelle version à l’importation des données :
1. Dans le dossier contenant les fichiers de la nouvelle solution d’exécution, créez un dossier nommé Fichiers de l’ancienne solution.
2. Placez les copies des fichiers de l’ancienne solution dans ce dossier.
3. Dans chaque fichier mis à jour, créez un script assurant la conversion du fichier de l’ancienne solution et l’importation des enregistrements dans le nouveau fichier.
La fonctionnalité du script doit comprendre :
1
Convertir fichier [<nom du fichier de l’ancienne version de la solution>]
1
Importer enregistrements [<ancien nom de fichier avec extension de la nouvelle solution>]
1
Fermer fichier [<ancien nom de fichier avec extension de la nouvelle solution>]
4. Ajoutez un bouton permettant d’activer le script.
5. Répétez les étapes 3 et 4 pour chaque fichier mis à jour.
6. Pour relier les fichiers mis à jour à la nouvelle solution d’exécution, utilisez les Utilitaires Developer.
80 Guide de développement FileMaker Pro Advanced
7. Testez les boutons de l’application d’exécution.
Servez-vous d’échantillons de données pour vérifier que les enregistrements sont correctement importés et les données importées dans les rubriques appropriées.
8. Distribuez les nouveaux fichiers contenant les boutons.
9. Donnez aux utilisateurs toutes les instructions nécessaires pour importer les données dans les fichiers de la nouvelle solution.
Les utilisateurs peuvent copier leurs anciens fichiers dans le dossier
Fichiers de l’ancienne solution, puis utiliser les boutons des nouveaux fichiers pour effectuer la conversion et importer leurs propres enregistrements dans les nouveaux fichiers.
Suppression des privilèges d’accès intégral des bases de données
Pour protéger les bases de données, FileMaker Pro et
FileMaker Pro Advanced utilisent des comptes, des jeux de privilèges et des privilèges étendus. Les Utilitaires Developer vous permettent de supprimer tous les comptes admin d’un fichier. Pour plus d’informations sur la création de comptes et de privilèges, consultez l’Aide.
Les Utilitaires Developer permettent d’empêcher les utilisateurs de modifier la conception et la structure des fichiers de vos bases de données et de modifier les comptes ou les privilèges configurés. Si vous activez l’option Supprimer définitivement l’accès admin des fichiers :
1
Les utilisateurs ne peuvent pas accéder aux boîtes de dialogue
Définir la base de données, Définir les références externes, Définir les fonctions personnalisées ni à la plupart des options de la boîte de dialogue Définir les comptes et privilèges.
1
La version texte des fonctions personnalisées est supprimée.
1
Les utilisateurs peuvent accéder à l’onglet Privilèges étendus de la boîte de dialogue Définir les comptes et privilèges si l’option Gérer les autorisations étendues de leur compte est activée.
1
Les utilisateurs peuvent accéder aux boîtes de dialogue dont la liste s’affiche ci-dessus s’ils exécutent un script dont l’option Exécuter le script avec toutes les autorisations d’accès est activée.
1
Les utilisateurs peuvent accéder au mode Modèle et à ScriptMaker si le jeu de privilèges affecté à leur compte le permet.
Remarque
Chaque fichier de base de données doit renfermer au moins un compte actif pour pouvoir être ouvert. Si les comptes dotés de jeux de privilèges Accès intégral sont les seuls comptes actifs du fichier, vous ne pouvez pas activer l’option Supprimer définitivement l’accès admin des fichiers. Si vous tentez de le faire, un message d’erreur apparaît.
Important
L’activation de cette option supprime définitivement de la base de données, tous les comptes qui utilisaient le jeu de privilèges
Accès intégral. Cela interdit également définitivement l’accès au Mode
Modèle et à ScriptMaker, ainsi qu’à toutes les boîtes de dialogue
Définir, à l’exception de l’onglet Privilèges étendus de la boîte de dialogue Définir les comptes et autorisations d’accès, pour tous les fichiers de la solution, qu’ils soient ouverts dans une application d’exécution, dans FileMaker Pro ou dans FileMaker Pro Advanced.
Personne ne peut plus modifier les éléments structurels et conceptuels des fichiers, pas même les employés de FileMaker. La seule manière de modifier les tables, les définitions de rubriques, les relations, les scripts ou les autorisations d’accès consiste alors à reprendre le fichier d’origine, avant sa personnalisation par les Utilitaires Developer.
Lors de la définition des autorisations d’accès, vous devez prendre en considération les besoins à long terme de vos utilisateurs. Vous devez en particulier indiquer clairement leurs autorisations d’accès dans le modèle A propos de et respecter les règles édictées par FileMaker.
Pour plus d’informations, consultez la rubrique « Création d’un modèle A propos de », page 85.
Chapitre 8
Diffusion des solutions d’exécution
La dernière étape de la conception d’une solution d’exécution consiste
à relier l’ensemble des fichiers nécessaires, choisir les modalités de sa diffusion (CD ou réseau par exemple) et fournir aux utilisateurs une documentation d’installation. Cette dernière doit contenir toutes les instructions relatives au démarrage de l’application et indiquer la marche à suivre en cas de fichiers endommagés.
Organisation des composants de la solution
Lorsque vous reliez les fichiers de votre base de données à une solution d’exécution, les Utilitaires Developer génèrent un nouveau dossier contenant l’application d’exécution, le fichier principal et les fichiers de base de données auxiliaires et un dossier Extensions.
Dans le cas de solutions d’exécution Windows, des fichiers DLL
(Dynamic Link Library) sont également nécessaires.
Dossier de solution Windows
Application d’exécution
Fichier principal et fichiers auxiliaires reliés
Fichiers DLL générés lors de la liaison
Extensions
Dictionaries
Dossiers de ressources linguistiques
Dossier de solution Mac OS X
Lot d’applications d’exécution
Fichier principal et fichiers auxiliaires reliés
Extensions
Dictionaries
Dossiers de distribution sous Windows et Mac OS X
Important
Ces fichiers et dossiers ne doivent pas être renommés.
Si votre solution d’exécution requiert des fichiers personnalisés, fournissez les fichiers avec les fichiers d’exécution. Les modules doivent être stockés dans le dossier Extensions. Lorsqu’un développeur utilise une police indisponible sur le système de l’utilisateur, l’application d’exécution choisit une police de substitution. Si l’exécution inclut une police, son installation par le programme
Outre ces fichiers d’exécution, vous devez fournir des instructions d’installation aux utilisateurs. Reportez-vous à la rubrique
« Documentation des procédures d’installation », page 84.
Lot d’application d’exécution Mac OS X
Les Utilitaires Developer génèrent un lot d’application d’exécution pour Mac OS X. Ce lot porte le même nom que votre solution et contient le code et les principales ressources nécessaires à l’exécution de l’application. Le contenu de ce lot ne doit pas être modifié, sauf pour supprimer les fichiers de ressources linguistiques. Pour plus
d’informations, consultez la rubrique « Réduction de la taille de la solution », page 82.
Le lot contient un dossier Contents, présentant des informations sur le lot et sur les dossiers Frameworks, MacOS et Resources. Le dossier
Resources renferme les dossiers de ressources linguistiques (*.lproj).
Le lot peut être ouvert à l’aide de la commande Afficher le contenu du progiciel.
Le dossier Extensions accompagne le lot Mac OS X et renferme le dossier Dictionnaires. Ce dossier contient les fichiers de dictionnaires
(*.mpr) de toutes les langues prises en charge ainsi que le fichier du dictionnaire orthographique de l’utilisateur (User.upr).
82 Guide de développement FileMaker Pro Advanced
Fichiers DLL des solutions d’exécution Windows
Durant le processus de liaison, les Utilitaires Developer génèrent un ensemble de DLL (Dynamic Link Libraries). Ces DLL sont placées dans le dossier de la solution avec l’application d’exécution et les fichiers liés. Elles font partie de la solution d’exécution et doivent être fournies avec cette dernière. Si certains des fichiers manquent ou sont endommagés, leur remplacement est indispensable.
DBConverter.dll
DBEngine.dll
DOMSupport.dll
FML10.dll
FMLayout.dll
FMOLE.dll
FMRSRC.dll
FMScript.dll
FMUserModel.dll
FMWrapper.dll
GdiPlus.dll
HBAM.dll
libeay32.dll
mfc71u.dll
MFCX.dll
msvcp71.dll
msvcr71.dll
NSViews.dll
omniDynamic4.dll
omniORB4.dll
omnithread.dll
PlatformSupport.dll
ProofReader.dll
ssleay32.dll
Support.dll
XalanDOM.dll
XalanExtensions.dll
XalanSourceTree.dll
XalanTransformer.dll
XCore.dll
XDraw.dll
Xerces.dll
XercesParserLiaison.dll
XFC.dll
XGrfx.dll
XMLEngine.dll
XMLSupport.dll
XPath.dll
XSLT.dll
XText.dll
Dossier Extensions des solutions Windows
Le dossier Extensions des solutions d’exécution Windows contient un dossier pour chaque langue prise en charge et un dossier de dictionnaires. Chaque dossier de ressources linguistiques contient le fichier DLL de la langue (FMRSRC.dll), un fichier contenant le texte de l’interface, des boîtes de dialogue et des messages d’erreur (FMStrs.dls), et un fichier contenant le code de langue
Windows (lang.dat).
Le dossier Extensions comprend également le dossier Dictionaries.
Ce dossier contient les fichiers de dictionnaires (*.mpr) de toutes les langues prises en charge ainsi que le fichier du dictionnaire orthographique de l’utilisateur (User.upr).
Choix de la méthode de diffusion
Après avoir organisé les fichiers qui composent votre solution, vous devez choisir leur mode d’installation par les utilisateurs.
Vous pouvez diffuser votre solution sur CD-ROM, via le réseau ou via Internet.
Réduction de la taille de la solution
Si vous envisagez de diffuser votre solution d’exécution via Internet, il peut être souhaitable d’en réduire la taille. La suppression des dictionnaires et des fichiers linguistiques associés aux langues que votre base de données ne prend pas en charge réduira la taille de l’application.
Pour réduire la taille de votre solution :
Windows
1. Ouvrez le dossier Extensions situé dans le dossier de la solution.
2. Supprimez les dossiers de ressources linguistiques des langues non prises en charge par votre solution.
Important
Ne supprimez pas le dossier de ressources English.
3. Ouvrez le dossier Dictionaries.
4. Supprimez les dictionnaires des langues non prises en charge par votre solution.
Mac OS X
1. Ouvrez le dossier Extensions situé dans le dossier de la solution.
2. Ouvrez le dossier Dictionaries.
3. Supprimez les dictionnaires des langues non prises en charge par votre solution.
4. Cliquez avec la touche Contrôle sur le lot d’application d’exécution et choisissez Afficher le contenu du progiciel.
5. Dans le dossier Contents, localisez le dossier Resources.
6. Supprimez les dossiers de ressources linguistiques (*.lproj) des langues non prises en charge par votre solution.
Utilisation d’un programme d’installation personnalisé
Vous pouvez utiliser un programme d’installation personnalisé pour préparer votre solution d’exécution à son installation par les utilisateurs. La configuration d’une application personnalisée permettant d’installer automatiquement votre solution d’exécution s’avère généralement plus complexe que l’utilisation d’un simple utilitaire de compression mais simplifie l’opération pour les utilisateurs.
Voici quelques exemples d’applications d’installation personnalisées :
1
MindVision Installer VISE (Windows et Mac OS X) de
MindVision, Inc. (www.mindvision.com)
1
InstallShield MultiPlatform (Windows et Mac OS X) d’InstallShield Software Corporation (www.installshield.com)
1
StuffIt InstallerMaker (Mac OS X) d’Allume Systems, Inc.
(www.allume.com)
Chapitre 8
|
Diffusion des solutions d’exécution 83
Utilisation d’un utilitaire de compression
Si votre solution d’exécution n’est pas complexe et que vous faites confiance aux compétences techniques de vos utilisateurs, vous pouvez envisager l’utilisation d’un utilitaire de compression plutôt que celle d’un programme d’installation personnalisé. Vous pouvez par exemple, utiliser les solutions suivantes :
1
WinZip pour Windows (Windows 2000, XP) de WinZip
Computing, Inc. (www.winzip.com)
1
StuffIt Deluxe (Windows et Mac OS X) d’Aladdin Systems
(www.allume.com)
Partage de solutions en réseau
Les utilisateurs ne peuvent pas partager votre solution via un réseau, sauf s’ils accèdent aux fichiers en utilisant l’application FileMaker Pro ou FileMaker Pro Advanced installée sur leur ordinateur. Pour autoriser ou modifier l’accès au fichier via le réseau, vous devez disposer d’un mot de passe principal. Pour des performances optimales, vous pouvez héberger les fichiers de la solution à l’aide de FileMaker Server.
Pour plus d’informations sur FileMaker Server, sur les produits
FileMaker Pro et sur la politique de vente de licences groupées, allez sur le site Web de FileMaker (www.filemaker.fr).
Configuration utilisateur requise
Afin de faire fonctionner votre solution d’exécution, vos utilisateurs doivent disposer de la configuration minimale matérielle et logicielle requise par FileMaker Pro Advanced. Consultez le Guide d’installation
pour FileMaker Pro et FileMaker Pro Advanced. En outre, vous devez leur fournir des instructions d’installation, de démarrage et de récupération des fichiers endommagés.
84 Guide de développement FileMaker Pro Advanced
Documentation des procédures d’installation
Vous devez fournir aux utilisateurs des instructions sur les modalités d’installation de votre solution d’exécution. Voici une liste des
éléments devant figurer dans cette documentation :
1
Instructions écrites sur les modalités de copie ou d’installation de la solution sur le disque dur de l’utilisateur.
1
Logiciel et instructions permettant de décompresser les fichiers de la solution.
1
Informations sur les configurations matérielles et logicielles minimales requises.
Pour plus de détails sur les informations à fournir avec votre solution
d’exécution, reportez-vous à la rubrique « Documentation destinée aux utilisateurs », page 85.
Démarrage d’une solution d’exécution
Après exécution du programme d’installation de votre application, les fichiers sont installés sur le disque dur de l’utilisateur. L’extension
à trois caractères des fichiers de la solution est enregistrée dans le système d’exploitation (Windows) ou dans les préférences du système
(Mac OS X). Cet enregistrement permet au système d’exploitation de localiser et de lancer la solution d’exécution lorsque l’utilisateur double-clique sur les fichiers principaux ou secondaires de la solution.
Si l’utilisateur double-clique sur le fichier principal ou sur un fichier auxiliaire avant l’enregistrement de l’extension, le système ne trouve pas l’application d’exécution.
Icône de l’application d’exécution
Double-cliquez pour démarrer
Icône du fichier principal
Important
Pour lancer la solution, les utilisateurs doivent doublecliquer sur l’icône de l’application d’exécution et non sur celle du fichier principal. S’il existe d’autres copies de l’application d’exécution sur le disque dur, un double-clic sur l’icône du fichier principal ou d’un fichier auxiliaire risque de provoquer des erreurs. Dans ce cas (s’il existe plusieurs solutions utilisant la même extension à trois caractères), la dernière application d’exécution installée est ouverte et il est possible qu’elle ne corresponde pas à votre fichier principal.
Chaque fois qu’une application d’exécution est ouverte, elle recherche le fichier principal qui lui est associé. Si elle ne le trouve pas, le système demande à l’utilisateur de le localiser.
Vous devez informer les utilisateurs qu’ils ne doivent pas renommer le fichier principal, ni les fichiers auxiliaires de la solution car ces opérations risquent d’empêcher le bon fonctionnement des liens et des scripts externes de la solution.
Remarque
Lorsque vous modifiez votre solution, vous devez vous assurer que les utilisateurs pourront importer leurs données dans la nouvelle version. Vous pouvez, par exemple, disposer un bouton et concevoir un script simplifiant l’importation des données dans la nouvelle solution. Pour plus d’informations, reportez-vous à la
rubrique « Importation des données dans des solutions d’exécution mises à jour », page 79.
Récupération des fichiers endommagés
Les pannes d’alimentation, les problèmes matériels et d’autres facteurs peuvent endommager un fichier FileMaker Pro. Si votre solution est endommagée, les utilisateurs devront remplacer les fichiers endommagés. Lorsque l’application d’exécution découvre un tel fichier, une boîte de dialogue en informe l’utilisateur et lui suggère de contacter le développeur. Même si cette boîte de dialogue ne s’affiche pas, des fichiers peuvent être endommagés et entraîner un comportement instable.
Si vous connaissez le fichier endommagé et que l’application
FileMaker Pro ou FileMaker Pro Advanced est installée sur votre ordinateur, la commande Récupérer vous permet de le récupérer.
Toutefois, si votre utilisateur ne dispose que de l’application d’exécution, la commande Récupérer ne s’affiche pas dans le menu Fichier de l’application.
Pour récupérer un fichier endommagé :
1
Sous Windows, appuyez sur Ctrl+Maj tout en effectuant un double-clic sur l’icône de l’application d’exécution. Maintenez les touches enfoncées jusqu’à ce que la boîte de dialogue de récupération de fichier apparaisse.
1
Sur les systèmes Mac OS, appuyez sur Option+
3 tout en effectuant un double-clic sur l’icône de l’application d’exécution.
Maintenez les touches enfoncées jusqu’à ce que la boîte de dialogue de récupération de fichier apparaisse.
Au cours de la procédure de récupération, l’application d’exécution :
1
génère un nouveau fichier ;
1
renomme le fichier endommagé en ajoutant le terme Ancien à son nom (par exemple, Annuaire devient Annuaire Ancien) ;
1
donne au fichier réparé le nom d’origine.
Si les utilisateurs constatent un comportement inhabituel des fichiers récupérés, ils doivent revenir à la copie de sauvegarde immédiatement antérieure à la modification des fichiers (ou vous contacter pour obtenir des informations).
Dans la documentation, vous devez indiquer aux utilisateurs comment procéder après avoir récupéré un fichier. Ils doivent :
1. Récupérer le fichier endommagé selon la procédure précédente pour le type d’ordinateur utilisé.
2. Ouvrir le fichier récupéré dans la solution d’exécution.
3. Choisir le menu Fichier > Enregistrer une copie.
Chapitre 8
|
Diffusion des solutions d’exécution 85
4. Dans la boîte de dialogue, choisissez Copie compactée (plus petite) dans la liste déroulante Enregistrer sous (Windows) ou
Type (Mac OS X), nommez le fichier et cliquez sur Enregistrer.
Le fichier compacté doit avoir le même nom que le fichier d’origine.
5. Faites une copie de la base de données d’origine et importez les données du fichier récupéré dans cette copie.
Documentation destinée aux utilisateurs
Qu’il s’agisse d’une base de données à ouvrir dans FileMaker Pro,
FileMaker Pro Advanced ou une solution d’exécution autonome, il est préférable d’accompagner votre solution d’une documentation.
Divers moyens vous permettent de générer une documentation pour votre solution, y compris un manuel imprimé, un système d’Aide en ligne ou un écran A propos de accessible depuis tous les modèles de l’application.
Vous pouvez créer des modèles personnalisés A propos de et
Aide présentant votre solution, son utilisation et des liens vers des informations complémentaires. Utilisez ensuite la fonction de menus personnalisés pour lier des scripts aux commandes de menu qui ouvriront ces modèles.
Remarque
Les systèmes d’aide en ligne de FileMaker Pro et FileMaker Pro Advanced ne sont pas disponibles dans les applications d’exécution. Néanmoins, l’aide de la barre d’état
(Windows) et les balises d’aide (Mac OS X) restent disponibles.
Création d’un modèle A propos de
Pour les solutions d’exécution, le contrat de licence FileMaker
Pro Advanced précise que vous devez créer un modèle A propos de indiquant aux utilisateurs les modalités d’accès à l’assistance technique. FileMaker, Inc. utilise également le modèle A propos de pour différencier les bases de données créées par des développeurs utilisant FileMaker Pro Advanced de celles des utilisateurs de
FileMaker Pro.
86 Guide de développement FileMaker Pro Advanced
Pour plus d’informations sur les mentions devant figurer dans le modèle A propos de des solutions d’exécution, reportez-vous à
la rubrique « Vos responsabilités de développeur », page 88.
Exemple d’un modèle A propos de
Pour créer un modèle A propos de :
1. Choisissez le menu Affichage > Mode Modèle.
2. Choisissez le menu Modèles > Nouveau modèle/rapport.
3. Dans la zone Nom, entrez
A propos de <votre solution>
.
Remarque
Pour les solutions d’exécution, les mots A propos de doivent figurer dans le nom du modèle. Vous devez également inclure certaines informations particulières dans le modèle. Reportez-vous
à la rubrique « Vos responsabilités de développeur », page 88.
4. Sélectionnez Modèle vierge.
5. Cliquez sur Terminer.
6. Incluez votre logo, la présentation de votre société et d’autres graphiques si nécessaire.
7. Ajoutez un texte précisant aux utilisateurs que les fichiers de la solution sont protégés par des mots de passe ou que les privilèges
Accès intégral ont été supprimés.
Pour plus de détails sur la formulation exacte des contraintes légales,
reportez-vous à la rubrique « Vos responsabilités de développeur », page 88.
8. Créez un bouton qui permettra aux utilisateurs de revenir au modèle du fichier principal.
9. Dans le menu Scripts, sélectionnez > ScriptMaker et créez un script destiné au modèle A propos de.
1
Vous devez inclure le terme A propos de dans le nom du script.
10. Utilisez la fonction Menus personnalisés pour créer une commande de menu qui affiche le modèle A propos de.
Pour afficher le modèle A propos de au démarrage de l’application d’exécution :
1. Ouvrez le fichier principal de la solution.
2. Choisissez Fichier > Options de fichier > Ouvrir/Fermer.
3. Sélectionnez Activer le modèle, puis le modèle A propos de dans la liste déroulante.
Création d’un modèle d’Aide personnalisé
Créez un modèle d’Aide décrivant l’utilisation et la saisie de données dans votre solution. Dans le fichier principal de votre solution, créez alors un script permettant d’afficher ce système d’Aide. Pour que ce script soit disponible sous la forme d’une commande du menu Aide, servez-vous de la fonction Menus personnalisés. Pour que le menu Aide personnalisé s’affiche sous Mac OS, vous devez partir d’un menu vide. Reportez-vous
à la rubrique « Création et modification des menus personnalisés », page 27.
Exemple de solution en mode Borne de communication comportant un unique modèle d’Aide.
Exemple de solution d’exécution présentant une fenêtre d’Aide distincte
Chapitre 8
|
Diffusion des solutions d’exécution 87
Ajout d’une documentation papier
En complément d’un système d’aide en ligne, vous pouvez proposer une documentation imprimée expliquant brièvement comment installer votre solution et l’utiliser dans le cas où les utilisateurs ne pourraient pas ouvrir les fichiers de votre solution.
Voici d’autres éléments pouvant être ajoutés à la documentation imprimée :
1
modalités d’installation de votre solution ;
1
modalités d’installation des fichiers personnalisés ;
1
modalités de mise à jour des fichiers de la solution ;
1
modalités d’utilisation du système d’Aide ;
1
modalités de démarrage de l’application (reportez-vous à la
rubrique « Démarrage d’une solution d’exécution », page 84) ;
1
procédure à suivre lorsque des fichiers sont endommagés
(reportez-vous à la rubrique « Récupération des fichiers endommagés », page 84) ;
1
comment contacter l’assistance technique.
Vous pouvez également ajouter les recommandations suivantes :
1
Indiquez aux utilisateurs que s’ils renomment les fichiers de la solution (à l’exception de celui de l’application d’exécution elle-même), cela peut nuire à son bon fonctionnement.
1
Recommandez des sauvegardes régulières des données. Une partie de la procédure peut être automatisée en ajoutant des scripts réalisant des copies des fichiers. Pour plus d’informations, consultez l’Aide.
Important
Si les fichiers de votre solution d’exécution sont endommagés, veillez à ce que les utilisateurs disposent des coordonnées de votre assistance technique dans la documentation imprimée ou dans un fichier texte car ils ne pourront probablement pas accéder au modèle A propos de pour afficher vos coordonnées.
88 Guide de développement FileMaker Pro Advanced
Vos responsabilités de développeur
FileMaker a établi des procédures de réparation des fichiers. Si les clients respectent ces procédures, FileMaker peut leur fournir un fichier réparé.
Si vous distribuez les fichiers de bases de données avec des mots de passe ou si vous avez supprimé les privilèges d’accès intégral et ne souhaitez pas que FileMaker répare un fichier pour les clients qui demandent ce service, vous devez :
1. Indiquez par écrit à vos clients (tout en conservant une copie de cette note) que votre solution comporte des mots de passe ou des données que vous seul pouvez fournir.
2. Faire en sorte que chaque fichier de votre solution d’exécution contienne un modèle A propos de, accessible depuis tous les modèles de la base de données.
Reportez-vous à la rubrique « Création d’un modèle A propos de », page 85.
3. Faire débuter le nom du modèle par les mots A propos de.
4. Inclure les éléments suivants dans le modèle A propos de :
1
nom de la solution ;
1
nom et coordonnées de votre société ;
1
politique d’assistance (quand et comment les utilisateurs peuvent accéder au support technique).
5. Inclure l’avertissement suivant dans le modèle A propos de :
AVERTISSEMENT : Cette solution est protégée par au moins un mot de passe qui ne peut être fourni que par le développeur indiqué ci-dessus.
6. Si les privilèges d’accès intégral ont été supprimés définitivement de votre solution par l’activation de l’option Supprimer définitivement l’accès admin des fichiers des Utilitaires Developer, le modèle A propos de doit également contenir l’avertissement suivant :
AVERTISSEMENT : Ce fichier ne peut pas être personnalisé. Contactez le développeur mentionné ci-dessus pour obtenir des informations sur la personnalisation de cette solution.
La protection d’un fichier FileMaker via les comptes et autorisations d’accès ne doit pas être perçue comme une barrière absolue empêchant les clients d’accéder aux fichiers. FileMaker ne peut pas garantir qu’aucun client ne pourra identifier ou contourner le mot de passe à l’aide de solutions ou d’outils tiers. De ce fait, FileMaker vous conseille de ne pas compter uniquement sur ce mot de passe et de prendre toutes les mesures nécessaires pour vous protéger. Pour plus d’informations sur les comptes et privilèges, consultez l’Aide.
En cas de conflit avec un client, vous devrez résoudre ce problème directement avec lui. FileMaker n’est pas en mesure et ne tentera pas d’intervenir dans de tels conflits.
Test de votre solution avant et après sa création
Pour vérifier les fonctionnalités de votre solution, testez-la soigneusement avant et après sa personnalisation dans les
Utilitaires Developer.
Pour vous assurer de la qualité de votre solution personnalisée :
1
Vérifiez systématiquement toutes ses fonctions et options. Si votre solution doit être utilisée à la fois sur des systèmes Windows et Mac OS X, vous devez la tester sur chaque plate-forme.
1
Assurez-vous de ne pas utiliser de fonctions standard
FileMaker Pro qui seraient masquées ou désactivées dans la
1
Vérifiez le bon fonctionnement de tous les boutons et scripts. Cela est tout particulièrement important si votre solution doit être présentée en mode Borne de communication. Reportez-vous à la rubrique
« A propos du mode Borne de communication », page 19.
1
Vérifiez vos procédures d’installation et testez toutes les instructions données dans la documentation.
1
Vérifiez que vos modèles apparaissent parfaitement sur des moniteurs disposant de résolutions, de caractéristiques couleur et de dimensions différentes.
1
Testez votre solution d’exécution avec des données réelles. Ceci est tout particulièrement important lorsque les utilisateurs effectuent une mise à niveau et souhaitent importer leurs données dans la nouvelle version.
1
Assurez-vous de la présence de tous les fichiers auxiliaires et des DLL (Windows).
1
Présentez votre solution à des utilisateurs potentiels afin de découvrir d’éventuels problèmes d’interface.
1
Installez les fichiers de base de données de votre application sur un système totalement différent afin de vérifier si tous les fichiers associés au fichier principal peuvent être trouvés.
1
Si vous avez défini des mots de passe ou supprimé définitivement les privilèges d’accès intégral, testez tous les niveaux d’accès. Veillez
à ce que votre solution contienne un modèle A propos de indiquant aux utilisateurs le niveau d’accès dont ils disposent. Consultez les
rubriques « Création d’un modèle A propos de », page 85 et « Vos
responsabilités de développeur », page 88.
Chapitre 8
|
Diffusion des solutions d’exécution 89
Important
Vous devez conserver une version complète de tous les fichiers de la solution d’exécution (avant liaison), en particulier si vous avez supprimé définitivement les privilèges d’accès intégral.
Diffusion de mises à jour de solutions d’exécution
Si vous apportez des améliorations fonctionnelles au fichier principal lié à votre solution d’exécution, vous pouvez distribuer le fichier mis à jour à vos utilisateurs sans qu’il soit nécessaire d’effectuer une nouvelle liaison. Néanmoins, si vous modifiez le nom du fichier principal, vous devez tout de même effectuer cette opération, puis distribuer une nouvelle version de l’application d’exécution avec le fichier mis à jour.
Pour distribuer des fichiers auxiliaires nouveaux ou mis à jour pour votre solution d’exécution, vous devez commencer par les lier à l’aide de la clé de liaison initiale. Dans le cas d’un nouveau fichier auxiliaire nécessitant l’ajout de nouvelles références externes dans le fichier principal ou devant interagir avec d’autres fichiers, mettez à jour tous les fichiers modifiés.
Si vous avez oublié cette clé de liaison et que vous souhaitez modifier votre solution d’exécution ou lui ajouter des fichiers, vous devez effectuer à nouveau l’ensemble de la procédure de liaison avec une nouvelle clé, puis redistribuer toute la solution.
Pour distribuer un fichier principal mis à jour :
1. Ouvrez le fichier principal d’origine depuis la copie de votre solution d’exécution dans FileMaker Pro Advanced.
2. Effectuez les changements nécessaires.
90 Guide de développement FileMaker Pro Advanced
3. Eventuellement, créez un script d’importation pour que les utilisateurs puissent faire migrer leurs données dans le nouveau fichier principal.
4. Faites parvenir aux utilisateurs une copie du nouveau fichier principal accompagnée des instructions nécessaires pour remplacer l’ancien fichier principal du dossier de la solution d’exécution.
Pour distribuer un fichier auxiliaire nouveau ou mis à jour :
1. Dans FileMaker Pro Advanced, créez un fichier auxiliaire ou ouvrez le fichier d’origine (avant la procédure de liaison) et modifiez-le.
2. Eventuellement, créez un script d’importation pour que les utilisateurs puissent faire migrer leurs données dans le nouveau fichier.
3. Utilisez les Utilitaires Developer pour relier tous les fichiers de la solution d’exécution et y inclure le nouveau fichier auxiliaire.
Utilisez la même clé de liaison que pour le fichier principal.
Souvenez-vous que les clés de liaison respectent la casse des
4. Faites parvenir aux utilisateurs une copie du nouveau fichier auxiliaire, accompagnée des instructions nécessaires pour le placer dans le dossier de la solution d’exécution et remplacer la version antérieure si nécessaire.
Tant que la clé de liaison n’est pas modifiée, il n’est pas nécessaire de redistribuer l’application d’exécution, ni les autres fichiers de la solution.
Annexe A
Comparaison de la fonctionnalité de l’application d’exécution et de FileMaker Pro
Lorsque vous double-cliquez sur l’icône de l’application
FileMaker Pro, la boîte de dialogue Nouvelle base de données apparaît automatiquement et vous permet de choisir un fichier de base de données. Lorsque vous démarrez une application d’exécution
FileMaker Pro, le fichier principal de sa base de données s’ouvre automatiquement.
Parmi les autres différences majeures entre FileMaker Pro et les applications d’exécution, citons :
1
Dans les applications d’exécution, toutes les fonctionnalités de conception de base de données sont supprimées ou masquées.
Cela comprend les boîtes de dialogue Définir la base de données,
Définir les listes de valeurs, Définir les références externes et Définir les comptes et autorisations d’accès, ainsi que les commandes Mode
Modèle et ScriptMaker.
1
Les fonctions et les menus personnalisés créés à l’aide de
FileMaker Pro Advanced fonctionnent dans l’application d’exécution, mais les utilisateurs de cette application ne peuvent pas les modifier ni en créer de nouveaux.
1
D’autres commandes de menu ont été supprimées de l’application d’exécution.
Par exemple, vous ne pouvez pas utiliser l’application d’exécution pour créer, ouvrir ou fermer une base de données. (Les fichiers de base de données regroupés de l’application doivent comporter un bouton ou un script personnalisé pour fermer ou ouvrir d’autres fichiers.
La fenêtre d’une application d’exécution ne présente aucune commande de fermeture.)
1
Il est impossible d’accéder à l’Aide de FileMaker Pro depuis une application d’exécution. Toutefois, les menus Aide et Runtime peuvent comporter des commandes de menu A propos de et
Aide personnalisées.
1
Certains outils ne figurent pas sur la barre d’outils de l’application d’exécution en mode Utilisation, Recherche et Prévisualisation.
1
Les modules Externes peuvent être activés dans la boîte de dialogue Préférences.
1
Bien que le filtre de données XML apparaisse comme une option pour l’action de script Convertir fichier, vous ne pouvez pas convertir les fichiers XML en utilisant cette action de script dans une application d’exécution.
1
Pour partager des fichiers FileMaker Pro, diffuser des bases de données sur le Web ou communiquer à l’aide d’une applet Java, il est nécessaire de disposer de FileMaker Pro ou de
FileMaker Pro Advanced. Vous pouvez néanmoins utiliser une version compatible de FileMaker Server pour héberger les fichiers des solutions.
1
Les Apple Event sont acceptés mais l’automatisation sous OLE est impossible pour les applications d’exécution fonctionnant sous
Windows.
92 Guide de développement FileMaker Pro Advanced
Préférences de l’application et du document
Dans les applications d’exécution, les options suivantes ne sont pas disponibles dans l’onglet Général de la boîte de dialogue Préférences :
1
Case à cocher Modèles sur l’écran Nouvelle base de données
1
Case à cocher Liste des fichiers récents
Dans l’application d’exécution, l’onglet Modèle est remplacé par l’onglet Couleur dans la boîte de dialogue Préférences.
Préférences générales d’une application d’exécution
(Mac OS X)
Préférences générales d’une application d’exécution
(Windows)
Dans les applications d’exécution, la boîte de dialogue Options de fichier ne comporte pas d’onglets Ouvrir/Fermer et Texte, mais uniquement l’onglet Orthographe, comme illustré ci-dessous.
Boîte de dialogue
Options de fichier de FileMaker Pro
Annexe A
|
Comparaison de la fonctionnalité de l’application d’exécution et de FileMaker Pro 93
Boîte de dialogue
Options de fichier d’une application d’exécution
Barres d’outils de FileMaker Pro
Comparaison des barres d’outils
Les outils Nouvelle base de données et Ouvrir de la barre d’outils standard (en mode Utilisation, Recherche et Prévisualisation) ne sont pas disponibles dans les applications d’exécution.
Le bouton Aide de la barre d’outils standard des applications d’exécution est grisé, sauf lorsqu’un script d’Aide personnalisé a été défini.
La barre d’outils Texte est identique dans les applications d’exécution et dans FileMaker Pro.
Barres d’outils d’une application d’exécution
Comparaison des commandes de menu
Les tableaux suivants présentent les commandes de menu disponibles dans FileMaker Pro (Pro) et l’application d’exécution (RT).
Commande du menu Fichier
Nouvelle base de données
Ouvrir
Ouvrir à distance
Ouvrir fichiers récents
Fermer
Définir
Options de fichier
Modifier le mot de passe
Configuration de l’impression
Mise en page
Imprimer
Importer des enregistrements
Exporter des enregistrements
1
1
1
Windows
RT
1
1
1
1
1
1
Pro
1
1
1
1
1
1
1
1
1
1
1
1
1
Mac OS X
RT
1
1
1
1
1
Pro
1
1
1
1
1
1
1
1
1
94 Guide de développement FileMaker Pro Advanced
Commande du menu Fichier
Enregistrer/Envoyer en
Envoyer Courrier
Enregistrer une copie
Récupérer
Quitter
1
Appuyez sur Ctrl+Maj
2
Appuyez sur Option+
3
Windows
Pro
1
1
1
1
1
RT
1
1
1
1
1
Mac OS X
Pro
1
1
1
1
RT
1
1
1
2
Remarque
Vous pouvez ajouter des éléments de menu qui imitent les commandes de menu Ouvrir, Fermer et Récupérer dans une application d’exécution utilisant les menus personnalisés en fonction d’un script ou d’une action de script. Pour plus d’informations, consultez la
rubrique « Personnalisation des menus », page 25.
Commande du menu Edition
Annuler
Couper
Copier
Coller
Collage spécial
Effacer
Tout sélectionner
Rechercher et remplacer
Orthographe
Objet
Windows
Pro
1
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
1
Mac OS X
Pro
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
1
1
1
Commande du menu Edition
Exporter le contenu de rubrique
Partage
Préférences
Pro
1
1
1
Windows
RT
1
1
Commande du menu
Affichage
Mode Utilisation
Mode Recherche
Mode Modèle
Mode Prévisualisation
Activer le Modèle
Afficher sous forme de formulaire
Afficher sous forme de liste
Afficher sous forme de tableau
Barres d’outils
Barre d’état
Zone d’état
Réglette de texte
Agrandir
Réduire
Pro
1
1
1
1
1
1
1
1
1
1
1
1
1
1
Windows
RT
1
1
1
1
1
1
1
1
1
1
1
1
1
Mac OS X
Pro
1
RT
1
1
1
1
1
Pro
1
1
1
1
1
1
1
1
1
Mac OS X
RT
1
1
1
1
1
1
1
1
1
1
1
1
Annexe A
|
Comparaison de la fonctionnalité de l’application d’exécution et de FileMaker Pro 95
Commande du menu
Insertion
Image
QuickTime
Son
Fichier
Objet
Date du jour
Heure actuelle
Nom de l’utilisateur
Index
Du dernier enregistrement consulté
Windows
Commande du menu Format Pro
Police
Corps
Style
1
1
1
Alignement
Interligne
Couleur
Texte
1
1
1
1
RT
1
1
1
1
1
1
1
Windows
Pro
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
Mac OS X
Pro
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
Mac OS X
Pro
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
Commande du menu
Enregistrements
Nouvel enregistrement
Dupliquer l’enregistrement
Supprimer l’enregistrement
Supprimer tous les enregistrements
Afficher l’enregistrement
Afifcher tous les enregistrements
Afficher enregistrements trouvés uniquement
Ignorer l’enregistrement
Ignorer les enregistrements
Modifier la requête
Trier les enregistrements
Annuler tri
Remplacer
Mettre à jour le contenu de la rubrique
Rétablir l’enregistrement
Windows
1
1
1
1
1
1
1
1
1
1
1
Pro
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
Mac OS X
1
1
1
1
1
1
1
1
1
1
1
Pro
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
96 Guide de développement FileMaker Pro Advanced
Commande du menu
Requêtes
(Mode Recherche)
Nouvelle requête
Dupliquer la requête
Supprimer la requête
Afficher requête
Afficher tous les enreg
Exécuter la requête
Restreindre l’ensemble trouvé
Développer l’ensemble trouvé
Rétablir la requête
Windows
Pro
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
Mac OS X
Pro
1
1
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
Commande du menu Scripts
ScriptMaker
<Noms des scripts>
Windows
Pro
1
1
RT
1
Mac OS X
Pro
1
1
RT
1
Windows
Commande du menu Fenêtre Pro
Nouvelle fenêtre
1
Afficher la fenêtre
Masquer la fenêtre
Réduire la fenêtre
Juxtaposition horizontale
Juxtaposition verticale
Superposer
Ranger les icônes
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
1
Premier plan
<Nom des fichiers ouverts>
1 1
Mac OS X
Pro
1
1
1
1
1
1
1
RT
1
1
1
1
1
1
1
1
1
1
1
Commande du menu Aide
Aide FileMaker Pro
Raccourcis clavier
FileMaker sur le Web
Téléchargements et mises à jour
Enregistrer maintenant
A propos de FileMaker Pro
A propos de FileMaker Pro
Runtime (apparaît si aucun script personnalisé A propos de n’est spécifié)
Windows
Pro
1
1
1
1
1
1
RT
1
Mac OS X
Pro
1
1
1
1
1
RT
1
1
Commande du menu Aide
A propos de la <solution d’exécution >(apparaît si le script personnalisé A propos de est spécifié)
<Nom du script de l’Aide de la solution d’exécution> (apparaît si le script personnalisé d’aide est spécifié)
Windows
Pro RT
1
Voir le tableau des commandes du menu Application
1
1
Commande du menu Application
A propos de FileMaker Pro
A propos de FileMaker Pro Runtime (apparaît si aucun script personnalisé A propos de n’est spécifié)
A propos de la <solution d’exécution >(apparaît si le script personnalisé A propos de est spécifié)
Partage
Préférences
Services
Masquer FileMaker Pro
Masquer la <solution d’exécution>
Masquer les autres
Tout afficher
Quitter FileMaker Pro
Quitter la <solution d’exécution>
1
1
1
1
Mac OS X
(uniquement)
RT Pro
1
1
1
1
1
1
1
1
1
1
1
1
Annexe A
|
Comparaison de la fonctionnalité de l’application d’exécution et de FileMaker Pro 97
Mac OS X
Pro RT
1
1
Actions de script ignorées
Certaines fonctionnalités ayant été supprimées de l’application d’exécution, les actions de scripts suivantes sont ignorées :
1
Ouvrir Définir base de données
1
Ouvrir Listes de valeurs
1
Ouvrir Définir réf. fichier
1
Ouvrir Partage
1
Ouvrir ScriptMaker
1
Ouvrir Aide (exécute le script d’Aide personnalisé spécifié lors de la liaison)
1
Multi-utilisateur
1
Nouveau fichier
1
Ouvrir Options fichier (partiellement disponible ; l’onglet
Orthographe s’ouvrira)
1
Ouvrir à distance
1
Exécuter SQL
1
Sauvegarder les enregistrements sous forme de fichier PDF
1
Exécuter script (si le fichier spécifié n’a pas été lié à l’application d’exécution)
1
Ouvrir fichier (si le fichier spécifié n’a pas été lié à l’application d’exécution)
98 Guide de développement FileMaker Pro Advanced
Préférences ou paramètres de registre mémorisés
Paramètres de registre Windows
FileMaker Pro stocke ses paramètres de registre dans :
HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\8.0
FileMaker Pro Advanced stocke ses paramètres de registre dans :
HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\8.0A
L’application d’exécution stocke ses paramètres de registre dans :
HKEY_CURRENT_USER\Software\FileMaker\<solution name>\8.0
Remarque
L’extension du nom des fichiers de base de données d’exécution est enregistrée dans HKEY_CLASSES_ROOT.
Préférences Mac OS X
FileMaker Pro stocke ses préférences dans le fichier de Préférences
FileMaker Pro 8.0, situé dans le dossier Préférences de FileMaker.
FileMaker Pro Advanced stocke ses préférences dans le fichier de
Préférences FileMaker Pro 8.0A, situé dans le dossier Préférences de
FileMaker. L’application d’exécution stocke ses préférences dans le fichier de Préférences <Nom de la solution> 8, situé dans le dossier
Préférences de FileMaker.
Index
A
Action de script Afficher/masquer zone d’état 22
Action de script Agrandir/Réduire
Action de script Ajuster fenêtre
Action de script Autoriser annulation utilisateur
Action de script Déplacer/redimensionner fenêtre
Action de script Exécuter script
Action de script Exécuter SQL
Action de script Faire défiler fenêtre
Action de script Imprimer
Action de script Mode Prévisualisation
Action de script Mode Recherche
Action de script Mode Utilisation
Action de script Multi-utilisateur
Action de script Nouveau fichier
Action de script Ouvrir à distance
Action de script Ouvrir Aide
Action de script Ouvrir Définir la base de données
Action de script Ouvrir Fichier
Action de script Ouvrir Listes de valeurs
Action de script Ouvrir Options fichier 97
Action de script Ouvrir Partage
Action de script Ouvrir Préférences
Action de script Ouvrir ScriptMaker
Action de script Trier enregistrements 22
Action Suspendre/reprendre script
Actions de script, désactivation
Aide
bouton de la barre d’outils des applications d’exécution
commandes disponibles dans les applications d’exécution
menus personnalisés
Aide de la barre d’état (Windows)
Apple Computer, Inc.
Apple Event dans les applications d’exécution
Apple Xcode
Applications d’exécution
activation de modules
barres d’outils disponibles
par rapport à FileMaker Pro
paramètres de registre enregistrés sous
Windows
98 préférences Mac OS X enregistrées 98
Assistance technique pour FileMaker Pro Advanced
10 pour les solutions d’exécution
Assistant Nouveau modèle/rapport
Attribution d’un nom aux solutions
Attribution d’un nouveau nom fichiers
Automatisation sous OLE dans les applications
Autorisations d’accès étendues
Autorisations d’accès intégrales fonctions personnalisées
rapports sur la structure des bases de données
suppression des fichiers
B
Barre d’outils
Base de connaissances et d’informations
Base de données, schémas
Base de données, statistiques
Base de données, structure
Boutons, création dynamique
C
Caractères ASCII
Chemins d’accès, fichier
Clé de liaison
définition pour les solutions d’exécution
mise à jour des solutions d’exécution
Clé, liaison
Code d’installation. Voir Numéro de licence
Codes créateur
Commande Afficher le contenu du progiciel
(Mac OS X)
Commandes de menu disponibles dans les applications d’exécution
personnalisation
suppression des accès aux
Commandes du menu Affichage disponibles dans les applications d’exécution
Commandes du menu Application disponibles dans les applications d’exécution
Commandes du menu Edition disponibles dans les
Commandes du menu Enregistrements disponibles dans les applications d’exécution
Commandes du menu Fenêtre disponibles dans les
Commandes du menu Fichier disponibles dans les
Commandes du menu Format disponibles dans les
Commandes du menu Insertion disponibles dans les applications d’exécution
Commandes du menu Requêtes disponibles dans les applications d’exécution
Commandes du Mode Modèle indisponibles dans
FileMaker Pro Advanced
indisponibles dans les applications d’exécution
100 Guide de développement FileMaker Pro Advanced
Commandes ScriptMaker indisponibles dans
FileMaker Pro Advanced
indisponibles dans les applications
Commandes, menu disponibles dans les applications
personnalisation
suppression des accès aux
Compression de fichiers
Comptes admin suppression des privilèges d’accès intégral
Comptes et autorisations d’accès
Configuration minimale requise, solutions
Configuration requise pour les modèles A propos de
Conseils à l’écran Voir Infobulles
Contrat de licence
Conversion de fichiers issus de versions
Copie actions de script
tables
Couleurs Web
D
DDR Voir Rapports sur la structure des bases de
données
Défragmentation de fichiers
Délai, écran personnalisé
Dépannage calculs
menus personnalisés
rubriques
Script Debugger
utilisation de rapport sur la structure des bases de données
variables
Désactivation des actions de script
Dictionnaire orthographique utilisateur
Dictionnaires
suppression
Diffusion de solutions d’exécution
distribution des mises à jour
méthodes
Documentation installation des applications d’exécution
menus personnalisés
modules de fonctions externes 60
rapports sur la structure des bases de données
solutions
Documentation électronique
Dossier Contents (Mac OS X) 81
Dossier de projet
et les Utilitaires Developer 72
Dossier Dictionaries
localisation des modules externes
Dossiers de ressources linguistiques, applications
E
Ecran personnalisé dans les solutions d’exécution
Ecran tactile, mode Borne de communication
Eléments de l’interface, émulation 22
Eléments de thèmes de modèle 39
Eléments XML à une ligne des thèmes de modèle
Eléments XML multilignes des thèmes de modèle
Emulation des éléments de l’interface
Enregistrement
FileMaker Pro Advanced
identifiants de modules
Enregistrement des paramètres des Utilitaires
Entité caractère apostrophe (')
Entité caractère Et commercial (&)
Entité caractère guillemet (")
Entité caractère inférieur à (<)
Entité caractère supérieur à (>)
Extensible Markup Language (XML). Voir XML
Extension de fichier fmplugin
Extension de fichier sav
Extensions de fichier applications d’exécution
conflits de registre (Windows)
des fichiers de bases de données
enregistrement effectué par les applications
modules
Extensions, nom de fichier. Voir Extensions de
fichier
F
Fichier de paramètres
connexion des fichiers auxiliaires
mise à jour
mode Borne de communication
problèmes avec le double-clic
Fichiers
attribution d’un nouveau nom 71
compression
fermeture en mode Borne de communication
optimisation
récupération des fichiers endommagés
spécification pour les Utilitaires
Fichiers auxiliaires mise à jour
ouverture
problèmes avec le double-clic
Fichiers d’exécution endommagés,
FileMaker Pro Advanced contrat de licence
mise à niveau à partir de versions
FileMaker Pro, menus disponibles
FileMaker Server
FileMaker Developer Voir FileMaker Pro
Advanced
FileMaker Pro Advanced
FileMaker Pro Advanced documentation
présentation générale du produit
Fonction Do_PluginInit
Fonction Maintenance des fichiers 66
option Compacter le fichier
66 option Optimiser le fichier
Fonctions externes
personnalisées
Fonctions externes
|
Index 101
Fonctions personnalisées
attribution d’un nom 17 création 17
désactivation de l’affichage
modification 18 suppression 18
Format HTML des rapports sur la structure des bases de données
I
Icônes pour les solutions d’exécution
Importation enregistrements
tables
Impression à partir d’applications d’exécution
Installation des menus personnalisés
InstallShield
Instructions d’installation
pour les utilisateurs de solutions
Interaction des utilisateurs avec la solution
Internet applications d’exécution sur
bases de données sur
J
JDBC, utilisation avec les produits FileMaker
Jeu de menus définition
Jeux de menus
installation
spécification par défaut
Journal d’erreurs
L
74 solutions multiplates-formes 74, 78
Licence pour plusieurs ordinateurs
Logo, ajout dans une solution d’exécution
Lot, application d’exécution (Mac OS X)
M
Mac OS X
application d’exécution, lot 81
préférences enregistrées
Mac OS X codes créateur
Menu Scripts commandes disponibles dans les applications d’exécution
Menus personnalisés
à propos du menu des solutions d’exécution
barres d’outils
documentation
exemple
impact sur les fonctions
installation
menu Aide des solutions d’exécution
menu Script des solutions d’exécution
test
touches d’accès
Message d’inactivité envoyé aux modules
Message d’initialisation envoyé aux modules 57
Message de fermeture envoyé aux modules
Message de fonction externe envoyé aux modules
Message de préférence envoyé aux modules
Message GetString envoyé aux modules
102 Guide de développement FileMaker Pro Advanced
Messages envoyés aux modules de fonctions
journal d’erreurs
Microsoft Visual Studio .NET
Microsoft Windows composants de l’application d’exécution
paramètres de registre mémorisés
Mise à jour des applications d’exécution
Mode Borne de communication
activation
centrage des fenêtres de base de données
fermeture de fichiers
préparation de bases de données
Mode Prévisualisation action de script
dans les applications d’exécution
Mode Recherche, dans les applications
Mode Utilisation, dans les applications
Modèle A propos de
contenu requis pour
Modèle Aide des solutions d’exécution
Modification des modules externes enregistrés
Modules configuration
conflits d’ID de ressources (Mac OS X)
dans les applications d’exécution
enregistrement auprès d’Apple
enregistrement auprès de FileMaker
identifiants
installation
installation de modules de publication Web instantanée
modification de l’enregistrement 60
préfixe des noms des fonctions
préparation
projet exemple
syntaxe requise pour la chaîne d’option
Modules de fonctions externes
activation
dans les applications d’exécution
documentation
identifiant de module
messages envoyés par FileMaker Pro
Mots de passe
avertissement requis dans le modèle
A propos de
N
Navigation en mode Borne de communication 19
Numéro de licence
O
Objets du modèle, infobulles
ODBC, utilisation avec les produits FileMaker
Options de fichier disponibles dans l’application d’exécution
Outil Nouvelle base de données
Outil Ouvrir
Ouverture applications d’exécution dans FileMaker Pro et
FileMaker Pro Advanced
fichiers d’applications d’exécution
P
Palette de motifs
Partie en-tête du modèle
Partie en-tête initial du modèle
Partie pied de page du modèle
Partie pied de page initial du modèle
Partie récapitulative d’en-tête du modèle 41
Partie récapitulative de pied de page du modèle
Partie sous-récapitulatif d’en-tête du modèle
Parties d’un modèle
Performances, amélioration
Personnalisation des éléments de menu
Plusieurs fichiers de base de données
Plusieurs tables par fichier de base de données
Points d’arrêt, script
Polices
indisponibles sur le système de l’utilisateur
Préférences disponibles dans l’application
Programmes d’installation des applications
R
Raccourcis définition
personnalisation
Script Debugger
Raccourcis clavier Voir raccourcis
Rapports sur la structure des bases de données
Récupération des fichiers d’exécution endommagés
Registre conflits liés aux extensions
paramètres enregistrés
Restauration des icônes de documents
(Windows)
Rubriques, surveillance
S
Sauvegarde des fichiers d’origine
Sauvegarder les enregistrements sous forme de fichier PDF
Schémas de bases de données
Script Debugger
boutons et commandes
droits d’accès nécessaires pour l’exécution
61 exécution de scripts en mode débogage
ignorer des actions
Scripts actions ignorées par les applications d’exécution
affectation à des commandes A propos de et
Aide
débogage
émulation des commandes de menu et des contrôles de fenêtre
navigation en mode Borne de communication
ouverture des applications d’exécution 73
pour modifier les jeux de menus
Scripts de démarrage pour un affichage personnalisé
Séparateurs de menu
Séparateurs, élément de menu
|
Index 103
Solutions d’exécution
configuration requise pour modèle A propos
conversion
DLL obligatoires (Windows)
documentation de l’installation
importation des enregistrements
mise à jour
mise à niveau
préparation des fichiers
récupération des fichiers endommagés
taille
vérification orthographique
Solutions. Voir Solutions d’exécution
Sous-menus
Sous-récapitulatif de pied de page du modèle
Statistiques de base de données
Structure de base de données, nouvelle
Structure des dossiers
Support clientèle pour FileMaker Pro Advanced
pour les solutions d’exécution
Syntaxe de la chaîne d’options des modules
T
Tables, base de données exclusion du Rapport sur la structure des bases de données
plusieurs par fichier
Taille des fichiers de bases de données
Test
solutions
Thèmes de modèle attributs des éléments à ligne unique
éléments à une ligne
éléments de parties de modèle 41
éléments multilignes
éléments texte du modèle
recherche des erreurs
valeurs d’attributs
valeurs des couleurs
valeurs des motifs
valeurs par défaut
Touches d’accès, menus personnalisés
U
Utilisateurs de navigateurs Web
Utilitaires de compression des applications d’exécution
Utilitaires Developer
V
Valeurs des couleurs des thèmes de modèle
Valeurs hexadécimales des thèmes de modèle 47
Variables, surveillance
Vérification orthographique des solutions d’exécution
Visualiseur de données
W
WinZip pour Windows
104 Guide de développement FileMaker Pro Advanced
X
XML documents pour les thèmes de modèle
éditeurs
entités caractère
format des rapports sur la structure des bases de données
instructions de traitement d’un document
XML
spécifications XML 1.0
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project