Condividi tramite


Creare l'URI di connessione di sistema Siebel

L'URI di connessione di Microsoft BizTalk Adapter per Siebel eBusiness Applications contiene proprietà usate dall'adapter per stabilire una connessione al sistema Siebel.

In questo argomento vengono fornite informazioni sull'URI di connessione Siebel e vengono forniti anche collegamenti ad altri argomenti che illustrano come specificare un URI di connessione in scenari di programmazione diversi.

URI di connessione per l'adapter Siebel

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 di connessione Siebel segue questo formato generale e viene implementato come segue:

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]  

Le sezioni seguenti descrivono le proprietà implementate per ogni componente dell'URI di connessione Siebel.

Schema per l'URI di connessione Siebel

Lo schema per l'URI di connessione Siebel è "siebel".

Informazioni utente nell'URI di connessione Siebel

Per impostazione predefinita, l'adattatore Siebel genera un'eccezione quando le credenziali di sistema Siebel vengono specificate nell'URI di connessione. Ciò è dovuto al fatto che queste credenziali sono rappresentate come testo normale, che comportano un rischio di sicurezza intrinseco. È possibile impostare la proprietà di associazione AcceptCredentialsInUri per controllare se l'URI di connessione può contenere credenziali. Se la proprietà AcceptCredentialsInUri è false, l'adapter Siebel genera un'eccezione se l'URI di connessione contiene credenziali; se la proprietà è true, non viene generata alcuna eccezione.

Importante

A causa dei rischi di sicurezza intrinseci derivanti dal passaggio delle credenziali nelle stringhe come testo normale, è consigliabile non specificare le credenziali di sistema Siebel nell'URI di connessione.

Esistono diversi modi per fornire le credenziali di sistema Siebel senza specificarle nell'URI di connessione.

  • Nel codice è possibile impostare la proprietà ClientCredentials sull'oggetto appropriato.

  • Quando si utilizza il plug-in Aggiungi riferimento al servizio adapter o il componente aggiuntivo Utilizzo servizio adapter, è possibile immettere le credenziali selezionando la scheda Sicurezza della finestra di dialogo Configura adattatore .

  • Quando si specifica un'associazione della porta di trasmissione o della posizione di ricezione in una soluzione di BizTalk Server, è possibile immettere le credenziali selezionando la scheda Sicurezza della finestra di dialogo appropriata.

    Le informazioni utente (userinfoparams) nell'URI di connessione Siebel sono rappresentate come raccolta nome-valore di parametri necessari per l'autenticazione utente. Nella tabella seguente vengono descritti i parametri.

Proprietà Descrizione
Username Il nome utente nel sistema Siebel; 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 Siebel mantiene la combinazione di maiuscole e minuscole del valore immesso per il nome utente quando apre una connessione nel sistema Siebel.
Password Password per l'utente nel sistema Siebel; 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 Siebel mantiene la combinazione di maiuscole e minuscole del valore immesso per la password quando apre una connessione nel sistema Siebel.

Informazioni sull'host nell'URI di connessione Siebel

Le informazioni sull'host Siebel (hostinfoparams) specificano l'indirizzo del sistema Siebel nel formato seguente: [SERVER]:[PORT]. A seconda della versione del server Siebel, le informazioni sull'host Siebel accettano valori diversi:

  • Per Siebel versione 7.5 e precedenti, il parametro di informazioni host accetta il nome del computer in cui è installato il server gateway Siebel e il numero di porta del gateway Siebel.

  • Per Siebel versione 7.7 e successive, il parametro di informazioni host accetta il nome del computer in cui è installato il server Siebel e il numero di porta del broker di connessione Siebel.

    Importante

    Quando si usa il plug-in Add Adapter Service Reference di Visual Studio o il componente aggiuntivo Consume Adapter Service BizTalk Project per connettersi a un sistema Siebel, è necessario specificare le informazioni sull'host per la proprietà di connessione "SiebelGateway".

Informazioni sulle query nell'URI di connessione Siebel

Le informazioni sulla query (query_string) nell'URI di connessione Siebel vengono usate per specificare proprietà di connessione aggiuntive.

Proprietà Descrizione
SiebelObjectManager Nome del gestore oggetti Siebel nel server aziendale. Questo parametro è obbligatorio.
SiebelEnterpriseServer Nome di Siebel Enterprise Server. Questo parametro è obbligatorio.
Linguaggio Linguaggio del gestore oggetti. Questo parametro è facoltativo e, Se non viene specificato, l'adattatore Siebel fornisce un valore predefinito (enu).
Trasporto Il trasporto; è supportato solo tcpip. Questo parametro è facoltativo e, Se non viene specificato, il sistema Siebel fornisce un valore predefinito (tcpip).
Crittografia Tipo di crittografia da usare tra l'adapter e il sistema Siebel. I valori supportati sono none, mscrypto o rsa. Questo parametro è facoltativo e, Se non viene specificato, il sistema Siebel fornisce un valore predefinito (nessuno).
Compressione Algoritmo di compressione da usare tra l'adapter e il sistema Siebel. I valori supportati sono none o zlib. Questo parametro è facoltativo e, Se non viene specificato, il sistema Siebel fornisce un valore predefinito (zlib).
SiebelServer Server Siebel. Obbligatorio per tutte le connessioni server Siebel 7.5 (7.5.2, 7.5.3 e così via); in caso contrario, non impostare questo parametro.
SiebelRepository Repository Siebel. Obbligatorio se nel server esistono più repository; in caso contrario, facoltativo. Nota: Se nel server sono presenti più repository, è necessario specificare un repository di destinazione nel parametro SiebelRepository.

Per altre informazioni sui parametri Siebel impostati nelle informazioni sulla query, vedere la documentazione di Siebel.

Uso di caratteri riservati nell'URI di connessione

L'adattatore Siebel 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 tramite plug-in Add Adapter Service Reference o Consume Adapter Service Add-in , è necessario specificarli così come sono nella scheda Proprietà URI , ovvero senza usare caratteri 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 trasmissione o ricezione nella console di amministrazione di BizTalk Server 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 Siebel

Di seguito è riportato un URI di connessione Siebel di esempio.

siebel://Username=YourUserName;Password=YourPassword@Siebel_server:1234?SiebelObjectManager=obj_mgr&SiebelEnterpriseServer=entserver&Language=enu  

Nota

Questo URI di esempio contiene le credenziali di sistema Siebel; È necessario impostare la proprietà di associazione AcceptCredentialsInUrisu true per usare un URI di connessione contenente le credenziali.

Per informazioni su come stabilire una connessione al sistema Siebel (inclusa l'impostazione delle proprietà di connessione) quando:

Vedere anche

Creare una connessione al sistema Siebel
Sviluppare applicazioni Siebel
Sviluppare applicazioni Siebel usando il modello di canale WCF3
Sviluppare applicazioni SQL usando il modello di servizio WCF