Condividi tramite

Generare un client WCF o un contratto di servizio WCF per gli artefatti della soluzione Oracle E-Business Suite

  • Articolo

È possibile usare il plug-in Add Adapter Service Reference Visual Studio per generare una classe client WCF o un contratto di servizio WCF (interfaccia) destinato alle operazioni selezionate sugli artefatti di Oracle E-Business Suite. È anche possibile usare serviceModel Metadata Utility Tool (svcutil.exe) per generare la classe client WCF o il contratto di servizio WCF; Tuttavia, il plug-in Add Adapter Service Reference espone la funzionalità dello strumento utilità metadati ServiceModel tramite un'interfaccia Microsoft Windows standard. Fornisce anche funzionalità di ricerca e sfoglia che non sono disponibili con lo strumento di svcutil.exe e genera un file di configurazione in base alle proprietà di associazione selezionate quando ci si connette a Oracle E-Business Suite.

Generazione di una classe client usando il plug-in Add Adapter Service Reference

Seguire questa procedura per generare una classe client WCF usando il plug-in Add Adapter Service Reference.

Per generare una classe client WCF

  1. In Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Aggiungi riferimento al servizio adapter.

  2. Dopo aver aperto la finestra di dialogo Aggiungi riferimento al servizio adapter , seguire la procedura descritta in Recupero dei metadati per Le operazioni di Oracle E-Business Suite in Visual Studio per connettersi a Oracle E-Business Suite e cercare le operazioni. Per creare una classe client WCF per le operazioni selezionate, assicurarsi che il client (operazioni in uscita) sia selezionato dall'elenco a discesa Seleziona tipo di contratto (impostazione predefinita).

  3. Dopo aver selezionato tutte le operazioni di destinazione, fare clic su OK per generare la classe client WCF.

    Il plug-in Add Adapter Service Reference aggiunge due file al progetto:

  • OracleEBSBindingClient.cs. Questo file contiene la classe client WCF generata e il codice helper per le operazioni selezionate.

  • app.config. Questo file contiene una configurazione di associazione e configurazioni dell'endpoint client. Queste configurazioni si basano sulle selezioni effettuate quando è stata configurata l'associazione e la connessione per il plug-in Di riferimento del servizio adattatore.

    Importante

    Durante l'uso del plug-in Add Adapter Service Reference Visual Studio, se non si specifica un valore per una proprietà di tipo stringa di tipo e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di app.config, se necessario.

Generazione di un contratto di servizio WCF usando il plug-in Add Adapter Service Reference

L'adapter espone le operazioni in ingresso per consentire a Oracle E-Business Suite di inviare messaggi a un client dell'adapter. Per tali operazioni è necessario generare un contratto di servizio WCF. Questa sezione fornisce informazioni su come generare un contratto di servizio per le operazioni in ingresso esposte dall'adapter.

Seguire questa procedura per generare un contratto di servizio WCF usando il plug-in Aggiungi plug-in del servizio adapter.

Per generare un contratto di servizio WCF per le operazioni in ingresso

  1. In Visual Studio Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Aggiungi riferimento al servizio adapter.

  2. Dopo aver aperto la finestra di dialogo Aggiungi riferimento al servizio adapter , seguire la procedura descritta in Recupero dei metadati per Oracle E-Business Suite Operations in Visual Studio per connettersi a Oracle E-Business Suite. Esistono diverse proprietà di associazione e una proprietà URI che è possibile impostare quando ci si connette a Oracle E-Business Suite.

  3. Dopo aver eseguito la connessione a Oracle E-Business Suite, selezionare Servizio (operazioni in ingresso) nell'elenco a discesa Seleziona tipo di contratto .

  4. Nella casella Selezionare una categoria passare all'operazione in ingresso per cui si vuole generare il contratto di servizio. Ad esempio, per l'operazione di notifica , fare clic sul nodo radice (/), selezionare Notifica nella casella Categorie e operazioni disponibili e quindi fare clic su Aggiungi. Per istruzioni su come cercare operazioni in ingresso , vedere Sfoglia, Ricerca e Recupero dei metadati per Le operazioni di Oracle E-Business Suite.

  5. Per generare il contratto di servizio WCF per l'operazione, fare clic su OK.

    Il plug-in Add Adapter Service Reference aggiunge tre file al progetto:

  • OracleEBSBindingInterface.cs. Questo file contiene il codice del contratto di servizio WCF generato (interfaccia) e il codice helper per l'operazione in ingresso.

  • OracleEBSBindingService.cs. Questo file contiene una classe che implementa l'interfaccia definita in OracleDBBindingInterface.cs. È possibile implementare la logica di business che elabora i record restituiti dall'operazione in ingresso.

  • app.config. Questo file contiene una configurazione di associazione, comportamenti dell'endpoint e configurazione dell'endpoint di servizio in base alle selezioni effettuate quando è stata configurata l'associazione e la connessione per il plug-in Add Adapter Service Reference Plug-in.

    Importante

    Durante l'uso del plug-in Add Adapter Service Reference Visual Studio, se non si specifica un valore per una proprietà di tipo stringa di tipo e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file app.config. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di app.config, se necessario.

Uso di svcutil.exe per generare una classe client WCF o un contratto di servizio WCF

È possibile usare svcutil.exe per generare una classe client WCF o un'interfaccia del servizio WCF per l'applicazione. È necessario configurare svcutil.exe per usarlo con l'adapter Oracle E-Business.

Svcutil.exe genera la classe client WCF o il contratto di servizio WCF in un file di output. Il nome del file predefinito è output.cs. È necessario includere manualmente questo file nel progetto di Visual Studio. Per altre informazioni su svcutil.exe, vedere https://go.microsoft.com/fwlink/?LinkId=139432.