Loading
CRM Analytics
Синтаксис фильтрации и выборки для внедренных панелей мониторинга

Синтаксис фильтрации и выборки для внедренных панелей мониторинга

Чтобы указать фильтры или выборки панелей мониторинга, требующие строк JSON, используйте атрибут Filter компонента панели мониторинга LWC CRM Analytics или атрибут Filter String встроенного компонента Aura панели мониторинга CRM Analytics.

Примечание
Примечание Маркер можно использовать для передачи значения с родительской страницы. Если маркер решает несколько значений, разрешенные значения отображаются правильно в конечной строке фильтра.

Синтаксис фильтрации

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

{"datasets" : {
    "dataset1": [
      {
        "fields": ["field1"], 
        "filter": { 
            "operator": "in", 
            "values": ["$value1", "$value2"]
          }
        }
      ]
    }
  }

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

{"datasets": {
    "account":[
      {
        "fields":["Name"], 
        "filter": {
          "operator": "matches", 
          "values":["$Name"]
          }
        }
      ]
    }
  }

Синтаксис выборки

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

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

{"steps" : {
    "Account_Step":  
      {
        "metadata": {"groups": ["Name"]}, 
        "values": ["$Name"]
      }
    }
  }

Дополнительные примеры синтаксиса фильтрации и выборки

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

{
    ...
    "values": [[value1]]
    ...
  }

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

{
    ...
    "values": [["year", 0], ["year", 2]]
    ...
  }

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

{
    ...
    "values": [null, ["year", 2]]
    ...
  }

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

{
    ...
    "values": [[1581033600000, 1585353600000]]
    ...
  }

Справочные таблицы синтаксиса

Используйте эти таблицы, чтобы понять определение синтаксиса фильтров и выборки.

Нотация Описание Примечания
datasets Наборы данных CRM Analytics. Наборы данных содержат fields и filter, описанные в таблице нотаций наборов данных.

Где находится В Analytics Studio выберите «Правка» в наборе данных. Системное имя находится на левой панели страницы редактирования набора данных. Если в вашей организации есть пространства имен, добавьте префикс пространства и два символа подчеркивания перед системным именем набора данных.

steps Имена этапов для ссылки в выборке. Этапы имеют metadata и values, описанные в таблице «Нотации этапов».

Где находится В Analytics Studio выберите «Правка» на панели мониторинга. Выберите виджет для применения к нему выборки. Именем этапа является значение «Код» во вкладке «Запрос».

Нотация наборов данных Описание Примечания
fields Список измерений или мер в наборе данных CRM Analytics. Где находится Нажмите значок «Изучить», чтобы открыть виджет. Затем выберите команду Показать SAQL в меню "Параметры". Названия измерений смотрите в операторах «сгруппировано по». Названия мер смотрите в операторах с такими функциями, как «sum» или «stddev».
фильтр Фильтр для применения к данным панели мониторинга. Фильтры содержат operators и values, описанные в таблице «Нотация фильтра». Фильтр принимает значения измерений или мер, описанные в следующей таблице.
Нотация фильтра Описание Примечания
operator Оператор фильтра.

Поддерживаемые operators для измерений: в пределах, за пределами, совпадает.

Поддерживаемые операторы для мер: ==, !=, >=, >, <=, <

значения Значения, используемые в фильтре. Эти значения могут быть заданы или вставлены динамически из контекста страницы посредством префикса $, например, $<FieldName>.

Где находится В меню «Настройки» найдите нужный объект и выберите «Поля». Используйте Имя поля (также называется «Имя API»). Для настраиваемых полей используйте имя с суффиксом «__c» в конце.

Нотация этапов Описание Примечания
metadata

Метаданные этапа.

Любые groups, указанные для группировки, должны использоваться в values.

values

Список значений этапов, используемые в выборке. Эти значения этапов могут быть заданы или вставлены динамически из контекста страницы посредством префикса $, например, $<FieldName>.

Где находится В меню «Настройки» найдите нужный объект и выберите «Поля». Используйте Имя поля (также называется «Имя API»). Для настраиваемых полей используйте имя с суффиксом «__c» в конце.

Примечание
Примечание Предыдущий синтаксис стал доступен в выпуске Spring ‘17. Предыдущий синтаксис поддерживается и работает так же, как и новый вариант выбора. Новый синтаксис рекомендован к использованию, поскольку его производительность выше. Предыдущий синтаксис для справки:
{ "datasetSystemName1": {"field1": ["$value1"]}, "datasetSystemName2": {"field1": ["$value1", "$value2"],"field2": ["$value3"]} } 

Например:

{"opportunity": {"AccountId': ["$Id"]}}

Не позволяйте пользователям открывать доступ к данным, блокируя или скрывая фильтры. При использовании параметра «Заблокировано» меню «Фильтры» отображается в заглавии встроенной панели мониторинга, но пользователи не могут изменить или удалить фильтры. При использовании параметра «Скрыто» меню «Фильтры» не отображается в заглавии встроенной панели мониторинга.

Заблокированные и скрытые параметры используются только для фильтров, а не для выборок. Добавьте параметры в JSON фильтра с помощью логического значения. Например, “locked”:false,”hidden”:true

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

  • Заблокированные и скрытые фильтры применяются к панели мониторинга. Если фильтр открывает доступ к полю, пользователям отображается поле даже при ограничении доступа к фильтрам посредством одного из указанных параметров.
  • Параметры «Заблокировано» и «Скрыто» не применяются автоматически при поиске в подключенных панелях мониторинга или представлениях Lens. Параметр применяется только к указанной панели мониторинга.
  • Параметры «Заблокировано» и «Скрыто» применяются к панели мониторинга при встраивании или открытии во вкладке CRM Analytics Studio или Analytics.
  • При применении заблокированных или скрытых фильтров к панели мониторинга меню «Мои представления» недоступно пользователям.
 
Загрузка
Salesforce Help | Article