Зареєструйте плагін для розгортання локально

Компоненти plug-in і настроювані дії робочого процесу – це настроюваний код, який ви розробляєте для розширення наявних функцій Dynamics 365 Customer Engagement (локально). Перш ніж використовувати плагін або настроюваний робочий процес, його потрібно зареєструвати на сервері. Плагін і спеціальний інструмент реєстрації активності робочого процесу доступні для завантаження.

Загальну інформацію про плагіни та реєстрацію збірки користувацького робочого процесу можна знайти в розділах Dataverse Реєстрація плагіна та Реєстрація вашої збірки. Наведена нижче інформація стосується розробки локальних плагінів.

Хоча цей розділ зосереджено переважно на плагінах, більшість інформації також стосується користувацьких робочих процесів. Одна з відмінностей між ними полягає в тому, що для збірок активності користувацького робочого процесу ви реєструєте лише збірку. Для плагінів потрібно реєструвати вузол плагіна та один або кілька кроків для кожного плагіна. Для отримання додаткових відомостей про настроювані дії робочого процесу перегляньте статтю Настроювані дії робочого процесу (збірки робочих процесів).

Важливо

Не реєструйте будь-які дії плагінів або настроюваних робочих процесів, якщо їх не отримано з надійного та надійного джерела.

Вбудоване сховище

 

Для локального розгортання плагіни, не зареєстровані в ізольованому програмному середовищі, можуть зберігатися в базі даних сервера Dynamics 365 або файловій системі на диску . Настійно рекомендується зберігати готові до виробництва компоненти plug-in у базі даних Dynamics 365 Customer Engagement (on-premises), а не на диску. Компоненти plug-in, що зберігаються в базі даних, автоматично розподіляються між кількома серверами Dynamics 365 у кластері центру обробки даних. Зберігання плагінів на диску корисне для налагодження плагінів за допомогою Visual Studio. Однак можна налагодити плагін, який зберігається в базі даних. Щоб отримати додаткові відомості, перегляньте статтю Налагодження плагіна.

Компоненти plug-in, зареєстровані в ізольованому програмному середовищі, мають зберігатися в базі даних незалежно від розгортання Dynamics 365 Customer Engagement (локально) (локально, IFD або онлайн).

Розгортання

 

Для локальних інсталяцій Dynamics 365 Customer Engagement (локальне розгортання) або орієнтованих на Інтернет (IFD) під час розгортання плагінів з іншого комп'ютера на диск сервера Dynamics 365 (розгортання на диску) збірку плагінів потрібно скопіювати на сервер вручну перед реєстрацією. Збірка повинна бути розгорнута в папці <installdir>\Program Files\Microsoft CRM\server\bin\assembly на кожному сервері, де має виконуватися плагін.

Реєстрацію плагіна слід виконувати після того, як збірка була скопійована в папку ...\bin\assembly на сервері, щоб запобігти ситуації, коли користувач системи викликає подію в Dynamics 365 Customer Engagement (on-premises), але зареєстрована збірка плагіна ще не існує на сервері. Для розгортання бази даних сервера збірка плагіна автоматично копіюється під час реєстрації плагіна, щоб попередня ситуація не була проблемою.

Залежно від конструкції плагіна, для його роботи можуть знадобитися інші збірки, на які посилаються. Незалежно від того, чи розгортаєте ви плагін на базі даних або диску, якщо для запуску плагіна потрібні інші збірки, ви повинні розміщувати копії цих збірок у глобальному кеші збірки на кожному сервері, де має виконуватися плагін.

Переміщення модуля з середовища розробки на проміжний або робочий сервер

1. На комп'ютері для розробки створіть код плагіна. Не додавайте налагоджувальну інформацію. Оптимізуйте плагін для продуктивності.
2. Зареєструйте плагін у базі даних Dynamics 365 Server.
3. Використовуючи веб-програму Dynamics 365 Customer Engagement (локально), створіть рішення або скористайтеся наявним і додайте до нього плагін.
4. Після того, як ви додали будь-які інші бажані компоненти до розчину, експортуйте розчин.
5. Імпортуйте рішення на стейджинговий або робочий сервер.

Обмеження безпеки

Існує обмеження безпеки, яке дозволяє реєструвати плагіни лише привілейованим користувачам. Для плагінів, не зареєстрованих в ізольованому середовищі (ізоляція), обліковий запис користувача системи, під яким реєструється плагін, має існувати в групі «Адміністратори розгортання » диспетчера розгортання. Лише обліковий запис користувача системного адміністратора або будь-який обліковий запис користувача, що входить до групи адміністраторів розгортання , може запускати Диспетчер розгортання.

Важливо

Для неізольованих плагінів невключення облікового запису зареєстрованого користувача до групи адміністраторів розгортання призводить до створення винятку під час реєстрації плагіна. В описі винятку зазначено: «Недостатньо привілеїв для завершення операції створення для сутності SDK».

Для плагінів, зареєстрованих в ізольованому середовищі (режим ізоляції), обліковий запис користувача системи, під яким реєструється плагін, повинен мати роль системного адміністратора. Членство в групі адміністраторів розгортання не потрібне.

Статті за темою

Розробка плагінів
Налагодження плагіна
Пакетування та розповсюдження розширень за допомогою рішень Dynamics 365 Customer Engagement (on-premises)