Windows SharePoint Services 컨텍스트 속성을 사용하여 송신 포트를 구성하는 방법
이 항목에서는 BizTalk 오케스트레이션에서 Windows Sharepoint Services 컨텍스트 속성을 사용하여 런타임에 Windows SharePoint Services 송신 포트를 구성하는 방법을 설명합니다. 이 메커니즘을 사용하여 Windows SharePoint Services 동적 송신 포트 및 런타임 바인딩 송신 포트를 구성할 수 있습니다. 동적 송신 포트에 대한 구성 속성은 런타임에 오케스트레이션에서 설정됩니다. Windows SharePoint Services 전송 속성 대화 상자에 노출되는 어댑터 속성을 동적 또는 지연 바인딩된 송신 포트에도 적용할 수 있습니다. Windows Sharepoint Services 어댑터 컨텍스트 속성을 사용하여 동적 송신 포트 또는 런타임 바인딩 송신 포트에 대한 구성 속성을 설정하려면 다음 단계를 수행합니다.
Windows Sharepoint Services 어댑터 컨텍스트 속성을 사용하여 송신 포트에 대한 구성 속성을 설정하려면
동적 송신 포트의 경우 동적 단방향 송신 포트를 만들려면 송 신 포트를 만드는 방법 항목의 단계를 따릅니다.
오케스트레이션의 생성 메시지 셰이프 내에서 메시지 할당 셰이프를 사용하여 아웃바운드 메시지에 대한 구성 속성을 설정합니다. 아웃바운드 메시지에 대한 구성 속성을 설정하는 방법에 대한 예제는 연습: 모듈 3 - 오케스트레이션에서 SharePoint 속성 액세스를 참조하세요. 이 항목의 새 메시지 생성 섹션에서는 아웃바운드 메시지의 구성 속성을 설정하는 방법을 보여 줍니다. Windows SharePoint Services 전송 속성 대화 상자에서 설정할 수 있는 속성과 상관 관계가 있는 어댑터 컨텍스트 속성은 아래 표에 나열되어 있습니다.
전송 속성 어댑터 컨텍스트 속성 데이터 형식 의견 어댑터 웹 서비스 포트 WSS.ConfigAdapterWSPort Int 유효한 값은 1-65535입니다.
기본값은 80입니다.제한 시간 WSS.ConfigTimeout Int 유효한 값은 1000-2147483647입니다.
기본값은 100000입니다.
시간 제한을 두지 않으려면 값을 0으로 지정합니다.대상 폴더 URL 해당 없음 해당 없음 동적 포트의 경우 오케스트레이션에서 식 셰이프를 사용하여 동적 포트의 Microsoft.XLANGs.BaseTypes.Address 속성을 설정하여 간접적으로 설정합니다. 런타임 바인딩 포트의 경우 이 속성은 실제 송신 포트 값에 의해 항상 재정의되므로 런타임에 설정할 수 없습니다. 파일 이름 WSS.Filename 문자열 %Filename% 및 %Extension% 매크로를 제외한 전송 속성에서 사용할 수 있는 모든 파일 이름 매크로의 사용을 지원합니다. 네임스페이스 별칭 WSS.ConfigNamespaceAliases 문자열 메시지에 대해 런타임에 설정된 네임스페이스 별칭이 메시지가 라우팅되는 대상 송신 포트에 대해 설정된 네임스페이스 별칭과 정확히 일치하는 경우 네임스페이스가 병합되고 라우팅 오류가 발생합니다. 이 문제를 방지하려면 네임스페이스 별칭을 서로 다르게 지정해야 합니다. 예를 들어 오케스트레이션에서 메시지의 네임스페이스 별칭을 설정하는 데 다음 식이 사용되고,
Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";
그리고 이 메시지가 네임스페이스 별칭 속성에 대해 다음 값을 지정하는 송신 포트로 라우팅되는 경우:
orchns='http://OrderProcess.PurchaseOrder'
BizTalk Server에서 메시지를 이 송신 포트로 라우팅하려고 하면 오류가 발생합니다. 이 문제를 resolve 송신 포트의 네임스페이스 별칭 속성에 다음 값을 지정할 수 있습니다.
orchns2='http://OrderProcess.PurchaseOrder'Overwrite WSS.ConfigOverwrite 문자열 유효한 값은 다음과 같습니다.
- "예"
- "아니요"
- "rename"SharePoint 사이트 URL WSS.InListUrl 문자열 동적 포트의 경우 오케스트레이션에서 식 셰이프를 사용하여 동적 포트의 Microsoft.XLANGs.BaseTypes.Address 속성을 설정하여 간접적으로 설정합니다. 런타임 바인딩 포트의 경우 이 속성은 실제 송신 포트 값에 의해 항상 재정의되므로 런타임에 설정할 수 없습니다. Microsoft Office 통합 WSS.ConfigOfficeIntegration 문자열 유효한 값은 다음과 같습니다.
- "예"
- "아니요"
- "yesformlibrary"
- "선택 사항"템플릿 문서 라이브러리 WSS.ConfigTemplatesDocLib 문자열 없음 템플릿 대체(fallback) 문서 라이브러리 WSS.ConfigCustomTemplatesDocLib 문자열 없음 템플릿 대체(fallback) 네임스페이스 열 WSS.ConfigCustomTemplatesNamespaceCol 문자열 없음 템플릿 네임스페이스 열 WSS.ConfigTemplatesNamespaceCol 문자열 없음 열 nWSS.ConfigPropertiesXml
열 이름은 PropertyNamex>columnname/PropertyName<x> 필드에 설정<됩니다.문자열 없음 열 n값WSS.ConfigPropertiesXml
열 값은 PropertySourcex>columnvalue</PropertySourcex> 필드에 설정<됩니다.String %Filename% 및 %Extension% 매크로를 제외한 전송 속성에서 사용할 수 있는 모든 파일 이름 매크로의 사용을 지원합니다. 참고
컨텍스트 속성에 지원되는 값은 대/소문자를 구분합니다. 컨텍스트 속성을 사용하여 동적 포트의 구성 값을 설정하는 경우 올바른 대/소문자를 사용해야 합니다. 그러지 않으면 BizTalk에서 문서를 대상 송신 포트로 라우팅하려고 할 때 오류가 발생합니다.
오케스트레이션에서 식 셰이프를 사용하여 동적 송신 포트에 대한 Microsoft.XLANGs.BaseTypes.Address 속성을 설정합니다. 이 속성은 동적 송신 포트가 메시지를 라우팅하는 대상 URI를 지정하는 데 사용됩니다. 동적 송신 포트에 대해 Microsoft.XLANGs.BaseTypes.Address 속성을 설정하는 방법에 대한 예제는 연습: 모듈 3 - 오케스트레이션에서 SharePoint 속성 액세스 항목의 식 만들기 섹션을 참조하세요. Windows Sharepoint Services 어댑터 컨텍스트 속성에 대한 자세한 내용은 Windows SharePoint Services 어댑터 속성 참조를 참조하세요.
오케스트레이션에서 런타임 바인딩 Windows Sharepoint Services 송신 포트의 특정 속성을 동적으로 설정할 수도 있습니다. 이렇게 하면 Windows SharePoint Services 포트가 Windows SharePoint Services 컨텍스트 속성과 Windows SharePoint Services 전송 속성 대화 상자를 통해 두 번 구성됩니다. 기본적으로 Windows SharePoint Services 전송 속성 대화 상자에 지정된 구성이 컨텍스트 속성에 지정된 구성 속성보다 우선적으로 적용됩니다. 컨텍스트 속성에 지정된 구성을 사용하려면 다음 단계를 수행합니다.
정적 단방향 송신 포트를 만들려면 송신 포트를 만드는 방법 항목의 단계를 따릅니다.
송신 포트에 대한 속성을 설정할 때 Sharepoint 사이트 URL 및 대상 폴더 URL 속성에 적절한 값을 입력하여 송신 포트에 대한 URI를 정의합니다.
컨텍스트 속성 WSS에 정의된 값을 사용하려면 덮어쓰 기 속성의 값을 Orchestration 으로 설정합니다 . 오케스트레이션의 ConfigOverwrite .
컨텍스트 속성 WSS에 정의된 값을 사용하려면 Microsoft Office Integration 속성을 Orchestration 으로 설정합니다 . 오케스트레이션의 ConfigOfficeIntegration 입니다.
오케스트레이션에서 컨텍스트 속성을 사용하여 해당 값을 설정하려는 경우 정수 데이터 형식을 사용하는 송신 포트 속성에 대해 -1 값을 입력합니다.
문자열 데이터 유형을 사용하는 송신 포트 속성에 대해 오케스트레이션의 컨텍스트 속성을 사용하여 값을 설정하려면 해당 송신 포트 속성을 모두 비워 둡니다. Sharepoint 사이트 URL 및 대상 폴더 URL 속성에는 적용되지 않습니다. 이러한 속성은 Windows Sharepoint Services 전송 속성 대화 상자에서 지정해야 합니다.
오케스트레이션의 생성 메시지 셰이프 내에서 메시지 할당 셰이프를 사용하여 아웃바운드 메시지에 대한 구성 속성을 설정합니다. 아웃바운드 메시지에 대한 구성 속성을 설정하는 방법에 대한 예제는 연습: 모듈 3 - 오케스트레이션에서 SharePoint 속성 액세스를 참조하세요. 이 항목의 새 메시지 생성 섹션에서는 아웃바운드 메시지의 구성 속성을 설정하는 방법을 보여 줍니다.
-1 값(정수 데이터 유형을 사용하는 속성), "오케스트레이션"(드롭다운 열거 속성) 또는 빈 값(문자열 데이터 유형을 사용하는 속성)으로 구성된 모든 송신 포트 속성은 오케스트레이션에 지정된 컨텍스트 속성을 사용하여 런타임에 설정됩니다.
Windows SharePoint Services 어댑터를 사용하여 포함된 첨부 파일이 있는 InfoPath 양식을 받은 다음 이를 SharePoint 문서 라이브러리로 보내려면 다음 단계에 따라 해당 양식에 있는 모든 InfoPath 처리 명령을 그대로 유지합니다.
BizTalk Server에서 처리하는 포함된 첨부 파일이 있는 InfoPath 양식에 대해 InfoPath 처리 명령을 유지하려면
오케스트레이션의 맵을 사용하여 한 InfoPath 양식의 데이터를 다른 InfoPath 양식으로 매핑하는 경우 맵의 PIS(복사 처리 지침) 속성을 예로 설정했는지 확인합니다. 이 매개 변수는 지도에 대한 그리드 속성 페이지의 사용자 지정 헤더 섹션 아래에 설정됩니다.
오케스트레이션의 맵을 사용하지 않는 경우 Message Assignment 셰이프에 다음 식을 사용하여 출력 메시지를 업데이트합니다.
NewMessage(XMLNORM.ProcessingInstructionOption) = 1; NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"위의 식에서 NewMessage 는 처리 지침을 추가하는 출력 메시지입니다.