연습: SharePoint 워크플로 솔루션 만들기 및 디버깅

아티클
02/21/2013

이 연습에서는 기본적인 순차 워크플로 템플릿을 만드는 방법을 보여 줍니다.워크플로에서는 공유 문서 라이브러리의 속성을 검사하여 문서가 검토되었는지 여부를 확인합니다.문서가 검토된 경우 워크플로가 완료됩니다.

이 연습에서는 다음 작업을 수행합니다.

Visual Studio에서 SharePoint 목록 정의 순차 워크플로 프로젝트 만들기
워크플로 작업 만들기
워크플로 작업 이벤트 처리

[!참고]

이 연습에서는 순차 워크플로 프로젝트를 사용하지만 상태 시스템 워크플로 프로젝트의 경우에도 프로세스가 동일합니다.

또한 시스템에서 일부 Visual Studio 사용자 인터페이스 요소에 대해 다음 지침에서 설명한 것과 다른 이름 또는 위치를 표시할 수 있습니다.설치한 Visual Studio 버전과 사용하는 설정에 따라 이러한 요소가 결정됩니다.자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

이 연습을 완료하려면 다음 구성 요소가 필요합니다.

지원되는 Microsoft Windows 및 SharePoint 버전.자세한 내용은 SharePoint 솔루션 개발 요구 사항을 참조하십시오.
Visual Studio

SharePoint 공유 문서 라이브러리에 속성 추가

공유 문서 라이브러리에 있는 문서의 검토 상태를 추적하려면 SharePoint 사이트의 공유 문서에 대해 Status, Assignee 및 Review Comments의 세 가지 속성을 만듭니다.이러한 속성은 공유 문서 라이브러리에서 정의합니다.

SharePoint 공유 문서 라이브러리에 속성을 추가하려면

웹 브라우저에서 SharePoint 사이트(예: http://<시스템 이름>/SitePages/Home.aspx)를 엽니다.
빠른 실행 표시줄에서 선택 공유문서.
선택 라이브러리 에 라이브러리 도구 리본 및 다음 선택은 열 만들기 새 열을 만들려면 리본 메뉴의 단추.
문서 상태 열 이름, 형식 설정 **선택 (선택할 메뉴)**다음 세 가지 선택 옵션을 지정 하 고 다음 선택은 확인 단추:
- 검토 필요
- 검토 완료
- 변경 요청
두 개의 열을 더 만들고 해당 이름을 Assignee 및 Review Comments로 지정합니다.Assignee 열 형식을 한 줄 텍스트로 설정하고 Review Comments 열 형식을 여러 줄 텍스트로 설정합니다.

문서를 체크 아웃하지 않고도 편집할 수 있도록 설정

문서를 체크 아웃하지 않고 편집할 수 있는 경우 워크플로 템플릿을 보다 손쉽게 테스트할 수 있습니다.다음 절차에서는 문서를 체크 아웃하지 않고 편집할 수 있도록 SharePoint 사이트를 구성합니다.

문서를 체크 아웃하지 않고도 편집할 수 있도록 설정하려면

빠른 실행 표시줄에서 선택 된 공유 문서 링크.
에 라이브러리 도구 리본, 선택할는 라이브러리 탭을 클릭 한 다음 선택의 라이브러리 설정 단추를 표시 하는 문서 라이브러리 설정 페이지.
에 일반 설정 을 섹션에서 선택의 버전 관리 설정 링크를 표시 하는 버전 관리 설정 페이지.
**문서를 편집하려면 먼저 체크 아웃해야 합니다.**가 아니요로 설정되어 있는지 확인합니다.이 아닌 경우 변경할 No 다음 선택은 확인 단추.
브라우저를 닫습니다.

SharePoint 순차 워크플로 프로젝트 만들기

순차 워크플로는 마지막 작업이 끝날 때까지 순서대로 실행되는 일련의 단계입니다.이 절차에서는 공유 문서 목록에 적용할 순차 워크플로를 만듭니다.워크플로 마법사를 사용하면 워크플로를 사이트 정의나 목록 정의에 연결하고 워크플로 시작 시기를 결정할 수 있습니다.

SharePoint 순차 워크플로 프로젝트를 만들려면

Visual Studio를 시작합니다.
메뉴 표시줄에서 선택 파일, New, 프로젝트 표시 하는 새 프로젝트 대화 상자.
확장은 SharePoint 노드 중 하나에서 C# 또는 Visual Basic, 다음 선택은 2010 노드.
에 템플릿 창에서 선택에서 SharePoint 2010 프로젝트 템플릿.
에 이름 상자에서 Mysharepointworkflow를 입력 한 다음 선택 된 확인 단추.

SharePoint 사용자 지정 마법사가 나타납니다.
에 사이트 지정 및 디버깅에 대 한 보안 수준 페이지에서 선택의 팜 솔루션으로 배포 옵션 단추를 선택한 다음 선택의 완료 신뢰 수준 및 기본 사이트 수락 단추.

이 단계에서는 솔루션의 신뢰 수준을 팜 솔루션으로 설정합니다. 이 옵션은 워크플로 프로젝트에 사용할 수 있는 유일한 옵션입니다.자세한 내용은 샌드박스가 적용된 솔루션 고려 사항을 참조하십시오.
솔루션 탐색기프로젝트 노드를 선택 하 고 다음 메뉴 표시줄에서 선택 프로젝트, 새 항목 추가.
하나 C# 또는 Visual Basic, 확장은 SharePoint 노드를 다음 선택은 2010 노드.
에 템플릿 창에서 선택의 순차적 워크플로 (팜 솔루션) 서식 파일을 다음 선택의 추가 단추.

SharePoint 사용자 지정 마법사가 나타납니다.
디버깅에 사용할 워크플로 이름 지정 페이지에서 기본 이름(MySharePointWorkflow - Workflow1)을 적용합니다.기본 워크플로 템플릿 형식 값 유지 목록 워크플로, 다음 선택은 다음 단추.
에 Visual Studio 디버그 세션에서 워크플로 자동으로 연결 하 시겠습니까? 페이지에서 선택 된 다음 단추 기본 설정을 모두 적용 합니다.

이 단계에서는 워크플로를 공유 문서 라이브러리에 자동으로 연결합니다.
에 워크플로 시작 하는 방법에 대 한 조건을 지정 합니다. 페이지에서 기본 옵션을 선택 하지는 워크플로 시작 하려면 선택 하는 방법? 구역 및 선택 된 완료 단추.

이 페이지에서는 워크플로가 시작되는 시점을 지정할 수 있습니다.기본적으로 워크플로는 SharePoint에서 사용자가 수동으로 워크플로를 시작하거나 워크플로와 연결된 항목이 만들어지면 시작됩니다.

워크플로 작업 만들기

워크플로에는 수행할 작업을 나타내는 작업이 하나 이상의 포함됩니다.Workflow Designer를 사용하여 워크플로의 작업을 정렬할 수 있습니다.이 절차에서는 워크플로에 HandleExternalEventActivity 및 OnWorkFlowItemChanged라는 두 가지 작업을 추가합니다.두 작업은 공유 문서 목록에서 문서의 검토 상태를 모니터링합니다.

워크플로 작업을 만들려면

Workflow Designer에 워크플로가 표시됩니다.아니면, 하나 열 Workflow1.cs 또는 Workflow1.vb 에서 솔루션 탐색기.
디자이너에서 선택 된 OnWorkflowActivated1 활동 합니다.
에 속성 창 옆에 Onworkflowactivated를 입력는 호출 속성을 다음 Enter 키를 선택 합니다.

코드 편집기가 열리고 onWorkflowActivated라는 이벤트 처리기 메서드가 Workflow1 코드 파일에 추가됩니다.
Workflow Designer로 돌아가서 도구 상자를 열고 Windows Workflow v3.0 노드를 확장합니다.
에 v3.0 Windows 워크플로 의 노드는 도구, 다음 단계 중 하나를 수행:
1. 바로 가기 메뉴 열기는 동안 활동을 하 고 선택 복사.워크플로 디자이너에서 바로 가기 메뉴 줄에서 열은 onWorkflowActivated1 활동, 다음 선택 붙여넣기.
2. 드래그는 동안 활동에서의 도구 상자 워크플로 디자이너에 활동 하는 선에서 연결는 onWorkflowActivated1 활동.
선택 된 WhileActivity1 활동 합니다.
에 속성 설정 창에서 조건 코드 조건.
확장의 조건 속성을 자식 옆에 Isworkflowpending을 입력 조건 속성을 다음 Enter 키를 선택 합니다.

코드 편집기가 열리고 isWorkflowPending이라는 메서드가 Workflow1 코드 파일에 추가됩니다.
Workflow Designer로 돌아가서 도구 상자를 열고 SharePoint 워크플로 노드를 확장합니다.
에 SharePoint 워크플로 의 노드는 도구, 다음 단계 중 하나를 수행:
- 바로 가기 메뉴 열기는 OnWorkflowItemChanged 활동을 하 고 선택 복사.워크플로 디자이너에서 선 내부에 대 한 바로 가기 메뉴 열기는 whileActivity1 활동을 하 고 선택 붙여넣기.
- 드래그는 OnWorkflowItemChanged 활동에서의 도구 상자 워크플로 디자이너에 선 내 활동에 연결 하 고는 whileActivity1 활동.
선택 된 onWorkflowItemChanged1 활동 합니다.
속성 창에서 속성을 다음 표와 같이 설정합니다.

Property

값

CorrelationToken

workflowToken

Invoked

onWorkflowItemChanged

Property	값
CorrelationToken	workflowToken
Invoked	onWorkflowItemChanged

작업 이벤트 처리

마지막으로 각 작업에서 문서 상태를 확인합니다.문서가 검토된 경우 워크플로가 완료됩니다.

작업 이벤트를 처리하려면

Workflow1.cs 또는 Workflow1.vb에서 Workflow1 클래스의 맨 위에 다음 필드를 추가합니다.작업에서 이 필드를 사용하여 워크플로를 완료할지 여부를 결정합니다.
```
Dim workflowPending As Boolean = True
```
```
Boolean workflowPending = true;
```
Workflow1 클래스에 다음 메서드를 추가합니다.이 메서드는 문서 목록의 Document Status 속성 값을 검사하여 문서가 검토되었는지 여부를 확인합니다.Document Status 속성이 Review Complete로 설정되어 있으면 checkStatus 메서드는 workflowPending 필드를 false로 설정하여 워크플로를 완료할 수 있음을 나타냅니다.
```
Private Sub checkStatus()
    If CStr(workflowProperties.Item("Document Status")) = "Review Complete" Then
        workflowPending = False
    End If
End Sub 
```
```
private void checkStatus()
{
    if ((string)workflowProperties.Item["Document Status"] == "Review Complete")
    workflowPending = false;
}
```
onWorkflowActivated 및 onWorkflowItemChanged 메서드에 다음 코드를 추가하여 checkStatus 메서드를 호출합니다.워크플로가 시작되면 onWorkflowActivated 메서드는 checkStatus 메서드를 호출하여 문서가 이미 검토되었는지 여부를 확인합니다.문서가 검토되지 않았으면 워크플로가 계속 실행됩니다.문서를 저장할 때 onWorkflowItemChanged 메서드는 checkStatus 메서드를 다시 호출하여 문서가 검토되었는지 여부를 확인합니다.workflowPending 필드가 true로 설정되어 있는 동안에는 워크플로가 계속 실행됩니다.
```
Private Sub onWorkflowActivated(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub

Private Sub onWorkflowItemChanged(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ExternalDataEventArgs)
    checkStatus()
End Sub
```
```
private void onWorkflowActivated(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}

private void onWorkflowItemChanged(object sender, ExternalDataEventArgs e)
{
    // Check the status.
    checkStatus();
}
```
isWorkflowPending 메서드에 다음 코드를 추가하여 workflowPending 속성의 상태를 확인합니다.문서가 저장될 때마다 whileActivity1 작업에서는 isWorkflowPending 메서드를 호출합니다.이 메서드는 ConditionalEventArgs 개체의 Result 속성을 검사하여 WhileActivity1 작업을 계속해야 할지 마쳐야 할지를 결정합니다.속성이 true로 설정되어 있으면 해당 작업이 계속 실행됩니다.그렇지 않으면 작업이 완료되고 워크플로가 완료됩니다.
```
Private Sub isWorkflowPending(ByVal sender As System.Object, ByVal e As System.Workflow.Activities.ConditionalEventArgs)
    e.Result = workflowPending
End Sub
```
```
private void isWorkflowPending(object sender, ConditionalEventArgs e)
{
    e.Result = workflowPending;
}
```
프로젝트를 저장합니다.

SharePoint 워크플로 템플릿 테스트

디버거를 시작하면 Visual Studio에서는 워크플로 템플릿을 SharePoint 서버에 배포하고 워크플로를 공유 문서 목록에 연결합니다.워크플로를 테스트하려면 공유 문서 목록에 있는 문서에서 워크플로 인스턴스를 시작합니다.

SharePoint 워크플로 템플릿을 테스트하려면

Workflow1.cs 또는 Workflow1.vb에서 onWorkflowActivated 메서드 옆에 중단점을 설정합니다.
빌드하고 솔루션을 실행 하려면 F5 키를 선택 합니다.

SharePoint 사이트가 나타납니다.
Sharepoint는 탐색 창에서 선택 된 공유 문서 링크.
에 공유 문서 페이지에서 선택의 문서 에 링크는 라이브러리 도구 탭을 클릭 한 다음 선택의 문서 업로드 단추.
에 문서 업로드 대화 상자에서 선택의 찾아보기 단추, 모든 문서 파일을 선택, 선택의 열려 단추를 클릭 한 다음 선택의 확인 단추.

이렇게 하면 선택한 문서가 공유 문서 목록에 업로드되고 워크플로가 시작됩니다.
Visual Studio에서 디버거가 onWorkflowActivated 메서드 옆의 중단점에서 중지되는지 확인합니다.
실행을 계속 하려면 F5 키를 선택 합니다.
여기에 문서에 대 한 설정을 변경할 수 있지만 이러한 기본값을 그대로 선택 하 여 하지의 저장 단추.

이렇게 하면 기본 SharePoint 웹 사이트의 공유 문서 페이지로 돌아갑니다.
에 공유 문서 페이지에서 확인 값 아래는 MySharePointWorkflow – Workflow1 열에 설정 된 진행 중.이는 워크플로가 진행 중이고 문서 검토가 대기 중임을 나타냅니다.
에 공유 문서 페이지, 문서를 선택, 선택 화살표 표시 되 고 선택은 속성 편집 메뉴 항목.
설정 문서 상태 에 검토 완료, 다음 선택은 저장 단추.

이렇게 하면 기본 SharePoint 웹 사이트의 공유 문서 페이지로 돌아갑니다.
에 공유 문서 페이지에서 확인 값 아래는 문서 상태 열에 설정 된 검토 완료.새로 고침의 공유 문서 페이지 및 확인 값 아래는 MySharePointWorkflow – Workflow1 열에 설정 된 완료.이는 워크플로가 완료되고 문서가 검토되었음을 나타냅니다.

다음 단계

다음 항목에서는 워크플로 템플릿을 만드는 방법에 대해 더 자세히 설명합니다.

SharePoint 워크플로 작업에 대한 자세한 내용은 Workflow Activities for SharePoint Foundation을 참조하십시오.
Windows Workflow Foundation 작업에 대한 자세한 내용은 System.Workflow.Activities Namespace를 참조하십시오.

참고 항목

기타 리소스

SharePoint 워크플로 솔루션 만들기

SharePoint 프로젝트 및 프로젝트 항목 템플릿

SharePoint 솔루션 빌드 및 디버깅

다음을 통해 공유