http://MY-SERVER/users.xml) non sono disponibili a causa di una modifica ai processi di Tableau Server. Gli utenti che dipendono da questi endpoint devono convertire il proprio codice per utilizzare l'API REST.
In Tableau Server 9.3, il processo wgserver è disabilitato per impostazione predefinita. Le chiamate API REST vengono gestite da un processo diverso. Per continuare a utilizzare endpoint XML in Tableau Server 9.3, devi abilitare in modo esplicito il processo tramite i seguenti comandi:
tabadmin stop
tabadmin set wgserver.enabled true
tabadmin set wgserver.xmlapi.enabled true
tabadmin set worker0.wgserver.procs 1
tabadmin configure
tabadmin start
Importante: a partire da Tableau Server 10.0, il processo wgserver è stato completamente rimosso e non sarai più in grado di utilizzare gli endopoint XML.
Poiché abbiamo esteso la nuova funzionalità all'API REST, gli endpoint XML sono sempre meno necessari. Le informazioni restituite dagli endpoint XML adesso sono disponibili tramite l'API REST o sono state definite come funzionalità per le quali attualmente non è richiesto un endpoint API.
Non esiste necessariamente un mapping uno per uno tra un endpoint XML e un'API REST; ad esempio, un endpoint XML potrebbe aver restituito informazioni in un formato diverso rispetto alle informazioni restituite da un metodo API REST.
Nella seguente tabella sono illustrati gli equivalenti tra i gli endpoint XML e i metodi API REST.
| Endopoint XML | Metodo/i API REST |
|---|---|
auth.xml | Sign In |
data_connections.xml | Query Workbook Connections |
datasources.xml | Query Datasources |
groups.xml | Query Groups |
projects.xml | Query Projects |
schedules.xml | Query Schedules |
site_tasks.xml | Query Extract Refresh Tasks |
sites.xml | Query sui siti |
tags.xml | Query sull'origine dati |
tasks.xml | Query Extract Refresh Tasks |
users.xml | Ottenere gli utenti nel gruppo |
views.xml | Query sulle viste per il sito |
workbooks.xml | Query sulla cartella di lavoro |
Con un'eccezione (vedi sezione successiva), se un endpoint non è elencato nella tabella precedente, non esiste alcun equivalente nell'API REST.
L'endpoint systeminfo.xml continua a essere disponibile. Questo endpoint fornisce informazioni sullo stato corrente dei processi del server. Per ulteriori informazioni, vedi Ottenere lo stato del processo come XML nella documentazione di Tableau Server.
Ai fini di prestazioni migliori, di scalabilità e per altri motivi, occasionalmente i componenti di Tableau Server vengono riprogettati. In quest'ottica, il processo Server API (wgserver) non è più richiesto in Tableau Server. La funzionalità originariamente fornita da tale componente adesso è incorporata in altri componenti.
In numerose versioni di Tableau Server era incluso il processo wgserver, progettato per facilitare la gestione dei contenuti. Uno degli effetti collaterali del modo in cui questo processo è stato implementato è dato dal fatto che Tableau Server ha consentito agli utenti di effettuare richieste agli enpoint XML. Ad esempio, gli utenti sono stati in grado di effettuare richieste come quella riportata di seguito, che hanno restituito informazioni sugli utenti definiti nel server:
http://MY-SERVER/users.xml
Gli endpoint XML non sono mai stati documentati né supportati. Se la funzionalità dell'applicazione di cui disponi dipende da questi endpoint, devi aggiornare il codice per utilizzare invece l'API REST.
Come hai potuto notare, gli endpoint XML non erano supportati; erano un effetto collaterale della modalità di implementazione di wgserver. Poiché non erano supportati, non abbiamo aggiornato gli endpoint per far posto alla nuova funzionalità sul server, né abbiamo corretto i bug. Inoltre, talvolta gli endpoint XML non erano stabili: ad esempio, la richiesta di set di dati molto grandi utilizzando un endpoint XML poteva generare errori o interruzioni.