Utilisation de REST avec des éléments (avant la version 8.5 CF03)

Vous pouvez utiliser le service REST de Web Content Manager pour créer, lire, mettre à jour et supprimer certains types d'élément stockés dans des zones de site et des objets de contenu. Tous les types d'élément sont pris en charge.

Créer

Vous pouvez créer un élément en envoyant une demande POST à l'URI suivant avec une entrée Atom représentant le titre de l'élément :

/[Content|SiteArea]/<parent-uuid>/elements

Remarque : Le type de l'élément à créer doit être spécifié dans la zone de type de l'entrée qui est envoyée.

Par exemple:

POST /wps/mycontenthandler/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements HTTP/1.0
Content-type: application/atom+xml

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:wcm="wcm/namespace">
    <title>Number Element Title</title>
    <wcm:name>numericElementName</wcm:name>
    <wcm:type>NumericComponent</wcm:type>
</entry>


HTTP/1.0 201 Created
Content-type: application/atom+xml; type=entry
Content-location: /wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:wcm="wcm/namespace">
    <title>Number Element Title</title>
    <link rel="edit-media" type="text/plain" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName"/>
    <link rel="edit" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName"/>
    <wcm:name>numericElementName</wcm:name>
    <wcm:type>NumericComponent</wcm:type>
</entry>

Mettre à jour

Vous pouvez mettre à jour un élément en envoyant une demande PUT à l'URI suivant avec une entrée Atom incluant le nom et le titre de l'élément.

/[Content|SiteArea]/<parent-uuid>/elements/<element-name-encoded>

Par exemple:

PUT /wps/mycontenthandler/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericComponentName HTTP/1.0
Content-type: application/atom+xml

<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:wcm="wcm/namespace">
    <title>numericElementTitleUpdated</title>
    <wcm:name>numericElementNameUpdated</wcm:name>
</atom:entry>


HTTP/1.0 200 OK
Content-type: application/atom+xml; type=entry

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:wcm="wcm/namespace">
    <title>numericComponentTitleUpdated</title>
    <link rel="edit-media" type="text/plain" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementNameUpdated"/>
    <link rel="edit" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementNameUpdated"/>
    <wcm:name>numericElementNameUpdated</wcm:name>
    <wcm:type>NumericComponent</wcm:type>
</entry>

Lire

Vous pouvez lire un élément en envoyant une demande GET à l'URI suivant :

/[Content|SiteArea]/<parent-uuid>/elements/<element-name-encoded>

Par exemple:

GET /wps/mycontenthandler/wcmrest/Content/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName HTTP/1.0


HTTP/1.0 200 OK
Content-type: application/atom+xml; type=entry

<entry xmlns="http://www.w3.org/2005/Atom" xmlns:wcm="wcm/namespace">
    <title>numericElementTitleUpdated</title>
    <link rel="edit-media" type="application/vnd.ibm.wcm+xml" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName"/>
    <link rel="edit" href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/numericElementName"/>
    <wcm:name>numericElementName</wcm:name>
    <wcm:type>NumericComponent</wcm:type>
</entry>

Supprimer

Vous pouvez supprimer un élément en envoyant une demande DELETE à l'URI suivant :

/[Content|SiteArea]/<parent-uuid>/elements/<element-name-encoded>

Par exemple:

DELETE

HTTP/1.1 DELETE
http://host:port/wps/mycontenthandler/wcmrest/Content/<parent-uuid>/elements/<element-name-encoded>

Réponse

Status Code :200
Status Message : OK

Spécification de données brutes

Le contenu d'un élément est accessible à partir de la ressource de support spécifiée dans l'attribut HREF du lien edit-media. Le lien contient également un attribut TYPE qui spécifie le type de support admis pour le contenu. Par exemple:

<link rel="edit-media" type="text/html" 
href="/wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/heading"/>

La liste complète de types de support est documentée ici : Types de support pris en charge.

Pour mettre à jour un élément, envoyez une demande PUT pour placer un contenu sur un type de support admis à l'adresse URL edit-media. Par exemple:

PUT /wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/heading HTTP/1.0
Content-type: text/html

<h1>Heading Text</h1>


HTTP/1.0 200 OK

Pour extraire du contenu à partir d'un composant de bibliothèque, envoyez une demande GET pour obtenir du contenu à partir de l'adresse URL edit-media. Par exemple:

GET  /wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/heading HTTP/1.0
Accept: text/html


HTTP/1.0 200 OK
Content-type: text/plain

<h1>Heading Text</h1>

Au lieu de spécifier le type de support dans l'en-tête HTTP accept, vous pouvez aussi utiliser le paramètre de demande mime-type. Vous devez coder la valeur dans l'URL. Par exemple:

GET  /wps/mycontenthandler/!ut/p/wcmrest/SiteArea/c6b00ee6-d628-4cbd-9e65-15c90f2093a6/elements/heading?mime-type=text%2Fhtml HTTP/1.0


HTTP/1.0 200 OK
Content-type: text/plain

<h1>Heading Text</h1>