Message Inspector Pipeline Component
Questo componente della pipeline consente di esaminare tutte le parti di un messaggio multiparte e il contesto del messaggio, per determinare se esiste un problema con il messaggio. Usare questo componente per la risoluzione dei problemi.
Il componente della pipeline elimina i file XML in una directory designata dall'utente. Ognuno di questi file contiene una delle quattro parti di un messaggio di RNIFv2.0 (intestazione del preambolo, intestazione del recapito, intestazione del servizio e contenuto del servizio) o tre parti di un messaggio RNIFv1.1 (intestazione del preambolo, intestazione del servizio e contenuto del servizio). Un altro file XML contiene il contesto del messaggio.
Si compila questo componente in una pipeline personalizzata e lo si associa a una porta di trasmissione. Si crea un filtro nella porta di trasmissione per sottoscrivere i messaggi da monitorare. Questa risoluzione dei problemi si verifica oltre all'elaborazione standard già eseguita dall'acceleratore BizTalk® per RosettaNet (BTARN).
Compilazione di una pipeline personalizzata con Message Inspector Pipeline Component
Per usare Message Inspector Pipeline Component è necessario compilare e distribuire una pipeline personalizzata che includa il componente. Per altre informazioni, vedere "Creazione di pipeline con pipeline Designer" in BizTalk Server Guida.
Per distribuire Message Inspector Pipeline Component
Avviare Visual Studio.
Scegliere Apri dal menu Filee quindi fare clic su Progetto.
Passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component, selezionare MessageInspector.csproj e quindi fare clic su Apri.
Aprire il prompt dei comandi di Visual Studio.
Al prompt dei comandi passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug.
Al prompt dei comandi digitare "sn -k MessageInspector.snk" per creare una chiave e quindi premere INVIO.
In Visual Studio, in Esplora soluzioni fare clic con il pulsante destro del mouse su MessageInspector e quindi scegliere Proprietà.
Nella pagina Proprietà MessageInspector fare clic sulla scheda Firma e quindi fare clic sulla casella di controllo Firma dell'assembly .
Nell'elenco a discesa Scegliere un file di chiave con nome sicuro passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug e selezionare MessageInspector.snk e quindi fare clic su Apri.
In Esplora soluzioni fare clic con il pulsante destro del mouse su MessageInspectore quindi scegliere Compila. Verificare nel riquadro Output che la compilazione sia riuscita.
Fare clic sul pulsante Start, scegliere Tutti i programmi, Accessori, quindi fare clic su Esplora risorse.
In Esplora risorse passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, fare clic con il pulsante destro del mouse su Microsoft.Solutions.BTARN.SDK.MessageInspector.dlle quindi scegliere Copia.
Passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\Pipeline Components, fare clic con il pulsante destro del mouse su Componenti pipeline e quindi fare clic su Incolla.
Scegliere Nuovo dal menu File di Visual Studio e quindi fare clic su Progetto.
Nel riquadro Modelli della finestra di dialogo Nuovo progetto selezionare Progetto BizTalk Server vuotoe nella casella Nome digitare un nome per il progetto. Nella casella Percorso in cui si vuole salvare il progetto e fare clic su OK.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto, scegliere Aggiungie quindi fare clic su Aggiungi nuovo elemento.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Pipeline di trasmissionee nella casella Nome digitare un nome per il file della pipeline personalizzata, quindi fare clic su Apri.
Nota
Aggiungere il componente Message Inspector Pipeline Component solo alle porte di trasmissione, non a quelle di ricezione.
Fare clic con il pulsante destro del mouse nel riquadro Componenti pipeline BizTalk del riquadro Casella degli strumenti e quindi scegliere Aggiungi/Rimuovi elementi.
Nella scheda Componenti pipeline BizTalk della finestra di dialogo Personalizza Casella degli strumenti selezionare BTARN Message Inspector Componente quindi fare clic su OK.
Nel riquadro Componenti della pipeline BizTalk del riquadro Casella degli strumenti fare clic su e tenere premuto componente controllo messaggi BTARN e quindi trascinare il componente in una casella Drop Here.
In Visual Studio, in Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto della pipeline e quindi scegliere Proprietà.
Nella finestra di dialogo Pagine delle proprietà fare clic su Proprietà comunie quindi su Assembly.
Nel riquadro destro, nella casella di testo associata al file chiave assembly fare clic sui puntini di sospensione, passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, selezionare MessageInspector.snk e quindi fare clic su OK.
In Designer pipeline di Visual Studio selezionare la forma Componente controllo messaggi BTARN.
In Visual Studio Finestra Proprietà, nella casella Directory digitare il nome della directory a cui si desidera eliminare i file XML.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Compila. Verificare che la compilazione riesca.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Distribuisci. Verificare che la distribuzione riesca.
In Visual Studio, nel menu Visualizza fare clic su BizTalk Explorer.
Fare clic con il pulsante destro del mouse su Porte di trasmissione, quindi scegliere Aggiungi porta di trasmissione.
Nella finestra di dialogo Crea nuova porta di trasmissione fare clic su OK.
Nella casella Nome della finestra di dialogo Proprietà porte di trasmissione digitare il nome per la porta di trasmissione. Con l'opzione Primaria selezionata nel riquadro sinistro fare clic su Tipo di trasporto nel riquadro destro e selezionare FILE.
Nella casella Indirizzo (URI) della finestra di dialogo Proprietà porta di trasmissione fare clic sul pulsante con i puntini di sospensione (...).
Nella finestra di dialogo Proprietà del trasporto FILE digitare il nome della cartella in Destinazione , fare clic su Trasmissione nel riquadro sinistro e quindi per Pipeline di trasmissione nel riquadro destro selezionare la pipeline personalizzata appena creata.
Fare clic su Filtri & Mappe nel riquadro sinistro e quindi fare clic su Filtri.
Immettere un'espressione di filtro nel riquadro destro, specificando il tipo di file per cui si vuole che la pipeline elimini i file XML. Ad esempio, per eliminare i file per tutti i messaggi di RNIF v1.1, per Proprietà selezionare Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction e per Operatore selezionare "Esiste", quindi fare clic su OK.
In BizTalk Explorer fare clic con il pulsante destro del mouse sulla porta di trasmissione appena creata, scegliere Integra, fare di nuovo clic con il pulsante destro del mouse sulla porta di trasmissione e quindi scegliere Avvia.
Commenti
Nell'elaborazione tipica si può esaminare solo una delle parti del messaggio alla volta (la parte che è stata definita come corpo del messaggio nell'orchestrazione). Si può quindi esaminare solo una delle parti nella Console di amministrazione BizTalk e la capacità di risoluzione dei problemi è limitata. Message Inspector Pipeline Component consente di superare questo limite.