Web Data Connectors in Tableau Server
Web Data Connectors (WDC's) zijn webpagina's die een dataverbinding bieden die toegankelijk is via HTTP voor databronnen die nog geen connector in Tableau hebben. Met WDC's kunnen gebruikers verbinding maken met vrijwel alle data die via internet toegankelijk zijn en extracten voor hun werkmappen maken. Databronnen voor een WDC kunnen interne webservices, JSON-data, REST API's en andere bronnen omvatten die beschikbaar zijn via HTTP of HTTPS. Gebruikers kunnen hun eigen WDC maken of connectoren gebruiken die door anderen zijn gemaakt.
Zie Web Data Connector(Link wordt in een nieuw venster geopend) in de Tableau Desktop-documentatie voor informatie over het gebruik van een WDC in Tableau Desktop.
Zie documentatie over Web Data Connector op Github voor informatie over het maken van een WDC.
Voordat u connectors uitvoert op Tableau Server
Uit veiligheidsoverwegingen voert Tableau Server geen WDC's uit tenzij u de connector goedkeurt, zoals uitgelegd in dit onderwerp.
Opmerking: U moet een serverbeheerder zijn om WDC's goed te keuren voor gebruik op Tableau Server.
Voor WDC's is uw goedkeuring vereist, omdat ze uitvoerbare code bevatten en doorgaans verzoeken naar websites van derden sturen. Voordat een gebruiker een WDC kan gebruiken met Tableau Server, moet u het domein en de poort die door de connector worden gebruikt toevoegen aan een acceptatielijst, en ook de domeinen waar een connector aanvragen naartoe kan sturen en van kan ontvangen op een secundaire acceptatielijst. Voordat u dit doet, raden wij u aan de connector te controleren en te testen, zodat u weet wat de connector doet en met welke sites deze verbinding maakt. Zie Web Data Connectors testen en doorlichten voor meer informatie.
Wanneer u een connector aan de acceptatielijsten toevoegt, configureert u Tableau Server om verbindingen toe te staan met een bepaalde URL waar de connector wordt gehost en vanaf een URL die de connector kan opvragen. Dit is de enige manier om Tableau Server toe te staan WDC's uitvoeren. De connectoren kunnen vervolgens worden gehost op een server binnen de firewall van uw organisatie of op een extern domein. Het importeren van WDC's wordt niet ondersteund voor Tableau Server.
Connectoren op een acceptatielijst beheren
Om een WDC aan de acceptatielijst toe te voegen, gebruikt u de opdracht tsm data-access web-data-connectors add
. Met deze opdracht en de hieronder beschreven gerelateerde opdrachten kunt u de volgende taken uitvoeren:
Voeg WDC's toe aan de acceptatielijst en de secundaire acceptatielijst.
Sta alle WDC's of WDC-vernieuwingen toe of weiger ze.
Verwijder een of meer connectoren van de acceptatielijst.
Geef alle WDC's op de acceptatielijst en de secundaire acceptatielijst weer.
Voor het bijwerken van WDC-acceptatielijsten is een herstart van de server vereist
Nadat u opdrachten hebt uitgevoerd die wijzigingen aanbrengen in WDC's, moet u uw openstaande wijzigingen toepassen met behulp van de tsm pending-changes apply
-opdracht.
Als voor de in behandeling zijnde wijzigingen de Server opnieuw moet worden opgestart, geeft de opdracht pending-changes apply
een prompt weer om u te laten weten dat de server opnieuw wordt gestart. Deze prompt verschijnt ook als de server is gestopt, maar in dat geval vindt er geen herstart plaats. U kunt de prompt onderdrukken met de optie --ignore-prompt
, maar dit verandert niets aan het herstartgedrag. Als opnieuw opstarten niet nodig is voor de wijzigingen, worden de wijzigingen zonder waarschuwing van een prompt toegepast. Zie tsm pending-changes apply voor meer informatie.
Connectors toevoegen aan de acceptatielijst en de secundaire acceptatielijst
Als u een connector aan de acceptatielijst en de secundaire acceptatielijst wilt toevoegen, gebruikt u de opdracht tsm data-access web-data-connectors add, waarbij u de naam, de URL van de acceptatielijst en de URL's van de secundaire acceptatielijst opgeeft. U kunt WDC's ook beheren met behulp van de web-data-connector-settings-entiteit. Nadat u deze opdracht hebt uitgevoerd, moet u uw openstaande wijzigingen toepassen met behulp van de opdracht tsm pending-changes apply
. Een prompt waarschuwt u dat de opdracht Tableau Server opnieuw zal starten. Als Tableau Server momenteel actief is, wordt deze opnieuw gestart, en als het wordt gestopt, blijft deze in de gestopte staat zonder opnieuw te starten.
tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*
Opmerkingen over opmaak:
- Zorg ervoor dat u rechte aanhalingstekens (" en ') gebruikt, en geen gekrulde of "slimme" aanhalingstekens, rond de naam van de WDC. Gebruik dubbele aanhalingstekens (") als de naam een spatie bevat.
- Voor veel WDC's is de opgegeven poort voor de
--url
-optie 443 of 80, maar u kunt de waarde voor uw connector controleren door naar de databrondetails op Tableau Server te kijken. U moet het poortnummer opgeven als onderdeel van de URL als de WDC gebruikmaakt van SSL (HTTPS). Als u bijvoorbeeld de standaardpoort voor HTTPS wilt gebruiken, kan de URL er als volgt uitzien:https://example.com:443/WDC/
. - Er moet een URL of een door komma's gescheiden lijst met URL's worden opgegeven voor de
--secondary
-optie, die de domeinen aangeeft die de bibliotheken en bronnen leveren waartoe de WDC toegang moet hebben. Deze optie kan niet worden weggelaten of leeg worden gelaten, tenzij het WDC geen secundaire domeinen gebruikt. Als u niet weet of de WDC secundaire domeinen gebruikt, of wat de secundaire domeinen zijn, moet u mogelijk contact opnemen met de ontwikkelaar van de WDC. U kunt er ook voor kiezen om de jokerteken-URL'shttp://.*
enhttps://.*
te gebruiken om alle domeinen toe te staan. We raden u echter ten zeerste aan specifiekere URL's te gebruiken voor betere beveiliging. - Als u een volledig domein aan de secundaire acceptatielijst wilt toevoegen, sluit u de domein-URL af met een jokertekenexpressie. Gebruik
.*
als jokerteken om het hele domein aan te geven, zoals in het volgende voorbeeld:https://example.com/.*
.
WDC's of WDC-extractvernieuwingen toestaan of weigeren
Om WDC's of WDC-extractvernieuwingen toe te staan of te weigeren, gebruikt u de opdracht tsm data-access web-data-connectors allow
met de opties -t
of -r
. Standaard zijn WDC's en WDC-extractvernieuwingen toegestaan. Als u deze instelling wijzigt, moet u de opdracht tsm pending-changes apply
uitvoeren. Zie tsm data-access web-data-connectors allow
voor meer informatie over de opdracht en de opdrachtopties.
Een of meer WDC's van de acceptatielijst verwijderen
Om een of meer WDC's van de acceptatielijst te verwijderen, gebruikt u de opdracht tsm data-access web-data-connectors delete
. Als u deze instelling wijzigt, moet u de opdracht tsm pending-changes apply
uitvoeren. Zie tsm data-access web-data-connectors delete
voor meer informatie.
Alle WDC's op de acceptatielijst weergeven
Om alle WDC's op de acceptatielijst weer te geven, gebruikt u de opdracht tsm data-access web-data-connectors list
. Zie tsm data-access web-data-connectors list
voor meer informatie.
Het extract voor een connector vernieuwen
Wanneer een gebruiker een werkmap maakt die gebruikmaakt van een WDC, maakt Tableau Server een extract van de data die door de connector worden geretourneerd. Als de gebruiker vervolgens de werkmap publiceert, verzendt het publicatieproces de werkmap en het dataextract naar de server.
Tableau kan een extract vernieuwen dat door een WDC is gemaakt, net zoals het elk ander extract kan vernieuwen. Als de connector referenties vereist voor aanmelding bij de webgebaseerde databron, moet u ervoor zorgen dat de referenties zijn ingesloten in de databron en dat de WDC op de acceptatielijst voor de server staat. Tableau Server kan het extract niet vernieuwen als de connector referenties vereist en deze niet zijn ingesloten in de databron. Dit komt doordat de vernieuwing volgens een planning of in een andere achtergrondcontext kan plaatsvinden en de server niet om referenties kan vragen.
Momenteel is er geen manier om een databron rechtstreeks vanuit Tableau Server opnieuw te verifiëren. Als de databron referenties heeft die verlopen zijn of is gepubliceerd zonder dat de referenties zijn ingesloten, moeten de werkmap en het dataextract opnieuw worden gepubliceerd met de nieuwe ingesloten referenties.
Als het achtergrondproces dat de vernieuwingsbewerking uitvoert, mislukt, wordt er een waarschuwing en een logboekvermelding gegenereerd waarin dit probleem wordt aangegeven. Gebruikers kunnen zien dat de tijdstempel op het extract niet verandert.
Om vernieuwing voor alle WDC's uit te schakelen, gebruikt u de opdracht tsm data-access web-data-connectors allow -r false
.
Problemen oplossen
Als de server problemen ondervindt bij het toevoegen van connectoren aan de acceptatielijst, kunt u de logboekbestanden bekijken. Zorg ervoor dat u de logboekbestanden controleert op zowel het initiële serverknooppunt als op de andere knooppunten waarop het gatewayproces wordt uitgevoerd. Zie Tableau Server-logboeken en locaties van logboekbestanden voor meer informatie over logboekbestanden.
Als het probleem is dat Tableau Server een extract dat is gemaakt door een WDC niet vernieuwt, zorg er dan voor dat de configuratie-instelling webdataconnector.refresh.enabled
is ingesteld op true
. Als deze is ingesteld op false
, voert u de volgende opdracht uit om extractvernieuwingen toe te staan voor alle WDC's op de server:
tsm data-access web-data-connectors allow -r true
Opmerking: De acceptatielijst is de enige manier om Tableau Server toe te staan om Web Data Connectors uit te voeren. Het importeren van Web Data Connectors is verouderd vanaf versie 10.5.