Каталог решений - Добавление собственного виджета в 1С:Документооборот версии 3.0

Не так давно мне досталась задачка по созданию собственных виджетов по отслеживанию невыполненных задач в виде кольцевой диаграммы и показателей в Документообороте 3.0. Поиск в интернете особо ничего выдал, только статью на ИТС и на Инфостарте, как это делается в Документообороте 2.1. Начал смотреть и разбираться, оказалось, что отличий очень много, поэтому и родилась идея написать данную статью, так как ДО 3.0 сейчас активно внедряется, а информации по ней мало. Итак, приступим.

Для начала опишу шаги, которые нам необходимо будет пройти, чтобы наш виджет заработал. Сперва нужно сделать некоторые манипуляции в 1С предприятии.

1. Создать сам виджет.
2. Создать групповой показатель. Он нужен для того, чтобы на самом виджете отображалось количество задач по нашим показателям.
3. Создать и настроить показатели виджета
4. Настроить сам виджет.

Далее переходим в конфигуратор и начинаем программировать работу виджета и показателей.

5. Пишем функцию, которая будет обрабатывать и выводить количество задач для наших показателей на самом виджете
6. Создаем команды для перехода, кликая по показателю на форму Задачи мне, но с нашими отборами, которые соответствуют названию показателя.
7. Дописываем типовые процедуры и функции, где указываем, как формировать наши группировки задач, а если точнее, то отборы для динамического списка.

По итогу мы получим виджет, в котором будет оперативно меняться количество задач и возможность перейти, кликая по показателю на форму задачи с нашим отбором, который будет заложен в коде соответствующего показателя.

План нарисовали, можно приступать.

Еще немаловажный момент. Делалось все через расширение, так как заказчик попросил конфу не менять.

1. Создаем сам виджет

Делается это достаточно легко, открываем функции для технического специалиста и вбиваем поиск "Виджеты". Находится один справочник в него и переходим.

Нам открывается справочник, в котором есть только предопределенные значения. Особой необходимости как в ДО 2.1 делать предопределенным новый виджет нет, поэтому берем тот, что более-менее похож на наш, к примеру, "Задачи мне (диаграмма, по видам)" и копируем его. На текущем этапе достаточно только обозвать его так, как нам нужно. В моем случае это будет выглядеть вот так:

В итоге получаем виджет с нашим наименованием, но по сути это будет копия того, что мы сделали и если его вывести, то он ничем отличаться не будет.

2. Создаем групповой показатель

Групповой показатель, как писал ранее, нужен для вывода информации о количестве задач, которые будут по нашим показателям на виджете. По этому также открываем функции для технического специалиста и вбиваем поиск "Групповые Показатели". Нам открывается аналогичный Виджетам справочник, в котором есть опять же только предопределенные значения. Копируем аналогичный виджету групповой показатель, а именно "Итоги "Задачи мне" (по видам)", и начинаем его настраивать.

Пробежимся по реквизитам:

1. В первую очередь наименование так как оно должно быть уникальным.
2. Далее выражение. Это как раз та функция, которую нам придется в дальнейшем закодировать, чтобы по указанным свойствам, которые указаны ниже, передавать количество задач. В моем случае я ее назвал "ЗадачиМнеИтогиПоДокументам"
3. Вкладка Свойства. На этой вкладке мы укажем ключи для наших показателей. Соответственно старые я удалил и вбил свои.
4. Вкладку события не трогаем, там перечислены события, по которым данная функция будет дергаться для обновления показателей.

Записываем и закрываем, больше нам тут делать нечего. Идем дальше.

3. Создание и настройка показателей виджетов

Уже ставшим привычным действием открываем функции для технического специалиста и вбиваем поиск "Показатели виджетов". Открываем справочник, видим снова предопределенные значения и копируем, к примеру, виджет "Задачи мне: На рассмотрение", так как он у нас был в нашем первоначальном виджете, с которого мы копировали, ну и в групповом виджете он тоже участвовал.

Меняем значение реквизитов:

1. Наименование в моем случае "Задачи мне: Договоры"
2. Заголовок "Договоры". Так будет выглядеть наименование на самом виджете
3. Подсказку по желанию
4. Немаловажный реквизит — картинка. Без нее будет плохо, поверьте мне. Я потратил кучу времени на то, чтобы понять, почему из показателя получается абракадабра. Выбираем любой цвет из ЛегендаДиаграммы. Я выбрал такое значение "ЛегендаДиаграммыСиний".
5. Цвет виджета серии по аналогии с картинкой берем "Синий"
6. Далее у нас уже стоит Тип "Групповой"
7. Групповой показатель выбираем тот, который создали ранее: "Итоги "Задачи мне" по документам"
8. Свойство группового показателя — выбираем тот, который мы закладывали заранее для этого показателя "ЗадачиМнеДоговоры"
9. Тип Значения уже стоит "Число", поэтому не трогаем.
10. В разделе Действие пока ничего не трогаем, так как без Источника виджет будет ломаться, а команды для перехода мы сделаем только сильно позже.
11. События оповещения нам не нужны.

Если все правильно сделали, то выглядеть будет вот так:

Записываем, закрываем и повторяем процедуру еще 3 раза, только указываем для каждого показателя свои значения.

Теперь настало время для настройки самого виджета.

4. Настройка виджета

Для того, чтобы нам удалось настроить виджет, необходима какая-нибудь обработка, которая позволит увидеть больше, чем то, что показывает нам сам документооборот. Я воспользовался 1С Admin. После открытия через данную обработку нашего виджета мы увидим, что у нас, оказывается, есть еще куча табличных частей, которые нам постеснялись показать.

Скрываем пустые ТЧ, удаляем все значения в ТЧ "Дополнительные показатели", "Основные показатели" и "Команды".

Добавляем в ТЧ "Основные показатели" наши показатели в том порядке, в каком вы хотите их видеть на виджете.

Записываем и закрываем. На текущем этапе в клиенте с работами пока все. Переходим в конфигуратор.

5. Функция для вывода значений показателей виджета на сам виджет.

Ранее в групповом показателе мы придумывали некую функцию. Так вот настало время ее создать. Идем в конфигурацию > Общиемодули > РаботаСЗадачиами

Для упрощения написания можно скопировать аналогичную функцию, к примеру, ту, что у нас была прописана в групповом показателе, с которого мы копировались. "ЗадачиМнеИтогиПоВидам"

Код этой функции: