Come distribuire le pipeline

Le pipeline vengono compilate e distribuite come parte del processo di compilazione e distribuzione della soluzione. Il compilatore chiama il metodo Validate su ogni componente, consentendo ai componenti di restituire errori di compilazione sulle informazioni configurate. Dopo la compilazione, la pipeline viene distribuita nello stesso assembly con il resto della soluzione quando la soluzione viene distribuita.

Configurazione della pipeline per singola istanza

La configurazione della pipeline per istanza viene usata per modificare le proprietà dei componenti della pipeline all'interno di una pipeline distribuita a livello di porta di trasmissione o di ricezione. La configurazione della pipeline per istanza è utile quando è necessario modificare solo alcune proprietà del componente della pipeline per ogni istanza. Ad esempio, se è necessario supportare tipi di messaggi diversi in più posizioni di ricezione e avere una singola pipeline di ricezione XML personalizzata, la configurazione della pipeline per istanza consente di distribuire la pipeline ed eseguire l'override della configurazione predefinita , inclusa la specifica di nomi di busta e specifiche di documento diversi. Questo meccanismo è supportato nella console di gestione BizTalk e a livello di codice tramite il modello a oggetti di Explorer.

Per-Instance configurazione della pipeline tramite la console di amministrazione bizTalk

È possibile eseguire la configurazione della pipeline per istanza usando la console di gestione BizTalk. Dopo aver distribuito la pipeline personalizzata, creare tutte le posizioni di ricezione o le porte di trasmissione necessarie. Quindi, per ogni posizione di ricezione o porta di trasmissione, eseguire l'override dei valori predefiniti delle proprietà tramite la finestra di dialogo Configura pipeline. Ad esempio, per specificare uno schema di documento diverso, immettere un nome di schema per la proprietà EnvelopeDocSpecNames .

Avvertimento

Non verrà eseguita alcuna convalida dei valori di configurazione specificati nel percorso di ricezione o nella porta di trasmissione. Se la configurazione non è corretta, i messaggi avranno esito negativo in fase di esecuzione durante il passaggio della pipeline.

Per-Instance configurazione della pipeline usando il modello a oggetti di Explorer

Quando il file XML che descrive la configurazione per istanza dei componenti della pipeline viene letto, esegue l'override delle proprietà impostate nel file della pipeline.

La configurazione della pipeline per istanza viene impostata usando il modello a oggetti di BizTalk Explorer. Il modello a oggetti di BizTalk Explorer fornisce la proprietà ReceivePipelineData nelle interfacce IReceiveLocation e ISendPort per impostare la configurazione dei componenti della pipeline di ricezione. Il modello a oggetti di BizTalk Explorer fornisce anche il metodo SendPipelineData nelle interfacce IReceivePort e ISendPort per impostare la configurazione dei componenti della pipeline di trasmissione.

La configurazione della pipeline per istanza non supporta quanto segue:

• Riorganizzare le fasi all'interno della pipeline

• Aggiunta o rimozione di fasi

• Ridisporre i componenti all'interno delle fasi

• Aggiunta o rimozione di componenti

  Le uniche modifiche supportate sono nella configurazione dei componenti della pipeline. La configurazione per istanza di un componente della pipeline prevale sulla configurazione comune del componente. Se non viene specificato un parametro di un componente nella configurazione della pipeline per istanza, viene usata la configurazione comune per tale parametro (come configurato in Progettazione pipeline).

  Di seguito è riportato un esempio di dati di configurazione per istanza.

<?xml version="1.0" encoding="utf-16"?>  
<Root xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
    <Stages>  
        <Stage CategoryId="9d0e4103-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft Microsoft.BizTalk.Component.MIME_SMIME_Decoder>  
                    <Properties>  
                        <AllowNonMIMEMessage vt=11>true</AllowNonMIMEMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e4105-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft.BizTalk.Component.XmlDasmComp>  
                    <Properties>  
                        <EnvelopeSpecNames vt=8>MySchemas.EnvelopeSpecNames</EnvelopeSpecNames>  
                        <AllowUnrecognizedMessage vt=11>false</AllowUnrecognizedMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e410d-4cce-4536-83fa-4a5040674ad6" ExecutionSequence="2">  
            <Components>  
                 <Component Name=Microsoft.BizTalk.Component.XmlValidator >  
                    <Properties>  
                        <DocumentSpecName vt=8>MySchemas.DocspecName</DocumentSpecName>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
    </Stages>  
</Root>  

Vedere anche

Sviluppo di componenti della pipeline personalizzati