Configuration d'un emplacement de réception SOAP
Vous pouvez configurer un emplacement de réception SOAP par programmation ou à l’aide de la console Administration BizTalk Server.
Configuration d'un emplacement de réception SOAP par programme
Le modèle objet BizTalk Explorer vous permet de créer et de configurer des emplacements de réception par programmation. Le modèle objet BizTalk Explorer expose l’interface de configuration de l’emplacementde réception IReceiveLocation qui a une propriété de lecture/écriture TransportTypeData. Cette propriété accepte le jeu de propriétés de configuration de l'emplacement de réception SOAP sous la forme d'une chaîne XML composée d'une paire nom/valeur. Pour définir cette propriété dans le modèle objet BizTalk Explorer, vous devez définir la propriété InboundTransportLocation de l’interface IReceiveLocation.
La propriété TransportTypeData de l’interface IReceiveLocation n’a pas besoin d’être définie. Dans ce cas, l'adaptateur SOAP utilise les valeurs par défaut pour la configuration de l'emplacement de réception SOAP, comme indiqué dans le tableau suivant.
Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir dans le modèle objet de l'Explorateur BizTalk pour l'emplacement de réception SOAP.
| Nom de la propriété | Type | Description |
|---|---|---|
| URI | String | Répertoire virtuel contenant le service Web sur le serveur de déploiement. |
| AddressableURI | String | Champ d'adresse publique contenant l'URL entière pouvant être appelée. Valeur par défaut : vide |
| UseSSO | Boolean | Spécifie si l'adaptateur SOAP émet le ticket d'authentification unique pour les messages arrivant sur cet emplacement de réception. Valeur par défaut : False |
Pour définir les propriétés, utilisez le format suivant :
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
Les propriétés URI et AddressableURI sont définies à l’aide des propriétés Address et PublicAddress de l’objet emplacement de réception.
Le fragment de code suivant illustre la création d'un emplacement de réception SOAP :
// Use BizTalk Explorer object model to create new SOAP receive location.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new Request-Response port
ReceivePort receivePort = explorer.AddNewReceivePort(true);
receivePort.Name = "SampleReceivePort";
receivePort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Add primary SOAP receive location
ReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
receiveLocation.Address = "/PurchaseOrder/POOrchestration.asmx";
receiveLocation.TransportType = explorer.ProtocolTypes["SOAP"];
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
foreach (ReceiveHandler receiveHandler in explorer.ReceiveHandlers)
{
if (receiveHandler.TransportType.Name == receiveLocation.TransportType.Name)
{
receiveLocation.ReceiveHandler = receiveHandler;
}
}
// Save
explorer.SaveChanges();
Configuration d'un emplacement de réception SOAP à l'aide de la console Administration de BizTalk Server
Vous pouvez définir des variables d’adaptateur d’emplacement de réception SOAP dans la console Administration BizTalk Server. Si les propriétés ne sont pas définies pour l'emplacement de réception, les valeurs par défaut du gestionnaire de réception définies dans la console Administration de BizTalk Server sont utilisées.
Notes
Avant d'effectuer les procédures suivantes, vous devez avoir ajouté un port de réception. Pour plus d'informations, consultez la rubrique Création d'un port de réception.
Pour configurer les variables pour un emplacement de réception SOAP
Dans la console Administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, Applications, puis l’application dans laquelle vous souhaitez créer un emplacement de réception.
Dans la console d’administration BizTalk Server, dans le volet gauche, cliquez sur le nœud Port de réception. Dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou auquel associer un nouvel emplacement, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du port de réception, dans le volet gauche, sélectionnez Emplacements de réception, puis dans le volet droit, double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveaupour créer un emplacement de réception.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la section Transport en regard de Type, sélectionnez SOAP dans la liste déroulante, puis cliquez sur Configurer.
Dans la boîte de dialogue Propriétés du transport SOAP , procédez comme suit :
Propriété Pour Répertoire virtuel assorti du fichier .asmx du service Web Indiquer le fichier .asmx créé par l'Assistant Publication de services Web de BizTalk.
Le format de ce message est similaire à ce qui suit :
/BonDeCommande/OrganisationBDC.asmx
Où l’emplacement complet du fichier .asmx est http://localhost/PurchaseOrder/POOrchestration.asmx. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.Adresse publique Indiquer l'adresse URI complète de cet emplacement de réception. La valeur de cette propriété est constituée du nom du serveur et de celui du répertoire virtuel. L'URI indiquée doit désigner l'URL du site Web public de manière à ce que les partenaires commerciaux puissent s'y connecter lors de l'envoi de messages à BizTalk Server.
Ces informations sont facultatives et ne sont pas utilisées par BizTalk Server. Ce paramètre est disponible pour permettre aux administrateurs de documenter l'URL publique à laquelle est lié l'emplacement de réception.Utiliser l’authentification unique Indiquer que l'adaptateur SOAP utilise l'authentification unique de l'entreprise. Note: L’Assistant Publication des services web BizTalk vous permet d’utiliser SharePoint Portal Server’authentification unique. Cette propriété active uniquement l’authentification unique d’entreprise. Cliquez sur OK.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, entrez les valeurs appropriées pour terminer la configuration de l’emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d'informations sur la boîte de dialogue Propriétés de l'emplacement de réception , consultez la rubrique Création d'un emplacement de réception.
Les paramètres de sécurité utilisés par l'emplacement de réception SOAP sont définis dans IIS. Par défaut, l'emplacement de réception SOAP n'est pas configuré pour utiliser l'authentification anonyme.
Tandis que le client SOAP appelle le service Web, l'adaptateur SOAP authentifie le client à l'aide de l'authentification Anonyme, De base, Digest ou Intégrée Windows. Si la vérification de l'utilisateur est activée, le contexte utilisateur est transmis au gestionnaire de réception.
Notes
Toute configuration IIS menant au partage du même processus par SOAP et HTTP est non valide. Vous ne pouvez utiliser qu'un seul récepteur isolé par processus.
Pour mettre à jour un répertoire virtuel pour utiliser ASP.NET 4.0
Lancez le Gestionnaire des services Internet (IIS). Cliquez sur Démarrer, sur Tous les programmes, puis sur Gestionnaire des services Internet (IIS).
Si vous devez vous connecter à un serveur IIS distant, cliquez avec le bouton droit sur le nœud Services Internet Information , puis cliquez sur Se connecter.
Tapez le nom d'ordinateur du serveur IIS distant et les informations d'identification, le cas échéant.
Développez le nom du serveur qui héberge le site Web ou le répertoire virtuel à mettre à jour.
Développez Sites.
Développez Site web par défaut.
Développez le site Web par défaut pour afficher les répertoires virtuels sous le site Web.
Cliquez avec le bouton droit sur le répertoire virtuel que vous souhaitez mettre à jour pour utiliser ASP.NET 4.0, cliquez sur Gérer l’application, puis sur Paramètres avancés. Le champ Pool d’applications affiche l’ensemble du pool d’applications pour le répertoire virtuel sélectionné. Cliquez sur OK.
Dans la fenêtre Gestionnaire des services Internet (IIS), cliquez sur Pools d’applications. Le volet Détails affiche la liste des pools d'applications sur le serveur.
Cliquez avec le bouton droit sur le pool d’applications défini à l’étape 8, puis cliquez sur Paramètres de base.
Dans la boîte de dialogue Modifier le pool d’applications, modifiez les éléments suivants :
.NET Framework version4.0
Mode pipeline managé vers Classic
Cliquez sur OK pour appliquer les modifications.