BASE DE CONOCIMIENTO

Extremos XML no disponibles en Tableau Server


Publicado: 15 Mar 2017
Fecha de la última modificación: 20 Jul 2023

Pregunta

Desde el lanzamiento de la versión 10.0 de Tableau Server en agosto de 2016, los extremos XML (como, por ejemplo, http://MY-SERVER/users.xml) no han estado disponibles debido a un cambio en los procesos de Tableau Server. Los usuarios que dependen de estos extremos deberían modificar su código para utilizar el API de REST.

Entorno

  • Tableau Server 10.0 y posteriores
  • Extremos XML

Respuesta

Estado en las versión actual y futuras de Tableau Server

En Tableau Server 9.3, el proceso wgserver está deshabilitado de forma predeterminada. (Las llamadas del API de REST se gestionan en un proceso distinto). Si desea seguir utilizando los extremos XML en Tableau Server 9.3, debe habilitar explícitamente el proceso con los comandos siguientes:

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 partir Tableau Server 10.0, el proceso wgserver se ha eliminado por completo y no podrá utilizar los extremos XML en absoluto.

Paridad de extremos XML

Como hemos ampliado el API de REST con la nueva funcionalidad, la necesidad de usar los extremos XML es cada vez menor. La información devuelta por los extremos XML ahora está disponible utilizando los API de REST o se ha determinado para que no sea la funcionalidad que actualmente necesita un extremo API.

No existe necesariamente una relación de uno a uno de mapeo entre el extremo XML y un API de REST; por ejemplo, un extremo XML puede haber devuelto información en un formato distinto a cómo devuelve la información el método de API de REST.

La tabla siguiente muestra las equivalencias entre los extremos XML y los métodos de API de REST.

Extremo XMLMétodos API de REST
auth.xmlSign In
data_connections.xmlQuery Workbook Connections
datasources.xmlQuery Datasources
groups.xmlQuery Groups
projects.xmlQuery Projects
schedules.xmlQuery Schedules
site_tasks.xmlQuery Extract Refresh Tasks
sites.xmlConsultar sitios
Consultar sitio
tags.xmlConsultar fuente de datos
Consultar libro de trabajo
Consultar libro de trabajo para el usuario
tasks.xmlQuery Extract Refresh Tasks
users.xmlObtener usuarios de un grupo
Obtener usuarios en un sitio
views.xmlConsultar vistas del sitio
Consultar vistas del libro de trabajo
workbooks.xmlConsultar libro de trabajo
Consultar libro de trabajo para el usuario

Con una excepción (consulte la sección siguiente), si un extremo no está incluido en la tabla anterior, no existe ningún equivalente en el API de REST.

systeminfo.xml

El extremo systeminfo.xml sigue estando disponible. Este extremo proporciona información sobre el estado actual de los procesos del servidor. Para obtener más información, consulte Obtener el estado de proceso como XML en la documentación de Tableau Server.

Información adicional

Segundo plano

Los componentes de Tableau Server ocasionalmente se rediseñan para obtener un mejor rendimiento, escalabilidad o por otros motivos. A parte de este intento, el proceso del servidor de API (wgserver) ya no es necesario en Tableau Server. La funcionalidad originalmente proporcionada por este componente ahora se ha integrado en otros componentes.

Extremos XML

A lo largo de diversas versiones, Tableau Server ha incluido el proceso wgserver, el cual fue diseñado para facilitar la gestión del contenido. Un efecto secundario de cómo se implementó este proceso es que Tableau Server dejaba que los usuarios realizasen solicitudes a los extremos XML. Por ejemplo, los usuarios han podido realizar solicitudes como la siguiente, la cual devolvía información sobre los usuarios definidos en el servidor:

http://MY-SERVER/users.xml

Los extremos XML nunca se documentaron ni fueron compatibles. Si dispone de una funcionalidad de aplicación que dependa de estos extremos, debe actualizar el código para utilizar el REST API en su lugar.

Motivos para el cambio

Como se indica, los extremos XML no eran una característica compatible; eran un efecto secundario de la forma en la que se implementó wgserver. Como no eran compatibles, no realizamos ninguna acción para actualizar los extremos y así acomodar la nueva funcionalidad del servidor ni corregimos los errores. Además, como los extremos XML en ocasiones eran inestables, acciones como, por ejemplo, solicitar conjuntos de datos de gran tamaño utilizando un extremo XML podía generar errores o que se colgara.

¿Fue de ayuda este artículo para resolver el problema?