Uso dello strumento ServiceModel Metadata Utility con l'adapter BizTalk per Siebel eBusiness Applications

È possibile usare lo strumento utilità metadati ServiceModel (svcutil.exe) per generare una classe client WCF per le operazioni esposte dall'adapter Microsoft BizTalk per Siebel eBusiness Applications. Dopo aver eseguito svcutil.exe per generare una classe client WCF, è possibile includere il file generato nel codice e creare istanze della classe client WCF per eseguire operazioni sul sistema Siebel.

Per usare svcutil.exe è necessario specificare un URI di connessione contenente le credenziali. Poiché, per impostazione predefinita, l'adattatore Siebel disabilita le credenziali nell'URI di connessione, è necessario configurare svcutil.exe per usare un'associazione non predefinita per l'adapter Siebel. È anche possibile configurare altre proprietà di associazione nell'associazione non predefinita.

Le sezioni seguenti illustrano come configurare svcutil.exe e come usare svcutil.exe per generare codice client WCF con l'adapter Siebel.

Configurare svcutil.exe per un'associazione non predefinita

Per configurare svcutil.exe per l'uso di un'associazione non predefinita, è necessario creare una copia locale di svcutil.exe e quindi creare o modificare una copia locale del file di configurazione svcutil.exe.config.

1. Creare una cartella e copiare svcutil.exe nella nuova cartella. In genere è possibile trovare svcutil.exe nel percorso di installazione di Windows SDK, in particolare C:\Programmi\Microsoft SDKs\Windows\v6.0\Bin.

2. Creare un file denominato svcutil.exe.config nella nuova cartella.

3. Aggiungere un'associazione e un endpoint client al file svcutil.exe.config. È necessario eseguire svcutil.exe dalla nuova cartella per assicurarsi che venga usata la configurazione corretta.

   Importante

   L'attributo name dell'endpoint client deve specificare lo schema usato nell'URI di connessione. Per questo valore viene applicata la distinzione tra maiuscole e minuscole.

   <configuration>
     <system.serviceModel>
       <client>
         <!-- the name should match the required scheme of the Metadata Exchange endpoint
         and the contract should be "IMetadataExchange" -->
         <endpoint name="siebel"
           binding="siebelBinding"
           bindingConfiguration="SiebelBinding"
           contract="IMetadataExchange" />
       </client>
       <bindings>
         <siebelBinding>
           <binding name="SiebelBinding" acceptCredentialsInUri="true" />
         </siebelBinding>
       </bindings>
   
     </system.serviceModel>
   
   </configuration>
   
   

Per altre informazioni sulla configurazione di un'associazione non predefinita per svcutil.exe, vedere l'argomento "Endpoint metadati sicuri personalizzati" nella documentazione di WCF all'indirizzo https://go.microsoft.com/fwlink/?LinkId=96077.

Creazione di una classe client WCF con svcutil.exe

Per utilizzare svcutil.exe per generare codice client WCF per l'adattatore Siebel, è necessario specificare un URI di connessione che specifica un endpoint IMetadataExchange (mex) e l'operazione o le operazioni per cui si desidera svcutil.exe generare codice. È inoltre necessario specificare le credenziali di connessione per il sistema Siebel nell'URI di connessione.

Specificare un endpoint mex e le operazioni di destinazione nell'URI di connessione della scheda Siebel nel modo seguente:

• È necessario includere il parametro "wsdl" nel query_string. Se è il primo parametro nella query_string, viene specificato subito dopo il punto interrogativo (?). Se non è il primo parametro, deve essere preceduto da una e commerciale (&).

• È necessario seguire il parametro "wsdl" in base a uno o più parametri "op". Ogni parametro "op" è preceduto da una e commerciale (&) e specifica l'ID nodo di un'operazione di destinazione.

  I due esempi seguenti illustrano come impostare come destinazione diverse operazioni usando svcutil.exe.

  In questo esempio viene creata una classe client WCF per un'operazione di inserimento nell'oggetto BUSINESS ACCOUNT\ACCOUNT.

  .\svcutil "siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert"

  In questo esempio viene creata una classe client WCF per un'operazione di inserimento e un'operazione di eliminazione nell'oggetto business ACCOUNT\ACCOUNT.

  .\svcutil " siebel://Username=YourUserName; Password=YourPassword@Siebel_server:1234? SiebelEnterpriseServer=ent_server&SiebelObjectManager=obj_mgr&Language=enu&wsdl&op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Insert& op=http://Microsoft.LobServices.Siebel/2007/03/BusinessObjects/Account/Account/Delete"

Per impostazione predefinita, svcutil.exe inserisce il codice generato nel file output.cs; È tuttavia possibile modificare il nome del file di output e molte altre opzioni usate svcutil.exe impostando le opzioni della riga di comando.

Svcutil.exe non offre la possibilità di cercare le operazioni, ad esempio usando caratteri jolly. È necessario specificare in modo esplicito gli ID nodo per le operazioni specifiche di destinazione. Non è possibile specificare GLI ID nodo che fanno riferimento solo alle categorie. Per altre informazioni sugli ID nodo esposti dall'adattatore Siebel, vedere ID nodo dei metadati.

Il plug-in Aggiungi riferimento al servizio adapter di Visual Studio offre funzionalità avanzate di ricerca e esplorazione che possono semplificare notevolmente la generazione di una classe client WCF. Per altre informazioni sul plug-in Di riferimento del servizio adapter, vedere Generare un client WCF o un contratto di servizio WCF per gli artefatti della soluzione Siebel.