Condividi tramite

Come usare tipi di messaggi a più parti

  • Articolo

Ogni messaggio ha un tipo di messaggio multiparte, una descrizione della struttura dei messaggi composta da zero o più parti di messaggio. Le parti sono definite da schemi di linguaggio di definizione dello schema XML (XSD- XML Schema Definition) o da classi .NET. È possibile definire tipi di messaggi multiparte personalizzati oppure utilizzare schemi e classi .NET esistenti.

È possibile accedere o assegnare parti di messaggio direttamente nell'ambito dell'orchestrazione oppure utilizzare singoli elementi di parti di messaggio esposti come campi distinti o campi proprietà. Per altre informazioni, vedere Uso di campi distinti e proprietà del messaggio.

Nota

Un messaggio multiparte non contiene necessariamente più parti.

Nota

Una parte del messaggio può essere definita dal tipo .NET XmlDocument, che può essere usato per contenere un documento XML arbitrario, da qualsiasi tipo .NET serializzabile xml o da qualsiasi tipo .NET che supporta la serializzazione personalizzata.

Aggiungere un tipo di messaggio a più parti

  1. Nella finestra Visualizzazione orchestrazione espandere il nodo Tipi .

  2. Fare clic con il pulsante destro del mouse su Tipi di messaggio a più parti e quindi scegliere Nuovo tipo di messaggio a più parti.

    La cartella Tipi di messaggi a più parti si espande, se compressa e viene aggiunto un nuovo tipo di messaggio a più parti con una parte messaggio predefinita.

  3. Assegnare un nome al tipo di messaggio multiparte e alla parte di messaggio fornita.

    Se il tipo di messaggio a più parti richiede più di una parte del messaggio, è possibile aggiungere altre parti assegnando un nome alla <parte Nuovo> messaggio.

  4. Associare ogni parte di messaggio a un tipo, ad esempio uno schema o una classe .NET.

Rimuovere un tipo di messaggio a più parti

  • Nella finestra Visualizzazione orchestrazione fare clic con il pulsante destro del mouse sul tipo di messaggio a più parti da rimuovere e quindi scegliere Elimina.

    Nota

    Rimuovendo un tipo di messaggio multiparte dall'orchestrazione verranno anche rimosse le informazioni relative al tipo dai messaggi che le utilizzano.

    Nota

    Gli elementi che compaiono in sola lettura sono definiti in un'altra orchestrazione.

Rimuovere una parte da un tipo di messaggio a più parti

  • Nella finestra Visualizzazione orchestrazione fare clic con il pulsante destro del mouse sulla parte da rimuovere e scegliere Elimina.

    Nota

    Non è possibile eliminare la parte del messaggio di un tipo di messaggio se la proprietà Message Body Part è impostata su true. È prima necessario impostare la proprietà Message Body Part su True per un'altra delle parti del tipo di messaggio.

Impostare il modificatore di tipo per un tipo di messaggio a più parti

  • Nella finestra Proprietà impostare la proprietà seguente:

    Proprietà Descrizione
    Modificatore tipo Consente di determinare l'ambito del tipo di messaggio multiparte:

    - Privato:L'accesso a questo tipo di messaggio a più parti è limitato al modulo contenente.
    - Pubblico:L'accesso a questo tipo di messaggio a più parti non è limitato.
    - Interno:L'accesso a questo tipo di messaggio a più parti è limitato ai moduli all'interno dello stesso progetto.

Aggiungere parti a un messaggio multi-part esistente

  • BizTalk Server offre la possibilità di aggiungere parti a un messaggio XLANG a più parti e di fare riferimento a una parte del messaggio in base a un indice maggiore del numero originariamente dichiarato di parti se la parte esiste. Questa funzionalità può risultare utile per la trasmissione o la ricezione di messaggi SMTP con un numero variabile di allegati. Questa funzionalità viene implementata come segue:

  • Dal progetto aggiungere un riferimento a Microsoft.XLANGs.BaseTypes.

  • Creare una variabile (ad esempio xlangPart) di tipo Microsoft.XLANGs.BaseTypes.XLANGMessage.

  • Chiamare xlangPart. AddPart (...) usando gli argomenti appropriati da una forma Expression.

    Nota

    Le parti aggiunte sono di tipo XmlDocument in modo che non sia possibile aggiungere una parte di messaggio formattata personalizzata usando il metodo AddPart().

Nota

Se viene ricevuto un messaggio a più parti che contiene maggiore del numero di parti dichiarate, il motore di orchestrazione legge il numero di parti presenti nel messaggio, quindi costruisce i tipi di parte appropriati per le parti corrispondenti al numero di parti nel tipo di messaggio dichiarato e quindi costruisce parti XmlDocument per le parti rimanenti.

Vedere anche

Metodo IBaseMessage.AddPart (COM) nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori
Risorse XSD sul Web
Uso di campi differenzianti e di campi di proprietà
Uso di messaggi nelle orchestrazioni