Tableau Cloud 도움말

Tableau LWC(Lightning 웹 구성 요소)를 사용하면 Salesforce 고객이 Tableau 뷰와 Tableau Pulse 메트릭을 Salesforce Lightning 페이지로 끌어다 놓을 수 있습니다.

• Tableau 뷰 구성 요소를 사용하면 Tableau Cloud 또는 Tableau Server에 내장된 뷰를 추가할 수 있습니다.
• Tableau Pulse 구성 요소를 사용하면 Tableau Cloud에 내장된 Tableau Pulse 메트릭을 추가할 수 있습니다.

Tableau LWC 원활한 인증을 사용하면 로그인하지 않고도 연결된 앱의 신뢰할 수 있는 토큰을 사용하여 Tableau 콘텐츠를 볼 수 있습니다. 원활한 인증은 Tableau 뷰 LWC의 경우 선택 사항이고 Tableau Pulse LWC의 경우 필수입니다.

신뢰할 수 있는 URL 추가

Lightning 페이지에 추가하려는 Tableau 뷰 또는 Pulse URL을 신뢰할 수 있는 URL로 추가해야 합니다.

1. Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
2. 왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 'Trusted URLs'를 입력합니다.
3. Trusted URLs(신뢰할 수 있는 URL) 설정 페이지를 선택합니다.
4. New Trusted URL(신뢰할 수 있는 새 URL)을 선택합니다.
5. 설정 페이지의 지침에 따라 API Name(API 이름) 및 URL을 입력합니다. 참고: URL은 https://로 시작해야 합니다.
6. CSP Context(CSP 컨텍스트)의 경우 All(전체)을.선택합니다.
7. CSP Directives(CSP 지시문)의 경우 모든 확인란을 선택합니다.
8. Save(저장)를 선택합니다.

Tableau LWC 및 원활한 인증 설정

Salesforce 설정 구성

다음 단계는 Salesforce 관리자가 한 번만 완료하면 됩니다.

1. Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
2. 왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 "Tableau"를 입력합니다.
3. Tableau Embedding(Tableau 내장) 설정 페이지를 선택합니다.
4. Turn on Tableau Lightning Web Components(Tableau Lightning 웹 구성 요소 설정) 및 Turn on token-based single sign-on authentication(토큰 기반 Single Sign-On 인증 설정)의 확인란을 선택합니다.

   참고: Tableau Pulse LWC를 구성하려면 이 두 확인란을 모두 선택해야 합니다. Tableau 뷰 LWC의 경우 토큰 인증을 설정하지 않고 대신 구성 요소가 로드될 때 수동으로 로그인하도록 선택할 수 있습니다.
   
   모바일에서 Tableau 뷰 LWC를 사용하려면 토큰 기반 인증을 사용하도록 설정하고 원활한 인증을 설정해야 합니다.

5. Tableau에서 사용자를 인증하도록 Select Tableau User Identity field(Tableau 사용자 ID 필드 선택)에서 조직 수준 사용자 필드를 설정합니다. Tableau 사용자 이름에 해당하는 Salesforce 사용자 필드를 선택해야 합니다. 드롭다운에는 현재 사용자의 필드 값이 표시되거나 값이 정의되지 않은 경우 null이 표시됩니다. Tableau 사용자 이름과 일치하는 사용자 필드가 없으면 빈 필드(예: 페더레이션 ID 또는 사용자 지정 필드)를 선택합니다. 그런 다음 사용자의 Tableau 사용자 이름으로 빈 필드를 채웁니다.

   참고: Tableau 사용자 ID 필드 설정은 모든 사용자에게 적용되며 개별적으로 설정할 필요가 없습니다.

6. 변경 내용을 저장합니다.
7. Tableau 관리자인 경우 다음 섹션에서 Tableau 설정을 구성하는 동안 Salesforce 설정 Tableau Embedding(Tableau 내장) 탭을 열어 두십시오. 관리자가 아닌 경우 발급자 URL 및 JWKS URI를 Tableau 관리자와 공유하십시오.

Tableau 설정 구성

한 탭에서 Salesforce 조직의 Tableau Embedding(Tableau 내장) 설정 페이지를 엽니다. 다른 탭에서 Tableau 사이트로 이동하고 다음 지침에 따라 연결된 앱을 설정합니다.

Tableau Server의 경우 아래 단계를 따릅니다.

1. Tableau Server 관리자로 TSM(Tableau 서비스 관리자) 웹 인터페이스에 로그인합니다.
2. 사용자 ID 및 액세스로 이동한 다음 인증 서버 탭을 선택합니다.
3. 내장된 콘텐츠에 OAuth 액세스 사용 확인란을 선택합니다.
4. 발급자 URL 및 JWKS URI를 입력합니다. 이는 Salesforce 조직의 Tableau Embedding(Tableau 내장) 설정 페이지에서 확인할 수 있습니다． Salesforce 조직의 설정 페이지에서 Copy(복사) 단추를 사용하여 발급자 URL 값을 복사한 다음 TSM 웹 인터페이스에 붙여 넣습니다. JWKS URI 값에 대해 이 프로세스를 반복합니다.

참고: JWKS URI 필드는 TSM 웹 인터페이스에서 선택 사항으로 표시되지만 Tableau LWC 원활한 인증을 사용하려면 이 값이 필요합니다.

5. 보류 중인 변경 내용 저장을 선택합니다.
6. 페이지의 오른쪽 아래에서 보류 중인 변경 내용을 선택한 후 변경 내용 적용 후 다시 시작을 선택하여 Tableau Server를 중지했다가 다시 시작합니다.
   

자세한 내용은 Tableau Server에 EAS 등록(링크가 새 창에서 열림)을 참조하십시오.

Tableau Cloud의 경우 아래 단계를 따릅니다.

1. Tableau 설정 페이지를 연 다음 연결된 앱 탭을 선택합니다.
2. 새 연결된 앱 드롭다운에서 OAuth 2.0 신뢰를 선택합니다.
3. 연결된 앱 만들기 대화 상자에서 발급자 URL 및 JWKS URI를 입력합니다. 이는 Salesforce 조직의 Tableau View Embedding(Tableau 뷰 내장) 설정 페이지에서 확인할 수 있습니다． Salesforce 조직의 설정 페이지에서 Copy(복사) 단추를 사용하여 발급자 URL 값을 복사한 다음 Tableau 설정 페이지에 붙여 넣습니다. JWKS URI 값에 대해 이 프로세스를 반복합니다.

중요: 연결된 앱 만들기 대화 상자에는 JWKS URI 필드가 선택 사항으로 표시되지만 Tableau LWC의 원활한 인증을 사용하려면 이 값이 필요합니다.

4. 연결된 앱 사용 확인란을 선택합니다.
5. 만들기를 선택합니다.

참고: 연결된 앱의 이름이 외부 인증 서버로 지정되었습니다.

자세한 내용은 Tableau Cloud에 EAS 등록(링크가 새 창에서 열림)을 참조하십시오.

이 사이트에 대한 호스트 매핑을 만들려면 연결된 앱 탭을 열어 둡니다. 이 페이지의 URL과 Copy Site ID(사이트 ID 복사) 단추를 사용하여 다음 섹션의 호스트 매핑 필드를 채울 수 있습니다.

호스트 매핑 설정 또는 편집

호스트 매핑을 만들거나 편집하려면 다음 단계를 따르십시오.

팁: 사용자 ID 필드 설정은 모든 사용자에게 적용되며 개별적으로 설정할 필요가 없습니다.

새 호스트 매핑 만들기

1. Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
2. 왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 "Tableau"를 입력합니다.
3. Tableau Embedding(Tableau 내장) 설정 페이지를 선택합니다.
4. Tableau Host Mapping(Tableau 호스트 매핑) 섹션에서 Create New(새로 만들기)를 선택합니다.
5. 호스트 매핑 세부 정보를 입력합니다.
   1. Tableau site URL(Tableau 사이트 URL): 매핑하려는 Tableau 사이트의 URL을 입력합니다. 기본 사이트를 사용하는 온프레미스 설치가 아닌 이상 URL에는 사이트 이름이 포함되어야 합니다. 참고: 이 사이트에 대한 호스트 매핑을 만들려면 연결된 앱 탭을 열어 둡니다. 이 페이지의 URL과 Copy Site ID(사이트 ID 복사) 단추를 사용하여 다음 섹션의 호스트 매핑 필드를 채울 수 있습니다.
   2. Tableau site ID(Tableau 사이트 ID): 매핑하려는 Tableau 사이트의 사이트 ID를 입력합니다. Connected App(연결된 앱) 설정 페이지 또는 Share(공유) 대화 상자에서 Copy Site ID(사이트 ID 복사) 단추를 사용할 수 있습니다.
   3. Tableau site host type(Tableau 사이트 호스트 유형): Tableau Cloud 또는 Tableau Server를 선택합니다.
6. Save(저장)를 선택합니다. 또는 저장하지 않고 Tableau Embedding(Tableau 내장) 설정 페이지로 돌아가려면 Cancel(취소)을 선택합니다.

호스트 매핑 편집

기존 매핑의 사이트 ID와 호스트 유형을 업데이트할 수 있습니다. 사이트 URL을 변경해야 하는 경우에는 기존 매핑을 삭제한 다음 올바른 URL을 사용하여 새 매핑을 만들어야 합니다.

1. Salesforce 앱의 Tableau Embeddings(Tableau 내장) 설정 페이지에서 기존 호스트 매핑 옆에 있는 Edit(편집)를 선택합니다.
2. 필요에 따라 Tableau site ID(Tableau 사이트 ID) 또는 Tableau site host type(Tableau 사이트 호스트 유형) 필드를 편집합니다.
3. Save(저장)를 선택합니다. 또는 저장하지 않고 Tableau Embedding(Tableau 내장) 설정 페이지로 돌아가려면 Cancel(취소)을 선택합니다.

Lightning 앱 빌더를 사용하여 Lightning 페이지에 Tableau LWC 추가

Tableau LWC는 App(앱), Home(홈) 및 Record(레코드) Lightning 페이지에서만 사용할 수 있습니다. Lightning 페이지 유형 및 Lightning 앱 빌더 사용에 대한 자세한 내용은 Salesforce 도움말에서 Lightning 앱 빌더를 참조하십시오.

기존 Lightning 페이지에 Tableau 뷰 또는 Tableau Pulse LWC를 추가하려면 다음 단계를 따르십시오.

1. 편집하려는 Lightning 페이지로 이동합니다.
2. 오른쪽 상단에서 톱니바퀴 아이콘을 선택합니다.
3. Edit Page(페이지 편집)를 선택합니다.
4. 아래의 Lightning 페이지에 Tableau LWC 추가 섹션을 진행합니다.

새 Lightning 페이지에 Tableau 뷰 또는 Tableau Pulse LWC를 추가하려면 다음 단계를 따르십시오.

1. Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
2. 왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 'Lightning App Builder(Lightning 앱 빌더)'를 입력합니다.
3. Lightning App Builder(Lightning 앱 빌더) 설정 페이지를 선택합니다.
4. New(새로 만들기)를 선택합니다.
5. 만들려는 페이지 유형을 선택합니다. Tableau LWC는 App(앱), Home(홈) 및 Record(레코드) 페이지에서만 사용할 수 있습니다.
6. Next(다음)를 선택합니다.
7. 이름을 입력하고 새 페이지의 레이아웃을 선택한 다음 Done(완료)을 선택합니다.

Lightning 페이지에 Tableau LWC 추가

1. 페이지 왼쪽의 Components(구성 요소) 목록에서 Tableau 뷰 또는 Tableau Pulse 구성 요소를 페이지로 끌어서 놓습니다.
2. LWC를 구성합니다.
   • Tableau 뷰 Lightning 웹 구성 요소 구성
   • Tableau Pulse Lightning 웹 구성 요소 구성

페이지 저장 및 활성화

1. Tableau 뷰 또는 Tableau Pulse LWC 추가 및 구성을 마쳤으면 Save(저장)를 선택합니다.
2. 새 페이지를 만든 경우 사용자가 볼 수 있도록 페이지를 활성화하라는 메시지가 표시됩니다. Activate(활성화)를 선택합니다.
3. 활성화 페이지의 Page Settings(페이지 설정) 탭에서 이름을 입력하고 아이콘을 선택한 다음 표시 유형 기본 설정을 선택합니다.
4. (선택 사항) 활성화 페이지의 Lightning Experience(Lightning 경험) 탭에서 다양한 Lightning Experience 앱에 페이지를 추가할 수 있습니다.
5. (선택 사항) 활성화 페이지의 Mobile Navigation(모바일 탐색) 탭에서 페이지를 모바일 탐색 메뉴에 추가할 수 있습니다.
   참고: Tableau Pulse LWC는 모바일에서 사용할 수 없습니다.
   
6. Save(저장)를 선택합니다.

여러 Tableau 뷰 내장

모든 뷰의 출처가 동일한 사이트인 경우 Salesforce Lightning 페이지에 Tableau 뷰를 둘 이상 내장할 수 있습니다. Tableau는 단일 세션만 지원하며 해당 세션은 특정 사이트로 한정됩니다. 가장 최근에 권한이 부여된 세션이 이전 세션을 삭제합니다.

여러 사이트의 Tableau 뷰를 내장하려면 사이트별로 별도의 Lightning 페이지를 만들어야 합니다.

모바일에서 Tableau 뷰 LWC의 원활한 인증

참고: Tableau 뷰 LWC는 iOS 17.2.1 이상에서 사용할 수 있습니다. Tableau Pulse LWC는 현재 iOS 또는 Android에서 사용할 수 없습니다.

모바일 사용자의 문제를 방지하려면 다음 모범 사례를 고려하십시오.

• Lightning 페이지 유형: 모바일 사용자는 앱 페이지와 레코드 페이지에 액세스할 수 있지만 홈 페이지에는 액세스하지 못합니다.
  

  참고: 레코드 페이지는 특정 유형의 레코드와 연결되어야 합니다.

• 데스크톱 사용자와 모바일 사용자 모두에 대해 동일한 페이지를 사용하는 경우 Activation(활성화)를 선택하여 Lightning 페이지가 데스크톱 및 휴대폰 폼 팩터 모두에 대해 조직 기본값으로 설정되어 있는지 확인하십시오.
• 알맞은 시각적 경험을 제공하려면 데스크톱과 모바일용으로 별도의 Lightning 페이지를 만드는 것이 좋습니다. Tableau 뷰 구성 요소의 높이는 고정되어 있으며 다양한 화면 크기에 맞춰 동적으로 조정되지 않습니다.
• 뷰에 스크롤 막대를 추가하려면 Tableau 뷰 구성 요소 속성 패널에서 Show Toolbar(툴바 표시)를 선택합니다.
• 앱 페이지 유형으로 Activation(활성화)을 선택한 후 Lightning Experience(Lightning 경험) 탭을 선택합니다. LightningBolt 목록에 페이지를 추가하면 모바일에서 페이지를 더 쉽게 찾을 수 있습니다.
• 모바일에서 iOS는 기본적으로 사이트 간 트래픽을 차단합니다. 모바일 설정을 열고 Salesforce 설정을 선택한 다음 Allow Cross-Website Tracking(교차 웹 사이트 추적 허용)을 설정합니다. 자세한 내용은 교차 웹 사이트 사용(영문)(링크가 새 창에서 열림)을 참조하십시오.

Tableau 뷰 LWC의 원활한 인증 문제 해결

Salesforce 및 Tableau 구성 확인

1. 발급자 URL과 JWKS URI 값이 Salesforce와 Tableau 설정 모두에서 일치하는지, JWKS URI가 id/keys로 끝나는지 확인하십시오.

   • Tableau Cloud의 경우 한 탭에서 Salesforce 설정 Tableau Embedding(Tableau 내장) 페이지를 엽니다. 다른 탭에서 Tableau 설정 연결된 앱 탭을 엽니다. 연결된 앱 탭에서 외부 권한 부여 서버를 선택한 다음 편집을 선택합니다. 발급자 URL 및 JWKS URI 값이 일치하고 JWKS URI가 id/keys로 끝나는지 확인합니다.
   • Tableau Server의 경우 한 탭에서 Salesforce 설정의 Tableau Embedding(Tableau 내장) 페이지를 엽니다. 그런 다음 TSM(Tableau 서비스 관리자) 웹 인터페이스에 로그인하고 사용자 ID 및 액세스로 이동한 다음 권한 부여 서버 탭을 엽니다.

2. 호스트 매핑을 확인합니다. 호스트 매핑을 저장한 경우 사이트 ID와 호스트 유형이 올바른지 확인합니다.

JWT 토큰 확인

Tableau 뷰 Lightning 웹 구성 요소 속성 편집기에서 디버그 모드를 선택하여 JWT 토큰이 예상대로 작동하는지 확인합니다.

1. 콘솔 로그를 열고 토큰을 복사합니다.
2. jwt.io(링크가 새 창에서 열림) 웹 사이트로 이동하고 Encoded(인코딩됨) 필드에 토큰을 붙여 넣습니다.
3. 다음을 확인합니다.
• 제목("sub")이 Tableau 사용자 이름과 일치합니다.
• Tableau Cloud의 경우 대상("aud")이 "tableau+SiteID"입니다.
  Tableau Server의 경우 대상("aud")이 "tableau"입니다.
  
• 범위("scp")에는 "tableau:views:embed" 및 "tableau:insights:embed"가 모두 포함됩니다.
• 발급자("iss") EAS 서버가 정확합니다.

페이지 활성화 확인

경우에 따라 사용자가 Lightning 페이지를 만들었지만 활성화되지 않았거나 어디에도 할당되지 않아 사용자가 찾을 수 없는 경우가 있습니다. 활성화를 선택하여 Lightning 페이지가 의도한 폼 팩터에 대한 조직 기본값으로 설정되어 있는지 확인합니다.

팁: 디버깅할 때 서식 있는 텍스트 구성 요소를 페이지에 끌어서 놓는 것이 도움이 됩니다. 내장하려는 페이지 유형과 뷰 URL에 대한 간략한 설명을 추가하십시오. 이를 통해 최종 사용자가 보고 있는 페이지가 관리자가 편집 중인 페이지인지 확인할 수 있습니다.

Tableau 뷰 LWC가 원활한 인증 없이 작동하는지 확인(Tableau 뷰 LWC만 해당)

1. Lightning 페이지의 Tableau 뷰 패널에서 Default Authentication Token(기본 인증 토큰) 확인란을 선택 취소한 후 변경 내용을 저장합니다.
2. 다른 탭에서 Tableau에 로그인한 경우 로그아웃합니다. 뷰 URL로 이동하면 Tableau 로그인 페이지로 리디렉션되는지 확인하십시오. 로그인하지 않습니다.
3. Lightning 페이지로 이동합니다. Tableau 뷰 LWC에 Sign in to Tableau(Tableau에 로그인) 단추가 표시되어야 합니다.
4. Sign in to Tableau(Tableau에 로그인)을 선택한 다음 로그인할 Tableau 자격 증명을 입력합니다.
   참고: 뷰가 로드되지 않으면 Tableau 인증과 관련된 더 광범위한 문제가 있음을 나타냅니다.

오류: LWC 구성 요소 버전이 더 이상 지원되지 않음(Tableau View LWC만 해당)

이 오류를 해결하려면 다음 단계를 수행합니다.

1. Components(구성 요소)목록에서 "Tableau"를 검색하고 새 Tableau View(Tableau 뷰) 구성 요소를 페이지로 끌어 놓습니다.
2. 이전 구성 요소에 대한 Tableau 뷰 패널의 모든 속성을 새 구성 요소에 복사합니다.
3. 이전 구성 요소에서 삭제 아이콘을 선택합니다.

참고 항목

연결된 앱 문제 해결(링크가 새 창에서 열림)

EAS를 등록하여 내장된 콘텐츠에 대한 SSO 지원