Condividi tramite

Come utilizzare le proprietà del contesto del messaggio

  • Articolo

Le proprietà del sistema vengono per lo più utilizzate internamente dal motore di messaggistica BizTalk e dai relativi componenti. In generale, non è consigliabile modificare i valori impostati dal motore per queste proprietà perché potrebbe compromettere la logica di esecuzione del motore. È tuttavia possibile modificare un numero elevato di proprietà.

Nella tabella seguente è incluso un elenco delle proprietà del contesto del messaggio che possono essere innalzate di livello dal motore di messaggistica. È possibile usare queste proprietà per la creazione di espressioni di filtro nelle porte di trasmissione e nelle orchestrazioni in Microsoft BizTalk Server. Ad esempio,

PortName = MyMessage(BTS.ReceivePortName);  
MyFileName = MyMessage(FILE.ReceivedFileName);  
MySubject= MyMessage(POP3.Subject);

In una tabella separata vengono elencate altre proprietà che possono essere utili in alcune applicazioni BizTalk e che non possono essere innalzate di livello.

Proprietà Quando e dove viene innalzata di livello Tipo Descrizione
BTS.AckFailureCategory Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:int Identifica ErrorCategory, che fornisce la posizione e il motivo della sospensione.
BTS.AckFailureCode Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica ErrorCode, che fornisce la posizione e il motivo della sospensione.
BTS.AckID Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica l'ID messaggio del messaggio originale.
BTS.AckInboundTransportLocation Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica InboundTransportLocation dal messaggio originale.
BTS.AckOutboundTransportLocation Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica OutboundTransportLocation dal messaggio originale.
BTS.AckOwnerID Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica l'ID di istanza del messaggio originale.
BTS.AckReceivePortID Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica ReceivePortID dal messaggio originale.
BTS.AckReceivePortName Innalzata di livello dal motore di messaggistica per il messaggio di riconoscimento. xs:string Identifica ReceivePortName dal messaggio originale.
BTS.AckSendPortID Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica SendPortID dal messaggio originale.
BTS.AckSendPortName Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica SendPortName dal messaggio originale.
BTS.AckType Innalzata di livello dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Consente il monitoraggio di riconoscimenti e non riconoscimenti da un’orchestrazione. Il valore sarà ACK per un riconoscimento e NACK per un riconoscimento negativo.
BTS.ActionOnFailure Questa proprietà può essere impostata da un adapter prima di chiamare l’API IBTTTransportBatch::SubmitMessage() per l’invio del messaggio a BizTalk. xs:int Determina il comportamento del motore di messaggistica in caso di errore nella pipeline di ricezione. In genere il motore di messaggistica sospende i messaggi non riusciti, tuttavia alcuni adapter (HTTP) inviano al client un rapporto sull’errore anziché sospendere il messaggio in caso di errore nella pipeline di ricezione.

Valori validi:

-Predefinito. Se la proprietà non esiste, il motore di messaggistica proverà automaticamente a sospendere il messaggio.
- 0. Indica che il motore di messaggistica non sospenderà automaticamente il motore.

Altri valori sono riservati per utilizzi futuri.
BTS.CorrelationToken Se questa proprietà è impostata nel contesto del messaggio, verrà innalzata di livello dal motore di messaggistica. La proprietà è impostata in modo implicito in un contesto quando l'adapter richiesta-risposta o un'orchestrazione invia un messaggio di richiesta al database MessageBox. xs:string Attiva il routing di risposta sulle porte richiesta-risposta.
BTS.EpmRRCorrelationToken Innalzata di livello dal motore di messaggistica per l’esecuzione di messaggi di richiesta-risposta. La proprietà è innalzata di livello prima che i messaggi vengano inviati al database MessageBox. xs:int Utilizzata internamente dal motore di messaggistica. Specifica il nome del server, l’ID di processo e un GUID univoco per i flussi di richiesta risposta dei messaggi.
BTS.InboundTransportLocation Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio da un adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:string Specifica l’indirizzo (URI) su cui il messaggio è stato ricevuto dal gestore.
BTS.InboundTransportType Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio da un adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:string Specifica il tipo di adattatore che ha ricevuto il messaggio e lo ha inviato nel server: FILE, HTTP e così via.
BTS.InterchangeSequenceNumber Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio dall’adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:int Indica il numero di sequenza del documento nell’interscambio. Se il documento non fa parte di un interscambio disassemblato in singoli documenti, questo valore sarà 1. La proprietà può essere letta in un'orchestrazione, in una pipeline di trasmissione e in una scheda di trasmissione.
BTS.IsDynamicSend Questa proprietà può essere impostata nel contesto del messaggio. Non verrà innalzata di livello e verrà applicata esclusivamente alle operazioni di trasmissione. xs:boolean Viene scritta nel contesto del messaggio dal motore di messaggistica con un valore True se l'operazione di trasmissione avviante su una porta di trasmissione dinamica. Se si desidera impostare le proprietà dinamicamente per le porte di trasmissione statiche nelle pipeline di trasmissione, è necessario impostare il valore su True.
BTS.MessageDestination Questa proprietà può essere impostata nella pipeline di ricezione da un componente della pipeline del disassembler quando viene restituito un messaggio da GetNext(). xs:string Utilizzata principalmente per supportare l’elaborazione di interscambio reversibile nei disassembler, questa proprietà determina se un messaggio viene pubblicato nel MessageBox o viene sospeso nella coda degli elementi sospesi. Se una pipeline rileva un messaggio errato in un interscambio e si desidera sospendere il messaggio e continuare l’elaborazione, è possibile impostare MessageDestination = SuspendQueue così che venga restituito il messaggio quando il motore chiama GetNext() sul disassembler.

Valori validi:

-Predefinito. Se la proprietà non esiste, il messaggio è considerato valido e viene pubblicato nel MessageBox.
- SuspendQueue. Indica al motore di messaggistica di sospendere il messaggio. Nota: Il messaggio sospeso sarà il messaggio post-pipeline/mapping e non il messaggio inviato dall'adapter (ad esempio il messaggio di rete).
BTS.MessageType Innalzata di livello dai componenti della pipeline del disassembler durante l’analisi del messaggio. xs:string Specifica il tipo del messaggio. Il tipo di messaggio viene definito come concatenazione dello spazio dei nomi dello schema del documento e nodo radice del documento: http://<MyNamespace>#<MyRoot>.
BTS.OutboundTransportLocation Se questa proprietà è impostata nel contesto del messaggio, verrà innalzata di livello dal motore di messaggistica. La proprietà è impostata in modo implicito nel contesto di un messaggio quando un’orchestrazione invia un messaggio a una porta di trasmissione. La proprietà può anche essere impostata in modo esplicito in un’orchestrazione o in una pipeline. xs:string Specifica l'URI dell’indirizzo di destinazione a cui viene inviato il messaggio. L'URI può contenere il prefisso dell'adattatore, ad esempio http://. Il prefisso per l’adapter viene utilizzato dal motore di messaggistica per determinare il tipo di adapter da utilizzare per l’invio del messaggio. Se sia il prefisso dell'adattatore sia il BTS. La proprietà OutboundTransportType è impostata, il tipo di adattatore da BTS. OutboundTransportType ha sempre la precedenza sul tipo di adattatore determinato dal prefisso.

Valori validi:

Accodamento messaggi BizTalk: DIRECT=, PRIVATE=e PUBLIC=

FILE: file://

FTP: FTP://

HTTP: http:// e https://

SMTP : mailto:

SOAP: SOAP://

SQL: SQL://
BTS.OutboundTransportType Se questa proprietà è impostata nel contesto del messaggio, verrà innalzata di livello dal motore di messaggistica. La proprietà è impostata in modo implicito in un contesto quando un’orchestrazione invia un messaggio a una porta di trasmissione. La proprietà può anche essere impostata in modo esplicito in un’orchestrazione o in una pipeline. xs:string Specifica il tipo di adapter utilizzato per l’invio del messaggio. I tipi di adapter disponibili sono FILE, FTP, HTTP, SMTP, SOAP e SQL.

Per i valori impostati nella proprietà e i prefissi per l’adapter specificati nell’indirizzo non viene fatta distinzione tra maiuscole e minuscole.
BTS.PropertiesToUpdate Questa proprietà viene impostata da un adapter che ha la necessità di mantenere alcuni dei valori delle proprietà di un messaggio non riuscito che viene inviato nuovamente o viene sospeso.

Ciò significa che quando un messaggio viene inviato nuovamente o viene ripristinato, le proprietà specificate verranno impostate nel contesto del messaggio.		 xs:string Include una stringa XML con elementi che rappresentano nomi di proprietà, spazi di nomi e valori.
BTS.ReceivePortID Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio da un adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:int Identifica la porta di ricezione su cui è stato ricevuto il messaggio.
BTS.ReceivePortName Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio da un adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:string Nome descrittivo della porta di ricezione su cui è stato ricevuto il messaggio.
BTS.RouteDirectToTP Innalzata di livello dal motore di messaggistica per l’esecuzione di tipo loopback o richiesta-risposta dei messaggi. La proprietà è innalzata di livello prima che i messaggi vengano inviati al database MessageBox. xs:boolean Utilizzata internamente dal motore di messaggistica per l’attivazione di scenari di tipo loopback e richiesta-risposta.
BTS.SPGroupID Innalzata di livello dal motore di messaggistica quando il messaggio viene inviato a una porta di trasmissione da un’orchestrazione. xs:string Specifica l’ID del gruppo di porte di trasmissione.
BTS.SPID Innalzata di livello dal motore di messaggistica quando un messaggio viene inviato a una porta di trasmissione da un’orchestrazione. xs:string Specifica l’ID della porta di trasmissione.
BTS.SPName Alzata di livello dal motore di messaggistica quando viene pubblicato un messaggio di risposta da una porta di trasmissione di sollecitazione-risposta. xs:string Utilizzata per la sottoscrizione dei messaggi di risposta da una porta di trasmissione di sollecitazione-risposta. Il valore è il nome della porta di trasmissione.
BTS.SPTransportBackupID Innalzata di livello dal motore di messaggistica quando un messaggio viene inviato a una porta di trasmissione da un’orchestrazione. xs:string Specifica l’ID dell’adapter di backup nella porta di trasmissione.
BTS.SPTransportID Innalzata di livello dal motore di messaggistica quando un messaggio viene inviato a una porta di trasmissione da un’orchestrazione. xs:string Specifica l’ID dell’adapter principale nella porta di trasmissione.
BTS.SuspendAsNonResumable Questa proprietà può essere impostata da un adapter prima della chiamata di SubmitMessage() o in un’orchestrazione prima dell’invio di un messaggio a una porta di trasmissione. Nota: SubmitRequestMessage() ignorerà questa proprietà; i messaggi bidirezionali vengono sempre sospesi come non ripristinabili. xs:boolean Determina se il motore di messaggistica sospenderà i messaggi come non ripristinabili in caso di errore. Benché i messaggi vengano in genere sospesi come ripristinabili, esistono casi in cui questa soluzione non è appropriata. Se ad esempio si ripristina un messaggio per una porta di trasmissione o ricezione ordinata, verrà alterato l’ordine dei messaggi.

Valori validi:

-False. Il messaggio viene sospeso come ripristinabile (valore predefinito).
-Vero. Il messaggio viene sospeso come non ripristinabile.
BTS.SuspendMessageOnRoutingFailure Innalzata di livello dal motore di messaggistica dopo la ricezione di un messaggio da un adapter di ricezione e prima della relativa pubblicazione nel database MessageBox. xs:boolean Specifica il comportamento quando si verifica un errore di routing con un messaggio in ingresso.

Valori validi:

- Impostazione predefinita/False. Se la proprietà non esiste o è impostata su False, il motore notifica all’adapter l’errore di routing nel momento in cui si verifica.
-Vero. Il motore di routing sospenderà automaticamente il messaggio quando si verifica un errore di routing. Nota: Il messaggio sospeso sarà il messaggio post-pipeline/mapping e non il messaggio inviato dall'adapter (ad esempio il messaggio di rete).

Sono disponibili molte altre proprietà in questo spazio dei nomi che includono informazioni che potrebbero essere utili per alcune applicazioni BizTalk.

Proprietà Quando e dove viene innalzata di livello Tipo Descrizione
BTS.AckDescription Impostata dal motore di messaggistica prima della pubblicazione di un messaggio di riconoscimento nel database MessageBox. xs:string Identifica l'erroreDescription, che fornisce il luogo e il motivo della sospensione.
BTS.EncryptionCert Non può essere innalzata di livello. xs:int Indica l'identificazione corrispondente al certificato di crittografia. Impostare questa proprietà in un’orchestrazione o in un componente personalizzato della pipeline posizionato prima del componente della pipeline del codificatore MIME/SMIME per eseguire la crittografia di risposta su una porta di richiesta-risposta che riceve messaggi firmati e crittografati.
BTS.InterchangeID Impostata dal motore di messaggistica per ogni messaggio in arrivo sul server. xs:string Definisce l’ID univoco utilizzato per raggruppare i documenti ottenuti dallo stesso messaggio di interscambio.
BTS.Loopback Impostata da un adapter all’invio del messaggio di richiesta per un’esecuzione di tipo loopback. xs:boolean Definisce se il messaggio verrà inviato al server per un’esecuzione di tipo loopback. Nell’esecuzione di tipo loopback il messaggio di richiesta viene pubblicato nel database MessageBox dove viene direttamente instradato all’adapter di ricezione come risposta.
BTS.SignatureCertificate Impostata da alcuni adapter all’invio di un messaggio al server. Questa proprietà viene utilizzata dal componente della pipeline di risoluzione entità. xs:string Indica l’identificazione del certificato di firma utilizzato per firmare il messaggio ricevuto da BizTalk Server.
BTS.SourcePartyID Impostata dal componente della pipeline di risoluzione entità dopo che è stata identificata l’entità per il messaggio in ingresso. xs:string ID dell’entità BizTalk.
BTS.SSOTicket Se è supportata dall’adapter di ricezione, questa proprietà viene impostata alla pubblicazione del messaggio in un server. xs:string Ticket contenente il dominio e il nome utente corrente crittografati, nonché la data di scadenza del ticket. Il ticket viene utilizzato dagli adapter attivati per SSO al fine di ottenere le credenziali dell’utente per l’autenticazione con gli endpoint di destinazione.
BTS.WindowsUser Impostata da alcuni adapter all’invio di un messaggio al server. Questa proprietà viene utilizzata dal componente della pipeline di risoluzione entità. xs:string Specifica l’account di un utente per conto del quale il messaggio viene inviato al server.

Per ulteriori informazioni su proprietà e schemi di proprietà associati ad adapter e componenti di pipeline, vedere gli argomenti seguenti:

Vedere anche

Informazioni sulle proprietà di contesto di messaggi BizTalk
Come utilizzare espressioni per assegnare valori a porte dinamiche