REST : Pièces jointes

Vous pouvez utiliser le service REST pour joindre des images à certains types d'élément. Cela équivaut à utiliser l'icône Insérer une image dans le portlet de création.

Une pièce jointe est une ressource d'image qui est associée à un autre objet contenant du texte HTML et qui peut être référencée à partir de cet objet. Les pièces jointes constituent un type spécial d'objet dans le service REST car elles ne peuvent pas être référencées directement. En effet, elles ne sont pas associées à un URI lorsqu'elles sont créées. Une pièce jointe ne peut pas être lue ni mise à jour, mais peut être supprimée indirectement par le biais d'une mise à jour de l'objet parent.
Les pièces jointes peuvent être ajoutées aux types d'objet suivants :
  • Modèles de présentation
  • Composants RTF
  • Composants HTML
Remarque : Vous devez créer l'objet et ajouter un élément de texte enrichi ou HTML avant de créer la pièce jointe.

Création

/ITEM-TYPE/ITEM-UUID/attachments
Content-Type : image/*

Lorsque vous créez une pièce jointe, les données binaires (mais pas le codage) d'une image sont envoyées à la collection de pièces jointes d'un élément. La zone d'en-tête Content-Type est associée au type d'image approprié. Par exemple: image/jpg, image/png

Exemple :
HTTP/1.1 POST 
http://host:port/wps/mycontenthandler/wcmrest/LibraryHTMLComponent/ITEM-UUID/attachments
Content-Type: image/jpg
(… binary data … )

201 Created

Lecture

Non pris en charge.

Mise à jour en cours

Non pris en charge

Supprimer

Une pièce jointe ne peut pas être référencée directement via le service REST, ce qui signifie qu'elle ne peut pas être supprimée directement. Toutefois, vous pouvez la supprimer indirectement en effectuant une opération de mise à jour sur l'objet parent.
Voici un exemple de marquage stocké dans un composant HTML :
<h1> Example Delete </h1>
<img src='/wps/wcm/myconnect/65132264-fd8b-461c-b6ec-ccdd22524ea6/image.jpg?MOD=AJPERES'
 alt='' title='' border='0'  />
Pour supprimer l'image, vous devez soumettre la demande de mise à jour suivante :
HTTP/1.1 PUT 
http://host:port/wps/mycontenthandler/wcmrest/LibraryHTMLComponent/ITEM-UUID/
Content-Type: text/html

<h1> Example Delete </h1>

200 OK