인쇄      온라인 도움말의 PDF 버전 열기


이전 항목

다음 항목

포함된 보고서 및 대시보드에 대한 필터 지정 정보

사용자정의 웹 애플릿 및 웹 탭에 보고서 및 대시보드를 포함할 수 있습니다. 보고서 및 대시보드를 열 웹 링크 필드를 구성할 수도 있습니다.

보고서 또는 대시보드 유형의 사용자정의 웹 애플릿, 웹 탭 또는 웹 링크를 생성하는 경우 런타임에 적용할 필터를 지정할 수 있습니다. 대시보드에 대해 지정한 필터는 대시보드의 모든 보고서에 적용됩니다.

필터에서 지정하는 각 열에는 포함하려는 보고서에서 해당 열에 대해 구성된 필터도 있어야 합니다. 대시보드를 포함하는 경우 열에는 대시보드의 각 보고서에서 해당 열에 대해 구성된 필터가 있어야 합니다. 보고서의 필터는 "전달됨"으로 설정되거나 연산자 및 값으로 구성될 수 있습니다. 보고서의 열에 대해 필터가 구성되지 않은 경우 웹 애플릿, 웹 탭 또는 웹 링크에서 해당 열에 대해 지정하는 필터가 보고서 실행 시 적용되지 않습니다. 보고서의 열에 필터를 추가하는 작업에 대한 자세한 내용은 분석의 열에 필터 추가를 참조하십시오.

참조: 보고서 유형의 사용자정의 웹 애플릿, 웹 탭 또는 웹 링크를 생성하는 경우 [보고서 프롬프트 표시] 확인란을 선택하여 포함된 보고서에 대해 정의된 프롬프트가 런타임 시 표시되도록 선택적으로 지정할 수 있습니다. 런타임 시 프롬프트를 표시하면 사용자가 보고서를 필터링할 수 있습니다. 하지만 [보고서 프롬프트 표시] 확인란의 설정은 포함된 보고서 또는 대시보드의 [매개변수] 필드에 정의된 필터보다 우선합니다. 따라서 사용자정의 웹 애플릿, 웹 탭 또는 웹 링크에 대해 [보고서 프롬프트 표시] 확인란을 선택하면 포함된 보고서에 대해 프롬프트가 정의되어 있지 않아도 이 항목에 설명된 것처럼 [매개변수] 필드에 정의된 필터가 모두 무시됩니다.

필터 지정 구문

필터 매개변수는 다음 방법 중 하나를 사용하여 지정할 수 있습니다.

  • Pn 매개변수를 사용합니다. Pn 구문이라고 합니다.
  • opn, coln 및 valn 매개변수 그룹을 사용합니다. opn 구문이라고 합니다.

두 유형의 구문을 혼합하여 사용할 수 없습니다.

Pn 구문을 사용하면 최대 6개의 필터를 지정할 수 있습니다. P0 매개변수에서 설정하려는 필터 수를 지정합니다. P0 매개변수에 유효한 값은 1부터 6까지의 정수입니다. P0 매개변수는 매개변수 문자열에 한 번만 사용할 수 있습니다. 각 필터는 3개의 매개변수를 사용하여 연산자, 열 및 값을 포함합니다. 첫 번째 필터는 P1~P3 매개변수에서 지정합니다. P1은 연산자를 지정해야 하고, P2는 열을 지정해야 하며, P3은 값을 지정해야 합니다. 3개 매개변수 집합 즉, P4~P6, P7~P9, P10~P12, P13~P15 및 P16~P18에 후속 필터를 지정합니다. 앰퍼샌드(&)를 사용하여 매개변수를 구분해야 합니다. 각 매개변수는 매개변수 문자열에 한 번만 사용할 수 있습니다.

단일 필터의 경우 구문은 다음과 같습니다. 단, 매개변수는 임의의 순서로 매개변수 문자열에 지정할 수 있습니다.

P0=1&P1=연산자&P2=table.column&P3=

추가 필터를 지정하려면 P4-P6, P7-P9 등의 매개변수를 추가하고 P0 매개변수의 값을 추가하는 필터 수와 일치하도록 늘립니다. 따라서 필터가 2개인 경우 구문은 다음과 같습니다.

P0=2&P1=연산자&P2=table.column&P3=&P4=연산자r&P5=table.column&P6=

opn 구문을 사용하면 지정할 수 있는 필터 수에 제한이 없습니다. 각 필터는 다음 3개의 매개변수로 구성된 그룹을 사용합니다. opn 매개변수는 연산자를 지정하고, coln 매개변수는 열을 지정하며, valn 매개변수는 값을 지정합니다. 앰퍼샌드(&)를 사용하여 매개변수를 구분해야 합니다. 동일한 번호를 사용하여 필터 그룹의 각 매개변수 번호를 지정해야 합니다. 번호는 0보다 큰 정수여야 하며 순차적으로 매개변수 그룹 번호를 지정해야 합니다. 단일 필터의 경우 구문은 다음과 같습니다. 단, 매개변수는 임의의 순서로 매개변수 문자열에 지정할 수 있습니다.

op1=연산자&col1=table.column&val1=

마찬가지로 필터가 2개인 경우 구문은 다음과 같습니다.

op1=연산자&col1=table.column&val1=&op2=연산자&col2=table.column&val2=

참고: 열 매개변수에서 테이블 이름이나 열 이름에 공백이 포함된 경우 해당 이름을 큰따옴표로 묶어야 합니다. 테이블 이름이나 열 이름에 공백이 포함되지 않은 경우 이름을 큰따옴표로 묶을 필요가 없으나 원하는 경우 큰따옴표로 묶을 수 있습니다. 이는 구문 유형 둘 다에 적용됩니다.

페이지 매개변수

대시보드를 포함하는 경우 선택적으로 페이지 매개변수를 사용하여 대시보드를 렌더링할 때 열리는 대시보드 페이지를 지정할 수 있습니다. 페이지 매개변수 구문은 다음과 같습니다.

페이지=페이지 이름

여기서, 페이지 이름은 대시보드에 표시되는 페이지 이름입니다. 페이지 이름은 공백이 1개 이상 포함되어 있어도 큰따옴표로 묶지 마십시오. 페이지 매개변수는 단독으로 또는 다른 매개변수와 함께 지정할 수 있습니다. 페이지 매개변수는 매개변수 문자열에서 임의의 위치에 배치할 수 있으나, 앰퍼샌드(&)를 사용하여 페이지 매개변수와 이 페이지 매개변수 앞이나 뒤에 오는 매개변수를 구분해야 합니다.

페이지 매개변수는 매개변수를 저장할 때 검증되지 않습니다. 페이지 매개변수를 포함하지 않거나 포함하되 매개변수 값을 비워 두면 대시보드를 렌더링할 때 대시보드의 첫 번째 페이지가 열립니다. 선택한 대시보드에서 페이지의 유효한 이름이 아닌 항목 값을 지정하는 경우 런타임 시 오류가 표시됩니다.

매개변수의 특수 문자 정보

매개변수에 지정하는 테이블 이름, 열 이름, 값 또는 대시보드 페이지 이름에는 다음 문자 중 하나가 포함되고 문자도 다음과 같이 인코딩되어야 합니다.

  • %(퍼센트 기호). %25로 인코딩합니다.
  • &(앰퍼샌드). %26으로 인코딩합니다.
  • [(왼쪽 대괄호). %5B로 인코딩합니다.
  • ](오른쪽 대괄호). %5D로 인코딩합니다.
  • +(더하기 기호). %2B로 인코딩합니다.

이러한 문자가 인코딩되지 않으면 매개변수를 저장하려는 경우 오류가 반환되거나 런타임 시 결과가 정확하지 않을 수 있습니다.

매개변수 검증

변경사항을 저장하려는 경우 페이지 매개변수를 제외하고 지정한 매개변수가 검증됩니다. 오류가 감지되면 해당 오류를 수정해야 변경사항을 저장할 수 있습니다.

참고: 릴리스 40 이전 릴리스에서는 필터 매개변수가 저장되기 전에 검증되지 않았습니다. 따라서 릴리스 40 이전 릴리스에 포함된 보고서 또는 대시보드에 대해 지정된 필터 매개변수에는 오류가 있을 수 있습니다. 포함된 보고서 또는 대시보드를 렌더링할 때 필터 구문에서 오류가 감지되면 오류 메시지가 표시됩니다. 또한, 보고서 또는 대시보드 유형의 기존 웹 애플릿, 웹 탭 또는 웹 링크 필드를 편집하는 경우 및 필드를 변경하는 경우 변경사항을 저장하려고 하면 [매개변수] 필드를 포함한 모든 필드가 검증됩니다. 오류가 감지되면 해당 오류를 수정해야 합니다.

다음 섹션에서는 필터를 구성하는 매개변수에 대해 설명합니다.

연산자

다음 표에는 필터에서 사용할 수 있는 연산자가 나와 있습니다.

연산자

설명

eq

같거나 포함됨

neq

같지 않거나 포함 안됨

lt

보다 작음

gt

보다 큼

ge

이상

le

이하

bwith

시작 문자

ewith

끝 문자

cany

다음 중 하나 포함. 값 매개변수에는 각각 더하기 기호(+)로 구분된 여러 개의 값이 포함될 수 있습니다. Pn 구문을 사용하는 경우 값 리스트 시작 부분에 값 개수를 지정해야 합니다. opn 구문을 사용하는 경우 값 개수를 지정하지 마십시오. 지정하면 Oracle CRM On Demand에서 지정된 개수를 또 하나의 값으로 가정합니다.

예를 들어 고객사 지역 동부, 서부 및 중부(즉, 3개 지역)를 찾는 경우 구문은 다음과 같습니다.

P0=1&P1=cany&P2="Account"."Account Region"&P3=3+East+West+Central

또는

op1=cany&col1="Account"."Account Region"&val1=East+West+Central

call

다음을 모두 포함. 값 매개변수에는 각각 더하기 기호(+)로 구분된 여러 개의 값이 포함될 수 있습니다. Pn 구문을 사용하는 경우 값 리스트 시작 부분에 값 개수를 지정해야 합니다. opn 구문을 사용하는 경우 값 개수를 지정하지 마십시오. 지정하면 Oracle CRM On Demand에서 지정된 개수를 또 하나의 값으로 가정합니다.

like

다음과 유사. 값 매개변수에 값이 있어야 합니다. 값 문자열은 와일드카드 %(퍼센트 기호)로 끝나야 합니다. 그러지 않으면 like 연산자가 문자열과 정확히 일치하는 항목만 반환합니다. 퍼센트 기호는 %25로 인코딩되어야 합니다.

예를 들어, Acme와 유사한 고객사 이름을 찾으려면 다음과 같이 입력합니다.

P0=1&P1=like&P2="Account"."Account Name"&P3=Acme%25

또는

op1=like&col1="Account"."Account Name"&val1=Acme%25

top

상위 n개 항목. 예를 들어, 상위 6개 매출 수익을 찾으려면 다음과 같이 입력합니다.

P0=1&P1=top&P2="Account"."Account Revenue"&P3=6

또는

op1=top&col1="Account"."Account Revenue"&val1=6

bottom

하위 n개 항목. 예를 들어, 하위 4개 매출 수익을 찾으려면 다음과 같이 입력합니다.

P0=1&P1=bottom&P2="Account"."Account Revenue"&P3=4

또는

op1=bottom&col1="Account"."Account Revenue"&val1=4

bet

범위. 값 매개변수에는 더하기 기호(+)로 구분된 2개의 값이 있어야 합니다. Pn 구문을 사용하는 경우 값 리스트 시작 부분에 값 개수(2)를 지정해야 합니다. opn 구문을 사용하는 경우 값 개수를 지정하지 마십시오. 지정하면 Oracle CRM On Demand에서 지정된 개수를 또 하나의 값으로 가정합니다.

예를 들어 100,000에서 500,000 사이의 고객사 매출을 필터링하려는 경우 구문은 다음과 같습니다.

P0=1&P1=bet&P2="Account"."Account Revenue"&P3=2+100000+500000

또는

op1=bet&col1="Account"."Account Revenue"&val1=100000+500000

null

Null임. 값 매개변수는 0이어야 하며 생략될 수 없습니다.

nnull

Null 아님. 값 매개변수는 0이어야 하며 생략될 수 없습니다.

열을 지정할 때 다음 사항에 유의하십시오.

  • 테이블 이름 및 열 이름을 마침표(.)로 구분하여 둘 다 지정해야 합니다.
  • 테이블 이름이나 열 이름에 공백이 포함된 경우 해당 이름을 큰따옴표로 묶어야 합니다. 테이블 이름이나 열 이름에 공백이 포함되지 않은 경우 이름을 큰따옴표로 묶을 필요가 없으나 원하는 경우 큰따옴표로 묶을 수 있습니다. 이는 구문 유형 둘 다에 적용됩니다. 예를 들어 다음 구문은 모두 유효합니다.

    "Account"."Account Name"

    "Service Request".Area

    Account."Account Name"

  • 표시 이름이 아니라 원래 열 이름을 사용해야 합니다.

필터 값을 지정하는 경우 다음 사항에 유의하십시오.

  • 값을 직접 지정하거나 필드를 매개변수로 지정할 수 있습니다.
  • opn 구문을 사용하는 경우 및 공백이 포함된 값을 직접 지정하는 경우 값을 큰따옴표로 묶어야 합니다. 2개 이상의 값이 지정된 경우 및 값 중 하나에 공백이 포함되어 있는 경우 다음의 예와 같이 각 지정된 값을 큰따옴표로 묶어야 합니다.

    val1="New York"+"Alabama"+"California"

    Pn 구문을 사용하는 경우 공백이 포함된 값을 큰따옴표로 묶을 필요가 없습니다.

  • 필터 매개변수에 사용자 또는 시스템 필드를 포함하려면 [매개변수] 필드에서 매개변수를 추가할 위치에 커서를 놓은 다음 [사용자 및 시스템 필드] 리스트에서 포함할 필드를 선택합니다.

    매개변수에 사용할 수 있는 사용자 및 시스템 필드에 대한 자세한 내용은 사용자 및 시스템 필드를 참조하십시오.

  • (레코드 유형 세부 사항 페이지에 대한 웹 애플릿만 해당 및 웹 링크) 필터 매개변수에 레코드 유형의 필드를 포함하려면 [매개변수] 필드에서 필드를 추가할 위치에 커서를 놓고 [레코드 유형 필드] 리스트에서 필드를 선택합니다. 여기서 레코드 유형은 애플릿을 생성할 레코드 유형의 이름입니다.

    예를 들어, [레코드 유형 필드] 리스트에서 [행 ID] 필드를 선택하면 %%%Row_Id%%%가 삽입됩니다. 런타임에 %%%Row_Id%%%는 현재 레코드의 행 ID로 교체됩니다.

참고: 보고서 또는 대시보드의 URL은 런타임에 생성됩니다. 보고서 또는 대시보드의 URL 길이는 런타임 시 필터 URL에 전달되는 값에 따라 달라집니다. 각 브라우저에는 최대 URL 길이가 지정되어 있습니다. 보고서 또는 대시보드의 URL이 이 길이를 초과할 경우 사용자가 해당 보고서나 대시보드를 보려고 하면 브라우저에서 예기치 않은 동작이 발생합니다.

참고: 웹 애플릿, 탭 또는 링크에 포함된 보고서 또는 대시보드의 매개변수를 지정하는 것과 동일한 방식으로 분석에 대해 예약된 이벤트의 전자메일 보내기 작업에서 보고서, 대시보드 또는 대시보드 페이지의 매개변수를 지정할 수 있습니다. 하지만 전자메일 보내기 작업에서 매개변수 값으로 지정할 필드를 선택할 수는 없습니다. 분석에 대해 예약된 이벤트를 설정하는 방법에 대한 자세한 내용은 분석에 대해 예약된 이벤트 생성을 참조하십시오.


2020년 3월 게시됨 Copyright © 2005, 2020, Oracle. All rights reserved. Legal Notices.