뷰의 내장 코드 매개 변수
Tableau Server 2022.3 이상 및 Tableau Cloud의 내장 코드가 Embedding API v3을 사용하도록 변경되었습니다. Embedding API v3의 현재 클래스 및 메서드 목록은 Embedding API 도움말에서 Embedding API 참조서(영문)를 참조하십시오. 본 항목의 정보는 이전 버전의 Embedding(Tableau JavaScript API v1 및 v2 사용)에 대한 것입니다.
이전 버전의 Embedding용 매개 변수
다음과 같은 방법 중 하나를 사용하여 내장 뷰를 구성할 수 있습니다.
JavaScript 태그의 개체 매개 변수
| 개체 매개 변수 | 값 | 설명 | 예 |
|---|---|---|---|
dataDetails | no | 툴바에서 뷰에 사용된 데이터의 세부 정보를 표시하는 데이터 세부 정보 단추를 숨깁니다. | <param name='dataDetails' value='no' /> |
showDataDetails | yes | Tableau Catalog가 사용되는 경우 데이터 세부 정보 패널이 열린 상태로 뷰가 표시됩니다. | <param name='showDataDetails' value='yes' /> |
alerts | no | 툴바에서 사용자가 데이터 기반 알림을 만들 수 있게 해 주는 알림 단추를 숨깁니다. | <param name='alerts' value='no'/> |
customViews | no | 툴바에서 사용자가 사용자 지정 뷰를 저장할 수 있게 해 주는 뷰 단추를 숨깁니다. | <param name='customViews' value='no'/> |
device | desktop; tablet; phone | 대시보드에 휴대기기를 위한 레이아웃이 있는 경우 화면 크기에 관계없이 특정 레이아웃을 표시합니다. 이 매개 변수가 설정되어 있지 않으면 Tableau Server 또는 Tableau Cloud에서 화면 크기를 감지하여 해당하는 레이아웃을 로드합니다. 예제에 대해서는 대시보드 내장을 참조하십시오. | <param name='device' value='phone'/> |
filter | 문자열 | 뷰가 열릴 때 표시되는 데이터를 필터링합니다. URL 매개 변수를 사용하여 필터링할 수도 있습니다. | <param name='filter' value='Team=Blue'/> |
host_url | 문자열 | 필수 항목입니다. URL에 나타나는 서버 이름입니다. | <param name='host_url' value='http://myserver.exampleco.com/'>
|
linktarget | 문자열 | 외부 하이퍼링크에 대한 대상 창 이름입니다. | <param name="linktarget" value="_blank"/> |
load-order | 숫자 | 다중 뷰가 내장된 경우 페이지에서 뷰가 로드되는 순서를 결정합니다. 음수가 허용됩니다. | <param name="load-order" value="2"/> |
mobile | yes | 모바일 장치에 맞게 터치 방식에 최적화된 퀵 필터를 표시합니다. | <param
name='mobile' value='yes'/> |
name | 문자열 | 이 구조에 필요한 개체 매개 변수: [workbook name]/[sheet name]/[optional custom view name] 선택적 사용자 지정 뷰 이름 형식: username@domain/[custom view name] | <param name='name' value='ExampleCoSales/Sales'/>
|
:original_view | yes | name 변수가 통합 문서, 또는 이 매개 변수가 포함된 시트 URL을 참조하고 사용자 지정 뷰를 명시적으로 참조하지 않는 경우 해당 뷰를 원래 뷰로 표시합니다. | <param name='filter' value=':original_view=yes'/> |
path(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.) | 문자열 | 신뢰할 수 있는 인증 전용인 경우 ticket 매개 변수와 함께 사용할 수 없습니다. name수의 값을 재정의하며, URL로 사용됩니다. 자세한 내용은 Tableau Server 관리자 도움말에서 티켓을 사용하여 뷰 표시(링크가 새 창에서 열림)를 참조하십시오. | <param name='path' value='trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4'/>
|
showShareOptions | true; false | 내장된 뷰에 공유 옵션을 표시할지 여부를 제어합니다. | <param name='showShareOptions' value='true' /> |
site_root | 문자열 | 필수 항목입니다. 사이트 이름입니다. 기본 사이트 값은 Null(value='')입니다. 서버가 다중 사이트 서버인 경우 신뢰할 수 있는 인증을 사용하려면 Tableau Server 도움말에서 티켓을 사용하여 뷰 표시(링크가 새 창에서 열림)를 참조하십시오. | <param name='site_root' value='/#/Sales'/>
|
subscriptions | no | 툴바에서 사용자가 정기적인 간격으로 뷰의 스냅샷을 받기 위해 이메일 구독을 설정할 수 있게 해 주는 구독 단추를 숨깁니다. |
|
tabs | yes; no | 탭을 표시하거나 숨깁니다. | <param name='tabs' value='yes'/> |
ticket(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.) | 문자열 | 신뢰할 수 있는 인증 전용인 경우 path매개 변수와 함께 사용할 수 없습니다. 신뢰할 수 있는 티켓 상환 URL을 생성하려면 name 개체와 함께 사용해야 합니다. 자세한 내용은 Tableau Server 도움말에서 티켓을 사용하여 뷰 표시(링크가 새 창에서 열림)를 참조하십시오. | <param name='ticket' value='9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5'/>
|
toolbar | yes; no; top | 툴바는 기본적으로 아래쪽에 표시됩니다. 이 매개 변수를 top으로 설정하면 툴바가 뷰 위쪽에 배치되고 no로 설정하면 내장된 뷰에서 툴바가 제거됩니다. | <param name='toolbar' value='top'/> |
tooltip | yes; no | 도구 설명은 기본적으로 표시되지만 이 매개 변수를 no로 설정하면 내장된 뷰에서 도구 설명이 제거됩니다. | <param name='tooltip' value='no'/> |
iframe 태그의 URL 매개 변수
참고: URL 매개 변수를 추가하기 전에 URL 끝에 있는 :iid=[#]을 제거합니다. 이 코드는 현재 브라우저 세션의 임시 뷰 카운터입니다.
| URL 매개 변수 | 값 | 설명 | 예 |
|---|---|---|---|
:dataDetails | no | 툴바에서 뷰에 사용된 데이터의 세부 정보를 표시하는 데이터 세부 정보 단추를 숨깁니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:dataDetails=no |
:showDataDetails | yes | Tableau Catalog가 사용되는 경우 데이터 세부 정보 패널이 열린 상태로 뷰가 표시됩니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showDataDetails=yes |
:alerts | no | 내장된 뷰에서 알림 단추를 숨깁니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:alerts=no |
:customViews | no | 내 변경 내용 저장 옵션입니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:customViews=no |
:device | desktop; tablet; phone | 대시보드에 휴대기기를 위한 레이아웃이 있는 경우 화면 크기에 관계없이 특정 레이아웃을 표시합니다. 이 매개 변수가 설정되어 있지 않으면 Tableau Server 또는 Tableau Cloud에서 화면 크기를 감지하여 해당하는 레이아웃을 로드합니다. 예제에 대해서는 대시보드 내장을 참조하십시오. | http://tabserver/views/sales/sales_dashboard?:device=tablet |
:display_count(Tableau Public만 해당) | yes | 왼쪽 아래에서 Tableau 로고를 클릭하면 총 페이지뷰 수가 표시됩니다. | https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:display_count=yes |
:embed | yes | 필수 URL 매개 변수입니다. 맨 위 탐색 영역을 숨겨 웹 페이지에 뷰 통합을 향상시킵니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes |
:format | pdf; png | 뷰를 PDF 또는 .png 파일로 표시합니다. | http://tabserver/views/Sales/Q2?:format=pdf |
:highdpi | false | 고해상도 디스플레이 및 기기를 위해 표준 DPI(Dots Per Inch)를 사용하여 뷰를 렌더링합니다. | http://tableauserver/views/Sales/Q2?:highdpi=false |
:linktarget | 문자열 | 외부 하이퍼링크에 대한 대상 창 이름입니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:linktarget=_blank |
:openid_hd | 문자열 | OpenID Connect로 인증할 때 사용됩니다. 사용자가 속한 호스팅된 도메인을 지정합니다. 예를 들어 도메인 선택 패널을 렌더링하지 않으려는 경우 이 옵션을 사용할 수 있습니다. :openid_login_hint와 함께 전체 사용자 식별자를 지정하는 데 사용됩니다. | http://tabserver/views/Sales/Q2?:openid_hd=example.com |
:openid_login_hint | 문자열 | OpenID Connect로 인증할 때 사용됩니다. 전체 사용자 식별자(이메일 주소)를 지정합니다. :openid_hd와 함께 사용자가 속한 호스팅된 도메인을 지정하는 데 사용됩니다. | http://tabserver/views/Sales/Q2?:openid_login_hint=tara@example.com |
:record_performance(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.) | yes | 뷰의 성능 기록을 시작합니다. 이 매개 변수를 URL 끝에 있는 세션 ID(:iid=<n>) 바로 앞에 추가합니다. 자세한 내용은 Tableau Server 도움말에서 성능 기록 만들기(링크가 새 창에서 열림)를 참조하십시오. | http://tabserver/views/Sales2013/Regions?:recordperformance=yes |
:refresh | yes | Tableau Server 또는 Tableau Cloud의 최신 데이터를 사용하여 뷰를 렌더링합니다. 팁: 뷰를 지속적으로 새로 고치려면 웹 페이지의 | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:refresh=yes |
:render | true; false; 숫자 | 클라이언트 쪽 렌더링이 사용으로 설정된 경우(기본값) 이 매개 변수를 false로 설정하면 세션에 대해 서버 쪽 렌더링을 사용하도록 설정됩니다. true로 설정하면 세션에 대해 클라이언트 쪽 렌더링이 강제 수행됩니다.1에서 100까지의 숫자를 입력하여 복잡성 임계값을 설정할 수 있으며, 이 값을 넘으면 뷰가 서버에서 렌더링됩니다. 자세한 내용은 Tableau Server 도움말에서클라이언트 쪽 렌더링 정보(링크가 새 창에서 열림)를 참조하십시오. | http://tabserver/views/Date-Time/DateCalcs?:render=false |
:revert | all; filters; sorts; axes; shelves | 항목을 원래 상태로 되돌립니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:revert=all |
:showAppBanner | false | 모바일 웹 브라우저에서 “Tableau Mobile에서 열기” 배너를 숨깁니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showAppBanner=false |
:showAskData | false | 내장된 뷰의 툴바에서 데이터에 질문 단추를 숨 깁니다. 기본적으로 데이터에 질문 단추가 표시됩니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showAskData=false |
:showShareOptions | true; false | 내장된 뷰에 공유 옵션을 표시할지 여부를 제어합니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:showShareOptions=true |
:showVizHome(Tableau Public만 해당) | yes; no | Tableau Public의 콘텐츠 탐색 인터페이스를 표시하거나 숨깁니다. 다른 웹 페이지에 비주얼리제이션을 내장할 경우 no로 설정하십시오. | https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:showVizHome=no |
:subscriptions | no | 내장된 뷰에서 구독 단추를 숨깁니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:subscriptions=no |
:tabs | yes; no | 탭을 표시하거나 숨깁니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:tabs=no |
:toolbar | yes; no; top | 이 매개 변수가 설정되지 않은 경우 기본적으로 아래쪽에 툴바가 표시됩니다. no인 경우 내장된 뷰에서 툴바가 제외됩니다. top인 경우 뷰 위쪽에 툴바가 배치됩니다. | http://tabserver/views/Date-Time/DateCalcs?:embed=yes&:toolbar=no |
:tooltip | yes; no | 이 매개 변수가 설정되지 않은 경우 기본적으로 뷰에 도구 설명이 표시됩니다. no로 설정되어 있으면 내장된 뷰에서 도구 설명이 제외됩니다. | http://tabserver/views/workbookQ4/SalesQ4?:embed=yes&:tooltip=no |