Plug-in Digital Data Connector XML générique

Vous pouvez utiliser le plug-in HCL Digital Data Connector (DDC) for HCL Portal directement en vue d'intégrer des données XML distantes sans codage. Il est possible d'intégrer des données XML fournies sous la forme de formats de document XML arbitraires par la prise en charge du concept de rendu de liste.

Un profil de rendu de liste décrit la transformation entre un format de document XML particulier et la structure de données de liste de beans générique générée par ce plug-in DDC. Identifiez le plug-in DDC XML générique par son nom ibm.portal.ddc.xml. Vous pouvez le traiter à l'aide de la balise [Plugin:ListRenderingContext extension-id="ibm.portal.ddc.xml"]. Le plug-in DDC XML prend en charge les attributs répertoriés ci-dessous. You can specify these attributes when you set up the list-rendering context by using the ListRenderingContext tag that HCL Web Content Manager provides.

source

Vous pouvez définir cet attribut pour qu'il identifie l'URI source qui sert les données XML. L'URI doit être accessible via la structure d'adressabilité de ressource de portail. Les schémas d'URI incluent http, https et dav. Si vous accédez à des données XML externes à l'aide d'adresses URL http ou https, veillez à ajuster votre configuration de proxy connexion HTTP sortante pour permettre l'accès en sortie à ces adresses URL. For more information, read the information about proxy configuration in the HCL Digital Experience Portal documentation. Pour plus d'informations, voir la rubrique Connexion HTTP sortante. Exemple :

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.cntserv_exmp.com/connections/communities/service/atom/catalog/public" 
   compute="always"

sortCriteria

Définissez cet attribut de manière à trier le contenu d'une liste de beans en fonction d'un attribut particulier. Cet attribut de tri doit être défini dans le profil de rendu de liste utilisé par le contexte de rendu de liste courant. Cette fonction de tri intégrée trie uniquement les données contenues dans la liste de beans courante. Par conséquent, vous ne devez pas utiliser cet attribut si la liste de beans représente uniquement un fragment d'un ensemble de résultats plus important. Dans ce cas, vous devez fournir le processus de tri traité par le service dorsal. Si vous n'indiquez pas cet attribut, la liste de beans conserve la séquence d'éléments fournie par la source de données externe. Pour indiquer l'ordre de tri, utilisez l'attribut sortOrder.

sortOrder

Utilisez cet attribut en association avec l'attribut sortCriteria pour indiquer l'ordre de tri. Les valeurs prises en charge sont asc et desc pour le tri en ordre croissant ou décroissant. Exemple :

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.cntserv_exmp.com/connections/communities/service/atom/catalog/public" 
   attribute="sortCriteria=title" attribute="sortOrder=asc"]

cacheScope

Définissez cet attribut en vue d'identifier la portée du cache pour les listes de beans résultant d'un contexte de rendu de liste spécifique. Les valeurs prises en charge sont les suivantes :

public: Il s'agit de la valeur par défaut. Si vous définissez cet attribut sur public, les valeurs de liste de beans mises en cache sont partagées entre les utilisateurs.
privé: Si vous définissez cet attribut sur private, des objets de liste de beans individuels sont mis en cache par utilisateur. Indiquez private si les listes de beans utilisent des informations spécifiques des utilisateurs.

Exemple :

[Plugin:ListRenderingContext action="set" extension-id="ibm.portal.ddc.xml" 
   profile="ibm.portal.atom" 
   attribute="source=https://www.cntserv_exmp.com/connections/communities/service/atom/catalog/my" 
   attribute="cacheScope=private" compute="always"]

cacheType

Définissez cet attribut en vue d'identifier le type de cache à utiliser pour les listes de beans résultant d'un contexte de rendu de liste particulier. Les valeurs prises en charge sont les suivantes :

invalidateOnLogin: Si vous utilisez ce paramètre, les objets placés en cache sont invalidés si l'utilisateur pour lequel la liste de beans a été calculée se connecte au portail. Utilisez cette valeur uniquement en association avec le paramètre cacheScope=private.
par défaut: Si vous utilisez ce paramètre, les listes de beans mises en cache résultantes ne sont pas invalidées pendant la connexion de l'utilisateur.

invalidateCache

Utilisez cet attribut pour invalider la liste de beans. Si vous définissez cet attribut sur la valeur always, la liste de beans est toujours invalidée avant la configuration du nouveau contexte de rendu de liste. Autrement dit, la liste de beans est recalculée pour chaque rendu. Pour effectuer une invalidation conditionnelle vous pouvez définir l'attribut sur une valeur différente. Dans ce cas, le cache est invalidé uniquement si un attribut de session de portlet ou un attribut de demande ayant la valeur indiquée est disponible dans le contexte d'exécution courant.

clearCache

Utilisez cet attribut pour effacer le cache de liste de beans. Si vous définissez cet attribut sur la valeur always, le cache est toujours effacé avant la configuration du nouveau contexte de rendu de liste. Pour effectuer une action d'effacement conditionnelle, vous pouvez définir l'attribut sur une autre valeur. Dans ce cas, le cache est nettoyé uniquement si un attribut de session de portlet ou un attribut de demande ayant la valeur indiquée est disponible dans le contexte d'exécution courant.