Utilisez l'activité Extraire des listes pour extraire des propriétés de liste à partir de MS SharePoint.
Pourquoi et quand exécuter cette tâche
Cette tâche permet d'extraire des propriétés de liste à partir de l'instance MS SharePoint. L'appel de cette activité est un appel synchrone
lorsque les données entrées sont envoyées à l'activité pour traitement et que la réponse
est renvoyée à l'orchestration.
Procédure
- Cliquez avec le bouton droit sur la section Orchestrations et sélectionnez une nouvelle orchestration.
- Faites glisser le nouveau noeud final MS SharePoint vers l'orchestration et sélectionnez l'activité Extraire des listes. L'activité Extraire des listes s'ajoute à l'orchestration.
Cliquez deux fois sur l'activité. La liste de contrôle de l'activité MS SharePoint Extraire des listes s'affiche.
- Dans la liste de contrôle, cliquez sur Réessayer. Passez en revue les paramètres par défaut et procédez aux modifications requises.
- Sélectionnez Mapper les entrées dans la Liste de contrôle. Les schémas XML générés à partir de cette opération sont affichés sous forme de noeuds sous le paramètre d'entrée de demande dans le panneau Vers l'activité.
- Créez une mappe entre les variables d'orchestration et le paramètre d'entrée de l'activité.
Zones obligatoires :
- retrieveType (valeurs admises : ALL et SPECIFIC)
- retrieveListBy (valeurs admises : LIST_ID et LIST_TITLE)
- listId (obligatoire si retrieveType a pour valeur SPECIFIC et retrieveListBy a pour valeur LIST_ID)
- listTitle (obligatoire si retrieveType a pour valeur SPECIFIC et retrieveListBy a pour valeur LIST_TITLE)
Exemple de demande d'entrée
<?xml version="1.0" encoding="UTF-8"?>
<RetrieveList xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/retrievelist">
<!--1. retrieveType value as ALL-->
<RetrieveListRequestDetails xmlns="">
<retrieveType>ALL</retrieveType>
</RetrieveListRequestDetails>
<!--2. retrieveType value as SPECIFIC and retrieveListBy as LIST_TITLE-->
<RetrieveListRequestDetails xmlns="">
<retrieveType>SPECIFIC</retrieveType>
<retrieveListBy>LIST_TITLE</retrieveListBy>
<listTitle>List103</listTitle>
</RetrieveListRequestDetails>
<!--3. retrieveType value as SPECIFIC and retrieveListBy as LIST_ID-->
<RetrieveListRequestDetails xmlns="">
<retrieveType>SPECIFIC</retrieveType>
<retrieveListBy>LIST_ID</retrieveListBy>
<listId>efb347bd-2b4f-4859-b67c-80c7e60ed8fa</listId>
</RetrieveListRequestDetails>
</RetrieveList>
Remarque : Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires de la structure d'entrée. Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en reliant l'élément avec un noeud d'entrée. A l'exécution, si aucune valeur n'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web. Si aucune valeur n'est fournie au moment de l'exécution pour un paramètre d'entrée facultatif, aucune exception n'est émise lors de l'exécution.
- Sélectionnez Mapper les sorties dans la Liste de contrôle. Le schéma XML
généré pour contenir la réponse de l'activité s'affiche sous forme de noeuds
sous le paramètre de sortie de réponse dans le panneau Depuis l'activité.
- Créez une mappe entre les paramètres de sortie et les variables d'orchestration.
Résultats
Vous venez de configurer l'activité MS SharePoint Extraire des listes.
Remarque : Vous pouvez extraire les propriétés de plusieurs listes en une seule fois à l'aide de cette activité dans la mesure où la variable d'entrée est sans limite.
Limitation :
L'option ExpandChildren de l'activité d'extraction de listes ne fonctionne pas pour SharePoint sur site. Il s'agit du comportement connu de l'API pour SharePoint sur site.