Windows SharePoint Services 어댑터 식
이 항목에서는 Windows SharePoint Services 어댑터의 파일 이름속성 원본 속성에 대한 값으로 지정할 수 있는 문자열의 형식과 의미를 설명합니다. 또한 관련 컨텍스트 속성인 WSS에 대해서도 설명합니다. 파일 이름 및 WSS. ConfigPropertiesXml. 이러한 식을 사용하면 리터럴은 물론, 메시지 또는 BizTalk 시스템에서 추출된 값을 기반으로 파일 이름 값 또는 사용자 지정 Windows SharePoint Service 열 값을 쉽게 정의할 수 있습니다.
식에는 리터럴 및 매크로가 포함될 수 있습니다. 리터럴은 파일 이름에 입력된 대로 정확하게 표시됩니다. 매크로는 '%'자 사이에 배치해야 합니다. 매크로의 예로 런 %MessageID% 타임 시 메시지의 GUID로 바뀝니다.
참고
% 문자가 리터럴로 사용되거나 XPATH 내에서 사용된 경우 \%처럼 이스케이프해야 합니다. 단일 %는 매크로 구분 기호로 간주되며 여기서 \%는 런타임에 단일 %로 바뀝니다. \ 문자는 \\처럼 이스케이프해야 합니다.
식 예제
| 디자인 타임 값 | 런타임 값 |
|---|---|
| XYZ | XYZ |
| PurchaseOrder | PurchaseOrder |
| %MessageID% | 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| PurchaseOrder - %MessageID% | PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| Discount \%10 | Discount %10 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – 10001 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:PartnerName%-%XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – Contoso-10001 |
지원되는 매크로
| 디자인 타임 값 | 런타임 값 |
|---|---|
| %MessageID% | 고유 GUID인 BizTalk 메시지 ID입니다. |
| %SendingOrchestrationID% | 메시지가 시작된 오케스트레이션 인스턴스의 BizTalk ID입니다. |
| %SendingOrchestrationType% | 메시지가 시작된 오케스트레이션의 유형 이름입니다. |
| %XPATH=<xpath>% | 메시지에서 값을 추출하는 데 사용할 XPATH를 지정할 수 있습니다. "<xpath>"를 유효한 XPATH 식으로 바꿔야 합니다. 참고: 네임스페이스 별칭은 '네임스페이스 별칭' 또는 WSS의 식 외부에서 정의되어야 합니다. ConfigNamespaceAliases 필드입니다. |
| %Filename% | 메시지 컨텍스트 속성 WSS.Filename에서 추출한 파일 이름 값으로 바뀝니다. SharePoint로부터 받은 메시지에는 WSS.Filename 컨텍스트 속성 값이 SharePoint 파일의 이름으로 설정되어 있습니다. 반환된 값은 Path.GetFilenameWithoutExtension을 사용하여 전처리됩니다. 참고: 이 매크로는 오케스트레이션의 WSS.Config* 컨텍스트 속성에서 사용할 수 없습니다. |
| %Extension% | 메시지 컨텍스트 속성 WSS.Filename에서 추출한 파일 확장명 값으로 바뀝니다. SharePoint로부터 받은 메시지에는 WSS.Filename 컨텍스트 속성 값이 SharePoint 파일의 이름으로 설정되어 있습니다. 반환된 값은 Path.GetExtension을 사용하여 전처리됩니다. 반환된 값에는 "."가 포함되지 않습니다. 참고: 이 매크로는 오케스트레이션의 WSS.Config* 컨텍스트 속성에서 사용할 수 없습니다. |
속성 승격에서 지원하는 모든 유효한 식은 유효한 디자인 타임 파일 이름입니다. 디자인 타임 파일 이름은 런타임에 Windows SharePoint Services 파일 이름으로 확장됩니다. 이 Windows SharePoint Services 파일 이름에는 다음과 같은 몇 가지 추가 제한 사항이 있습니다.
유효한 Windows 파일 이름에는 / \ : * ? 를 제외하고 유니코드 문자가 포함될 수 있습니다. <> | " # { } % & ~ 또는 탭 문자와 여러 마침표.
파일 이름은 256자를 넘을 수 없으며 전체 URL은 256자 이하여야 합니다.
확장된 Windows SharePoint Services 파일 이름에 잘못된 문자가 포함되어 있거나 확장된 파일 이름 또는 URL이 너무 긴 경우 응용 프로그램 이벤트 로그에 오류가 기록되고 메시지가 일시 중단됩니다. 또한 메시지 이벤트 및 서비스 인스턴스 추적을 사용하여 그룹 허브 페이지에서 오류 및 메시지 상태를 볼 수도 있습니다.
참고 항목
Windows SharePoint Services 수신 위치 구성 방법
Windows SharePoint Services 송신 핸들러 구성 방법
Windows SharePoint Services 송신 포트 구성 방법
Windows SharePoint Services 어댑터 속성 참조
지원되는 Windows SharePoint Services 열 형식