Créer l’URI de connexion système Siebel
L’URI de connexion de l’adaptateur Microsoft BizTalk pour Siebel eBusiness Applications contient les propriétés que l’adaptateur utilise pour établir une connexion au système Siebel.
Cette rubrique fournit des informations sur l’URI de connexion Siebel et fournit également des liens vers d’autres rubriques qui expliquent comment spécifier un URI de connexion dans différents scénarios de programmation.
URI de connexion pour l’adaptateur Siebel
Un URI d’adresse de point de terminaison WCF standard est représenté comme suit :
scheme://userinfoparams@hostinfoparams?query_string
L’URI d’adresse de point de terminaison contient les composants suivants :
scheme est le nom du schéma.
userinfoparams est une collection nom-valeur des paramètres requis pour l’authentification utilisateur par le point de terminaison.
hostinfoparams est des informations nécessaires pour établir la connexion à l’hôte ; par exemple, un chemin d’accès.
query_string est une collection nom-valeur facultative de paramètres délimités par un point d’interrogation ( ?).
L’URI de connexion Siebel suit ce format général et est implémenté comme suit :
siebel://Username=[USER_NAME];Password=[PASSWORD]@[SERVER]:[PORT]?SiebelObjectManager=[SIEBEL_OBJECT_MANAGER_NAME]&SiebelEnterpriseServer=[SERVER_NAME]&Language=[LANGUAGE]&Transport=[TRANSPORT]&Encryption=[ENCRYPTION]&Compression=[COMPRESSION]&SiebelServer=[SIEBEL_SERVER_NAME]&SiebelRepository=[SIEBEL_REPOSITORY_NAME]
Les sections suivantes décrivent les propriétés implémentées pour chaque composant de l’URI de connexion Siebel.
Schéma pour l’URI de connexion Siebel
Le schéma de l’URI de connexion Siebel est « siebel ».
Informations utilisateur dans l’URI de connexion Siebel
Par défaut, l’adaptateur Siebel lève une exception lorsque les informations d’identification système Siebel sont spécifiées dans l’URI de connexion. Cela est dû au fait que ces informations d’identification sont représentées sous forme de texte brut, ce qui pose un risque de sécurité inhérent. Vous pouvez définir la propriété de liaison AcceptCredentialsInUri pour contrôler si l’URI de connexion peut contenir des informations d’identification. Si la propriété AcceptCredentialsInUri a la valeur false, l’adaptateur Siebel lève une exception si l’URI de connexion contient des informations d’identification ; si la propriété a la valeur true, aucune exception n’est levée.
Important
En raison des risques de sécurité inhérents à la transmission d’informations d’identification dans des chaînes en texte brut, il est préférable de ne pas spécifier les informations d’identification système Siebel dans l’URI de connexion.
Il existe plusieurs façons de fournir des informations d’identification système Siebel sans les spécifier dans l’URI de connexion.
Dans le code, vous pouvez définir la propriété ClientCredentials sur l’objet approprié.
Lorsque vous utilisez le plug-in Ajouter une référence de service d’adaptateur ou le complément Consommer le service d’adaptateur, vous pouvez entrer les informations d’identification en sélectionnant l’onglet Sécurité de la boîte de dialogue Configurer l’adaptateur .
Lorsque vous spécifiez une liaison de port d’envoi ou d’emplacement de réception dans une solution BizTalk Server, vous pouvez entrer les informations d’identification en sélectionnant l’onglet Sécurité de la boîte de dialogue appropriée.
Les informations utilisateur (userinfoparams) dans l’URI de connexion Siebel sont représentées sous la forme d’une collection nom-valeur des paramètres requis pour l’authentification utilisateur. Le tableau suivant décrit ces paramètres.
| Propriété | Description |
|---|---|
| Nom d’utilisateur | Nom d’utilisateur sur le système Siebel ; cette valeur respecte la casse. Vous devez définir la propriété de liaison AcceptCredentialsInUri sur true pour spécifier le nom d’utilisateur et le mot de passe dans l’URI de connexion. Note: L’adaptateur Siebel conserve la casse de la valeur que vous entrez pour le nom d’utilisateur lorsqu’il ouvre une connexion sur le système Siebel. |
| Mot de passe | Mot de passe de l’utilisateur sur le système Siebel ; cette valeur respecte la casse. Vous devez définir la propriété de liaison AcceptCredentialsInUri sur true pour spécifier le nom d’utilisateur et le mot de passe dans l’URI de connexion. Note: L’adaptateur Siebel conserve la casse de la valeur que vous entrez pour le mot de passe lorsqu’il ouvre une connexion sur le système Siebel. |
Informations sur l’hôte dans l’URI de connexion Siebel
Les informations sur l’hôte Siebel (hostinfoparams) spécifient l’adresse du système Siebel au format suivant : [SERVER] :[PORT]. Selon la version du serveur Siebel, les informations de l’hôte Siebel prennent des valeurs différentes :
Pour Siebel version 7.5 et antérieures, le paramètre d’informations sur l’hôte prend le nom de l’ordinateur sur lequel le serveur de passerelle Siebel est installé et le numéro de port de la passerelle Siebel.
Pour Siebel version 7.7 et ultérieures, le paramètre d’informations sur l’hôte prend le nom de l’ordinateur sur lequel le serveur Siebel est installé et le numéro de port du répartiteur de connexions Siebel.
Important
Lorsque vous utilisez le plug-in Visual Studio Add Adapter Service Reference ou le complément De projet BizTalk Du service d’adaptateur de consommation pour vous connecter à un système Siebel, les informations sur l’hôte doivent être fournies pour la propriété de connexion « SiebelGateway ».
Informations de requête dans l’URI de connexion Siebel
Les informations de requête (query_string) dans l’URI de connexion Siebel sont utilisées pour spécifier des propriétés de connexion supplémentaires.
| Propriété | Description |
|---|---|
| SiebelObjectManager | Nom du gestionnaire d’objets Siebel sur le serveur d’entreprise. Ce paramètre est obligatoire. |
| SiebelEnterpriseServer | Nom de Siebel Enterprise Server. Ce paramètre est obligatoire. |
| Langage | Langue du gestionnaire d’objets. Ce paramètre est facultatif. S’il n’est pas spécifié, l’adaptateur Siebel fournit une valeur par défaut (enu). |
| Transport | Le transport ; seul tcpip est pris en charge. Ce paramètre est facultatif. Si elle n’est pas spécifiée, le système Siebel fournit une valeur par défaut (tcpip). |
| Chiffrement | Type de chiffrement à utiliser entre l'adaptateur Siebel et le système Siebel. Les valeurs prises en charge sont none, mscrypto ou rsa. Ce paramètre est facultatif. S’il n’est pas spécifié, le système Siebel fournit une valeur par défaut (aucun). |
| Compression | Algorithme de compression à utiliser entre l'adaptateur Siebel et le système Siebel. Les valeurs prises en charge sont none ou zlib. Ce paramètre est facultatif. Si elle n’est pas spécifiée, le système Siebel fournit une valeur par défaut (zlib). |
| SiebelServer | Serveur Siebel. Obligatoire pour toutes les connexions serveur Siebel 7.5 (7.5.2, 7.5.3, etc.) ; sinon, ne définissez pas ce paramètre. |
| SiebelRepository | Référentiel Siebel. Obligatoire s’il existe plusieurs référentiels sur le serveur ; sinon, facultatif. Note: S’il existe plusieurs référentiels sur le serveur, vous devez spécifier un dépôt cible dans le paramètre SiebelRepository. |
Pour plus d’informations sur les paramètres Siebel définis dans les informations de requête, consultez votre documentation Siebel.
Utilisation de caractères réservés dans l’URI de connexion
L’adaptateur Siebel ne prend pas en charge la spécification d’un URI de connexion comportant des caractères spéciaux pour l’une des valeurs de paramètre. Si les valeurs des paramètres de connexion contiennent des caractères spéciaux, veillez à effectuer l’une des opérations suivantes :
Si vous spécifiez l’URI dans Visual Studio à l’aide du plug-in Add Adapter Service Reference Plug-in ou Consume Adapter Service Add-in, vous devez le spécifier tel quel sous l’onglet Propriétés de l’URI , c’est-à-dire sans utiliser de caractères d’échappement. Si vous spécifiez l’URI directement dans le champ Configurer un URI et que les paramètres de connexion contiennent des caractères réservés, vous devez spécifier les paramètres de connexion à l’aide des caractères d’échappement appropriés.
Si vous spécifiez l’URI lors de la création d’un port d’envoi ou de réception dans BizTalk Server console Administration et que les paramètres de connexion contiennent des caractères réservés, vous devez spécifier les paramètres de connexion à l’aide des caractères d’échappement appropriés.
Utilisation de l’URI de connexion pour se connecter au système Siebel
Voici un exemple d’URI de connexion Siebel.
siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu
Notes
Cet exemple d’URI contient les informations d’identification système Siebel ; vous devez définir la propriété de liaison AcceptCredentialsInUri sur true pour utiliser un URI de connexion qui contient des informations d’identification.
Pour plus d’informations sur l’établissement d’une connexion au système Siebel (y compris la définition des propriétés de connexion) lorsque vous :
Utilisez le complément de projet BizTalk du service d’adaptateur de consommation ou le plug-in Ajouter une référence de service d’adaptateur Visual Studio. Consultez Obtenir des métadonnées pour les opérations Siebel dans Visual Studio.
Configurer un port d’envoi ou un port de réception (emplacement) dans une solution de BizTalk Server, consultez Configurer manuellement une liaison de port physique à l’adaptateur Siebel.
Utilisez le modèle de canal WCF dans une solution de programmation. Consultez Créer un canal à l’aide de Siebel.
Utilisez le modèle de service WCF dans une solution de programmation. Consultez Configurer un client WCF pour un système Siebel.
Utilisez wcf ServiceModel Metadata Utility Tool (svcutil.exe), consultez Utilisation de l’outil ServiceModel Metadata Utility Tool with the BizTalk Adapter for Siebel eBusiness Applications.
Voir aussi
Créer une connexion au système Siebel
Développer vos applications Siebel
Développer des applications Siebel à l’aide du modèle de canal WCF3
Développer des applications SQL à l’aide du modèle de service WCF