ObjectId — функция диаграммы
Функция диаграммы ObjectId() возвращает идентификатор объекта, в котором оценивается выражение. Функция принимает дополнительный аргумент, определяющий тип объекта, к которому относится функция. Объектом может быть лист или визуализация. Эта функция доступна только в выражениях диаграммы.
Синтаксис:
ObjectId([object_type_str])
Возвращаемые типы данных: строка
Единственный аргумент функции, object_type_str, является необязательным и содержит строковое значение, указывающее на тип объекта.
Аргумент | Описание |
---|---|
object_type_str | Строковое значение, представляющее тип оцениваемого объекта. |
Если в выражении функции не задан аргумент, ObjectId() возвращает идентификатор объекта, в котором используется выражение. Чтобы вернуть идентификатор объекта листа, в котором отображается визуализация, используйте ObjectId('sheet').
Если объект визуализации вложен в другой объект визуализации, укажите требуемый тип объекта в аргументе функции для получения других результатов. Например, для диаграммы Текст и изображение в контейнере используйте 'text-image' для возврата объекта Текст и изображение и 'container' для возврата идентификатора контейнера.
Выполните следующие действия.
-
В режиме анализа добавьте следующий текст в URL:
/options/developer
-
Щелкните визуализацию правой кнопкой мыши и выберите Разработчик.
-
В области Свойства найдите идентификатор объекта в заголовке диалогового окна и тип объекта в свойстве qType.
Ограничения:
Эта функция может приводит к неожиданным результатам, если вызывается в объекте (например, кнопке) внутри контейнера, который является основным элементом. Это ограничение также применяется в основным элементам фильтра, которые являются контейнерам для нескольких списков. Это объясняется тем, как основные элементы используют иерархию объектов.
В таких случаях выражение диаграммы ObjectId('sheet') возвращает пустую строку, а ObjectId('masterobject') — идентификатор основного элемента-владельца.
Функция InObject() часто используется в сочетании со следующими функциями:
Функция | Взаимодействие |
---|---|
if — функция скриптa и диаграммы | Функции if и ObjectId можно использовать вместе для создания условных выражений. Например, на визуализации можно применять условные цвета, используя выражения с этими функциями. |
InObject — функция диаграммы | Аналогично if, InObject также используется с функцией ObjectId для создания условных выражений. |
Пример 1. Возвращение идентификатора объекта диаграммы
Пример 2. Возвращение идентификатора листа
Пример 3. Вложенное выражение
Для получения более подробного примера использования условных цветов см. пример по использованию InObject — функция диаграммы.