Message Editor Pipeline Component

Questo componente permette di modificare automaticamente qualsiasi parte di un messaggio in più parti all'interno di una pipeline di trasmissione o ricezione. È necessario aggiungere questo componente a una pipeline esistente per configurare la sostituzione come parte dell'elaborazione tipica.

Creazione di Message Editor Pipeline Component in una pipeline esistente

Per usare Message Editor Pipeline Component, è necessario aggiungere il componente a una pipeline esistente. Per altre informazioni, vedere "Creazione di pipeline con pipeline Designer" in BizTalk Server Guida.

Per aggiungere Message Editor Pipeline Component a una pipeline esistente

1. Avviare Visual Studio.

2. Scegliere Apri dal menu Filee quindi fare clic su Progetto.

3. Passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component, selezionare MessageEditor.csproj e quindi fare clic su Apri.

4. Avviare il prompt dei comandi di Visual Studio.

5. Al prompt dei comandi passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug.

6. Al prompt dei comandi digitare sn -k MessageEditor.snk per creare una chiave e quindi premere INVIO.

7. In Visual Studio, in Esplora soluzioni fare clic con il pulsante destro del mouse su MessageEditor e quindi scegliere Proprietà.

8. In Proprietà MessageEditor fare clic sulla scheda Firma e quindi selezionare la casella di controllo Firma assembly .

9. Nell'elenco a discesa Scegliere un file chiave con nome sicuro passare a C:\Programmi (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\ SDK\Message Editor Pipeline Component\obj\debug e selezionare MessageEditor.snk e quindi fare clic su Apri.

10. In Esplora soluzioni fare clic con il pulsante destro del mouse su MessageEditore quindi scegliere Compila. Verificare nel riquadro Output che la compilazione sia riuscita.

11. Fare clic sul pulsante Start, scegliere Tutti i programmi, Accessori, quindi fare clic su Esplora risorse.

12. In Esplora risorse passare a C:\Programmi\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug, fare clic con il pulsante destro del mouse su Microsoft.Solutions.BTARN.SDK.MessageEditor.dlle quindi fare clic su Copia.

13. Passare a C:\Programmi\Microsoft BizTalk Server 2013\Pipeline Components, fare clic con il pulsante destro del mouse su Componenti pipelinee quindi scegliere Incolla.

14. In Visual Studio scegliere Apri dal menu File e quindi fare clic su Progetto.

15. Aprire il progetto che contiene la pipeline a cui si vuole aggiungere l'editor.

16. In Esplora soluzioni fare doppio clic sul nome della pipeline per aprirla in Progettazione pipeline.

17. Fare clic con il pulsante destro del mouse nel riquadro Componenti pipeline BizTalk e quindi scegliere Aggiungi/Rimuovi elementi.

18. Nella scheda Componenti pipeline BizTalk della finestra di dialogo Personalizza Casella degli strumenti selezionare BTARN Message Editor Componente quindi fare clic su OK.

19. Nel riquadro Componenti pipeline BizTalk del riquadro Casella degli strumenti fare clic su BTARN Message Editor Componente trascinare il componente nella posizione desiderata nella pipeline.

20. Nel riquadro Componenti pipeline BizTalk del riquadro Casella degli strumenti fare clic su BTARN Message Editor Componente trascinare il componente nella posizione desiderata nella pipeline.

    Nota

    È consigliabile aggiungere Message Editor Pipeline Component dopo la fase di disassemblaggio nel componente della pipeline di ricezione o nella fase di preassemblaggio nel componente della pipeline di trasmissione.

21. In Visual Studio, in Pipeline Designer selezionare la forma Componente dell'editor messaggi BTARN.

22. Nella casella di testo associata a Query XPathnel riquadro Proprietà digitare il nome dell'elemento XPath per cui si vuole modificare il valore.

23. Nella casella di testo associata a Valore XPathdigitare il valore su cui si vuole impostare l'elemento XPath.

24. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto e quindi scegliere Compila. Verificare che la compilazione riesca.

25. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto e quindi scegliere Distribuisci. Verificare che la distribuzione riesca.

Esempio

Per modificare il valore dell'elemento ProprietaryDocumentIdentifier nello schema PIP 0C1, aggiungere la query XPath mostrata nella sezione di codice seguente alla proprietà della query XPath di Message Editor Pipeline Component.

/*[local-name()='Pip0C1AsynchronousTestNotification' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='thisDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='ProprietaryDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']  

Per ottenere una query XPath completa, aprire lo schema nell'Editor BizTalk e quindi copiare Xpath dalla proprietà Instance XPath nella finestra Proprietà. La query XPath fornita deve contenere tutti i riferimenti allo spazio dei nomi.

Vedere anche

Utilità