메트릭을 내장하여 Viewer(뷰어)와의 관련성 컨텍스트에서 다른 웹 콘텐츠와 함께 메트릭을 표시할 수 있습니다. 내장된 메트릭을 로드하면 사용할 수 있는 가장 최신 상태의 데이터가 표시됩니다. Tableau Server 또는 Tableau Cloud의 데이터에 직접 연결하는 것이기 때문입니다.

웹 페이지에 메트릭을 내장하려면 Tableau Server 또는 Tableau Cloud에 제공된 HTML 내장 코드를 복사하거나 아래에 표시된 JavaScript 예제를 사용합니다. 동일한 Tableau 사이트에서 나온 메트릭인 경우 여러 메트릭을 단일 페이지에 내장할 수 있습니다.

내장된 메트릭은 Tableau Cloud 및 Tableau Server에서 지원되는 것과 동일한 웹 브라우저에서 작동합니다. 지원되는 브라우저 목록은 기술 사양을 참조하십시오. Safari에서는 내장이 지원되지만 Viewer(뷰어)가 “사이트 간 추적 방지”를 해제해야 내장된 콘텐츠를 볼 수 있습니다.

내장된 메트릭의 내장 코드 및 매개 변수는 내장된 뷰에 사용되는 것과 다릅니다. 내장된 뷰에 대한 자세한 내용은 웹 페이지에 내장된 뷰을 참조하십시오.

참고: Tableau 관리자는 내장이 허용되거나 내장을 완전히 사용하지 않는 사이트를 제한할 수 없습니다. 내장된 메트릭이 로드되지 않는 경우 관리자를 통해 메트릭을 내장한 사이트가 내장 허용 목록에 있는지 확인하십시오. 자세한 내용은 내장에 대한 Tableau 사이트 설정(영문)을 참조하십시오.

내장 코드 복사

메트릭을 내장하는 가장 빠른 방법은 Tableau에서 제공하는 내장 코드를 복사하는 것입니다.

  1. Tableau Cloud 또는 Tableau Server에서 내장하려는 메트릭의 세부 정보 페이지로 이동합니다.
  2. 메트릭 공유 단추를 클릭합니다.
  3. 내장 코드 복사를 클릭합니다.
    공유 대화 상자의 내장 코드 복사 단추
  4. 메트릭을 내장하려는 웹 페이지에 내장 코드를 붙여 넣습니다.

자체 내장 코드 작성

Tableau Server 또는 Tableau Cloud에서 내장 코드를 복사할 때는 선택적 매개 변수 없이 HTML 내장 코드를 복사합니다. 내장된 메트릭을 세밀하게 제어하고 싶다면 HTML을 사용자 지정하거나 JavaScript 예제를 사용하여 자체 스크립트를 작성하면 됩니다.

HTML 예제

                    <tableau-metric
	src='https://mycompany/#/metrics/1'
	link-target='https://example.com'>
</tableau-metric>
<script type='module' src='https://mycompany/javascripts/api/tableau.metric.1.latest.min.js'></script>
                

JavaScript 예제

                    <div id='metricDiv'/>
<script type='module'>
	import { TableauMetric } from 'https://mycompany/javascripts/api/tableau.metric.1.latest.min.js';
				
	let metric = new TableauMetric();

	metric.src = 'https://mycompany/#/metrics/1';
	metric.linkTarget = 'https://example.com';document.getElementById('metricDiv').appendChild(metric);
</script>
                

내장 코드의 매개 변수

내장 코드의 매개 변수를 사용하여 HTML 및 JavaScript 내장 옵션을 사용자 지정할 수 있습니다.

매개 변수 설명
src
(필수)
문자열 Tableau Server 또는 Tableau Cloud에 있는 메트릭의 URL입니다. https://mycompany/#/metrics/1

link-target(HTML)

linkTarget(JavaScript)

(선택 사항)

문자열 Viewer(뷰어)가 메트릭을 클릭할 때 연결되는 URL입니다. 대상이 지정되지 않은 경우 내장된 메트릭은 원본 URL에 연결됩니다. http://example.com

내장된 메트릭에 대한 인증

내장된 메트릭은 Tableau Server 및 Tableau Cloud에 사용된 동일한 라이선스 및 사용 권한 제한을 따릅니다. 내장된 메트릭을 보려면 Viewer(뷰어)가 내장된 메트릭의 원본 Tableau 사이트에서 계정에 로그인해야 합니다. 내장된 뷰와 달리 내장된 메트릭은 로그인하지 않은 Viewer(뷰어)에게 게스트 계정을 사용하여 메트릭을 표시하는 것을 허용하지 않습니다.

다른 탭에서 Tableau Server 또는 Tableau Cloud에 로그인하지 않은 Viewer(뷰어)에게는 내장된 메트릭 자체에서 로그인하라는 메시지가 표시됩니다. 내장된 메트릭에서 로그인하려면 타사 쿠키를 허용하도록 Viewer(뷰어)의 브라우저를 구성해야 합니다.

내장된 메트릭은 신뢰할 수 있는 인증을 제외하고 Tableau Server 및 Tableau Cloud의 모든 인증 방법을 지원합니다. Tableau Server에서 내장된 메트릭의 경우 서버에서 HTTPS를 사용하여 통신을 보호해야 합니다.

내장된 메트릭에 대한 SSO(Single Sign-On)를 지원하려면 Tableau 관리자가 Tableau Server와 외부 권한 부여 서버(Tableau Server만 해당) 또는 Tableau의 연결된 앱 및 웹 페이지와의 신뢰 관계를 구성해야 합니다. 자세한 내용은 Tableau Server 도움말의 EAS를 등록하여 내장된 콘텐츠에 대한 SSO 지원(링크가 새 창에서 열림) 또는 Tableau Cloud 도움말의 Tableau의 연결된 앱을 구성하여 내장된 콘텐츠에 대한 SSO 지원(링크가 새 창에서 열림)을 참조하십시오.

메트릭 URL 구조 방식

메트릭을 내장하려면 메트릭 URL과 메트릭을 렌더링하는 데 사용되는 JavaScript URL을 지정해야 합니다. 메트릭 URL은 Tableau Cloud, 단일 사이트를 보유한 Tableau Server 환경 및 다중 사이트 Tableau Server 환경에서 약간씩 다른 패턴을 따릅니다. URL 서식을 지정하는 방법을 잘 모르는 경우 메트릭 URL과 JavaScript URL이 모두 포함되어 있는 내장 코드를 복사하십시오.

메트릭은 Tableau Server 또는 Tableau Cloud에서 호스팅되어야 합니다. 로컬 파일의 메트릭을 내장할 수는 없습니다.

메트릭 URL 구조

  • Tableau Cloud 사이트: https://<pod>.online.tableau.com/#/site/<sitename>/metrics/<metric>
  • Tableau Server 단일 사이트(또는 기본 사이트): https://<servername>/#/metrics/<metric>
  • Tableau Server 다중 사이트: https://<servername>/#/site/<sitename>/metrics/<metric>

JavaScript URL 구조

메트릭 URL은 내장하는 메트릭의 원본 사이트에 따라 변경되지만 메트릭을 렌더링하는 JavaScript의 URL은 사이트를 포함하지 않기 때문에 변경되지 않습니다.

  • Tableau Cloud 사이트: https://<pod>.online.tableau.com/javascripts/api/tableau.metric.1.latest.min.js
  • Tableau Server: https://<servername>/javascripts/api/tableau.metric.1.latest.min.js
피드백을 제공해 주셔서 감사합니다!