Запуск скрипта из дашборда

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

Данный функционал позволяет, например:

• Добавить, удалить или обновить строки таблицы
• Совершить действие в другой системе:
  • Создать задачу
  • Повысить приоритет задачи
  • Отправить сообщение

Настройка скрипта

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

1. Создайте новый скрипт в Панели данных пространства.
2. Первым блоком (триггером) обязательно должен быть Ручной запуск. Для запуска действия можно использовать скрипт только с этим триггером.
3. Настройте ожидаемые поля, они будут заполняться пользователем или автоматически во время запуска действия из виджета. В параметрах блока:
   • Укажите название поля
   • Выберите тип данных (текст, число, дата или дата и время)
   • Если будет приниматься ряд данных, поставьте галочку рядом с полем Массив
   • Можно сделать поле обязательным для заполнения переключателем Обязательное поле
   Действие в дашборде не выполнится, если указанный тип данных ожидаемого поля не совпадет с фактическим типом данных.
4. При нажатии Продолжить открывается модальное окно с созданными полями. Заполните их и нажмите Выполнить. Блок протестируется и в левой панели отобразятся дата и время выполнения, а также введенные в полях значения.
5. Добавьте блок, например, для удаления или обновления строки таблицы.
6. Выберите таблицу, в которую будут вноситься изменения, и с помощью маппинга соотнесите поля.
7. Протестируйте блок и опубликуйте скрипт.

Настройка действия

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

После нажатия появляются параметры для настройки действия.

Параметры настройки действия

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

В поле Активация кнопки можно добавить условие, при выполнении которого кнопка в режиме просмотра становится доступной для нажатия. Указать условие для активации можно по формуле или по переменной. При выборе активации по переменной, доступны только переменные типа Статический список. Если установленное в условии значение не соответствует текущему значению переменной, то в режиме просмотра кнопка запуска действия не активна.

Дополнительно можно выбрать тип кнопки: основная, второстепенная или ссылка. Также можно настроить базовый цвет фона и текста.

Настройте параметры действия:

• Название
• Описание
• Способ ввода

Настройка способа ввода

Из колонки

В параметр скрипта будет передаваться значение из таблицы, выбранное в списке.

Из переменной

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

Из модели данных

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

Список таблиц — это основной параметр, а Список колонок — зависимый. Чтобы использовать в способе ввода Список колонок, сначала необходимо настроить параметр, для которого будет использоваться Список таблиц.

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

В режиме просмотра поле параметра, для которого используется Список колонок, становится активным после выбора таблицы в основном параметре.

Задать формулой

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

Задать агрегацией

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

Ввести вручную

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

Статический список

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

Динамический список

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

• Отображаемый список
• Значение по умолчанию
• Фильтр по строкам
• Предустановленные фильтры (кнопка + Фильтр)
• Переключатели:
  • Скрыть параметр — параметр не будет отображаться в окне запуска действия
  • Ввод любых значений — в режиме просмотра в параметр можно вводить и отправлять одно значение, которого нет в динамическом списке. Если ожидаемое поле в скрипте — массив, то переключатель скрыт
  • Учитывать фильтры — в параметр передаются данные с учетом фильтров, назначенных в режиме просмотра

Запуск действия

После настройки действия над таблицей появляется кнопка. Она становится активной в режиме просмотра.

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

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

Откроется окно запуска скрипта. Заполните обязательные поля и другие, если необходимо. Чтобы запустить скрипт, нажмите Выполнить или Enter. Для отмены нажмите иконку крестика в правом верхнем углу окна.

Действие невозможно запустить, когда:

• Используемый скрипт удален
• В используемом скрипте блок-триггер Ручной запуск заменен на другой
• Из модели данных удалена используемая таблица
• Используется пустое значение колонки из другой связанной таблицы. Необходимо изменить ее свойство на Nullable

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

Примеры запуска скриптов из дашборда

Чтобы выполнить какое-либо действие, необходимо создать скрипт.

Добавить строку

Чтобы добавить строку в таблицу:

1. Создайте новый скрипт в дашборде.
2. Добавьте блок Ручной запуск. В блок добавьте ожидаемые поля, укажите необходимые типы данных и нажмите Продолжить. Используйте названия колонок таблиц из модели данных. Протестируйте блок.
3. Добавьте блок Добавить строки. В блоке выберите необходимую таблицу, а в колонках — указанные в первом блоке ожидаемые поля. Для удобства используйте визуальный маппинг. Протестируйте блок.
4. Опубликуйте скрипт.
5. Откройте дашборд с необходимой таблицей. Добавьте действие во вкладке Действия и укажите для него название. В параметрах каждого поля укажите необходимый способ ввода и колонку. Чтобы результат выполнения отобразился после выполнения скрипта, установите для параметра Обновить после выполнения скрипта значение Этот виджет.
6. Опубликуйте дашборд. В верху таблицы нажмите Добавить строку. Укажите необходимые параметры и нажмите Выполнить.
7. Строка добавлена.

Удалить строки

Чтобы удалить строки из таблицы:

1. Создайте новый скрипт в дашборде.
2. Добавьте блок Ручной запуск. В блок добавьте ожидаемое поле, укажите необходимый тип данных и нажмите Продолжить. Используйте название колонки таблицы из модели данных. Протестируйте блок.
3. Добавьте блок SQL-запрос с запросом на удаление строки. Протестируйте блок. Пример SQL-запроса для удаления строки:
   DELETE FROM case_table
   WHERE incident_id = ${a1.Номер проблемы};
   

4. Опубликуйте скрипт.
5. Откройте дашборд с необходимой таблицей. Добавьте действие во вкладке Действия и укажите для него название. В параметрах поля укажите способ ввода Из колонки. Выберите ту же колонку, что и указана в SQL-запросе скрипта. Чтобы результат выполнения отобразился после выполнения скрипта, установите для параметра Обновить после выполнения скрипта значение Этот виджет.
6. Опубликуйте дашборд. Выберите строки, которые хотите удалить и нажмите Удалить строки над таблицей. Нажмите Выполнить.
7. Строки удалены.

Изменить приоритет

Чтобы изменить приоритет:

1. Создайте новый скрипт в дашборде.
2. Добавьте блок Ручной запуск. В блок добавьте ожидаемые поля, укажите необходимые типы данных и нажмите Продолжить. Протестируйте блок.
3. Добавьте блок Обновить строки. В блоке укажите необходимую таблицу, колонку-ключ и значение ключа, а в колонках — приоритет. Для удобства можно использовать визуальный маппинг. Протестируйте блок.
4. Опубликуйте скрипт.
5. Откройте дашборд с необходимой таблицей. Добавьте действие во вкладке Действия и укажите для него название. В параметрах каждого поля укажите необходимый способ ввода и колонку. Чтобы результат выполнения отобразился после выполнения скрипта, установите для параметра Обновить после выполнения скрипта значение Этот виджет.
6. Опубликуйте дашборд. Выберите строки, для которых хотите изменить приоритет. В верху таблицы нажмите Изменить приоритет. Введите или выберите необходимое значение и нажмите Выполнить.
7. У выбранных задач изменился приоритет.

Настройки скрипта и действия в YAML

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

Параметры скрипта (блок parameters)

В блоке parameters указываются параметры скрипта:

Способ ввода (ключ inputMethod)

Доступны перечисленные способы ввода значения:

• COLUMN — из колонки
• VARIABLE — из переменной
• DATA_MODEL — из модели данных
• FORMULA — задать формулой
• AGGREGATION — задать агрегацией
• MANUALLY — ввести вручную
• STATIC_LIST — статический список
• DYNAMIC_LIST — динамический список

Настройки для способа ввода Из колонки (COLUMN):

Настройки для способа ввода Из переменной (VARIABLE):

Настройки для способа ввода Из модели данных (DATA_MODEL):

Настройки для способа ввода Задать формулой (FORMULA):

Настройки для способа ввода Задать агрегацией (AGGREGATION):

Настройки для способа ввода Ввести вручную (MANUALLY):

Настройки для способа ввода Статический список (STATIC_LIST):

Настройки для способа ввода Динамический список (DYNAMIC_LIST):

Настройка цвета для кнопки

При настройке блоков backgroundColor, color или borderColor используйте ключи, описанные в таблице ниже.

Активация кнопки (блок blockingCondition)

Пример:

actions:
  - name: "Действие"
    type: EXECUTE_SCRIPT
    description: "Описание действия"
    filters:
      - name: case_id
        formula: '"case_table"."case_id"'
        dbDataType: STRING
        format: STRING
        filteringMethod: INCLUDE
        checkedvalues: 
          - 'Value_1'
          - 'Value_2'
          - 'Value_3'
        formValues: {}
    scriptName: script_1
    parameters: 
      - name: parameter_1
        displayName: "Параметр 1"
        inputMethod: COLUMN
        tableName: table_1
        columnName: column_1
        isHidden: false
      - name: parameter_2
        displayName: "Параметр 2"
        inputMethod: VARIABLE
        sourceVariable: variable_1
        isHidden: false
      - name: parameter_3
        displayName: "Параметр 3"
        inputMethod: FORMULA
        formula: 'avg("table_1"."column_1")'
        isHidden: false
      - name: parameter_4
        displayName: "Параметр 4"
        inputMethod: MANUALLY
        description: "Описание поля параметра"
        isHidden: false
      - name: parameter_5
        displayName: "Параметр 5"
        inputMethod: STATIC_LIST
        options:
          - '10'
          - '20'
          - '30'
        defaultOptionIndex: 0
        isHidden: false
      - name: parameter_6
        displayName: "Параметр 6"
        inputMethod: DYNAMIC_LIST
        formula: '"table_1"."column_1"'
        dbDataType: STRING
        filters:
          - name: case_id
            formula: '"case_table"."case_id"'
            dbDataType: STRING
            format: STRING
            filteringMethod: INCLUDE
            checkedvalues: 
              - 'Value_1'
              - 'Value_2'
              - 'Value_3'
            formValues: {}
        defaultValue: '100'
        isHidden: false
    updateDashboard: true