The content object -- L'objet de contenu

Date de publication: le mardi 22 mars 2011 à 18h00
Dernière modification: par Pascal BOYER le vendredi 25 mars 2011 à 18h21

22/02/2011 01:45

versions 3.9, 3.10, 4.x

A content object is an instance of a content class. While the class only defines the data structure, it is the content objects themselves that contain actual data. Once a content class is defined, several content objects / instances of that class can be created. For example, if a class for storing news articles is created, several article objects (each containing a different story) can then be instantiated. The following illustration summarizes and shows the relation between datatypes, attributes, a content class and content objects. 
Un objet de contenu est une instance d'une classe. Alors qu'une classe ne fait que définir une structure de données, ce sont les objets de contenu qui contiennent les données. Une classe de contenu une fois définie, plusieurs objets de contenu, c'est à dire plusieurs instances de cette classe peuvent être créés. Par exemple, si une classe dédiée au stockage (c'est à dire, à la publication) d'articles de news est créée, plusieurs objets article (chacun d'eux contenant des textes différents) peuvent être instanciés. L'illustration ci-dessous résume et présente la relation entre les datatypes, les attributs, une classe de contenu et les objets de contenu:

Datatypes, attributes, a content class and objects
Datatypes, attributs, classes de contenu et objets

Please note that the illustration above is a simplified version of the reality. It doesn't show the exact structure of the objects since the versioning and the translation layers have been left out. The following text gives a more in-depth explanation of the object structure. The versioning and the translation layers will be explained in the upcoming sections. 
Notez que l'illustration ci-dessus n'est qu'une simplification de la réalité. Elle ne montre pas la structure exacte des objets puisque la couche de gestion des versions et la couche de traduction ont été omises. La suite du présent article explique en profondeur la structure d'un objet. Les couches de gestion des versions et de traduction font, quant à elles, l'objet des deux prochains articles.

Note: A non-technical understanding of the "Content Object": one piece of content like an article, a picture or a movie, managed by eZ Publish. Describing attributes like author, title, subtitle etc. are belonging to the content object. A single content object can have different translations and versions. One and the same object can be used and displayed in several channels and contexts – i.e. one picture, used in different publications is still regarded as one content object.
Note: présentation non technique d'un objet de contenu: un morceau de contenu, comme un article, une photo ou une vidéo, géré par eZ Publish. Des attributs de description (???) tels que l'auteur, le titre, le sous-titre, etc... appartiennent à l'objet de contenu. Alors qu'un même objet de contenu peut avoir plusieurs traductions et plusieurs versions, il peut être également utilisé et affiché via divers canaux d'affichage et dans divers contextes - e.g: une image utilisée dans plusieurs articles ne compte que pour un seul objet de contenu.

Object structure / Structure d'un objet

A content object consists of the following elements: 
Un objet de contenu est composé des éléments suivants:

• Object ID 
  d'un numéro de ID (IDentifiant)

• Name 
  d'un nom

• Type 
  d'un type

• Owner 
  d'un propriétaire

• Creation time 
  d'une date de création

• Modification time 
  d'une date de modification

• Status 
  d'un statut

• Section ID 
  d'un numéro de ID de section

• Versions 
  de plusieurs versions

• Current version 
  d'une version courante

Object ID / Numéro d'IDentifiant de l'objet

Every object has a unique identification number. The ID numbers are used by the system to organize and keep track of different objects. These ID numbers are not recycled. In other words, if an object is deleted, the ID number of that object will not be reused when a new object is created. 
Chaque objet possède un numéro d'identifiant unique. Les numéros de ID sont utilisés par le système pour organiser et garder une trace des différents objets. Ces numéros de ID ne sont pas recyclés, ce qui signifie que lorsqu'un objet est supprimé, le numéro de ID de cet objet n'est plus jamais réutilisé, pas même lors de la création d'un nouvel objet.

Name / Nom de l'objet

The name of an object is nothing more than a friendly name that appears in various lists throughout the administration interface. It helps the user to identify different objects by their names instead of having to deal with identification numbers. An object's name is generated automatically by the system when the object is published. It is the object name pattern definition of a class that dictates how objects of that class should be named. This mechanism makes it possible to automatically generate names based on the object's attributes. Since the object name is not used by the system, different objects can have the exact same name. 
Le nom d'un objet n'est rien d'autre qu'un nom choisi par l'utilisateur et qui apparaît dans plusieurs endroits de l'interface d'administration. Il aide l'utilisateur à identifier les différents objets par leur noms plutôt que de devoir se souvenir et jongler avec des numéros de ID. Un nom d'objet est généré automatiquement par le système lorsqu'un objet est publié. C'est le Modèle de nom d'objet d'une classe qui détermine comment les objets de cette classe devront être nommés. Ce mécanisme rend possible la génération automatique des noms basée sur les attributs des objets. De plus, puisque les noms des objets ne sont pas utilisés par le système, il devient possible d'avoir plusieurs objets ayant le même nom.

For example, when dealing with news articles, the title of the article would most likely be used to generate the object names. When an article object is published, its name will be a copy of the object's title attribute. The name of the object will be updated every time the object is published. In other words, if the title is changed, the object's name will automatically also be changed. 
Lorsque l'on a, par exemple, affaire à des articles de news, le titre de l'article sera utilisé, dans la plupart des cas, pour générer le nom des objets. Quand un objet article est publié, son nom est une copie de l'attribut titre de l'objet. Le nom de l'objet est mis à jour chaque fois que l'objet est publié. En d'autres termes, si le titre change, le nom de l'objet change automatiquement.

Type / Type de l'objet

The type information indicates which class that was used to create the object. 
Le type de l'objet renseigne sur la classe qui a été utilisée pour créer l'objet.

Owner / Propriétaire de l'objet

The object's owner contains a reference to the user who initially created the object. At any time, an object can only be owned by one user. This reference is set by the system the first time the object is published. The ownership of an object can not be manipulated and will not change even if the owner the object is removed from the system. 
Le propriétaire d'un objet contient une référence à l'utilisateur ayant créé l'objet. En toutes circonstances, un objet ne peut avoir qu'un seul propriétaire et cette référence à ce dernier est gérée par le système lors de la première publication de l'objet. La propriété d'un objet ne peut être manipulée et ne changera plus même si le propriétaire de l'objet est supprimé du système.

Creation time / Date de création de l'objet

The published field contains a time-stamp pinpointing the exact date and time when the object was published for the first time. This information is set by the system and it can not be modified. The published timestamp will remain the same regardless of what happens to the object. 
Le champ published (publié) contient, au format temps Unix, l'heure et la date exactes de première publication de l'objet. Cette information est gérée par le système et ne peut être modifiée. Le temps Unix de première publication restera le même, quoiqu'il arrive à l'objet.

Modification time / Date de modification de l'objet

The modified field contains a time-stamp revealing the exact date and time when the object was modified. This information is set by the system and it can not be modified. The modified timestamp will change every time the object is published. 
Le champ modified (modifié) contient, au format temps Unix, l'heure et la date exactes de modification de l'objet. Cette information est gérée par le système et ne peut être modifiée. Le temps Unix de modification évoluera à chaque nouvelle publication de l'objet.

Status / Statut de l'objet

The status indicates the current state of the object. There are three possibilities: 
Le statut indique l'état courant de l'objet. Trois états sont possibles:

• (0) Draft - Brouillon

• (1) Published - Publié

• (2) Archived - Archivé

When initially created, the object's status is set to   draft . This status will remain until the object is published and thus the status will be set to   published  . Once published, the object can not become a draft. When a published object is moved to the trash, the status will be set to   archived  . If a published object is removed from the trash (or removed without being put in the trash first), it will be permanently deleted. 
Au départ, lorsque l'on crée un objet, celui-ci a le statut de brouillon. Ce statut sera conservé jusqu'à la première publication de l'objet dont le statut passera alors à publié. Une fois publié, l'objet ne peut plus devenir un brouillon mais s'il est mis à la poubelle alors son statut passe à archivé. Enfin, si un objet est supprimé de la poubelle (ou supprimé définitivement sans être gardé dans la poubelle), l'objet sera définitivement supprimé.

Section / Section de l'objet

The section ID of an object denotes which section that object belongs to. Each object can belong to one section. By assigning different sections to objects, it is possible to have different groups of objects. The section mechanism is explained under Sections. 
Le numéro de ID de la section d'un objet permet de savoir à quelle section appartient l'objet. Tout objet appartient à une section. En assignant différentes sections aux objets, il devient possible d'avoir différents groupes d'objets. Le mécanisme de gestion des sections est expliqué au paragraphe Sections .

Versions / Les versions de l'objet

The actual contents of an object is stored inside different versions. A version can be thought of as a timestamped collection of data (the object's attributes) that belongs to a specific user. Every time the contents of an object is edited, a new version is created. It is always the new version that will be edited. The current / published version along with earlier versions will remain untouched. This makes it possible to revert unwanted or accidental changes. An object always has at least one version of its content. Each version is identified by a number which is automatically increased for every new version that is created. The structure and logic of the versioning mechanism is explained in the next section. 
Le contenu d'un objet est stocké dans différentes versions. Une version peut être pensée comme un ensemble de données (les attributs de l'objet) lié à un temps Unix et appartenant à un utilisateur spécifique. Chaque fois que le contenu d'un objet est édité, une nouvelle version est créée et c'est toujours la nouvelle version qui sera éditée la fois prochaine. La version courante/plubliée, tout comme les versions précédentes, restera inchangée. Il devient dès lors possible de revenir en arrière suite à des changements ou modifications involontaires. Un objet possède toujours au moins une version de son contenu. Chaque version est identifiée par un nombre automatiquement incrémenté à chaque nouvelle version. La struture et la logique du mécanisme de gestion des versions sont expliquées dans le prochains article.

Current version / La version courante de l'objet

The current version is a number that pinpoints the currently published version of the object. As described above, the contents of an object may exist in several versions. However, only one of them can be the current version (also referred to as the   published   version). The current/published version is the version that will be displayed when the object is viewed. 
La version courante est un nombre indiquant la version publiée d'un objet. Comme décrit ci-dessus, le contenu d'un objet peut exister sous différentes versions, mais une seule d'entre elles est la version courante (aussi référencée en tant que version publiée). Elle représente la version qui est affichée lorsqu'un objet est vu (donc affiché).

Commentaires