Personalizzazione delle enumerazioni nello schema della busta

Articolo
07/21/2023

BizTalk Server consente di personalizzare le enumerazioni dei campi ID nello schema del servizio (busta). Ciò consente di ricevere o inviare interscambi con valori non standard, ovvero non inclusi nell'insieme di valori definiti dal corpo di standard X12, nei campi ID mittente o ricevitore nella busta. Consente inoltre di modificare i qualificatori disponibili negli elenchi a discesa per i valori di intestazione nelle definizioni di proprietà dell'accordo.

Importante

Quando si modifica uno schema, tale modifica viene applicata a tutte le transazioni per lo standard in questione. Non è possibile apportare una modifica nello schema della busta per un'entità singola.

BizTalk Server esegue il pull dell'elenco di valori consentiti dagli schemi di servizio statici nel Microsoft.BizTalk.Edi.BaseArtifacts.dll, che viene fornito con il prodotto. Per estendere il set di valori di base, è necessario sviluppare e distribuire un'estensione dello schema di servizio. BizTalk Server fornisce modelli di schema del servizio (busta) che è possibile usare per modificare le enumerazioni in. Questi schemi di servizio sono X12_ServiceSchemaExtension.xsd e EDIFACT_ServiceSchemaExtension.xsd. Ogni schema personalizzato avrà uno degli spazi dei nomi seguenti, in base allo standard. Tale spazio dei nomi non può essere modificato.

Standard	Spazio dei nomi
X12 e HIPAA	`http://schemas.microsoft.com/BizTalk/EDI/X12/2006`
EDIFACT	`http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006`

Si apportano le modifiche allo schema in BizTalk Editor in Visual Studio (vedere la procedura seguente). Dopo aver apportato le modifiche necessarie, è necessario distribuire lo schema.

Nei lati di ricezione e invio, quando BizTalk Server convalida i segmenti di busta (ISA e GS per X12 o UNB e UNG for EDIFACT), verificherà l'esistenza dello schema del servizio personalizzato in base al relativo spazio dei nomi. Se lo schema personalizzato viene distribuito, BizTalk Server unisce lo schema con lo schema di servizio regolare e userà valori di enumerazione personalizzati e standard in cui specificato. È possibile personalizzare lo schema per estendere un elenco di enumerazione, ma non è possibile rimuovere valori da tale schema. Se non viene distribuito uno schema personalizzato, BizTalk Server userà lo schema di servizio standard.

Dopo aver distribuito uno schema personalizzato, l'interfaccia utente di Trading Partner Management (TPM) nella console di amministrazione BizTalk Server userà i valori in un'enumerazione personalizzata per popolare gli elenchi a discesa appropriati nelle pagine delle proprietà TPM. Se non è stato distribuito uno schema personalizzato, TPM userà i valori nell'enumerazione nello schema di servizio standard. Inoltre, il runtime di BizTalk Server userà l'enumerazione personalizzata per convalidare un messaggio.

Se si usano gli strumenti XML forniti con BizTalk Server per convalidare un'istanza con la relativa busta e si è personalizzato lo schema del servizio, è necessario includere lo schema del servizio personalizzato nel progetto BizTalk, oltre allo schema del documento (set di transazioni) e, se necessario, lo schema batch. Ciò non è necessario se si convalida un'istanza di set di transazioni che non dispone di busta.

Prerequisiti

È necessario eseguire l'accesso come membro del gruppo Amministratori BizTalk Server.

Campi modificabili della busta

È possibile modificare solo i campi seguenti della busta. Solo questi campi sono inclusi negli schemi di estensione. Altri campi aggiunti nello schema del servizio di estensione non avranno alcun effetto sull'elaborazione.

Standard	Campo
X12 e HIPAA	ISA1 - Qualificatore autorizzazione ISA3 - Qualificatore di sicurezza ISA05 - Qualificatore ID mittente ISA07 - Qualificatore ID ricevente GS01 - Codice funzionale GS07 - Agenzia responsabile
EDIFACT	UNB2.2 - Qualificatore codice mittente UNB3.2 - Qualificatore codice ricevente

Campi della busta da non modificare

Alcuni campi della busta influenzano i comportamenti nel motore. È pertanto consigliabile non aggiungere valori all'elenco di enumerazioni esistente per tali campi. Di seguito sono riportati questi campi:

Standard	Campo
X12 e HIPAA	ISA11 - Identificatore standard del controllo di interscambio ISA12 - Numero di versione del controllo di interscambio ISA14 - Riconoscimento richiesto
EDIFACT	UNB1.1 - Identificatore sintassi UNB1.2 - Numero di versione della sintassi UNB9 - Richiesta di riconoscimento

Per personalizzare un'enumerazione nello schema della busta

In Visual Studio creare un nuovo progetto.
Aggiungere lo schema X12_ServiceSchemaExtension.xsd (per modificare enumerazioni X12 o HIPAA) o lo schema EDIFACT_ServiceSchemaExtension.xsd in \Programmi (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI a un progetto BizTalk nell'editor BizTalk. Aprire lo schema.
Per modificare i valori in un'enumerazione, selezionare l'enumerazione nel riquadro Proprietà e quindi fare clic sui puntini di sospensione per aprire l'editor di enumerazione. Aggiungere all'elenco di valori, in base alle esigenze, assicurarsi che sia presente un valore su ogni riga nel riquadro Valori . Fare clic su OK.

Importante

Non è possibile modificare lo spazio dei nomi per lo schema del servizio. Tale schema deve avere lo stesso spazio dei nomi e lo stesso nome di nodo radice dello schema di estensione originale installato insieme al prodotto.

Nota

Se si aggiunge un nuovo campo agli schemi, tale campo verrà ignorato. È possibile modificare solo i campi elencati nella sezione Busta che può essere modificata in precedenza.
Salvare lo schema.
Fare clic con il pulsante destro del mouse sullo schema e scegliere Distribuisci.

Nota

Lo schema deve essere distribuito nel gruppo BizTalk corrente.

Vedere anche

Sviluppo di schemi EDI
Modifica di schemi EDI

Condividi tramite