Виджеты для третьей бухгалтерии. [Расширение] Шаблон блоков для информационной панели.

25.02.18

Разработка - Работа с интерфейсом

Расширение конфигурации Бухгалтерия предприятия 3.0 для создания собственных блоков (виджетов) информационной панели.

Скачать исходный код

Наименование Файл Версия Размер
Расширение "Шаблон блоков для информационной панели конфигурации Бухгалтерия предприятия 3.0":
.cfe 77,36Kb
34
.cfe 1.03 77,36Kb 34 Скачать

Что это:

Перед вами расширение конфигурации "1С Бухгалтерия предприятия" редакции 3.0, которое содержит шаблоны пользовательских блоков для информационной панели. Мне больше нравиться называть это "виджеты". С помощью этого расширения вы можете сделать от одного до трех собственных виджетов. Вот как это выглядит:

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

Проект доступен на GitHub. Ставьте звездочки, если расширение пригодилось.

Тестировалось на версии Бухгалтерия предприятия, редакция 3.0 (3.0.58.41) 

Для тех, кто торопится:

Желаете собственный виджет? Выполните следующие 6 шагов:

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

Далее, подробнее.

Встраивание пользовательских виджетов в конфигурацию

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

Отключение виджета

Любой виджет можно отключить, после чего он становиться недоступен в "Настройке информационной панели" и не отображается на самой информационной панели. Воспользуйтесь методом:

ПОЛЬЗX_Доступен()

Расположение: РасширениеКонфигурации - общий модуль БлокиИнформационнойПанели Установите возвращаемое значение метода в Истина если виджет доступен или Ложь если недоступен.

Наименование виджета

Наименование виджета в "Настройке информационной панели" определяется методом:

ТекстЗаголовкаПОЛЬЗX()

Пример, смотри на скриншоте выше. Расположение: РасширениеКонфигурации - общий модуль БлокиИнформационнойПанелиКлиентСервер. Наименование виджета обычно, но не обязательно используется как значение заголовка информационного блока.

Способ обновления данных

Расширение к стандартному способу обновления данных виджетов добавляет альтернативный способ обновления данных.

Стандартный способ обновление данных срабатывает при наступлении событий:

  • запуск конфигурации
  • смена организации на информационной панели
  • нажатие на кнопку "Обновить"
  • по прошествию суток после последнего обновления, если конфигурация не выгружалась

Альтернативный способ обновление данных срабатывает при наступлении событий:

  • все события стандартного способа
  • по тайм-ауту с помощью обработчика ожидания

В расширении тайм-аут установлен равным 15 минутам. Значение можно изменить, установив переменную модуля:

м_чИнтервалОбновления = 900;

Расположение: РасширениеКонфигурации - модуль формы ИнформационнаяПанель. Переключение между способами обновления данных выполняется с помощью переменной модуля:

м_бАльтернативныйСпособОбновления = Ложь;

Расположение: РасширениеКонфигурации - модуль формы ИнформационнаяПанель Если значение Истина то работает альтернативный способ обновления, если Ложь то работает стандартный способ.

Информация виджета

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

  1. Разместить на форме РасширениеКонфигурации - форма ИнформационнаяПанель реквизиты, которые будут программно заполнены данными. Тип реквизита: ФорматированнаяСтрока.
  2. Расставить реквизиты и иные элементы формы в блоке виджета.
Дизайн блока информационной панели
 
  1. Если виджет имеет элементы управления, разместите на форме команды и их обработчик.
  2. Установите наименование виджета в методе ТекстЗаголовкаПОЛЬЗХ(), который располагается РасширениеКонфигурации - общий модуль БлокиИнформационнойПанелиКлиентСервер
  3. Включите доступность виджета с помощью метода ПОЛЬЗХ_Доступен(), который располагается РасширениеКонфигурации - общий модуль БлокиИнформационнойПанели
  4. Опишите свойства вашего виджета в методе СвойстваПОЛЬЗX(), который распологается РасширениеКонфигурации - общий модуль БлокиИнформационнойПанели. Свойства, определенные в этом методе должны соответствовать реквизитам формы из п.п. 1. Пример реализации: 
    Функция СвойстваПОЛЬЗ0()
    	Перем сСвойства;
    	
    	сСвойства = "ПОЛЬЗ0_Заголовок, ПОЛЬЗ0_ДатаКурса,
    	| ПОЛЬЗ0_Валюта1, ПОЛЬЗ0_Валюта2, ПОЛЬЗ0_Валюта3,
    	| ПОЛЬЗ0_Курс1, ПОЛЬЗ0_Курс2, ПОЛЬЗ0_Курс3,";
    	
    	Возврат сСвойства;
    КонецФункции

    Метод должен возвращать строку со свойствами через запятую.

  5. Реализуйте метод ПОЛЬЗХ(Параметры) для заполнения свойств виджета данными. Расположение метода РасширениеКонфигурации - общий модуль БлокиИнформационнойПанели. Полученные данные нужно "упаковать" в структуру, где ключ это имя свойства виджета, которое определено на шаге 6 этого алгоритма. Значение структуры это данные с типом Форматированная строка. Структуру с данными необходимо поместить во временное хранилище, адрес которого передан в параметре метода. Пример реализации: 
    Процедура ПОЛЬЗ2(Параметры) Экспорт	
    	Перем Шрифт, ЦветТекста, стДанныеБлока, фсДанные, фсЗаголовок;
    	
    	Если Параметры.Инициализация Тогда
    		Возврат;
    	КонецЕсли;
    	
    	Шрифт = ШрифтыСтиля.ШрифтТекстаИнформационнойПанели;
    	ЦветТекста = ЦветаСтиля.ЦветТекстаИнформационнойПанели;
    	
    	стДанныеБлока = Новый Структура();
    	фсЗаголовок = ЗаголовокБлока(БлокиИнформационнойПанелиКлиентСервер.ТекстЗаголовкаПОЛЬЗ1());
    	стДанныеБлока.Вставить("ПОЛЬЗ2_Заголовок", фсЗаголовок);
    	фсДанные = Новый ФорматированнаяСтрока("Информация виджета пользователя", Шрифт, ЦветТекста);
    	стДанныеБлока.Вставить("ПОЛЬЗ2_Данные", фсДанные);
    	
    	ПоместитьВоВременноеХранилище(стДанныеБлока, Параметры.АдресХранилища);
    	
    КонецПроцедуры

    Аргумент функции структура с данными: 

    Ключ Комментарий
    АдресХранилища Строка - адрес хранилища результата
    Организация СправочникСсылка.Организации - организация, которая установлена в отборе информационной панели
    ВариантОкругления Число - 1 - округлять до целых рублей, 1000 - до тысяч
    ПоказыватьСравнениеСПрошлымГодом Булево - необходимость сравнения с показателями прошлого года
    Инициализация Истина - заполнить только статическими данными

Итого

Я надеюсь на появление моря полезных, нужных и просто прикольных виджетов. От прогноза погоды и курса Биткоина до списка именинников и музыкального плеера. Дерзайте. Присылайте ссылки на ваши виджеты и я включу их в эту статью.

расширение виджет информационная панель БУХ30 ACC30

См. также

Управление дашбордами

Работа с интерфейсом Программист Платформа 1С v8.3 Конфигурации 1cv8 Платные (руб)

Обработка предназначена для создания и управления дашбордами.

2400 руб.

29.06.2020    17294    23    4    

37

Новогоднее оформление для 1С

Работа с интерфейсом Платформа 1С v8.3 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Зарплата и Управление Персоналом 3.x 1С:Управление нашей фирмой 3.0 Бесплатно (free)

Добавьте новогоднего настроения! Расширение создает декорацию в виде гирлянды на некоторых формах объектов.

27.12.2023    11858    780    elcoan    47    

109

Конструктор HTML, CSS и javascript

Инструментарий разработчика Работа с интерфейсом Программист Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

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

2 стартмани

10.04.2023    10335    157    acces969    31    

120

Модель состояния для MVC

Работа с интерфейсом Программист Платформа 1С v8.3 Конфигурации 1cv8 Абонемент ($m)

"MVC плохо применима в 1С" - познакомьтесь с моделью состояния и, возможно, ваше мнение поменяется! Представленное решение является эволюционным развитием идеи реализации MVC для 1С. В новой версии добавлены DSL для описания модели состояния, а также параметризация свойств параметров и элементов формы.

1 стартмани

05.07.2022    4293    kalyaka    4    

31

Условное оформление элементов форм в пользовательском режиме 1С (управление видимостью и доступностью элементов форм)

Работа с интерфейсом Платформа 1С v8.3 Платные (руб)

Подсистема условного оформления элементов форм (далее подсистема) предназначена для настройки оформления элементов форм (видимость, доступность, цвет фона, цвет текста и прочее) в пользовательском режиме 1С. Также подсистему возможно использовать для ограничения доступа к реквизитам формы для определенных пользователей (или групп пользователей).

6000 руб.

18.01.2022    9170    1    2    

6

Программный интерфейс для доработки форм

Работа с интерфейсом Программист Платформа 1С v8.3 Конфигурации 1cv8 Бесплатно (free)

Реализовал простой способ программного создания новых элементов, команд и реквизитов на форме.

25.11.2021    10184    AtamanovYS    19    

142
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. пользователь 25.02.18 16:04
Сообщение было скрыто модератором.
...
2. 1c-intelligence 12808 06.03.18 07:41 Сейчас в теме
Смотри-ка, +5 за день после публикации.
Не благодарите.
3. infosoft-v 884 06.03.18 09:15 Сейчас в теме
(2) Здорово. Спасибо.
Еще не читал эту статью, но в планах на ближайшие вечера.
4. adapter 418 12.03.18 14:14 Сейчас в теме
Мой вариант "виджетов":
Монитор сводных показателей
https://infostart.ru/public/665135/
Оставьте свое сообщение