F Filliettaz TECFA 02 2002.

F Filliettaz TECFA

Qu’est-ce que c’est que ça ? A quoi ça sert ? Comment ça marche ?
Démo pratique de quelques aspects particuliers (portail) F Filliettaz TECFA

1. Qu’est-ce que ? Z Object Publishing Environment
Advanced web application server framework Open source: il est possible de comprendre en profondeur comment il fonctionne Orienté objet. Les éléments publiés sur le web ne sont pas des fichiers, mais des objets Sécurisé Multi-plate-forme: Windows, Unix, Mac Zope: mot d’origine bretone dont personne ne sait exactement ce qu’il signifie. Z ne signifie rien de particulier (N ou B auraient parfaitement fait l’affaire) Framework: charpente, carcasse, infrastructure qui facilite la construction d'application dans un domaine donné (fonction identique à une librairie de classes en OOP). Zope est essentiellement programmé en Python, langage relativement simple et très puissant. (à développer) Orienté objet: tous les avantages de la programmation objets se retrouvent dans Zope, p.ex les ZClasses. Dès le début Zope a été très sûr. Il existe des failles, mais elles sont connues, semble-t-il, et il existe des stratégies pour y parer. F Filliettaz TECFA

Les objets dans Un objet est défini par
son état (ensemble des valeurs de ses attributs) son comportement (ensemble des méthodes qui lui sont applicables). Il appartient à une classe (qui peut être dérivée d'une super-classe, etc) Les objets Zope les plus courants appartiennent aux classes Folder, DTML Document et DTML Method. Ils sont persistants, leur durée de vie dépasse celle de l'application (généralement on instancie un objet quand on en a besoin, et on le détruit quand on en a plus besoin). Un objet persistant se sauvegarde et se restaure lui-même. Le composant ZODB se charge de la persistance des objets. Zope: mot d’origine bretone dont personne ne sait exactement ce qu’il signifie. Z ne signifie rien de particulier (N ou B auraient parfaitement fait l’affaire) Framework: charpente, carcasse, infrastructure qui facilite la construction d'application dans un domaine donné (fonction identique à une librairie de classes en OOP). Zope est essentiellement programmé en Python, langage relativement simple et très puissant. (à développer) Orienté objet: tous les avantages de la programmation objets se retrouvent dans Zope, p.ex les ZClasses. Dès le début Zope a été très sûr. Il existe des failles, mais elles sont connues, semble-t-il, et il existe des stratégies pour y parer. F Filliettaz TECFA

ZServer HTTP requests, responses Channels and Threads, Buffering
FRAMEWORK COMPOSANTS ZServer HTTP requests, responses Channels and Threads, Buffering Content Folder, File, Image, Document Template Page & Document Template Zpublisher URL traversal, access control Argument and exception handling Scripts Python Script, External Method ZODB (Zope Objects Data Base) Objects, transactions, undo, history, versions Database Interface Adapter, SQL Method, Search Wizzard Storages ZClass Undoable non-undoable remote Python based Products File Berkeley ZEO Zope architecture F Filliettaz TECFA Site Building Objects

ZServer ZServer Server web multi-thread (plusieurs utilisateurs peuvent se brancher en même temps). Supporte HTTP, FTP et PCGI (persistent CGI). En réalité, ZServer est un framwork et ZPublisher en plug-in. ZServer reçoit les requêtes venant du web, les "prétraite" (preprocessing) selon les standards CGI et appelle ZPublisher. Ensuite ZServer envoie la réponse de ZPublisher sur Internet. F Filliettaz TECFA

ZPublisher Zope met des objets sur le web. On appelle cela publier des objets. Une des caractéristiques uniques de Zope est sa manière d'atteindre les objets et d'appeler les méthodes simplement en remontant les URL. En plus de rendre les objets disponibles pour le protocole HTTP, Zope en permet l'accès aux protocoles FTP, WebDAV et XML-RPC Remote Procedure Call: XML pour l'encodage, HTTP pour le transfert). URL Traversal: processus par lequel Zope touve l'objet demandé par la requête. Le processus dépend de l'acquisition, il est donc sensible au contexte (il ne dépend pas uniquement de l'URL). F Filliettaz TECFA

ZODB Zope ne conserve pas les composants du site dans les fichiers du système d'exploitation, mais dans une base de données orientée objet. Ainsi chaque objet est implémenté par classe, ce qui rend possible de leur attribuer des propriétés et d'y définir des méthodes. La maintenance du site en est grandement facilitée. Mais la ZODB a un autre avantage essentiel: c'est une base de données transactionnelle, c'est-à-dire qu'une transaction (transfert de fichiers) qui échoue ne menace pas l'intégrité du contenu. Zope détecte si une transaction est incomplète, ou si elle interfère avec une autre transaction, et peut l'annuler (undo). Il existe deux types de transactions: transactions à court terme, utiles pour protéger les opération d'une simple requête, et les transactions à long terme, appelées versions, autorisent des développements concurrents d'un même fichier. F Filliettaz TECFA

ZEO Zope Enterprise Object: permet de faire tourner un site sur plusieurs ordinateurs: Quand le site est très actif, un ordinateur peut se crasher. Les autres répondent aux requêtes. On installe un ZEO serveur et plusieurs ZEO clients (même version de Zope, mêmes Products) F Filliettaz TECFA

Templates Document Template est le principal outil de composition de Zope. Il s'agit d'un modèle statique, qui contient des commandes pour ajouter du texte qui leur sera substitué. La syntaxe est semblable au HTML, mais elle permet d'inclure dans des pages HTML d'autres pages (idem SSI) ou objets. Ces commandes sont appelées DTML (Document Template Markup Language). Document Template contient des commandes pour: l'inclusion de tous types d'objets l'itération le rendement conditionnel de texte (empêche l'affichage d'un texte ou en affiche un autre suivant les conditions) F Filliettaz TECFA

Templates call/return : appelle un objet pour ses effets de bord (p.ex mettre à jour une propriété, envoyer un ) ou pour contrôler ses valeurs retournées. gestion des exceptions (erreurs) présentation hiérarchique interactive des structures hiérarchisées F Filliettaz TECFA

Products Ces produits se trouvent dans le dossier webserver/lib/python/products. C'est là qu'il faut les installer. Le site de zope en propose plus de 400. S'ils sont convenablement installés, ils peuvent être ajoutés partout, en cliquant sur add. Les products sont extrèmement variés, il en existe dans tous les domaines, et rien n'empêche d'en programmer soi-même en Python. F Filliettaz TECFA

Avec un moteur de recherche relativement efficace
Possibilité d’interfaçage avec des systèmes externes, bases de données, systèmes RPC ou autres sites web. Possibilités infinies et très simples de faire croître un site. Les possibilités de Zope peuvent être largement étendues, grâce à la créativité de sa communauté. moteur de recherche: développer l'indexation F Filliettaz TECFA

1. Qu’est-ce que ? (suite) Interface basée sur le web: l’interface de management de Zope s’ouvre dans le navigateur Permet d’écrire des applications dans plusieurs langages de script: Python, Perl et le langage de Zope: DTML Gratuit Une communauté très active et qualifiée - Zope: mot d’origine bretone dont personne ne sait exactement ce qu’il signifie. Z ne signifie rien de particulier (N ou B auraient parfaitement fait l’affaire) framework: charpente, carcasse, structure modulaire. Zope est essentiellement programmé en Python, langage relativement simple et très puissant. (à développer) F Filliettaz TECFA

2. A quoi sert ? Permet de construire des sites web dynamiques
Modulaires : séparation claire entre contenu, logique et présentation, composants paramétrables et configurables, permettant une unité de style du site, et une navigation uniforme, sensible au contexte, mise à jour automatiquement. Site qui utilise des pages web dynamiques, qui ne sont pas produites à l’avance mais sont créées lors de leur publication, donc très grande souplesse, gain de temps etc.. Les modules ne sont créés qu’une fois, et sont repris chaque fois que c’est nécessaire lors de la publication des pages (p.ex standard_html_header). Cette séparation est essentielle; p.ex. les rédacteurs ne doivent pas écrire dans des espaces réservés dans des pages html, avec le risque qu’ils détruisent toute la mise en page. F Filliettaz TECFA

2. A quoi sert ? Ce qui facilite la gestion du style d'un site, puisque chaque module inclu dans les pages se réfère à la même CSS, permet une navigation uniforme dans tout le site, une indexation automatique des pages, et l'utilisation d'un outil de recherche très utile dans un site d'une certaine importance. Offre une interaction évoluée et des possibilités de personnalisation pour chaque visiteur. Site qui utilise des pages web dynamiques, qui ne sont pas produites à l’avance mais sont créées lors de leur publication, donc très grande souplesse, gain de temps etc.. Les modules ne sont créés qu’une fois, et sont repris chaque fois que c’est nécessaire lors de la publication des pages (p.ex standard_html_header). Cette séparation est essentielle; p.ex. les rédacteurs ne doivent pas écrire dans des espaces réservés dans des pages html, avec le risque qu’ils détruisent toute la mise en page. F Filliettaz TECFA

3. Comment marche ? Installation Premiers contacts
L’environnement de développement L’acquisition Le DTML par le menu F Filliettaz TECFA

Installation Télécharger Zope http://www.zope.org/Products/Zope
Sous Windows, exécuter setup.exe NT ou 2k: l'installer en tant que service (manuel) Pour entrer dans l’environnement de développement, pointer le navigateur vers A TECFA: F Filliettaz TECFA

Installation Se connecter en utilisant nom et mot de passe créés lors de l’installation. Créer un répertoire qui contiendra les éléments de votre site. Y copier index_html, standard_html_header et standard_html_footer de la racine. F Filliettaz TECFA

Installation des composants
Depuis la page télécharger le composant. Le déziper Placer les dossiers dans le répertoire où vous avez installé Zope (par défaut WebServer), sous /lib/python/Products. Vérifier depuis le Control_panel de Zope, lien Product management, qu'il est bien installé. Si c'est le cas, il sera disponible dans le drop-down Select type to add . F Filliettaz TECFA

F Filliettaz TECFA

Installation Précaution: faire régulièrement un back-up du fichier Data.fs, qui se trouve dans le dossier var. F Filliettaz TECFA

Premiers contacts Créer un utilisateur: cliquer sur le dossier add_user, puis sur le bouton Add une fois les champs renseignés Créer une page: le code HTML est contenu dans des objets. Il suffit d’un créer un de type DTML_document L’ID est essentiel, il permettra à Zope de référencer l’objet. Le titre apparaîtra dans le document, appelé par la méthode title_or_id. Cliquer sur Add pour l’ajouter au dossier courant F Filliettaz TECFA

Entrer l’URL http://localhost:8080/ # id_du_fichier # (p. ex
Entrer l’URL id_du_fichier # (p.ex. ..:8080/toto) pour voir l’aspect d’un objet sommaire. Revenir à l’environnement de management, et cliquer sur l’objet. On devrait voir ceci: <dtml-var standard_html_header> <h2><dtml-var title_or_id></h2> <p> This is the <dtml-var id> Document. </p> <dtml-var standard_html_footer> C’est le code par défaut d’un DTML_document. F Filliettaz TECFA

DTML Document / DTML Method
Ces deux objets ont la même interface, et il est souvent difficile de savoir lequel utiliser. S'il s'agit de publier un contenu, utiliser DTML Document. S'il s'agit de manipuler ou d'appeler d'autres objets, utiliser DTML Method (presentation templates: définir des layouts séparément du contenu). F Filliettaz TECFA

<dtml-var > Toutes les balises du DTML commencent par <dtml-.
<dtml-var permet d’insérer une variable. id est le contenu de l’identifiant de l’objet title_or_id est une méthode qui renvoie le titre de l’objet s’il existe, sinon son id standard_html_header et standard_html_footer sont des objets qui seront inclus dans l’objet appelant. F Filliettaz TECFA

<dtml-var > L’instruction <dtml-var>permet d’inclure des variables, le résultat de l’appel d’une fonction et des objets. Elle ne se ferme pas. Elle a des attributs: P.ex. missing <dtml-var truc missing="il n'existe pas , ce truc"> Voir les attributs dans DTML Reference, Appendice A de "Zope Book" F Filliettaz TECFA

Ecrire en HTML Il est évidemment possible d'écrire des pages HTML sans profiter du DTML. Zope jouera alors le rôle d'un serveur web statique. Il est aussi possible d'importer des pages HTML pour les convertir au format DTML. Dans le pop-up de Add, sélectionner Add DTML Document, dont le dernier élément est Browse. Choisir le fichier texte, lui donner un id, et cliquer Add. F Filliettaz TECFA

Importer des images Depuis la racine du site, ajouter un objet Image
Renseignez id et title Avec Parcourir chercher l’image Cliquer sur Add. L’objet apparaît désormais à la racine du site, et peut être utilisé dans toutes les pages avec la balise HTML <IMG SRC="id_de_image" > (p.ex <IMG SRC=" image " >). F Filliettaz TECFA

DTML sommaire petit cas pratique
Vous avez installé Zope pour permettre à vos collègues de publier des textes sur le web. Ils ignorent tout du HTML. Créez un dossier utilisateurs et intitulez-le comme il vous plaît. Ne sélectionnez aucune option. Puis dans ce dossier, créez un dossier par collègue (au moins 3 pour la beauté de l'exercice), sans cocher d'option. F Filliettaz TECFA

DTML sommaire (suite) Dans le dossier utilisateurs, créer une DTML Method (et non un DTML Document) appelé (id) index_html, et contenant le code suivant: <dtml-var standard_html_header> <dtml-in "objectValues(['Folder'])"> <A HREF=<dtml-var id>><dtml-var title></A><BR> </dtml_in> <dtml-var standard_html_footer> F Filliettaz TECFA

DTML sommaire (suite) Pour améliorer l'apparence du site, éditer la méthode index_html du dossier utilisateurs et introduire le code suivant: <dtml-var standard_html_header> <TABLE> <TR> <TD WIDTH="30%"> <dtml-var DocumentList> </TD> </TR> </TABLE> <dtml-var standard_html_footer> F Filliettaz TECFA

DTML sommaire (suite) Toujours dans le dossier utilisateurs créer une DTML Method appelée FolderList contenant le code suivant: <P> <A HREF="<dtml-var "PARENTS[1].absolute_url()">">Retour</A><BR> </P> <dtml-in "objectValues(['Folder'])"> <A HREF="<dtml-var id>"><dtml-var title></A><BR> </dtml-in> F Filliettaz TECFA

DTML sommaire (suite) et une DTML Method appelée DocumentList contenant le code suivant: <dtml-in "objectValues(['DTML Document'])"> <H1><dtml-var title_or_id></H1> <dtml-var "_['sequence-item']"> </dtml-in> Puis créer un DTML Document dans le dossier utilisateurs appelé presentation contenant un texte comme celui-ci: Créez vos pages en insérant des "DTML Documents" et des "Folder" dans votre dossier personnel. F Filliettaz TECFA

DTML sommaire (suite) Enfin, permettez à chaque utilisateur de gérer ses propres pages. Pour chaque utilisateur, se placer dans le dossier /acl_users et ajouter un utilisateur doté des propriétés suivantes: id identifiant ou nom de l'utilisateur Password mot de passe assigné à cet utilisateur Domains laisser vide Roles ne sélectionner aucun rôle F Filliettaz TECFA

DTML sommaire (fin) Puis dans le dossier de chaque utilisateur, cliquer sur Security et cliquer sur le lien Local role; sélectionner le nom de l'utilisateur dans la liste de gauche et les rôles Manager et Owner dans la liste de droite, puis cliquer sur Add. Maintenant chaque utilisateur peut utiliser l'URL pour créer et modifier ses propres pages. Il n'a accès qu'à sa partie personnelle, et ne peut pas modifier votre travail. Toutes les pages peuvent être vues par tout le monde. F Filliettaz TECFA

L'environnement de développement Manipulations élémentaires
Modifier un objet: cliquer sur son nom. Ajouter un objet: dans un dossier: cliquer sur son lien dans le cadre de gauche, puis sélectionner dans la liste déroulant "Select object to add" le type d'objet à ajouter. Lui donner ensuite un id (deux objets ne peuvent pas avoir le même id dans un même dossier) et un nom (pas obligatoire). Cliquer sur Add. Détruire un objet: sur l'onglet "Contents" du dossier parent cocher la case de l'objet, puis sur "Delete". F Filliettaz TECFA

Renommer un objet: pour changer son identifiant sans en modifier le titre, ses propriétés en général, le contenu: le sélectionner, puis cliquer sur le bouton Rename. Changer le titre d'un objet: aller dans l'onglet "Properties" de cet objet. Copier/coller F Filliettaz TECFA

Editer le contenu d'un objet: cliquer deux fois sur le nom de l'objet, ou aller à l'ongler "Edit". Toujours cliquer sur "Save Changes" pour que les changements deviennent effectifs Editer les propriétés d'un objet: aller à l'onglet "Properties". Attention: les propriétés sont des attributs au sens de la programmation objet; pour un dossier, elles ne peuvent avoir le même nom qu'un objet contenu dans ce dossier, F Filliettaz TECFA

et il n'est pas possible dans ce dossier de créer un objet du même nom qu'un propriété existante. Les propriétés sont gérées automatiquement par Zope : en ajoutant des propriétés à un objet, on autorise les utilisateurs à accéder à ces propriétés et/ou à les modifier, s'ils ont les permissions requises. Les types de propriétés correspondent dans la pratique aux types de champs des formulaires HTML. On ne peut pas créer un objet title dans un dossier si ce dossier possède une propriété title. F Filliettaz TECFA

Annulation: undo Zope intègre un mécanisme d'annulation très efficace. Les objets de Zope sont stockés dans une base de données, dont l'architecture est conçue de manière à garder un historique de toute modification qui y est apportée. Cette faculté d'annulation est gérée dossier par dossier, ce qui permet d'avoir toujours une vision des actions relatives au dossier courant. F Filliettaz TECFA

Version: permet de modifier une partie du site sans que ces modifications soient accessibles aux autres utilisateurs. Permet de tester les changements avant de les rendre publiques. Il est possible de travailler à plusieurs sur une version. Dès qu'un objet a été modifié à partir d'une version, il est vérouillé en modification hors de cette version, et ne peut être modifié que dans cette version. Aucun chevauchement n'est possible avec d'autres modifications. F Filliettaz TECFA

L'environnement de développement Espace de noms
Espace de noms Zope transforme une URL en appel d'une méthode d'un objet ZODB. Il transmet son namespace à la méthode qui permettra à l'objet de se rendre. Il s'agit d'une liste de variables qui permettent à l'objet d'interagir avec son environnement. Il peut contenir: les attributs et les méthodes définis par l'objet lui-même les attributs et les méthodes de ses conteneurs récupérés par l'acquisition F Filliettaz TECFA

une variable spéciale, REQUEST, contenant des informations spécifiques à la requête HTTP un objet RESPONSE permettant de renvoyer des en-têtes HTTP ou des codes de réponse au navigateur. les attributs et méthodes définis au sein de Zope et accessibles par tous les objets. La variable REQUEST contient les données de la requête HTTP. C'est la variable la plus utilisée et le meilleur moyen de récupérer des entrées de l'utilisateur, pour les traiter dynamiquement. F Filliettaz TECFA

Par example: <FORM ACTION="fomulaire"> <TABLE> <TR> <TH>Texte :</TH> <TD><INPUT TYPE="text" NAME="texte"></TD> </TR> <TR> <TH>Sélection :</TH><TD> <INPUT TYPE="checkbox" NAME="select" VALUE="1"> <BR><INPUT TYPE="checkbox" NAME="select" VALUE="2"> <BR><INPUT TYPE="checkbox" NAME="select" VALUE="3"> </TD> </TR> <TABLE> <INPUT TYPE="submit" VALUE="Test"> </FORM> F Filliettaz TECFA

La validation du formulaire provoque un appel de l'URL formulaire. Et donc de l'objet en question. Dans l'objet formulaire, suivant les données entrées par l'utilisateur, les expressions python suivantes peuvent être vraies : REQUEST.text == "Mon texte" REQUEST.select == "3" F Filliettaz TECFA

Par exemple , pour récupérer les valeurs obtenues dans le formulaire précédent, écrire le DTML Document suivant, auquel vous donnez l'id formulaire: <dtml-var standard_html_header> <dtml-var expr="_.int(REQUEST.select) + 5"><BR> <dtml-var expr="REQUEST.texte"> <dtml-var standard_html_footer> F Filliettaz TECFA

Pour voir le contenu de REQUEST, écrire un DTML Document avec ce simple contenu: <dtml-var standard_html_header> <dtml-var REQUEST> <dtml-var standard_html_footer> F Filliettaz TECFA

L'environnement de développement Utilisateurs, rôles et permissions
Les droits ne sont pas réglés au niveau des utilisateurs, mais à travers des rôles. A chaque utilisateur est affecté un ou plusieurs rôles. Trois rôles particuliers: Administrateur (Manager) dispose de tous les droits Propriétaire d'un objet (Owner). Permet de déléguer l'administration de certains objets à leur propriétaire. Il n'y a qu'un seul propriétaire par objet. Anonyme (anonymus user), correspondant à un utilisateur pas encore identifié. F Filliettaz TECFA

D'autres rôles peuvent être créés. Lors de la création ou de la modification des utilisateurs, le responsable peut affecter les rôles qu'il souhaite à chacun d'eux. La création de nouveaux rôles se fait dans l'onglet Security des objets concernés: local roles Ce rôle apparaît dans tous les sous-objets s'il s'agit d'un objet conteneur. Il n'est pas possible de retirer ce rôle dans les sous-objets. F Filliettaz TECFA

Il est possible et très pratique de créer des rôles locaux pour des objets qui ne sont pas des conteneurs (DTML Document en particulier) Modification des permissions Dans l'onglet Security de l'objet. F Filliettaz TECFA

Acquisition L'acquisition est la technologie qui permet le passage des comportements et contenus dynamiques d'un objet Zope à un autre. Le concept de l'acquisition est simple: : Des objets sont placés à l'intérieur d'autres objets. Ces objets acquièrent le contenu et les comportements de leur conteneur (idem pour ce conteneur etc.).. F Filliettaz TECFA

Acquisition La puissance de l'acquisition réside dans ce partage automatique entre contenu et conteneur. En créant Documents et Folders on ne construit pas simplement un site, mais on construit une structure d'information. F Filliettaz TECFA

Acquisition En plaçant un Document dans un Folder, on crée un petit outil de partage d'information entre le Document et le Folder. Dans Zope, un Document p.ex. a accès au contenu et au services de tous ses conteneurs. Si un des Folder peut envoyer des mails, le Document le pourra aussi sans que cela apparaisse dans son code.. F Filliettaz TECFA

Acquisition Ainsi les objets acquièrent et fournissent des services.
L'acquisition va dans les deux sens. La réutilisation des services est simple, puisqu'il n'y a rien à faire de spécial pour qu'ils soient disponibles pour d'autres objets. Un Document dans un Folder acquière les comportements du Folder. Quid pour un Document qui est au centre d'une "poupée russe" faite de différents Folder?. De qui va-t-il acquérir les comportements? F Filliettaz TECFA

Acquisition L'acquisition agit sur toute la hiérarchie. Si nous avons un Document au centre de trois Folder - /Utilisateurs/Nooteboom/Romans/Rituels, le Document Rituels acquière les comportements du Folder Romans, qui acquière les comportements du Folder Nooteboom, et ainsi de suite. Chaque objet acquière les comportements d'un objet, ou d'une collection d'objets. Ils peuvent être nombreux, ce qui signifie qu'il bénéficiera d'une panoplie très adaptée. Exercice: Construire une hiérarchie d'au-moins 3 niveaux (Folders imbriqués) contenant chacun quelques documents. Ecrire un index_html unique, qui affichera le nom du Folder et son contenu. F Filliettaz TECFA

Acquisition Comportements dynamiques L'acquisition permet que les comportements soient distribués partout dans Zope. Quand on ajoute un objet, il n'y a pas besoin de spécifier dans son code tous ses comportements, mais seulement ceux qui lui sont propres. Ce qui signifie qu'il est possible de changer le comportement d'un objet en le changeant de place dans la hiérarchie. Exercice: Construire une hiérarchie d'au-moins 3 niveaux (Folders imbriqués) contenant chacun quelques documents. Ecrire un index_html unique, qui affichera le nom du Folder et son contenu. F Filliettaz TECFA

Acquisition Exercice: construire une hiérarchie d'au-moins 3 niveaux (Folders imbriqués) contenant chacun quelques documents. Ecrire un index_html unique, qui dès qu'on pointe vers un Folder en affichera le contenu. Exercice: Construire une hiérarchie d'au-moins 3 niveaux (Folders imbriqués) contenant chacun quelques documents. Ecrire un index_html unique, qui affichera le nom du Folder et son contenu. F Filliettaz TECFA

DTML Langage à balise pour modèle de document qui peut:
Afficher le contenu d'objets Zope Exécuter des méthodes sur des objet Zope Afficher des attributs d'objets Effectuer des tests sur ces variables Parcourir des boucles à partir de ces variables Gérer les exceptions F Filliettaz TECFA

DTML Le code DTML est interprété par DTML Document DTML Method
Le DTML est interprété dans le corps du document, jamais dans ses propriétés (du code écrit dans la propriété title ne sera pas interprété) Tous les traitements sont effectués sur le serveur. F Filliettaz TECFA

Balises du DTML Balises ouvrantes Balises fermantes <dtml-var>
<dtml-in> </dtml-in> <dtml-tree> </dtml-tree> <dtml-if> <dtml-else> <dtml-elif> <dtml-endif></dtml-if> <dtml-unless> </dtml unless> F Filliettaz TECFA

Balises du DTML Balises ouvrantes Balises fermantes <dtml-with>
<dtml-let> </dtml-let> <dtml-call> </dtml-call> <dtml-try> <dtml-except> <dtml-else> <dtml-finally> </dtml-try> <dtml-raise> </dtml raise> F Filliettaz TECFA

Balises du DTML Balises ouvrantes Balises fermantes
<dtml-comment> </dtml-comment> <dtml-return> <dtml-sendmail </dtml-sendmail> <dtml-mime> </dtml-mime> F Filliettaz TECFA

Attributs name et expr de <dtml-var
<dtml-var name="title"> et <dtml-var title> sont équivalents. <dtml-var "title"> et <dtml-var expr="title"> sont équivalents. Il est fortement conseillé de n'utiliser implicitement que l'attribut name et toujours préciser expr= lors de l'utilisation de l'attribut expr. <dtml-var> est doté de nombreux attributs qui permettent de spécifier la manière dont les valeurs sont affichées. F Filliettaz TECFA

Attributs name et expr de <dtml-var
Avec l'attribut name on ne peut spécifier que des noms de variables (objets, attributs, méthodes). L'attribut expr permet d'insérer le contenu d'une expression Python, ou effectuer des calculs simples: <dtml-var expr="24 * 60"> expr est indispensable pour exécuter des méthodes de l'espace de noms. Pour afficher le titre ou l'identifiant du parent: <dtml-var expr="PARENTS[0].title_or_id ()"> Ajouter éventuellement des infos sur les modules Python p.98. F Filliettaz TECFA

<dtml-if > Si l'attribut name fait référence à une propriété ou un document inexistant, sa valeur est considérée comme fausse. C'est la façon la plus pratique de vérifier l'existence d'un document ou d'une propriété. Dans le cas de expr, si un attribut auquel il fait référence n'existe pas, il y a erreur. <dtml-if toto1> <h1>Voici Toto1</h1> <dtml-var toto1> <dtml-elif toto2> <h1>Voici Toto2</h2> <dtml-var toto2> <dtml-elif toto3> <h1>Voici Toto3</h2> <dtml-var toto3> <dtml-else> <h1>RAS</h1> </dtml-if> F Filliettaz TECFA

<dtml-call> <dtml-return>
Pour appeler une méthode ou un document sans qu'il se "rende" (pour effectuer un traitement sur le serveur p.ex), on utilise <dtml-call>, qui n'accepte que expr et var comme attributs. Pour obtenir en retour une valeur précise, on utilise <dtml-return>, qui accepte les attributs expr et var. <dtml-if condition> <dtml-return "'Oui'"> <dtml-else> <dtml-return "'Non'"> </dtml-if> Attention à la syntaxe des chaînes! Il est interdit d'utiliser des guillemets dans les expressions. Utiliser '…'. Attrention aux chaînes! En parler quelque part. F Filliettaz TECFA

<dtml-call> <dtml-return>
<dtml-return> peut retourner n'importe quel type de données. Pour renvoyer l'objet magasin : <dtml-return "magasin"> F Filliettaz TECFA

<dtml-in > Permet l'itération dans un Folder, dans les propriétés d'un objet etc.. Le contenu d'un bloc entre les tags in est une sorte de template qui s'applique une fois à chaque item d'une séquence. F Filliettaz TECFA

<dtml-in propriétés >
Pour parcourir des listes. Exemple: dans un Folder magasin créer un DTML Document vide appelé catalogue. Lui affecter une propriété articles de type lines. Entrer 5 ou 6 articles. Dans le corps du DTML Document entrer ce code: <dtml-var standard_html_header> <dtml-in articles> <dtml-var sequence-item><BR> </dtml-in> <dtml-var standard_html_footer> F Filliettaz TECFA

<dtml-in> Cliquer sur l'onglet View.
<dtml-in > accepte les attributs name et expr. Elle renvoie une erreur si la propriété n'existe pas. Pour vérifier qu'il y a un ou des article(s) il suffit d'écrire. <dtml-in articles> <dtml-var sequence-item><BR> <dtml-else> <H2>Aucun article</H2> </dtml-in> F Filliettaz TECFA

<dtml-in liste d'objets >
Il faut stocker les articles dans des objets Zope. Créer un dossier articles dans le dossier courant Puis 1 DTML Document par article. Leur donner un ID du type Art_01 etc..Supprimer le contenu par défaut. Dans la propriété title indiquer le nom de l'article. F Filliettaz TECFA

Les objets Folder possèdent une méthode objectsIds() qui renvoie la liste des objets qu'ils contiennent (sous forme d'une liste de chaînes) <dtml-in "articles.objectIds()"> <dtml-var sequence-item><BR> </dtml-in> Il est possible de spécifier quels objets sont recherchés: <dtml-in "articles.objectIds(['DTML Document'])"> <dtml-var sequence-item><BR> </dtml-in> F Filliettaz TECFA

Les objets Folder possèdent une méthode objectsValues() qui renvoie la liste des objets qu'ils contiennent (sous forme d'une liste): <dtml-in "articles.objectValues(['DTML Document'])"> <dtml-var title><BR> </dtml-in> Pour obtenir aussi la référence: <dtml-in "articles.objectValues(['DTML Document'])"> <dtml-var id>%nbsp; <dtml-var title><BR> </dtml-in> F Filliettaz TECFA

Pour obtenir en plus le contenu des objets (description qu'il faut entrer dans le corps du DTML Document de chaque article): <dtml-in "articles.objectValues(['DTML Document'])"> <dtml-var id>%nbsp;<dtml-var title> %nbsp;<dtml-var sequence-item><BR> </dtml-in> F Filliettaz TECFA

Parcourir des objets pour obtenir leur contenu? Dans le dossier magasin créer une DTML Method appelée index_html et y inclure ce code: <dtml-var standard_html_header> <dtml-in "articles.objectValues(['DTML Document'])"> <H1><dtml-var title></H1> <dtml-var sequence-item> </dtml-in> <dtml-var standard_html_footer> F Filliettaz TECFA

Se placer dans le dossier articles et cliquer sur l'onglet View. Tous les articles apparaîssent les uns à la suite des autres, grâce à l'acquisition. Pour détecter le début ou la fin d'une séquence: sequence-start et sequence-end F Filliettaz TECFA

<dtml.in "articles.objectValues(['DTML Document'])" <dtml-if sequence-start> <TABLE BORDER="1"> <TR><TH>Article</TH></TR> </dtml-if> <TR><TD><dtml-var title></TD></TR> <dtml-if sequence-end> </TABLE> </dtml-if> <dtml-else> Aucun article </dtml-in> Retrouver dans le site les exemples plus sophistiqués F Filliettaz TECFA

Pour obtenir l'index de l'élément, utiliser la variable sequence-index <TR><TD><dtml-var sequence-index> : <dtml-var title></TD></TR> Pour parcourir des dictionnaires (liste de valeurs associées à des clefs, comme {'ART_01':'Avion' . 'ART_02' : 'Bateau'} ) on utilise sequence-key pour obtenir le premier indice, et sequence-item pour obtenir le second. Retrouver dans le site les exemples plus sophistiqués F Filliettaz TECFA

<dtml-in "articles.objecItems(['DTML Document'])"> <dtml-if sequence-start> <TABLE BORDER="1"> <TR><TH>Référence</TH> <TH>Article</TH> </TR> </dtml-if> <TR> <TD><dtml-var sequence-key></TD>(ou <dtml-var id>) <TD><dtml-var title></TD> </TR> <dtml-if sequence-end> </TABLE> </dtml-if> <dtml-else> Aucun article </dtml-in> Retrouver dans le site les exemples plus sophistiqués F Filliettaz TECFA

Exercice: ajouter quelques DTML Documents d'articles, en ajoutant à certains (pas à tous) une propriété prix de type integer, et ajouter dans le document catalogue une colonne au tableau mentionnant le prix ou affichant "N/A" si aucun prix n'a été défini. Retrouver dans le site les exemples plus sophistiqués F Filliettaz TECFA

<dtml-in liste d'objets > sort
Pour trier les objets par ordre de prix croissant: <dtml-in "articles.objecItems(['DTML Document'])" sort="prix"> Par ordre de prix décroissant: <dtml-in "articles.objecItems(['DTML Document'])" sort="prix" reverse> Voir éventuellement la suite p122. F Filliettaz TECFA

<dtml-tree > Permet de facilement construire dynamiquement un arbre en HTML pour décrire une structure hiérarchique. <dtml-var standard_html_header> <dtml-tree> <dtml-var getId> </dtml-tree> </dtml-var standard_html_footer> Voir éventuellement la suite p122. F Filliettaz TECFA

Page Template Outil de génération de pages web
Pour que designers et programmeurs puissent travailler facilement ensemble Le designer peut faire évoluer le design sans se préoccuper du contenu des pages Page Template génère des pages HTML ou XML, pas des pages dynamiques (apanage de DTML). Voir éventuellement la suite p122. F Filliettaz TECFA

Page Template création
Depuis le add drop-down choisir Page Template, lui donner un id. Pour les détails, voir Zope Book p.67ss et 135ss. Un excellent article décrit en détail le processus: Voir éventuellement la suite p122. F Filliettaz TECFA

CMF un portail avec ZOPE
Exemple: Zopera.org, Liens: (CMF, CMF francisés, liens cassés…) Création d'un skin : Docs : Voir éventuellement la suite p122. F Filliettaz TECFA

Dans un nouveau Folder (il est ainsi possible d'avoir plusieurs configurations différentes): Ajouter l'objet CMFSite, qui permet d'administrer le site. Remplir les champs Il y a 4 pages: Home Page Member Page News Page Search Page Voir éventuellement la suite p122. F Filliettaz TECFA

Chaque membre peut changer, pour lui, le look de l'espace qu'il peut atteindre. Le site possède un skin par défaut, et les différents skin qu'il met à disposition. Pour changer de skin: Dans CMFSite/portal_skin -> onglet "content" Ajouter un nouveau Folder (p.ex MonSkin) Pour changer les couleurs p.ex aller dans portal_skin/Nouvelle/stylesheet_properties Sous "Customize" sélectionner p.ex MonSkin et cliquer sur Customize "Customizer" votre skin. Voir éventuellement la suite p122. F Filliettaz TECFA

Pour mettre ce nouveau skin à disposition des membres, aller à l'ongler Porperties de portal_skin et ajouter : Name: My Skin Layers: MySkin, custom, nouvelle, content, generic, control Le skin est maintenant ajouté au Préférences. Voir éventuellement la suite p122. F Filliettaz TECFA

Pour des changements plus consistants, il va falloir changer le Layout, c'est-à-dire intervenir dans le code des DTML Methods, le plus difficile étant de trouver la bonne. Les Folders de portal_skin contiennent toutes les méthodes nécessaires pour les pages CMF. Elles sont sous portal_skin/ onglet Content/generic. Pour se faire la main, changer le contenu de standard_html_header, index_html et stabdard_html_footer. Le site entier changera. Voir éventuellement la suite p122. F Filliettaz TECFA

Voir éventuellement la suite p122. F Filliettaz TECFA

Pour des changements plus consistants, il va falloir changer le Layout, c'est-à-dire intervenir dans le code des DTML Methods, le plus difficile étant de trouver la bonne. Les Folders de portal_skin contiennent toutes les méthodes nécessaires pour les pages CMF. Elles sont sous portal_skin/ onglet Content/generic. Pour se faire la main, changer le contenu de standard_html_header, index_html et stabdard_html_footer. Le site entier changera. Voir éventuellement la suite p122. F Filliettaz TECFA

Ressources Liens Sites
Le livre Zope : CMF : Sites Voir éventuellement la suite p122. F Filliettaz TECFA

Ressources Autres liens intéressants:
E-books : Voir éventuellement la suite p122. F Filliettaz TECFA

F Filliettaz TECFA 02 2002.

Présentations similaires

Présentation au sujet: "F Filliettaz TECFA 02 2002."— Transcription de la présentation:

Présentations similaires

Notre projet

Feed-back

Entrer

S'autoriser via un réseau social:

F Filliettaz TECFA 02 2002.

Présentations similaires

Présentation au sujet: "F Filliettaz TECFA 02 2002."— Transcription de la présentation:

Présentations similaires

Notre projet

Feed-back