Naadloze verificatie van Tableau Lightning-webcomponenten configureren

Met Tableau Lightning-webcomponenten (LWC) kunnen Salesforce-klanten Tableau-weergaven en Tableau Pulse-statistieken naar Salesforce Lightning-pagina's slepen.

  • Met het Tableau View-component kunt u ingesloten weergaven toevoegen vanuit Tableau Cloud of Tableau Server.
  • Met het Tableau Pulse-component kunt u ingesloten Tableau Pulse-statistieken toevoegen vanuit Tableau Cloud.

Met de naadloze verificatie van Tableau LWC kunt u Tableau-inhoud bekijken met behulp van vertrouwde tokens voor verbonden apps, zonder dat u zich hoeft aan te melden. Naadloze verificatie is optioneel voor Tableau View LWC en vereist voor Tableau Pulse LWC.

Vertrouwde URL toevoegen

De Tableau-weergave of Pulse-URL die u aan uw Lightning-pagina wilt toevoegen, moet worden toegevoegd als een vertrouwde URL.

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
  2. Voer in het linker navigatiedeelvenster Vertrouwde URL's in in de zoekbalk Snel zoeken.
  3. Selecteer de instellingenpagina voor Vertrouwde URL's.
  4. Selecteer Nieuwe vertrouwde URL.
  5. Voer een API-naam en URL in en volg de instructies op de instellingenpagina. Opmerking: de URL moet beginnen met https://
  6. Selecteer voor CSP-context Alles.
  7. Vink voor CSP-richtlijnen alle vakjes aan.
  8. Selecteer Opslaan.

Tableau LWC's inschakelen en naadloze verificatie instellen

Salesforce-instellingen configureren

De volgende stappen hoeven slechts één keer door een Salesforce-beheerder te worden uitgevoerd:

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
  2. Voer in het linker navigatiedeelvenster Tableau in in de zoekbalk Snel zoeken.
  3. Selecteer de instellingenpagina voor Tableau Embedding.
  4. Selecteer de selectievakjes voor Tableau Lightning-webcomponenten inschakelen en Tokengebaseerde verificatie met eenmalige aanmelding inschakelen.

    Opmerking: beide vakjes moeten worden aangevinkt om de Tableau Pulse LWC te configureren. Voor de Tableau View LWC kunt u ervoor kiezen om geen tokenverificatie in te stellen en u in plaats daarvan handmatig aan te melden wanneer het component wordt geladen.

    Om Tableau View LWC op mobiel te gebruiken, moet u tokengebaseerde verificatie inschakelen en naadloze verificatie instellen.

  5. Voor Het veld Tableau-gebruikersidentiteit selecteren, stelt u een gebruikersveld op organisatieniveau in om de gebruiker in Tableau te verifiëren. U moet het Salesforce-gebruikersveld selecteren dat overeenkomt met de Tableau-gebruikersnaam. In de vervolgkeuzelijst wordt de veldwaarde voor de huidige gebruiker weergegeven, of null als er geen waarde is gedefinieerd. Als geen van de gebruikersvelden overeenkomt met de Tableau-gebruikersnaam, selecteert u een leeg veld (bijvoorbeeld Federatie-ID of een aangepast veld). Vul vervolgens het lege veld in met de Tableau-gebruikersnaam van uw gebruikers.

    Opmerking: de instelling voor het veld Tableau-gebruikersidentiteit geldt voor alle gebruikers en hoeft niet per individu te worden ingesteld.

  6. Sla uw wijzigingen op.
  7. Als u de Tableau-beheerder bent, houdt u het Salesforce-instellingentabblad Tableau Embedding open terwijl u in de volgende sectie de Tableau-instellingen configureert. Als u niet de beheerder bent, deel dan de Probleem-URL en JWKS-URI met uw Tableau-beheerder.

Tableau-instellingen configureren

Open in één tabblad de instellingenpagina voor Tableau Embedding in uw Salesforce-organisatie. Ga in een ander tabblad naar uw Tableau-site en volg deze instructies om de verbonden app in te stellen.

Volg voor Tableau Server deze stappen:

  1. Meld u als Tableau Server-beheerder aan bij de webinterface van Tableau Services Manager (TSM).
  2. Navigeer naar Gebruikersidentiteit en toegang en selecteer vervolgens het tabblad Autorisatieserver.
  3. Schakel het selectievakje OAuth-toegang inschakelen voor ingesloten inhoud in.
  4. Ga naar de Probleem-URL en JWKS-URI, die u kunt vinden op de instellingenpagina voor Tableau Embedding in uw Salesforce-organisatie. Gebruik de knop Kopiëren op de instellingenpagina voor de Salesforce-organisatie om de waarde van de Uitgever-URL te kopiëren en deze vervolgens in de TSM-webinterface te plakken. Herhaal dit proces voor de JWKS URI-waarde.
  5. Opmerking: het JWKS URI-veld is gemarkeerd als optioneel in de TSM-webinterface, maar deze waarde is vereist om naadloze verificatie in Tableau LWC te gebruiken.

  6. Selecteer Lopende wijzigingen opslaan.
  7. Selecteer rechtsboven op de pagina Lopende wijzigingen en vervolgens Wijzigingen toepassen en opnieuw opstarten om Tableau Server te stoppen en opnieuw op te starten.

Zie Uw EAS registreren met Tableau Server(Link wordt in een nieuw venster geopend) voor meer informatie.

Volg voor Tableau Cloud deze stappen:

  1. Open de pagina Instellingen van Tableau en kies vervolgens het tabblad Verbonden apps.
  2. Selecteer in de vervolgkeuzelijst Nieuwe verbonden app OAuth 2.0-vertrouwensrelatie.
  3. Voer in het dialoogvenster Verbonden app maken de Probleem-URL en JWKS-URI in, die u kunt vinden op de instellingenpagina voor Tableau View-insluiting in uw Salesforce-organisatie. Gebruik de knop Kopiëren op de instellingenpagina voor de Salesforce-organisatie om de waarde van de Uitgever-URL te kopiëren en deze vervolgens in de Tableau-instellingenpagina te plakken. Herhaal dit proces voor de JWKS URI-waarde.
  4. Belangrijk: in het dialoogvenster Verbonden app maken wordt het veld JWKS URI als optioneel aangemerkt. Deze waarde is echter vereist om naadloze verificatie via Tableau LWC te gebruiken.

  5. Schakel het selectievakje Verbonden app inschakelen in.
  6. Selecteer Maken.
  7. Opmerking: de verbonden app heet Externe autorisatieserver.

Zie Uw EAS registreren met Tableau Cloud(Link wordt in een nieuw venster geopend) voor meer informatie.

Als u een hosttoewijzing voor deze site wilt maken, laat u het tabblad Verbonden apps open. U kunt de URL voor deze pagina en de knop Site-ID kopiëren gebruiken om de hosttoewijzingsvelden in de volgende sectie in te vullen.

Hosttoewijzing instellen of bewerken

Volg deze stappen om een hosttoewijzing te maken of te bewerken.

Tip: de instelling voor het veld Tableau-gebruikersidentiteit geldt voor alle gebruikers en hoeft niet per individu te worden ingesteld.

Een nieuwe hosttoewijzing maken

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
  2. Voer in het linker navigatiedeelvenster Tableau in in de zoekbalk Snel zoeken.
  3. Selecteer de instellingenpagina voor Tableau Embedding.
  4. Selecteer in de sectie Tableau-hosttoewijzing Nieuwe maken.
  5. Vul de gegevens van de hosttoewijzing in:
    1. Tableau-site-URL: voer een URL in voor de Tableau-site die u wilt toewijzen. De URL moet de sitenaam bevatten, tenzij het een installatie op locatie betreft die gebruikmaakt van de standaardsite. Opmerking: als u een hosttoewijzing voor deze site wilt maken, laat u het tabblad Verbonden apps open. U kunt de URL voor deze pagina en de knop Site-ID kopiëren gebruiken om de hosttoewijzingsvelden in de volgende sectie in te vullen.
    2. Tableau-site-ID: voer de site-ID in voor de Tableau-site die u wilt toewijzen. U kunt de knop Site-ID kopiëren op de instellingenpagina voor verbonden apps of in het dialoogvenster Delen gebruiken.
    3. Hosttype Tableau-site: selecteer Tableau Cloud of Tableau Server.
  6. Selecteer Opslaan. Of, als u wilt terugkeren naar de instellingenpagina van Tableau Embedding zonder op te slaan, selecteert u Annuleren.

Een hosttoewijzing bewerken

U kunt de site-ID en het hosttype voor een bestaande toewijzing bijwerken. Als u de site-URL moet wijzigen, verwijdert u de bestaande toewijzing en maakt u vervolgens een nieuwe toewijzing met de juiste URL.
  1. Selecteer op de instellingenpagina van Tableau Embedding in de Salesforce-app Bewerken naast een bestaande hosttoewijzing.
  2. Bewerk de velden Tableau-site-ID of Hosttype Tableau-site indien nodig.
  3. Selecteer Opslaan. Of, als u wilt terugkeren naar de instellingenpagina van Tableau Embedding zonder op te slaan, selecteert u Annuleren.

Tableau LWC's toevoegen aan een Lightning-pagina met behulp van Lightning-appsamensteller

Tableau LWC's zijn alleen beschikbaar op de pagina's App, Startpagina en Record Lightning. Zie Lightning-appsamensteller in de hulpsectie van Salesforce voor meer informatie over Lightning-paginatypen en het gebruik van de Lightning-appsamensteller.

Volg deze stappen om een Tableau View of Tableau Pulse LWC toe te voegen aan een bestaande Lightning-pagina:

  1. Navigeer naar de Lightning-pagina die u wilt bewerken.
  2. Selecteer het tandwielpictogram rechtsboven.
  3. Selecteer Pagina bewerken.
  4. Ga naar de sectie Een Tableau LWC toevoegen aan een Lightning-pagina hieronder.

Volg deze stappen om een Tableau View of Tableau Pulse LWC toe te voegen aan een nieuwe Lightning-pagina:

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
  2. Voer in het linker navigatiedeelvenster Lightning-appsamensteller in in de zoekbalk Snel zoeken.
  3. Selecteer de configuratiepagina Lightning-appsamensteller.
  4. Selecteer Nieuwe.
  5. Selecteer het paginatype dat u wilt maken. Tableau LWC's zijn beschikbaar op de pagina's App, Startpagina en Record.
  6. Selecteer Volgende.
  7. Voer een naam in, selecteer een opmaak voor de nieuwe pagina en selecteer vervolgens Gereed.

Een Tableau LWC toevoegen aan een Lightning-pagina

  1. Sleep vanuit de lijst Componenten aan de linkerkant van de pagina het Tableau View- of Tableau Pulse-component naar de pagina.
  2. De LWC configureren:

De pagina opslaan en activeren

  1. Wanneer u klaar bent met het toevoegen en configureren van een Tableau View of Tableau Pulse LWC, selecteert u Opslaan.
  2. Als u een nieuwe pagina hebt gemaakt, wordt u gevraagd de pagina te activeren, zodat deze zichtbaar is voor gebruikers. Selecteer Activeren.
  3. Op het tabblad Pagina-instellingen van de pagina Activering voert u een naam in, kiest u een pictogram en selecteert u uw zichtbaarheidsvoorkeur.
  4. (Optioneel) Op het tabblad Lightning Experience van de pagina Activering kunt u de pagina toevoegen aan verschillende Lightning Experience-apps.
  5. (Optioneel) Op het tabblad Mobiele navigatie van de pagina Activering kunt u de pagina toevoegen aan het mobiele navigatiemenu.
    Opmerking: Tableau Pulse LWC is niet beschikbaar op mobiel.
  6. Selecteer Opslaan.

Meerdere Tableau-weergaven insluiten

U kunt meer dan één Tableau-weergave op een Salesforce Lightning-pagina insluiten, zolang alle weergaven van dezelfde site afkomstig zijn. Tableau ondersteunt slechts één sessie en die sessie is specifiek voor de site. De meest recent toegekende sessie zal de vorige tenietdoen.

Als u Tableau-weergaven van meerdere sites wilt insluiten, moet u een afzonderlijke Lightning-pagina maken die sitespecifiek is.

Naadloze verificatie voor Tableau View LWC op mobiel

Opmerking: Tableau View LWC is beschikbaar op iOS 17.2.1 en hoger. Tableau Pulse LWC is momenteel niet beschikbaar op iOS of Android.

Houd rekening met de volgende best practices om problemen voor mobiele gebruikers te voorkomen:

  • Type Lightning-pagina: mobiele gebruikers hebben toegang tot de pagina's App en Record, maar niet tot Startpagina.

    Opmerking: recordpagina's moeten aan een specifiek recordtype worden gekoppeld.

  • Als u dezelfde pagina voor zowel desktop- als mobiele gebruikers gebruikt, selecteert u Activering om te controleren of de Lightning-pagina is ingesteld als de standaardinstelling voor de organisatie, zowel voor desktop- als telefoonvormfactoren.
  • Overweeg om aparte Lightning-pagina's voor desktop en mobiel te maken om een op maat gemaakte visuele ervaring te bieden. De hoogte voor het Tableau View-component staat vast en wordt niet dynamisch aangepast aan verschillende schermformaten.
  • Om een schuifbalk aan een weergave toe te voegen, selecteert u Werkbalk tonen in het eigenschappenvenster van het Tableau View-component.
  • Selecteer voor het paginatype App Activering en vervolgens het tabblad Lightning Experience. Voeg uw pagina toe aan de LightningBolt-lijst, zodat deze gemakkelijker te vinden is op mobiele apparaten.
  • Op mobiele apparaten blokkeert iOS standaard verkeer tussen websites. Open uw mobiele instellingen, selecteer Salesforce-instellingen en schakel vervolgens Tracking tussen websites toestaan in. Zie Tracking tussen websites inschakelen(Link wordt in een nieuw venster geopend) voor meer informatie.

Problemen oplossen met naadloze verificatie voor Tableau View LWC

De Salesforce- en Tableau-configuratie verifiëren

  1. Verifieer of de waarden Uitgever-URL en JWKS-URI overeenkomen in zowel de Salesforce- als Tableau-instellingen en dat de JWKS-URI eindigt op ID/codes.

    • Voor Tableau Cloud opent u de Salesforce-instellingenpagina voor Tableau Embedding in één tabblad. Open in een ander tabblad de Tableau-instellingen van de verbonden apps. Selecteer op het tabblad Verbonden apps Externe autorisatieserver en vervolgens Bewerken. Verifieer of de waarden Uitgever-URL en JWKS-URI overeenkomen en dat de JWKS-URI eindigt op ID/codes.
    • Voor Tableau Server opent u de Salesforce-instellingenpagina voor Tableau Embedding in één tabblad. Meld u vervolgens aan bij de webinterface van Tableau Services Manager (TSM), navigeer naar Gebruikersidentiteit en toegang en open het tabblad Autorisatieserver.
  2. Hosttoewijzing verifiëren: als u een hosttoewijzing hebt opgeslagen, verifieert u of deze de juiste site-ID en het juiste hosttype heeft.

Het JWT-token verifiëren

Selecteer in de eigenschappenbewerker van het Tableau View Lightning-webcomponent de Foutopsporingsmodus om te verifiëren of het JWT-token werkt zoals verwacht.

  1. Open de consolelogboeken en kopieer het token.
  2. Ga naar de website jwt.io(Link wordt in een nieuw venster geopend) en plak het token in het veld Gecodeerd.
  3. Verifieer het volgende:
    • Het onderwerp ('sub') komt overeen met de Tableau-gebruikersnaam.
    • Voor Tableau Cloud is het publiek ('aud') 'tableau+SiteID'.
      Voor Tableau Server is het publiek ('aud') 'tableau'.
    • Het bereik ('scp') omvat zowel tableau:views:embed als tableau:insights:embed.
    • De EAS-server van de uitgever ('iss') is juist.

Pagina-activering verifiëren

Soms maakt een gebruiker een Lightning-pagina, maar is deze nog nergens geactiveerd of toegewezen, waardoor gebruikers deze niet kunnen vinden. Selecteer Activering om te verifiëren of de Lightning-pagina is ingesteld als de organisatiestandaard voor de gewenste vormfactoren.

Tip: bij het opsporen van fouten is het handig om een RTF-tekstcomponent naar uw pagina te slepen. Voeg een korte beschrijving toe van het paginatype en de weergave-URL die u probeert in te sluiten. Zo weet u zeker dat de pagina die de eindgebruiker bekijkt ook de pagina is die de beheerder bewerkt.

Bevestigen dat Tableau View LWC werkt zonder naadloze verificatie (alleen Tableau View LWC)

  1. Schakel in het deelvenster Tableau View op uw Lightning-pagina het selectievakje uit voor Standaardverificatietoken en sla de wijzigingen op.
  2. Als u via een ander tabblad bent aangemeld bij Tableau, meldt u zich af. Zorg ervoor dat u door naar de URL voor weergave te navigeren, wordt doorgestuurd naar de aanmeldingspagina van Tableau. Meld u niet aan.
  3. Navigeer naar de Lightning-pagina. De Tableau View LWC zou een knop Aanmelden bij Tableau moeten weergeven.
  4. Selecteer Aanmelden bij Tableau en voer vervolgens uw Tableau-referenties in om u aan te melden.
    Opmerking: als de weergave niet wordt geladen, duidt dit op een groter probleem met de authenticatie bij Tableau.

Fout: LWC-componentversie wordt niet meer ondersteund (alleen Tableau View LWC)

Om deze fout op te lossen, volgt u deze stappen:

  1. Zoek in de lijst Componenten naar Tableau en sleep vervolgens een nieuw Tableau View-component naar de pagina.
  2. Kopieer alle eigenschappen van het Tableau View-venster voor het oude component naar het nieuwe component.
  3. Selecteer het verwijderpictogram op het oude component.

Zie ook

Problemen met verbonden apps oplossen(Link wordt in een nieuw venster geopend)

EAS registreren om SSO voor ingesloten inhoud in te schakelen

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.