Microsoft BizTalk Server 2006 è un application service che facilità la rapida creazione di soluzioni integrate, è indicato per integrare sistemi totalmente eterogenei e per creare complessi processi di business.
Per maggiori informazioni è possibile accedere al sito di Microsoft nell' area Biztalk a questo indirizzo:
http://www.microsoft.com/italy/biztalk/default.mspx

Questo articolo vuole fornire le informazioni necessarie per creare un semplice processo di business con Biztalk Server 2006, non sono richiesti particolari prerequisiti.
Quello che essenzialmente faremo sarà creare una semplice orchestration, passarle un file in entrata ed ottenere lo stesso identico file in una directory di output.
Biztalk Server 2006 si integra totalmente in Visual Studio 2005 e offre tutti i templates necessari per lo sviluppo delle sue soluzioni.
Se non abbiamo un Visual Studio 2005 Biztalk lo istallerà durante la sua procedura di setup.

Per questo esercizio è necessario utilizzare una delle seguenti versioni di Microsoft Biztalk 2006, Enterprise, Standard o Developer
E' possibile scaricare una versione di valutazione valida 120 giorni a questo indirizzo:
http://www.microsoft.com/biztalk/downloads/default.mspx

Iniziamo con il creare una directory di progetto di nome MySampleProjetcs
Per creare tutti i componenti necessari al nostro progetto useremo un semplice file Xml come quello qui sotto riportato.
Andiamo nella nostra directory di progetto e creiamo un file XML di nome myorder.xml.

<order> 
 <orderID>1234</orderID> 
 <quantity>1000</quantity> 
 <shipmentPrice>10</shipmentPrice> 
</order>

Ci occorrono due directory che utilizzeremo come Input e Output per Biztalk, le chiameremo rispettivamente IN e OUT, le creiamo sotto la directory di progetto e saranno le nostre directory di lavoro.

Apriamo Visual Studio 2005 e creiamo un nuovo progetto Biztalk.

Il concetto di schema è fondamentale, lo schema definisce come è fatto il file che Biztalk dovrà ricevere, hanno estensione XSD, Biztalk fornisce tutti gli strumenti necessari per la sua creazione.

Selezionate il progetto, tasto destro e Add Generated Items.

Selezionate Generate Schemas e premete Add

Trattandosi di un file XML selezioneremo Well-FormedXML e specifichiamo il nostro file myorder.xml.

Adesso dobbiamo creare le pipeline di receive e send.

Le Pipelines in Biztalk sono una delle principali componenti.

Hanno estensione .btp e il loro utilizzo è mirato a: 

• Spacchettare messaggi in entrata in più messaggi individuali

• Verificare i documenti mediante firma digitale

• Processare la codifica dei documenti (MIME/SMIME)

• Trasformare da flat file a XML e vice versa

• Incrementare i messaggi con ulteriori informazioni derivate da database o altro

Senza di esse Biztalk non può ricevere alcun messaggio, In un successivo articolo tratterò questo argomento in modo più dettagliato.

Tasto destro su progetto, Add / New / Item e selezionate Receive Pipeline, chiamiamola myReceivePipeline.btp

La Pipelines è composta di vari stages, ognuno è adibito ad un determinato compito.
In questo caso utilizzeremo quello di Disassemble e quello di Assemble il cui compito è rispettivamente quello di disassemblare e assemblare il file sulla base di un determinato schema.
I componenti che effettivamente si occupano di queste operazioni sono l' XML disassembler e l' XML assembler.

Facciamo il Drag and Drop del componete XML Disassembler nello stage Disassemble.

Selezioniamo l’ XML Disassembler e impostiamo la proprietà Document schemas con lo schema appena creato.

Creiamo la Pipeline di send, seguite i passi precedenti eccetto che per il tipo di pipeline, che sarà quindi di Send.

Questa volta lo stage sarà Assemble, mentre per il componente sarà XML assembler.

Impostate la proprietà Add XML Declaration dell’ XML Assembler a False, altrimenti il file risultante conterrà in testata la
classica dichiarazione XML.

E’ il momento di creare il nostro processo di business.
In Biztalk i processi di business vengono creati mediante l'utilizzo del componente Orchestration, hanno estensione .odx

Add / New / Items e selezioniamo Orchestration Files

Salvate questa orchestration come MyOrchestration.odx

Tutto quello che Biztalk riceve è sempre e comunque trasformato in un oggetto di tipo messaggio.

Il file ricevuto da Biztalk viene interpretato all' interno del nostro processo in qualità di oggetto messaggio.

A questo punto dobbiamo costruire il messaggio vero e proprio.
Apriamo la nostra orchestration e di conseguenza l’ orchestration view

Tasto destro su Messages, New Message e impostiamo le proprietà come in figura.

Adesso abbiamo creato un' oggetto di tipo messaggio, il fatto di aver associato lo schema, altro non fa, che tipizzare l'oggetto di tipo Message sulla base del file che intendiamo ricevere.

L' oggetto di tipo orchestration fornisce molti componenti per creare i processi di business, questi vengono chiamati shapes.

A questo punto Drag and Drop dei due shape di Receive e Send che troviamo sulla nostra toolbox, semplicemente parlando questi due shape hanno il compito rispettivamente di ricevere e inviare il file.

Impostiamo le proprietà rispettivamente in questo modo:

Shape di Receive
Name: Receive_IN o come meglio preferite (In Biztalk è buona usanza definire con _IN e _OUT le rispettive porte di entrata e uscita)
Activate: True
Message: Message_Order

Shape di Send
Name: Send_OUT o come meglio preferite (In Biztalk è buona usanza definire con _IN e _OUT le rispettive porte di entrata e uscita)
Message: Message_Order

A questo punto iniziamo a creare le porte di ricezione e spedizione.
Prendere dalla toolbox una Port e mettetela sulla Port Surface alla vostra sinistra, apparirà il wizard.

Impostate i seguenti valori:

Name: Port_IN o come meglio credete
Port Type Name: PortType_IN o come meglio credete
Port direction of communication: I’ll always be receving…
Port binding: Specify Now
Transport: File
URI: Impostate la directory IN precedentemente creata nel nostro caso sarà C:\MyProjects\BizTalkQuickStart\IN\*.xml
Receive Pipeline: BiztalkQuickStart.myReceivePipeline

Prendere dalla toolbox una Port e mettetela sulla Port Surface alla vostra destra, apparirà il wizard.

Name: Port_OUT o come meglio credete
Port Type Name: PortType_ OUT o come meglio credete
Port direction of communication: I’ll always be sending …
Port binding: Specify Now
Transport: File
URI: Impostate la directory OUT precedentemente creata nel nostro caso sarà C:\MyProjects\BizTalkQuickStart\OUT\%MessageID%.xml
%MessageID% restituisce l'EntryID di un Messaggio.
Send Pipeline: BiztalkQuickStart.mySendPipeline

Agganciamo le due porte ai corrispettivi shapes, questo farà sì che biztalk associ correttamente la porta di ricezione con lo shape di receive e lo shape di send con la porta di spedizione.

A questo punto non reste che fare il deploy della nostra soluzione.
Quello che produrrà il nostro compilatore altro non è che un’ assembly .NET e questo assembly deve essere registrato in GAC.
Apriamo il nostro Visual Studio command prompt e creiamo il nostro file di Strong Name sotto la directory di progetto mediante l’ormai famosissimo comando:
sn -k myfilesn.snk

Tasto destro su progetto, selezionate properties , Common Properties \ Assembly e impostate la proprietà Assembly Key File per utilizzare il file di strong name appena creato

Selezionate Configuration Properties, Deployment, e impostate Application Name a myProjects

Compiliamo il nostro progetto, tasto destro su progetto e Build.
Eseguiamo il Deploy, tasto destro su progetto e Deploy

Non preoccupatevi degli eventuali messaggi di warning, aprite il Biztalk Explorer selezionando la voce di menù View \ Biztalk Explorer

Selezioniamo la nostra orchestration

Tasto destro, click su Bind e impostiamo l’ host su BizTalkServerApplication

Ancora tasto destro sulla nostra orchestration ed eseguiamo l’ enlist mediante il comando Enlist, successivamente sempre tasto destro ed eseguiamo lo start.

A questo punto non ci resta che provare il nostro semplice processo di business.
Copiate il file myorder.xml nella directory di input, andate nella directory di output e troverete un file simile a questo {4C66BCD3-0BAD-4935-9704-13404E1295A7}.xml e dal contenuto identico a quello sorgente.

Inizio pagina

Conclusioni

Questo voleva essere un primo approccio, senza nessuna pretesa, verso il mondo Biztalk.
Gli articoli che verranno prenderanno in dettaglio tutti gli oggetti che abbiamo utilizzato, il prossimo tratterà proprio le Pipelines.

Inizio pagina