В режиме Код можно создать дашборд с рабочими показателями, которые руководитель отслеживает регулярно. Например, собрать статистику по активным и просроченным задачам, добавить фильтры и переходы к исходным задачам.

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

Определить показатели дашборда

Сначала определите, какой рабочий вопрос должен решать дашборд. От этого зависит, какие показатели и данные использовать, за какой период их считать и какие фильтры добавить.

Например, руководителю отдела нужно быстро понять, какие задачи требуют внимания. На таком дашборде можно показать:

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

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

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

Сформулировать запрос и создать первую версию

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

Пример запроса:

Создай дашборд по задачам отдела: покажи активные и просроченные задачи, ближайшие сроки и распределение задач по ответственным. Дашборд нужен руководителю отдела.

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

Покажи время последнего успешного обновления. Если подходящих задач нет, покажи сообщение «Нет данных». Если данные не удалось загрузить, покажи сообщение об ошибке.

Сначала создай первую версию на тестовых данных. Реальные данные Битрикс24 пока не подключай.

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

На первой версии проверьте структуру дашборда. Например:

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

Если первая версия требует доработки, продолжайте работу в том же сеансе и описывайте изменения отдельными запросами. Например: В карточке просроченных задач сейчас учитываются закрытые. Исключи их из расчета. Остальные показатели не меняй.

Проверить показатели

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

Для каждого показателя проверьте:

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

Если значения не совпадают, укажите конкретное расхождение и ожидаемый результат. Например:

В тестовых данных две просроченные активные задачи, а дашборд показывает три. Проверь правило расчета показателя «Просроченные задачи». Закрытые задачи не должны учитываться. Остальные показатели не меняй.

Подключить данные Битрикс24 и настроить дашборд

Когда расчеты на тестовых данных работают правильно, попросите агента подключить реальные данные Битрикс24. Если понадобятся дополнительные права или действия, агент сообщит об этом. После подключения снова сверьте несколько показателей с исходными задачами.

Затем настройте дашборд под рабочий сценарий. Например:

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

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

Проверить и опубликовать дашборд

Перед публикацией пройдите основной сценарий целиком:

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

После проверки выполните деплой — приложение получит постоянный адрес, по которому его можно открывать вне сеанса режима Код. После публикации проверьте приложение повторно.
Как создать и опубликовать приложение для Битрикс24 в режиме Код

Что делать, если данные не совпадают

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

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

Показатели устарели. Проверьте время последнего успешного обновления и сообщения об ошибках.

Пользователи видят разные значения. Сравните их права доступа, фильтры, период и часовой пояс.

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