FTP 어댑터 구성 속성
다음 표는 FTP 어댑터 수신 위치에 대해 프로그래밍 방식으로 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| uri | VT_BSTR | 수신 위치에서 모니터링하는 위치의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| serverAddress | VT_BSTR | FTP 서버의 이름이나 IP 주소를 지정합니다. | 없음 | 없음 |
| serverPort | VT_BSTR | 대상 FTP 서버와 통신할 때 사용할 TCP 포트를 지정합니다. | 없음 | 없음 |
| userName | VT_BSTR | FTP 서버에 액세스할 때 사용할 사용자 이름을 지정합니다. | 없음 | 없음 |
| password | VT_BSTR | FTP 서버에 액세스할 때 사용할 암호를 지정합니다. | 이 값은 바인딩 파일을 내보낼 때 항상 마스크됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 가져오기 전에 이 속성에 대해 직접 암호를 입력해야 합니다. | 없음 |
| fileMask | VT_BSTR | 파일을 전송할 때 사용할 파일 마스크 필터를 지정합니다. | 없음 | 없음 |
| targetFolder | VT_BSTR | FTP 서버의 폴링 위치를 지정합니다. | 없음 | 없음 |
| commandLogFilename | VT_BSTR | 로그 파일의 복사본을 저장할 위치를 지정합니다. | 없음 | FTP 어댑터를 통해 파일을 보내거나 받을 때 오류 상태를 진단하는 데 이 파일을 사용합니다. |
| representationType | VT_BSTR | FTP 어댑터에서 데이터를 수신하는 방법을 선택합니다. | 유효한 값은 다음과 같습니다. - 이진 - ASCII |
기본값은 Binary입니다. |
| spoolingFolder | VT_BSTR | FTP 서버의 임시 폴더 위치를 지정합니다. 전송 오류를 복구하는 데 이 위치를 사용합니다. | 없음 | 없음 |
| receiveDataTimeOut | VT_BSTR | 수신 통화가 중단될 때까지의 시간을 밀리초 단위로 지정합니다. 이 값은 느린 서버로 인해 수신 위치가 중단되는 것을 방지하기 위해 사용합니다. | 없음 | 기본값은 90000입니다. |
| maximumBatchSize | VT_BSTR | BizTalk Server 일괄 처리당 최대 바이트 수를 지정합니다. | 없음 | 없음 |
| maximumNumberOfFiles | VT_BSTR | BizTalk Server 일괄 처리당 최대 파일 수를 지정합니다. | 없음 | 없음 |
| passiveMode | VT_BSTR | 어댑터를 FTP 서버에 연결할 때의 모드를 지정합니다. | 유효한 값은 다음과 같습니다. -수동 - 활성 |
기본값은 Active입니다. |
| useNLST | VT_BSTR | 시스템에서 정의된 기본 파일 목록 대신 파일 이름만 검색하려면 이 값을 Yes로 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 No입니다. |
| beforeGet | VT_BSTR | 파일을 가져오기 전에 실행할 FTP 명령을 지정합니다. | 세미콜론을 사용하여 명령 분리(;) 참고: QUIT 명령은 GET 파일 전에 지원되지 않습니다. | 없음 |
| afterGet | VT_BSTR | 파일을 가져온 후에 실행할 FTP 명령을 지정합니다. | 명령이 여러 개인 경우 각 명령을 세미콜론(;)으로 구분해야 합니다. | 없음 |
| firewallType | VT_BSTR | 배포된 방화벽 유형을 지정합니다. | 유효한 값은 다음과 같습니다. - None - 양말 4 - 양말 5 |
기본값은 None입니다. |
| firewallAddress | VT_BSTR | 방화벽 주소(DNS 이름 또는 IP 주소)를 지정합니다. | 없음 | 없음 |
| firewallPort | VT_BSTR | 방화벽 포트를 지정합니다. | 유효한 값은 1에서 65535까지입니다. | 기본값은 21입니다. |
| firewallUserName | VT_BSTR | 방화벽의 사용자 이름을 지정합니다. | 없음 | 없음 |
| firewallPassword | VT_BSTR | 방화벽 암호를 지정합니다. | 없음 | 없음 |
| pollingUnitOfMeasure | VT_BSTR | pollingInterval 속성의 단위 유형을 지정합니다. | 유효한 값은 다음과 같습니다. -초 -분 -시간 -일 |
기본값은 Seconds입니다. |
| pollingInterval | VT_BSTR | 이 위치를 폴링하는 간격 값을 지정합니다. | 없음 | 폴링을 계속하려면 이 값을 0으로 설정합니다. 기본값은 60입니다. |
| redownloadInterval | VT_BSTR | FTP 어댑터가 파일을 다시 다운로드하는 시간 간격을 초 단위로 지정합니다. | 이 속성은 deleteAfterDownload 및 enableTimeComparison 속성이 모두 No로 설정되어 있는 경우에 적용됩니다. | -1 값은 어댑터가 파일을 다시 다운로드하지 않을 것임을 나타냅니다. 기본값은 -1입니다. |
| ssoAffiliateApplication | VT_BSTR | SSO(Single Sign-On) 관련 응용 프로그램을 지정합니다. | 없음 | 없음 |
| errorThreshold | VT_BSTR | 위치 설정을 해제하기 전 BizTalk Server에서 발생할 수 있는 오류 수를 지정합니다. | 없음 | 기본값은 10입니다. |
| maxFileSize | VT_BSTR | 다운로드할 수 있는 최대 파일 크기(MB)를 지정합니다. | 없음 | 값 0은 파일 크기에 제한이 없음을 나타냅니다. 기본값은 100입니다. |
| useSsl | VT_BSTR | FTP 어댑터에서 FTPS 서버와 통신할 때 SSL을 사용해야 하는 경우 이 값을 Yes로 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 No입니다. |
| useDataProtection | VT_BSTR | FTP 어댑터가 FTPS 서버와 파일을 주고받을 때 SSL 암호화를 사용해야 하는 경우 이 값을 Yes로 지정합니다. | useSsl 속성이 Yes로 설정되어 있으면 이 속성이 유효합니다. 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 Yes입니다. |
| ftpsConnMode | VT_BSTR | FTPS 서버에 대한 SSL 연결의 모드를 지정합니다. | 유효한 값은 다음과 같습니다. - 명시적 -암시적 |
기본값은 Explicit입니다. |
| clientCertificateHash | VT_BSTR | SSL 협상에 사용해야 하는 클라이언트 인증서의 SHA1 해시를 지정합니다. | 없음 | 이 해시를 기반으로 BizTalk 호스트 인스턴스를 실행하는 사용자 계정의 개인 저장소에서 클라이언트 인증서가 선택됩니다. |
| deleteAfterDownload | VT_BSTR | 다운로드가 완료된 후 어댑터가 FTP 서버에서 파일을 삭제해야 하는 경우 이를 예로 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 Yes입니다. |
| enableTimeComparison | VT_BSTR | 파일의 타임스탬프가 변경되었을 때 어댑터가 파일을 다시 다운로드해야 하는 경우 이 값을 Yes로 지정합니다. | 이 속성은 deleteAfterDownload가 No로 설정된 경우에만 유효합니다. 대상 FTP 서버는 이 기능에 대해 MDTM 명령을 지원해야 합니다. 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 No입니다. |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><uri>ftp://localhost:21/in/*.xml</uri><serverAddress>localhost</serverAddress><serverPort>21</serverPort><userName>domain\testuser</userName><password>******</password><fileMask>*.xml</fileMask><targetFolder>in</targetFolder><commandLogFilename>c:\temp\realftplog.txt</commandLogFilename><representationType>binary</representationType><maximumBatchSize>0</maximumBatchSize><maximumNumberOfFiles>0</maximumNumberOfFiles><passiveMode>False</passiveMode><firewallType>NoFirewall</firewallType><firewallPort>21</firewallPort><pollingUnitOfMeasure>Seconds</pollingUnitOfMeasure><pollingInterval>5</pollingInterval><errorThreshold>10</errorThreshold><maxFileSize>5000</maxFileSize><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><deleteAfterDownload>True</deleteAfterDownload><enableTimeComparison>False</enableTimeComparison></Config></AdapterConfig></CustomProps>
다음 표는 FTP 어댑터 송신 포트에 설정할 수 있는 구성 속성을 보여 줍니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| uri | VT_BSTR | 데이터를 보낼 위치의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| serverAddress | VT_BSTR | 방화벽 주소(DNS 이름 또는 IP 주소)를 지정합니다. | 없음 | 없음 |
| serverPort | VT_BSTR | FTP 서버의 포트 주소를 지정합니다. | 없음 | 기본값은 21입니다. |
| userName | VT_BSTR | FTP 서버에 로그온할 때 사용할 사용자 이름을 지정합니다. | 없음 | 없음 |
| password | VT_BSTR | FTP 서버에 로그온할 때 사용할 암호를 지정합니다. | 이 값은 바인딩 파일을 내보낼 때 항상 마스크됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 가져오기 전에 이 속성에 대해 직접 암호를 입력해야 합니다. | 없음 |
| accountName | VT_BSTR | FTP 서버의 계정 이름을 지정합니다. | 선택 사항 | 없음 |
| targetFolder | VT_BSTR | FTP 서버에서 파일을 이동할 위치를 지정합니다. | 없음 | 없음 |
| targetFileName | VT_BSTR | 파일의 대체 이름을 지정합니다. 기본 이름을 유지하면 전송되는 각 메시지에 고유한 메시지 이름이 지정됩니다. | 없음 | 기본값은 %MessageID%.xml입니다. |
| commandLogFilename | VT_BSTR | 로그 파일의 복사본을 저장할 위치를 지정합니다. FTP 서버를 통해 파일을 송수신할 때 이 로그 파일을 사용하여 오류 조건을 진단합니다. | 없음 | 없음 |
| representationType | VT_BSTR | FTP의 데이터 송신 방법(이진 또는 ASCII)을 선택합니다. | 유효한 값은 다음과 같습니다. -이진 - ASCII |
기본값은 binary입니다. |
| beforePut | VT_BSTR | FTP 서버에서 기본값을 변경하는 명령 등과 같이 파일을 넣기 전에 실행할 FTP 명령을 지정합니다. | 세미콜론(;)으로 명령을 구분합니다. 참고: QUIT 명령은 PUT 파일 이전에 지원되지 않습니다. | 열기 명령은 필요하지 않습니다. |
| afterPut | VT_BSTR | 파일을 넣은 후에 실행할 FTP 명령을 지정합니다. | 세미콜론(;)으로 명령을 구분합니다. | 없음 |
| allocateStorage | VT_BSTR | 레거시 호스트 시스템에 저장 공간을 할당할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 No입니다. |
| spoolingFolder | VT_BSTR | FTP 서버의 임시 폴더 위치를 지정합니다. 전송 모드가 이진인 경우 전송 오류로부터 확실히 복구하려면 이 설정을 사용합니다. 전송 모드가 ASCII인 경우에는 어댑터가 업로드를 다시 시작합니다. | 없음 | 없음 |
| connectionLimit | VT_BSTR | 서버에서 열 수 있는 최대 동시 FTP 연결 수를 지정합니다. | 없음 | 값 0은 제한이 없음을 의미합니다. |
| passiveMode | VT_BSTR | 수동 모드를 사용할 것인지 활성 모드를 사용할 것인지 지정합니다. | 유효한 값은 다음과 같습니다. - True(수동 모드) - False(활성 모드) |
기본값은 False(활성 모드)입니다. |
| firewallType | VT_BSTR | 배포된 방화벽의 유형을 선택합니다. | 유효한 값은 다음과 같습니다. - 양말 4 - 양말 5 - None |
기본값은 None입니다. |
| firewallAddress | VT_BSTR | 방화벽 주소(DNS 이름 또는 IP 주소)를 지정합니다. | 없음 | 없음 |
| firewallPort | VT_BSTR | 방화벽 포트를 지정합니다. | 유효한 값은 1에서 65535까지입니다. | 기본값은 21입니다. |
| firewallUserName | VT_BSTR | 방화벽의 사용자 이름을 지정합니다. | 없음 | 없음 |
| firewallPassword | VT_BSTR | 방화벽 암호를 지정합니다. | 이 값은 바인딩 파일을 내보낼 때 항상 마스크됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 가져오기 전에 이 속성에 대해 직접 암호를 입력해야 합니다. | 없음 |
| ssoAffiliateApplication | VT_BSTR | SSO(Single Sign-On) 관련 응용 프로그램을 지정합니다. | 없음 | 없음 |
| useSsl | VT_BSTR | FTP 어댑터에서 FTPS 서버와 통신할 때 SSL을 사용해야 하는 경우 이 값을 Yes로 지정합니다. | 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 No입니다. |
| useDataProtection | VT_BSTR | FTP 어댑터가 FTPS 서버와 파일을 주고받을 때 SSL 암호화를 사용해야 하는 경우 이 값을 Yes로 지정합니다. | useSsL이 Yes로 설정되어 있으면 이 속성이 유효합니다. 유효한 값은 다음과 같습니다. -예 -아니요 |
기본값은 Yes입니다. |
| ftpsConnMode | VT_BSTR | FTPS 서버에 대한 SSL 연결의 모드를 지정합니다. | 유효한 값은 다음과 같습니다. - 명시적 -암시적 |
기본값은 Explicit입니다. |
| clientCertificateHash | VT_BSTR | SSL 협상에 사용해야 하는 클라이언트 인증서의 SHA1 해시를 지정합니다. | 없음 | 이 해시를 기반으로 BizTalk 호스트 인스턴스를 실행하는 사용자 계정의 개인 저장소에서 클라이언트 인증서가 선택됩니다. |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><serverAddress>TestServer</serverAddress><serverPort>21</serverPort><userName>testuser</userName><password>******</password><accountName>testuser</accountName><targetFolder>output</targetFolder><targetFileName>%MessageID%.xml</targetFileName><commandLogFilename>c:\logfile\ftpsendlog.txt</commandLogFilename><representationType>binary</representationType><beforePut>CDW dir</beforePut><afterPut>CDUP </afterPut><allocateStorage>False</allocateStorage><spoolingFolder>tempfolder</spoolingFolder><connectionLimit>0</connectionLimit><passiveMode>False</passiveMode><firewallType>Socks4</firewallType><firewallAddress>TestServer</firewallAddress><firewallPort>21</firewallPort><firewallUserName>domain\testuser</firewallUserName><firewallPassword>******</firewallPassword><useSsl>False</useSsl><useDataProtection>True</useDataProtection><ftpsConnMode>Explicit</ftpsConnMode><clientCertificateHash>bc 32 2c a9 22 75 6a 3f e4 f7 a9 b1 b3 3a 24 20 23 53 68 49</clientCertificateHash><uri>ftp://TestServer:21/output/%MessageID%.xml</uri></Config></AdapterConfig></CustomProps>
참고
어댑터 프레임워크를 사용하여 빌드된 어댑터에 대한 TransportTypeData 구성 데이터를 지정할 때 사용되는 모든 이름/값 쌍을 AdapterConfig> 요소에 <저장해야 합니다. <AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식 <> 을 지정하므로 데이터의 문자를 이스케이프해야 합니다.