연습: 모듈 3 - 오케스트레이션에서 SharePoint 속성 액세스

이 연습은 연습의 연속입니다. 모듈 2 - Office를 Windows SharePoint Services 어댑터와 통합하고 런타임에 들어오는 메시지의 Windows SharePoint Services 컨텍스트 속성에 액세스한 다음 의 동적 포트를 사용하여 속성을 기반으로 해당 메시지의 대상을 결정하는 방법을 보여 줍니다. 오케스트레이션. Windows SharePoint Services 어댑터에 대한 소개는 Windows SharePoint Services 어댑터가란?을 참조하세요.

필수 구성 요소

이 항목의 절차를 수행하려면 먼저 다음 필수 구성 요소가 필요합니다.

• Windows Server 2008 SP2 또는 Windows Server 2008 R2에서 실행되는 BizTalk Server 완전히 설치한 단일 서버 배포가 있어야 합니다.

• 연습: 모듈 1 - Windows SharePoint Services 어댑터를 사용하여 메시지 보내기 및 받기 및 연습: 모듈 2 - Office와 Windows SharePoint Services 어댑터 통합 연습을 완료해야 합니다.

  다중 서버 배포에서 Windows SharePoint Services 어댑터를 사용하는 방법에 대한 자세한 내용은 Windows SharePoint Services 어댑터 설정 및 배포를 참조하세요.

BizTalk 프로젝트 수정

이 절차에서는 연습: 모듈 2 - Office를 Windows SharePoint Services 어댑터와 통합에서 PurchaseOrder 스키마를 수정합니다. 이 절차는 BizTalk 오케스트레이션에서 쉽게 액세스할 수 있도록 스키마 속성을 승격하는 방법을 보여 줍니다.

PurchaseOrder.xsd 스키마 수정

1. Microsoft Visual Studio를 시작합니다.

2. 파일을 클릭하고 열기를 클릭한 다음 프로젝트/솔루션을 클릭합니다.

3. 파일을 찾은 OrderProcess.sln 다음 열기를 클릭합니다.

4. 솔루션 탐색기 파일을 마우스 오른쪽 단추로 OrderProcessSchema.xsd 클릭한 다음 열기를 클릭합니다.

5. BizTalk 편집기에서 를 확장PurchaseOrder합니다.

6. 를 마우스 오른쪽 단추로 클릭하고 Amount승격을 클릭한 다음 빠른 승격을 클릭합니다.

7. 확인을 클릭합니다.

   참고

   Visual Studio는 현재 프로젝트에서 이에 대한 속성 스키마를 만듭니다.

8. PurchaseOrder.xsd를 저장합니다.

오케스트레이션 만들기

이 절차에서는 새 BizTalk 오케스트레이션을 만듭니다. 이 절차에서는 Windows Sharepoint Services 어댑터가 수신한 메시지를 처리하는 데 사용되는 오케스트레이션을 만듭니다.

BizTalk 오케스트레이션 추가

1. 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 OrderProcess 클릭하고 추가를 클릭한 다음 새 항목을 클릭합니다.

2. 범주에서 오케스트레이션 파일을 선택합니다.

3. 템플릿에서BizTalk 오케스트레이션을 선택합니다.

4. 이름 필드에 를 입력 MyCompanyOrderProcessing 한 다음 추가를 클릭합니다.

수신 정보 만들기

이 절차에서는 새 메시지, 수신 포트 및 오케스트레이션에 대한 수신 셰이프를 만듭니다. 이 절차에서는 BizTalk Server 메시지를 받도록 오케스트레이션을 구성하는 방법을 보여 줍니다.

새 메시지 만들기

1. 오케스트레이션 보기에서 메시지를 마우스 오른쪽 단추로 클릭한 다음 새 메시지를 클릭합니다. 그러면 이름이 Message_1인 새 메시지가 생성됩니다.

2. 를 마우스 오른쪽 단추로 클릭하고 Message_1이름 바꾸기를 클릭한 다음 를 입력합니다Message_PO.

3. 를 마우스 오른쪽 단추로 클릭한 Message_PO다음 속성 창을 클릭합니다.

4. 메시지 유형 속성에서 스키마를 확장한 다음 스키마를 선택합니다OrderProcess.OrderProcessSchema.

오케스트레이션에 수신 포트 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 포트 셰이프를 포트 표면으로 끕니다. 포트 구성 마법사가 시작됩니다.

2. 시작 화면에서 다음을 클릭합니다.

3. 이름 필드에 를 입력 ReceivePurchaseOrder 하고 다음을 클릭합니다.

4. 새 포트 유형 만들기를 선택합니다.

5. 포트 형식 이름 필드에 를 입력 PurchaseOrderPT 하고 다음을 클릭합니다.

6. 포트 바인딩 화면에서 기본값을 그대로 두고 다음을 클릭합니다.

7. Finish를 클릭합니다.

8. 오케스트레이션 뷰의 포트 형식에서 포트 유형을 확장 PurchaseOrderPT 합니다.

9. 를 마우스 오른쪽 단추로 클릭하고 Operation_1이름 바꾸기를 클릭한 다음 를 입력합니다PurchaseOrderOperation.

오케스트레이션에 수신 셰이프 추가

1. 도구 상자의 BizTalk 오케스트레이션 에서 수신 셰이프를 오케스트레이션으로 끌어옵니다.

2. 수신 셰이프를 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. Activate 속성을 True로 설정합니다.

   참고

   활성화 속성을 false로 설정하면 "오류 X2214: 상관 관계가 자동으로 지정되지 않은 포트에 연결된 수신 셰이프는 활성화 속성이 True이거나 상관 관계를 지정해야 합니다."라는 오류가 발생합니다.

4. 이름 필드에 를 입력 Receive_PO 합니다.

5. 속성 창에서 메시지 속성을 선택합니다Message_PO.

6. 작업 속성에 대해 를 선택합니다ReceivePurchaseOrder.PurchaseOrderOperation.Request. 그러면 포트가 오케스트레이션 디자이너에 있는 수신 셰이프에 연결됩니다.

송신 정보 만들기

이 절차에서는 새 메시지, 송신 포트 및 오케스트레이션에 대한 판단 구조를 만듭니다. 이 절차에서는 판단 논리로 오케스트레이션을 구성하고 송신 포트로 메시지를 보내도록 오케스트레이션을 구성하는 방법을 보여 줍니다.

새 메시지 만들기

1. 오케스트레이션 보기에서 메시지를 마우스 오른쪽 단추로 클릭한 다음 새 메시지를 클릭합니다. 그러면 이름이 Message_1인 새 메시지가 생성됩니다.

2. 를 마우스 오른쪽 단추로 클릭하고 Message_1이름 바꾸기를 클릭한 다음 를 입력합니다Message_Task.

3. 를 마우스 오른쪽 단추로 클릭한 Message_Task다음 속성 창을 클릭합니다.

4. 메시지 유형 속성에서 스키마를 확장한 다음 스키마를 선택합니다OrderProcess.OrderProcessSchema.

오케스트레이션에 송신 포트 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 포트 셰이프를 포트 표면으로 끕니다. 포트 구성 마법사가 시작됩니다.

2. 시작 화면에서 다음을 클릭합니다.

3. 이름 필드에 를 입력 SendPurchaseOrder 하고 다음을 클릭합니다.

4. 기존 포트 유형 사용을 선택합니다.

5. 사용 가능한 포트 형식에서 를 선택한 OrderProcess.PurchaseOrderPT다음, 다음을 클릭합니다.

6. 포트 바인딩 화면의 통신 포트 방향에서 를 선택하고 I'll always be sending messages on this port다음을 클릭합니다.

7. Finish를 클릭합니다.

오케스트레이션에 송신 셰이프 추가

1. 도구 상자의 BizTalk 오케스트레이션에서 셰이프 보내기를 오케스트레이션 Designer 끌어옵니다. 수신 셰이프 아래에 Receive_PO 배치합니다.

2. 보내기 셰이프를 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. 이름 필드에 를 입력 Send_PO 합니다.

4. Message 속성을 선택합니다Message_PO.

5. 작업 속성에 대해 를 선택합니다SendPurchaseOrder.PurchaseOrderOperation.Request. 그러면 포트가 오케스트레이션 디자이너에 있는 송신 셰이프에 연결됩니다.

오케스트레이션에 판단 셰이프 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 결정 셰이프를 오케스트레이션 Designer 끌어옵니다. 보내기 셰이프 아래에 Send_PO 배치합니다.

2. 셰이프 결정 을 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. 이름 필드에 를 입력 NeedsApproval 합니다.

4. 오케스트레이션 Designer 결정 셰이프에서 Rule_1 클릭합니다.

5. 속성 창에서 Name 속성을 입력 ApprovalRequired 합니다.

6. 식 속성 필드를 클릭한 다음 줄임표(...) 단추를 클릭합니다.

7. BizTalk 식 편집기에서 다음을 입력하거나 복사합니다.

   Message_PO(OrderProcess.PropertySchema.Amount) > 1000  
   

8. 확인을 클릭합니다.

오케스트레이션에 다른 송신 포트 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 포트 셰이프를 포트 표면으로 끕니다. 포트 구성 마법사가 시작됩니다.

2. 시작 화면에서 다음을 클릭합니다.

3. 이름 필드에 를 입력 SendToTasksList 하고 다음을 클릭합니다.

4. 기존 포트 유형 사용을 선택합니다.

5. 사용 가능한 포트 유형에서 를 선택한 OrderProcess.PurchaseOrderPT다음 다음을 클릭합니다.

6. 포트 바인딩 화면의 통신 포트 방향에서 를 선택합니다I'll always be sending messages on this port.

7. 포트 바인딩에서 를 선택한 Dynamic다음, 다음을 클릭합니다.

8. Finish를 클릭합니다.

판단 셰이프에 송신 셰이프 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 셰이프 보내기를 오케스트레이션 Designer 끌어옵니다. 셰이프 아래에 ApprovalRequired 배치합니다.

2. 셰이프 보내기를 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. 이름 필드에 를 입력 CreateApprovalTask 합니다.

4. Message 속성에 대해 를 선택합니다Message_Task.

5. 작업 속성에 대해 를 선택합니다SendToTasksList.PurchaseOrderOperation.Request. 그러면 포트가 오케스트레이션 디자이너에 있는 송신 셰이프에 연결됩니다.

식 만들기

이 절차에서는 식 셰이프를 작업 경로 값을 변수에 할당하는 솔루션에 추가합니다. 이 절차에서는 동적 송신 포트의 속성을 수정하도록 오케스트레이션에 논리를 추가하는 방법을 보여 줍니다.

새 식 만들기

1. 도구 상자의 BizTalk 오케스트레이션 에서 식 셰이프를 보내기 셰이프 앞에 CreateApprovalTask 끕다.

2. 식 셰이프를 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. 이름 필드에 를 입력 SetPortDestination 합니다.

4. 식 속성 필드를 클릭한 다음 줄임표(...) 단추를 클릭합니다.

5. BizTalk 식 편집기에서 다음을 입력합니다.

   SendToTasksList(Microsoft.XLANGs.BaseTypes.Address) = "wss://localhost/sites/WSSAdapterWalkthrough/Lists/Tasks/";  
   

6. 확인을 클릭합니다.

새 메시지 생성

이 절차에서는 솔루션에 생성 셰이프를 추가하여 오케스트레이션 내에서 새 메시지 유형 인스턴스를 생성하도록 합니다. 이 절차에서는 인바운드 메시지의 복사본인 새 메시지를 만든 다음 새 메시지의 컨텍스트 속성을 수정하는 방법을 보여 줍니다. BizTalk에서는 메시지를 변경할 수 없으므로 이 단계가 필요합니다(메시지를 생성한 후에는 원본을 수정할 수 없음).

생성 셰이프 추가

1. 도구 상자의 BizTalk 오케스트레이션 아래에서 구문 메시지 셰이프를 식 셰이프 앞으로 SetPortDestination 끌어옵니다.

2. 메시지 생성 셰이프를 마우스 오른쪽 단추로 클릭한 다음 속성 창을 클릭합니다.

3. 이름 필드에 를 입력ConstructTaskMessage합니다.

4. 메시지 생성 속성에 대해 를 선택합니다Message_Task.

5. 도구 상자의 BizTalk 오케스트레이션 아래에서 메시지 할당 셰이프를 메시지 생성 셰이프로 ConstructTaskMessage 끌어옵니다.

6. 속성 창에서 이름 필드를 입력 InitTaskMessage 합니다.

7. 식 속성 필드를 클릭한 다음 줄임표(...) 단추를 클릭합니다.

8. BizTalk 식 편집기에서 다음을 입력하거나 복사합니다.

   Message_Task = Message_PO;  
   Message_Task(WSS.ConfigOverwrite) = "no";  
   Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'";  
   Message_Task(WSS.ConfigPropertiesXml) = "<ConfigPropertiesXml><PropertyName1>Title</PropertyName1><PropertySource1>Approve %XPATH=//orchns:PurchaseOrder/orchns:PurchaseOrderID%</PropertySource1><PropertyName3>Status</PropertyName3><PropertySource3>Not Started</PropertySource3><PropertyName4>Priority</PropertyName4><PropertySource4>(1) High</PropertySource4></ConfigPropertiesXml>";  
   

   중요

   이러한 컨텍스트 속성에 대해 제공한 값은 대/소문자를 구분합니다. 컨텍스트 속성으로 동적 포트에 대한 구성 값을 설정할 때는 대/소문자를 올바르게 사용해야 합니다. 그렇지 않으면 BizTalk에서 문서를 지정된 송신 포트로 라우팅할 때 오류가 발생합니다.

9. 확인을 클릭합니다.

10. 파일을 클릭한 다음 모두 저장을 클릭합니다.

BizTalk 프로젝트 빌드

이 절차에서는 BizTalk 프로젝트를 빌드 및 배포합니다. 이 단계는 BizTalk Server 런타임에 사용하는 어셈블리를 만들고 배포하는 데 필요합니다.

솔루션 빌드 및 배포

1. 빌드를 클릭한 다음 OrderProcess 빌드를 클릭합니다.

2. 빌드를 클릭한 다음 OrderProcess 배포를 클릭합니다.

3. Microsoft Visual Studio를 닫습니다.

수신 위치 및 송신 포트 수정

이 절차에서는 파이프라인에 대해 XML 처리를 사용하도록 기존 수신 위치 및 송신 포트를 수정합니다. 수신 XML 파이프라인은 오케스트레이션 처리 중에 사용된 메시지 속성을 지속하고 송신 XML 파이프라인은 메시지 라우팅에 나중에 사용되는 오케스트레이션에 적용된 메시지 속성을 지속합니다.

수신 위치 수정

1. 시작을 클릭하고 모든 프로그램을 가리킨 다음 MicrosoftBizTalk Server 가리킨 다음 BizTalk Server 관리를 클릭합니다.

2. MicrosoftBizTalk Server관리 스냅인, BizTalk 그룹, 애플리케이션, BizTalk 애플리케이션 1을 차례로 확장한 다음 수신 위치 노드를 클릭합니다.

3. 를 마우스 오른쪽 단추로 클릭한 SourceLocation다음 속성을 클릭합니다.

4. 수신 위치 속성 대화 상자의 일반 아래에서 수신 파이프라인 속성을 선택합니다XMLReceive.

5. 확인을 클릭합니다.

송신 포트 수정

1. 송신 포트 노드를 클릭합니다.

2. 를 마우스 오른쪽 단추로 클릭한 SendToDestination다음 속성을 클릭합니다.

3. 송신 포트 속성 대화 상자의 일반 아래에서 송신 파이프라인 속성을 선택합니다XMLTransmit.

4. 필터 탭 을 선택합니다.

5. 기존 조건을 선택하고 DELETE 키를 누른 다음 확인을 클릭합니다.

새 송신 포트 시작

1. 송신 포트 노드를 클릭합니다.

2. 를 마우스 오른쪽 단추로 클릭한 OrderProcess_1.0.0.0_OrderProcess.MyCompanyOrderProcess_SendToTasksList_<GUID>다음 시작을 클릭합니다.

참고

표시되지 않는 경우 콘솔을 새로 고쳐야 할 수 있습니다.

오케스트레이션 바인딩

이 절차에서는 오케스트레이션을 지정된 포트로 바인딩합니다. 실제 포트를 빌드 및 배포된 오케스트레이션으로 연결하는 데 이 절차가 필요합니다.

오케스트레이션 바인딩

1. BizTalk Server 관리 콘솔에서 오케스트레이션 노드를 클릭합니다.

2. 오케스트레이션을 마우스 오른쪽 단추로 OrderProcess.MyCompanyOrderProcessing 클릭한 다음 속성을 클릭합니다.

3. 바인딩 탭 을 선택합니다.

4. 호스트에서 호스트 필드에서 를 선택합니다BizTalkServerApplication.

5. 바인딩 아래에서 인바운드 논리 포트를 ReceivePurchaseOrder 선택합니다FromSource.

6. 바인딩 아래에서 아웃바운드 논리 포트를 SendPurchaseOrder 선택합니다SendToDestination.

7. 확인을 클릭합니다.

8. 오케스트레이션을 마우스 오른쪽 단추 OrderProcess.MyCompanyOrderProcessing 로 클릭한 다음 시작을 클릭합니다.

시스템을 통해 메시지 보내기

이 절차에서는 InfoPath 양식을 만들어 Windows SharePoint Services 웹 사이트에 업로드합니다. Windows SharePoint Services 어댑터는 해당 메시지를 가져와 보관 문서 라이브러리에 보관한 다음 대상 문서 라이브러리로 보냅니다. 이 메시지를 처리하는 동안 Windows SharePoint Services 컨텍스트 속성에 액세스하여 대상을 확인할 수 있습니다.

시스템을 통해 보내는 InfoPath 양식 만들기

1. 웹 브라우저를 열고 사용자가 만든 사이트의 URL로 이동합니다. 예들 들어 http://<server_name>/sites/WSSAdapterWalkthrough입니다.

2. 빠른 실행 메뉴에서 를 클릭합니다 InfoPathSolutions.

3. PurchaseOrder 파일을 클릭하여 파일 다운로드 대화 상자를 표시한 다음 열기를 클릭합니다. InfoPath가 양식을 로드합니다.

4. 구매 주문 ID 필드에 를 입력합니다1003.

5. 청구 날짜 필드에 를 입력합니다John Doe.

6. 크기 필드에 를 입력합니다1750.

7. 구매 주문 날짜 필드에 를 입력합니다1/3/2005.

8. 저장을 클릭합니다.

9. 다른 이름으로 저장 대화 상자에서 파일 이름 필드를 입력http://<server_name>/sites/WSSAdapterWalkthrough/Source한 다음 Enter 키를 누릅니다.

10. 파일 이름 필드에 를 입력 PurchaseOrder3.xml 한 다음 저장을 클릭합니다.

11. InfoPath를 닫습니다.

12. 웹 브라우저에서 문서 및 목록을 클릭합니다.

13. 문서 라이브러리에서 대상을 클릭합니다.

14. 이제 대상 문서 라이브러리의 라이브러리에 나열된 메시지가 표시됩니다. 또한 보관 문서 라이브러리에 보관된 복사본도 찾을 수 있습니다.

15. 홈을 클릭합니다.

16. 목록에서작업을 클릭합니다.

17. 작업 목록에 새로 만들어진 승인 작업이 표시됩니다.

참고

구매 주문서의 금액이 1,000.00달러를 초과하기 때문에 작업이 만들어졌습니다.

요약

이 연습에서는 Windows SharePoint Services 컨텍스트 속성에 액세스하고 동적 포트를 통과하는 메시지의 대상을 확인하는 방법에 대해 살펴보았습니다.

다음 단계

Windows SharePoint Services 어댑터 섹션의 나머지 부분을 계속해서 검토합니다. 자세한 내용은 참고의 해당 항목을 참조하십시오.

참고 항목

Windows SharePoint Services 어댑터란?
Windows SharePoint Services 어댑터 연습