Comment appliquer des cartes et des codes personnalisés d’accusé de réception pour les messages d’accusé de réception dans HL7 pour BizTalk Server 2013 R2

Symptômes

Problème 1

Considérez le scénario suivant :

  • Vous exécutez Microsoft BizTalk 2013 R2 Accelerator for HL7 (BTAHL7).

  • Vous utilisez un MLLP : adaptateur de réception et un HL7 le pipeline de réception dans un texte bidirectionnel le port de réception.

  • Vous définissez l’option de l’Utilisation directe synchrone HL7 accusé de réception à True dans les propriétés de Transport de MLLP.

  • Vous créez un mappage sortant sur ce bidirectionnelle port pour transformer l’accusé de réception avant d’être envoyé de réception.


Dans ce scénario, la carte sortante n’est pas appliquée à l’accusé de réception HL7, et par conséquent l’accusé de réception n’est pas transformé.

Problème 2

Port d’envoi MLLP vérifie le code de l’accusé de réception de l’accusé de réception (le champ MSA.1_AcknowledgmentCode du segment MSA) qui est renvoyé par le système en aval et la compare avec les codes ACK acceptables qui sont définies dans les propriétés de configuration du port d’envoi MLLP. Les codes d’accusé de réception qui sont actuellement pris en charge par MLLP envoient un port CA, CA, AE, CE, AR et CR. Vous pouvez sélectionner tous les codes de l’accusé de réception ou une combinaison d'entre eux. Par exemple, les codes suivants sont tous valides :

AA et l’autorité de certification
CA, CA, AE et CE
Autorité de certification, AA, AR et CR

Toutefois, vous ne pouvez saisir tous les codes ACK acceptables supplémentaires.

Après avoir appliqué ce correctif, un nouveau code ACK acceptable qui a nommé personnalisé est ajouté dans la liste de Codes d’ACK Acceptable . En outre, une nouvelle zone de texte est ajoutée pour entrer des codes personnalisés ACK acceptables.

alternate text


alternate text


Notes

  • Les codes personnalisés doivent être séparés par une virgule (,). Par exemple : AE, CE, AR, CR, XX, ZZ

  • Si une des combinaisons standard (option non personnalisé) est sélectionnée, vous êtes inutile de taper des valeurs dans la propriété Des Codes personnalisés ACK Acceptable .

  • Pour vous assurer que la validation de pipeline réussit pour les codes d’accusé de réception personnalisés, vous devez ajouter les codes personnalisés ACK au schéma ACK correspondant.

  • Vous pouvez utiliser la fonctionnalité de suivi de BizTalk (par l’activation du suivi) pour suivre le message à l’aide de l’ID du message est enregistré dans le journal des événements lorsque le message est une nouvelle tentative ou suspendu.


Résolution

Informations de mise à jour cumulative

Ce problème a été tout d’abord été résolu dans la mise à jour cumulative suivante de BizTalk Server :


Assurez-vous que vous déployez le fichier DLL de mappage sortant requis et d’installer ce fichier DLL dans le global assembly cache (GAC) :

  1. Nom de l’assembly OutboundMap

    Cela nécessite le nom complet de l’assembly qui héberge la carte sortante. Vous pouvez trouver ces informations dans les propriétés de la carte dans la Console Administration de BizTalk Server. Vous avez trouverez les informations de l’assembly et le nom complet OutboundMap qui est requis dans l’étape suivante.

    Par exemple : sortant, Version = 1.0.0.0, Culture = neutral, PublicKeyToken = 83f92b3673c9005d

  2. Nom de OutboundMap

    Cela nécessite le nom de mappage complet, y compris l’espace de noms. Vous pouvez trouver ces informations dans les propriétés du fichier *.btm (Namespace.TypeName).

    Par exemple : Outbound.Map1

Remarque Ces propriétés sont appliquées uniquement si Direct ACK HL7 synchrone est définie sur True.

Si vous n’avez pas besoin du désassembleur HL7 (DASM) dans le Pipeline de réception HL7 pour automatiquement générer HL7 accusés de réception (par exemple l’accusé de réception qui est retourné par un système en aval est transmise au système en amont), désactivez l’option Itinéraire ACK pipeline sur le port de réception de la demande d’envoi de la partie source et affectez la valeur False Utilisation directe synchrone HL7 accusé de réception . Puis, utilisez l’option de mappage sortant qui est fournie dans le port de réception.

Problème 1

Cette nouvelle fonctionnalité s’applique uniquement à un Port de réception ou de l’emplacement. Actuellement, tout BizTalk port de réception a une propriété de Mappages de trafic entrant . Après avoir installé ce correctif, il existe une propriété supplémentaire dans l’emplacement de réception pour appliquer un mappage à un accusé de réception HL7. Cette propriété supplémentaire vous permet d’appliquer un mappage à un bidirectionnelle l’emplacement de réception dont l’Utilisation directe synchrone HL7 accusé de réception est définie à True(=). Le seul but de ce correctif doit permettre à l’utilisateur de spécifier un mappage pour un accusé de réception lors de l’Utilisation directe synchrone HL7 accusé de réception est définie sur True(=).

Après avoir installé le correctif, vous verrez deux propriétés supplémentaires dans la MLLP fenêtre de configuration de l’emplacement de réception. Le paramètre par défaut pour les deux propriétés est vide et ils doivent être remplis et Utilisation directe synchrone HL7 accusé de réception doit être définie sur True(=).

alternate text

Pour définir les deux propriétés, procédez comme suit :

  1. Propriété de Nom d’Assembly OutboundMap requiert le nom complet de l’assembly dans lequel est hébergé le mappage sortant, comme dans l’exemple suivant :

    Sortant, Version = 1.0.0.0, Culture = neutral, PublicKeyToken = 83f92b3673c9005dL’assembly doit être mis en cache précédemment par l’Assembly Global. Dans le cas contraire, la transformation échouera.

  2. Propriété de Nom de OutboundMap requiert le nom complet de la carte, notamment l’espace de noms.


Un inconvénient de cette nouvelle fonctionnalité : l’accusé de réception HL7 n’est pas suivi. Si vous devez effectuer le suivi de l’accusé de réception, vous devez également définir les Mappages de trafic entrant propriété dans BizTalk port de réception. Techniquement, vous appliquerez le mappage pour l’accusé de réception qui a été placé dans la boîte de Message et de l’accusé de réception qui a été renvoyé par le système en amont. Les deux doivent être identiques, car les deux ont le même mappage appliqué. La capture d’écran suivante est incluse pour la clarification et est nécessaire uniquement si l’accusé de réception doit être suivi.

alternate text

Remarque : L’option d’Utilisation directe synchrone HL7 accusé de réception améliore les performances de traitement de message entrant. Pour ce faire, vous devez envoyer l’accusé de réception au système en amont dès que le message est déposé dans la boîte de message. Ce paramètre améliore les performances si les conditions suivantes sont remplies :

  • Le port de réception est un port de réception bidirectionnel, et l’option d’Utilisation directe synchrone HL7 accusé de réception est définie à True dans la configuration du port de réception MLLP.

  • BizTalk HL7 DASM est utilisé pour générer l’accusé de réception. Le composant DASM doit être utilisé en tant qu’il est inclus dans la valeur par défaut BTAHL72XReceivePipeline ou à l’aide de la BTAHL7 natif. Composant de HL72fDasm dans un pipeline personnalisé.

  • Le paramètre de port de réception ACK itinéraire à un pipeline d’envoi de réponse à la demande de la partie de la Source doit être dans l’Explorateur de Configuration HL7, et le Type d’accusé de réception doit être définie sur une valeur autre que Aucun.


Problème 2

La nouvelle fonctionnalité s’applique uniquement les ports d’envoi. Après avoir installé le correctif, le comportement se fondera sur le code ACK Acceptable que vous sélectionnez dans la liste déroulante au lieu du code qui est fourni par le système en aval.

Envoyer MLLP port vérifie le code de l’accusé de réception de l’accusé de réception (champ MSA.1_AcknowledgmentCode du segment MSA) qui est renvoyé par le système en aval et la compare avec les codes ACK acceptables qui sont définies dans le MLLP d’envoyer les propriétés de configuration de port. Codes ACK acceptables en cours qui sont pris en charge par le port d’envoi de MLLP incluent AA, CA, AE, CE, AR et CR. Vous pouvez sélectionner tous les codes de l’accusé de réception ou une combinaison d'entre eux (AA et autorité de certification), (AA, CA, AE et CE), (AA, autorité de certification, AR et CR) comme étant valide. Mais il n’existe aucune option pour entrer une combinaison de code ACK acceptable.

Un autre valeur Acceptable ACK codes est intitulée « Custom » est ajoutée dans la liste déroulante la propriété Acceptable Codes d’accusé de réception . Toutes les combinaisons précédentes restent et sont appliqués tels qu’ils étaient avant que la nouvelle fonctionnalité a été ajoutée.

alternate text

alternate text

Une fois personnalisé est sélectionné, vous devez également entrer les nouvelles valeurs dans la propriété Acceptable Codes d’accusé de réception personnalisée . Ces nouvelles valeurs d’accusé de réception doivent être séparés par une virgule (,).

Après avoir installé le correctif, le comportement dépend du paramètre Acceptable Codes d’accusé de réception qui est sélectionné. Si le code de l’accusé de réception qui est renvoyé correspond à du code acceptable sélectionné, traitement s’effectue avec succès. Il va réessayer pour les codes d’accusé de réception standard et suspendre pour n’importe quel code d’accusé de réception qui n’a pas été répertorié (qui rend un non standard ou un code d’accusé de réception non personnalisé).

Le tableau suivant représente ce scénario. Une interprétation écrite suit le tableau.

alternate text

Pour l’autorité de certification et AA, toujours de traitement du message réussit, quel que soit les codes ACK acceptables la définition qui est sélectionné. Voici plus d’informations sur les paramètres Des Codes de ACK Acceptable :

  • AA, CA : Tentatives AE, CE, AR, CR et suspend toutes les autres.

  • AE, CA, CA, CE : Accepté et réussie : AA, CA, AE, CE et tentatives AR et avoirs interrompt tous les autres.

  • CR de CA, CA, AR : Accepté et réussie : AA, autorité de certification, AR, CR et tentatives AE et CE. Suspend tous les autres.

  • AA, autorité de certification, AR, CR, AE, CE : Accepté et réussie : AA, autorité de certification, AR, CR, AE, CE et aucun autre n’est retournée. Accusé de réception est relancée et message suspendu.

  • Personnalisée (les valeurs sont saisies et séparées par une virgule). Exemple : AA, AE, Foo, ZZ, ZZZ). Accepté et réussie : AA, CA, AE ainsi que toutes les autres entrées ACK personnalisé comme Foo, ZZ et ZZZ dans ce cas. Nouvelles tentatives CE, comptabilité

  • Tout code d’accusé de réception qui n’est pas spécifié dans les Codes de ACK Acceptable personnalisé n’est pas relancé et est interrompue.


Lorsqu’un accusé de réception standard n’est pas entrée sous Les Codes ACK Acceptable, une erreur semblable à la suivante est renvoyée :

La carte n’a pas pu transmettre le message destiné à le «< SendPortName >» avec l’URL « 127.0.0.1:33000 » de port d’envoi. Il va être retransmis après l’intervalle avant nouvelle tentative spécifié pour ce Port d’envoi. Détails : "Message avec MessageID : < MessageID >, reçu avec le type d’accusé de réception : erreur avec le code de l’accusé de réception : CE.


Le schéma d’ACK-de-l’emploi doit être modifié en ajoutant à la liste existante des accusés de réception standard (AA, AE, AR, CA, CE, CR). Les plus acceptables personnalisés les accusés de réception (XX, ZZ, par exemple) doivent être ajoutés au champ MSA.1_AcknowledgementCode du schéma de l’accusé de réception. Si les accusés de réception personnalisées supplémentaires ne sont pas ajoutés au schéma, la validation de pipeline échoue avec une erreur « Valeur de Table introuvable ».


alternate text

Plus d'informations

Conditions préalables à l’installation de la mise à jour de logiciel

Pour appliquer ce correctif, vous devez disposer des logiciels suivants :

  • Microsoft BizTalk Server 2013 R2

  • Microsoft BizTalk 2013 R2 Accelerator pour HL7

Nécessité d’un redémarrage

Vous n’êtes pas obligé de redémarrer l’ordinateur après avoir appliqué ce correctif. Toutefois, nous recommandons que vous fermez et rouvrez la Console d’administration BizTalk après l’installation du correctif.

La version anglaise de ce correctif dispose des attributs de fichier (ou version ultérieure) répertoriés dans le tableau suivant. Les dates et heures de ces fichiers sont répertoriées en temps universel coordonné (UTC). Lorsque vous affichez les informations de fichier, elles sont converties en heure locale. Pour trouver la différence entre l’UTC et l’heure locale, utilisez l’onglet fuseau horaire dans l’élément de Date et heure dans le panneau de configuration.

Nom de fichier

Version de fichier

Taille du fichier

Date

Heure

Plateforme

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


État

Microsoft a confirmé l'existence de ce problème dans les produits Microsoft répertoriés dans la section « S'applique à ».

Références

Pour plus d’informations sur les correctifs de BizTalk Server, consultez les informations sur les correctifs de BizTalk Server.

Obtenir des informations sur la terminologie standard qui est utilisée pour décrire les mises à jour logicielles de Microsoft.

Les produits tiers dont traite cet article sont fabriqués par des sociétés indépendantes de Microsoft. Microsoft exclut toute forme de garantie, expresse ou implicite, concernant les performances ou la fiabilité de ces produits.


Besoin d’aide ?

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoindre Microsoft Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×