Developpez.com - 4D
X

Choisissez d'abord la catégorieensuite la rubrique :


Créer vos Modèles de bases en 4D 2003

Date de publication : Avril 2003

Par Dave DELL'AQUILA (Senior evangelist, 4D Inc.)
 

Cette note technique vous montre comment transformer une base 4D 2003 standard en Modèle. Vos propres modèles peuvent être un outil efficace pour créer des bases avec une interface, une programmation, des barres de menus, etc, déjà mis en place. Pour cela vous devez modifer des ressources dans la structure. A faire donc avec toutes les précautions nécessaires.

I. Résumé
II. Utilisation des modèles
III. Emplacement des Modèles :
IV. Transformer une base existante en Modèle :
V. Pas de plug-ins
VI. Doit posséder un fichier de données
VII. Le nom du modèle
VIII. Pour ajouter un nom de Modèle :
IX. Descriptif du Modèle
X. Image du Modèle
XI. Nom du fichier de données


I. Résumé

4ème Dimension 2003 possède une nouvelle fonctionnalité qui permet de simplifier la création de nouvelles bases à partir de structures existantes. Le dialogue d'ouverture a été modifié pour permettre de visualiser une liste de Modèles ou de structures de base de données existantes qui peuvent être utilisées comme point de départ pour de nouveaux projets.

Ces structures contiennent les éléments (tables, méthodes, formulaires menus, images et données) qui peuvent servir de prototypes pour de nouveaux projets de développement. Par le passé, les développeurs devaient dupliquer une structure, la renommer puis l'ouvrir avec 4ème Dimension. Désormais, les modèles peuvent permettre aux développeurs novices de créer très rapidement des bases totalement fonctionnelles à partir d'une liste de modèles prédéfinis.

Cette note technique décrit comment modifier une structure existante pour qu'elle devienne un nouveau Modèle dans 4ème Dimension 2003.


II. Utilisation des modèles

Le dialogue d'ouverture et de création de bases de données a été modifié dans 4ème Dimension 2003 et 4D Server. Par défaut, il apparaît comme ceci :

Pictures 0230x0336

Cliquez sur l'onglet "Créer une base" pour visualiser l'option "Nouvelle base vierge" ainsi que la liste des Modèles déjà installés :

Pictures 0398x0350

Si vous sélectionnez "Nouvelle base vierge", vous créerez une base vide, comme dans les anciennes versions.

Les autres noms de la liste sont les modèles installés en standard dans le dossier "4D Templates".

Pour choisir un Modèle, cliquez sur son nom. La partie droite du dialogue affiche une prévisualisation de l'interface, ainsi qu'un bref descriptif des fonctionnalités du modèle.

Pour créer une nouvelle base en utilisant le Modèle, cliquez sur le bouton "Créer". Un dialogue standard vous permet de choisir le nom de la base et son répertoire.


III. Emplacement des Modèles :

Les Modèles sont stockés dans un dossier nommé "4D Templates". Ce dossier doit se trouver dans le même répertoire que l'application 4D que vous lancez. C'est-à-dire à côté du fichier .exe sous Windows ou du "progiciel" sous MacOS.

Pictures 0247x0074


IV. Transformer une base existante en Modèle :

N'importe quelle base existante peut devenir un modèle. Même convertie en modèle, une base reste une base standard ; c'est-à-dire que des changements peuvent être faits dans la structure ou dans les données et ces modifications seront utilisés à chaque nouvelle création de base avec ce modèle.

Les différents points à noter quand vous convertissez une base en modèle, sont les suivants :

- La base ne peut pas utiliser de plug-ins ;

- Chaque Modèle doit avoir un fichier de données (même nom que celui de la structure avec comme extension ".data" sous MacOS et ".4DD" sous Windows ;

- La structure doit contenir une ressource "STR ", ID=14000, qui contient le nom du Modèle tel qu'il apparaîtra dans la liste des Modèles dans le dialogue d'ouverture ;

- La structure doit contenir une ressource "TEXT", ID=14000, qui contient le descriptif du Modèle ;

- La structure doit contenir une ressource "PICT", ID=14000, qui contient l'image associée au Modèle lors de la prévisualisation ;

- La structure contient une ressource "STR#", ID=14000, qui contient la liste des noms des fichiers de données.


V. Pas de plug-ins

Parce que tous les Modèles partagent le même répertoire, il est impossible de leur associer un dossier de plug-ins en particulier. Les Modèles ne peuvent donc pas avoir de plug-ins.

Après avoir créé votre base en utilisant un modèle, vous pouvez intégrer un dossier de plug-ins dans le nouveau dossier de la base si des plug-ins sont requis.

Une autre solution consiste à créer dans le répertoire "4D Templates" un répertoire qui contient les plug-ins nécessaires. Ce répertoire doit avoir un nom facile à localiser par programmation, et en utilisant les commandes 4D permettant de gérer des documents et dossiers ( Tester chemin acces, LISTE DES DOSSIERS, LISTE DES DOCUMENTS, CREER DOSSIER, COPIER DOCUMENT, fichier application), vous pouvez créer un dossier Mac4DX ou Win4DX à l'ouverture de la base si le plug-in ne se trouve pas au bon endroit.

Par exemple, si votre base s'appelle Commandes, vous pouvez créer un dossier appelé Commandes.Mac.4DX et Commandes.Win.4DX, et y stocker les plug-ins appropriés, dans le répertoire "4D Templates".

Quand vous créez une nouvelle base en utilisant le Modèle Commandes, la méthode Sur ouverture peut vérifier si le dossier Mac4DX ou Win4DX existe et si non, le créer et y copier le contenu du dossier des plug-ins (Commandes.Mac.4DX et Commandes.Win.4DX) de "4D Templates".


VI. Doit posséder un fichier de données

Les Modèles n'apparaîtront pas dans la liste du dialogue d'ouverture si la structure n'est pas accompagnée d'un fichier de données. Ce fichier doit se terminer par l'extension ".data" sous MacOS ou ".4DD" sous Windows.


VII. Le nom du modèle

Le nom du modèle est stocké dans une ressource du fichier structure. Pour ajouter des ressources, vous devez utiliser un Editeur de ressources. Une modification de ressources se fait sous votre responsabilité. Pensez à faire une copie de votre base auparavant et manipulez les ressources avec précaution.

Par défaut, les nouvelles structures contiennent deux ressources, IN4D et STR . Au lancement, 4D cherche les ressources spécifiques pour les Modèles valides. Nous ajoutons la ressource contenant le nom du Modèle tel qu'il apparaît dans le dialogue d'ouverture.


VIII. Pour ajouter un nom de Modèle :

1. Ouvrir le fichier de structure avec un Editeur de ressources :

Pictures 0544x0274

2. Double-cliquez sur la ressource "STR " (notez l'espace après la lettre R) pour l'ouvrir.

3. Créez une nouvelle ressource "STR ".

Pictures 0400x0218

4. Saisissez le nom du Modèle.

Pictures 0380x0186

5. Modifiez l'ID de la ressource en remplaçant 128 par 14000.

Sauvegardez la modification.


IX. Descriptif du Modèle

Le descriptif du Modèle, une ressource de type "TEXT", peut contenir jusqu'à 32 767 caractères. Ce descriptif apparaîtra lors de la prévisuation du Modèle.

Pour ajouter une description au Modèle, ajoutez une ressource de type "TEXT", modifiez-en également l'ID par 14000 :

Pictures 0278x0191

Vous pouvez y saisir le texte de votre descriptif :

Pictures 0400x0218

Une fois le texte saisi, fermez la ressource et sauvegardez-la.


X. Image du Modèle

Lorsque vous sélectionnez un Modèle dans la liste du dialogue d'ouverture, une image peut être affichée pour donner une idée de l'interface.

Pour ajouter une image, créez une nouvelle ressource de type "PICT", ID=14000 :

Pictures 0348x0240

Dans celle-ci, collez l'image de prévisualisation de votre Modèle. La taille idéale de votre image est de 171 sur 256 pixels.

Pictures 0472x0242


XI. Nom du fichier de données

Enfin, nous devons donner à 4D la liste des noms de fichiers de données associés au fichier structure qu'il doit chercher dans le dossier "4D Templates".

Créez une nouvelle ressource de type "STR#", ID=14000 :

Pictures 0254x0222

Dans cette ressource, saisissez 6 champs avec les contenus ci-dessus (dupliquez les 3 premiers dans les champs 4, 5 et 6).

Sauvegardez vos modifications. Votre base peut maintenant être reconnue comme un Modèle 4D (à condition de l'avoir copiée dans le dossier "4D Templates") :

Pictures 0454x0345

__________________________________________________
Copyright © 1985-2009 4D SA - Tous droits réservés
Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible.
Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers.
Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support du Logiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés ou reproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence.
Aucune partie de ce document ne peut être reproduite ou recopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA.
4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension ®, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA.
Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation.
Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc.
Mac2Win Software Copyright © 1990-2002 est un produit de Altura Software,Inc.
4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,Trumbull,CT,USA.
XTND Copyright 1992-2002 © 4D SA. Tous droits réservés.
XTND Technology Copyright 1989-2002 © Claris Corporation.. Tous droits réservés ACROBAT © Copyright 1987-2002, Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'Adobe Systems Inc.
Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.
__________________________________________________
 



Valid XHTML 1.1!Valid CSS!

Ce document est issu de http://www.developpez.com et reste la propriété exclusive de son auteur. La copie, modification et/ou distribution par quelque moyen que ce soit est soumise à l'obtention préalable de l'autorisation de l'auteur.
Contacter le responsable de la rubrique 4D