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 (&)
&amp;
Inférieur à (<)
&lt;
Supérieur à (>)
&gt;
Apostrophe (')
&apos;
Guillemet (")
&quot;
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