연습: Visual Studio에 SharePoint Designer의 다시 사용 가능한 워크플로 가져오기

아티클
08/09/2011

이 연습에서는 SharePoint Designer 2010에서 만든 다시 사용할 수 있는 워크플로를 Visual Studio SharePoint 워크플로 프로젝트로 가져오는 방법을 보여 줍니다.

SharePoint Designer에서 만든 워크플로, 즉 선언적 워크플로는 코드 대신 XML 문으로 구성됩니다. SharePoint Designer 2010에서는 SharePoint 사이트의 여러 목록에서 사용할 수 있는 이식 가능한 선언적 워크플로인 다시 사용할 수 있는 워크플로를 소개합니다.

순차 워크플로, 상태 시스템 워크플로 등 Visual Studio 2010에서 만든 워크플로를 코드 워크플로라고 합니다. 코드 워크플로는 사용자가 워크플로 동작을 사용자 지정할 수 있는 코드 모듈과 XML 파일로 구성됩니다.

Visual Studio 2010을 사용하면 SharePoint Designer 2010에서 만든 다시 사용할 수 있는 워크플로를 가져와 SharePoint 사이트에서 사용할 코드 워크플로로 변환할 수 있습니다.

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

SharePoint Designer에서 간단한 다시 사용할 수 있는 워크플로 만들기
SharePoint Designer의 다시 사용할 수 있는 워크플로를 .wsp 파일 및 SharePoint로 내보내기
다시 사용할 수 있는 워크플로 가져오기 프로젝트를 사용하여 .wsp 파일을 Visual Studio로 가져오기
코드를 추가하여 워크플로 변경
SharePoint 사이트에서 가져온 워크플로 사용

참고

다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

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

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

대상 SharePoint 하위 사이트 만들기

먼저 SharePoint Designer의 다시 사용할 수 있는 워크플로를 호스팅할 하위 사이트와 변환된 워크플로를 호스팅할 하위 사이트 등 두 개의 새로운 SharePoint 하위 사이트를 만듭니다.

SharePoint 하위 사이트를 만들려면

SharePoint Designer 2010의 파일 메뉴에서 사이트 열기를 클릭합니다.
사이트 열기 대화 상자에서 워크플로를 만들려는 SharePoint 사이트로 이동하거나 기본값 http://system name/을 사용하고 열기를 클릭합니다.

홈 페이지가 나타납니다.
하위 사이트 섹션에서 새로 만들기를 클릭합니다.
새로 만들기 대화 상자의 왼쪽 창에서 SharePoint 서식 파일을 선택한 다음 오른쪽 창에서 팀 사이트를 선택합니다.
웹 사이트의 위치를 지정하십시오. 상자에서 URL의 단어 subsite를 SPD1로 바꾼 다음 확인을 클릭합니다.

SharePoint Designer에 새 하위 사이트가 열립니다. 이 SharePoint Designer 인스턴스를 닫고 첫 번째 인스턴스(최상위 사이트)로 돌아갑니다.
3 - 5단계를 반복하여 둘째 하위 사이트를 만듭니다. 이번에는 URL의 단어 subsite를 SPD2로 바꿉니다.

SharePoint Designer에서 다시 사용할 수 있는 워크플로 만들기

SharePoint에는 이 예제에 사용할 수 있는 다시 사용할 수 있는 워크플로가 없으므로 새로 만듭니다. 이 간단한 워크플로에서는 사용자가 특정 제목을 가진 새 작업을 작업 목록에 입력하면 작업이 해당 사용자에게 할당됩니다.

SharePoint Designer에서 다시 사용할 수 있는 워크플로를 만들려면

하위 사이트 섹션에서 SPD1 사이트를 클릭하여 수정합니다.
리본 메뉴에서 다시 사용할 수 있는 워크플로를 클릭합니다.

다시 사용할 수 있는 워크플로 만들기 마법사가 나타납니다.
이름 상자에 SPD Task Workflow를 입력합니다.
콘텐츠 형식 상자에서 작업을 클릭한 다음 확인을 클릭합니다.

SharePoint Designer Workflow Designer에서 워크플로가 열립니다.
1단계가 선택되었는지 확인하고 리본 메뉴에서 조건 단추를 클릭한 다음 조건 목록에서 현재 항목 필드와 값이 일치하는 경우를 선택합니다.

이렇게 하면 필드와 값이 일치하는 경우라는 새 조건이 추가됩니다.
필드와 값이 일치하는 경우 조건에서 필드 링크를 클릭합니다.
값 목록에서 제목을 선택합니다.
필드와 값이 일치하는 경우 조건에서 값 링크를 클릭합니다.
상자에 New task를 입력합니다.

이제 조건문이 현재 항목:Title이 새 작업과 일치하는 경우로 표시됩니다.
조건문 아래의 줄을 클릭하고 리본 메뉴에서 동작 단추를 클릭한 다음 동작 목록에서 현재 항목의 필드 설정을 선택합니다.
필드를 값으로 설정 동작의 필드 링크를 클릭하고 담당자를 선택합니다.
필드를 값으로 설정 동작의 값 링크를 클릭하고 기존 사용자 및 그룹 목록에서 현재 항목을 만든 사용자를 선택한 다음 추가 단추, 확인을 차례로 클릭합니다.

이제 동작 문이 담당자를 현재 항목으로 설정:CreatedBy로 표시됩니다.

다시 사용할 수 있는 워크플로 저장 및 배포

Visual Studio에서는 .wsp 파일만 가져올 수 있기 때문에 다시 사용할 수 있는 워크플로를 Visual Studio로 가져오기 전에 .wsp 파일로 저장하고 SharePoint에 배포해야 합니다.

중요

다음 절차를 수행하는 동안 런타임 오류가 표시되는 경우 SharePoint 사이트에 액세스할 수 있는 시스템에서 절차를 수행해야 합니다.

다시 사용할 수 있는 워크플로를 저장 및 배포하려면

SharePoint Designer의 맨 위에 있는 저장 단추를 클릭하여 진행 상황을 저장하고 게시 단추를 클릭하여 SPD1 SharePoint 사이트에 워크플로를 배포합니다.
탐색 창에서 워크플로를 클릭합니다.
다시 사용할 수 있는 워크플로에서 SPD 작업 워크플로를 클릭합니다.
리본 메뉴에서 템플릿로 저장을 클릭하여 워크플로를 .wsp 파일로 저장합니다.
브라우저에서 SPD1 SharePoint 사이트를 열고 SharePoint에서 .wsp 파일을 확인합니다.
빠른 실행 모음에서 라이브러리를 클릭합니다.
문서 라이브러리 섹션에서 사이트 자산을 클릭합니다.

SPD 작업 워크플로 파일이 다른 사이트 자산과 함께 나열됩니다.
목록에서 파일 이름을 클릭합니다. 그러면 파일 다운로드 대화 상자가 나타납니다.
파일 다운로드 대화 상자에서 저장 단추를 클릭하여 .wsp 파일을 시스템에 저장합니다.

.wsp 파일을 Visual Studio로 가져오기

다시 사용할 수 있는 워크플로 가져오기 프로젝트를 사용하여 .wsp 파일을 Visual Studio로 가져옵니다. 이 프로젝트에서는 워크플로를 다시 사용할 수 있는 선언적 워크플로에서 코드 워크플로로 변환합니다. 워크플로가 변환된 후 코드를 사용하여 동작을 수정합니다.

.wsp 파일에서 워크플로를 가져오고 수정하려면

Visual Studio의 파일 메뉴에서 새로 만들기를 가리킨 다음 새 프로젝트를 클릭하여 새 프로젝트 대화 상자를 표시합니다.
Visual C# 또는 Visual Basic 아래의 SharePoint 노드를 확장한 다음 2010을 클릭합니다.
템플릿 창에서 다시 사용할 수 있는 워크플로 가져오기를 클릭하고 프로젝트 이름을 WorkflowImportProject1로 유지한 다음 확인을 클릭합니다.

SharePoint 사용자 지정 마법사가 나타납니다.
디버깅에 사용할 사이트 및 보안 수준 지정 페이지에서 이전에 만든 두 번째 SharePoint 하위 사이트의 URL을 http://system name/SPD2로 입력합니다.
이 SharePoint 솔루션의 신뢰 수준을 선택하십시오. 섹션에서 선택 항목을 팜 솔루션으로 배포로 유지합니다.

샌드박스가 적용된 솔루션과 팜 솔루션 비교에 대한 자세한 내용은 샌드박스가 적용된 솔루션 고려 사항을 참조하십시오.
새 프로젝트 소스 지정 페이지에서 이전에 .wsp 파일을 저장한 시스템 위치로 이동한 후 다음을 클릭합니다.

참고

이 페이지에서 마침을 클릭하면 .wsp 파일에서 사용 가능한 모든 항목을 가져오게 됩니다.

이렇게 하면 다시 사용 가능한 워크플로 중 가져올 수 있는 워크플로의 목록이 표시됩니다.
가져올 항목 선택 상자에서 SPD Task Workflow 워크플로를 선택한 다음 마침을 클릭합니다.

가져오기 작업이 완료되면 SPD_Workflow_TestFT라는 워크플로가 포함된 WorkflowImportProject1 프로젝트가 만들어집니다. 이 폴더에는 워크플로의 정의 파일인 Elements.xml과 워크플로 디자이너 파일(.xoml)이 들어 있습니다. 디자이너에는 규칙 파일(.rules)과 코드 숨김 파일(프로젝트의 프로그래밍 언어에 따라 .cs 또는 .vb)의 두 개 파일이 있습니다.
워크플로 프로젝트 항목 WorkflowImportProject1을 시작 항목으로 설정합니다.

이렇게 하면 프로젝트를 디버깅하는 즉시 목록이 표시됩니다.
다시 사용할 수 있는 워크플로 가져오기로는 가져온 워크플로에 대한 연결 속성 값을 가져올 수 없으므로 이 값을 직접 입력해야 합니다. 이를 위해 다음을 수행합니다.
1. 솔루션 탐색기에서 SPD_Workflow_TestFT 워크플로 프로젝트 항목을 클릭합니다.
2. 대상 목록 속성 옆에 있는 줄임표 단추()를 클릭합니다. 이 단추가 있는 다른 속성 옆의 줄임표 단추를 클릭해도 됩니다.
3. SharePoint 사용자 지정 마법사에서 누락된 값을 채웁니다. 입력을 마쳤으면 마침을 클릭합니다.
.xoml 파일을 마우스 오른쪽 단추로 클릭하고 디자이너 보기를 선택하여 Workflow Designer에서 가져온 워크플로를 봅니다.
도구 상자의 Windows Workflow v3.0 섹션에서 코드 작업을 디자이너로 끌어 SequenceActivity1 작업 아래에 놓습니다.

CodeActivity1이라는 작업이 Workflow Designer에 추가됩니다. 이 작업에서는 사용자가 워크플로를 시작할 때 알림 목록에 알림을 만드는 코드 동작을 추가합니다.
CodeActivity1을 두 번 클릭하여 이벤트 처리기를 생성하고 코드를 봅니다.

다음 내용을 기존의 using 또는 Imports 문 아래 추가합니다.

Imports Microsoft.SharePoint
Imports System

using Microsoft.SharePoint;
using System;

codeActivity1_ExecuteCode를 다음 코드로 바꿉니다.

Private Sub codeActivity1_ExecuteCode(ByVal sender As System.Object, ByVal e As System.EventArgs)
    Try
        ' Get reference to SharePoint site.
        Dim site As SPSite = New SPSite("http://MyServer")
        Dim web As SPWeb = site.OpenWeb("SPD2/")
        ' Get reference to Announcements list.
        Dim announcementsList As SPList = web.Lists("Announcements")
        ' Add announcement to Announcements list for the Task.
        Dim oListItem As SPListItem = announcementsList.Items.Add
        oListItem("Title") = ("Assigned task on " + DateTime.Now.ToString)
        oListItem.Update()
    Catch err As Exception
        Console.WriteLine(("Error: " + err.ToString))
    End Try
End Sub

private void codeActivity1_ExecuteCode(object sender, System.EventArgs e)
{

    try
    {
        // Get reference to SharePoint site.
        SPSite site = new SPSite("http://MyServer");
        SPWeb web = site.OpenWeb("SPD2/");
        // Get reference to Announcements list.
        SPList announcementsList = web.Lists["Announcements"];

        // Add announcement to Announcements list for the Task.
        SPListItem oListItem = announcementsList.Items.Add();
        oListItem["Title"] = "Assigned task on " + DateTime.Now.ToString();
        oListItem.Update();
    }

    catch (Exception err)
    {
        Console.WriteLine("Error: " + err.ToString());
    }        
}

프로젝트 배포 및 워크플로 연결

다음으로, WorkflowImportProject1을 실행하여 SharePoint 사이트에 배포하고 워크플로를 작업 목록과 연결하여 수정 및 변환된 워크플로를 보고 테스트합니다.

프로젝트를 배포하고 워크플로를 연결하려면

Visual Studio에서 F5 키를 눌러 변환된 워크플로 프로젝트를 실행하고 배포합니다.
빠른 실행 모음에서 작업을 클릭하여 작업 목록을 표시합니다.
목록 도구 리본 메뉴에서 항목을 클릭한 다음 새 항목 단추를 클릭합니다.
작업 - 새 항목 대화 상자의 제목 상자에 New task를 입력하고 저장을 클릭합니다.
목록 도구 리본 메뉴 단추에서 목록을 클릭한 다음 목록 설정을 클릭하여 목록 설정 페이지를 표시합니다.
사용 권한 및 관리 섹션에서 워크플로 설정 링크를 클릭합니다.

워크플로 추가 페이지가 나타납니다.
워크플로 목록에서 WorkflowImportProject1 - SPD Workflow Test를 선택합니다.
이름 상자에 SPD Workflow Test를 입력한 다음 확인을 클릭합니다.
빠른 실행 모음에서 작업을 클릭합니다.
새 작업 옆에 있는 드롭다운 화살표를 클릭하고 워크플로를 선택합니다.
새 워크플로 시작 섹션에서 SPD Workflow Test 링크를 클릭한 다음 시작을 클릭하여 워크플로를 시작합니다.

참고

또는 워크플로 설정 마법사를 실행하고 워크플로를 자동 연결로 설정하여 워크플로를 목록과 자동으로 연결할 수 있습니다.

워크플로에서 두 가지 동작이 수행됩니다. 작업의 담당자 열에 사용자 이름이 표시되고 알림 목록에 알림이 표시됩니다.

참고 항목

개념

기존 SharePoint 사이트에서 항목 가져오기

기타 리소스

SharePoint 솔루션 개발

웹 파트 또는 응용 프로그램 페이지를 위해 재사용 가능한 컨트롤 만들기