사용자 지정 플러그 인을 등록 및 배포하여 선호하는 지리 공간 데이터 공급자 사용
플러그 인을 사용하려면 먼저 서버에 등록되고 배포되어야 합니다.
플러그 인 프로젝트를 작성하면 플러그 인 어셈블리(.dll)가 생성됩니다. 이 문서에서는 기본 지리 공간 데이터 공급자를 사용하기 위해 두 개의 지리 공간 작업에 대한 플러그 인 어셈블리를 등록하고 배포하는 방법에 대한 정보를 제공합니다. 플러그 인 작성에 대한 자세한 내용은 사용자 지정 플러그인을 생성하여 선호하는 지리 공간 데이터 공급자 사용을 참조하십시오.
사용자 지정 플러그 인을 등록하는 동안 실행 순서 고려 사항
동일한 엔터티와 메시지에 대해 여러 플러그 인을 등록하면 플러그 인의 실행 순서가 개별 플러그 인의 실행 순서에 의해 정의됩니다. 낮은 실행 순서 값을 가진 플러그 인이 먼저 실행되고 실행 순서 값이 더 높은 플러그 인이 다음에 실행됩니다.
지역 코드 및 거리 매트릭스 작업의 Bing 지도를 사용하는 기본 플러그 인 Field Service 및 Project Service의 실행 순서 값은 1로 설정됩니다. 사용자 지정 플러그 인의 실행 순서를 기본 플러그 인 전(1보다 작음) 또는 후(1보다 큼)에 실행하도록 설정할 수 있습니다.
다음 표에서는 플러그 인 등록 및 매개 변수 조건에 지정된 실행 순서에 따라 사용자 지정 플러그 인을 처리하는 방법을 보여줍니다.
| 계층 구조 | Description |
|---|---|
| 기본 | 사용자 지정 플러그 인을 기본으로 취급하고 기본 Bing 플러그 인을 보조로 취급하려는 경우 플러그 인의 실행 순서를 0으로 설정합니다. 이로 인해 플러그 인이 Bing 플러그 인 이전에 실행됩니다. Bing 플러그 인은 사용자 지정 플러그 인이 반환하는 "위도" 및 "경도" 값을 검사하고 반환된 두 값이 모두 0인 경우에만 Bing을 사용하여 지역 코드로 진행됩니다. 이는 사용자 지정 플러그 인이 대부분의 지역 코딩 요구 사항을 제공해야 하는 경우 선호되는 방법입니다. |
| 보조 | Bing이 지역 코드에 실패한 경우에만 지역 코딩 서비스를 제공하여 Bing 플러그 인에 보조로 사용자 지정 플러그 인을 취급하려는 경우 플러그 인의 실행 순서를 2로 설정합니다. Bing 플러그 인이 반환하는 "위도" 및 "경도" 값을 먼저 검사하고 반환된 두 값이 모두 0인 경우에만 진행되도록 사용자 지정 플러그 인 코드를 작성할 수도 있습니다. 이는 Bing이 대부분의 지역 코딩 요구 사항을 제공해야 하는 경우 선호되는 실행 방법입니다. |
| 완전히 재정의 | 사용자 지정 플러그 인이 지역 코드에 실패한 경우에도 항상 사용자 지정 플러그 인을 지역 코딩의 원본으로 만들고 Bing을 지역 코딩에서 완전히 재정의하려면 "위도" 및 "경도" 값에 대해 0,0이 아닌 다른 항목을 항상 반환해야 합니다. .NET 예외를 throw하는 예외 조건 및 결과를 반환하지 않는 것을 결정할 수 있습니다. 결과를 반환하지 않고 후속 플러그 인이 결과를 반환하지 않도록 하려면 사용자 지정 플러그 인이 0.0001, 0.0001과 같은 값을 반환해야 합니다. |
사용자 지정 플러그 인 등록 및 배포
Plug-in Registration Tool을 사용하거나 특정 SDK 클래스를 사용하여 등록 코드를 작성하여 프로그래밍하는 방식으로 등록하고 배포할 수 있습니다. 추가 정보: 플러그 인 등록 및 배포.
이 섹션의 경우 플러그 인을 쉽게 등록하고 배포할 수 있는 그래픽 사용자 인터페이스를 제공하는 Plug-in Registration Tool을 사용합니다. 또한 이 섹션에는 샘플 사용자 지정 플러그 인을 사용하여 작업하고 CustomPlugin-FS-Geospatial 어셈블리를 생성하는 샘플 프로젝트를 빌드했다는 가정에 기반한 정보가 포함되어 있습니다. 사용자 지정 플러그 인을 개발한 경우 어셈블리 및 플러그 인의 이름이 달라지지만 플러그 인을 등록하는 전체 명령은 동일하게 유지됩니다.
팁
일반적으로 플러그 인 등록 도구를 사용하는 방법에 대한 자세한 내용은 연습: Plug-in Registration Tool을 사용하여 플러그 인 등록을 참조하십시오.
Plug-in Registration Tool을 다운로드합니다. 플러그 인 등록 도구를 다운로드하려면 NuGet에서 도구 다운로드를 참조하십시오.
[Your folder]\Tools\PluginRegistration폴더를 탐색하고 PluginRegistration.exe 파일을 두 번 클릭하여 도구를 실행합니다.새 연결 만들기를 클릭합니다.
로그인 대화 상자에서 Dynamics 365에 연결할 자격 증명을 지정하고 로그인을 클릭합니다.
Dynamics 365에서 여러 조직에 액세스할 수 있는 경우 연결하도록 선택할 조직 목록이 표시됩니다. 그렇지 않으면 기본 조직이 사용됩니다.
등록된 플러그 인 또는 사용자 지정 워크플로 활동 어셈블리의 축소된 목록이 표시됩니다. 등록>새 어셈블리 등록을 선택합니다.
새 어셈블리 등록 대화 상자에서:
단계 1 섹션에서 줄임표 [...]를 클릭합니다. 버튼을 눌러 CustomPlugin-FS-Geospatial.dll 어셈블리를 선택합니다.
2단계 섹션에서 두 플러그 인을 모두 선택합니다.
3단계 섹션에서 샌드박스 옵션을 선택합니다.
4단계 섹션에서 데이터베이스 옵션을 선택합니다.
선택한 플러그 인 등록을 선택합니다.
CustomPlugin-FS-Geospatial 어셈블리와 msdyn_GeocodeAddress 및 msdyn_RetrieveDistanceMatrix에 대한 두 개의 플러그 인이 이제 등록되고 서버에 배포됩니다.
다음 단계는 각 작업에 대한 단계를 등록하는 것입니다. 단계는 플러그 인이 실행되는 시기와 방법을 구성하는 데 사용되는 SDK 메시지 처리 단계 엔터티를 말합니다.
등록된 플러그 인 & 사용자 지정 워크플로 활동 트리 보기에서 (Assembly) CustomPlugin-FS-Geospatial 노드를 확장하고 등록된 플러그 인 Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix를 선택합니다.
Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix를 마우스 오른쪽 단추로 클릭하고 새 단계 등록을 선택합니다.
새 단계 등록 대화 상자에서 다음 정보를 입력합니다.
- 메시지: msdyn_RetrieveDistanceMatrix
- 실행 순서: 필요에 따라. 이 문서 앞부분의 사용자 지정 플러그 인을 등록하는 동안 실행 순서 고려 사항을 참조하십시오.
- 이벤트 파이프라인 실행 단계: PostOperation
- 실행 모드: 동기
- 나머지 필드는 기본값으로 둡니다. 새 단계 등록 대화 상자를 클릭합니다.
그런 다음, Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress 플러그 인을 마우스 오른쪽 단추로 클릭하고 새 단계 등록을 선택합니다.
새 단계 등록 대화 상자에서 다음 정보를 입력합니다.
- 메시지: msdyn_GeocodeAddress
- 실행 순서: 필요에 따라. 이 항목 앞부분의 사용자 지정 플러그 인을 등록하는 동안 실행 순서 고려 사항을 참조하십시오.
- 이벤트 파이프라인 실행 단계: PostOperation
- 실행 모드: 동기
- 나머지 필드는 기본값으로 둡니다. 새 단계 등록 대화 상자를 클릭합니다.
이제 두 지리 공간 작업에 대한 사용자 지정 플러그 인을 호출하는 단계를 등록하는 작업이 완료되었습니다.
Plugin Registration Tool의 Universal Resource Scheduling 지리 공간 작업을 볼 경우 작업에 대해 등록된 기본 플러그 인과 사용자 지정 플러그 인이 모두 표시됩니다. 예를 들어 mdyn_GeocodeAddress 작업에 대한 플러그 인을 참조하십시오.
