Condividi tramite

Passaggio 4: Configurare la soluzione BizTalk Server

Nel passaggio precedente è stata creata e distribuita un'applicazione BizTalk Server per ricevere la notifica salesforce in BizTalk Server e inserire i dettagli in un database DI SQL Server locale. In questo passaggio verrà configurata l'applicazione nella console di amministrazione di BizTalk Server. La configurazione dell'applicazione comporta principalmente la creazione di porte fisiche corrispondenti alle porte logiche create nell'orchestrazione. Implica anche l'associazione della porta fisica alle porte logiche. Verranno eseguiti i passaggi seguenti per configurare l'applicazione BizTalk Server:

  • Configura la posizione di ricezione WCF-BasicHttpRelay per ricevere notifiche di opportunità da Salesforce.

  • Configurare una porta di trasmissione WCF-WebHttp richiesta-risposta per inviare una query a Salesforce e recuperare i dettagli del prodotto correlati alla notifica di opportunità ricevuta. Questa porta di trasmissione riceve anche la risposta della query da Salesforce.

  • Configurare una porta di trasmissione unidirezionale WCF-SQL per inserire la risposta di query da Salesforce in un database DI SQL Server locale.

  • Configurare l'applicazione BizTalk Server associando la porta logica nell'orchestrazione alle porte fisiche create nella console di amministrazione di BizTalk Server.

Per configurare la posizione di ricezione WCF-BasicHttpRelay

  1. Aprire la console di amministrazione di BizTalk Server. Espandere il nodo Applicazioni e cercare l'applicazione SalesforceIntegration . Questa applicazione viene creata quando è stato distribuito il progetto BizTalk Server da Visual Studio.

  2. Espandere l'applicazione SalesforceIntegration , fare clic con il pulsante destro del mouse su Porte di ricezione, scegliere Nuovo e quindi fare clic su Request-Response porta di ricezione. Specificare il nome della porta come ReceiveOppNotification e nel riquadro sinistro fare clic su Posizioni di ricezione.

  3. Nella finestra di dialogo delle proprietà del percorso di ricezione, specificare i valori seguenti:

    Parametro Valore
    Nome Inserisci ReceiveOppNotification.
    TIPO Selezionare WCF-BasicHttpRelay
    Gestore di ricevimento Selezionare BizTalkServerApplication
    Pipeline di ricezione Selezionare XMLReceive
    Pipeline di trasmissione Selezionare PassThruTransmit

    Fare clic su Configura per il tipo di porta.

  4. Nella finestra di dialogo Proprietà trasporto WCF-BasicHttpRelay specificare i valori seguenti:

    1. Nella scheda Generale, immettere https://btssalesforce.servicebus.windows.net/notifications/opportunity per Indirizzo (URI). In questo caso, btssalesforce è lo spazio dei nomi che hai creato in Passaggio 1: Creare un Namespace del Service Bus. L'URL specificato qui è lo stesso URL specificato durante la creazione di un flusso di lavoro in Salesforce nel passaggio 2: Configurare salesforce System. Si configura un flusso di lavoro in cui ogni volta che la fase di un'opportunità è impostata su Closed Won, Salesforce invia una notifica all'URL https://btssalesforce.servicebus.windows.net/notifications/opportunity. Qui viene specificato lo stesso URL come parte di questa configurazione della posizione di ricezione. Quando viene abilitato il percorso di ricezione, l'endpoint di inoltro specificato dall'URL viene creato su Microsoft Azure.

    2. Nella scheda Sicurezza specificare quanto segue:

      • Per Modalità di sicurezza selezionare Trasporto e per Tipo di autenticazione client di inoltroselezionare Nessuno.

      • Selezionare la casella di controllo Abilita individuazione servizi per pubblicare il comportamento del servizio nel Registro di sistema dei servizi. Specificare il nome visualizzato che indica il nome con cui il servizio viene pubblicato nel Registro di sistema. È possibile impostare la modalità di individuazione su pubblico o privato. Per questa esercitazione impostare Nome visualizzato su SF Outbound Notification e Modalità di individuazione su Pubblico.

      • Nella casella Servizio di controllo di accesso fare clic su Modifica. Per il servizio di accesso controllo Uri, inserire https://btssalesforce-sb.accesscontrol.windows.net/. Per Nome emittente e Chiave emittente, inserisci i valori che hai salvato in Passaggio 1: Creare uno spazio dei nomi del Bus di Servizio nei campi Utente predefinito e Chiave predefinita.

    3. Fare clic su OK finché non si escono tutte le finestre di dialogo aperte.

Per configurare la porta di trasmissione WCF-WebHttp

  1. Espandere l'applicazione SalesforceIntegration , fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e quindi fare clic su Statico Solicit-Response Porta di trasmissione.

  2. Nella finestra di dialogo Proprietà porta di trasmissione specificare i valori seguenti:

    Parametro Valore
    Nome Inserisci SalesforceREST.
    TIPO Selezionare WCF-WebHttp
    Gestore di invio Selezionare BizTalkServerApplication
    Pipeline di trasmissione Selezionare PassThruTransmit
    Pipeline di ricezione Selezionare AddNamespace e fare clic sul pulsante con i tre puntini accanto alla pipeline per configurare la pipeline.

    - Nella fase 1: Decodificare, per NamespaceBase, immettere http://BtsSalesforceIntegration.QueryResult. Questo è lo spazio dei nomi dello schema QueryResult.xsd creato nel passaggio 3b: Recuperare i dettagli delle opportunità da Salesforce usando l'adapter WCF-WebHttp. Quando la pipeline di ricezione AddNamespace riceve la risposta da Salesforce, aggiunge questo spazio dei nomi al messaggio di risposta. Per impostazione predefinita, il messaggio di risposta di Salesforce non include alcun namespace.
    Per NamespacePrefix immettere sf.
    - Nella fase 2: Disassemble accettare i valori predefiniti e quindi fare clic su OK.

    Nella finestra di dialogo Proprietà porta di trasmissione fare clic su Configura per il tipo di porta.

  3. Nella finestra di dialogo Proprietà trasporto WCF-WebHttp specificare i valori seguenti:

    1. Nella scheda Generale, procedi come segue:

      • per Indirizzo (URI) immettere https://<Salesforce_instance_name>.salesforce.com/services/data/v24.0. È possibile recuperare il nome dell'istanza di Salesforce copiando il testo tra https:// e Salesforce.com nella barra degli indirizzi in cui è aperto il portale di Salesforce.com. Ad esempio, se l'URL nel portale salesforce è https://na15.salesforce.com/home/home.jsp, il nome dell'istanza di Salesforce è na15.

      • Nella casella Metodo HTTP e Mapping URL specificare quanto segue:

        <BtsHttpUrlMapping>  
<Operation Method="GET" Url="/query?q={VAR}" />  
</BtsHttpUrlMapping>

        Ecco come viene usata questa impostazione: per eseguire una query su Salesforce per recuperare altre informazioni sulla notifica dell'opportunità, è necessario eseguire un'operazione GET sull'endpoint REST salesforce (specificato nel campo Indirizzo ) e accodare la query per recuperare i dettagli dell'opportunità. L'URL dovrebbe quindi essere simile al seguente:

        https://na15.salesforce.com/services/data/v24.0/query?q=<query_string>

        L'endpoint REST di Salesforce è già incluso nel campo Indirizzo (URI). Pertanto, come parte della proprietà Metodo HTTP e Mappatura URL, specifichiamo l'uso del metodo GET e accodiamo {VAR} come variabile.

      • Nella casella Mappatura delle variabili cliccare su Modifica. In questa casella si specifica come viene dedotto il valore per la variabile {VAR} in fase di esecuzione.

        Nel passaggio 3b: Recuperare i dettagli delle opportunità da Salesforce usando l'adapter WCF-WebHttp è stata alzata di livello la proprietà Query, che ha comportato la creazione di un propertySchema.xsd. Si userà l'elemento Query in tale schema per passare la stringa di query eseguendo il mapping dell'elemento alla variabile {VAR} nell'URL.

        Nella finestra di dialogo Mapping variabili la colonna Variabile elenca il nome della variabile specificata in precedenza, ad esempio VAR. Nella colonna Nome proprietà, specificare il nome della proprietà promossa che contiene la stringa di query da passare alla variabile. In questa esercitazione il nome della proprietà è Query. Infine, per Spazio dei nomi delle proprietà specificare lo spazio dei nomi per PropertySchema.xsd, ovvero https://BtsSalesforceIntegration.PropertySchema. Fare clic su OK.

        Scheda Generale dell'adattatore WCF-WebHttp BTS_SF_WebHttp_General

    2. Nella scheda Sicurezza , per Modalità di sicurezza, selezionare Trasporto.

    3. Nella scheda Comportamento usare il comportamento personalizzato creato nel passaggio 3d: Abilitazione di BizTalk Server per l'invio e la ricezione di messaggi da Salesforce per l'autenticazione con Salesforce. Per usare il comportamento, eseguire le operazioni seguenti:

      • Fare clic con il pulsante destro del mouse su EndpointBehavior e quindi scegliere Aggiungi estensione.

      • Nella finestra di dialogo Seleziona estensione comportamento selezionare Microsoft.BizTalk.Adapter.Behaviors.Demo.Salesforce. Avevamo usato questo nome di comportamento durante l'aggiunta del comportamento al machine.config.

      • Selezionare il comportamento appena aggiunto e quindi specificare i valori seguenti:

        Parametro Valore
        consumerKey (obbligatorio) Specifica la chiave consumer per il tuo account Salesforce. È possibile recuperare la chiave consumer passando all'applicazione connessa Salesforce creata nel passaggio 2: Configurare il sistema Salesforce.
        consumerSecret (obbligatorio) Recuperare il segreto consumer dall'applicazione connessa Salesforce creata nel passaggio 2: Configurare il sistema Salesforce.
        Password (obbligatorio) Specificare la password per l'account Salesforce. Per connettersi a Salesforce da un'applicazione di terze parti, è necessario specificare la password nel formato password seguita dal token di sicurezza. Ad esempio, se la password è password e il token è XXXXXX, è necessario immettere passwordXXXXXX.
        sessioneTimeout Il valore predefinito è 300.
        Nome utente (obbligatorio) Specificare l'account di accesso dello sviluppatore Salesforce.

        Scheda Comportamento per l'adattatore WCF-WebHttp, BTS_SF_WebHttp_Behavior

    4. Nella scheda Messaggi , in Messaggio in uscita , per Elimina corpo per verbi immettere GET. Ciò garantisce che per il metodo GET non sia presente alcun payload del messaggio nella richiesta inviata a Salesforce.

    5. Fare clic su OK finché non si escono tutte le finestre di dialogo aperte.

Per configurare la porta di trasmissione WCF-SQL

  1. Espandere l'applicazione SalesforceIntegration , fare clic con il pulsante destro del mouse su Porte di trasmissione, scegliere Nuovo e quindi fare clic su Porta di trasmissione statica unidirezionale.

  2. Nella finestra di dialogo Proprietà porta di trasmissione specificare i valori seguenti:

    Parametro Valore
    Nome Inserisci SendToSQL.
    TIPO Selezionare WCF-SQL
    Gestore di invio Selezionare BizTalkServerApplication
    Pipeline di trasmissione Selezionare XMLTransmit

    Nella finestra di dialogo Proprietà porta di trasmissione fare clic su Configura per il tipo di porta.

  3. Nella finestra di dialogo Proprietà trasporto WCF-SQL specificare i valori seguenti:

    1. Nella scheda Generale, procedi come segue:

      • In Endpoint Addressfare clic su Configura. Per la proprietà InitialCatalog specificare il nome del database che contiene la tabella in cui devono essere immessi i dati della risposta salesforce. Per questa esercitazione immettere questo valore come Orders. Per proprietà Server immettere il nome del server in cui è installato il database di SQL Server.

      • In Intestazione SOAP Action, specificare l'azione da inserire nella tabella OrderDetails. È necessario immettere TableOp/Insert/dbo/OrderDetails.

    2. Nella scheda Credenziali, se si lascia vuoto tutto l'adattatore usa l'autenticazione di Windows per connettersi al database di SQL Server. Se si desidera utilizzare qualsiasi altra forma di autenticazione, è possibile specificare i valori pertinenti.

    3. Fare clic su OK finché non si escono tutte le finestre di dialogo aperte.

Per configurare l'applicazione BizTalk Server

  1. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sull'applicazione SalesforceIntegration e quindi scegliere Configura.

  2. Nella finestra di dialogo Configura applicazione selezionare l'orchestrazione NotificationServiceClient e nel riquadro destro eseguire le operazioni seguenti:

    1. Per Host selezionare BizTalkServerApplication.

    2. Eseguire il mapping della porta di ricezione logica SalesforceNotificationPort alla porta di ricezione fisica ReceiveOppNotification.

    3. Eseguire il mapping della porta di trasmissione logica SalesforceRESTInterface alla porta di trasmissione fisica SalesforceREST.

    4. Eseguire il mapping della porta di trasmissione logica SendToSQL alla porta di trasmissione fisica SendToSQL.

      Fare clic su OK.

  3. Fare clic con il pulsante destro del mouse sull'applicazione SalesforceIntegration e quindi scegliere Avvia. Viene avviata l'orchestrazione NotificationServiceClient , viene abilitata la posizione di ricezione e viene avviata la porta di trasmissione.

    In questo argomento è stata completata la configurazione della soluzione nella console di amministrazione di BizTalk Server associando le porte logiche nell'orchestrazione alle porte fisiche.

  • Last updated on