Виджет временной шкалы

Назначение

Виджет Timeline - это интерактивный виджет, который отображает зарегистрированные события из таблицы Tulip. Он показывает самую последнюю запись сверху, позволяя вам всегда быть в курсе событий.

Настройка

Необходимые поля:- ID агрегации (агрегация таблицы Tulip)- API-ключ (текст)- Секрет (текст)- URL аккаунта (текст)

Необязательное поле:- Белый текст (да/нет) - Установите "да", чтобы изменить цвет шрифта на белый. По умолчанию действует значение "нет".

Чтобы настроить этот виджет, вам нужно предоставить API-ключ, секрет и URL (который выглядит как your-account.tulip.co). Если вы не знаете, что такое API-ключ, обратитесь к следующему разделу. Кроме того, вы можете настроить виджет в редакторе приложений (до запуска приложения), введя информацию непосредственно в свойства виджета. После того как вы предоставили необходимую информацию, обновите виджет. В этот момент, если у вас есть события в таблице, они должны отображаться в виджете.Виджет использует агрегацию. Благодаря агрегации виджет наполняется информацией о событиях. Без этой агрегации виджет нужно было бы обновлять после каждой вставки в таблицу, чтобы поддерживать ее в актуальном состоянии.

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

Чтобы получить доступ к таблице событий, у вас должен быть API-токен с правами tables: read. Убедитесь, что он у вас есть, перейдя в раздел настроек вашего экземпляра, а затем в раздел "API-токены". Если настроено рабочее пространство, он может находиться в разделе "Настройки рабочего пространства". Если у вас уже есть токен, он будет указан в этом разделе. Нажмите "Редактировать" и убедитесь, что в разделе "Области действия" отмечен пункт "Таблицы: чтение". Если он установлен, все готово; если нет, либо настройте области, либо создайте новый токен. Если токенов нет, создайте один, нажав кнопку "Создать API-токен". Присвойте ему любое имя по своему усмотрению, а затем выберите области действия, убедившись, что установлен флажок tables: read, и любые другие области действия по вашему усмотрению. Предпочтительно назначить наименьшее количество необходимых привилегий, хотя, если вы не уверены, можете отметить все опции.После нажатия кнопки "Создать" появится окно, в котором вам будет предложено сохранить секретный ключ. Придерживайтесь этого правила, потому что если вы потеряете его и вам понадобится восстановить секрет, все места, где использовался предыдущий секрет, нужно будет обновить до нового.

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

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

Таблица называется Timeline events и имеет следующие столбцы:- ID (текст) - уникальный идентификатор события, должен создаваться автоматически, не предназначен для отображения, но необходим- Title (текст) - название события, оно должно быть кратким, так как отображается крупнее- Description (текст) - если название недостаточно описательно, можно добавить больше деталей, которые отображаются под названием- Type (текст) - может быть одним из следующих или оставаться пустым: success, error, warning, message, andon, pause, start, stop, msteams - есть также значок по умолчанию, если тип не указан или не является ни одним из перечисленных ранее - они обрабатываются в виджете без учета регистра- Date Created (метаданные, скрытые) - каждая запись в таблице Tulip имеет метаданные (Date created и Date updated), которые не могут быть изменены, но могут быть использованы в запросах