Condividi tramite

Passaggio 2: Configurare una porta di trasmissione WCF-WebHttp bidirezionale

  • Articolo

In questo passaggio viene configurata una porta di trasmissione WCF-WebHttp bidirezionale per richiamare l'URL della risorsa REST per recuperare i ritardi nelle pianificazioni dei vettori aerei degli Stati Uniti.

Per configurare la porta di trasmissione WCF-WebHttp

  1. Nella console di amministrazione di BizTalk Server, nel nodo Applicazione BizTalk 1 fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovoe quindi fare clic su Statico Solicit-Response Porta di trasmissione.

  2. Nella scheda Generale eseguire le operazioni seguenti:

    Usare Per
    Nome Digitare SendPortRESTAzureMarketPlace.
    Tipo Selezionare WCF-WebHttp.
    Gestore di invio Selezionare BizTalkServerApplication.
    Pipeline di trasmissione Selezionare PassThruTransmit.
    Pipeline di ricezione Selezionare PassThruReceive.

    Fare clic su Configure.

  3. Nella finestra di dialogo Proprietà trasporto WCF-WebHttp eseguire le operazioni seguenti:

    1. Nella scheda Generale immettere per Indirizzo (URI)https://api.datamarket.azure.com/oakleaf/US_Air_Carrier_Flight_Delays_Incr/ .

    2. Nella scheda Generale, per Metodo HTTP e Mapping URL, immettere quanto segue:

      <BtsHttpUrlMapping>
<Operation Method="GET" Url="/On_Time_Performance" />
</BtsHttpUrlMapping>

      In questo caso , GET è il verbo HTTP e On_Time_Performance viene aggiunto all'URI di base per costruire un URL di risorsa univoco per recuperare i ritardi dei voli.

      Suggerimento

      All'interno del campo URL tutti i caratteri XML speciali devono essere preceduti da un carattere di escape. In questo modo si garantisce che i caratteri XML speciali vengano elaborati e mantenuti dalla porta. Ad esempio, il & carattere speciale deve essere preceduto da un carattere di escape come &amp;.

      Da: Url=”/Customer?{ID}& group=Location”

      A: Url=”/Customer?{ID}&amp;group=Location”

    3. Nella scheda Associazioni selezionare un valore sufficientemente grande per il campo Dimensioni massime messaggi ricevuti . Le dimensioni del messaggio di risposta contenente lo stato dei voli infatti sono generalmente piuttosto elevate e potrebbero superare la dimensione predefinita specificata per i messaggi.

    4. Nella scheda Protezione, procedere come segue:

      1. Per Modalità di sicurezza selezionare Trasporto.

      2. Per Tipo di credenziale client di trasporto selezionare Basic.

      3. Nella casella Credenziali nome utente selezionare Modifica.

      4. Nella casella Credenziali client selezionare Non usare Single-Sign Sì.

      5. Immettere il nome utente e la password recuperati dalla scheda Account personale dopo l'accesso a Microsoft Azure Marketplace.

        Le credenziali vengono elencate in base alle etichette ID cliente (nome utente) e Chiave account primaria (password).

      6. Selezionare OK.

    5. Nella scheda Messaggi , per Elimina corpo per verbi, specificare il verbo per il quale si desidera rimuovere il payload del messaggio dal messaggio di richiesta. Per questa esercitazione, specificare questo valore come GET. Ecco perché: una chiamata al metodo GET sull'endpoint REST dei ritardi dei voli us Air Carrier non richiede un payload del messaggio; l'URL della risorsa REST è sufficiente per recuperare le informazioni. Tuttavia, per attivare la porta di trasmissione WCF-WebHttp che effettua la chiamata REST, eliminare un messaggio fittizio con un corpo del messaggio. Questo messaggio non deve essere inviato dalla porta di trasmissione all'endpoint REST perché quest'ultimo non prevede un payload di messaggio. Quindi, prima di richiamare l'endpoint REST, l'adapter rimuove il payload del messaggio dal messaggio fittizio solo per i verbi specificati nella casella di testo Elimina corpo per verbi .

    6. Fare clic su OK finché non si torna alla finestra di dialogo Proprietà porta di trasmissione. Nel riquadro sinistro fare clic su Filtri e specificare il filtro per utilizzare tutti i messaggi ricevuti tramite la porta di ricezione creata nel passaggio 1: Configurare un percorso di ricezione FILE.

      Parametro Valore
      Proprietà Impostare su BTS. Receiveportname
      Operatore Impostare su ==
      Valore Impostare su ReceivePortRestAzureMarketPlace

    7. Fare clic su OK.

Vedere anche

Esercitazione 5: richiamare un'interfaccia REST usando BizTalk Server