MSMQ 어댑터 구성 속성
다음 표에는 MSMQ 어댑터 수신 위치에 대해 설정할 수 있는 구성 속성이 나와 있습니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| queue | VT_BSTR | 수신 위치에서 모니터링하는 위치의 유효한 큐 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| batchSize | VT_BSTR | MSMQ 어댑터에서 일괄 처리 메시지를 MessageBox 데이터베이스에 전송할 때 사용하는 일괄 처리 크기를 지정합니다. | 유효한 값은 1에서 4294967295. | 기본값은 20입니다. |
| transactional | VT_BSTR | MSDTC(Microsoft Distributed Transaction) 컨텍스트에서 소스 큐의 메시지를 읽을지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false 어댑터는 원격 큐의 트랜잭션 읽기를 지원하지 않습니다. |
기본값은 false입니다. |
| serialProcessing | VT_BSTR | 메시지의 순차적 처리 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 false입니다. |
| onFailure | VT_BSTR | 어댑터가 오류에 응답하는 방식을 지정합니다. | 유효한 값은 다음과 같습니다. - stopOnFailure - suspendNonResumable - suspendResumable |
기본값은 suspendResumable입니다. |
| uri | VT_BSTR | 수신 위치에서 모니터링하는 큐의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><queue>FORMATNAME:DIRECT=OS:.\PRIVATE$\QUEUE</queue><batchSize>20</batchSize><transactional>false</transactional><serialProcessing>false</serialProcessing><onFailure>suspendResumable</onFailure><uri>FORMATNAME:DIRECT=OS:.\PRIVATE$\QUEUE</uri></Config></AdapterConfig></CustomProps>
다음 표에는 MSMQ 어댑터 송신 포트에 대해 설정할 수 있는 구성 속성이 나와 있습니다.
| 속성 이름 | Type | 설명 | 제한 | 의견 |
|---|---|---|---|---|
| 큐 | VT_BSTR | 대상 큐를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
| maximumMessageSiz | VT_BSTR | 지정한 큐로 송신할 메시지의 최대 메시지 크기(KB)를 지정합니다. | segmentationSupport와 transactional이 true로 설정된 경우 유효한 값은 1-4294967295입니다. 그렇지 않은 경우 유효한 값은 1-4095입니다. | 기본값은 1024입니다. |
| acknowledgeType | VT_BSTR | 하나 이상의 승인 유형을 지정합니다. | 유효한 값은 .NET System.Messaging.AcknowledgeTypes 열거형의 멤버입니다. | 기본값은 None입니다. |
| administrationQueue | VT_BSTR | MSMQ 관리 큐를 지정합니다. | 없음 | 없음 |
| timeOut | VT_BSTR | 대상 큐에 도달하기 위해 메시지가 대기하는 최대 시간을 지정합니다. | 이 속성은 transactional 속성이 true로 설정된 경우에만 적용됩니다. - timeOutUnits 값을 Days로 지정할 때 유효한 값은 10675199 1입니다. - timeOutUnits 값을 Hours로 지정할 때 유효한 값은 596523 1입니다. - timeOutUnits 값을 분으로 지정할 때 유효한 값은 35791394 1입니다. - timeOutUnits 값을 Seconds로 지정할 때 유효한 값은 2147483647 1입니다. |
없음 |
| priority | VT_BSTR | 메시지의 우선 순위를 지정합니다. | 유효한 값은 .NET System.Messaging.MessagePriority 열거형의 멤버입니다. | 없음 |
| recoverable | VT_BSTR | 메시지의 복구 가능 여부를 보장할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 false입니다. |
| encryptionAlgorithm | VT_BSTR | 사용할 암호화 알고리즘을 지정합니다. | 유효한 값은 .NET System.Messaging.EncryptionAlgorithm 열거형의 멤버입니다. | 기본값은 None입니다. |
| useAuthentication | VT_BSTR | 인증을 사용할지 여부를 지정합니다. | certificate 속성과 함께 이 속성을 사용하여 메시지를 확인할 수 있습니다. 큐에 액세스하려면 userName 및 password 속성을 사용합니다. | 없음 |
| 인증서(certificate) | VT_BSTR | 메시지를 확인하는 데 사용할 인증서를 지정합니다. | 40자로 된 인증서 손 도장(Thumbprint)을 입력합니다. | 없음 |
| segmentationSupport | VT_BSTR | 조각화 지원 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 false입니다. |
| transactional | VT_BSTR | MSDTC(Microsoft Distributed Transaction) 컨텍스트에서 메시지 전송을 지원할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 false입니다. |
| useJournalQueue | VT_BSTR | 메시지를 처리할 때마다 메시지의 복사본을 저장할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 false입니다. |
| useDeadLetterQueue | VT_BSTR | 오류가 발생할 때 배달 못한 편지 큐로 메시지를 송신할지 여부를 지정합니다. | 유효한 값은 다음과 같습니다. - true - false |
기본값은 true입니다. |
| ackTypeEnumsValue | VT_BSTR | 지정된 acknowledgeType 값에 연결되는 값의 비트 OR을 지정합니다. | 없음 | 기본값은 0입니다. |
| timeOutUnits | VT_BSTR | timeOut 속성에 대해 지정된 값과 함께 사용할 단위를 지정합니다. | 유효한 값은 다음과 같습니다. -일 -시간 -분 -초 |
기본값은 일입니다. |
| userName | VT_BSTR | 원격 큐의 사용자 이름을 지정합니다. | 기본값은 비어 있습니다. | |
| password | VT_BSTR | 원격 큐에 액세스하기 위해 userName 속성에 대해 지정된 값과 함께 사용할 암호를 지정합니다. | 이 값은 바인딩 파일을 내보낼 때 항상 마스크됩니다. 바인딩 파일을 대상 BizTalk Server 구성으로 내보내기 전에 이 필드에 직접 암호를 입력해야 합니다. | 기본값은 비어 있습니다. |
| bodyType | VT_BSTR | MSMQ의 메시지 본문 유형을 지정합니다. | 유효한 값은 .NET VarEnum 열거형의 멤버입니다. | 기본값은 8209입니다. |
| uri | VT_BSTR | 대상 큐의 전체 경로를 지정합니다. | 송신 포트나 수신 위치의 URI는 256자를 초과할 수 없습니다. | 없음 |
다음 코드는 속성을 설정하는 데 사용하는 문자열의 형식을 보여 줍니다.
<CustomProps><AdapterConfig vt="8"><Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"><queue>FORMATNAME:DIRECT=OS:TESTSERVER\PRIVATE$\DESTQUEUE</queue><maximumMessageSize>1024</maximumMessageSize><acknowledgeType>None</acknowledgeType><administrationQueue>Direct=OS:TestServer\Private$\AdminQueue</administrationQueue><timeOut>4</timeOut><priority>Normal</priority><recoverable>false</recoverable><encryptionAlgorithm>None</encryptionAlgorithm><useAuthentication>false</useAuthentication><segmentationSupport>false</segmentationSupport><transactional>false</transactional><useJournalQueue>false</useJournalQueue><useDeadLetterQueue>true</useDeadLetterQueue><ackTypeEnumsValue>0</ackTypeEnumsValue><timeOutUnits>Days</timeOutUnits><userName>TestUser</userName><password>******</password><bodyType>8209</bodyType><uri>FORMATNAME:DIRECT=OS:TESTSERVER\PRIVATE$\DESTQUEUE</uri></Config></AdapterConfig>
참고
어댑터 프레임워크를 사용하여 빌드된 어댑터에 대한 TransportTypeData 구성 데이터를 지정할 때 사용되는 이름/값 쌍은 모두 AdapterConfig> 요소에 <저장되어야 합니다. <AdapterConfig> 요소는 VT_BSTR(vt="8") 데이터 형식 <> 을 지정하므로 데이터의 문자를 이스케이프해야 합니다.