Utilisation de REST pour la gestion des objets récents

Vous pouvez utiliser les services REST pour afficher la liste des objets auxquels vous avez accédé récemment. Cette fonction équivaut à utiliser la vue Eléments récents dans l'explorateur de bibliothèque.

Remarque : Par défaut, les objets accessibles via le service REST sont ajoutés à la liste des objets récents. Pour empêcher les objets accessibles via le service REST d'apparaître dans la liste des objets récents, affectez au paramètre rest.default.add-recent la valeur false dans le service WCM WCMConfigService à l'aide de la console WebSphere® Integrated Solutions Console. Le paramètre rest.default.add-recent peut être remplacé demande par demande en spécifiant recent=true ou recent=false dans la chaîne de requête.

URI :

/recent-items

Exemple :

HTTP 1.1 GET /wps/mycontenthandler/wcmrest/recent-items

<feed xmlns="http://www.w3.org/2005/Atom" xmlns:wcm="http://www.ibm.com/xmlns/wcm">
    <id>wcmrest:recent-items</id>
    <title>wcmrest:recent-items</title>
    <updated>2011-09-28T02:51:47.228Z</updated>
    <link rel="next-page" href="/wps/mycontenthandler/!ut/p/wcmrest/recent-items?page=2"/>
    <entry>
        <id>wcmrest:8b629b12-e16a-4afa-bbf5-a37ebee5a5b8</id>
        <title xml:lang="fr-fr">Articles List</title>
        <summary xml:lang="fr-fr"></summary>
        <wcm:name>Articles List</wcm:name>
        <wcm:description xml:lang="fr-fr"></wcm:description>
        <wcm:type>LibraryMenuComponent</wcm:type>
        <updated>2011-09-21T06:21:11.701Z</updated>
        <wcm:lastAccessed>2011-09-26T05:41:50.874Z</wcm:lastAccessed>
        <wcm:lastModifier>
            <wcm:distinguishedName>Replicator</wcm:distinguishedName>
        </wcm:lastModifier>
        <link rel="edit" href="/wps/mycontenthandler/!ut/p/wcmrest/item/8b629b12-e16a-4afa-bbf5-a37ebee5a5b8"/>
        <link rel="library" href="/wps/mycontenthandler/!ut/p/wcmrest/item/8c01ede8-4ccd-410e-9e21-c4c37114f5f2"/>
        <wcm:displayTitle xml:lang="fr-fr">Articles List</wcm:displayTitle>
        <category label="Published" scheme="wcmrest:workflowState" term="PUBLISHED" xml:lang="fr-fr"/>
    </entry>
    <entry>
        <id>wcmrest:4ffeefcc-5539-4271-936a-7bd0ddf1644d</id>
        <title xml:lang="fr-fr">Article Toolbar</title>
        <summary xml:lang="fr-fr"></summary>
        <wcm:name>Article toolbar</wcm:name>
        <wcm:description xml:lang="fr-fr"></wcm:description>
        <wcm:type>LibraryAuthoringToolsComponent</wcm:type>
        <updated>2011-09-21T06:21:21.452Z</updated>
        <wcm:lastAccessed>2011-09-26T05:41:55.544Z</wcm:lastAccessed>
        <wcm:lastModifier>
            <wcm:distinguishedName>Replicator</wcm:distinguishedName>
        </wcm:lastModifier>
        <link rel="edit" href="/wps/mycontenthandler/!ut/p/wcmrest/item/4ffeefcc-5539-4271-936a-7bd0ddf1644d"/>
        <link rel="library" href="/wps/mycontenthandler/!ut/p/wcmrest/item/8c01ede8-4ccd-410e-9e21-c4c37114f5f2"/>
        <wcm:displayTitle xml:lang="fr-fr">Article toolbar</wcm:displayTitle>
        <category label="Published" scheme="wcmrest:workflowState" term="PUBLISHED" xml:lang="fr-fr"/>
    </entry>
</feed>

Une zone supplémentaire est présente dans chaque entrée lorsqu'une requête d'objets récents est exécutée. Il s'agit de la date du dernier accès à l'objet. Elle indique la date et l'heure du dernier affichage ou de la dernière édition de l'objet via le portlet de création. Par exemple:

<wcm:lastAccessed>2011-09-26T05:41:55.544Z</wcm:lastAccessed>

Paramètres

Les paramètres ci-après, avec mime-type, sont les seuls paramètres fonctionnant avec le flux renvoyé. Tous les autres paramètres sont ignorés.

Tableau 1. Paramètres
Paramètre	Détails
`sort`	Le paramètre `sort` est ajouté aux requêtes pour déterminer la façon dont les résultats de requête sont triés. Les valeurs suivantes peuvent être utilisées avec le paramètre `sort` : `accessed` `author` `created` `modified` `name` `title` Les valeurs `_ascending` ou `_descending` sont ajoutées à la requête pour déterminer l'ordre de tri. Par exemple, pour trier une requête de modèles de présentation par ordre croissant de création, utilisez : /recent-items?type=PresentationTemplate&sort=created_ascending Pour trier une requête de modèles de présentation par ordre décroissant de création, utilisez : /recent-items?type=PresentationTemplate&sort=created_descending Si la valeur `_ascending` ou `_descending` n'est pas spécifiée, les résultats apparaissent par ordre croissant.
`type`	Ce paramètre est utilisé pour obtenir les objets d'un type spécifique. Par exemple, pour interroger une liste de composants : /recent-items?type=LibraryHTMLComponent
`page`	Ce paramètre est utilisé avec le paramètre `pagesize` pour définir l'ensemble de résultats à afficher. Par exemple, si le paramètre `pagesize` a pour valeur 5 et que le paramètre `page` a pour valeur 2, seuls les résultats 6 à 10 sont affichés. Par exemple: /recent-items?type=PresentationTemplate&pagesize=5&page=2
`pagesize`	Ce paramètre est utilisé pour limiter le nombre d'objets renvoyés par une requête à un nombre défini. Il peut être utilisé avec le paramètre `page` pour renvoyer des pages spécifiques de résultats. Par exemple, pour limiter le nombre de requêtes renvoyées à 5, entrez : /recent-items?type=PresentationTemplate&pagesize=5