Condividi tramite


Generare un client WCF o un contratto di servizio WCF per gli artefatti della soluzione SAP

È possibile usare il plug-in Add Adapter Service Reference Visual Studio per generare una classe client WCF o un contratto di servizio WCF destinato alle operazioni selezionate sugli artefatti SAP. È 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 al sistema SAP.

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 Recupera metadati per le operazioni SAP in Visual Studio per connettersi al sistema SAP 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:

  • SAPBindingClient.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. Le impostazioni sono basate sulle selezioni effettuate quando è stata configurata l'associazione e la connessione per il plug-in Add Adapter Service Reference.

    Importante

    Quando si usa il plug-in Add Adapter Service Reference, 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

Quando si usa l'adattatore SAP per ricevere IDOCs, RFC e tRFC dal sistema SAP, il codice funge da servizio alla scheda. Ovvero, l'adattatore riceve l'artefatto appropriato dal sistema SAP e quindi richiama un'operazione (in ingresso) sul codice per distribuire l'artefatto all'applicazione.

È quindi necessario implementare un servizio WCF che può ricevere questa operazione in ingresso dall'adapter. A tale scopo, usare il plug-in Add Adapter Service Reference per generare un'interfaccia .NET che rappresenta il contratto di servizio che viene visualizzato dall'adattatore per l'operazione. Questa interfaccia .NET viene anche chiamata contratto di servizio WCF. Il plug-in Add Adapter Service Reference genera anche una classe contenente un'implementazione stub del servizio WCF. È quindi possibile implementare questa interfaccia per creare il servizio WCF che è possibile usare per ricevere l'operazione.

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

  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 Recupera metadati per le operazioni SAP in Visual Studio per connettersi al sistema SAP e cercare le operazioni. Per creare un contratto di servizio WCF per le operazioni selezionate, assicurarsi che il servizio (operazioni in ingresso) sia selezionato nell'elenco a discesa Seleziona tipo di contratto .

  3. Dopo aver selezionato tutte le operazioni di destinazione, fare clic su OK per generare il contratto di servizio WCF.

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

  • SAPBindingInterface.cs. Questo file contiene il codice del contratto di servizio WCF generato (interfaccia) e helper per le operazioni selezionate.

  • SAPBindingService.cs. Questo file contiene una classe di servizio WCF stubbed che implementa l'interfaccia definita in SAPBindingInterface.cs. È possibile implementare la logica di business che elabora RFC, tRFC o IDOC direttamente nei metodi di questa classe.

  • 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

    Quando si usa il plug-in Add Adapter Service Reference, 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.

Nota

Non è necessario specificare i parametri del server RFC quando si configura l'URI di connessione per il plug-in Aggiungi plug-in del servizio adapter per generare il contratto di servizio WCF. L'adattatore SAP recupera i metadati dal sistema SAP tramite una connessione client.

Generare una classe client WCF o un contratto di servizio WCF usando svcutil.exe

È possibile usare svcutil.exe per generare una classe client WCF o un contratto di servizio WCF per l'applicazione. È necessario configurare svcutil.exe per usarlo con l'adattatore SAP. Per altre informazioni sulla configurazione e l'uso di svcutil.exe con l'adapter SAP, vedere Uso dello strumento utilità metadati ServiceModel con l'adapter BizTalk per mySAP Business Suite.

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.

Vedere anche

Sviluppare applicazioni SAP usando il modello di canale WCF