Proprietà di contesto EDI
Le proprietà del contesto del messaggio contenute nello schema proprietà globali EDI vengono esposte pubblicamente, pertanto essere utilizzate in operazioni quali il routing dei messaggi. Queste proprietà del contesto sono definite in PropertySchema.xsd nell'assembly Microsoft.BizTalk.Edi.BaseArtifacts. Lo spazio dei nomi per le proprietà è http://schemas.microsoft.com/ Edi/PropertySchema. Se vengono promossi, queste proprietà del contesto di messaggio sono disponibili come Edi.<Nome> proprietà nella pagina Filtri della finestra di dialogo Proprietà porta di invio nella guida dell'interfaccia utente e informazioni di riferimento sullo spazio dei nomi api per sviluppatori.
Elenco delle proprietà di contesto
Le proprietà del contesto EDI sono disponibili anche in un'orchestrazione, purché sia stato aggiunto un riferimento all'assembly Microsoft.BizTalk.Edi.BaseArtifacts al progetto di orchestrazione.
| Nome | Tipo | Descrizione |
|---|---|---|
| AK901 | string | Indica se il gruppo funzionale identificato nel segmento AK1 del riconoscimento è stato accettato o rifiutato (solo ACK 997 X12). |
| AttachmentId | string | ID dell'allegato del messaggio. |
| AgreementID | Int | Viene scritta dalla pipeline di ricezione EDI. Specifica l'ID dell'accordo in cui viene risolto il messaggio in ingresso. Per un accordo di fallback questo valore è 0. |
| AgreementName | string | Viene scritta dalla pipeline di ricezione EDI. Specifica il nome dell'accordo in cui viene risolto il messaggio in ingresso. Per un contratto di fallback questo valore è BTSGuestParty. |
| AgreementNameForSend | string | Viene utilizzata dalla pipeline di trasmissione EDI per la risoluzione dell'accordo per il documento in uscita. |
| AgreementPartIDForSend | Int | Viene utilizzata dalla pipeline di trasmissione EDI per la risoluzione dell'accordo per il documento in uscita. Questo valore viene registrato dall'orchestrazione batch. |
| AgreementPartIDOnReceive | Int | Viene scritta dalla pipeline di ricezione EDI. Specifica l'ID dell'accordo unidirezionale in cui viene risolto il messaggio in ingresso. Per un accordo di fallback questo valore è 0. |
| BatchElementValidationFailure | boolean | Indica che il sistema di elaborazione dei batch ha generato un errore quando un elemento batch non ha superato la convalida. |
| BatchEncodingType | string | Tipo di codifica che è necessario utilizzare per codificare un interscambio batch in uscita. |
| BatchId | Int | ID batch della configurazione batch da utilizzare per l'elaborazione del documento, se quest'ultimo corrisponde solo a un filtro batch. |
| BatchIds | string | Elenco degli ID batch dei set di filtri batch corrispondenti, se il documento corrisponde a più di un filtro batch. |
| BatchingError | string | Descrizione dell'errore generato dal sistema di elaborazione dei batch quando un elemento batch viene sospeso. |
| BatchName | string | Nome della configurazione batch da utilizzare per l'elaborazione del documento. |
| CodePage | string | Tabella codici da utilizzare per convalidare l'interscambio. |
| CONTRL_UCI4 | string | Campo del codice di azione di un riconoscimento CONTRL, indicante se l'interscambio è stato accettato (valore "8") o rifiutato a causa di un errore nel segmento UNA o UNB (valore "4") (solo ACK CONTRL EDIFACT). |
| DestinationPartyID (deprecato in BizTalk Server) | INT | ID dell'entità di destinazione a cui deve essere inviato il messaggio. |
| DestinationPartyName (deprecato in BizTalk Server) | string | Nome dell'entità di destinazione a cui deve essere inviato il messaggio. |
| DestinationPartyReceiver Identificatore |
string | Identificatore dell'entità di destinazione a cui deve essere inviato il messaggio. Questa proprietà può essere alzata di livello in un componente personalizzato per consentire la risoluzione dell'entità nella pipeline di trasmissione. |
| DestinationPartyReceiver Qualifier |
string | Qualificatore dell'entità di destinazione a cui deve essere inviato il messaggio. Questa proprietà può essere alzata di livello in un componente personalizzato per consentire la risoluzione dell'entità nella pipeline di trasmissione. |
| DestinationPartySender Identificatore |
string | Identificatore dell'entità che invia il messaggio all'entità di destinazione. Questa proprietà può essere alzata di livello in un componente personalizzato per consentire la risoluzione dell'entità nella pipeline di trasmissione. |
| DestinationPartySender Qualifier |
string | Qualificatore dell'entità che invia il messaggio all'entità di destinazione. Questa proprietà può essere alzata di livello in un componente personalizzato per consentire la risoluzione dell'entità nella pipeline di trasmissione. |
| EncodingType | short | Tipo di codifica che è necessario utilizzare per codificare un messaggio in uscita. |
| Descrizione dell'errore | string | Per un messaggio sospeso, contiene una copia del messaggio di errore, simile a quello visualizzato nel Visualizzatore eventi. |
| GS_Segment | string | Segmento GS (gruppo funzionale) completo (X12). La pipeline di ricezione EDI scrive questa proprietà nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. |
| GS01 | string | Codice identificatore funzionale (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| GS02 | string | Codice mittente applicazione (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| GS03 | string | Codice ricevitore applicazione (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| GS07 | string | Agenzia responsabile (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| GS08 | string | Codice identificatore di versione/rilascio/settore (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ISA_Segment | string | Segmento ISA (intestazione di controllo interscambio) completo (X12). Questa proprietà viene scritta nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. La proprietà contiene informazioni di sicurezza/autorizzazione (ISA2, informazioni di autorizzazione e ISA4, informazioni di sicurezza) che possono causare la divulgazione di informazioni. È possibile usare la proprietà Informazioni sulla sicurezza maschera/autorizzazione/password (nella pagina Convalida e generazione ACK ) per sostituire ogni carattere nei campi ISA2 e ISA4 con un carattere "#". Si tratta di un processo unidirezionale: i caratteri "#" non possono essere convertiti in caratteri effettivi. La pipeline di ricezione EDI scrive questa proprietà nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. |
| ISA05 | string | Qualificatore mittente interscambio (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ISA06 | string | ID mittente interscambio (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ISA07 | string | Qualificatore ricevitore interscambio (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ISA08 | string | ID ricevitore interscambio (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ISA15 | string | Indicatore di utilizzo (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| IsResendControlMessage | INT | Viene utilizzata dal motore AS2 per indicare che è necessario ritrasmettere l'invio di un messaggio AS2, in quanto non è stata ricevuta una risposta MDN nell'intervallo di tempo configurato. |
| IsSystemGeneratedACK | boolean | Indica che il messaggio è un riconoscimento (TA1 o 997 X12 oppure CONTRL EDIFACT) generato dal sistema. Può essere impostato su True o False. Si tratta di una proprietà di contesto del messaggio disponibile come EDI. IsSystemGeneratedACK nella pagina Filtri della finestra di dialogo Proprietà porta di trasmissione . |
| ReceiverPartyName | string | Viene scritta dalla pipeline di ricezione EDI. Specifica il nome del partner di destinazione fornito nell'accordo in cui viene risolto il messaggio. Per un contratto di fallback questo valore è RECEIVE-PARTNER. |
| ReceiverPartyNameForSend | string | Viene utilizzata dalla pipeline di trasmissione EDI per la risoluzione dell'accordo per i documenti in uscita. |
| ReuseEnvelope | boolean | Indica se un interscambio viene mantenuto o diviso. Se l'interscambio viene mantenuto, la busta verrà riutilizzata per l'elaborazione dell'interscambio per l'invio. |
| SenderPartyName | string | Viene scritta dalla pipeline di ricezione EDI. Specifica il nome del partner di origine fornito nell'accordo in cui viene risolto il messaggio in ingresso. Per un contratto di fallback questo valore sarà BTS-SENDER. |
| SenderPartyNameForSend | string | Viene utilizzata dalla pipeline di trasmissione EDI per la risoluzione dell'accordo per i documenti in uscita. |
| ST01 | string | Codice identificatore set transazioni (X12) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| ST03 | string | Codice identificatore di versione/rilascio/settore (X12) È possibile scrivere e alzare di livello questa proprietà nel contesto e utilizzarla per il routing dei messaggi. |
| TA1_TA104 | string | Campo relativo al comportamento del motore di un riconoscimento TA104, indicante se l'interscambio è stato accettato (valore "A"), accettato con errori (valore "E") o rifiutato/sospeso (valore "R") (solo ACK TA1 X12). |
| ToBeBatched | boolean | Indica se il messaggio deve essere incluso in batch con altri messaggi dall'orchestrazione batch. Dopo l'inclusione di un interscambio nel batch, l'orchestrazione batch imposta questa proprietà su "False". |
| ToBeRouted | boolean | Indica che il messaggio deve essere prelevato dall'orchestrazione di routing, che crea un numero di copie dell'elemento batch uguale al numero di sottoscrizioni dell'elemento disponibili e quindi le instrada al database MessageBox. |
| UNA_Segment | string | Segmento UNA (avviso stringa servizio) completo (EDIFACT) La pipeline di ricezione EDI scrive questa proprietà nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. |
| UNB_Segment | string | Segmento UNB (intestazione di controllo interscambio) completo (EDIFACT) La pipeline di ricezione EDI scrive questa proprietà nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. Questa proprietà contiene informazioni di sicurezza/autorizzazione (UNB6.1 e UNB6.2) che possono causare la divulgazione di informazioni. È possibile utilizzare la proprietà Maschera informazioni sicurezza/autorizzazione/password per sostituire i valori contenuti nei campi UNB6.1 e UNB6.2 con caratteri "#". Si noti che il carattere "#" non può essere convertito nei caratteri effettivi. |
| UNB11 | string | Indicatore di utilizzo (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNB2_1 | string | ID mittente interscambio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNB2_2 | string | Qualificatore codice mittente interscambio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNB2_3 | string | Indirizzo routing inverso (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNB3_1 | string | ID destinatario interscambio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNB3_2 | string | Qualificatore codice destinatario interscambio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNG_Segment | string | Segmento UNG (gruppo funzionale) completo (X12). La pipeline di ricezione EDI scrive questa proprietà nel contesto quando l'interscambio viene diviso in set di transazioni, non quando viene mantenuto. |
| UNG1 | string | Identificazione gruppo funzionale (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNG2_1 | string | Identificazione mittente applicazione (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNG3_1 | string | Identificazione destinatario applicazione (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNH2_1 | string | Tipo messaggio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNH2_2 | string | Numero versione messaggio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
| UNH2_3 | string | Numero rilascio messaggio (EDIFACT) La pipeline di ricezione EDI alza di livello questa proprietà nel contesto, se l'interscambio non è un interscambio batch da mantenere. |
Estrazione dei singoli campi dalle proprietà del contesto del segmento
Alcune proprietà non vengono scritte né alzate di livello nel contesto del messaggio dalle pipeline di ricezione EDI come singole proprietà, ma solo come parte di una stringa di segmento. Il motivo è che la promozione proprietà influisce sulle prestazioni. Ad esempio, i campi ISA5, ISA6, ISA7, ISA8 e ISA15 del segmento ISA vengono alzati di livello dalle pipeline di ricezione come singole proprietà, ma gli altri campi ISA vengono solo scritti nel contesto del messaggio come parte della proprietà ISA_Segment. Queste proprietà vengono scritte o promosse solo quandoRiusEnvelope non è impostato su True, indicando che non viene mantenuto un interscambio batch ricevuto.
Se è necessario che nel contesto del messaggio venga scritto un singolo campo di uno dei segmenti (ISA, GS, UNB, UNG o UNA), ma questa operazione non viene eseguita per impostazione predefinita, sarà necessario creare un componente personalizzato per scrivere tale campo nel contesto del messaggio. Il componente personalizzato deve analizzare i campi del segmento e scrivere un singolo campo nel contesto del messaggio.
Nell'esempio Message Enrichment viene illustrato come utilizzare un parser per estrarre singoli campi dai segmenti e scriverli nel contesto. Questo esempio è incluso nell'unità<>:\Programmi\Microsoft BizTalk Server\SDK\Samples\EDI\MessageEnrichment. Per altre informazioni, vedere Esempio di arricchimento dei messaggi (BizTalk Server esempio).