Procédure pas à pas : Module 3 - Accès aux propriétés SharePoint à partir d’une orchestration

Cette procédure pas à pas est une continuation de Procédure pas à pas : Module 2 - Intégration d’Office à l’adaptateur Windows SharePoint Services et vous montre comment accéder aux propriétés de contexte Windows SharePoint Services d’un message entrant au moment de l’exécution, puis déterminer la destination de ce message en fonction d’une propriété à l’aide de ports dynamiques dans un message Orchestration. Pour une présentation de l’adaptateur Windows SharePoint Services, consultez Qu’est-ce que l’adaptateur Windows SharePoint Services ?.

Prérequis

La configuration suivante est requise pour exécuter les procédures décrites dans cette rubrique :

• Vous devez disposer d’un déploiement de serveur unique avec une installation complète de BizTalk Server s’exécutant sur Windows Server 2008 SP2 ou Windows Server 2008 R2.

• Vous devez suivre les procédures pas à pas suivantes : Procédure pas à pas : Module 1 - Envoi et réception de messages avec l’adaptateur Windows SharePoint Services et Procédure pas à pas : Module 2 - Intégration d’Office à l’adaptateur Windows SharePoint Services

  Pour plus d’informations sur l’utilisation de l’adaptateur Windows SharePoint Services dans un déploiement multiserveur, consultez Configuration et déploiement de l’adaptateur Windows SharePoint Services.

Modification du projet BizTalk

Dans cette procédure, vous modifiez le schéma PurchaseOrder à partir de Walkthrough : Module 2 - Integrationing Office with the Windows SharePoint Services Adapter. Cette procédure montre comment promouvoir une propriété de schéma pour un accès facile dans une orchestration BizTalk.

Modification du schéma PurchaseOrder.xsd

1. Démarrez Microsoft Visual Studio.

2. Cliquez sur Fichier, sur Ouvrir, puis sur Projet/Solution.

3. Accédez au OrderProcess.sln fichier, puis cliquez sur Ouvrir.

4. Dans Explorateur de solutions, cliquez avec le bouton droit sur le OrderProcessSchema.xsd fichier, puis cliquez sur Ouvrir.

5. Dans l’Éditeur BizTalk, développez PurchaseOrder.

6. Cliquez avec le bouton Amountdroit sur , cliquez sur Promouvoir, puis sur Promotion rapide.

7. Cliquez sur OK.

   Notes

   Visual Studio crée un schéma de propriété pour cela dans le projet actuel.

8. Enregistrez PurchaseOrder.xsd.

Création d'une orchestration

Cette procédure permet de créer une orchestration BizTalk. Cette procédure crée l'orchestration utilisée pour traiter un message reçu par l'adaptateur Windows Sharepoint Services.

Ajout d'une orchestration BizTalk

1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le OrderProcess projet, cliquez sur Ajouter, puis cliquez sur Nouvel élément.

2. Sous Catégories, sélectionnez Fichiers d’orchestration.

3. Sous Modèles, sélectionnez Orchestration BizTalk.

4. Tapez MyCompanyOrderProcessing le champ Nom , puis cliquez sur Ajouter.

Création d'informations de réception

Cette procédure permet de créer un message, un port de réception et une forme Réception pour l'orchestration. Cette procédure montre comment configurer une orchestration pour recevoir un message de BizTalk Server.

Création d'un message

1. Dans la vue Orchestration, cliquez avec le bouton droit sur Messages, puis cliquez sur Nouveau message. Cela génère un nouveau message portant le nom Message_1.

2. Cliquez avec le bouton Message_1droit sur , cliquez sur Renommer, puis tapez Message_PO.

3. Cliquez avec le bouton droit sur Message_PO, puis cliquez sur Fenêtre Propriétés.

4. Dans la propriété Type de message , développez Schémas, puis sélectionnez OrderProcess.OrderProcessSchema schéma.

Ajout d'un port de réception à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme de port vers port Surface. L'Assistant Configuration du port démarre.

2. Dans l’écran Bienvenue, cliquez sur Suivant.

3. Tapez ReceivePurchaseOrder le champ Nom , puis cliquez sur Suivant.

4. Sélectionnez Créer un type de port.

5. Tapez PurchaseOrderPT le champ Nom du type de port , puis cliquez sur Suivant.

6. Dans l’écran Liaison de port, conservez les valeurs par défaut, puis cliquez sur Suivant.

7. Cliquez sur Terminer.

8. Dans La vue Orchestration, sous Types de ports, développez le type de PurchaseOrderPT port.

9. Cliquez avec le bouton Operation_1droit sur , cliquez sur Renommer, puis tapez PurchaseOrderOperation.

Ajout d'une forme Réception à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme Recevoir vers l’orchestration.

2. Cliquez avec le bouton droit sur la forme Recevoir, puis cliquez sur Fenêtre Propriétés.

3. Définissez la propriété Activate sur True.

   Notes

   Si la propriété Activer est définie sur false, vous obtenez l'erreur suivante : « erreur X2214 : vous devez indiquer au moins un ensemble de corrélations déjà initialisé pour une réception sans activation située sur un port autre qu'un port d'autocorrélation ».

4. Tapez Receive_PO dans le champ Nom .

5. Dans la fenêtre Propriétés, sélectionnez Message_PO la propriété Message.

6. Sélectionnez ReceivePurchaseOrder.PurchaseOrderOperation.Request la propriété Operation . Cela lie le port à la forme Réception dans le Concepteur d'orchestration.

Création d'informations d'envoi

Cette procédure permet de créer un message, des ports d'envoi et une structure de décision pour l'orchestration. Cette procédure montre comment configurer une orchestration avec une logique de décision et comment configurer une orchestration pour envoyer un message à un port d'envoi.

Création d'un message

1. Dans la vue Orchestration, cliquez avec le bouton droit sur Messages, puis cliquez sur Nouveau message. Cela génère un nouveau message portant le nom Message_1.

2. Cliquez avec le bouton Message_1droit sur , cliquez sur Renommer, puis tapez Message_Task.

3. Cliquez avec le bouton droit sur Message_Task, puis cliquez sur Fenêtre Propriétés.

4. Dans la propriété Type de message , développez Schémas, puis sélectionnez OrderProcess.OrderProcessSchema schéma.

Ajout d'un port d'envoi à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme de port vers port Surface. L'Assistant Configuration du port démarre.

2. Dans l’écran Bienvenue, cliquez sur Suivant.

3. Tapez SendPurchaseOrder le champ Nom , puis cliquez sur Suivant.

4. Sélectionnez Utiliser un type de port existant.

5. Sous Types de ports disponibles, sélectionnez OrderProcess.PurchaseOrderPT, puis cliquez sur Suivant.

6. Dans l’écran Liaison de port, sous Sens de la communication, sélectionnez I'll always be sending messages on this port, puis cliquez sur Suivant.

7. Cliquez sur Terminer.

Ajout d'une forme Envoi à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme Envoyer vers le Designer Orchestration. Placez-la sous la Receive_PO forme Recevoir.

2. Cliquez avec le bouton droit sur la forme Envoyer, puis cliquez sur Fenêtre Propriétés.

3. Tapez Send_PO dans le champ Nom .

4. Sélectionnez Message_PO la propriété Message .

5. Sélectionnez SendPurchaseOrder.PurchaseOrderOperation.Request la propriété Operation . Cela lie le port à la forme Envoi dans le Concepteur d'orchestration.

Ajout d'une forme Décider à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme Décider vers le Designer Orchestration. Placez-la sous la Send_PO forme Envoyer.

2. Cliquez avec le bouton droit sur la forme Décider, puis cliquez sur Fenêtre Propriétés.

3. Tapez NeedsApproval dans le champ Nom .

4. Dans Orchestration Designer, cliquez sur Rule_1 sur la forme Décider.

5. Dans les fenêtres Propriétés, tapez ApprovalRequired pour la propriété Name .

6. Cliquez sur le champ de propriété Expression , puis sur le bouton de sélection (...).

7. Dans l'Éditeur d'expression BizTalk, tapez ou copiez ce qui suit :

   Message_PO(OrderProcess.PropertySchema.Amount) > 1000  
   

8. Cliquez sur OK.

Ajout d'un autre port d'envoi à l'orchestration

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme de port vers port Surface. L'Assistant Configuration du port démarre.

2. Dans l’écran Bienvenue, cliquez sur Suivant.

3. Tapez SendToTasksList le champ Nom , puis cliquez sur Suivant.

4. Sélectionnez Utiliser un type de port existant.

5. Sous Types de ports disponibles, sélectionnez OrderProcess.PurchaseOrderPT, puis cliquez sur Suivant.

6. Dans l’écran Liaison de port, sous Direction du port de la communication, sélectionnez I'll always be sending messages on this port.

7. Sous Liaison de port, sélectionnez Dynamic, puis cliquez sur Suivant.

8. Cliquez sur Terminer.

Ajout d'une forme Envoi à la forme Décider

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme Envoyer vers le Designer d’orchestration. Placez-le sous la ApprovalRequired forme.

2. Cliquez avec le bouton droit sur la forme Envoyer, puis cliquez sur La fenêtre Propriétés

3. Tapez CreateApprovalTask le champ Nom .

4. Sélectionnez Message_Task la propriété Message .

5. Sélectionnez SendToTasksList.PurchaseOrderOperation.Request la propriété Operation . Cela lie le port à la forme Envoi dans le Concepteur d'orchestration.

Créer une expression

Dans cette procédure, vous allez ajouter une forme Expression à votre solution, qui attribue la valeur du chemin des tâches à une variable. Cette procédure montre comment ajouter une logique à une orchestration pour modifier les propriétés d'un port d'envoi dynamique.

Création d'une expression

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme Expression avant la CreateApprovalTask forme Envoyer.

2. Cliquez avec le bouton droit sur la forme Expression, puis cliquez sur Fenêtre Propriétés.

3. Tapez SetPortDestination le champ Nom .

4. Cliquez sur le champ de propriété Expression , puis sur le bouton de sélection (...).

5. Dans l’Éditeur d’expression BizTalk, tapez ce qui suit :

   SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";  
   

6. Cliquez sur OK.

Construction d'un nouveau message

Dans cette procédure, vous allez ajouter une forme Construire à la solution, qui construira une nouvelle instance d'un type de message à l'intérieur de l'orchestration. Cette procédure montre comment créer un message qui est une copie du message entrant, puis modifier les propriétés de contexte du nouveau message. Cette étape est obligatoire parce que les messages sont immuables dans BizTalk. Une fois que vous avez construit un message original, vous ne pouvez plus le modifier.

Ajout d'une forme Construction

1. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme de message de construction avant la SetPortDestination forme Expression.

2. Cliquez avec le bouton droit sur la forme Construire un message, puis cliquez sur Fenêtre Propriétés.

3. Tapez ConstructTaskMessagele champ Nom .

4. Sélectionnez Message_Task la propriété Messages construits .

5. Sous Orchestrations BizTalk dans la boîte à outils, faites glisser une forme d’affectation de message dans la forme Construire unConstructTaskMessage message.

6. Dans la fenêtre Propriétés, tapez InitTaskMessage le champ Nom .

7. Cliquez sur le champ de propriété Expression , puis sur le bouton de sélection (...).

8. Dans l’éditeur d’expressions BizTalk, tapez ou copiez ce qui suit :

   Message_Task = Message_PO;  
   Message_Task(WSS.ConfigOverwrite) = "no";  
   Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
   Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";  
   

   Important

   Les valeurs fournies pour ces propriétés de contexte respectent la casse. Lors de la définition de valeurs de configuration pour un port dynamique avec des propriétés de contexte, vous devez veiller à utiliser la casse appropriée, sans quoi une erreur se produit quand BizTalk tente de router le document vers le port d'envoi désigné.

9. Cliquez sur OK.

10. Cliquez sur Fichier, puis sur Enregistrer tout.

Création du projet BizTalk

Dans cette procédure, vous allez construire et déployer le projet BizTalk. Cette étape est nécessaire pour créer et déployer l’assembly que BizTalk Server utilise lors de l’exécution.

Création et déploiement de la solution

1. Cliquez sur Générer, puis sur Générer orderProcess.

2. Cliquez sur Générer, puis sur Déployer OrderProcess.

3. Fermez Microsoft Visual Studio.

Modification de l'emplacement de réception et du port d'envoi

Dans cette procédure, vous allez modifier l'emplacement de réception et le port d'envoi existants pour utiliser le traitement XML pour les pipelines. Le pipeline de réception XML conserve les propriétés de message utilisées durant le traitement de l'orchestration, puis le pipeline d'envoi XML conserve les propriétés de message appliquées dans l'orchestration, qui sont ensuite utilisées pour le routage des messages.

Modification de l'emplacement de réception

1. Cliquez sur Démarrer, pointez sur Tous les programmes, sur MicrosoftBizTalk Server, puis cliquez sur administration BizTalk Server.

2. Développez MicrosoftBizTalk ServerAdministration SnapIn, BizTalk Group, Applications, BizTalk Application 1, puis cliquez sur le nœud Emplacements de réception.

3. Cliquez avec le bouton droit sur SourceLocation, puis cliquez sur Propriétés.

4. Dans la boîte de dialogue Propriétés de l’emplacement de réception, sous Général, sélectionnez XMLReceive la propriété de pipeline de réception .

5. Cliquez sur OK.

Modification du port d'envoi

1. Cliquez sur le nœud Ports d’envoi .

2. Cliquez avec le bouton droit sur SendToDestination, puis cliquez sur Propriétés.

3. Dans la boîte de dialogue Propriétés du port d’envoi, sous Général, sélectionnez XMLTransmit la propriété Envoyer le pipeline .

4. Sélectionnez l’onglet Filtres .

5. Sélectionnez la condition existante, appuyez sur SUPPR, puis cliquez sur OK.

Démarrage d'un nouveau port d'envoi

1. Cliquez sur le nœud Ports d’envoi .

2. Cliquez avec le bouton droit sur OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>, puis cliquez sur Démarrer.

Liaison de l'orchestration

Dans cette procédure, vous allez lier l'orchestration aux ports spécifiés. Cette procédure est obligatoire pour lier des ports physiques à l'orchestration que vous avez construite et déployée.

Liaison de l'orchestration

1. Dans la console Administration BizTalk Server, cliquez sur le nœud Orchestrations.

2. Cliquez avec le bouton droit sur l’orchestration OrderProcess.MyCompanyOrderProcessing , puis cliquez sur Propriétés.

3. Sélectionnez l’onglet Liaisons .

4. Sous Hôte, sélectionnez BizTalkServerApplication dans le champ Hôte .

5. Sous Liaisons, sélectionnez FromSource le ReceivePurchaseOrder Port logique entrant.

6. Sous Liaisons, sélectionnez SendToDestination le SendPurchaseOrder Port logique sortant.

7. Cliquez sur OK.

8. Cliquez avec le bouton droit sur OrderProcess.MyCompanyOrderProcessing orchestration, puis cliquez sur Démarrer.

Envoi d'un message via le système

Dans cette procédure, vous allez créer un formulaire InfoPath et le télécharger sur le site Web Windows SharePoint Services. L'adaptateur Windows SharePoint Services prend ce message, l'archive dans la bibliothèque de documents d'archive, puis l'envoie dans la bibliothèque de documents de destination. Durant le traitement de ce message, des propriétés de contexte Windows SharePoint Services seront utilisées pour déterminer la destination.

Création d'un formulaire InfoPath pour envoi via le système

1. Ouvrez un navigateur Web, puis accédez à l'URL du site que vous avez créé Par exemple : http://<server_name>/sites/WSSAdapterWalkthrough.

2. Dans le menu Lancement rapide, cliquez sur InfoPathSolutions.

3. Cliquez sur le PurchaseOrder fichier pour afficher la boîte de dialogue Téléchargement de fichier, puis cliquez sur Ouvrir. InfoPath va charger le formulaire.

4. Dans le champ ID de bon de commande , tapez 1003.

5. Dans le champ Facture à , tapez John Doe.

6. Dans le champ Montant , tapez 1750.

7. Dans le champ Date du bon de commande , tapez 1/3/2005.

8. Cliquez sur Enregistrer.

9. Dans la boîte de dialogue Enregistrer sous , tapez http://<server_name>/sites/WSSAdapterWalkthrough/Sourcele champ nom de fichier , puis appuyez sur ENTRÉE.

10. Tapez PurchaseOrder3.xml le champ nom de fichier , puis cliquez sur Enregistrer.

11. Fermez InfoPath.

12. Dans le navigateur web, cliquez sur Documents et listes.

13. Sous Bibliothèques de documents, cliquez sur Destination.

14. Dans la bibliothèque de documents de destination, vous allez voir votre message répertorié dans cette bibliothèque. Vous trouverez également une copie archivée dans la bibliothèque de documents Archive.

15. Cliquez sur Accueil.

16. Sous Listes, cliquez sur Tâches.

17. Dans la liste Tâches, vous verrez la tâche d'approbation créée.

Résumé

Cette procédure pas à pas vous a montré comment accéder aux propriétés de contexte Windows SharePoint Services et déterminer la destination des messages transitant par les ports dynamiques.

Étapes suivantes

Continuez à consulter le reste de la section sur l'adaptateur Windows SharePoint. Pour plus d'informations, consultez les rubriques sous Voir aussi.

Voir aussi

Présentation de l’adaptateur Windows SharePoint Services
Procédures pas à pas relatives à l’adaptateur Windows SharePoint Services