Initiation à zope [30 mn de lecture - paru le 11/5/2003 - Public : Débutant]

Auteur

Benjamin TARLAY Elève-Ingénieur Supinfo Paris Promotion SUPINFO 2004    Lui écrire    Tous les projets de cet auteur    Le mini-CV de cet auteur

3. Création d'une page simple

    3.1. Création de la DTML method

Nous allons créer une page simple, pour cela nous devons d'abord créer un nouveau dossier :

• Cliquez sur Root Folder
• Sélectionnez "Folder" dans le menu déroulant "Select type to add..." situé en haut à droite :

• Entrez un numéro d'ID unique: "Test"
• Entrez un titre pour votre objet: "Test de titre"

• cliquez sur Add

A noter que l'on aurait pu sélectionnez " Create public interface" pour avoir un document HTML par défaut et "Create user folder" pour pouvoir gérer les accès à ce dossier.

• Cliquer sur le dossier "Test" dans la frame de gauche :

• Dans la frame workspace, sélectionnez "Add DTML Method" dans le menu déroulant "Select type to add..." situé en haut à droite :

• Tout comme pour la création du dossier, saisissez index_html comme id unique et un titre pour la page.
  A noter que comme nous l'avons évoqué dans l'introduction, les pages zopes ne sont pas des fichiers mais des objets stoqués en base de données.
  A noter également qu'il n'y pas d'extension pour le nom des objets et donc au lieu de nommer notre page index.html comme sur un serveur classique, nous allons la nommée index_html.

• Cliquer sur "Add"

A noter que l'on aurait pu directement uploader un fichier existant ou faire un "Add and edit" pour éditer directement le fichier.

• Cliquer sur l'objet index_html que nous venons de créer, vous découvrez le workspace de développement :

En haut vous pouvez observer le menu :

• Edit : champ d'edition de l'objet
• View : permet de visualiser la page en cours de déveleloppement
• Proxy qui permet de gérer les droits d'accès
• History : historique des version de l'objets avec dernier user à avoir modifier la page, possibilité de comparer les différentes versions
• Security : gestion de la sécurité de l'objet, gestions des droits des différents users sur l'objet.
• Undo : permet de revenir sur une version ancienne de l'objet
• Ownership : savoir qu'elle est l'utilisateur qui a créer l'objet.

Vous pouvez faire un View pour voir la page que l'on vient de créer :

Nous allons étudier le code DTML de la page :

<dtml-var standard_html_header>
<h2><dtml-var title_or_id> <dtml-var document_title></h2>
<p>
This is the <dtml-var document_id> Document
in the <dtml-var title_and_id> Folder.
</p>
<dtml-var standard_html_footer>

• <dtml-var standard_html_header> : permet d'inclure l'objet standard_html_header que l'on trouve à la racine ce qui permet de gérer la charte graphique
• <dtml-var standard_html_footer> : permet d'inclure l'objet standard_html_footer que l'on trouve à la racine ce qui permet de gérer la charte graphique
• <dtml-var title_or_id> : titre du dossier
• <dtml-var document_title> : titre de l'objet
• <dtml-var document_id> : id de l'objet
• <dtml-var title_and_id> : titre du dossier

Vous pouvez modifier le code de l'objet pour bien comprendre le fonctionnement.

    3.2. Modification du header et du footer

Vous pouvez :

• modifier standard_html_header et standard_html_footer situé à la racine afin de bien comprendre le fonctionnement de ces objets
• Surcharger les objets standard_html_header et standard_html_footer en les recréant dans le dossier test afin d'avoir une charte différente dans le dossier test par rapport au dossier racine :

Cliquer sur Copy
Cliquer sur le dossier test à gauche
Cliquer sur paste
Vous obtenez ceci :

Editer les deux fichiers que vous venez de coller, faites un View sur le dossier test pour voir les modifs que vous venez de faire.
Retourner à la racine faites de nouveau un View
Vous avez créer deux chartes différentes pour les deux dossiers.

    3.3. Appel d'un script python

Sélectionnez "Script (Python)" dans le menu déroulant "Select type to add..." situé en haut à droite :

    3.4. Liste exhaustive des balises DTML

• dtml-call : appeler une méthode DTML.
• dtml-comment : insérer un commentaire.
• dtml-functions : utiliser une fonction Python prédéfinie.
• dtml-if : SI, pour tester une condition.
• dtml-in : créer des boucles, pour répéter, parcourir, etc.
• dtml-let : définir une variable et lui donner une valeur.
• dtml-mime : créer un type MIME (principalement utilisé pour le mail).
• dtml-raise : lever une exception (pour gérer les erreurs survenues lors de l'exécution).
• dtml-return : fin d'une méthode, et éventuellement renvoyer un résultat).
• dtml-sendmail : envoyer un mail via SMTP.
• dtml-sqlgroup : créer un groupe dans une requête SQL.
• dtml-sqltest : insérer un test dans du SQL.
• dtml-sqlvar : insérer des variables dans du SQL.
• dtml-tree : afficher un arbre dynamique.
• dtml-try : permet la gestion des exceptions (voir dtml-raise).
• dtml-unless : permet de tester facilement des conditions négatives.
• dtml-var : insérer une variable (ou plutôt sa valeur).
• dtml-with : pousse un objet dans l'espace de nommage de DTML ; les variables seront cherchées d'abord dans les objets poussés.