--- title: "Настройка пользовательского виджета" slug: "job-planningscheduling-board" updated: 2026-10-22T17:16:24Z published: 2026-10-22T17:16:24Z canonical: "support.tulip.co/job-planningscheduling-board" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Настройка пользовательского виджета To download the app, visit: [widget](https://library.tulip.co/apps/scheduling-custom-Library ## Назначение Пользовательский виджет планирования служит инновационным решением для управления задачами. Этот виджет планирования предназначен для использования внутри приложений Tulip с целью извлечения задач или работ из базы данных, каждая из которых имеет свою уникальную продолжительность. Задачи отображаются в вертикальном списке в левой части виджета. Перетаскивая задачи на один из ресурсов, расположенных в правой части виджета «Планирование», можно распределить задачи или рабочие задания по временной шкале. Такое распределение связывает задачу или рабочее задание с конкретным ресурсом, указывая, когда ресурс приступит к его выполнению. По сути, этот настраиваемый виджет оптимизирует процесс распределения задач, облегчая визуальную связь между задачами и ресурсами с помощью интуитивно понятной функции перетаскивания, тем самым обеспечивая эффективное управление и планирование в интерфейсе Tulip. ![scheduling-printscreen.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-printscreen.png) ## Настройка При настройке виджета некоторые параметры являются обязательными, а другие — опциональными и имеют значения по умолчанию. Для установления соединения с системой клиента виджету требуется следующее: - URL экземпляра клиента - Токен аутентификации для доступа вместо учетных данных - Если клиент не использует рабочую область DEFAULT, необходимо также указать идентификатор рабочей области. После успешной аутентификации виджет «Планирование» должен получить доступ к ресурсам, которые извлекаются из списка. Ресурсы могут быть получены из переменных или с помощью запроса к таблице. Задачи для виджета «Планирование» извлекаются из таблицы Tulip на основе идентификатора таблицы и её полей. Поскольку эти параметры настраиваются, виджет «Планирование» обеспечивает дополнительную гибкость в случае использования другой таблицы. Виджет «Планирование» имеет следующие параметры, которые необходимо настроить: ### Обязательные параметры **Ресурсы:** это текстовый список, который может быть получен из таблицы, но в данном случае он управляется как переменная приложения.**Имена столбцов:** идентификаторы полей можно найти на уровне таблицы «Задачи»; пожалуйста, добавляйте их по одному. Таблицу «Задачи» можно найти следующим образом:![scheduling-table.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-table%281%29.png) Идентификатор поля можно найти следующим образом:![tablefield-unique-name.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tablefield-unique-name.png) - *Идентификатор задачи* - *Название задачи* - *Название столбца «Статус»* - *Название столбца «Начало»* - *Название столбца «Окончание»* - *Название столбца «Продолжительность»* - *Название столбца «Ресурс»* **Токен базовой аутентификации:** нажмите на свой профиль в правом верхнем углу, выберите «Настройки учетной записи», нажмите на Tulip API на левой панели и следуйте инструкциям для создания служебной учетной записи.**URL учетной записи:** например: your-account.tulip.**co Идентификатор таблицы задач:** идентификатор таблицы можно найти на уровне таблицы![tableID.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tableID.png) **Дата планирования:** на какой день вы хотите запланировать задачу? Это поле типа «дата и время». ### Дополнительные параметры **Начало дня:** начало временной шкалы. Значение по умолчанию — 06:**00. Конец дня:** конец временной шкалы. Значение по умолчанию — 21:**00 Единица времени в пределах часа:** значение по умолчанию — 10 (в минутах); это означает, что при перемещении задачи по временной шкале вы можете выбрать, например, 07:10 или 07:20... каждый шаг составляет 10 минут. Если изменить это значение на 30, то можно выбрать 07:00, 07:30... каждый шаг составляет 30**минут**.**Ширина шага:** ширина одного шага в пикселях; с помощью этого параметра можно настроить ширину виджета. Значение по умолчанию — 13. Ширина названия ресурса: ширина столбца «Ресурс» в пикселях. Значение по умолчанию —**220. Перекрытие:** виджет поддерживает перекрытие задач. Значение по умолчанию — false.**Инфобокс:** это всплывающее окно, в котором отображается название задачи, если оно обрезано. Значение по умолчанию —**false. Статусы (эта опция доступна, если включена функция «Инфобокс»):** Виджет «Планирование» работает с двумя фиксированными статусами: «Запланировано» и «Не запланировано». Кроме того, он предоставляет возможность определять дополнительные статусы, такие как «Завершено» или «Отменено». Для пользовательских статусов можно указать цвет, а также настроить поведение по умолчанию (ShowByDefault). В зависимости от параметра ShowByDefault виджет автоматически скрывает задачи, если ShowByDefault установлено в «no», или отображает задачи, если установлено в «yes». Пользовательские статусы можно найти в информационном блоке.![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28871%29.png) **Выделение текущего временного интервала:** отображение вертикальной линии, указывающей ход выполнения в реальном времени и показывающей наше текущее положение на временной шкале. Значение по умолчанию — false. ## Триггеры В виджете «Планирование» доступны следующие события: **Задача запланирована:** задача добавлена на**временную шкалу;** **Задача****отмена:** задача удалена с временной шкалы **; Задача перемещена:** задача только что**перепланирована; Обновление статуса задачи:** в случае использования пользовательских**статусов; Задача выбрана:** нажатие на запланированную задачу ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28870%29.png) Каждый триггер приводит к следующим результатам, за исключением «Задача выбрана» и «Обновление статуса задачи»: ![scheduling-widget-results.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-widget-results.png) Результатом триггера «Задача выбрана» является ID задачи. Его можно использовать, например, для загрузки записи. ## Как это работает Он извлекает задачи посредством вызова API из таблицы задач в базе данных, в то время как ресурсы получаются из параметров виджета. Задачи отображаются в левой части, а ресурсы перечисляются вертикально в правой части виджета «Планирование». Каждый ресурс имеет суточную временную шкалу, на которую можно размещать задачи. Ранее назначенные задачи автоматически появляются на временной шкале при перезагрузке виджета. Когда задача привязана к ресурсу, ей присваиваются время начала и окончания для запланированного дня, и она будет видна на временной шкале виджета «Планирование» только в этот конкретный день.Виджет «Планирование» взаимодействует с таблицей задач CDM в базе данных для записи новых расписаний, перемещений задач во времени или между ресурсами, а также удаления задач с временной шкалы ресурса двойным щелчком (переводя их в незапланированное состояние). Эти фоновые процессы работают с использованием встроенной функции fireEvent. Дополнительную информацию о функции fireEvent можно найти [ЗДЕСЬ](https://support.tulip.co/docs/custom-widgets-overview#fire-an-event){`target=_blank`}. Дополнительные возможности: - Поддержка перекрытия задач путём установки параметра «Overlap» в значение true, что полезно для обработки параллельных задач на одном и том же ресурсе. - Активация информационного окна путем установки параметра «Infobox» в значение «true», что при нажатии отображает небольшое окно с полным названием задачи, так как иногда название может не поместиться на временной шкале. ## Как создать служебную учетную запись Feature rename Prior to r383, Service Accounts were called "API Tokens". [Здесь](https://support.tulip.co/r230/docs/setting-up-a-tulip-api#adding-an-api){`target=_blank`} вы можете найти подробную информацию о создании служебной учетной записи. ## Дополнительная информация Если вы хотите узнать больше о custom widgets, посетите сайт по ссылке ниже:[ОбзорCustom Widgets](https://support.tulip.co/docs/custom-widgets-overview) {`target=_blank`}