Processus de développement du traitement et de la recherche
Les opérations de recherche et de traitement permettent d'identifier, en fonction de la requête de recherche, un jeu d'éléments de liste, puis d'effectuer des opérations personnalisées sur ces éléments de liste en bloc. Par exemple, vous devrez peut-être identifier un jeu de documents, en fonction de métadonnées de document spécifiques, puis déplacer ces documents dans un référentiel d'enregistrements.
La procédure de création d'une opération de recherche et de traitement est la suivante :
Créez l'assembly pour traiter les éléments qui doivent être retournés par votre recherche.
Pour traiter les éléments retournés, votre assembly doit implémenter l'interface IProcess.
Compilez l'assembly et installez-le sur le serveur Microsoft Office SharePoint Server 2007. L'assembly doit avoir un nom fort, être signé et ajouté au global assembly cache.
Écrivez le code qui crée un objet SearchAndProcessItem pour représenter votre tâche de recherche et traitement. Cette classe contient des propriétés que vous pouvez utiliser pour spécifier les éléments suivants :
Les paramètres de votre requête de recherche, tels que étendue, radical, bruit, suppression des doublons et taille du jeu de retour.
Le nom de l'assembly et la classe dans l'assembly, à appeler pour traiter chaque élément retourné par la recherche.
Le nom affiché dans le rapport de messagerie pour cette tâche de recherche et de traitement.
Tout argument facultatif à passer à l'assembly et à la classe de traitement.
Les utilisateurs auxquels un rapport doit être envoyé par courrier électronique sur les résultats de la tâche de recherche et de traitement.
Appelez la méthode Add de la classe SearchAndProcessItem pour ajouter votre tâche de recherche et de traitement à la tâche du minuteur maître Office SharePoint Server 2007.
Notes
La méthode Add intègre un paramètre pour spécifier l'utilisateur au nom duquel l'opération de recherche et de traitement est effectuée. Les éléments pour lesquels l'utilisateur ne dispose pas des droits suffisants ne sont pas inclus dans le jeu de retour des opérations de recherche et de traitement.
La méthode Add permet de spécifier l'heure d'exécution de votre tâche. La méthode Add lève une exception si l'un des événements suivants se produit :
L'assembly référencé est introuvable ou n'implémente pas l'interface IProcess.
L'heure d'exécution spécifiée pour la tâche n'est pas valide. Par exemple, vous avez spécifié une heure passée.
L'opération de recherche et de traitement est créée en tant qu'une seule tâche du minuteur asynchrone. La méthode Add retourne un GUID qui représente le SPTimerJob créé pour cette requête.
Interface IProcess
Chaque assembly créé pour traiter les éléments en tant que partie intégrante de l'opération de recherche et de traitement doit implémenter l'interface IProcess. L'interface IProcess est composée d'une seule méthode, ProcessItem, qui est appelée par Office SharePoint Server 2007 pour chaque élément dans le jeu de retour de la recherche. La méthode ProcessItem comprend des paramètres pour spécifier les éléments suivants :
L'élément à traiter
Tout argument facultatif spécifié par l'utilisateur pour Office SharePoint Server 2007 à passer à l'assembly
Un paramètre de sortie pour l'assembly afin de retourner les informations de traitement détaillées à Office SharePoint Server 2007
La méthode ProcessItem retourne une valeur booléenne pour indiquer si le traitement de l'élément a réussi.
Office SharePoint Server 2007 enregistre cet indicateur de réussite booléen, ainsi que les informations détaillées retournées via le paramètre de sortie, pour chaque élément traité. Office SharePoint Server 2007 insère ces informations dans le rapport de synthèse sur la tâche de recherche et de traitement qui est envoyé par courrier électronique aux utilisateurs spécifiés.