통합된 BizTalk 어댑터의 구성 속성

아티클
05/04/2023

BizTalk Explorer 개체 모델은 이름/값 쌍 XML 문자열 형식으로 어댑터 구성 속성 모음을 포함하는 IReceiveLocation.CustomData 및 ISendPort.CustomData 속성을 노출합니다. 이 이름/값 쌍 XML 문자열은 바인딩 파일의 <TransportTypeData> 요소 내의 <CustomProps> 요소에 저장됩니다. CustomProps> 요소의 대부분의 정보는 <BizTalk Server 사용자 인터페이스의 어댑터에 대해 설정할 수 있는 정보(예: BizTalk 관리 콘솔 또는 BizTalk Explorer)에 해당합니다. 이러한 값이 바인딩 파일에 있으면 바인딩 파일을 가져올 때 지정한 수신 위치 및 송신 포트의 어댑터 구성에 해당 값이 적용됩니다. 모든 어댑터의 구성 정보는 Single Sign-On 데이터베이스에 저장됩니다.

이 섹션에서는 통합된 각 BizTalk 어댑터에 설정할 수 있는 구성 속성에 대해 설명합니다.

참고

바인딩 파일의 <TransportTypeData> 요소에 저장된 암호 정보는 중요한 데이터가 명확한 텍스트로 저장되지 않도록 마스킹됩니다. 전송에 따라 암호 정보가 NULL로 바뀌거나 별표로 바뀝니다. 바인딩 파일을 대상 BizTalk Server 구성으로 가져오기 전에 바인딩 파일에 수동으로 이 정보를 입력하여 어댑터 구성을 업데이트해야 합니다.

어댑터 프레임워크를 사용하여 빌드된 어댑터의 구성 데이터는 AdapterConfig> 요소에 <저장됩니다. <AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식 < > 을 지정하므로 이 요소에 포함된 문자는 이스케이프되어야 하며 바인딩 파일을 가져오려고 할 때 오류가 발생합니다. 이로 인해 구성 데이터의 텍스트가 해당 문자를 이스케이프하지 않은 경우보다 읽기 어려운 상태가 됩니다. 다음 예에서는 POP3 어댑터에 바인딩된 송신 포트의 샘플 구성 데이터에서 이러한 문자를 이스케이프할 때의 결과를 보여 줍니다.

AdapterConfig> 요소에 <사용되는 문자를 이스케 <> 이프하지 않는 TransportTypeData 구성 데이터

AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식을 지정하고><AdapterConfig> 요소에 <포함된 문자는 이스케이프되지 않으므로 이 구성 데이터는 유효<하지 않습니다.

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
<mailServer>test.microsoft.com</mailServer>  
<serverPort>0</serverPort>  
<userName>testuser</userName>  
<password>******</password>  
<authenticationScheme>Basic</authenticationScheme>  
<sslRequired>false</sslRequired>  
<applyMIME>true</applyMIME>  
<bodyPartContentType>text/xml</bodyPartContentType>  
<bodyPartIndex>1</bodyPartIndex>  
<errorThreshold>10</errorThreshold>  
<pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure>   
<uri>POP3://test.microsoft.com#testuser</uri>  
</Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

AdapterConfig> 요소에 <사용되는 문자를 이스케 <> 이프하는 TransportTypeData 구성 데이터

<AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식 <> 을 지정하므로 아래와 같이 AdapterConfig> 요소에서 <문자를 이스케이프해야 합니다.

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
xmlns:xsd="http://www.w3.org/2001/XMLSchema"><mailServer>test  
microsoft.com</mailServer><serverPort>0</serverPort>&  
lt;userName>testuser</userName><password>******</pass  
word><authenticationScheme>Basic</authenticationScheme>&  
lt;sslRequired>false</sslRequired><applyMIME>true</ap  
plyMIME><bodyPartContentType>text/xml</bodyPartContentType&  
gt;<bodyPartIndex>1</bodyPartIndex><errorThreshold>10  
</errorThreshold><pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure><uri  
>POP3://test.microsoft.com#testuser</uri></Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

어댑터 프레임워크를 사용하여 만든 통합된 어댑터에는 다음이 포함됩니다.

FTP 어댑터
MQSeries 어댑터
MSMQ 어댑터
POP3 어댑터
Windows SharePoint Services 어댑터

각 통합된 어댑터의 TransportTypeData 구성 데이터로 사용되는 샘플 문자열을 보려면 이 섹션의 해당 어댑터와 관련된 구성 속성 항목을 참조하십시오.