Partager via

Configuration du port d'envoi SharePoint Services

  • Article

Cette rubrique compare un port d’envoi statique à un port d’envoi dynamique et répertorie également les étapes de création d’un port d’envoi Windows SharePoint Services. Plus précisément :

Comparaison entre un port d'envoi statique et un port d'envoi dynamique

Création d'un port d'envoi statique

Création d'un port d'envoi dynamique

Comparaison entre un port d'envoi statique et un port d'envoi dynamique

  Port d'envoi statique Port d'envoi dynamique
Vous devez utiliser un port d'envoi unique avec différents adaptateurs. No

Lors de la création d'un port d'envoi statique, vous devez indiquer le type de transport.		 Yes

En règle générale, un port d'envoi dynamique est ajouté à une orchestration. Le type de transport est configuré dans la logique d'orchestration.
Vous devez utiliser un port d'envoi unique avec différentes propriétés de port d'envoi, telles qu’une URL. No

Lors de la création d'un port d'envoi statique, vous devez configurer certaines propriétés de l'adaptateur, telles qu’une URL.		 Yes

En règle générale, un port d'envoi dynamique est ajouté à une orchestration. Les propriétés sont configurées dans la logique d'orchestration.
Vous devez utiliser le gestionnaire d'envoi par défaut. No

Le gestionnaire d'envoi peut être configuré lors de la création d'un port d'envoi.		 No

Le gestionnaire d'envoi peut être configuré lors de la création d'un port d'envoi.
À utiliser lorsque vous ne savez pas où le message doit être acheminé. No

Lors de la création d'un port d'envoi statique, vous devez spécifier le type de transport et l'emplacement final.		 Yes

L'emplacement final peut être configuré dans une orchestration ou dans un scénario de routage basé sur le contenu. Les règles permettent également de filtrer l'emplacement de destination du message.
Vous devez utiliser un port d'envoi unique pour envoyer des messages à plusieurs partenaires. No

Lors de la création d'un port d'envoi statique, vous devez spécifier le type de transport et l'emplacement final.		 Yes

En règle générale, un port d'envoi dynamique est ajouté à une orchestration. Les propriétés sont configurées dans la logique d'orchestration et sont basées sur des règles que vous spécifiez ; les messages peuvent être envoyés à plusieurs partenaires.

Création d'un port d'envoi statique

Lors de la création d'un port d'envoi statique, le port d'envoi fait appel au gestionnaire d'envoi par défaut associé au type de transport. Lorsque vous utilisez l’adaptateur Windows SharePoint Services, le gestionnaire d’envoi par défaut est BizTalkServerApplication. Pour connaître les étapes d’ajout d’un nouveau gestionnaire d’envoi, accédez à Comment créer un gestionnaire d’adaptateur.

Pour créer le port d'envoi statique :

  1. Dans la console Administration BizTalk Server, développez BizTalk Group [GroupName], Applications, puis développez l’application pour contenir le port d’envoi.

  2. Cliquez avec le bouton droit sur Ports d’envoi, cliquez sur Nouveau, puis sur Port d’envoi unidirectionnel statique.

    Important

    Un port d’envoi de Solicit-Response statique n’est pas configurable avec l’adaptateur Windows SharePoint Services.

  3. Dans Propriétés, cliquez sur Windows SharePoint Services dans la liste déroulante Type. Entrez les propriétés Name, Send Handler et Send Pipeline .

  4. Cliquez sur Configurer. Dans Propriétés, configurez les éléments suivants :

    Propriété Description
    Port de service Web d'adaptateur Requis. Port configuré sur le site web IIS hébergeant le service web de l’adaptateur SharePoint Services.

    La valeur par défaut est le port 80, qui est le port HTTP standard. Si vous utilisez un autre port, vous devez mettre à jour cette valeur.
    Délai d'expiration Requis. Cette valeur, exprimée en millisecondes, détermine le délai d'attente pour que l'adaptateur reçoive une réponse du service Web.

    La valeur par défaut est de 100 000 ms (100 secondes).

    Augmentez cette valeur si la taille du message ou du lot est supérieure à celle prévue.

    Il s'agit du délai d'expiration, en millisecondes, des appels du service Web d'exécution de l'adaptateur adressés au service Web de l'adaptateur Windows SharePoint Services. Vous devrez éventuellement augmenter cette valeur si la taille du message ou du lot est supérieure à la valeur moyenne attendue par l'adaptateur.
    Utiliser le modèle objet client Requis. Détermine si le modèle CSOM (Client-side Server Object Model) ou le modèle SSOM (Service-Side Object Model) SharePoint est utilisé.

    La valeur par défaut est Oui. Définissez sur Oui pour utiliser le CSOM SharePoint sur le BizTalk Server. Il n’existe aucune configuration requise sur l’ordinateur SharePoint Services.

    Définissez sur Non pour utiliser le SSOM SharePoint qui inclut le service web installé sur l’ordinateur SharePoint Services.

    Annexe B : Installer l’adaptateur Microsoft SharePoint fournit des informations spécifiques sur les composants SSOM et CSOM utilisés par l’adaptateur SharePoint Services.
    URL Dossier de destination Requis. URL du dossier SharePoint Services pour stocker les documents. Entrez le chemin d'accès relatif au site SharePoint, Par exemple, Documents partagés ou Documents partagés/Bons de commande/. Vous pouvez également utiliser une liste comme destination, Par exemple, Listes/Tâches. Si vous spécifiez une liste, le corps du message n’est pas enregistré avec l'élément de liste. Les valeurs extraites du message sont promues dans les colonnes SharePoint. Note: L’URL de la bibliothèque de documents ou du dossier SharePoint peut être différente de son nom. Consultez l'adresse dans le navigateur Web pour connaître l'URL exacte.
    Nom de fichier Facultatif. Entrez le nom de SharePoint Services nom de fichier.

    Entrez un nom de fichier, comme PurchaseOrder0001.xml ou une expression. Les expressions incluent toute combinaison de littéraux, de macros et de requêtes XPATH. Par exemple, entrez PurchOrd-%XPATH=//po :PurchaseOrderId%-%MessageID%.xml. Si vous n’indiquez aucun nom de fichier, le nom du fichier d'origine, la valeur fournie par l'orchestration ou « Msg-%MessageID%.xml » est utilisé. Pour plus d’informations, consultez Expressions d’adaptateur Windows SharePoint Services. Note: Lors de l’envoi de messages à une liste, cette valeur Filename est ignorée et n’est pas enregistrée dans une colonne SharePoint. Vous devez donc mettre à jour la colonne 'Titre' en utilisant l'une des 16 colonnes disponibles. Les listes SharePoint n’ont pas de colonne Nom de fichier.
    Alias d'espaces de noms Facultatif. Il s'agit d'une liste, séparée par des virgules ou des points-virgules, des définitions d'alias d'espaces de noms.

    Utilisez ce champ pour définir les alias d'espaces de noms utilisés par les requêtes XPATH introduites dans le champ « Nom de fichier » ou « Valeur de colonne ». Par exemple, entrez po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation' xmlns=" » ; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'. Note: Cette propriété ne remplace pas WSS. ConfigNamespacesAliases propriété de contexte de message définie par l’orchestration. Au lieu de cela, les deux valeurs sont fusionnées.
    Remplacer Requis. S'il existe un fichier, cette option détermine si le fichier est remplacé.

    La valeur par défaut est Non. Options disponibles :

    - Non : génère une erreur et suspend le message s’il existe un fichier portant le même nom.
    - Orchestration : utilise la valeur définie dans l’orchestration si un fichier portant le même nom existe.
    - Renommer : renomme le nouveau fichier s’il existe un fichier portant le même nom.
    - Oui : remplace un fichier existant s’il porte le même nom.
    Lorsque la valeur est Oui, l’envoi d’un grand nombre de messages portant le même nom peut entraîner des erreurs de observateur d'événements SharePoint. Ces erreurs n’ont aucun impact sur l'adaptateur, et un message qui échoue fait l'objet d'une nouvelle tentative d'envoi.
    URL de site SharePoint Requis. URL complète du site web SharePoint Services. Par exemple, http:// SharePointServer/sites/TestSite. Note: Un URI de port d’envoi ou d’emplacement de réception ne peut pas dépasser 256 caractères.
    Intégration de Microsoft Office Requis. Pour les messages binaires, vous devez utiliser Non ou Facultatif.

    La valeur par défaut est Facultatif. Options disponibles :

    • Non : enregistre le document tel quel. Vous pouvez utiliser cette option pour les messages binaires.
    • Facultatif : modifie le document de sorte qu’il s’ouvre automatiquement dans une application Office, comme InfoPath. Si les instructions de traitement sont introuvables, le document est traité tel qu’il est. Vous pouvez utiliser cette option pour les messages binaires.
    • Orchestration : utilise la valeur définie dans l’orchestration.
    • Oui : modifie le document de sorte qu’il s’ouvre automatiquement dans une application Office, comme InfoPath. Si les instructions de traitement sont introuvables, le message est interrompu.

      Lorsque la valeur est Oui, au moins l’une des paires de propriétés suivantes est requise :

      • Bibliothèque de documents modèles et colonne d’espace de noms modèles
      • Bibliothèque de documents de secours de modèles et colonne d’espace de noms de secours modèles
    • Oui (bibliothèque de formulaires InfoPath) : si une solution InfoPath réside dans la bibliothèque de formulaires, le document est modifié de sorte qu’il s’ouvre automatiquement dans une application Office, comme InfoPath. Si la bibliothèque de formulaires n’est associée à aucune solution, le message est interrompu.
    Bibliothèque de documents Modèles Obligatoire uniquement lorsque la colonne d’espace de noms de modèles est remplie. Il s'agit de la bibliothèque de documents SharePoint qui stocke les solutions InfoPath, Par exemple, Mes solutions. L’adaptateur recherche dans la bibliothèque de documents modèles une solution InfoPath correspondante. Si aucune solution n’est trouvée, l’adaptateur se trouve dans la bibliothèque de documents de secours des modèles. Note: La bibliothèque de documents modèles nécessite au moins une colonne SharePoint « Ligne de texte unique » remplie avec les éléments suivants :
    • le nom de l'espace de noms et le nœud racine des documents XML pouvant être ouverts avec la solution InfoPath ;
    • OU, le nœud racine du document XML.
    Pour plus d’informations, voir Procédure pas à pas : Module 2 - Intégration d’Office à l’adaptateur Windows SharePoint Services.
    Bibliothèque de documents Modèles de secours Obligatoire uniquement lorsque la colonne d’espace de noms de secours des modèles est remplie. Il s'agit de la bibliothèque de documents SharePoint qui stocke les solutions InfoPath, Par exemple, Modèles.

    Si aucune solution n’est trouvée dans la bibliothèque de documents de modèles, l’adaptateur recherche dans La bibliothèque de documents de secours des modèles une solution InfoPath correspondante. Les champs Bibliothèque de documents de secours de modèles et Bibliothèque de documents de modèles peuvent être utilisés avec deux ensembles de solutions InfoPath. Il existe des solutions InfoPath génériques à usage universel et des solutions InfoPath spécialisées qui sont utilisées uniquement pour un partenaire spécifique. Le champ Bibliothèque de documents de secours des modèles doit pointer vers les solutions génériques, et la bibliothèque de documents modèles doit pointer vers les solutions spécialisées pour ce partenaire particulier. Remarque : La bibliothèque de documents de secours de modèles nécessite au moins une colonne SharePoint « Ligne de texte unique » remplie avec les éléments suivants :
    • le nom de l'espace de noms et le nœud racine des documents XML pouvant être ouverts avec la solution InfoPath ;
    • OU, le nœud racine du document XML.
    Pour plus d’informations, voir Procédure pas à pas : Module 2 - Intégration d’Office à l’adaptateur Windows SharePoint Services.
    Colonne espaces de noms Modèles de secours Obligatoire uniquement lorsque la bibliothèque de documents de secours des modèles est remplie. Il s'agit de la bibliothèque de documents SharePoint qui stocke l'espace de noms des solutions InfoPath, Par exemple, myNamespace. Note: Ce champ respecte la casse.
    Colonne d'espace de noms des modèles Obligatoire uniquement lorsque la bibliothèque de documents de modèles est remplie. Colonne Bibliothèque de documents modèles SharePoint qui stocke l’espace de noms de la solution InfoPath. Par exemple, myNamespace. Note: Ce champ respecte la casse.
    Mot de passe SharePoint Online Facultatif. Il s'agit du mot de passe associé au compte SharePoint Online.
    Nom d'utilisateur SharePoint Online Facultatif. Il s'agit du nom d'utilisateur associé au compte SharePoint Online.
    Colonne n Facultatif. Colonne SharePoint qui existe dans la bibliothèque de documents de destination. Mettez à jour cette colonne avec la valeur extraite du message ou spécifiée dans le champ Valeur de colonne . Note: Jusqu’à 16 colonnes peuvent être spécifiées. Ce champ respecte la casse.
    Valeur de colonne n Facultatif. Entrez la valeur de colonne à définir pour ce message. Vous pouvez entrer une valeur littérale comme « Bon de commande » ou une expression. Les expressions peuvent se composer d'un mélange de littéraux, macros et requêtes XPATH, Par exemple, entrez « %XPATH=//po :POAmount% », « %SendingOrchestrationID% ». Note: Jusqu’à 16 colonnes peuvent être spécifiées.

  5. Cliquez sur OK pour enregistrer les paramètres.

  6. Autres options de configuration du port d'envoi :

    1. Configuration des options avancées de transport pour un port d'envoi

    2. Configuration des options de transport secondaire pour un port d'envoi

    3. Configuration des mappages sortants pour un port d'envoi

    4. Configuration des filtres pour un port d'envoi

    5. Attribution d'un certificat à un port d'envoi

    6. Configuration du suivi pour un port d'envoi

Création d'un port d'envoi dynamique

Lors de la création d'un port d'envoi dynamique, le gestionnaire d'envoi peut être configuré pour chaque adaptateur. Un port d'envoi dynamique unique peut être utilisé par plusieurs adaptateurs. Consultez Le gestionnaire de port d’envoi dynamique est configurable pour connaître les étapes de configuration du gestionnaire de port d’envoi dynamique.

  1. Dans la console Administration BizTalk Server, développez Groupe BizTalk [Nom_groupe], développez Applications, puis développez l’application pour contenir le port d’envoi.

  2. Cliquez avec le bouton droit sur Ports d’envoi, cliquez sur Nouveau, puis choisissez Port d’envoi unidirectionnel dynamique ou Port d’envoi dynamique Solicit-Response.

  3. Dans Propriétés, entrez les propriétés Nom et Pipeline .

    Cliquez sur Configurer.

  4. Dans la fenêtre Configurer le gestionnaire d’envoi, choisissez le gestionnaire d’envoi pour les adaptateurs individuels. Le gestionnaire d’envoi par défaut est BizTalkServerApplication. Pour connaître les étapes d’ajout d’un nouveau gestionnaire d’envoi, accédez à Comment créer un gestionnaire d’adaptateurs.

    L'utilisation d'hôtes distincts peut être motivée par plusieurs raisons :

    • Configuration requise 32 bits : certains adaptateurs nécessitent un hôte 32 bits, comme les adaptateurs FTP et POP3. Vous pouvez regrouper tous les adaptateurs ou chaque adaptateur 32 bits dans leur propre hôte.

      Prise en charge du fonctionnement en 64 bits pour BizTalk Server

    • Hôte par objectif : créez un hôte pour l’envoi, un hôte pour la réception, un hôte pour le traitement des orchestrations et un hôte pour le suivi.

    • Différents paramètres de l’hôte : de nombreux paramètres sont implémentés au niveau de l’hôte. Par conséquent, différents paramètres de limitation peuvent être configurés pour chaque hôte. Par exemple, vous pouvez désactiver la limitation sur HôteA, suivre chaque événement sur HôteB, modifier les paramètres .NET CLR sur HôteC ou augmenter l'utilisation de la mémoire sur HôteD.

    • Sécurité : la sécurité est implémentée au niveau de l’hôte. Chaque hôte est exécuté sous son propre compte Windows. Par exemple, HôteA utilise l'adaptateur FILE pour accéder à un partage de fichiers. Octroyez les autorisations d'accès au partage de fichiers au compte d'utilisateur HôteA. HôteB utilise un service Web hébergé sur un serveur IIS. Octroyez les autorisations d'accès au service Web au compte d'utilisateur HôteB. Cela empêche également d'autres comptes d'hôtes d'accéder à des entités auxquelles ils n’ont pas besoin d'accéder.

    • Adaptateurs distincts : par exemple, vous avez plusieurs artefacts (emplacement de réception et ports d’envoi) à l’aide de l’adaptateur HTTP. Vous souhaitez que tous les éléments associés à l'adaptateur HTTP se trouvent dans leur propre hôte.

    • Orchestrations distinctes : les orchestrations individuelles peuvent se trouver dans leur propre hôte. Par exemple, si une orchestration utilise la mémoire ou le processeur de manière intensive, placez cette orchestration dans son propre hôte.

      BizTalk Server Guide d’optimisation des performances et Guide pratique pour gérer et résoudre les problèmes BizTalk Server bases de données fournissent des suggestions de performances.

  5. Cliquez sur OK pour enregistrer les paramètres.

  6. Autres options de configuration du port d'envoi :

    1. Configuration des options avancées de transport pour un port d'envoi

    2. Configuration des mappages sortants pour un port d'envoi

    3. Configuration des filtres pour un port d'envoi

    4. Attribution d'un certificat à un port d'envoi

    5. Configuration du suivi pour un port d'envoi

  7. Cliquez sur OK pour enregistrer les paramètres.

    Autres rubriques relatives aux ports d'envoi :

    Création et configuration des ports d’envoi

    Création et configuration des groupes de ports d’envoi

Voir aussi

Résolution des problèmes de configurationde l’adaptateur SharePoint Services SharePoint Services emplacement de réception CSOM : adaptateur SharePoint Services