Разработка форм в Microsoft Dynamics 365 (на примере SimpleList)

Разработка форм — одна из задач, с которой может столкнуться разработчик Microsoft Dynamics 365. С этой задачей ему могут помочь шаблоны форм, которые значительно облегчают разработку.

В предыдущей статье Шаблоны форм в Microsoft Dynamics 365 были рассмотрены шаблоны форм в Microsoft Dynamics 365, их особенности и отличия от стилей форм Microsoft Dynamics AX 2012. В данной же статье будет рассмотрено создание формы на основе шаблона SimpleList в среде разработки Visual Studio 2015.

Постановка задачи

В новом модуле, отвечающем за статьи, ранее была создана таблица, состоящая из трёх полей и хранящая информацию о группах статей. Сейчас необходимо создать форму, которая позволяет пользователям просматривать и редактировать данные этой таблицы.

Анализ задачи

Самым важным этапом в решении данной задачи будет выбор шаблона формы. К выбору шаблона стоит отнестись очень серьёзно.

Проведя анализ задачи, можно сделать следующие выводы:

  • Таблица содержит малое количество полей
  • Таблица не имеет каких-либо связей
  • Необходимо вывести на форму только таблицу

Основываясь на предыдущей статье и вышеперечисленных выводах, для решения данной задачи выберем шаблон SimpleList и перейдем к разработке.

Разработка формы

Шаг 1. Создание новой формы

Для создания новой формы необходимо открыть контекстное меню проекта, располагающегося в обозревателе решений (если он отсутствует, необходимо открыть Solution Explorer (Обозреватель решений) во вкладке View (Вид) на панели инструментов). В открывшемся контекстном меню выбрать пункт «Добавить», затем — «Новый элемент». Так же новый элемент можно создать по нажатию комбинации горячих клавиш «Ctrl+Shift+A»
New Item
После перехода по пункту меню, откроется форма добавления элементов. В списке слева выбираем User Interface (Пользовательский интерфейс), и в отобразившейся в средней части окна выбираем форму. Обязательно нужно указать значимое название для формы (его можно будет изменить в любое время).
Add New Item Form

Шаг 2. Применение шаблона

Следующим важным шагом в создании формы будет применение шаблона. Для этого в дизайнере нашей формы необходимо открыть контекстное меню дизайна формы. В меню выбрать Apply Pattern (Применить шаблон) и нажать на необходимый шаблон, в нашем случае это Simple List
Apply Form Pattern
После применения шаблона на вкладке Pattern (Шаблон) предпросмотра формы отобразится структура шаблона. Как видно на рисунке, в структуре помечены отсутствующие элементы формы, которые необходимо добавить. Элемент Footer помечен белым цветом, хотя и отсутствует на форме, так как является необязательным.
Form Model

Шаг 3. Добавление элементов

Добавим на форму первый необходимый элемент — ActionPane. На этот элемент не нужно добавлять кнопки, такие как редактировать, создать или удалить запись, так как они добавляются автоматически с помощью встроенной платформы.
Design With Action Pane
Как видно из рисунка, в структуре шаблона наш элемент стал белым, это означает, что он добавлен на форму.
Add Action Pane
Добавим остальные необходимые элементы. А также добавим в источник данных таблицу, которая была создана ранее, и установим его в качестве источника данных сетки. Помимо этого, необходимо добавить поля на сетку. Это можно сделать путем ручного добавления полей, или установить в свойстве DataGroup сетки нужную нам группу полей.
Add All Elements

Шаг 4. Применение подшаблонов

На форму были добавлены все элементы, указанные в структуре. Попробуем запустить сборку проекта.
BP Error
Так как шаблоны стали обязательными, компилятор выдает ошибку, что у элемента Группа отсутствует шаблон.
SubPattern
Чтобы узнать количество элементов, которые требуют применения шаблона, можно воспользоваться функционалом, который располагается в контекстном меню формы Addins>Form Statistics.
Form Statistics
Для применения подшаблона также выбираем применить шаблон в меню элемента. Стоит отметь, что в списке будет только тот подшаблон, который предусмотрен шаблоном формы. Это очень сильно облегчает разработку, так как не нужно искать среди огромного количества необходимый шаблон.
Apply SubPattern

Шаг 5. Проверка формы на соответствие Best Practise

Перед запуском формы необходимо проверить ее на соответствие Best Practise. Для этого в контекстном меню формы выбираем пункт «Run Best Practices Fixers»

Основные правила Best Practise для форм:

  • Свойства формы и её элементов должны быть установлены как Auto или Default
  • Для формы должно быть указано свойство Caption
  • К форме и ее элементам должен быть применен шаблон
  • Для формы и содержащейся в ней сетке необходимо определить источник данных
  • На форму должен ссылаться хотя бы один MenuItem
  • Сетка не должна содержать больше 15 полей

Шаг 6. Последние штрихи

После устранения ошибок и предупреждений преходим к заключительной стадии. Для того чтобы запустить нашу форму создадим DisplayMenuItem и укажем в качестве объекта нашу форму. Так же для того, чтобы наша формы была доступна для пользователя, создадим расширение меню MainMenu и добавим туда наш MenuItem. Помимо этого, нам нужно добавить наш MenuItem в новую или уже существующую привилегию, но это уже рассмотрим в другой статье.

Результат

Для того, чтобы посмотреть готовую форму можно запустить её прямо из Visual Studio. Для этого назначим MenuItem как стартовый объект и запустим. Форму также можно посмотреть в браузере, перейдя к необходимому пункту меню. В нашем случае «Главное меню»>»Статьи»>»Группы статей».
Разработка форм. Form

Примечания

См. также

Comments

So empty here ... leave a comment!

Добавить комментарий

Sidebar