Un `instance` réferre à une installation spécifique d'un ou plusieurs cubes 

où sont regroupés tous les fichiers de configuration de l'application web finale.

.. image:: images/login-form.png

.. image:: images/blog-demo-first-page.png

Rappelez-vous que pour le moment, tout a été géré par la plate-forme

`CubicWeb` et que la seule chose qui a été fournie est le schéma de

données. 

Créons des entités

------------------

Nous allons maintenant créer quelques entités dans notre application.

Créez un Blog

~~~~~~~~~~~~~

Créons à présent quelques entités. Cliquez sur `[+]` sur la

droite du lien Blog. Appelez cette nouvelle entité Blog ``Tech-Blog``

et tapez pour la description ``everything about technology``,

puis validez le formulaire d'édition en cliquant sur le bouton

``Validate``.

.. image:: images/cbw-create-blog.en.png

   :alt: from to create blog

En cliquant sur le logo situé dans le coin gauche de la fenêtre,

vous allez être redirigé vers la page d'accueil. Ensuite, si vous allez 

sur le lien Blog, vous devriez voir la liste des entités Blog, en particulier

celui que vous venez juste de créer ``Tech-Blog``.

.. image:: images/cbw-list-one-blog.en.png

   :alt: displaying a list of a single blog

Si vous cliquez sur ``Tech-Blog`` vous devriez obtenir une description

détaillée, ce qui dans notre cas, n'est rien de plus que le titre

et la phrase ``everything about technology``

Maintenant retournons sur la page d'accueil et créons un nouveau

Blog ``MyLife`` et retournons sur la page d'accueil, puis suivons

le lien Blog et nous constatons qu'à présent deux blogs sont listés.

.. image:: images/cbw-list-two-blog.en.png

   :alt: displaying a list of two blogs

Créons un article

~~~~~~~~~~~~~~~~~

Revenons sur la page d'accueil et cliquons sur `[+]` à droite du lien

`articles`. Appellons cette nouvelle entité ``Hello World`` et introduisons

un peut de texte avant de ``Valider``. Vous venez d'ajouter un article

sans avoir précisé à quel Blog il appartenait. Dans la colonne de gauche

se trouve une boite intitulé ``actions``, cliquez sur le menu ``modifier``.

Vous êtes de retour sur le formulaire d'édition de l'article que vous 

venez de créer, à ceci près que ce formulaire a maintenant une nouvelle

section intitulée ``ajouter relation``. Choisissez ``entry_of`` dans ce menu,

cela va faire apparaitre une deuxième menu déroulant dans lequel vous

allez pouvoir séléctionner le Blog ``MyLife``.

Vous auriez pu aussi, au moment où vous avez crée votre article, sélectionner

``appliquer`` au lieu de ``valider`` et le menu ``ajouter relation`` serait apparu.

.. image:: images/cbw-add-relation-entryof.en.png

   :alt: editing a blog entry to add a relation to a blog

Validez vos modifications en cliquant sur ``Valider``. L'entité article

qui est listée contient maintenant un lien vers le Blog auquel il 

appartient, ``MyLife``.

.. image:: images/cbw-detail-one-blogentry.en.png

   :alt: displaying the detailed view of a blogentry

Rappelez-vous que pour le moment, tout a été géré par la plate-forme

`CubicWeb` et que la seule chose qui a été fournie est le schéma de

données. D'ailleurs pour obtenir une vue graphique du schéma, visitez

le lien `Application schema`` a l'URL suivante :

http://localhost:8080/view?vid=schema

.. image:: images/cbw-schema.en.png

   :alt: graphical view of the schema (aka data-model)

Le principe de sélection des vues

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Une vue est une classe Python qui inclut:

  - un identifiant (tous les objets dans `CubicWeb` sont listés

    dans un registre et cet identifiant est utilisé comme la clé)

  - un filtre de sélection de `result sets` auxquels il

    peut s'appliquer

`CubicWeb` fournit un ensemble de vues standard pour le type d'objet

`EntityView`. vous poubez les trouver listées dans ``cubicweb/web/views``.

Une vue est appliquée sur un `result set` qui représente l'ensemble

des entités que nous cherchons à appliquer. `CubicWeb` utilise un

sélecteur qui permet de calculer un score et d'identifier la vue

la plus adaptée au `result set` que nous voulons afficher. La librarie

standard des sélecteurs se trouve dans ``cubicweb.common.selector`` 

et une librairie des méthodes utilisées pour calculer les scores 

est dans ``cubicweb.vregistry.vreq``.

Il est possible de définir plusieurs vues ayant le meme identifiant

et d'y associer des sélecteurs et des filtres afin de permettre à 

l'application de s'adapter au mieux aux données que nous avons 

besoin d'afficher. Nous verrons cela plus en détails dans :ref:`DefinitionVues`.

On peut citer l'exemple de la vue nommée ``primary`` qui est celle utilisée

pour visualiser une entité seule. Nous allons vous montrer comment modifier 

cette vue.

Modification des vues

~~~~~~~~~~~~~~~~~~~~~

Si vous souhaitez modifier la manière dont est rendue un article (`Blogentry`),

vous devez surcharger la vue ``primary`` définie dans le module ``views`` de 

votre cube, ``cubes/blog/views.py``.

Nous pourrions par exemple ajouter devant la date de publication un préfixe

indiquant que la date visualisée est la date de publication.

Pour cela appliquez les modifications suivantes: 

  class BlogEntryPrimaryView(baseviews.PrimaryView):

    def cell_call(self, row, col):

        entity = self.entity(row, col)

        # display entity attributes with prefixes

        self.w(u'<h1>%s</h1>' % entity.title)

        self.w(u'<p>published on %s</p>' % entity.publish_date.strftime('%Y-%m-%d'))

        self.w(u'<p>%s</p>' % entity.content)

        # display relations

        siderelations = []

        if self.main_related_section:

            self.render_entity_relations(entity, siderelations)

.. note::

  Lors qu'une vue est modifiée il n'est pas nécessaire de relancer

  l'application. Sauvez juste le fichier Python et rechargez la page

  dans votre navigateur afin de visualiser les modifications.

Nous pouvons voir que la date de publication est préfixée comme souhaitée.

.. image:: images/cbw-update-primary-view.en.png

   :alt: modified primary view

Le code que nous avons modifié définit une vue primaire pour une entité de 

type `BlogEntry`. 

Etant donné que les vues sont appliquées sur des `result sets` et que 

les `result sets` peuvent être des tableaux de données, il est indispensable

de récupérer l'entité selon ses coordonnées (row,col).

La méthode ``self.w()`` est utilisée pour afficher des données. En particulier

dans notre exemple, nous l'utilisons pour afficher des tags HTML et des valeurs

des attributs de notre entité.