어댑터 구성 스키마
디자인 타임의 어댑터 구성에는 다양한 유형의 스키마가 사용됩니다. 속성 값의 표시 유형 및 범위에 따라 각기 다른 스키마가 수정되고 사용됩니다.
핸들러 스키마
핸들러에서 가져온 어댑터 구성은 어댑터 및 전역 범위의 모든 어댑터 사용자에게 적용됩니다. 관리자는 BizTalk Server 관리 콘솔을 사용하여 어댑터의 수신 또는 송신 처리기를 확장하고 지정된 호스트의 속성을 가져와 디자인 타임에 처리기 구성을 정적으로 변경할 수 있습니다.
SDK에 포함된 샘플 파일 어댑터에는 수신 위치, 송신 포트, 수신 핸들러 및 송신 핸들러를 구성하는 데 사용하는 일련의 XSD 파일이 있습니다. 이러한 XSD 파일을 수정하여 사용자 지정 어댑터가 어댑터에 필요한 구성 속성을 받도록 합니다. 샘플 파일 어댑터에 포함된 파일 중 수정해야 할 파일은 TransmitHandler.xsd와 ReceiveHandler.xsd 스키마 파일입니다. 이러한 파일은 BizTalk Server 관리 콘솔에서 처리기를 구성하는 데 사용되는 속성 페이지를 제어하여 송신 처리기 및 수신 처리기를 각각 구성합니다.
어댑터 요구 사항을 사용하여 각 엔드포인트에 필요한 구성 속성 목록을 만듭니다. 모든 구성 속성이 전역 속성인 경우에는 송신 및 수신 포트 구성만 수정하면 됩니다. 각 송신 포트 또는 수신 포트마다 어댑터 속성을 설정해야 하는 경우 수신 위치 및 송신 포트 구성 파일도 함께 수정해야 합니다.
어댑터 프레임워크는 일반적인 어댑터 구성 요구 사항을 지원하는 스키마 확장 및 고급 구성 옵션을 제공합니다. 뿐만 아니라 샘플 파일 어댑터에 포함된 스키마에 없는 확장도 제공합니다. 어댑터 프레임워크 스키마 확장에 대한 자세한 내용은 어댑터 프레임워크 구성 스키마 확장을 참조하세요. 사용자 지정 드롭다운 편집기 및 사용자 지정 형식 변환기와 같은 고급 구성 옵션에 대한 자세한 내용은 어댑터용 고급 구성 구성 요소를 참조하세요.
이 항목 끝에 나오는 코드는 TransmitHandler.xsd 파일에서 가져온 것이며 다음과 같은 속성 페이지를 생성합니다.
TransmitHandler.xsd 파일로 만든 송신 핸들러 속성 페이지
아래에 표시된 TransmitHandler.xsd 코드에서 baf:designer>, baf:displayname> 및 <baf:description> 태그를 사용합니다<<. 이러한 태그는 속성 페이지가 더 빠르게 생성되도록 어댑터 프레임워크에서 제공하는 사용자 지정 데코레이션입니다.
어댑터 프레임워크 내에서 사용할 수 있는 모든 장식 목록은 어댑터 프레임워크 구성 스키마 장식 태그를 참조하세요.
이 스키마에는 요소가 하나만 포함되며 URI 요소는 포함되지 않습니다.
중요
중요한 고객 데이터를 기본 어댑터 스키마에 저장하지 마십시오. 보안상의 이유로 사용자 이름 및 암호 정보는 어댑터를 배포한 후에만 구성해야 합니다. 그러면 정보가 Enterprise SSO(Single Sign-On) 데이터베이스에 저장됩니다. SSO 데이터베이스에 대한 자세한 내용은 SSO 사용을 참조하세요.
<?xml version="1.0" encoding="utf-16"?>
<xs:schema xmlns:baf="BiztalkAdapterFramework.xsd"
xmlns:b="http://schemas.microsoft.com/BizTalk/2003"
xmlns="http://tempuri.org/XMLSchema1.xsd"
elementFormDefault="qualified" targetNamespace="http://tempuri.org/XMLSchema1.xsd"
id="TransmitHandler" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Config">
<xs:complexType>
<xs:sequence>
<xs:element default="50" name="sendBatchSize" type="xs:int" >
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname _locID="sendBatchSizeName">Batch Size</baf:displayname>
<baf:description _locID="sendBatchSizeDesc">Enter the
maximum number of files to be transmitted per batch</baf:description>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element default="4096" name="bufferSize" type="xs:int" >
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname _locID="bufferSizeName">Write Buffer Size</baf:displayname>
<baf:description _locID="bufferSizeDesc">Enter the size of
the buffer used to write the file</baf:description>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element default="1" name="threadsPerCPU" type="xs:int" >
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname _locID="threadsPerCPUName">Threads Per CPU</baf:displayname>
<baf:description _locID="threadsPerCPUDesc">Enter the
number of threads per CPU to execute in the thread pool</baf:description>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
송신 포트 및 수신 위치 스키마
어댑터에 포트 관련 속성을 설정하려면 수신 위치 및 송신 포트 구성 스키마를 수정합니다. TransmitLocation.xsd 및 ReceiveLocation.xsd 스키마 파일은 각각 송신 포트와 수신 위치를 구성합니다.
어댑터 프레임워크는 일반적인 어댑터 구성 요구 사항을 지원하는 스키마 확장 및 고급 구성 옵션을 제공합니다. 어댑터 프레임워크 스키마 확장에 대한 자세한 내용은 어댑터 프레임워크 구성 스키마 확장을 참조하세요. 사용자 지정 드롭다운 편집기 및 사용자 지정 형식 변환기와 같은 고급 구성 옵션에 대한 자세한 내용은 어댑터용 고급 구성 구성 요소를 참조하세요.
아래에 나오는 코드는 TransmitLocation.xsd 파일에서 가져온 것이며 다음과 같은 속성 페이지를 생성합니다.
샘플 파일 어댑터의 송신 포트 속성 페이지
아래의 TransmitLocation.xsd 파일에서 송신 포트 구성에는 송신 처리기와 마찬가지로 baf:designer>, baf:displayname> 및 <baf:description> 태그가 포함되어 <있으며 baf:category> 태그도 사용합니다<<. category 태그를 사용하면 속성을 그룹화할 수 있습니다. 범주가 둘 이상이면 범주를 확장하거나 축소할 수 있습니다. 범주는 해당 범주의 속성 위쪽에 회색 헤더로 표시됩니다. 자세한 내용은 어댑터 프레임워크 구성 스키마 확장을 참조하세요.
이 스키마에는 URI 필드도 포함됩니다. URI 필드는 송신 포트 속성 페이지의 모든 필드에 정보를 입력한 후 어댑터가 유효성 검사를 수행하는 동안 나타나는 페이지에서 채워집니다.
<?xml version="1.0" encoding="utf-16"?>
<xs:schema xmlns:baf="BiztalkAdapterFramework.xsd" xmlns:b="http://schemas.microsoft.com/BizTalk/2003" xmlns="http://tempuri.org/XMLSchema1.xsd" elementFormDefault="qualified" targetNamespace="http://tempuri.org/XMLSchema1.xsd" id="TransmitLocation" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Config">
<xs:complexType>
<xs:sequence>
<xs:element name="directory" type="xs:string">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="sendDirectoryName">Directory</baf:displayname>
<baf:description _locID="sendDirectoryDesc">Directory to write the file to</baf:description>
<baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element default="%MessageID%.xml" name="fileName" type="xs:string">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="fileNameName">File Name</baf:displayname>
<baf:description _locID="fileNameDesc">The name of the file that will be written</baf:description>
<baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element default="2" name="fileCopyMode" type="CopyMode">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="fileCopyModeName">File Mode</baf:displayname>
<baf:category _locID="transmitLocationCategory">Transmit Location</baf:category>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element name="uri" type="xs:string">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:browsable show="false" />
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<!-- An example of how an SSO affiliate application would be configured for this endpoint: -->
<!--
<xs:element name="ssoAffiliateApplication" type="baf:SSOList">
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname _locID="ssoAffiliateApplicationName">SSO Affiliate</baf:displayname>
<baf:description _locID="ssoAffiliateApplicationDesc">The Single Sign On (SSO) Affiliate Application</baf:description>
<baf:category _locID="ftpCategory">FTP</baf:category>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
-->
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:simpleType name="CopyMode">
<xs:restriction base="xs:int">
<xs:enumeration value="0">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="appendName">Append</baf:displayname>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="1">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="createName">Create</baf:displayname>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="2">
<xs:annotation>
<xs:appinfo>
<baf:designer xmlns:baf="BiztalkAdapterFramework.xsd">
<baf:displayname _locID="createNewName">CreateNew</baf:displayname>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:schema>