MENU
    Пользовательский виджет планирования
    • 14 Mar 2025
    • 4 Минуты для чтения
    • Авторы

    Пользовательский виджет планирования


    Вводный текст

    To download the app, visit: Library

    Назначение

    Пользовательский виджет планирования служит инновационным решением для управления задачами. Виджет "Расписание" предназначен для использования в приложениях Tulip для получения задач или заданий из базы данных, каждое из которых имеет свою уникальную продолжительность.

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

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

    scheduling-printscreen.png

    Настройка

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

    Чтобы установить соединение с системой клиента, виджету требуется следующее:

    • URL-адрес экземпляра клиента
    • Токен аутентификации для доступа вместо учетных данных для входа в систему.
    • Если клиент не использует DEFAULT Workspace, необходимо также указать ID Workspace.

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

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

    Виджет планирования имеет следующие параметры для настройки:

    Обязательные параметры

    Ресурсы: это текстовый список, он может быть получен из таблицы, но в этом случае он управляется как переменная приложения**.Имена столбцов:** идентификаторы полей можно найти на уровне таблицы задач, пожалуйста, добавляйте их по одному.

    Таблицу Task можно найти следующим образом:scheduling-table.png{height="200" width=""}.

    Идентификатор поля можно найти следующим образом:tablefield-unique-name.png

    • ID задачи
    • Имя задачи
    • Имя столбца состояния
    • Имя начального столбца
    • Название столбца Конец
    • Имя столбца Продолжительность
    • Название столбца "Ресурс

    Основной токен Auth: нажмите на свой профиль в правом верхнем углу, выберите настройки аккаунта, нажмите на API-токены на левой панели и следуйте инструкциям, чтобы получить этот токен**.URL аккаунта:** например: your-account.tulip.coTaskTable ID: ID таблицы можно найти на уровне таблицыtableID.png{height="200" width=""}.

    Дата планирования: на какой день вы хотите запланировать работу? Это поле времени даты.

    Необязательные параметры

    Начало дня: начало временной шкалы. Значение по умолчанию - 06:00Конец дня**:** конец временной шкалы. Значение по умолчанию - 21:00Единица измерения временив течение часа: значение по умолчанию - 10 (в минутах), это означает, что при перемещении задачи по временной шкале вы можете выбрать, например, 07:10 или 07:20....., каждый шаг - 10 минут. Если изменить на 30, то можно выбрать 07:00, 07:30..... каждый шаг по 30 минутUnitwidth: ширина одного шага в px, с помощью этого параметра можно настроить ширину виджета. Значение по умолчанию - 13Ширина имени ресурса: Ширина колонки ресурса в px. Значение по умолчанию 220Overlap**:** виджет поддерживает перекрытие задач. Значение по умолчанию false**.Infobox:** это всплывающее окно для просмотра названия задачи, если она обрезана. Значение по умолчанию falseСтатусы**(эта опция доступна, если активирован инфоблок):** Виджет планирования работает с двумя фиксированными статусами: "Запланировано" и "Незапланировано". Кроме того, он предоставляет возможность определять дополнительные статусы, такие как "Завершено" или "Отменено". Для пользовательских статусов можно задать цвет, а также установить поведение по умолчанию (ShowByDefault). На основе параметра ShowByDefault виджет автоматически скрывает задачи, если ShowByDefault - "нет", или отображает их в случае "да".

    Пользовательские статусы можно найти в инфобоксе.image.png

    Выделение текущего таймслота: Отображение вертикальной линии, указывающей на прогресс в реальном времени и показывающей наше текущее положение на временной шкале. Значение по умолчанию - false.

    Триггеры

    В виджете планирования доступны следующие события:

    Задача запланирована: задача попала на временную шкалуЗадачавнеплановая: задача удалена с временной шкалыЗадача перемещена: задача только чтоперепланированаОбновление статуса задачи**:** в случае использования пользовательских статусовЗадачавыбрана: щелкнули на запланированной задаче

    image.png

    Все триггеры имеют следующие результаты, кроме "Задача выбрана" и "Обновление статуса задачи":

    scheduling-widget-results.png{height="200" width=""}.

    Результатом "Задача выбрана" является ID задачи. Его можно использовать, например, для загрузки записи.

    Как это работает

    Задачи извлекаются с помощью API-вызова из таблицы задач в базе данных, а ресурсы - из параметров виджета. Задачи отображаются слева, а ресурсы - вертикально в правой части виджета планирования. У каждого ресурса есть ежедневный график, на котором можно размещать задачи. Когда задача привязывается к ресурсу, она получает время начала и окончания запланированного дня и будет видна на временной шкале виджета планирования только в этот день.Виджет планирования взаимодействует с таблицей задач CDM в базе данных для записи новых расписаний, перемещения задач во времени или между ресурсами, а также удаления задач с временной шкалы ресурса двойным щелчком (переводя их во внеплановое состояние). Эти фоновые процессы работают с помощью встроенной функции fireEvent. Дополнительную информацию о функции fireEvent можно найти ЗДЕСЬ{target=_blank}.Дополнительные возможности:

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

    Как создать API-токен

    Здесь{target=_blank} вы можете найти подробную информацию о создании API-токена.

    Дальнейшее чтение

    Если вы хотите узнать больше о пользовательских виджетах, посетите сайт ниже:Custom Widgets Overview{target=_blank}


    Была ли эта статья полезной?