Come usare le proprietà del contesto del messaggio

Le proprietà di sistema vengono usate internamente dal motore di messaggistica BizTalk e dai relativi componenti. In generale, la modifica dei valori impostati dal motore per tali proprietà non è consigliata, perché può influire sulla logica di esecuzione del motore. Tuttavia, è possibile modificare un numero elevato di proprietà.

La tabella seguente contiene un elenco di proprietà del contesto del messaggio che il motore di messaggistica può alzare di livello. È possibile usare queste proprietà per la creazione di espressioni di filtro su porte di trasmissione e orchestrazioni in Microsoft BizTalk Server. Ad esempio:

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

In una tabella separata sono elencate proprietà aggiuntive che possono essere usate in alcune applicazioni BizTalk che non possono essere alzate di livello.

Proprietà	Quando e dove viene promosso	TIPO	Descrizione
BTS. AckFailureCategory	Promosso dal motore di messaggistica prima di pubblicare un messaggio di riconoscimento nel database MessageBox.	xs:int	Identifica ErrorCategory, che fornisce la posizione e il motivo della sospensione.
BTS.AckFailureCode	Promosso dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica ErrorCode, che fornisce la posizione e il motivo della sospensione.
BTS.AckID	Eseguito dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica l'ID messaggio del messaggio originale.
BTS. AckInboundTransportLocation	Promosso dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica InboundTransportLocation dal messaggio originale.
BTS. AckOutboundTransportLocation	Promosso dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica OutboundTransportLocation dal messaggio originale.
BTS.AckOwnerID	Promosso dal motore di messaggistica prima della pubblicazione di un messaggio di conferma nel database MessageBox.	xs:string	Identifica l'ID istanza del messaggio originale.
BTS.AckReceivePortID	Promosso dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica ReceivePortID dal messaggio originale.
BTS. AckReceivePortName	Alzata di livello dal motore di messaggistica per il messaggio di riconoscimento.	xs:string	Identifica ReceivePortName dal messaggio originale.
BTS.AckSendPortID	Promosso dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica SendPortID dal messaggio originale.
BTS.AckSendPortName	Innescato dal motore di messaggistica prima di pubblicare un messaggio di conferma nel database MessageBox.	xs:string	Identifica SendPortName dal messaggio originale.
BTS.AckType	Promosso dal Motore di Messaggistica prima di pubblicare un messaggio di riconoscimento nel database MessageBox.	xs:string	Consente il monitoraggio dei riconoscimenti e dei mancati riconoscimenti da parte di un'orchestrazione. Il valore sarà ACK per un riconoscimento e NACK per un riconoscimento negativo.
BTS.ActionOnFailure	Questa proprietà può essere impostata da un adattatore prima di chiamare l'API IBTTTransportBatch::SubmitMessage() per inviare il messaggio a BizTalk.	xs:int	Controlla il comportamento del motore di messaggistica quando si verifica un errore nella pipeline di ricezione. In genere il motore di messaggistica sospende i messaggi non riusciti; Tuttavia, alcuni adattatori (ad esempio HTTP) segnalano l'errore al client invece di sospendere il messaggio in caso di errore della pipeline di ricezione. Valori validi: - Predefinito. Se la proprietà non esiste, il motore di messaggistica tenterà automaticamente di sospendere il messaggio. - 0. Indica che il motore di messaggistica non deve sospendere automaticamente il motore. Altri valori sono riservati per un uso futuro.
BTS. CorrelationToken	Se questa proprietà è impostata nel contesto del messaggio, viene alzata di livello dal motore di messaggistica. Questa proprietà viene impostata in modo implicito in un contesto quando un adattatore request-response o un'orchestrazione invia un messaggio di richiesta nel database MessageBox.	xs:string	Abilita il routing della risposta alle porte request-response.
BTS. EpmRRCorrelationToken	Alzata di livello dal motore di messaggistica nell'esecuzione dei messaggi di richiesta-risposta. La proprietà viene assegnata prima che i messaggi vengano inviati nella database MessageBox.	xs:int	Utilizzato internamente dal motore di messaggistica. Specifica il nome del server, l'ID processo e un GUID univoco per un flusso di messaggi di risposta alla richiesta.
BTS.InboundTransportLocation	Alzata di livello dal motore di messaggistica dopo aver ricevuto un messaggio da un adattatore di ricezione e prima di pubblicarla nel database MessageBox.	xs:string	Specifica il percorso (URI) in cui il messaggio è stato ricevuto dal gestore.
BTS. InboundTransportType	Alzata di livello dal motore di messaggistica dopo aver ricevuto un messaggio da un adattatore di ricezione e prima di pubblicarla 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	Promosso dal motore di messaggistica dopo aver ricevuto un messaggio dall'adattatore di ricezione e prima di pubblicarlo 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 un adattatore di trasmissione.
BTS.IsDynamicSend	Questa proprietà può essere impostata nel contesto del messaggio. Non verrà alzata di livello e viene applicata solo alle operazioni di invio.	xs:boolean	Viene scritto nel contesto del messaggio dal motore di messaggistica con un valore true quando l'operazione di invio si trova su una porta di trasmissione dinamica. Se si desidera impostare in modo dinamico le proprietà per le porte di trasmissione statiche nelle pipeline di trasmissione, sarà necessario impostare questo valore su true.
BTS. MessageDestination	Questa proprietà può essere impostata nella pipeline di ricezione da un componente della pipeline del disassembler quando restituisce un messaggio da GetNext().	xs:string	Utilizzata principalmente per supportare l'elaborazione dell'interscambio ripristinabile nei disassembler, questa proprietà controlla se un messaggio viene pubblicato nella finestra di messaggio o viene sospeso nella coda di sospensione. Se una pipeline rileva un messaggio non valido in un interscambio e vuole sospendere il messaggio e continuare l'elaborazione, può farlo impostando MessageDestination = SuspendQueue e restituire il messaggio quando il motore chiama GetNext() sul disassembler. Valori validi: - Predefinito. Se la proprietà non esiste, si presuppone che il messaggio sia valido e venga pubblicato nella finestra di messaggio. - 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'adattatore (ad esempio il messaggio di trasmissione).
BTS.MessageType	Promosso dai componenti della pipeline del disassembler durante il parsing dei messaggi.	xs:string	Specifica il tipo del messaggio. Il tipo di messaggio viene definito come la concatenazione del namespace dello schema del documento e del nodo radice del documento: http://<MyNamespace>#<MyRoot>.
BTS. OutboundTransportLocation	Se questa proprietà è impostata nel contesto del messaggio, viene alzata di livello dal motore di messaggistica. Questa proprietà viene impostata in modo implicito in un contesto di messaggio quando un'orchestrazione invia un messaggio a una porta di trasmissione. Anche questa proprietà può essere impostata in modo esplicito in un'orchestrazione o in una pipeline.	xs:string	Specifica l'URI della posizione di destinazione in cui viene inviato il messaggio. L'URI può contenere il prefisso dell'adattatore, ad esempio http://. Il prefisso dell'adattatore viene utilizzato dal motore di messaggistica per determinare il tipo di adattatore da utilizzare durante l'invio del messaggio. Se sia il prefisso dell'adattatore che la proprietà BTS.OutboundTransportType sono impostati, il tipo di adattatore di 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, viene alzata di livello dal motore di messaggistica. Questa proprietà viene impostata in modo implicito in un contesto quando un'orchestrazione invia un messaggio a una porta di trasmissione. Questa proprietà può anche essere impostata in modo esplicito in un'orchestrazione o in una pipeline.	xs:string	Specifica il tipo di adattatore utilizzato per inviare il messaggio. I tipi di adattatori disponibili sono FILE, FTP, HTTP, SMTP, SOAP e SQL. I valori impostati su questa proprietà, nonché i prefissi dell'adattatore specificati nell'indirizzo non fanno distinzione tra maiuscole e minuscole.
BTS.PropertiesToUpdate	Un adattatore imposta questa proprietà quando deve mantenere alcuni dei valori delle proprietà in un messaggio non riuscito che viene inviato di nuovo o sospeso. Ciò significa che quando il messaggio viene nuovamente inviato o ripreso, le proprietà specificate verranno impostate nel contesto.	xs:string	Contiene una stringa XML con elementi che rappresentano nomi di proprietà, spazi dei nomi e valori.
BTS.ReceivePortID	Alzata di livello dal motore di messaggistica dopo aver ricevuto un messaggio da un adattatore di ricezione e prima di pubblicarla nel database MessageBox.	xs:int	Identifica la porta di ricezione in cui è stato ricevuto il messaggio.
BTS.ReceivePortName	Alzata di livello dal motore di messaggistica dopo aver ricevuto un messaggio da un adattatore di ricezione e prima di pubblicarla nel database MessageBox.	xs:string	Nome descrittivo della porta di ricezione in cui è stato ricevuto il messaggio.
BTS. RouteDirectToTP	Promosso dal motore di messaggistica nei messaggi per l'esecuzione del ciclo indietro o di richiesta-risposta. La proprietà viene assegnata prima che i messaggi vengano inviati nella database MessageBox.	xs:boolean	Usato internamente dal motore di messaggistica per abilitare scenari di loopback e request-response.
BTS.SPGroupID	Alzata di livello dal motore di messaggistica quando il messaggio viene inviato a una porta di trasmissione dall'orchestrazione.	xs:string	Specifica l'ID del gruppo di porte di trasmissione.
BTS. SPID	Alzata di livello dal motore di messaggistica quando un messaggio viene inviato a una porta di trasmissione dall'orchestrazione.	xs:string	Specifica l'ID della porta di trasmissione.
BTS.SPName	Promosso dal motore di messaggistica quando si pubblica un messaggio di risposta da una porta di invio Solicit-Response.	xs:string	Usato per sottoscrivere i messaggi di risposta da una porta di invio Solicit-Response. Il valore è il nome della porta di trasmissione.
BTS. SPTransportBackupID	Alzata 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'adattatore di backup nella porta di trasmissione.
BTS. SPTransportID	Alzata 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 scheda primaria nella porta di trasmissione.
BTS.SuspendAsNonResumable	Questa proprietà può essere impostata da un adattatore prima di chiamare SubmitMessage() o in un'orchestrazione prima di inviare un messaggio a una porta di trasmissione. Nota: SubmitRequestMessage() ignorerà questa proprietà; i messaggi bidirezionali vengono sempre sospesi come non ripristinabili.	xs:boolean	Controlla se il motore di messaggi deve sospendere un messaggio come non ripristinabile in caso di errore del messaggio. In genere, i messaggi vengono sospesi come ripristinabili, ma esistono casi in cui ciò non è appropriato, ad esempio riprendere un messaggio per una porta di invio o ricezione ordinata interromperebbe l'ordine dei messaggi. Valori validi: -Falso. Il messaggio viene sospeso come ripristinabile (impostazione predefinita). -Vero. Il messaggio viene sospeso come non ripristinabile.
BTS.SuspendMessageOnRoutingFailure	Alzata di livello dal motore di messaggistica dopo aver ricevuto un messaggio da un adattatore di ricezione e prima di pubblicarla nel database MessageBox.	xs:boolean	Specifica il comportamento quando si verifica un errore di routing con un messaggio in arrivo. Valori validi: - Impostazione predefinita/ False. Se la proprietà non esiste o è impostata su False, il motore invia una notifica all'adattatore dell'errore quando si verifica un errore di routing. -Vero. Il motore di routing sospende automaticamente il messaggio quando si verifica un errore di routing. Nota: Il messaggio sospeso sarà il messaggio successivo alla pipeline/mappatura e non il messaggio inviato dall'adattatore (ad esempio il messaggio in formato wire).

Esistono diverse altre proprietà in questo spazio dei nomi che contengono informazioni che possono essere utili per alcune applicazioni BizTalk.

Proprietà	Quando e dove viene promosso	TIPO	Descrizione
BTS.AckDescrizione	Impostato dal motore di messaggistica prima di pubblicare un messaggio di acknowledgement nel database MessageBox.	xs:string	Identifica errorDescription, che fornisce la posizione e il motivo della sospensione.
BTS. EncryptionCert	Non promuovibile.	xs:int	Identifica l'impronta digitale corrispondente al certificato di crittografia. Impostare questa proprietà in un componente di orchestrazione o di pipeline personalizzata posizionato prima del componente della pipeline MIME/SMIME Encoder per eseguire la crittografia delle risposte su una porta richieste-risposte che riceve un messaggio firmato e crittografato.
BTS. InterchangeID	Impostato dal motore di messaggistica per ogni messaggio che arriva sul server.	xs:string	Definisce l'ID univoco utilizzato per raggruppare i documenti risultanti dallo stesso messaggio di interscambio.
BTS. Loopback	Impostato da un adattatore quando si invia il messaggio di richiesta per l'esecuzione loopback.	xs:boolean	Definisce se il messaggio deve essere inviato nel server per un'esecuzione loopback. Nell'esecuzione loopback, il messaggio di richiesta viene pubblicato nel database MessageBox in cui viene indirizzato direttamente all'adapter di ricezione come risposta.
BTS. CertificatoFirma	Impostato da alcuni adattatori durante l'invio di un messaggio nel server. Questa proprietà viene utilizzata dal componente della pipeline di risoluzione delle parti.	xs:string	Identifica l'impronta digitale del certificato di firma utilizzato per firmare il messaggio ricevuto da BizTalk Server.
BTS. SourcePartyID	Impostato dal componente della pipeline di risoluzione delle parti dopo che la parte è stata identificata per il messaggio in arrivo.	xs:string	ID dell'entità BizTalk.
BTS. SSOTicket	Se l'adattatore di ricezione supporta questa proprietà, viene impostato quando si pubblica il messaggio in un server.	xs:string	Un ticket contiene il dominio crittografato e il nome utente dell'utente corrente, nonché l'ora di scadenza del ticket. Il ticket viene utilizzato dagli adattatori abilitati per il Single Sign-On per ottenere le credenziali dell'utente durante l'autenticazione con gli endpoint di destinazione.
BTS.WindowsUser	Impostato da alcuni adattatori durante l'invio di un messaggio nel server. Questa proprietà viene utilizzata dal componente della pipeline Risoluzione Partecipanti.	xs:string	Specifica l'account di un utente per conto del quale il messaggio viene inviato nel server.

Per altre informazioni sulle proprietà e sugli schemi delle proprietà associati ai componenti e agli adattatori della pipeline, vedere quanto segue:

• Proprietà e schema delle proprietà dell'adattatore file

• Proprietà e schema delle proprietà dell'adapter FTP

• Proprietà e schema delle proprietà dell'adapter HTTP

• Proprietà e schema delle proprietà dell'adapter MSMQ

• Schema e proprietà delle proprietà dell'adapter SMTP

• Proprietà e schema delle proprietà dell'adapter SOAP

• Schema e proprietà di BizTalk Framework

• Proprietà dell'adapter MQSeries

• Proprietà e schema delle proprietà dell'adapter POP3

• Informazioni di riferimento sulle proprietà dell'adapter Windows SharePoint Services

• Proprietà e schema delle proprietà MIME/SMIME

• Schema e proprietà delle proprietà XML e dei file di testo

Vedere anche

Informazioni sulle proprietà del contesto del messaggio BizTalk
Come usare espressioni per assegnare valori a porte dinamiche