Condividi tramite

Procedura: Convertire un documento di testo in XML e indirizzare a una posizione di file usando un foglio di rotta 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 pratico, completerete i passaggi seguenti:

  • Usare una pipeline per ricevere un documento di file flat e convertirlo in XML.

  • Configurare il componente della pipeline del Selettore di Itinerario per individuare il modulo di instradamento appropriato.

  • Creare una rampa di accesso che utilizza la pipeline personalizzata.

  • Testare il routing basato sull'itinerario di un messaggio di file flat.

Prerequisiti

Le procedure descritte in questo argomento richiedono il completamento dei prerequisiti per le attività di sviluppo.

Prima di iniziare

Completate le attività seguenti prima di eseguire i passaggi più avanti in questa guida pratica.

  • Distribuire l'itinerario DataFormatTransformation.

  • Creare il messaggio di test.

    Le procedure seguenti descrivono come eseguire ognuna di queste operazioni.

Per distribuire l'itinerario DataFormatTransformation

  1. In Visual Studio, apri C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln.

  2. In Esplora soluzioni, nel progetto Itinerary.Library fare doppio clic su DataFormatTransformation.itinerary per aprirlo in Itinerary Designer.

  3. In Visual Studio, fai clic sull'area di progettazione di DataFormatTransformation.itinerario. Nella finestra Proprietà DataFormatTransformation.itinerary configurare le proprietà seguenti:

    1. Nell'elenco a discesa Stato itinerario fare clic su Distribuito.

    2. Nell'elenco a discesa Esportazione modelli fare clic su Esportazione itinerari di database.

    3. Fare clic sul pulsante con i puntini di sospensione (...) accanto alla proprietà Database dell'itinerario .

    4. Nella finestra di dialogo Proprietà connessione scegliere SQL Server che ospita il database del repository di itinerari e quindi specificare il nome del database (il nome predefinito è EsbItineraryDb).

  4. Salvare tutti gli artefatti del progetto.

  5. 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

  1. In Visual Studio fare clic con il pulsante destro del mouse su DataFormatTransformation.Schemas e quindi scegliere Proprietà. Fare clic su Applicazione e quindi digitare GlobalBank.ESB.DataFormatTransformation.Schemas nella casella Nome assembly .

  2. Fare clic con il pulsante destro del mouse su DataFormatTransformation.Schemas e 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 .\.. \.. \.. \.. \.. \keys\Microsoft.Practices.ESB.snk.

  3. Fare clic con il pulsante destro del mouse su DataFormatTransformation.Pipelines e quindi scegliere Rimuovi.

  4. 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.

  5. 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.

  6. Fare clic con il pulsante destro del mouse su DataFormatTransformationReceive.Pipeline, scegliere Aggiungie quindi fare clic su Nuovo elemento.

  7. 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.

  8. 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.

  9. Dalla Toolbox, trascinare un componente di pipeline Flat file disassembler nella fase Disassemble del pipeline.

  10. Nella finestra Proprietà per la scomposizione del file flat, fare clic su DataModelTransformation.Schemas.NAOrderDocFF nell'elenco a discesa Schema documento.

  11. Dal Toolbox, trascinare un componente della pipeline ESB Itinerary Selector nella fase corrispondente a Resolve Party della pipeline.

  12. Dalla Casella degli Strumenti, trascinare un componente della pipeline ESB Dispatcher alla fase Resolve Party della pipeline e quindi posizionarlo sotto il componente della pipeline ESB Itinerary Selector.

  13. Salvare tutti gli artefatti del progetto.

Per creare il messaggio di test

  1. 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.

  2. 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.

  3. Copiare (non spostare) il file NAOrderDocFF.txt da C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation a C:\HowTos.

    Annotazioni

    Si tratta del messaggio che si riceverà e si convertirà in XML. Questo documento rappresenta una versione file flat del documento North American Order.

Fasi

Per distribuire la pipeline di ricezione e lo schema

  1. Fare clic con il pulsante destro del mouse su DataFormatTransformationReceive.Pipeline, quindi scegliere Proprietà. Fare clic su Distribuzione e quindi digitare Microsoft.Practices.ESB nella casella Nome applicazione .

  2. Fare clic con il pulsante destro del mouse sul progetto DataFormatTransformation.Schemas e quindi scegliere Proprietà. Fare clic su Distribuzione e quindi digitare Microsoft.Practices.ESB nella casella Nome applicazione .

  3. Chiudere i riquadri Proprietà per DataFormatTransformationReceive.Pipeline e DataFormatTransformation.Schemas.

  4. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto DataFormatTransformation e quindi scegliere Distribuisci soluzione.

Per creare e configurare un punto di accesso ESB

  1. Fare clic su Start sulla barra delle applicazioni, scegliere Tutti i programmi, BizTalk Server e quindi fare clic su Amministrazione BizTalk Server.

  2. Nella Console di amministrazione di BizTalk Server espandere Gruppo BizTalk, espandere Applicazioni e quindi fare clic su Microsoft.Practices.ESB.

  3. Fare clic con il pulsante destro del mouse su Percorsi di ricezione, scegliere Nuovo e quindi fare clic su Posizione di ricezione unidirezionale.

  4. Nella finestra di dialogo Seleziona porta di ricezione fare clic su OnRamp.Itinerary e quindi su OK.

  5. Nella casella Nome della finestra di dialogo Proprietà percorso ricezione digitare OnRamp.Itinerary.FlatFile.FILE.

  6. Nell'elenco a discesa Tipo fare clic su FILE e quindi su Configura.

  7. Nella finestra di dialogo Proprietà trasporto FILE, nella casella Cartella di ricezione, digitare C:\HowTos\DropFolder.

  8. Nella casella Maschera file della finestra di dialogo Proprietà trasporto FILE digitare *.txte quindi fare clic su OK.

Per configurare il componente della pipeline del selettore itinerario

  1. Nella finestra di dialogo Proprietà località di ricezione, fare clic su ItinerarySelectReceiveFF nell'elenco a discesa Receive pipeline e quindi fare clic sul pulsante con i puntini di sospensione (...).

  2. Usare la finestra di dialogo Configura pipeline per configurare le proprietà del componente selettore itinerario seguenti:

    1. Fare clic sulla proprietà ItineraryFactKey e quindi digitare Resolver.Itinerary.

    2. Fare clic sulla proprietà ResolverConnectionString , digitare ITINERARIO:\\name=DataFormatTransformation e quindi fare clic su OK.

  3. Fare clic su OK per chiudere la finestra di dialogo Proprietà del percorso di ricezione.

  4. 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

  1. In Esplora risorse passare a C:\HowTos.

  2. Copiare (non spostare) NAOrderDocFF.txt in C:\HowTos\DropFolder.

  3. Passa a C:\HowTos\Out. Verify that the DFT%MessageID%.xml, il messaggio è stato scritto nella la directory.

  4. 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.

  5. 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 eliminazione posizione di ricezione, fare clic su Sì.

Risorse aggiuntive

Per altre informazioni, vedere gli argomenti correlati seguenti: