Creare l'URI di connessione di sistema SAP
L'adapter Microsoft BizTalk per l'URI di connessione mySAP Business Suite contiene proprietà usate dall'adapter per stabilire una connessione al sistema SAP.
Importante
Per impostazione predefinita, la libreria client SAP (librfc32u.dll) supporta un massimo di 100 connessioni al sistema SAP. Se si supera questo numero di connessioni, verrà generata un'eccezione. Per questo motivo, è necessario impostare la proprietà di associazione MaxConnectionsPerSystem per limitare il numero di connessioni che l'adapter SAP tenterà di aprire nel sistema SAP; o impostare la variabile di ambiente CPIC_MAX_CONV per aumentare il numero di connessioni supportate dalla libreria client SAP. Se si modifica CPIC_MAX_CONV, è necessario riavviare il computer per rendere effettiva la modifica. Per altre informazioni sulle proprietà di associazione dell'adapter SAP, vedere Informazioni sulle proprietà di associazione di BizTalk Adapter per mySAP Business Suite.
Questo argomento fornisce informazioni sull'URI di connessione SAP e fornisce anche collegamenti ad altri argomenti che illustrano come specificare un URI di connessione in scenari di programmazione diversi.
URI di connessione per l'adapter SAP
Un URI di indirizzo endpoint WCF tipico è rappresentato come segue:
scheme://userinfoparams@hostinfoparams?query_string
L'URI dell'indirizzo endpoint contiene i componenti seguenti:
scheme è il nome dello schema.
userinfoparams è una raccolta nome-valore di parametri necessari per l'autenticazione utente dall'endpoint.
hostinfoparams è informazioni necessarie per stabilire la connessione all'host; ad esempio un percorso.
query_string è una raccolta facoltativa nome-valore di parametri delimitati da un punto interrogativo (?).
L'URI dell'indirizzo endpoint usato dall'adattatore SAP per un sistema SAP viene specificato usando un URI di connessione SAP. L'adattatore SAP implementa questo URI di connessione come indicato di seguito:
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]
I componenti dell'URI di connessione sono illustrati nelle sezioni seguenti.
Schema URI connessione SAP
Lo schema per l'URI di connessione SAP è "sap".
Informazioni utente nell'URI di connessione SAP
Le informazioni utente (userinfoparams) nell'URI di connessione SAP sono rappresentate come raccolta nome-valore di parametri necessari per l'autenticazione utente, l'identificazione client e la specifica della lingua. Nella tabella seguente vengono descritti i parametri.
| Proprietà | Descrizione |
|---|---|
| Utente | Nome utente nel sistema SAP; questo valore fa distinzione tra maiuscole e minuscole. È necessario impostare la proprietà di associazione AcceptCredentialsInUrisu true per specificare il nome utente e la password nell'URI di connessione. Nota: L'adattatore SAP mantiene la combinazione di maiuscole e minuscole del valore immesso per il nome utente quando apre una connessione nel sistema SAP. |
| Passwd | Password per l'utente nel sistema SAP; questo valore fa distinzione tra maiuscole e minuscole. È necessario impostare la proprietà di associazione AcceptCredentialsInUrisu true per specificare il nome utente e la password nell'URI di connessione. Nota: L'adattatore SAP mantiene il caso del valore immesso per la password quando apre una connessione nel sistema SAP. |
| Client | ID client di sistema SAP. |
| Linguaggio | Lingua. |
| UseSnc | Parametro facoltativo che specifica se SAP Secure Network Communications (SNC) è abilitato. Il valore può essere True o False; se True, SNC è abilitato. Il valore predefinito è False Quando si abilita SNC, è necessario impostare anche le proprietà di associazione SncPartnerName e SncLibrary . Per altre informazioni, vedere Informazioni sull'adapter BizTalk per le proprietà di associazione mySAP Business Suite. Se SNC è abilitato e l'URI di connessione contiene credenziali, l'adapter genera un'eccezione. Nota: Il parametro di connessione UseSnc è applicabile solo per i tipi di connessione A e B. I diversi tipi di connessione e il loro significato sono descritti in dettaglio più avanti in questo argomento. |
Nota
È necessario specificare client e lingua nell'URI di connessione SAP.
L'adattatore SAP presenta la proprietà di associazione AcceptCredentialsinUri in modo da poter controllare se è possibile specificare le credenziali di sistema SAP nell'URI di connessione. Ciò è dovuto al fatto che le credenziali sono rappresentate come testo normale nell'URI di connessione e ciò comporta un rischio di sicurezza intrinseco. Per impostazione predefinita, la proprietà di associazione AcceptCredentialsInUri è false e l'adapter genera un'eccezione se le credenziali sono specificate nell'URI di connessione.
Esistono alcuni scenari in cui è necessario specificare le credenziali nell'URI di connessione; Ad esempio, per ricevere le operazioni in ingresso dal sistema SAP quando si usa il modello di servizio WCF o il modello di canale WCF. È possibile impostare la proprietà AcceptCredentialsInUri su true per questi scenari. È tuttavia consigliabile evitare di fornire le credenziali direttamente nell'URI di connessione. Per altre informazioni su come fornire in modo più sicuro le credenziali per la connessione SAP, vedere Proteggere le applicazioni SAP.
Importante
Se si abilita Secure Network Communications (SNC) impostando il parametro UseSnc su true, la scheda genera un'eccezione.
Informazioni sull'host nell'URI di connessione SAP
Le informazioni sull'host SAP (hostinfoparams) sono rappresentate dagli elementi seguenti nell'URI di connessione SAP: connectiontype/conndetail1/conndetail2. Questi parametri specificano i dettagli sulla connessione client al sistema SAP. Altri dettagli sulla connessione client SAP e dettagli che stabiliscono una connessione come listener a una destinazione SAP RFC possono essere specificati nella query_string. L'adattatore SAP supporta i tipi di connessione client seguenti nell'URI di connessione SAP:
R: Connessione basata su host dell'applicazione in cui l'URI di connessione specifica un server applicazioni tramite il quale la scheda SAP si connette a SAP.
B: connessione con bilanciamento del carico in cui l'URI di connessione specifica un server di messaggi tramite il quale l'adapter SAP si connette a SAP.
D: connessione basata sulla destinazione in cui l'URI di connessione specifica una destinazione nel file saprfc.ini che contiene i parametri di connessione per SAP.
Nella tabella seguente viene descritto il modo in cui queste connessioni vengono specificate nell'URI di connessione SAP.
| Tipo di connessione | Conndetail1 | Conndetail2 | Descrizione |
|---|---|---|---|
| A | ASHOST (host del server applicazioni) | SYSNR (numero di sistema SAP) | Specifica una connessione basata su host dell'applicazione. Per una connessione basata su host dell'applicazione, è possibile specificare un host gateway e un servizio gateway facoltativi nel query_string. |
| B | MSHOST (host del server di messaggi) | R3NAME (nome SAP R3) | Specifica una connessione di bilanciamento del carico tramite un server messaggi. Per una connessione di bilanciamento del carico, è possibile specificare un gruppo di server e un servizio messaggi facoltativi nel query_string. |
| D | DEST (destinazione che contiene i parametri di connessione nel file di saprfc.ini) | -- | Specifica una connessione basata sulla destinazione. I parametri di connessione SAP sono contenuti nella destinazione specificata nel file saprfc.ini. Solo le connessioni di tipo A e B possono essere specificate nella destinazione. |
Nota
Se si specificano i valori di connessione nel file saprfc.ini, assicurarsi che il file si trovi nella stessa cartella del .exe accedere al file o in un percorso standard come richiesto dal sistema SAP. Per altre informazioni, vedere la documentazione di SAP.
Eseguire query sulle informazioni nell'URI di connessione SAP
Le informazioni sulla query (query_string) nell'URI di connessione SAP contengono parametri facoltativi che possono essere inclusi per specificare quanto segue:
Dettagli aggiuntivi sulla connessione per le connessioni basate su host dell'applicazione (A).
Dettagli aggiuntivi della connessione per le connessioni di bilanciamento del carico (B).
Dettagli del listener che specificano una destinazione RFC nel sistema SAP tramite cui il sistema SAP può inviare RFC, TRFC e IDocs all'adattatore SAP.
Indica se abilitare SAP Secure Network Communications (SNC).
Dettagli che specificano la configurazione di debug.
I parametri di query sono facoltativi; Tuttavia, i dettagli del listener devono essere specificati affinché l'adattatore SAP funga da server RFC.
La tabella seguente descrive i parametri di query e indica i tipi di connessione SAP per i quali sono validi.
| Valore | Tipo di connessione valido | Descrizione |
|---|---|---|
| GwHost | Una | Specifica il nome di un host gateway facoltativo in una connessione basata su host dell'applicazione. |
| GwServ | Una | Specifica il nome di un servizio gateway facoltativo in una connessione basata su host dell'applicazione. |
| MsServ | B | Specifica il nome di un servizio messaggio facoltativo in una connessione di bilanciamento del carico. |
| Raggruppare | B | Specifica un gruppo facoltativo di server applicazioni in una connessione di bilanciamento del carico. |
| ListenerDest | (R) | Specifica una destinazione facoltativa nel file saprfc.ini in una connessione server rfc. La destinazione deve specificare una connessione di tipo R. |
| ListenerGwHost | (R) | Specifica l'host del gateway per una connessione server rfc. Questo parametro è facoltativo; tuttavia, se è desiderata una connessione server rfc e LISTENERDEST non è specificato o nessun host gateway viene specificato dalla destinazione nel file saprfc.ini, LISTENERGWHOST deve contenere un host gateway valido. |
| ListenerGwServ | (R) | Specifica il servizio gateway per una connessione server rfc. Questo parametro è facoltativo; tuttavia, se è desiderata una connessione del server rfc e LISTENERDEST non è specificato o non viene specificato alcun servizio gateway dalla destinazione nel file saprfc.ini, LISTENERGWSERV deve contenere un servizio gateway valido. |
| ListenerProgramId | (R) | Specifica l'ID programma per una connessione server rfc. Questo parametro è facoltativo; tuttavia, se è desiderata una connessione del server rfc e LISTENERDEST non è specificato o non viene specificato alcun servizio gateway dalla destinazione nel file saprfc.ini, LISTENERPROGRAMID deve contenere un servizio gateway valido. |
| RfcSdkTrace | Tutti | Parametro facoltativo che specifica se la traccia della libreria RFC è abilitata. Il valore può essere True o False; se True, la traccia della libreria RFC è abilitata. Il valore predefinito è False. Il livello di traccia abilitato dal parametro RfcSdkTrace dipende dalla variabile di ambiente RFC_TRACE. - Se RFC_TRACE non presente o è impostato su 0, il livello minimo di traccia è abilitato. - È possibile impostare RFC_TRACE su 1 o 2 per aumentare il livello di traccia. |
| AbapDebug | Tutti | Parametro facoltativo che specifica se il debug ABAP da Visual Studio è abilitato. Il valore può essere True o False; se True, il debug ABAP è abilitato. Il valore predefinito è False. Se AbapDebug è True, l'interfaccia grafica SAP viene aperta. |
| SAPROUTER | Tutti | Parametro facoltativo per SAProuter quando viene usato per le connessioni tramite un firewall. Questo parametro è un elenco di nomi host e nomi di servizio/numeri di porta nel formato seguente: /H/hostname/S/portnumber. |
I parametri nella stringa di query sono parametri SAP e i relativi valori sono definiti da SAP. Per altre informazioni su questi parametri, vedere la documentazione di SAP.
Di seguito viene illustrato un URI di connessione di esempio per una connessione basata su host dell'applicazione:
sap://Client=800;lang=EN@A/YourSAPHOST/00
Proprietà URI connessione nella finestra di dialogo Configura adattatore
Quando ci si connette al sistema SAP con il componente aggiuntivo Del progetto BizTalk del servizio adapter o il plug-in Add Adapter Service Reference Visual Studio, si impostano i parametri URI di connessione dalla scheda Proprietà URI nella finestra di dialogo Configura adattatore . Nella tabella seguente viene illustrato come vengono visualizzate le proprietà dell'URI nel foglio Proprietà URI . Le proprietà URI sono elencate dal gruppo nell'ordine in cui vengono visualizzate nel foglio Proprietà URI.
| Category | URI, proprietà | Parte URI |
|---|---|---|
| Server applicazioni | Application Server Host | Conndetail1 (tipo di connessione delle informazioni host A) |
| Server applicazioni | Host gateway | GwHost (stringa di query) |
| Server applicazioni | Servizio gateway | GwServ (stringa di query) |
| Server applicazioni | Numero sistema | Conndetail2 (tipo di connessione delle informazioni host A) |
| Destination | Nome destinazione | Conndetail1 (tipo di connessione delle informazioni host D) |
| Diagnostica | Traccia RFC | RfcSdkTrace (stringa di query) |
| Diagnostica | ABAP Debug | AbapDebug (stringa di query) |
| Informazioni di accesso | Client | Client (userinfoparams) |
| Informazioni di accesso | Linguaggio | Lingua (userinfoparams) |
| Server messaggi | Nome del gruppo di Application Server | Gruppo (stringa di query) |
| Server messaggi | Message Server Host | Conndetail1 (tipo di connessione delle informazioni host B) |
| Server messaggi | Message Server Service | MsServ (stringa di query) |
| Server messaggi | R/3 System Name | Conndetail2 (tipo di connessione delle informazioni host B) |
| Varie | Tipo di connessione | Tipo di connessione (informazioni host: A, B o D) |
| Varie | SAP Router | SAPROUTER (stringa di query) |
| RFC Server | Nome destinazione | ListenerDest (stringa di query) |
| RFC Server | Host gateway | ListenerGwHost (stringa di query) |
| RFC Server | Servizio gateway | ListenerGwServ (stringa di query) |
| RFC Server | ID programma | ListenerProgramId (stringa di query) |
| SNC | UseSnc | UseSnc (informazioni utente) |
Come specificare un URI di connessione per le connessioni server RFC.
Per creare un indirizzo endpoint tramite il quale l'adapter SAP può fungere da server RFC, è necessario specificare un ID programma SAP, un host del gateway SAP e un servizio gateway SAP che corrispondono a una destinazione RFC nel sistema SAP. Per informazioni su come configurare una destinazione RFC in SAP, vedere Creare una destinazione RFC, RFC e inviare un RFC da SAP.
È possibile specificare l'ID programma, l'host gateway e il servizio gateway nell'URI di connessione in uno dei due modi seguenti:
impostando i parametri di query ListenerGwHost, ListenerGwServ e ListenerProgramId
impostando il parametro query ListenerDest su una destinazione nel file saprfc.ini che specifica una connessione di tipo R.
Nota
Se si specificano i valori di connessione nel file saprfc.ini, assicurarsi che il file si trovi nello stesso percorso del .exe l'accesso al file o in una posizione standard, come richiesto dal sistema SAP. Per altre informazioni, vedere la documentazione di SAP.
Per specificare un URI di connessione per una connessione server RFC, specificare una connessione client regolare con una destinazione RFC specificata nella stringa di query, come nell'esempio seguente:
sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
L'adapter SAP usa le informazioni contenute nella parte userinfoparams e hostinfoparams dell'URI di connessione per recuperare i metadati dal sistema SAP e usa le informazioni fornite dai parametri listener nella stringa di query per registrarsi come listener nella destinazione SAP RFC.
Uso di caratteri riservati nell'URI di connessione
L'adapter SAP non supporta la specifica di un URI di connessione con caratteri speciali per uno dei valori dei parametri. Se i valori dei parametri di connessione contengono caratteri speciali, assicurarsi di eseguire una delle operazioni seguenti:
Se si specifica l'URI in Visual Studio usando il plug-in Add Adapter Service Reference o Il componente aggiuntivo Del servizio adapter, è necessario specificarli come è nella scheda Proprietà URI , ovvero senza usare alcun carattere di escape. Se si specifica l'URI direttamente nel campo Configura un URI e i parametri di connessione contengono caratteri riservati, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.
Se si specifica l'URI durante la creazione di una porta di invio o ricezione in BizTalk Server console di amministrazione e i parametri di connessione contengono caratteri riservati, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.
Uso dell'URI di connessione per connettersi al sistema SAP
Per informazioni su come stabilire una connessione al sistema SAP quando si:
Usare il componente aggiuntivo Del progetto BizTalk del servizio adapter o il plug-in Add Adapter Service Reference Visual Studio, vedere Connettersi al sistema SAP in Visual Studio.
Configurare una porta di trasmissione o una porta di ricezione (posizione) in una soluzione BizTalk Server, vedere Configurare manualmente un'associazione di porte fisiche all'adattatore SAP.
Usare il modello di canale WCF in una soluzione di programmazione, vedere Creare un canale usando SAP.
Usare il modello di servizio WCF in una soluzione di programmazione, vedere Configurare un'associazione client per il sistema SAP.
Usare lo strumento utilità metadati WCF ServiceModel (svcutil.exe), vedere Uso dello strumento utilità metadati ServiceModel con l'adapter BizTalk per mySAP Business Suite.