Konfiguration och friktionsfri autentisering av Lightning-webbkomponenter för Tableau

Gäller för: Tableau Cloud, Tableau Server

Lightning-webbkomponenter för Tableau gör det möjligt för Salesforce-kunder att dra och släppa Tableau-vyer och Tableau Pulse-mätvärden på Salesforce Lightning-sidor.

  • Med komponenten för Tableau-vyer kan du lägga till inbäddade vyer från Tableau Cloud eller Tableau Server.
  • Med komponenten för Tableau Pulse kan du lägga till inbäddade Tableau Pulse-mätvärden från Tableau Cloud.

Med friktionsfri autentisering av Lightning-webbkomponenter för Tableau kan du se Tableau-innehåll med anslutna appbetrodda token utan att logga in. Friktionsfri autentisering är valfritt för Lightning-webbkomponenter för Tableau-vyer och krävs för Lightning-webbkomponenter för Tableau Pulse.

Lägga till betrodd URL

Om du vill lägga till en Tableau-vy- eller Pulse-URL på din Lightning-sida måste den läggas till som en betrodd URL.

  1. Välj kugghjulet högst upp till höger i din Salesforce-app och därefter Konfigurera.
  2. Ange ”Betrodda URL:er” i sökrutan Snabbsökning i den vänstra navigeringsrutan.
  3. Välj inställningssidan Betrodda URL:er.
  4. Välj Ny betrodd URL.
  5. Ange API-namn och URL med hjälp av anvisningarna på inställningssidan. Obs! URL:en måste börja med https://.
  6. Välj Alla för CSP-kontext.
  7. Markera alla rutor för CSP-direktiv.
  8. Välj Spara.

Aktivera Lightning-webbkomponenter för Tableau och ställa in friktionsfri autentisering

Konfigurera Salesforce-inställningar

Följande steg behöver utföras endast en gång av en Salesforce administratör:

  1. Från din Salesforce app väljer du kugghjulet i det övre högra hörnet och sedan Konfigurera.
  2. I den vänstra navigeringsrutan anger du ”Tableau” i sökrutan Snabbsökning.
  3. Välj inställningssidan för Tableau Embedding (Tableau-inbäddning).
  4. Markera kryssrutorna för Aktivera Lightning-webbkomponenter för Tableau och Aktivera tokenbaserad autentisering med enkel inloggning.

    Obs! Båda dessa rutor måste vara markerade för att konfigurera Lightning-webbkomponenten för Tableau Pulse. För Lightning-webbkomponenten för Tableau-vyer kan du välja att inte ställa in tokenautentisering och i stället logga in manuellt när komponenten läses in.

    Du måste aktivera tokenbaserad autentisering och ställa in friktionsfri autentisering för att använda Lightning-webbkomponenten för Tableau-vyer på en mobil enhet.

  5. För fältet Välj Tableau användaridentitet ställer du in ett användarfält på organisationsnivå för att autentisera användaren i Tableau. Du måste välja det Salesforce-användarfält som motsvarar Tableau-användarnamnet. Listrutan visar fältvärdet för den aktuella användaren eller null om inget värde är definierat. Om inget av användarfälten matchar Tableau-användarnamnet väljer du ett tomt fält (till exempel Federations-ID eller ett anpassat fält). Fyll därefter i det tomma fältet med Tableau-användarnamnet för användaren.

    Obs! Fältinställningen för Tableau användaridentitet gäller för alla användare och behöver inte ställas in för varje enskild individ.

  6. Spara dina ändringar.
  7. Om du är Tableau-administratör ska du hålla Salesforce-inställningsfliken Tableau-inbäddning öppen medan du konfigurerar Tableau-inställningar i nästa avsnitt. Om du inte är administratör ska du dela Utfärdarens URL och JWKS URI med din Tableau-administratör.

Konfigurera Tableau-inställningar

Öppna inställningssidan för Tableau-inbäddning i din Salesforce-organisation i en flik. På en annan flik går du till din Tableau-webbplats och utför följande instruktioner för att konfigurera ansluten app.

För Tableau Server, följ dessa steg:

  1. Som Tableau Server-administratör loggar du in i webbgränssnittet för Tableau Services Manager (TSM).
  2. Navigera till Användaridentitet och åtkomst och välj därefter fliken Auktoriseringsserver.
  3. Markera kryssrutan för Aktivera OAuth-åtkomst för inbäddat innehåll.
  4. Ange Utfärdarens URL och JWKS URI, som du hittar på Salesforce org-inställningssidan för Tableau-inbäddning. Använd knappen Kopiera på Salesforce org-inställningssidan för att kopiera värdet för utfärdarens URL och klistra sedan in det i TSM-webbgränssnittet. Upprepa denna process för JWKS URI-värdet.

    5. Obs! Fältet JWKS URI är markerat som valfritt i TSM-webbgränssnittet, men det värdet krävs för friktionsfri autentisering av LWC för Tableau-vy.

  5. Välj Spara väntande ändringar.
  6. Välj Väntande ändringar högst upp till höger på sidan och välj därefter Tillämpa ändringar och starta om för att stoppa och starta om Tableau Server.

Mer information finns i Registrera din EAS hos Tableau Server(Länken öppnas i ett nytt fönster).

För Tableau Cloud, följ dessa steg:

  1. Öppna sidan för Inställningar i Tableau och välj sedan fliken Anslutna appar.
  2. Välj OAuth 2.0 Trust i listrutan Ny anslutet program.
  3. I dialogrutan Skapa ansluten app anger du Utfärdarens URL och JWKS URI, som du hittar på Salesforce org-inställningssidan för Tableau-inbäddning. Använd knappen Kopiera på Salesforce org-inställningssidan för att kopiera utfärdarens URL-värde och klistra sedan in det på Tableau inställningssida. Upprepa denna process för JWKS URI-värdet.

    4. Viktigt: I dialogrutan Skapa anslutet program är fältet JWKS URI markerat som valfritt, men det värdet krävs för friktionsfri autentisering av LWC för Tableau-vy.

  4. Markera kryssrutan för Aktivera anslutet program.
  5. Välj Skapa.

    6. Obs! Det anslutna programmet heter Extern auktoriseringsserver (EAS).

Mer information finns i Registrera din EAS hos Tableau Cloud(Länken öppnas i ett nytt fönster).

Lämna fliken Anslutna program öppen om du vill skapa en värdmappning för den här webbplatsen. Du kan använda URL:en för den här sidan och knappen Kopiera plats-ID för att fylla i värdmappningsfälten i följande avsnitt.

Ställa in eller redigera värdmappning

Följ de här stegen för att skapa eller redigera en värdmappning.

Tips: Fältinställningen för Tableau-användaridentitet gäller för alla användare och behöver inte ställas in för varje enskild individ.

Skapa en ny värdmappning

  1. Välj kugghjulet högst upp till höger i din Salesforce-app och därefter Konfigurera.
  2. I den vänstra navigeringsrutan anger du ”Tableau” i sökrutan Snabbsökning.
  3. Välj inställningssidan för Tableau Embedding (Tableau-inbäddning).
  4. Välj Skapa ny i avsnittet Tableau-värdmappning.
  5. Fyll i värdmappningsuppgifterna:
    1. Tableau-platsens URL: Ange en URL för Tableau-platsen som du vill mappa. URL:en ska innehålla platsnamnet, såvida det inte är en lokal installation som använder standardplatsen. Obs! Lämna fliken Anslutna program öppen om du vill skapa en värdmappning för den här webbplatsen. Du kan använda URL:en för den här sidan och knappen Kopiera plats-ID för att fylla i värdmappningsfälten i följande avsnitt.
    2. Tableau-platsens ID: Ange plats-ID:t för Tableau-platsen som du vill mappa. Du kan använda knappen Kopiera plats-ID på inställningssidan för Anslutet program eller i dialogrutan Dela.
    3. Tableau-platsens värdtyp: Välj Tableau Cloud eller Tableau Server.
  6. Välj Spara. Om du vill gå tillbaka till inställningssidan för Tableau-inbäddning utan att spara kan du välja Avbryt.

Redigera en värdmappning

Du kan uppdatera plats-ID:t och värdtypen för en befintlig mappning. Om du behöver ändra platsens URL ska du ta bort den befintliga mappningen och därefter skapa en ny med rätt URL.
  1. Välj Redigera bredvid en befintlig värdmappning på inställningssidan för Tableau-inbäddning i Salesforce-appen.
  2. Redigera fälten Tableau-platsens ID eller Tableau-platsens värdtyp efter behov.
  3. Välj Spara. Om du vill gå tillbaka till inställningssidan för Tableau-inbäddning utan att spara kan du välja Avbryt.

Lägga till Lightning-webbkomponenter för Tableau på en Lightning-sida med Lightning-appbyggaren

Lightning-webbkomponenter för Tableau är endast tillgängliga på Lightning-sidorna App, Start och Post. Mer information om Lightning-sidtyper och användning av Lightning-appbyggaren finns under Lightning-appbyggare i Salesforce-hjälpen.

Följ de här stegen för att lägga till en Lightning-webbkomponent för Tableau-vyer eller Tableau Pulse på en befintlig Lightning-sida:

  1. Gå till Lightning-sidan som du vill redigera.
  2. Välj kugghjulsikonen högst upp till höger.
  3. Välj Redigera sida.
  4. Fortsätt till avsnittet Lägga till en Lightning-webbkomponent för Tableau på en Lightning-sida nedan.

Följ de här stegen för att lägga till en Lightning-webbkomponent för Tableau-vyer eller Tableau Pulse på en ny Lightning-sida:

  1. Välj kugghjulet högst upp till höger i din Salesforce-app och därefter Konfigurera.
  2. Ange ”Lightning-appbyggare” i sökrutan Snabbsökning i den vänstra navigeringsrutan.
  3. Välj inställningssidan för Lightning-appbyggare.
  4. Välj Ny.
  5. Välj sidtypen som du vill skapa. Lightning-webbkomponenter för Tableau är tillgängliga på sidorna App, Start och Post.
  6. Välj Nästa.
  7. Ange ett namn och välj en layout för den nya sidan och välj sedan Klar.

Lägga till en Lightning-webbkomponent för Tableau på en Lightning-sida

  1. Dra komponenten för Tableau-vyer eller Tableau Pulse från komponentlistan till vänster och släpp på sidan.
  2. Konfigurera Lightning-webbkomponenten:

Spara och aktivera sidan

  1. När du har lagt till och konfigurerat en Lightning-webbkomponent för Tableau-vyer eller Tableau Pulse väljer du Spara.
  2. Om du har skapat en ny sida uppmanas du att aktivera sidan så att den blir synlig för användarna. Välj Aktivera.
  3. Ange ett namn, välj en ikon och välj önskad synlighet på fliken Sidinställningar på sidan Aktivering.
  4. (Valfritt) På fliken Lightning Experience på sidan Aktivering kan du lägga till sidan i olika Lightning Experience-appar.
  5. (Valfritt) På fliken Mobil navigering på sidan Aktivering kan du lägga till sidan i mobilnavigeringsmenyn.
    Obs! Lightning-webbkomponenten för Tableau Pulse är inte tillgänglig på mobila enheter.
  6. Välj Spara.

Bädda in flera Tableau-vyer

Du kan bädda in fler än en Tableau-vy på en Salesforce Lightning-sida, så länge alla vyer kommer från samma plats. Tableau har bara stöd för en session och den sessionen är specifik för platsen. Den senast beviljade sessionen raderar den föregående.

Om du vill bädda in Tableau-vyer från flera platser måste du skapa separata Lightning-sidor som är platsspecifika.

Friktionsfri autentisering av LWC för Tableau-vy på mobila enheter

Obs! Lightning-webbkomponenten för Tableau-vyer är tillgänglig på iOS 17.2.1+. Lightning-webbkomponenten för Tableau Pulse är för närvarande inte tillgänglig på iOS eller Android.

Tänk på följande bästa praxis för att förhindra problem för mobilanvändare:

  • Typ av Lightning-sida: Mobilanvändare kan komma åt app- och postsidor, men inte startsidor.

    Obs! Postsidor måste vara associerade med en specifik typ av post.

  • Om du använder samma sida för både dator- och mobilanvändare ska du välja Aktivering för att verifiera att Lightning-sidan är inställd som Organisationsstandard för både dator- och telefonformfaktorer.
  • Överväg att skapa separata Lightning-sidor för dator- och mobilanvändare för att skapa en skräddarsydd visuell upplevelse. Tableau-vykomponenten har en fast höjd och kommer inte att anpassas dynamiskt till olika skärmstorlekar.
  • Om du vill lägga till en rullningslist för en vy väljer du Visa verktygsfält i egenskapsrutan för Tableau-vykomponenten.
  • För sidtypen väljer du Aktivering och därefter fliken Lightning-upplevelse. Lägg till din sida i LightningBolt-listan för att göra sidan lättare att hitta på mobila enheter.
  • På mobila enheter blockerar iOS trafik mellan webbplatser som standard. Öppna dina mobilinställningar, välj Salesforce-inställningar och aktivera Tillåt spårning mellan webbplatser. Mer information finns i Enable Cross-Website Tracking (iOS)(Länken öppnas i ett nytt fönster) (Aktivera spårning mellan webbplatser (iOS)).

Felsökning av friktionsfri autentisering av LWC för Tableau-vy

Verifiera Salesforce- och Tableau-konfigurationen

  1. Verifiera att värdena för Utfärdarens URL och JWKS URI matchar i både Salesforce- och Tableau-inställningarna och att JWKS URI slutar med id/nycklar.

    • För Tableau Cloud, öppna Salesforce-inställningssidan för Tableau-inbäddning i en flik. Öppna fliken Anslutna program under Tableau-inställningar i en annan flik. På fliken Anslutna program väljer du Extern auktoriseringsserver och därefter Redigera. Verifiera att värdena för Utfärdarens URL och JWKS URI matchar och att JWKS URI slutar med id/nycklar.
    • För Tableau Server, öppna Salesforce-inställningssidan för Tableau-inbäddning i en flik. Logga sedan in i webbgränssnittet för Tableau Services Manager (TSM), navigera till Användaridentitet och åtkomst och öppna fliken Auktoriseringsserver.

  2. Verifiera värdmappning: Om du har sparat en värdmappning ska du kontrollera att den har rätt plats-ID och värdtyp.

Verifiera JWT-token

Välj Felsökningsläge i egenskapsredigeraren för Lightning-webbkomponenten för Tableau-vyer för att verifiera att JWT-token fungerar som förväntat.

  1. Öppna konsolloggarna och kopiera token.
  2. Gå till webbplatsen jwt.io(Länken öppnas i ett nytt fönster) och klistra in token i fältet Encoded (Kodad).
  3. Verifiera följande:
    • Ämnet (”sub”) matchar Tableau-användarnamnet.
    • För Tableau Cloud är målgruppen (”aud”) ”tableau+SiteID”.
      För Tableau Server är målgruppen (”aud”) ”tableau”.
    • Omfattningen (”scp”) inkluderar både ”tableau:views:embed” och ”tableau:insights:embed”.
    • Utfärdaren (”iss”) – EAS-servern – är korrekt.

Verifiera sidaktivering

Ibland skapar en användare en Lightning-sida utan att aktivera eller tilldela den någonstans, vilket gör att andra användare inte kan hitta den. Välj Aktivering för att verifiera att Lightning-sidan är inställd som Organisationsstandard för de avsedda formfaktorerna.

Tips Vid felsökning kan det hjälpa att dra och släppa en Rich Text-komponent på din sida. Lägg till en kort beskrivning av sidtypen och vy-URL:en som du försöker bädda in. Det gör att du kan vara säker på att sidan som slutanvändaren ser är den sida som administratören redigerar.

Bekräfta att Lightning-webbkomponenten för Tableau-vyer fungerar utan friktionsfri autentisering (endast Lightning-webbkomponenten för Tableau-vyer)

  1. Avmarkera kryssrutan för Standardautentiseringstoken i Tableau-vyrutan på din Lightning-sida och spara ändringarna.
  2. Logga ut om du är inloggad i Tableau på en annan flik. Kontrollera att vy-URL:en omdirigerar dig till Tableau-inloggningssidan. Logga inte in.
  3. Gå till Lightning-sidan. Lightning-webbkomponenten för Tableau-vyer bör visa knappen Logga in i Tableau.
  4. Välj Logga in i Tableau och ange dina Tableau-inloggningsuppgifter för att logga in.
    Obs! Om vyn inte läses in indikerar det ett mer omfattande problem än Tableau-autentisering.

Fel: Lightning-webbkomponentversionen stöds inte längre (endast Lightning-webbkomponenten för Tableau-vyer)

Gör följande för att åtgärda felet:

  1. Sök efter ”Tableau” i komponentlistan och dra därefter komponenten Tableau-vy till sidan.
  2. Kopiera alla egenskaper för den gamla komponenten från Tableau-vyrutan till den nya komponenten.
  3. Välj raderingsikonen för den gamla komponenten.

Se även

Felsöka anslutna program(Länken öppnas i ett nytt fönster)

Registrera extern auktoriseringsserver för att aktivera enkel inloggning för inbäddat innehåll

Tillbaka till toppen
Tack för din feedback!Din feedback har skickats in. Tack!