Slik bruker du kart og egendefinerte ACK-koder på ACK-meldinger i HL7 for BizTalk Server 2013 R2

Symptomer

Problem 1

Tenk deg følgende:

  • Du kjører Microsoft BizTalk 2013 R2 Accelerator for HL7 (BTAHL7).

  • Du bruker en MLLP får kort og en HL7 mottar rørledningen i en toveis får port.

  • Du setter alternativet Bruk direkte synkron HL7 ACK til stede i MLLP Transport egenskaper.

  • Du oppretter en utgående kart på dette toveis får port for å transformere ACK før det sendes.


I dette scenariet utgående kartet brukes ikke på HL7-SPOR, og derfor ACK ikke er omgjort.

Problem 2

MLLP send port kontrollerer ACK-koden i ACK ( MSA.1_AcknowledgmentCode -felt med MSA segment) som returneres av downstream systemet og sammenligner den med akseptabel ACK-kodene som er angitt i konfigurasjonsegenskapene for MLLP send port. ACK-kodene som støttes av MLLP sende port er AA, CA, AE, CE, AR og CR. Du kan velge alle ACK-koder eller en kombinasjon av disse. Det er for eksempel alle gyldige følgende koder:

AA og CA
AA, CA, AE og CE
AA, CA, AR og CR

Du kan imidlertid skrive inn noen flere akseptabel ACK-koder.

Når du har installert denne hurtigreparasjonen, legges en ny akseptabel ACK-kode som har navnet Egendefinert i listen over Godkjente ACK-koder . I tillegg legges en ny tekstboks der du vil angi de akseptable egendefinerte ACK-kodene.

alternate text


alternate text


Notes

  • Egendefinerte koder bør skilles med et komma (,). For eksempel: AE, CE, AR, CR, XX, ZZ

  • Hvis en av standard kombinasjoner (alternativet ikke egendefinert) velges, har du ikke angi verdier i egenskapen Akseptabel egendefinerte ACK-koder .

  • Hvis du vil forsikre deg om at pipeline-valideringen lykkes for egendefinerte ACK-kodene, må du legge til de nødvendige egendefinerte ACK-kodene tilsvarende ACK-skjemaet.

  • Du kan bruke funksjonen for sporing av BizTalk (ved å aktivere sporing) til å følge opp meldingen ved hjelp av MessageID som logges i hendelsesloggen når meldingen er prøvd på nytt eller avbrutt.


Oppløsning

Informasjon om kumulativ oppdatering

Dette problemet ble først løst i følgende kumulativ oppdatering av BizTalk Server:


Kontroller at du distribuerer den nødvendige utgående Map-DLL-filen, og at du installerer denne DLL-filen i den globale samlingsbufferen (GAC):

  1. Samlingsnavnet for OutboundMap

    Dette krever at det fulle navnet på samlingen som er vert for utgående kartet. Du kan finne denne informasjonen i egenskapene for kartet i BizTalk Server Admin-konsollen. Her finner du informasjon for samlingen og det fullstendige navnet for OutboundMap som er nødvendig i neste trinn.

    For eksempel: utgående, versjon = 1.0.0.0, Culture = nøytral, PublicKeyToken = 83f92b3673c9005d

  2. OutboundMap navn

    Dette krever full Tilordningsnavn, blant annet navneområdet. Du kan finne denne informasjonen i egenskapene for filen *.btm (Namespace.TypeName).

    For eksempel: Outbound.Map1

Obs! Disse egenskapene gjelder bare hvis direkte synkron HL7 SPOR er satt til True.

Hvis du ikke trenger HL7 Disassembler (DASM) i HL7 motta forløpet til å automatisk generere bekreftelser (for eksempel ACK som returneres av noen nedstrøms system vil være leveres til oppstrøms systemet), slå av alternativet Rute Bekreftelser til å sende rørledningen på forespørsel får port for kilde-part HL7, og angi Bruk direkte synkron HL7 ACK til False. Deretter bruker du alternativet for utgående kart som følger i porten for mottak.

For problem 1

Denne nye funksjonen gjelder bare for mottak Port /-plassering. For øyeblikket mottar et BizTalk port-egenskapen er en Innkommende tilordninger . Når denne hurtigreparasjonen er installert, er det en ekstra egenskap tilgjengelig i mottak hvor det skal bruke et kart på en HL7-Ack Denne ekstra (TidsavbruddForODBC) kan du bruke et kart til en toveis får plassering som har Bruk direkte synkron HL7 ACK til (=) Sann. Det eneste formålet med denne hurtigreparasjonen er å tillate brukeren å angi et kart for en Bekreftelse når Bruk direkte synkron HL7 SPOR er satt til (=) Sann.

Når du har installert hurtigreparasjonen, vil du se to andre egenskaper i MLLP mottar plasseringen konfigurasjon-vinduet. Standardinnstillingen for de to egenskapene er tomt, og de må fylles ut, og Bruk direkte synkron HL7 ACK må være satt til (=) Sann.

alternate text

Hvis du vil angi to egenskaper, gjør du følgende:

  1. OutboundMap samlingsnavn egenskapen krever at det fulle navnet på samlingen som utgående kartet er vert for, som i følgende eksempel:

    Utgående, versjon = 1.0.0.0, Culture = nøytral, PublicKeyToken = 83f92b3673c9005dSamlingen må tidligere være hurtigbufret av den globale samlingsbufferen. Hvis ikke, mislykkes transformasjonen.

  2. OutboundMap Name -egenskapen krever det fullstendige navnet på kartet inkludert navneområde.


En shortcoming av den nye funksjonaliteten: HL7-ACK spores ikke. Du må holde rede på ACK, må du også angi Innkommende kart -egenskapen i BizTalk får port. Teknisk sett vil du bruke kartet til SPOR som ble satt inn i melding-boksen og ACK som ble returnert til oppstrøms-systemet. Begge må være identiske fordi begge har samme kart brukes. Følgende skjermbilde er inkludert for å klargjøre og er bare nødvendig hvis ACK må følges.

alternate text

Obs! Alternativet Bruk direkte synkron HL7-SPOR forbedrer ytelsen ved behandling av innkommende melding. Dette gjøres ved å sende ACK tilbake til foregående systemet så snart meldingen lagres i meldingsboksen. Denne innstillingen forbedrer ytelsen hvis følgende betingelser er oppfylt:

  • Motta porten er en toveis mottak-port, og Bruk direkte synkron HL7 ACK -alternativet er satt til True i MLLP motta portkonfigurasjonen.

  • BizTalk-HL7 DASM brukes til å generere Ack DASM-komponenten må brukes enten som er inkludert i standard BTAHL72XReceivePipeline, eller ved hjelp av den opprinnelige BTAHL7. HL72fDasm-komponenten i en egendefinert rørledning.

  • Rute-ACK til sending rørledningen på forespørsel-svar får port innstillingen av kilde-part må være i HL7 konfigurasjon Explorer, og Bekreftelse Type må være satt til en annen verdi enn Ingen.


For problemet 2

Den nye funksjonen gjelder hvis du vil sende bare porter. Når du har installert hurtigreparasjonen, baseres virkemåten for akseptabel ACK-koden som du velger i rullegardinlisten i stedet for koden som leveres av downstream systemet.

Sende MLLP Send port kontrollerer ACK-koden i ACK (MSA.1_AcknowledgmentCode felt med MSA segment) som returneres av downstream systemet og sammenligner den med akseptabel ACK-kodene som er angitt i MLLP egenskaper for port-konfigurasjon. Gjeldende godkjente ACK-kodene som støttes av MLLP sende port inkluderer AA, CA, AE, CE, AR og CR. Du kan velge alle ACK-koder eller en kombinasjon av dem (AA og CA), (AA, CA, AE og CE), (AA, CA, AR og CR) som gyldig. Men det finnes ingen alternativer for å angi en akseptabel ACK-kodekombinasjonen.

En ekstra akseptabel ACK-koder -verdi som heter "Egendefinert" blir lagt til i rullegardinlisten i egenskapen Akseptabel ACK-koder . Alle tidligere kombinasjonene forblir og brukes slik den var før den nye funksjonen ble lagt til.

alternate text

alternate text

Etter at Egendefinert er valgt, må du også angi nye verdier i egenskapen Akseptabel egendefinert ACK-koder . Disse nye ACK-verdier må være atskilt med et komma (,).

Når du har installert hurtigreparasjonen, avhenger virkemåten av innstillingen for Akseptabel ACK-koder som er valgt. Hvis ACK-koden som er returnert stemmer overens med den valgte koden for akseptabel, skjer behandlingen ble. Det vil prøve på nytt for standard ACK-koder og hvilemodus for ACK-kode som ikke er oppført (som gjør det en ikke-standard eller en ikke-tilpasset ACK-kode).

Den følgende tabellen representerer dette scenariet. En skriftlig tolkning følger tabellen.

alternate text

Meldingen behandler alltid lykkes uansett noen akseptabel ACK koder innstillingen som er valgt for AA og CA. Her er mer informasjon om innstillinger for Akseptabel ACK-koder :

  • AA, CA: Forsøk AE, CE, AR CR og utsetter alle andre.

  • AA, CA, AE, CE: Godtatt og vellykket: AA, CA, AE, CE og forsøk AR og Kreditnotabeløp Innstiller alle andre.

  • AA, CA, AR CR: Godtatt og vellykket: AA, CA, AR, CR og forsøk AE og CE. Stopper alle andre.

  • AA, CA, AR, CR, AE, CE: Godtatt og vellykket: AA, CA, AR, CR, AE, CE og ingen andre returneres. Bekreftelser på nytt, og meldingen er deaktivert.

  • Egendefinert (verdier angitt og atskilt med komma). Eksempel: AA, AE, Foo, ZZ, ZZZ). Godtatt og vellykket: AA, CA, AE, pluss andre angitt egendefinert ACK som Foo, ZZ og ZZZ i dette tilfellet. Forsøk CE, AR.

  • ACK-kode som ikke er angitt i Akseptabel egendefinert ACK-koder forsøkt på nytt ikke og er deaktivert.


Når det ikke er angitt en standard ACK under Akseptable ACK-koder, returneres en feil som ligner på følgende:

Kortet kan ikke overføre meldingen skal sende port "< SendPortName >" med URL-adressen "127.0.0.1:33000". Det omadresseres etter omforsøksintervall angitt for denne Send-porten. Detaljer: "melding med MessageID: < MessageID >, mottatt med bekreftelse type: feil og Bekreftelser kode: CE.


Ut av esken ACK-skjemaet må endres ved å legge til den eksisterende listen over standard bekreftelse (AA, AE, AR, CA, CE, CR). Eventuelle ekstra akseptabel egendefinerte bekreftelse (XX, ZZ, for eksempel) må legges til MSA.1_AcknowledgementCode -feltet i SPOR-skjemaet. Hvis de ekstra egendefinerte bekreftelse ikke er lagt til skjemaet, mislykkes pipeline-valideringen med feilmeldingen "Verdi ikke funnet".


alternate text

Hvis du vil ha mer informasjon

Forutsetningene for å installere programvareoppdateringen

Hvis du vil bruke denne hurtigreparasjonen, må du ha følgende programvare installert:

  • Microsoft BizTalk Server 2013 R2

  • Microsoft BizTalk 2013 R2 Accelerator for HL7

Omstartskrav

Du har ikke datamaskinen på nytt etter at du har installert denne hurtigreparasjonen. Vi anbefaler at du lukker og åpner BizTalk-administrasjonskonsoll etter hurtigreparasjonsinstallasjonen.

Den engelskspråklige versjonen av denne hurtigreparasjonen har filattributtene (eller senere filattributter) som er oppført i følgende tabell. Datoene og klokkeslettene for disse filene er oppført i Coordinated Universal Time (UTC). Når du viser filinformasjonen, konverteres den til lokal tid. Hvis du vil finne forskjellen mellom UTC og lokal tid, kan du bruke kategorien tidssone under dato og klokkeslett i Kontrollpanel.

Filnavn

Filversjon

Filstørrelse

Dato

Tid

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 har bekreftet at dette er et problem i Microsoft-produktene som er oppført i delen "Gjelder for".

Referanser

Hvis du vil ha mer informasjon om hurtigreparasjoner for BizTalk Server, kan du se informasjon om hurtigreparasjoner for BizTalk Server.

Lær mer om standardterminologien som brukes til å beskrive oppdateringer av Microsoft-programvare.

Tredjepartsprodukter som beskrives i denne artikkelen, produseres av selskaper som er uavhengige av Microsoft. Microsoft gir ingen garantier, stilltiende eller på annen måte, om ytelsen eller påliteligheten til disse produktene.


Trenger du mer hjelp?

Utvid ferdighetene dine
Utforsk opplæring
Vær først ute med de nye funksjonene
Bli med i Microsoft Insiders

Var denne informasjonen nyttig?

Takk for tilbakemeldingen!

Takk for tilbakemeldingen! Det høres ut som det kan være lurt å sette deg i kontakt med én av våre Office-kundestøtteagenter.

×