Applicazione di mappe e codici personalizzati di ACK ai messaggi ACK HL7 per BizTalk Server 2013 R2

Sintomi

Problema 1

Si consideri lo scenario seguente:

  • È in esecuzione Microsoft BizTalk 2013 R2 Accelerator per HL7 (BTAHL7).

  • Si sta utilizzando un MLLP adapter di ricezione e la pipeline di ricezione di un HL7 in bidirezionale porta di ricezione.

  • Impostate l'opzione Uso diretto sincrono ACK HL7 su True nella proprietà del trasporto MLLP.

  • Creare una mappa in uscita su questa bidirezionale porta per trasformare l'ACK prima dell'invio di ricezione.


In questo scenario, la mappa in uscita non viene applicata per il riconoscimento di HL7 e pertanto non viene trasformato il ACK.

Problema 2

Porta di trasmissione MLLP controlla il codice di ACK ACK (il campo MSA.1_AcknowledgmentCode del segmento MSA) che viene restituito dal sistema downstream e lo confronta con i codici di ACK accettabili cui vengono impostati le proprietà di configurazione porta di trasmissione MLLP. I codici di ACK sono attualmente supportati da MLLP inviano porta sono AA, CA, AE, CE, P.A. e CR. È possibile selezionare tutti i codici ACK o una loro combinazione. Ad esempio, i codici seguenti sono tutte validi:

AA e CA
AA, CA, AE e CE
AA, CA, P.A. e CR

Tuttavia, è possibile immettere eventuali ulteriori codici ACK accettabile.

Dopo avere applicato questo hotfix, viene aggiunto un nuovo codice accettabile ACK con nome personalizzato nell'elenco Codici ACK accettabile . Inoltre, una nuova casella di testo viene aggiunto in cui immettere i codici di riconoscimento personalizzati accettabili.

alternate text


alternate text


Notes

  • I codici personalizzati devono essere separati da una virgola (,). Ad esempio: AE, CE, AR, CR, XX, ZZ

  • Se è selezionata una delle combinazioni standard (un'opzione non personalizzati), non è necessario immettere i valori nella proprietà Accettabile codici personalizzati di ACK .

  • Per assicurarsi che la convalida della pipeline ha esito positivo per i codici di riconoscimento personalizzati, è necessario aggiungere i codici ACK personalizzati necessari allo schema corrispondente ACK.

  • È possibile utilizzare la funzionalità di rilevamento BizTalk (attivando la registrazione) per rilevare il messaggio utilizzando il MessageID che viene registrato nel registro eventi quando il messaggio viene ripetuto o sospeso.


Risoluzione

Informazioni sull'aggiornamento cumulativo

Questo problema è stato corretto nell'aggiornamento cumulativo di BizTalk Server seguente:


Assicurarsi di distribuire il file DLL di mappa in uscita e di installare questo file DLL nella global assembly cache (GAC):

  1. Nome dell'assembly OutboundMap

    Questa operazione richiede il nome completo dell'assembly che contiene la mappa in uscita. È possibile trovare queste informazioni nelle proprietà della mappa nella Console di amministrazione di BizTalk Server. Qui troverete le informazioni per l'assembly e il nome completo di OutboundMap richiesto nel passaggio successivo.

    Ad esempio: in uscita, versione = 1.0.0.0, Culture = neutral, PublicKeyToken = 83f92b3673c9005d

  2. Nome OutboundMap

    Questa operazione richiede il nome di mappa completa, incluso lo spazio dei nomi. È possibile trovare queste informazioni nelle proprietà del file *.btm (TypeName).

    Ad esempio: Outbound.Map1

Nota: Queste proprietà vengono applicate solo se diretto ACK HL7 sincrona è impostato su True.

Se non è necessario automaticamente il Disassembler HL7 (DASM) nella Pipeline di ricezione HL7 per generare HL7 riconoscimenti (ad esempio l'ACK restituito da un sistema a valle verrà passato al sistema upstream), disattivare l'opzione Route ACK per inviare una conduttura nella porta di ricezione richiesta per la parte di origine e impostare Uso diretto sincrono ACK HL7 su False. Quindi, utilizzare l'opzione di uscita mappa fornito nella porta di ricezione.

Per il problema 1

Questa nuova funzionalità si applica solo alla porta di ricezione/posizione. Attualmente, porta di ricezione qualsiasi BizTalk ha una proprietà di Mappe in ingresso . Dopo aver installato questo hotfix, è una proprietà aggiuntiva disponibile nell'indirizzo di ricezione per applicare una mappa a un ACK HL7. Questa proprietà aggiuntiva consente di applicare una mappa bidirezionale di ricezione che l'Uso diretto sincrono ACK HL7 è impostata su (=) come True. L'unico scopo di questo hotfix è consentire all'utente di specificare una mappa per un ACK quando Utilizzo diretto sincrono ACK HL7 è impostata su (=) come True.

Dopo aver installato l'hotfix, verranno visualizzati due ulteriori proprietà di MLLP percorso configurazione finestra di ricezione. L'impostazione predefinita per le due proprietà è vuota e che devono essere compilati e Utilizzare ACK HL7 sincrona diretta deve essere impostata su (=) come True.

alternate text

Per impostare le due proprietà, attenersi alla seguente procedura:

  1. Proprietà Nome Assembly OutboundMap richiede il nome completo dell'assembly in cui è ospitata la mappa in uscita, come illustrato di seguito:

    In uscita, Version = 1.0.0.0, Culture = neutral, PublicKeyToken = 83f92b3673c9005dL'assembly deve essere memorizzata nella cache dal Global Assembly. In caso contrario, la trasformazione ha esito negativo.

  2. Proprietà OutboundMap Name richiede il nome completo della mappa tra spazio dei nomi.


Uno dei limiti di questa nuova funzionalità: l'ACK HL7 non viene tenuta traccia. Se è necessario tenere traccia di ACK, è necessario impostare anche le Mappe in ingresso in BizTalk proprietà porta di ricezione. Tecnicamente, si applicano la mappa di ACK e inserita nella finestra di messaggio e l'ACK che è stato restituito al sistema upstream. Entrambi devono essere identici in quanto entrambe avranno la stessa mappa applicata. Nell'immagine riportata di seguito è incluso per chiarimenti ed è necessaria solo se è necessario tenere traccia di ACK.

alternate text

Nota: L'opzione di Utilizzo diretto sincrono HL7 ACK migliora le prestazioni di elaborazione di messaggi in ingresso. È possibile inviare l'ACK al sistema monte non appena il messaggio viene depositato nella finestra di messaggio. Questa impostazione consente di migliorare le prestazioni se sono vere le seguenti condizioni:

  • La porta di ricezione è una porta di ricezione bidirezionale e l'opzione di Utilizzo diretto sincrono ACK HL7 è impostata su True nella configurazione della porta MLLP ricevere.

  • BizTalk HL7 DASM viene utilizzato per generare l'ACK. Il componente DASM deve essere utilizzato come incluso il valore predefinito BTAHL72XReceivePipeline o utilizzando il BTAHL7 nativo. Componente HL72fDasm di una pipeline personalizzata.

  • L'impostazione porta di ricezione Route ACK a pipeline di trasmissione su richiesta-risposta della parte di origine deve essere in Gestione configurazione HL7 e il Tipo di riconoscimento deve essere impostato su un valore diverso da None.


Per emettere 2

La nuova funzionalità si applica per inviare solo le porte. Dopo aver installato l'hotfix, il comportamento sarà basato sul codice selezionato nell'elenco a discesa anziché il codice fornito dal sistema downstream ACK accettabile.

Invia MLLP porta controlla il codice di ACK ACK (campo MSA.1_AcknowledgmentCode del segmento MSA) che viene restituito dal sistema downstream e lo confronta con i codici di ACK accettabile che vengono impostati nella finestra di MLLP inviare una proprietà di configurazione della porta. Accettabile ACK codici correnti che sono supportati da porta di trasmissione MLLP includono AA, CA, AE, CE, AR e CR. È possibile selezionare tutti i codici ACK o una combinazione di essi (AA e CA), AA, CA, AE e CE, (AA, CA, AR e CR) come valido. Ma vi è alcuna possibilità di immettere una combinazione di codice ACK accettabile.

Un ulteriore valore accettabile ACK codici denominato "Custom" viene aggiunto nell'elenco a discesa nella proprietà Codici ACK accettabile . Tutte le combinazioni precedenti rimangono e vengono applicate come erano prima che la nuova funzionalità è stata aggiunta.

alternate text

alternate text

Dopo aver selezionato personalizzato , è necessario immettere anche i nuovi valori nella proprietà Accettabili i codici di ACK personalizzati . Questi nuovi valori ACK devono essere separati da una virgola (,).

Dopo aver installato l'hotfix, il comportamento sarà dipendono dall'impostazione Codici ACK accettabile selezionato. Se il codice ACK restituito corrisponde al codice selezionato accettabile, l'elaborazione viene eseguita correttamente. Verrà Riprova per codici standard di ACK e sospendere il codice ACK non è elencato (renderlo un non standard o un codice ACK non personalizzati).

Nella tabella seguente rappresenta questo scenario. Un'interpretazione scritta segue la tabella.

alternate text

Elaborazione messaggio sempre riesce per AA e CA, indipendentemente da eventuali codici ACK accettabile l'impostazione selezionata. È qui ulteriori informazioni sulle impostazioni di Codici ACK accettabile :

  • AA, CA: Tentativi AE, CE, AR, CR e sospende tutti gli altri.

  • AA, CA, AE, CE: Accettato con successo: AA, CA, AE, CE e tentativi P.A. e CR sospende tutti gli altri.

  • AA, CA, AR, CR: Accettato con successo: AA, CA, AR, CR e tentativi AE e CE. Sospende tutti gli altri.

  • AA, CA, AR, CR, AE, CE: Accettato con successo: AA, CA, AR, CR, AE, CE e nessun altro viene restituito. ACK viene ripetuto e messaggio sospeso.

  • Personalizzato (valori immessi e separati da virgola). Esempio: AA, AE, Foo, ZZ, ZZZ). Accettato con successo: AA, CA, AE più di qualsiasi altro immesso in questo caso ACK personalizzato come Foo, ZZ e ZZZ. Tentativi di CE, P.A.

  • Qualsiasi codice ACK non specificato nei Codici di ACK accettabile personalizzato non viene ripetuta e viene sospesa.


Quando un ACK standard non viene immesso sotto I codici ACK accettabili, viene restituito un errore analogo al seguente:

La scheda messaggio da inviare "< SendPortName >" con l'URL "127.0.0.1:33000" porta di trasmissione non riuscita. Esso verrà trasmesso nuovamente dopo l'intervallo specificato per questa porta di trasmissione. Dettagli: "messaggio con ID messaggio: < MessageID >, ricevuto con tipo di riconoscimento: errore e con codice ACK: CE.


Lo schema ACK out-of-the-box deve essere modificato mediante l'aggiunta all'elenco esistente di ACK standard (AA, AE, AR, CA, CE, CR). Qualsiasi ulteriore ACK personalizzato accettabile (XX, ZZ, per esempio) deve essere aggiunto al campo MSA.1_AcknowledgementCode dello schema ACK. Se l'ACK personalizzati aggiuntivi non vengono aggiunte allo schema, la convalida della pipeline non riesce con un errore di "Valore di tabella non trovato".


alternate text

Ulteriori informazioni

Prerequisiti per installare l'aggiornamento software

Per applicare questo hotfix, è necessario disporre del software seguente:

  • Microsoft BizTalk Server 2013 R2

  • R2 2013 Microsoft BizTalk Accelerator per HL7

Necessità di riavvio

Non è necessario riavviare il computer dopo avere applicato questo hotfix. Tuttavia, si consiglia di chiudere e riaprire la Console di amministrazione BizTalk dopo l'installazione dell'hotfix.

La versione inglese di questo hotfix presenta gli attributi di file (o attributi successivi) elencati nella tabella riportata di seguito. Le date e ore dei file sono elencate in base al formato UTC (Coordinated Universal Time Coordinated). Quando si visualizzano le informazioni sul file, viene convertito in ora locale. Per calcolare la differenza tra ora UTC e ora locale, utilizzare la scheda fuso orario nell'elemento di Data e ora nel Pannello di controllo.

Nome del file

Versione del file

Dimensione del file

Data

Ora

Piattaforma

Microsoft.Solutions.BTAHL7.HL72fDasm.dll

3.10.325.2

107520



09-Feb-2015

22:52

x86

Microsoft.Solutions.BTAHL7.PipelineCommon.dll

3.10.325.2

95232



09-Feb-2015

22:52

x86

Microsoft.Solutions.BTAHL7.Shared.dll

3.10.325.2

99328



09-Feb-2015

22:52

x86

Microsoft.Solutions.BTAHL7.MLLP.dll

3.10.325.2

128000



09-Feb-2015

22:52

x86

Microsoft.Solutions.BTAHL7.HL7AckHelper.dll

3.10.325.2

29696



09-Feb-2015

22:52

x86


Stato

Microsoft ha confermato che questo è un problema dei prodotti Microsoft elencati nella sezione "Si applica a".

Riferimenti

Per ulteriori informazioni sugli aggiornamenti rapidi di BizTalk Server, vedere informazioni sugli aggiornamenti rapidi di BizTalk Server.

Informazioni sulla terminologia standard utilizzata per descrivere gli aggiornamenti software Microsoft.

I prodotti di terze parti descritti in questo articolo sono forniti da società indipendenti da Microsoft. Microsoft esclude ogni garanzia, implicita o esplicita relativa alle prestazioni o all'affidabilità di tali prodotti.


Serve aiuto?

Amplia le tue competenze
Esplora i corsi di formazione
Ottieni in anticipo le nuove caratteristiche
Partecipa a Microsoft Insider

Queste informazioni sono risultate utili?

Grazie per il feedback!

Grazie per il tuo feedback! Potrebbe essere utile metterti in contatto con uno dei nostri operatori del supporto di Office.

×