Implémentation de requêtes HCL Connections

HCL Connections fournit une API distante exhaustive. Vous pouvez utiliser cette API pour accéder aux données sociales via des flux Atom.

Pourquoi et quand exécuter cette tâche

Pour plus d'informations sur l'API, reportez-vous à la documentation sur l'API HCL Connections 4.5.

Vous pouvez créer des requêtes personnalisées pour des données sociales en créant les adresses URL correspondantes. Pour afficher le résultat de telles requêtes dans les pages de votre portail à l'aide des composants de conception HCL Web Content Manager, procédez comme suit :

Procédure

Identifiez ou créez le profil de rendu de liste pour le format de données fourni par votre adresse URL de requête.
Par exemple, votre requête peut utiliser l'API distante Forums HCL Connections afin d'effectuer une requête pour un ensemble particulier de sujets de forum. Dans ce cas vous pouvez utiliser le profil ibm.portal.sr.forums.topics de sujet de forum pour transformer les documents de résultats fournis par cette adresse URL.
Etablissez le contexte de rendu de liste pour cette requête. Pour cela, indiquez votre adresse URL de requête comme attribut source et le plug-in HCL Digital Data Connector (DDC) for HCL Portal approprié capable de gérer votre requête.
Deux options sont possibles :
- Si le profil que vous utilisez est basé sur les profils inclus avec HCL Digital Experience Portal version 8.5, vous pouvez utiliser le plug-in DDC de rendu social.
- Si vous utilisez un profil de rendu de liste personnalisé vous pouvez utiliser le plug-in DDC XML générique ou un plug-in DDC personnalisé que vous avez déployé.
Exemple : pour extraire la liste de toutes les communautés publiques, établissez le contexte de rendu de liste comme suit :
```
[Plugin:ListRenderingContext action="set" 
   extension-id="ibm.portal.ddc.sr" 
   profile="ibm.portal.sr.communities" 
   attribute="source=https://www.cntserv_exmp.com/connections/communities/service/atom/catalog/public"]
```
Pour afficher le résultat, vous devez afficher un composant d'apparence de Digital Data Connector. Dans ce composant, extrayez les différentes pièces d'information. Pour cela utilisez la balise [AttributeResource] et les noms d'attribut pris en charge par le profil de rendu de liste que vous utilisez.
Exemple : dans la requête de communauté présentée à l'étape précédente, vous pouvez afficher le rendu d'un lien vers une vue détaillée de la communauté. Pour cela, ajoutez le marquage suivant à la section Conception de résultat du composant d'apparence DDC :
```
<a href="[AttributeResource attributeName='link']">
    [AttributeResource attributeName='title']
</a>
```
Une fois le rendu du composant d'apparence terminé, assurez-vous de supprimer le contexte de rendu de liste à nouveau. Ceci est particulièrement important si vous voulez imbriquer des contextes de rendu de liste pour afficher des listes imbriquées.
Vous supprimez le contexte de rendu de liste comme suit :
```
[Plugin:ListRenderingContext action="remove"]
```
For more information, read Setting the list-rendering context.