PartyResolution (esempio di BizTalk Server)

L'esempio di PartyResolution dimostra come utilizzare le orchestrazioni di BizTalk con la risoluzione delle entità per instradare messaggi a uno di due destinatari possibili.

Scopo dell'esempio

In questo esempio vengono eseguite più orchestrazioni per dimostrare i seguenti ruoli diversi:

• Orchestrazione Buyer, relativa all'acquirente, utilizzata per avviare l'elaborazione del messaggio di ordine di acquisto (PO).

• Orchestrazione Supplier, relativa al fornitore, che dimostra la risoluzione delle entità in ingresso e in uscita.

• Orchestrazioni ShipmentAgency1 e ShipmentAgency2, relative alle agenzie di spedizione, che rispondono all'orchestrazione del fornitore in base alla destinazione della spedizione specificata nell'ordine di acquisto.

Progettazione e finalità dell'esempio

La risoluzione delle entità si riferisce al processo eseguito per determinare chi, ovvero quale entità, invia un messaggio. Ad esempio, per l'invio di un messaggio potrebbe essere preferibile abilitare solo le entità note. La risoluzione delle entità in uscita è il processo tramite il quale si determina a quali entità inviare un messaggio.

Oltre alla risoluzione delle entità, questo esempio dimostra come implementare e utilizzare i ruoli. Ad esempio, per elaborare la spedizione del prodotto si crea una porta di trasmissione a cui viene inviato un documento che comunica a uno spedizioniere di spedire il prodotto. Se sono disponibili più spedizionieri tra cui scegliere, è possibile creare un ruolo spedizioniere nell'orchestrazione invece che creare più porte di trasmissione, la cui unica differenza è rappresentata dall'URL dello spedizioniere. Successivamente è possibile inviare i messaggi inerenti la spedizione del prodotto al ruolo spedizioniere. Si creano quindi le entità e si associa una porta di trasmissione a ciascuna entità e certificato di entità. Infine, si integra ciascuna entità nel ruolo spedizioniere per abilitarlo. Nell'orchestrazione è possibile specificare in maniera dinamica a quale spedizioniere si invia il messaggio.

Questo esempio dimostra inoltre come utilizzare la correlazione per abbinare il messaggio in ingresso all'istanza di orchestrazione appropriata.

• I flussi del processo di business per acquirente, fornitore e agenzie di spedizione sono i seguenti:

• Flusso del processo di business per l'acquirente:

  1. Ricezione del messaggio dell'ordine di acquisto dal reparto interno come file xml.

  2. Invio del messaggio di ordine d'acquisto al fornitore.

• Flusso del processo di business per il fornitore:

  1. Risoluzione dell'entità in ingresso per aggiornare l'entità di origine in base al certificato di firma.

  2. Ricezione di un messaggio di attivazione (ordine di acquisto) dall'acquirente.

  3. Invio di un messaggio di riconoscimento dell'ordine di acquisto all'acquirente.

  4. Verifica del paese/area geografica.

  5. Risoluzione dell'entità in uscita per identificare quale agenzia di spedizioni utilizzare. Se il paese/area geografica si trova all'interno degli USA, l'agenzia di spedizione è ShipmentAgency2. Se il paese/area geografica si trova in Canada, l'agenzia di spedizione è ShipmentAgency1.

  6. Invio di un messaggio di Shipment Order Request (richiesta di ordine di spedizione) all'agenzia di spedizione appropriata.

  7. Ricezione del messaggio di Shipment Order Acknowledgement (riconoscimento dell'ordine di spedizione) dall'agenzia di spedizione appropriata.

  8. Invio di un messaggio di Shipment Advice (avviso di spedizione) all'agenzia di spedizione appropriata.

  9. Ricezione del messaggio di Shipment Advice Acknowledgement (riconoscimento dell'avviso di spedizione) dall'agenzia di spedizione appropriata.

  10. Invio di un messaggio finale di PO Delivery Receipt (conferma di recapito dell'ordine di acquisto) all'acquirente.

• Flusso di processo di business dell'agenzia di spedizione, uguale per entrambe le agenzie:

  1. Ricezione del messaggio di Shipment Order Request dal fornitore.

  2. Generazione e invio di un messaggio di Acknowledgement (riconoscimento) per il messaggio di Shipment Order Request.

  3. Ricezione di un messaggio di Shipment Advice dal fornitore.

  4. Generazione e invio di un messaggio di Acknowledgement per il messaggio di Shipment Advice.

  Le istruzioni seguenti spiegano la progettazione dell'esempio:

• L'orchestrazione BuyerProcess.odx riceve un messaggio e utilizza la pipeline personalizzata MimePartyResSendPipeline per codificare il messaggio e inviarlo al fornitore. Questa operazione viene eseguita utilizzando Progettazione pipeline per creare e distribuire una pipeline di trasmissione personalizzata. Prima di inviare il messaggio al fornitore, il messaggio viene firmato digitalmente con la chiave privata dell'acquirente, specificata in Proprietà del gruppo BizTalk nella console di amministrazione BizTalk Server.

• L'orchestrazione SupplierProcess.odx utilizza la pipeline personalizzata MimePartyResReceivePipeline, che include un componente decodificatore MIME/SMIME, per decodificare il messaggio ed eseguire la risoluzione dell'entità in ingresso utilizzando la chiave pubblica dell'acquirente per risolvere e convalidare l'identità dell'acquirente. Questa operazione viene eseguita tramite la creazione e la distribuzione di una pipeline di ricezione personalizzata.

• L'orchestrazione del fornitore avvia quindi POCorrelationSets, che viene definito in modo tale da basarsi su una proprietà innalzata di livello: PONo. Il PONo viene utilizzato per abbinare i messaggi in ingresso e in uscita a questa istanza di orchestrazione nella fase successiva, poiché in tutta l'orchestrazione esistono più azioni di invio e ricezione.

• L'orchestrazione del fornitore implementa i collegamenti ruolo per gestire la risoluzione delle entità in ingresso e in uscita. L'orchestrazione del fornitore utilizza due tipi di collegamento ruolo:

  • Tipo collegamento ruolo Buyer_Supplier

  • Tipo collegamento ruolo Supplier_Shipment

• Nella forma Buyer_Supplier Collegamento ruolo il fornitore si trova nel ruolo provider e l'acquirente si trova nel ruolo Consumer perché il fornitore riceve il primo messaggio dall'acquirente. Quando l'orchestrazione fornitore invia il riconoscimento al ruolo acquirente, esiste una porta di trasmissione associata all'acquirente, a cui il messaggio viene inviato attraverso la porta di trasmissione specificata. Per trovare la porta di invio, fare clic con il pulsante destro del mouse su BuyerAgency nella console di amministrazione BizTalk Server e quindi scegliere Proprietà. La porta di invio viene visualizzata in Porte di invio.

• L'orchestrazione utilizza quindi la seguente espressione per restituire le informazioni sul partner e scrive un file XML su una cartella tramite una chiamata a un assembly esterno denominato CheckPartyName.

  Buyer_Supplier(Microsoft.XLANGs.BaseTypes.SourceParty)  
  

• Nella forma Supplier_Shipment Collegamento ruolo il ruolo spedizione contiene una porta di invio con due operazioni usate per inviare il messaggio dal fornitore all'agenzia di spedizione appropriata a seconda della parte di destinazione. Il ruolo fornitore contiene una porta di ricezione con due operazioni che vengono utilizzate per ricevere la risposta dall'agenzia di spedizione. La correlazione viene utilizzata per inviare e ricevere tali messaggi e si basa sul PONo.

  Nota

  Quando si associa l'orchestrazione del fornitore, sarà necessario associare solo una porta di trasmissione e due porte di ricezione Questo dipende dal fatto che le porte di trasmissione verso le entità di destinazione sono già associate alle entità. Inoltre, una delle porte di ricezione nell'orchestrazione contiene due operazioni di ricezione, quindi anche se vengono visualizzate tre forme di ricezione, è necessario associare solo due di esse.

• L'orchestrazione del fornitore utilizza la prima riga del codice seguente per ottenere l'agenzia di spedizione chiamando un assembly esterno denominato QueryShipmentCatalogComponent. Utilizza quindi la seconda riga per impostare l'entità di destinazione per il ruolo Shipment.

  strShipmentName= objQueryShipmentCatalog.GetShipmentDetails(POMessage.MessagePart_1.POHeader.Address.Country);  
  Supplier_Shipment(Microsoft.XLANGs.BaseTypes.DestinationParty) = new Microsoft.XLANGs.BaseTypes.Party(strShipmentName,"OrganizationName");  
  

• Shipper1Process.odx e Shipper2Process.odx vengono compilati per ricevere l'ordine e l'avviso di spedizione da SupplierProcess.odx e per rinviare la risposta a SupplierProcess.odx. In entrambe le orchestrazioni dello spedizioniere viene usata la correlazione, e il tipo di correlazione si basa sulla proprietà innalzata di livello PONo.

Percorso dell'esempio

<Esempi path>\Orchestrations\PartyResolution\

Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.

Compilazione e inizializzazione dell'esempio

Il componente della pipeline MIME non è supportato in un'istanza host a 64 bit. L'host associato al gestore di trasmissione e ricezione dell'adapter per file deve essere configurato come host a soli 32 bit. Per altre informazioni su questo argomento, vedere Come modificare le proprietà dell'host. Se nel sistema è già configurato un host a 32 bit e si vuole usarlo, vedere Configurazione dell'adattatore file per istruzioni sulla configurazione degli host associati al gestore di invio e ricezione dell'adattatore file.

Il certificato citato in questa sezione deve essere aggiunto all'archivio Personale dell'account di accesso configurato per l'istanza host BizTalk In-Process predefinita che firmerà i messaggi.

Per impostazione predefinita, il file di setup.bat indicato di seguito installerà l'esempio di risoluzione delle entità nell'applicazione predefinita BizTalk Server. È possibile modificare il file di setup.bat per distribuire l'esempio in una nuova applicazione BizTalk Server aprendo il file setup.bat e sostituendo la sezione preceduta dall'istruzione @ECHO Deploy Assemblies... con quanto segue:

@ECHO Deploy Assemblies...  

btstask AddApp -ApplicationName:PartyResolutionSample -Description:"Party Resolution Orchestration sample from the SDK"  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Schemas\bin\Release\Schemas.dll -Options:GacOnAdd  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Pipeline\projectschema\bin\Release\ProjectSchema.dll -Options:GacOnAdd   
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Buyer\bin\Release\Buyer.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%BuyerBindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:ShipmentAgency1\bin\Release\ShipmentAgency1.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%ShipmentAgency1BindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:ShipmentAgency2\bin\Release\ShipmentAgency2.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%ShipmentAgency2BindingFileName%  
btstask AddResource -ApplicationName:PartyResolutionSample -Type:System.BizTalk:BizTalkAssembly  -Source:Supplier\bin\Release\Supplier.dll -Options:GacOnAdd  
btstask ImportBindings -ApplicationName:PartyResolutionSample -Source:%SupplierBindingFileName%  

Per generare e inizializzare l'esempio PartyResolution

1. In una finestra di comando passare alla seguente cartella:

   <Percorso esempi>\Orchestrations\PartyResolution

2. Eseguire il file Setup.bat. Verranno eseguite le operazioni seguenti:

   • Compila i progetti di Visual Studio per questo esempio e distribuisce gli assembly risultanti.

   • Crea e associa le porte di invio e ricezione BizTalk Server.

     Durante il processo di installazione è possibile che vengano visualizzati i seguenti avvisi o avvisi simili. Ignorarli.

     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\PartyResolution.sln" (Buildtarget) (1) ->  
     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj" (default target) (5) ->  
     "C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj" (default target) (5:2) ->  
     (CompileODX target) ->  
       C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\SupplierProcess.odx(831,13): warning X4014: convoy processing will not occur -- check your protocol if you were expecting it [C:\ProgramFiles\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj]  
       C:\Program Files\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\SupplierProcess.odx(841,13): warning X4014: convoy processing will not occur -- check your protocol if you were expecting it [C:\ProgramFiles\Microsoft BizTalk Server <version>\SDK\Samples\Orchestrations\PartyResolution\Supplier\Supplier.btproj]  
     
     

3. Avviare il prompt dei comandi di Visual Studio.

4. Immettere i seguenti comandi per installare gli assembly nella cache di assembly globale:

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\Schemas\bin\Release\schemas.dll <

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\Pipeline\projectschema\bin\Release\ProjectSchema.dll <

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\Buyer\bin\Release\Buyer.dll <

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\ShipmentAgency1\bin\Release\ShipmentAgency1.dll <

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\ShipmentAgency2\bin\Release\ShipmentAgency2.dll <

   • gacutil -i \Programmi (x86)\Microsoft BizTalk Server VERSION>SDK\Samples\Orchestrations\PartyResolution\Supplier\bin\Release\Supplier.dll <

5. Ottenere un certificato di posta elettronica protetto da un'autorità di certificazione (CA). La CA può essere un'autorità di terza parte oppure l'autorità all'interno dell'organizzazione. Dopo aver ottenuto il certificato, esportare la chiave pubblica e la chiave privata.

6. Per importare la chiave privata nell'archivio Personale dell'account di accesso dell'istanza host e la chiave pubblica nell'archivio Computer locale Altri utenti, eseguire le operazioni seguenti:

   1. In BizTalk Server Console di amministrazione espandere il gruppo BizTalk e quindi espandere Impostazioni piattaforma.

   2. Fare clic su Istanze host e trovare l'account di accesso visualizzato per l'istanza host In-Process predefinita. In un'installazione predefinita, l'host In-Process predefinito dovrebbe essere BizTalkServerApplication.

   3. Fare clic sul pulsante Starte quindi scegliere Esegui. Nella casella Esegui digitare mmc.exee quindi fare clic su OK. Immettere la password corretta per l'account di accesso dell'istanza dell'host per aprire Microsoft Management Console (MMC) con tale account.

   4. Scegliere Aggiungi/Rimuovi snap-in dal menu File.

   5. Nella finestra di dialogo Aggiungi o Rimuovi snap-in selezionare Certificati e quindi fare clic su Aggiungi.

   6. Nella finestra di dialogo Snap-in Certificati selezionare Account utente personale e quindi fare clic su Fine.

   7. Nella finestra di dialogo Aggiungi o Rimuovi snap-in selezionare Certificati e quindi fare clic su Aggiungi.

   8. Nella finestra di dialogo Snap-in certificati, selezionare Account del computer e fare clic su Avanti.

   9. Nella finestra di dialogo Seleziona computer selezionareComputer locale e quindi fare clic su Fine.

   10. Nella finestra di dialogo Aggiungi o rimuovi snap-in , fare clic su OK.

   11. Espandere il nodo Certificati - Utente corrente e quindi espandere Personale. Fare clic con il pulsante destro del mouse su Certificati, scegliere Tutte le attività e quindi fare clic su Importa.

   12. Importare la chiave privata e immettere una password nella procedura guidata.

   13. Espandere il nodo Certificati (computer locale) e quindi espandere Altro Persone. Fare clic con il pulsante destro del mouse su Certificati, scegliere Tutte le attività e quindi fare clic su Importa.

   14. Importare la chiave pubblica.

7. Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sul nodo Gruppo BizTalk e quindi scegliere Proprietà. Nella finestra di dialogo Proprietà gruppo BizTalk selezionare Certificato.

8. Nella finestra di dialogo Certificato fare clic su Sfoglia e selezionare la chiave privata appena importata. Il certificato specificato in questo punto verrà utilizzato per firmare il messaggio in uscita. Fare clic su OK.

9. Per aggiornare l'entità BuyerAgency di questo esempio eseguire le operazioni seguenti:

   1. Nella console di amministrazione di BizTalk Server selezionare Entità.

   2. Fare clic con il pulsante destro del mouse su BuyerAgency e quindi scegliere Proprietà. Nella finestra di dialogo BuyerAgency - Proprietà entità selezionare Generale.

   3. Nella sezione Alias della finestra di dialogo aggiungere un nuovo alias con il nome e il qualificatore impostati su WindowsUser. Impostare Il valore su un nome utente in formato <dominio\nome> utente,ad esempio SOMEDOMAIN\someuser.

   4. Selezionare Certificato e quindi fare clic su Sfoglia e selezionare la chiave pubblica appena importata. Il certificato specificato in questo punto viene utilizzato per convalidare l'identità del mittente del messaggio in ingresso. Fare clic su OK.

10. Nella console di amministrazione di BizTalk Server espandere Impostazioni piattaforma e quindi selezionare Host.

11. Fare clic con il pulsante destro del mouse su BizTalkServerApplication e quindi scegliere Proprietà. Nella finestra di dialogo BizTalkServerApplication - Proprietà host selezionare Certificati.

12. Fare clic su Sfoglia e selezionare la chiave privata appena importata. Il certificato specificato in questo punto verrà utilizzato per decrittografare i messaggi in ingresso. Fare clic su OK.

13. Nella console di amministrazione di BizTalk Server espandere Impostazioni piattaforma e quindi selezionare Istanze host.

14. Fare clic con il pulsante destro del mouse su BizTalkServerApplication e quindi scegliere Riavvia.

Esecuzione dell'esempio

Per eseguire l'esempio PartyResolution

1. Eseguire FilePolling.exe dalla seguente cartella:

   <Percorso> esempi\Orchestrations\PartyResolution\FilePolling\bin\Debug

2. Fare clic su Avvia polling.

3. Incollare una copia del file di istanza dell'ordine di acquisto fornito, PurchaseOrder.xml, nella seguente cartella:

   <Percorso> degli esempi\Orchestrations\PartyResolution\FileDrop\PurchaseOrder

4. Osservare la sequenza dei messaggi forniti nelle finestre di messaggio che informano sullo stato di avanzamento dell'esempio:

   1. Quando il fornitore riceve l'ordine di acquisto dall'acquirente.

   2. Quando la richiesta dell'ordine di spedizione è ricevuta dall'agenzia di spedizione 1 o 2.

   3. Quando l'avviso di spedizione è ricevuto dall'agenzia di spedizione 1 o 2.

   4. Quando il fornitore invia la conferma di recapito dell'ordine di acquisto all'acquirente.

5. Fare clic su Esci per chiudere il programma di polling file.

Disinstallazione dell'esempio

Per disinstallare l'esempio PartyResolution

1. Al prompt dei comandi di Visual Studio modificare la directory (cd) in <Percorso> esempi\Orchestrations\ PartyResolution\.

2. Eseguire Cleanup.bat.

Vedere anche

Componente della pipeline di risoluzione entità
Come configurare il componente della pipeline del codificatore MIME/SMIME
Come configurare il componente della pipeline di decodifica MIME-SMIME
Orchestrations (cartella di esempi di BizTalk Server)