Créer l’URI de connexion système SAP
L’URI de connexion de l’adaptateur Microsoft BizTalk pour mySAP Business Suite contient des propriétés que l’adaptateur utilise pour établir une connexion au système SAP.
Important
Par défaut, la bibliothèque cliente SAP (librfc32u.dll) prend en charge un maximum de 100 connexions au système SAP. Si vous dépassez ce nombre de connexions, une exception est levée. Pour cette raison, vous devez définir la propriété de liaison MaxConnectionsPerSystem pour limiter le nombre de connexions que l’adaptateur SAP tente d’ouvrir sur le système SAP ; ou définissez la variable d’environnement CPIC_MAX_CONV pour augmenter le nombre de connexions prises en charge par la bibliothèque cliente SAP. Si vous modifiez CPIC_MAX_CONV, vous devez redémarrer votre ordinateur pour que la modification prenne effet. Pour plus d’informations sur les propriétés de liaison de l’adaptateur SAP, consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour mySAP Business Suite.
Cette rubrique fournit des informations sur l’URI de connexion SAP 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 SAP
Un URI d’adresse de point de terminaison WCF classique 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 d’adresse de point de terminaison que l’adaptateur SAP utilise pour un système SAP est spécifié à l’aide d’un URI de connexion SAP. L’adaptateur SAP implémente cet URI de connexion comme suit :
sap://user=[USER_NAME];passwd=[PASSWORD];Client=[CLIENT];lang=[LANGUAGE];[UseSnc]=[True|False]@connectiontype/conndetail1/conndetail2?GwHost=[GWHOST]?GwServ=[GWSERV]?MsServ=[MSSERV]?Group=[GROUP]?ListenerDest=[LISTENERDEST]?ListenerGwHost=[LISTENERGWHOST]?ListenerGwServ=[LISTENERGWSERV]?ListenerProgramId=[LISTENERPROGRAMID]?RfcSdkTrace=[true/false]?AbapDebug=[true/false]
Les composants de l’URI de connexion sont expliqués dans les sections suivantes.
Schéma d’URI de connexion SAP
Le schéma pour l’URI de connexion SAP est « sap ».
Informations utilisateur dans l’URI de connexion SAP
Les informations utilisateur (userinfoparams) dans l’URI de connexion SAP sont représentées sous la forme d’une collection nom-valeur des paramètres requis pour l’authentification de l’utilisateur, l’identification du client et la spécification de langue. Le tableau suivant décrit ces paramètres.
| Propriété | Description |
|---|---|
| Utilisateur | Nom d’utilisateur sur le système SAP ; 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 SAP conserve la casse de la valeur que vous entrez pour le nom d’utilisateur lorsqu’il ouvre une connexion sur le système SAP. |
| Passwd | Mot de passe de l’utilisateur sur le système SAP ; 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 SAP conserve la casse de la valeur que vous entrez pour le mot de passe lorsqu’il ouvre une connexion sur le système SAP. |
| Client | ID client du système SAP. |
| Langage | Langue : |
| UseSnc | Paramètre facultatif qui spécifie si SAP Secure Network Communications (SNC) est activé. La valeur peut être True ou False ; si true, SNC est activé. La valeur par défaut est False Lorsque vous activez SNC, vous devez également définir les propriétés de liaison SncPartnerName et SncLibrary . Pour plus d’informations, consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour mySAP Business Suite. Si SNC est activé et que l’URI de connexion contient des informations d’identification, l’adaptateur lève une exception. Note: Le paramètre de connexion UseSnc s’applique uniquement aux types de connexion A et B. Les différents types de connexion et leur importance sont décrits en détail plus loin dans cette rubrique. |
Notes
Vous devez spécifier le client et la langue dans l’URI de connexion SAP.
L’adaptateur SAP affiche la propriété de liaison AcceptCredentialsinUri afin que vous puissiez contrôler si les informations d’identification système SAP peuvent être spécifiées dans l’URI de connexion. Cela est dû au fait que les informations d’identification sont représentées en texte brut dans l’URI de connexion, ce qui présente un risque de sécurité inhérent. Par défaut, la propriété de liaison AcceptCredentialsInUri est false et l’adaptateur lève une exception si les informations d’identification sont spécifiées dans l’URI de connexion.
Il existe certains scénarios dans lesquels il est nécessaire de spécifier des informations d’identification dans l’URI de connexion ; par exemple, pour recevoir les opérations entrantes du système SAP lorsque vous utilisez le modèle de service WCF ou le modèle de canal WCF. Vous pouvez définir la propriété AcceptCredentialsInUri sur true pour ces scénarios. Toutefois, il est recommandé d’éviter de fournir des informations d’identification directement dans l’URI de connexion. Pour plus d’informations sur la façon de fournir des informations d’identification plus sécurisées pour la connexion SAP, consultez Sécuriser vos applications SAP.
Important
Si vous activez les communications réseau sécurisées (SNC) en définissant le paramètre UseSnc sur true, l’adaptateur lève une exception.
Informations sur l’hôte dans l’URI de connexion SAP
Les informations sur l’hôte SAP (hostinfoparams) sont représentées par les éléments suivants dans l’URI de connexion SAP : connectiontype/conndetail1/conndetail2. Ces paramètres spécifient des détails sur la connexion du client au système SAP. Des détails supplémentaires sur la connexion du client SAP ainsi que les détails qui établissent une connexion en tant qu’écouteur à une destination SAP RFC peuvent être spécifiés dans le query_string. L’adaptateur SAP prend en charge les types de connexion client suivants dans l’URI de connexion SAP :
R : Connexion basée sur l’hôte d’application dans laquelle l’URI de connexion spécifie un serveur d’applications via lequel l’adaptateur SAP se connecte à SAP.
B : connexion à charge équilibrée dans laquelle l’URI de connexion spécifie un serveur de messages via lequel l’adaptateur SAP se connecte à SAP.
D : connexion basée sur la destination dans laquelle l’URI de connexion spécifie une destination dans le fichier saprfc.ini qui contient les paramètres de connexion pour SAP.
Le tableau suivant décrit comment ces connexions sont spécifiées dans l’URI de connexion SAP.
| Type de la connexion | Conndetail1 | Conndetail2 | Description |
|---|---|---|---|
| Un | ASHOST (Hôte du serveur d’applications) | SYSNR (numéro de système SAP) | Spécifie une connexion basée sur l’hôte d’application. Pour une connexion basée sur l’hôte d’application, un hôte de passerelle et un service de passerelle facultatifs peuvent être spécifiés dans le query_string. |
| B | MSHOST (hôte du serveur de messages) | R3NAME (NOM SAP R3) | Spécifie une connexion d’équilibrage de charge via un serveur de messages. Pour une connexion d’équilibrage de charge, un groupe de serveurs facultatif et un service de message peuvent être spécifiés dans le query_string. |
| D | DEST (Destination qui contient les paramètres de connexion dans le fichier saprfc.ini) | -- | Spécifie une connexion basée sur la destination. Les paramètres de connexion SAP sont contenus dans la destination spécifiée dans le fichier saprfc.ini. Seules les connexions de type A et de type B peuvent être spécifiées dans la destination. |
Notes
Si vous spécifiez des valeurs de connexion dans le fichier saprfc.ini, assurez-vous que le fichier se trouve dans le même dossier que le .exe qui accède au fichier ou à un emplacement standard requis par le système SAP. Pour plus d’informations, consultez la documentation SAP.
Informations de requête dans l’URI de connexion SAP
Les informations de requête (query_string) dans l’URI de connexion SAP contiennent des paramètres facultatifs qui peuvent être inclus pour spécifier les éléments suivants :
Détails de connexion supplémentaires pour les connexions basées sur l’hôte d’application (A).
Détails de connexion supplémentaires pour les connexions d’équilibrage de charge (B).
Détails de l’écouteur qui spécifient une destination RFC sur le système SAP par le biais duquel le système SAP peut envoyer des RFC, des TRFCs et des IDocs à l’adaptateur SAP.
Indique s’il faut activer SAP Secure Network Communications (SNC).
Détails qui spécifient la configuration du débogage.
Les paramètres de requête sont facultatifs ; toutefois, les détails de l’écouteur doivent être spécifiés pour que l’adaptateur SAP agisse en tant que serveur RFC.
Le tableau suivant décrit les paramètres de requête et indique les types de connexion SAP pour lesquels ils sont valides.
| Valeur | Type de connexion valide | Description |
|---|---|---|
| GwHost | A | Spécifie le nom d’un hôte de passerelle facultatif dans une connexion basée sur l’hôte d’application. |
| GwServ | A | Spécifie le nom d’un service de passerelle facultatif dans une connexion basée sur l’hôte d’application. |
| MsServ | B | Spécifie le nom d’un service de message facultatif dans une connexion d’équilibrage de charge. |
| Groupe | B | Spécifie un groupe facultatif de serveurs d’applications dans une connexion d’équilibrage de charge. |
| ListenerDest | (R) | Spécifie une destination facultative dans le fichier saprfc.ini dans une connexion de serveur rfc. La destination doit spécifier une connexion de type R. |
| ListenerGwHost | (R) | Spécifie l’hôte de passerelle pour une connexion de serveur rfc. Ce paramètre est facultatif ; Toutefois, si une connexion serveur rfc est souhaitée et QUE LISTENERDEST n’est pas spécifié ou qu’aucun hôte de passerelle n’est spécifié par la destination dans le fichier saprfc.ini, LISTENERGWHOST doit contenir un hôte de passerelle valide. |
| ListenerGwServ | (R) | Spécifie le service de passerelle pour une connexion de serveur rfc. Ce paramètre est facultatif ; Toutefois, si une connexion serveur rfc est souhaitée et QUE LISTENERDEST n’est pas spécifié ou qu’aucun service de passerelle n’est spécifié par la destination dans le fichier saprfc.ini, LISTENERGWSERV doit contenir un service de passerelle valide. |
| ListenerProgramId | (R) | Spécifie l’ID de programme pour une connexion de serveur rfc. Ce paramètre est facultatif ; Toutefois, si une connexion serveur rfc est souhaitée et QUE LISTENERDEST n’est pas spécifié ou si aucun service de passerelle n’est spécifié par la destination dans le fichier saprfc.ini, LISTENERPROGRAMID doit contenir un service de passerelle valide. |
| RfcSdkTrace | Tous | Paramètre facultatif qui spécifie si le suivi de bibliothèque RFC est activé. La valeur peut être True ou False ; si la valeur est True, le suivi de la bibliothèque RFC est activé. La valeur par défaut est False. Le niveau de suivi activé par le paramètre RfcSdkTrace dépend de la variable d’environnement RFC_TRACE. - Si RFC_TRACE pas présent ou est défini sur 0, le niveau minimal de suivi est activé. - Vous pouvez définir RFC_TRACE sur 1 ou 2 pour augmenter le niveau de suivi. |
| AbapDebug | Tous | Paramètre facultatif qui spécifie si le débogage ABAP à partir de Visual Studio est activé. La valeur peut être True ou False ; si la valeur est True, le débogage ABAP est activé. La valeur par défaut est False. Si AbapDebug a la valeur True, l’interface graphique graphique SAP est ouverte. |
| SAPROUTER | Tous | Paramètre facultatif pour SAProuter lorsqu’il est utilisé pour les connexions via un pare-feu. Ce paramètre est une liste de noms d’hôtes et de noms de service/numéros de port au format suivant : /H/hostname/S/portnumber. |
Les paramètres de la chaîne de requête sont des paramètres SAP et leurs valeurs sont définies par SAP. Pour plus d’informations sur ces paramètres, consultez votre documentation SAP.
Voici un exemple d’URI de connexion pour une connexion basée sur l’hôte d’application :
sap://Client=800;lang=EN@A/YourSAPHOST/00
Propriétés de l’URI de connexion dans la boîte de dialogue Configurer l’adaptateur
Lorsque vous vous connectez au système SAP avec le complément de projet BizTalk du service d’adaptateur consommer ou le plug-in Visual Studio, vous définissez les paramètres d’URI de connexion à partir de l’onglet Propriétés de l’URI de la boîte de dialogue Configurer l’adaptateur . Le tableau suivant montre comment les propriétés de l’URI sont affichées dans la feuille Propriétés de l’URI . (Les propriétés d’URI sont répertoriées par groupe dans l’ordre dans lequel elles apparaissent dans la feuille Propriétés de l’URI.)
| Category | URI, propriété | Composant URI |
|---|---|---|
| Serveur d’applications | Hôte du serveur d'application | Conndetail1 (type de connexion d’informations sur l’hôte A) |
| Serveur d’applications | Hôte de passerelle | GwHost (chaîne de requête) |
| Serveur d’applications | Service de passerelle | GwServ (chaîne de requête) |
| Serveur d’applications | Numéro système | Conndetail2 (type de connexion d’informations sur l’hôte A) |
| Destination | Nom de la destination | Conndetail1 (type de connexion d’informations d’hôte D) |
| Diagnostics | RFC Trace | RfcSdkTrace (chaîne de requête) |
| Diagnostics | Déboguer ABAP | AbapDebug (chaîne de requête) |
| Informations de connexion | Client | Client (userinfoparams) |
| Informations de connexion | Langage | Langue (userinfoparams) |
| Serveur de messages | Nom du groupe de serveurs d’applications | Groupe (chaîne de requête) |
| Serveur de messages | Hôte de serveur de message | Conndetail1 (type de connexion d’informations sur l’hôte B) |
| Serveur de messages | Service du serveur de message | MsServ (chaîne de requête) |
| Serveur de messages | Nom de système R/3 | Conndetail2 (type de connexion d’informations sur l’hôte B) |
| Divers | Type de la connexion | Type de connexion (informations sur l’hôte : A, B ou D) |
| Divers | Routeur SAP | SAPROUTER (chaîne de requête) |
| Serveur RFC | Nom de la destination | ListenerDest (chaîne de requête) |
| Serveur RFC | Hôte de passerelle | ListenerGwHost (chaîne de requête) |
| Serveur RFC | Service de passerelle | ListenerGwServ (chaîne de requête) |
| Serveur RFC | ID de programme | ListenerProgramId (chaîne de requête) |
| SNC | UseSnc | UseSnc (informations utilisateur) |
Comment spécifier un URI de connexion pour les connexions au serveur RFC.
Pour créer une adresse de point de terminaison par le biais de laquelle l’adaptateur SAP peut agir en tant que serveur RFC, vous devez spécifier un ID de programme SAP, un hôte de passerelle SAP et un service de passerelle SAP qui correspondent à une destination RFC sur le système SAP. Pour plus d’informations sur la configuration d’une destination RFC sur SAP, consultez Créer une RFC, une destination RFC et envoyer une RFC à partir de SAP.
Vous pouvez spécifier l’ID de programme, l’hôte de passerelle et le service de passerelle dans l’URI de connexion de deux façons :
en définissant les paramètres de requête ListenerGwHost, ListenerGwServ et ListenerProgramId
en définissant le paramètre de requête ListenerDest sur une destination dans le fichier saprfc.ini qui spécifie une connexion de type R.
Notes
Si vous spécifiez des valeurs de connexion dans le fichier saprfc.ini, assurez-vous que le fichier se trouve au même emplacement que le .exe l’accès au fichier ou à un emplacement standard requis par le système SAP. Pour plus d’informations, consultez la documentation SAP.
Pour spécifier un URI de connexion pour une connexion de serveur RFC, vous spécifiez une connexion cliente régulière avec une destination RFC spécifiée dans la chaîne de requête, comme dans l’exemple suivant :
sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
L’adaptateur SAP utilise les informations contenues dans la partie userinfoparams et hostinfoparams de l’URI de connexion pour récupérer les métadonnées du système SAP et utilise les informations fournies par les paramètres de l’écouteur dans la chaîne de requête pour s’inscrire en tant qu’écouteur à la destination SAP RFC.
Utilisation de caractères réservés dans l’URI de connexion
L’adaptateur SAP 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 SAP
Pour plus d’informations sur l’établissement d’une connexion au système SAP lorsque vous :
Utilisez le complément de projet BizTalk du service d’adaptateur de consommation ou le plug-in Add Adapter Service Reference Visual Studio. Consultez Se connecter au système SAP 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 SAP.
Utilisez le modèle de canal WCF dans une solution de programmation. Consultez Créer un canal à l’aide de SAP.
Utilisez le modèle de service WCF dans une solution de programmation. Consultez Configurer une liaison cliente pour le système SAP.
Utilisez l’outil WCF ServiceModel Metadata Utility Tool (svcutil.exe), consultez Utilisation de l’outil Utilitaire de métadonnées ServiceModel avec l’adaptateur BizTalk pour mySAP Business Suite.