Problembeschreibung
Problem 1
Betrachten Sie das folgende Szenario:
-
Sie verwenden Microsoft BizTalk 2013 R2 Accelerator für HL7 (BTAHL7).
-
Sie verwenden ein MLLP Empfangsadapter und einen HL7 Empfangspipeline in einen bidirektionalen Empfangsport.
-
Verwendet direkte synchrone HL7 ACK -Option festgelegt auf True MLLP Transporteigenschaften.
-
Erstellen eine ausgehende Zuordnung auf diesem bidirektionalen Empfangsport um das ACK transformiert werden, bevor es gesendet wird.
In diesem Szenario die ausgehende Zuordnung gilt nicht für HL7 ACK und daher das ACK nicht transformiert.
Problem 2
MLLP Sendeport überprüft ACK im ACK ( MSA.1_AcknowledgmentCode Feld MSA Segment), die das entfernte System zurück und vergleicht sie mit zulässigen ACK-Codes, die in der MLLP Send Port festgelegt werden. ACK-Codes, die derzeit vom MLLP unterstützt senden Port AA, CA, AE, CE AR und CR. Sie können alle ACK-Codes oder eine Kombination auswählen. Folgende Codes sind z. B. gültig:
AA und CA AE, AA, CA und CE AA, CA, AR und CR Jedoch kann keine zusätzliche zulässigen ACK Codes eingeben. Nach Installation dieses Hotfixes wird neuer zulässigen ACK Code mit dem benutzerdefinierten Namen wurde in der Liste Zulässigen ACK Codes hinzugefügt. Außerdem wird ein neues Textfeld, akzeptabel benutzerdefinierte ACK-Codes geben hinzugefügt. Notes-
Benutzerdefinierte Codes sollten durch ein Komma (,) getrennt. Beispiel: AE CE, AR, CR, XX, ZZ
-
Wenn standard Kombinationen (Option nicht benutzerdefiniert) ausgewählt ist, müssen Sie keinen Werte in der Eigenschaft Zulässigen benutzerdefinierte ACK-Codes einzugeben.
-
Um sicherzustellen, dass benutzerdefinierte ACK-Codes die Pipeline Validierung erfolgreich ist, müssen Sie das entsprechende ACK-Schema erforderliche benutzerdefinierte ACK-Codes hinzufügen.
-
Funktion der BizTalk Tracking (durch Aktivieren der Verfolgung), verfolgen Sie die Nachricht mit MessageID, die im Ereignisprotokoll protokolliert, wenn die Meldung wiederholt oder angehalten ist.
Problemlösung
Informationen zum kumulativen Update
Dieses Problem wurde erstmals die folgenden kumulative Update BizTalk Server behoben:
Stellen Sie sicher erforderliche ausgehenden Karte DLL-Datei bereitstellen, die diese DLL-Datei im globalen Assemblycache (GAC) installieren:
-
AssemblyName OutboundMap
Hierfür wird der vollständige Name der Assembly, die die ausgehende Zuordnung hostet. Diese Informationen finden Sie in den Eigenschaften der Zuordnung in der BizTalk Server-Verwaltungskonsole. Hier finden Sie die Informationen für die Assembly und den vollständigen Namen OutboundMap, der im nächsten Schritt erforderlich ist. Beispiel: ausgehende, Version = 1.0.0.0, Culture = Neutral, PublicKeyToken = 83f92b3673c9005d -
OutboundMap Namen
Dies erfordert vollständige Zuordnungsname, einschließlich des Namespace. Diese Informationen finden Sie in den Eigenschaften der Datei *.btm (Namespace.TypeName). Beispiel: Outbound.Map1
Hinweis Diese Eigenschaften gelten nur, wenn direkte synchrone HL7 ACK auf Truefestgelegt ist.
Wenn Sie automatisch die HL7 Disassembler (DASM) in die HL7 Empfangspipeline, benötigen HL7 Empfangsbestätigungen (beispielsweise wird das zurückgegebene einige Nachfolgesystem ACK upstream System übergeben), deaktivieren Sie die Option Route ACK Pipeline Empfangsport Anforderung senden Quelle Partei generieren und Verwenden direkte synchrone HL7 ACK auf Falsefestgelegt. Verwenden Sie die Option ausgehende Zuordnung die bereitgestellte in den Empfangsport.Für Problem 1
Diese neue Funktion gilt nur für Empfangsports-Speicherort. Derzeit BizTalk-Empfangsport hat eine Eingehende Karten -Eigenschaft. Nach Installation dieses Hotfixes gibt es eine zusätzliche Eigenschaft der Empfangsspeicherort HL7 ACK Zuordnung zuweisen Diese zusätzliche Eigenschaft können Sie eine Zuordnung zum Anwenden einer bidirektionalen Empfangsspeicherort, die die Verwendung direkte synchrone HL7 ACK (=) Trueverfügt. Der einzige Zweck dieses Hotfixes ist der Benutzer eine Zuordnung bei Verwendung direkte synchrone HL7 ACK (=) TrueACK angeben.
Nachdem Sie den Hotfix installieren, sehen Sie zwei zusätzliche Eigenschaften in der MLLP Position Konfigurationsfenster angezeigt. Die Standardeinstellung für die beiden Eigenschaften ist leer und muss aufgefüllt sein Verwenden direkte synchrone HL7 ACK (=) Trueeingestellt werden. Gehen Sie folgendermaßen vor, um die beiden Eigenschaften festgelegt:-
OutboundMap Assembly Name -Eigenschaft muss den vollständigen Namen der Assembly in der ausgehende Karte, wie im folgenden Beispiel gehostet wird:
Ausgehend, Version = 1.0.0.0, Culture = Neutral, PublicKeyToken = 83f92b3673c9005dDie Assembly muss zuvor vom globalen Assemblycache zwischengespeichert werden. Andernfalls wird die Transformation nicht.
-
OutboundMap Name -Eigenschaft muss der vollständige Name der Zuordnung, einschließlich Namespace.
Ein Nachteil dieser neuen Funktionen: die HL7 ACK nicht nachverfolgt. Das ACK verfolgen muss, muss auch festgelegt Wird eingehender Eigenschaft in BizTalk Port empfangen. Technisch gesehen werden Sie anwenden die Karte ACK, die im Meldungsfeld gestellt wurde und das ACK upstream System zurückgegeben wurde. Beide müssen identisch sein, weil beide die gleiche Zuordnung angewendet werden. Die folgende Abbildung dient zur Klärung und ist nur erforderlich, wenn das ACK nachverfolgt werden muss. Hinweis Die Option Mit direkte synchrone HL7 ACK verbessert Leistung eingehende Nachricht. Dies erfolgt durch ACK an upstream System sendet, sobald die Nachricht in der MessageBox abgelegt wird. Dadurch wird die Leistung verbessert, wenn Folgendes zutrifft:
-
Der Empfangsport ist einen bidirektionalen Empfangsport und Verwenden direkte synchrone HL7 ACK -Option auf True festgelegt ist, in der Portkonfiguration MLLP erhalten.
-
BizTalk HL7 DASM dient der Bestätigung DASM Komponente muss als in der Standard-BTAHL72XReceivePipeline oder mit systemeigenen BTAHL7 verwendet werden. HL72fDasm-Komponente in einer benutzerdefinierten Pipeline.
-
Route ACK Sendepipeline Anforderungsantwort Empfangsport Quelle Partei muss werden im Explorer Konfiguration HL7 und Bestätigungstyp muss auf einen Wertfestgelegt werden.
Problem 2
Die neue Funktion gilt nur für Sendeports. Nachdem Sie den Hotfix installieren, das Verhalten der zulässigen ACK-Code basiert auf, die Sie in der Dropdown-Liste anstatt den Code auswählen, die durch das entfernte System bereitgestellt wird.
Anschluss ACK Code in ACK (MSA.1_AcknowledgmentCode Feld MSA Segment) prüft, die zurückgegebene downstream Systems und vergleicht sie mit zulässigen ACK-Codes, die in der MLLP festgelegt MLLP senden Senden Konfigurationseigenschaften. Aktuelle MLLP Sendeport unterstützt ACK-Codes akzeptabel sind AA, CA, AE, CE, AR und CR. Sie können alle ACK-Codes oder eine Kombination davon AA und CA AA, CA, AE und CE (AA, CA, AR und CR) als gültig. Aber es gibt keine Möglichkeit, eine akzeptable ACK Kombination eingeben. Weitere zulässige ACK Codes -Wert mit dem Namen "Custom" in der Dropdown-Liste Eigenschaft Zulässigen ACK Codes hinzugefügt. Alle vorherige Kombinationen bleiben und wie vor dem Hinzufügen der neuen Funktion angewendet werden. Nach Benutzerdefiniert ausgewählt ist, müssen Sie die neuen Werte in der Eigenschaft Zulässigen benutzerdefinierte ACK Codes eingeben. Diese neuen ACK-Werte müssen jeweils durch ein Komma (,) getrennt. Nachdem Sie den Hotfix installieren, hängt das Verhalten Akzeptabel ACK Codes Einstellung, das ausgewählt ist. ACK-Code, der zurückgegebene ausgewählten zulässigen Code entspricht, erfolgt die Verarbeitung erfolgreich. Für ACK Standardcodes wiederholen wird und ACK Code, der nicht aufgeführt ist, (die eine nicht standardmäßige machen wird oder ein ACK nicht benutzerdefiniert) sperren. Die folgende Tabelle stellt dieses Szenario dar. Eine schriftliche Interpretation folgt die Tabelle. AA und CA erfolgreich Nachricht verarbeitet immer unabhängig von zulässigen ACK Codes festlegen, das ausgewählt ist. Weitere Informationen zu Zulässigen ACK Codes lautet-
AA, CA: Versuche AE CE, AR, CR und andere.
-
AA, CA, AE, CE: Akzeptiert und erfolgreichen: AA, CA, AE, CE und Wiederholungsversuche AR und Gutgeschriebener hält andere.
-
AA, CA, AR CR: Akzeptiert und erfolgreichen: AA, CA, AR, CR und Wiederholungsversuche AE und CE. Hält andere.
-
AA, CA, AR, CR, AE, CE: Akzeptiert und erfolgreichen: AA, CA, AR, CR, AE, CE und keine anderen zurückgegeben. ACK wiederholt und Nachricht angehalten.
-
Benutzerdefiniert (Werte werden eingegeben und durch ein Komma getrennt). Beispiel: AA AE Foo, ZZ, ZZZ). Akzeptierte und erfolgreichen: AA, CA, AE sowie andere benutzerdefinierte ACK wie Foo, ZZ oder ZZZ eingegeben in diesem Fall. Versuche, CE p.a.
-
ACK Code, die nicht akzeptablen benutzerdefinierte ACK -Codes nicht wiederholt und angehalten wird.
Wenn standard ACK nicht akzeptablen ACKCodes eingegeben wird, wird eine Fehlermeldung, die der folgenden ähnelt zurückgegeben:
Fehler im Adapter beim Übertragen der Nachricht für den Sendeport "< SendPortName >" URL "127.0.0.1:33000". Es wird nach dem für diesen Sendeport angegebenen Wiederholungsintervall erneut übertragen. Details: "Nachricht mit MessageID: < MessageID >, mit Bestätigung empfangen: Fehler und ACK Code: CE.
Out-of-the-Box ACK Schema muss geändert werden, die vorhandene Liste der standardmäßigen ACKs (AA AE, AR, CA CE, CR) hinzu. Feld MSA.1_AcknowledgementCode ACK-Schema müssen zusätzliche zulässigen benutzerdefinierte ACKs (XX, ZZ beispielsweise) hinzugefügt. Zusätzliche benutzerdefinierte ACKs nicht dem Schema hinzugefügt, bei der die Pipeline Validierung mit dem Fehler "Nicht gefunden Wert".
Weitere Informationen
Voraussetzung für das Softwareupdate installieren
Um diesen Hotfix anwenden zu können, müssen Sie die folgende Software installiert:
-
Microsoft BizTalk Server 2013 R2
-
Microsoft BizTalk 2013 R2 Accelerator for HL7
Neustart
Sie müssen keinen Neustart des Computers nach der Installation dieses Hotfixes durchführen. Es empfiehlt sich jedoch, schließen und öffnen die BizTalk-Verwaltungskonsole nach der Hotfixinstallation.
Die englische Version dieses Hotfixes weist Dateiattribute (oder spätere Attribute), die in der folgenden Tabelle aufgelistet sind. Die Datums- und Uhrzeitangaben für diese Dateien sind in Coordinated Universal Time (UTC) aufgelistet. Wenn Sie die Dateiinformationen anzeigen, werden sie in die lokale Zeit konvertiert. Um die Differenz zwischen UTC und der Ortszeit zu finden, verwenden Sie die Registerkarte Zeitzone unter Datum und Uhrzeit in der Systemsteuerung.
Dateiname |
Dateiversion |
Dateigröße |
Datum |
Zeit |
Plattform |
---|---|---|---|---|---|
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 |
Status
Microsoft hat bestätigt, dass es sich um ein Problem bei den Microsoft-Produkten handelt, die im Abschnitt „Eigenschaften“ aufgeführt sind.
Referenzen
Weitere Informationen über BizTalk Server-Updates finden Sie unter Informationen über BizTalk Server-Updates. Erfahren Sie mehr über standard-Terminologie, mit dem Microsoft-Softwareupdates beschrieben.
Die in diesem Artikel erörterten Produkte von Drittanbietern werden von Unternehmen hergestellt, die von Microsoft unabhängig sind. Microsoft übernimmt keine Garantie, weder konkludent noch anderweitig, für die Leistung oder Zuverlässigkeit dieser Produkte.