HelloWorld (esempio di BizTalk Server)
Nell'esempio HelloWorld viene illustrato come utilizzare le orchestrazioni BizTalk per convertire un messaggio XML, in questo caso un ordine di acquisto, in un tipo di messaggio correlato ma distinto, in questo caso una fattura.
Scopo dell'esempio
In questo esempio viene configurata la cartella In come percorso di ricezione. Quando si inserisce un file, ad esempio il file di esempio SamplePOInput.xml, in questa cartella, BizTalk Server elabora il messaggio seguendo questa procedura:
BizTalk Server recupera il messaggio dell'ordine di acquisto XML dalla cartella del percorso di ricezione.
L'orchestrazione utilizza il file di mappa per creare una fattura in formato XML dall'ordine di acquisto XML.
BizTalk Server inserisce il messaggio di fattura XML risultante nella cartella Out dell'adapter di trasmissione.
Progettazione e finalità dell'esempio
In uno scenario di scambio di messaggi tra aziende, è spesso necessario convertire i messaggi in ingresso ricevuti dai trading partner in un formato riconoscibile dalle applicazioni interne. In questo esempio viene utilizzata una forma Receive , una forma Transform e una forma Send per ottenere questo risultato. La forma Transform svolge il ruolo importante in questo esempio perché si verifica la conversione del formato del messaggio. Trascinare una forma Trasforma nell'orchestrazione e configurare il messaggio di origine, il nome della mappa e il messaggio di destinazione. In fase di esecuzione, il messaggio di origine viene mappato al messaggio di destinazione utilizzando la mappa specificata.
Per altre informazioni sulla forma Transform , vedere How to Configure the Transform Shape.For more information about the Transform shape, see How to Configure the Transform Shape. Per altre informazioni sulla creazione di una mappa, vedere Creazione di mappe tramite BizTalk Mapper.
Percorso dell'esempio
<Percorso esempi>\Orchestrations\HelloWorld\
Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.
| File | Descrizione |
|---|---|
| Cleanup.bat | Viene utilizzato per annullare la distribuzione degli assembly e rimuoverli dalla Global Assembly Cache. Consente inoltre di rimuovere porte di trasmissione e ricezione. Consente infine di rimuovere le directory virtuali di Microsoft Internet Information Services (IIS), se necessario. |
| HelloOrchestration.odx | Orchestrazione che coordina la conversione dell'ordine di acquisto in una fattura. |
| HelloWorld.btproj, HelloWorld.sln | File di progetto e soluzione per l'esempio. |
| HelloWorldBinding.xml | Utilizzato per l'impostazione automatica, ad esempio il binding delle porte. |
| InvoiceSchema.xsd, POSchema.xsd | Schemi rispettivamente per il messaggio della fattura e quello dell'ordine di acquisto. |
| POToInvoice.btm | Mappa per la conversione dell'ordine di acquisto in una fattura. |
| SamplePOInput.xml | File di input di esempio. |
| Setup.bat | Utilizzato per compilare e inizializzare l'esempio. |
Compilazione e inizializzazione dell'esempio
Per compilare e inizializzare l'esempio HelloWorld
In una finestra di comando passare alla seguente cartella:
<Percorso esempi>\Orchestrations\HelloWorld
Eseguire il file Setup.bat. Verranno eseguite le operazioni seguenti:
Creazione delle cartelle di input (In) e output (Out) per l'esempio nella cartella seguente:
<Percorso esempi>\Orchestrations\HelloWorld
Compila il progetto di Visual Studio per questo esempio.
Crea e associa il BizTalk Server percorso di ricezione e le porte di invio e ricezione all'orchestrazione.
Abilita l'indirizzo di ricezione e avvia la porta di trasmissione. Integrazione e avvio dell'orchestrazione.
Nota
Prima di provare a eseguire l'esempio, è necessario verificare che BizTalk Server non abbia segnalato errori durante il processo di generazione e inizializzazione. A tale scopo, consultare i registri eventi.
Esecuzione dell'esempio
Per eseguire l'esempio HelloWorld
Incollare una copia del file SamplePOInput.xml nella cartella In .
Osservare il file .xml creato nella cartella Out . Questo file contiene la fattura XML costruita dal file di input SamplePOInput.xml. Il formato del nome di questo file è <MessageID>.xml, dove <MessageID> è il GUID generato per identificare in modo univoco il messaggio.
Disinstallazione dell'esempio
Per disinstallare l'esempio HelloWorld
In una finestra di comando passare alla seguente cartella:
<Percorso esempi>\Orchestrations\HelloWorld\
Eseguire Cleanup.bat.