Partager via

Fichier d'inscription de l'adaptateur

  • Article

Une fois que le code de l’adaptateur personnalisé a été correctement généré, il doit être inscrit auprès de BizTalk Server. Pour ce faire, il convient de mettre à jour le Registre à l'aide des paramètres appropriés de l'adaptateur. Vous pouvez écrire manuellement un fichier de Registre, mais il y a un risque d'erreurs en raison de la précision et de la complexité des informations que vous devrez entrer. Il est conseillé d'exécuter l'Assistant Registre d'adaptateur. Cet Assistant vous propose les mêmes options que si vous génériez un fichier de Registre en partant de zéro et il réduit le risque d'erreurs dans le fichier. Pour plus d’informations sur l’Assistant Registre d’adaptateurs, consultez Assistant Registre d’adaptateurs.

Les fichiers StaticAdapterManagement.reg et DynamicAdapterManagement.reg se trouvent dans <drive> :\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter. Lorsque vous exécutez l’un de ces fichiers (vous pouvez double-cliquer dessus ou cliquer dessus avec le bouton droit et sélectionner Fusionner), il inscrit l’exemple d’adaptateur de fichiers auprès du Registre et installe l’assembly dans le global assembly cache. Pour enregistrer votre adaptateur personnalisé, la meilleure méthode consiste à créer un fichier de Registre en utilisant l'Assistant Registre d'adaptateur. Si votre adaptateur statique personnalisé est identique à l'adaptateur exemple, et que vous décidiez à la place de modifier le fichier de Registre existant, ouvrez le fichier StaticAdapterManagement.reg et modifiez les propriétés suivantes :

  • Contraintes

  • InboundTypeName

  • InboundAssemblyPath

  • OutboundTypeName

  • OutboundAssemblyPath

  • AdapterMgmtTypeName

  • AdapterMgmtAssemblyPath

  • PropertyNameSpace

Notes

Pour OutboundAssemblyPath et AdapterMgmtAssemblyPath , nous vous recommandons de ne pas inclure le chemin d’accès local dans la valeur de propriété, car la configuration peut s’interrompre lorsqu’elle est installée sur différents emplacements de serveur. Il vaut mieux utiliser un nom fort et l'installer dans le GAC (Global Assembly Cache).

Vous avez deux possibilités pour spécifier le type .NET implémentant le récepteur de l'adaptateur, l'émetteur de l'adaptateur et la gestion de l'adaptateur :

  1. Installez l'adaptateur dans un dossier et spécifiez *TypeName et *AssemblyPath où *TypeName correspond à type.FullName de la classe et *AssemblyPath est le chemin d'accès et le nom de fichier de l'assembly.

  2. Installez l'adaptateur dans le GAC et spécifiez uniquement *TypeName, où *TypeName correspond au type.AssemblyQualifiedName de la classe. C'est l'option recommandée.

    Tous les adaptateurs doivent avoir les clés de Registre suivantes avec le GUID spécifié :

  • Catégories implémentées\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}

  • "InboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A281}"

  • "OutboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A283}"

  • "ReceiveLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A280}"

  • "TransmitLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A282}"

    Les adaptateurs basés sur la structure d'adaptateur doivent utiliser ces GUID spécifiques pour le gestionnaire d'envoi et de réception et les pages de propriétés de l'emplacement. Notez que si un adaptateur est un adaptateur d’envoi uniquement, il a simplement besoin de l’OutboundProtocol_PageProvet TransmitLocation_PageProvGUID. De même, une carte de réception seule nécessite simplement le InboundProtocol_PageProv et ReceiveLocation_PageProv GUID.

    Le code suivant est issu du fichier StaticAdapterManagement.reg et le code correspondant au fichier DynamicAdapterManagement.reg est quasiment identique. Pour plus d’informations sur chacune des propriétés du Registre, consultez Inscription d’un adaptateur. Après avoir apporté les modifications nécessaires au fichier de Registre, enregistrez le fichier et exécutez-le.

Windows Registry Editor Version 5.00  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}]  
@="Static DotNetFile Adapter"  
"AppID"="{12A6EBAA-CF68-4B58-B36E-A5A19B22C04E}"  
  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\BizTalk]  
@="BizTalk"  
"TransportType"="Static DotNetFile"  
"Constraints"=dword:00003C0b  
  
"InboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A281}"  
"OutboundProtocol_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A283}"  
"ReceiveLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A280}"  
"TransmitLocation_PageProv"="{2DE93EE6-CB01-4007-93E9-C3D71689A282}"  
  
"InboundEngineCLSID"="{3D4B599E-2202-4bbb-9FC6-7ACA3906E5DE}"  
"InboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileReceiver""InboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll"  
"OutboundEngineCLSID"="{024DB758-AAF9-415e-A121-4AC245DD49EC}"  
"OutboundTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.DotNetFileTransmitter""OutboundAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Runtime\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Runtime.dll""AdapterMgmtTypeName"="Microsoft.BizTalk.SDKSamples.Adapters.Designtime.StaticAdapterManagement""AdapterMgmtAssemblyPath"="C:\\Program Files\\Microsoft BizTalk Server <version>\SDK\\Samples\\AdaptersDevelopment\\File Adapter\\Design Time\\Adapter Management\\bin\\Debug\\Microsoft.BizTalk.SDKSamples.Adapters.DotNetFile.Designtime.dll""PropertyNameSpace"="http://schemas.microsoft.com/BizTalk/2003/SDK_Samples/Messaging/Transports/dotnetfile-properties"  
"AliasesXML"="<AdapterAliasList><AdapterAlias>DotNetFILE://</AdapterAlias></AdapterAliasList>"  
"ReceiveHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"SendHandlerPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"ReceiveLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
"SendLocationPropertiesXML"="<CustomProps><AdapterConfig vt=\"8\"/></CustomProps>"  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories]  
[HKEY_CLASSES_ROOT\CLSID\{62018D08-281A-415b-A6D3-6172E3762867}\Implemented Categories\{7F46FC3E-3C2C-405B-A47F-8D17942BA8F9}]

Pour enregistrer l'exemple d'adaptateur statique

  1. Effectuez la procédure pour exécuter l'exemple d'adaptateur de fichier dans le SDK. Pour plus d’informations, consultez Adaptateur de fichier (exemple BizTalk Server) .

  2. Cliquez sur Démarrer, pointez sur Tous les programmes, sur Accessoires, puis cliquez sur Windows Explorer.

  3. Accédez au lecteur d’installation pour BizTalk Server, puis accédez à <drive>:\Program Files\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter.

  4. Pour ajouter l’exemple d’adaptateur au Registre, double-cliquez sur StaticAdapterManagement.reg. (Si vous souhaitez ajouter l’adaptateur de fichiers dynamiques au Registre, exécutez DynamicAdapterManagement.reg à la place et utilisez ce fichier partout ailleurs, le cas échéant.)

    Notes

    Si BizTalk Server n’est pas installé sur le lecteur C de votre ordinateur, vous devez modifier le fichier StaticAdapterManagement.reg avec le chemin d’installation approprié. Recherchez C : dans le fichier et remplacez-le par le lecteur d’installation approprié.

  5. Dans la boîte de dialogue Éditeur du Registre , cliquez sur Oui pour ajouter l’exemple d’adaptateur au Registre, puis cliquez sur OK pour fermer la boîte de dialogue, en vérifiant que les informations ont été ajoutées au Registre.

  6. Pour fermer Windows Explorer, dans le menu Fichier, cliquez sur Fermer.

    L’exemple d’adaptateur statique est désormais inscrit auprès de BizTalk Server.