다음을 통해 공유

어댑터 등록 파일

  • 아티클

사용자 지정 어댑터 코드가 성공적으로 빌드된 후에는 BizTalk Server 등록해야 합니다. 이렇게 하려면 적절한 어댑터 설정으로 레지스트리를 업데이트합니다. 수동으로 레지스트리 파일을 작성할 수 있지만 이 경우 복잡한 정보를 정확하게 입력해야 하기 때문에 오류가 발생하기 쉽습니다. 그보다는 어댑터 레지스트리 마법사를 실행하는 것이 좋습니다. 어댑터 레지스트리 마법사는 레지스트리 파일을 새로 만드는 것과 동일한 모든 옵션을 제공하며 파일에서 오류가 발생할 가능성을 줄입니다. 어댑터 레지스트리 마법사에 대한 자세한 내용은 어댑터 레지스트리 마법사를 참조하세요.

StaticAdapterManagement.reg 파일 및 DynamicAdapterManagement.reg 파일은 drive:\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersDevelopment\File Adapter에 있습니다<.> 이러한 파일 중 하나를 실행하면(두 번 클릭하거나 마우스 오른쪽 단추로 클릭하고 병합을 선택할 수 있음) 샘플 파일 어댑터를 레지스트리에 등록하고 어셈블리를 전역 어셈블리 캐시에 설치합니다. 사용자 지정 어댑터를 등록하려면 어댑터 레지스트리 마법사를 사용하여 새 레지스트리 파일을 만드는 것이 가장 좋습니다. 사용자 지정 정적 어댑터가 샘플 어댑터와 비슷하여 대신 기존 레지스트리 파일을 수정하려는 경우에는 StaticAdapterManagement.reg 파일을 열고 다음 속성을 수정합니다.

  • 제약 조건

  • InboundTypeName

  • InboundAssemblyPath

  • OutboundTypeName

  • OutboundAssemblyPath

  • AdapterMgmtTypeName

  • AdapterMgmtAssemblyPath

  • PropertyNameSpace

참고

OutboundAssemblyPath 및 AdapterMgmtAssemblyPath의 경우 다른 서버 위치에 설치할 때 구성이 중단될 수 있으므로 속성 값에 로컬 경로를 포함하지 않는 것이 좋습니다. 더 나은 방법은 강력한 이름을 사용하고 전역 어셈블리 캐시에 설치하는 것입니다.

어댑터 수신기, 어댑터 전송기 및 어댑터 관리를 구현하는 .NET 유형을 지정하는 옵션은 다음 두 가지가 있습니다.

  1. 폴더에 어댑터를 설치하고 *TypeName 및 *AssemblyPath를 지정합니다. 여기서 *TypeName은 클래스의 type.FullName이고 *AssemblyPath는 어셈블리의 경로와 파일 이름입니다.

  2. 전역 어셈블리 캐시에 어댑터를 설치하고 *TypeName만 지정합니다. 여기서 *TypeName은 클래스의 type.AssemblyQualifiedName입니다. 이 옵션이 권장 옵션입니다.

    모든 어댑터에는 지정된 GUID를 가진 다음 레지스트리 키가 있어야 합니다.

  • 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}"

    어댑터 프레임워크를 기반으로 하는 어댑터는 이러한 특정 GUID를 송신 및 수신 핸들러와 위치 속성 페이지에 사용해야 합니다. 어댑터가 송신 전용 어댑터인 경우 OutboundProtocol_PageProv및 TransmitLocation_PageProvGUID만 필요합니다. 마찬가지로 수신 전용 어댑터에는 InboundProtocol_PageProv 및 ReceiveLocation_PageProv GUID만 필요합니다.

    다음 코드는 StaticAdapterManagement.reg 파일에서 가져온 것이며 DynamicAdapterManagement.reg 파일의 코드도 거의 동일합니다. 각 레지스트리 속성에 대한 자세한 내용은 어댑터 등록을 참조하세요. 레지스트리 파일을 변경한 후 파일을 저장하고 실행합니다.

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

정적 샘플 어댑터를 등록하려면

  1. SDK에 있는 FILE 어댑터 샘플을 실행하는 절차를 완료합니다. 자세한 내용은 파일 어댑터(BizTalk Server 샘플)를 참조하세요.

  2. 시작을 클릭하고 모든 프로그램을 가리킨 다음 액세서리를 가리킨 다음 Windows Explorer 클릭합니다.

  3. BizTalk Server 설치 드라이브로 이동한 다음 :\Program Files\Microsoft BizTalk Server\SDK\Samples\AdaptersUsage\File Adapter로 이동합니다><drive.

  4. 샘플 어댑터를 레지스트리에 추가하려면 StaticAdapterManagement.reg를 두 번 클릭합니다. (레지스트리에 동적 파일 어댑터를 추가하려면 DynamicAdapterManagement.reg 를 대신 실행하고 다른 곳에서는 해당 파일을 적절하게 사용합니다.)

    참고

    컴퓨터의 C 드라이브에 BizTalk Server 설치되지 않은 경우 적절한 설치 경로로 StaticAdapterManagement.reg 파일을 수정해야 합니다. C: 파일을 검색하고 올바른 설치 드라이브로 바꿉다.

  5. 레지스트리 편집기 대화 상자에서 예를 클릭하여 샘플 어댑터를 레지스트리에 추가한 다음 확인을 클릭하여 대화 상자를 닫고 정보가 레지스트리에 추가되었는지 확인합니다.

  6. Windows Explorer 닫려면 파일 메뉴에서 닫기를 클릭합니다.

    이제 샘플 정적 어댑터가 BizTalk Server 등록됩니다.