Методы
...
visApi().setFilterSelectedValues(widgetGuid, values, handler) void
Устанавливает фильтр в виджете.
...
handler: Function() => void - Функция обратной связи, которая вызывается после того, как фильтр был установлен.
visApi().setExcludeFilterSelectedValues(widgetGuid, values, handler) void
Устанавливает исключающий фильтр в виджете.
...
handler: Function() => void - Функция обратной связи, которая вызывается после того, как фильтр был установлен.
visApi().setDateFilterSelectedValues(widgetGuid, values) void
Устанавливает фильтр в виджете.
...
values: Date[][] - массив дат, которые нужно установить в фильтр по датам. Пример для множественного выбора (от и до): [new Date(), new Date()]. Пример для единичного выбора: [new Date()]. Для сброса фильтра необходимо передать пустой массив: [].
visApi().getWidgetDataByGuid(widgetGuid) Promise<{ data: DataFrame, selected : string[][] }>
Возвращает данные виджета. Асинхронная функция.
...
Возвращаемый ответ: data: DataFrame - данные виджета. selected: string[][] - массив выбранных значений (фильтров).
visApi().getSelectedValues(widgetGuid) string[][] = [[" Москва ", " 2020 "], [" Казань ", "2021"]]
Возвращает выбранные значения (фильтры) на виджете.
visApi().getSheetZoom() number
Возвращает значение зума (0 – 100%) листа на дашборде.
visApi().getFilterIsOpen(widgetGuid) boolean
Возвращает состояние выпадающего списка в виджете «Фильтр».
visApi().exportDashboard(format) Promise<void>
Экспортирует дашборд. Асинхронная функция.
format: string - формат файла, в который нужно экспортировать дашборд. Поддерживаемые форматы: "png ", "pdf ", "xlsx ", "pptx".
visApi().exportExcelWidgetData(widgetGuid) Promise<void>
Экспортирует видимые данные виджета в формат XLSX. Асинхронная функция.
...
widgetGuid: string - guid виджета, данные которого необходимо экспортировать в XLSX.
visApi().exportAllWidgetData(widgetGuid) Promise<void>
Экспортирует все данные виджета в формат XLSX. Асинхронная функция.
widgetGuid: string - guid виджета, данные которого необходимо экспортировать в XLSX.
Функции, структуры ответов которых могут часто изменяться
| Информацияwarning |
|---|
В настоящем разделе приводятся функции, структуры ответов которых могут часто изменяться. Поэтому данные функции не рекомендуется использовать. Важно!
|
visApi().getWidgets() object[]
Возвращает объекты всех виджетов на выбранном листе. Имеет сложную структуру для каждого типа виджета.
visApi().getSelectedWidgets() object[]
Возвращает объекты выделенных виджетов на выбранном листе. Имеет сложную структуру для каждого типа виджета.
visApi().getWidgetByGuid(widgetGuid) object
Возвращает объект виджета на выбранном лист. Имеет сложную структуру для каждого типа виджета.
widgetGuid: string - guid виджета, который нужно получить.
События
...
visApi().onSelectedValuesChangedListener({ guid, widgetGuid }, handler) void
Подписка на изменение выбранных фильтров у виджета.
...
handler: Function({ widgetGuid: string, selectedValues: string[][], useExcluding: boolean) => void - Функция обратной связи, которая вызывается при изменении выбранных значений (фильтров) на виджете. widgetGuid: string - guid виджета, в котором изменили выбранные значения. selectedValues: string[][] - выбранные значения. useExcluding: boolean - true, если фильтр исключающий.
visApi().onWidgetLoadedListener({ guid, widgetGuid }, handler) void
Подписка на загрузку виджета.
...
handler: Function({ widgetGuid: string }) => void - функция обратной связи, которая вызывается после загрузки виджета. widgetGuid: string - guid виджета, который загрузился. Примечание: функция вызывается сразу после выполнения js кода виджета, не дожидаясь его отрисовки.
visApi().onAllWidgetsLoadedListener(handler) void
Подписка на загрузку виджета.
handler: Function() => void - функция обратной связи, которая вызывается после загрузки всех виджетов. Примечание: функция вызывается сразу после выполнения js кода последнего виджета, не дожидаясь его отрисовки.
visApi().onFilterIsOpenChangedListener({ guid, widgetGuid }, handler) void
Подписка на загрузку виджета.
...
handler: Function({ widgetGuid: string, isOpen: boolean }) => void - Функция обратной связи, которая вызывается после открытия/закрытия выпадающего списка в виджете «Фильтр». widgetGuid: string - guid виджета «Фильтр», выпадающий список которого открыли/закрыли. isOpen: boolean - true, если выпадающий список открыт.
Описание объектов
...
DataFrame
cols: string[][] - названия колонок.
...
rowHeaders: string[] - названия заголовков строк.
ColInfo
id: string - объединенная (join) id колонок.
idParts: string[] - массив id колонок.
ColMeta
measureGroupId: string - id группы показателей.
...
dimensions: string[] - массив id измерений.
Total
columnPath: string[] - путь к итогам в столбце.
...