뷰 URL 구조
Tableau Server 2022.3 이상 및 Tableau Cloud의 내장 코드가 Embedding API v3을 사용하도록 변경되었습니다. Embedding API v3을 사용하면 내장할 때 필터링할 URL을 보기 위해 더 이상 매개 변수를 추가하지 않아도 됩니다. 대신 필터 웹 구성 요소에 특성을 추가하여 필터링하면 됩니다. 자세한 내용은 Embedding API 도움말에서 뷰 필터링(영문)을 참조하십시오. 본 항목의 정보는 이전 버전의 Embedding(Tableau JavaScript API v1 및 v2 사용)에 대한 것입니다.
Tableau가 뷰 URL을 구조화하는 방식을 이해하기 위해 브라우저 주소 표시줄의 예를 자세히 살펴보겠습니다.
기본 URL의 구조
- Tableau Server 또는 Tableau Cloud에서 Tableau 뷰의 기본적인 URL 패턴은 다음과 같습니다.
http://<servername>/#/views/<workbook>/<sheet>
- 다중 사이트 환경에서 기본 사이트 이외의 사이트에 저장된 뷰의 경우 사이트의 ID도 URL에 포함됩니다.
http://<servername>/#/site/<sitename>/views/<workbook>/<sheet>
기본 URL에 매개 변수 추가
쿼리 문자열 추가
필터링 URL을 만들려면 기본 URL에 쿼리 문자열을 추가합니다. 쿼리 문자열에서 뷰 필터는 매개 변수입니다. 쿼리 문자열을 작성하려면:
- 물음표(
?
)로 쿼리 문자열을 시작합니다. - 앰퍼샌드(
&
)를 사용하여 매개 변수를 구분합니다. - 쉼표(
,
)를 사용하여 한 매개 변수의 여러 값을 구분합니다.
예를 들면 다음과 같습니다.http://<servername>/#/views/<workbook>/sheet?param1=value1,value2¶m2=value
또한 필드 또는 시트 이름에서 URL에 표시할 수 없는 모든 문자는 URL로 인코딩됩니다. 예를 들어 공백은 %20
으로 변환됩니다.
참고: URL 매개 변수를 추가하기 전에 URL 끝에 있는 :iid=[#]
을 제거합니다. 이 코드는 현재 브라우저 세션의 임시 뷰 카운터입니다.
필드명의 대/소문자 반영
URL 매개 변수는 대/소문자를 구분합니다. 쿼리 문자열을 추가할 때 원본 데이터에 있는 필드명의 대/소문자를 정확하게 반영해야 합니다.
쿼리 문자열이 대시보드에 미치는 영향
때때로 하나의 시트에만 영향을 미치는 대시보드의 표시 필터와 달리 URL 매개 변수는 모든 시트에 적용됩니다. URL 매개 변수를 추가하기 전에 각 시트에 표시된 필드를 숙지하여 유지하려는 데이터를 실수로 필터링하지 않도록 주의합니다.
작업에 사용할 예제 뷰 선택
이 문서의 예에서는 Tableau Server와 함께 제공되는 Superstore 샘플 데이터의 Performance(성능) 뷰를 사용합니다.
예제 URL에는 다음 특성이 반영됩니다.
- 시트 이름은 Performance입니다.
- 통합 문서 이름은 Superstore입니다.
- 서버 이름은 자리 표시자 IP 주소를 사용하여 나타내는데, 여기에는 온프레미스 서버 이름 또는
online.tableau.com
이 표시됩니다.
예제를 따라 진행하려면 Superstore에서 유사한 뷰를 살펴보거나, 사용자 환경의 필드, 시트 및 기타 이름을 사용하도록 예제 URL을 조정하면 됩니다. 고유한 뷰를 사용하는 경우 먼저 서버에 뷰를 게시해야 합니다.
뷰 필터링
이 문서에서 사용하는 예제 뷰의 기본 URL은 다음과 같습니다.http:<servername>/#/views/Superstore/Performance
Furniture만
Furniture의 매출만 표시하려면 URL의 끝에 다음 쿼리 문자열을 추가합니다.?Category=Furniture
예:http:<servername>/#/views/Superstore/Performance?Category=Furniture
Consumer만
Consumer 매출만 표시하도록 뷰를 제한하려면 URL을 다음과 같이 변경합니다.http:<servername>/#/views/Superstore/Performance?Segment=Consumer
Home Office 및 Consumer
Home Office 매출과 Consumer 매출을 모두 표시하려면 URL을 다음과 같이 변경합니다.http:<servername>/#/views/Superstore/Performance?Segment=Home%20Office,Consumer
필드명 "Home Office"에서 %20은 기본 URL에 매개 변수 추가에서 설명한 것처럼 URL로 인코딩된 공백 문자를 나타냅니다.
여기서 한 매개 변수의 여러 값은 공백이 아니라 쉼표로 구분되어 있습니다.
Central의 Furniture
필드/값 쌍을 여러 개 표시하려면 앰퍼샌드로 구분합니다.http:<servername>/#/views/Superstore/Performance?Region=Central&Category=Furniture
제외 필터링
지금까지 이 문서에서 설명한 예제에서는 모든 필드 값이 결과 뷰에 표시되었습니다. 특정 필터에 대해 여러 개의 값을 지정하고 해당 값의 특정한 교집합만 표시하는 추가 매개 변수를 포함하면 좀 더 유연하게 값을 표시할 수 있습니다.
다음 URL은 이 예에 사용된 필터링되지 않은 기본 뷰를 나타내며, 지역별 부서 매출이 나와 있습니다.http://<servername>/#/views/Superstore/Performance
다음으로, Central 지역과 West 지역의 Furniture 부서 및 Technology 부서 매출만 표시하려면 기본 URL에 다음 쿼리 문자열을 추가합니다.?Region=Central,West&Category=Furniture,Technology
Central(중부) 지역의 Furniture(가구) 매출과 West(서부) 지역의 Technology(기술) 매출만 표시하려면 쿼리 문자열에 ~s0
매개 변수를 추가합니다.?Region~s0=Central,West&Category~s0=Furniture,Technology
최종 URL은 다음과 같습니다.http://<servername>/#/views/Superstore/Performance?Region~s0=Central,West&Category~s0=Furniture,Technology
날짜 필터링에 대해 특별히 고려해야 할 사항
날짜 필드를 필터링하려면 데이터베이스 환경에서의 날짜 형식과 동작을 고려해야 합니다.
- URL 매개 변수를 통해 전달되는 날짜(및 시간) 값은 다음 Tableau 기본 형식과 일치해야 합니다.
yyyy-mm-dd hh:mm:ss
- 날짜를 날짜/시간 값으로 저장하는 데이터베이스가 많으므로 매개 변수에 입력하는 값에 시간 부분을 포함해야 할 수 있습니다. 시간 부분은 24시간 형식을 기준으로 하므로 오후 10시 18분은 22:18:00으로 지정됩니다.
예제 날짜 매개 변수
다음 예제 쿼리 문자열에서는 Order Date라는 날짜 필드가 사용됩니다. 이 문서의 이전 예제와 마찬가지로 뷰의 기본 URL에 이러한 쿼리 문자열을 추가합니다.
- Order Date(주문 날짜) 필드 유형에 시간 없이 날짜만 포함되고 2018년 7월 8일 일요일에 대한 데이터만 표시하려는 경우 쿼리 문자열은 다음과 같습니다.
?Order%20Date=2018-07-08
- Order Date(주문 날짜)에 시간 부분이 포함되고 2018년 7월 8일 일요일 오후 10시 18분을 기준으로 필터링하려는 경우 쿼리 문자열은 다음과 같습니다.
?Order%20Date=2018-07-08%2022:18:00
- Order Date에 날짜만 있고 여러 날짜를 기준으로 필터링하려는 경우에는 이 문서의 앞부분에서 설명한 대로 쉼표를 사용합니다. 예를 들면 다음과 같습니다.
?Order%20Date=2018-07-08,2018-07-09,2018-07-10,2018-07-11
매개 변수를 DATEPART 필터로 사용
날짜 부분을 기준으로 필터링하려면 기본 Tableau Desktop 날짜 계층의 경우와 동일한 명명법을 사용합니다. 자세한 내용은 Tableau 도움말에서 날짜 함수(링크가 새 창에서 열림)를 참조하십시오.
year(Order%20Date) | 정수 |
quarter(Order%20Date) | 1과 4 사이의 정수 |
month(Order%20Date) | 1과 12 사이의 정수 |
day(Order%20Date) | 1과 31 사이의 정수 |
hour(Order%20Date) | 0과 23 사이의 정수 |
minute(Order%20Date) | 0과 59 사이의 정수 |
second(Order%20Date) | 0과 59 사이의 정수 |
week(Order%20Date) | 1과 53 사이의 정수 |
my(Order%20Date) | 6자리 정수: YYYYMM |
mdy(Order%20Date) | 8자리 정수: YYYYMMDD |