Cycle de vie

La commande create crée un nouveau noeud de contenu. La commande derive crée un nouveau noeud de contenu pour une page dérivée d'une autre page. La commande delete supprime un noeud de contenu.

Lorsque vous créez un nouveau noeud de contenu, le parent du nouveau noeud doit être sélectionné. Le premier argument de création correspond au type du nouveau noeud. Les types pris en charge sont label, page et externalurl. Pour obtenir d'autres noms plus courts, consulter l'aide relative aux beans. Il est impossible de créer un nœud du type internalurl à partir d'un script.

Le second argument correspond au nom du nouveau noeud. Il fait office de titre anglais provisoire à partir duquel le nom usuel du nouveau noeud est déterminé. Le dernier argument correspond à un marquage qui est pris en charge par ces noeuds. Des marquages supplémentaires peuvent être activés en manipulant la liste des marquages. Pour plus d'informations, voir Attributs valorisés de liste. La commande create renvoie l'ID du nœud venant d'être créé. Si le mot clé select est ajouté à la commande, le nœud créé passe alors en mode sélection.

Le cas échéant, le script peut spécifier un indicateur de partage qui indique si la nouvelle page est une page partagée (shared) ou une page non partagée (nonshared). L'indicateur facultatif private-flag indique si la nouvelle page est privée ou publique (les valeurs possibles sont private et public). Cet indicateur n'est valable que si le type du nœud de contenu correspond à page.

Lors de la dérivation d'une page, le parent de cette nouvelle page dans l'arborescence de contenu doit être sélectionné. Seules les pages partagées et publiques peuvent être utilisées comme pages de base pour la dérivation. Le premier argument correspond au nom de la nouvelle page. Le type du noeud est implicite, puisque seules les pages peuvent être dérivées.

Le deuxième argument correspond au mot clé from et le troisième argument à l'identificateur de la page à partir de laquelle effectuer la dérivation from. Les marquages pris en charge sont identiques à ceux de la page de base. La commande derive renvoie l'ID du nœud venant d'être créé. Si le mot clé select est ajouté à la commande, le nœud créé passe alors en mode sélection.

Il est déconseillé de se fier au nom paramétré en tant que titre anglais, car ce paramétrage peut changer ultérieurement. Paramétrez le titre anglais de manière explicite si vous envisagez de prendre en charge l'environnement local en. Toutefois, le nom usuel est élaboré à partir de l'argument du nom.

Content.create(type, name, markup)
Content.create(type, name, markup, "select")
Content.create(type, name, markup, [shared_flag,]
[private_flag,] "select")

Content.derive(name, "from", ID)
Content.derive(name, "from", ID, "select")

# example: create and select a label at the first level,
#          then create a derived page under the new label
Content.select("the", "root")
Content.create("label", "Leisure", "html", "select")
Content.derive("Movies", "from", node_ID)

$Content create type name markup
$Content create type name markup select
$Content create type name markup [shared_flag] [private_flag] 
select

$Content derive name from ID
$Content derive name from ID select

# example: create and select a label at the first level,
#          then create a derived page under the new label
$Content select the root
$Content create label "Leisure" html select
$Content derive "Movies" from node_ID

Pour créer une page statique, exécutez la commande suivante :

Content.create(staticpage, title, markup, zip_file_name, filename, displayoption, "select")

$Content create staticpage title markup zip_file_name filename [displayoption] [select]

L'exemple précédent crée une page statique sous le nœud de contenu actuellement sélectionné pour le marquage HTML, avec le titre de page MyStaticPageTitle. Vous pouvez lire le contenu de la page à partir de c:/tmp/StaticContentPage.zip. Le point d'entrée pour l'affichage de la page est lu à partir du fichier index.html, lequel doit être contenu dans le fichier d'archive ZIP. Pour spécifier la méthode d'affichage, vous pouvez utiliser le paramètre facultatif displayoption. Celui-ci accepte l'une des valeurs suivantes : inline, iframe ou ajax. Sa valeur par défaut est : inline. Pour faire de la page statique que vous venez de créer le noeud de contenu actuellement sélectionné, utilisez le paramètre facultatif select.

Pour obtenir le contenu d'une page statique sous le format d'un fichier d'archive ZIP, exécutez la commande suivante :

Content.pageget(oid, markup, zip_file_name)

$Content pageget oid  markup  zip_file_name

L'exemple précédent écrit le contenu de la page statique spécifiée dans le fichier c:/tmp/MyStaticContentPage.zip.

Pour définir le contenu de la page statique en spécifiant un nom de fichier ZIP, utilisez la commande suivante :

Content.pageset(oid, markup, zip_file_name, filename)

$Content pageset oid markup zip_file_name filename

L'exemple précédent met à jour le contenu de la page statique spécifiée avec le contenu du fichier c:/tmp/NewStaticContentPage.zip. Le point d'entrée pour l'affichage de la page est lu à partir du fichier index.html, lequel doit être contenu dans le fichier d'archive ZIP.

La commande delete supprime un nœud de contenu sans enfant. Il est impossible de supprimer des noeuds dotés d'enfants. Pour diminuer le risque de suppression accidentelle, cette commande nécessite toujours l'ID en tant qu'argument, même si le noeud à supprimer est sélectionné.

Lors de la suppression d'une page, toutes les pages qui sont dérivées de cette page sont également supprimées. Cette action affecte également les autres utilisateurs dont les pages sont dérivées de cette page de base. Si le noeud en mode de sélection est supprimé soit directement, soit à la suite de la suppression d'une page de base, Le bean n'est plus sélectionné.

Content.delete(ID)

$Content delete ID