다음을 통해 공유


Windows SharePoint Services 어댑터란?

Windows SharePoint Services BizTalk Server 어댑터는 Windows SharePoint Services 및 Microsoft Office InfoPath와의 긴밀한 통합을 제공합니다. 다음 항목에서는 Windows SharePoint Services 어댑터의 기능과 작동 방식에 대한 개요를 설명합니다.

Windows SharePoint Services 어댑터의 기능

다음 목록은 Windows SharePoint Services 어댑터의 중요한 기능을 보여 줍니다.

  • SharePoint 문서 라이브러리로 BizTalk Server XML 및 이진 메시지 보내기 기능

  • InfoPath와의 통합: Windows SharePoint Services 사이트에서 열 때 나가는 BizTalk Server XML 메시지를 InfoPath에서 자동으로 열도록 변환할 수 있습니다.

  • Windows SharePoint Services로 이동하는 메시지에 대한 속성 승격. 메시지 형식 오케스트레이션 인스턴스 ID, 메시지 ID 또는 메시지에서 추출된 값에 대한 BizTalk Server 메타데이터로 최대 16개의 SharePoint 열을 업데이트할 수 있습니다.

  • 메시지 내용 및 BizTalk Server 속성을 기반으로 하는 파일-이름 정의

  • 문서를 문서 라이브러리 대신 임의 목록으로 보내는 기능: 이 경우 문서 자체는 Windows SharePoint Services 저장되지 않지만 속성 승격은 여전히 발생하므로 새 목록 항목이 만들어지고 메시지에서 열 값이 검색됩니다.

  • 문서 라이브러리의 모든 보기에서 메시지를 받아 지정된 파일 이름을 사용하여 지정된 문서 라이브러리에 보관하는 기능

  • BizTalk Server Windows SharePoint Services 어댑터 속성 승격: Windows SharePoint Services 파일 정보는 메시지 컨텍스트 속성으로 BizTalk Server 사용할 수 있습니다. 메시지 컨텍스트 속성은 파이프라인, 오케스트레이션 등에서 액세스할 수 있으며, 사용자 지정 SharePoint 열은 WSS.InPropertiesXml 문서를 통해 액세스할 수 있습니다.

  • 동적 포트에 대한 전체 지원: 송신 어댑터는 정적 URI 바인딩(송신 포트를 만들 때 사용자가 정의함) 또는 동적 URI 바인딩(메시지를 보낼 때 오케스트레이션에 의해 정의됨)을 지원할 수 있습니다. 모든 구성 정보는 동적 송신 포트 및 실제 송신 포트에 대해 WSS.Filename 및 WSS.ConfigTimeout과 같은 메시지 컨텍스트 속성을 통해 정의할 수 있습니다.

  • 성능 카운터

Windows SharePoint Services 어댑터 작동 방식

Windows SharePoint Services BizTalk Server 어댑터는 세 가지 기본 구성 요소로 구성됩니다.

  • Windows SharePoint Services 어댑터 웹 서비스

  • Windows SharePoint Services 수신 어댑터

  • Windows SharePoint Services 송신 어댑터

    Windows SharePoint Services 서버에는 Windows SharePoint Services 라이브러리 및 목록에 대한 액세스를 제공하기 위해 웹 서비스(BTSharePointAdapterWS.asmx)가 설치됩니다. 웹 서비스는 SharePoint 라이브러리에서 문서를 가져오고, 배치하고, 삭제하고, 보관하는 메서드를 노출합니다. 수신 어댑터는 웹 서비스에서 파일을 검색하고, 송신 어댑터는 웹 서비스에 파일을 게시합니다.

    다음 그림에서는 이러한 기능을 제공하는 Windows SharePoint Services 대한 BizTalk Server 어댑터의 기본 구성 요소를 보여 줍니다.

    이러한 기능을 제공하는 Windows SharePoint Services 대한 BizTalk Server 어댑터의 기본 구성 요소를 보여 주는 이미지.

Windows SharePoint Services에서 문서 받기

수신 어댑터는 Windows SharePoint Services 문서 라이브러리 보기를 폴링합니다. 수신 어댑터는 Windows SharePoint Services 서버에서 Windows SharePoint Services 개체 모델을 사용하여 라이브러리를 검색하고 파일을 체크 아웃한 후 어댑터로 파일 데이터를 반환하는 웹 메서드를 호출합니다. 그런 다음 BizTalk Server MessageBox로 파일을 전송하고 다른 웹 메서드를 호출하여 Windows SharePoint Services에서 파일을 삭제하거나 보관합니다. Windows SharePoint Services 라이브러리에서 파일을 필터링하려는 경우 어댑터는 Windows SharePoint Services 보기를 통해 Windows SharePoint Services 라이브러리를 폴링합니다.

중앙 집중식(폴링) 접근 방법은 BizTalk Server에서 구성이 완료되는 간단한 관리 모델을 제공합니다. 또한 메시지 일괄 처리가 가능하기 때문에 향상된 성능을 제공합니다.

Windows SharePoint Services, 웹 서비스 및 BizTalk Server 간에는 플랫폼 수준 트랜잭션이 지원되지 않으므로 실패 조건과 관련된 오류를 최소화하기 위해 체크 아웃 메커니즘이 사용됩니다. 특정 상황, 즉 파일이 BizTalk Server MessageBox 데이터베이스로 전송되었지만 Windows SharePoint Services에서 삭제될 수 있는 상황에서는 파일이 BizTalk Server로 전송된 후에도 Windows SharePoint Services 서버에서 체크 아웃된 상태로 유지됩니다. 오류는 BizTalk Server의 이벤트 로그에 기록됩니다.

Windows SharePoint Services로 문서 보내기

어댑터는 Windows SharePoint Services 서버에서 웹 메서드를 호출하여 Windows SharePoint Services로 문서를 보냅니다. 이 경우 어댑터는 Windows SharePoint Services 사이트 URL, 사이트에 상대적인 문서 라이브러리 또는 목록 URL, 파일 또는 파일과 연결한 목록 항목 이름 및 승격 속성을 지정합니다.

파일 이름을 고정 문자열 또는 문서의 XML 데이터에서 파생된 이름으로 설정할 수 있습니다. 파생된 이름은 표준 명명 규칙을 적용하는 데 매우 유용할 수 있습니다. 또한 어댑터는 파일에서 승격 속성 값을 열 값으로 설정합니다. 파일 이름과 마찬가지로 승격 속성 값은 고정 값이거나 문서의 XML 데이터에서 파생된 값일 수 있습니다.

중요

Windows SharePoint Services 어댑터의 승격 속성은 BizTalk Server의 승격 속성 또는 Windows SharePoint Services의 승격 속성과 다른 엔터티입니다.

Windows SharePoint Services의 승격 속성은 Windows SharePoint Services 양식 라이브러리를 검색할 때 XML 요소를 표시하는 데 사용됩니다. InfoPath 양식이 Windows SharePoint Services 양식 라이브러리에 게시되면 InfoPath에서 주요 요소를 승격하도록 양식 라이브러리를 구성하여 이 작업이 자동으로 실행되도록 합니다. 이 기능은 InfoPath 양식 라이브러리(동일한 XSD 스키마와 InfoPath 솔루션을 사용하여 InfoPath 양식을 저장하는 문서 라이브러리)를 사용하는 경우에만 Windows SharePoint Services에서 사용할 수 있습니다.

Windows SharePoint Services 어댑터 속성 승격을 사용하여 사용자는 여러 스키마가 있는 문서가 같은 문서 라이브러리에 저장된 경우 Windows SharePoint Services로 속성을 승격할 수 있습니다.

BizTalk Server 속성 승격은 이와 개념이 유사하지만 속성이 오케스트레이션에서 메시지의 속성으로만 표시되고 최종 사용자가 볼 수 있게 UI에 표시되지는 않습니다. 또한 BizTalk Server는 속성 값이 문서에 다시 저장된 경우 속성 강등이라는 개념을 지원합니다.

임의 XML 및 문서 라이브러리 대신 InfoPath 양식 및 양식 라이브러리에서 Windows SharePoint Services 어댑터를 사용하는 경우 송신 어댑터를 통해 승격 속성을 설정할 필요가 없습니다. 대신 오케스트레이션 내에서 메시지를 변경하거나 강등할 속성을 통해 직접 또는 간접적으로 문서를 변경할 수 있습니다. 값은 Windows SharePoint Services에 의해 자동으로 승격됩니다.

Windows SharePoint Services 어댑터의 보안 고려 사항

Windows SharePoint Services 어댑터는 하위 시스템, Windows SharePoint Services 웹 사이트에서 실행되는 BTSharePointAdapterWS 웹 서비스 및 BizTalk Server 호스트 인스턴스 프로세스 내의 BizTalk Server에서 실행되는 어댑터 런타임으로 구성됩니다. 어댑터 런타임은 Windows SharePoint Services 내에서 특정 작업을 수행할 권한이 있어야 하는 BTSharePointAdapterWS 웹 서비스를 호출합니다. 이 구성 요소는 호출자로 실행되기 때문에 호출자에게 권한이 부여되어야 합니다. 즉, 해당 사이트에서 메시지를 보내고 받을 수 있도록 BizTalk 호스트 instance SharePoint 사이트에서 기여자로 만들어야 합니다. BTSharePointAdapterWS 웹 서비스는 SharePoint 사용 호스트 그룹의 멤버만 호출할 수 있습니다. 어댑터 런타임을 실행하는 BizTalk 호스트 instance 웹 서비스와 상호 작용할 수 있도록 하려면 호스트 instance Windows 계정을 SharePoint 사용 호스트 그룹의 구성원으로 만들어야 합니다. 이 그룹에서 계정을 추가 및 제거하고 호스트를 SharePoint 기여자 역할의 계정 구성원으로 instance 것은 관리자의 책임입니다.

구성 요소 프로세스 ID 사용 권한
BTSharePointAdapterWS 웹 서비스 호출자 ID SharePoint 설정 호스트 그룹에 부여된 호출 권한
어댑터 런타임 BizTalk 호스트 ID 해당 없음
Windows SharePoint Services 개체 모델 해당 없음 SharePoint 사용 호스트 그룹은 SharePoint Services 기여자 역할의 멤버여야 합니다.

BizTalk Server 설정은 SHAREPoint 사용 호스트 그룹의 구성원인 계정만 이 웹 서비스에 액세스할 수 있도록 BTSharePointAdapterWS 웹 서비스에 대한 권한을 구성합니다. 호스트가 Windows SharePoint Services 어댑터를 실행하도록 하려면 관리자가 해당 호스트와 연결된 NT 그룹을 SharePoint 사용 호스트 그룹에 추가하고 SharePoint 사용 호스트 그룹을 Windows SharePoint Services 기여자 역할에 추가해야 합니다.

Windows SharePoint Services 파일, 목록 및 문서 라이브러리에 대한 권한은 Windows SharePoint Services 보안을 통해 제한됩니다. 메시지는 Windows SharePoint Services에서 BizTalk Server로 직접 전송되고, 어댑터 런타임과 웹 서비스 간의 통신은 HTTP 또는 HTTPS를 통해 실행됩니다.

어댑터는 BTSharePointAdapterWS 웹 서비스에서 Windows SharePoint Services 사이트와 동일한 HTTP 스키마(HTTP 또는 HTTPS)를 사용하는 것으로 가정합니다. 즉, 어댑터는 Windows SharePoint Services 사이트가 보안 IIS 웹 사이트에서 만들어진 경우 HTTPS를 사용하여 BTSSharePointAdapterWS 웹 서비스와 통신하고, Windows SharePoint Services 사이트가 서버 인증서를 사용하지 않는 IIS 웹 사이트에서 만들어진 경우 HTTP를 사용하여 BTSharePointAdapterWS 웹 서비스와 통신합니다.

참고 항목

Windows SharePoint Services 어댑터 설정 및 배포
Windows SharePoint Services 어댑터 구성
Windows SharePoint Services 어댑터 연습