연습: 플러그 인 등록 도구를 사용하여 플러그 인 등록

아티클
03/04/2017

게시 날짜: 2017년 1월

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

이 연습에서는 SDK에서 제공하는 Plug-in Registration 도구를 사용하여 플러그 인을 등록하는 방법에 대해 설명합니다. 등록할 플러그 인은 샘플: 기본 플러그인 만들기 항목의 FollowupPlugin입니다.

플러그 인은 account 엔터티, CreateRequest 메시지, 사후 이벤트 및 샌드박스에서 등록됩니다. 사용자 계정에 시스템 사용자 지정자 또는 시스템 관리자 역할이 있을 경우 모든 Microsoft Dynamics 365(온라인 및 온-프레미스) 배포에서 플러그 인을 등록할 수 있습니다.

이 연습을 시작하려면 먼저 다음 필수 조건이 완료되어야 합니다.

SDK의 Tools\PluginRegistration 폴더에서 PluginRegistration.exe 도구를 가져옵니다.Microsoft Dynamics CRM SDK 패키지를 다운로드합니다.
Microsoft Dynamics 365 서버에서 시스템 사용자 계정을 얻습니다.
사용자 계정에는 시스템 사용자 지정자 또는 시스템 관리자 역할이 있어야 합니다.Microsoft Dynamics 365의 엔터티에 대한 액세스를 제어하기 위해 역할 기반 보안을 사용할 수 있는 방법를 참조하십시오.

Microsoft Dynamics 365 서버에 연결

Plug-in Registration 도구를 실행합니다.
새 연결 만들기를 클릭합니다.
로그인 대화 상자에서 플러그 인을 등록하려는 Microsoft Dynamics 365 서버에 해당하는 배포 유형 라디오 단추를 선택합니다.온-프레미스 라디오 단추에는 IFD 배포가 포함되어 있고 온라인 단추는 Microsoft Dynamics 365(온라인)의 Windows Live 공급자용이며 Office 365 단추는 Microsoft Dynamics 365(온라인)의 Microsoft Online Services 공급자용입니다.

온라인 배포를 위한 로그인 창

온-프레미스 배포를 위한 로그인 창
사용 가능한 조직 목록 항상 표시를 클릭하면 로그인을 선택한 후 속한 조직의 목록이 표시됩니다. 따라서 플러그 인을 등록할 조직을 선택할 수 있습니다. 그렇지 않으면 기본 조직이 사용됩니다.
서버 및 로그인 계정에 대한 정보를 입력한 후 로그인을 클릭합니다.

등록된 플러그 인 또는 사용자 지정 워크플로 활동 어셈블리 및 서비스 끝점의 축소된 목록이 표시됩니다. 피드 알림 및 Microsoft.Crm.ObjectModel 어셈블리는 Microsoft Dynamics 365이 제대로 작동하는 데 필요하므로 도구에서 변경하지 않도록 합니다. 목록에서 항목을 선택하면 목록 항목에 대한 정보를 표시하는 속성 및 정보 탭 창에 결과가 표시됩니다.

응용 프로그램의 기본 창

플러그 인 어셈블리 등록

활성화하도록 조직 탭을 선택합니다.
탭의 도구 모음에서 등록을 클릭한 후 새 어셈블리 등록을 클릭합니다.
새 어셈블리 등록 대화 상자에서 Step#1 필드 오른쪽의 줄임표[…] 단추를 클릭합니다.
열기 대화 상자에서 컴파일된 SamplePlugin.dll 어셈블리의 위치로 이동합니다. 기본 위치는 SDK\SampleCode\CS\Plug-ins\bin\Debug입니다. 어셈블리를 선택한 다음 열기를 클릭합니다.
Step#2 섹션에서 SamplePlugins 어셈블리를 확장하여 해당 어셈블리의 모든 플러그 인을 봅니다.Microsoft.Crm.Sdk.Samples.FollowupPlugin 플러그 인만 선택(확인 표시)합니다.
Step#3 섹션에서 샌드박스 옵션을 선택합니다.
Step#4 섹션에서 데이터베이스 옵션을 선택합니다.

어셈블리 등록 대화 상자
선택한 플러그 인 등록을 클릭합니다. 열려 있는 대화 상자를 닫을 수 있습니다.

트리 보기에 표시되는 등록된 플러그 인

팁

로그 영역의 오류 및 다음 메시지가 포함된 로그가 표시됩니까?

<Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

그럴 경우 서버에서 사용자 지정 코드를 활성화하고 다시 시도해야 합니다. 자세한 내용은 사용자 지정 코드 실행 활성화 또는 비활성화를 참조하십시오.

SamplePlugins.dll 어셈블리와 FollowupPlugin 플러그 인이 이제 등록되고 서버에 배포됩니다. 사용자 지정 워크플로 활동 어셈블리를 등록하기 위해 도구를 사용한 경우 단계 등록에 대한 다음 섹션은 적용되지 않습니다.

이벤트에 대한 플러그 인 단계 등록

등록된 플러그 인 및 사용자 지정 워크플로 활동 트리 보기에서 (어셈블리) SamplePlugins 노드를 확장하고 등록된 플러그 인을 선택합니다.
도구 모음의 등록 메뉴로 이동한 후 새 단계 등록을 클릭합니다.

참고

플러그 인은 이벤트가 이벤트 실행 파이프라인에서 처리될 때 실행하도록 등록됩니다. 각 이벤트에는 핵심 플랫폼 작업 전후에 스테이지 이름과 파이프라인에서의 위치를 나타내는 번호가 있습니다.단계는 플러그 인이 실행되는 시기와 방법을 구성하는 데 사용되는 SDK 메시지 처리 단계 엔터티를 말합니다.
다음 그림에 표시된 대로 새 단계 등록 대화 상자를 완료합니다.

새 단계 등록 대화 상자
새 단계 등록 대화 상자를 클릭합니다.
(어셈블리) SamplePlugins 노드와 하위 노드를 확장하면 만든 플러그 인 및 단계 노드를 볼 수 있습니다. 도구를 닫을 수 있지만 플러그 인을 테스트하고 어셈블리의 등록을 취소할 때까지 열어 둘 수 있습니다.

참고

단계, 플러그 인 또는 어셈블리를 등록 취소하려면 트리에서 해당 노드를 선택한 후 도구 모음에서 등록 취소를 클릭합니다. 어셈블리 또는 단계 등록을 수정하려면 트리 보기에서 어셈블리 또는 단계 노드를 두 번 클릭합니다. 또는 노드를 선택하고 도구 모음에서 업데이트를 클릭합니다.

이제 핵심 작업이 실행된 후에 거래처 만들기 이벤트에 대해 샌드박스에서 실행하도록 플러그 인이 등록되었습니다. 후속 작업 활동 만들기는 시간이 중요한 작업이 아니므로 플러그 인을 비동기적으로 실행하도록 등록했습니다. 거래처를 만든 후 다음 번에 비동기 서비스가 큐를 처리할 때 플러그 인이 실행됩니다.

플러그 인 테스트

플러그 인을 등록 한 후 필요에 따라 다음 절차를 사용하여 실행을 테스트할 수 있습니다.

플러그 인을 등록한 조직과 동일한 조직에 대해 Microsoft Dynamics 365 웹 응용 프로그램을 엽니다.
작업 영역으로 이동하고 거래처를 선택한 후 새로 만들기를 클릭합니다.
거래처 이름 상자에 거래처 이름(예: Adventure Works Cycle)을 입력한 후 저장 후 닫기를 클릭합니다.
거래처 표에서 양식 이름을 두 번 클릭하여 양식을 엽니다.
활동을 클릭하여 거래처에 대한 관련 활동 목록을 표시합니다. 플러그 인을 만든 “Send email to the new customer“라는 활동이 표시됩니다.
비동기적으로 실행되도록 플러그 인을 등록했고, 새 단계 등록 양식에서 StatusCode가 Successful이면 AsyncOperation 삭제 옵션을 선택하지 않은 경우 “FollowupPlugin: Create of account”라는 새 시스템 작업이 있습니다. 관련 시스템 작업을 보려면 설정을 클릭한 후 시스템 작업을 클릭합니다. 앞에서 언급한 시스템 작업을 두 번 클릭합니다.

이제 원하는 경우 단계, 플러그 인 및 어셈블리를 등록 취소할 수 있습니다. 만든 시스템 작업과 거래처를 삭제하려고 할 수도 있습니다.

참고 항목

플러그 인 개발
연습: 오프라인 플러그 인에 대해 어셈블리 보안 구성
플러그 인 등록 및 배포
이벤트 실행 파이프라인
플러그 인 격리, 트러스트 및 통계
플러그 인에 대해 지원되는 메시지 및 엔터티

Microsoft Dynamics 365

다음을 통해 공유