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