Procedura: Convertire un documento di testo in XML e instradare a un percorso di file usando una lista di distribuzione dell'itinerario
Obiettivo
La sezione illustra come creare una pipeline che convertirà un documento di testo in XML e quindi selezionare l'itinerario appropriato e instradare il messaggio a un percorso FILE.
In questo argomento di procedura si completeranno i passaggi seguenti:
Usare una pipeline per ricevere un documento di file flat e convertirlo in XML.
Configurare il componente pipeline del selettore itinerari per risolvere la lista di distribuzione appropriata.
Creare una rampa che usa la pipeline personalizzata.
Testare il routing basato sull'itinerario di un messaggio di file flat.
Prerequisiti
Le procedure descritte in questa procedura richiedono il completamento dei prerequisiti per le attività di sviluppo.
Prima di iniziare
Completare le attività seguenti prima di eseguire i passaggi più avanti in questo argomento procedura:
Distribuire l'itinerario DataFormatTransformation .
Creare il messaggio di test.
Le procedure seguenti descrivono come eseguire ognuna di queste operazioni.
Per distribuire l'itinerario DataFormatTransformation
In Visual Studio aprire C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln.
In Esplora soluzioni, nel progetto Itinerary.Library fare doppio clic su DataFormatTransformation.itinerary per aprirlo nel Designer itinerario.
In Visual Studio fare clic sull'area di progettazione di DataFormatTransformation.itinerary. Nella Finestra Proprietà DataFormatTransformation.itinerary configurare le proprietà seguenti:
Nell'elenco a discesa Stato itinerario fare clic su Distribuito.
Nell'elenco a discesa Esportazione modelli fare clic su Esportazione itinerari di database.
Fare clic sul pulsante con i puntini di sospensione (...) accanto alla proprietà Database itinerario .
Nella finestra di dialogo Proprietà connessione scegliere il SQL Server che ospita il database del repository dell'itinerario e quindi specificare il nome del database ( il nome predefinito è EsbItineraryDb).
Salvare tutti gli artefatti del progetto.
In Visual Studio fare clic con il pulsante destro del mouse sull'area di progettazione dell'itinerario DataModelTransformation e quindi scegliere Esporta modello.
Per creare la pipeline di ricezione
In Visual Studio fare clic con il pulsante destro del mouse su DataFormatTransformation.Schemas e quindi scegliere Proprietà. Fare clic su Applicazione, quindi digitare GlobalBank.ESB.DataFormatTransformation.Schemas nella casella Nome assembly .
Fare clic con il pulsante destro del mouse su DataFormatTransformation.Schemas, quindi scegliere Proprietà. Fare clic su Firmae quindi verificare che la casella di controllo Firma assembly sia selezionata e che il percorso dell'assembly punti a .\.. \.. \.. \.. \.. \keys\Microsoft.Practices.ESB.snk.
Fare clic con il pulsante destro del mouse su DataFormatTransformation.Pipelines, quindi scegliere Rimuovi.
Fare clic con il pulsante destro del mouse su DataFormatTransformation, scegliere Aggiungi, quindi fare clic su Nuovo progetto. Fare clic su Progetti Biztalk e quindi su Progetto Biztalk Server vuoto. Nella casella Nome digitare DataFormatTransformationReceive.Pipeline.
Fare clic con il pulsante destro del mouse su DataFormatTransformationReceive.Pipeline, quindi scegliere Proprietà. Fare clic su Firma, quindi verificare che la casella di controllo Firma l'assembly sia selezionata e che il percorso dell'assembly punti a C:\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk.
Fare clic con il pulsante destro del mouse su DataFormatTransformationReceive.Pipeline, scegliere Aggiungi e quindi fare clic su Nuovo elemento.
Nella finestra di dialogo Aggiungi nuovo elemento fare clic su Pipeline di ricezione nel riquadro Modelli. Nella casella Nome digitare ItinerarioSelectReceiveFF e quindi fare clic su Aggiungi.
Fare clic con il pulsante destro del mouse su Riferimenti per il progetto DataFormatTransformationReceive.Pipeline e quindi scegliere Aggiungi riferimento. Fare clic sulla scheda Progetti e quindi su DataFormatTransformation.Schemas. Fare clic su OK per aggiungere il riferimento.
Dalla casella degli strumenti trascinare un componente della pipeline disassembler file flat nella fase Disassemble della pipeline.
Nella Finestra Proprietà per il disassemble del file flat fare clic su DataModelTransformation.Schemas.NAOrderDocFF nell'elenco a discesa Schema documento.
Dalla casella degli strumenti trascinare un componente della pipeline del selettore dell'itinerario ESB nella fase Resolve Party della pipeline.
Dalla casella degli strumenti trascinare un componente della pipeline dispatcher ESB nella fase Resolve Party della pipeline e quindi inserirlo nel componente della pipeline del selettore dell'itinerario ESB .
Salvare tutti gli artefatti del progetto.
Per creare il messaggio di test
Fare clic una sola volta nel file di schema NAOrderDocFF.xsd del progetto DataFormatTransformation.Schemas. Nel riquadro Proprietà di Visual Studio modificare le due proprietà seguenti:
Generare il tipo di output dell'istanza. Fare clic sull'elenco a discesa per questa proprietà per modificarla in Nativo.
Nome file dell'istanza di output. Fare clic sul pulsante con i puntini di sospensione (...) per questa proprietà e accettare il percorso predefinito C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation. Nella casella Nome file digitare NAOrderDocFF e quindi fare clic su Salva.
Fare clic con il pulsante destro del mouse su NAOrderDocFF.xsd in DataFormatTransformation.Schemas e quindi scegliere Genera istanza. A questo punto, è necessario avere un nuovo file generato nella directory C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation.
Copiare (non spostare) il file NAOrderDocFF.txt da C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation a C:\HowTos.
Nota
Questo è il messaggio che si riceverà e si convertirà in XML. Questo documento rappresenta una versione file flat del documento North American Order.
Passaggi
Per distribuire la pipeline di ricezione e lo schema
Fare clic con il pulsante destro del mouse su DataFormatTransformationReceive.Pipeline, quindi scegliere Proprietà. Fare clic su Distribuzione, quindi digitare Microsoft.Practices.ESB nella casella Nome applicazione .
Fare clic con il pulsante destro del mouse sul progetto DataFormatTransformation.Schemas e quindi scegliere Proprietà. Fare clic su Distribuzione, quindi digitare Microsoft.Practices.ESB nella casella Nome applicazione .
Chiudere i riquadri Proprietà per DataFormatTransformationReceive.Pipeline e DataFormatTransformation.Schemas.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto DataFormatTransformation e quindi scegliere Distribuisci soluzione.
Per creare e configurare un'istanza di ESB su rampa
Fare clic su Start sulla barra delle applicazioni, scegliere Tutti i programmi, BizTalk Server e quindi fare clic su BizTalk Server Amministrazione.
Nella console di amministrazione di BizTalk Server espandere Gruppo BizTalk, applicazionie quindi fare clic su Microsoft.Practices.ESB.
Fare clic con il pulsante destro del mouse su Percorsi di ricezione, scegliere Nuovo e quindi fare clic su Posizione di ricezione unidirezionale.
Nella finestra di dialogo Seleziona porta di ricezione fare clic su OnRamp.Itinerary e quindi su OK.
Nella casella Nome della finestra di dialogo Proprietà posizione di ricezione digitare OnRamp.Routey.FlatFile.FILE.
Nell'elenco a discesa Tipo fare clic su FILE e quindi su Configura.
Nella casella Cartella di ricezione della finestra di dialogo Proprietà trasporto FILE digitare C:\HowTos\DropFolder.
Nella finestra di dialogo Proprietà trasporto FILE digitare *.txtnella casella Maschera file e quindi fare clic su OK.
Per configurare il componente pipeline del selettore itinerario
Nella finestra di dialogo Proprietà località di ricezione fare clic su ItinerarioSelectReceiveFF nell'elenco a discesa Pipeline di ricezione , quindi fare clic sul pulsante con i puntini di sospensione (...).
Usare la finestra di dialogo Configura pipeline per configurare le proprietà del componente del selettore itinerario seguenti:
Fare clic sulla proprietà ItineraryFactKey e quindi digitare Resolver.Itinerary.
Fare clic sulla proprietà ResolverConnectionString , digitare ITINERARY:\\name=DataFormatTransformation e quindi fare clic su OK.
Fare clic su OK per chiudere la finestra di dialogo Proprietà posizione ricezione .
Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sul percorso di ricezione OnRamp.Itinerary.FlatFile.FILE e quindi scegliere Abilita.
Per testare il routing basato sull'itinerario di un messaggio di file flat
In Esplora risorse passare a C:\HowTos.
Copiare (non spostare) NAOrderDocFF.txt in C:\HowTos\DropFolder.
Passare a C:\HowTos\Out. Verificare che il messaggio DFT%MessageID%.xml sia stato scritto nella directory.
Nella console di amministrazione di BizTalk Server fare clic con il pulsante destro del mouse sul percorso di ricezione OnRamp.Itinerary.FlatFile.FILE e quindi scegliere Disabilita.
Dopo che il percorso di ricezione OnRamp.Itinerary.FlatFile.FILE è disabilitato , fare clic con il pulsante destro del mouse su di esso e quindi scegliere Elimina. Nella finestra di dialogo Conferma ricezione eliminazione fare clic su Sì.
Risorse aggiuntive
Per altre informazioni, vedere i seguenti argomenti correlati:
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per