Exemple : créer une règle de routage
Dernière modification : mercredi 20 avril 2011
S’applique à : SharePoint Server 2010
Cette règle de routage utilise un récepteur d’événements ItemAdded pour créer automatiquement des règles de routage. Les règles de routage permettent à la fonctionnalité organisateur de contenu de déplacer des documents vers un dossier ou une bibliothèque de documents cible. Dans cet exemple de code, lorsqu’un élément du type de contenu dossier personnalisé est créé, une règle de routage est créée afin que les éléments soient routés vers ce dossier. Cette règle est utile lorsque vous avez besoin d’un dossier personnalisé pour stocker les éléments qui satisfont à des critères spécifiques et que vous souhaitez router le contenu existant et le contenu futur vers ce dossier.
Vous devez activer la fonctionnalité organisateur de contenu, fonctionnalité au niveau du site, pour utiliser cet exemple de code. Le tableau 1 répertorie les champs et les types de contenu également nécessaires à l’utilisation de l’exemple de code.
Tableau 1. Champs et types de contenu requis pour l’exemple de code
Champ ou type de contenu |
Description |
|---|---|
Champ MyTextColumn |
Colonne de texte unique |
Champ My EMM Column |
Colonne de métadonnées gérées à valeur unique |
Type de contenu dossier personnalisé |
Ce type de contenu doit dériver du dossier de routage et doit inclure les champs MyTextColumn et My EMM Column. Le champ MyTextColumn est obligatoire. |
Accédez au fichier CreateRoutingRuleAutomaticallyEventReceiver.zip dans le dossier C:\Program Files\Microsoft SDKs\SharePoint 2010\Samples et ouvrez le fichier *.sln dans Microsoft Visual Studio 2010. Dans le volet Propriétés de Visual Studio 2010, définissez le paramètre URL du site sur l’adresse absolue de votre site de test de développement. Par exemple, http://serveur_de_développement/. Pensez à inclure la barre oblique de fermeture.
Avec cet exemple de code, lorsqu’un type de contenu dossier personnalisé est créé, une règle de routage est créée dans la liste des règles de routage. Les types de contenu de document qui possèdent la même valeur MyTextColumn sont routés vers ce dossier.
Génération et exécution de l’exemple
Cet exemple de code suppose que le site contient un type de contenu appelé Contract dérivé du type de contenu Document.
Génération de l’exemple
Créez un dossier nommé Microsoft.SDK.Server.Samples, puis décompressez le fichier CreateRoutingRuleAutomaticallyEventReceiver.zip dans ce dossier.
Démarrez Visual Studio 2010, puis ouvrez le fichier CreateRoutingRuleItemAdded.sln qui se trouve dans le dossier créé à l’étape 1.
Dans la fenêtre Propriétés, spécifiez la valeur d’URL de site correspondant à l’adresse absolue de votre site de test ou de développement (par exemple, http:// monsite/). Pensez à inclure la barre oblique de fermeture.
Si elles ne sont pas déjà présentes, ajoutez au projet des références aux assemblys suivants :
Microsoft.Office.DocumentManagement.dll
Microsoft.SharePoint.dll
Microsoft.SharePoint.Taxonomy.dll
Dans le menu Générer, sélectionnez Déployer la solution. Une fois la génération terminée, la solution est installée sur votre site de développement ou de test.
Exécution de l’exemple
Cet exemple crée une règle d’organisateur de contenu qui organise les documents du type de contenu Contract en une bibliothèque de documents au sein du site.