Passaggio 2: Configurare una porta di ricezione unidirezionale WCF-Custom

Tempo da completare: 10 minuti

Obiettivo: In questo passaggio viene configurata una porta WCF-Custom per ricevere un IDOC flat da un sistema SAP. Dopo aver configurato la porta, configurare l'applicazione BizTalk per usare la porta di ricezione WCF-Custom.

Prerequisiti

È necessario aver compilato e distribuito il progetto BizTalk vPrev per ricevere IDOCs da un sistema SAP.

Per configurare una porta di ricezione unidirezionale WCF-Custom

1. Avviare la console di amministrazione di BizTalk Server.

2. Nell'albero della console espandere Gruppo BizTalk e quindi espandere Applicazioni.

3. Espandere l'applicazione in cui si vuole creare la porta di ricezione.

4. Fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e fare clic su Porta di ricezione unidirezionale.

5. Nella scheda Generale della finestra di dialogo Proprietà porta di ricezione digitare un nome per la porta di ricezione.

6. Nella scheda Posizioni di ricezione fare clic su Nuovo. Viene visualizzata la finestra di dialogo Proprietà posizione di ricezione .

7. Nella finestra di dialogo Proprietà percorso di ricezione eseguire le operazioni seguenti:

   1. Specificare un nome per la posizione di ricezione.

   2. Nell'elenco a discesa Tipo selezionare WCF-Custom e quindi fare clic su Configura.

8. Nella finestra di dialogo Proprietà trasporto personalizzate WCF eseguire le operazioni seguenti:

   1. Fare clic sulla scheda Generale e nel campo Indirizzo (URI) specificare l'URI di connessione per ricevere messaggi dal sistema SAP. L'URI di connessione per ricevere messaggi dal sistema SAP deve essere nel formato seguente:

      sap://Client=800;lang=EN@A/YourSAPHOST/00?ListenerGwHost=YourSAPHOST&ListenerGwServ=SAPGW00&ListenerProgramId=MyProgramId
      

      Nella figura seguente viene illustrata la finestra di dialogo delle proprietà della porta con l'URI specificato:

      

      Per altre informazioni sull'URI di connessione, vedere Creare una connessione al sistema SAP.

   2. Fare clic sulla scheda Binding e nell'elenco a discesa Tipo di associazione selezionare sapBinding. Assicurarsi di specificare le proprietà di associazione seguenti per la porta di ricezione.

      Proprietà binding	Impostare il valore su
      flatFileSegmentIndicator	SegmentType. Ciò indica che i file flat devono contenere il tipo di segmento per ogni segmento nel file IDOC.
      padReceivedIdocWithSpaces	True. Specifica se ogni riga nel IDOC è riempita con spazi per la lunghezza corretta.
      receiveIDocFormat	Stringa. Questo specifica che il messaggio IDOC deve essere rappresentato come singolo campo stringa.

      Per altre informazioni sulle proprietà di associazione, vedere Informazioni sull'adapter BizTalk per le proprietà di associazione di mySAP Business Suite.

   3. Fare clic sulla scheda Altri e specificare le credenziali per connettersi a un sistema SAP.

   4. Fare clic sulla scheda Messaggi e nella sezione Corpo del messaggio BizTalk in ingresso scegliere l'opzione Percorso .

   5. Nella casella di testo Espressione percorso corpo specificare la query XPath per estrarre il file flat-IDOC dal messaggio XML. In questo modo, la porta di ricezione estrae i dati dal file IDOC e taglia il tag XML che fa parte dell'operazione ReceiveIdoc per l'adapter SAP basato su WCF. Per altre informazioni sullo schema dei messaggi per l'operazione ReceiveIdoc , vedere Schemi di messaggi per operazioni IDOC.

      

      È necessario specificare la query XPath seguente:

      /*[local-name()='ReceiveIdoc']/*[local-name()='idocData']
      

   6. Nell'elenco a discesa Codifica nodo selezionare String.

   7. Fare clic su Applica e quindi su OK.

9. Nella finestra di dialogo Proprietà percorso di ricezione selezionare BizTalkServerApplication dall'elenco a discesa Gestore ricezione.

10. Nell'elenco a discesa Ricezione pipeline selezionare ConvertToXML. Questa pipeline di disassembler file flat fa già parte del progetto BizTalk vPrev per convertire un IDOC flat in un IDOC XML.

11. Fare clic su OK.

Per configurare l'applicazione BizTalk

1. Nella console di amministrazione BizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e espandere l'applicazione BizTalk in cui viene distribuita l'orchestrazione.

2. Fare clic con il pulsante destro del mouse sull'applicazione BizTalk e quindi scegliere Configura.

3. Nel riquadro sinistro fare clic sull'orchestrazione per configurare. Nell'elenco a discesa Host del riquadro destro selezionare un'istanza host BizTalk.

4. Nella casella Associazioni eseguire il mapping delle porte logiche dell'orchestrazione BizTalk alle porte fisiche nella console di amministrazione BizTalk Server.

   1. Selezionare la porta di ricezione WCF-Custom creata in precedenza in questo argomento.

   2. Selezionare una porta file in cui si riceverà l'IDOC flat-file.

   3. Fare clic su OK.

      Per altre informazioni sulla configurazione delle app in BizTalk Server, vedere Come configurare un'applicazione.

Passaggi successivi

È stata completata la migrazione del progetto BizTalk vPrev a un progetto BizTalk che riceve IDOCs da un sistema SAP usando l'adapter SAP basato su WCF. È ora necessario testare l'applicazione BizTalk migrata ricevendo un IDOC flat, come descritto nel passaggio 3: Testare l'applicazione migrata.

Vedere anche

Esercitazione 4: Migrazione di un progetto BizTalk per la ricezione di un IDOC da SAP