Как определить конфигурацию визуализации

Варианты настроек данных и стиля задаются в файле конфигурации JSON. Конфигурация data определяет набор параметров и показателей, поддерживаемых в визуализации. Конфигурация style определяет селекторы стиля, доступные на панели свойств.

Конфигурация data

Конфигурация data определяет элементы DIMENSION и METRIC, отображаемые Студией данных на панели свойств. Элементы соответствуют полям параметров и показателей, которые конечный пользователь задает в визуализации.

Пример элемента data:

{
  "id": "twoDimensionsPlease",
  "label": "Dimension Element Heading",
  "type": "DIMENSION",
  "options": {
    "min": 2,
    "max": 2,
  }
}

Объект id, заданный в элементе data, включается в информацию, которую возвращает Студия данных. Объект label определяет текст, который будут видеть пользователи над разделом data. Объект type определяет тип элемента: параметр или показатель. Объект options определяет минимальное и максимальное количество полей, которые можно добавить в элемент data.

В элементе data DIMENSION объект options поддерживает необязательный ключ supportedTypes. Если он определен, Студия данных ограничивает тип полей параметров, которые можно добавить в элемент. Значение supportedTypes является массивом, содержащим все комбинации значений "DEFAULT", "TIME" и "GEO".

Раздел data объединяет несколько элементов data. Студия данных отображает значение label как заголовок этого раздела.

Пример раздела data:

{
  "id": "dimensionSection1",
  "label": "Dimension Section Heading",
  "elements":[
    // array of data elements
  ]
}

Ниже показано, как в Студии данных будут отображаться заданные выше раздел data и элемент data.

Элемент data на панели свойств

Конфигурация style

Конфигурация style определяет селекторы стиля, отображаемые на панели свойств.

Пример элемента style:

{
  "id": "linkOpacity",
  "label": "Link opacity",
  "type": "OPACITY",
  "defaultValue": "0.2"
}

Объект label определяет текст, который пользователи будут видеть как подсказку. Объект type определяет тип селектора стиля, отображаемого Студией данных. Объект defaultValue задавать необязательно. Он определяет значение по умолчанию для каждого элемента style.

Как и в конфигурации data, элементы style логически объединены в разделы с заголовками. Полный список доступных селекторов приведен в этой статье.

Пример раздела style:

{
  "id": "styleGroup1",
  "label": "Header for style group",
  "elements": [
    // insert Style Elements here
  ]
}

Ниже приведен пример панели стиля с селектором прозрачности и подсказкой "Link Opacity" (прозрачность ссылки), заданной в объекте label элемента style.

Селектор стиля

Конфигурация interaction

Конфигурация interaction определяет взаимодействия с диаграммой. Это необязательная настройка.

Пример:

{
  "id": "onClick",
  "supportedActions": ["FILTER"]
}

В настоящее время поддерживается только один тип взаимодействия: FILTER. Если вы зададите эту конфигурацию, на панели свойств появится соответствующий флажок.

Селектор стиля

Пример конфигурации

Дополнительная информация

Определив конфигурацию, вы можете перейти к созданию визуализации.