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. Возвращение идентификатора объекта диаграммы

Следующий базовый пример показывает, как вернуть идентификатор визуализации.

Выполните следующие действия.

Откройте новый лист и перетащите диаграмму Текст и изображение на лист.
На панели свойств щелкните Добавить меру.
Щелкните элемент , чтобы открыть редактор выражения.
Вставьте следующее выражение в диалоговое окно:
```
=ObjectId()
```
Щелкните Применить.

Идентификатор объекта Текст и изображение отображается в визуализации.

Того же результата можно добиться с помощью следующего выражения:

=ObjectId('text-image')

Пример 2. Возвращение идентификатора листа

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

Выполните следующие действия.

Откройте новый лист и перетащите диаграмму Текст и изображение на лист.
На панели свойств щелкните Добавить меру.
Щелкните элемент , чтобы открыть редактор выражения.
Вставьте следующее выражение в диалоговое окно:
```
=ObjectId('sheet')
```
Щелкните Применить.

Идентификатор листа отображается в визуализации.

Пример 3. Вложенное выражение

Следующий пример показывает, как функцию ObjectId() можно вкладывать в другие выражения.

Выполните следующие действия.

Откройте новый лист и перетащите диаграмму Текст и изображение на лист.
На панели свойств щелкните Добавить меру.
Щелкните элемент , чтобы открыть редактор выражения.
Вставьте следующее выражение в диалоговое окно:

=if(InObject(ObjectId('text-image')), 'В «Текст и изображение»', 'Не в «Текст и изображение»')
Щелкните Применить.

Текст В «Текст и изображение» отображается на диаграмме и обозначает, что объект, упомянутый в выражении, является диаграммой Текст и изображение.

Для получения более подробного примера использования условных цветов см. пример по использованию InObject — функция диаграммы.

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!

Оставьте свой отзыв здесь