---
schema_version: "1"
id: d9aef2f303a0835764aa0c370e8950cbdfbfee6b2d2c537405284fe948894d54
title: 뷰의 내장 코드 매개 변수
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/pro/desktop/embed_list.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/ko-kr/embed_list.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f66d0f707f44acb610e512186329028aea20273d732a2aed5abdc539c3860afd
description: Tableau Server 2022
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 뷰의 내장 코드 매개 변수

> [!TIP]
> 
> Tableau Server 2022.3 이상 및 Tableau Cloud의 내장 코드가 Embedding API v3을 사용하도록 변경되었습니다. Embedding API v3의 현재 클래스 및 메서드 목록은 [Embedding API 도움말](https://help.tableau.com/current/api/embedding_api/en-us/index.html)에서 [Embedding API 참조서(영문)](https://help.tableau.com/current/api/embedding_api/ko-kr/reference/index.html)를 참조하십시오. 본 항목의 정보는 이전 버전의 Embedding(Tableau JavaScript API v1 및 v2 사용)에 대한 것입니다.

이전 버전의 Embedding용 매개 변수

다음과 같은 방법 중 하나를 사용하여 내장 뷰를 구성할 수 있습니다.

- [JavaScript 태그의 개체 매개 변수](#Object_params)
- [iframe 태그의 URL 매개 변수](#URL_params)

## JavaScript 태그의 개체 매개 변수

<table class="table--plain"><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th>개체 매개 변수</th><th>값</th><th>설명</th><th>예</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>dataDetails</code></td><td><code>no</code></td><td>툴바에서 뷰에 사용된 데이터의 세부 정보를 표시하는 데이터 세부 정보 단추를 숨깁니다.</td><td><code>&lt;param name='dataDetails' value='no' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>showDataDetails</code></td><td><code>yes</code></td><td>Tableau Catalog가 사용되는 경우 데이터 세부 정보 패널이 열린 상태로 뷰가 표시됩니다.</td><td><code>&lt;param name='showDataDetails' value='yes' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>alerts</code></td><td><code>no</code></td><td>툴바에서 사용자가 데이터 기반 알림을 만들 수 있게 해 주는 알림 단추를 숨깁니다.</td><td><code>&lt;param name='alerts' value='no'/&gt;</code><br></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>customViews</code></td><td><code>no</code></td><td>툴바에서 사용자가 사용자 지정 뷰를 저장할 수 있게 해 주는 뷰 단추를 숨깁니다.</td><td><code>&lt;param name='customViews' value='no'/&gt;</code><br></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>device</code></td><td><code>desktop; tablet; phone</code></td><td>대시보드에 휴대기기를 위한 레이아웃이 있는 경우 화면 크기에 관계없이 특정 레이아웃을 표시합니다. 이 매개 변수가 설정되어 있지 않으면 Tableau Server 또는 Tableau Cloud에서 화면 크기를 감지하여 해당하는 레이아웃을 로드합니다. 예제에 대해서는 <a href="https://help.tableau.com/v0.0/pro/desktop/ko-kr/embed_dashboard.htm" class="xref">대시보드 내장</a>을 참조하십시오.</td><td><code>&lt;param name='device' value='phone'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>filter</code></td><td>문자열</td><td>뷰가 열릴 때 표시되는 데이터를 필터링합니다. URL 매개 변수를 사용하여 필터링할 수도 있습니다.</td><td><code>&lt;param name='filter' value='Team=Blue'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>host_url</code></td><td>문자열</td><td>필수 항목입니다. URL에 나타나는 서버 이름입니다.</td><td><code>&lt;param name='host_url' value='http://myserver.exampleco.com/'&gt;</code><p><code>&lt;param name="host_url" value="http://localhost/"&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>linktarget</code></td><td>문자열</td><td>외부 하이퍼링크에 대한 대상 창 이름입니다.</td><td><code>&lt;param name="linktarget" value="_blank"/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>load-order</code></td><td>숫자</td><td>다중 뷰가 내장된 경우 페이지에서 뷰가 로드되는 순서를 결정합니다. 음수가 허용됩니다.</td><td><code>&lt;param name="load-order" value="2"/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>mobile</code></td><td><code>yes</code></td><td>모바일 장치에 맞게 터치 방식에 최적화된 퀵 필터를 표시합니다.</td><td><code>&lt;param
						name='mobile' value='yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>name</code></td><td>문자열</td><td>이 구조에 필요한 개체 매개 변수: [workbook name]/[sheet name]/[optional custom view name]<p> 선택적 사용자 지정 뷰 이름 형식: username@domain/[custom view name]<br><br>Tableau Server 또는 Tableau Cloud URL을 참조하여 <code>name</code>의 값을 확인하는 경우 URL의 끝 부분에 있는 세션 ID(<code>:iid=<i>&lt;n&gt;</i></code>)를 제외합니다.</p></td><td><code>&lt;param name='name' value='ExampleCoSales/Sales'/&gt;</code><p><code>&lt;param
name='name' value='ExampleCoSales/Sales/jsmith@example.com/EastRegionSales'/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:original_view</code></td><td><code>yes</code></td><td><code>name</code> 변수가 통합 문서, 또는 이 매개 변수가 포함된 시트 URL을 참조하고 사용자 지정 뷰를 명시적으로 참조하지 않는 경우 해당 뷰를 원래 뷰로 표시합니다.</td><td><code>&lt;param name='filter' value=':original_view=yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>path</code><p>(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.)</p></td><td>문자열</td><td>신뢰할 수 있는 인증 전용인 경우 <code>ticket</code> 매개 변수와 함께 사용할 수 없습니다. <code>name</code>수의 값을 재정의하며, URL로 사용됩니다. 자세한 내용은 Tableau Server 관리자 도움말에서 <a href="https://help.tableau.com/current/server/ko-kr/trusted_auth_webURL.htm" target="_blank">티켓을 사용하여 뷰 표시</a>를 참조하십시오.</td><td><code>&lt;param name='path' value='trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4'/&gt;</code><p><code>http://tableauserver/trusted/Etdpsm_Ew6rJY-9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>showShareOptions</code></td><td><code>true</code>; <code>false</code></td><td>내장된 뷰에 공유 옵션을 표시할지 여부를 제어합니다.</td><td><code>&lt;param name='showShareOptions' value='true' /&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>site_root</code></td><td>문자열</td><td>필수 항목입니다. 사이트 이름입니다. 기본 사이트 값은 Null(<code>value=''</code>)입니다. 서버가 다중 사이트 서버인 경우 신뢰할 수 있는 인증을 사용하려면 Tableau Server 도움말에서 <a href="https://help.tableau.com/current/server/ko-kr/trusted_auth_webURL.htm" target="_blank">티켓을 사용하여 뷰 표시</a>를 참조하십시오.</td><td><code>&lt;param name='site_root' value='/#/Sales'/&gt;</code><p><code>&lt;param name='site_root' value=''/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>subscriptions</code></td><td><code>no</code></td><td>툴바에서 사용자가 정기적인 간격으로 뷰의 스냅샷을 받기 위해 이메일 구독을 설정할 수 있게 해 주는 구독 단추를 숨깁니다.</td><td><p><code>&lt;param name='subscriptions' value='no'/&gt;</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>tabs</code></td><td><code>yes; no</code></td><td>탭을 표시하거나 숨깁니다.</td><td><code>&lt;param name='tabs' value='yes'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>ticket</code><p>(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.)</p></td><td>문자열</td><td>신뢰할 수 있는 인증 전용인 경우 <code>path</code>매개 변수와 함께 사용할 수 없습니다. 신뢰할 수 있는 티켓 상환 URL을 생성하려면 <code>name</code> 개체와 함께 사용해야 합니다. 자세한 내용은 Tableau Server 도움말에서 <a href="https://help.tableau.com/current/server/ko-kr/trusted_auth_webURL.htm" target="_blank">티켓을 사용하여 뷰 표시</a>를 참조하십시오.</td><td><code>&lt;param name='ticket' value='9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5'/&gt;</code><p><code>http://tableauserver/trusted/9D1ObyqDQmSIOyQpKdy4Sw==:dg62gCsSE0QRArXNTOp6mlJ5/views/workbookQ4/SalesQ4?:embed=yes&amp;:tabs=yes</code></p></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>toolbar</code></td><td><code>yes; no; top</code></td><td>툴바는 기본적으로 아래쪽에 표시됩니다. 이 매개 변수를 <code>top</code>으로 설정하면 툴바가 뷰 위쪽에 배치되고 <code>no</code>로 설정하면 내장된 뷰에서 툴바가 제거됩니다.</td><td><code>&lt;param name='toolbar' value='top'/&gt;</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>tooltip</code></td><td><code>yes; no</code></td><td>도구 설명은 기본적으로 표시되지만 이 매개 변수를 <code>no</code>로 설정하면 내장된 뷰에서 도구 설명이 제거됩니다.</td><td><code>&lt;param name='tooltip' value='no'/&gt;</code></td></tr></tbody></table>

## iframe 태그의 URL 매개 변수

참고: URL 매개 변수를 추가하기 전에 URL 끝에 있는 `:iid=[#]`을 제거합니다. 이 코드는 현재 브라우저 세션의 임시 뷰 카운터입니다.

<table class="table--plain"><colgroup><col><col style="width: 101px;"><col><col></colgroup><thead><tr class="TableStyle-Basic-Border-Head-Header1"><th>URL 매개 변수</th><th>값</th><th>설명</th><th>예</th></tr></thead><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:dataDetails</code></td><td><code>no</code></td><td>툴바에서 뷰에 사용된 데이터의 세부 정보를 표시하는 데이터 세부 정보 단추를 숨깁니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:dataDetails=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showDataDetails</code></td><td><code>yes</code></td><td>Tableau Catalog가 사용되는 경우 데이터 세부 정보 패널이 열린 상태로 뷰가 표시됩니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showDataDetails=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:alerts</code></td><td><code>no</code></td><td>내장된 뷰에서 알림 단추를 숨깁니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:alerts=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:customViews</code></td><td><code>no</code></td><td><span class="uicontrol">내 변경 내용 저장</span> 옵션입니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:customViews=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:device</code></td><td><code>desktop; tablet; phone</code></td><td>대시보드에 휴대기기를 위한 레이아웃이 있는 경우 화면 크기에 관계없이 특정 레이아웃을 표시합니다. 이 매개 변수가 설정되어 있지 않으면 Tableau Server 또는 Tableau Cloud에서 화면 크기를 감지하여 해당하는 레이아웃을 로드합니다. 예제에 대해서는 <a href="https://help.tableau.com/v0.0/pro/desktop/ko-kr/embed_dashboard.htm" class="xref">대시보드 내장</a>을 참조하십시오.</td><td><code>http://tabserver/views/sales/sales_dashboard?:device=tablet</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:display_count</code><p>(Tableau Public만 해당)</p></td><td><code>yes</code></td><td>왼쪽 아래에서 Tableau 로고를 클릭하면 총 페이지뷰 수가 표시됩니다.</td><td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:display_count=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:embed</code></td><td><code>yes</code></td><td>필수 URL 매개 변수입니다. 맨 위 탐색 영역을 숨겨 웹 페이지에 뷰 통합을 향상시킵니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:format</code></td><td><code>pdf; png</code></td><td>뷰를 PDF 또는 .png 파일로 표시합니다.</td><td><code>http://tabserver/views/Sales/Q2?:format=pdf</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:highdpi</code></td><td><code>false</code></td><td>고해상도 디스플레이 및 기기를 위해 표준 DPI(Dots Per Inch)를 사용하여 뷰를 렌더링합니다.</td><td><code>http://tableauserver/views/Sales/Q2?:highdpi=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:linktarget</code></td><td>문자열</td><td>외부 하이퍼링크에 대한 대상 창 이름입니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:linktarget=_blank</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:openid_hd</code></td><td>문자열</td><td>OpenID Connect로 인증할 때 사용됩니다. 사용자가 속한 호스팅된 도메인을 지정합니다. 예를 들어 도메인 선택 패널을 렌더링하지 않으려는 경우 이 옵션을 사용할 수 있습니다. <code>:openid_login_hint</code>와 함께 전체 사용자 식별자를 지정하는 데 사용됩니다.</td><td><code>http://tabserver/views/Sales/Q2?:openid_hd=example.com</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:openid_login_hint</code></td><td>문자열</td><td>OpenID Connect로 인증할 때 사용됩니다. 전체 사용자 식별자(이메일 주소)를 지정합니다. <code>:openid_hd</code>와 함께 사용자가 속한 호스팅된 도메인을 지정하는 데 사용됩니다.</td><td><code>http://tabserver/views/Sales/Q2?:openid_login_hint=tara@example.com</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td>:<code>record_performance</code><p>(Tableau Server에만 해당합니다. Tableau Cloud에는 적용할 수 없습니다.)</p></td><td><code>yes</code></td><td>뷰의 성능 기록을 시작합니다. 이 매개 변수를 URL 끝에 있는 세션 ID(<code>:iid=<i>&lt;n&gt;</i></code>) 바로 앞에 추가합니다. 자세한 내용은 Tableau Server 도움말에서 <a href="https://help.tableau.com/current/server/ko-kr/perf_record_create_server.htm" target="_blank">성능 기록 만들기</a>를 참조하십시오.</td><td><code>http://tabserver/views/Sales2013/Regions?:recordperformance=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><a name="refresh_param"></a><code>:refresh</code></td><td><code>yes</code></td><td>Tableau Server 또는 Tableau Cloud의 최신 데이터를 사용하여 뷰를 렌더링합니다. 자세한 내용은 <a href="https://help.tableau.com/v0.0/pro/desktop/ko-kr/refresh.htm" class="xref">데이터 새로 고침 또는 자동 업데이트 일시 중지</a>을 참조하십시오.<p class="note"><b>팁:</b> 뷰를 지속적으로 새로 고치려면 웹 페이지의 <code>&lt;head&gt;</code> 섹션에 <code>&lt;meta http-equiv="refresh" content="#"&gt;</code>을 추가합니다. 여기서 <code>#</code>은 새로 고침 간격(초)입니다.</p></td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:refresh=yes</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:render</code></td><td><code>true</code>; <code>false</code>; 숫자</td><td>클라이언트 쪽 렌더링이 사용으로 설정된 경우(기본값) 이 매개 변수를 <code>false</code>로 설정하면 세션에 대해 서버 쪽 렌더링을 사용하도록 설정됩니다. <code>true</code>로 설정하면 세션에 대해 클라이언트 쪽 렌더링이 강제 수행됩니다.<p>1에서 100까지의 숫자를 입력하여 복잡성 임계값을 설정할 수 있으며, 이 값을 넘으면 뷰가 서버에서 렌더링됩니다. 자세한 내용은 Tableau Server 도움말에서<a href="https://help.tableau.com/current/server/ko-kr/browser_rendering.htm" target="_blank">클라이언트 쪽 렌더링 정보</a>를 참조하십시오.</p></td><td><code>http://tabserver/views/Date-Time/DateCalcs?:render=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:revert</code></td><td><code>all; filters; sorts; axes; shelves</code></td><td>항목을 원래 상태로 되돌립니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:revert=all</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showAppBanner</code></td><td><code>false</code></td><td>모바일 웹 브라우저에서 “Tableau Mobile에서 열기” 배너를 숨깁니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAppBanner=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showAskData</code></td><td><code>false</code></td><td>내장된 뷰의 툴바에서 데이터에 질문 단추를 숨 깁니다. 기본적으로 데이터에 질문 단추가 표시됩니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showAskData=false</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showShareOptions</code></td><td><code>true</code>; <code>false</code></td><td>내장된 뷰에 공유 옵션을 표시할지 여부를 제어합니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:showShareOptions=true</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:showVizHome</code><p>(Tableau Public만 해당)</p></td><td><code>yes; no</code></td><td>Tableau Public의 콘텐츠 탐색 인터페이스를 표시하거나 숨깁니다. 다른 웹 페이지에 비주얼리제이션을 내장할 경우 no로 설정하십시오.</td><td><code>https://public.tableau.com/en-us/s/gallery/what-emoji-say-about-music?:showVizHome=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:subscriptions</code></td><td><code>no</code></td><td>내장된 뷰에서 구독 단추를 숨깁니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:subscriptions=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:tabs</code></td><td><code>yes; no</code></td><td>탭을 표시하거나 숨깁니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:tabs=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:toolbar</code></td><td><code>yes; no; top</code></td><td>이 매개 변수가 설정되지 않은 경우 기본적으로 아래쪽에 툴바가 표시됩니다. <code>no</code>인 경우 내장된 뷰에서 툴바가 제외됩니다. <code>top</code>인 경우 뷰 위쪽에 툴바가 배치됩니다.</td><td><code>http://tabserver/views/Date-Time/DateCalcs?:embed=yes&amp;:toolbar=no</code></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td><code>:tooltip</code></td><td><code>yes; no</code></td><td>이 매개 변수가 설정되지 않은 경우 기본적으로 뷰에 도구 설명이 표시됩니다. <code>no</code>로 설정되어 있으면 내장된 뷰에서 도구 설명이 제외됩니다.</td><td><code>http://tabserver/views/workbookQ4/SalesQ4?:embed=yes&amp;:tooltip=no</code></td></tr></tbody></table>