Compartir a través de

Archivo de registro del adaptador

  • Artículo

Una vez que el código del adaptador personalizado se haya compilado correctamente, debe registrarse con BizTalk Server. Para ello, actualice el Registro con la configuración del adaptador adecuada. Puede escribir de forma manual un archivo de Registro, pero hay más probabilidad de errores debido a la precisión y complejidad de la información que hay que escribir. Una decisión más acertada consiste en ejecutar el Asistente para el Registro del adaptador. Este asistente le proporciona las mismas opciones de que dispone al crear un archivo de Registro nuevo y reduce la probabilidad de errores en el archivo. Para obtener más información sobre el Asistente para el Registro de adaptadores, vea Asistente para registro de adaptadores.

El archivo StaticAdapterManagement.reg y el archivo DynamicAdapterManagement.reg se encuentran en <la unidad>:\Archivos de programa\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter. Al ejecutar uno de estos archivos (puede hacer doble clic o hacer clic con el botón derecho en él y seleccionar Combinar), registra el adaptador de archivo de ejemplo con el Registro e instala el ensamblado en la caché global de ensamblados. Para registrar el adaptador personalizado, la mejor opción consiste en crear un archivo de Registro nuevo mediante el Asistente para el Registro del adaptador. Si el adaptador estático personalizado es parecido al adaptador de ejemplo y decide modificar el archivo de Registro existente, abra y modifique las propiedades siguientes en el archivo StaticAdapterManagement.reg:

  • Restricciones

  • InboundTypeName

  • InboundAssemblyPath

  • OutboundTypeName

  • OutboundAssemblyPath

  • AdapterMgmtTypeName

  • AdapterMgmtAssemblyPath

  • PropertyNameSpace

Nota

Para OutboundAssemblyPath y AdapterMgmtAssemblyPath , se recomienda no incluir la ruta de acceso local en el valor de la propiedad, ya que la configuración podría interrumpirse cuando se instala en diferentes ubicaciones del servidor. Una opción mejor consiste en utilizar un nombre seguro e instalarlo en la caché de ensamblados global.

Para especificar el tipo .NET que implementa el receptor del adaptador, el transmisor del adaptador y la administración del adaptador, existen dos opciones:

  1. Instalar el adaptador en una carpeta e indicar *TypeName y *AssemblyPath donde *TypeName es type.FullName de la clase y *AssemblyPath es la ruta y el nombre de archivo del ensamblado.

  2. Instalar el adaptador en la caché de ensamblados global y especificar sólo *TypeName donde *TypeName es type.AssemblyQualifiedName de la clase. Ésta es la opción recomendada.

    Todos los adaptadores deben tener las claves de Registro siguientes con el GUID especificado:

  • Implemented Categories\{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}"

    Los adaptadores basados en el marco de trabajo de adaptadores deben utilizar estos GUID específicos para las páginas de propiedades de ubicación y controlador de envío y recepción. Tenga en cuenta que si un adaptador es un adaptador de solo envío, solo necesita el OutboundProtocol_PageProvy TransmitLocation_PageProvGUID. De forma similar, un adaptador de solo recepción simplemente requiere los GUID de InboundProtocol_PageProv y ReceiveLocation_PageProv .

    El siguiente código pertenece al archivo StaticAdapterManagement.reg y el código del archivo DynamicAdapterManagement.reg es casi idéntico. Para obtener más información sobre cada una de las propiedades del Registro, consulte Registro de un adaptador. Después de realizar cambios en el archivo de Registro, guárdelo y ejecútelo.

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}]

Para registrar el adaptador estático de ejemplo

  1. Complete el siguiente procedimiento para ejecutar el adaptador de archivo de ejemplo del SDK. Para obtener más información, vea Adaptador de archivos (BizTalk Server ejemplo) .

  2. Haga clic en Inicio, seleccione Todos los programas, Accesorios y, a continuación, haga clic en Explorador de Windows.

  3. Vaya a la unidad de instalación para BizTalk Server y, a continuación, vaya a <drive>:\Archivos de programa\MicrosoftBizTalk Server\SDK\Samples\AdaptersUsage\File Adapter.

  4. Para agregar el adaptador de ejemplo al Registro, haga doble clic en StaticAdapterManagement.reg. (Si desea agregar el adaptador de archivo dinámico al registro, ejecute DynamicAdapterManagement.reg en su lugar y use ese archivo en cualquier otro lugar según corresponda).

    Nota

    Si BizTalk Server no está instalado en la unidad C del equipo, debe modificar el archivo StaticAdapterManagement.reg con la ruta de instalación adecuada. Busque el archivo C: y reemplácelo por la unidad de instalación correcta.

  5. En el cuadro de diálogo Editor del Registro , haga clic en Sí para agregar el adaptador de ejemplo al Registro y, a continuación, haga clic en Aceptar para cerrar el cuadro de diálogo, comprobando que la información se agregó al Registro.

  6. Para cerrar el Explorador de Windows, en el menú Archivo , haga clic en Cerrar.

    El adaptador estático de ejemplo ahora está registrado con BizTalk Server.