Печать      Открыть версию интерактивной справки в формате PDF


Previous Topic

Next Topic

О задании фильтров для внедренных отчетов и информационных панелей

Можно внедрять отчеты и информационные панели в пользовательские веб-аплеты и веб-вкладки. Также можно настроить поля веб-ссылок таким образом, чтобы они позволяли открыть отчеты и информационные панели.

При создании пользовательского веб-аплета, веб-вкладки или веб-ссылки типа "Отчет" или "Информационная панель" можно задать фильтры, которые будут применяться во время выполнения. Фильтры, заданные для информационной панели, будут применяться ко всем содержащимся на ней отчетам.

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

ПРИМЕЧАНИЕ. При создании пользовательского веб-аплета, веб-вкладки или веб-ссылки типа "Отчет" при необходимости можно указать, что любые приглашения, определенные для встроенного отчета, должны отображаться во время выполнения, установив флажок "Отображать приглашения отчета". Отображение приглашений во время выполнения позволяет пользователям фильтровать отчет. Однако настройка флажка "Отображать приглашения отчета" имеет приоритет над любыми фильтрами, определенными в поле "Параметры" для внедренного отчета иди информационной панели. Поэтому, если установлен флажок "Отображать приглашения отчета" для настраиваемого веб-аплета, веб-вкладки или веб-ссылки, любые фильтры, определенные в поле "Параметры", как описано в этом разделе, игнорируются, даже если никакие приглашения не определены для встроенного отчета.

Синтаксис для определения фильтров

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

  • С помощью параметров Pn, именуемых синтаксисом Pn.
  • С помощью групп параметров opn, coln и valn, именуемых синтаксисом opn.

Нельзя использовать смесь синтаксиса двух типов.

При использовании синтаксиса Pn можно задать не более шести фильтров. В параметре P0 указывается число настраиваемых фильтров. Допустимыми значениями параметра P0 являются числа от 1 до 6. Параметр P0 может использоваться в строке параметров только один раз. Для каждого фильтра используются три параметра, которые содержат оператор, столбец и значение. Первый фильтр задается параметрами P1-P3. P1 должен определять оператор, P2 - столбец, а P3 - значение. Последующие фильтры задаются группами из трех параметров P4-P6, P7-P9, P10-P12, P13-P15 и P16-P18. Используйте амперсанд (&) для разделения параметров. Каждый параметр может использоваться в строке параметров только один раз.

В случае одного фильтра синтаксис имеет следующий вид, хотя порядок параметров в строке может быть произвольным:

P0=1&P1=оператор&P2=столбец.таблицы&P3=значение

Чтобы задать дополнительные фильтры, добавьте параметры P4-P6, P7-P9 и т. д., увеличивая при этом значение параметра P0 так, чтобы оно соответствовало общему числу фильтров. Таким образом, в случае двух фильтров синтаксис примет следующий вид:

P0=2&P1=оператор&P2=столбец.таблицы&P3=значение&P4=оператор&P5=столбец.таблицы&P6=значение

При использовании синтаксиса opn число фильтров, которые могут быть определены, неограниченно. Каждый фильтр использует группу из трех параметров: параметр opn определяет оператор, параметр coln определяет столбец, а параметр valn определяет значение. Используйте амперсанд (&) для разделения параметров. Все параметры в группе фильтров должны иметь одинаковый номер, который должен быть целым числом больше нуля (0), а группы параметров должны нумероваться последовательно. В случае одного фильтра синтаксис имеет следующий вид, хотя порядок параметров в строке может быть произвольным:

op1=оператор&col1=столбец.таблицы&val1=значение

Аналогично, в случае двух фильтров синтаксис примет следующий вид:

op1=оператор&col1=столбец.таблицы&val1=значение&op2=оператор&col2=столбец.таблицы&val2=значение

ПРИМЕЧАНИЕ. В параметре столбца, если имя таблицы или имя столбца содержит пробел, необходимо заключить имя в двойные кавычки. Если имя таблицы или имя столбца не содержит пробел, необязательно заключать имя в двойные кавычки, но можно сделать это. Это справедливо для обоих типов синтаксиса.

Параметр "Страница"

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

Page=имя страницы,

где имя страницы - это имя страницы, отображаемое в информационной панели. Не заключайте имя страницы в двойные кавычки, даже если оно содержит один или несколько пробелов. Можно определить параметр "Страница" непосредственно или с помощью других параметров. Параметр "Страница" может быть указан в любом месте строки параметров, но необходимо использовать амперсанд (&) для отделения его от всех предшествующих или предыдущих параметров.

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

О специальных символах в параметрах

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

  • % (знак процента). Кодируется как %25.
  • & (амперсанд). Кодируется как %26.
  • [ (левая квадратная скобка). Кодируется как %5B.
  • ] (правая квадратная скобка). Кодируется как %5d.
  • + (знак плюса). Кодируется как %2B.

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

Проверка параметров

Указанные параметры, за исключением параметра "Страница", проверяются при попытке сохранить изменения. Если обнаружены какие-либо ошибки, необходимо исправить их, прежде чем сохранить изменения.

ПРИМЕЧАНИЕ. До выпуска 40 параметры фильтра не проверялись перед сохранением. Поэтому параметр фильтра, указанный для встроенного отчета или информационной панели в выпусках до Выпуска 40, может содержать ошибку. Если в синтаксисе фильтра обнаруживаются ошибки при отображении встроенного отчета или информационной панели, выводится сообщение об ошибке. Кроме того, если при редактировании существующего поля веб-аплета, веб-вкладки или веб-ссылки с типом "Отчет" или "Информационная панель" какое-то поле изменяется и предпринимается попытка сохранить изменения, проверяются все поля, включая поле "Параметры". Если обнаружены какие-либо ошибки, необходимо исправить их.

В следующих разделах описываются параметры, составляющие фильтр.

Оператор

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

Оператор

Описание

eq

Равно или содержится в

neq

Не равно или не содержится в

lt

Меньше

gt

Больше

ge

Больше или равно

le

Меньше или равно

bwith

Начинается с

ewith

Заканчивается на

cany

Содержит любое значение. Параметр значения может содержать несколько значений; их следует разделять знаком плюс (+). При использовании синтаксиса Pn в начале списка значений необходимо указать число значений. При использовании синтаксиса opn число значений не указывается, в противном случае Oracle CRM On Demand принимает указанное число за другое значение.

Например, чтобы найти области организации "Восток", "Запад" и "Центр" (т. е. три области):

P0=1&P1=cany&P2="Организация"."Область организации"&P3=3+Восток+Запад+Центр

или:

op1=cany&col1="Организация"."Область организации"&val1=Восток+Запад+Центр

call

Содержит все. Параметр значения может содержать несколько значений; их следует разделять знаком плюс (+). При использовании синтаксиса Pn в начале списка значений необходимо указать число значений. При использовании синтаксиса opn число значений не указывается, в противном случае Oracle CRM On Demand принимает указанное число за другое значение.

like

Like. Параметр значения должен содержать значение. Строка значений должна оканчиваться подстановочным знаком % (знак процента), иначе оператор LIKE вернет только точные совпадения для строки. Знак процента должен быть закодирован %25.

Например, чтобы найти названия организаций, подобные Acme, введите:

P0=1&P1=like&P2="Организация"."Имя организации"&P3=Acme%25

или:

op1=like&col1="Организация"."Имя организации"&val1=Acme%25

top

Первые n позиций. Например, чтобы найти первые 6 показателей выручки от продаж, введите:

P0=1&P1=top&P2="Организация"."Выручка организации"&P3=6

или:

op1=top&col1="Организация"."Выручка организации"&val1=6

bottom

Последние n позиций. Например, чтобы найти последние 4 показателя выручки от продаж, введите:

P0=1&P1=bottom&P2="Организация"."Выручка организации"&P3=4

или:

op1=bottom&col1="Организация"."Выручка организации"&val1=4

bet

Между. Параметр значения должен содержать два значения, разделенных знаком плюс (+). При использовании синтаксиса Pn в начале списка значений необходимо указать число значений (2). При использовании синтаксиса opn число значений не указывается, в противном случае Oracle CRM On Demand принимает указанное число за другое значение.

Например, чтобы задать фильтр по выручке организации от 100 000 до 500 000, введите:

P0=1&P1=bet&P2="Организация"."Выручка организации"&P3=2+100000+500000

или:

op1=bet&col1="Организация"."Выручка организации"&val1=100000+500000

null

Не определено. Параметр значения должен быть равен нулю (0) и не может быть пропущен.

nnull

Определено. Параметр значения должен быть равен нулю (0) и не может быть пропущен.

Столбец

При задании столбца необходимо иметь в виду следующее:

  • Необходимо указать имя таблицы и имя столбца, разделенные точкой (.).
  • Если имя таблицы или имя столбца содержит пробел, необходимо заключить имя в двойные кавычки. Если имя таблицы или имя столбца не содержит пробел, необязательно заключать имя в двойные кавычки, но можно сделать это. Это справедливо для обоих типов синтаксиса. Например, допустимы все следующие варианты:

    "Организация"."Имя организации"

    "Запрос на обслуживание".Область

    Организация."Имя организации"

  • Необходимо использовать исходные имена столбцов, а не отображаемые.

Значение

При задании значения фильтра необходимо иметь в виду следующее:

  • Можно указать непосредственно значение или определить поле в качестве параметра.
  • При использовании синтаксиса opn и непосредственного задания значения, которое содержит пробел, значение следует заключить в двойные кавычки. Если указано несколько значений, одно из которых содержит пробел, все указанные значения следует заключить в двойные кавычки, например:

    val1="Нью-Йорк"+"Алабама"+"Калифорния"

    При использовании синтаксиса Pn не требуется заключать значение, содержащее пробел, в двойные кавычки.

  • Чтобы включить пользовательское или системное поле в параметр фильтра, подведите курсор к тому месту в поле "Параметры", куда требуется добавить параметр, и выберите нужное поле в списке "Пользовательские и системные поля".

    Сведения о пользовательских и системных полях, которые можно использовать в качестве параметров, см. в разделе Пользовательские и системные поля.

  • (Веб-аплеты только для страниц сведений типов записей и веб-ссылки) Чтобы включить поле из типа записи в параметр фильтра, подведите курсор к тому месту в поле "Параметры", куда требуется добавить поле, и выберите нужное поле в списке "Поля тип записи", где тип записи - имя типа записи, для которого создается аплет.

    Например, если выбрать поле "Идентификатор строки" в списке "Поля тип записи" вставляется %%%Row_Id%%%. Во время выполнения вместо %%%Row_Id%%% подставляется идентификатор строки текущей записи.

ПРИМЕЧАНИЕ. URL-адрес для отчета или информационной панели генерируется во время выполнения. Длина URL-адреса для отчета или информационной панели может варьироваться в зависимости от значений, передаваемых в поле URL-адреса для фильтров во время выполнения. Для каждого браузера определена макс. длина адреса URL. Если длина URL-адреса для отчета или информационной панели превышает этот предел, при попытке просмотреть этот отчет или панель браузер может повести себя непредсказуемо.

ПРИМЕЧАНИЕ. Можно задать параметры для отчета, информационной панели или страницы информационной панели в действии "Отправка электронной почты" для запланированного события аналитики таким же образом, что и параметры для внедренного отчета или информационной панели в веб-аплете, в веб-ссылке или на веб-вкладке. Однако в действии "Отправка электронной почты" нельзя выбрать поля для задания в качестве значений параметров. Сведения о настройке запланированных событий для аналитики см. в разделе Создание запланированных событий для аналитики.


Опубликовано в Август 2022 Copyright © Oracle и/или ее дочерние компании, 2005, 2022. Legal Notices.