The content node -- Le noeud de contenu

Date de publication: le mardi 22 mars 2011 à 18h00
Dernière modification: par Pascal BOYER le dimanche 27 mars 2011 à 16h33

28/09/2010 10:39

versions 3.9, 3.10, 4.x

When the system is in use, new content objects are created on the fly. For example, when a news article is composed, a new article object is created. Obviously, the content objects can't just hover around in space, they have to be organized in some way. This is where the nodes and the content node tree comes in. A content node is nothing more than an encapsulation of a content object. In eZ Publish, every object is usually represented by one or more nodes. The following illustration shows a simplified example of a node and a corresponding object (which is referenced by the node) as it would have been represented inside the system. 
Lorsque le système est en fonctionnement, de nouveaux objets de contenu sont créés à la volée. Lorsqu'un article de news est écrit par exemple, un nouvel objet article est créé. Il est évident que les objets de contenu ne peuvent pas flotter comme ça dans l'espace et doivent être, au contraire, organisés d'une manière ou d'une autre. Et c'est là que les nœuds et l'arbre de nœuds de contenu entrent en jeu. Un nœud de contenu n'est rien d'autre qu'une encapsulation d'un objet de contenu. Dans eZ Publish, tout objet est représenté par un ou plusieurs nœuds. L'illustration suivante présente l'exemple simple d'un nœud et de l'objet correspondant (qui est référencé par le nœud) comme s'il était représenté à l'intérieur du système.

Object - node relation
Relation Objet <-> Nœud

The content node tree is built up of nodes. A node is simply a location of an object within the tree structure. The tree is the actual mechanism used to hierarchically organize the objects that are present on the system. The content node tree is explained in the next section. 
L'arbre de nœuds de contenu est constitué de nœuds. Un nœud représente simplement l'emplacement d'un objet dans la structure de l'arbre. L'arbre est un mécanisme utilisé pour organiser hiérarchiquement les objets présents dans le système. L'arbre de nœuds de contenu fait l'objet du prochain article.

Node structure / Structure d'un nœud

A content node consists of the following elements: 
Un nœud de contenu est composé des éléments suivants:

• Node ID 
  du numéro de ID du nœud

• Parent node ID 
  du numéro de ID du nœud parent

• Object ID 
  du numéro de ID de l'objet encapsulé

• Sort method 
  d'une méthode de tri

• Sort order 
  d'un ordre de tri

• Priority 
  d'une priorité

Node ID / ID du nœud

Every node has a unique identification number. The ID numbers are used by the system to organize and keep track of the different nodes. These ID numbers are not recycled. In other words, if a node is deleted, the ID number of that node will not be reused when a new node is created. 
Chaque nœud a un numéro d'identifiant unique. Les numéros d'identifiant sont utilisés par le système pour organiser et garder une trace des différents nœuds. Ces numéros de ID ne sont pas recyclés, c'est à dire que si un nœud est supprimé, le numéro de ID de ce nœud ne sera plus jamais utilisé lors de la création d'un nouveau nœud.

Parent node ID / ID du nœud parent

The parent node ID of a node reveals the node's superior node in the tree. 
Le numéro de ID du nœud parent correspond au nœud de niveau supérieur dans l'arbre.

Object ID / ID de l'objet

Every object that exists in the system has a unique identification number. The object ID of a node pinpoints the actual object that the node encapsulates. 
Chaque objet existant dans le système possède un numéro d'identifiant unique. Le numéro de ID d'objet d'un nœud pointe vers l'objet encapsulé par le nœud.

Sort method / Méthode de tri

The sorting method of a node determines how the children of the node should be sorted. The following sorting methods are possible:
La méthode de tri d'un nœud détermine la façon dont les enfants du nœud doivent être triés. Les méthodes de tri suivantes sont possibles: 

Please note that it is possible to combine the available sort methods in order to sort nodes in a more complex way. However, since a node is incapable of "remembering" a combination (you can only set one method and one order for each node), this has to be done in the templates. 
Notez que bien qu'il soit possible de combiner différentes méthodes de tri afin d'obtenir un tri plus complexe des nœuds, cette pratique est réservée aux templates dans la mesure où un nœud ne peut se souvenir d'une combinaison de tri (on ne peut paramétrer qu'une méthode et qu'un seul ordre de tri par nœud).

Sort order / Ordre de tri

The sorting order determines the order in which the children of the node should be sorted. There are two possibilities: 
L'ordre de tri détermine l'ordre dans lequel les enfants du nœud sont triés. Il existe deux possibilités:

• Descending (0 / FALSE) 
  Par ordre décroissant (0 / FALSE)

• Ascending (1 / TRUE) 
  Par ordre croissant (1 / TRUE)

For example, if the sorting method is set to "Name" and the sort method is set to "Ascending", the underlying nodes will be alphabetically sorted from A to Z. If the sort method is set to "Descending", the underlying nodes will be sorted from Z to A. 
Si la méthode de tri est basée par exemple sur le Nom et que l'ordre de tri est Croissant alors les nœuds sous-jacents seront triés par ordre alphabétique de A à Z. Si l'ordre de tri est Décroissant, alors les nœuds seront classés de Z à A.

Priority / Priorités

The priority field allows a user to assign both positive and negative integer values to a node (zero is also allowed). This field makes it possible to sort nodes in a custom way. If the sorting method of a node is set to "Priority", the children of that node will be sorted by their priorities. 
Le champ priorité permet aux utilisateurs d'assigner des valeurs entières positives, négatives ou nulles aux nœuds. Ce champ rend possible le classement des nœuds dans n'importe quel ordre. Si la méthode de tri est fixée à Priorité, les enfants du nœud seront triés en fonction de la valeur de leur priorité.

Commentaires