Modifica di schemi EDI
È possibile modificare uno schema EDI esistente fornito in BizTalk Server. Quando l'utente e i partner commerciali hanno concordato le modifiche agli schemi standard e, forse, è stato modificato il file miG (Message Implementation Guideline) pertinente, è possibile modificare gli schemi nell'editor BizTalk in Visual Studio.
Nota
Alcune modifiche degli schemi (convalida campi incrociata e divisione di documenti secondari HIPAA) implicano modifiche alle annotazioni in uno schema EDI. Queste modifiche non possono essere effettuate nell'Editor BizTalk ma in un editor di testo, ad esempio il Blocco note.
Prerequisiti
È necessario eseguire l'accesso come membro del gruppo Amministratori BizTalk Server.
Convenzione di denominazione degli schemi
Uno schema EDI viene identificato dal nome radice e dallo spazio dei nomi. Non è possibile distribuire due schemi nello stesso gruppo BizTalk con lo stesso nome radice e lo stesso spazio dei nomi. Non è possibile modificare né aggiungere valori al nome radice di uno schema EDI, perché tale nome deve contenere la versione e il tipo di documento in una convenzione di denominazione standard. Di conseguenza, se si desidera distribuire due schemi nello stesso gruppo BizTalk con lo stesso nome radice, è necessario utilizzare uno spazio dei nomi diverso per ognuno di essi.
Non è insolito che in un'azienda venga distribuita nello stesso gruppo BizTalk una versione diversa dello stesso schema per due o più partner commerciali diversi. In questo caso, i due schemi avrebbero la stessa versione e lo stesso tipo di documento. Per distribuire questi due schemi, è necessario impostare spazi dei nomi diversi per ognuno di essi.
Modifiche degli schemi EDI
È possibile apportare le modifiche seguenti a uno schema EDI in Visual Studio:
| Per | Procedere nel modo seguente |
|---|---|
| Modificare un'enumerazione (ad esempio l'elenco di valori in un elenco codici) |
Nelle proprietà di un elemento aprire l'editor di enumerazione e aggiungere un valore a o eliminare un valore dall'elenco di enumerazione. |
| Modificare la facoltatività di un elemento dati | Modificare la proprietà Min Occurs . impostandola su 0 per rendere il campo facoltativo o su 1 per renderlo obbligatorio. |
| Modificare il numero massimo di volte in cui un elemento dati può apparire nel file | Modificare la proprietà Max Occurs . |
| Modificare il numero di caratteri nell'elemento dati | Modificare la proprietà Length . |
| Modificare il tipo di dati di un elemento dati | Modificare la proprietà Tipo di dati di base o Tipo didata . |
| Aggiungere un campo personalizzato | Inserire un nodo di schema di elementi campo figlio e impostare le relative proprietà. Nota: L'aggiunta di un attributo di campo figlio a un record in uno schema EDI non è consentita, perché la sequenza degli elementi non sarebbe garantita. Se si tenta di aggiungere un attributo campo figlio, verrà generato uno schema non valido. È possibile aggiungere solo un elemento campo figlio in un record di uno schema EDI. |
| Aggiungere un record personalizzato | Inserire un nodo di schema di record figlio, impostarne le proprietà e quindi aggiungere elementi campo figlio. |
| Eliminare un campo o un record personalizzato | Eliminare un campo o un record personalizzato con i relativi elementi campo figlio. |
| Abilitare la convalida campi incrociata | Impostare il flag di convalida tra campi nell'annotazione nella sezione appinfo dello schema su Sì. Questo flag è X12ConditionDesignator_Check (per schemi X12 o HIPAA) o EdifactDependencyRule_Check (per schemi EDIFACT). Abilitare la convalida campi incrociata per un elemento specifico impostando le condizioni relazionali (X12 e HIPAA) o le regole di dipendenza (EDIFACT). Per altre informazioni, vedere Configurazione della convalida tra campi. È anche necessario impostare la proprietà di convalida dei tipi Edi su sì. La convalida campi incrociata è abilitata per impostazione predefinita per gli schemi HIPAA. |
| Abilitare la divisione di documenti secondari HIPAA | In uno degli schemi HIPAA che è possibile impostare la suddivisione dei documenti secondari in impostare le proprietà subdocument_break e Split_Without_Sibling_Data per lo schema su sì e la proprietà subdocument_creation_break per un elemento specifico nello schema su sì. È anche necessario impostare la proprietà contratto di opzione di elaborazione batch in ingresso su Split Interscambio come set di transazioni. Per altre informazioni, vedere Suddivisione di documenti secondari HIPAAA. |
| Aggiungere campi trigger in un documento HIPAA | È possibile consentire al disassembler EDI di creare record XML univoci per un segmento del documento HIPAA, in base a un elemento di qualificazione noto come campo trigger. È necessario specificare gli attributi che descrivono il segmento e il valore trigger in modo che venga creato un record XML univoco per il segmento. Per altre informazioni, vedere Annotazioni di campo trigger dello schema HIPAA. |
| Aggiungere un segmento in un set di transazioni X12 | Quando si aggiunge un nuovo segmento in un set di transazioni X12, i primi tre caratteri del nome del segmento vengono utilizzati come identificatore del segmento. Di conseguenza, è consigliabile assegnare al segmento un nome tale che i primi tre caratteri siano univoci. |
| Aggiungere un ciclo in un set di transazioni HIPAA | Quando si aggiunge un nuovo ciclo in un set di transazioni HIPAA, è consigliabile assegnare al ciclo un nome che includa il termine "Loop". Un esempio di formato di ciclo è "TS837_2010AB_Loop". Nota: Il primo segmento in un ciclo è obbligatorio (minOccurs del segmento deve essere uguale a 1) per evitare ambiguità. |
| Aggiungere un "ciclo in qualsiasi ordine" in un set di transazioni HIPAA | Quando un set di transazioni include segmenti equivalenti con una semantica diversa, è necessario definirli in un SubLoop. Un SubLoop con annotazione XML di <xs:all> consente ai segmenti equivalenti di verificarsi in qualsiasi ordine. È consigliabile assegnare al "ciclo in qualsiasi ordine" un nome che includa il termine "SubLoop". Un formato di esempio è "TS837Q1_2010A_SubLoop" Nota: gli elementi di un ciclo di ordine devono verificarsi solo una volta all'interno del ciclo. Per evitare ambiguità, la proprietà maxOccurs degli elementi di pari livello di un SubLoop deve essere impostata su 1. |
Per modificare uno schema EDI esistente nell'Editor BizTalk
In Visual Studio aggiungere lo schema da modificare a un progetto e aprire lo schema in BizTalk Editor.
Nota
È possibile visualizzare lo schema in forma grafica facendo clic sulla scheda EDI nella parte inferiore della schermata Editor schema. Risulta molto più semplice esplorare i nodi dello schema utilizzando il formato tabulare.
Per modificare le proprietà di un elemento dati o di un record, fare clic sul nodo appropriato nel riquadro sinistro dell'Editor BizTalk e modificare le relative proprietà nella finestra Proprietà.
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 o eliminare dall'elenco di valori, in base alle esigenze, assicurandosi che sia presente un valore su ogni riga nel riquadro Valori . Fare clic su OK.
Per aggiungere un campo personalizzato allo schema, fare clic con il pulsante destro del mouse su un nodo record nell'albero della console di BizTalk Editor, scegliere Inserisci nodo schema e fare clic su Elemento Campo figlio. Assegnare un nome all'elemento dati e quindi trascinarlo nella posizione appropriata nel record. Impostare le proprietà per il campo personalizzato come necessario.
Nota
L'aggiunta di un attributo campo figlio a un record in uno schema EDI non è consentita, perché la sequenza degli elementi non sarebbe garantita. Se si tenta di aggiungere un attributo campo figlio, verrà generato uno schema non valido.
Per aggiungere un record personalizzato allo schema, fare clic con il pulsante destro del mouse su un nodo record nell'albero dello schema dell'editor dello schema, scegliere Inserisci nodo schema e quindi fare clic su Record figlio. Assegnare un nome al record e quindi trascinarlo nella posizione appropriata nello schema. Aggiungere almeno un elemento dati al record. Impostare le proprietà per il record personalizzato come necessario.
Dopo aver apportato le modifiche desiderate allo schema, è possibile modificare lo spazio dei nomi di destinazione che si applica alla proprietà dello schema facendo clic sul nodo radice (<Schema>) e quindi modificando la proprietà Spazio dei nomi di destinazione .
Salvare lo schema.
Convalidare lo schema facendo clic con il pulsante destro del mouse sullo schema in Esplora soluzioni e facendo clic su Convalida schema.
Nota
Il comando Validate Schema convalida lo schema EDI perché la proprietà Estensione editor schema del nodo radice (<Schema>) è impostata sull'estensione dell'editor di schemi EDI.
Per modificare le proprietà di annotazione in uno schema EDI esistente
Aprire lo schema in un editor di testo, ad esempio il Blocco note.
Per abilitare la convalida campi incrociata, eseguire le operazioni seguenti. Per altre informazioni, vedere Configurazione della convalida tra campi.
Nell'annotazione appinfo nella parte superiore dello schema impostare il flag di convalida tra campi ( X12ConditionDesignator_Check per schemi X12 o HIPAA o EdifactDependencyRule_Check per gli schemi EDIFACT) su Sì.
Nota
Il flag di convalida tra campi è Sì per impostazione predefinita per gli schemi HIPAA BizTalk Server.
Nell'annotazione per un elemento specifico, impostare le relative condizioni relazionali (X12 o HIPAA) o regole di dipendenza (EDIFACT). Per altre informazioni su queste impostazioni, vedere Convalida tra Field-Segment.
Nota
Nella pagina Convalida (nella sezione Impostazioni set di transazioni ) della scheda Contratto unidirezionale della finestra di dialogo Proprietà contratto per il contratto pertinente verificare che sia selezionata la proprietà Convalida del tipo EDI .
Per abilitare la divisione di documenti secondari HIPAA, eseguire le operazioni seguenti. Per altre informazioni, vedere Suddivisione di documenti secondari HIPAA.
Nell'annotazione appinfo all'inizio dello schema impostare i flag subdocument_break e Split_Without_Sibling_Datasu sì.
Nell'annotazione appinfo per un elemento specifico, vedi il flag subdocument_creation_break su sì.
Nota
Nella pagina Impostazioni host locale (nella sezione Impostazioni interscambio ) della scheda Contratto unidirezionale della finestra di dialogo Proprietà contratto per il contratto pertinente verificare che la proprietà dell'opzione Elaborazione batch in ingresso sia impostata su Divisione interscambio come set di transazioni.
Vedere anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per