다음을 통해 공유

사용자 지정 워크플로 활동 만들기

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

이 항목에서는 사용자 지정 워크플로 활동을 만들고 Microsoft Dynamics 365(온라인 및 온-프레미스)에 사용하도록 등록하는 방법에 대해 설명합니다.Microsoft Dynamics 365(온라인)의 경우 사용자 지정 워크플로 활동은 샌드박스(부분 신뢰)에서만 실행하도록 등록할 수 있습니다. 샌드박스 및 부분 신뢰에 대한 자세한 내용은 플러그 인 격리, 트러스트 및 통계를 참조하십시오.

이 항목의 내용

필요한 소프트웨어 및 어셈블리

CodeActivity 워크플로 기본 클래스 사용

사용자 지정 워크플로 활동에 대한 이름 및 그룹 이름 지정

필요한 소프트웨어 및 어셈블리

Dynamics 365용 Windows Workflow Foundation 4 사용자 지정 활동을 개발하려면 Microsoft .NET Framework 4.5.2에서 개발해야 합니다. 프로젝트에 다음 어셈블리를 참조로 추가해야 합니다. 어셈블리는 Microsoft Dynamics 365 SDK의 SDK\Bin 폴더에서 찾을 수 있습니다.Microsoft Dynamics CRM SDK 패키지를 다운로드합니다.

  • Microsoft.Xrm.Sdk.dll

  • Microsoft.Xrm.Sdk.Workflow.dll

CodeActivity 워크플로 기본 클래스 사용

사용자 지정 워크플로 활동을 만들려면 CodeActivity 워크플로 기본 클래스에서 상속되는 클래스를 만듭니다. 이 클래스는 System.Activities 네임스페이스에서 사용할 수 있습니다.CodeActivity 클래스에서 상속되는 활동은 Execute 메서드를 다시 정의하여 사용자 지정 기능을 생성할 수 있습니다.

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

  2. 파일 메뉴에서 새로 만들기를 클릭한 후 프로젝트를 클릭합니다.

  3. 새 프로젝트 대화 상자에서 설치된 템플릿 창의 Visual C#에서 워크플로를 선택한 후 활동 라이브러리를 선택합니다.

  4. 솔루션에 대한 이름과 위치를 지정한 후 확인을 클릭합니다.

  5. 프로젝트 메뉴로 이동하고 속성을 선택합니다.응용 프로그램 탭에서 .NET Framework 4.5.2를 대상 프레임워크로 지정합니다.

  6. Microsoft.Xrm.Sdk.dll 및 Microsoft.Xrm.Workflow.dll 어셈블리에 대한 참조를 추가합니다.

  7. 프로젝트에서 Activity1.xaml 파일을 삭제합니다.

  8. 프로젝트에 클래스 파일(.cs)을 추가합니다. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 선택한 후 클래스를 클릭합니다.새 항목 추가 대화 상자에서 클래스의 이름을 입력한 후 추가를 클릭합니다.

  9. 클래스 파일을 열고 다음 using 지시문을 추가합니다.

    using System.Activities;using Microsoft.Xrm.Sdk;using Microsoft.Xrm.Sdk.Workflow;

  10. 클래스를 CodeActivity 클래스에서 상속하도록 하고 다음과 같이 public 액세스 한정자를 지정합니다.

    public class SampleCustomActivity : CodeActivity

  11. Execute 메서드를 사용하여 클래스에 기능을 추가합니다.

    protected override void Execute(CodeActivityContext context){    //Activity code}

    자세한 내용은 사용자 지정 워크플로 활동에 메타데이터 추가을 참조하십시오.

  12. 입력 및 출력 매개 변수를 지정합니다. 자세한 내용은 사용자 지정 워크플로 활동에 메타데이터 추가을 참조하십시오.

  13. 프로젝트 속성의 서명 탭에서 어셈블리 서명을 선택하고 키 파일 이름을 입력합니다. 사용자 지정 워크플로 활동(및 플러그 인) 어셈블리를 서명해야 합니다.

  14. 어셈블리(.dll)를 만드는 프로젝트를 컴파일합니다.

사용자 지정 워크플로 활동을 만드는 방법을 보여 주는 코드 샘플을 보려면 샘플: 사용자 지정 워크플로 활동 만들기를 참조하십시오.

중요

향상된 성능을 위해 Microsoft Dynamics 365에서는 사용자 지정 워크플로 활동 인스턴스를 캐시합니다. 사용자 지정 워크플로 활동의 Execute 메서드는 생성자가 사용자 지정 워크플로 활동을 호출할 때마다 호출되지 않으므로 상태 없이 작성되어야 합니다. 다중 시스템 스레드는 동시에 사용자 지정 워크플로 활동을 실행할 수도 있습니다. 호출 상태 정보는 모두 컨텍스트에 저장되므로 전역 변수 또는 멤버 변수를 사용하여 한 호출에서 다음 호출로 데이터를 전달하지 않는 것이 좋습니다.

사용자 지정 워크플로 활동에 대한 이름 및 그룹 이름 지정

사용자 지정 워크플로 활동 어셈블리를 등록할 경우 이름과 그룹 이름을 지정합니다. 이름 속성은 워크플로 활동의 이름을 지정합니다. 그룹 이름 속성은 Microsoft Dynamics 365 프로세스 디자이너에서 기본 메뉴에 추가된 하위 메뉴의 이름을 지정합니다. 이러한 속성은 사용자 지정 워크플로 활동과 Microsoft Dynamics 365 프로세스 디자이너를 연결하므로 사용자 지정 활동 이름이 사용자 인터페이스에 표시됩니다.

사용자 지정 워크플로 활동의 이름과 그룹 이름을 지정하려면 사용자 지정 워크플로 활동 어셈블리를 등록할 때 PluginType.Name 및 PluginType.WorkflowActivityGroupName 특성을 사용합니다. 사용자 지정 워크플로 활동 등록에 대한 자세한 내용은 사용자 지정 워크플로 활동 어셈블리 등록 및 사용을 참조하십시오.PluginType.Name 및 PluginType.WorkflowActivityGroupName 특성이 널값으로 설정된 경우, 맞춤 활동은 Microsoft Dynamics 365 워크플로 디자이너에서 숨겨지며 XAML 워크플로에서만 액세스할 수 있습니다.

플러그 인 등록 도구를 사용하여 사용자 지정 활동 어셈블리를 등록할 경우 편집 가능 영역의 이름 및 워크플로 활동 그룹 이름 상자에서 적절한 값을 지정할 수 있습니다. 플러그 인 등록 도구를 사용하는 방법에 대한 자세한 내용은 연습: 플러그 인 등록 도구를 사용하여 플러그 인 등록을 참조하십시오.

등록 중 그룹 이름 및 이름 지정

이 사용자 지정 워크플로 활동을 등록한 후에는 Microsoft Dynamics 365 프로세스 디자이너에서 워크플로 또는 대화 상자에 대해 사용할 수 있습니다. 자세한 내용은 사용자 지정 워크플로 활동 어셈블리 등록 및 사용을 참조하십시오.

참고 항목

사용자 지정 워크플로 활동(워크플로 어셈블리)
사용자 지정 워크플로 활동에 메타데이터 추가
사용자 지정 워크플로 활동에서 IOrganization 웹 서비스 사용
샘플: 사용자 지정 워크플로 활동 만들기
샘플: Azure 인식 사용자 지정 워크플로 활동
Windows Workflow Foundation 4 기본 활동 클래스

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보