SharePoint Services 송신 포트 구성
이 항목에서는 정적 송신 포트와 동적 송신 포트를 비교하고 Windows SharePoint Services 송신 포트를 만드는 단계도 나열합니다. 특히 다음에 대해 주의하세요.
정적 송신 포트와 동적 송신 포트 비교
| 정적 송신 포트 | 동적 전송 포트 | |
|---|---|---|
| 여러 가지 어댑터에 단일 송신 포트를 사용합니다. | No 정적 송신 포트를 만들 때엔 전송 방식이 필요합니다. |
Yes 동적 송신 포트는 대개 오케스트레이션에 추가되며 전송 방식은 오케스트레이션 논리에서 구성됩니다. |
| 여러 송신 포트 속성이 지정된 단일 송신 포트를 사용합니다(예: URL). | No 정적 송신 포트를 만들 때엔 몇 가지 어댑터 속성이 구성되어 있어야 합니다(예: URL). |
Yes 동적 송신 포트는 대개 오케스트레이션에 추가되며 속성은 오케스트레이션 논리에서 구성됩니다. |
| 기본 송신 핸들러를 사용해야 합니다. | No 송신 핸들러는 송신 포트를 만들 때 구성할 수 있습니다. |
No 송신 핸들러는 송신 포트를 만들 때 구성할 수 있습니다. |
| 메시지가 어디로 흘러가야 할지 모를 때 사용합니다. | No 정적 송신 포트를 만들 때 송신 방식과 송신 위치를 지정합니다. |
Yes 송신 위치를 오케스트레이션과 내용 기준 라우팅 시나리오에서 구성할 수 있습니다. 메시지가 송신되는 필터에 규칙을 사용할 수도 있습니다. |
| 단일 송신 포트를 사용하여 메시지를 여러 파트너에게 보냅니다. | No 정적 송신 포트를 만들 때 송신 방식과 송신 위치를 지정합니다. |
Yes 동적 송신 포트는 대개 오케스트레이션에 추가되며 속성은 오케스트레이션 논리에서 구성되며 지정한 규칙에 따라 메시지가 여러 파트너에게 보내집니다. |
정적 송신 포트 만들기
정적 송신 포트를 만들 때 송신 포트에는 전송 방식과 연관된 기본 송신 핸들러가 사용됩니다. Windows SharePoint Services 어댑터를 사용하는 경우 기본 송신 처리기는 BizTalkServerApplication입니다. 새 송신 처리기를 추가하는 단계는 어댑터 처리기를 만드는 방법으로 이동합니다.
정적 송신 포트 만들기
BizTalk Server 관리 콘솔에서 BizTalk 그룹 [GroupName]을 확장하고 애플리케이션을 확장한 다음 송신 포트를 포함하도록 애플리케이션을 확장합니다.
포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 클릭한 다음 정적 단방향 송신 포트를 클릭합니다.
중요
정적 Solicit-Response 송신 포트는 Windows SharePoint Services 어댑터로 구성할 수 없습니다.
속성의 형식 드롭다운 목록에서 Windows SharePoint Services 클릭합니다. 이름, 송신 처리기 및 송신 파이프라인 속성을 입력합니다.
Configure를 클릭합니다. 속성에서 다음을 구성합니다.
속성 Description 어댑터 웹 서비스 포트 필수. SharePoint Services 어댑터 웹 서비스를 호스팅하는 IIS 웹 사이트에 구성된 포트입니다.
기본값은 표준 HTTP 포트인 포트 80입니다. 80 이외의 포트가 사용되는 경우 이 값을 업데이트합니다.제한 시간 필수. 이 값은 어댑터가 웹 서비스로부터 응답을 받기 위한 밀리초 단위의 시간입니다.
기본값은 100000ms (100초)입니다.
메시지나 일괄 처리의 크기가 예상보다 클 경우 이 값을 늘리십시오.
Windows SharePoint Services 어댑터 웹 서비스에 대한 어댑터 런타임 웹 서비스 호출의 시간 제한(밀리초)입니다. 메시지 또는 일괄 처리 크기가 어댑터가 예상하는 평균 크기보다 크면 이 값을 늘려야 할 수 있습니다.클라이언트 OM 사용 필수. SharePoint CSOM(Client Side Object Model)을 사용할지 아니면 SSOM(Service Side Object Model)을 사용할지를 정합니다.
기본값은 예입니다. BizTalk Server SharePoint CSOM을 사용하려면 예로 설정합니다. SharePoint Services 컴퓨터에는 요구 사항이 없습니다.
아니요로 설정하여 SharePoint Services 컴퓨터에 설치된 웹 서비스를 포함하는 SharePoint SSOM을 사용합니다.
부록 B: Microsoft SharePoint 어댑터 설치는 SharePoint Services 어댑터에서 사용하는 SSOM 및 CSOM 구성 요소에 대한 특정 정보를 제공합니다.대상 폴더 URL 필수. 문서를 저장할 SharePoint Services 폴더 URL입니다. SharePoint 사이트의 상대 경로를 입력합니다(예: 예를 들어 공유 문서 또는 공유 문서/구매 주문/가 있습니다. 대상 폴더에는 목록이 사용될 수 있습니다 예를 들어 목록/작업입니다. 목록을 지정할 경우 메시지 본문은 목록 항목과 함께 저장되지 않으며 메시지에서 추출된 값이 SharePoint 열에 승격됩니다. 참고: SharePoint 문서 라이브러리 또는 폴더 URL은 이름과 다를 수 있습니다. 정확한 URL은 웹 브라우저에서 주소를 확인하십시오. 파일 이름 선택 사항입니다. SharePoint Services 파일 이름의 이름을 입력합니다.
파일 이름( 예:PurchaseOrder0001.xml 또는 식)을 입력합니다. 식에는 리터럴, 매크로 및 XPATH 쿼리 등을 조합하여 입력할 수 있습니다. 예를 들어 PurchOrd-%XPATH=//po:PurchaseOrderId%-%MessageID%.xml를 입력합니다. 파일 이름이 지정되지 않으면 원본 파일의 이름, 오케스트레이션에서 제공된 값 또는 'Msg-%MessageID%.xml'이 사용됩니다. 자세한 내용은 Windows SharePoint Services 어댑터 식을 참조하세요. 참고: 목록에 메시지를 보낼 때 이 파일 이름 값은 무시되고 SharePoint 열에 저장되지 않습니다. 대신 사용 가능한 16개 열 중에서 하나를 사용하여 '제목' 열을 업데이트하십시오. SharePoint 목록에는 파일 이름 열이 없습니다.네임스페이스 별칭 선택 사항입니다. 쉼표나 세미콜론으로 구분된 네임스페이스 별칭 정의 목록입니다.
이 필드에서 '파일 이름' 또는 '열 값'과 같은 필드의 XPATH 쿼리에 사용되는 네임스페이스 별칭을 정의할 수 있습니다(예: 예를 들어 po='http://OrderProcess/POrder', conf='http://OrderProcess/Confirmation'xmlns=""; ipsol='{D8217CF1-4EF7-4bb5-A30D-765ECB09E0D9}'를 입력합니다. 참고: 이 속성은 WSS를 재정의하지 않습니다. ConfigNamespacesAliases 오케스트레이션에서 정의한 메시지 컨텍스트 속성입니다. 대신 두 값이 합쳐집니다.Overwrite 필수. 파일이 존재할 경우 해당 파일을 덮어쓸지 결정합니다.
기본값은 아니요입니다. 표시되는 옵션은 다음과 같습니다.
- 아니요: 같은 이름의 파일이 있는 경우 오류를 발생시키고 메시지를 일시 중단합니다.
- 오케스트레이션: 이름이 같은 파일이 있는 경우 오케스트레이션에 정의된 값을 사용합니다.
- 이름 바꾸기: 이름이 같은 파일이 있는 경우 새 파일의 이름을 바꿉니다.
- 예: 이름이 같은 경우 기존 파일을 덮어씁니다.
예로 설정하면 이름이 같은 많은 메시지를 보내면 SharePoint 이벤트 뷰어 오류가 발생할 수 있습니다. 이러한 오류는 어댑터에 영향을 주지 않으며 실패된 메시지는 다시 시도됩니다.SharePoint 사이트 URL 필수. SharePoint Services 웹 사이트의 전체 URL입니다. 예를 들어 http:// SharePointServer/sites/TestSite입니다. 참고: 송신 포트 또는 수신 위치 URI는 256자를 초과할 수 없습니다. Microsoft Office 통합 필수. 이진 메시지의 경우 아니요 또는 선택적 메시지를 사용해야 합니다.
기본값은 선택 사항입니다. 표시되는 옵션은 다음과 같습니다.
- 아니요: 문서를 있는 그대로 저장합니다. 이진 메시지에 이 옵션을 사용할 수 있습니다.
- 선택 사항: InfoPath와 같은 Office 응용 프로그램에서 자동으로 열리도록 문서를 수정합니다. 처리 지침을 찾을 수 없으면 문서가 있는 그대로 처리됩니다. 이진 메시지에 이 옵션을 사용할 수 있습니다.
- 오케스트레이션: 오케스트레이션에 정의된 값을 사용합니다.
- 예: InfoPath와 같은 Office 응용 프로그램에서 자동으로 열리도록 문서를 수정합니다. 처리 지침이 없으면 메시지가 일시 중단됩니다.
예로 설정하면 다음 속성 쌍 중 하나 이상이 필요합니다.
- 템플릿 문서 라이브러리 및 템플릿 네임스페이스 열
- 템플릿 대체 문서 라이브러리 및 템플릿 대체 네임스페이스 열
- 예(InfoPath 양식 라이브러리): InfoPath 솔루션이 양식 라이브러리에 있는 경우 문서가 수정되어 InfoPath와 같은 Office 응용 프로그램에서 자동으로 열립니다. 양식 라이브러리에 솔루션이 없으면 메시지가 일시 중단됩니다.
템플릿 문서 라이브러리 템플릿 네임스페이스 열이 채워진 경우에만 필요합니다. InfoPath 솔루션이 저장되는 SharePoint 문서 라이브러리입니다(예: 예를 들어 내 솔루션입니다. 어댑터는 서식 파일 문서 라이브러리 에서 일치하는 InfoPath 솔루션을 찾습니다. 솔루션을 찾을 수 없는 경우 어댑터는 템플릿 대체 문서 라이브러리를 찾습니다. 참고:템플릿 문서 라이브러리 에는 다음으로 채워진 하나 이상의 '텍스트 한 줄' SharePoint 열이 필요합니다. - InfoPath 솔루션으로 열 수 있는 XML 문서의 네임스페이스 및 루트 노드
- 또는 XML 문서의 루트 노드
템플릿 대체(fallback) 문서 라이브러리 템플릿 대체 네임스페이스 열이 채워진 경우에만 필요합니다. InfoPath 솔루션이 저장되는 SharePoint 문서 라이브러리입니다(예: 예를 들어 템플릿입니다.
템플릿 문서 라이브러리에서 솔루션을 찾을 수 없는 경우 어댑터는 템플릿 대체 문서 라이브러리에서 일치하는 InfoPath 솔루션을 찾습니다. 템플릿 대체 문서 라이브러리 및 템플릿 문서 라이브러리 필드는 두 가지 InfoPath 솔루션 집합과 함께 사용할 수 있습니다. 모든 일반적인 용도로 작동하는 일반 InfoPath 솔루션과 특정 파트너에 대해서만 사용되는 특수 InfoPath 솔루션이 있습니다. 서식 파일 대체 문서 라이브러리 필드는 제네릭 솔루션을 가리킵니다. 템플릿 문서 라이브러리는 특정 파트너에 대한 특수 솔루션을 가리킵니다. 참고:서식 파일 대체 문서 라이브러리 에는 다음으로 채워진 하나 이상의 '텍스트 한 줄' SharePoint 열이 필요합니다.- InfoPath 솔루션으로 열 수 있는 XML 문서의 네임스페이스 및 루트 노드
- 또는 XML 문서의 루트 노드
템플릿 대체(fallback) 네임스페이스 열 템플릿 대체 문서 라이브러리가 채워진 경우에만 필요합니다. InfoPath 솔루션의 네임스페이스가 저장되는 SharePoint 문서 라이브러리입니다(예: 예를 들어 myNamespace입니다. 참고: 이 필드는 대/소문자를 구분합니다. 템플릿 네임스페이스 열 템플릿 문서 라이브러리가 채워진 경우에만 필요합니다. InfoPath 솔루션의 네임스페이스를 저장하는 SharePoint 템플릿 문서 라이브러리 열입니다. 예를 들어 myNamespace입니다. 참고: 이 필드는 대/소문자를 구분합니다. SharePoint Online 암호 선택 사항입니다. SharePoint Online 계정의 암호입니다. SharePoint Online 사용자 이름 선택 사항입니다. SharePoint Online 계정의 사용자 이름입니다. 열 n선택 사항입니다. 대상 문서 라이브러리에 있는 SharePoint 열입니다. 메시지에서 추출되거나 열 값 필드에 지정된 값으로 이 열을 업데이트합니다. 참고: 최대 16개의 열을 지정할 수 있습니다. 이 필드는 대/소문자를 구분합니다. 열 n값선택 사항입니다. 이 메시지에 대해 설정할 열 값을 입력합니다. 'Purchase Order'와 같은 리터럴 값이나 식을 입력할 수 있습니다. 식에는 리터럴, 매크로 및 XPATH 쿼리가 혼합되어 포함될 수 있습니다(예: 예를 들어 "%XPATH=//po:POAmount%", "%SendingOrchestrationID%"를 입력합니다. 참고: 최대 16개의 열을 지정할 수 있습니다. 확인을 클릭하여 설정을 저장합니다.
그 밖에 다음과 같은 송신 포트 구성 방법이 있습니다.
동적 송신 포트 만들기
동적 송신 포트를 만들 때는 송신 핸들러를 어댑터마다 구성할 수 있습니다. 단일 동적 송신 포트를 여러 어댑터에서 사용할 수 있습니다. 동적 송신 포트 처리기를 구성하는 단계는 동적 송신 포트 처리기가 구성 가능함 을 참조하세요.
BizTalk Server 관리 콘솔에서 BizTalk 그룹 [GroupName]을 확장하고 애플리케이션을 확장한 다음 송신 포트를 포함하도록 애플리케이션을 확장합니다.
포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 클릭한 다음 동적 단방향 송신 포트 또는 동적 Solicit-Response 송신 포트를 선택합니다.
속성에서 이름 및 파이프라인 속성을 입력합니다.
Configure를 클릭합니다.
송신 처리기 구성 창에서 개별 어댑터에 대한 송신 처리기를 선택합니다. 기본 송신 처리기는 BizTalkServerApplication입니다. 새 송신 처리기를 추가하는 단계는 어댑터 처리기를 만드는 방법으로 이동합니다.
개별 호스트는 다음과 같은 여러 가지 이유로 사용하게 됩니다.
32비트 요구 사항: 일부 어댑터에는 FTP 및 POP3 어댑터와 같은 32비트 호스트가 필요합니다. 32비트 어댑터 전체나 각각을 해당 호스트로 그룹화할 수 있습니다.
용도에 따라 호스트: 보낼 호스트, 수신 호스트, 오케스트레이션 처리를 위한 호스트 및 추적을 위한 호스트를 만듭니다.
다른 호스트 설정: 많은 설정이 호스트 수준에서 구현됩니다. 따라서 각 호스트에 대해 여러 가지 조정 설정을 구성할 수 있습니다. 예를 들어, HostA에서는 조정을 사용하지 않고, HostB에서는 모든 이벤트를 추적하고, HostC의 .NET CLR 설정을 수정하고, HostD에 대해서는 메모리 사용량을 늘릴 수 있습니다.
보안: 보안은 호스트 수준에서 구현됩니다. 각 호스트는 해당 Windows 계정을 통해 실행됩니다. 예를 들어 HostA가 FILE 어댑터를 사용하여 파일 공유에 액세스하는 경우, HostA 사용자 계정 권한을 파일 공유에 제공합니다. HostB가 IIS 서버에서 호스팅된 웹 서비스를 사용하는 경우에는 HostB 사용자 계정 권한을 웹 서비스에 제공합니다. 이렇게 하면 액세스할 필요가 없는 항목을 다른 호스트 계정이 액세스할 수 없게 됩니다.
별도의 어댑터: 예를 들어 HTTP 어댑터를 사용하는 여러 아티팩트(수신 위치 및 송신 포트)가 있습니다. HTTP 어댑터와 연관된 모든 항목을 자체 호스트에 넣을 수 있습니다.
별도의 오케스트레이션: 개별 오케스트레이션은 자체 호스트에 있을 수 있습니다. 예를 들어 메모리나 CPU 사용량이 큰 오케스트레이션을 자체 호스트에 넣습니다.
BizTalk Server 성능 최적화 가이드 및 BizTalk Server 데이터베이스의 유지 관리 및 문제 해결 방법은 성능 제안을 제공합니다.
확인을 클릭하여 설정을 저장합니다.
그 밖에 다음과 같은 송신 포트 구성 방법이 있습니다.
확인을 클릭하여 설정을 저장합니다.
기타 송신 포트 항목
참고 항목
SharePoint Services 어댑터구성 SharePoint Services 수신 위치CSOM: SharePoint Services 어댑터 문제 해결