▼
Scroll to page 2
of
54
FileMaker Pro 11 Advanced ® Guide de développement © 2007-2010 FileMaker, Inc. Tous droits réservés. FileMaker, Inc. 5201 Patrick Henry Drive Santa Clara, California 95054 FileMaker est une marque de FileMaker, Inc., déposée aux Etats-Unis et dans d'autres pays. Le logo en forme de dossier est une marque de FileMaker, Inc. Toutes les autres marques sont la propriété de leurs détenteurs respectifs. La documentation de FileMaker est protégée par la législation sur les droits d’auteur. Vous n'êtes pas autorisé à créer des copies supplémentaires ni à 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, sociétés, adresses email et URL 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 les documents Remerciements fournis avec ce logiciel. Les produits tiers et les adresses URL sont mentionnés à titre indicatif uniquement, et non pas à titre de recommandation. FileMaker, Inc. se dégage de toute responsabilité concernant les performances de ces produits. Pour plus de détails, consultez notre site Web à l'adresse http://www.filemaker.com. Edition : 01 Table des matières Chapitre 1 Présentation de FileMaker Pro Advanced A propos de ce guide Utilisation de la documentation de FileMaker Pro Advanced Où trouver la documentation PDF Respect du contrat de licence pour les solutions d'exécution Vos responsabilités de développeur 5 5 6 6 7 Chapitre 2 Création de solutions de bases de données Utilisation des Utilitaires Developer A propos de la création de solutions d’exécution Conversion et mise à jour des solutions précédentes Liaison de la solution Démarrage d'une solution d'exécution Distribution des solutions d'exécution Organisation des composants de la solution Choix de la méthode de diffusion Tester la solution avant et après sa création Diffusion de mises à jour de solutions d'exécution Création de solutions en mode Borne de communication 9 11 11 12 13 13 14 14 16 17 18 Chapitre 3 Personnalisation des solutions de base de données Copie ou importation de schémas de rubriques et de tables Création de fonctions personnalisées A propos des menus personnalisés Exemple de menu personnalisé Création de menus personnalisés Création d’éléments de menu personnalisés Création de jeux de menus personnalisés Création de thèmes de modèle personnalisés Conditions requises pour les fichiers de thème 21 22 22 23 24 25 26 27 29 Chapitre 4 Débogage et analyse de fichiers Débogage de scripts Désactivation des actions du script Utilisation du Visualiseur de données Utilisation du Rapport sur la structure des bases de données 31 33 33 35 4 Guide de développement FileMaker Pro Advanced Chapitre 5 Développement de modules FileMaker tiers Accessibilité des modules pour les utilisateurs Installation de modules Activation des modules Configuration des modules 37 38 38 39 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 commandes de menu Actions de script ignorées Préférences ou paramètres de registre mémorisés 42 43 48 49 Index 51 Chapitre 1 Présentation de FileMaker Pro Advanced 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. Outre toutes les fonctions disponibles avec FileMaker Pro, FileMaker Pro Advanced comprend : 1 des Utilitaires Developer, pour la création, la personnalisation et le déploiement de solution de bases de données d’exécution ; 1 la fonction Rapport sur la structure des bases de données, pour la publication de documents complets sur les structures ou les schémas de bases de données ; 1 Script Debugger, pour le test et la mise au point automatiques des scripts FileMaker ; 1 le Visualiseur de données assurant le contrôle des rubriques, des variables et des calculs ; 1 la fonction de copie, permettant de copier des rubriques et des tables. Vous pouvez également importer des schémas de table à utiliser dans le même fichier ou dans d’autres fichiers ; 1 la fonction Menus personnalisés assurant la création de menus personnalisés pour la solution ; 1 la fonction Fonctions personnalisées, pour la création de fonctions personnalisées utilisables n’importe où dans une solution. A propos de ce guide Ce guide de développement propose des informations sur les fonctions disponibles dans FileMaker Pro Advanced. En outre, il vous explique comment créer des thèmes de modèles personnalisés et des modules de fonctions externes. Pour plus d’informations sur les fonctions du produit, consultez l’aide de FileMaker Pro. Pour toutes remarques sur ce guide, visitez www.filemaker.com/company/documentation_feedback.html. Pour consulter les ressources du site Web FileMaker, comme les solutions prêtes à l'emploi et la Base de connaissances FileMaker, choisissez le menu Aide > Centre de ressources. Pour en savoir plus au sujet de FileMaker Pro et discuter des rubriques de support avec les autres clients, visitez le forum FileMaker. Choisissez le menu Aide > Forum FileMaker. 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. FileMaker Pro Advanced intègre également un système d'aide en ligne qui fournit des détails sur les fonctions FileMaker Pro. Ce guide 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. 6 Guide de développement FileMaker Pro Advanced 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 et des nouvelles fonctions de FileMaker Pro et FileMaker Pro Advanced : contient des instructions d’installation, ainsi que la liste des nouvelles fonctions proposées dans la version actuelle. 1 Guide de l'utilisateur FileMaker Pro : contient les principaux concepts et les procédures de base. 1 Didacticiel FileMaker Pro : contient des instructions étape par étape concernant la création et l’utilisation des bases de données FileMaker Pro. 1 Manuel FileMaker Pro Advanced 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. 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 Guide ODBC et JDBC FileMaker : décrit comment utiliser le logiciel FileMaker en tant qu'application cliente ODBC et en tant que source de données pour des applications ODBC et JDBC. Où trouver la documentation PDF Pour accéder aux PDF de la documentation FileMaker : 1 dans FileMaker Pro Advanced, choisissez le menu Aide > Documentation produit ; 1 rendez-vous sur le site www.filemaker.fr/documentation pour accéder à d'autres documentations. 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 Advanced\Extras en français\Documentation électronique 1 Mac OS : Disque dur Macintosh/Applications/FileMaker Pro Advanced/Extras en français/ Documentation électronique 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 de l'accord 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 pour l'assistance technique. Pour plus d’informations sur la création d’un modèle A propos de, consultez la section suivante. 1 Avant toute utilisation de FileMaker Pro Advanced, vous devez lire attentivement et accepter les termes et conditions de la licence affichée par le programme d'installation de FileMaker Pro Advanced. Chapitre 1 | Présentation de FileMaker Pro Advanced 7 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. indiquer 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. 3. Le nom du modèle doit commencer par les mots « A propos de ». 4. Le modèle A propos de doit comporter les éléments suivants : 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. » Pour plus d’informations sur la création d’un modèle A propos de, consultez l’Aide. 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-avant pour obtenir des informations sur la personnalisation de cette solution. » La protection d'un fichier FileMaker via les comptes et privilèges 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. 8 Guide de développement FileMaker Pro Advanced Chapitre 2 Création de solutions de bases de données Les Utilitaires Developer de FileMaker Pro Advanced permettent de : 1 renommer un ensemble de fichiers de base de données et mettre automatiquement à jour les liens internes (vers des fichiers et des scripts) ; 1 relier vos fichiers de bases 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 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 afficher vos fichiers de base de données en mode Borne de communication ; 1 ajouter l'extension FileMaker Pro au nom de vos fichiers. Remarque Consultez l'Aide de FileMaker Pro pour obtenir des informations détaillées et complètes ainsi que des procédures étape par étape concernant l'utilisation de FileMaker Pro Advanced. Utilisation des Utilitaires Developer Pour personnaliser vos fichiers de base de données ou les lier à une solution d'exécution : 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 base de données et enregistré vos paramètres, cliquez sur Charger paramètres. Une boîte de dialogue apparaît pour vous permettre de rechercher votre fichier de paramètres. 4. Pour définir les fichiers à personnaliser, cliquez sur Ajouter. 5. Si vous liez plusieurs fichiers dans une solution d'exécution, double-cliquez sur un fichier de la liste pour préciser le fichier principal. 6. Pour renommer un fichier, sélectionnez le fichier dans la liste, entrez le nouveau nom dans la zone Renommer le fichier et cliquez sur Modifier. 7. Pour supprimer un fichier, sélectionnez-le dans la liste et cliquez sur Supprimer. 8. Pour choisir l'emplacement d'enregistrement de la copie de la solution, cliquez sur Définir sous Dossier de projet. 9. Pour conserver les versions précédentes des fichiers, désactivez 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. 10 Guide de développement FileMaker Pro Advanced 10. Effectuez l'une des opérations suivantes : 1 Si vous souhaitez créer une copie de vos fichiers de base de données sous de nouveaux noms, cliquez sur Créer. Remarque FileMaker Pro Advanced met automatiquement à jour les liens internes vers les fichiers et scripts associés. 1 Si vous souhaitez personnaliser davantage vos fichiers de base de données ou les lier, cliquez sur Définir sous Options de solution. 11. Dans la boîte de dialogue Options de solution, sélectionnez une ou plusieurs options. Pour Faites ceci Lier des bases de données à des applications d'exécution Sélectionnez Créer une ou plusieurs applications de solution d'exécution. Remarque Cette option peut être combinée avec toutes les autres à l'exception d'Extension de fichier FileMaker requise pour les bases de données. Consultez la rubrique « A propos de la création de solutions d’exécution », page 11. Interdire définitivement les accès admin à votre solution 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. Pour plus d’informations sur la suppression de l’accès admin des bases de données, consultez l’Aide. Forcer les comptes ne disposant pas des privilèges d'accès intégral pour ouvrir votre solution en mode Borne de communication Sélectionnez Activer le mode Borne de communication pour les comptes non admin Consultez la rubrique « Création de solutions en mode Borne de communication », page 18. Ajouter l'extension FileMaker aux Sélectionnez Extension de fichier FileMaker requise pour les bases de données noms de fichiers des 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 ont pas. Créer un fichier journal afin d'enregistrer les erreurs survenant pendant le traitement Sélectionnez Créer un journal d'erreurs pour les erreurs de traitement Spécifiez un emplacement et un nom de fichier pour le journal d’erreurs. Remarques 1 Si vous n’indiquez pas de nom et d’emplacement, le journal d’erreurs sera enregistré dans le dossier de projet sous le nom Logfile.txt. 1 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. 12. Cliquez sur OK. 13. 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. Pour plus d’informations sur l’enregistrement des paramètres de la solution, consultez l’Aide. 14. Cliquez sur Créer. Chapitre 2 | Création de solutions de bases de données 11 A propos de la création de solutions 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. Les applications d’exécution ne disposent pas de toutes les fonctionnalités et fonctions de FileMaker Pro. Pour obtenir la liste complète des différences entre l'application d'exécution et FileMaker Pro, consultez la section annexe A, « Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro ». Il peut être nécessaire de lier vos fichiers de bases 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. Remarque FileMaker Pro et FileMaker Pro Advanced vous permettent 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 privilèges d'accès, sont stockés au niveau du fichier et certaines solutions complexes continueront à utiliser avantageusement plusieurs fichiers. 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 1 1 1 1 1 des éléments communs et un aspect homogène pour les solutions multiplates-formes ; des infobulles et menus personnalisés, un thème de modèle personnalisé utilisé par tous les fichiers de la solution ; un modèle A propos de pour présenter votre solution (obligatoire) ; un système d'Aide spécifique donnant des conseils pour utiliser votre solution ; 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. Pour plus d'informations sur les conditions requises pour l'utilisation de la solution d'exécution, reportezvous à la rubrique « Distribution des solutions d'exécution », page 13. Conversion et mise à jour des solutions précédentes 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. 12 Guide de développement FileMaker Pro Advanced 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 l’Aide. Après leur conversion, vous pouvez mettre à jour 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. Consultez l’Aide pour plus d’informations sur l’importation de données dans des solutions d’exécution mises à jour. Pour relier les fichiers à une nouvelle solution d'exécution mise à jour, utilisez les Utilitaires Developer. 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). Liaison de la solution Pour lier des fichiers de base de données à une solution d'exécution : 1. Suivez les procédures décrites à la rubrique « Utilisation des Utilitaires Developer », page 9. 2. Dans la boîte de dialogue Options de solution, sélectionnez Créer une ou plusieurs applications de solution d'exécution. 3. Pour nommer votre application d’exécution : 1 Saisissez un nom dans la zone Nom 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. 1 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. Pour plus d’informations sur l’attribution de noms aux solutions d’exécution, consultez l’Aide. 4. 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. Les clés de liaison tiennent compte de la casse des caractères saisis. Pour plus d’informations sur la définition de la clé de liaison, consultez l’Aide. Important L'opération de liaison installe les fichiers système appropriés à chaque plate-forme. 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 pour Mac OS X. Utilisez la même clé de liaison sur les deux plates-formes. 5. 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 32 x 175 pixels (72 ppp) ; au dessous, l'image est déformée lors de son affichage. Les formats pris en charge sont les formats JPEG et GIF. 6. 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. 7. Lorsque la définition des options est terminée, cliquez sur OK. Chapitre 2 | Création de solutions de bases de données 13 8. 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. Pour plus d’informations sur l’enregistrement et la réutilisation des Utilitaires Developer, consultez l’Aide. 9. 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. Démarrage d'une solution d'exécution Faites un double-clic pour démarrer Icône de l'application d'exécution Icône d’un fichier de solution Important Pour lancer la solution, les utilisateurs doivent double-cliquer sur l'icône de l'application d'exécution et non sur celle du fichier de solution. 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 de solution ou d'un fichier auxiliaire risque de provoquer des erreurs. Si vos utilisateurs disposent de plus d’une solution associée à la même extension à trois caractères sur leur ordinateur et qu’ils double-cliquent sur l’icône du fichier de solution, la première solution installée tentera d'ouvrir le fichier, bien que ce ne soit peut-être pas l'application appropriée pour ce fichier spécifique. Distribution 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 permettant le lancement de l'application et indiquer la marche à suivre en cas de fichiers endommagés. Important Windows : La méthode appropriée pour la distribution des solutions d'exécution (y compris le fichier exécutable) consiste à utiliser le logiciel du programme d'installation. Ce logiciel doit installer les composants aux emplacements adéquats du système de fichiers Windows et fournir une possibilité de désinstallation. Consultez le site Web de Microsoft pour obtenir plus d'informations sur l'emplacement des fichiers installés ainsi que sur les restrictions d'emplacement. Sachez que Windows Vista impose des restrictions spécifiques et exige que certains composants d'exécution, notamment Microsoft Visual C++ 2008 SP1 Redistributable Package (x86), se trouvent à un emplacement où seul un programme d'installation peut écrire. 14 Guide de développement FileMaker Pro Advanced 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. Remarque Si vous déplacez plusieurs fichiers dans un dossier pour créer une solution d’exécution, notez que cela aura un impact sur vos liens internes. De ce fait, toutes les sources de données 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 sources de données, elle décèle tout de même 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 de source de données pour le cas où les fichiers sont également utilisés dans FileMaker Pro ou FileMaker Pro Advanced. Dossier solution Windows Lot Fichier principal et fichiers auxiliaires regroupés Fichiers DLL générés lors du regroupement Dossier de solution Mac OS X Application d'exécution, lot Fichier principal et fichiers auxiliaires regroupés Extensions Extensions Dictionnaires Dictionnaires Dossiers de ressources linguistiques Exemple de dossiers de distribution sous Windows et Mac OS X Important Ces fichiers et dossiers ne doivent pas être renommés. Pour plus de détails sur le contenu du lot d’exécution Mac OS X, ainsi que sur le dossier d'extensions Windows et DLL, consultez l’Aide. 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 d'installation doit être prévue. Consultez la rubrique « Utilisation d'un programme d'installation personnalisé » ci-dessous. Outre ces fichiers d'exécution, vous devez fournir des instructions d'installation aux utilisateurs. Pour plus d’informations sur la documentation de solutions de développement, consultez l’Aide. Choix de la méthode de diffusion Après avoir organisé les fichiers qui composent votre solution, vous devez décider comment ils seront installés par les utilisateurs. Vous pouvez diffuser votre solution sur CD-ROM, via le réseau ou via Internet. 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. Chapitre 2 | Création de solutions de bases de données 15 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 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 1 InstallShield MultiPlatform 1 MacInstallerBuilder 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é. 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, rendez-vous sur le site Web de FileMaker (www.filemaker.fr). Récupération des fichiers endommagés Des pannes d'alimentation, des 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. Pour des informations sur la récupération des fichiers d’exécution, consultez l’Aide. 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 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. 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 7. Création d'un modèle d’Aide personnalisé Le système d’aide de FileMaker Pro Advanced n'est pas disponible dans les applications d'exécution. 16 Guide de développement FileMaker Pro Advanced 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 créer une page Web pour documenter votre solution, ajoutez un Web Viewer à votre modèle d’aide permettant d’afficher la page Web. Pour afficher le menu Aide personnalisé sous Mac OS, vous devez partir d'un menu vide. Pour plus d’informations sur la création et la modification de menus personnalisés, consultez la rubrique « A propos des menus personnalisés », page 22. Tester la 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 les 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 cachées ou désactivées dans la solution d'exécution. Consultez la rubrique annexe A, « Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro ». 1 Vérifiez que tous les boutons et les scripts fonctionnent correctement. Cela est tout particulièrement important si votre solution doit être présentée en mode Borne de communication. Consultez la rubrique « Création de solutions en mode Borne de communication », page 18. 1 Vérifiez les 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. 1 Veillez à ce que votre solution contienne un modèle A propos de indiquant aux utilisateurs le niveau d'accès dont ils disposent. Important Vous devez conserver une version complète de tous les fichiers de la solution d'exécution, en particulier si vous avez supprimé définitivement les privilèges d'accès intégral. Chapitre 2 | Création de solutions de bases de données 17 Diffusion de mises à jour de solutions d'exécution Si vous apportez des améliorations fonctionnelles ou 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, liez-les d’abord à l’aide de la clé de liaison initiale. Dans le cas d'un nouveau fichier auxiliaire nécessitant l'ajout de nouvelles sources de données dans le fichier principal ou devant interagir avec d'autres fichiers, mettez à jour tous les fichiers modifiés. Si vous avez oublié la clé de liaison d'origine 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 regroupement 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. 3. Eventuellement, créez un script d'importation pour que les utilisateurs puissent faire migrer leurs données dans le nouveau fichier principal. Pour plus d’informations sur l’importation de données dans des solutions d’exécution mises à jour, consultez l’Aide. 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 nouveau 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. Pour plus d’informations sur l’importation de données dans des solutions d’exécution mises à jour, consultez l’Aide. 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 celle utilisée pour le fichier principal. 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. 18 Guide de développement FileMaker Pro Advanced Création de solutions en mode Borne de communication Le mode Borne de communication permet d’afficher votre solution de bases de données ou d’exécution en plein écran, sans barres d’outils ou 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. Le mode Borne de communication est ignoré si la solution est ouverte à l'aide de comptes associés à un jeu de privilèges 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 > Gérer > Comptes et privilèges. 3. Dans la boîte de dialogue Gérer les comptes et privilèges, cliquez sur Nouveau. 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 privilèges étendus. 8. Si nécessaire, sélectionnez d'autres options, puis cliquez sur OK. Pour activer le mode Borne de communication : 1. Suivez les procédures décrites à la rubrique « Utilisation des Utilitaires Developer », page 9. 2. Dans la boîte de dialogue Options de solution, sélectionnez Activer le mode Borne de communication pour les comptes non Admin. 3. Si nécessaire, sélectionnez d'autres options, puis cliquez sur OK. 4. 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. Pour plus d’informations sur l’enregistrement des paramètres de la solution, consultez l’Aide. Chapitre 2 | Création de solutions de bases de données 19 5. 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é 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. 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. Remarque Si vous possédez une solution Borne de communication précédente affichée dans la zone d'état, vous devez mettre à jour votre solution. Vous ne pouvez pas afficher la barre d'outils d'état ni la barre de modèle dans une solution Borne de communication. Vous devez ajouter la navigation entre les enregistrements, l'état de pause de script et les boutons de script Annuler et Continuer à vos modèles. Pour plus d'informations sur l'utilisation des scripts et boutons pour contrôler les solutions Borne de communication, consultez l'Aide. 20 Guide de développement FileMaker Pro Advanced Chapitre 3 Personnalisation des solutions de base de données Vous pouvez utiliser FileMaker Pro Advanced pour personnaliser vos solutions, bien plus qu'il n'est possible avec FileMaker Pro. Vous pouvez effectuer les actions suivantes : 1 copier et coller des rubriques et les utiliser au sein du même fichier ou dans d'autres fichiers de la base de données ; 1 1 1 1 copier ou importer les tables existantes dans votre fichier de base de données ; créer des fonctions personnalisées à utiliser au sein d'un fichier ; créer des menus personnalisés ; créer des thèmes de modèles personnalisés ; Important Vous devez disposer de privilèges d'accès intégral pour personnaliser les solutions de bases de données. Remarque consulter l'Aide pour obtenir des informations détaillées et complètes ainsi que des procédures étape par étape concernant l'utilisation de FileMaker Pro Advanced. Copie ou importation de schémas de rubriques et de tables Vous pouvez copier ou importer des schémas de rubriques et de tables dans un fichier ou vers d’autres fichiers de base de données. 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 Faites ceci Copier un schéma de rubrique Choisissez Fichier > Gérer > Base de données > onglet Rubriques. Sélectionnez la rubrique dans la liste, puis cliquez sur Copier. Les données ne sont pas copiées. Copier un schéma de table Ouvrez le fichier contenant la table que vous souhaitez copier. Choisissez le menu Fichier > Gérer > Base de données > onglet Tables. Sélectionnez la table dans la liste, puis cliquez sur Copier. Importer un schéma de table Ouvrez le fichier dans lequel vous souhaitez importer une table. Choisissez le menu Fichier > Gérer > Base de données > onglet Tables. Cliquez sur Importer. Sélectionnez le fichier et la table source, puis cliquez sur OK. Pour plus d’informations sur la copie ou l’importation de rubriques et de tables, consultez l'Aide. 22 Guide de développement FileMaker Pro Advanced Création de fonctions personnalisées Utilisez les Fonctions personnalisées pour créer des fonctions personnalisées pouvant être réutilisées partout dans un fichier de base de données et copiées ou importées dans d'autres fichiers FileMaker Pro. Une fois les formules écrites pour la fonction, il est inutile de les réécrire pour les appliquer à d'autres rubriques ou 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. Pour créer une fonction personnalisée : 1. Dans le menu Fichier, sélectionnez > Gérer > Fonctions personnalisées. 2. Dans la boîte de dialogue Gérer les fonctions personnalisées pour, cliquez sur Créer. Affichage sous forme de liste (ouvert) Liste des paramètres Liste des fonctions Zone de formule La boîte de dialogue Modifier la fonction personnalisée Les paramètres personnalisés s'affichent dans cet espace 3. Dans la boîte de dialogue Modifier la fonction personnalisée, entrez le nom de la fonction et élaborez une formule. 4. Cliquez sur OK. Pour plus d’informations sur la création de fonctions personnalisées, consultez l’Aide. A propos des menus personnalisés Avec FileMaker Pro Advanced, vous pouvez créer des menus personnalisés, des éléments de menu et des jeux de menus pour vos solutions de base de données. Vous pouvez effectuer les actions suivantes : 1 créer un menu ou modifier un menu existant ; 1 dupliquer ou supprimer un menu ; 1 ajouter, dupliquer ou supprimer des éléments de menu ; 1 spécifier les propriétés des éléments de menu, comme par exemple le titre d'écran, le raccourci et l'action. Chapitre 3 | Personnalisation des solutions de base de données 23 Jeu de menus (pour cette fenêtre de fichier) Barre de menus Titre d'écran du menu Sous-menu Menu Séparateur Elément de menu Terminologie des menus personnalisés 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. 1 commençant par un menu vide. Utilisez cette méthode pour procéder à d'importantes modifications dans les menus, par exemple pour ajouter des menus ou modifier les propriétés des éléments de menu. Exemple de menu personnalisé L'exemple qui suit vous montre comment personnaliser l'élément de menu Nouvel enregistrement qui s'affiche dans le menu Enregistrements. Ici, nous renommons l'élément de menu Nouvel enregistrement en Nouvelle facture, puis y joignons un script qui s'exécute lorsque l'utilisateur choisit l'élément de menu Nouvelle facture. Enfin, nous modifions le jeu de menus par défaut de sorte que le 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. 1. Ouvrez la base de données, choisissez le menu Fichier > Gérer > Menus personnalisés > onglet Menus personnalisés. 2. Double-cliquez dans le menu Enregistrements copie pour modifier une copie du menu Enregistrements standard. 24 Guide de développement FileMaker Pro Advanced 3. Sélectionnez l'élément de menu Nouvel enregistrement pour modifier ses propriétés. Sous Remplacer les comportements par défaut : 1 Sélectionnez Nom de l'élément et saisissez Nouvelle facture. 1 Sélectionnez Action et indiquez le script Ma nouvelle facture. 4. Cliquez sur OK. L'élément de menu personnalisé est utilisé dans Jeu de menus personnalisé 1 par défaut. Pour afficher l'élément de menu personnalisé dans FileMaker Pro : 1. Pour Jeu de menus par défaut pour ce fichier, sélectionnez Jeu de menus personnalisé 1, puis cliquez sur OK pour fermer la boîte de dialogue Gérer les menus personnalisés. 2. Choisissez le menu Enregistrements. L'élément de menu Nouvelle facture apparaît dans la partie supérieure du menu Enregistrements. Création de menus personnalisés Pour créer un menu personnalisé : 1. Choisissez le menu Fichier > Gérer > Menus personnalisés > onglet Menus personnalisés. La boîte de dialogue Gérer les menus personnalisés s'affiche. 2. Cliquez sur Créer. 3. 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. Cette opération affiche la boîte de dialogue Modifier le menu personnalisé. Chapitre 3 | Personnalisation des solutions de base de données 25 4. Dans la boîte de dialogue Modifier le menu personnalisé, indiquez un nom de menu personnalisé, un commentaire décrivant le menu (facultatif), le titre de menu à afficher au niveau de la barre de menus ainsi que la plate-forme de système d'exploitation et les modes FileMaker Pro dans lesquels le menu doit apparaître. Consultez l’Aide pour plus d’informations sur ces options. Remarque Le commentaire apparaît au niveau de la boîte de dialogue Gérer les menus personnalisés et non pas dans le fichier de votre solution. 5. Créez des éléments de menu personnalisés, comme décrit dans la section suivante. Création d’éléments de menu personnalisés Après avoir créé un menu, vous pouvez créer des éléments de menu. Vous pouvez également créer ou modifier des éléments de menu qui sont des copies des menus standard de FileMaker. Les éléments du 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 créez un élément de menu auquel aucune commande n'est affectée à l'origine. Lorsque vous basez un élément de menu sur une commande FileMaker, l'élément de menu hérite de toutes les propriétés de la commande. Vous pouvez ignorer des propriétés (nom de l'élément de menu, raccourci clavier ou action) afin de personnaliser l'élément de 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 cet élément de menu. Pour créer un élément de menu : 1. Choisissez le menu Fichier > Gérer > Menus personnalisés > onglet Menus personnalisés. 2. Dans la boîte de dialogue Gérer les menus personnalisés, sélectionnez le menu auquel vous souhaitez ajouter l'élément de menu, puis cliquez sur Modifier. 3. Dans la boîte de dialogue Modifier le menu personnalisé, indiquez les éléments du menu à insérer dans le menu : Pour Faites ceci Ajouter une commande Cliquez sur Créer pour ajouter un nouvel élément de menu (<sans titre>) à la liste. Pour Type d'élément de menu, choisissez Commande, puis sélectionnez En fonction de la commande existante. Dans la boîte de dialogue Spécifier une commande FileMaker, choisissez une commande, puis cliquez sur Sélectionner. Une commande détermine l'action ou le comportement d'un élément de menu. Ajouter un sous-menu Cliquez sur Créer pour ajouter un élément de menu <sans titre> à la liste. Pour Type d'élément de menu, choisissez Sous-menu, cliquez sur Définir, sélectionnez un menu, puis cliquez sur Sélectionner. 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 atteignez rapidement la limite fixée. Ajouter une ligne de séparation Cliquez sur Créer pour ajouter un élément de menu <sans titre> à la liste. Pour Type d'élément de menu, choisissez Séparateur. Dupliquer un élément de menu Sélectionnez un élément de menu dans la liste, puis cliquez sur Dupliquer. Supprimer un élément de menu Sélectionnez un élément de menu dans la liste, puis cliquez sur Supprimer. Faites glisser une flèche vers le haut ou vers le bas pour modifier l'ordre des rubriques du menu dans la liste. 26 Guide de développement FileMaker Pro Advanced Pour modifier les propriétés d'un élément de menu : 1. Sélectionnez un élément de menu dans la liste Eléments de menu et effectuez une ou plusieurs des actions suivantes : Pour Faites ceci Modifier une commande d'un élément de menu Pour En fonction de la commande existante, cliquez sur Définir, choisissez une autre commande, puis cliquez sur Sélectionner. Changer le type d'un élément de menu par un autre Pour Type d'élément de menu, choisissez un type différent. (Vous pouvez par exemple changer un séparateur en commande.) Modifier le nom d'un élément de menu Sélectionnez Nom de l'article et saisissez un nouveau nom. Pour baser 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. Windows : Pour indiquer une touche d'accès, insérez 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. Définir un raccourci clavier pour un élément de menu Sélectionnez Raccourci clavier. Dans la boîte de dialogue Définir un raccourci, entrez la combinaison de touches souhaitée, puis cliquez sur OK. Les raccourcis clavier apparaissent en regard des éléments de menu dans la liste Eléments de menu. Pour plus d'informations sur les raccourcis clavier, consultez l'Aide. 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. 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 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), utilisez l'action de script Exécuter script. Pour plus d'informations sur les scripts et les actions de script, consultez l'Aide. Modifier un script ou une action de script Pour Action, cliquez sur Définir, modifiez la définition du script, puis cliquez sur OK. Choisir une plate-forme pour un élément de menu Sélectionnez Windows et/ou Macintosh. Votre élément de menu apparaît dans les fichiers FileMaker Pro exécutés sur les plates-formes indiquées. Remarque Certaines commandes sont valides uniquement sur une plate-forme. 2. Cliquez sur OK. Création de jeux de menus personnalisés Les jeux de menus personnalisés sont des ensembles de menus qui apparaissent dans la barre de menus de l'application FileMaker Pro. Vous pouvez créer des jeux de menus personnalisés pour insérer uniquement les menus souhaités. Après avoir créé des jeux de menus, vous pouvez : 1 1 1 1 spécifier des jeux de menus pour les modèles individuels ; créer des scripts qui modifient les jeux de menus ; modifier le jeu de menus par défaut dans la barre de menus d'un fichier de solution ; basculer temporairement d'un jeu de menus à un autre en utilisant le menu Outils de FileMaker Pro Advanced. Chapitre 3 | Personnalisation des solutions de base de données 27 Pour créer et modifier des jeux de menus : 1. Choisissez le menu Fichier > Gérer > Menus personnalisés > onglet Jeux de menus personnalisés. 2. Cliquez sur Créer. 3. Dans la boîte de dialogue Modifier le jeu de menus personnalisés, cliquez sur Ajouter pour indiquer les menus à inclure dans le jeu de menus. Pour Faites ceci Ajouter un menu dans ce jeu de menus Cliquez sur Ajouter, effectuez l'une des actions suivantes dans la boîte de dialogue Sélectionner un menu, puis cliquez sur Sélectionner : 1 Choisissez un menu dans la liste. 1 Cliquez sur + pour créer un menu. Pour obtenir plus d'informations, consultez la rubrique « Création de menus personnalisés », page 24. Astuces 1 Vous pouvez utiliser les combinaisons de touches Maj+clic ou Ctrl+clic (Windows) ou Command+clic (Mac OS) sur des menus supplémentaires pour ajouter plusieurs menus au jeu de menus. 1 Cliquez sur – pour supprimer un menu personnalisé dans la boîte de dialogue Sélectionner un menu. Modifier les propriétés d'un menu de ce jeu de menus Sélectionnez le menu, puis cliquez sur Modifier. Pour obtenir plus d'informations, consultez la rubrique « Création d’éléments de menu personnalisés », page 25. Supprimer un menu de ce jeu de menus Sélectionnez le menu, puis cliquez sur Supprimer. 4. Cliquez sur OK pour retourner à la boîte de dialogue Gérer les menus personnalisés. Conseil Pour modifier le jeu de menus par défaut pour ce fichier, sélectionnez Menus par défaut du fichier et cliquez sur OK. Le nouveau jeu de menus s'affiche dans FileMaker Pro. Pour plus d’informations sur la création, l’installation et le test de jeux de menus, consultez l’Aide. 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 XMLSpy 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. 28 Guide de développement FileMaker Pro Advanced Couleur et motif de fond de l'élément en-tête Texte de l'en-tête Couleur et motif de fond du corps Titre de rubrique Texte de rubrique Fond, cadre et effet d'ombrage rubrique Texte du pied de page Couleur et motif de fond 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. 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. Important Le code XML qui compose le thème du modèle doit être conçu avec soin et doit 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. Pour créer ou 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 Advanced\Extensions\French\Themes\ eur Mac OS X : FileMaker Pro Advanced/FileMaker Pro 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 Thèmes. 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 présenter l'extension .fth. 3. Ouvrez le fichier de thème dans un éditeur de texte. Chapitre 3 | Personnalisation des solutions de base de données 29 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" /> Important 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. 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” /> 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. 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 Thèmes. 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 nom des thèmes personnalisés s’affiche comme option. Le troisième écran de cet Assistant présente la liste des thèmes disponibles. Si le nom de votre thème n’apparaît pas dans l’assistant, vous avez probablement commis une erreur de syntaxe. Conditions requises pour les fichiers de 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. 30 Guide de développement FileMaker Pro Advanced Eléments indispensables d'un fichier de thème Pour plus d’informations sur les éléments et attributs de modèles, consultez l’Aide. Chapitre 4 Débogage et analyse de 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 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 bases de données et les options 1 Visualiseur de données pour la surveillance des rubriques, des variables et des calculs Remarque Consultez l'Aide pour obtenir des informations détaillées et complètes ainsi que des procédures étape par étape concernant l'utilisation de FileMaker Pro Advanced. Débogage de scripts Avec FileMaker Pro Advanced, vous pouvez utiliser Script Debugger pour : 1 déboguer des scripts exécutés depuis le menu Scripts ou les raccourcis clavier ; 1 mettre au point des scripts de démarrage (le menu Script Debugger est activé même si aucun fichier n’est ouvert) ; 1 1 1 1 1 1 1 1 déboguer un script activé par un déclencheur de script, un bouton ou un menu personnalisé ; faire défiler les scripts action par action ; afficher et suivre les sous-scripts ; surveiller les rubriques, les variables et les calculs ; désactiver des actions de script ; mettre au point des scripts avec privilèges d’accès ; suspendre un script lorsque des erreurs de scripts surviennent ; cliquer sur un numéro d'erreur de script pour ouvrir une rubrique d'aide. Pour exécuter des scripts en mode débogage : 1. Sélectionnez le menu Outils > Script Debugger. La boîte de dialogue Script Debugger s'ouvre. 2. Exécutez votre script. 32 Guide de développement FileMaker Pro Advanced Vous pouvez afficher les sous-scripts au moment où vous naviguez entre les scripts du 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. Script Debugger reconnaît les privilèges associés à chaque script. Un script ne s’affiche donc dans Script Debugger que si vous êtes autorisé à le modifier et que ses privilèges d’accès sont définis sur Modifiable. pour vous connecter Vous pouvez cliquer sur le script Authentifier le script/Annuler l'authentification et modifier les actions de scripts dans les scripts dont l’accès est restreint. Dans la fenêtre Script Debugger, vous pouvez sélectionner plus d’une action dans la liste d’actions, ce qui vous permet de placer plusieurs points d’arrêt simultanément pour les actions. Si plusieurs actions sont sélectionnées, le bouton Définir l’action suivante est désactivé. Remarques 1 Vous ne pouvez pas définir des points d'arrêt sur les actions de script appelées par des boutons ou des menus personnalisés. 1 Lorsque vous utilisez Script Debugger pour faire défiler les scripts activés par un déclencheur de script, vous ne pouvez pas entrer en interaction avec les fenêtres du document, vous déplacer entre les rubriques ou les enregistrements, modifier les données, fermer la fenêtre ou quitter. Ce blocage de l'interaction se produit uniquement lorsqu'un script est déclenché par une action. Lorsque vous déboguez un script non activé par un déclencheur de script, vous pouvez entrer en interaction de manière habituelle avec les fenêtres du document, les rubriques et les enregistrements. Pour plus d'informations sur l'utilisation des déclencheurs de script, consultez l'Aide. Conseil Pour activer Script Debugger à partir de la boîte de dialogue Gérer les scripts, appuyez sur la touche 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. Chapitre 4 | Débogage et analyse de fichiers 33 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 > Gérer les scripts. Vous pouvez également choisir le menu Fichier > Gérer les > scripts. 2. Dans la boîte de dialogue Gérer les scripts, double-cliquez sur le nom du script. Vous pouvez également cliquer sur le de la boîte de dialogue Script Debugger. 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. Pour plus d’informations sur la mise au point des scripts, consultez l’Aide. Utilisation du Visualiseur de données Vous pouvez utiliser le Visualiseur de données pour surveiller des expressions du type valeurs de rubrique, rubriques globales et calculs. Vous pouvez contrôler ces expressions pendant l’exécution des scripts ou lors du test de ces derniers dans Script Debugger. L'onglet En cours indique les rubriques et variables du script actuellement exécuté, les rubriques référencées dans les calculs utilisés dans le script, ainsi que les variables globales. L'onglet Surveiller contrôle les expressions que vous avez saisies tant que vous ne les supprimez pas de la liste. Pour contrôler les rubriques, les variables et les calculs : 1. Choisissez le menu Outils > Visualiseur de données ou cliquez sur Ouvrir/fermer le Visualiseur de données de la boîte de dialogue Script Debugger. Cliquez pour afficher les expressions avec accès restreint Cliquez sur un titre de colonne pour trier 2. Dans l’onglet En cours, double-cliquez sur une valeur pour afficher une boîte de dialogue dans laquelle vous pouvez : 1 afficher, modifier et copier des variables locales ou globales ; 1 afficher (mais pas modifier) des valeurs de rubrique. 3. Pour trier les expressions, cliquez sur un en-tête de colonne. Les expressions sont triées indépendamment dans cet ordre : rubriques, variables globales, variables locales. 34 Guide de développement FileMaker Pro Advanced 4. Pour ajouter une expression à l’onglet Surveiller, cliquez sur Ajouter pour surveiller. L’expression est copiée dans l’onglet Surveiller et ce dernier s'ouvre. 5. Pour afficher des expressions dont l'accès est restreint, cliquez sur bénéficiant des privilèges d’accès intégral. puis connectez-vous à un compte Remarque Si vous vous êtes connecté pour modifier des scripts dont l'accès est limité dans Script Debugger, vos privilèges d'accès s'appliquent également au Visualiseur de données. Si vous vous êtes connecté depuis le Visualiseur de données, vos privilèges d’accès s’appliquent également au Script Debugger. Dans les deux cas, vos privilèges d’accès durent jusqu’à ce que vous fermiez le Script Debugger ou le Visualiseur de données. 6. Cliquez sur l'onglet Surveiller. Faites glisser une flèche vers le haut ou vers le bas pour modifier l'ordre. 7. Choisissez l'une des opérations suivantes : Pour Faites ceci Ajouter une expression Cliquez sur Modifier une expression Sélectionnez une expression, puis cliquez sur Dupliquer une expression Sélectionnez une ou plusieurs expressions, puis cliquez sur . Supprimer une expression Sélectionnez une ou plusieurs expressions, puis cliquez sur . . ou double-cliquez sur l’expression. 8. 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. Chapitre 4 Sélectionnez les opérateurs mathématiques et de texte | Débogage et analyse de fichiers 35 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 Nom de fichier Sélectionnez des fonctions Choisissez les références de rubriques Zone de la formule Résultats de l'expression Evaluer le contenu de l'expression Ajouter l'expression au Visualiseur de données 9. Cliquez sur Evaluer maintenant pour afficher les résultats d'une expression ou sur Surveiller pour ajouter l'expression à la liste dans le Visualiseur de données. 10. Dans le Visualiseur de données, cliquez sur Rafraîchir les valeurs pour rafraîchir les calculs de la liste. Pour plus d'informations sur l'utilisation du Visualiseur de données, consultez l'Aide. Utilisation du Rapport sur la structure des bases 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 les 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. 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. 36 Guide de développement FileMaker Pro Advanced 2. Sélectionnez Outils > Rapport sur la structure des bases. 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. Les tables du fichier s'affichent dans la liste Inclure les rubriques des tables dans le fichier sélectionné. Vous pouvez alors désélectionner les tables souhaitées dans la liste. 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. Pour plus d’informations sur l’utilisation du rapport sur la structure des bases de données, reportez-vous à l’Aide. Chapitre 5 Développement de modules FileMaker tiers Si vous programmez en C ou C++ et que vous connaissez bien les fonctions de calcul 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, FileMaker Server et FileMaker Server Advanced et utiliser vos fonctions externes dans des scripts ou des rubriques Calcul. Vous pouvez utiliser FileMaker Server pour veiller à ce que les clients FileMaker Pro disposent toujours du module le plus récent sur leurs ordinateurs. Reportez-vous au Guide de la mise à jour des modules FileMaker Server disponible sur le site http://www.filemaker.fr/support/product/documentation.html. Pour afficher un exemple de projet de module, rendez-vous sur le site www.filemaker.fr/support/technologies. Accessibilité des modules pour les utilisateurs Les utilisateurs des bases de données accèdent à vos modules à l'aide de fonctions externes au niveau de la boîte de dialogue Calcul. Suivez les étapes ci-dessous pour préparer vos modules personnalisés : 1. Créez un fichier de module contenant votre code de programmation personnalisé. 2. Compilez le module personnalisé et testez-le. 3. Installez le fichier du module compilé pour vos utilisateurs. Pour pouvoir être utilisés, les fichiers des modules de fonctions externes doivent être installés dans le dossier approprié et activés dans FileMaker Pro, FileMaker Pro Advanced ou FileMaker Server. Pour accéder aux fonctions externes, précisez à vos utilisateurs qu'ils doivent : 1. Activer votre module dans la boîte de dialogue Préférences de FileMaker Pro ; 2. Configurer votre module, si nécessaire ; 3. Définir ou modifier une rubrique de calcul pour accéder aux fonctions externes ; 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. 38 Guide de développement FileMaker Pro Advanced Installation de modules Certains modules (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 s’exécute alors comme un service et non comme un processus utilisateur. En conséquence, nous devons écrire les modules de manière différente pour une utilisation avec FileMaker Server. 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, voir l’aide de FileMaker Server. Pour installer un module, glissez le fichier du module dans le dossier Extensions de l'utilisateur de FileMaker comme suit : Sous ce système d'exploitation : Stockez le module dans ce dossier : Windows XP C:\Documents and Settings\nom_utilisateur\Local Settings\Application Data\FileMaker\Extensions\ Windows Vista ou Windows 7 C:\Utilisateurs\nom_utilisateur\AppData\Local\FileMaker\Extensions\ Mac OS X Disque dur Macintosh/Utilisateurs/nom_utilisateur/Library/Application Support/FileMaker/ Extensions Sous Windows, l'extension de module doit être .fmx. Sous Mac OS X, l'extension de module doit être .fmplugin. Activation des modules 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. Pour figurer dans la liste, le module doit être installé dans le dossier FileMaker approprié. Au démarrage, FileMaker Pro charge dans un premier temps les modules stockés dans le dossier Extensions FileMaker de l'utilisateur. Si un module est introuvable, FileMaker Pro le recherche dans le dossier Extensions de l'application FileMaker Pro. Chapitre 5 | Développement de modules FileMaker tiers Le texte de description est défini dans une chaîne de ressource. Sélection d'un module pour l'activer Configuration des modules 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. 3. Pour configurer le module, suivez les instructions de la boîte de dialogue de configuration. 4. Cliquez sur OK. 39 40 Guide de développement FileMaker Pro Advanced 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 pour la démarrer, vous pouvez créer une nouvelle base de données ou choisir un fichier à ouvrir. 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. Ceci inclut le mode Modèle et les commandes du sous-menu Gérer. 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. Cependant, vous pouvez utiliser la fonction de menu personnalisé pour afficher le texte de l’aide personnalisé que vous créez. 1 Les modules de fonction externe 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 de 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. 1 Les applications d’exécution ne peuvent être partagées sur un réseau. 1 Les applications d’exécution n’incluent pas la possibilité d’enregistrer ni d’envoyer des enregistrements sous forme de fichiers Adobe PDF. 1 Les fonctionnalités de FileMaker Pro Advanced ne sont pas disponibles dans 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 intégral ont été supprimés. 1 Les applications d'exécution ne prennent pas en charge les sources de données SQL (ESS), l'importation ODBC ou l'action de script Exécuter SQL. 1 Les graphiques ne sont pas pris en charge dans les solutions d'exécution. 42 Guide de développement FileMaker Pro Advanced Préférences de l'application et du document Dans l’application d'exécution, certaines options ne sont pas disponibles dans l'onglet Général de la boîte de dialogue Préférences. Préférences générales d'une application d'exécution (Mac OS X) 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 (Windows) La boîte de dialogue Options de fichier dans l’application d’exécution n’affiche que l’onglet Orthographe. Boîte de dialogue Options de fichier d'une application d'exécution Annexe A | Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro 43 Comparaison des commandes de menu Les tableaux suivants présentent les commandes de menus disponibles dans FileMaker Pro (Pro) et dans l'application d'exécution (RT). Windows Commande du menu Fichier Pro Mac OS X RT Pro RT Nouvelle base de données 1 1 Nouveau à partir de 1 1 Ouvrir 1 1 Ouvrir à distance 1 1 Ouvrir fichiers récents 1 1 Ouvrir favori 1 1 Close 1 1 Gérer 1 1 Partage 1 1 Options de fichier 1 1 1 1 Modifier le mot de passe 1 1 1 1 Configuration de l'impression 1 1 1 1 Mise en page Impression 1 1 1 1 Importer enregistrements 1 1 1 1 Exporter enregistrements 1 1 1 1 Enregistrer/Envoyer en 1 1 1 1 Envoyer 1 2 1 2 Enregistrer une copie 1 1 1 1 Récupérer 1 3 1 4 Quitter 1 1 1. Vous ne pouvez pas enregistrer ni envoyer des enregistrements sous forme de PDF ou de liens d'instantané. 2. Vous ne pouvez pas envoyer de lien vers une base de données. 3. Appuyez sur Ctrl+Maj 4. Appuyez sur Option+3 Remarque Vous pouvez ajouter des éléments de menus qui miment 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 « Création de menus personnalisés », page 24. 44 Guide de développement FileMaker Pro Advanced Windows Commande du menu Edition Mac OS X Pro RT Pro RT Annuler/Impossible d'annuler 1 1 1 1 Rétablir/Impossible de rétablir 1 1 1 1 Couper 1 1 1 1 Copie 1 1 1 1 Coller 1 1 1 1 Collage spécial 1 1 Effacer 1 1 1 1 Dupliquer 1 Sélectionner tout 1 1 1 1 Rechercher et remplacer 1 1 1 1 Orthographe 1 1 1 1 Objet 1 1 Exporter contenu de rubrique 1 1 1 1 Préférences 1 1 1 Windows Commande du menu Affichage Mac OS X Pro RT Pro RT Mode Utilisation 1 1 1 1 Mode Recherche 1 1 1 1 Mode Modèle 1 Mode Prévisualisation 1 1 1 1 Activer modèle 1 1 1 1 Afficher sous forme de formulaire 1 1 1 1 Afficher sous forme de liste 1 1 1 1 Afficher sous forme de tableau 1 1 1 1 Barre d'outils Etat 1 1 1 1 Personnaliser la barre d'outils Etat 1 1 1 1 Barre de texte 1 1 1 1 Réglette de texte 1 1 1 1 Agrandir 1 1 1 1 Réduire 1 1 1 1 1 Annexe A | Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro Windows Commande du menu Insertion Mac OS X Pro RT Pro RT Image 1 1 1 1 QuickTime 1 1 1 1 Son 1 1 1 1 Fichier 1 1 1 1 Objet 1 1 Date du jour 1 1 1 1 Heure actuelle 1 1 1 1 Nom de l’utilisateur 1 1 1 1 A partir de l'index 1 1 1 1 Depuis le dernier enregistrement consulté 1 1 1 1 Windows Commande du menu Format Mac OS X Pro RT Pro RT Police 1 1 1 1 Corps 1 1 1 1 Style 1 1 1 1 Alignement 1 1 1 1 Interligne 1 1 1 1 Couleur de texte 1 1 1 1 Windows Commande du menu Enregistrements Mac OS X Pro RT Pro RT Nouvel enregistrement 1 1 1 1 Dupliquer l'enregistrement 1 1 1 1 Supprimer l'enregistrement 1 1 1 1 Supprimer les enregistrements trouvés/Supprimer tous enreg. 1 1 1 1 Afficher enregistrement 1 1 1 1 Rafraîchir fenêtre 1 1 1 1 Afficher tous les enreg. 1 1 1 1 Afficher enreg. ignorés uniq. 1 1 1 1 Ignorer l'enregistrement 1 1 1 1 Ignorer les enregistrements 1 1 1 1 Modifier la recherche 1 1 1 1 45 46 Guide de développement FileMaker Pro Advanced Windows Commande du menu Enregistrements Mac OS X Pro RT Pro RT Recherches enregistrées 1 1 1 1 Trier les enregistrements 1 1 1 1 Annuler tri 1 1 1 1 Remplacer le contenu de la rubrique 1 1 1 1 Mettre à jour le contenu de la rubrique 1 1 1 1 Rétablir l'enregistrement 1 1 1 1 Commande du menu Requêtes (Mode Recherche) Windows Mac OS X Pro RT Pro RT Nouvelle requête 1 1 1 1 Dupliquer la requête 1 1 1 1 Supprimer la requête 1 1 1 1 Afficher requête 1 1 1 1 Afficher tous les enreg. 1 1 1 1 Exécuter recherche 1 1 1 1 Restreindre l'ensemble trouvé 1 1 1 1 Développer l'ensemble trouvé 1 1 1 1 Rétablir la requête 1 1 1 1 Windows Commande du menu Scripts Pro Mac OS X RT Pro Gérer les scripts 1 1 Enregistrer le script 1 1 Enregistrer tous les scripts 1 1 Rétablir le script 1 1 <Noms des scripts> 1 1 1 RT 1 Remarque Les commandes de menu Enregistrer le script, Enregistrer tous les scripts et Rétablir le script apparaissent uniquement lorsque la boîte de dialogue Gérer les scripts ou Modifier le script est active. Annexe A | Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro Windows Commande du menu Fenêtre Mac OS X Pro RT Pro RT Nouvelle fenêtre 1 1 1 1 Afficher la fenêtre 1 1 1 1 Masquer la fenêtre 1 1 1 1 Réduire la fenêtre 1 1 1 1 Juxtaposition horizontale 1 1 1 1 Juxtaposition verticale 1 1 1 1 Superposer 1 1 1 1 Ranger les icônes 1 1 1 1 1 1 Premier plan <Nom des fichiers ouverts> 1 1 Windows Commande du menu Aide Pro Mac OS X RT Pro Aide FileMaker Pro 1 1 Raccourcis clavier 1 1 Ecran Démarrage rapide 1 1 Centre de ressources 1 1 Documentation produit 1 1 Consultants et solutions 1 1 Envoyer des commentaires à FileMaker 1 1 Rechercher les mises à jour 1 1 Enregistrer FileMaker Pro 1 1 Forum FileMaker 1 1 Assistance technique et service clientèle 1 1 A propos de FileMaker Pro (ou A propos de FileMaker Pro Advanced) 1 RT 1 A propos de FileMaker Pro Runtime (s'affiche si aucun script personnalisé A propos de n'est spécifié) 1 1 A propos de <solution d'exécution> (s'affiche si un script personnalisé A propos de est spécifié) 1 1 <Nom du script Aide de la solution d'exécution> (s'affiche si un script personnalisé Aide est spécifié) 1 1 1 Voir le tableau des commandes du menu Application 47 48 Guide de développement FileMaker Pro Advanced Commande du menu Application (Mac OS X uniquement) A propos de FileMaker Pro Pro RT 1 A propos de FileMaker Pro Runtime (s'affiche si aucun script personnalisé A propos de n'est spécifié) 1 A propos de <solution d'exécution> (s'affiche si un script personnalisé A propos de est spécifié) 1 Préférences 1 1 Services 1 1 Masquer FileMaker Pro 1 1 Masquer la <solution d'exécution> Masquer les autres 1 1 Afficher tout 1 1 Quitter FileMaker Pro 1 Quitter la <solution d'exécution> 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 1 1 1 1 1 1 1 1 1 1 1 1 1 Ouvrir Gérer la base de données Ouvrir Gérer les listes de valeurs Ouvrir Gérer les sources de données Ouvrir Gérer les scripts Ouvrir Gérer les modèles Ouvrir Partage Ouvrir Aide Multi-utilisateur Nouveau fichier Ouvrir Options fichier (partiellement disponible ; l’onglet Orthographe s’ouvrira) Ouvrir à distance Exécuter SQL Sauvegarder en PDF Sauvegarder les enregistrements en lien d’instantané Remarque Ouvrir fichier renvoie une erreur si le fichier spécifié n'est pas incorporé à l'application d'exécution. Une solution d'exécution peut uniquement exécuter un script externe si le fichier externe est lié à la solution d'exécution. Annexe A | Comparaison de la fonctionnalité de l'application d'exécution et de FileMaker Pro 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\.0 FileMaker Pro Advanced stocke ses paramètres de registre dans HKEY_CURRENT_USER\Software\FileMaker\FileMaker Pro\.0A L'application d'exécution stocke ses paramètres de registre dans : HKEY_CURRENT_USER\Software\FileMaker\<solution name>\.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 paramètres de préférences dans : com.filemaker.client.pro.plist FileMaker Pro Advanced stocke ses paramètres de préférences dans : com.filemaker.client.advanced.plist L'application d'exécution stocke ses préférences dans : com.filemaker.client.runtime.<Nom solution>.plist 49 50 Guide de développement FileMaker Pro Advanced Index A accès Admin suppression des fichiers 10 suppression des solutions en mode Borne de communication 19 Action de script Exécuter SQL 48 Action de script Multi-utilisateur 48 Action de script Nouveau fichier 48 action de script Ouvrir à distance 48 Action de script Ouvrir Aide 48 Action de script Ouvrir Fichier 48 Action de script Ouvrir Gérer la base de données 48 Action de script Ouvrir Gérer les listes de valeurs 48 Action de script Ouvrir Gérer les modèles 48 Action de script Ouvrir Gérer les sources de données 48 Action de script Ouvrir Options fichier 48 Action de script Ouvrir Partage 48 Action de script Sauvegarder en PDF 48 Action de script Sauvegarder les enregistrements en lien d’instantané 48 Aide commandes disponibles dans les applications d'exécution 47 Apple Event dans les applications d'exécution 41 Application d’exécution, lot Windows 14 Applications d'exécution actions de script ignorées 48 activation de modules 41 commandes disponibles 43 icône 13 par rapport à FileMaker Pro 41 paramètres de registre enregistrés sous Windows 49 préférences Mac OS X enregistrées 49 Assistant Nouveau modèle/rapport 27, 29 Attribution d'un nom aux solutions d'exécution 12 Attributs des thèmes de modèle 27 Authentification de scripts 32 Automatisation sous OLE dans les applications d'exécution 41 B Base de données, statistiques 35 Base de données, structure 35 C C/C++ 37 calculs avancés 33 utilisation des fonctions externes 37 Clé de liaison à propos de 12 mise à jour des solutions d'exécution 17 Codes d’erreur, affichage à partir de Script Debugger 31 Commandes de menu, disponibles dans les applications d'exécution 43 Commandes du menu Affichage disponibles dans les applications d'exécution 44 Commandes du menu Edition disponibles dans les applications d'exécution 44 Commandes du menu Enregistrements disponibles dans les applications d'exécution 45 Commandes du menu Fenêtre disponibles dans les applications d'exécution 47 Commandes du menu Fichier disponibles dans les applications d'exécution 43 Commandes du menu Format disponibles dans les applications d'exécution 45 Commandes du menu Insertion disponibles dans les applications d'exécution 45 Commandes du menu Requêtes disponibles dans les applications d'exécution 46 Commandes du mode Modèle, non disponibles dans les applications d'exécution 41 Commandes, menu disponibles dans les applications d'exécution 43 comptes et privilèges 7, 21 mode Borne de communication 18 suppression de l’accès admin 10 Configuration des modules 39 Contrat de licence 6 conversion de fichiers issus de versions précédentes 12 Copie de schémas de rubriques ou de tables 21 Couleurs, thèmes de modèle 28 D DDR Voir Rapports sur la structure des bases de données déclencheurs de script, débogage 32 Délai, écran personnalisé 12 Démarrage de solutions d’exécution 13 Désactivation des actions de script 33 Déverrouillage de scripts 32 Didacticiel, FileMaker Pro 6 Diffusion de solutions d'exécution à propos de 13 distribution des mises à jour 17 termes et conditions 6 DLL (Dynamic Link Libraries) 14 52 Guide de développement FileMaker Pro Advanced Documentation rapports sur la structure des bases de données 35 solutions d'exécution 15 documentation électronique 6 Documentation PDF 6 Dossier de projet 9, 13 Dossier Extensions, emplacement des modules 38 E Ecran personnalisé dans les solutions d'exécution démarrage 11 fermeture 12 Ecran tactile 18 Editeurs de texte 27 Eléments de thèmes de modèle 29 Expressions, surveillance 33 Extensible Markup Language (XML). Voir XML Extension de fichier fmplugin 38 Extension de fichier fmx 38 Extension de fichier fth 28 extensions de fichier des fichiers de bases de données 10 modules 38 pour les solutions d'exécution 12 Thèmes de modèle 28 Extensions, nom de fichier. Voir Extensions de fichier F fest Scripts 31 solutions de bases de données 16 Fichier de paramètres 10 Fichier de solution icône 13 problèmes avec le double-clic 13 Fichier principal connexion des fichiers auxiliaires 11 mise à jour 17 spécification 9 Fichiers attribution d'un nouveau nom 9 compression 15 conversion 12 mise à jour 10 suppression de l’accès admin 10 Fichiers auxiliaires mise à jour 17 problèmes avec le double-clic 13 FileMaker Developer Voir FileMaker Pro Advanced FileMaker Pro Advanced Contrat de licence 6 documentation 5 mise à jour à partir de versions antérieures 11 FileMaker Pro, menus disponibles 43 FileMaker Server 15, 37, 41 Fonctions externes 37 personnalisation 22 surveillance dans des formules 35 Fonctions externes 37 Fonctions personnalisées, création 22 Format HTML des rapports sur la structure des bases de données 35 formules pour fonctions personnalisées 22 suivi 33 G Gérer les scripts 32 I Icônes pour les solutions d'exécution 13 InstallShield 15 Instructions d'installation 6 Interaction des utilisateurs avec la solution 11 Internet applications d'exécution sur 41 bases de données sur 6 J JDBC, FileMaker comme source de données 6 Jeux de menus, création 26 journal d'erreurs 10 L Liaison des solutions d'exécution 12 Logfile.txt 10 Logo, ajout dans une solution d'exécution 12 M Mac OS X application d'exécution, lot 14 préférences enregistrées 49 MacInstallerBuilder 15 Menu Scripts commandes disponibles dans les applications d'exécution 46 Menus personnalisés à propos de 22 création 24 éléments de menu 25 exemple 23 jeux de menus 26 Messages, journal d'erreurs 10 | Microsoft Windows, paramètres de registre enregistrés 49 MindVision Installer VISE 15 Mise à jour des applications d'exécution 11 Mise au point des scripts 31 Mises à jour des solutions d’exécution 17 modules 37 Modèle A propos de contenu requis pour 7 description 6 Modèle Aide 16 Modification des noms de fichiers 9 modules configuration 39 dans les applications d'exécution 41 installation 38 préparation 37 Modules de fonctions externes activation 38 dans les applications d'exécution 41 description 37 Motifs, thèmes de modèle 28 Mots de passe, avertissement requis dans le modèle A propos de 7 N Nouvelles fonctions 6 O Obligations légales 6 ODBC, FileMaker comme source de données 6 Options de fichier disponibles dans l'application d'exécution 42 Ouverture de fichiers dans des applications d'exécution 41 Ouvrir Gérer les scripts, action de script 48 P Plusieurs tables par fichier de base de données 11 Polices indisponibles sur le système de l'utilisateur 14 Thèmes de modèle 27 Préférences disponibles dans l'application d'exécution 42 Privilèges d’accès 7, 21 problèmes calculs 33 rubriques 33 Script Debugger 31 utilisation de rapport sur la structure des bases de données 35 variables 33 Programmes d'installation des applications Index 53 d'exécution 15 R Raccourcis clavier dans les éléments de menus personnalisés 26 Raccourcis, clavier. Voir raccourcis clavier rapports sur la structure des bases de données 35 Rapports, base de données 35 Récupération des fichiers d'exécution endommagés 15 Références externes. Reportez-vous à sources de données Registre, paramètres mémorisés 49 Réseaux, partage de solutions sur 15 rubriques copie d’un schéma 21 suivi 33 S Sauvegardes 16 Schémas de bases de données copie ou importation 21 dans Rapport sur la structure des bases de données 35 Schémas, base de données copie ou importation 21 Documentation 35 Script Debugger avec des déclencheurs de script 32 description 31 Scripts actions ignorées par les applications d'exécution 48 authentification 32 débogage 31 Désactivation des actions de script 33 déverrouillage 32 Séparateurs de menu 25 Séparateurs, élément de menu 25 Solutions d'exécution configuration requise du modèle A propos de 7, 15 conversion 12 création 9, 11 démarrage 13 Documentation 13 liaison de fichiers 12 mise à jour 11, 17 préparation de fichiers 11 récupération des fichiers endommagés 15 Solutions en mode Borne de communication, création 18 Solutions multi-plateformes 12 Sources de données mise à jour 17 mise à jour automatique 10 Sous-menu Gérer, non disponible dans les applications d'exécution 41 Statistiques de base de données 35 54 Guide de développement FileMaker Pro Advanced Structure de base de données, nouvelle création 35 Structure des dossiers, solution 14 T Tables, base de données copie ou importation de schéma 21 exclusion du rapport sur la structure des bases de données 36 plusieurs par fichier 11 Thèmes de modèle, création 27 Thèmes. Voir Thèmes de modèle U Utilisateurs de navigateurs Web 6 Utilitaires de compression des applications d'exécution 15 Utilitaires Developer à propos de 9 création de solutions d’exécution 11 V Variables, surveillance 33 Visualiseur de données 33 W Web Viewer 16 X XML documents pour les thèmes de modèle 27 éditeurs 27 format des rapports sur la structure des bases de données 35 instructions pour le traitement d'un document XML 29 spécifications XML 1.0 29 syntaxe de sortie pour DDR 6