Ayuda de Tableau Server

Comentarios

Transcripción

Ayuda de Tableau Server
Bienvenido a Tableau Server
Como complemento de Tableau Desktop Professional Edition, Tableau Server le permite a
usted y otras personas compartir descubrimientos mediante una experiencia interactiva y
colaborativa. Las personas que usan Tableau Desktop pueden crear representaciones
visuales de datos para responder preguntas desde simples a complejas. Estas
representaciones se denominan vistas. Con Tableau Server, los autores pueden publicar
libros de trabajo llenos de vistas para que otros puedan ver e interactuar con los datos.
Cómo usar la ayuda
Cuando necesite ayuda, haga clic en el menú Ayuda en la parte superior de la página. Se
abre un menú con temas relevantes a la página en que se encuentra.
Versión: 8.1 | Actualizado el 25.10.2013
Iniciar sesión
En la mayoría de los casos debe tener una cuenta en Tableau Server para publicar y navegar.
Además, se le debe asignar un nivel de licencia de visor o interaccionador. Los
administradores configuran las cuentas. Se basan en su cuenta de usuario de Windows,
mediante Active Directory o en el sistema de administración de usuarios interno de Tableau
Server. Comuníquese con su administrador si no conoce su nombre de usuario o contraseña.
A veces, según la configuración de servidor, su sesión iniciará automáticamente. Si inicia
sesión automáticamente como la persona incorrecta, puede cambiar a su cuenta al hacer clic
en Cerrar sesión en el menú del servidor en la esquina superior derecha de la página:
Si se le solicita iniciar sesión, ingrese su nombre de usuario y contraseña y haga clic en Iniciar
sesión.
Recuerdo de nombre de usuario
Seleccionar la casilla de verificación Recordarme en la página Tableau Server Inicio de
sesión llenará su nombre de usuario cada vez que visite el servidor. Esta opción facilita el
acceso rápido a su cuenta. Aún necesitará ingresar su contraseña en cada visita para poder
iniciar sesión. Cuando se selecciona Recordarme en el inicio de sesión, Tableau Server crea
una cookie de nombre de usuario para recordarlo cuando vuelva al sitio desde la misma
computadora. Para detener el llenado automático de su nombre de usuario, borre las cookies
de su navegador.
Tableau Server siempre almacena cookies de sesión cuando inicia sesión, haya seleccionado
Recordarme o no. Por ello, su navegador debe estar configurado para admitir cookies de
origen.
Iniciar sesión en un sitio
Si es miembro de un sitio en Tableau Server, la elección de sitio no es parte del proceso de
inicio de sesión, este ocurre de forma automática. La parte superior de la página del servidor
se ve similar a esto:
Si usted pertenece a varios sitios, el nombre de su sitio actual se muestra en el menú Sitios:
Iniciar sesión con SAML
Si Tableau Server está configurado para la autenticación SAML, no verá un aviso de inicio de
sesión de Tableau Server. En su lugar, verá un aviso de un proveedor de identidad externo
(IdP).Por ejemplo:
Tras iniciar sesión con SAML activado, no verá un comando de Cerrar sesión en el menú de
usuario de Tableau Server. Esto es porque IdP manejó su inicio de sesión, no Tableau Server.
Para cerrar sesión en Tableau Server, también debe usar su IdP.
Examinar Tableau Server
Cuando inicia sesión por primera vez en Tableau Server, se muestra una lista de vistas. Las
vistas se ordenan en orden alfabético por nombre. La página contiene varias herramientas que
le ayudan a navegar y encontrar vistas en el servidor:
Navegue por el servidor
Hay algunas formas de navegar por Tableau Server, ya sea mediante el uso de vínculos de
navegación en la izquierda o los controles de la página.
Vínculos de navegación
El área de navegación a la izquierda se divide en una pestaña Administración, que solo
pueden ver los administradores de sistema y sitio, y una pestaña Contenido, que pueden ver
todos los usuarios del servidor:
Administrador
Si es administrador de sistema, puede ver todo lo del servidor y tiene todas las capacidades.
Los administradores de sitio pueden ver todas las áreas que puede ver un administrador,
excepto por las páginas Sitios y Licencias. Para las áreas que pueden ver, los administradores
de sitio generalmente tienen menos capacidades. La capacidad de los administradores de sitio
de agregar usuarios a un sitio es algo que los administradores de sistema pueden permitir o
evitar (consulte Agregar o editar sitios).
Contenido
Los vínculos del área Proyectos para una lista de proyectos en el servidor. Un proyecto es una
recopilación de libros de trabajo relacionados. Los administradores crean y mantienen
proyectos. Consulte Proyectos para obtener más información.
Controles de página
Si hay múltiples páginas, puede avanzar a través de ellas mediante los enlaces Siguiente y
Anterior en la parte inferior de la página. De forma alternativa, puede saltar a una página
específica al escribir el número en el cuadro de texto y presionar Intro en el teclado.
Puede aumentar o disminuir el número de elementos que se muestra en cada página
ingresando el número de elementos que desee ver y presionando Intro.
Pestañas de hojas
Los libros de trabajo frecuentemente contienen hojas múltiples, incluidos paneles de control y
vistas individuales. Los autores pueden publicar opcionalmente estos libros de trabajo donde
las hojas se muestran como pestañas en la parte superior de la página (usando la opción de
Tableau Desktop Mostrar hojas como pestañas). Cuando trabaja con un libro de trabajo
tabulado, puede navegar fácilmente entre las hojas usando las hojas mediante las pestañas de
hojas.
Avance por páginas
Algunas vistas pueden tener varias páginas, las cuales dividen los datos según los valores de
un campo específico. Un ejemplo común es una vista que muestra una página separada para
cada año, trimestre o mes. Las páginas le ayudan a comparar datos y encontrar valores
anómalos. Cada página usa el mismo rango de eje, de forma que mientras se mueve entre las
páginas puede ver fácilmente cómo cambian los datos.
Si la vista tiene páginas, se muestra el control de páginas de forma que puede navegar por las
páginas. Puede usar las flechas a la izquierda y derecha para desplazarse por cada página o
usar el menú desplegable al medio para saltar a una página específica. Por último, puede usar
la barra deslizante para avanzar por las páginas.
Por ejemplo, en la vista a continuación, las páginas se definen por Años. Puede usar el control
de páginas para ver los GDP y el porcentaje de uso de Internet por cada año.
Seleccione Mostrar historial en el control de páginas para incluir las marcas de páginas
anteriores mientras se mueve de una página a otra y cuando selecciona marcas. El autor de la
vista puede especificar cómo se deben mostrar las marcas históricas.
Su página de preferencias del usuario
Las opciones en la página Preferencias del usuario afectan sus sesiones Web individuales de
Tableau Server. Úselos para administrar su configuración de suscripción, especificar su
página de inicio y cambiar el idioma y local en Tableau Server, borrar las cookies para
contraseñas de conexión de datos o cambiar la contraseña de Tableau Server. También
puede usar esta página para examinar rápidamente lo que ha publicado. Para acceder a la
página Preferencias del usuario, haga clic en su nombre de usuario en la parte superior de la
página y seleccione Preferencias del usuario desde el menú desplegable:
Cambiar la dirección de correo electrónico
Si tiene una suscripción para una vista o libro de trabajo de Tableau Server, la cuenta de
correo electrónico que recibe la suscripción aparece en la página Preferencias del usuario:
Para ingresar o cambiar la dirección de correo electrónico a la que Tableau Server envía
suscripciones, ingrese la nueva dirección de correo electrónico en el cuadro de texto Correo
electrónico, ingréselo nuevamente en el cuadro de texto Confirmar correo electrónico, y
luego seleccione Configurar:
Administrar su configuración de suscripción
Use las opciones de suscripción para cambiar el programa para cualquier suscripción que esté
recibiendo. Aquí también es donde puede anular la suscripción desde una vista. Para conocer
los pasos, consulte Anular la suscripción de una vista y Cambiar la configuración de
suscripción.
Personalizar su página de inicio
Tableau Serverse instala con Vistas como la página de inicio predeterminada para todos los
usuarios, pero el administrador puede especificar una distinta. Para averiguar cuál es su
página de inicio, haga clic en Ir a la página de inicio:
Puede designar otra página de inicio para usted mismo navegando a la página del servidor
que desee, como Libros de trabajo y seleccionando el comando Hacer de esta mi página
de inicio en el menú desplegable de la esquina superior derecha:
Para volver a usar la página de inicio designada por el administrador, en la página
Preferencias del usuario, haga clic en Restablecer al valor predeterminado:
Idioma y local
El ajuste Idioma controla el idioma que ve para la interfaz de usuario de Tableau Server y
Local afecta elementos en vistas, como la forma en que se formatean los números o la
moneda que se usa. El administrador puede configurar estas configuraciones para todos los
usuarios de servidores, pero puede cambiarlas aquí solo para usted. Si cambia la
configuración, tenga en cuenta que solo tendrá efecto si se trata de un idioma compatible.
Consulte Idioma y local para obtener más información.
Después de realizar sus selecciones de Idioma y Local, haga clic en Configurar.
La próxima vez que inicie sesión, la configuración se usa para las sesiones de servidor.
Cambiar su contraseña de Tableau Server
Si el servidor está configurado para usar el sistema de administración de usuarios interno
(Autenticación local) en lugar de Active Directory, cambiar la contraseña de Tableau Server
haciendo clic en Cambiar contraseña. Cuando hace clic en el enlace, se le solicita que
ingrese su Contraseña actual y la Contraseña nueva (dos veces). Después de escribir la
información requerida, haga clic en Cambiar para guardar los cambios.
Borrar sus contraseñas de conexión de datos guardadas
Si accede a una vista o libro de trabajo que tiene una conexión de base de datos de acceso en
tiempo real y le requiere autenticación, Tableau ofrece guardar sus contraseñas. Si acepta,
guarda las credenciales en una cookie. Haga clic en Borrar todo en Contraseñas de
conexión de datos guardadas para eliminar la cookie de Tableau Server:
Examine sus elementos publicados
La página de cuenta de usuario indica todos los libros de trabajo, etiquetas y comentarios que
ha publicado. Use esta página para examinar rápidamente su propia actividad en el servidor.
Realizar acciones
Si se le ha otorgado el nivel de licencia de Interaccionador o si es un administrador, tiene
acceso a comandos en la parte superior de muchas páginas del servidor que le permiten, por
ejemplo, establecer permisos, agregar etiquetas o eliminar vistas y libros de trabajo.
Puede usar los comandos en combinación con la casilla de verificación que se muestra junto a
cada elemento de la lista. En lugar de seleccionar elementos de forma individual, puede usar el
menú desplegable para seleccionar Todo, solo los elementos de la Página actual o Ninguno
de los elementos.
En lugar del menú desplegable, puede hacer clic en la casilla de verificación en la parte
superior de la lista en múltiples ocasiones para alternar entre estas opciones. La casilla de
verificación se actualiza para indicar los elementos seleccionados.
Todos los elementos
seleccionados en
múltiples páginas
Todos los elementos
seleccionados en la página
actual solamente
No hay
elementos
seleccionados
Después de haber seleccionado elementos, puede aplicar acciones relevantes como
configuración de permisos o adición de etiquetas.
Buscar contenido
Puede usar la casilla de búsqueda a la izquierda de la página en combinación con los filtros
bajo ella para buscar rápidamente vistas y otros elementos. También puede usar atributos de
búsqueda y operadores en lo que ingrese para la búsqueda.
Usar búsqueda filtrada
Los menús desplegables Proyecto, Publicador y Etiqueta le muestran lo que se definió en
el servidor y los filtros Modificado en o antes/después, Favoritos y Usados
recientemente pueden ayudarle a especificar más su búsqueda:
Para eliminar un filtro, haga clic en la X a la derecha del filtro para eliminarlo:
Para eliminar todos los filtros, haga clic en Borrar todo en la parte superior:
Use atributos con búsqueda
Además de una búsqueda general, puede limitar la búsqueda en Tableau Server a un atributo
específico como el nombre, el libro de trabajo, la fuente de datos y así sucesivamente. Por
ejemplo, al escribir name:proyecciones ventas (sin espacios a ningún lado de los dos puntos)
solo se arrojan elementos con nombres que contienen las palabras ventas o proyecciones.
Mientras tanto, los operadores de búsqueda le ayudan a especificar el tipo de búsqueda que
desea realizar.
A continuación se muestra una lista completa de atributos.
Este
atributo…
Seguido por…
Arroja
name:
término de
búsqueda
Elementos con nombres que coinciden
con el término de búsqueda
title:
término de
búsqueda
Vistas con títulos que coinciden con el
término de búsqueda
caption:
término de
búsqueda
Vistas con textos que coinciden con el
término de búsqueda
publisher:
nombre de
usuario
Elementos que fueron publicados por los
usuarios especificados
project:
término de
búsqueda
Elementos que son parte de un proyecto
cuyo nombre coincide con el término de
búsqueda
comment:
término de
búsqueda
Vistas con comentarios que coinciden
con el término de búsqueda
tag:
término de
búsqueda
Elementos con etiquetas que coinciden
con el término de búsqueda
field:
término de
búsqueda
Las vistas con campos que coinciden en
las filas, columnas, nivel de detalle,
páginas o estantes de codificación
type:
workbook,
view,
datasource,
project
Elementos que son del tipo que coincide
sheettype: vista o dashboard
Vistas que son del tipo de hoja que
coincide
class:
tipo de fuente de
datos (por
ejemplo, mysql)
Las vistas y fuentes de datos que se
asocian con el tipo de fuente de datos
que coincide
dbname:
nombre de base
de datos
Las vistas y fuentes de datos que se
asocian con la fuente de datos que
coincide
tablename: término de
Las vistas y fuentes de datos que se
Este
atributo…
nviews:
Seguido por…
Arroja
búsqueda
asocian con el nombre de tabla que
coincide
número
Los libros de trabajo que contienen el
número especificado de vistas
Las búsquedas de términos no distinguen mayúsculas de minúsculas.
Puede incluir atributos múltiples para limitar adicionalmente una búsqueda. Por ejemplo, para
buscar todos los paneles de control que fueron publicados por Smith, puede escribir lo
siguiente en el campo de búsqueda. sheettype:dashboard publisher:smith.
Usar operadores de búsqueda
Algunas veces es posible que desee crear búsquedas con operaciones lógicas en Tableau
Server. Por ejemplo, puede que desee buscar todos los elementos que no coinciden con un
término específico. O bien, posiblemente desee buscar elementos que coinciden con un
término u otro término, pero no tienen que coincidir ambos. Puede usar y, o, no y * para
construir expresiones de búsqueda.
Operador Definición
Ejemplos
y
Arroja elementos
que coinciden con
ambos términos de
búsqueda.
ventas and marketing; lápices and papel
or
Arroja elementos
que coinciden con
un término de
búsqueda.
occidental or oriental; soccer and fútbol
not
Excluye elementos
que coinciden el
término de
búsqueda luego de
este operador
notsheettype:dashboard
*
Funciona como
sustituto para
cualquier otro
carácter o palabra
que sigue o como
dev* sales*
parte del término de
búsqueda. Este
operador se puede
usar por sí mismo o
Operador Definición
Ejemplos
al final del término
de búsqueda. Este
operador es útil
cuando no conoce el
término exacto que
busca.
Espacios y búsqueda
Si su término de búsqueda incluye cualquier espacio, puntuación o las palabras y, o o no,
encierre su término de búsqueda entre comillas.
Usar listas
A medida que navega por Tableau Server encontrará que los elementos se muestran como
miniaturas o en listas. Los iconos de la parte superior de las páginas Libros de trabajo y Vista
permiten especificar si el contenido se muestra como listas o miniaturas:
Puede alternar rápidamente entre estos dos estados haciendo clic en los iconos de lista y
miniatura:
Ordenar miniaturas
Según el tipo de elementos que indica, es posible que pueda ordenar según las siguientes
categorías: Nombre, Proyecto, cantidad de Hojas, la última fecha de Modificación y
Publicador. La forma de orden depende de si busca en miniaturas o una lista de texto. Una
lista ordenada se agrupa según la categoría seleccionada con títulos que muestran las
distintas agrupaciones. Por ejemplo, la vista de miniaturas a continuación se ordenan
alfabéticamente en orden ascendente (A a Z), tenga en cuenta que la flecha de orden apunta
hacia arriba:
Ordenar listas
En una lista de texto, puede usar el encabezado de columnas para ordenar la lista.
Nuevamente la flecha indica si los elementos se ordenan de forma ascendente (flecha hacia
arriba) o descendente (flecha hacia abajo). Haga clic en el encabezado que desea usar para
ordenar la lista.
En ocasiones, en la vista de lista hay una columna Editar disponible. Puede seleccionar una
vista y hacer clic en Editar para modificar la vista en el servidor. Para obtener detalles sobre
cómo hacer esto, consulte Editar y crear vistas.
A medida que continúa cambiando el orden en una lista de libros de trabajo, vistas o
proyectos; el servidor recuerda sus últimas tres opciones y las aplica como un orden de
columnas múltiples. Por ejemplo, si ordena por fecha de Modificación y luego ordena
por Proyecto, la lista se agrupará por proyecto y dentro de cada proyecto los libros de
trabajo o vistas se ordenarán por fecha de modificación.
Almacenar favoritos
Puede marcar cualquier vista o libro de trabajo para almacenarlo como uno de sus favoritos
para buscarlos rápidamente en el futuro. Los favoritos se guardan en el menú Favoritos de la
esquina superior derecha:
En el menú Favoritos, las vistas tienen un icono
y los libros de trabajo tienen un icono . Si
tiene un gran número de favoritos, puede usar la barra de desplazamiento de la derecha para
verlos todos:
Puede buscar rápidamente algunos favoritos usando el cuadro de búsqueda de la parte
superior:
Agregar un favorito
Puede crear un favorito desde la miniatura o la vista de lista de las páginas Libros de trabajo y
Vistas. Desde la vista miniatura, cree un favorito situando el cursor sobre una vista o libro de
trabajo y seleccionando la estrella de Favoritos en la descripción emergente que aparece:
Desde la vista de lista, cree un favorito haciendo clic en la estrella junto a la vista o libro de
trabajo que desea almacenar como favorito:
La vista o libro de trabajo se agrega al menú Favoritos.
Eliminar un favorito
Para eliminar una vista o libro de trabajo desde la lista Favoritos, situe el cursor sobre la
descripción emergente y haga clic en la estrella:
Desde la vista de lista, simplemente haga clic en la estrella o retire la vista o libro de trabajo
como un favorito:
Guardar contraseñas
En ocasiones una vista requiere que ingrese un nombre de usuario y contraseña de base de
datos. Si tiene acceso a la base de datos debe ingresar el nombre de usuario y contraseña en
los cuadros de texto adecuados. Si selecciona la opción Recordar mi contraseña iniciará
sesión automáticamente cada vez que mire la vista. Su información de inicio de sesión se
almacena encriptada en el servidor de forma que iniciará sesión automáticamente incluso
entre sesiones de navegador y al acceder a la vista desde computadoras múltiples. Esto es
conveniente cuando tiene cierta cantidad de vistas a las que accede siempre.
Nota:
Los administradores pueden restringir si se permite que los usuarios recuerden contraseñas
de bases de datos. Si es administrador, consulte Configuración de mantenimiento para
obtener más información.
Borrado y restablecimiento de contraseñas guardadas
Si se guardan las contraseñas (se habilita Contraseñas guardadas en la página
Mantenimiento), puede borrar las contraseñas guardadas. Cuando hace esto, la próxima vez
que visite el servidor se le solicitará que ingrese el nombre de usuario y contraseña. Es posible
que desee hacer esto su el nombre de usuario y la contraseña cambian de forma que pueda
comenzar a usar y guardar credenciales nuevas.
1. Abra la página Preferencias de usuario desde el menú desplegable de la esquina
superior derecha:
2. En Contraseñas de conexión de datos guardadas, haga clic en Borrar todo.
Los administradores también pueden borrar todas las contraseñas guardadas en el
servidor mediante Borrar todas las contraseñas guardadas para todos los usuarios
en la página Mantenimiento.
Trabajar con vistas
Después de encontrar una vista o cuadro de mandos que le interese, puede ver e interactuar
con los datos de muchas formas. Exactamente cómo depende de dos cosas: el nivel de
licencia y los permisos configurados por el autor de la vista. Consulte Trabajar con permisos
para obtener más información.
Compartir vistas
Cada vista y libro de trabajo publicado se puede compartir mediante correo electrónico o
incrustar en otra página Web, wiki o aplicación Web. Cualquier persona que vea una vista
compartida debe tener una cuenta en Tableau Server y permiso para acceder a la vista.
Enviar una vista por correo electrónico
Puede enviar por correo electrónico un vínculo a una vista al hacer clic en el vínculo
Compartir en la esquina superior izquierda de la vista. Luego copie y pegue el vínculo
proporcionado en el mensaje de correo electrónico.
Vistas incrustadas
Puede compartir una vista al incrustarla en otra página Web como su aplicación Wiki, blog o
Web. Haga clic en el enlace Compartir en la esquina superior izquierda de la vista y copie y
pegue el código HTML proporcionado.
Ajustar la apariencia de una vista incrustada
Puede cambiar la forma en que se ve una vista incrustada al ajustar las Opciones de
visualización. Ahí puede especificar un ancho fijo, altura y si desea visualizar la barra de
herramientas o pestañas.
Exploración de datos mediante información sobre herramientas
La información sobre herramientas son detalles de datos adicionales que aparecen al situarse
sobre una o más marcas en una vista:
La información sobre herramientas ofrece formas sencillas para filtrar o eliminar marcas, y ver
datos:
l
Mantener solamente: Solo muestra lo que ha seleccionado en la vista.
l
Excluir: Elimina lo que ha seleccionado de la vista.
l
Ver datos: Abre una ventana que muestra los datos. Puede ver los datos resumidos o
los datos subyacentes.
Para filtrar o excluir un grupo de marcas, simplemente selecciónelos y haga clic en la acción
que desea realizar.
Para ver los datos resumidos o datos subyacentes, realice una selección y haga clic en el icono
Ver datos:
Los datos de la pestaña Resumen muestran los datos agregados en la vista o en la selección
dentro de la vista:
Los datos en Subyacentes muestran los valores para cada fila en la fuente de datos, según
las restricciones de la o las marcas que ha seleccionado:
La selección de Mostrar todas las columnas muestra todas las columnas en la fuente de
datos subyacentes, ya sea que los datos estén en la vista o no:
Descargue todas las filas como archivo de texto mediante los enlaces en la parte
superior e inferior de la tabla:
Subscribir a vistas
Si puede ver una vista en Tableau Server y tiene el icono de una suscripción ( ) en la esquina
superior derecha, el administrador ha configurado suscripciones para su sitio y puede
suscribirse a la vista. Esto significa, en un intervalo regular, que puede recibir una instantánea
de la vista automáticamente en la bandeja de entrada de su correo electrónico, sin tener que
iniciar sesión en Tableau Server. También puede suscribirse a libros de trabajo. En lugar de
recibir una sola vista, recibe todas las vistas del libro de trabajo en un solo correo electrónico.
Puede cambiar qué programa de suscripción va a usar o anular la suscripción. Consulte los
detalles a continuación.
Subscribirse a una vista
Para sus suscribirse a una vista o libro de trabajo:
1. Seleccione la página Vistas o Libros de trabajo:
2. Haga clic en vista o libro de trabajo.
3. Haga clic en el icono de suscripción en la esquina superior derecha:
4. Si su cuenta de Tableau Server aún no se ha asociado con ninguna dirección de correo
electrónico, se le solicita proporcionar una. Ingrese su dirección de correo electrónico y
haga clic en Siguiente.
5. En el siguiente diálogo, seleccione un programa de suscripción. De forma
predeterminada, Tableau Server proporciona un programa de día de semana en la
mañana y un programa de lunes en la mañana. El administrador de Tableau Server
también puede crear programas de suscripción personalizados.
6. A continuación, seleccione si desea suscribirse a una sola vista (Esta hoja) o al libro de
trabajo completo (Hojas en libro de trabajo) y haga clic en Suscribir.
7. Luego, cuando reciba la suscripción por correo electrónico, haga clic en la instantánea
de la vista y esta abre en Tableau Server:
Anular la suscripción a una vista
Para anular la suscripción a una vista o libro de trabajo:
1. Acceda a la página Preferencias de usuario en Tableau Server haciendo clic en el
enlace de la parte inferior de un correo electrónico de suscripción:
También puede abrir la página Preferencias del usuario desde el menú desplegable
Tableau Server:
2. Junto a la vista para la que desea anular la suscripción, seleccione la casilla de
verificación Anular suscripción.
3. Haga clic en Actualizar.
Cambiar la configuración de suscripción
Para cambiar el programa de suscripción:
1. Abra la página Preferencias del usuario:
2. En Programa, seleccione una programación diferente:
3. Haga clic en Actualizar.
Ordenar datos
Puede cambiar rápidamente el orden de ordenamiento para elementos de una vista mediante
los botones Ordenar en un eje, etiqueta de campo o encabezado. Por ejemplo, la vista a
continuación muestra la salida de petróleo por pozo. Si sitúa el mouse sobre el eje vertical, un
botón de orden aparece y muestra el orden que realizará al hacer clic en él; en este caso, un
orden ascendente:
Luego de ordenar, el icono de orden permanece en el eje vertical.
Haga clic nuevamente en el icono Ordenar y ordena de forma descendente, desde la menor
salida a la mayor:
Un tercer clic regresa el gráfico de barras a su estado original:
Siempre puede revertir al estado de vista completa mediante el botón Revertir todo en la
barra de herramientas.
Filtrar datos
Con un nivel de licencia de interaccionador, puede filtrar datos de una vista para acotar la
visualización de los datos de interés. Por ejemplo, un informe de ventas regionales puede
mostrar ventas para varias regiones. Puede enfocarse en la forma en que la región usa filtros.
Luego puede revertir los filtros para volver a la vista original y comparar la región con otras.
Hay dos formas de filtrar la vista: filtros rápidos y Mantener solamente y Excluir comandos de
descripción emergente.
Tipos de filtros rápidos
Existen muchos tipos distintos de filtros rápidos. El autor de la vista elija el tipo de filtro que
muestra mejor los valores que filtra. Cada tipo de filtro y la forma en que interactúa con él se
describe a continuación.
Tipo de filtro rápido
Descripción
Lista de valores múltiples
Muestra una lista de casillas de verificación.
Seleccione los valores que desea incluir.
Lista de valores individuales
Muestra una lista de botones de selección.
Seleccione un valor a la vez que desee incluir.
Lista compacta
Muestra una lista desplegable de valores. Seleccione
un valor a la vez que desee incluir.
Barra deslizante
Muestra valores en un rango. Arrastre la barra
deslizante o use las flechas para seleccionar un valor
que desee incluir. Para valores cuantitativos, use las
dos barras deslizantes para especificar un rango de
valores.
Tipo de filtro rápido
Descripción
Coincidencia de comodín
Muestra un campo de texto. Incluya todos los valores
que contienen un conjunto específico de caracteres.
Puede usar el símbolo de asterisco (*) como carácter
comodín.
Escribir
Muestra un campo de texto. Escriba un valor y haga
clic en el símbolo más para incluirlo en el filtro. De
forma alternativa, copie y pegue una lista de valores
en el campo de texto.
Filtros de fecha
Los filtros de fecha se pueden mostrar en la mayoría
de los tipos de filtros descritos anteriormente. Sin
embargo, hay algunos tipos más que son específicos
para fechas. Por ejemplo, filtros de fecha relativos le
permiten incluir rangos de fecha comunes como
“últimas 3 semanas” o “año a la fecha”. O bien, puede
seleccionar desde una recopilación de periodos de
fechas predefinidas como 1 día, 1 semana, 3 meses,
etc.
Lista de valores múltiples (jerárquico)
Si la vista usa una fuente de datos multidimensional,
la lista de valores múltiples muestra los niveles
jerárquicos. Use los selectores de nivel en la parte
superior para seleccionar todos los valores en el nivel
determinado.
Opciones de filtro
Muchos filtros rápidos tienen opciones adicionales que muestran cuando sitúa el puntero
sobre el área de filtro en la página. Por ejemplo, algunas veces es más fácil seleccionar lo que
no quiere ver en lugar de todos los elementos que desea. Las opciones del menú desplegable
para una lista de valores múltiples le permiten alternar entre un filtro Inclusivo y Exclusivo.
Cada tipo de filtro tiene su propio conjunto de opciones disponible en el menú desplegable en
la esquina superior derecha del área de filtro. La disponibilidad de estas opciones es
controlada por el autor de la vista.
Además, si un filtro contiene mucho valores, puede usar la búsqueda para encontrar y
seleccionar rápidamente lo que busca. Haga clic en el botón Buscar que muestra cuando
sitúa el puntero sobre el filtro rápido. Luego comience a escribir el valor que busca. Los
resultados se muestran directamente a continuación de la casilla de búsqueda facilitando la
selección.
Por último, puede limitar los valores que se muestran en un filtro de búsqueda mediante el
botón Mostrar más valores/Mostrar menos valores. Cuando muestra más valores, se
visualizan todos los valores del campo. Cuando muestra menos valores, se consideran los
otros filtros activos. Solo se muestran los valores que pasan todos los filtros. Por ejemplo, se
puede filtrar una vista para que muestre ventas mayores que $5000 en las regiones occidental
y central. Cuando muestra más valores, el filtro Región mostrará todas las regiones. Cuando
muestra menos valores, el filtro Región solo mostrará las regiones donde las ventas son
mayores que $5000.
Reversión de filtros
Si en algún momento desea restaurar los filtros a como estaban cuando se publicó la vista, use
el botón Revertir todo.
Exportar vistas
Puede exportar la vista como Imagen o PDF. También puede exportar los datos como una
Tabulación cruzada o un archivo de valores separados por coma (Datos). Seleccione una
opción en el menú Exportar en la barra de herramientas en la parte superior de la vista.
Si exporta un dashboard a un PDF y el dashboard incluye un objeto de página Web,
este último no se incluye. Además, cuando selecciona una opción de exportación, se
debe generar PDF o archivo de datos. Se abre un mensaje cuando finaliza la
generación de forma que pueda continuar la descarga del archivo.
Zoom y panorama en mapas
Para ayudarle a navegar por vistas que incluyen mapas, una barra de herramientas de zoom
aparece cuando sitúa el mouse sobre un mapa en una vista. La barra de herramientas le
permite acercar y alejar, seleccionar marcas, regresar el mapa a su estado inicial y le permite
panoramizar.
Si el autor de libro de trabajo elige ocultar los controles de zoom (en Tableau Desktop: Vista >
Controles de zoom > Ocultar), no verá la barra de herramientas de zoom.
A continuación se describe cada modo:
Acercar: Acerca una vista de mapa para ver más detalles.
Seleccionar: Seleccione marcas en una vista de mapa para identificar
un subconjunto de los datos.
Inicio Restaura la vista de mapa a su estado original.
Panoramizar: Mantenga pulsado el botón del mouse para mover la
vista de un mapa arriba y abajo, así como también, a la izquierda o
derecha. Esto es especialmente útil cuando ha acercado una vista y
desea mover la vista para ver otras áreas de interés.
Colocar en pausa las actualizaciones automáticas
A medida que interactúa con la vista en el servidor, en ocasiones enviarán una consulta a la
fuente de datos para actualizar los datos de la vista. Si trabaja con una vista densa con una
gran cantidad de datos o una fuente de datos sumamente grande, la actualización automática
puede tardar un tiempo prolongado. Para evitar la espera de cada actualización mientras
realiza varios cambios, puede hacer clic en Colocar en pausa las actualizaciones
automáticas en la barra de herramientas.
Cuando hace clic en Reanudar las actualizaciones automáticas mediante el botón de la
misma barra de herramientas, solo debe esperar una consulta a la fuente de datos.
Actualizar datos
Si la fuente de datos cambia, como cuando se agregan nuevos campos o se modifican valores
de datos y nombres de campos, la vista reflejará dichos cambios la próxima vez que carga la
página. Sin embargo, es posible que deba actualizar manualmente la vista mediante el botón
Actualizar datos en la barra de herramientas.
Cuando actualiza los datos, borra cualquier memoria caché que es posible que exista y
recupera los últimos datos de la fuente de datos. Esta opción es distinta a la opción Colocar en
pausa las actualizaciones automáticas, la cual aun puede cargar la vista según los datos en
caché. Según el tamaño de su fuente de datos y la vista, la actualización de datos puede tardar
más que otras consultas que funcionan en datos almacenados en caché.
Descargar libros de trabajo
Los libros de trabajo se pueden descargar mediante el vínculo Descargar en la esquina
superior derecha de la vista. El libro de trabajo descargado se puede abrir con una versión de
Tableau Desktop. La descarga del libro de trabajo desde el servidor es igual que la selección
de Servidor > Abrir libro de trabajo en la aplicación de escritorio. El libro de trabajo solo se
puede abrir si aun está publicado en el servidor.
Esta opción solo está disponible si ha recibido el permiso Descargar/Guardar en Web como
por parte del autor del libro de trabajo o un administrador. Consulte Trabajar con permisos
para obtener más información.
Seguimiento de hipervínculos
Muchas vistas contienen hipervínculos a URL exteriores u otras hojas. El autor agrega estos
hipervínculos y pueden ser útiles para obtener más información sobre un conjunto de puntos
de datos. Según cómo se crea la vista, los hipervínculos se pueden iniciar en una de las tres
siguientes formas:
l
Seleccionar: haga clic en una marca de la vista.
l
Situar: sitúe el puntero sobre la marca en la vista.
l
Información en pantalla: el hipervínculo está disponible en la información en pantalla
que se muestra cuando sitúa el puntero sobre una selección de marcas.
Vínculos a páginas Web
Una vista puede vincular a una página Web externa para mostrar más información sobre los
datos. Por ejemplo, una vista de mapa puede vincularse desde una ubicación específica para
mostrar una imagen satelital. O bien, un informe de ventas puede vincular desde una selección
de productos para mostrar el estado de inventario actual en una intranet interna. Cuando hace
clic en un vínculo se le dirige a una página Web externa, la cual está fuera de Tableau Server.
También se pueden incrustar páginas Web en un cuadro de mandos. En este caso, al hacer
clic en un vínculo se carga la página Web en la misma ventana.
Vínculos a otras vistas
Además de los vínculos a páginas Web externas, algunas vistas tendrán hipervínculos a otras
vistas en Tableau Server. Esto vincula datos de filtros en la vista objetivo según su selección
en la vista fuente. Por ejemplo, en el cuadro de mandos que se muestra a continuación, la
selección de un producto de la lista de filtros Productos con mayores ventas para mostrar
dónde se vende el producto.
Resaltar marcas, leyendas y acciones
El resalto es una forma de llamar la atención a un subconjunto de datos en una vista. Hay tres
formas de resaltar en Tableau Server: usar marcas, leyendas o acciones.
Uso de marcas para resaltar
Cuando selecciona una o más marcas en una vista, todas las otras marcas se atenúan a fin de
destacar la selección. Seleccione marcas individuales o haga clic y arrastre el puntero para
seleccionar varias marcas. Mantenga presionada la tecla Ctrl en el teclado para seleccionar
múltiples marcas en la vista.
Uso de leyendas para resaltar
Puede usar las leyendas (color, forma y tamaño) para resaltar las marcas que responden a
cada elemento de la leyenda. Por ejemplo, si una vista está coloreada por categoría de
producto, puede resaltar rápidamente cierto tipo de producto mediante el resaltado de
leyenda. Para habilitar el resalto de leyenda:
1. Haga clic en el botón Resaltar que se muestra en la esquina superior derecha cuando
sitúa el puntero sobre la leyenda.
2. Seleccione un elemento en la leyenda:
3. Puede mantener presionada la tecla Ctrl en el teclado para seleccionar elementos
múltiples en la leyenda. Desactive el resalto de leyenda al seleccionar nuevamente el
botón Resaltar.
Acciones de resalto
Algunas vistas pueden tener acciones de resalto, las cuales resaltan datos relacionados en
una o más vistas según su selección en una vista fuente. Las acciones de resalto se usan
principalmente en vistas de cuadro de mandos donde múltiples vistas se muestran
simultáneamente. Por ejemplo, en la vista de cuadro de mandos hay una acción de resalto
configurada para resaltar Región. Cuando se selecciona Oeste en el diagrama de dispersión,
todas las otras vistas resaltan la categoría Oeste.
Según la forma en que se creó la vista, se puede iniciar Acciones de resalto al seleccionar una
marca, situar el puntero sobre una marca o en la información en pantalla que se muestra
cuando sitúa el puntero sobre una durante un periodo.
Etiquetar vistas
Una etiqueta es una palabra clave que describe una vista y puede ayudarle a categorizar y
buscar vistas. Los autores pueden agregar etiquetas a las vistas cuando publican vistas. Al
publicar una vista en un servidor de Tableau, puede agregar etiquetas a cualquier vista para la
cual tenga acceso y eliminar cualquier etiqueta que haya agregado. En una vista publicada, el
cuadro de texto Etiquetas se encuentra debajo de la vista:
Agregar etiquetas
Puede agregar etiquetas a cualquier vista del servidor para la cual tenga permiso de acceso.
Las etiquetas no distinguen mayúsculas de minúsculas y se convierten a minúscula cuando las
agrega.
Para agregar etiquetas en un vista individual:
Escriba una o más palabras en el cuadro de texto Etiquetas ubicado a continuación de la vista
y haga clic en Agregar. Las palabras se pueden separar con espacios o comas.
Para agregar etiquetas a vistas múltiples:
Si tiene nivel de licencia de interaccionador, también puede agregar etiquetas a vistas
múltiples de una vez.
1. Navegue a una lista de vistas o libros de trabajo.
2. Seleccione las vistas que desea etiquetar y haga clic en Etiquetar en la parte superior
de la página. Si no existe ninguna etiqueta todavía, puede Agregar una:
Si ya existen etiquetas, seleccione una:
Eliminar etiquetas
Puede eliminar cualquier etiqueta que ha creado.
1. Abra la vista etiquetada.
2. Desplácese al cuadro de texto Etiquetas debajo de la vista.
3. Haga clic en 'x' junto a la etiqueta que desea eliminar.
Comentar en vistas
Puede agregar comentarios a cualquier vista a la que tenga acceso en Tableau Server.
También puede ver cualquier comentario asociado con una vista en particular.
Escriba el texto en el cuadro de texto Comentario ubicado a continuación de la vista y haga
clic en Agregar.
Puede agregar formato a su comentario al insertar hipervínculos, negrita, cursiva y subrayado.
En la tabla a continuación se muestran ejemplos de cómo agregar cada uno de estos tipos de
formato en la tabla a continuación.
Formato
Qué escribir
Ejemplo
Hipervínculo
“Mi
vínculo”:http://www.tableausoftware.com
Mi vínculo
Negrita
*Texto en negrita*
Texto en
negrita
Cursiva
_Texto en cursiva_
Texto en cursiva
Subrayar
+Texto subrayado+
Texto
subrayado
Vistas personalizadas (Recordar mis cambios)
Puede tener una vista en la que realiza los mismos cambios cada vez que la abre. Por ejemplo,
puede aplicar un filtro determinado solo para incluir los datos relevantes para usted o puede
ordenar la vista de forma distinta a su publicación. Puede que también necesite mantener
diferentes versiones de la misma vista, por ejemplo, una con dos filtros seleccionados y otra
con solo uno seleccionado. Si tiene un nivel de licencia de Interaccionador , en vez de realizar
estos cambios cada vez que abre la vista, Tableau puede recordar los cambios como una o
más vistas personalizadas. Puede también compartir o “anunciar” sus vistas personalizadas
con otros usuarios. Los usuarios con licencias de Interaccionador o Visor pueden ver vistas
que otros usuarios hayan anunciado.
Consulte los siguientes temas para obtener más información:
Acceder a Recordar mis cambios
La configuración Recordar mis cambios aparece sobre el área de vistas la primera vez que
ve una vista publicada (o abajo si está viendo una vista incrustada):
Si hay versiones personalizadas de una vista, la primera vez que la vea después de que se
haya publicado mostrará Vista original. Después de hacer clic en el menú desplegable y
seleccionar una de las vistas personalizadas, se muestra el nombre de esa vista.
Guardar su vista personalizada
A medida que filtra, ordena e interactúa con una vista, aparece un punto gris junto al menú
Recordar mis cambios o al nombre de la vista. El punto indica que se realizaron los cambios.
Use este menú para guardar los cambios como una vista personalizada.
Cualquier vista personalizada que usted u otras personas creen estará siempre relacionada
con la vista original. Cuando la vista original se actualiza o vuelve a publicar, también se
actualizan las versiones personalizadas de la vista. Si se elimina del servidor la vista original,
se eliminan también sus vistas personalizadas relacionadas. Si se quitan los filtros de la vista
original y esta se vuelve a publicar, los filtros no estarán disponibles en las versiones
personalizadas de la vista. Si se restauran los filtros y la vista se vuelve a publicar, se restauran
las versiones personalizadas de la vista.
A continuación se presentan más detalles sobre cómo guardar una vista personalizada:
1. Abra la vista individual que desea personalizar.
2. Filtre los datos, cambie los órdenes de ordenamiento, resalte, acerque o aleje, etc.
Haga clic en el vínculo Recordar mis cambios o en el nombre de la vista
personalizada. Posteriormente, escriba un nombre para la vista personalizada y haga
clic en Recordar.
3.
Para que la vista personalizada se vea de manera predeterminada la primera vez que abra la
vista, seleccione Cambiar predeterminada a <nombre de vista personalizada>. Aparece
la palabra (Predeterminado) a la derecha del nombre de la vista personalizada, lo que indica
que esta versión de la vista es su vista predeterminada.
Anunciar su vista personalizada
De manera predeterminada, la vista personalizada es privada y solo usted podrá verla en su
lista. Si su nivel de licencia es Interaccionador, puede optar por anunciarla a otras personas.
Cualquier persona que tenga acceso a la vista publicada original podrá ver su vista
personalizada anunciada.
Nota:
Aunque no anuncie la vista personalizada, todavía podrá compartirla copiando la dirección
URL o haciendo clic en el botón Compartir.
1. Cuando esté viendo la vista personalizada que desea anunciar, haga clic en el nombre
de la vista y luego en Administrar vistas personalizadas.
2. En Administrar vistas personalizadas, haga clic en el icono junto al nombre de la vista
para alternar entre la modalidad anunciada y privada. El icono de una sola persona
indica que la vista es es privada y el icono de dos personas
significa que la vista es
anunciada.
3. Haga clic en Realizado.
Acceder a otras vistas personalizadas
A medida que examina las vistas, puede tener acceso a otras vistas personalizadas que otras
personas guardaron y anunciaron al hacer clic en el vínculo Vista original. Si el vínculo Vista
original está disponible, significa que hay versiones personalizadas de la vista disponible. Las
vistas personalizadas de otras personas se enumeran en la sección Otras vistas
personalizadas del menú desplegable.
Hacer su vista privada
Puede hacer que una vista anunciada vuelva a ser privada. Cuando una vista personalizada
es privada, no se muestra más en la lista desplegable para otras personas y solo usted podrá
verla en su lista.
1. Cuando esté viendo la vista personalizada que desea dejar de anunciar, haga clic en el
nombre de la vista y luego en Administrar vistas personalizadas.
2. En Administrar vistas personalizadas, haga clic en el icono junto al nombre de la vista
para alternar entre la modalidad compartida y privada. El icono de dos personas
indica que está anunciada y el icono de una sola persona
privada.
3. Haga clic en Realizado.
significa que la vista es
Eliminar una vista personalizada
Puede eliminar una vista personalizada en cualquier momento. La eliminación de la vista
personalizada no afecta la vista original.
1. Cuando esté viendo la vista personalizada que desea eliminar, haga clic en el nombre
de la vista y luego en Administrar vistas personalizadas.
2. En Administrar vistas personalizadas, haga clic en la x a la derecha del nombre de la
vista personalizada.
3. Después de quitar una vista personalizada, puede hacer clic en Deshacer para
restaurarla. El botón Deshacer no está disponible después de hacer clic en Realizado.
4. Haga clic en Realizado. Se eliminará la vista personalizada.
Editar y crear vistas
Los usuarios que cuentan con credenciales adecuadas para el entorno de edición Web
pueden editar libros de trabajo existentes o crear nuevos libros.
Cuando inicia sesión en Tableau Server, la sección Vistas aparece de forma predeterminada.
Las vistas a las que tiene acceso aparecen aquí como resultado de uno de los siguientes
procesos:
l
l
Un usuario de Tableau Desktop publica el libro de trabajo que contiene la vista para
Tableau Server.
Un usuario crea la vista y guarda el libro de trabajo directamente en el entorno de
edición Web Tableau Server .
Quién puede crear, editar y guardar vistas
Los administradores pueden siempre editar y guardar libros de trabajo existentes o crear
nuevos. También pueden asignar permisos a otros usuarios y grupos para editar y guardar
vistas en libros de trabajo, al igual que otras acciones que se pueden realizar en el servidor.
Configurar licencia de usuario y niveles de publicación
Los administradores asignan un nivel de licencia y derechos de usuario cuando crean o
modifican usuarios. Para permitir que los usuarios editen libros de trabajo, primero debe
aprovisionar a los usuarios de la siguiente manera:
l
El usuario debe tener nivel de licencia de Interaccionador.
l
El usuario debe tener el derecho de usuario Publicar.
Para obtener más información, consulte Usuarios y Licencias y derechos de usuario.
Permitir editar y guardar libros de trabajo
Después de configurar usuarios o grupos, configure los niveles de licencia, y otorgue derechos
de publicación. Debe configurar los permisos en los niveles de proyecto y de libro de
trabajo, según el tipo de edición que desee permitir. Entre los permisos del nivel de tarea que
los administradores pueden permitir o negar a los usuarios y grupos, los permisos principales
para editar y guardar vistas incluyen lo siguiente:
l
l
Editar en Web: determina si el usuario puede editar vistas de libros de trabajo
mediante la creación Web.
Descargar/Guardar en Web como determina si el usuario puede ver los comandos
Guardar y Guardar como mientras editan una vista, si pueden guardar sus cambios a
un nuevo libro de trabajo nuevo. También determina si los usuarios pueden abrir un libro
de trabajo en el servidor usando Tableau Desktop.
l
Escribir/Guardar en Web determina si los usuarios pueden guardar cambios a un libro
de trabajo existente en el servidor ( sobrescribir un libro de trabajo).
Para permitirle a un usuario o un grupo guardar cambios en libros de trabajo existentes o libros
de trabajo nuevos, configure estos tres permisos de nivel de tarea según las tablas en las
siguientes secciones.
Permitirle a los usuarios guardar cambios a libros de trabajo nuevos y existentes
Permiso
Para los libros de trabajo
Para el
adecuados en el
proyecto
proyecto
Permitir Permitir
Editar en Web
Descargar/Guardar
Permitir
como
Escribir/Guardar Permitir
Permitir
Permitir
En este escenario, ya que los permisos se configuran del mismo modo para proyectos y
libros de trabajo, si desea aplicar cambios de permiso de nivel de proyecto a todos los
libros de trabajo dentro del proyecto, puede seleccionar Asignar permisos a
contenidos mientras en los Permisos: Página de proyecto.
Permitirle a los usuarios guardar libros de trabajo nuevos pero no sobrescribir
existentes
Permiso
Para los libros de trabajo
Para el
adecuados en el
proyecto
proyecto
Permitir Permitir
Editar en Web
Descargar/Guardar
Permitir
como
Escribir/Guardar Permitir
Permitir
Negar
Importante: En este escenario, los permisos se deben configurar manualmente en
cada libro de trabajo. Si selecciona Asignar permisos a contenidos según lo descrito
en Permitirle a los usuarios guardar cambios a libros de trabajo nuevos y existentes, los
permisos de proyecto sobrescriben los permisos de libro de trabajo, por lo que les
permiten a los usuarios guardar cambios en los libros de trabajo existentes.
Permisos para vistas dentro de libros de trabajo
Los permisos de vistas en un libro de trabajo heredan a partir de los permisos del libro de
trabajo cuando publica un libro de trabajo desde Tableau Desktop.
Si un usuario selecciona Mostrar hojas como pestañas al publicar un libro de trabajo desde
Tableau Desktop o guardarlo en Tableau Server, los permisos de libro de trabajo sobrescriben
los permisos de vistas individuales, hasta que el libro de trabajo se guarde nuevamente sin
pestañas.
Para ver más información, consulte Permisos y también el artículo de la base de
conocimientos Crear permisos basados en proyecto.
Si no es un administrador, puede averiguar si tiene autorización para editar una vista al
abrirla y comprobar si aparece un comando Editar sobre el área del visor.
Crear un libro de trabajo y una vista
Puede crear una nueva vista si crea una nueva hoja en un libro de trabajo existente o si crea un
nuevo libro de trabajo. Este tema muestra cómo crear una vista en un nuevo libro de trabajo.
El siguiente procedimiento usa la fuente de datos de muestra Superstore que viene con
Tableau Desktop, y se publica en Tableau Server, para crear una vista que incorpore
información acerca de ventas por categoría y región. Si tiene acceso a la fuente de datos de
muestra Superstore, puede realizar los pasos del procedimiento.
1. En la pestaña Contenido, seleccione Fuentes de datos.
2. En la lista de fuentes de datos, seleccione la casilla de verificación junto a la fuente de
datos que desea visualizar, y luego seleccione Libro de trabajo nuevo.
Una nueva vista en blanco se abre en el Tableau Server entorno de creación.
3. Desde el panel Medidas, arrastre Ventas al estante Columnas.
4. Desde el panel Dimensiones, expanda Productos para mostrar sus subcategorías y
luego arrastre Categoría al estante Filas.
Ahora Tableau cuenta con información suficiente para convertir los datos en una
visualización (vista), en este caso un gráfico de barras horizontal
5. Desde el panel Dimensiones, arrastre Región al estante Columnas.
Ahora la vista contiene otra capa de datos: las categorías se desglosan por región.
Ahora, suponga que desea ver y comparar las ventas por categoría en una sola región.
Puede lograrlo usando un filtro.
6. Desde el panel Dimensiones, arrastre Región al estante Filtros.
Mientras sitúa el mouse sobre el estante Filtros, un triángulo pequeño a la izquierda del
campo indica que puede soltarRegión en el estante.
En el borde derecho de la página aparece un control de filtros.
7. Desmarque las casillas de verificación para todas las regiones excepto la que desea
analizar, y luego vuelva a marcarlas todas.
8. Puede usar color para mejorar la visualización. Arrastre Región hasta Color en la
tarjeta Marcas.
Ahora tiene una vista útil que le permite comparar las ventas de diferentes categorías de
productos entre las regiones:
Consejo: Para aprender acerca de seleccionar una paleta de colores diferente
para las barras o cambiar su tamaño, consulte Tarjeta Marcas.
9. En lugar de enfocarse en ventas regionales de cada producto, quizás prefiera una vista
que le permita analizar más fácilmente las ventas de productos generales de una región.
En el estante Filas, arrastre Región a la izquierda de Categoría.
La vista se actualiza para mostrar las ventas de todos los productos por región.
10. Si decide que prefiere la versión anterior de la vista, puede hacer clic en Deshacer en la
Barra de herramientas.
11. Si desea crear una segunda hoja de trabajo, seleccione la pestaña Nueva hoja de
trabajo en la parte inferior de la vista.
Seleccione la pestaña Hoja de trabajo y seleccione Cambiar nombre de hoja de
trabajo para darle un nombre más descriptivo.
12. Haga clic en Guardar para guardar el libro de trabajo. En el cuadro de diálogo Guardar
libro de trabajo, complete los siguientes pasos:
l Especifique el nombre del libro de trabajo y configure Proyecto en
Predeterminado.
l Seleccione Mostrar hojas como pestañas si creó hojas múltiples y desea que
sus pestañas aparezcan en la parte inferior de la vista.
l Seleccione Incrustar contraseña para fuente de datos si desea que los
usuarios que no tienen una cuenta en la base de datos puedan ver la vista.
l Cuando termine, haga clic en Guardar.
Editar una vista
En la sección Vistas, puede abrir una vista para editar en una de las siguientes formas:
l
l
Haga clic en Editar en la información de herramienta que aparece cuando sitúa el
puntero sobre la vista.
Seleccione una vista para mostrar, y haga clic en Editar en la parte superior de la vista.
Si el libro de trabajo tiene una conexión con una base de datos de acceso en tiempo real, se le
solicitará autenticación.
Tableau ServerEntorno de edición
El entorno de edición Web de servidor es similar a Tableau Desktop. La ventana de datos
aparece al lado izquierdo y muestra los nombres de las fuentes de datos incluidas en el libro de
trabajo, y los campos, parámetros y conjuntos incluidos en la fuente de datos activa.
Similarmente, en el área principal, aparece una barra de herramientas a lo largo de la parte
superior, la tarjeta Marcas y los estantes Páginas y Filtros a la izquierda de la vista, y los
estantes Columnas y Filas sobre la vista. Cualquier pestaña de hojas que se incluya en el
libro de trabajo aparecerá en la parte inferior de la vista.
Cuando abre una vista para editarla, puede editar las otras vistas en el mismo libro de trabajo,
pero no los paneles de control. También puede seleccionar la pestaña Hoja nueva para
comenzar a crear una nueva vista.
Para obtener detalles sobre cómo usar uno de estos componentes para editar las vistas,
consulte los temas que se listan en la parte inferior de este tema.
Guardar o eliminar cambios
Cuando trabaja con una vista, puede guardar o eliminar los cambios en cualquier momento,
usando los enlaces sobre el área de la vista.
Cuando guarda su trabajo, a pesar de que ingresó al entorno de edición desde una vista única,
el libro de trabajo completo se guarda, incluidas otras vistas que puede o no haber editado.
l
l
l
l
Guardar sobrescribe el libro de trabajo original.
Guardar como crea un nuevo libro de trabajo en el mismo proyecto.
Si desea mantener tanto la versión original de la vista y su versión editada, use Guardar
como para crear un nuevo libro de trabajo.
Revertir elimina las ediciones y regresa a la última versión guardada de una vista.
Terminar sale del entorno de edición.
Si tiene cambios que no ha guardado, se le solicitará que los guarde. Si opta por no
guardarlos, los cambios sin guardar seguirán presentes cuando vuelva al modo de
edición de la vista, siempre que su sesión en el servidor actual permanezca iniciada.
Como guarda los libros de trabajo depende de los permiso que le otorgó el administrador.
Para obtener más información, consulte Quién puede crear, editar y guardar vistas.
Barra de herramientas
Cuando está editando una lista, puede usar la barra de herramientas en la parte superior de la
vista para realizar acciones comunes.
Deshacer/Rehacer
Deshacer y rehacer una acción o serie de acciones. Puede deshacer o rehacer prácticamente
cualquier tipo de cambio en la vista seleccionando esas opciones de la barra de herramientas.
Colocar en pausa las actualizaciones
Cuando coloca un campo en un estante, Tableau genera la vista al consultar la fuente de
datos. Si las actualizaciones parecen lentas al editar la vista, puede colocarlas en pausa
mientras realiza una serie de ediciones y luego volver a activarlas.
Intercambiar
Esto traslada los campos del estante Filas al estante Columnas y viceversa. Se usa
principalmente con tipos de vistas basados en ejes x- e y-.
Totales
Puede calcular automáticamente totales generales y subtotales para los datos de una vista.
Seleccione Totales para ver cuatro opciones:
l
l
l
l
Mostrar totales generales de columna: agrega una fila que muestra totales para
todas las columnas de la vista.
Mostrar totales generales de fila; agrega una columna que muestra totales para
todas las filas de la vista.
Agregar todos los subtotales: inserta filas y columnas de subtotales en la vista, si
tiene varias dimensiones en una columna o fila.
Eliminar todos los subtotales: elimina las filas o columnas de subtotales.
Ocultar/mostrar etiquetas
Seleccione mostrar u ocultar etiquetas de marcas en la vista.
Tamaño de vista
Use las opciones bajo Tamaño de vista para cambiar las proporciones de su vista dentro de
la ventana del navegador, y alterne entre ver los detalles y ver la imagen completa. Los
comandos de Tamaño de celda tienen distintos efectos según el tipo de visualización.
Hoja de trabajo
Contiene opciones para realizar cambios en el nivel de hoja de trabajo. Cree hojas de trabajo,
modifique nombres de hojas, borre formatos de hojas o borre la hoja completa.
Exportar
Use las opciones en Exportar para capturar partes de su vista para usarlas en otras
aplicaciones.
l
l
l
l
Imagen: Muestra la vista o el dashboard como una imagen en una nueva pestaña de
navegador.
Datos: Muestra los datos desde la vista en una nueva ventana de navegador con dos
pestañas: Resumen, que muestra datos totales para los campos que aparecen en la
vista, y Subyacente, que muestra datos subyacentes para las marcas seleccionadas en
la visualización. Si no se abre la nueva ventana, es posible que necesite deshabilitar el
bloqueador de ventanas emergentes de su navegador.
Tabulación cruzada: Guarda los datos subyacentes para las marcas seleccionadas en
la visualización en un archivo CSV (valores separados por comas) que se puede abrir
en Microsoft Excel.
PDF: Abre la vista actual como un PDF en una nueva ventana de navegador. Desde ahí
puede guardarlo como archivo. Si no se abre la nueva ventana, es posible que necesite
deshabilitar el bloqueador de ventanas emergentes de su navegador.
Mostrarme
Abre un control que muestra una gama de tipos de visualizaciones que puede usar en
Tableau. Cuando muestra la lista Mostrarme, los datos que se usan actualmente en la vista
determinan qué tipos de visualización están disponibles para su selección. También puede
situar el puntero sobre un tipo de visualización para ver qué tipos de campo se requieren para
hacer que ese tipo de visualización esté disponible.
Ventana de datos
En la parte superior de la ventana de datos hay una lista de las fuentes de datos disponibles en
el libro de trabajo. Si desea editar un libro de trabajo existente, es posible que haya varias
fuentes de datos. Seleccione una fuente de datos para ver las dimensiones y medidas para
esa fuente de datos. Si desea crear un nuevo libro de trabajo, ve solo la fuente de datos desde
la que creó el libro de trabajo.
Todas las fuentes de datos contienen campos. Estos campos aparecen bajo la lista de fuentes
de datos en la ventana de datos. Las dimensiones y medidas siempre aparecen, otros tipos de
campos aparecen si están presentes en la fuente de datos:
l
l
l
l
Las dimensiones son campos que contienen datos cualitativos discretos. Algunos
ejemplos de las dimensiones incluyen fechas, nombres de clientes y segmentos de
clientes.
Las medidas son campos que contienen datos numéricos que se pueden agregar. Los
ejemplos de medida incluyen ventas, ganancias, número de empleados, temperatura,
frecuencia y presión.
Los conjuntos son campos personalizados que definen un subconjunto de datos
basado en algunas condiciones. Un conjunto puede basarse en una condición
calculada, que se actualiza a medida que cambian los datos, o una lista constante de
valores. Los conjuntos pueden estar presentes en los libros de trabajo que edite, pero
no puede crear conjuntos.
Los parámetros son valores dinámicos que pueden reemplazar valores constantes en
los cálculos, los filtros y las líneas de referencia. Los parámetros pueden estar presentes
en los libros de trabajo que edite, pero no puede crear parámetros.
Para crear visualizaciones, debe arrastrar campos desde la ventana de datos a los estantes
Filas y Columnas, la tarjeta Marcas o uno de los otros estantes disponibles. Para ver una
demostración, consulte Crear un libro de trabajo y una vista.
Estantes Columnas y Filas
Arrastre campos al estante Columnas para crear las columnas de una tabla, o al estante Filas
para crear las filas de una tabla. También puede arrastrar varios campos a cualquier estante.
Los valores discretos (normalmente, dimensiones) se muestran en azul en los estantes
Columnas y Filas; los valores continuos (normalmente, medidas) se muestran en verde.
En el extremo derecho de cualquier campo que ubique en el estante Columnas o Filas hay un
menú desplegable que puede usar para configurar la dimensión o la medida:
Las opciones disponibles dependen del tipo de campo. La lista completa de opciones incluye:
l
Incluir en Información sobre herramientas
De forma predeterminada, todos los campos del estante Columnas y Filas se incluyen
en las informaciones sobre herramientas que aparecen al mover el mouse sobre una o
más marcas en la vista. Desmarque esta opción para eliminar un campo de las
informaciones sobre herramientas.
l
Mostrar filtro
Seleccione esta opción para agregar un filtro a este campo para la vista. Los usuarios
podrán especificar qué datos incluir y excluir para esta dimensión o medida.
l
Discretas/Continuas
Use estas opciones para convertir un rango continuo de valores en un conjunto de
valores discretos o un conjunto de valores discretos en un rango continuo.
l
Dimensión/atributo/medida
Use este rango de opciones para convertir una dimensión en una medida o una medida
en una dimensión.
También puede definir la opción como un atributo, lo que devuelve el valor de la
expresión dada si solo tiene un valor individual para todas las filas del grupo, de lo
contrario, muestra un asterisco (*). Se ignoran los valores Null.
l
Cálculo de tablas rápido
Proporciona un conjunto de opciones para redefinir el significado de las marcas para el
valor.
l
Eliminar
Elimina el valor del estante Columnas o Filas.
Opciones de la dimensión de fecha
Hay un conjunto de opciones adicional disponible para dimensiones de fecha:
Seleccione una de las opciones desde el grupo superior para definir la granularidad de los
datos como valores discretos. Por ejemplo, si selecciona Mes su vista combinará los datos de
cada mes nombrado en sus datos a lo largo del rango completo de años:
Hay exactamente doce marcas en los datos, una para cada mes. La marca de noviembre
combina los datos de noviembre de 2008, noviembre de 2009, etc.
Seleccione una de las opciones desde el grupo inferior para definir la granularidad de los datos
como valores continuos. Por ejemplo, si selecciona Mes su vista mostrará sus datos en forma
secuencial, sobre el rango de meses disponibles.
En este caso, hay 48 marcas en los datos, una para cada mes desde noviembre de 2008.
Tarjeta Marcas
Al arrastrar campos a la vista, los datos aparecen con marcas. Cada marca representa la
intersección de todas las dimensiones de la vista. Por ejemplo, en una vista con las
dimensiones Región y Año, hay una marca para cada combinación de esos dos campos
(oriente 2011, oriente 2012, occidente 2011, occidente 2012).
Las marcas pueden aparecer de muchas formas distintas, incluidas líneas, formas, barras,
mapas, etc. Puede mostrar información adicional sobre los datos con propiedades de las
marcas, como color, tamaño, forma, etiquetas, etc. El tipo de marca que utiliza y las
propiedades de las marcas los controla la tarjeta Marcas. Arrastre campos a la tarjeta Marcas
para mostrar más datos. Por ejemplo, la misma vista de arriba vuelve a aparecer abajo pero
esta vez con Ganancias en Color. Con esta información adicional, está claro que la región del
sur no fue rentable el 2010.
Controle las marcas en la vista con la tarjeta Marcas. Utilice el menú desplegable para
especificar el tipo de marca que desea mostrar. Arrastre los campos a la tarjeta Marcas y
utilice los controles desplegables para agregar más información a la vista y controlar el color, la
forma, el tamaño, las etiquetas y el número de marcas en la vista.
Tipos de marca
Los tipos de marca están disponibles en el menú desplegable de la tarjeta Marcas.
Propiedades de marca
Puede controlar los colores, el tamaño, la forma y otras propiedades de las marcas en la vista.
Arrastre un campo a una propiedad en la tarjeta Marcas para codificar las marcas usando sus
datos.
Las propiedades disponibles varían entre los tipos de marca. Por ejemplo, la propiedad Forma
solo está disponible para el tipo de marca de forma y la propiedad Ángulo solo está disponible
para el tipo de Marca circular.
Las propiedades son:
Propiedad
Descripción
Codifica los datos al asignar diferentes colores a las marcas en una
vista de datos basada en los valores de un campo.
Se aplican paletas de colores cuantitativas a los campos continuos,
como la medición de ganancias. Se aplican paletas categóricas a los
campos discretos, como campos que representen regiones
geográficas.
Cambie la paleta de colores o la transparencia seleccionando Color
y luego usando el control y la barra deslizante de paleta.
Color
Tamaño
Separa las marcas según los miembros en una dimensión y asigna
un tamaño único a cada miembro. Debido a que el tamaño posee un
orden inherente (pequeño a grande), los tamaños categóricos
funcionan mejor para datos ordenados como años o trimestres.
Para cambiar el tamaño general de las marcas en la vista,
seleccione tamaño y arrastre la barra deslizante.
Codifica los datos al asignar etiquetas de texto a las marcas. Al
trabajar con una tabla de texto, esta propiedad se llama Texto, y
muestra los números asociados con la vista de datos.
Para mostrar u ocultar las etiquetas en las marcas, seleccione
Etiqueta y luego marque o desmarque la casilla de verificación.
Etiqueta/texto
Detalle
Cuando pone una dimensión en el estante Filas o Columnas, los
miembros categóricos crean encabezados de tablas. Los
encabezados representan niveles de detalle porque separan las filas
de la fuente de datos en categorías específicas. Puede identificar
cada categoría por el nombre del miembro.
La propiedad Detalle también permite separar las marcas en una
vista de datos según los miembros (niveles de detalle) de una
dimensión. Sin embargo, a diferencia del estante Filas y Columnas,
esta propiedad no modifica la estructura de tablas.
Información sobre
herramientas
Agrega el nombre y valor del campo a la información sobre
herramientas de cada marca.
Ruta
Permite codificar datos al conectar marcas que usan un orden de
dibujo en particular. Puede codificar sus datos por ruta mediante una
dimensión o una medida. Cuando pone una dimensión en Ruta,
Tableau conecta las marcas según los miembros en la dimensión. Si
la dimensión es una fecha, el orden del trazado lo proporciona el
orden de las fechas. Si la dimensión contiene palabras, como
nombres de clientes o tipos de productos, el orden del trazado lo
proporciona el orden de los miembros en la fuente de datos. Cuando
pone una medida en Ruta, Tableau conecta las marcas según los
valores de la medida.
La propiedad Ruta está disponible solo cuando selecciona el tipo de
marcas de línea o polígono en el menú Marca.
Forma
Separa las marcas según los miembros en la dimensión y asigna
una forma única a cada miembro.
Estante Filtros
Use el estante Filtros para especificar qué datos incluir y excluir para una dimensión o medida.
Por ejemplo, podría querer analizar las ganancias para cada segmento de cliente, pero solo
para ciertos contenedores de envío y tiempos de entrega. Al colocar la dimensión Contenedor
en el estante Filtros, puede especificar qué contenedores incluir. En forma similar, puede
colocar el campo Fecha de entrega en el estante Filtros para definir qué tiempos de entrega
incluir.
Cuando arrastra una dimensión o medida al estante Filtros, Tableau inserta automáticamente
un control de filtro en una vista para seleccionar los valores que se mostrarán. Por ejemplo:
Para dimensiones, el control de filtros muestra valores discretos, como en la parte de arriba.
Para medidas, el control muestra un rango continuo:
Sitúe el mouse sobre la derecha del título del control de filtro para especificar cómo se
mostrarán los valores en el control:
Estante Páginas
Arrastre una dimensión o medida al estante Páginas para dividir una vista en una serie de
páginas para que pueda analizar mejor cómo un campo específico afecta al resto de los datos
en una vista. Arrastrar una dimensión al estante Páginas es como agregar una nueva fila para
cada miembro en la dimensión. Al arrastrar una medida al estante Páginas, la medida se
convierte automáticamente en una medida discreta que se puede dividir en páginas
individuales.
Cuando arrastra una dimensión o medida al estante Páginas, Tableau inserta
automáticamente un control en la vista para permitirle navegar en las páginas de su vista. Por
ejemplo:
Puede avanzar manualmente a través de la secuencia de páginas en cualquiera de las
siguientes formas:
l
l
l
Use el menú desplegable para seleccionar un valor.
Usar los botones de adelantamiento y retroceso a los lados de la lista desplegable para
navegar a través de las páginas una a la vez.
Usar la barra deslizante de Página para desplazarse rápidamente hacia delante y atrás
en la secuencia de páginas.
Seleccione Mostrar historial para mostrar marcas de páginas previas además de marcas
para la página actual.
Información sobre herramientas
Coloque el cursor sobre una marca en la vista para ver la información sobre herramientas para
esa marca.
Las informaciones para herramientas proporcionan información sobre los valores de
dimensiones y medidas para la marca seleccionada:
Las informaciones sobre herramientas también proporcionan estas opciones:
l
Solo conservar
Excluye todas las marcas desde la vista, excepto esta.
l
Excluir
Excluye solo esta marca.
l
Agrupar miembros
Seleccione el icono de sujetapapeles para crear un nuevo grupo, que es una dimensión,
desde la marca seleccionada. Normalmente, seleccionaría varias marcas y luego
crearía un grupo. Por ejemplo, si tiene una dimensión Región con los valores Norte,
Sur, Este y Oeste, podría seleccionar Sur y Oeste y luego crear un grupo para ellos.
l
Ver datos
Seleccione el icono de tabla para abrir una nueva ventana de navegador que muestra
dos pestañas: Resumen, que muestra solo datos para la marca actual, y Subyacente,
que muestra datos para la vista completa.
Trabajar con permisos
Lo que puede con las vistas, libros de trabajo, proyectos y fuentes de datos en Tableau Server
está controlado por su nivel de licencia (especificado por un administrador) y los permisos
establecidos por el autor de la vista o fuente de datos.
Puede cambiar los permisos de un elemento si tiene un nivel de licencia de interaccionador y al
menos una de las siguientes condiciones es verdadera:
l
Es propietario del libro de trabajo o fuente de datos (la publicó en el servidor).
l
Tiene asignado el permiso para configurar permisos.
l
l
Tiene asignado el permiso de Líder de proyecto para el proyecto que contiene el
elemento.
Se le ha otorgado derecho de administración.
Consulte los siguientes temas para obtener más información:
Cómo se configuran los permisos
El diagrama a continuación ilustra la forma en que se evalúan los permisos.
Si un libro de trabajo está configurado para mostrar hojas como pestañas, todas las
vistas heredan los permisos del libro de trabajo aunque se especifiquen permisos
diferentes en una vista individual.
Configurar permisos para libros de trabajo y vistas
Siga los pasos a continuación para configurar permisos para un libro de trabajo o vista.
1. En una página que muestre uno o más libros de trabajo, o una o más vistas, haga clic y
seleccione uno o más libros de trabajo o vistas y, a continuación, haga clic en Permisos:
2. Haga clic en Agregar/Editar permisos en la página Permisos: Libro de trabajo o
permisos: Vista:
La opción Asignar permisos a contenido aparece para los libros de trabajo
pero no para las vistas.
3. En la ventana Agregar/Editar permisos, seleccione un usuario o grupo en la lista que
aparece a la izquierda:
Puede configurar la lista para mostrar usuarios, grupos o ambos.
4. Seleccione un rol predefinido en el menú desplegable Rol o especifique permisos
individuales en el área de abajo. La lista de permisos y los roles predefinidos varían
levemente según si está definiendo permisos para un libro de trabajo o para una vista.
Consulte Permisos para ver una tabla que define los diversos permisos y los elementos
a los que se aplican.
Los roles disponibles para los libros de trabajo y las vistas son:
Rol
Visor
Se aplica
Descripción
a...
libros de
trabajo
vistas
Interaccionador
libros de
trabajo
vistas
Editor
libros de
trabajo
Permite al usuario o grupo ver el libro de trabajo o
la vista en el servidor.
Permite al usuario o grupo ver el libro de trabajo o
la vista en el servidor, editar vistas de libros de
trabajo, aplicar filtros, ver datos subyacentes,
exportar imágenes y exportar datos. Todos los
demás permisos se heredan de los permisos del
proyecto del usuario o del grupo.
Otorga todos los permisos al usuario o grupo
vistas
Conector de fuente
de datos
Editor de fuente de
datos
vistas
Permite al usuario o grupo conectarse a la fuente
de datos del servidor. Este permiso es pertinente
para las vistas cuando se accede a una vista que
se conecta con una fuente de datos.
vistas
Permite al usuario o grupo conectarse a las
fuentes de datos del servidor. También permite
publicar, editar, descargar, eliminar y definir
permisos para una fuente de datos y programar
actualizaciones para las fuentes de datos que
usted publique. Este permiso es pertinente para
las vistas cuando se accede a una vista que se
conecta con una fuente de datos.
5. Puede configurar permisos para uno o varios usuarios o grupos. Cuando haya
terminado, haga clic en Enviar.
Configurar permisos para una fuente de datos
Siga los pasos a continuación para configurar permisos para una fuente de datos.
1. En la página Fuentes de datos, haga clic para seleccionar una o más fuentes de datos y
haga clic en Permisos.
2. Haga clic en Agregar/Editar permisos en la página Permisos: Fuente de datos:
3. En la ventana Agregar/Editar permisos, seleccione un usuario o grupo en la lista que
aparece a la izquierda:
4. Seleccione un rol predefinido en el menú desplegable Rol o especifique permisos
individuales en el área de abajo. Consulte Permisos para ver una tabla que define los
diversos permisos y los elementos a los que se aplican.
Los roles disponibles para las fuentes de datos son:
Rol
Descripción
Conector de fuente
de datos
Permite al usuario o grupo conectarse a la fuente de datos del
servidor.
Editor de fuente de
datos
Permite al usuario o grupo conectarse a las fuentes de datos
del servidor. También permite publicar, editar, descargar,
eliminar y definir permisos para una fuente de datos y
programar actualizaciones para las fuentes de datos que
usted publique.
5. Puede configurar permisos para uno o varios usuarios o grupos. Cuando haya
terminado, haga clic en Enviar.
Configurar permisos para un proyecto
Los administradores y líderes de proyectos pueden especificar permisos de proyectos.
Cuando crea un proyecto nuevo, cuenta con los mismo permisos que el proyecto
Predeterminado. Puede definir permisos permitir o denegar el acceso al proyecto a personas
individuales y grupos. Para especificar permisos de proyectos:
1. Haga clic en Administrador >Proyectos.
2. Haga clic para seleccionar uno o más proyectos y haga clic en Permisos:
3. Haga clic en Agregar/Editar permisos en la página Permisos: Proyecto:
4. En la ventana Agregar/Editar permisos, seleccione un usuario o grupo en la lista que
aparece a la izquierda:
Puede configurar la lista para mostrar usuarios, grupos o ambos.
5. Seleccione un rol predefinido en el menú desplegable Rol o especifique permisos
individuales en el área de abajo. Consulte Permisos para ver una tabla que define los
diversos permisos y los elementos a los que se aplican.
Los roles disponibles para los proyectos son:
Rol
Descripción
Visor
Permite al usuario o grupo ver los libros de trabajo y las vistas
del proyecto.
Interaccionador
Permite al usuario o grupo ver los libros de trabajo y las vistas
del proyecto, editar vistas de libros de trabajo, aplicar filtros,
ver datos subyacentes, exportar imágenes y exportar datos.
Editor
Otorga todos los permisos al usuario o grupo
Conector de fuente
de datos
Permite al usuario o grupo conectarse a las fuentes de datos
del proyecto.
Editor de fuente de
datos
Permite al usuario o grupo conectarse a las fuentes de datos
del proyecto. También permite publicar, editar, descargar,
eliminar y definir permisos para una fuente de datos y
programar actualizaciones para las fuentes de datos que
usted publique. Este permiso es pertinente para las vistas
cuando se accede a una vista que se conecta con una fuente
de datos.
Líder de proyecto
Permite al usuario o grupo definir permisos para todos los
elementos de un proyecto.
Publicador
Otorga al usuario o grupo todos los permisos necesarios para
publicar libros de trabajo en el servidor.
Los permisos que especifica se aplican al proyecto en sí mismo. Ningún permiso explícito
definido en los libros de trabajo, vistas y fuentes de datos del proyecto resulta afectado. Sin
embargo, tiene la opción de asignar los permisos del proyecto a todos los libros de trabajo,
vistas y fuentes de datos del proyecto. En ese caso, estos permisos anulan los permisos
existentes en los libros de trabajo y vistas. Por ejemplo, diga que hay varios libros de trabajo
que cada uno ha sido publicado con permisos personalizados y agrupa los libros de trabajo en
un nuevo proyecto con una nueva configuración de permisos. Puede aplicar los nuevos
permisos a cada uno de los libros de trabajo haciendo clic en Asignar permisos a contenido
en la página Permiso.
Verificar permisos actuales
En cualquier momento, puede ver los permisos de un usuario para una vista, libro de trabajo,
proyecto o fuente de datos en particular. Desde cualquier página donde pueda definir
permisos, seleccione un usuario en la lista desplegable Verificar permisos de usuario.
Los permisos que se muestran son específicos de la vista, el libro de trabajo, la fuente de datos
o el proyecto que haya seleccionado.
Permisos
Los administradores y otros usuarios autorizados pueden permitir o denegar permisos para
acciones que los usuarios pueden llevar a cabo en Tableau Server. También es posible
establecer permisos en Tableau Desktop al publicar un libro de trabajo o una fuente de datos
en Tableau Server.
Los administradores siempre tienen el control completo de todos los activos de Tableau
Server, y los administradores de sitios tienen el control completo de todos los activos de un
sitio. Si publica un libro de trabajo o una fuente de datos en Tableau Server, usted es el
publicador de ese activo y conserva el control completo del mismo.
La siguiente tabla muestra qué permisos se aplican a qué elementos en Tableau Server y
describe las acciones que los usuarios pueden llevar a cabo con cada permiso.
Permiso
Afecta a...
libros de
trabajo
Vista
fuentes de
datos
vistas
proyectos
Cuando se permite, los usuarios pueden...
Vea el elemento en Tableau Server. Un usuario que
accede a una vista que se conecta a una fuente de
datos debe tener permiso de Vista para el libro de
trabajo y de Conexión para la fuente de datos.
Permiso
Afecta a...
Cuando se permite, los usuarios pueden...
Editar vistas en libros de trabajo. Consulte Quién
puede crear, editar y guardar vistas.
libros de
trabajo
Editar en Web
vistas
proyectos
libros de
trabajo
Escribir/Guardar en fuentes de
datos
Web
vistas
proyectos
Descargar/Guardar libros de
en Web como
trabajo
Los permisos de las hojas de trabajo (vistas) de un
libro de trabajo se copian (sobrescriben) a partir de
los permisos del libro de trabajo cuando publica un
libro de trabajo desde Tableau Desktop. También se
copian cuando hace clic en Asignar permisos a
contenido en la página Permisos: Libro de trabajo.
Si selecciona Mostrar hojas como tabulaciones
al guardar un libro de trabajo, los permisos de todas
las hojas de trabajo (vistas) del libro de trabajo son
sobrescritas por los permisos del libro de trabajo,
pero solo hasta que las tabulaciones se deshabiliten.
Consideración especial para el grupo Todos los
usuarios: En el interés de evitar que otro usuario
sobrescriba el contenido de un publicador (ya sea al
publicar desde Tableau Desktop o al guardar un libro
de trabajo editado en Web en Tableau Server), cada
vez que un usuario publica un proyecto donde el
grupo Todos los usuarios tenga permisos, el
permiso Escribir/Guardar en Web para el grupo
Todos los usuarios cambia de Permitir a Heredar
de manera predeterminada. Puede modificar este
permiso de manera manual mediante los siguientes
pasos en Configurar permisos para libros de trabajo
y vistas para cambiar de Heredar a Permitir.
Sobrescribir el elemento en el servidor. Cuando se
permite, el usuario puede volver a publicar un libro
de trabajo o fuente de datos de Tableau Desktop,
con lo cual se convierte en el publicador y se
adjudica todos los permisos. Desde ese punto en
adelante, el acceso del publicador original al libro de
trabajo estará determinado por los permisos del
grupo de ese usuario y cualquier permiso adicional
que el publicador decida definir.
Este permiso también determina la capacidad del
usuario o del grupo para sobrescribir un libro de
trabajo después de editarlo en el servidor. Consulte
Quién puede crear, editar y guardar vistas.
Cuando se permite, un usuario puede descargar el
elemento del servidor y también guardar un libro de
Permiso
Afecta a...
Cuando se permite, los usuarios pueden...
fuentes de
datos
trabajo editado como un libro de trabajo nuevo en el
servidor. Consulte Descargar libros de trabajo y
Quién puede crear, editar y guardar vistas.
proyectos
libros de
trabajo
Eliminar
fuentes de
datos
Eliminar el elemento.
vistas
proyectos
libros de
trabajo
Filtro
vistas
Modificar los filtros rápidos, mantener solo los filtros
y excluir los datos. Consulte Comentar en vistas.
proyectos
Agregar
comentario
libros de
trabajo
vistas
Agregar comentarios a las vistas en un libro de
trabajo.
proyectos
libros de
trabajo
Ver comentarios
vistas
Ver los comentarios asociados con las vistas de un
libro de trabajo.
proyectos
Ver datos de
resumen
libros de
trabajo
vistas
Ver los datos agregados en una vista o en la
selección del usuario dentro de la vista y descargar
esos datos como archivo de texto.
proyectos
Ver datos
subyacentes
libros de
trabajo
vistas
proyectos
libros de
trabajo
Exportar imagen
vistas
proyectos
Ver todos los datos en bruto detrás de cada fila en
una vista, restringidos según las marcas que el
usuario haya seleccionado, y descargar los datos
como archivo de texto.
Exportar cada vista como imagen. Consulte
Exportar vistas.
Permiso
Compartir
personalizada
Afecta a...
libros de
trabajo
vistas
proyectos
Cuando se permite, los usuarios pueden...
Hacer que las personalizaciones guardadas de una
vista estén disponibles para que las vean otros
usuarios. Los usuarios pueden crear vistas
personalizadas mediante la opción Recordar mis
cambios en Tableau Server. Consulte Vistas
personalizadas.
libros de
trabajo
Mover
vistas
Mover libros de trabajo entre los proyectos.
proyectos
libros de
trabajo
Configurar
permisos
fuentes de
datos
vistas
Especificar permisos para el elemento. En los libros
de trabajo, este permiso se extiende a las vistas del
libro de trabajo.
proyectos
fuentes de
datos
Conectar
vistas
proyectos
Líder de proyecto
proyectos
Conectarse a la fuente de datos. Un usuario que
accede a una vista que se conecta a una fuente de
datos debe tener permiso de Vista para la vista y
permiso de Conexión para la fuente de datos.
Configurar permisos para todos los elementos de un
proyecto y el proyecto mismo.
Guía de administrador
La guía de administrador es su referencia completa para manipular tareas administrativas en
Tableau Server:
Antes de instalar…
Asegúrese de que la computadora en la que instala Tableau Server cumple los siguientes
requisitos:
l
Sistemas operativos admitidos: Tableau Server se encuentra disponible en
versiones de 32 y 64 bits. Puede instalar Tableau Server en Windows Server 2003 (SP1
o superior), Windows Server 2008, Windows Server 2008 R2, Windows Server 2012,
Windows Vista, Windows 7 o Windows 8. Se recomienda la versión de 64 bits de
Tableau Server en un sistema operativo de 64 bits. Puede instalar Tableau Server en
plataformas virtuales o físicas.
l
Memoria, núcleos y espacio en el disco: los requisitos de sistema de Tableau
Server varían en función de muchos factores. Las siguientes recomendaciones se
basan en la cantidad de usuarios del servidor:
Tipo de implementación
Nº usuarios de
servidor
CPU
RAM
Evaluación (solo servidor
Tableau de 32 bit)
1-2
2 núcleos
4 GB
Pequeño
<25
4 núcleos
8 GB
Mediano
<100
8 núcleos
32 GB
Empresa
>100
16 núcleos
32 GB o más
Los requisitos mínimos para ejecutar la versión de 64 bits de Tableau Server son 4
núcleos y 8 GB de RAM.
l
l
l
Cuenta administrativa: la cuenta bajo la cual instala Tableau Server debe tener
permiso para instalar software y servicios.
Opcional: Cuenta Ejecutar como: una cuenta Ejecutar como usuario para que se
ejecute el servicio Tableau Server es útil si usa autenticación de NT con fuentes de
datos o si planifica realizar suplantación de SQL Server. Para obtener más información,
consulte Ejecutar como usuario y Suplantación de SQL Server.
IIS y puerto 80: La puerta de enlace de Tableau Server escucha en el puerto 80, que
también es el que utiliza de manera predeterminada Internet Information Services (IIS).
Si está instalando Tableau Server en un equipo que también ejecuta IIS, debe modificar
el número de puerto de la puerta de enlace de Tableau para evitar que se produzca un
conflicto con IIS. Consulte Puertos TCP/IP y Editar los puertos predeterminados para
conocer más detalles.
Información de configuración
Cuando instala y configura Tableau Server es posible que se le solicite la siguiente
información:
Opción Descripción
Cuenta El servidor debe tener una cuenta de usuario que el servicio
de
pueda usar. El valor predeterminado es la cuenta de
servidor Network Service de Windows. Si usa una cuenta de usuario
específica, necesita el nombre de dominio, nombre de
usuario y contraseña.
Active
En lugar de usar el sistema de administración de usuario
Directory incorporado de Tableau Server, puede autenticar mediante
Active Directory. Si es así, necesita el nombre de dominio
completamente calificado.
Su
información
Nombre de
usuario:
Contraseña:
Dominio:
Dominio de
Active
Directory:
Opción Descripción
Su
información
Puerto Cuando se selecciona, Tableau Server abrirá el puerto
__ - Sí
abierto usado para solicitudes http en el software Windows Firewall __ - No
en el
para permitir que otras máquinas en la red accedan al
firewall servidor.
de
Windows
Puertos
De forma predeterminada, Tableau Server requiere que varios puertos TCP/IP estén
disponibles para el servidor. Consulte el tema Puertos TCP/IP para ver la lista completa,
incluidos los puertos que deben estar disponibles para todas las instalaciones en comparación
con las instalaciones distribuidas o las instalaciones listas para conmutación tras error. Los
puertos predeterminados se pueden cambiar si existe un conflicto. Consulte Editar los puertos
predeterminados para saber cómo.
Controladores
Es posible que deba instalar controladores de bases de datos adicionales. Descargue
controladores de www.tableausoftware.com/support/drivers.
Instalar y configurar
Aquí se presentan los pasos principales que debe realizar para instalar y configurar Tableau
Server:
Ejecutar configuración de servidor
Después de instalar el archivo de instalación de Tableau Server, siga las instrucciones a
continuación para instalar el servidor.
1. Haga doble clic en el archivo de instalación.
2. Siga las instrucciones en pantalla para finalizar la configuración e instalar la aplicación.
3. Después que la instalación finaliza, haga clic en Siguiente para abrir la ventana
Administrador de claves de producto.
Si necesita compatibilidad de caracteres que no están en el conjunto Latin-1, instale
paquetes de idiomas de Windows mediante Cuadro de mando > Opciones
regionales y de idiomas. Se debe instalar los paquetes de idiomas en el servidor
primario y en la máquina de cualquier trabajador.
Activar Tableau
Tableau Server requiere al menos una clave de producto que activa el servidor y especifica la
cantidad de niveles de licencia que puede asignar a usuarios. Puede acceder a claves de
producto de Centro de cuentas de clientes de Tableau. Después de instalar y configurar el
servidor, el administrador de claves del producto se abre automáticamente de forma que
pueda ingresar la clave del producto y registrar el producto. Si necesita activar el producto en
una computadora fuera de línea, consulte Activar Tableau fuera de línea.
1. Seleccione Activar y pegue la clave del producto:
2. Consulte la página de ayuda de descarga en el sitio Web para obtener instrucciones
paso a paso.
Activar Tableau fuera de línea
Si trabaja fuera de línea puede seguir los pasos a continuación para completar la activación
fuera de línea.
1. Cuando se abre el administrador de claves del producto haga clic en Activar el
producto.
Pegue la clave de producto de servidor en el cuadro de texto correspondiente y haga clic
en Activar. Puede obtener la clave del producto desde el Portal de clientes de Tableau..
2. Cuando está fuera de línea, la activación fallará y se le brinda la opción de guardar un
archivo que puede usar para activación fuera de línea. Haga clic en Guardar.
3. Seleccione una ubicación para el archivo y haga clic en Guardar. El archivo se guarda
como offline.tlq.
4. De vuelta en Tableau haga clic en Salir para cerrar el cuadro de diálogo Activación.
5. Desde una computadora que tenga acceso a Internet, abra un navegador Web y visite
la página Activación de productos en el sitio Web de Tableau,Complete las
instrucciones para enviar su archivo offline.tlq.
6. Tableau le enviará un correo electrónico con un archivo llamado activation.tlf. Mueva
este archivo a la computadora donde instala Tableau Server. Si tiene Tableau Desktop
instalado en la computadora entonces puede hacer doble clic en el Nuevo archivo
para completar la activación. Si no tiene Tableau Desktop instalado continue al paso 7.
7. En la computadora donde instala Tableau Server, abra una cadena de comandos como
administrador y ejecute el siguiente comando.
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
8. A continuación, escriba tabadmin activate --tlf
<path>\activation.tlf, donde <path> es la ubicación del archivo de respuesta
que Tableau en envió por correo electrónico. Por ejemplo:
tabadmin activate --tlf \Desktop\activation.tlf
Mantenga abierta la ventana de la línea de comando.
9. Luego de inicializar la licencia, se le pedirá que vuelva a activar el producto. En Tableau
Server, haga clic en Inicio > Todos los programas > Tableau Server 8.1>
Administrar claves de productos.
10. Haga clic en Activar el producto.
11. Ingrese su clave de producto nuevamente (la misma que ingresó en el paso 1).
12. Guarde el archivo .tlq.
13. Desde una computadora que tenga acceso a internet, abra un navegador Web y visite la
página Activación de productos nuevamente en el sitio Web de Tableau. Complete las
instrucciones.
14. Tableau le enviará un archivo llamado activation.tlf por correo electrónico. Mueva este
archivo a la computadora donde instala Tableau Server.
15. De vuelta en la ventana de línea de comando de Tableau Server, ingrese tabadmin
activate --tlf <ruta>\activation.tlf, donde <ruta> es la ubicación
del segundo archivo de respuesta que Tableau le envió por correo electrónico. Por
ejemplo:
tabadmin activate --tlf \Desktop\activation.tlf
Ahora Tableau Server se encuentra activado. Si necesita asistencia adicional,
comuníquese con el servicio al cliente de Tableau.
Configurar el servidor
Se muestra el cuadro de diálogo Configurar durante la Configuración. Puede abrirlo tras la
Instalación seleccionando Todos los programas > Tableau Server 8.1 > Configurar
Tableau Server en el menú de inicio de Windows. Debe detener el servidor antes de realizar
cualquier cambio de configuración. Consulte Reconfigurar el servidor para conocer los pasos.
Hay dos cosas que debe tener en mente para la configuración que especifique en el cuadro de
diálogo Configuración:
l
l
La configuración abarca todo el sistema: La configuración que ingrese se aplica al
servidor completo. Si el servidor ejecuta múltiples sitios, esta configuración afecta a
cada sitio.
La autenticación del usuario es "permanente": Todas estas configuraciones se
pueden cambiar después de Configuración al detener el servidor y volver a configurar.
La excepción es la configuración Autenticación de usuario (pestaña General). Es
"permanente" en el sentido de que cambiar Usar autenticación local a Usar Active
Directory requiere desinstalar y volver a instalar el servidor.
Consulte los temas a continuación para obtener detalles sobre las distintas pestañas de
Configuración:
General
Use los pasos a continuación para configurar las opciones en la pestaña General:
1. De manera predeterminada, Tableau Server se ejecuta bajo una cuenta de Network
Service. Para usar una cuenta que acomodará autenticación NT con fuentes de datos,
especifique un nombre de usuario y contraseña. El nombre de usuario debe incluir el
nombre de dominio. Consulte Ejecutar como usuario para obtener más información
sobre el uso de una cuenta de usuario específica.
2. Seleccione si desea usar Active Directory para autenticar usuarios en el servidor.
Seleccione Usar autenticación local para crear usuarios y asignar contraseñas
mediante el sistema de administración de usuario incorporado en Tableau Server. No
puede alternar entre Active Directory y autenticación local posteriormente.
3. Si usa Active Directory:
l
l
Opcionalmente, puede Activar el inicio de sesión automático, que usa
Microsoft SSPI para iniciar sesión basándose en su nombre de usuario y
contraseña de Windows. No seleccione Activar inicio de sesión automático si
planea configurar Tableau Server para SAML o autentificación confiable.
Asegúrese de escribir el nombre de domino completamente calificado (FQDN) y
apodo.
Para determinar el FQDN: Seleccione Inicio > Ejecutar, luego escriba
sysdm.cpl en el cuadro de texto Ejecutar. En el cuadro de diálogo Propiedades
del sistema, seleccione la pestaña Nombre de computadora. El FQDN se
muestra cerca del centro del cuadro de diálogo. La primera vez que los usuarios
inician sesión, deben usar el nombre de dominio completamente calificado (por
ejemplo, myco.lan\jsmith). En los inicios de sesión posteriores, pueden usar
el apodo (myco\jsmith).
4. El puerto predeterminado para acceso Web a Tableau Server (via HTTP) es el puerto
80. Es posible que deba cambiar el número de puerto si tiene otro servidor que se
ejecuta en el puerto 80 o debido a otras necesidades de conexión de red. Por ejemplo,
es posible que tenga un firewall de hardware o proxy delante del host de Tableau
Server, el cual haga que la ejecución de un sistema back-end en el puerto 80 sea
indeseable.
5. Seleccione si va a abrir un puerto en el Firewall de Windows. Si no abre este puerto, es
posible que los usuarios en otras máquinas no puedan tener acceso al servidor.
6. Seleccione si va a incluir datos de muestra y usuarios. Los datos de muestra pueden
ayudarlo a familiarizarse con Tableau Server, especialmente si va a instalar una versión
de prueba del producto. En un principio, el usuario de muestra utiliza una licencia de
interaccionador. Puede cambiar este usuario a sin licencia para recuperar los niveles de
licencia. Consulte Licencias y derechos de usuario para saber cómo. Si selecciona
incluir el usuario de muestra, se instala un solo usuario. El nombre de usuario y
contraseña se muestran a continuación:
Nombre de usuario Contraseña
Tableau Software
prueba
7. Opcionalmente, vaya a la página siguiente para configurar el guardado en caché y las
opciones de SQL inicial. Si no desea configurar estas opciones, haga clic en Aceptar.
Dominios
Cuando usa autenticación de Active Directory para el servidor puede ver una lista de los
dominios que se usan y editar sus nombres de dominio y apodos. Por ejemplo, es posible que
deba hacer esto para garantizar que Tableau Server usa el apodo correcto para autenticación
SSPI o el nombre de dominio correcto.
Modificar nombres de dominio
Para modifica un nombre de dominio:
1. Seleccione el vínculo Usuarios en el área Mantenimiento en el lado izquierdo de la
página.
2. Haga clic en el vínculo Dominios en la parte inferior de la lista de usuarios. La lista de
dominios muestra el número de usuarios y grupos que se han agregado al servidor
desde cada dominio.
3. Para mostrar una lista de usuarios que son parte de un dominio, haga clic en el nombre
de dominio.
4. Para modificar el nombre de dominio o apodo, haga clic en el vínculo Editar, escriba un
nuevo nombre de dominio completamente calificado o apodo, luego haga clic en
Modificar.
5.
Puede modificar el apodo para cualquier dominio que el servidor usa. En general,
puede modificar el nombre de dominio completo por cualquier dominio, excepto el
que se usa para iniciar sesión. Sin embargo, si el nombre de usuario con el que
inicia sesión actualmente existe en el dominio actual y el dominio nuevo, puede
modificar el nombre complete para el dominio actual.
Conexiones de datos
Use las opciones en la pestaña Conexiones de datos para configurar el guardado en caché y
especificar cómo desea administrar las declaraciones SQL iniciales desde las fuentes de
datos.
Guardando en caché
Las vistas publicadas en Tableau Server son interactivas y en ocasiones tiene un conexión en
tiempo real con una base de datos. A medida que los usuario interactúan con las vistas de un
navegador Web, los datos que se consultan son almacenados en un caché. Las visitas
posteriores extraerán los datos de este caché si está disponible. La pestaña Conexiones de
datos es donde se configuran aspectos de guardado en caché que se aplicarán a todas las
conexiones de datos.
Para configurar el guardado en caché, seleccione una de las siguientes opciones: :
l
l
Actualizar menos frecuentemente: los datos se guardan en caché y reutilizan
cuando están disponibles, independientemente de cuándo se agregaron al caché. Esta
opción minimiza la cantidad de consultas enviadas a la base de datos. Seleccione esta
opción cuando los datos no cambian frecuentemente. La actualización menos
frecuentemente puede mejorar el rendimiento.
Equilibrado: los datos se eliminan del caché luego de una cantidad específica de
minutos. Si se han agregado los datos al caché en el rango de tiempo especificado, se
usarán los datos guardados en caché, de lo contrario, se consultarán datos nuevos de la
base de datos.
l
Actualizar más frecuentemente: se consulta la base de datos cada vez que se carga
la página. Los datos aun se guardan en caché y se reutilizarán hasta que el usuario
recargue la página. Esta opción garantizará que los usuarios vean los datos más
actualizados; sin embargo, es posible que disminuya el rendimiento.
Independientemente de cómo se configura el guardado en caché, el usuario
puede hacer clic en el botón Actualizar datos de la barra de herramientas para
enviar una consulta y recuperar datos nuevos.
SQL inicial
Para vistas que se conectar con fuentes de datos de Teradata, los creadores de libros de
trabajo pueden especificar un comando SQL que se ejecutará una vez, cuando el libro de
trabajo se carga en el navegador. A esto se le llama declaración SQL inicial. Por motivos de
rendimiento o seguridad, es posible que algunos administradores deseen deshabilitar esta
funcionalidad. La pestaña Conexiones de datos es donde se realiza esto:
Para deshabilitar la funcionalidad SQL inicial, seleccione la casilla de verificación Ignorar
declaraciones SQL iniciales para todas las fuentes de datos. Los libros de trabajo
creados con declaraciones SQL iniciales aun se abrirán, pero los comandos de SQL inicial no
se enviarán.
Alertas y suscripciones
Tableau Server puede enviarle una alerta por correo electrónico si hay una falla del sistema y
puede enviar suscripciones por correo electrónico a usuarios de Tableau Server, que son
instantáneas de sus vistas favoritas. La pestaña Alertas y suscripciones es donde
especifica el servidor SMTP que Tableau Server usa para enviar correos electrónicos.
Para alertas y suscripciones, no son compatibles las conexiones SMTP encriptadas.
Configurar alertas de correo electrónico
Cuando configura alertas, Tableau Server envía un correo electrónico a los destinatarios que
se indican bajo Enviar correo electrónico a cada vez que se detienen o reinician los
procesos del motor de datos, del repositorio o de la puerta de enlace, o cada vez que se
detiene o reinicia el Tableau Server primario. Si está ejecutando una instalación en un solo
servidor (todos los procesos en la misma máquina), las alertas de inactividad (DOWN) indican
que el servidor completo se ha detenido y las alertas de actividad (UP) que se reciben por
correo electrónico después indican que el servidor está funcionando nuevamente. Si está
ejecutando una instalación distribuida configurada para realizar conmutación tras error
(consulte Configurar la conmutación tras error y puertas de enlace múltiples), un mensaje de
alerta de inactividad (DOWN) indica que falló la instancia activa del repositorio o del motor de
datos y las alertas de actividad (UP) subsiguientes indican que la instancia en espera de ese
proceso se ha hecho cargo y ahora está activa.
Para configurar una alerta de correo electrónico:
1. Seleccione Enviar alertas de correo electrónico para problemas de estado de
servidor.
2. En Servidor SMTP, ingrese el nombre del servidor SMTP. Ingrese un Nombre de
usuario y una Contraseña para la cuenta de servidor SMTP solo si se requiere una
(algunas lo requieren, otras no). El valor de puerto SMTP predeterminado es 25. En
Enviar correo electrónico desde, escriba la dirección de correo electrónico que
enviará una alerta en caso de que haya una falla en el sistema. Aunque la dirección de
correo electrónico que ingrese debe tener una sintaxis válida (por ejemplo,
[email protected] or [email protected]), no es necesario que también sea una cuenta
de correo electrónico real en Tableau Server.
3. En Enviar correo electrónico a escriba al menos una dirección de correo electrónico
que recibirá las alertas. Si ingresa múltiples direcciones de correo electrónico, sepárelas
con comas (no con punto y coma).
4. Haga clic en Aceptar. Cuando inicia el servidor, activará una alerta de correo
electrónico y esto confirmará que estableció las alertas correctamente.
Configurar las suscripciones de correo electrónico
Para establecer un servidor SMTP para enviar suscripciones:
1. Seleccione Habilitar suscripciones de correo electrónico.
2. En Servidor SMTP, ingrese el nombre del servidor SMTP. Ingrese un Nombre de
usuario y una Contraseña para la cuenta de servidor SMTP solo si se requiere una
(algunas lo requieren, otras no). El valor de puerto SMTP predeterminado es 25. En
Enviar correo electrónico desde, escriba la dirección de correo electrónico que
enviará suscripciones a los usuarios de Tableau Server.
Aunque la dirección de correo electrónico que ingrese debe tener una sintaxis válida
(como en <text>@<text>, por ejemplo [email protected] o
[email protected]), Tableau Server no requiere que sea una cuenta de correo
electrónico real (sin embargo, algunos servidores SMTP pueden requerir que sea una
cuenta de correo electrónico real). También puede anular esta dirección Enviar correo
electrónico desde que abarca todo el sistema según el sitio para las suscripciones.
Consulte Agregar o editar sitios para obtener detalles.
3. En URL de Tableau Server, ingrese http:// o https://, seguido del nombre del
servidor de Tableau Server. Este nombre se usará para el pie de página de los correos
electrónicos de suscripción.
4. Haga clic en Aceptar.
SSL
Puede configurar Tableau Server para que use comunicaciones encriptadas por capa de
conexión segura (SSL) en todo el tráfico HTTP.La configuración de SSL garantiza que el
acceso a la aplicación Web es segura y que se pasa información confidencial entre el
navegador Web y el servidor o Tableau Desktop y el servidor está protegido. En el paso a
continuación se describen pasos sobre cómo configurar el servidor para SSL; sin embargo,
primero debe adquirir un certificado de una autoridad de confianza y luego importar los
archivos de certificado en Tableau Server.
Para Configurar Tableau Server para usar SSL:
1. Adquiera un certificado Apache SSL de una autoridad de confianza (por ejemplo,
Verisign, Thawte, Comodo, GoDaddy, etc.). También puede usar un certificado interno
emitido por su empresa. También se admiten certificados de comodín, los cuales le
permiten utilizar SSL con muchos nombres de host dentro del mismo dominio.
Algunos navegadores requerirán configuración adicional para aceptar certificados de
proveedores determinados. Consulte la documentación proporcionada por la autoridad
de certificados.
2. Coloque los archivos de certificado en una carpeta llamada SSL, paralela a la carpeta
Tableau Server 8.1. Por ejemplo:
C:\Program Files\Tableau\Tableau Server\SSL
Esta ubicación proporciona a la cuenta que ejecuta Tableau Server los permisos
necesarios para los archivos.
3. Abra la utilidad de configuración de Tableau Server al seleccionar Inicio > Todos los
programas > Tableau Server 8.1 > Configurar Tableau Server en el menú Inicio.
4. En el cuadro de diálogo Configuración de Tableau Server, seleccione la pestaña SSL.
5. Seleccione Usar SSL para comunicación de servidor y proporcione la ubicación
para cada uno de los siguientes archivos de certificado:
Archivo de certificado SSL: debe ser un certificado x509 válido codificado por PEM
con la extensión .crt
Archivo de clave de certificado SSL: debe ser una clave RSA o DSA válida que no
está protegida por contraseña con la extensión de archivo .key
Archivo de cadena de certificado SSL (opcional): algunos proveedores de
certificados emiten dos certificados para Apache. El segundo certificado es un archivo
en cadena, el cual es una concatenación de todos los certificados que conforman la
cadena de certificados para el certificado del servidor. Todos los certificados en el
archivo deben x509 codificados por PEM y el archivo debe tener una extensión .crt (no
.pem).
6. Haga clic en Aceptar. Los cambios tendrán vigencia la próxima vez que el servidor se
reinicie.
Cuando el servidor está configurado para SSL, acepta solicitudes para el puerto no SSL
(valor predeterminado es puerto 80) y automáticamente redirige al puerto 443 SSL. Los
errores SSL se registran en el directorio de instalación en la siguiente ubicación. Use
este registro para validación de solución de problemas y problemas de encriptación.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\httpd\error.log
Tableau Server solo admite el puerto 443 como puerto seguro. No se puede
ejecutar en una máquina donde cualquier otra aplicación usa el puerto 443.
SAML
Puede configurar Tableau Server para usar un proveedor de identidad externa (IdP) para
autenticar a los usuarios de Tableau Server sobre SAML. Toda la autenticación de usuarios se
realiza fuera de Tableau, sin importar si usa Active Directory o autenticación local en Tableau
Server para administrar sus cuentas de usuario en Tableau Server. Esto le permite
proporcionar una experiencia de inicio de sesión en todas las aplicaciones de su organización.
Antes de que configure Tableau Server para SAML, asegúrese de cumplir los Requisitos de
SAML.
Configuración de SAML
Para configurar Tableau Server para usar SAML:
1. Coloque los archivos de certificado en una carpeta llamada SAML, paralela a la carpeta
8.1Tableau Server. Por ejemplo:
C:\Program Files\Tableau\Tableau Server\SAML
Esta ubicación proporciona a la cuenta que ejecuta Tableau Server los permisos
necesarios para los archivos.
2. La configuración SAML se maneja en la pestaña SAML, que se muestra durante la
configuración de Tableau Server. Si está configurando SAML después de la instalación,
tenga acceso a la pestaña SAML abriendo la utilidad de configuración de Tableau
Server (Inicio > Todos los programas > Tableau Server 8.1 > Configurar
Tableau Server) y haga clic en la pestaña SAML.
3. En la pestaña SAML, seleccione Usar SAML para inicio de sesión único y
proporcione la ubicación para cada uno de los siguientes elementos:
URL de retorno de Tableau Server : la URL a la que tendrán acceso los usuarios de
Tableau Server, como http://tableau_server. No se recomienda usar http://localhost.
ID de entidad SAML: la ID de entidad identifica su instalación de Tableau Server de
forma única al IdP. Puede ingresar su URL de Tableau Server nuevamente aquí si lo
desea, pero no necesita ser su URL de Tableau Server.
Archivo de certificado de SAML: un certificado x509 codificado mediante PEM con la
extensión .crt
Archivo de clave de certificado SAML: una clave RSA o DSA que no está protegida
por contraseña con la extensión de archivo .key
4. Deje el cuadro de texto Archivo de metadatos IdP de SAML vacío por ahora y haga
clic en Exportar archivo de metadatos.
5. Se abrirá un cuadro de diálogo que le permitirá guardar la configuración SAML de
Tableau Server en un archivo XML.En este punto, los metadatos de su IdP no se
incluyen.
Guarde el archivo XML con el nombre que desee.
6. En el sitio Web de su IdP o en su aplicación:
l
l
Agregue Tableau Server como Proveedor de servicios. Deberá consultar la
documentación de su IdP para saber cómo hacerlo. Como parte de este proceso,
importará el archivo que guardó en el paso 5.
Confirme que su IdP usa Nombre de usuario como el elemento de atributo a
verificar.
7. Dentro de su IdP, exporte el archivo XML de metadatos de su IdP.
8. Copie el archivo XML de metadatos de su IdP a la siguiente carpeta en su computadora
con Tableau Server:
C:\Program Files\Tableau\Tableau Server\SAML
9. En la pestaña SAML en el cuadro de diálogo Configuración de Tableau Server, ingrese
la ubicación del archivo en el cuadro de texto Archivo de metadatos de IdP SAML:
10. Haga clic en Aceptar. Tableau Server está ahora configurado para la autenticación
SAML.
Probar su configuración
Pruebe su configuración SAML al abrir una instancia nueva del navegador Web e ingresando
el nombre de Tableau Server en la ventana URL:
Debe tener en cuenta que el aviso de inicio de sesión que aparece es de su IdP y no de
Tableau Server.
Agregar una cuenta de administrador
El paso final en la activación de Tableau Server es la adición de una cuenta de administrador.
El administrador tendrá todo el acceso al servidor incluida la capacidad de administrar
usuarios, grupos y proyectos. La adición de una cuenta de administrador difiera según el uso
de Active Directory o autenticación local.
Active Directory
Si usa Active Directory, escriba el nombre de usuario y contraseña para un usuario existente
de Active Directory que será el administrador. Luego, haga clic en Agregar usuario.
Nota:
Si la cuenta de administrador está en el mismo dominio que el servidor simplemente escriba el
nombre de usuario sin el dominio. De lo contrario, debe incluir el nombre de dominio
completamente calificado. Por ejemplo, test.lan\username.
Autenticación local
Si usa autenticación local, cree una cuenta administrativa al escribir un nombre de usuario,
nombre de visualización y una contraseña (dos veces) de su elección. Luego, haga clic en
Agregar usuario.
Reconfigurar el servidor
Realizar ajustes de configuración de Tableau Server es parte de la Configuración, pero luego
podrá abrir el cuadro de diálogo para realizar cambios. Consulte los pasos a continuación para
conocer detalles. También puede usar latabadmin herramienta de línea de comando para
hacer cambios de configuración. Independientemente de cómo realice el cambio, los nuevos
ajustes se escriben en el archivo de configuración tabsvc.yml, el cual se ubica en el directorio
de configuración.
Nota: No puede alternar entre Active Directory y autenticación local. Estas opciones solo se
pueden configurar durante la configuración.
Para cambiar un ajuste en el cuadro de diálogo Configuración de Tableau Server, haga lo
siguiente:
1. Detenga el servidor al seleccionar Todos los programas > Tableau Server 8.0 >
Detener Tableau Server en el menú Inicio de Windows.
2. Luego, seleccione Configurar Tableau Server en el menu de inicio de Windows.
3. Si utiliza una cuenta de Active Directory para la cuenta de servidor Ejecutar como
usuario, escriba la contraseña en la pestaña General.
4. Realice el cambio de configuración.
5. Haga clic en Aceptar.
6. Inicie el servidor al seleccionar Todos los programas > Tableau Server 8.0 > Iniciar
Tableau Server en el menú Inicio de Windows.
Reconfigurar procesos
Para cambiar cómo se configuran los procesos para la instalación de un solo servidor, siga los
pasos a continuación. Si va a cambiar cómo se configuran los procesos para un trabajador,
consulte Instalar y configurar los servidores de trabajador.
1. Abra la el cuadro de diálogo Configuración de Tableau Server desde el menú Inicio al
navegar a Todos los programas > Tableau Server 8.1 > Configurar Tableau
Server.
2. Ingrese su Contraseña, si fuese necesario, en la pestaña General y haga clic en la
pestaña Servidores:
3. Resalte This Machine y haga clic en Editar:
4. El cuadro de diálogo Editar Tableau Server es donde cambia el número de procesos:
5. Puede ejecutar hasta ocho instancias del VizQL, el servidor de aplicaciones, el servidor
de datos o los procesos en segundo plano, aunque este límite se puede modificar, si
fuese necesario. Consulte Acerca del límite del proceso de servidor para obtener
información. Además, para que Tableau Server funcione, siempre debe haber una
instancia activa del motor de datos y el repositorio. Para los pasos sobre cómo moverlos
a otra máquina, consulte Trasladar los procesos del motor de datos y de repositorio.
Para los pasos sobre cómo configurar las instancias en espera de ellos, consulte Alta
disponibilidad.
Después de realizar los cambios, haga clic en Aceptar, luego en Aceptar nuevamente
para salir del cuadro de diálogo Configuración.
Los procesos de Tableau Server
Hay seis procesos de Tableau Server cuya configuración predeterminada puede cambiar para
lograr resultados diferentes. Los temas Mejorar el rendimiento del servidor y Alta
disponibilidad describen algunos de los enfoques que puede tomar. El estado de alto nivel de
cada proceso se muestra en la página Mantenimiento del servidor y puede encontrar más
información detallada relacionada con algunos de los procesos, como el proceso en segundo
plano, en Vistas administrativas. En términos de arquitectura, la versión de 64 bits de Tableau
Server usa procesos nativos de 64 bits; la versión de 32 bits de Tableau Server usa procesos
de 32 bits. La excepción es el motor de datos. Si la versión de 32 bits de Tableau Server está
instalada en un sistema operativo de 64 bits, se utilizará la versión del proceso de motor de
datos de 64 bits.
Nombre de
archivo
servidor de wgserver.exe
aplicación
Proceso
segundo
plano
¿Varios Características de
hilos?
rendimiento
Manipula la
Sí
Solo consume recursos
aplicación Web,
evidentes durante
admite la
operaciones poco
navegación y la
frecuentes como
búsqueda
publicar un libro de
trabajo con un extracto o
generar una imagen
estática de una vista. Su
carga se puede crear
con la interacción
basada en el navegador
y con tabcmd.
backgrounder.exe Ejecuta tareas de No
Un proceso de un solo
servidor, incluidas
hilo donde se pueden
actualizaciones de
ejecutar múltiples
extracto, tareas
procesos en una o todas
‘Ejecutar ahora’ y
las máquinas del clúster
tareas iniciadas
para expandir la
desde tabcmd
capacidad. Por lo
general, el componente
de segundo plano no
consume mucha
memoria del proceso,
pero puede consumir
recursos de CPU, E/S o
red según la naturaleza
de la carga de trabajo
que se le presente. Por
ejemplo, al realizar
actualizaciones de
extractos grandes,
Propósito
Proceso
motor de
datos
Nombre de
archivo
¿Varios Características de
hilos?
rendimiento
puede usar el ancho de
banda de la red para
recuperar datos. La
recuperación de datos o
las tareas tabcmd
complejas pueden
consumir recursos de
CPU.
tdeserver64.exe Almacena
Sí
La carga de trabajo del
extractos de datos
motor de datos se
tdeserver.exe
y responde
genera mediante
consultas
solicitudes del proceso
de VizQL Server. Es el
componente que carga
extractos en la memoria
y realiza consultas en
ellos. El consumo de
memoria se basa
principalmente en el
tamaño de los extractos
de datos que se cargan.
El código binario de 64
bits se usa como el valor
predeterminado en
sistemas operativos de
64 bits, incluso si
Tableau Server de 32
bits se encuentra
instalado. El motor de
datos tiene varios hilos
para manipular
solicitudes múltiples en
un momento. Bajo una
carga alta puede
consumir recursos de
CPU, E/S y red, todos
los que pueden ser un
atasco de rendimiento
bajo carga. A carga alta,
una instancia simple del
motor de datos puede
consumir todos los
recursos de CPU para
Propósito
Proceso
Nombre de
archivo
servidor de dataserver.exe
datos
repositorio
postgres.exe
VizQL
Server
vizqlserver.exe
¿Varios Características de
hilos?
rendimiento
procesar las solicitudes.
Manipula
Sí
Dado que es un proxy,
conexiones en las
normalmente solo se
fuentes de datos
une por la red, pero se
de Tableau
puede unir por la CPU
Server
con sesiones de usuario
simultáneas suficientes.
Su carga se genera
mediante la interacción
basada en navegador y
en Tableau Desktop y
extrae los trabajos de
actualización para las
fuentes de datos de
Tableau Server.
La base de datos Normalmente consume
de Tableau server
pocos recursos. Se
almacena libros
puede transformar en un
de trabajo y
atasco en casos
metadatos de
excepcionales para
usuario
implementaciones muy
grandes (miles de
usuarios) mientras
realiza operaciones
como ver todos los libros
de trabajo por usuario o
cambiar los permisos.
Carga y renderiza Sí
Consume recursos
vistas, calcula y
evidentes durante la
ejecuta consultas
carga de la vista y el uso
interactivo de un
navegador Web. Se
puede unir a CPU, E/S o
la red. La carga del
proceso solo se puede
crear con la interacción
basada en el navegador.
Se puede acabar la
memoria.
Propósito
Acerca del límite del proceso de servidor
Los procesos de servidor wgserver, motor de datos, servidor de datos y VizQL server están
diseñados para tener varios hilos y varios procesos. Una sola instancia de proceso puede
ejecutar más de 16 hilos. De manera predeterminada, Tableau Server se instala con hasta dos
instancias de cada proceso de servidor.
Si está ejecutando la versión de 64 bits de Tableau Server (que está disponible desde la
versión 8.1), solo debe ejecutar hasta dos instancias de un proceso.
Si está ejecutando la versión de 32 bits de Tableau Server y la configuración
predeterminada no es suficiente, puede modificarlos a hasta ocho instancias desde la
Instalación (solo para actualizaciones) o después de la Instalación, usando el Cuadro de
diálogo de configuración. El límite superior predeterminado es de ocho instancias por proceso.
Si su máquina tiene suficiente cantidad de memoria RAM y núcleos en la CPU, puede cambiar
el límite superior usando el ajuste service.max_procs tabadmin. Para cada instancia de
proceso, Tableau recomienda que la máquina que ejecuta el proceso tenga al menos 1 GB de
RAM y 1 núcleo lógico de CPU.
Para cambiar la cantidad máxima de procesos permitidos:
1. Después de la instalación, detenga el servidor.
2. Estando en el directorio de agrupación de Tableau Server, escriba el siguiente
comando, donde number es la cantidad máxima de instancias de proceso que desea
permitir:
tabadmin set service.max_procs number
Por ejemplo:
tabadmin set service.max_procs 16
3. Inicia el servidor para que los cambios surtan efecto.
Actualizar a 8.1
Use los siguientes temas para actualizar el software Tableau Server a la versión 8.1. Si
actualiza desde una versión anterior a 8.0, consulte la Base de conocimiento de Tableau.
Lista de verificación previa a la actualización
El siguiente tema describe los elementos que debe ubicar y los pasos que debe realizar antes
de actualizar Tableau Server a la versión 8.1.x.
Credenciales, archivos de configuración y personalizaciones
Antes de actualizar, asegúrese de tener lo siguiente:
l
Credenciales de cuenta de usuario: Para cada máquina que actualiza, necesita
credenciales para una cuenta de usuario con permisos de administrador local.
l
l
l
Ejecutar como credenciales de cuenta: Confirme que tiene el nombre de usuario y
contraseña para la cuenta Ejecutar como de Tableau Server. Si usa NT
AUTHORITY\NetworkService (valor predeterminado), no se requiere contraseña.
Versión de bitsComenzando con la versión 8.1, Tableau Server se proporciona como
una aplicación nativa de 64 bits (además de una aplicación de 32 bits). Si anteriormente
estaba ejecutando la versión de 32 bits de Tableau Server en un sistema operativo de
64 bits, se recomienda que actualice a la versión de 64 bits de Tableau Server. Consulte
Antes de instalar… para conocer los requisitos mínimos para ejecutar la versión de 64
bits de Tableau Server.
Archivos de configuración: Además de tener el archivo .exe para la actualización
que va a realizar, debe ubicar o volver a descargar el archivo .exe de configuración para
la versión de servidor que actualmente tiene en producción (consulte Descarga de
productos Tableau). Si ocurre algo inesperado durante la actualización, esto puede
ayudarle a recuperar más rápidamente.
Aunque Tableau conserva los ajustes de configuración durante una actualización, es mejor
anotar las personalizaciones que haya realizado para poder verificarlas posteriormente. Estas
incluyen configuración SSL, cambio de puerto predeterminado de Tableau y valores de tiempo
de espera, así como también, el uso de logotipos personalizados. Además, si agregó su
versión actual de Tableau Server a la variable de entorno PATH de Windows, deberá
actualizar la entrada después de actualizar, de modo que se refiera a la versión más nueva de
Tableau Server.
Verifique el estado de mantenimiento del producto
Si intenta actualizar Tableau Server desde un servidor cuyo mantenimiento ha expiado el
resultado será una instancia sin licencia de Tableau Server.
Para ver si ha expirado el mantenimiento del servidor:
l
Seleccione Inicio > Todos los programas > Tableau Server > Administrar claves
de productos y vea bajo la columna Expiración de mantenimiento.
Si el mantenimiento ha expirado, comuníquese con Soporte al cliente de Tableau. La
reactivación de la clave del producto será parte de la configuración. Consulte Activar Tableau
para conocer detalles. Si el servidor no tiene acceso a Internet, consulte Activar Tableau fuera
de línea.
Cree un respaldo de “limpieza”
Además de los respaldos de Tableau Server regulares, una práctica recomendada es crear un
respaldo justo antes de la actualización. Antes de crear el respaldo, ejecute el comando de
limpieza tabadmin para eliminar archivos no esenciales del respaldo. Consulte Ejecución de
limpieza y Respaldar los datos de Tableau para conocer los pasos.
Instalaciones distribuidas solamente: ¿Eliminar los trabajadores antes de crear el respaldo?
Además de los datos, el archivo de respaldo de Tableau (.tsbak) incluye información sobre la
configuración. Por lo tanto, el respaldo de una instalación distribuida de Tableau Server
incluye información de configuración sobre los trabajadores, inclusive sus direcciones IP.Si no
quiere que esta información forme parte del respaldo (por ejemplo, porque migra a los
trabajadores a un hardware nuevo como parte de su actualización), tiene dos opciones: puede
eliminar los trabajadores de la configuración de Tableau Server antes de crear el respaldo o
puede usar la opción --no-config al restaurar el archivo de respaldo en la instalación
nueva. Observe que con la segunda opción no se restaura ninguna información de
configuración; tampoco la del Tableau Server primario.
Si está ejecutando una instalación distribuida de Tableau Server y tiene un trabajador que
ejecuta Windows XP, debe eliminarlo de la configuración antes de actualizar. Windows XP no
es una plataforma compatible en la versión 8.1.
Para eliminar un trabajador de la configuración de Tableau Server:
1. Detenga el servidor en Tableau Server primario.
2. En el servidor primario, abra la utilidad de configuración seleccionando Tableau Server
<versión> > Configurar Tableau Server en el menú Inicio.
3. En el cuadro de diálogo Configuración, seleccione la pestaña Servidores.
4. Si el trabajador aloja extractos y/o el repositorio, traslade estos servicios a otra máquina.
Consulte Trasladar los procesos del motor de datos y de repositorio para conocer
pasos.
5. A continuación, resalte al trabajador y haga clic en Eliminar.
6. Haga clic en Aceptar.
7. Inicie el servidor.
Ejecución de limpieza
La ejecución del comando de limpieza tabadmin elimina los archivos desde el sistema Tableau
Server que no necesita en el archivo de respaldo. Debe ejecutar una limpieza una vez con el
servidor en ejecución, lo cual le permite actuar en la base de datos de Tableau, y una vez con
el servidor detenido, lo cual le permite eliminar los archivos de registro.
Para ejecutar tabadmin cleanup:
1. Abra una línea de comando como administrador:
2. Navegue al directorio de la agrupación de Tableau Server. Por ejemplo:
cd “C:\Program Files (x86)\Tableau\Tableau Server\8.0\bin”
3. Confirme que el servidor está en ejecución:
tabadmin status
4. Ejecute la limpieza al escribir lo siguiente:
tabadmin cleanup
5. Detenga el servidor:
tabadmin stop
6. Ejecute la limpieza nuevamente:
tabadmin cleanup
Mantenga el servidor detenido para la creación de un respaldo (a continuación).
Cree el archivo de respaldo
El comando tabadmin respaldo crea un archivo .tsbak que contiene datos del repositorio,
extractos de datos y configuración de servidor. Después de crear el archivo, almacénelo en
una computadora separada. Consulte Respaldar los datos de Tableau para conocer pasos.
Instalaciones distribuidas solamente: Si antes de crear el respaldo eliminó algunos
trabajadores de la configuración del servidor y está actualizando de la versión 8.1.x a la
8.1.x, ahora puede volver a agregar los trabajadores a la configuración. Al actualizar el
Tableau Server primario se activarán las actualizaciones para los trabajadores. De lo
contrario, si está actualizando de la versión 8.0 a la 8.1.x, deje a los trabajadores fuera
de la configuración. Consulte Actualizar a 8.1 para conocer detalles.
Actualizar a 8.1
Luego de finalizar Lista de verificación previa a la actualización, actualice Tableau Server a la
versión 8.1 mediante el procedimiento a continuación. Si migra a un nuevo hardware como
parte de la actualización, consulte Migrar a hardware nuevo en su lugar. Si está actualizando
desde una versión de 32 bits de Tableau Server a la versión de 64 bits, no necesita realizar
pasos especiales. Puede seguir el procedimiento a continuación.
1. Use Agregar/Eliminar programas en Tableau Server (o Tableau Server primario, si
tiene una instalación distribuida), para desinstalar la versión anterior.
La desinstalación elimina el software del servidor, pero déjelos datos y ajustes de
configuración intactos.
2. Instalar Tableau Server. Si tiene una instalación distribuida, este paso se encuentra
Tableau Server primario.
La configuración de Tableau Server manipulará la importación de datos y los ajustes de
configuración de la versión anterior.
Trasladar los procesos del motor de datos y de repositorio
Si necesita eliminar un trabajador de la configuración de Tableau Server y ese trabajador
alberga la única instancia del repositorio o el motor de datos (que alberga extractos), primero
debe trasladar el proceso a otra máquina. Eso se debe a que siempre debe haber una
instancia activa de los procesos de repositorio y de motor de datos.
Para trasladar los procesos del motor de datos o del repositorio:
1. Si no lo ha hecho aún, detenga el servidor Tableau primario y abra el cuadro de diálogo
Configuración de Tableau Server (Inicio > Tableau Server 8.1 > Configurar
Tableau Server) en el Tableau Server primario.
2. En la pestaña Servidores, resalte la dirección IP o el nombre de la computadora a la
que desea trasladar el proceso. Puede ser otra computadora de trabajador o la primaria
(This Computer (Primary)).
3. Haga clic en Editar.
4. En el cuadro de diálogo Editar Tableau Server, seleccione la casilla de verificación del
proceso que desea trasladar: puede ser Motor de datos, Repositorio o ambos, y
haga clic en Aceptar.
5. En el cuadro de diálogo Configuración de Tableau Server, haga clic en Aceptar.
6. Inicie el servidor Tableau primario para que los cambios surtan efecto.
7. Detenga el servidor y abra el cuadro de diálogo Configuración de Tableau Server.
8. En la pestaña Servidores, resalte la dirección IP o el nombre de la computadora del
trabajador de la cual está retirando el proceso y haga clic en Editar.
9. Desactive la casilla de verificación del proceso que trasladó y haga clic en Aceptar.
10. Vuelva a hacer clic en Aceptar e inicie el servidor primario para que los cambios surtan
efecto.
Si realiza este procedimiento como parte de la eliminación de un trabajador de la configuración
de Tableau Server (tal como se describe en Lista de verificación previa a la actualización),
vuelva a detener el servidor antes de continuar.
Acerca del límite del proceso de servidor
Los procesos de servidor wgserver, motor de datos, servidor de datos y VizQL server están
diseñados para tener varios hilos y varios procesos. Una sola instancia de proceso puede
ejecutar más de 16 hilos. De manera predeterminada, Tableau Server se instala con hasta dos
instancias de cada proceso de servidor.
Si está ejecutando la versión de 64 bits de Tableau Server (que está disponible desde la
versión 8.1), solo debe ejecutar hasta dos instancias de un proceso.
Si está ejecutando la versión de 32 bits de Tableau Server y la configuración
predeterminada no es suficiente, puede modificarlos a hasta ocho instancias desde la
Instalación (solo para actualizaciones) o después de la Instalación, usando el Cuadro de
diálogo de configuración. El límite superior predeterminado es de ocho instancias por proceso.
Si su máquina tiene suficiente cantidad de memoria RAM y núcleos en la CPU, puede cambiar
el límite superior usando el ajuste service.max_procs tabadmin. Para cada instancia de
proceso, Tableau recomienda que la máquina que ejecuta el proceso tenga al menos 1 GB de
RAM y 1 núcleo lógico de CPU.
Para cambiar la cantidad máxima de procesos permitidos:
1. Después de la instalación, detenga el servidor.
2. Estando en el directorio de agrupación de Tableau Server, escriba el siguiente
comando, donde number es la cantidad máxima de instancias de proceso que desea
permitir:
tabadmin set service.max_procs number
Por ejemplo:
tabadmin set service.max_procs 16
3. Inicia el servidor para que los cambios surtan efecto.
Migrar a hardware nuevo
Use el siguiente procedimiento para migrar Tableau Server de una computadora a otra:
Específicamente, estos pasos describen cómo mover los datos y ajustes de configuración de
Tableau Server desde la computadora en producción a una nueva computadora donde se
instala Tableau Server versión 8.1 . Antes de iniciar, asegúrese de que ha realizado los
siguientes pasos en Lista de verificación previa a la actualización, incluida la creación de un
archivo .tsbak.
1. Instale Tableau Server en la computadora nueva.
2. Copie el archivo .tsbak a la carpeta de agrupación en Tableau Server nuevo (por
ejemplo, C:\Program Files\Tableau\Tableau Server\8.1\bin).
3. A continuación, detenga Tableau Server.
4. Restaure los datos en producción e información de configuración a su nueva instalación
de Tableau Server al escribir tabadmin restore <filename>, donde
<filename> es el nombre del archivo .tsbak. Por ejemplo:
tabadmin restore mybackup.tsbak
O bien, para restaurar solo los datos de Tableau Server en producción y no la
información de configuración, escriba lo siguiente:
tabadmin restore --no-config mybackup.tsbak
5. Inicie el servidor.
6. Instalaciones distribuidas solamente: Ejecute el instalador de Tableau Worker en
todas las computadoras adicionales que desee agregar al conjunto de Tableau Server.
Consulte Instalar y configurar los servidores de trabajador para conocer los pasos a
seguir.
7. Después de probar la nueva instalación, debe desactivar la versión anterior de Tableau
Server antes de desinstalarla. Para desactivar la versión anterior:
- Seleccione Inicio > Todos los programas > Tableau Server > Administrar
claves de productos.
- Para la clave de cada producto y haga clic en Desactivar.
Si no tiene conexión a Internet, se le solicitará que cree un archivo de devolución
sin conexión para completar el proceso de desactivación. Consulte Activar
Tableau fuera de línea para conocer los pasos a seguir.
Entornos distribuidos
Utilice los temas a continuación para obtener más información sobre la ejecución de una
instalación distribuida de Tableau Server:
Instalar y configurar los servidores de trabajador
Después de completar la configuración inicial, puede configurar Tableau Server para
ejecutarse en computadoras múltiples. A esto se le llama instalación distribuida. La ejecución
de una instalación distribuida usa puertos adicionales en el Tableau Server primario y requiere
que determinados puertos estén disponibles para vinculación durante la instalación en el
Tableau Worker Server Server. Consulte Puertos TCP/IP para obtener información.
Aquí hay algunas cosas a tener en mente:
l
l
l
Tableau Server y Tableau Worker Server están disponibles en versiones de 32 y 64 bits.
Todas las computadoras en una instalación distribuida deben ejecutar la misma versión
de bits del software Tableau Server. En otras palabras, los servidores de trabajadores y
el primario deben ejecutar todos la versión de 32 bits de Tableau Server o todos la
versión de 64 bits de Tableau Server.
Todas las computadoras en un entorno distribuido deben ser miembros del mismo
dominio. La cuenta Ejecutar como usuario del servidor, que se especifica en el Tableau
Server principal, debe ser una cuenta de dominio del mismo dominio.
Todas las computadoras en un entorno distribuido deben tener direcciones IP estáticas.
Para instalar y configurar un Tableau Worker Server:
1. Asegúrese de que ha instalado Tableau Server en la computadora primaria.
2. Detenga el servidor en la computadora primaria (consulte Tableau Server Monitor para
aprender cómo).
3. Descargue el software Tableau Server Worker del Centro de cuentas de clientes de
Tableau.
4. Ejecute el instalador del software Tableau Server Worker en todas las máquinas
adicionales que desea agregar al conjunto de Tableau Server. Durante la instalación se
le solicitará proporcionar la dirección IPv4 o nombre de computadora del servidor
primario.
Si es un trabajador que ejecuta Windows 7 con el firewall de Windows activado,
consulte la Base de conocimiento de Tableau antes de proceder.
5. Una vez que el software del trabajadore esté instalado en las computadoras de
trabajadores, y con el servidor Tableau Server primario aun detenido, regrese al
servidor primario y abra la utilidad de configuración seleccionando Tableau Server 8.1
> Configurar Tableau Server en el Menú de inicio.
6. En la utilidad de configuración, escriba la contraseña en la pestaña General, seleccione
la pestaña Servidores y haga clic en Agregar.
7. En el siguiente cuadro de diálogo, escriba la dirección IPv4 o el nombre de computadora
para una de las computadoras de trabajadores y especifique el número de procesos
VizQL, de servidor de aplicaciones, de servidor de datos, de fondo y de motor
de datos a asignar a la computadora. Puede asignar hasta ocho instancias de un
proceso a un servidor de trabajador (o primario).
De forma predeterminada, el motor de datos, el repositorio y la puerta de enlace están
hospedadas en el servidor primario. Ejecutar esos procesos en un servidor adicional o
trasladarlas desde el servidor primario es parte de la configuración para la alta
disponibilidad. Consulte Alta disponibilidad para obtener más información.
8. Haga clic en Aceptar. Es posible que el proceso de actualización tarde varios minutos.
9. Repita estos pasos para cada computadora que desee agregar al entorno distribuido.
Cuando haya terminado de agregar trabajadores, haga clic en Aceptar nuevamente
para guardar los cambios, luego inicie el Tableau Server primario.
Controladores de bases de datos
Los instaladores para Tableau Server y Tableau Server Workers instalan automáticamente
controladores para bases de datos Oracle y Oracle Essbase. Si planea publicar libros de
trabajo y fuentes de datos que se conecten a otras bases de datos, deberá asegurarse de que
su servidor primario y de trabajadores tengan los controladores correspondientes.
Los trabajadores que ejecutan VizQL, servidor de aplicaciones, servidor de datos o procesos
en segundo plano requieren estos controladores de bases de datos. Por ejemplo, si tiene un
trabajador dedicado como un VizQL Server y otra computadora dedicada a extraer
almacenamiento, solo necesita instalar controladores en la computadora que ejecuta el VizQL
Server.
¿Requiere
controlador de
base de datos?
sí
sí
sí
sí
no
Proceso de servidor
VizQL
Servidor de aplicación
Data Server
Fondo
Motor de datos
(almacenamiento de extracción)
Repositorio
no
Puerta de enlace
no
Mantener un entorno distribuido
Después de la configuración de un servidor primario o uno o más servidores de trabajador
para una instalación distribuida, puede realizar toda la configuración y actualizaciones
posteriores desde el servidor primario, mediante las herramientas de línea de comando y la
utilidad de configuración en el servidor primario. Las actualizaciones se ejecutarán
automáticamente en los trabajadores.
Cuando instaló servidores de trabajadores, especificó la dirección IPv4 del servidor primario o
un nombre de computadora. Si esa dirección IP o nombre de computadora cambia, deberá
reinstalar los servidores de trabajadores.
Puede supervisar el estado del conjunto Tableau Server en la página Mantenimiento del
servidor. Consulte Mantenimiento de servidor para obtener más información sobre
mantenimiento del servidor.
Alta disponibilidad
Utilice los enlaces a continuación para obtener más información sobre el soporte de alta
disponibilidad de Tableau Server:
Comprender la alta disponibilidad
Si va configurar un sistema para alta disponibilidad, todos los pasos que realice se tratarán de
integrar redundancia, lo que reduce la posibilidad de tiempo inactivo. Las cuatro áreas que
requieren redundancia son el motor de datos, el repositorio, los procesos de puerta de enlace
y el Tableau Server principal, que ejecuta el componente de licencia del servidor. Ya que
siempre debe haber una instancia activa del motor de datos y los procesos de repositorio,
configurar el conjunto es un procedimiento de múltiples fases que requiere que el Tableau
Server principal se detenga y se reinicie en ciertos puntos para que la configuración tenga
efecto. Para conocer los pasos exactos, consulte Configurar la conmutación tras error y
puertas de enlace múltiples y Configurar un servidor primario de respaldo. Consulte además
Requisitos de alta disponibilidad.
Los temas a continuación resumen cómo una topología del sistema de servidor evoluciona
mientras lo configura para obtener una alta disponibilidad. La configuración mínima
recomendada para una alta disponibilidad es un sistema de tres nodos. Esto incluye un
servidor primario para ejecutar las licencias y dos trabajadores para hospedar los procesos
principales. Puede aumentar la confiabilidad del sistema agregando una cuarta computadora
para que funcione como un servidor primario de respaldo. Si ejecuta un proceso de puerta de
enlace en todos los nodos, también tiene sentido usar un equilibrador de cargas para las
puertas de enlace.
Un solo sistema de servidor
Después de instalar el Tableau Server primario, estará ejecutando al menos una instancia de
todos los procesos de servidor. Esta es la configuración más básica de Tableau Server. No
tiene redundancia.
Así es como se ve generalmente la tabla Estado de la página Mantenimiento de un sistema de
un solo servidor:
Para integrar redundancia , necesita agregar servidores adicionales para alojar el motor de
datos activo y en espera y los procesos del repositorio. IAdemás, para reducir la vulnerabilidad
del sistema, se pueden ejecutar múltiples puertas de enlace, y el servidor primario debe
aislarse en su propio nodo, idealmente ejecutando la menor cantidad posible de procesos de
servidor. Para lograr esto se necesitan al menos tres computadoras (consulte Sistema de tres
nodos); sin embargo, puede lograr alguna redundancia con dos computadoras.
Un sistema de dos nodos
Si tiene restricciones de hardware y no tiene acceso a un conjunto de tres nodos, puede
obtener algo de redundancia usando dos computadoras y un host externo a su conjunto
Tableau Server.
En el sistema anterior, el servidor primario de Tableau Server y el servidor de trabajadores
ejecutan las instancias activas y en espera del motor de datos y el repositorio, al igual que las
puertas de enlace. Una tercera computadora, externa al conjunto Tableau Server, se usa
como un tercer punto de contacto para las dos puertas de enlace. Esta es la razón:Cuando un
Tableau Server que ejecuta el motor de datos o el repositorio pierde conectividad con los otros
nodos, comprueba con un proceso de puerta de enlace externo a si mismo (pero aún dentro
del conjunto de Tableau Server) para determinar cuál nodo falló y si se debe activar algún
proceso de espera. En un conjunto de dos nodos, si se pierde la conectividad, no es posible
alcanzar ese otro proceso de puerta de enlace de Tableau. En estos casos, se puede usar un
sitio Web o una computadora fuera del conjunto Tableau Server. Consulte Confirmar
conmutación tras error de forma externa para saber cómo configurar esta función.
Así se ve la tabla Estado para la siguiente configuración. Ya que la tercera computadora no es
un Tableau Server, no se menciona en la tabla.
Sistema de tres nodos
Mientras que el sistema de dos nodos descrito anteriormente brinda algo de soporte de
conmutación tras errores para el motor de datos y los procesos de repositorio, un sistema de
tres nodos le ayudaría a reducir la vulnerabilidad del servidor primario:
La tabla Estado en la página Mantenimiento tendrá una apariencia similar a la siguiente:
En un conjunto de tres nodos, los procesos de motor de datos y repositorio se trasladan desde
el servidor primario a un trabajador, y el primario solo ejecuta el proceso de puerta de enlace.
Ya que las funciones de búsqueda y licencia son integrales para el servidor primario y no se
pueden eliminar, no se muestran en la tabla Estado. En esta configuración, si su trabajador
activo falla, el trabajador en espera se vuelve activo automáticamente. La descripción exacta
sobre cómo crear este conjunto de tres nodos, incluido cómo agregar los trabajadores y quitar
los procesos del primario se encuentra en Configurar la conmutación tras error y puertas de
enlace múltiples.
Todavía quedan dos cosas que puede hacer para mejorar este conjunto de tres nodos:1)
agregar un equilibrador de carga para interactuar con las tres puertas de enlace activas, y 2)
crear un respaldo para abordar el punto de falla único: el servidor primario. Consulte los temas
a continuación para conocer detalles.
Agregar un equilibrador de carga
En este punto, lo tres nodos tienen puertas de enlace, que se usan para enrutar solicitudes a
procesos de servidor disponibles. A diferencia del proceso de repositorio, no hay puertas de
enlace activas y en espera. Todas las puertas de enlace están activas. Para reducir más el
potencial de su conjunto de tener tiempos de inactividad, debe configurar un equilibrador de
carga.
Agregar un servidor primario de respaldo
Agregar un servidor primario de respaldo ofrece protección para su sistema. El servidor
primario de respaldo es un servidor adicional agregado al sistema para que esté preparado
por si falla el primario. Aun cuando no es un servidor activo, después de completar el primer
conjunto de pasos de Configurar un servidor primario de respaldo, estará lista para activarse.
A continuación se presenta la apariencia del sistema con un servidor primario de respaldo:
La tabla Estado de la configuración anterior tiene la misma apariencia que la del sistema de
tres nodos. Si el servidor primario falla y usted realiza los pasos para que el servidor primario
de respaldo asuma el control, su sistema volverá a estar en línea usando el servidor primario
nuevo:
Requisitos de alta disponibilidad
Antes de empezar a configurar un conjunto para la conmutación tras error y la alta
disponibilidad, asegúrese de cumplir los siguientes requisitos.
Hardware
Salvo la puerta de enlace, los sistemas que use para la conmutación tras error y la alta
disponibilidad deben cumplir los requisitos que se describen en Antes de instalar… aunque no
necesitan ser idénticos:
l
l
l
l
Conmutación tras error: dos o tres computadoras: Para configurar un conjunto
que proporcione soporte de conmutación tras error para los procesos de motor de datos
y repositorio, necesita al menos dos computadoras o MV: una para el Tableau Server
principal y una para un trabajador Tableau. En esta configuración, también se puede
necesitar un sitio Web o una computadora que no esté ejecutando Tableau (obtenga
más información). La configuración recomendada de conmutación tras error requiere
tres computadoras o MV: una para el Tableau Server principal y dos para los
trabajadores.
Soporte para conmutación tras error y puertas de enlace múltiple: tres
computadoras y un equilibrador de carga: Para configurar un conjunto que
proporcione lo anterior más soporte para puertas de enlace múltiples, necesita tres
computadoras o VM, y un equilibrador de carga para apoyar al conjunto.
Alta disponibilidad: cuatro computadoras y un equilibrador de carga: Para
configurar a fin de obtener una alta disponibilidad, necesita los recursos descritos
anteriormente además de una computadora adicional para que funcione como servidor
primario de respaldo para su Tableau Server principal.
Computadoras principales: Si configura para obtener una alta disponibilidad, el
Tableau Server principal y el primario de respaldo pueden ejecutar pocos procesos de
Tableau Server, o ninguno. Por lo tanto, las computadoras que ejecuten el servidor
primario y el primario de respaldo no necesitan tantos núcleos como las que ejecutan
sus servidores trabajadores. Sin embargo deberá contar con espacio suficiente en disco
para los respaldos. El servidor primario se usa temporalmente durante el respaldo de la
base de datos y el proceso de restauración.
Software
Los productos de software de Tableau están disponibles en versiones de 32 y 64 bits. Si está
ejecutando un conjunto de Tableau Server, cada computadora debe usar la misma versión:
todas de 64 bits o todas de 32 bits. Por ejemplo, el Tableau Server principal ejecuta la versión
de 64 bits de Tableau Server, los trabajadores en el conjunto deben ejecutar la versión de 64
bits de Tableau Server Worker. No pueden ejecutar la versión de 32 bits de Tableau Server
Worker.
Usar la misma versión no es un problema entre Tableau Desktop y Tableau Server. Puede
publicar un libro de trabajo a un Tableau Server de 64 bits desde una versión de 32 bits de
Tableau Desktop, y vice versa.
Red y puertos
Como ocurre con cualquier sistema distribuido, las computadoras o VM que use necesitan
poder comunicarse entre sí. Consulte Puertos TCP/IP para conocer una lista de puertos que
deben estar disponibles en las puertas de enlace y los trabajadores.
Procedimientos recomendados
A continuación se presentan algunos puntos que se deben tener en cuenta antes de comenzar
a instalar y configurar:
l
l
l
l
Direcciones IP o nombres de computadoras: Anote las direcciones IPv4 o los
nombres de computadora de cada computadora o VM con la que trabaje. Necesitará
proporcionarlas durante la instalación y la configuración de Tableau Worker. Cada
computadora en el conjunto debe usar una dirección IP estática, incluso si usa el
nombre de la computadora para identificarla durante la configuración.
Registro CNAME: Si está configurando a fin de obtener una alta disponibilidad y no
está usando un equilibrador de carga, asegúrese de que su Tableau Server principal y
el primario de respaldo tengan el mismo registro CNAME para que sus usuarios de
Tableau Server tengan una buena experiencia si un principal falla y configura el otro
para que tome el control. Si usa un equilibrador de carga, es el nombre de este el que
usarán los usuarios como la URL de Tableau Server, sin importar la puerta de enlace
que realmente esté manejando la solicitud.
Credenciales de cuenta de usuario: Para cada computadora, necesita credenciales
para una cuenta de usuario con permisos de administrador local. Si está configurando a
fin de obtener una alta disponibilidad, la Cuenta Ejecutar como que usa para su Tableau
Server principal debe ser la misma que la que usa para su Tableau Server primario de
respaldo.
Respaldo: Es una práctica recomendada crear un respaldo antes de realizar cambios
importantes en el sistema. Consulte Respaldar los datos de Tableau para conocer
pasos.
Configurar la conmutación tras error y puertas de enlace múltiples
Realice los siguientes pasos para configurar un grupo de tres computadoras que proporciona
soporte para puertas de enlace múltiples y conmutación tras error:Tenga en cuenta que
ejecutar puertas de enlace múltiples solo es sensato si planea usar también un equilibrador de
carga.
1. Instale Tableau Server en su computadora primaria.
2. Después de finalizada la instalación, revise la tabla Estado en la página Mantenimiento.
Todos los procesos deben tener un estado en color verde que diga “esperando
solicitud”:
3. Detenga el servidor en el primario.
4. A continuación, ejecute Instalación de Tableau Worker en las dos computadoras o VM
adicionales que proporcionarán conmutación tras errores y soporte para puertas de
enlace adicionales. Durante la instalación de Worker, deberá proporcionar la dirección
IPv4 o el nombre de la computadora del Tableau Server principal.
Se debe asignar una dirección IP estática al servidor primario, incluso si está
usando su nombre para identificarlo.
5. Con el servidor primario todavía detenido, habrá su cuadro de diálogo Configuración:
Inicio > Todos los programas > Tableau Server > Configurar Tableau Server. En
la pestaña General, escriba la contraseña de cuenta Ejecución como.
6. En la pestaña Servidores, haga clic en Agregar para agregar un trabajador.
7. Ingrese la dirección IPv4 o nombre de la computadora del trabajador, ingrese 1 para
Motor de datos y seleccione la casilla de verificación Repositorio. Seleccione la
casilla de verificación Puerta de enlace si planea usar también un equilibrador de
carga.
Si desea que el trabajador ejecute otros procesos de servidor, escriba el número de
instancias que desea ejecutar, como por ejemplo 1 o 2.
8. Haga clic en Aceptar para cerrar el cuadro de diálogo de Tableau Server y haga clic en
Agregar nuevamente en la pestaña Servidores para agregar otro trabajador.
9. Ingrese la dirección IPv4 o el nombre de la computadora del segundo trabajador,
ingrese al menos 1 para cada proceso excepto Motor de datos (configúrelo en 0).
Deseleccione la casilla de verificación Repositorio y seleccione Puerta de enlace.
No es necesario especificar el trabajador que está activo y cuál está en espera para el
motor de datos y el repositorio.
10. Inicie el servidor en el primario para que sus cambios tengan efecto (puede demorar
unos minutos) y luego detenga el servidor en el primario.
11. Abra el cuadro de diálogo de configuración nuevamente y, en la pestaña Servidores,
resalte Esta computadora (principal), y haga clic en Editar.
12. En el cuadro de diálogo Edición de Tableau Server, defina Motor de datos en 0 y
desmarque la casilla de verificación Repositorio. Mantenga Puerta de enlace
seleccionado. Si desea que el Tableau Server primario ejecute solamente Apache (y
por lo tanto, ningún proceso de Tableau Server), puede eliminar los procesos restantes
al escribir 0 en cada cuadro de texto:
Haga clic en Aceptar.
13. En la pestaña Servidor, seleccione el segundo trabajador y haga clic en Editar.
14. Configure Motor de datos en 1 y seleccione la casilla de verificación Repositorio.
Haga clic en Aceptar. La pestaña Servidores ahora debe parecerse a lo siguiente:
15. También puede configurar alertas de correo electrónico de modo que se le notifiquen las
fallas del servidor o los cambios en el estado de los procesos del motor de datos y del
repositorio. Para hacer esto, haga clic en la pestaña Alertas y suscripciones en el cuadro
de diálogo Configuración y siga los pasos en Configurar alertas de correo electrónico.
16. Haga clic en Aceptar para cerrar el cuadro de diálogo Configuración.
17. Inicie el servidor en el primario (puede tardar algunos minutos para que los cambios
surtan efecto). Su sistema está configurado para proporcionar soporte de conmutación
tras error para los procesos del repositorio y el motor de datos. También se configura
para puertas de enlace múltiples. Ahora puede usar un equilibrador de carga para
asegurar la disponibilidad de conjunto en el caso de un fallo de puerta de enlace, y para
distribuir la carga de trabajo del conjunto.
La tabla Estado en la página Mantenimiento debe tener una apariencia similar a la
siguiente:
Una marca de verificación verde claro significa que hay un proceso en espera, listo para
tomar el control si falla el proceso activo (marca de verificación verde oscuro).
Confirmar conmutación tras error de forma externa
Una vez que agregue un segundo servidor a su configuración de Tableau Server que ejecuta
el motor de datos o repositorio podrá usar la casilla de verificación Usar hosts externos para
confirmar conmutación tras errores en la pestaña Servidores. La opción le permite listar
una o más computadoras o sitios Web externos a su conjunto de Tableau Server que se usará
para confirmar el estado de conectividad del conjunto en el caso de una conmutación tras
error.
Usar un host o sitio Web externo para confirmar la conmutación tras error es muy útil en un
sistema Tableau Server de dos nodos como el siguiente:
En el sistema anterior, el servidor primario de Tableau Server y el servidor de trabajadores
ejecutan las instancias activas y en espera del motor de datos y el repositorio, al igual que las
puertas de enlace. La tercera computadora, externa al conjunto de Tableau Server, se usa
como una tercera opción de contacto para las dos puertas de enlace. Esta es la razón:Cuando
un Tableau Server que ejecuta el motor de datos o el repositorio pierde conectividad con los
otros nodos, comprueba si hay un proceso de puerta de enlace externo a si mismo (pero aún
dentro del conjunto de Tableau Server) para determinar qué nodo falló y si deben activarse
procesos de espera. En un conjunto de dos nodos, si se pierde la conectividad, no es posible
alcanzar ese otro proceso de puerta de enlace de Tableau. En esos casos, se puede usar una
computadora que no esté ejecutando Tableau para realizar una conexión TCP simple. Si el
servidor de trabajadores en el diagrama anterior pierde conectividad con el primario pero se
puede conectar al host externo, esto gatillaría la ejecución de las instancias activas del motor
de datos y el repositorio.
Agregar un equilibrador de carga
Puede mejorar la confiabilidad de un conjunto Tableau Server al ejecutar múltiples puertas de
enlace y configurar un equilibrador de carga para distribuir solicitudes entre las puertas de
enlace. A diferencia del proceso de repositorio,que puede estar activo o en espera, todos los
procesos de puerta de enlace están activos. Si una puerta de enlace en un conjunto no está
disponible, el equilibrador de carga deja de enviarle solicitudes. El algoritmo equilibrador de
carga que elige determina cómo enrutarán las solicitudes de los clientes las puertas de enlace.
Cuando un equilibrador de carga encabeza un conjunto Tableau Server, la URL que usan los
usuarios de Tableau Server le pertenece al equilibrador de carga, no al Tableau Server
principal.
Configurar un servidor primario de respaldo
Antes de seguir los procedimientos de este tema, siga los pasos que se mencionan en
Configurar la conmutación tras error y puertas de enlace múltiples. Después de realizar los
pasos mencionados, tendrá dos servidores trabajadores que proporcionan soporte de
conmutación tras error. Cada servidor también ejecuta una puerta de enlace, para la cual se
puede configurar un equilibrador de carga. El Tableau Server principal ejecuta un proceso de
puerta de enlace y creación de licencias, que no está expuesto ni es asignable como proceso.
Ahora que tiene redundancia para el motor de datos, el repositorio y la puerta de enlace, debe
reconstruir la redundancia para su Tableau Server principal. Debe hacerlo creando un
respaldo de él.
El primer procedimiento a continuación describe cómo crear un respaldo de su servidor
primario. El segundo procedimiento lo lleva por lo que debe hacer en caso de que se produzca
un error en su servidor primario actual.
Crear un servidor primario de respaldo
Realice lo siguiente para crear un servidor primario de respaldo:
1. Detenga el servidor en su Tableau Server principal.
2. En el servidor primario, abra una línea de comando como administrador y navegue al
directorio de la agrupación de Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\bin
3. Escriba el siguiente comando, donde <primary1> es la dirección IPv4 del servidor
primario actual o el nombre de la computadora y <primary2> es la dirección IPv4 del
servidor primario de respaldo o el nombre de su computadora:
tabadmin failoverprimary --primary <primary1> --secondary
<primary2>
4. Luego, cree una copia del archivo tabsvc,yml del servidor primario (ubicado en
ProgramData\Tableau\Tableau Server\config) y ponga la copia en una ubicación
temporal en su computadora primaria de respaldo.
El archivo tabsvc.yml contiene ajustes de la configuración del servidor. Se escribe el
cambiar los ajustes de configuración en el cuadro de diálogo Configuración de Tableau
Server o mediante tabadmin. Si tabsvc.yml cambia, deberá actualizar la copia de
tabsvc.yml en su servidor primario de respaldo.
5. En su servidor primario de respaldo, abra el archivo tabsvc.yml y reemplace la dirección
IP o nombre de la computadora para el servidor primario en la línea worker.hosts
con la dirección de IP o el nombre de la computadora para el servidor primario de
respaldo (la computadora en la que se encuentra actualmente):
6. En su servidor de respaldo principal, instale Tableau Server. Use la misma Cuenta
Ejecutar como y los valores de configuración que usó al ejecutar la instalación de
Tableau Server en su servidor primario.
7. Después de que termine la instalación, detenga el servidor en el servidor primario de
respaldo.
8. Todavía en el servidor primario de respaldo, escriba el siguiente comando para
deshabilitar su servicio de Tableau Server:
sc config tabsvc start= disabled
Ha terminado de crear un servidor primario de respaldo. Consulte los siguientes pasos
para saber qué hacer si su servidor primario de respaldo falla. Si trabaja en un entorno
de pruebas, este sería un buen momento para probar su configuración apagando su
servidor primario para simular una falla de sistema.
Configuración del servidor primario de respaldo
Siga este segundo grupo de pasos en el caso de un fallo de servidor primario. Se deben
realizar todos los pasos en la computadora primaria de respaldo.
1. En su servidor primario de respaldo, use el archivo tabsvc.yml que editó en el paso 5 del
procedimiento anterior para sobrescribir el que se encuentra instalado localmente en
ProgramData\Tableau\Tableau Server\config.
2. Abra una línea de comando como administrador y navegue al directorio de la
agrupación de Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\bin
3. Ingrese el siguiente comando, donde primary2 es la dirección IP o el nombre de
computadora de su servidor primario de respaldo (que pronto será su servidor primario)
y primary1 es la dirección IP o el nombre de la computadora de su servidor primario
anterior (que pronto será su respaldo):
tabadmin failoverprimary --primary <primary2> --secondary
<primary1>
4. Escriba el siguiente comando:
sc config tabsvc start= auto
5. Inicie el servidor. El servidor primario de respaldo es ahora su servidor primario. Cuando
mira la tabla Estado de la página Mantenimiento, debe notar que la dirección IP o el
nombre de la computadora del servidor primario cambió:
6. Para que su servidor primario ahora actúe como principal de respaldo, debe hacer lo
siguiente:
l
l
l
Use Agregar/Eliminar programas para eliminar Tableau Server de su servidor
primario anterior. Al final de la desinstalación del programa recibirá un error de
respaldo, el cual puede ignorar.
Elimine las carpetas de Tableau en Archivos de programa y Datos de programa
en su servidor primario anterior.
Repita los pasos de este tema comenzando con el paso 4 de “Crear una puerta
de enlace de respaldo”.
Trabajar con el servidor
Consulte los siguientes temas al utilizar la interfaz de usuario de Tableau Server para
administrar su instalación
Usuarios y licencias
Todas las personas que necesitan acceder a Tableau Server, ya sea para publicar, navegar o
administrar, deben estar agregadas como usuario. Además, se debe asignar un nivel de
licencia a los usuarios.
Usuarios
Todas las personas que necesitan acceder a Tableau Server, ya sea para publicar, navegar o
administrar, deben estar agregadas como usuario. Si Tableau Server ejecuta múltiples sitios,
la página Todos los usuarios es el lugar donde los administradores hacen esto. De lo
contrario, si Tableau Server está en modo de un sitio, los administradores de sistema y sitio
pueden agregar usuarios en la página Usuarios.
Luego de agregar los usuarios, puede editarlos y eliminarlos, agregarlos o eliminarlos de los
sitios, y asignarles niveles de licencia y derechos de usuario. Consulte los temas a
continuación para obtener más información.
Agregar usuarios
Tanto los administradores del sistema como los administradores de sitio con los permisos
correctos pueden agregar usuarios desde la página Usuarios:
Puede agregar usuarios desde la página Usuarios de dos formas: De manera interactiva
(descrito a continuación) o en lotes usando el comando Importar, que depende de un archivo
CSV (descrito en Importar usuarios desde un archivo CSV).
Para agregar un usuario:
En la página Usuarios, haga clic en el enlace Agregar sobre la lista de usuarios:
1.
2. Escriba un nombre de usuario.
l
l
Autenticación local: Si el servidor está configurado para una autenticación
local, el uso de una dirección de correo electrónico para el Nombre de usuario
es la mejor forma de evitar conflictos entre nombres de usuario (por ejemplo,
[email protected] en vez de jsmith). Después de escribir un Nombre de
usuario, haga clic en Agregar usuario.
Active Directory: Si agrega un usuario que proviene del mismo dominio de
Active Directory que el servidor, puede escribir el Nombre de usuario sin el
dominio. El dominio del servidor se sobreentenderá.
Si se configuró una confianza bilateral entre el dominio del servidor y otro
dominio, puede agregar usuarios de ambos dominios. La primera vez que
agregue un usuario del “dominio diferente del servidor”, debe emplear el nombre
de dominio completamente calificado con el nombre de usuario. Los siguientes
usuarios se pueden agregar con el apodo del dominio. Por ejemplo, si tenemos
un “dominio diferente del servidor” llamado mybiz.lan, escriba el primer usuario de
este dominio [email protected] o mybiz.lan\user1. El siguiente usuario se
puede escribir con el apodo, por ejemplo como [email protected] o mybiz\user2.
Nota:Asegúrese de no escribir el Nombre completo del usuario en este campo,
ya que puede causar errores durante el proceso de importación.
3. Solo autenticación local, proporcione lo siguiente:
l
Nombre completo: escriba un nombre de visualización para el usuario (p. ej.
John Smith).
l
Contraseña: escriba una contraseña para el usuario.
l
Confirmar: vuelva a escribir la contraseña.
4. Nivel de licencia: Seleccione un nivel de licencia. Consulte Licencias y derechos de
usuario y Permisos para obtener más información.
5. Derecho de usuario: Seleccione si el usuario puede publicar libros de trabajo y asignar
derechos de administrador. Consulte Permitir o denegar derechos de usuario para
obtener más información.
6. Haga clic en Agregar.
Nota para servidores de sitios múltiples:
Los administradores de sitio pueden editar una cuenta de usuario existente siempre que el
usuario sea el único miembro de los sitios que controla el administrador de sitio. Por ejemplo, si
el usuario Joe es miembro del Sitio A y el Sitio B y el administrador de sitio solo es
administrador en el Sitio B, el administrador de sitio no podrá editar el nombre completo de Joe
ni restablecer su contraseña.
Agregar usuarios a un sitio
Una vez que agrega un sitio a Tableau Server, se convierte en un sistema de sitios múltiples y
lo que antiguamente era la página Usuarios se convierte en dos páginas: Todos los
usuarios y Usuarios del sitio. Como administrador del sistema, solo puede acceder a la
página Todos los usuarios, que se aplica al sistema del servidor completo. Es el único lugar
donde puede agregar todos los usuarios a varios sitios a la vez, quitar usuarios y, si el servidor
utiliza autenticación local, restablecer las contraseñas de los usuarios.
La página Usuarios del sitio es una forma fácil de ver rápidamente qué usuarios están en el
sitio al que está conectado actualmente. Puede agregar usuarios desde aquí, pero solo se
agregarán a ese sitio.
El siguiente procedimiento describe cómo agregar usuarios desde Todos los usuarios. Hay
dos enfoques que puede considerar:Uno a la vez (como se describe a continuación) o en lotes
usando el comando Importar, que depende de un archivo CSV (descrito en Importar usuarios
desde un archivo CSV).
Para agregar un usuario:
1. En la página Todos los usuarios, haga clic en el enlace Agregar en la parte superior
de la lista de usuarios.
2. Escriba un nombre de usuario:
l
l
Autenticación local: si el servidor utiliza autenticación local, el uso de una
dirección de correo electrónico para el nombre de usuario es la mejor forma de
evitar conflictos entre nombres de usuario (por ejemplo, [email protected] en
vez de jsmith).
Active Directory: si agrega un usuario que proviene del mismo dominio de
Active Directory que el servidor, puede escribir el Nombre de usuario sin el
dominio. El dominio del servidor se sobreentenderá.
Si se configuró una confianza bilateral entre el dominio del servidor y otro
dominio, puede agregar usuarios de ambos dominios. La primera vez que
agregue un usuario del “dominio diferente del servidor”, debe emplear el nombre
de dominio completamente calificado con el nombre de usuario. Los siguientes
usuarios se pueden agregar con el apodo del dominio. Por ejemplo, si tenemos
un “dominio diferente del servidor” llamado mybiz.lan, escriba el primer usuario de
este dominio [email protected] o mybiz.lan\user1. El siguiente usuario se
puede escribir con el apodo, por ejemplo como [email protected] o mybiz\user2.
Nota: Asegúrese de no escribir el Nombre completo del usuario en este
campo, ya que puede causar errores durante el proceso de importación.
3. Si el servidor está usando la autenticación local, proporcione lo siguiente:
l
Nombre completo: escriba un nombre completo para el usuario (por ejemplo,
John Smith).
l
Contraseña: escriba una contraseña para el usuario.
l
Confirmar: vuelva a escribir la contraseña.
4. Membresía de sitio: seleccione los sitios a los cuales debería pertenecer el usuario. El
sitio en el que inició sesión se selecciona de forma predeterminada.
5. Nivel de licencia y derechos de usuario: seleccione un nivel de licencia, función de
administrador y si el usuario puede publicar libros de trabajo y fuentes de datos. Un
usuario que pertenece a varios sitios puede tener niveles de licencias diferentes y
derechos de usuario. Consulte Sobre niveles de licencia, Permisos y Sobre derechos de
usuario para obtener más información.
6. Haga clic en Agregar usuario.
Importar usuarios desde un archivo CSV
Puede automatizar el proceso para agregar usuarios mediante el uso de un archivo CSV.
Requisitos
l
l
l
l
El archivo CSV se debe guardar en formato UTF-8, con la marca de orden de bytes
(BOM).
Se debe convertir las codificaciones de caracteres distintas a UTF-8, como BIG5.Puede hacer esto mediante “Guardar como”.
No use encabezados de columna. Si usa encabezados de columna (Username,
Password, etc.), Tableau Server intentará importarlos como credenciales literales para
el primer usuario en el archivo.
Las siguientes dos columnas son siempre obligatorias:
l
l
l
Username
Password: Si Tableau Server está configurado para usar la autenticación de
usuario de Active Directory, debe haber una columna Password, pero la
columna debe estar vacía. Si el servidor está usando la autenticación local,
deberá proporcionar contraseñas a los usuarios nuevos. Consulte también “Modo
de varios sitios y Desde donde importa” para obtener más información.
El archivo CSV puede tener también las siguientes columnas opcionales en el orden
que se muestra a continuación (después de las columnas Username y Password):
l
Full Name
l
License Level (Interactor, Viewer o Unlicensed)
l
Administrator (Sistema, Sitio, Sitio o Ninguno)
l
Publisher (yes/true/1 o no/false/0)
l
Email Address
l
El orden de las columnas es importante. La primera columna se considera Username,
la segunda Password, la tercera Full Name, etc., independientemente del contenido
de las columnas.
Modo de varios sitios y Desde donde importa
Si el servidor está ejecutando varios sitios y usted es administrador del sistema, hay dos
páginas desde las cuales puede realizar una importación de usuario de CSV.Cada una tiene
distintas funciones en lo que se refiere a cuentas de usuarios del servidor actuales.
Página Todos los usuarios: Esta página muestra si un servidor está ejecutando varios
sitios y solo los administradores del sistema pueden acceder a ella.
l
Las importaciones de CSV desde aquí le permiten actualizar las cuentas de usuarios
actuales del servidor, además de agregar usuarios nuevos. Por ejemplo, si realiza una
importación de CSV que tiene una contraseña nueva para cada usuario actual, se
restablecerán las contraseñas.
La página Usuarios del sitio:
l
Cuando un administrador del sistema trabaja desde este lugar, tiene las mismas
capacidades que un administrador de sitio. Esto significa que puede agregar cuentas de
usuarios nuevas con las importaciones de CSV y, si los usuarios actuales son parte de
la importación, los campos Contraseña y Nombre completo deben coincidir o quedar
en blanco. Si se usan contraseñas o nombres completos nuevos, se producirá un error
en la importación.
Si usted es un administrador de sitio en un servidor con varios sitios, realice importaciones de
usuarios de CSV desde la página Usuarios.
Un usuario puede pertenecer a más de un sitio en el mismo sistema de servidor, pero debe
usar las mismas credenciales para cada sitio. Esto es importante cuando se agregan usuarios
que son nuevos para su sitio, pero tal vez no para el servidor (en otras palabras, son miembros
de un sitio diferente en el servidor). Si cree que este puede ser el caso, intente dejar la
columna Password en blanco (pero mantenga el encabezado de la columna Password que
se requiere). Si el servidor está configurado para una autenticación local y un usuario o nuevo
del sitio es también nuevo para el sistema de servidor, verá un mensaje en la ventana de
importación de CSV que le indicará que proporcione una contraseña para el usuario.
Agregar usuarios desde un archivo CSV
Para agregar usuarios desde un archivo CSV:
1. En la página Usuarios o Todos los usuarios, haga clic en el enlace Importar:
2. Haga clic en Examinar, navegue hasta el archivo y haga clic en Verificar archivo:
3. Se mostrarán los resultados preliminares. Para ver información específica de una
cuenta, seleccione Ver detalles:
4. Para continuar, haga clic en Importar usuarios luego haga clic en Salir en el cuadro
de diálogo final.
Agregar usuarios a un grupo
Una forma de facilitar la administración de usuario es asignarlos a grupos. De esa forma
puede asignar permisos a un grupo completo en lugar de a cada usuario individual. Para
agregar un usuario a un grupo, el grupo ya debe existir. Consulte Crear grupos para obtener
más información.
Para agregar un usuario a un grupo:
1. En la pestaña Administración, seleccione la página Usuarios:
Si es el administrador del sistema de un servidor de sitios múltiples, deberá hacer esto
por sitio usando la página Usuarios del sitio:
2. Seleccione uno o más usuarios.
3. Haga clic en el enlace Grupo + sobre la lista de usuarios, luego seleccione un grupo al
cual agregar los usuarios:
Ver, editar y eliminar usuarios
Use este tema para aprender a ver, editar y eliminar usuarios de Tableau Server.
Ver usuarios
Si Tableau Server ejecuta múltiples sitios, Todos los usuarios enumera a todos los usuarios
en el sistema del servidor, y Usuarios del sitio muestra todos los usuarios para el sitio en el
que ha iniciado sesión:
Nota:
De forma predeterminada, esta lista de usuarios es privada y solo los administradores pueden
verla. Puede hacer la lista de usuarios pública al habilitar Lista de usuarios pública en el área
Configuración de la página Mantenimiento. Si el servidor ejecuta múltiples sitios, la habilitación
de esta configuración solo mostrará los nombres de usuarios en su sitio.
Es posible que se indique a los usuarios en múltiples páginas. A medida que selecciona
usuarios de la lista, estos se agregan a una lista rápida en la esquina superior izquierda. La
lista rápida le permite ver cuántos usuarios ha seleccionado y le ayuda a eliminar fácilmente
usuarios de la lista. Haga clic en el botón "x" junto al nombre de usuario en la lista rápida para
eliminar a una persona de la selección.
También puede usar la casilla Buscar en Filtros a la izquierda para buscar rápidamente un
usuario específico de la lista.
Escriba el nombre del usuario de forma parcial o total y presione Intro. Puede usar un carácter
de asterisco (*) como comodín en la búsqueda. Por ejemplo, al buscar John* se mostrarán
todos los nombres que comienzan con John.
Editar usuarios
Si el servidor está configurado para usar el sistema de administración de usuarios interno
(Autenticación local), puede editar el Nombre de visualización y la Contraseñapara
usuarios después de que se hayan agregado. Si realiza muchos cambios es más fácil importar
los cambios desde un archivo CSV.Consulte Agregar usuarios para conocer detalles.
Para editar información de usuario:
1. Seleccione un usuario individual de la lista de usuarios.
2. Haga clic en el enlace Editar en la parte superior de la lista.
3. Escriba un nuevo Nombre de visualización y Contraseña en los cuadros de texto
correspondientes.
4. Haga clic en Enviar.
Nota para servidores de sitios múltiples:
Los administradores de sitio pueden editar una cuenta de usuario existente siempre que el
usuario sea el único miembro de los sitios que controla el administrador de sitio. Por ejemplo, si
el usuario Joe es miembro del Sitio A y el Sitio B y el administrador de sitio solo es
administrador en el Sitio B, el administrador de sitio no podrá editar el nombre completo de Joe
ni restablecer su contraseña.
Eliminar usuarios
Para eliminar usuarios:
1. Seleccione uno o más usuarios para eliminar.
2. Haga clic en Eliminar en la parte superior de la lista.
3. Haga clic en Sí en el cuadro de diálogo de confirmación.
Solo puede eliminar un usuario desde Tableau Server si el usuario no posee contenido
(libros de trabajo, fuentes de datos, etc.). Si utiliza el siguiente procedimiento para
eliminar un usuario que posee contenido, el usuario se configurará como Sin licencia,
pero no se eliminará.
Licencias y derechos de usuario
El nivel de licencia y los derechos de usuario que asigna a los usuarios determina cuánto
pueden hacer en Tableau Server.
Sobre niveles de licencia
Para abrir la página Licencias, haga clic en el enlace Licencias de la pestaña Administración:
Todos los usuarios de Tableau Server deben recibir una asignación de un nivel de licencia,
incluso si el nivel es Sin licencia. Los niveles de licencia de Tableau Server no corresponden a
las licencias de usuarios llamadas Tableau Server que compró desde Tableau (si usa
licenciamiento de servidor basado en usuario en lugar de basado en núcleos). Dichas licencias
le permiten tener cierto número de usuarios en el servidor. Los niveles de licencia permiten
que los administradores controlen el nivel de acceso de los usuarios en el sitio.
A continuación están los niveles de licencia que puede asignar:
Nivel de licencia
Descripción
Sin licencia
El usuario no puede iniciar
sesión en el servidor.
Todos los usuarios se
agregan sin licencia de
forma predeterminada.
Visor
El usuario puede iniciar
sesión y ver vistas
publicadas en el servidor,
pero no puede interactuar
con las vistas. Los
usuarios con este nivel
solo pueden recibir
permisos para ver,
agregar comentarios y ver
comentarios. No pueden
interactuar con filtros
Nivel de licencia
Descripción
rápidos u ordenar los
datos de una vista.
Interaccionador
El usuario puede iniciar
sesión, navegar en el
servidor e interactuar con
las vistas publicadas. Es
importante tener en
cuenta que las vistas,
libros de trabajo y
proyectos específicos se
pueden haber agregado
sin permisos que
restrinjan las capacidades
de un usuario. El autor del
libro de trabajo o un
administrador pueden
editar la configuración de
permisos.
Invitado
El nivel de licencia invitado
está disponible para
permitir que usuarios sin
cuenta en el servidor vean
e interactúen con una
vista incrustada. Cuando
se habilita, el usuario
puede cargar una página
Web que contiene una
visualización incrustada
sin iniciar sesión. Esta
opción solo está
disponible con un servidor
basado en núcleos.
Puede revisar la forma en que estos niveles se distribuyeron en la página Licencias:
Cambiar niveles de licencia
Cuando crea un usuario, a menudo le asigna un nivel de licencia. Para cambiar ese nivel para
uno o más usuarios existentes, siga estos pasos:
1. En la pestaña Administración, haga clic en Usuarios.
2. Seleccione uno o más usuarios.
3. Haga clic en Usuario de licencia en la parte superior de la lista.
4. Seleccione Sin licencia, Visor o Interaccionador para los usuarios seleccionados.
La columna Nivel de licencia de la lista de usuarios se actualiza para reflejar los
cambios.
Sobre derechos de usuario
Además del nivel de licencia, los privilegios de usuario de Tableau Server también se ven
afectados por sus derechos de usuario:
Derecho de
usuario
Publicar
Administrador
Descripción
Permite que los usuarios se conecten a
Tableau Server desde Tableau
Desktop, de forma que pueda publicar y
descargar libros de trabajo y fuentes de
datos.
Convierte al usuario en un
administrador.
Hay dos tipos de administradores: Los
administradores de sitio y los
administradores de sistema.
l
l
Los administradores de sitio
pueden administrar grupos,
proyectos, libros de trabajo y
conexiones de datos. De manera
predeterminada, los
administradores de sitio pueden
también agregar usuarios y
asignar derechos de usuario y
niveles de licencia, pero un
administrador de sistema puede
deshabilitarlos (consulte sites_
edit.htm).
Los administradores del
sistema tienen todos los
derechos de un administrador de
sitio, además de poder otorgar
licencia a los usuarios sin
licencia, controlar si los
administradores de sitio pueden
agregar usuarios, crear
administradores de sistemas
adicionales y administrar el
servidor mismo. Esto incluye la
manipulación de mantenimiento,
configuración, programas y el
índice de búsqueda.
El derecho de administración
solo se puede asignar a usuarios
con el nivel de licencia de
interaccionador y el derecho de
publicación.
Permitir o denegar derechos de usuario
Cuando crea un usuario, normalmente le asigna derechos de usuario. Para cambiar los
derechos de usuario para uno o más usuarios existentes, siga estos pasos:
1. En la pestaña Administración, haga clic en Usuarios.
2. Seleccione uno o más usuarios.
3. Haga clic en Publicación o Administración en la parte superior de la lista.
4. Seleccione Permitir o Denegar para cambiar el derecho de publicación para los
usuarios seleccionados.
5. Desde Administración, seleccione Sistema, Sitio o Ninguno para cambiar el
derecho de Administración para los usuarios seleccionados. Las columnas
Administración y Publicación de la lista de usuarios se actualizan para reflejar los
cambios.
Grupos y proyectos
Grupos y Proyectos ayudan a organizar sus libros de trabajo y usuarios en Tableau Server.
Grupos
Puede organizar a los usuarios de Tableau Server en grupos para facilitar la administración de
varios usuarios. Puede crear grupos de forma local en el servidor o importar desde Active
Directory. Puede crear y administrar grupos en la página Grupos, la cual muestra una lista de
todos los grupos en el servidor o sitio, si el servidor alberga sitios múltiples.
Crear grupos
Según la forma en que se configuró el servidor puede agregar grupos mediante el sistema de
administración de usuarios interno (autenticación local) o puede importar desde Active
Directory.
Crear un grupo local
Un grupo local es un grupo que se crea en Tableau Server mediante el sistema de
administración de usuarios interno. Después de crear un grupo, puede agregar y eliminar
usuarios. Para crear un grupo local:
1. Haga clic en Nuevo en la parte superior de la lista de grupos.
2. Escriba el nombre del grupo y haga clic en Agregar grupo:
3. Haga clic en Volver a grupos para volver a la lista de grupos.
Crear un grupo mediante Active Directory
También se puede importar los grupos de Active Directory. Cuando importa Active Directory,
se crea un grupo coincidente en el servidor y se crea un usuario en el servidor para cada
miembro del grupo. Los usuarios no tienen licencia ni permiso para publicar. Si el usuario ya
existe en el servidor, se agrega al nuevo grupo y sus permisos no cambian. Consulte Licencias
y derechos de usuario para obtener más información sobre niveles de licencia y derechos de
usuario
1. Haga clic en Importar grupo de Active Directory en la parte inferior de la lista de
grupos.
2. Escriba el nombre del grupo de Active Directory que desea importar y haga clic en
Importar
3. Si no conoce el nombre exacto del grupo puede encontrarlo al escribir todo o parte del
nombre del grupo en el cuadro de texto Búsqueda. Luego haga clic en Buscar. Puede
usar el símbolo de asterisco ( * ) como comodín.
4. Seleccione el grupo de la lista de resultados de búsqueda.
5. La nombre de grupo se agrega automáticamente al cuadro de texto Importar. Haga clic
en Importar para agregar el grupo a Tableau Server.
No puede cambiar el nombre de grupos importados de Active Directory. El nombre de
grupo solo se puede cambiar en Active Directory.
Sincronizar un grupo de Active Directory
En cualquier momento, puede sincronizar un grupo de Active Directory con Tableau Server de
forma que también se pueda agregar nuevos usuarios de Active Directory en el servidor.
Puede sincronizar grupos individuales o grupos múltiples a la vez.
1. En la página Grupos, seleccione uno o más grupos.
2. Haga clic en Sincronizar.
Si agrega un grupo que es del mismo dominio de Active Directory en que se ejecuta el
servidor, simplemente escriba el tipo de nombre de grupo. Además, si hay una
confianza bilateral configurado entre el dominio que el servidor usa y otro dominio puede
agregar grupos de ambos dominios. La primera vez que agrega un grupo desde un
dominio distinto al que el servidor usa, debe incluir el nombre de dominio
completamente calificado con el nombre de grupo. Por ejemplo, domain.lan\group o
[email protected] Se puede agregar cualquier grupo posterior mediante el apodo del
dominio. Consulte Modificar nombres de dominio para obtener más información sobre la
administración de nombres de dominio.
Eliminar grupos
Puede eliminar cualquier grupo del servidor. Cuando elimina un grupo, se eliminan los
usuarios del grupo, pero no se eliminan del servidor.
1. En la página Grupos, seleccione uno o más grupos que desee eliminar.
2. Haga clic en Eliminar sobre la lista de grupos:
Proyectos
Un proyecto es una recopilación de libros de trabajo relacionados. Como administrador,
existen dos lugares donde verá una lista de Proyectos: en la pestaña Contenido y en la
pestaña Administración. Si desea crear nuevos proyectos, asignar permisos o eliminar
proyectos, use la página Proyectos en la pestaña Administración:
A pesar que solo los administradores de proyectos pueden crear proyectos nuevos, se puede
asignar el permiso de líder de proyecto a usuarios y grupos. Este permiso permite que un
usuario o grupo especifique permisos de proyectos y mueva libros de trabajo dentro de
proyectos. Consulte los temas a continuación para conocer procedimiento y obtener más
información sobre el trabajo con proyectos.
Agregar proyectos
Para agregar uno o más proyectos:
1. Haga clic en el enlace Agregar.
2. Escriba el nombre y la descripción para el proyecto y haga clic en Agregar. Puede
incluir formato e hipervínculos en la descripción del proyecto.
Mover libros de trabajo hacia proyectos
Todos los libros de trabajo deben estar en un proyecto.De forma predeterminada, los libros de
trabajo se agregan al proyecto Predeterminado. Después que ha creado sus propios
proyectos puede mover libros de trabajo de un proyecto a otro. Puede mover libros de trabajo
hacia proyectos si tiene un nivel de licencia de interaccionador y al menos uno de los siguientes
es verdadero.
l
Se le ha otorgado permiso de escritura en el proyecto .
l
Se le ha otorgado permiso de Líder de proyecto para el proyecto.
l
Se le ha otorgado derecho de administración.
Para mover un libro de trabajo hacia un proyecto:
1. Seleccione uno o más libros de trabajo y haga clic en el enlace Mover en la parte
superior de la lista de libros de trabajo.
2. Seleccione un proyecto para mover el libro de trabajo.
Debido a que todos los libros de trabajo deben ser parte de un proyecto, puede eliminar
un libro de trabajo desde un proyecto al moverlo al proyecto predeterminado. Cada libro
de trabajo solo puede ser parte de un proyecto individual.
Eliminar proyectos
Solo los administradores pueden eliminar proyectos. Cuando elimina un proyecto, todos los
libros de trabajo y vistas que son parte del proyecto también se eliminan del servidor. Para
eliminar un proyecto:
1. Seleccione el proyecto de la lista de proyectos.
2. Haga clic en Eliminar sobre la lista de proyectos.
3. Haga clic en Sí en el cuadro de diálogo de confirmación.
No es posible eliminar el proyecto Predeterminado.
Programar actualizaciones y suscripciones
Las actualizaciones de extractos y las entregas de suscripciones son tareas que realiza
Tableau Server y los programas controlan cuándo se ejecutan dichas tareas.
Como administrador de servidor, tiene el mayor nivel de control sobre tareas y programas de
servidor, sin embargo, existen dos tipos de tareas que los usuarios de Tableau Server pueden
programar. Los autores de libros de trabajo pueden programar actualizaciones de extractos
cuando publican un libro de trabajo o una fuente de datos con un extracto y los usuarios de
Tableau Server pueden suscribirse a vistas, que se entregan en una programación. Como
administrador, puede ajustar un programa de extracto o suscripción, crear nuevos programas,
actualizar tareas y eliminarlas. Usted también controla si los autores de libros de trabajo
pueden programar (consulte Habilitar programación) y tiene control de si el servidor se
configura para enviar suscripciones (consulte Administrar suscripciones). Cualquier cambio
que hace en el programa de un extracto se refleja en el cuadro de diálogo Programa de
Tableau Desktop la próxima vez que el autor publica. De forma similar, si crea una nueva
programación de suscripción o elimina una existente, se refleja en las elecciones de
programación que ve un usuario de Tableau Server al intentar suscribirse a una vista.
Consulte los siguientes temas para obtener más información:
Sobre extractos y programas
Tableau Desktop permite que los autores creen un extracto de datos, el cual es una copia o
subconjunto de datos de la fuente de datos original. Los libros de trabajo que usan extractos de
datos generalmente son más rápidos que los que usan conexiones de base de datos de
acceso en tiempo real debido a que los datos extraídos se importan en el motor de datos
rápido incorporado de Tableau. Los extractos también pueden aumentar la funcionalidad. Una
vez que se publica un libro de trabajo o fuente de datos con un extracto, el extracto reside en
Tableau Server.
Actualizar extractos directamente en Tableau Server:
l
Navegador Web: Como administrador, puede usar para cambiar o reasignar
programas de actualización de extractos, independientemente de si un libro de trabajo o
fuente de datos con un extracto recibió un programa de actualización en el momento de
su publicación. Cualquier cambio de programación que el administrador realiza en
[[[Undefined variable ServerOrOnline.ServerOrOnline]]] se refleja en el cuadro de
diálogo Programa en Tableau Desktop cuando se publica nuevamente el libro de
trabajo o la fuente de datos.
También puede actualizar un extracto de inmediato, con la opción Ejecutar ahora.
Consulte Administrar tareas de actualizacióny Crear o modificar un programa para
conocer los detalles. Tenga en cuenta que antes de crear programas de actualización,
debe habilitar la programación en el servidor. Consulte Habilitar programación para
obtener más información.
l
Utilidad de línea de comando tabcmd: La utilidad de línea de comando tabcmd
proporciona un comando refreshextracts que puede utilizar desde la línea de
comando o que puede incorporar en su propia secuencia de comando. Consulte
Automatizar las tareas de actualización para obtener más información.
Actualizar extractos directamente desde Tableau Desktop:
l
l
En el momento de la publicación: Cuando un autor publica un libro de trabajo o
fuente de datos que usa un extracto, dicho autor puede asignarlo a un programa de
actualización recurrente en Tableau Server. C La actualización puede ser una
actualización completa o en incrementos. Las actualizaciones en incrementos hacen
referencia a una columna del extracto que tiene un tipo de datos de fecha, fecha/hora o
entero; como un sello de tiempo. Tableau usa esta columna para identificar nuevas filas
que se deben agregar al extracto. Consulte Actualizar extractos y Programas en la
ayuda de Tableau Desktop para obtener más información.
Interfaz de usuario: Puede usar las opciones Actualizar desde fuente y Adjuntar
de archivo de Tableau Desktop para cargar una adición o actualizar un extracto en
Tableau Server. Es recomendable hacer esto si Tableau Server no tiene credenciales
suficientes para actualizar datos desde la fuente de datos original. Consulte
Actualización de extractos en Tableau Server en la ayuda en línea de Tableau Desktop
para conocer más detalles sobre la carga.
l
Utilidad de línea de comando de extracción de datos: La utilidad de línea de
comando de extracto de datos se instala con Tableau Desktop. Puede usarla para
cargar una adición para un extracto en Tableau Server o para actualizarlo. Consulte
Utilidad de línea de comando de extracción de datos de Tableau en la ayuda en línea de
Tableau Desktop para obtener más información sobre la carga. C
Habilitar programación
Antes de poder ejecutar una actualización de extracto, se debe habilitar la programación en el
servidor. Después de habilitar la programación, puede agregar libros de trabajo y fuentes de
datos a programas, crear y editar programas, administrar tareas programadas y cambiar la
configuración de programas para permitir que publicadores asignen libros de trabajo a
programas. Esta configuración no afecta la programación de suscripciones.
Para habilitar la programación, seleccione la casilla de verificación Programación bajo
Configuración en la página Mantenimiento de servidor:
Debido a que es posible que se requiera que las contraseñas actualicen el extracto,
debe habilitar Credenciales incrustadas a fin de permitir la programación.
Crear o modificar un programa
La página Programas muestra una lista de programas, incluido su nombre, tipo, para lo que
son (alcance), número de tareas, comportamiento (procesamiento simultáneo o en serie) y
cuándo están programados para su ejecución.
1. Para crear un programa nuevo, haga clic en Nuevo:
2. Para modificar un programa existente, seleccione y luego haga clic en Modificar:
3. Especifique un Nombre descriptivo para el programa (por ejemplo, cada sábado en la
mañana, fin de mes).
4. Seleccione un Alcance de programa, que es lo que administrará el programa, ya sea
actualizaciones de extractos o entregar suscripciones.
5. De forma opcional, defina una Prioridad predeterminada de 0 a 100. Esta es la
prioridad que se asignará a las tareas de forma predeterminada. Si hay dos tareas
pendientes en la cola, se ejecuta primero la que tiene mayor prioridad. Consulte
Administrar tareas de actualización para obtener más información sobre la modificación
de la prioridad de una tarea.
6. Elija si los trabajos del programa se ejecutarán al mismo tiempo (simultáneamente, el
valor predeterminado) o uno después de otro (en secuencia).
7. Termine de definir o editar el programa. Puede definir un programa por hora, día,
semana o mes.
8. Haga clic en Crear programación si es una nueva programación o Guardar
programación si modificó una programación existente.
Agregar una fuente de datos o libro de trabajo a un programa
Una vez que haya habilitado la programación puede agregar un libro de trabajo a un programa
desde la lista Libros de trabajo o puede agregar una fuente de datos a un programa desde la
lista Fuentes de datos. De forma predeterminada Tableau Server tiene tres programas
incorporados para actualizar extractos. También puede crear el suyo. Consulte Crear o
modificar un programa para conocer detalles.
1. Si va a programar un libro de trabajo para una actualización de extractos, seleccione
uno o más en la página Libros de trabajo y haga clic en Tareas programadas:
Si va a programar una fuente de datos para una actualización de extractos, seleccione
uno o más en la página Fuentes de datos y haga clic en Tareas programadas:
2. Seleccione Agregar actualización completa o Agregar actualización incremental,
luego seleccione un programa de la lista:
Agregar actualización completa solo está disponible si la fuente de datos se conecta
a un extracto. Agregar actualización incremental solo está disponible si la fuente de
datos seleccionada se conecta a un origen de datos de extracción para el cual ha
definido una actualización incremental. Tableau Server no puede actualizar fuentes de
datos que se conectan a fuentes de datos de archivos locales en una unidad asignada.
Actualice la conexión para usar la ruta completa a la fuente de datos.
Administrar tareas de actualización
La página Tareas muestra todas las tareas de actualización de extracto completas e
incrementales que administra el servidor. Los administradores de sistema y sitio pueden usar
esta página para cambiar la prioridad de una tarea, moverla a un programa diferente,
ejecutarla o eliminarla. Puede abrir la página Tareas haciendo clic en Tareas en la pestaña
Administración:
Editar el programa de una tarea
Mueva una tarea de actualización de extractos de un programa a otro haciendo lo siguiente:
1. En la página Tareas seleccione una o más tareas que desee modificar.
2. Haga clic en Editar programa. Seleccione un programa nuevo de la lista de
programas:
También puede eliminar y ejecutar tareas al seleccionar una o más tareas de la lista y
seleccionar una opción de la barra de herramientas.
Ejecutar una tarea ahora
Puede forzar la actualización inmediata de una tarea, como por ejemplo, una tarea de
actualización de extracto, utilizando la opción Ejecutar ahora.
1. En la página Tareas, seleccione la tarea que desea ejecutar.
2. Haga clic en Ejecutar ahora.
Cambiar la prioridad de una tarea
Para cambiar la prioridad de una tarea de actualización de extracto:
1. En la página Tareas seleccione una o más tareas que desee modificar.
2. Haga clic en Editar prioridad.
3. Escriba una prioridad nueva de 0 a 100 y haga clic en Enviar.
Automatizar las tareas de actualización
Puede asociar las tareas de actualización de extractos con programas de Tableau Server para
automatizar la actualización de extracciones de datos. También puede automatizar las
actualizaciones de extractos usando tabcmd, , una utilidad de línea de comando que se incluye
con Tableau Server y que se puede instalar en una computadora que no sea donde se ejecuta
Tableau Server. En particular, puede usar el comando refreshextracts en combinación
con otros comandos en su propia secuencia de comando. Por ejemplo:
tabcmd login - http://mytabserver -u jsmith -p [email protected]!
refreshextracts --datasource salesq4
Manejar alertas de actualización de extracto
Si las actualizaciones de extractos calendarizadas no tienen éxito, Tableau mostrará un menú
de Alertas en la esquina superior derecha:
Solo verá el menú de Alertas si falló una actualización de extractos y es:
l
Un administrador de sistema o de sitio.
l
El autor del libro de trabajo o la fuente de datos que no se pudo actualizar.
l
El autor de un libro de trabajo que se conecta a la fuente de datos que no se pudo
actualizar.
Cuando abre el menú de Alertas, puede ver más información acerca de los fallos de
actualización:
Cuando una Fuente de datos se lista como Incrustada, significa que la definición de la
fuente de datos (que incluye cosas como las credenciales de la fuente de datos, o el nombre
de la base de datos) está incrustada en, o reside dentro del libro de trabajo. También significa
que el problema se debe corregir en Tableau Desktop. Por ejemplo, la fuente del problema
puede ser que las credenciales se deben incrustar en el libro de trabajo.
Cuando un nombre de fuente de datos o nombre de libro de trabajo se lista como la Fuente de
datos(por ejemplo, Fuente de datos: sales_data), significa que la fuente de datos es una
fuente de datos de Tableau Server. La definición de la fuente de datos reside en Tableau
Server. Cuando el libro de trabajo o la fuente de datos se crearon originalmente en Tableau
Desktop, se mostraba un icono de Tableau en lugar de un icono de base de datos junto a la
fuente de datos, en la ventana de datos:
A veces puede corregir un problema de actualización de extracto al hacer clic en Editar
información de conexión, ingresar la información faltante y hacer clic en Guardar:
Administrar suscripciones
Una suscripción es una vista o libro de trabajo en Tableau Server que los usuarios pueden
recibir una instantánea a través del correo electrónico. Cuando hacen clic en la instantánea en
su correo electrónico, se abre la vista o libro de trabajo en Tableau Server. Para administrar
suscripciones, haga clic en Suscripciones en la pestaña Administrador.
Requisitos
Para que los usuarios de Tableau Server reciban suscripciones, debe reunir los siguientes
requisitos:
l
Configuración de correo electrónico: Como administrador del sistema, puede
configurar los ajustes del servidor SMTP básicos para suscripciones en la pestaña
Configuración de alertas de correo electrónico/suscripciones en el cuadro de
diálogo Configuración, el cual aparece durante la configuración. Esta es la "desde
cuenta" que Tableau Server utiliza para enviar por correo electrónico suscripciones a los
usuarios del servidor. También puede acceder a esta pestaña después de la
configuración. Consulte Reconfigurar el servidor y Configurar las suscripciones de
correo electrónico para conocer los pasos.
l
l
l
Credenciales incrustadas o no requeridas: Desde la perspectiva de Tableau
Server, una suscripción incluye un libro de trabajo, datos y un programa. Para entregar
la pieza de datos, Tableau Server debe poder acceder a los datos sin participación del
usuario final. Esto se puede lograr con un libro de trabajo y credenciales de base de
datos incrustadas, una fuente de datos de Tableau Server o a través del uso de datos
que no requieren credenciales, como un archivo que se incluye en el libro de trabajo en
el momento de la publicación. No es posible suscribirse a libros de trabajo que soliciten
credenciales para las conexiones de bases de datos de acceso en tiempo real.
Requisitos de usuario: Si un usuario puede ver una vista o libro de trabajo en Tableau
Server y tiene el icono de suscripción ( ) en la esquina superior derecha, puede
suscribirse a la vista o libro de trabajo. La capacidad de ver una vista o libro de trabajo se
controla mediante el permiso Ver. Un usuario debe tener también una dirección de
correo electrónico. Si Tableau Server no tiene ya una dirección de correo para un
usuario suscriptor, solicita una en el momento de la suscripción. Los usuarios pueden
cambiar sus opciones de entrega, anular la suscripción o actualizar su dirección de
correo electrónico en la página Preferencias del usuario.
Autenticación no confiable: Si se configura Tableau Server para autenticación de
confianza, se deshabilitan las suscripciones. La autenticación de confianza, junto con la
autenticación local de Tableau, crea una experiencia "libre de inicio de sesión" pero
autenticada para los usuarios finales. Para crear esta misma experiencia y usar
suscripciones, use Active Directory (con Activar inicio de sesión automático) como el
tipo de autenticación de usuario en su lugar+. El tipo de autenticación de usuario se
elige durante la Configuración. Consulte Configurar el servidor para conocer los
detalles.
Configuración de suscripción adicional
Mientras las suscripciones se configuren en la pestaña Alertas y suscripciones y Tableau
Server esté usando su configuración predeterminada, los usuarios del servidor pueden
suscribirse a las vistas y libros de trabajo que vean. Para evitar que los usuarios se suscriban o
personalicen su experiencia de suscripción, debe ir aquí:
l
l
Página Sitios: De manera predeterminada, se habilitan las suscripciones para cada
sitio, pero puede usar la página Sitios para deshabilitar las suscripciones en cada uno de
los sitios o para personalizar. Por ejemplo, puede ingresar una Dirección de ingreso
personalizada para suscripciones en lugar de la que especificó en el cuadro de diálogo
Configuración. También puede crear su propio pie de página para los correos
electrónicos de suscripción que reciben los usuarios.
Página Programas: Los usuarios necesitarán al menos un programa de suscripción
para poder elegir cuándo suscribirse. Tableau proporciona dos, de manera
predeterminada. Como administrador del sistema, puede crear programas adicionales
o eliminar los predeterminados. Consulte Crear o modificar un programa para conocer
los detalles.
l
Página Suscripciones: Esta página enumera todas las suscripciones del servidor o, si
es un administrador de sitio, del sitio. Los administradores de sistema pueden usar esta
página para cambiar el programa de suscripción de un usuario del servidor o eliminar su
suscripción. Consulte los temas a continuación para conocer los detalles.
Para conocer los pasos sobre cómo probar si ha configurado las suscripciones de manera
correcta, consulte Probar la configuración de suscripción. Si tiene problemas con las
suscripciones, consulte Solucionar problemas relacionados con las suscripciones.
Eliminar una suscripción
Para eliminar una suscripción, seleccione la que desea eliminar y haga clic en Eliminar:
Editar un programa de suscripción
Para cambiar el programa de una suscripción, selecciónela, haga clic en Editar programa y
seleccione un programa:
Probar la configuración de suscripción
Como administrador, puede probar si ha configurado de manera correcta las suscripciones de
la siguiente manera:
1. Suscribirse a una vista.
2. En la página Programas, seleccione el programa que contiene su suscripción.
3. Haga clic en Ejecutar ahora:
4. En algunos momentos, la suscripción aparecerá en su buzón de correo electrónico.
Solucionar problemas relacionados con las suscripciones
"La instantánea de la vista de este correo electrónico no se pudo renderizar correctamente".
Puede haber diversas razones para recibir una suscripción con este mensaje de error:
l
l
l
Falta de credenciales: Algunas vistas se publican con credenciales incrustadas. Es
posible que reciba el error indicado anteriormente si las credenciales incrustadas están
obsoletas o si la vista se volvió a publicar sin las credenciales incrustadas.
Base de datos temporalmente fuera de servicio: Si la vista tiene una conexión con
una base de datos de acceso en tiempo real y esa base de datos se encontraba fuera de
servicio cuando se generó la suscripción, es posible que aparezca el error anterior.
Límite de tiempo de espera de proceso en segundo plano: De manera
predeterminada, el proceso en segundo plano que controla suscripciones caduca
después de 30 minutos. En la mayoría de los casos, esto es tiempo suficiente. Sin
embargo, si el proceso en segundo plano está controlando un dashboard
extraordinariamente grande y complejo, es posible que no sea tiempo suficiente. Puede
revisar la vista de administrador de Tareas en segundo plano para ver si ese es el caso.
Para aumentar el umbral del límite de tiempo de espera, utilice la opción
subscriptions.timeout de tabadmin.
No es posible suscribirse
Si puede ver una vista en Tableau Server y tiene el icono de suscripción ( ) en la esquina
superior derecha, puede suscribirse a ella.
Para suscribirse a una vista, debe cumplir con dos requisitos: Debe configurar Tableau Server
correctamente (como se describe en Administrar suscripciones) y la vista a la cual desea
suscribirse debe tener credenciales incrustadas para su fuente de datos o no confiar en
absoluto en las credenciales. Algunos ejemplos incluyen un libro de trabajo que se conecta a
un extracto que no se actualiza o un libro de trabajo, cuyos datos están en un archivo que se
incluyó en el libro de trabajo en el momento de la publicación. La incrustación de credenciales
es un paso que ocurre en Tableau Desktop (consulte la Ayuda de Tableau Desktop para
obtener detalles).
Sin icono de suscripción
Puede ocurrir que se pueda ver una vista en Tableau Server, pero no suscribirse a ella. Esto
ocurre para las vistas con conexiones de base de datos de acceso en tiempo real, donde se
piden las credenciales de la base de datos la primera vez que hace clic en la vista. Una
suscripción incluye una vista (o libro de trabajo), datos y un programa. Para entregar la pieza
de datos, Tableau Server necesita credenciales de la base de datos incrustadas o datos que
no requieran credenciales. Cuando se trata de las conexiones de la base de datos de acceso
en tiempo real, Tableau Server no tiene las credenciales correspondientes, solo los usuarios
individuales. Esta es la razón por la cual solo puede suscribirse a vistas que no requieren
credenciales o las tienen incrustadas.
También podrá ver una vista pero no podrá suscribirse a ella (sin icono de suscripción) si
Tableau Server se configura para autenticación de confianza. Consulte Requisitos de
suscripción para obtener más información.
Recepción de suscripciones no válidas o que no funcionan
Si configuró suscripciones en instancias de pruebas o desarrollo de Tableau Server, además
de la instancia de producción, deshabilite las suscripciones de las instancias que no son de
producción. Mantener las suscripciones habilitadas en todas las instancias puede ocasionar
que los usuarios reciban suscripciones que parecen válidas, pero que no funcionan, o que
reciban suscripciones incluso si ya no están suscritos a la vista o el libro de trabajo.
Las suscripciones no llegan ("Error al enviar correo electrónico. No es posible enviar el comando al host
SMTP").
Puede ver el error de arriba en Windows Event Viewer si las suscripciones aparecen como
enviadas (según la vista de administración Tareas en segundo plano), las suscripciones no
llegan y el servidor SMTP usa sesiones cifradas (SSL). Las suscripciones son solo
compatibles para conexiones SMTP no encriptadas. La solución es usar un servidor SMTP no
encriptado.
Sitios
Use la página Sitios para crear sitios independientes para distintas organizaciones o grupos en
un sistema de un servidor. Los libros de trabajo, datos y listas de usuarios de cada sitios se
aíslan de los que pertenecen a otros sitios. Como administrador de sistema, solo usted puede
ver cada sitio y realizar acciones como crear sitios y realizar cambios en todo el sistema.
Consulte los temas a continuación para obtener más información:
Trabajar con sitios
Los temas a continuación describen aspectos del trabajo con múltiples sitios como qué tipo de
autenticación se usa, así como también, cosas que debe saber sobre licencias de usuarios y
funciones de administrador.
Credenciales de autenticación y de inicio de sesión
Todos los sitios de un servidor usan la misma cuenta Ejecutar servidor como y modo de
autenticación de usuario. Elija estas dos configuraciones al instalar Tableau Server. Consulte
General para obtener más información.
Los usuarios que pertenecen a más de un sitio en el mismo sistema de servidor usan las
mismas credenciales para cada sitio. Por ejemplo, si Jane Smith tiene el nombre de usuario
jsmith y una contraseña “MiContraseña” en el sitio A, ella usa las mismas credenciales en el
lado B. Cuando inicie sesión en Tableau Server, podrá elegir a qué sitio desea acceder.
El sitio predeterminado
Para ayudarle a lograr una transición sin problemas desde un sistema de servidor de un sitio o
sitios múltiples, Tableau Server se instala con un sitio denominado Predeterminado. Si ejecuta
en modo de un sitio, no es necesario usar explícitamente Predeterminado, ocurre de forma
automática. Sin embargo, si agrega uno o más sitios, Predeterminado se convierte en uno de
los sitios en que puede iniciar sesión cuando inicia sesión en Tableau Server. Predeterminado
difiera de sitio que agrega al sistema en las siguientes formas:
l
l
l
No se puede eliminar nunca, sin embargo, al igual que los sitios que agrega, se puede
cambiar su nombre.
Almacena las muestras y las conexiones de datos que se envían con Tableau Server.
La URL usada para Predeterminado ni tiene carpeta Web correspondiente llamada
“predeterminada”. Por ejemplo, la URL para una vista nombrada Ganancias en un sitio
llamado Ventas es http://localhost/t/sales/views/profits. La URL para
esta misma vista en el sitio Predeterminado sería
http://localhost/views/profits.
Las funciones de administrador de sitio y sistema
Hay dos tipos de administradores en Tableau Server, administradores de sistema y
administradores de sitio. Los administradores de sistema pueden controlar si los
administradores de sitio pueden agregar o eliminar usuarios en el cuadro de diálogo Agregar
sitio nuevo (o Editar sitio):
Si se selecciona Solo administradores de sistema, los administradores de sitio no podrán
agregar ni eliminar usuarios del sitio. Sin embargo, todavía pueden administrar grupos,
proyectos, libros de trabajo y conexiones de datos dentro de su sitio. Si se selecciona
Administradores de sistema y de sitio (predeterminado), los administradores de sitio
pueden realizar todas las acciones anteriores, incluso agregar o eliminar usuarios.
Licenciamiento y límites del usuario
Los usuarios pueden pertenecer a varios sitios, con distintos derechos de usuario y niveles de
licencia en cada sitio. Sin embargo, un usuario que pertenece a varios sitios no necesita una
licencia para cada sitio. Cada usuario de servidor solo necesita una licencia.
Los administradores de sistema pueden usar el ajuste Máximo de usuarios del sitio <n>
para especificar un límite de usuarios de un sitio. Solo se cuentan los usuarios con licencia; se
excluyen los administradores de sistema. Por ejemplo, si un sitio tiene 90 usuarios con licencia,
20 usuarios sin licencia y un administrador del sistema, el conteo de usuarios es 90. Si
Máximo de usuarios del sitio se establece en 100, se pueden agregar 10 usuarios con
licencia más.
Agregar o editar sitios
Si es administrador de sistema, puede agregar un sitio a Tableau Server o editar uno existente
de la siguiente forma:
1. Abra la página Sitios al hacer clic en Sitios bajo Administración, luego haga clic en
Agregar:
O bien, si va a editar un sitio, seleccione el sitio que desea cambiar y haga clic en Editar.
Si no ha agregado sitios a Tableau Server, habrá solo un solo sitio para seleccionar:
Predeterminado.
2. Ingrese un Nombre de sitio y una ID de sitio para el sitio (si desea editar el sitio
Predeterminado, no puede cambiar el ID de sitio):
La “t” en la URL (por ejemplo, http://localhost/t/wsales) no se puede cambiar. En los
sistemas de servidores de varios sitios, aparece en la dirección URL para los sitios
distintos al Sitio predeterminado.
3. Los libros de trabajo, extractos y fuentes de datos consumen espacio de
almacenamiento en el servidor. Seleccione Sin límite o Cuota, e ingrese el número de
GB que desea como límite. Si establece una cuota y el sitio la excede, los publicadores
no podrán cargar nuevo contenido hasta que el sitio esté bajo el límite nuevamente. Los
administradores de sitio pueden rastrear qué parte del sitio es relativa a su cuota
mediante las columnas Cuota de almacenamiento y % de cuota usado de la página
Sitios.
4. A continuación, seleccione si desea que solo usted, el administrador del sistema, pueda
agregar y quitar usuarios (Solo administradores de sistema) o si se puede realizar a
través de los dos tipos de administradores (Administradores de sistema y de
contenido).
Si permite que los administradores de sitio agreguen usuarios, especifique cuántos
usuarios pueden agregar al sitio seleccionando una de las siguientes opciones:
l
l
Capacidad del servidor: Para un servidor con licenciamiento basado en el
usuario, el límite es la cantidad de licencias por puesto de servidor disponible.
Para un servidor con licenciamiento basado en el núcleo, no hay límites para la
cantidad de usuarios que se pueden agregar.
Máximo de usuarios del sitio <n>: Permite a un administrador de sitio agregar
usuarios hasta un límite que especifique. Consulte Trabajo con sitios para
obtener información sobre el licenciamiento y los límites de usuarios.
5. Seleccione Permitir registro de rendimiento para permitir que los usuarios del sitio
recopilen métricas sobre cómo funcionan los libros de trabajo, como la velocidad con
que cargan, etc.
Además de tener esta casilla de verificación marcada para este sitio, para iniciar el
registro, los usuarios deben agregar un parámetro a la URL del libro de trabajo.
Consulte Crear un registro de rendimiento para obtener más información.
6. En la Configuración de suscripciones de sitio, mantenga seleccionada la opción
Habilitar suscripciones si desea que los usuarios del sitio puedan suscribirse a vistas.
Esta opción solo se encuentra disponible si también tiene configuraciones de
suscripciones definidas en el cuadro de diálogo Configuración.
También puede ingresar una Dirección de ingreso personalizada para las
suscripciones. Aunque la dirección que ingrese debe usar una sintaxis de dirección de
correo electrónico válida (como [email protected] o [email protected]sales), Tableau
Server no requiere que sea una cuenta de correo electrónico real (sin embargo, algunos
servidores SMTP pueden requerir que sea una dirección real).
7. En Pie de página de correo electrónico, seleccione Personalizado e ingrese
cualquier texto que desee que aparezca sobre la URL de Tableau Server en los pies de
página de la suscripción. Por ejemplo, si ingresa este texto:
El pie de página del correo electrónico se verá similar al siguiente:
8. Haga clic en Aceptar.
Si desea agregar el primer sitio a Tableau Server, la pestaña Administración cambia.
Usuarios es ahora Todos los usuarios, porque pertenece a todos los usuarios del servidor y
aparece la categoría Usuarios del sitio.
Agregar usuarios a un sitio
Una vez que agrega un sitio a Tableau Server, se convierte en un sistema de sitios múltiples y
lo que antiguamente era la página Usuarios se convierte en dos páginas: Todos los
usuarios y Usuarios del sitio. Como administrador del sistema, solo puede acceder a la
página Todos los usuarios, que se aplica al sistema del servidor completo. Es el único lugar
donde puede agregar todos los usuarios a varios sitios a la vez, quitar usuarios y, si el servidor
utiliza autenticación local, restablecer las contraseñas de los usuarios.
La página Usuarios del sitio es una forma fácil de ver rápidamente qué usuarios están en el
sitio al que está conectado actualmente. Puede agregar usuarios desde aquí, pero solo se
agregarán a ese sitio.
El siguiente procedimiento describe cómo agregar usuarios desde Todos los usuarios. Hay
dos enfoques que puede considerar:Uno a la vez (como se describe a continuación) o en lotes
usando el comando Importar, que depende de un archivo CSV (descrito en Importar usuarios
desde un archivo CSV).
Para agregar un usuario:
1. En la página Todos los usuarios, haga clic en el enlace Agregar en la parte superior
de la lista de usuarios.
2. Escriba un nombre de usuario:
l
l
Autenticación local: si el servidor utiliza autenticación local, el uso de una
dirección de correo electrónico para el nombre de usuario es la mejor forma de
evitar conflictos entre nombres de usuario (por ejemplo, [email protected] en
vez de jsmith).
Active Directory: si agrega un usuario que proviene del mismo dominio de
Active Directory que el servidor, puede escribir el Nombre de usuario sin el
dominio. El dominio del servidor se sobreentenderá.
Si se configuró una confianza bilateral entre el dominio del servidor y otro
dominio, puede agregar usuarios de ambos dominios. La primera vez que
agregue un usuario del “dominio diferente del servidor”, debe emplear el nombre
de dominio completamente calificado con el nombre de usuario. Los siguientes
usuarios se pueden agregar con el apodo del dominio. Por ejemplo, si tenemos
un “dominio diferente del servidor” llamado mybiz.lan, escriba el primer usuario de
este dominio [email protected] o mybiz.lan\user1. El siguiente usuario se
puede escribir con el apodo, por ejemplo como [email protected] o mybiz\user2.
Nota: Asegúrese de no escribir el Nombre completo del usuario en este
campo, ya que puede causar errores durante el proceso de importación.
3. Si el servidor está usando la autenticación local, proporcione lo siguiente:
l
Nombre completo: escriba un nombre completo para el usuario (por ejemplo,
John Smith).
l
Contraseña: escriba una contraseña para el usuario.
l
Confirmar: vuelva a escribir la contraseña.
4. Membresía de sitio: seleccione los sitios a los cuales debería pertenecer el usuario. El
sitio en el que inició sesión se selecciona de forma predeterminada.
5. Nivel de licencia y derechos de usuario: seleccione un nivel de licencia, función de
administrador y si el usuario puede publicar libros de trabajo y fuentes de datos. Un
usuario que pertenece a varios sitios puede tener niveles de licencias diferentes y
derechos de usuario. Consulte Sobre niveles de licencia, Permisos y Sobre derechos de
usuario para obtener más información.
6. Haga clic en Agregar usuario.
Eliminar sitios
Los administradores de sistema pueden eliminar sitios que se han agregado a Tableau Server.
La eliminación de un sitio también elimina los libros de trabajo y las fuentes de datos que se
publicaron en el sitio, además de los usuarios. Si un usuario pertenece a un sitio adicional, no
será eliminado. Para eliminar permanentemente un usuario, debe usar la página Todos los
usuarios.
Para eliminar un sitio:
1. Abra la página Sitios bajo Servidor:
2. Seleccione el sitio que desea eliminar y haga clic en Eliminar:
3. Haga clic en Sí en el cuadro de diálogo de confirmación que aparece.
Navegación en sitios múltiples
A continuación encontrará algunos consejos para navegar de un sitio a otro e identificar qué
sitio está usando.
Inicio de sesión del sitio
Si es miembro de sitios múltiples, al iniciar sesión en el servidor se le solicitará que elija un sitio:
Navegación a otros sitios
Si usted pertenece a varios sitios, verá un menú Sitio en la parte superior de la página:
Para iniciar sesión en otro sitio, haga clic en el menú Sitio y seleccione el sitio:
Identificación de su sitio
Si el servidor ejecuta varios sitios, pero usted solo pertenece a uno, no se le solicitará que elija
su sitio en el inicio de sesión de servidor. Después de iniciar sesión, no verá un menú Sitio en la
parte superior de la página:
Sin embargo, la URL del navegador Web mostrará una t seguida de la ID de sitio para su
sitio:
Si el servidor no está ejecutando varios sitios, la URL del navegador Web se verá similar a esto
(sin t, sin ID de sitio). Si ve esto, está usando el sitio incorporado de Tableau, que se llama
Predeterminado.
Mantenimiento de servidor
Como administrador de sistema, puede verificar el estado del servidor, analizar y supervisar la
actividad del servidor, administrar tareas programadas o realizar ciertas actividades de
mantenimiento como la reconstrucción del índice de búsqueda. Además, hay diversa
configuración que puede especificar para personalizar la experiencia de usuario para
personas que usan el servidor. Puede realizar todas estas tareas desde la página
Mantenimiento.
Ver el estado de los procesos del servidor
Puede usar la tabla Estado que se encuentra en la página Mantenimiento para ver el estado
de los procesos de Tableau en cada servidor Tableau:
Para obtener más información sobre estado no licenciado para un proceso de VizQL
Server, consulte Manipular un proceso de VizQL Server sin licencia.
Para mostrar una versión legible por máquina de la información anterior, desde la página
Mantenimiento, reemplace el estado de palabra en su URL con systeminfo (por ejemplo,
http://jsmith/admin/systeminfo). Se muestra una página Web similar a la siguiente:
Los tipos de estado para un servicio Tableau son Aceptar, Ocupado, Sin funcionamiento y En
espera.
Acceder a estado de forma remota
Como administrador de Tableau, solo puede ver las herramientas en la página Mantenimiento,
incluida la tabla Estado. Sin embargo, puede hacer que la versión legible por máquina de la
tabla Estado esté disponible para usuarios que no son administradores y computadores
distintas a la que alberga Tableau Server, por ejemplo, como parte de un proceso de
supervisión remoto. Para otorgar acceso remoto al estado de Tableau Service:
1. En la computadora que ejecuta Tableau Server primario, abra el archivo de
configuración de Tableau Server:
ProgramData\Tableau\Tableau Server\config\tabsvc.yml
2. Agregue la línea wgserver.systeminfo.allow_referrer_ips: <IP
address or name> to tabsvc. yml, donde <IP address or name> es la
dirección IPv4 o el nombre de la computadora que desea agregar. Si otorga acceso de
estado de servicio a múltiples computadores, use comas (no espacios) para separar
cada entrada. Por ejemplo:
3. Guarde y cierre tabsvc.yml.
4. Abra una línea de comando como administrador y escriba:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
5. Luego, use el siguiente comando para reiniciar los procesos de Tableau Server:
tabadmin restart
Ahora, los usuarios en cuyas direcciones IP o nombres de computadora se hayan
agregado a tabsvc.yml pueden ver el estado de proceso Tableau ingresando a la URL
http://<server>/admin/systeminfo en un navegador o desde una línea de
comando (por ejemplo, curl http://jsmith/admin/systeminfo). Esta
funcionalidad también se puede usar como parte de un proceso de supervisión remoto
automatizado.
Reconstruir el índice de búsqueda
Si por algún motivo el índice de búsqueda deja de arrojar resultados correctos o faltan
resultados, es posible que deba reconstruir el índice de búsqueda. Además, debe reconstruir
el índice de búsqueda si el generador de índices falla durante un periodo prolongado.
1. Para reconstruir el índice de búsqueda, en la pestaña Administrador, haga clic en
Mantenimiento:
2. Haga clic en Reconstruir índice de búsqueda para comenzar.
Borrar las contraseñas de conexión de datos guardadas
Como administrador, si habilita la configuración Contraseñas guardadas, los usuarios del
servidor pueden guardar contraseñas de fuentes de datos en diversas vistas y navegadores.
Puede restablecer todas las contraseñas de todos los usuarios de Tableau Server, lo cual los
obliga a iniciar sesión en las fuentes de datos la próxima vez que visiten una vista que requiera
autenticación en la base de datos. Los usuarios de servidor también pueden borrar sus
contraseñas de conexión de datos guardadas de manera individual a través de la página
Preferencias del usuario.
Para borrar las contraseñas de conexión de datos guardada de todos los usuarios del servidor:
1. Haga clic en el vínculo Mantenimiento de la sección Administración en el lado izquierdo
de la página:
2. Bajo Actividades, haga clic en Borrar todas las contraseñas de conexión de datos
guardadas para todos los usuarios.
Configuración de mantenimiento
La siguiente configuración está disponible en la sección Configuración de la página
Mantenimiento de servidor:
Configuración
Descripción
Credenciales
incrustadas
Permite que los publicadores incluyan contraseñas en los libros de
trabajo publicados para autenticar automáticamente a los usuarios
Web para que se conecten a las fuentes de datos. Las contraseñas se
fijan a libros de trabajo y solo son accesibles en el servidor. Es decir,
cuando se abre el libro de trabajo en Tableau Desktop, los usuarios
aun tendrían que ingresar un nombre de usuario y contraseña para
conectarse a la fuente de datos. Cuando esta configuración está
desactivada, todas las contraseñas incrustadas se guardan, pero no se
usan para autenticación. De esa forma si vuelve a activar la
configuración, los usuarios no deben volver a incrustar las
contraseñas.
Programación
Permite que los publicadores asignen libros de trabajo a programas.
Esta opción solo está disponible si se habilita Credenciales
incrustadas. Cuando esta configuración está habilitada, los
publicadores verán opciones de publicación en el cuadro de diálogo
Publicar.
Contraseñas
guardadas
Permite que los usuarios guarden contraseñas de fuentes de datos en
varias vistas y navegadores. De forma predeterminada, los usuarios
pueden elegir la opción “Recordar mi contraseña hasta que cierre
sesión”, la cual les permite guardar su contraseña durante una sesión
de navegador. Cuando la configuración se selecciona Contraseñas
guardadas un usuario puede elegir en su lugar la opción Recordar mi
contraseña, la cual guarda la contraseña en vistas y navegadores
múltiples de forma que los usuarios se autenticarán de forma
automática, independientemente de la computadora que usan. Usted,
como administrador, puede borrar todas las contraseñas guardadas en
cualquier momento. Además, los usuarios pueden borrar sus propias
contraseñas guardadas.
Permite que los usuarios vean e interactúen con vistas incrustadas sin
tener que iniciar sesión en una cuenta Tableau Server. Se puede
asignar permisos a la cuenta de usuario Invitado para controlar la
Habilitar invitado interactividad permitida para cada vista. Esta opción solo está
disponible si tiene una licencia de servidor basado en núcleos. Esta
opción se puede usar con Activar inicio de sesión automático, una
opción que puede seleccionar durante la Instalación.
Página de inicio
predeterminada
Lleva al usuario a la página de inicio predeterminada actual del servidor
para todos los usuarios. Consulte Configurar la página de inicio
predeterminada para todos los usuarios para conocer los pasos para
cambiarla. Usuarios individuales podrán sobrescribir esta
configuración (consulte Su página de preferencias del usuario para
conocer más detalles).
Controla el idioma que se usa para la interfaz de usuario del servidor y
el local que se usa para las vistas. Los usuarios individuales pueden
Idioma y local
anular esta configuración en la página Preferencias del usuario.
predeterminados Además, la configuración de navegador Web es el primer elemento
que se usa para determinar el idioma y local que se usan. Consulte
Idioma y local para obtener información.
Restablecer toda
la configuración Cualquier configuración del servidor que haya cambiado desde la
a sus valores
configuración regresa a su estado original.
predeterminados
Configurar la página de inicio predeterminada para todos los usuarios
De manera predeterminada, Tableau Server se instala con la página Vistas como página de
inicio predeterminada para todos los usuarios. Como administrador, puede cambiar esta
configuración para usar otra página a la cual todos los usuarios tengan acceso, como por
ejemplo, la página de libros de trabajo. Usuarios individuales podrán sobrescribir esta
configuración (consulte Su página de preferencias del usuario para conocer más detalles).
Para configurar la página de inicio predeterminada para todos los usuarios:
1. Navegue a la página que desea definir como página predeterminada.
2. Haga clic en su nombre en la esquina superior derecha de la página.
3. Seleccione Hacer que esta sea la página de inicio para todos los usuarios.
Tableau Server Monitor
Tableau Server Monitor se instala como parte de Tableau Server y se encuentra disponible a
través de la bandeja del sistema de Windows.
Al usar esta herramienta puede iniciar y detener el servidor, abrir Tableau Server y ver el
estado del servidor.
Abra el servidor
Este comando inicia Tableau Server en su navegador Web. Ésta es una forma sencilla para
acceder a la aplicación Web y las herramientas de mantenimiento asociadas.
Inicio/Detención del servidor
Puede iniciar y detener el servidor mediante estos comandos. Cuando detiene el servidor lo
deja no disponible para todos los usuario y termina cualquier sesión que está en progreso
actualmente. Si alguien publica un libro de trabajo cuando el servidor está detenido, el proceso
se abandona. Como resultado, solo algunas de las hojas de trabajo del libro de trabajo se
pueden publicar en el servidor. Debido a que la detención del servidor puede ser sumamente
perjudicial para los usuarios, asegúrese de advertirles antes de esta operación o plan de
mantenimiento durante horas no comerciales.
Reinicio del servidor
Este comando reinicia el servidor. Mientras el servidor lo reinicia, no estará disponible para
todos los usuarios. Asegúrese de advertir a sus usuarios sobre la suspensión del servicio
antes de esta operación. Deberá reiniciar el servidor si realiza cambios en la configuración de
Tableau Server.
Mostrar estado
Este comando abre información en pantalla que contiene el estado de cada proceso. Para
obtener un estado más detallado, use la página Mantenimiento.
Administrar claves de productos
Este comando abre el administrador de claves del producto donde puede agregar y eliminar
claves de producto.
Salir
Este comando cierra Tableau Server Monitor. No detiene Tableau Server. Puede volver a
abrir la aplicación al seleccionar Todos los programas > Tableau Server 8.1 > Tableau
Server Monitor en el menú Inicio de Windows.
Fuentes de datos
Una fuente de datos Tableau Server es una conexión reutilizable para datos. Puede incluir un
extracto de datos o información para una conexión de paso a una base de datos relacional de
acceso en tiempo real. También puede incluir una capa de personalizaciones, como cálculos,
grupos o conjuntos.Tableau Serverlos usuarios con los permisos adecuados pueden usar una
fuente de datos para crear un libro de trabajo de cero en el servidor. Consulte Crear un libro de
trabajo y una vista para obtener más detalles. Los administradores pueden realizar las
siguientes tareas en la página Fuentes de datos:
l
l
Edite y vea permisos de fuentes de datos: Use permisos para especificar qué
usuarios o grupos se pueden conectar a Fuentes de datos, modificarlas o descargarlas.
Consulte Configuración de permisos para una fuente de datos para obtener más
información.
Programar extractos de fuente de datos para actualización: Si una fuente de
datos incluye un extracto, puede asignar el extracto a un programa de actualización.
Consulte Programación de tareas para obtener más información.
Aunque las dos tareas anteriores puede realizarlas en Tableau Desktop, la persona que
publicó la fuente de datos, como administrador, también puede cambiar la configuración.
También puede usar la página Fuentes de datos para eliminar una fuente de datos o agregar
etiquetas a ella. Consulte los temas a continuación para obtener más información.
Administrar fuentes de datos
Para que los usuarios puedan trabajan con fuentes de datos de Tableau Server, deben tener
los permisos adecuados para la fuente de datos. Para las fuentes de datos que son
conexiones proxy, también debe tener en cuenta la forma en que los usuarios se autentican en
la base de datos, y si tiene los controladores adecuados instalados en Tableau Server. Para
obtener más información, consulte lo siguiente.
Configurar permisos para una fuente de datos
Controladores de bases de datos
Seguridad de datos
Acerca del Data Server de Tableau
El servidor de datos de Tableau es un componente de servidor que le permite administrar
centralmente y almacenar fuentes de datos de Tableau Server. Una fuente de datos es una
conexión reutilizable para datos. Los datos se pueden ubicar en el motor de datos de Tableau,
como extracto, o en una base de datos relacional (los cubos no son compatibles). En el
segundo caso, la información almacenada en la fuente de datos es para una conexión de
paso. La fuente de datos también puede incluir personalizaciones que ha realizado en campos
en Tableau Desktop, como cálculos, alias de dimensión, grupos o conjuntos.
Para los administradores, hay muchas ventajas en el uso de fuentes de datos de Tableau
Server. Debido a que un extracto de fuente de datos puede ser usado por muchos libros de
trabajo, ahorra en espacio de servidor y tiempo de procesamiento. Las actualizaciones de
extracto se pueden programar por extracto en lugar de por libro de trabajo, e incluso cuando
se descarga un libro de trabajo que usa una fuente de datos de Tableau Server, el extracto de
datos permanece en el servidor, provocando menos tráfico de red. Por último, si se requiere el
controlador de una base de datos para una conexión, solo debe instalar el controlador una vez,
en Tableau Server, en lugar de múltiples veces, en los escritorios de todos los usuarios.
Para usar el servidor de datos, lo que los autores deben hacer es conectarse a los datos en
Tableau Desktop, ya sea al crear un extracto o una conexión a una base de datos relacional de
conexión en tiempo real y publicarlos en Tableau Server. Luego de la publicación, estas
fuentes de datos reutilizables y el servidor contienen todo lo que los autores de libros de
trabajo requieren para conectarse rápidamente a los datos y comenzar la creación. Para
cambiar una fuente de datos publicada, la descarga a Tableau Desktop, hace los cambios,
luego la vuelve a publicar, sobreescribiendo la original. Tenga en cuenta que todos los
miembros nuevos que agregue a un parámetro o cualquier cambio que efectúe al orden de
ordenamiento predeterminado, no son parte de la fuente de datos (son parte del libro de
trabajo).
Si ejecuta una instalación distribuida de Tableau Server y espera uso intensivo de fuentes de
datos, hay varias formas en que puede optimizar la implementación del servidor. Consulte
Entornos distribuidos para obtener más información.
Usar fuentes de datos
Si es un autor de libro de trabajo, el uso de una fuente de datos de Tableau Server
simplemente es un asunto de conectarse desde Tableau Desktop. En la página Conectar a
datos en Tableau Desktop, haga clic en Tableau Server, luego proporcione las credenciales:
Después de iniciar sesión en Tableau Server, las fuentes de datos que tenga disponibles
aparecerán en la derecha. Para ver una fuente de datos, la persona que la publicó debió
configurar el permiso Conexión en Permitir para usted como usuario. De forma
predeterminada, todos los usuarios tienen este permiso.
Seleccione una fuente de datos y se cargará en la ventana de datos del libro de trabajo. Las
fuentes de datos de Tableau Servertienen un icono de Tableau en lugar de un icono de base
de datos:
Para obtener más información sobre la publicación de fuentes de datos desde Tableau
Desktop, consulte Publicar fuentes de datos en la ayuda en línea de Tableau Desktop.
Solucionar problemas de fuentes de datos
Para usuarios que trabajan con fuentes de datos de Tableau Server, se debe contra con hasta
tres elementos:
l
l
l
Permisos para la fuente de datos: Todas las personas que se conectan a una fuente
de datos deben tener permisos de Conexión y Vista para ella. Esto también se aplica a
usuarios que acceden a vistas que se conectan a fuentes de datos. Todas las personas
que publican y modifican fuentes de datos deben tener licencia de Publicación y también
tener permisos de Escritura/Guardar como y Descargar/Guardar en Web como.
Consulte Trabajar con permisos y Configurar permisos para una fuente de datos para
obtener más información.
Capacidad de autenticar la base de datos: Hay varias formas en que se puede
conectar a datos en Tableau y controlar quién tiene acceso a qué. Básicamente,
cualquier entidad que se conecta a la base de datos debe poder autenticarse. La
entidad podría ser Tableau Server realizando una actualización de extracción. Podría
ser un usuario de Tableau Desktop que se conecta a una fuente de datos que luego se
conecta a una fuente de datos en tiempo real. También podría ser un usuario de
Tableau Desktop que accede a una vista que se conecta a una fuente de datos en
tiempo real. Consulte Seguridad de datos para obtener más información sobre las
opciones.
Controladores de bases de datos: Si la persona que creó o publicó la fuente de
datos en Tableau Desktop debe instalar controladores de bases de datos adicionales,
es posible que deba instalarlos en Tableau Server. Si ejecuta una instalación distribuida
de Tableau Server donde, por ejemplo, el proceso de servidor de datos se ejecuta en el
servidor de un trabajador, cualquier controlador de base de datos requerido debe
instalarse también ahí en el servidor primario. Otros procesos también requieren
controladores,Consulte Controladores de bases de datos para obtener más
información.
Mensajes de error de fuente de datos
A continuación se indican algunos errores que autores de libros de trabajo y otros usuarios
pueden encontrar mientras trabajan con fuentes de datos y vistas:
Se denegó el permiso para acceder a esta fuente de datos de Tableau Server: La
conexión de la fuente de datos requiere permiso de Conexión. Consulte Trabajar con
permisos y Configurar permisos para una fuente de datos para obtener más información.
No se encontró la fuente de datos: Una persona que trabaja con una vista puede ver este
error si la fuente de datos se elimina de Tableau Server o si se debe actualizar su página
Conectar a datos. Para actualizar la página Conectar a datos en Tableau Desktop, haga clic
en el icono Actualizar:
No es posible conectar a esta fuente de datos de Tableau Server: Este error puede
aparecer si la información de conexión para la fuente de datos ha cambiado, por ejemplo,
como resultado del cambio de nombre del servidor de la base de datos. Observe la
información Conexión de datos para conocer la fuente de datos y confirme que tiene la
configuración correcta.
No es posible enumerar las fuentes de datos de Tableau Server: Este error puede
ocurrir si un usuario intenta acceder a fuentes de datos de Tableau Server y hay problemas de
conectividad entre Tableau Server y Tableau Desktop.
No es posible conectarse con una fuente de datos de cubo: Las conexiones a fuentes
de datos de cubo (como MSAS) no son compatibles. Los datos deben ser un extracto o una
conexión en tiempo real a una base de datos relacional.
Conexiones de datos
Todos los libros de trabajo que se publican en Tableau Server contienen una o más
conexiones. Estas conexiones se indican en la pestaña Administración en la página
Conexiones de datos:
La diferencia entre Conexiones de datos y Fuentes de datos
Las conexiones de datos son distintas de las fuentes de datos en cada conexión que está
asociada con un libro de trabajo individual y describe los atributos requeridos para la conexión
a una fuente de datos (por ejemplo, nombre de servidor, nombre de base de datos, etc.). Eso
significa que si tiene tres libros de trabajo que se conectan a la misma fuente de datos, aun
tendrá tres conexiones indicada en la página de conexiones.
Buscando las conexiones de datos
El área de búsqueda en la parte superior de la página Conexiones de datos ayuda a encontrar
conexiones por nombre de servidor de base de datos, nombre de usuario, puerto, tipo de
conexión general y por si las credenciales de base de datos están o no incrustadas. Para usar
esta área a fin de buscar una conexión, complete una o más áreas y haga clic en Buscar:
¿Qué conexiones puedo editar?
Puede editar la información de conexión para las conexiones de base de datos de acceso en
tiempo real y para extractos que necesiten actualización de Tableau Server. Por ejemplo, es
posible que tenga una gran cantidad de libros de trabajo que se conectan a una base de datos
en un servidor de base de datos específico. Si el nombre del servidor cambia, puede actualizar
todos los libros de trabajo simultáneamente de forma que hagan referencia al nombre del
servidor nuevo. Otro ejemplo es si un libro de trabajo se conecta a una base de datos mediante
un nombre de usuario y contraseña específicos. Puede actualizar rápidamente todos los libros
de trabajo para que usen un conjunto distinto de credenciales. Para obtener detalles sobre
cómo editar conexiones de datos, consulte el siguiente tema.
Editar conexiones de datos
Use la página Conexiones de datos para administrar la información de conexión para todos los
libros de trabajo publicados en el servidor o un sitio. Para modificar atributos de conexión:
1. Si ejecuta sitios múltiples en el servidor, inicie sesión en el sitio que tiene las conexiones
de datos que desea modificar.
Navegue a la página Conexiones de datos.
2. Use el cuadro de búsqueda en la parte superior de la lista de conexiones para encontrar
las conexiones que desea editar. Puede buscar por Servidor, Tipo de conexión,
Puerto del servidor, Nombre de usuario de la base de datos y si tiene
Contraseña incrustada.
Los valores que escribe en los campos Servidor y Nombre de usuario de base
de datos se tratan como expresiones regulares.
3. Seleccione las conexiones que desea modificar de la lista de resultados de búsqueda:
4. Escriba un valor nuevo para una o más de los atributos de conexión. Si una base de
datos o el controlador de una base de datos no le permite conectarse a través de una
dirección IP, el valor ingresado para Servidor debe ser el nombre de la base de datos.
Se actualizarán todos los atributos seleccionados bajo la columna ¿Cambiar? Si
selecciona la casilla de verificación ¿Cambiar? y deja el campo Nuevo valor en
blanco, el atributo se configurará en blanco también.
5. Haga clic en Enviar.
6. Actualice la página del servidor (presione F5) para que los cambios tengan efecto.
Supervisar progreso
Se abre un diálogo de supervisión automáticamente donde puede ver el progreso de los
cambios. Si cierra el cuadro de diálogo supervisión, las modificaciones se ejecutarán en
segundo plano hasta que finalicen. Tableau Server realizará tantos cambios como sea posible.
Cualquier falla será omitida, pero no impedirá la realización de otros cambios. Por ejemplo, si
intenta cambiar el nombre del servidor y agregar una contraseña a varias conexiones, los
nombres del servidor se cambiarán y las contraseñas en los libros de trabajo se cambiarán,
pero debido a que no puede agregar una contraseña a una fuente de datos, las contraseñas
para las fuentes de datos no se cambiarán.
Hay una vista administrativa que le permite revisar los detalles para tareas finalizadas y
pendientes. Consulte Tareas en segundo plano para obtener más información.
Personalizar el servidor
Puede personalizar la forma en que Tableau Server busca personalizarlo para su empresa o
grupo. Por ejemplo, puede cambiar el nombre que aparece en los consejos y mensajes en
pantalla y puede cambiar el logotipo que aparece en la mayorías de las páginas de servidor.
También puede personalizar la forma en que los usuarios pueden interactuar con el servidor.
Por ejemplo, puede permitir que publicadores de libros de trabajo incrusten sus credenciales
de fuentes de datos de forma que cuando las personas hacen clic en una vista publicada con
una conexión a una fuente de datos en tiempo real obtienen acceso inmediato a la vista y no
tienen que proporcionar las credenciales de su base de datos primero.
También puede controlar el idioma que se usa para la interfaz de usuario de servidor y qué
local se usa para vistas.
Consulte los siguientes temas para obtener más información sobre la personalización de
Tableau Server:
Cambiar el nombre o logotipo
Puede personalizar los siguientes aspectos del aspecto y la sensación de Tableau Server:
Cambiar el nombre
Puede personalizar el aspecto y sensación de Tableau Server al personalizar el nombre que
aparece en la descripción emergente y los mensajes. Por ejemplo, si cambia el nombre a
MyCo, el texto de la página de inicio de sesión del servidor muestra "Ingrese el nombre de
usuario y contraseña de MyCo para inciar sesión" y la descripción emergente para el icono de
navegación de inicio muestra MyCo Home en lugar de Tableau Server Home:
La información de copyright de la parte inferior de cada página del servidor seguirá mostrando
Tableau (por ejemplo, ©2013, Tableau Software, Incorporated y sus licenciantes. Todos los
derechos reservados.)
Para cambiar el nombre que aparece en la descripción emergente y los mensajes:
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Cambie el nombre al escribir lo siguiente:
tabadmin customize name "new_name"
En la línea anterior, reemplace "new_name" con el texto que desea que aparezca como
nombre del servidor. Ejemplo: tabadmin customize name "Company
Server"
3. Reinicie el servidor para que el cambio tenga efecto al escribir:
tabadmin restart
Cambiar el logotipo
Puede personalizar el aspecto y sensación de Tableau Server al personalizar el logotipo que
aparece en la página de inicio de sesión de Tableau Server y en la columna izquierda de las
páginas del servidor primario (como la página Proyectos, Libros de trabajo, Mantenimiento,
etc.). El tamaño de logotipo compatible es de hasta 160 x 160 píxeles y se implementa
mediante la ejecución del comando tabadmin customize logo. También puede
personalizar el logotipo pequeño que aparece en el extremo superior izquierdo para cada libro
de trabajo y vista. El tamaño de logotipo pequeño compatible es de hasta 32 x 32 píxeles y se
implementa mediante la ejecución del comando tabadmin customize smalllogo.
Si una imagen es superior a 160 x 160 píxeles (logotipo grande) o 32 x 32 píxeles (logotipo
pequeño), aparecerá recortada. El archivo de imagen debe estar en formato GIF, JPEG o
PNG. No es posible cambiar el logotipo Tableau que aparece en la pestaña del navegador
Web del servidor y a la izquierda de la dirección URL.
Para cambiar el logotipo:
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Cambie el logotipo escribiendo lo siguiente para un logotipo de “tamaño grande” (hasta
160 x 160 px, pero no inferior a 32 x 32 px):
tabadmin customize logo "C:\My Pictures\logo.png"
Si su logotipo es de 32 x 32 px o más pequeño, utilice el siguiente comando:
tabadmin customize smalllogo "C:\My Pictures\logo.png"
3. Reinicie el servidor para que el cambio tenga efecto al escribir:
tabadmin restart
Restaurar el nombre o logotipo predeterminado
Puede restaurar el aspecto y la sensación predeterminada de Tableau Server al realizar lo
siguiente:
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Cambie el logotipo al escribir lo siguiente:
tabadmin customize <parameter> -d
En la línea anterior, reemplace <parameter> con lo que desea restaurar, ya sea
name o logo.
3. Reinicie el servidor para que el cambio tenga efecto al escribir:
tabadmin restart
Idioma y local
Tableau Server está localizado en varios idiomas y tiene configuración de idioma y local que
puede establecer por usuario (consulte Su página de preferencias del usuario) y en todo el
sistema (consulte Configuración de mantenimiento). La configuración Idioma controla la
configuración de interfaz de usuario (UI) como menús y mensajes. La configuración Local
controla elementos en vistas como formato y moneda.
Configuración predeterminada
Tableau Server obtiene su configuración de idioma predeterminado durante la configuración.
Si la computadora host está configurada con un idioma compatible con Tableau Server, se
instala con dicho idioma. Si no es un idioma compatible, Tableau Server se instala en inglés.
Cómo se determinan el idioma y local
El navegador Web del usuario es otra influencia en el idioma y local que se muestran cuando
un usuario hace clic en una vista es el navegador Web del usuario. Si un servidor de usuario no
tiene una configuración de Idioma en su página de Cuenta de usuario, y su navegador Web
está configurado en un idioma compatible con Tableau Server, se usará el idioma del
navegador, aunque Tableau Server esté configurado en un idioma diferente.
Este es un ejemplo: Suponga que Tableau Server tiene una configuración en todo el sistema
de inglés como el Idioma para todos los usuarios. El servidor de usuario Claude no tiene un
idioma especificado en la página de cuenta de usuario de Tableau. El navegador de Claude
usa alemán (Alemania) para su idioma/local.
Cuando Claude inicia sesión en Tableau Server, la UI del servidor se muestra en alemán, y
cuando hace clic en Vista A, está usando la información local de Alemania para los números y
divisas. Si Claude configura el Idioma y Local de su cuenta de usuario en Francés (Francia),
la UI y la vista se mostrarían en francés. La configuración de su cuenta de usuario sustituye la
configuración del navegador Web y ambas tienen precedencia sobre la configuración de todo
el sistema de Tableau Server.
Otra configuración que debe considerar es la configuración Local de Tableau Desktop
(Archivo > Local de libro de trabajo). Esta configuración determina el local de los datos de
la vista, como la moneda que se indica y el formato que se da a los números. De forma
predeterminada, Local en Tableau Desktop está configurado en Automático. Sin embargo,
un autor puede anular esto al selecciona un local específico. Mediante el ejemplo anterior, si el
autor de Vista A configura Local en Griego (Grecia), ciertos aspectos de los datos en Vista A
se muestran en configuración local Griego (Grecia).
Aquí está la configuración que Tableau usa para determinar idioma y local, en el siguiente
orden de precedencia:
1. Local de libro de trabajo (configurado en Tableau Desktop)
2. Configuración de idioma/local de la cuenta de usuario de Tableau Server
3. Idioma/Local de navegador Web
4. Configuración de idioma/local de página Mantenimiento de Tableau Server
5. Configuración de idioma y local de la computadora host
Vistas administrativas
Tableau Server viene con varias vistas para administradores, con el fin de ayudar a supervisar
la actividad en Tableau Server. Las vistas administrativas se ubican en la tabla Análisis en la
página Mantenimiento:
Consulte lo siguiente para obtener más información:
Actividad del servidor
La vista administrativa Actividad del servidor proporciona una instantánea de la actividad
deTableau Server en los últimos 30 días.
En Total de vistas con el tiempo, puede situar el mouse sobre algún punto en la línea y ver
la descripción emergente que muestra cuántas vistas se abrieron ese día, junto con otra
información:
Haga clic en un punto de la línea para actualizar los gráficos de barras para mostrar qué libros
de trabajo se vieron ese día y quién estuvo haciendo la mayoría de las visualizaciones:
Seleccionar una marca en Total de vistas con el tiempo también filtra el patrón de
visualización total de 24 horas mostrando el patrón de visualización de un día en particular.
Si ninguna marca está seleccionada en Total de vistas con el tiempo, 24 horas totales de
patrón de visión suma los datos en Total de vistas con el tiempo y los muestra en un
período de 24 horas para que pueda ver los patrones típicos en el transcurso de un día:
Actividad de usuario
La vista Actividad de usuario puede ayudarle a medir la medida en que se usa la instalación de
Tableau Server y si es necesario comprar licencias adicionales. Específicamente, esta vista le
muestra quién tiene sesión iniciada en Tableau Server, desde dónde y cuándo interactuó por
última vez con el servidor.
Si un usuario tiene sesión iniciada desde múltiples navegadores, eso también se mostrará. Por
ejemplo, si un usuario inicia sesión una vez desde Internet Explorer y una vez desde Mozilla
Firefox, su nombre aparece dos veces. Si un usuario inicia sesión dos veces desde Mozilla
Firefox, su nombre aparece una vez.
Activo actualmente significa que el usuario interactuó con el servidor durante los últimos
cinco minutos. Activo recientemente indica que el usuario estuvo activo entre los últimos
cinco a quince minutos e Inactivo significa que no hubo actividad por parte del usuario durante
los últimos 15 minutos. De forma predeterminada, luego de cuatro horas de inactividad, se
cierra la sesión de usuario de Tableau Server. Puede cambiar esta configuración utilizando la
opción Opciones de tabadmin set de tabadmin.
En la vista Actividad de usuario detallada, los círculos indican una acción, como inicio de
sesión o el filtrado de una vista. Las barras abarcan el periodo total en el cual hubo actividad.
Para obtener más información, sitúese sobre un área y se muestra la descripción emergente:
Historial de rendimiento
Use Historial de rendimiento de vistas para ver qué vistas son las más costosas en términos de
rendimiento del servidor.
Hay dos solicitudes distintas asociadas con las vistas: Solicitudes de carga iniciales, en
naranjo, y solicitudes de cálculo, en azul. Las últimas son cualquier cosa que provoca que
Tableau Server vuelva a calcular lo que el usuario ve. Esto incluye solicitudes de recarga y
elementos de selección y filtro dentro de una vista. Las marcas de valores anómalos
representan solicitudes con el mayor impacto en el rendimiento del servidor:
Tareas en segundo plano
La vista Tareas en segundo plano muestra tareas que el servidor ejecuta. Las tareas más
comunes son las asociadas con acciones del usuario. Las tareas son seleccionadas de forma
predeterminada bajo Tipo de tarea:
Las tareas que pueden tener un estado de finalización exitosa, error, en proceso o pendiente:
Icono Descripción
Error: el servidor no pudo finalizar la tarea.
Éxito: el servidor finalizó la tarea.
En proceso: el servidor está realizando la tarea actualmente.
Pendiente: una tarea que el servidor aun no ha comenzado.
Para obtener detalles sobre una tarea, sitúese sobre su icono:
Tableau Server puede ejecutar múltiples procesos en segundo plano en paralelo. Las
direcciones IP bajo ID de componente de segundo plano en la vista Tareas en segundo
plano muestran las máquinas que están asignadas para ejecutar procesos en segundo plano:
Una máquina con núcleos múltiples que ejecuta más de un proceso en segundo plano se
indicará con <IP address>:0 para el primero proceso, <IP address>:1 para el
segundo y así sucesivamente.
Uso de espacio
La vista Uso de espacio puede ayudarle a identificar qué libros de trabajo y fuentes de datos
consumen el mayor espacio de disco en el servidor. El uso de espacio de disco se muestra por
usuario, por proyecto y por el tamaño del libro de trabajo o fuente de datos, y se redondea al
número más cercano:
Mueva el cursor sobre cualquier barra de tamaño para mostrar detalles de uso:
También puede obtener más detalles en los vínculos que se encuentran en la descripción
emergente. Por ejemplo, puede ir a los detalles de un usuario o ver el libro de trabajo.
Vistas personalizadas
Las personas que trabajan con vistas pueden usar la opción Recordar mis cambios para
guardar sus vistas personalizadas y los publicadores pueden permitir o evitar la compartición
de vistas personalizadas:
Las vista administrativa Vistas personalizadas indica todas las vistas en el servidor que se han
personalizado con Recordar mis cambios. Se puede usar como un indicador de la
popularidad o importancia de una vista:
Crear vistas administrativas personalizadas
Además de las vistas administrativas preincorporadas disponibles en la página Mantenimiento
del servidor, puede usar Tableau Desktop para consultar y crear sus propios análisis de
actividad de servidor. El depósito de Tableau Server tiene varias vistas de base de datos
configuradas que puede conectar y consultar. La opción de tabadmin auditing.enabled
controla si Tableau Server recopila actividad histórica del usuario y otra información en el
repositorio. Está habilitado de manera predeterminada. La opción de tabadmin
wgserver.audit_history_expiration_days controla la cantidad de días que el historial de
eventos se conserva en el repositorio. De manera predeterminada, esta opción está definida
en 183 días. Un elemento que se debe tomar en cuenta es que recopilar eventos históricos sí
tiene un impacto en el tamaño del archivo de respaldo de Tableau Server (.tsbak).
Para acceder a estas vistas primero debe usar la herramienta de línea de comando para
habilitar el acceso externo a la base de datos de Tableau Server. Luego, debe conectarse y
consultar la base de datos de Tableau Server.
Habilitación de acceso externo a la base de datos de Tableau Server
El repositorio de Tableau Server tiene varias vistas de base de datos configuradas a las que se
puede conectar y consultar como parte de la creación de sus propios análisis de actividad de
Tableau Server. Para acceder a estas vistas primero debe usar la utilidad de línea de
comando tabadmin para habilitar el acceso externo a la base de datos.
1. Abra una línea de comando como administrador y escriba:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. A continuación, use el siguiente comando para habilitar el acceso externo a la base de
datos para el usuario "tableau" con la contraseña que especifique.
tabadmin dbpass [password]
Sustituya la opción [password] con su propia contraseña. Por ejemplo:
tabadmin dbpass [email protected]!
3. Reinicie Tableau Server.
Después de habilitar el acceso externo a la base de datos, Tableau permite a cualquier
dirección IP acceder a la base de datos, siempre y cuando proporcione la contraseña correcta.
Siga los pasos en Conexión a la base de datos de Tableau Server para conectarse.
Para deshabilitar el acceso externo después, ejecute tabadmin dbpass --disable y
luego reinicie el servidor.
Conexión a la base de datos de Tableau Server
Después de habilitar el acceso externo a la base de datos de Tableau Server, siga los pasos a
continuación para conectarse a la base de datos y hacer consultas a ella.
1. En Tableau Desktop seleccione Datos > Conectar a datos, luego seleccione
PostgreSQL como la base de datos a la que desea conectarse. Es posible que deba
instalar los controladores de bases de datos PostgreSQL.Puede descargar los
controladores desde www.tableausoftware.com/drivers.
2. En el cuadro de diálogo Conexión PostgreSQL, escriba el nombre o URL para Tableau
Server. Si tiene una instalación de servidor distribuida y un trabajador alojada en el
repositorio, escriba el nombre del trabajador.
Debe conectarse mediante el puerto que ha configurado para pgsql.port, el cual es 8060
de forma predeterminada. Para obtener más información sobre los puertos, consulte
Puertos TCP/IP.
3. Escriba workgroup como la base de datos a la que desea conectarse.
4. Conéctese mediante el siguiente nombre de usuario y contraseña:
Nombre de usuario: tableau
Contraseña: La contraseña que especificó cuando habilitó el acceso a la base de datos
de Tableau Server.
5. Haga clic en Conectar.
6. Seleccione una o más tablas a las que conectarse. El usuario "tableau" tiene acceso a
todas las tablas que comienzan con un guión bajo y hist_. Por ejemplo, puede
conectarse a _background_tasks y _datasources. Las tablas que comienzan con
historical_ apuntan a las tablas hist_. Las tablas hist_ incluyen información acerca de
los usuarios de servidores que no está presente actualmente en la vista Actividad de
usuario.
7. Haga clic en Aceptar.
Seguridad
Hay cuatro componentes principales para la seguridad en Tableau Server:
Autenticación
La autenticación establece la identidad de un usuario. Esto se realiza para evitar el acceso no
autorizado a Tableau Server y permitir una experiencia de usuario personalizada. Tableau
Server admite cuatro tipos de autenticación:
l
l
l
l
Active Directory: Autentica usuarios de Tableau Server según sus credenciales de
Windows.
Autenticación local: Usa el mecanismo de autenticación interno proporcionado con
Tableau Server.
SAML: Usa un proveedor de identidad externo (IdP) para autenticar a los usuarios de
Tableau Server.
Autenticación de confianza: Manipula autenticación mediante una relación de
confianza entre Tableau Server y uno o más servidores Web.
Ya sea que Active Directory o autenticación local sea una opción que realice durante
Configuración de Tableau Server. Después de la configuración, no puede cambiar entre las
dos opciones. Para cambiar los tipos de autenticación, desinstale Tableau Server (se
conservarán los datos) y vuelva a ejecutar la instalación.
También puede elegir configurar SAML durante la instalación, sin embargo, no es la única
instancia en la que puede configurarlo. Cuando SAML maneja la autenticación de usuarios,
Active Directory o la autenticación local se convierten en lo que usa para manejar, no
autenticar, a sus usarios de Tableau Server. SAML se puede activar o desactivar sin
necesidad de desinstalar Tableau Server y volver a ejecutar la instalación.
Active Directory
Cuando Active Directory se usa para autenticación de usuario, Active Directory administra
todos los nombres de usuario y contraseñas. Cuando un usuario ingresa sus credenciales
para iniciar sesión en Tableau Server, Tableau las pasa al servidor de Active Directory. No
participa en el proceso de autenticación, aunque almacena nombre de usuario (pero no
contraseñas) en su repositorio.
Con autenticación de usuario de Active Directory, los administradores también pueden iniciar
sesión automáticamente a usuarios según sus credenciales Windows actuales (Habilitar inicio
de sesión automático). Esto significa que las credenciales del usuario se pasan de su
computadora local, pero no de otro sistema o portal al que puede haber iniciado sesión.
Por ejemplo, si un usuario inicia sesión en su computadora local como ‘MSmith’ y luego inicia
sesión en un portal SharePoint como ‘Mary’, las credenciales pasadas a serán para ‘MSmith’.
Para usar las credenciales del sitio SharePoint (‘Mary’) para inicio de sesión automático, el
portal SharePoint debe usar la Parte Web de Tableau con autenticación de confianza.
Los administradores pueden sincronizar grupos con Active Directory de forma manual o
programada, mediante tabcmd. Consulte Sincronizar un grupo de Active Directory y
syncgroup group-name en Comandos tabcmd para obtener más información.
Autenticación local
Cuando se usa autenticación local para autenticación de usuarios, Tableau Server administra
usuarios, grupos, contraseñas y todo el proceso de autenticación. Se puede importar
fácilmente las listas de usuarios a Tableau Server y la mayoría de las funciones de
administración de usuarios se pueden realizar de forma programada mediante tabcmd. Los
usuarios inician sesión manualmente al ingresar sus credenciales cuando se les solicitan o, al
acceder a contenido en un portal, mediante autenticación de confianza transparente.
SAML
Cuando se usa SAML para la autenticación de usuarios, un proveedor de identidad externo
(IdP) autentica a los usuarios de Tableau Server. Aún deberá usar Active Directory o la
autenticación local para administrar a sus usuarios de Tableau Server, agregarlos a Tableau
Server, etc., pero el IdP maneja la autenticación. Cuando los usuarios inician sesión en
Tableau Server usando SAML, el inicio de sesión que ven le pertenece al IdP, no a Tableau
Server. Consulte SAML para obtener información sobre cómo configurar SAML en su sitio.
Autenticación de confianza
Autenticación de confianza significa que ha configurado una relación de confianza entre
Tableau Server y uno o más servidores Web. Por ejemplo, puede hacer que su wiki
corporativo use autenticación de confianza para mostrar paneles de control a empleados que
ya han iniciado sesión en wiki, sin requerir otro inicio de sesión.
Cuando Tableau Server recibe solicitudes de un servidor Web de confianza, asume que el
servidor Web ya ha manipulado cualquier autenticación si es necesaria. Tableau Server recibe
la solicitud con un token o boleto reembolsable y le presenta al usuario una vista
personalizada, la cual considera la función y los permisos del usuario.
Consulte Autenticación de confianza para obtener información sobre cómo configurar la
autenticación de confianza en su sitio.
Autorización
La autorización es a lo que un usuario puede tener acceso y hacer después de que se haya
autenticado. En Tableau, la autorización se manipula de la siguiente forma:
l
l
Funciones y permisos: Defina capacidades específicas que los usuarios pueden
realizar o no en objetos determinados de Tableau. Una función es un conjunto de
permisos que los administradores pueden usar como están o personalizarlos. Consulte
Trabajar con permisos para conocer detalles.
Licenciamiento y derechos de usuario: Controle el conjunto máximo de permisos
que un usuario puede tener. Consulte Licencias y derechos de usuarioLicencias y
derechos de usuario y Permitir o denegar derechos de usuario.
Mientras los elementos anteriores controlan las acciones que un usuario puede realizar y en
qué, no controlan los datos que aparecen dentro de una vista. Los datos que un usuario ve se
controlan mediante opciones de seguridad de datos.
Permisos iniciales
Los permisos iniciales para un proyecto se copian desde el proyecto Predeterminado. Los
permisos iniciales para un libro de trabajo se copian desde los permisos para su proyecto. Los
permisos iniciales para una vista se copian desde los permisos de su libro de trabajo. Esta es
una copia de una vez de los permisos del padre. Los cambios a los permisos de padres no se
aplican automáticamente a los hijos a menos que los nuevos permisos se asignen activamente
al contenido.
Cualquier elemento puede tener permisos que difieren del padre. Por ejemplo, es posible que
un grupo no tenga permiso para ver un proyecto X, pero es posible que tenga permiso para ver
una vista que se publica en el proyecto X. Tableau Server no es compatible con permisos de
objetos jerárquicos; sin embargo, no proporciona un modelo de herencia para usuarios y
grupos. Si un usuario no tiene un permiso explícitamente configurado en Permitir o Denegar,
la configuración se heredará de los grupos a los que pertenece el usuario.
Permisos y el proyecto predeterminado
Si Tableau Server se implementa en un entorno abierto donde la compartición de
conocimiento e información es clave, entonces debe considerar la configuración de permisos
para que el proyecto predeterminado incluya el grupo Todos los usuarios, con su función
configurada en Interaccionador. Los usuarios podrán publicar automáticamente en nuevos
proyectos y consumir contenido de ellos.
Si Tableau Server se implementa en un entorno restrictivo donde la seguridad de datos y el
control de acceso es clave, entonces considere el vacío de permisos para el proyecto
predeterminado: Elimine los permisos para todos los usuarios y grupos. Se debe otorgar
permiso explícitamente a los usuarios y grupos para publicar y consumir contenido en
proyectos nuevos.
Seguridad de datos
Tableau proporciona varias formas para que controle qué usuarios pueden ver datos
determinados. Para fuentes de datos que se conectan a bases de datos en tiempo real,
también puede controlar si se solicita que los usuarios proporcione credenciales de bases de
datos cuando hacen clic en una vista publicada. Las siguientes tres opciones funcionan en
conjunto para lograr resultados distintos:
l
l
Cuenta de inicio de sesión de base de datos: Cuando crea una fuente de datos que
se conecta a una base de datos en tiempo real, elige entre la autenticación a la base de
datos a través de Windows NT o a través del mecanismo de seguridad incorporado de
la base de datos.
Modo de autenticación: Cuando publica una fuente de datos o un libro de trabajo con
una conexión de base de datos en vivo, puede elegir un Modo de autenticación. Los
modos que están disponibles dependen de lo que elige anteriormente.
l
Filtros de usuario: Puede definir filtros en un libro de trabajo o fuente de datos que
controlan los datos que una persona ve en una vista publicada, según su cuenta de
inicio de sesión de Tableau Server.
La tabla a continuación describe algunas dependencias con las opciones anteriores:
Opciones de conexión de
base de datos
La cuenta
de inicio
de sesión
de base
de datos
usa…
Seguridad
integrada
de
Windows
NT
(seguridad
de
Windows)
Preguntas de seguridad de datos
Modo de
autenticación
¿Es
posible la
seguridad
de bases
de datos
por
usuario de
Tableau
Server?
¿Los filtros
de usuario
son la única
forma de
restringir los
datos que
cada usuario
ve?
¿Se
comparten
las
memorias
caché de
Web entre
usuarios?
Cuenta Ejecutar
servidor como
No
Sí
Sí
Suplantar vía
cuenta Ejecutar
servidor como
Sí
No*
No
No
No
No
Sí
Sí
Sí
No*
No
Indicar usuario: Se
solicita la credencial
de base de datos a
los visores al hacer Sí
clic en una vista. Se
puede guardar las
credenciales.
Credenciales
incrustadas: El libro
de trabajo o el
Nombre de publicador de
usuario y
fuente de datos
contraseña pueden incrustar
sus credenciales.
Suplantar vía
contraseña
incrustada: Se
incrustan
Opciones de conexión de
base de datos
La cuenta
de inicio
de sesión
de base
de datos
usa…
Modo de
autenticación
Preguntas de seguridad de datos
¿Es
posible la
seguridad
de bases
de datos
por
usuario de
Tableau
Server?
¿Los filtros
de usuario
son la única
forma de
restringir los
datos que
cada usuario
ve?
¿Se
comparten
las
memorias
caché de
Web entre
usuarios?
credenciales de
bases de datos con
permisos
suplantados.
* Debido a que puede crear resultados inesperados, Tableau recomienda que no use este
modo de autenticación con filtros de usuarios.
Los filtros de usuario, la opción de credenciales incrustadas y los modos suplantados tienen
efectos similares; cuando los usuarios hacen clic en una vista, no se les solicita sus
credenciales de base de datos y ver solo los datos que les pertenecen. Sin embargo, los filtros
de usuario se aplican en el libro de trabajo por autores, y los modos de autenticación de
suplantación dependen de políticas de seguridad definidas por administrados en la base de
datos en sí misma.
Algunas de las opciones descritas anteriormente requieren pasos de configuración que deben
ocurrir durante la configuración de Tableau Server o antes de publicar un libro de trabajo o
fuente de datos. Consulte los siguientes temas para obtener más información:
l
Ejecutar como usuario
l
Suplantación de SQL Server
l
Credenciales incrustadas
l
Contraseñas guardadas
Seguridad de red
Hay tres interfaces de red principales en Tableau Server:
l
l
Cliente para Tableau Server: El cliente puede ser un navegador Web, Tableau
Desktop o la utilidad tabcmd.
Tableau Server para sus bases de datos: Para actualizar extractos de datos o
manipular conexiones de bases de datos en tiempo real, Tableau Server debe
comunicarse con sus bases de datos.
l
Comunicación de componentes de servidor: Esto se aplica a implementaciones
distribuidas solamente.
Cliente para Tableau Server
Un cliente de Tableau Desktop puede ser un navegador Web, Tableau Desktop o tabcmd. Las
comunicaciones entre Tableau Server y sus clientes usan solicitudes y respuestas HTTP
estándar. Tableau Server también se puede configurar para HTTPS (consulte SSL). Cuando
Tableau Server está configurado para SSL, todo el contenido y las comunicaciones entre
clientes están encriptadas y usan el protocolo HTTPS.
Las contraseñas se comunican desde navegadores y tabcmd a Tableau Server mediante
encriptación de claves públicas/privadas. Tableau Server envía una clave pública al
navegador, el cual usa la clave para encriptar la contraseña para transmisión. Cada
transmisión encriptada usa una clave una vez antes de que se descarte. Esto significa que las
contraseñas siempre son seguras independientemente del uso de SSL.
Tableau Server para su base de datos
Tableau Server realiza conexiones dinámicas a bases de datos para procesar conjuntos de
resultados y actualizar extractos. Usa controladores nativos para conectarse a bases de datos
cuando es posible y depende de un adaptador ODBC genérico cuando los controladores
nativos no están disponibles. Todas las comunicaciones a la base de datos se dirigen a través
de estos controladores. De tal forma, la configuración del controlador para comunicarse en
puertos no estándar o proporcionar encriptación de transporte es parte de la instalación de
controladores nativos. Este tipo de configuración es transparente para Tableau.
Comunicación de componentes de servidor
Hay dos aspectos para comunicación entre componentes de Tableau Server en una
instalación de servidores distribuidos. confianza y transmisión. Cada servidor en un clúster de
Tableau usa un modelo de confianza estricto para garantizar que recibe solicitudes válidas de
otros servidores del clúster. Las computadoras en el conjunto que ejecutan procesos de puerta
de enlace aceptan solicitudes de terceros (clientes), a menos que estén detrás de un
equilibrador de carga, en cuyo caso este recibe las solicitudes. Los servidores que no ejecutan
un proceso de puerta de enlace solo aceptan solicitudes de otros miembros de confianza del
conjunto. La confianza se establece por una lista de entrada al servidor de dirección IP, puerto
y protocolo. Si cualquiera de estos elementos no es válido, se ignora la solicitud. Todos los
miembros del clúster pueden comunicarse entre sí. Con la excepción de validación de
licencias y acceso al repositorio, transmisión de toda la comunicación interna se realiza
mediante HTTP.
Cuando las contraseñas se transmiten dentro del clúster, se usa una clave para encriptar las
contraseñas transmitidas entre los componentes de Tableau Server (por ejemplo, entre el
servidor de aplicación y los procesos de servidor VizQL). Cada transmisión encriptada usa una
clave una vez antes de que se descarte.
Rendimiento
Cada entorno de servidor es único y hay muchas variables que afectan el rendimiento. Las
variables incluyen detalles de hardware, como la velocidad del disco, la memoria y los núcleos;
la cantidad de servidores en la implementación; el tráfico de la red; los factores de uso, como la
complejidad del libro de trabajo, la actividad de usuarios concurrentes y el guardado en caché
de los datos; los valores de configuración de Tableau Server, como la cantidad de procesos
que está ejecutando en cada servidor; y las consideraciones de datos, como el volumen de
datos, el tipo de la base de datos y la configuración de la base de datos. Debido a esta
complejidad, no hay una fórmula única para mejorar el rendimiento del servidor, pero hay
algunas pautas básicas que puede seguir. Use los temas a continuación para obtener más
información:
Pautas de rendimiento general
Hardware y software
Use un sistema operativo de 64 bits y el producto de 64 bits: Aunque Tableau Server
se ejecuta bien en sistemas operativos Microsoft de 32 bits, para obtener el mejor rendimiento,
elija un sistema operativo de 64 bits e instale la versión de 64 bits de Tableau Server.
Agregar más núcleos y memoria: Independiente de si ejecuta el servidor Tableau Server
en una computadora o en varias, la regla general es que más núcleos de CPU y más RAM le
brindarán mejor rendimiento. Asegúrese de cumplir los requisitos de hardware y software de
Tableau Server y consulte Cuándo agregar trabajadores y reconfigurar para evaluar si debe
agregar máquinas adicionales. Si está ejecutando Tableau Server en un entorno virtual, utilice
las prácticas recomendadas de su VM para la asignación de vCPU en relación con la cantidad
de núcleos de CPU físicos del host de la VM.
Configuración
Programar actualizaciones para horarios de menor consumo: Las tareas de respaldo
tienden a detener otras Tareas de fondo hasta que el respaldo finaliza. Utilice la vista
administrativa Tareas en segundo plano para ver los programas de tareas de actualización y
respaldo. Sus tareas de actualización deben programarse en horas de menos congestión que
no se superpongan con el horario de respaldo.
Examinar el guardado en caché: El guardado en caché ayuda a Tableau Server a
responder a las solicitudes de clientes de manera rápida, en especial para las vistas que se
conectan con las bases de datos de acceso en tiempo real. Confirme que esté seleccionado
Actualizar menos frecuentemente en la pestaña Conexión de datos del cuadro de diálogo
Configuración.
Considere cambiar la configuración de memoria de dos sesiones:
l
Límite de tiempo de espera de sesión de VizQL: El límite predeterminado de
tiempo de espera de la sesión VizQL es 30 minutos. Aunque la sesión VizQL esté
inactiva, aún consume memoria y ciclos de CPU.Si lo puede hacer con un límite inferior,
l
use tabadmin para cambiar la configuración de
vizqlserver.session.expiry.timeout.
Borrar sesión VizQL: De forma predeterminada, las sesiones de VizQL se mantienen
en memoria incluso cuando un usuario navega lejos de una vista. Esto consume gran
parte de la memoria de la sesión. En lugar de esto, puede finalizar las sesiones cuando
los usuarios se alejen de una vista cambiando el valor de la vizqlserver.clear_
session_on_unload configuración a true (lo predeterminado es false).
Evaluar la configuración de proceso: Tableau Server se divide en seis componentes
diferentes llamados procesos del servidor. Mientras su configuración predeterminada se
diseñó para que funcione con un amplio rango de escenarios, puede reconfigurarlas para
lograr diferentes objetivos de rendimiento. Específicamente, puede controlar en qué
computadoras se ejecutan los procesos y cuántos se ejecutan. Consulte Mejorar el
rendimiento del servidor para ver las pautas para las implementaciones de uno, dos y tres
nodos.
Cuándo agregar trabajadores y reconfigurar
Tableau Server se puede ampliar y reducir a medida que sus necesidades y requisitos
evolucionan. Estas son algunas pautas para ayudarle a comprender si es tiempo de agregar
más nodos al sistema, volver a configurar el servidor o ambas opciones.
l
l
l
Más de 100 usuarios simultáneos: Si la implementación es para un uso intenso de
los usuarios (>100 visores simultáneos), es importante contar con suficientes procesos
VizQL, pero no tantos como para exceder la capacidad de hardware para manipularlos.
Además, la habilitación de la cuenta Usuario invitado de Tableau Server puede
aumentar el número de visores simultáneos potenciales más allá de la lista de usuarios
que cree que puede tener. La vista administrativa Actividad de usuario puede ayudarle a
evaluar esto. Para obtener consejos sobre cómo configurar o ampliar la
implementación, consulte Mejorar el rendimiento del servidor.
Uso intenso de extractos: Los extractos pueden consumir gran cantidad de memoria
y recursos de CPU.No existe una sola medida que califique a un sitio como uso intenso
de extractos. Tener unos cuantos extractos extremadamente grandes podría poner al
sitio en esta categoría, del mismo modo que lo haría tener muchos extractos pequeños.
Los sitios con uso intenso de extractos se benefician al aislar los procesos del motor de
datos en su propia máquina. Consulte Mejorar el rendimiento del servidor para obtener
pautas.
Actualizaciones de extractos frecuentes: la actualización de un extracto es una
tarea intensa para la CPU.Los sitios donde se actualizan frecuentemente los extractos
(por ejemplo, varias veces al día) a menudo se ven beneficiados con un mayor énfasis
en el proceso en segundo plano, lo que manipula las tareas de actualización. Use la
vista administrativa Tareas en segundo plano para ver la tasa de actualización actual,
luego consulte Mejorar el rendimiento del servidor para obtener detalles sobre cómo
ampliar.
l
l
Solución de problemas de rendimiento: Si las vistas demoran en cargarse o el
rendimiento del servidor es generalmente lento, podría deberse a diversas causas.
Consulte Pautas de rendimiento general y Mejorar el rendimiento del servidor.
Potencial de desconexión: Si su sistema de servidores se considera esencial y
requiere un alto nivel de disponibilidad, puede configurarlo para que exista una
redundancia para los procesos de servidor que manejan los extractos, el repositorio y la
puerta de enlace. Consulte Alta disponibilidad para obtener detalles.
Mejorar el rendimiento del servidor
Use los siguientes temas para orientarse sobre cómo mejorar el rendimiento de las
implementaciones que hacen uso intensivo de los extractos, de los usuarios o de ambos:
¿Cuál es su objetivo?
Cuántos procesos ejecutar
Dónde configurar los procesos
Optimización de los extractos y los libros de trabajo
Ejemplo de una
máquina:Extractos
Ejemplo de dos
máquinas:Extractos
Ejemplo de dos
máquinas:
Visualización
Ejemplo de tres
máquinas:
Extractos y
visualización
Evaluación de la capacidad de respuesta de la vista
¿Cuál es su objetivo?
Optimización de los extractos
El proceso del motor de datos almacena los extractos y responde las consultas; el proceso en
segundo plano actualiza los extractos. Dado que ambos exigen recursos de CPU, el mejor
enfoque para mejorar el rendimiento de una implementación de uso intensivo de extractos es
aislar estos dos procesos uno del otro y de los otros procesos del servidor. Esto puede requerir
tres máquinas. Si no tiene tres máquinas para trabajar, aún hay estrategias que puede usar
(consulte los ejemplos de implementación a continuación).
Optimización de los usuarios y la visualización
El proceso de VizQL Server manipula la carga y el renderizado de vistas para los usuarios de
Tableau Server. Si intenta optimizar su implementación para un número mayor de usuarios y
mucha interacción de vista, este el proceso en que se debe enfocar.
Cuántos procesos ejecutar
Este tema supone que está ejecutando la versión de 64 bits de Tableau Server en un sistema
operativo de 64 bits. En esta situación dos instancias de cada proceso deberían satisfacer sus
necesidades. Si su máquina solo cumple los requisitos mínimos de RAM para Tableau Server,
que son de 8 GB, su límite debe ser una instancia de cada proceso.
Proceso en segundo plano
Un proceso en segundo plano único puede consumir el 100 % del núcleo de una sola CPU, y
en ocasiones más para algunas tareas. En consecuencia, el número total de instancias que
debe ejecutar depende de los núcleos disponibles de la máquina, así como de lo que intenta
mejorar. Los siguientes ejemplos de implementación usan N para representar el número total
de núcleos de la máquina y cada uno sugiere una estrategia diferente cuando se trata del
proceso en segundo plano. Si tiene dudas, comience con el extremo inferior del rango
sugerido y evalúe el rendimiento antes de aumentar el número.
Procesos del motor de datos y repositorio
Hay escenarios donde el proceso del motor de datos se debe aislar en su propio nodo, como si
intentara mejorar una implementación de uso intensivo de extractos y quisiera enfatizar las
consultas más que las actualizaciones de extractos. Los ejemplos de implementaciones
proporcionan detalles específicos. Dado que el motor de datos almacena datos en tiempo real,
su transferencia es un procedimiento de varias fases. Trasladar los procesos del motor de
datos y de repositorio describe cómo hacerlo.
Otro motivo para aislar el motor de datos (y/o el repositorio) es minimizar el potencial de
implementación para el tiempo de inactividad. Consulte Alta disponibilidad para conocer
detalles. A menos que lo configure para alta disponibilidad, el repositorio normalmente puede
permanecer en Tableau Server.
Dónde configurar los procesos
Puede configurar el tipo y el número de procesos en cualquier máquina que ejecute usando el
cuadro de diálogo Configuración de Tableau Server. Si agrega nuevas máquinas como parte
de su reconfiguración, ya deben tener el software de Tableau Worker en ellas. Consulte
Instalar y configurar los servidores de trabajador para conocer los pasos.
Si intenta reconfigurar los procesos en su Tableau Server primario o independiente, consulte
Reconfigurar procesos.
Optimización de los extractos y los libros de trabajo
El rendimiento más rápido del servidor con los extractos es en parte una función de los
extractos y los libros de trabajo. Los autores de los libros de trabajo pueden ayudar a mejorar
el rendimiento del servidor al mantener el conjunto de datos del extracto breve mediante
filtrado o agregación, y acotado, al ocultar los campos que no se usan. Use las opciones de
Tableau Desktop Ocultar todos los campos sin usar y Agregar datos para
dimensiones visibles para esto. Para conocer los pasos, consulte Creación de un extracto
(ayuda de Tableau Desktop). Para obtener consejos generales sobre cómo crear libros de
trabajo que tengan un buen rendimiento, busque “rendimiento” en la ayuda de Tableau
Desktop. Para ver el rendimiento de los libros de trabajo una vez que ya se han publicado en
Tableau Server, puede crear un registro de rendimiento. Consulte Crear un registro de
rendimiento para conocer más detalles.
Evaluación de la capacidad de respuesta de la vista
Cuando un usuario abre una vista, los componentes de la vista primero se recuperan y se
interpretan y luego, aparecen en el navegador Web del usuario. En el caso de la mayoría de
las vistas, la fase de renderización de la visualización se lleva a cabo en el navegador Web del
usuario y en la mayoría de los casos, esto produce resultados más rápidos y el nivel más alto
de respuesta interactiva. Manejar la mayor parte de las interacciones en el navegador Web del
cliente reduce el consumo de ancho de banda y elimina las latencias de las solicitudes de ida y
vuelta. Si una vista es muy compleja, Tableau Server maneja la fase de renderización en el
servidor en lugar de hacerlo en el navegador Web del cliente, porque generalmente eso
produce un mejor rendimiento. Si le parece que las vistas no responden como lo desea, puede
probar a cambiar el umbral que hace que las vistas se rendericen en el servidor en lugar del
navegador Web del cliente. Consulte Acerca de la renderización del lado del cliente para
obtener más información.
Ejemplo de una máquina:Extractos
Una instalación de Tableau Server con uso intenso de extractos se puede ejecutar en una sola
máquina de 64 bits configurada de la siguiente manera:
La configuración anterior luciría del siguiente modo en la página de Mantenimiento de Tableau
Server:
Notas de configuración:
l
l
l
l
Ejecute dos procesos de VizQL Server.
Calcule el número menor de procesos en segundo plano para ejecutar al tomar el
número total de núcleos de la máquina y dividir por 4. Para determinar el número
máximo, divida por 2.
Tanto los procesos en segundo plano como los del motor de datos hacen uso intenso de
la CPU y la configuración anterior los equilibra.
La programación de las actualizaciones de extractos fuera de los horarios de mayor
consumo ayuda a los procesos del motor de datos y en segundo plano a no competir
entre sí por recursos del sistema.
Ejemplo de dos máquinas: Extractos
Esta es la manera en que puede configurar una implementación de Tableau Server en dos
máquinas, de manera que puede manipular el uso de extractos de uso intenso. Lo más
importante de advertir en este ejemplo es que el proceso del motor de datos se aísla de los
procesos en segundo plano.
Con la configuración anterior, la tabla Estado en la página Mantenimiento luciría así:
Notas de configuración:
l
l
l
Una vez que pasa de una implementación de una a dos máquinas, el primer servidor
pasa a ser el Tableau Server primario. En la tabla Estado, se obtiene un valor de Puerta
de enlace.
Ejecute dos procesos de VizQL Server en cada máquina.
Para averiguar el número mínimo de procesos en segundo plano para ejecutar en el
Tableau Server primario, tome el número total de núcleos de la máquina y divídalo por
4. Para obtener el número mínimo, divida por 2.
l
Mover el motor de datos desde el Tableau Server primario al Worker es un
procedimiento de varias fases. Consulte Trasladar los procesos del motor de datos y de
repositorio para conocer pasos.
Ejemplo de dos máquinas: Visualización
Una implementación de dos máquinas con uso ligero de extractos y uso intenso de
visualizaciones se puede configurar del siguiente modo:
La tabla Estado para la configuración anterior se vería así:
Notas de configuración:
l
l
Ejecute dos procesos de VizQL Server en cada máquina.
Se debe ejecutar un mínimo de 2 procesos en segundo plano en el Tableau Server
primario. El número máximo debe ejecutar su equivalente al número total de núcleos de
la máquina.
l
l
l
En una implementación donde los extractos se actualizan con poca frecuencia, los
procesos de motor de datos y en segundo plano pueden estar en la misma máquina que
los otros procesos.
Si los trabajos de actualización de extractos se ejecutarán fuera el horario de mayor
consumo, muchos procesos en segundo plano se pueden poner en cada máquina para
maximizar su paralelismo.
La cantidad de máquinas en el conjunto se determina únicamente por el número total de
núcleos y memoria principal disponible.
Ejemplo de tres máquinas:Extractos y visualización
La configuración de tres máquinas es el número mínimo recomendado de máquinas para
lograr el mejor rendimiento si tiene una cantidad igual de actualización y uso de extractos, y un
alto número de usuarios concurrentes.
Esta es la tabla Estado para la configuración anterior:
Notas de configuración:
l
l
l
l
l
Ejecute dos procesos de VizQL Server.
Los procesos en segundo plano están en su propia máquina, de manera que su trabajo
no compite con aquellos de otros procesos. Dado la que la máquina se dedica a los
procesos en segundo plano y puede consumir el 100 % de los recursos de CPU, el
extremo inferior del rango sugerido equivale al número total de núcleos. Según el
tamaño de los datos que se actualizarán, es posible que algunas implementaciones
ejecuten hasta dos veces los procesos en segundo plano que los núcleos y aún
obtengan aceleramiento paralelo.
Dado que los procesos del motor de datos pueden consumir todos los recursos de CPU
de una máquina, se aísla en su propia máquina.
Las cargas del usuario para los procesos del servidor de aplicaciones y del servidor de
datos normalmente se pueden manipular mediante 1 proceso cada uno, pero se
configuran en 2 para brindar redundancia.
Bajo la mayor parte de las condiciones, el Tableau Server primario y el motor de datos
no serán un atasco para el rendimiento general del sistema, siempre que existan
suficientes ciclos de CPU para ellos. Para aumentar la capacidad de visualización,
agregue máquinas dedicadas a los procesos de VizQL Server. Para aumentar la
capacidad de actualización de los extractos, agregue máquinas dedicadas al proceso en
segundo plano.
Acerca de la renderización del lado del cliente
Antes de mostrar los datos y las marcas de una vista en el navegador Web de un cliente, estos
se recuperan, se interpretan y se renderizan. Tableau Server puede realizar este proceso en
el navegador Web del cliente o en el servidor. La renderización del lado del cliente es el modo
predeterminado ya que manipular la renderización y toda la interacción en el servidor puede
dar como resultado más demoras en la transferencia y transmisión de datos en la red. Con la
renderización del lado del cliente, la mayoría de las interacciones de la vista son más rápidas,
ya que se interpretan y se renderizan ahí mismo en el cliente.
Algunas vistas, sin embargo, se renderizan de forma más eficiente en el servidor, donde las
computadoras son más potentes. La renderización del lado del servidor es útil cuando una
vista es compleja hasta el punto en que los archivos de imagen ocupan considerablemente
menos ancho de banda que los datos utilizados para crear las imágenes. Además, ya que las
tablets normalmente tienen un rendimiento muy inferior al de las PC, pueden manipular vistas
de menor complejidad. Existen casos donde una vista abierta en el navegador Web de una PC
puede ser renderizada por el cliente, pero si la misma vista se abre en el navegador Web de
una tablet, es renderizada por el servidor.
Tableau Server está configurado para manejar automáticamente todas estas situaciones
utilizando El cálculo del umbral como desencadenante para renderizar una vista en el servidor
en lugar del navegador Web. Como administrador, puede probar o adaptar esta configuración
para computadoras y tablets. Consulte los temas a continuación para obtener más
información.
Requisitos
l
l
Navegadores compatibles: La renderización del lado del cliente es compatible con
Internet Explorer versión 9.0 o superior, Firefox, Chrome y Safari. Todos estos
navegadores Web incluyen el elemento HTML 5 <canvas>, que utiliza la renderización
del lado del cliente.
Polígonos, formas personalizadas y función de historial de páginas: Si una vista
utiliza polígonos, formas personalizadas o la función de historial de páginas, se realiza la
renderización en el lado del servidor, incluso si está habilitada la renderización en el lado
del cliente.
El cálculo del umbral
Cuando la renderización del lado del cliente está habilitada, Tableau Server utiliza un cálculo
para determinar la complejidad de la vista. Si el valor de complejidad excede 100 (para
navegadores de PC) o 20 (para navegadores de tablet), la vista se renderiza en el servidor en
lugar del navegador Web. Este es el cálculo:
(# of marks) + 3(# of headers) + 3(# of annotations) + 3(# of
reference lines) = view complexity
Por ejemplo, si tiene una vista con 2.000 marcas, 150 encabezados (algunas veces, puede
determinar esto si suma el número de filas y columnas de un vista), 1 anotación y 1 línea de
referencia, la ecuación sería:
2,000 + 3(150) + 3(1) + 3(1) = 2,456
Ahora, tome el valor del umbral actual y divídalo por 100, luego multiplíquelo por 5.000 (dividir
el umbral por 100 es una normalización y multiplicarlo por 5.000 es un factor de escala de
Tableau). Al asumir un valor de umbral actual de 100, la ecuación sería la siguiente:
100/100 * 5,000 = 5,000
Compare las dos sumas. Sabiendo que 5.000 representa una complejidad de 100, puede ver
que 2.456 representa casi la mitad de la complejidad (49). Por lo tanto, para forzar la
renderización del lado del servidor para esta vista en particular en un navegador Web, debe
definir ese umbral en 48. Tenga en cuenta que interacciones como el filtrado pueden cambiar
la complejidad de la vista y una sesión puede cambiar los modos de renderización siempre que
la complejidad de la vista cambie.
Consulte los temas a continuación para obtener detalles sobre cómo probar y configurar la
renderización del lado del cliente.
Prueba con el parámetro de URL
Tableau Server está configurado para realizar la renderización del lado del cliente de forma
predeterminada, siempre que se cumplan los requisitos. Para probar la renderización del lado
del servidor por sesión, escriba ?:render=false al final de la URL de la vista. Por ejemplo:
http://localhost/views/Supplies/MyView?:render=false
Si la renderización del lado del cliente está deshabilitada en Tableau Server, ingrese
?:render=true para habilitarla para la sesión:
http://localhost/views/Supplies/MyView?:render=true
También puede probar umbrales de complejidad determinados en vistas individuales para ver
si es adecuado ajustar el umbral en todo el servidor para su servidor y las condiciones de la
red. Por ejemplo, puede encontrar que puntos clave de complejidad menor (como 80) o
complejidad mayor (como 120) producen una mayor capacidad de respuesta en las
interacciones de usuario. Para probar un umbral, puede guardar la configuración
predeterminada del servidor (renderización del lado del cliente habilitada) e ingresar el número
de umbral de prueba al final de la URL de la vista. Por ejemplo:
http://localhost/views/Supplies/MyView?:render=80
Usar las Opciones de tabadmin set
Puede utilizar las opciones de tabadmin vizqlserver.browser.render para habilitar o
deshabilitar la renderización del lado del cliente vizqlserver.browser.render_
threshold y vizqlserver.browser.render_threshold_mobile para cambiar los
umbrales de la renderización del lado del cliente. Consulte Opciones de tabadmin set para
conocer más detalles.
Los procesos de Tableau Server
Hay seis procesos de Tableau Server cuya configuración predeterminada puede cambiar para
lograr resultados diferentes. Los temas Mejorar el rendimiento del servidor y Alta
disponibilidad describen algunos de los enfoques que puede tomar. El estado de alto nivel de
cada proceso se muestra en la página Mantenimiento del servidor y puede encontrar más
información detallada relacionada con algunos de los procesos, como el proceso en segundo
plano, en Vistas administrativas. En términos de arquitectura, la versión de 64 bits de Tableau
Server usa procesos nativos de 64 bits; la versión de 32 bits de Tableau Server usa procesos
de 32 bits. La excepción es el motor de datos. Si la versión de 32 bits de Tableau Server está
instalada en un sistema operativo de 64 bits, se utilizará la versión del proceso de motor de
datos de 64 bits.
Nombre de
archivo
servidor de wgserver.exe
aplicación
Proceso
Propósito
Manipula la
aplicación Web,
admite la
¿Varios Características de
hilos?
rendimiento
Sí
Solo consume recursos
evidentes durante
Proceso
segundo
plano
motor de
datos
Nombre de
archivo
¿Varios Características de
hilos?
rendimiento
navegación y la
operaciones poco
búsqueda
frecuentes como
publicar un libro de
trabajo con un extracto o
generar una imagen
estática de una vista. Su
carga se puede crear
con la interacción
basada en el navegador
y con tabcmd.
backgrounder.exe Ejecuta tareas de No
Un proceso de un solo
servidor, incluidas
hilo donde se pueden
actualizaciones de
ejecutar múltiples
extracto, tareas
procesos en una o todas
‘Ejecutar ahora’ y
las máquinas del clúster
tareas iniciadas
para expandir la
desde tabcmd
capacidad. Por lo
general, el componente
de segundo plano no
consume mucha
memoria del proceso,
pero puede consumir
recursos de CPU, E/S o
red según la naturaleza
de la carga de trabajo
que se le presente. Por
ejemplo, al realizar
actualizaciones de
extractos grandes,
puede usar el ancho de
banda de la red para
recuperar datos. La
recuperación de datos o
las tareas tabcmd
complejas pueden
consumir recursos de
CPU.
tdeserver64.exe Almacena
Sí
La carga de trabajo del
extractos de datos
motor de datos se
tdeserver.exe
y responde
genera mediante
consultas
solicitudes del proceso
Propósito
Proceso
Nombre de
archivo
servidor de dataserver.exe
datos
¿Varios Características de
hilos?
rendimiento
de VizQL Server. Es el
componente que carga
extractos en la memoria
y realiza consultas en
ellos. El consumo de
memoria se basa
principalmente en el
tamaño de los extractos
de datos que se cargan.
El código binario de 64
bits se usa como el valor
predeterminado en
sistemas operativos de
64 bits, incluso si
Tableau Server de 32
bits se encuentra
instalado. El motor de
datos tiene varios hilos
para manipular
solicitudes múltiples en
un momento. Bajo una
carga alta puede
consumir recursos de
CPU, E/S y red, todos
los que pueden ser un
atasco de rendimiento
bajo carga. A carga alta,
una instancia simple del
motor de datos puede
consumir todos los
recursos de CPU para
procesar las solicitudes.
Manipula
Sí
Dado que es un proxy,
conexiones en las
normalmente solo se
fuentes de datos
une por la red, pero se
de Tableau
puede unir por la CPU
Server
con sesiones de usuario
simultáneas suficientes.
Su carga se genera
mediante la interacción
basada en navegador y
en Tableau Desktop y
Propósito
Proceso
Nombre de
archivo
repositorio
postgres.exe
VizQL
Server
vizqlserver.exe
¿Varios Características de
hilos?
rendimiento
extrae los trabajos de
actualización para las
fuentes de datos de
Tableau Server.
La base de datos Normalmente consume
de Tableau server
pocos recursos. Se
almacena libros
puede transformar en un
de trabajo y
atasco en casos
metadatos de
excepcionales para
usuario
implementaciones muy
grandes (miles de
usuarios) mientras
realiza operaciones
como ver todos los libros
de trabajo por usuario o
cambiar los permisos.
Carga y renderiza Sí
Consume recursos
vistas, calcula y
evidentes durante la
ejecuta consultas
carga de la vista y el uso
interactivo de un
navegador Web. Se
puede unir a CPU, E/S o
la red. La carga del
proceso solo se puede
crear con la interacción
basada en el navegador.
Se puede acabar la
memoria.
Propósito
Crear un registro de rendimiento
Con la función Registro de rendimiento en Tableau, puede registrar la información de
rendimiento de eventos clave a medida que interactúa con los libros de trabajo. Luego puede
ver las métricas de rendimiento en un libro de trabajo de rendimiento que Tableau crea
automáticamente. Los pasos que siga para crear y ver el registro de rendimiento varían entre
Tableau Desktop y Tableau Server. Sin embargo, los libros de trabajo de rendimiento
resultantes tienen el mismo formato, tanto en Tableau Desktop como en Tableau Server.
Use los libros de trabajo de rendimiento para analizar y solucionar problemas de rendimiento
que pertenecen a varios eventos conocidos por afectar el rendimiento, incluidos:
l
l
l
l
l
l
l
Ejecución de la consulta
Geocodificación
Conexiones a fuentes de datos
Cálculos de trazado
Generación de extracto
Mezcla de datos
Mezcla de servidor (solo Tableau Server)
Tableau Support puede solicitar que cree libros de trabajos de rendimiento, ya que le ayudan a
diagnosticar problemas de rendimiento.
Para crear un registro de rendimiento en Tableau Server
El administrador de servidor determina dónde habilitar el registro de rendimiento en el nivel del
sitio. De forma predeterminada, el registro de rendimiento no se habilita en el sitio
predeterminado o en cualquier sitio que cree. Para habilitar el registro de rendimiento para un
sitio, siga estos pasos:
1. Seleccione el botón Administración en Tableau Server.
2. Seleccione Sitio.
3. Seleccione un sitio.
4. Seleccione Editar.
5. En el cuadro de diálogo Editar sitio, seleccione Permitir registro de rendimiento.
6. Seleccione Aceptar.
Inicie el registro de rendimiento para una vista específica agregando ?:record_
performance=yes a la url. Por ejemplo:
http://localhost/views/Variety/BaseballStatistics?:record_performance=yes
La confirmación visual de que el registro se ha iniciado es el comando Mostrar registro de
rendimiento en la barra de herramientas:
Seleccione Mostrar registro de rendimiento para abrir un libro de trabajo de rendimiento,
que es una instantánea actualizada al minuto de los datos de rendimiento. Puede continuar
tomando instantáneas adicionales a medida que continúe trabajando con la vista; los datos de
rendimiento son acumulativos. Una vez que se aleje de la vista o que elimine ?:record_
performance=yes de la url, el registro se detiene.
Interpretar un registro de rendimiento
Un libro de trabajo de registro de rendimiento es un dashboard de Tableau que contiene tres
vistas: Línea de tiempo, Eventos y Consulta.
Para obtener información sobre la creación de un registro de rendimiento en Tableau Server,
consulte Crear un registro de rendimiento.
Línea de tiempo
La vista de más arriba en un dashboard de registro de rendimiento muestra los eventos que
ocurrieron durante el registro, organizados cronológicamente de izquierda a derecha. El eje
inferior muestra el tiempo transcurrido desde que comenzó el registro.
En la vista Línea de tiempo, las columnas Libro de trabajo, Dashboard y Hoja de trabajo
identifican el contexto de los eventos. La columna Evento identifica la naturaleza del evento y
la columna final muestra cada duración del evento y cómo se compara cronológicamente con
otros eventos registrados:
Eventos
La vista central en un libro de trabajo de registro de rendimiento muestra los eventos,
organizados por duración (mayor a menor). Esto puede ayudarlo a identificar dónde buscar
primero si desea acelerar el libro de trabajo.
Los distintos colores indican distintos tipos de eventos. El rango de eventos que se pueden
registrar es:
l
Cálculo de trazados.
Si los trazados tardan demasiado, considere simplificar el libro de trabajo.
l
Conexión a la fuente de datos.
Las conexiones lentas se pueden deber a problemas de red o problemas con el servidor
de la base de datos.
l
Ejecución de consulta.
Si las consultas tardan demasiado, consulte la documentación del servidor de la base de
datos.
l
Generación de extracto.
Para acelerar la generación de extractos, considere importar solo algunos datos desde
la fuente de datos original. Por ejemplo, puede filtrar campos de datos específicos o
crear una muestra basado en un número específico de filas o un porcentaje de los
datos.
l
Geocodificación.
Para acelerar el rendimiento de la geocodificación, intente usar menos datos o filtrar
para excluir datos.
l
Mezcla de datos.
Para acelerar la mezcla de datos, intente usar menos datos o usar filtros para excluir
datos.
l
Renderización del servidor.
Puede acelerar la renderización del servidor si ejecuta procesos de VizQL Server
adicionales en máquinas adicionales.
Consulta
Si hace clic en un evento Ejecutando consulta en cualquier Línea de tiempo o sección de
Eventos de un dashboard de registro de rendimiento, el texto de esa consulta se muestra en
la sección Consulta. Por ejemplo:
A veces la consulta está truncada y necesitará buscar en el registro de Tableau para encontrar
la consulta completa. La mayoría de los servidores de base de datos pueden aconsejarlo para
optimizar una consulta agregando índices u otras técnicas. Consulte la documentación del
servidor de base de datos para ver detalles.
Vistas incrustadas
Puede incrustar vistas desde Tableau Server en páginas Web, blogs, wikis, aplicaciones Web
y portales de intranet. Las vistas incrustadas se combinan sin problemas en sus páginas Web y
son interactivas. Las vistas actualizan los cambios de datos subyacentes o los libros de trabajo
se actualizan en el servidor.Las vistas incrustadas siguen las mismas restricciones de
licenciamiento y permiso que se usan en el servidor. En general, las personas que cargan una
página Web con una vista incrustada también deben tener una cuenta en Tableau Server. Si
tiene una licencia basada en núcleos puede seleccionar de forma alternativa Habilitar invitado,
lo que permite que los usuarios carguen la vista sin iniciar sesión. Hay tres formas en que
puede incrustar vistas:
l
l
l
Usar el código de incrustación Compartir como está: El vínculo Compartir en la
esquina superior izquierda de cada vista proporciona un código incrustado generado
automáticamente. Lo único que debe hacer es copiar el código y pegarlo en la página
Web.
Escriba su propio código incrustado: Puede mejorar el código de incrustación
predeterminado que Tableau le proporciona o puede crear su propio código. De
cualquier forma puede agregar parámetros que controlan la barra de herramientas,
pestañas y más.
Use la Tableau JavaScript API: Puede usar objetos de Tableau JavaScript en su
propio código de aplicación Web. Consulte JavaScript API para conocer otros detalles.
Para que los usuarios puedan autenticarse correctamente cuando hacen clic en una
vista incrustada, sus navegadores deben estar configurados para admitir cookies de
terceros.
Consulte los siguientes temas para conocer más detalles sobre las vistas incrustadas:
Escritura de código de incrustación
Si escribe su propio código incrustado, puede considerar uno de dos enfoques:
l
l
Use Tableau JavaScript: Éste es el enfoque preferido. Simplemente use el código
incrustado Compartir como el punto de inicio para si propio código, agregar o editar
parámetros de objeto que controlan la barras de herramienta, pestañas y más. El código
incrustado predeterminado, el cual depende del archivo de Tableau JavaScript, también
es la única forma de controlar el orden de carga de múltiples vistas incrustadas.
Especifique la URL de la vista: Al igual que en las versiones anteriores de Tableau,
puede incrustar una vista mediante un Iframe o etiqueta de imagen, donde la fuente es
la URL en bruto para la vista. Puede hacer esto si no puede usar JavaScript en su sitio
Web. Es posible que también haya situaciones donde todo lo que puede especificar es
una URL, como cuando incrusta una vista mediante la Parte Web del visor de páginas
de SharePoint .
Independientemente del enfoque que tome, debe definir un ancho y altura si incrusta una vista.
Tableau JavaScript
Aquí hay un ejemplo del código incrustado que obtiene de forma predeterminada al hacer clic
en Compartir:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<div class="tableauPlaceholder" style="width:800; height:600;">
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="/t/Sales" />
<param name="name"
value="MyCoSales/SalesScoreCard/[email protected]/EastCoastSales"
/>
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" /></object></div>
La fuente para la etiqueta <script> es la URL para el archivo de Tableau Server JavaScript,
viz_v1.js. El archivo JavaScript manipula el armado de la URL completa de la vista que se
muestra a sus usuarios. Los parámetros de objeto name y site_root son los únicos
parámetros requeridos; todos los demás parámetros son opcionales. Para ver ejemplos,
consulte Lista de parámetros incrustados y los "Ejemplos de etiqueta de comando" en la
sección Ejemplos.
URL de vista como fuente
Aquí hay un ejemplo de incrustación de la misma vista mediante un Iframe, donde la fuente es
la URL para la vista:
<iframe
src="http://myserver/t/Sales/MyCoSales/SalesScoreCard?:embed=yes&:tabs=yes&:toolbar=yes" width="800" height="600"></iframe>
Puede especificar el parámetro URL embed y opcionalmente incluir parámetros que controlan
la barra de herramientas y revertir opciones, entre otros. También puede agregar filtros a la
URL que controla los datos específicos que se muestran cuando se carga una vista. Para ver
ejemplos, consulte Lista de parámetros incrustados y los "Ejemplos de etiqueta de Iframe" en
la sección Ejemplos.
Lista de parámetros incrustados
Puede incrustar una vista mediante una etiqueta Iframe, la cual usa parámetros URL o una
etiqueta JavaScript, la cual usa parámetros de objeto. La siguiente tabla indica ambos
conjunto de parámetros y cómo usarlos:
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
custom- :custono
Views
mViews
Esconde la
opción
"Recordar mis
Ejemplos
<&param name="customViews"
value="no"/>
http://tabserver/views/Date-
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
cambios".
-
filter
:embed yes
-
Ejemplos
Time/DateCalcs?:embed=yes:customViews=no
Requerido
para parámetro
de URL. Oculta
el área de
navegación
http://tabserver/views/Datesuperior,
Time/DateCalcs?:embed=yes
haciendo que
la vista se
combine mejor
con la página
Web.
Personaliza lo
que se muestra
cuando la vista
se abre.
También es
posible filtrar
por parámetros
<param name="filter"
cade- de URL.
value="Team=Blue"/>
na
Consulte los
ejemplos de
etiquetas
Iframe en
Agregar filtros
y Filtrar en
campos
múltiples.
-
pd:formaf;
t
png
Muestra una
vista como
archivo PDF o
.png.
http://tabserver/views/Sales/Q2?:format=pdf
-
Representa
una vista
usando DPI
:highd- fal(puntos por
pi
so
pulgada)
estándar para
pantallas y
http://tableauserver/views/Sales/Q2?:highdpi=false
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
Ejemplos
dispositivos de
alta resolución.
host_
url
-
El nombre del
cade- servidor como
na
aparece en la
URL.
El nombre de
ventana
linkta- :linkt- cadeobjetivo para
rget
arget
na
hipervínculos
externos.
loadorder
name
<param name="host_url"
value="http://myserver.bigco.com/">
<param name="host_url"
value="http://localhost/">
<param name="linktarget"
value="_blank"/>
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:linktarget=_blank
Cuando se
incrustan
múltiples
vistas, el orden
de carga
predeterminado es el orden
en que se
<param name="load-order"
indican las
value="2"/>
vistas. Use
esta
configuración
para anular ese
orden. Se
permiten
números
negativos.
-
número
-
Requeridos
para parámetro
de objeto.
Nombre del
cade- libro de trabajo
y de la hoja y,
na
opcionalmente,
una vista
personalizada
(nombredeusu-
<param name="name"
value="MyCoSales/Sales"/>
<param name="name"
value="MyCoSales/Sales/[email protected]/EastCoastSales"/>
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
Ejemplos
[email protected]/
[nombre de
vista
personalizada]).
path
-
Para
autenticación
confiable
solamente, no
se puede usar
el parámetro
"boleto". Anula
cadeel valor del
na
parámetro
"nombre" y se
usa como URL.
Consulte los
ejemplos de
autenticación
confiable.
Renderiza la
página.
Consulte
Actualizar
datos para
conocer más
detalles.
-
:refresh
-
all;
filters;
Regresa el
:rever- sorelemento a su
t
ts;
estado original.
axes;
shelves
<param name="path"
value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4"/>
http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:refresh
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:revert=all
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
site_
root
tabs
ticket
-
:tabs
-
Requerido. El
nombre del
sitio. El valor de
sitio
Predeterminado es nulo
(value="").
Si el servidor
cadees de sitios
na
múltiples y
desea usar
autenticación
confiable,
consulte los
ejemplos de
autenticación
confiable.
yes;
no
Muestra u
oculta
pestañas.
número
Para
autenticación
confiable
solamente, no
se puede usar
el parámetro
de objeto
"ruta". Se debe
usar con objeto
"nombre" para
construir la
URL de
validación de
boleto de
confianza.
Consulte los
ejemplos de
autenticación
confiable.
Ejemplos
<param name="site_root"
value="/t/Sales"/>
<param name="site_root"
value=""/>
<param name="tabs"
value="yes"/>
<param name="ticket"
value="Etdpsm_Ew6rJY9kRrALjauU"/>
http://tableauserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes&:tabs=yes
Parámet- ParámeValoro de
tro de
Descripción
res
objeto
URL
yetoolba- :toolb- s;
r
ar
no;
top
La barra de
herramientas
se muestra de
manera
predeterminada en la parte
inferior si este
parámetro no
está
configurado.
Cuando el
valor es no, la
barra de
herramientas
se excluye de
la vista
incrustada.
Cuando el
valor es top, la
barra de
herramientas
se ubica
encima de la
vista.
Ejemplos
<param name="toolbar"
value="top"/>
http://tabserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no
Ejemplos
Aquí hay algunos ejemplos de formas en que puede personalizar o trabajar con el código
incrustado:
Agregar filtros
puede pasar valores de filtro para que la vista se abra mostrando solo los datos que desea. Por
ejemplo, puede incluir un hipervínculo de otra parte de la aplicación Web a una vista de
rendimiento de venta incrustada que solo muestra una región específica.
Ejemplo de etiqueta de comando
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Region=East" />
</object>
Para pasar por filtros múltiples, simplemente separe cada valor con una coma. Por ejemplo:
<param name="filter" value="Region=East,West" />
Ejemplos de etiqueta Iframe
<iframe
src="http://myserver/views/CalculatedFields?:embed=yes&Region=East"width="800" height="600"></iframe>
<iframe src="http://myserver/views/Sales/SalesPerformance?:embed=yes&Region=East,West" width="900px"
height="700px"></iframe>
Filtrar en campos múltiples
Puede pasar filtros en tantos campos como desee, incluidos los campos que no están en la
vista original.
Ejemplo de etiqueta de comando
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Region=East,West&Customer
Segment=Consumer,HomeOffice" />
</object>
Ejemplo de etiqueta Iframe
<iframe
src="http://myserver/views/CalculatedFields?:embed=yes&Region=East,West&Customer Segment=Consumer,Home Office" width="800"
height="600"></iframe>
Si el valor de un filtro contiene un carácter especial, como una coma, reemplace el
carácter por la secuencia de codificación de URL correspondiente a \ (barra diagonal
inversa, %5c) seguida de la secuencia de codificación de URL correspondiente al
carácter especial. La barra diagonal inversa es necesaria para escapar del carácter
especial. Por ejemplo, la secuencia de codificación de URL correspondiente a \, (barra
diagonal invertida, coma) es %5c%2c.
Filtrar fechas y horas
Si desea filtrar en un campo de Fecha/Hora, incluya el valor con el formato de Tableau
predeterminado que se muestra a continuación:
yyyy-mm-dd hh:mm:ss
La parte de tiempo usa un reloj de 24 horas. Muchas bases de datos almacenan todos los
datos de fecha como Fecha y hora, por lo cual, es posible que necesite entregar un valor de
hora junto con la fecha.
Ejemplo de etiqueta de comando
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Date=2012-12-01" />
</object>
Este ejemplo filtra un campo de fecha y un campo de fecha y hora:
<param name="filter" value="2012-12-01%2022:18:00" />
Ejemplo de etiqueta Iframe
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Date=2008-12-01%2022:18:00" width="800"
height="600"></iframe>
Para filtrar múltiples fechas, separe cada fecha con una coma.
Filtrar medidas
Puede filtrar medidas al incluir uno o más valores. No hay compatibilidad valores mayor que,
menor que o rangos. El ejemplo a continuación filtra para mostrar solo ventas de $100 y $200.
Ejemplo de etiqueta de comando
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="800" height="600
"style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="Sales/Sales-Performance" />
<param name="filter" value="Profit=100, 200" />
</object>
Ejemplo de etiqueta Iframe
<iframe src="http://myserver/Sales/SalesPerformance?:embed=yes&Profit=100,200" width="800"
height="600"></iframe>
Controlar el orden de carga de varias vistas
Puede controlar el orden en que se cargan vistas múltiples para las personas que trabajan con
sus vistas. Solo se puede acceder a esta función mediante un código incrustado en el archivo
de Tableau JavaScript.
En el siguiente ejemplo, se incrustan dos vistas. La segunda vista carga primero, seguida por
la vista superior. Si incrusta múltiples vistas y les proporciona el mismo valor de orden de
carga, o si no especifica parámetros de orden de carga, se cargan en el orden en que
aparecen en la página.
Ejemplo de etiqueta de comando
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name ="name" value="MyCoSales/TopPerformers" />
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" />
<param name="filter" value="Salesperson=Top 5" />
<param name="load-order" value="0" />
</object>
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js">
</script>
<object class="tableauViz" width="600" height="400"
style="display:none;">
<param name="host_url" value="http://myserver/" />
<param name="site_root" value="" />
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="tabs" value="yes" />
<param name="toolbar" value="yes" />
<param name="load-order" value="-1" />
</object>
Incrustar vistas en SharePoint (Microsoft SSPI)
Puede incrustar una vista de Tableau Server en una página de SharePoint. Para autenticar
automáticamente a los usuarios de Tableau Server que acceden a la vista incrustada tiene dos
opciones, ambas dependen del método de autenticación del usuario seleccionado durante la
configuración de Tableau Server. Puede usar ya sea un Active Directory con Habilitar
inicio de sesión automático para autenticar a los usuarios de Tableau Server (también
conocido como usar Microsoft SSPI), o puede usar Autenticación local, y luego configurar
Tableau Server para obtener la autenticación confiable.
Este tema se aplica a la primera opción, donde Tableau Server y SharePoint usan Microsoft
SSPI. Si Tableau Server está usando Autenticación local, consulte Vistas incrustadas en
SharePoint (Autenticación local) para conocer los pasos.
Siga los pasos a continuación para usar la parte Web del visor de SharePoint e incrustar una
vista en una página de SharePoint.
1. Navegue a la página de SharePoint en la cual desea incrustar una vista (el tipo de
página debe ser Página de parte Web).
2. En el menú Acciones de sitio en la esquina superior izquierda de la página, seleccione
Editar página.
3. Haga clic en Agregar una parte Web en la sección de la página donde desea incrustar
la vista.
4. En Categorías, seleccione TableauEmbeddedView en la carpeta Varios o
Personalizado y haga clic en Agregar.
5. De vuelta en la página de SharePoint seleccione Editar parte Web en el menú Editar
para la parte Web nueva.
6. En el lado derecho de la página, puede especificar los atributos de la parte Web de la
vista de páginas. Escriba la URL para la vista que desea incrustar. Use el formato que
se especifica en Vistas incrustadas. Por ejemplo, puede escribir:
http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no
7. En la sección Apariencia, puede especificar un Título de la parte Web, la Altura, y el
Ancho. En general puede especificar una altura fija (por ejemplo, 700 pixeles) y ajustar
el ancho al ancho de la zona.
8. Haga clic en Aceptar para aplicar los cambios y salir del modo de edición.
La vista se incrustará en la parte Web que recién creó. Los usuarios no tendrán que
iniciar sesión en Tableau Server para ver la vista incrustada, en lugar de autenticarse
automáticamente mediante Microsoft SSPI.
Incrustar vistas en wikis
Puede incrustar fácilmente una vista en un wiki u otra página Web simplemente al colocar la
vista dentro de una etiqueta <iframe>.
1. Navegue a la página wiki en la que desea incrustar una vista.
2. Edite la página y agregue un <iframe> donde la fuente es una URL para la vista. Por
ejemplo:
<iframe src="http://tableauserver/views/DateTime/DateCalcs?:embed=yes&:toolbar=no" width="800"
height="600"></iframe>
3. Guardar los cambios.
La vista se incrusta en la página wiki.
Si Tableau Server y wiki están configurados para usar Microsoft SSPI, los usuarios que
acceden a una vista incrustada en wiki iniciarán sesión automáticamente para que
puedan ver la vista.
Si el servidor y wiki no usan el mismo método de autenticación, primero se solicitará a
los usuarios que inicien sesión en el servidor antes de poder ver la vista.
Incrustar imágenes
Además de incrustar una vista en una etiqueta <script> o <iframe> también puede
incrustar la vista como imagen. Cuando incrusta una imagen la vista no es interactiva, sin
embargo, se carga cada vez que la página recarga completamente. La forma en que la imagen
muestra los últimos datos, incluso si los datos subyacentes cambian.
1. Navegue a la página donde en la que desea incrustar la imagen.
2. Edite la página y agregue una etiqueta <img> donde la fuente es una URL para la vista
más la extensión de archivo .png. Por ejemplo:
<img src="http://tableauserver/views/Date-Time/DateCalcs.png"
width="900" height="700">
Nota:
Si la página Web y Tableau Server usan Microsoft SSPI para autenticación, entonces todas
las personas que acceden a la imagen incrustada iniciarán sesión automáticamente en
Tableau Server y podrán ver la vista. Sin embargo, si el servidor y la página Web no usan el
mismo método de autenticación, no se mostrará la imagen.
Vistas incrustadas en SharePoint (Autenticación local)
Puede incrustar una vista de Tableau Server en una página de SharePoint. Si la Autenticación
local es el método de autenticación de usuario de Tableau Server, hay algunos pasos
adicionales que debe realizar antes de poder incrustar vistas. Los pasos identifican a los
usuarios de Tableau Server, entre otras cosas, a SharePoint. Tableau ofrece esta
funcionalidad a través de los archivos complementarios TableauEmbeddedView.dll y
TableauEmbeddedView.wsp. Este tema describe cómo instalar y proporcionar estos archivos,
probar su configuración y luego incrustar una vista con una parte Web de SharePoint. Si su
método de autenticación de usuario es Active Directory, no necesita realizar estos pasos
adicionales, porque Active Directory y SharePoint usan Microsoft SSPI. Puede comenzar a
incrustar de inmediato. Consulte Incrustar vistas en SharePoint (Microsoft SSPI) para conocer
los pasos.
Requisitos
Todas las personas que acceden a una vista incrustada deben ser un usuario con licencia de
Tableau Server y su nombre de usuario en SharePoint debe ser el mismo que su nombre de
usuario en Tableau Server.
Editar permisos de seguridad para el DLL
El primer paso es editar los permisos de seguridad del .dll, de modo que todos los usuarios del
sistema operativo puedan usarlo.
1. Ubique los archivos TableauEmbeddedView.dll y TableauEmbeddedView.wsp que se
instalan con Tableau Server:
C:\Program Files\Tableau\Tableau
Server\8.1\extras\embedding\sharepoint\
2. Copie los archivos al directorio raíz del servidor de SharePoint. El directorio raíz se
ubica, generalmente, en
C:\Inetpub\wwwroot\wss\VirtualDirectories\<puerto>\bin, por
ejemplo:
C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin
El resto de este procedimiento y todo lo siguiente se centrará solo en el archivo .dll.
3. Edite los permisos de seguridad de TableauEmbeddedView.dll; para ello, haga clic
sobre él con el botón derecho y seleccione Propiedades > Seguridad.
4. En Nombres de grupo o usuarios, seleccione Todos y haga clic en Editar.
5. En Permisos para todos, seleccione Permitir para el permiso Control completo.
6. Haga clic en Aceptar.
Instalar e implementar el archivo WSP
El procedimiento anterior otorgó a todos los usuarios del sistema operativo permiso para usar
el archivo .dll. En el siguiente procedimiento entregará a SharePoint más información acerca
de qué hacer con el archivo .dll. Esto es manipulado por el archivo
TableauEmbeddedView.wsp. Copió este archivo como parte del paso 2 en Editar permisos de
seguridad para el DLL. Para instalar e implementar el archivo .wsp:
1. Abra una línea de comando como administrador.
2. Navegue a la siguiente carpeta:
C:\Program Files (x86)\Common Files\Microsoft Shared\Web
Server Extensions\14\BIN
3. Ejecute el siguiente comando para agregar el archivo .wsp:
stsadm -o addsolution -filename
"C:\Inetpub\wwwroot\wss\VirtualDirectories\80\bin\TableauEmbeddedView.wsp"
4. Luego, ejecute el siguiente comando para implementarlo. En el comando,
http://<su sitio de SharePoint>/ debe ser el directorio raíz de su sitio de
SharePoint, como http://mySharePoint/.
stsadm -o deploysolution -name TableauEmbeddedView.wsp
http://<your SharePoint Site>/ -local -force allowgacdeployment
-url
5. Finalmente, active la función Parte Web mediante la ejecución del siguiente comando:
stsadm -o activatefeature -name TableauEmbeddedView_Feature1
-url http://<your SharePoint Site>/
Verificar la implementación de la parte Web
Después de instalar e implementar el archivo TableauEmbeddedView.wsp, verifique la
configuración de la siguiente manera:
1. Abra el sitio de SharePoint en un navegador Web. El sitio puede tardar algunos
momentos en aparecer.
2. En la lista Acciones del sitio, seleccione Configuración del sitio.
3. En Galerías, seleccione Partes Web.
4. Confirme que TableauEmbeddedView aparece en la lista.
5. Regrese a Configuración del sitio y en Administración de recopilación del sitio,
seleccione Características de recopilación del sitio.
Confirme que la Función TableauEmbeddedView tiene el estado Activa.
Incrustar una vista con la parte Web
Ahora puede incrustar una vista en una página de SharePoint:
1. Navegue a la página de SharePoint en la cual desea incrustar una vista (el tipo de
página debe ser Página de parte Web).
2. En el menú Acciones de sitio en la esquina superior izquierda de la página, seleccione
Editar página.
3. Haga clic en Agregar una parte Web en la sección de la página donde desea incrustar
la vista.
4. En Categorías, seleccione TableauEmbeddedView en la carpeta Varios o
Personalizado y haga clic en Agregar.
5. De vuelta en la página de SharePoint, seleccione Editar parte Web en el menú Editar
para la parte Web nueva.
6. En el lado derecho de la página, puede especificar los atributos de la parte Web
TableauEmbeddedView. Escriba el nombre de su Tableau Server y a continuación,
escriba la ruta hacia la vista que desea incrustar. Por ejemplo, puede escribir
/vistas/Fecha-Hora/FechaCalcs.
7. Especifique otros atributos como si desea mostrar la barra de herramientas o incluso si
desea incrustar la vista como imagen en lugar de una vista interactiva.
8. En la sección Apariencia, puede especificar un Título de la parte Web, la Altura y el
Ancho. En general puede especificar una altura fija (por ejemplo, 700 pixeles) y ajustar
el ancho al ancho de la zona.
9. Haga clic en Aceptar para aplicar los cambios y salir del modo de edición.
Ahora la vista está incrustada en la página y los usuarios que accedan a ella iniciarán
sesión automáticamente según su nombre de usuario y contraseña para SharePoint.
Todas las personas que acceden a una vista incrustada deben ser un usuario licenciado
de Tableau Server y su nombre de usuario en SharePoint debe ser el mismo que su
nombre de usuario en Tableau Server.
Éste es un ejemplo de incrustación de vistas en SharePoint mediante el archivo
.dll proporcionado. También puede incrustar vistas en otros tipos de aplicaciones
Web. Consulte JavaScript API para obtener información.
Servidores proxy
Tableau Server se puede configurar para que funcione con un servidor proxy. En este tipo de
entorno, el servidor proxy actúa como un intermediario entre Tableau Server y los clientes que
hacen solicitudes de recursos en Tableau Server. Hay varias formas de configurar los
servidores proxy, por ejemplo, como proxies de avance o inversos. Estos temas suponen que
ya configuró su servidor proxy y que ahora necesita identificar a su servidor proxy en Tableau
Server.
Use los temas a continuación para obtener más información:
Preparar la configuración de un entorno proxy
Para configurar Tableau Server a fin de que funcione con un servidor proxy, necesitará la
siguiente información sobre su servidor proxy:
l
l
l
l
Dirección IP: Las direcciones IP del servidor proxy. La dirección IP debe tener un
formato de IPv4, por ejemplo, 123.45.67.89, y debe ser una IP estática.
FQDN: El nombre de dominio completamente calificado del servidor proxy. Por ejemplo,
bigbox.myco.com.
Sin FQDN: Cualquier nombre de dominio que no esté completamente calificado para el
servidor proxy. Con la ayuda del ejemplo anterior, el nombre de dominio que no está
completamente calificado del servidor proxy sería bigbox.
Alias: Cualquier alias del servidor proxy. Los alias se designan usando los registros
CNAME (registros de nombre canónico). Un ejemplo es un servidor proxy con un
CNAME de bigbox.myco.com y alias de ftp.myco.com y www.myco.com.
Configurar Tableau para que funcione con un servidor proxy
Después de recopilar la información descrita en Preparar la configuración de un entorno
proxy, puede configurar Tableau Server para que funcione con un proxy siguiendo los
siguientes pasos. Para obtener información sobre la configuración a continuación, consulte
Opciones de tabadmin set.
1. Detenga el servidor.
2. Estando en el directorio de agrupación de Tableau Server, escriba el siguiente
comando, donde name es el nombre anónimo (externamente visibles) el servidor proxy:
tabadmin set gateway.public.host "name"
3. De manera predeterminada, Tableau supone que el servidor proxy escucha el puerto 80
para las comunicaciones externas. Para designar un puerto diferente, escribe el
siguiente comando, donde port_number es el puerto:
tabadmin set gateway.public.port "port_number"
4. Ahora, escriba el siguiente comando, donde server es la dirección IPv4 o el nombre
de computador del servidor proxy:
tabadmin set gateway.trusted "server"
El valor de server puede ser una lista separada por comas, por ejemplo:
tabadmin set gateway.trusted "123.45.67.890, 123.45.67.880,
123.45.67.870"
o
tabadmin set gateway.trusted "proxy1, proxy2, proxy3"
5. En el siguiente comando, deberá proporcionar cualquier nombre alternativo para el
servidor proxy, como por ejemplo su nombre de dominio completamente calificado,
cualquier nombre de dominio que no esté completamente calificado y los alias. Estos
son los nombres que un usuario podría escribir en un navegador. Separe cada nombre
con una coma:
tabadmin set gateway.trusted_hosts "name1, name2, name3"
Por ejemplo:
tabadmin set gateway.trusted_hosts "proxy1.example.com,
proxy1, ftp.example.com, www.example.com"
6. Inicia el servidor para que los cambios surtan efecto.
Autenticación de confianza
Cuando incrusta vistas de Tableau Server en páginas Web, todas las personas que visitan la
página deben ser usuarios con licencia de Tableau Server. Cuando los usuarios visitan la
página se les solicita iniciar sesión en Tableau Server antes de poder ver la vista. Si ya tiene
una forma de autenticar usuarios en la página Web o dentro de la aplicación Web, puede
anular esta solicitud y evitar que los usuarios deban iniciar sesión dos veces al configurar
autenticación de confianza.
Autenticación de confianza simplemente significa que ha configurado una relación de
confianza entre Tableau Server y uno o más servidores Web. Cuando Tableau Server recibe
solicitudes de estos servidores Web de confianza, asume que el servidor Web ha manipulado
cualquier autenticación si es necesaria.
Si el servidor Web usa SSPI (Interfaz de proveedor de soporte de seguridad), no es necesario
configurar una autenticación de confianza. Puede incrustar vistas y los usuarios tendrán
acceso seguro a ellas siempre que sean usuarios de Tableau Server con licencia y miembros
de su Active Directory. No se admite el uso de Habilitar inicio de sesión automático (una opción
configurada durante la configuración que usa Microsoft SSPI) y la autenticación de confianza.
Si no usa SSPI con Active Directory y desea que los usuarios tengan acceso seguro a las
vistas de Tableau Server sin que se soliciten credenciales, puede configurar la autenticación
de confianza.
Entonces, para que los usuarios puedan autenticarse cuando hacen clic en una vista
incrustada, sus navegadores deben estar configurados para admitir cookies de
terceros.
Cómo funciona la autenticación de confianza
El diagrama a continuación describe cómo funciona la autenticación de confianza entre el
navegador Web del cliente, sus servidores Web y Tableau Server.
El usuario visita la página
Web: Cuando un usuario
visita la página Web con la
vista de Tableau Server
incrustada, envía una solicitud
GET al servidor Web para
HTML para dicha página.
POSTS de servidor Web a
El servidor Web pasa la URL al navegador: El
servidor Web construye la URL para la vista con la
URL de vista o la etiqueta de archivo (si la vista está
incrustada) y la inserta en el HTML para la página.
Se incluye el boleto (por ejemplo,
http://tabserver/trusted/<ticket>/views/requestedviewname). El servidor Web pasa todo el HTML para
la página de vuelta al navegador Web del cliente.
El navegador solicita una vista de Tableau
Server: El navegador Web del cliente envía una
Tableau Server: El servidor
Web envía una solicitud POST
al Tableau Server de
confianza (por ejemplo,
http://tabaserver/trusted, no
http://tabserver).
Dicha solicitud POST debe
tener un parámetro de
username. El valor
username debe ser el
nombre de usuario de un
usuario de Tableau Server
con licencia. Si el servidor
ejecuta sitios múltiples y la
vista está en un sitio distinto al
sitio predeterminado, la
solicitud POST también debe
incluir un parámetro target_
site.
Tableau Server crea un
boleto: Tableau Server
comprueba la dirección IP o
nombre de host del servidor
Web (192.168.1.XXX en el
diagrama anterior) que envió
la solicitud POST.Si se
configura como un host de
confianza, Tableau Server
crea un ticket a modo de una
cadena única de 24 caracteres
(de URL segura, codificados
en Base64).Tableau Server
responde a la solicitud POST
con dicho boleto. Si hay un
error y no se puede crear el
boleto, Tableau Server
responde con un valor -1.
solicitud a Tableau Server mediante una solicitud
GET que incluye la URL con el boleto.
Tableau Server valida el boleto: Tableau Server
ve que el navegador Web solicitó una URL con un
boleto en ella y valida el boleto. Los boletos se
deben validar dentro de tres minutos después de su
emisión. Luego de validar el boleto, Tableau Server
inicia la sesión del usuario, elimina el boleto de la
URL y envía de vuelta la URL final para la vista
incrustada.
Agregar direcciones IP o nombres de host de confianza a Tableau Server
El primer paso para configurar una autenticación de confianza es configurar Tableau Server a
fin de que reconozca y confíe en solicitudes de uno o más servidores Web:
1. Abra una línea de comando como administrador y navegue al directorio de la
agrupación de Tableau Server (por ejemplo, C:\Program Files (x86)\Tableau\Tableau
Server\8.1\bin).
2. A continuación, escriba el siguiente comando:
tabadmin set wgserver.trusted_hosts "<trusted IP addresses or
host names>"
En el comando anterior, <trusted IP addresses> debe ser una lista separada
por comas de las direcciones IPv4 o nombres de host de los servidores Web. Por
ejemplo:
tabadmin set wgserver.trusted_hosts "192.168.1.101,
192.168.1.102, 192.168.1.103"
o
tabadmin set wgserver.trusted_hosts "webserv1, webserv2,
webserv3"
Notas:
l
l
La lista separada por comas debe estar entre comillas con un espacio
después de cada coma.
Los servidores Web que especifique deben usar direcciones IP estáticas,
incluso si usa los nombres de host aquí para especificarlos.
3. Si tiene uno o más servidores proxy entre la computadora que crea el ticket de confianza
(uno de los configurados en el paso 2, anteriormente) y Tableau Server, también debe
agregarlas como puertas de enlace de confianza. Consulte Configurar Tableau para
que funcione con un servidor proxy para conocer pasos.
4. Por último, escriba el siguiente comando para reiniciar el servidor:
tabadmin restart
Luego, debe configurar el servidor Web para recibir boletos de Tableau Server.
Recibir un boleto de Tableau Server
Una vez que haya agregado sus direcciones de IP confiables a Tableau Server, está listo para
configurar su servidor Web para obtener boletos de Tableau Server a través de una solicitud
POST (el paso 3 en el diagrama). La solicitud POST debe enviarse a http://<server
name>/trusted; por ejemplo, http://tabserv/trusted, no http://tabserv.
Para obtener ejemplos de códigos que puede usar para crear solicitudes POST en Java, Ruby
y PHP, vea lo siguiente:
C:\Program Files\Tableau\Tableau Server\8.1\extras\embedding
Estos son datos que puede utilizar en una solicitud POST a Tableau Server.
l
l
l
username=<username> (requerido): El nombre de usuario para un usuario de
Tableau Server con licencia. Si usa autenticación local el nombre de usuario puede ser
una cadena simple (por ejemplo, username=jsmith). Si usa Active Directory con
múltiples dominios debe incluir el nombre de dominio con el nombre de usuario (por
ejemplo, username=MyCo\jsmith).
target_site=<site id> (es requerido si la vista no se encuentra en el sitio
predeterminado): Especifique el sitio que contiene la vista si Tableau Server se ejecuta
en sitios múltiples y la vista está en un sitio distinto al predeterminado (por ejemplo
target_site=Sales). El valor que usted usa para<site id> debe ser el nombre
de la carpeta Web del sitio.
client_ip=<IP address> (opcional): Utilizado para especificar la dirección IP de
la computadora cuyo navegador está accediendo a la vista (por ejemplo, client_
ip=123.45.67.891). No es la dirección IP del servidor Web que está haciendo la
solicitud POST de Tableau Server. Si decide utilizar este parámetro; consulte Opcional:
Configurar coincidencia de IP de cliente para obtener más información.
La respuesta de Tableau Server a la solicitud POST será una única cadena de nueve dígitos
(el boleto). Si Tableau Server no puede procesar la solicitud, la devolución será -1. Consulte
Valor del boleto de -1 Devuelto desde Tableau Server para obtener consejos para corregir
esta situación. Además, para que los usuarios puedan autenticarse correctamente cuando
hacen clic en una vista incrustada, sus navegadores deben estar configurados para admitir
cookies de terceros.
A continuación, deberá agregar un código que permita que el servidor Web construya una
URL para la vista que incluya la ubicación de la vista y el boleto.
Mostrar la vista con el boleto
Después de crear la solicitud POST, debe escribir el código que provee el servidor Web con la
ubicación de la vista y el boleto de Tableau Server. Usará esta información para mostrar la
vista. Cómo especificarlo depende de si la vista está incrustada y de si Tableau Server se
ejecuta en sitios múltiples.
Ejemplos de vistas de Tableau Server
Este es un ejemplo de cómo especificar una vista a la que los usuarios solo acceden a través
de Tableau Server (la vista no está incrustada):
http://tabserver/trusted/<ticket>/views/<workbook>/<view>
Si Tableau Server se está ejecutando en sitios múltiples y la vista está en un sitio distinto al al
predeterminado, debe agregar t/<site name> a la ruta. Por ejemplo:
http://tabserver/trusted/<ticket>/t/Sales/views/<workbook>/<view>
Ejemplos de vistas incrustadas
Estos son algunos ejemplos de cómo se pueden especificar vistas incrustadas. Debido a que
hay dos enfoques posibles para código incrustado, se proporcionan estas dos formas a
continuación. Independientemente de cuál use, hay información exclusiva de autenticación de
confianza que debe suministrar.
Ejemplos de etiqueta de comando
Este ejemplo utiliza el boleto parámetro de objeto:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
Así se ve el ejemplo anterior para Tableau Server de multiples sitios, donde la vista se publica
en el sitio Sales:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="800" height="600"
style="display:none;">
<param name="site_root" value="/t/Sales" />
<param name="name" value="MyCoSales/SalesScoreCard" />
<param name="ticket" value="Etdpsm_Ew6rJY-9kRrALjauU" />
</object>
En vez de usar ticket, puede usar el parámetro de ruta establecer la ruta completa de la
vista explícitamente. Cuando se utiliza path, no es necesario el parámetro name, que suele
ser un parámetro requerido en el código incrustado de Tableau JavaScript :
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700"
style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/views/MyCoSales/SalesScoreCard" />
</object>
Este es el mismo ejemplo para un servidor de múltiples sitios. Tenga en cuenta que
/t/<site name> se utiliza aquí:
<script type="text/javascript"
src="http://myserver/javascripts/api/viz_v1.js"></script>
<object class="tableauViz" width="900" height="700"
style="display:none;">
<param name="path" value="trusted/Etdpsm_Ew6rJY9kRrALjauU/t/Sales/views/MyCoSales/SalesScoreCard" />
</object>
Ejemplo de etiqueta Iframe
<iframe src="http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookQ4/SalesQ4?:embed=yes" width="800"
height="600"></iframe>
Opcional: Configurar coincidencia de IP de cliente
De forma predeterminada, Tableau Server no considera la dirección IP del navegador Web
del cliente cuando crea o valida boletos. Para cambiar esto, debe hacer dos cosas: Especificar
la dirección IP con el parámetro client_ip en la solicitud POST que obtiene el boleto y
seguir los pasos a continuación para configurar Tableau Server a fin de ejecutar coincidencia
de dirección IP de clientes.
1. Abra una ventana de comando y cambie directorios a la ubicación del directorio de la
agrupación de Tableau Server. La ubicación predeterminada es C:\Program
Files\Tableau\Tableau Server\8.1\bin
2. Abra una línea de comando como administrador y escriba el siguiente comando:
tabadmin set wgserver.extended_trusted_ip_checking true
3. Luego escriba el siguiente comando:
tabadmin configure
4. Por último, reinicie el servidor al escribir lo siguiente:
tabadmin restart
Solución de problemas de la autenticación de confianza
A continuación se muestran algunos problemas y errores comunes que puede encontrar
cuando configura autenticación de confianza. La información de autenticación de confianza se
escribe en ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Para aumentar el nivel de
inicio de sesión desde info a debug, utilice la configuración vizqlserver.trustedticket.log_
level.
Para obtener consejos para probar la autenticación de confianza, consulte la Base de
conocimiento de Tableau.
Valor del boleto de -1 Devuelto desde Tableau Server
Tableau Server arroja -1 para el valor del boleto si no puede emitir el boleto como parte del
proceso de autenticación de confianza. La razón exacta por la que este mensaje fue escrito en
el archivo production*.log en la siguiente carpeta:
ProgramData\Tableau\Tableau Server\data\tabsvc\logs\wgserver
Aquí hay algunas cosas para confirmar:
l
Todos los nombres de host o direcciones IP de servidores Web se agregan a
hosts de confianza
La dirección IP o nombre de host para la computadora que envía la solicitud POST debe
estar en la lista de los hosts de confianza de Tableau Server. Consulte Agregar
direcciones IP o nombres de host de confianza a Tableau Server para aprender a
agregar direcciones IP o nombres de host a esta lista.
l
El valor de wgserver.trusted_hosts está formateado adecuadamente
La lista de hosts de confianza que proporcionó usando la configuración
wgserver.trusted_hosts debe ser una lista separada por comas con un espacio después
de cada coma. Por ejemplo, la lista debe ser similar a lo siguiente: 192.168.1.101,
192.168.1.102, 192.168.1.103 o bigbox1.example.lan, bixbox2.example.lan,
bigbox3.example.lan.
l
Las direcciones IP son IPv4
Si está usando direcciones IP para especificar hosts de confianza, deben estar en
formato de Protocolo de Internet versión 4 (IPv4). Una dirección IPv4 se ve de la
siguiente manera: 123.456.7.890. No se admiten direcciones IPv6 (por ejemplo,
fe12::3c4a:5eab:6789:01c%34) como una forma de ingresar hosts de confianza.
l
El nombre de la solicitud POST es un usuario de Tableau Server válido
El nombre de usuario que envía en la solicitud POST debe ser un usuario de Tableau
Server con licencia con un nivel de licencia de visor o interaccionador. Puede ver una
lista de usuarios y sus niveles de licencia al iniciar sesión en Tableau Server como
administrador y hacer clic en el vínculo Licenciamiento en el lado izquierdo de la página.
l
El nombre de usuario en la solicitud POST incluye dominio
Si Tableau Server está configurado para usar autenticación local, el nombre de usuario
que envía en la POST puede ser una cadena simple. Sin embargo, si el servidor está
configurado para Active Directory debe incluir el nombre de dominio con el nombre de
usuario (por ejemplo, dominio\nombre de usuario). Por ejemplo, el parámetro de
nombre de usuario puede ser: username=dev\jsmith
HTTP 401 - No autorizado.
Si recibe un error 401- No autorizado, es posible que Tableau Server esté configurado para
usar Active Directory con SSPI (consulte Habilitar inicio de sesión automático). Si el servidor
Web usa SSPI, no necesita configurar autenticación de confianza. Puede incrustar vistas y los
usuarios tendrán acceso a ellas siempre que sean usuarios de Tableau Server con licencia y
miembros de su Active Directory.
No se admite el uso simultáneo de Habilitar inicio de sesión automático y la autenticación
de confianza.
HTTP 404 - Archivo no encontrado
Es posible que reciba este error si el código de programa hace referencia a una URL de
Tableau Server que no existe. Por ejemplo, el servidor Web puede construir una URL no
válida que no se puede encontrar cuando la página Web intenta recuperarla.
Usuario no válido (SharePoint o C#)
Puede encontrar este error si ha configurado Tableau Server para autenticación de confianza.
El código de ejemplo para el .dll de SharePoint hace referencia a la siguiente solicitud GET:
SPContext.Current.Web.CurrentUser.Name
La solicitud anterior arrojará el nombre de visualización del usuario de Windows Active
Directory. Si desea usar la ID de inicio de sesión, entonces debe cambiar el código a:
SPContext.Current.Web.CurrentUser.LoginName
Después de realizar el cambio, vuelva a compilar el .dll de SharePoint.
Intento por recuperar el boleto desde la dirección IP errónea
Puede encontrar este error si ha configurado Tableau Server para autenticación de confianza.
La dirección IP del navegador Web no se considera de forma predeterminada al validar el
boleto. Si Tableau Server se configura para que ejecute coincidencia de dirección IP de
clientes, asegúrese de que la dirección IP del navegador Web del cliente que se envía en la
POST a Tableau Server es la misma cuando el navegador intenta recuperar la vista
incrustada. Por ejemplo, en el diagrama autenticación de confianza, si la solicitud POST en el
paso 3 envía el parámetro client_ip=74.125.19.147, entonces la solicitud GET en el paso 5
debe venir de la misma dirección IP.
Consulte Opcional: Configurar coincidencia de IP de cliente para aprender cómo configurar
Tableau Server para ejecutar coincidencia de dirección IP de clientes.
Error de restricción de cookie
Cuando un usuario inicia sesión en Tableau Server, una cookie de sesión se almacena en su
navegador local. La cookie almacenada es el método mediante el cual Tableau Server afirma
que el usuario está autenticado y puede acceder al servidor. Dado que la cookie se define con
el mismo dominio o subdominio de la barra de dirección del navegador, se le considera una
cookie de origen. Si el navegador del usuario está configurado para bloquear las cookies de
origen, el usuario no podrá iniciar sesión en Tableau Server.
Cuando el usuario inicia sesión en Tableau Server a través de una vista incrustada o en un
entorno que tiene configurada la autenticación de confianza, sucede lo mismo: se almacena
una cookie. Sin embargo, en este caso, el navegador trata la cookie como una cookie de
terceros. Esto se debe a que la cookie se define con un dominio diferente al que se muestra en
la barra de dirección del navegador. Si el navegador Web del usuario está configurado para
bloquear las cookies de terceros, la autenticación en Tableau Server fallará. Para evitar que
esto suceda, los navegadores Web se deben configurar para admitir las cookies de terceros.
Ocurrió un error al comunicarse con el servidor (403)
Si Tableau Server se configura para autenticación de confianza, puede que reciba este error
después de abrir una nueva vista en un explorador e intentar navegar de regreso a vistas
abiertas anteriormente. Tableau Server proporciona protección ante la reutilización no
autorizada de sesiones VizQL a través de la opción tabadmin set vizqlserver.protect_sessions,
que está configurada en true de forma predeterminada. Debido a que Tableau Server se
configura para autenticación de confianza, puede que no necesite habilitar
vizqlserver.protect_sessions. Para deshabilitarla, use tabadmin set para cambiarlo
a false.
SAML
Puede configurar Tableau Server para usar un proveedor de identidad externa (IdP) para
autenticar a los usuarios de Tableau Server sobre SAML. Toda la autenticación de usuarios se
realiza fuera de Tableau, sin importar si usa Active Directory o autenticación local en Tableau
Server para administrar sus cuentas de usuario en Tableau Server. Esto le permite
proporcionar una experiencia de inicio de sesión en todas las aplicaciones de su organización.
Consulte los siguientes temas para obtener más información sobre SAML:
Cómo funciona la autenticación SAML
SAML es un estándar abierto basado en XML para el intercambio de información de
autenticación entre dos partes, un proveedor de servicios (en este caso, Tableau Server) y un
proveedor de identidad (IdP).Cuando configure Tableau Server para SAML, un IdP de
terceros se usa para autenticar los usuarios y para pasar la información de identificación a
Tableau Server a modo de un documento XML firmado de forma digital.
El usuario intenta acceder a un
enlace de libro de trabajo o a otro
recurso de Tableau Server.
Tableau Server inicia el proceso de
autenticación y redirige al usuario al
IdP.
IdP le envía una respuesta
de éxito SAML a Tableau
Server.
El usuario abre el libro de
trabajo en Tableau Server.
IdP autentica al usuario.
Cuenta de
usuario de
Tableau
ServerEste nombre
de usuario
debe
coincidir
con el que
tiene
almacenado IdP
como
nombre
de usuario
( ).
Cuenta
del
usuario en
el IdP.
Requisitos de SAML
Para configurar Tableau Server para usar SAML, debe hacer lo siguiente:
Archivo de certificado: Un certificado x509 codificado mediante PEM con la extensión .crt.
Archivo de clave de certificado: Una clave RSA o DSA que no está protegida por
contraseña con la extensión de archivo .key.
Cuenta IdP: Necesita una cuenta con un proveedor de identidad externo. Algunos ejemplos
son PingFederate, SiteMinder y Open AM.
Atributo llamado nombre de usuario: Debe configurar su proveedor de identidad para
arrojar un atributo llamado nombre de usuario en la respuesta SAML.
Nombres de usuario coincidentes: Los nombres de usuario de Tableau Server y los
almacenados en el IdP deben coincidir. Por ejemplo, si el nombre de usuario para Jane Smith
está almacenado en PingFederate como jsmith, también debe estarlo en Tableau Server
como jsmith. Además, si está configurando SAML como parte de la instalación de Tableau
Server, parte de esta es crear la cuenta de administrador de Tableau Server. Antes de
ejecutar la Instalación, asegúrese de que la cuenta que planea usar exista en su IdP.
Inicio de sesión no automático de Active Directory: Si está usando SAML y Tableau
Server también está configurado para usar Active Directory para la administración de
usuarios, no use además Activar inicio de sesión automático.
SAML
Puede configurar Tableau Server para usar un proveedor de identidad externa (IdP) para
autenticar a los usuarios de Tableau Server sobre SAML. Toda la autenticación de usuarios se
realiza fuera de Tableau, sin importar si usa Active Directory o autenticación local en Tableau
Server para administrar sus cuentas de usuario en Tableau Server. Esto le permite
proporcionar una experiencia de inicio de sesión en todas las aplicaciones de su organización.
Antes de que configure Tableau Server para SAML, asegúrese de cumplir los Requisitos de
SAML.
Configuración de SAML
Para configurar Tableau Server para usar SAML:
1. Coloque los archivos de certificado en una carpeta llamada SAML, paralela a la carpeta
8.1Tableau Server. Por ejemplo:
C:\Program Files\Tableau\Tableau Server\SAML
Esta ubicación proporciona a la cuenta que ejecuta Tableau Server los permisos
necesarios para los archivos.
2. La configuración SAML se maneja en la pestaña SAML, que se muestra durante la
configuración de Tableau Server. Si está configurando SAML después de la instalación,
tenga acceso a la pestaña SAML abriendo la utilidad de configuración de Tableau
Server (Inicio > Todos los programas > Tableau Server 8.1 > Configurar
Tableau Server) y haga clic en la pestaña SAML.
3. En la pestaña SAML, seleccione Usar SAML para inicio de sesión único y
proporcione la ubicación para cada uno de los siguientes elementos:
URL de retorno de Tableau Server : la URL a la que tendrán acceso los usuarios de
Tableau Server, como http://tableau_server. No se recomienda usar http://localhost.
ID de entidad SAML: la ID de entidad identifica su instalación de Tableau Server de
forma única al IdP. Puede ingresar su URL de Tableau Server nuevamente aquí si lo
desea, pero no necesita ser su URL de Tableau Server.
Archivo de certificado de SAML: un certificado x509 codificado mediante PEM con la
extensión .crt
Archivo de clave de certificado SAML: una clave RSA o DSA que no está protegida
por contraseña con la extensión de archivo .key
4. Deje el cuadro de texto Archivo de metadatos IdP de SAML vacío por ahora y haga
clic en Exportar archivo de metadatos.
5. Se abrirá un cuadro de diálogo que le permitirá guardar la configuración SAML de
Tableau Server en un archivo XML.En este punto, los metadatos de su IdP no se
incluyen.
Guarde el archivo XML con el nombre que desee.
6. En el sitio Web de su IdP o en su aplicación:
l
l
Agregue Tableau Server como Proveedor de servicios. Deberá consultar la
documentación de su IdP para saber cómo hacerlo. Como parte de este proceso,
importará el archivo que guardó en el paso 5.
Confirme que su IdP usa Nombre de usuario como el elemento de atributo a
verificar.
7. Dentro de su IdP, exporte el archivo XML de metadatos de su IdP.
8. Copie el archivo XML de metadatos de su IdP a la siguiente carpeta en su computadora
con Tableau Server:
C:\Program Files\Tableau\Tableau Server\SAML
9. En la pestaña SAML en el cuadro de diálogo Configuración de Tableau Server, ingrese
la ubicación del archivo en el cuadro de texto Archivo de metadatos de IdP SAML:
10. Haga clic en Aceptar. Tableau Server está ahora configurado para la autenticación
SAML.
Probar su configuración
Pruebe su configuración SAML al abrir una instancia nueva del navegador Web e ingresando
el nombre de Tableau Server en la ventana URL:
Debe tener en cuenta que el aviso de inicio de sesión que aparece es de su IdP y no de
Tableau Server.
Solución de problemas de SAML
Use los siguientes temas para solucionar problemas que pueda tener con SAML.
SAML y Activar inicio de sesión automático
Si está usando SAML y Tableau Server también está configurado para usar Active Directory,
no use además Activar inicio de sesión automático. No se pueden usar Activar inicio de
sesión automático y SAML juntos.
Inicio de sesión fallido
Si recibe el mensaje "Inicio de sesión fallido:Autenticación de proveedor de identidad exitosa
para usuario <nombre de usario de IdP>,No se pudo encontrar el usuario en Tableau Server."
el nombre de usuario almacenado en Tableau Server y el almacenado en IdP no son idénticos.
Para corregirlo, asegúrese de que coincidan. Por ejemplo, si el nombre de usuario para Jane
Smith está almacenado en el IdP como jsmith, también debe estarlo en Tableau Server
como jsmith.
Registro de error SAML
Los errores de inicio de sesión SAML se registran en la siguiente ubicación. Puede usar este
registro para solucionar problemas.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\wgserver\error.log
Ejecutar como usuario
Puede usar una cuenta de usuario de Active Directory (AD) dedicada para que se ejecute el
servicio de Tableau Server, denominada cuenta Ejecutar como usuario. Algunos
administradores eligen hacer esto cuando los libros de trabajo publicados en Tableau Server
se conectan a fuentes de datos en tiempo real. La cuenta de Network Service predeterminada
del servidor (NT AUTHORITY\NetworkService) no tiene los permisos correctos para
conectarse a fuentes de datos en otras computadoras. Una cuenta AD configurada
correctamente tiene permisos.
Para fuentes de datos que requieren autenticación de NT, la cuenta AD también puede
manipular automáticamente el proceso de autenticación, de esta forma, se protege a los
usuarios contra solicitudes de credenciales cuando el libro de trabajo se conecta a la fuente de
datos en tiempo real. Por último, una cuenta AD Ejecutar como usuario que se dedica a un
recurso específico frecuentemente es menos problemática de administrar que una cuenta AD
asociada con una persona.
Para configurar Tableau Server a fin de que use una cuenta Ejecutar como usuario, siga los
procedimientos a continuación. Si está ejecutando una instalación distribuida de Tableau
Server, estos pasos deben realizarse en los trabajadores y en la instalación primaria. También
observe que los pasos de Configuración de Ejecutar como cuenta para confirmar pueden
variar de un sitio a otro.
Nota:
Si instala Tableau Server con su cuenta Ejecutar como usuario a mano, antes de ejecutar la
configuración, confirme que el servicio Inicio de sesión secundario de Windows tiene los
valores correctos para cierre de sesión e inicio. Consulte Verificar la configuración de Tableau
Service para obtener información.
Identificar la cuenta
El primer paso es identificar o crear una cuenta de Active Directory bajo la cual se ejecuta el
servicio de Tableau Server. Ésta será la cuenta Ejecutar como usuario de Tableau Server y
debe tener lo siguiente:
l
l
Permisos para conectarse a la fuente de datos con al menos acceso de lectura.
Credenciales para permitir que Tableau Server cumpla el proceso de autenticación de
NT con la fuente de datos. Las fuentes de datos Microsoft que realizan autenticación de
NT incluyen Microsoft SQL Server y Microsoft Analytical Services (MSAS), pero no
Access ni Excel.
l
Permisos para consultar el controlador de dominio de Active Directory para usuarios y
grupos. Una cuenta de usuario creada en la máquina local en la que se ejecuta Tableau
Server probablemente no tendrá estos permisos.
Confirmar confianza bilateral de dominios
Confirme que hay confianza bilateral entre dominios si alguna de las siguientes opciones es
verdadera:
l
l
Las máquinas que albergan Tableau Server y la fuente de datos están en dominios
separados.
Los usuarios de Tableau Server están en un dominio separado de Tableau Server o la
fuente de datos.
Verificar la configuración de Tableau Service
Confirme que se asignan los valores correctos de inicio de sesión e inicio a los servicios
Tableau. Si está ejecutando una instalación distribuida de Tableau Server, realice estos pasos
en los trabajadores y en la instalación primaria.
1. Inicie sesión como administrador en la computadora que ejecuta Tableau Server.
2. En la computadora de Tableau Server, seleccione Inicio > Cuadro de mandos >
Herramientas administrativas > Administración de equipos > Servicios y
aplicaciones > Servicios.
3. Abra Servicios y aplicaciones, luego haga clic en Servicios. Confirme que los
siguientes servicios tienen la configuración correcta:
Nombre de
servicio
Servicio de
licenciamiento
FLEXnet
Inicio de sesión
secundario
Tableau
Server (tabsvc)
Tablicsrv
Valor de inicio de sesión
Sistema local
Valor de
inicio
Manual
Sistema local
Automático
<dominio>\<nombredeusuario> Esta es la
Automático
cuenta de usuario Ejecutar como. Consulte a
continuación.
Sistema local
Automático
Cambio del valor de inicio de sesión
Para cambiar el valor de Inicio de sesión para Tableau Server (tabsvc) en la cuenta Ejecutar
como usuario:
1. En la ventana Servicios, detenga el servicio de Tableau Server al hacer clic con el botón
derecho en Tableau Server (tabsvc) y seleccionar Detener.
2. Seleccione Inicio > Todos los programas > Tableau Server > Configurar
Tableau Server.
3. En la pestaña General, ingrese el dominio, nombre de usuario y contraseña para la
cuenta Ejecutar como usuario de Tableau Server.
4. Haga clic en Aceptar, luego reinicie Tableau Server (tabsvc).
Preparar la política de seguridad local
Si la cuenta Ejecutar como usuario no es de administrador en la máquina de Tableau Server
(en la instalación principal y en los trabajadores, si ejecuta una instalación distribuida), debe
preparar la política de seguridad local de la máquina de forma que la cuenta Ejecutar como
usuario de Tableau Server pueda iniciar sesión en la máquina como un servicio y realizar
cambios de configuración. Para hacer esto:
1. Seleccione Inicio > Cuadro de mandos > Herramientas administrativas >
Política de seguridad local.
2. En la ventana Configuración de seguridad local, resalte Asignaciones de derechos de
usuario, luego haga clic con el botón derecho en Iniciar sesión como servicio y
seleccione Propiedades.
3. En la ventana Propiedades de inicio de sesión como servicio, haga clic en Agregar
usuario o grupo.
4. Escriba la <domain>\<username> para la cuenta Ejecutar como usuario de Tableau
Server (por ejemplo: MYCO\tableau_server) y haga clic en Verificar nombres.
5. Cuando la cuenta se resuelve de forma correcta, se le agrega una subraya. Haga clic en
Aceptar.
6. Repita estos pasos para agregar la cuenta Ejecutar como a la política Iniciar sesión
localmente.
7. Repita estos pasos para eliminar la cuenta Ejecutar como de la política Denegar inicio
de sesión.
8. Haga clic en Aceptar para cerrar las ventanas de Configuración de seguridad local.
Configurar los ajustes de conexión de la fuente de datos
Para autenticar automáticamente a los usuarios cuando el libro de trabajo al que accede se
conecta a una fuente de datos autenticada por NT en tiempo real, configure la conexión de
datos de Tableau con la opción Usar seguridad integrada de Windows NT seleccionada:
Seguridad integrada de Windows NT
Autentica con la cuenta Ejecutar como
usuario del servidor
Nombre de usuario y contraseña
Se solicita las credenciales de base de datos
a cada usuario de Tableau Server
Configuración de Ejecutar como cuenta para confirmar
La cuenta Ejecutar como usuario necesita permisos que le permiten leer, ejecutar y, en
ocasiones, modificar archivos. Según la cuenta que usa como punto de inicio, es posible que
ya tenga los permisos correctos. En cualquier momento que cambia la cuenta Ejecutar como
del servidor debe confirmar que cumple los siguientes requisitos. Si está ejecutando una
instalación distribuida, esto se aplica en los trabajadores y en la instalación primaria.
Otorgar permisos de lectura y ejecución
La cuenta bajo la cual se ejecuta el servicio Tableau Server necesita permiso para leer y
ejecutar archivos. En cualquier momento que la cuenta Ejecutar como usuario del servidor
cambia, confirme y configure lo siguiente:
1. En la máquina que aloja Tableau Server (y Tableau Worker, si se distribuye), use
Windows Explorer para hacer clic con el botón derecho en la unidad en la que se
encuentra instalado Tableau, como el Disco local (C:), y seleccione Propiedades.
2. En la ventana Propiedades de disco local, seleccione la pestaña Seguridad.
3. Haga clic en Editar, luego en Agregar.
4. En el cuadro de diálogo Seleccionar usuarios, Equipos, Cuentas de servicio o Grupos,
escriba el <domain>\<username> para la cuenta Ejecutar como usuario de Tableau
Server. No utilice una cuenta grupal.
5. Haga clic en Verificar nombres para solucionar la cuenta, luego en Aceptar para
confirmar.
6. Con la cuenta Ejecutar como usuario de Tableau Server resaltada, confirme que tiene
permisos para Leer y ejecutar. La selección de Leer y ejecutar selecciona
automáticamente Indicar contenido de carpeta y Leer.
7. Haga clic en Aceptar para salir.
Otorgar permisos de modificación
La cuenta también necesita la capacidad de realizar cosas como la creación de archivos de
registro. Confirme o configure lo siguiente:
1. Navegue a las siguientes carpetas:
C:\Program Files\Tableau
C:\ProgramData\Tableau\
Si está ejecutando Tableau Server de 32 bits en un sistema operativo de 64 bits,
deberá ir a C:\Program Files (x86)\Tableau en lugar de C:\Program
Files\Tableau. Además, las unidades y rutas anteriores pueden variar según
dónde esté instalado Tableau Server.
2. Haga clic con el botón derecho, seleccione Propiedades y haga clic en la pestaña
Seguridad:
l
l
l
l
Haga clic en Editar, luego en Agregar.
Escriba la <domain>\<username> para la cuenta Ejecutar como usuario de
Tableau Server.
Haga clic en Verificar nombres para solucionar la cuenta, luego en Aceptar
para confirmar.
Con la cuenta Ejecutar como usuario de Tableau Server resaltada, confirme que
tiene permisos para Modificar. La selección de Modificar automáticamente
otorga todos los permisos excepto para Control completo y Permisos
especiales:
3. Para cada carpeta del paso 1 anterior, en la pestaña Seguridad de propiedades de
Tableau, haga clic en Avanzado:
4. En la configuración de seguridad avanzada para la ventana de Tableau, haga clic en
Cambiar permisos.
5. En la configuración de seguridad avanzada para el cuadro de diálogo para Tableau,
resalte la cuenta Ejecutar como usuario y seleccione la casilla de verificación
Reemplazar todos los permisos de objetos hijo con permisos heredables de
este objeto:
6. Haga clic en Aceptar para aplicar cambios a todas las subcarpetas y archivos, esto
puede tardar algunos minutos. Es normal recibir varios mensajes de error de Windows
cuando aplica estos cambios. No es necesario cancelar el proceso; en su lugar, haga
clic en Continuar.
7. Haga clic en Aceptar para confirmar los cambios, luego haga clic en Aceptar en el
cuadro de diálogo Propiedades de Tableau.
Modificar Configuración de registro
El siguiente paso es opcional y no se ve en muchos entornos. Si la seguridad de registro es
muy restrictiva, otorgue a la cuenta Ejecutar como usuario de Tableau Server permisos de
lectura y escritura a las siguientes ramas del registro:
l
HKEY_CURRENT_USER\Software\Tableau
l
Máquina de 32 bits: HKEY_LOCAL_MACHINE\Software\Tableau
l
Máquina de 64 bits:HKEY_LOCAL_MACHINE\Software\Wow6432Node\Tableau
y
Suplantación de SQL Server
Suplantación es cuando la cuenta de un usuario funciona en nombre de la cuenta de otro
usuario. Puede configurar Tableau y Microsoft SQL Server para realizar suplantación de
usuario de base de datos, de forma que la cuenta de base de datos de SQL Server usada por
Tableau Server consulta en nombre de usuarios de base de datos de SQL Server, los cuales
también son usuarios de Tableau.
El principal beneficio de esta función es permitir a los administradores la implementación y
control de su política de seguridad de datos en un lugar. sus bases de datos. Cuando los
usuarios de Tableau acceden a una vista con una conexión a una base de datos de SQL
Server, la vista solo muestra lo que los permisos de base de datos de usuarios les autorizan a
ver. Un beneficio adicional es que los usuarios no deben responden a una indicación de inicio
de sesión de base de datos cuando acceden a la vista. Además, los publicadores de libros de
trabajo no tienen que depender de filtro específicos para usuarios a fin de restringir lo que se
ve en las vistas.
Use los temas a continuación para obtener más información sobre lo que necesita para usar
esta función.
Requisitos de suplantación
Aquí hay lo que necesita para usar la función:
l
l
l
l
Conexiones en tiempo real a SQL Server solamente: La suplantación solo se
puede usar para vistas que tienen una conexión en tiempo real a una base de datos de
SQL, versión 2005 o más moderna.
Cuentas de base de datos individuales: Cada persona que accederá a la vista debe
tener una cuenta individual explícita en la base de datos de SQL Server a la cual se
conecta la vista. No se puede suplantar a los miembros de un grupo de Active Directory
(AD). Por ejemplo, si Jane Smith es miembro del grupo AD Ventas, y su administrador
de base de datos agrega el grupo AD ventas a la base de datos de SQL Server, no se
puede suplantar Jane.
Credenciales que coinciden y tipo de autenticación: Las credenciales de cada
cuenta de usuario de Tableau y su tipo de autenticación de usuario de Tableau deben
coincidir con sus credenciales y tipo de autenticación en la base de datos de SQL
Server. En otras palabras, si la cuenta de usuario de Tableau Server de Jane Smith
tiene un nombre de usuario MyCo\jsmith y Tableau Server usa Active Directory para
autenticación de usuarios, su nombre de usuario en la base de datos SQL Server
también debe ser MyCo\jsmith y SQL Server debe usar autenticación integrada de
Windows.
Prerrequisitos de SQL Server: En SQL debe tener una tabla de seguridad de datos,
una vista que ejecuta seguridad de datos y debe requerir que los usuarios de base de
datos usen la vista.
l
Cuenta de SUPLANTACIÓN SQL: Debe tener una cuenta de base de datos de SQL
Server que tiene permiso de SUPLANTACIÓN para los usuarios de base de datos
anteriores. Esta es una cuenta con la función sysadmin o una que ha recibido permiso
IMPERSONATE para cada usuario de cuenta individual (consulte el artículo de MSDN
sobre EJECUTAR COMO). Esta cuenta de SQL Server también debe ser una de dos
cuentas en el lado Tableau de las cosas:
l
l
La cuenta Ejecutar como usuario de Tableau Server (consulte Suplantar con una
cuenta Ejecutar como usuario).
La cuenta del publicador de libro de trabajo (consulte. Suplantar con credenciales
SQL incrustadas).
Cómo funciona la suplantación
Aquí hay una ilustración de cómo funciona la suplantación de usuarios de bases de datos:
En la ilustración anterior, Jane Smith (MyCo\jsmith) es un representante de ventas de la costa
oeste y Henry Wilson (MyCo\hwilson) cubre la costa este. En la base de datos de SQL Server,
los permisos de la cuenta para la cuenta de Jane, MyCo\jsmith, solo otórguele acceso a los
datos de la costa oeste. La cuenta de Henry, MyCo\hwilson, solo puede acceder a los datos
para la costa este.
Se creó una vista que muestra datos para todo el país. Tiene una conexión en tiempo real con
una base de datos de SQL Server. Ambos usuarios inician sesión en Tableau Server y haga
clic en la vista. Tableau Server se conecta con SQL Server mediante una cuenta de base de
datos con permiso de SUPLANTACIÓN para la cuenta de base de datos de cada usuario.
Esta cuenta funciona en nombre de la cuenta de base de datos de cada usuario.
Cuando se muestra vista, está restringida por los permisos de base de datos individuadle cada
usuario:Jane solo ve los datos de ventas de la costa oeste, Henry solo ve los datos de la costa
este.
Suplantar con una cuenta Ejecutar como usuario
La suplantación mediante una cuenta Ejecutar como usuario es la forma recomendada de
realizar suplantación. La cuenta Ejecutar como usuario es una cuenta AD que el servicio
Tableau Server puede ejecutar bajo la máquina que alberga Tableau Server (consulte
Ejecutar como usuario). Esta misma cuenta debe tener permiso de SUPLANTACIÓN para las
cuentas de usuario de base de datos en SQL Server. Desde una perspectiva de seguridad de
datos, el uso de la cuenta Ejecutar servidor como Tableau para suplantación le da al
administrador el mayor control.
Para configurar suplantación con una cuenta Ejecutar como usuario:
1. Cuando configure Tableau Server como parte de Configuración, bajo Ejecutar
servidor como usuario, ingrese la cuenta Ejecutar como usuario AD que tiene
permiso de SUPLANTACIÓN para las cuentas de usuario. Bajo Autenticación de
usuario, seleccione Usar Active Directory:
2. Haga clic en Aceptar para finalizar la configuración.
3. Cree un libro de trabajo en Tableau Desktop. Cuando crea la conexión de datos,
seleccione Usar seguridad integrada de Windows NT para la conexión en tiempo
real del libro de trabajo para una base de datos de SQL Server:
4. En Tableau Desktop, publique el libro de trabajo en Tableau Server (Servidor >
Publicar libro de trabajo).
5. En el cuadro de diálogo Publicar, haga clic en Autenticación, luego en el cuadro de
diálogo Autenticación, seleccione Suplantar vía cuenta Ejecutar servidor como
desde la lista desplegable:
6. Haga clic en Aceptar.
7. Pruebe la conexión al iniciar sesión en Tableau Server como usuario. Cuando hace clic
en una vista, no se le debe solicitar las credenciales de base de datos y solo debe ver los
datos a los que el usuario tiene autorización para ver.
Suplantar con credenciales SQL incrustadas
También puede realizar suplantación al solicitar a la persona que publica una vista que
incruste sus credenciales de cuenta de SQL Server en la vista. Tableau Server se puede
ejecutar bajo cualquier tipo de cuenta, pero usará estas credenciales, proporcionadas por el
publicador, para conectarse a la base de datos.
Esta puede ser la elección adecuada para el sitio si la cuenta que maneja la suplantación no
puede ser una cuenta AD y si está cómodo al proporcionar a los publicadores de libros de
trabajo una cuenta con un nivel de permiso potencialmente alto en SQL Server.
Nota:
Para usar este enfoque, se deben habilitar las Credenciales incrustadas en Tableau Server:
Para suplantar con la cuenta SQL del publicador de libro de trabajo:
1. En Tableau Desktop, cree un libro de trabajo. Cuando crea la conexión de datos,
seleccione Usar un nombre de usuario y contraseña para la conexión en tiempo real de
la base de datos de SQL Server:
2. Publique el libro de trabajo en Tableau Server (Servidor > Publicar libro de trabajo).
3. En el cuadro de diálogo Publicar, haga clic en Autenticación, luego en el cuadro de
diálogo Autenticación, seleccione Suplantar vía contraseña incrustada desde la lista
desplegable:
4. Haga clic en Aceptar.
5. Pruebe la conexión al iniciar sesión en Tableau Server como usuario. Cuando hace clic
en una vista, no se le debe solicitar las credenciales de base de datos y solo debe ver los
datos a los que el usuario tiene autorización para ver.
Puertos TCP/IP
La siguiente tabla indica los puertos que usa Tableau Server de manera predeterminada y
cuáles están disponibles para unión. Si el firewall de Windows está activado, Tableau Server
abrirá los puertos que necesite; no es necesario que usted lo haga (para las instalaciones
distribuidas con un trabajador que ejecuta Windows 7, consulte la Base de conocimientos de
Tableau).
Utilizado por este
proceso de
Puerto servidor...
80
Puerta de enlace.
TIPO DE INSTALACIÓN
Alta
Todos Distribuida disponibilidad Parámetro
X
gateway.public.port,
worker0.gateway.port
Utilizado por este
proceso de
Puerto servidor...
TIPO DE INSTALACIÓN
Alta
Todos Distribuida disponibilidad Parámetro
443
SSL. Cuando
Tableau Server se
configure para SSL,
el servidor de
aplicaciones redirige
solicitudes a este
puerto.
X
--
3729
Instalación de
Tableau Server.
X
--
37303731
Los servidores de
trabajador de
Tableau en
entornos distribuido
y altamente
disponible (el
Tableau Server
primario no escucha
estos puertos).
8000 8059
Servidor de
aplicación (puerto
base 8000). Se
usan puertos
consecutivos
después de 8000,
hasta el número de
procesos. De
manera
predeterminada,
Tableau Server se
instala con dos
procesos de
servidor de
aplicaciones
(puertos 8000 y
8001).
X
wgserver.port
8060
Base de datos
PostgreSQL.
X
pgsql.port
8061
Firebird.
X
firebird.port
X
X
--
Utilizado por este
proceso de
Puerto servidor...
TIPO DE INSTALACIÓN
Alta
Todos Distribuida disponibilidad Parámetro
8062
Proceso que lleva a
cabo un
descubrimiento en
un entorno
distribuido que se ha
configurado para
alta disponibilidad.
8080
Solr y Tomcat
HTTP.
X
solr.port,
tomcat.http.port1
8250
Tareas de fondo.
X
backgrounder.port
9090
Proceso que lleva a
cabo una replicación
en un entorno
distribuido que se ha
configurado para
alta disponibilidad.
9100 9199
Servidor de
aplicación VizQL
(puerto base 9100).
También se usan
puertos
consecutivos
después de 9100,
hasta el número de
procesos. De
manera
predeterminada,
Tableau Server se
instala con dos
procesos VizQL
Server (puertos
9100 y 9101).
X
vizqlserver.port
9700 9899
Servidor de datos
(puerto base 9700).
También se usan
puertos
X
dataserver.port
X
X
1Estos parámetros se deben establecer en el mismo valor.
pgsql.initport
rsync.port
Utilizado por este
proceso de
Puerto servidor...
TIPO DE INSTALACIÓN
Alta
Todos Distribuida disponibilidad Parámetro
consecutivos
después de 9700,
hasta el número de
procesos. De
manera
predeterminada,
Tableau Server se
instala con dos
procesos de
servidor de datos
(puertos 9700 y
9701).
27000
27009
Servidores primario
y de trabajadores
para comunicar
información de
licenciamiento en
entornos distribuido
y altamente
disponible.
X
X
--
Un puerto adicional
se escoge en forma
dinámica para que
los trabajadores y el
servidor primario
comunique
información de
licenciamiento en
entornos distribuido
y altamente
disponible. En lugar
de esto, puede
especificar un
puerto fijo (se
recomienda 27010).
Consulte la Base de
conocimiento de
Tableau para
obtener detalles.
Las instalaciones en
X
X
--
Utilizado por este
proceso de
Puerto servidor...
TIPO DE INSTALACIÓN
Alta
Todos Distribuida disponibilidad Parámetro
las que el servidor
primario está en una
zona desmilitarizada
deben usar estas
instrucciones.
27042
Motor de datos.
Tableau Server se
instala con un
proceso de motor de
datos. Pueden
haber hasta dos
procesos de motor
de datos por nodo,
en hasta dos nodos
en un conjunto.
27043
La inicialización del
motor de datos en
un entorno
distribuido que se
haya configurado
para alta
disponibilidad.
X
dataengine.port
X
Editar los puertos predeterminados
Puede modificar los puertos predeterminados usados por los procesos de Tableau Server
usando la herramienta administrativa de línea de comandos, tabadmin. Por ejemplo, el puerto
predeterminado para el proceso de servidor de aplicaciones (wgserver) es 8000. Puede
usar el parámetro tabadmin workerX.wgserver.port para cambiarlo a un puerto
diferente. Siga los pasos a continuación para cambiar la configuración de puertos de Tableau
Server. Si va a habilitar los puertos JMX del servidor, consulte los Habilitar los puertos JMX
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd “C:\Program Files\Tableau\Tableau Server\8.1\bin”
2. Modifique el valor de un puerto al escribir lo siguiente:
tabadmin set <workerX>.<parameter> <new port value>
En el comando anterior, <workerX> se refiere a la máquina cuyo puerto desea
cambiar, <parameter> es uno de los valores de la tabla a continuación (el puerto de
un proceso de servidor, como por ejemplo wgserver.port), y <new port value>
es el número del puerto nuevo que desea que el proceso de servidor utilice. Si se
ejecuta Tableau Server en una máquina, <workerX> es worker0. Si va ejecutar un
conjunto, worker0 es el primario, worker1 es su primer servidor de trabajador,
worker2 el segundo, y así sucesivamente. En este último caso, necesitará ejecutar el
comando (a partir de una línea de comando en el primario) una vez para cada máquina
del conjunto.
El siguiente es un ejemplo que define el puerto en el servidor primario o independiente
en 8020 para el proceso de servidor de aplicaciones (wgserver):
tabadmin set worker0.wgserver.port 8020
El siguiente ejemplo establece el puerto para un conjunto de 3 máquinas (una primaria y
los trabajadoras) en 9200 para el proceso de servidor VizQL.
tabadmin set worker0.vizqlserver.port 9200
tabadmin set worker1.vizqlserver.port 9200
tabadmin set worker2.vizqlserver.port 9200
Puede usar los siguiente parámetros para modificar los puertos correspondientes;
consulte Puertos TCP/IP para obtener una lista completa de los parámetros tabadmin
que se pueden establecer.
Puerto para cambio Parámetro
80
gateway.public.port, worker0.gateway.port
8000
wgserver.port
8060
pgsql.port
8080
solr.port, tomcat.http.port1
9100
vizqlserver.port
9700
dataserver.port
3. Después de realizar los cambios necesarios en la configuración de puertos, reinicie
Tableau Server escribiendo lo siguiente:
tabadmin restart
1Estos parámetros se deben establecer en el mismo valor.
Mientras el servidor reinicia, no estará disponible para todos los usuarios. Asegúrese de
advertir a los usuarios sobre la suspensión del servicio antes de esta operación o
programar este mantenimiento durante horas no comerciales.
Habilitar los puertos JMX
Para ayudarle a trabajar mediante un problema con Tableau Server, Tableau Support puede
pedirle que habilite los puertos JMX del servidor. Estos puertos pueden ser útiles para
supervisar y solucionar problemas, normalmente con una herramienta como JConsole.
Para habilitar los puertos JMX en Tableau Server:
1. Detenga el servidor.
2. Escriba el siguiente comando:
tabadmin set service.jmx_enabled true
3. Escriba el comando de configuración:
tabadmin configure
4. Inicie el servidor.
Lista de puertos JMX
A continuación hay una lista de puertos JMX, que están todos deshabilitados de forma
predeterminada. Al habilitar estos puertos, se usan para todos los tipos de instalaciones: un
solo servidor, distribuida y de altamente disponible:
Puerto Utilizado por este proceso de servidor...
Parámetro
8300 8359
Servidor de aplicación JMX. Determinado por los puertos de
servidor de aplicaciones + 300.
--
8550
JMX de monitor de componente de segundo plano.
Determinado por el puerto de componente de segundo plano
8250 + 300.
--
9095
JMX de supervisión de servicios.
svcmonitor.jmx.port
9400 9499
JMX de servidor VizQL. Determinado por los puertos de
servidor VizQL + 300.
--
10000
10299
JMX de servidor de datos. Determinado por los puertos del
servidor de datos + 300.
--
Cómo se determinan los puertos JMX
Los puertos JMX para el servidor de aplicaciones (8300 - 8359), componente de segundo
plano (8550), VizQL server (9400 - 9599) y el servidor de datos (10000 - 10299) se asignan
usando la fórmula “puerto base + 300” (consulte Puertos TCP/IP para ver una lista de los
puertos de base predeterminados). Además, si hay varias instancias de un proceso, cada una
tendrá un puerto JMX.Por ejemplo, si configura Tableau Server para que ejecute cuatro inicia
instancias del proceso de servidor de aplicaciones, se utilizan los puertos 8000 (puerto base
predeterminado), 8001, 8002 y 8003.Los puertos JMX del servidor de aplicaciones 8300
(puerto base + 300), 8301, 8302 y 8303 están unidos a sus respectivas instancias de proceso.
Aunque Tableau Server no los usa directamente, si un puerto JMX está siendo usado por otra
aplicación, no se ejecutarán los procesos de Tableau Server. Además, los puertos JMX no se
pueden editar directamente usando tabadmin. Usted cambia un puerto JMX cambiando el
puerto base de su proceso. En otras palabras, si el puerto 10000 no está disponible para el
proceso JMX del servidor de datos, puede usar tabadmin (como se describe en Editar los
puertos predeterminados) para cambiar el puerto base del servidor de datos de 9700 a 9800.
Esto cambiará el puerto JMX del servidor de datos a 11000.
Para reducir los riesgos de seguridad, es una práctica recomendada configurar su firewall
para que bloquee todo el tráfico exterior hacia los puertos JMX.
Restaurar el valor predeterminado de un puerto
Puede restaurar el valor predeterminado para un puerto al seguir el procedimiento a
continuación:
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd “C:\Program Files\Tableau\Tableau Server\8.1\bin”
2. Restaure el puerto predeterminado al escribir lo siguiente:
tabadmin set <workerX>.<parameter> --default
Si se ejecuta Tableau Server en una máquina, <workerX> es worker0. Si va ejecutar
un conjunto, worker0 es el primario, worker1 es su primer servidor de trabajador,
worker2 el segundo, y así sucesivamente.
Este es un ejemplo:
tabadmin set worker0.wgserver.port --default
3. Reinicie Tableau Server escribiendo lo siguiente:
tabadmin restart
tabcmd
La utilidad tabcmd es una de las dos herramientas de línea de comando que se instala con
Tableau Server (la otra es tabadmin). Los comandos que se proporcionan a través de tabcmd
pueden ayudarle a automatizar tareas comunes, como la publicación de libros de trabajo en
lotes y la administración de usuarios y grupos. La utilidad tabcmd se instala en la carpeta bin de
Tableau Server (C:\Archivos de programa\Tableau Server\8.1\bin), pero puede instalarla y
ejecutarla en otra máquina. Consulte los siguientes temas para obtener más información:
Instalar tabcmd
La utilidad de línea de comando tabcmd se instala de forma predeterminada con Tableau
Server y se puede ejecutar desde el directorio de la agrupación del servidor (por ejemplo,
C:\Program Files\Tableau\Tableau Server\8.1\bin). Para flexibilidad administrativa, se puede
instalar también en otra máquina.
Para instalar tabcmd:
1. Navegue a la carpeta de extras en Tableau Server:
C:\Program Files\Tableau\Tableau
Server\8.1\extras\TabcmdInstaller.exe
2. Copie TabcmdInstaller.exe a la computadora donde desea realizar la instalación.
3. Haga doble clic en TabcmdInstaller.exe para ejecutarlo.
4. Siga las instrucciones para instalar tabcmd.
Debido a que tabcmd es una herramienta de la línea de comando, y debido a algunas
limitaciones con el sistema operativo de Windows, Tableau sugiere instalar tabcmd en
su propia carpeta tabcmd en la raíz de C:\ drive (C:\tabcmd).
La ejecución del programa de configuración de tabcmd no agrega de manera
automática tabcmd a la variable PATH de Windows, deberá llamar de manera explícita
a tabcmd mediante la ruta completa o agregar su directorio a la variable PATH.
Cómo usar tabcmd
El primer paso para usar tabcmd es abrir una línea de comando como administrador.
Entonces debe navegar hasta el directorio de la agrupación de Tableau Server (por ejemplo,
C:\Program Files\Tableau\Tableau Server\8.1\bin) o incluir esa ubicación en sus comandos.
Para usar tabcmd para realizar tareas en Tableau Server, debe establecer una sesión de
servidor autenticada. La sesión identifica al a Tableau Server y al usuario Tableau Server que
ejecuta la sesión. Primero puede iniciar una sesión, luego especificar su siguiente comando o
puede iniciar una sesión y ejecutar un comando, todo a la vez.
El siguiente comando demuestra cómo iniciar una sesión con Tableau Server denominada
tabserver.myco.com:
tabcmd login -s http://tabserver.myco.com -u admin -p [email protected]!
Este es un comando que elimina el libro de trabajo denominado Sales_Workbook:
tabcmd delete "Sales_Workbook"
Así se logra todo lo anterior con un comando: observe que no necesita login aquí:
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -u
admin -p [email protected]!
Tableau Server puede ejecutar varios sitios. Cuando hay un libro de trabajo en el sitio
Predeterminado de un servidor de varios sitios, no necesita especificar Predeterminado, basta
con el comando anterior. Sin embargo, si el comando se aplica a algo del sitio que no sea
Predeterminado, necesita especificar la Id. de sitio para dicho sitio (consulte login). Este es el
mismo comando para un libro de trabajo que está en el sitio Ventas de la costa oeste (Id. de
sitio wsales):
tabcmd delete "Sales_Workbook" -s http://tabserver.myco.com -t
wsales -u admin -p [email protected]!
Las opciones -s, -t, -u y -p están entre las variables globales de tabcmd, lo que significa
que se pueden usar con cualquier comando.
Cuando el comando es exitoso, tabcmd arroja un código de estado cero. Un mensaje de error
completo para códigos de estado que no son cero se imprime en stderr. Además, es posible
que se impriman mensajes informativos o de progreso en stdout. Un registro completo con el
nombre tabcmd.log, incluidos mensajes de depuración, progreso y error, se escribe en:
l
l
Windows Server 2012, Windows Server 2008 R2, Windows Vista, Windows 7,
Windows 8: C:\Users\<username>\AppData\Roaming\Tableau
Windows Server 2003: C:\Documents and Settings\<username>\Application
Data\Tableau
Opciones globales de tabcmd
La tabla a continuación muestra las opciones usadas por todos los comandos. Las opciones -server, --user y --password se requieren al menos una vez para comenzar una
sesión. Se almacena un token de autenticación de forma que se pueda ejecutar comandos
posteriores sin incluir estas opciones. Este token permanece válido por cinco minutos después
del último comando que lo usó.
Opción Opción
(corto) (largo)
Argumento
Descripción
Muestra la ayuda para el
comando.
-h
--help
-s
--server
Tableau Server
URL
Se requiere al menos una vez
para iniciar sesión.
-u
--user
Nombre de usuario
de Tableau Server
Se requiere al menos una vez
para iniciar sesión.
-p
-password
Contraseña de
Tableau Server
Se requiere al menos una vez
para iniciar sesión. De forma
alternativa puede usar la opción
-P.
-P
Permite el almacenamiento de la
-contraseña en el archivo
password- nombredearchivo.txt determinado en lugar de la línea
file
de comando para mayor
seguridad.
-t
--site
Tableau
Servernombre del
sitio
Especifica que el comando se
aplica al sitio Tableau Server
especificado. Si no especifica un
sitio, se asume el sitio
Predeterminado. Solo se aplica a
servidores con sitios múltiples.
-x
--proxy
Host:Port
Usa el proxy HTTP especificado.
--noprompt
Cuando se especifica, el
comando no solicita una
contraseña. Si no se proporcionó
una contraseña válida el
comando fallará.
--noproxy
Cuando se especifica, no se usa
un proxy HTTP.
--nocertcheck
Cuando se especifica, no se
valida el certificado SSL.
--[no-]
cookie
Cuando se especifica, la ID de
sesión se guarda en el inicio de
sesión para que los comandos
posteriores no requieran que se
inicie sesión. Use el prefijo nopara no guardar la ID de sesión.
La sesión de guarda de manera
Opción Opción
(corto) (largo)
Argumento
Descripción
predeterminada.
--timeout segundos
Espera el número de segundos
especificado para que el servidor
finalice el procesamiento del
comando. De forma
predeterminada el tiempo de
espera del proceso expirará en
30 segundos.
Comandos tabcmd
Aquí están los comandos que se pueden usar con herramienta de línea de comando tabcmd:
addusers group-name
creategroup group-name
createproject project-name
createsite site-name
createusers filename.csv
createusers filename.csv
delete workbook-name o datasource-name
deletegroup group-name
deletesite site-name
deleteusers filename.csv
editsite site-name
export
get url
listsites
login
logout
publicar
filename.twb
(x),
filename.tds(x)
o filename.tde
refreshextracts
workbookname o
datasourcename
removeusers
group-name
runschedule
schedulename
set setting
syncgroup
group-name
version
addusers group-name
Agrega los usuarios indicados en el argumento --users al grupo con el nombre-grupo
determinado.
Ejemplo
tabcmd addusers "Development" --users "users.csv"
Opción
Opción (largo)
(corto)
--users
Argumento Descripción
Agregue los usuarios en el
archivo determinado al grupo
especificado. El archivo debe
ser una lista simple con un
filename.csv nombre de usuario por línea.
Los usuarios ya deben estar
creados en Tableau Server.
Consulte también Importar
usuarios desde un archivo CSV.
--[no-]complete
Al establecerse en complete
esta opción requiere que todas
las filas sean válidas para que
cualquier cambio tenga éxito. Si
no se especifica, se usa -complete.
creategroup group-name
Crea un grupo con el nombre de grupo determinado. Use comandos addusers (para grupos
locales) y syncgroup (para grupos de Active Directory) para agregar usuarios después de
creado el grupo. U
Ejemplo
tabcmd creategroup "Development"
createproject project-name
Crea un proyecto con el nombre de proyecto determinado.
Ejemplo
tabcmd createproject -n "Quarterly_Reports" -d "Workbooks showing
quarterly sales reports."
Opción
(corto)
Opción
(largo)
Argumento Descripción
-n
--name
nombre
-d
-descripción
description
Especifique el nombre del
proyecto que desea crear.
Especifique una descripción para
el proyecto.
createsite site-name
Crea un sitio con el nombre de sitio determinado.
Ejemplos
Crear un sitio con el nombre West Coast Sales. Una ID de sitio de WestCoastSales se
creará automáticamente, el sitio no tendrá límite de cuota de almacenamiento y los
administradores del sitio podrán agregar y eliminar usuarios:
tabcmd createsite "West Coast Sales"
Crear un sitio con el nombre West Coast Sales y con la ID de sitio wsales:
tabcmd createsite "West Coast Sales" -r "wcoast"
Evitar que los administradores del sitio agreguen usuarios al sitio:
tabcmd createsite "West Coast Sales" --no-site-mode
Definir una cuota de almacenamiento en MB:
tabcmd createsite "West Coast Sales" --storage-quota 100
OpciOpción
ón
(cor- (largo)
to)
Argumento
Descripción
-r
--url
ID de sitio
Se utiliza en las URL para especificar el sitio. Es diferente
al nombre del sitio.
-userquota
número de
usuarios
La cantidad máxima de usuarios que es posible agregar al
sitio.
-[no-]
site-
Permitir o denegar a los administradores del sitio la
capacidad de agregar o eliminar usuarios del sitio.
OpciOpción
ón
(cor- (largo)
to)
Argumento
Descripción
mode
-storag- número de
eMB
quota
La cantidad en MB de libros de trabajo, extractos y
fuentes de datos que se pueden almacenar en el sitio.
createsiteusers filename.csv
Este comando permite que los administradores de sitio agreguen usuarios al sitio. Crea los
usuarios en el sitio actual, utilizando el archivo de valores separados por comas (CSV)
determinado. El archivo puede tener las siguientes columnas, en el orden que se muestra a
continuación:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (site/none)
6. Publisher (yes/true/1 o no/false/0)
7. Email Address
El archivo puede tener menos columnas. Por ejemplo puede ser una lista simple con un
nombre de usuario por línea. Cuando el servidor usa autenticación de Active Directory, la
columna Password debe ser ignorada.Se puede usar comillas si un valor contiene comas.
Consulte Importar usuarios desde un archivo CSV para conocer otros detalles.
Ejemplo
tabcmd createsiteusers "users.csv" --license "Interactor" -publishers
Opción Opción
(corto) (largo)
Argumento
Descripción
--nowait
No espere la finalización de trabajos
asíncronos.
--silentprogress
No muestre mensajes de progreso
para trabajos asíncronos.
Opción Opción
(corto) (largo)
--license
--admintype
Argumento
Descripción
Establece el nivel de licencia
Interactor
predeterminado para todos los
, Viewer, o
usuarios. El valor del archivo CSV
Unlicensed
puede anular esta configuración.
Site o None
Asigna o elimina el derecho de
administrador de sitio a todos los
usuarios en el archivo CSV. El valor
del archivo CSV puede anular esta
configuración. El valor
predeterminado es None para
usuarios nuevos y sin cambios para
usuarios existentes. Los
administradores del sistema no
pueden crearse o quitarles derechos
utilizando createsiteusers (en
su lugar, use createusers).
--[no-]
publishers
Asigna o elimina el derecho de
Publicación a todos los usuarios en
el archivo CSV de forma
predeterminada. El valor del archivo
CSV puede anular esta
configuración. El valor
predeterminado es no para usuarios
nuevos y sin cambios para usuarios
existentes.
--[no-]
complete
Requiere (o no requiere) que todas
las filas sean válidas para que
cualquier cambio tenga éxito. De
forma predeterminada, se usa la
opción --complete.
createusers filename.csv
Crea los usuarios indicados en el archivo (CSV) de valores separados por comas
determinado. Este comando solo lo pueden usar los administradores de sistema. El archivo
puede tener las siguientes columnas, en el orden que se muestra a continuación:
1. Username
2. Password
3. Full Name
4. License Level (interactor/viewer/unlicensed)
5. Administrator (system/site/none)
6. Publisher (yes/true/1 o no/false/0)
7. Email Address
El archivo puede tener menos columnas. Por ejemplo puede ser una lista simple con un
nombre de usuario por línea. Cuando el servidor usa autenticación de Active Directory, la
columna de Password debe quedar en blanco. Se puede usar comillas si un valor contiene
comas. Consulte Importar usuarios desde un archivo CSV para conocer otros detalles.
Ejemplo
tabcmd createusers "users.csv" --license "Interactor" --publisher
Opción Opción
(corto) (largo)
Argumento
Descripción
--nowait
No espere la finalización de trabajos
asíncronos.
--silentprogress
No muestre mensajes de progreso
para trabajos asíncronos.
Establece el nivel de licencia
Interactor
predeterminado para todos los
--license , Viewer, o
usuarios. El valor del archivo CSV
Unlicensed
puede anular esta configuración.
--admintype
Asigna o elimina el derecho de
administrador a todos los usuarios en
el archivo CSV de forma
System,
predeterminada. El valor del archivo
Site, o None CSV puede anular esta configuración.
El valor predeterminado es None
para usuarios nuevos y sin cambios
para usuarios existentes.
--[no-]
publisher
Asigna el derecho de publicación a
todos los usuarios en el archivo CSV
de forma predeterminada. El valor del
archivo CSV puede anular esta
configuración. El valor
predeterminado es no para usuarios
nuevos y sin cambios para usuarios
existentes.
--[no-]
Requiere que todas las filas sean
Opción Opción
(corto) (largo)
Argumento
Descripción
válidas para que cualquier cambio
tenga éxito. De forma
predeterminada, se usa la opción -complete.
complete
delete workbook-name o datasource-name
Elimina la fuente de datos o libro de trabajo determinado del servidor. Este comando toma el
nombre del libro de trabajo o fuente de datos como está en el servidor, no el nombre de archivo
cuando se publicó.
Ejemplo
tabcmd delete "Sales_Analysis"
Opción Opción
(corto) (largo)
-r
--project
Argumento Descripción
Nombre de
proyecto
El nombre del proyecto que contiene el
libro de trabajo o fuente de datos que
desea eliminar. Si no se especifica, se
asume el proyecto “Predeterminado”.
Nombre de
--workbook libro de
trabajo
El nombre del libro de trabajo que
desea eliminar.
Nombre de
-fuente de
datasource
datos
El nombre de la fuente de datos que
desea eliminar.
deletegroup group-name
Elimina el grupo con el nombre-grupo determinado del servidor.
Ejemplo
tabcmd deletegroup "Development"
deletesite site-name
Elimina el sitio con el nombre-sitio determinado del servidor.
Ejemplo
tabcmd deletesite "Development"
deleteusers filename.csv
Elimina los usuarios indicados en el archivo (CSV) separado por comas determinado. El
archivo es una lista simple de un nombre de usuario por línea.
Ejemplo
tabcmd deleteusers "users.csv"
Opción Opción
(corto) (largo)
Argumento Descripción
--[no-]
complete
Al establecerse en --complete esta
opción requiere que todas las filas sean
válidas para que cualquier cambio tenga
éxito. Si no se especifica, se usa -complete.
createsite site-name
Le permite cambiar el nombre de un sitio o el nombre de su carpeta Web. También puede usar
este comando para permitir o denegar a los administradores de sitio la capacidad de agregar y
eliminar usuarios. Si los administradores de sitio tienen derechos de administración, usted
puede especificar cuántos usuarios pueden agregar a un sitio.
Ejemplos
tabcmd editsite wc_sales --site-name "West Coast Sales"
tabcmd editsite wc_sales --site-id "wsales"
tabcmd editsite wsales --status ACTIVE
tabcmd editsite wsales --user-quota 50
Opción
(largo)
Argumento
Descripción
--sitename
Nombre al que se
quiere cambiar el
sitio
El nombre del sitio que se muestra.
Opción
(largo)
Argumento
Descripción
--siteid
La ID del sitio a la
que se quiere
cambiar el sitio
Se utiliza en la URL para identificar al sitio
de manera exclusiva.
--userquota
Número de
usuarios
La cantidad máxima de usuarios que
pueden ser miembros del sitio.
--[no-]
sitemode
--status
Permitir o evitar que los administradores del
sitio agreguen usuarios al sitio.
ACTIVO o
SUSPENDIDO
-storage- Número de MB
quota
Activar o suspender un sitio.
La cantidad en MB de libros de trabajo,
extractos y fuentes de datos que se pueden
almacenar en el sitio.
export
Exporta una vista o libro de trabajo desde Tableau Server y lo guarda en un archivo. Tenga en
cuenta lo siguiente cuando utilice el siguiente comando:
l
l
Permisos: Para exportar, debe tener el permiso Exportar imagen. De manera
predeterminada, este permiso es Permitido o Heredado para todos los roles, sin
embargo, los permisos pueden configurarse por libro de trabajo o vista.
La vista, el libro de trabajo o los datos que se están importando. Puede
especificar esto usando la cadena "workbook/view" como aparece en la URL para
el libro de trabajo o vista, sin utilizar “Sobrenombres”. Por ejemplo, para exportar la vista
de ejemplo Crecimiento de la inversión del libro de trabajo Finanzas, utilizaría la cadena
Finance/InvestmentGrowth.Utilice -t <site_id> si el servidor se ejecuta en
sitios múltiples y la vista o el libro de trabajo están en un sitio distinto al predeterminado.
Para exportar un libro de trabajo, también tiene que incluir una vista válida en la cadena
que use. Siguiendo con el ejemplo anterior, para exportar el libro de trabajo Finanzas,
tendría que usar la cadena Finance/InvestmentGrowth. Por último, para exportar
un libro de trabajo, tiene que haber sido publicado como Mostrar hojas como
pestañas seleccionada en el cuadro de diálogo Publicar de Tableau Desktop.
l
El formato del archivo guardado: Las opciones de formato dependen de lo que se
esté exportando. Un libro de trabajo solamente se puede exportar como PDF usando el
argumento --fullpdf . Una vista puede exportarse como PDF (--pdf), como PNG
(--png) o puede exportar los datos de la vista como un archivo CSV (--csv).
l
l
El nombre y la ubicación del archivo guardado (opcional). Si no proporciona un
nombre, será derivado del nombre del libro de trabajo o de la vista. Si no proporciona
una ubicación, el archivo se guardará en el directorio en el que está trabajando
actualmente. De lo contrario, puede especificar una ruta completa o una que esté
asociada al directorio en el que trabaja actualmente.
Los objetos de la página Web del dashboard no se incluyen en las
exportaciones de PDF: De manera opcional, un dashboard puede incluir un objeto de
página Web. Si realiza una exportación a PDF de un dashboard que incluye un objeto
de página Web, este último no se incluirá en el PDF.
Limpieza de la memoria caché para usar datos en tiempo real
De manera opcional, puede agregar el parámetro de URL ?:refresh=yes para forzar una
consulta de datos actualizada en lugar de sacar los resultados de la memoria caché. Si utiliza
tabcmd con su propio script y el parámetro de URL refresh se usa mucho, esto puede
causar un impacto negativo en el rendimiento. Se recomienda usar refresh solo cuando se
requieran datos en tiempo real: por ejemplo, en un dashboard individual en lugar de en un libro
de trabajo completo.
Ejemplos
Vistas
tabcmd export "Q1Sales/Sales_Report" --csv -f "Weekly-Report"
tabcmd export -t Sales "Sales/Sales_Analysis" --pdf -f
"C:\Tableau_Workbooks\Weekly-Reports"
tabcmd export "Finance/InvestmentGrowth" --png
tabcmd export "Finance/InvestmentGrowth?:refresh=yes" --png
Libros de trabajo
tabcmd export "Q1Sales/Sales_Report" --fullpdf
tabcmd export -t Sales "Sales/Sales_Analysis" --fullpdf -pagesize tabloid -f "C:\Tableau_Workbooks\Weekly-Reports"
Opción Opción
(corto) (largo)
Argumento
Descripción
-f
Nombre para guardar el
archivo como
Guarda el archivo con el
nombre de archivo
determinado.
--filename
--csv
Solo vista. Exporte los
datos de la vista en
formato CSV.
--pdf
Solo vista. Exportar
Opción Opción
(corto) (largo)
Argumento
Descripción
como PDF
--png
Solo vista. Exportar una
imagen en formato
PNG.
--fullpdf
Solo libro de trabajo.
Exportar como PDF El
libro de trabajo tiene
que haber sido
publicado con la función
Mostrar hojas como
pestañas habilitada.
-landscape,
pagelayout portrait
Configura la página en
la misma orientación
que el PDF exportado.
Si no se especifica, se
utilizará la configuración
de Tableau Desktop.
unspecified,
letter, legal,
note folio,
tabloid, ledger,
--pagesize
statement,
executive, a3,
a4, a5, b4, b5,
quatro
Configura la página en
el mismo tamaño que el
PDF exportado. El valor
predeterminado es
(letter)
--width
Número de píxeles
Define el ancho. El valor
predeterminado es 800
px.
--height
Número de píxeles
Define la altura. El valor
predeterminado es 600
px.
get url
Usar una cadena URL como uno de sus parámetros, hace que un HTTP “OBTENGA” un
pedido de Tableau Server. El resultado vuelve como un archivo. Tenga en cuenta lo siguiente
cuando utilice el siguiente comando:
l
l
l
l
Permisos: Para obtener un archivo, debe tener el permiso Descargar/Guardar en
Web como. De manera predeterminada, este permiso es Permitido o Heredado para
todos los roles, sin embargo, los permisos pueden configurarse por libro de trabajo o
vista.
Extensión del archivo: La cadena URL del archivo que desea OBTENER debe incluir
una extensión de archivo, como por ejemplo
"/views/Finance/InvestmentGrowth.pdf". La extensión (por ejemplo, .pdf)
determina lo que se devuelve. Se puede devolver una vista en formato PDF, PNG, CSV
(solo datos) o XML (solo información). Un libro de trabajo se puede devolver en formato
TWB o TWBX. Para saber qué extensión utilizar, puede utilizar un navegador Web y
buscar el elemento en el que está interesado en Tableau Server y agregar la extensión
del archivo al final de la URL.
El nombre y la ubicación del archivo guardado (opcional). El nombre que utiliza
para --filename debe incluir la extensión del archivo. Si no proporciona un nombre y
extensión de archivo, ambos se derivarán de la cadena URL. Si no proporciona una
ubicación, el archivo se guardará en el directorio en el que está trabajando actualmente.
De lo contrario, puede especificar una ruta completa o una que esté asociada al
directorio en el que trabaja actualmente.
Tamaño PNG (opcional): Si el archivo guardado es un PNG, puede especificar el
tamaño, en píxeles, en la URL.
Limpieza de la memoria caché para usar datos en tiempo real
De manera opcional, puede agregar el parámetro de URL ?:refresh=yes para forzar una
consulta de datos actualizada en lugar de sacar los resultados de la memoria caché. Si utiliza
tabcmd con su propio script y el parámetro de URL refresh se usa mucho, esto puede
causar un impacto negativo en el rendimiento. Se recomienda usar refresh solo cuando se
requieran datos en tiempo real: por ejemplo, en un dashboard individual en lugar de en un libro
de trabajo completo.
Ejemplos
Vistas
tabcmd get "/views/Sales_Analysis/Sales_Report.png" --filename
"Weekly-Report.png"
tabcmd get "/views/Finance/InvestmentGrowth.pdf" -f
"Q1Growth.pdf"
tabcmd get "/views/Finance/InvestmentGrowth.csv"
tabcmd get "/views/Finance/InvestmentGrowth.png?:size=640,480" -f
growth.png
tabcmd get "/views/Finance/InvestmentGrowth.png?:refresh=yes" -f
growth.png
Libros de trabajo
tabcmd get "/workbooks/Sales_Analysis.twb" -f "C:\Tableau_
Workbooks\Weekly-Reports.twb"
tabcmd get "/workbooks/Sales.xml"
Otro
tabcmd get "/users.xml" --filename "UserList.xml"
Opción
(corto)
Opción
(largo)
-f
Nombre para
-guardar el archivo
filename
como
Argumento
Descripción
Guarda el archivo con el
nombre de archivo
determinado.
listsites
Arroja una lista de sitios a los cuales pertenece el usuario con sesión iniciada.
Ejemplo
tabcmd listsites -u corman -pw [email protected]!
login
Inicia sesión de un usuario de Tableau Server. Use las opciones globales --server, -site, --username, --password para crear una sesión. Si desea iniciar sesión con la
misma información que ha usado para crear una sesión simplemente especifique la opción -password. Se usarán el servidor y nombre de usuario almacenados en la cookie.
Si el servidor está usando un puerto que no sea 80 (el predeterminado) deberá especificar
cuál.
Solo necesita la opción --site (-t) si el servidor ejecuta múltiples sitios e inicia sesión en un
sitio distinto al predeterminado. Si no proporciona una contraseña se le solicitará una. Si se
especifica la opción --no-prompt y no se proporciona contraseña, el comando fallará.
Luego del inicio de sesión, la sesión continuará hasta que expire en el servidor o se ejecute el
comando logout.
Ejemplo
Inicia su sesión en Tableau Server que se está ejecutando en su máquina local:
tabcmd login -s http://localhost -u jsmith -p [email protected]!
tabcmd login -s https://online.tableausoftware.com/t/oursite -u
[email protected] -p [email protected]
Inicia su sesión en el sitio de ventas del servidor de ventas:
tabcmd login -s http://sales-server -t Sales -u administrator -p
[email protected]!
tabcmd login -s http://sales-server:8000 -t Sales -u
administrator -p [email protected]!
Inicia su sesión en el sitio de ventas del servidor de ventas utilizando SSL:
tabcmd login -s https://sales-server -t Sales -u administrator -p
[email protected]!
Establece un puerto y un proxy de reenvío para el host local:
tabcmd login --proxy myfwdproxyserver:8888 -s http://localhost -u
jsmith -p [email protected]!
Inicia su sesión en el proxy inverso utilizando SSL:
tabcmd login -s https://myreverseproxy -u jsmith -p [email protected]!
Opción Opción
(corto) (largo)
-s
Argumento Descripción
URL de
--server Tableau
Server
ID de sitio
del sitio de
Tableau
Server
-t
--site
-u
Nombre de
-usuario de
username Tableau
Server
Si ejecuta el comando desde la
computadora de Tableau Server,
puede usar http://localhost. De lo
contrario, especifique la URL de la
computadora, como
http://bigbox.myco.com o
http://bigbox.
La ID del sitio. Es la que se utiliza en
la URL para identificar al sitio de
manera exclusiva. Por ejemplo, un
sitio con el nombre West Coast
Sales puede tener la ID de sitio
WestCoastSales. Use esta opción
si el servidor ejecuta múltiples sitios
e inicia sesión en un sitio distinto al
predeterminado.
El nombre de usuario del usuario de
Tableau Server.
Opción Opción
(corto) (largo)
Argumento Descripción
-p
contraseña
-de Tableau
password
Server
-x
--proxy
Host:Port
Contraseña para el usuario de
Tableau Server. Si no proporciona
una contraseña se le solicitará una.
Se utiliza para especificar el
servidor proxy HTTP y el puerto
para la solicitud de tabcmd.
--noprompt
No solicite una contraseña. Si no se
especifica una contraseña, el
comando login fallará.
--noproxy
No utilizar un servidor proxy HTTP.
--[no-]
cookie
Guarda la ID de sesión al inicio de
sesión. Los comandos
subsiguientes no requerirán un
inicio de sesión. Las cookies están
habilitadas (--cookie) de manera
predeterminada.
-timeout
SECONDS
Número de
segundos
El número de segundos que el
servidor debe esperar antes de
procesar el comando login.
Predeterminado: 30 segundos.
logout
Cierra sesión del servidor.
Ejemplo
tabcmd logout
publicar filename.twb(x), filename.tds(x) o filename.tde
Publica el libro de trabajo determinado (.twb(x)), la fuente de datos (.tds(x)) o el extracto de
datos (.tde) en Tableau Server. De forma predeterminada, todas las hojas del libro de trabajo
se publican sin nombres de usuario de base de datos o contraseñas.
Ejemplo
tabcmd publish "analysis.twbx" -n "Sales_Analysis" --db-user
"jsmith" --db-password "[email protected]"
Opción Opción
(corto) (largo)
Argumento Descripción
-n
Nombre de
la fuente de
datos o libro
de trabajo
determinado
en el
servidor.
-o
-r
--name
Si se omite, el libro de trabajo,
la fuente de datos o el extracto
de datos recibirá el nombre del
archivo.
--overwrite
Sobrescribe el libro de trabajo,
fuente de datos o extracto de
datos si ya existe en el
servidor.
--project
Publica el libro de trabajo,
fuente de datos o extracto de
datos en el proyecto
especificado. Publica en el
proyecto “Predeterminado”si
no está especificado.
Nombre de
un proyecto
--dbusername
Use esta opción para publicar
un nombre de usuario de base
de datos con el libro de trabajo,
fuente de datos o extracto de
datos.
--dbpassword
Use esta opción para publicar
una contraseña de base de
datos con el libro de trabajo,
fuente de datos o extracto de
datos.
--save-dbpassword
Almacena la contraseña de
base de datos proporcionada
en el servidor.
-thumbnailusername
Si el libro de trabajo contiene
filtros de usuarios, las
miniaturas se generarán
según lo que el usuario
especificado puede ver. No se
puede especificar cuando se
establece la opción -thumbnail-group.
Opción Opción
(corto) (largo)
Argumento Descripción
-thumbnailgroup
Si el libro de trabajo contiene
filtros de usuarios, las
miniaturas se generarán
según lo que el grupo
especificado puede ver. No se
puede especificar cuando se
establece la opción -thumbnail-username.
--tabbed
Cuando se publica un libro de
trabajo con vistas tabuladas,
cada hoja se convierte en una
pestaña que los visores
pueden usar para navegar por
el libro de trabajo. Tenga en
cuenta que esta configuración
anulará cualquier seguridad de
nivel de hoja.
--append
Agrega el archivo de extracto a
la fuente de datos existente.
--replace
Usar el archivo de extracto
para reemplazar la fuente de
datos existente.
--disableuploader
Deshabilitar el cargador de
archivos incremental.
--disabletdecompression
Detener la compresión del
archivo de extracto antes de
que se cargue.
--restart
Reiniciar la carga del archivo.
Si el libro de trabajo contiene filtros de usuarios, se debe especificar una de las opciones de
miniatura.
refreshextracts workbook-name o datasource-name
Realiza una actualización completa o incremental de los extractos que pertenecen a la fuente
de datos o libro de trabajo especificado. Este comando toma el nombre del libro de trabajo o
fuente de datos como aparece en el servidor, no el nombre de archivo cuando se publicó.
Ejemplos
tabcmd refreshextracts --datasource sales_ds
tabcmd refreshextracts --workbook "My Workbook"
tabcmd refreshextracts --url SalesAnalysis
Opción Opción
(corto) (largo)
Argumento Descripción
-incremental
Ejecuta la operación de actualización
incremental.
-synchronous
Ejecuta la operación de actualización
completa inmediatamente en el
primer plano.
--workbook
Nombre de
un libro de
trabajo
El nombre del libro de trabajo
contiene extractos que actualizar. Si
el libro de trabajo tiene espacios en
su nombre, agregue comillas a su
alrededor.
-datasource
Nombre de
fuente de
datos
El nombre de la fuente de datos
contiene extractos que actualizar.
--project
Nombre de
un proyecto
Use con --workbook o -datasource para identificar un
libro de trabajo o fuente de datos en
un proyecto distinto a
Predeterminado. Si no se especifica,
se asume el proyecto
Predeterminado.
--url
El nombre del libro de trabajo como
Nombre de aparece en la URL. Un libro de
URL un libro trabajo publicado como “Análisis de
de trabajo
ventas” tiene un nombre de URL
“SalesAnalysis”.
removeusers group-name
Elimino los usuarios indicados en el argumento --users del grupo con el nombre-grupo
determinado.
Ejemplo
tabcmd removeusers "Development" --users "users.csv"
Opción Opción
(corto) (largo)
--users
Argumento Descripción
Elimine los usuarios en el archivo
determinado del grupo especificado. El
filename.csv
archivo debe ser una lista simple con un
nombre de usuario por línea.
--[no-]
complete
Requiere que todas las filas sean válidas
para que cualquier cambio tenga éxito. Si
no se especifica, se usa --complete.
runschedule schedule-name
Ejecuta el programa especificado. Este comando toma el nombre del programa como está en
el servidor.
Ejemplo
tabcmd runschedule "5AM Sales Refresh"
set setting
Habilita la configuración especificada en el servidor. En la página Mantenimiento del servidor
se pueden ver detalles sobre cada configuración. Use un signo de exclamación delante del
nombre de la configuración para deshabilitar la configuración. Puede habilitar o deshabilitar la
siguiente configuración:
l
embedded_credentials
l
remember_passwords_forever
Ejemplo
tabcmd set embedded_credentials
syncgroup group-name
Sincroniza el grupo con el nombre-grupo determinado con Active Directory. Este comando
también se puede usar para crear un grupo nuevo en el servidor que se basa en un grupo
Active Directory existente.
Ejemplo
tabcmd syncgroup "Development"
Opción
Opción (largo)
(corto)
--license
Argumento
Descripción
viewer
Establece el nivel de licencia
interactor para todos los usuarios del
unlicensed grupo.
-system
administrator site none
Asigna o elimina el derecho de
Administrador para todos los
usuarios del grupo. El tipo de
usuario Administrador puede ser
de sistema, de sitio o ninguno. El
predeterminado es ninguno (los
nuevos usuarios no tienen
derechos de Administrador) y los
usuarios existentes no sufren
cambios.
--[no-]
publisher
Asigna o elimina el derecho de
publicación para todos los
usuarios del grupo. Si no se
especifica, no se asigna este
derecho a los nuevos usuarios y
los usuarios existentes no sufren
cambios.
--[no-]
complete
Requiere que todas las filas sean
válidas para que cualquier
cambio tenga éxito. Si no se
especifica, se usa --complete.
--silentprogress
Suprime mensajes de progreso.
version
Imprime la información de versión para la instalación actual de la utilidad tabcmd.
Ejemplo
tabcmd version
tabadmin
Puede realizar ciertas tareas administrativas y cambiar la configuración de Tableau Server con
la herramienta de línea de comando tabadmin. Para acceder a ella, abra una ventana de línea
de comando como administrador y cambie directorios con el siguiente comando.
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
Para ver una lista de todos los comandos tabadmin disponibles, escriba lo siguiente:
tabadmin help commands
Para obtener más información, consulte los temas a continuación:
tabadmin set
Uno de los comandos tabadmin usados con mayor frecuencia es tabadmin set, que le
permite cambiar el valor de las opciones de configuración de Tableau Server. La sintaxis es la
siguiente:
tabadmin set option-name value
Para usar este comando:
1. Detener el servidor.
2. Escriba tabadmin set y a continuación el nombre de la opción y el valor.
Por ejemplo, para cambiar el valor predeterminado de la opción de tabadmin
backgrounder.querylimit de 7200 segundos (2 horas, el predeterminado) a 9000
segundos, escriba lo siguiente:
tabadmin set backgrounder.querylimit 9000
Si está configurando una opción cuyo valor comienza con un guion, utilice comillas
anidadas:
tabadmin set option-name "'-value'"
tabadmin set option-name "'-value1 -value2'"
3. Después de usar tabadmin set, escriba el comando configure:
tabadmin configure
4. Por último, inicie Tableau Server.
Opciones de tabadmin set
Use la tabla a continuación para obtener más información sobre las opciones de Tableau
Server que puede configurar usando el comando tabadmin set. Consulte Puertos TCP/IP para
obtener una lista completa de puertos.
Opción
Valor
predetermina- Descripción
do
auditing.enabled
verdadero
Permite el acceso a las tablas de auditoría
histórica de PostgreSQL (base de datos propia
de Tableau Server). Consulte Crear vistas
administrativas personalizadas para conocer
más detalles.
backgrounder.querylimit
7200
Mayor tiempo permisible para finalizar una
actualización de extracto, en segundos (7200
segundos = 2 horas).
dataengine.port
27042
Puerto en que se ejecuta el motor de datos.
dataserver.port
9700
Puerto en que se ejecuta el servidor de datos.
gateway.public.host
Nombre de la
máquina
El nombre canónico del servidor que se usa
para el acceso externo a Tableau Server. Si se
configura Tableau Server para que trabaje con
un servidor proxy, es el nombre canónico del
servidor proxy (no Tableau Server).
gateway.public.port
80 (443 si se
usa SSL)
Solo se aplica a entornos de servidor proxy. El
puerto externo que el servidor proxy escucha.
gateway.timeout
1800
La mayor cantidad de tiempo, en segundos,
que un portal esperará por ciertos eventos
antes de enviar un pedido de falla (1800
segundos = 30 minutos).
gateway.trusted
La dirección IP
Solo se aplica a entornos de servidor proxy.
de la máquina
Las direcciones IP o nombres de host del
de servidor
servidor proxy.
proxy
gateway.trusted_hosts
Nombres
Solo se aplica a entornos de servidor proxy.
alternativos del Cualquier nombre de host para el servidor
servidor proxy proxy.
java.heap.size
128m
Tamaño de pila para Tomcat (repositorio y
solr). Generalmente no es necesario cambiar
esto excepto si Tableau lo indica.
pgsql.port
8060
El puerto que PostgreSQL escucha.
600
Tiempo máximo permitido, en segundos, para
finalizar la sincronización de archivos (600
segundos = 10 minutos). La sincronización de
rsync.timeout
Opción
Valor
predetermina- Descripción
do
archivos ocurre como parte de la configuración
de alta disponibilidad o al mover el motor de
datos y los procesos del repositorio.
La configuración true habilita los puertos
JMX para una supervisión y solución de
problemas opcional. Consulte Habilitar los
puertos JMX para conocer detalles.
service.jmx_enabled
falso
service.max_procs
Nº de procesos Máximo de cantidad de procesos de servidor.
subscriptions.enabled
falso
Controla si las suscripciones son configurables
en todo el sistema. Consulte Administrar
suscripciones.
subscriptions.timeout
1800
Cantidad de segundos después de los cuales
caduca el tiempo de espera del proceso en
segundo plano que maneja una suscripción.
solr.port
8080
El puerto que solr escucha. Este debe ser el
mismo valor que tomcat.http.port.
tomcat.http.port
8080
Puerto en que Tomcat se ejecuta.
tomcat.https.port
8443
Puerto SSL para Tomcat (sin usar).
tomcat.server.port
8085
Puerto que tomcat escucha para mensajes de
cierre.
vizqlserver.browser.render verdadero
Las vistas por debajo del umbral definido por
vizqlserver.browser.render_
threshold o
vizqlserver.browser.render_
threshold_mobile son renderizadas por
el navegador Web cliente en lugar del servidor.
Consulte Acerca de la renderización del lado
del cliente para conocer más detalles.
vizqlserver.browser.rende100
r_threshold
El valor predeterminado (100) representa un
alto nivel de complejidad para una vista que se
muestra en una PC. Los factores de
complejidad incluyen cantidad de marcas,
encabezados, líneas de referencia y
anotaciones. Las vistas que exceden este nivel
de complejidad son renderizadas por el
servidor en lugar del navegador Web de la PC.
Opción
Valor
predetermina- Descripción
do
vizqlserver.browser.rende20
r_threshold_mobile
El valor predeterminado (20) representa un
alto nivel de complejidad para una vista que se
muestra en una tablet. Los factores de
complejidad incluyen cantidad de marcas,
encabezados, líneas de referencia y
anotaciones. Las vistas que exceden este nivel
de complejidad son renderizadas por el
servidor en lugar del navegador Web de la
tablet.
vizqlserver.port
9100
Puerto base para los servidores VizQL.
vizqlserver.protect_
sessions
verdadero
Cuando se configura en true
(predeterminado), previene que las sesiones
VizQL se reutilicen después de que el usuario
original se desconecta.
vizqlserver.querylimit
1800
Mayor tiempo permisible para actualización de
una vista, en segundos.
Especifica un host Rserve. Esta configuración,
y las tres que se encuentran inmediatamente a
continuación, admiten las funcionalidades R
en libros de trabajo. R es un idioma de
programación de software de código abierto y
un entorno de software para cálculos
estadísticos y los gráficos. En Tableau
Desktop, puede usar un conjunto de cuatro
funciones para pasar expresiones R a un
servidor Rserve y obtener un resultado. Si
carga un libro de trabajo que use una de estas
funciones, debe configurar Tableau Server
para una conexión Rserve, al configurar esta
opción y las tres siguientes. De lo contrario,
cualquier hoja de trabajo que use
funcionalidades R no estará disponible.
Consulte Conexión R en la ayuda de Tableau
Desktop para obtener más detalles.
vizqlserver.rserve.host
vizqlserver.rserve.port
vizqlserver.rserve.username
6311
Especifica un puerto Rserve. Esta
configuración admite la funcionalidad R en los
libros de trabajo.
Especifica un nombre de usuario de Rserve.
Esta configuración admite la funcionalidad R
Opción
Valor
predetermina- Descripción
do
en los libros de trabajo. No todos los host
Rserve requieren un nombre de usuario y
contraseña.
vizqlserver.rserve.password
Especifica una contraseña Rserve. Esta
configuración admite la funcionalidad R en los
libros de trabajo. No todos los host Rserve
requieren un nombre de usuario y contraseña.
vizqlserver.session.expiry.5
minimum
La cantidad de minutos de tiempo inactivo
después de una sesión VizQL sea elegible
para ser descartada si el proceso VizLQ
empieza a quedarse sin memoria.
vizqlserver.session.expiry.t30
imeout
Número de minutos de tiempo inactivo
después que se descarta una sesión de VizQL.
vizqlserver.showdownload verdadero
Controla la aparición del botón Descargar en
la parte superior de las vistas.
vizqlserver.showshare
Controla la aparición del botón Compartir en la
parte superior de las vistas.
verdadero
vizqlserver.trustedticket.loinfo
g_level
El nivel de inicio de sesión para una
autenticación de confianza, escrito a
ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\vizqlserver\vizql-*.log. Configure en debug
para obtener más información.
vizqlserver.trustedticket.tok24
en_length
Determina el número de caracteres en cada
ticket de confianza. La configuración
predeterminada de 24 caracteres proporciona
144 bits de aleatoriedad. El valor se puede
configurar a cualquier entero entre 9 y 255,
incluidos.
vizqlserver.trustedticket.use_deprecated_9digit_
falso
token
Cuando se configura en true, los tickets
tienen una longitud de 9 dígitos (como en la
versión 8.0 y anterior) y la configuración
vizqlserver.trustedticket.token_
length se ignora.
wgserver.audit_history_
expiration_days
Cantidad de días después de los cuales los
registros de eventos históricos se eliminan de
la base de datos de PostgreSQL (base de
datos propia de Tableau Server). Consulte
183
Opción
Valor
predetermina- Descripción
do
Crear vistas administrativas personalizadas
para conocer más detalles.
wgserver.domain.fqdn
wgserver.password_
autocomplete.enabled
El nombre de dominio completamente
valor de
%USERDOM- calificado del servidor para uso de Active
AIN%
Directory.
falso
Controla si los navegadores Web pueden
completar automáticamente campos de
contraseña.
wgserver.session.idle_limit 240
El número de minutos de tiempo inactivo antes
que expire el tiempo de espera de un inicio de
sesión a la aplicación Web.
wgserver.trusted_hosts
Esta opción toma una lista separada por
comas de direcciones IP o nombres de host de
confianza para la computadora de la cual
desea aceptar solicitudes de confianza. Un
valor común es 127.0.0.1 si desea colocar el
servidor Web y Tableau Server en la misma
computadora. Esta opción se usa al configurar
una relación de confianza entre el servidor
Web y Tableau Server al incrustar vistas.
workerX.gateway.port
80 (443 si se
usa SSL)
Puerto externo al que escucha Apache para
workerX. worker0.gateway.port es el puerto
externo de Tableau Server. En un entorno
distribuido, worker0 es el Tableau Server
primario.
workerX.vizqlserver.procs
Nº de procesos Número de servidores VizQL.
workerX.vizqlserver.port
9100
Puerto base para el servidor vizQL en
workerX.
workerX.wgserver.port
8000
Puerto base para el servidor de aplicaciones
Web en workerX.
workerX.wgserver.procs
Nº de
procesadores
Número de procesos de servidor de aplicación
Web
Restaurar una configuración a su valor predeterminado
Puede restaurar el valor predeterminado para un ajuste de la configuración de Tableau Server
haciendo lo siguiente:
1. Detenga el servidor.
2. Todavía en el Directorio de la agrupación, restaure el valor predeterminado para un
ajuste en particular al escribir lo siguiente:
tabadmin set option-name --default
Por ejemplo, para establecer la opción tabadmin vizqlserver.session.expiry.timeout
nuevamente en su valor predeterminado de 30 minutos, deberá escribir los siguiente:
tabadmin set vizqlserver.session.expiry.timeout --default
De forma alternativa puede usar el comando -d más corto. Por ejemplo:
tabadmin set vizqlserver.querylimit -d
3. A continuación, ejecute el comando de configuración:
tabadmin configure
4. Inicie el servidor.
tabadmin stop
Para usar tabadmin a fin de detener Tableau Server:
1. Abra una línea de comando como administrador:
2. Escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
3. Escriba lo siguiente para detener el servidor:
tabadmin stop
tabadmin start
Para usar tabadmin a fin de iniciar Tableau Server:
1. Abra una línea de comando como administrador:
2. Escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
3. Escriba lo siguiente para iniciar el servidor:
tabadmin start
Mantenimiento de base de datos
Puede usar la herramienta de línea de comando tabadmin para respaldar y restaurar los datos
de Tableau. Los datos de Tableau incluyen la propia base de datos PostgreSQL de Tableau
Server, la cual almacena libros de trabajo y metadatos de usuario, archivos de extractos de
datos (.tde) y datos de configuración del servidor. Para automatizar el respaldo de estos datos,
puede usar los comandos que se describen en los temas que aparecen a continuación, en
conjunto con el programador de tareas de Windows incorporado.
Respaldar los datos de Tableau
Es importante respaldar sus datos de Tableau, de forma que pueda restaurar las vistas
publicadas y otra información en caso de falla del sistema. Los datos administrados por
Tableau Server se componen de la propia base de datos PostgreSQL de Tableau, la cual
almacena libros de trabajo y metadatos de usuario, archivos de extractos de datos (.tde) y
datos de configuración. Cuando crea un respaldo, toda la información se coloca en un solo
archivo con la extensión .tsbak. Si está ejecutando una instalación distribuida de Tableau
Server, este paso se realiza en el servidor primario, incluso si el motor de datos que maneja los
archivos .tde se encuentra en uno de trabajadores. Para que pueda ser un respaldo efectivo
para usted, asegúrese de almacenar el archivo .tsbak en una computadora diferente de su
host de Tableau Server.
Puede crear un archivo .tsbak mediante el siguiente procedimiento. Tableau Uninstall, el
primer paso para actualizar a una versión nueva, también crea automáticamente un archivo
.tsbak. Este mismo archivo .tsbak se usa para migrar automáticamente sus datos a la versión
más nueva.
Si ejecuta el comando backup se eliminan también los archivos de registro de Tableau
Server de más de siete días, como asimismo parte de la información que aparece en un
Tableau Server determinado Vistas administrativas.
1. Abra una línea de comando como administrador y escriba lo siguiente:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Cree un archivo de respaldo escribiendo tabadmin backup <filename>, donde
<filename> es el nombre o ubicación y nombre de su archivo de respaldo. No hay
necesidad de detener el servidor antes de crear el respaldo. Por ejemplo:
tabadmin backup tabserver
o
tabadmin backup C:\backups\tableau\tabserver
También puede usar opcionalmente -d para adjuntar la fecha actual al nombre de
archivo y -t, seguido de una ruta, para especificar una ubicación para archivos
temporales que se crean durante el proceso de respaldo. Por ejemplo:
tabadmin backup tabserver -d -t C:\mytemp\tableau
Restaurar a partir de un respaldo
Cuando restaura, el contenido de la base de datos PostgreSQL de Tableau, los extractos de
datos y los archivos de configuración se sobrescriben con el contenido del archivo de respaldo
(.tsbak). Si está ejecutando una instalación distribuida de Tableau Server, este paso se realiza
en la instalación primaria.
Para restaurar desde un archivo de respaldo de base de datos:
1. Detenga el servidor al escribir:
tabadmin stop
2. Restaure la base de datos desde un archivo de respaldo al escribir:
tabadmin restore <filename>
En la línea anterior, reemplace <filename> con el nombre del archivo de respaldo del
cual desea restaurar.
Para restaurar solo los datos y no el ajuste de configuración, escriba lo siguiente en su
lugar:
tabadmin restore --no-config <filename>
3.
Reinicie los procesos de Tableau Server escribiendo lo siguiente:
tabadmin start
Recuperar extractos a partir de un respaldo
El archivo uninstall-<version>.tsbak (por ejemplo, uninstall-8.0.tsbak) se crea como parte del
proceso de desinstalación. Después de actualizar a la versión 8.1, puede usar este archivo
para restaurar extractos de datos, por ejemplo, si por error elimina la carpeta del motor de
datos durante la actualización. Para usar uninstall-<version>.tsbak a fin de restaurar extractos
de datos:
1. Detenga el servidor.
2. Desde el directorio de la agrupación Tableau Server versión 8.1, escriba lo siguiente:
Windows Server 2012, Windows Server 2008, Windows Vista, Windows 7, Windows 8:
tabadmin restore \ProgramData\Tableau\Tableau
Server\uninstall-8.0.tsbak
Tableau Server de 32 bits instalado en Windows Server 2003 de 64 bits: tabadmin
restore \Program Files (x86)\Tableau\Tableau
Server\uninstall-8.0.tsbak
Tableau Server de 32 bits instalado en Windows Server 2003 de 32 bits: tabadmin
restore \Program Files\Tableau\Tableau Server\uninstall8.0.tsbak
Solución de problemas
Use los siguientes temas para solucionar problemas que pueda tener con Tableau Server.
Para obtener consejos sobre la solución de problemas de autenticación de confianza, consulte
Solución de problemas de la autenticación de confianza:
Registros y archivos temporales
Tableau Service genera varios registros y archivos temporales que puede ayudarle a
comprender y realizar seguimiento a actividad reciente, así como también, depurar cualquier
problema que pueda surgir. Si debe ahorrar espacio en el disco duro, puede eliminar estos
archivos ocasionalmente.
Use los siguientes temas para averiguar dónde se ubican los archivos de registro, su
propósito, cómo archivarlos y cómo ahorrar espacio al ejecutar el comando de limpieza.
Ubicaciones de archivo de registro
Los archivos del servidor de registro de Tableau Server se pueden encontrar en las siguientes
carpetas:
Registros de Tableau Server
Los siguientes archivos de registro realizan seguimiento a actividades relacionadas con la
aplicación Web, base de datos e índice:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc
Registros de VizQL
Estos archivos de registro realizan seguimiento a actividades relacionadas con la visualización
de vistas, como la consulta de bases de datos y generación de imágenes
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\vizqlserver\Logs
Archivos temporales
Cualquier archivo que comienza con exe_ en la carpeta a continuación es un archivo de
Tableau Server y es posible eliminarlo.
C:\ProgramData\Tableau\Tableau Server\temp
Archivar archivos de registro
Puede archivar archivos de Tableau Server mediante el comando ziplogs. Este comando crea
un archivo zip que contiene todos los archivos de registro y es útil cuando trabaja con Tableau
Support. El comando ziplogs no elimina los archivos de registro, en lugar de eso, los copia en
un archivo zip. Si está ejecutando una instalación distribuida de Tableau Server, este paso se
realiza desde la instalación primaria. Todos los registros de trabajador que haya se incluirán en
el archivo zip.
1. Abra una línea de comando como administrador y navegue al directorio de la
agrupación de Tableau Server. Por ejemplo:
cd "C:\Program Files\Tableau\Tableau Server\8.1\bin"
2. Detenga Tableau Server al escribir:
tabadmin stop
3. Cree el archivo zip al escribir tabadmin ziplogs -l -n <filename> donde
<filename> es el nombre del archivo zip que desea crear. Elija un nombre único sin
espacios. Tableau no sobrescribe un archivo existente. Por ejemplo:
tabadmin ziplogs -l -n my_logs
Si no especifica un nombre de archivo, el nombre del archivo será llogs.zip. También
puede usar -d mm/dd/yyyy para incluir solo los archivos generados desde una fecha
específica. Por ejemplo:
tabadmin ziplogs -l -n -d 02/14/2013
El comando anterior crea un archivo comprimido con el nombre logs.zip, el cual
incluye registros con fecha 14 de febrero de 2013 hasta el presente; se excluyen los
registros anteriores. La opción -n captura información sobre el entorno del servidor,
incluidos los puertos que están en uso. Para ver una lista de todas las opciones de
ziplogs, escriba tabadmin ziplogs -h.
4. Reinicie Tableau Server al escribir:
tabadmin restart
Puede encontrar el archivo zip en el directorio de la agrupación Tableau Server.
Eliminar archivos de registro
El comando cleanup elimina registros de proceso de Tableau Server y las entradas de más
de siete días de la tabla HTTP, a fin de ahorrar espacio. Esto afectará parte de la información
presentada en el Tableau Server Vistas administrativas.
l
En una línea de comando escriba lo siguiente:
tabadmin cleanup --restart
En general debe cerrar el servidor antes de ejecutar este comando. Sin embargo,
si el servidor está en ejecución debe incluir la opción --restart para garantizar
una limpieza y restauración exitosa.
Manipular un servidor sin licencia
Tableau ofrece dos modelos de licenciamiento: basado en el usuario y basado en los núcleos.
El licenciamiento basado en usuarios requiere que cada cuenta de usuario activa esté cubierta
por una licencia. Las licencias basadas en usuarios tienen una capacidad definida o un número
de usuarios que permite. Cada usuario tiene un nombre de usuario asignado a él en el servidor
y se requiere su identificación al conectarse al servidor. El software se puede instalar en una
máquina individual o distribuir en cualquier cantidad de máquinas en un entorno de servidor
distribuido.
El licenciamiento basado en núcleos no tiene limitaciones en la cantidad de cuentas de usuario
del sistema, pero sí restringe el número máximo de núcleos de procesadores que Tableau
Server puede usar. Puede instalar el servidor en una o más máquinas para crear un clúster,
con las restricciones que el número total de núcleos en todas las máquinas, no sobrepase el
número máximo núcleos que ha licenciado y que todos los núcleos en una máquina en
particular estén cubiertos por la licencia.
Servidor basado en usuarios sin licencia
El motivo más común para que un servidor que tiene licenciamiento basado en usuario quede
sin licencia es una clave de producto expirada o un contrato de mantenimiento expirado.
Puede ver las claves de productos y agregar nuevas al seleccionar Inicio > Todos los
programas > Tableau Server > Administrar claves de productos.
Servidor basado en núcleos sin licencia
Un servidor basado en núcleos puede quedar sin licencia por diversos motivos. Un problema
común es que la máquina primaria o la de un trabajador tiene más núcleos que lo permitido por
la licencia. Cuando el servidor no tiene licencia no puede iniciar o administrar el servidor. Sin
embargo, puede administrar sus licencias mediante la herramienta de línea de comando
tabadmin. Siga los pasos a continuación para ver una lista de sus licencias y el número de
núcleos por máquina.
1. Abra una línea de comando y escriba lo siguiente: cd C:\Program
Files\Tableau\Tableau Server\8.1\bin
2. Escriba lo siguiente: tabadmin licenses.
Manipular un proceso de VizQL Server sin licencia
Existen varios indicadores en la página Mantenimiento de Tableau Server que le ayudan a
comprender el estado de los procesos de Tableau Server. Un cuadro de estado de color
naranja, “Sin licencia”, indica que uno de los procesos de VizQL Server no puede recuperar la
información de licencia de Tableau Server.
Es posible que existan varios motivos por el que un proceso no puede acceder a esta
información. Por ejemplo, es posible que haya problemas de red que evitan que un proceso
VizQL, el cual se ejecuta en otra máquina de trabajador, se comunique con la máquina
primaria. O bien, es posible que el proceso envíe más solicitudes que las que puede aceptar a
la vez y no puede manejar la solicitud de licenciamiento. En consecuencia, es posible que
algunos usuarios puedan acceder a vistas mientras que otros no.
Para solucionar el problema, detenga, luego inicie Tableau Server.
Error ‘Sin memoria’ de VizQL
En las versiones de 32 bits de Tableau Server, si un proceso VizQL alcanza su límite de
sesiones de visualización concurrentes, puede que vea un error ‘Sin memoria’, el cual también
se escribirá en los registros vizqlserver*.txt ubicados aquí:
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\vizqlserver\Logs
El proceso VizQL no finaliza cuando se produce este error, sino que no aceptará conexiones
adicionales. Este problema lo puede tratar realizando lo siguiente:
l
l
l
Actualizar a la versión de 64 bits de Tableau Server: Consulte upgrade.htm para
conocer detalles.
Aumentar el número de procesos VizQL: Esto podría significar que necesita
agregar uno o más trabajadores. Consulte Instalar y configurar los servidores de
trabajador para conocer cómo realizar esto.
Editar vizqlserver.session.expiry.timeout: Usar tabadmin para cambiar la
configuración de vizqlserver.session.expiry.timeout de su valor predeterminado (30
minutos) a un período de tiempo más corto, como 10 o 5 minutos. Esto también dejará
inactivas las sesiones para que expiren pronto, liberando así memoria para nuevas
sesiones.
Error de restricción de cookie
Cuando un usuario inicia sesión en Tableau Server, una cookie de sesión se almacena en su
navegador local. La cookie almacenada es el método mediante el cual Tableau Server afirma
que el usuario está autenticado y puede acceder al servidor. Dado que la cookie se define con
el mismo dominio o subdominio de la barra de dirección del navegador, se le considera una
cookie de origen. Si el navegador del usuario está configurado para bloquear las cookies de
origen, el usuario no podrá iniciar sesión en Tableau Server.
Cuando el usuario inicia sesión en Tableau Server a través de una vista incrustada o en un
entorno que tiene configurada la autenticación de confianza, sucede lo mismo: se almacena
una cookie. Sin embargo, en este caso, el navegador trata la cookie como una cookie de
terceros. Esto se debe a que la cookie se define con un dominio diferente al que se muestra en
la barra de dirección del navegador. Si el navegador Web del usuario está configurado para
bloquear las cookies de terceros, la autenticación en Tableau Server fallará. Para evitar que
esto suceda, los navegadores Web se deben configurar para admitir las cookies de terceros.
Solucionar problemas de fuentes de datos
Para usuarios que trabajan con fuentes de datos de Tableau Server, se debe contra con hasta
tres elementos:
l
l
l
Permisos para la fuente de datos: Todas las personas que se conectan a una fuente
de datos deben tener permisos de Conexión y Vista para ella. Esto también se aplica a
usuarios que acceden a vistas que se conectan a fuentes de datos. Todas las personas
que publican y modifican fuentes de datos deben tener licencia de Publicación y también
tener permisos de Escritura/Guardar como y Descargar/Guardar en Web como.
Consulte Trabajar con permisos y Configurar permisos para una fuente de datos para
obtener más información.
Capacidad de autenticar la base de datos: Hay varias formas en que se puede
conectar a datos en Tableau y controlar quién tiene acceso a qué. Básicamente,
cualquier entidad que se conecta a la base de datos debe poder autenticarse. La
entidad podría ser Tableau Server realizando una actualización de extracción. Podría
ser un usuario de Tableau Desktop que se conecta a una fuente de datos que luego se
conecta a una fuente de datos en tiempo real. También podría ser un usuario de
Tableau Desktop que accede a una vista que se conecta a una fuente de datos en
tiempo real. Consulte Seguridad de datos para obtener más información sobre las
opciones.
Controladores de bases de datos: Si la persona que creó o publicó la fuente de
datos en Tableau Desktop debe instalar controladores de bases de datos adicionales,
es posible que deba instalarlos en Tableau Server. Si ejecuta una instalación distribuida
de Tableau Server donde, por ejemplo, el proceso de servidor de datos se ejecuta en el
servidor de un trabajador, cualquier controlador de base de datos requerido debe
instalarse también ahí en el servidor primario. Otros procesos también requieren
controladores,Consulte Controladores de bases de datos para obtener más
información.
Mensajes de error de fuente de datos
A continuación se indican algunos errores que autores de libros de trabajo y otros usuarios
pueden encontrar mientras trabajan con fuentes de datos y vistas:
Se denegó el permiso para acceder a esta fuente de datos de Tableau Server: La
conexión de la fuente de datos requiere permiso de Conexión. Consulte Trabajar con
permisos y Configurar permisos para una fuente de datos para obtener más información.
No se encontró la fuente de datos: Una persona que trabaja con una vista puede ver este
error si la fuente de datos se elimina de Tableau Server o si se debe actualizar su página
Conectar a datos. Para actualizar la página Conectar a datos en Tableau Desktop, haga clic
en el icono Actualizar:
No es posible conectar a esta fuente de datos de Tableau Server: Este error puede
aparecer si la información de conexión para la fuente de datos ha cambiado, por ejemplo,
como resultado del cambio de nombre del servidor de la base de datos. Observe la
información Conexión de datos para conocer la fuente de datos y confirme que tiene la
configuración correcta.
No es posible enumerar las fuentes de datos de Tableau Server: Este error puede
ocurrir si un usuario intenta acceder a fuentes de datos de Tableau Server y hay problemas de
conectividad entre Tableau Server y Tableau Desktop.
No es posible conectarse con una fuente de datos de cubo: Las conexiones a fuentes
de datos de cubo (como MSAS) no son compatibles. Los datos deben ser un extracto o una
conexión en tiempo real a una base de datos relacional.
Solucionar problemas relacionados con las suscripciones
"La instantánea de la vista de este correo electrónico no se pudo renderizar
correctamente".
Puede haber diversas razones para recibir una suscripción con este mensaje de error:
l
l
l
Falta de credenciales: Algunas vistas se publican con credenciales incrustadas. Es
posible que reciba el error indicado anteriormente si las credenciales incrustadas están
obsoletas o si la vista se volvió a publicar sin las credenciales incrustadas.
Base de datos temporalmente fuera de servicio: Si la vista tiene una conexión con
una base de datos de acceso en tiempo real y esa base de datos se encontraba fuera de
servicio cuando se generó la suscripción, es posible que aparezca el error anterior.
Límite de tiempo de espera de proceso en segundo plano: De manera
predeterminada, el proceso en segundo plano que controla suscripciones caduca
después de 30 minutos. En la mayoría de los casos, esto es tiempo suficiente. Sin
embargo, si el proceso en segundo plano está controlando un dashboard
extraordinariamente grande y complejo, es posible que no sea tiempo suficiente. Puede
revisar la vista de administrador de Tareas en segundo plano para ver si ese es el caso.
Para aumentar el umbral del límite de tiempo de espera, utilice la opción
subscriptions.timeout de tabadmin.
No es posible suscribirse
Si puede ver una vista en Tableau Server y tiene el icono de suscripción ( ) en la esquina
superior derecha, puede suscribirse a ella.
Para suscribirse a una vista, debe cumplir con dos requisitos: Debe configurar Tableau Server
correctamente (como se describe en Administrar suscripciones) y la vista a la cual desea
suscribirse debe tener credenciales incrustadas para su fuente de datos o no confiar en
absoluto en las credenciales. Algunos ejemplos incluyen un libro de trabajo que se conecta a
un extracto que no se actualiza o un libro de trabajo, cuyos datos están en un archivo que se
incluyó en el libro de trabajo en el momento de la publicación. La incrustación de credenciales
es un paso que ocurre en Tableau Desktop (consulte la Ayuda de Tableau Desktop para
obtener detalles).
Sin icono de suscripción
Puede ocurrir que se pueda ver una vista en Tableau Server, pero no suscribirse a ella. Esto
ocurre para las vistas con conexiones de base de datos de acceso en tiempo real, donde se
piden las credenciales de la base de datos la primera vez que hace clic en la vista. Una
suscripción incluye una vista (o libro de trabajo), datos y un programa. Para entregar la pieza
de datos, Tableau Server necesita credenciales de la base de datos incrustadas o datos que
no requieran credenciales. Cuando se trata de las conexiones de la base de datos de acceso
en tiempo real, Tableau Server no tiene las credenciales correspondientes, solo los usuarios
individuales. Esta es la razón por la cual solo puede suscribirse a vistas que no requieren
credenciales o las tienen incrustadas.
También podrá ver una vista pero no podrá suscribirse a ella (sin icono de suscripción) si
Tableau Server se configura para autenticación de confianza. Consulte Requisitos de
suscripción para obtener más información.
Recepción de suscripciones no válidas o que no funcionan
Si configuró suscripciones en instancias de pruebas o desarrollo de Tableau Server, además
de la instancia de producción, deshabilite las suscripciones de las instancias que no son de
producción. Mantener las suscripciones habilitadas en todas las instancias puede ocasionar
que los usuarios reciban suscripciones que parecen válidas, pero que no funcionan, o que
reciban suscripciones incluso si ya no están suscritos a la vista o el libro de trabajo.
Las suscripciones no llegan ("Error al enviar correo electrónico. No es posible enviar
el comando al host SMTP").
Puede ver el error de arriba en Windows Event Viewer si las suscripciones aparecen como
enviadas (según la vista de administración Tareas en segundo plano), las suscripciones no
llegan y el servidor SMTP usa sesiones cifradas (SSL). Las suscripciones son solo
compatibles para conexiones SMTP no encriptadas. La solución es usar un servidor SMTP no
encriptado.
Solución de problemas de SAML
Use los siguientes temas para solucionar problemas que pueda tener con SAML.
SAML y Activar inicio de sesión automático
Si está usando SAML y Tableau Server también está configurado para usar Active Directory,
no use además Activar inicio de sesión automático. No se pueden usar Activar inicio de
sesión automático y SAML juntos.
Inicio de sesión fallido
Si recibe el mensaje "Inicio de sesión fallido:Autenticación de proveedor de identidad exitosa
para usuario <nombre de usario de IdP>,No se pudo encontrar el usuario en Tableau Server."
el nombre de usuario almacenado en Tableau Server y el almacenado en IdP no son idénticos.
Para corregirlo, asegúrese de que coincidan. Por ejemplo, si el nombre de usuario para Jane
Smith está almacenado en el IdP como jsmith, también debe estarlo en Tableau Server
como jsmith.
Registro de error SAML
Los errores de inicio de sesión SAML se registran en la siguiente ubicación. Puede usar este
registro para solucionar problemas.
C:\ProgramData\Tableau\Tableau
Server\data\tabsvc\logs\wgserver\error.log
Manejar alertas de actualización de extracto
Si las actualizaciones de extractos calendarizadas no tienen éxito, Tableau mostrará un menú
de Alertas en la esquina superior derecha:
Solo verá el menú de Alertas si falló una actualización de extractos y es:
l
Un administrador de sistema o de sitio.
l
El autor del libro de trabajo o la fuente de datos que no se pudo actualizar.
l
El autor de un libro de trabajo que se conecta a la fuente de datos que no se pudo
actualizar.
Cuando abre el menú de Alertas, puede ver más información acerca de los fallos de
actualización:
Cuando una Fuente de datos se lista como Incrustada, significa que la definición de la
fuente de datos (que incluye cosas como las credenciales de la fuente de datos, o el nombre
de la base de datos) está incrustada en, o reside dentro del libro de trabajo. También significa
que el problema se debe corregir en Tableau Desktop. Por ejemplo, la fuente del problema
puede ser que las credenciales se deben incrustar en el libro de trabajo.
Cuando un nombre de fuente de datos o nombre de libro de trabajo se lista como la Fuente de
datos(por ejemplo, Fuente de datos: sales_data), significa que la fuente de datos es una
fuente de datos de Tableau Server. La definición de la fuente de datos reside en Tableau
Server. Cuando el libro de trabajo o la fuente de datos se crearon originalmente en Tableau
Desktop, se mostraba un icono de Tableau en lugar de un icono de base de datos junto a la
fuente de datos, en la ventana de datos:
A veces puede corregir un problema de actualización de extracto al hacer clic en Editar
información de conexión, ingresar la información faltante y hacer clic en Guardar:
JavaScript API
With Tableau's JavaScript API you can integrate Tableau visualizations into your own web
applications. The API lets you tightly control your users' interactions and combine functionality
that otherwise couldn't be combined. For example, you can code a single control that filters a
group of marks, selects some of those marks, and presents their data for download. See the
topics below for details:
l
Requirements
l
Concepts
l
Tutorial
l
API Reference
Requirements
The requirements for Tableau's JavaScript API are as follows:
Tableau Server: To program with Tableau's JavaScript API you need Tableau Server,
version 8.1 or higher. The API is powered by the file tableau_v8.js, which is located in the
following folder: Program Files\Tableau\Tableau
Server\8.1\wgserver\public\javascripts\api. Your web application shouldn't
be on the same computer as Tableau Server, but it needs to be able to access it.
Supported browsers: Your end-users can experience the web application you create in most
supported web browsers, specifically: Chrome, Firefox, Safari 3.2.1 and higher, and Internet
Explorer 8.0 and higher. If you are using Internet Explorer 8.0, it must have compatability mode
disabled.
Concepts
This topic is designed for people familiar with JavaScript and object-oriented programming
concepts. You should also be familiar with Tableau visualizations from a user's point of view. If
you are just getting started, a good place to begin is the Tutorial.
Programming Approach
Tableau's JavaScript API uses an object model. The entry point into the object model is to
instantiate a new Viz object as follows:
var viz = new tableauSoftware.Viz(/* params omitted */);
Nearly every Tableau object allows you to navigate back to its parent Viz object by way of
"parent" properties on the object.
Accessing the API
The API is about programmatically controlling views embedded from Tableau Server. To use
it, you need access to a Tableau server running version 8.0 or higher, and a published
workbook on that server. The API is provided through the file tableau_v8.js (minimized) or
tableau_v8.debug.js, which install in the following folder on Tableau Server:
Program Files\Tableau\Tableau
Server\8.1\wgserver\public\javascripts\api
If you don't have a Tableau Server on-premise, you have a couple other options:
l
l
Tableau Public is a free Tableau Server implementation that you can also use to access
the JavaScript API. The workbooks published to Tableau Public must be packaged
.twbx workbooks (data extract and workbook bundled together). Workbooks published
to Tableau Public can't use live database connections or rely on extract refresh
schedules (Tableau can't connect to databases behind your firewall). The Tutorial uses
a workbook published to Tableau Public for its example.
Tableau Online is another Tableau-hosted implementation of Tableau Server, in the
cloud. Workbooks published to Tableau Online need to use extracts, or live connections
to certain cloud-based data sources like Salesforce and Google Analytics. Contact
Tableau Software to learn more.
Bootstrapping
There is only one entry point into the API: instantiating a new Viz object, which creates the
HTML necessary to embed a Tableau visualization. To instantiate a new Viz object, simply
call the Viz constructor via new, passing the required parentElement and URL parameters
and an optional set of options. The URL parameter is where you specify the name of the
Tableau server:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Trusted Authentication
If Tableau Server is using trusted authentication and the trusted ticket server is configured to
return the ticket value itself, add a ticket option. For example:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px",
ticket: "Etdpsm_Ew6rJY-9kRrALjauU"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
If the trusted ticket server is configured to return a full URL, specify the ticket in the URL by first
adding trusted after the server name, followed by the ticket. For example:
var placeholderDiv = document.getElementById("tableauViz");
var url = "http://tabserver/trusted/Etdpsm_Ew6rJY9kRrALjauU/views/workbookname/viewname";
var options = {
hideTabs: true,
width: "800px",
height: "700px"
};
var viz = new tableauSoftware.Viz(placeholderDiv, url, options);
Property Getters and Setters
Getters and setters are always functions that start with get or set. They can be called
multiple times with little performance impact (in other words, they should simply return cached
fields or do very simple calculations). Properties are always synchronous and return
immediately with the value, rather than having a callback function.
Call Behavior - Asynchronous
By default, calls are asynchronous since many of them may require a roundtrip to the server.
Methods use the following naming convention:
l
l
Asynchronous calls are indicated by an Async suffix on the method name, for example,
Worksheet.applyFilterAsync().
Asynchronous calls return a Promise object, allowing chaining.
The Tableau JavaScript API uses the CommonJS Promises/A standard. The premise behind
Tableau's implementation is that asynchronous methods return an object that has a then
method in the following form:
then(fulfilledHandler, errorHandler)
The fulfilledHandler is called when the promise is fulfilled (on success). The
errorHandler is called when a promise fails. All arguments are optional and non-function
values are ignored.
Chaining Promises
The promised result of an asynchronous method is passed as the parameter to the next then
() method. For example:
var activeSheet;
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(selectLemon).then(filterToLemonAndMint);
function selectLemon(sheet) {
activeSheet = sheet;
return sheet.selectMarksAsync("Product", "Lemon", "replace");
}
function filterToLemonAndMint() {
return activeSheet.applyFilterAsync("Product", ["Lemon",
"Mint"], "replace");
}
The result of activateSheetAsync() is a promise to eventually return the Sheet object
that was activated, which is passed as the first parameter to the selectLemon() method.
Notice that the selectLemon() method returns a Promise object (the return value of the
selectMarksAsync() method), not the result after the marks have been selected.
However, since it’s a Promise object, the next then() method is not called until that promise
is fulfilled.
If a link in the chain is added after the promise has been fulfilled, the callback will be
immediately called with the value that was previously returned. As the programmer, this means
you don't need to determine if the response has already been received from the server. The
asynchronous methods will always be called, whether it's now or later.
var promise = viz.getWorkbook().activateSheetAsync("Sheet 1");
// Pretend that activatSheeteAsync() has already returned from
the server.
promise.then(callback);
// callback will be called immediately using the Sheet object
// returned from activateSheetAsync()
Return Values of Then() Methods
Whatever is returned in a then() method will get passed as the first parameter to the next
then() method. It can be a scalar value (Number, Boolean, String, etc.), an object, or
another Promise. The infrastructure will automatically wrap non-Promise values into a
Promise value so that they can be chained.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
return "First link";
})
.then(function (message) {
if (message === "First link") { alert("Expected"); }
// no return value here means nothing is passed to the next
link
})
.then(function () {
});
Breaking Out of a Chain
Technically, there’s no way to break out of a chain since that would invalidate the guarantee
that subsequent links in the chain will be called. If there is an exception thrown in part of the
chain, the rest of the chain is run but the errorHandler is called instead of the
fulfilledHandler.
If a link in the chain depends on the results of earlier links, then you should write an if
statement to check your condition. Here's an example:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function (sheet) {
// I’m returning a Promise
return sheet.selectMarksAsync("Product", "NoProduct",
"replace");
})
.then(function () {
return viz.getWorkbook().getActiveSheet().getSelectedMarksAsync
();
})
.then(function (marks) {
// The getSelectedMarksAsync call succeeded, but no marks were
selected
// because there are not any marks corresponding to
"NoProduct".
if (marks.length === 0) {
throw new Error("No marks selected");
}
var firstMarkValue = marks[0].getPairs().get("Product").value;
return sheet.applyFilterAsync("Product", firstMarkValue,
"replace");
})
.then(function (filterName) {
// applyFilterAsync succeeded
}, function(err) {
if (err.message === "No marks selected") {
alert("This was caused by the first link above");
}
})
.otherwise(function (err) {
alert("We handled the error above, so it’s not propagated to
this handler.");
});
If a callback is not provided (or is null or undefined), then the results are passed to the next link
in the chain:
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then()
.then(function (sheet) {
// this is called
});
In this way, you can specify a single otherwise function to handle all errors in the chain. The
always function works the same way, but it is called regardless of success or failure. The
then/otherwise/always functions work similarly to a try/catch/finally block.
viz.getWorkbook().activateSheetAsync("Sheet 1")
.then(function () {
return sheet.selectMarksAsync(...);
})
.then(function (marks) {
// Do something with the marks.
})
.otherwise(function (err) {
// I’m handling all errors in one place.
console.log(err.message);
})
.always(function () {
// Do some cleanup or logging
});
Collections
Many classes have collections of items, where each item has a key (typically an ID or a name).
Examples include a collection of sheets keyed by name or the list of parameters on a sheet
keyed by name. Collections are publicly immutable, exposing read-only functionality. Each
Collection array is keyed with its elements’ identifiers. For example, the result of
Workbook.getPublishedSheetsInfo() is an array with the index corresponding to
the position of the sheet in the workbook. It is also keyed by the sheet name so that you can
access it like this:
var sheet = workbook.getPublishedSheetsInfo()[0];
var sameSheet = workbook.getPublishedSheetsInfo().get("Sheet 1");
Collection Interface
Name
Return
Type
get(key : Collection
string)
item type
has(key bool
: string)
Description
Gets the element in the collection associated with the key, or
undefined if there is nothing associated with it.
Returns true if there is an element in the collection associated
with the key; otherwise, false.
Events
The Viz class acts as the central event hub. This way you only have to go to one place for all
events. It also means that events can be raised on an object that may not have been created
yet. For example, the marksselection event can be raised for a particular sheet even
though the Sheet object hasn't been created yet. Each event contains an anonymous object
with information pertaining to that event, such as the sheet the event occurred on.
Listening to an event is done by calling Viz.addEventListener(type, callback)
and passing in a function callback. Here's an example of listening to an event:
viz.addEventListener("marksSelection", function (marks) {
changeMySelectionUI(marks);
});
Removing a listener is done by calling Viz.removeEventListener(type, listener)
and passing in the same callback function that was passed into Viz.addEventListener
(). For example:
function changeMySelectionUI(marks) {
viz.removeEventListener("marksSelection",
changeMySelectionUI);
}
viz.addEventListener("marksSelection", changeMySelectionUI);
Events are multicast delegates, meaning that multiple listeners are supported. The order in
which notifications are called is not specified. Every event callback takes a single object
containing a pointer to the Viz that raised the event. Each event also adds additional fields to
the event, as specified in the API Reference.
Filtering
When you program filtering you are mimicking the user behavior of clicking a filter in a view to
narrow down the data that is displayed. Here's an example of filtering on a single value:
worksheet.applyFilterAsync("Container", "Jumbo Box",
tableauSoftware.FilterUpdateType.REPLACE);
There is a difference between querying existing filter state and setting new or existing filters.
Querying filters is done via Worksheet.getFiltersAsync() which returns a collection
of Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its
variants) and is a function call that doesn't require you to instantiate a Filter class.
When you specify fields in a filter, you should use the caption as shown in the user interface,
not the database field name. For example, you should use Container (the caption) instead of
Product Container (the actual field name). In some cases, Tableau Desktop renames fields
after they've been dragged to a shelf. For example the Date field might be renamed to YEAR
(Date) after being dragged to the rows shelf. In this case, you should use YEAR(Date) as the
parameter. The exception is hierarchical filters, which use the full hierarchical name (for
example, [Product].[All Product].[Espresso]). Captions can use the optional []
delimiters around names.
Here are samples for many types of filtering:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
worksheet = sheet;
})
// Single value
.then(function () {
return worksheet.applyFilterAsync("Product Type", "Coffee",
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple values
.then(function () {
return worksheet.applyFilterAsync(
"Product Type", ["Coffee", "Tea"],
tableauSoftware.FilterUpdateType.REPLACE);
})
// Multiple Values - adding and removing
.then(function () {
return worksheet.applyFilterAsync("Product", ["Lemon", "Mint"],
tableauSoftware.FilterUpdateType.ADD);
})
.then(function () {
return worksheet.applyFilterAsync("Product", ["Caffe Latte",
"Green Tea"],
tableauSoftware.FilterUpdateType.REMOVE);
})
// All values
.then(function () {
return worksheet.applyFilterAsync("Product Type", "",
tableauSoftware.FilterUpdateType.ALL);
})
// Date Range
.then(function () {
return; worksheet.applyRangeFilterAsync("Date", {
min: new Date(Date.UTC(2010, 3, 1)),
max: new Date(Date.UTC(2010, 12, 31))
});
})
// Clearing a Filter
.then(function () {
return worksheet.clearFilterAsync("Date");
})
// Relative Date
.then(function () {
return worksheet.applyRelativeDateFilterAsync("Date", {
anchorDate: new Date(Date.UTC(2011, 5, 1)),
periodType: tableauSoftware.PeriodType.YEAR,
rangeType: tableauSoftware.DateRangeType.LASTN,
rangeN: 1
});
})
// Quantitative Filters
// SUM(Sales) > 2000 and SUM(Sales) < 4000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 2000,
max: 4000
});
})
// SUM(Sales) > 1000
.then(function () {
return worksheet.applyRangeFilterAsync("SUM(Sales)", {
min: 1000
});
})
// Hierarchical Filters - selecting all on a level
.then(function () {
return worksheet.applyHierarchicalFilterAsync("[Product].
[Product Categories]", {
levels: [0, 1]
}, tableauSoftware.FilterUpdateType.ADD);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding one item
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
// Hierarchical Filters - adding multiple items
.then(function () {
return worksheet.applyHierarchicalFilterAsync(
"[Product].[Product Categories].[Product Name]",
[
"Accessories.Bike Racks.Hitch Rack - 4-Bike",
"Accessories.Bike Stands.All-Purpose Bike Stand"
],
tableauSoftware.FilterUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
.otherwise(function (err) {
console.log(err);
});
Selecting Marks
Selecting marks is almost identical to filtering. For filtering,you use one of the
Worksheet.applyFilterAsync() methods. For selecting marks, you use
Worksheet.selectMarksAsync(). The parameters for mark selection are almost
identical to those used for filtering.
worksheet.selectMarksAsync("Product", "Caffe Latte",
tableauSoftware.SelectionUpdateType.REPLACE);
Here are samples of other types of selecting you can use:
var worksheet;
viz.getWorkbook().activateSheetAsync("Sheet 4").then(function
(sheet) {
worksheet = sheet;
})
// Single dimensions work just like filtering
// Single dimension - single value
.then(function () {
return worksheet.selectMarksAsync("Product", "Mint",
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Mint"],
tableauSoftware.SelectionUpdateType.REPLACE);
})
// Single dimension - Multiple values (delta)
.then(function () {
return worksheet.selectMarksAsync("Product", ["Lemon", "Earl
Grey"],
tableauSoftware.SelectionUpdateType.ADD);
})
.then(function () {
return worksheet.selectMarksAsync(
"Product", ["Chamomile", "Earl Grey"],
tableauSoftware.SelectionUpdateType.REMOVE);
})
// Quantitative selection
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Florida", "Missouri"],
"SUM(Sales)": { min: 3000, max: 4000 }
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
// Hierarchical dimensions
.then(function () {
return worksheet.selectMarksAsync(
"[Product].[Product Categories].[Category]",
"Bikes",
tableauSoftware.SelectionUpdateType.REPLACE);
}, function (err) { /* ignore errors */ })
// Multiple dimensions - multiple values
// ((State = Washington OR Oregon) AND Product = Lemon)
// OR
// (State = Oregon AND Product = Chamomile)
.then(function () {
return worksheet.selectMarksAsync({
"State": ["Washington", "Oregon"],
"Product": "Lemon"
}, tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.selectMarksAsync({
"State": "Oregon",
"Product": "Chamomile"
}, tableauSoftware.SelectionUpdateType.ADD);
})
// Round-tripping selection
.then(function () {
return worksheet.selectMarksAsync(
"Product",
"Lemon",
tableauSoftware.SelectionUpdateType.REPLACE);
})
.then(function () {
return worksheet.getSelectedMarksAsync();
}).then(function (marks) {
// filter out only the Washington and Oregon marks
var onlyWashingtonAndOregon = [];
for (var i = 0, len = marks.length; i < len; i++) {
var m = marks[i];
var pair = m.getPairs().get("State");
if (pair &&
(pair.value === "Washington" || pair.value === "Oregon")) {
onlyWashingtonAndOregon.push(m);
}
}
return worksheet.selectMarksAsync(
onlyWashingtonAndOregon,
tableauSoftware.SelectionUpdateType.REPLACE);
})
.otherwise(function (err) {
console.log(err);
});
API Reference
Style and Conventions
Tableau's JavaScript API follows these JavaScript standards:
l
l
l
l
Classes are PascalCase (initial capital letter, with each subsequent word capitalized)
Namespaces, methods, parameters, and variables are camelCase (initial lowercase letter, with each subsequent word capitalized)
Constants and enum values are UPPERCASE_UNDERSCORE_DELIMITED
Protected variables or methods start with an initial underscore '_' character,
indicating that it should not be referenced by the programmer.
Top-Level Class Diagram
The following class diagram shows the relationships between the top-level classes, as well as
the inheritance hierarchy for the Sheet, Dashboard, and Worksheet classes. Note that
there's always a way to traverse back up the containment hierarchy with parent pointers, with
the exception of VizManager, as it's a static class and always accessible.
Asynchronous and Error Classes
Promise Class
Represents a promise to return a value from an asynchronous method in the future. The
Tableau JavaScript API implements the Promises/A specification.
Methods
Name
Return Description
Type
then(callback: Promise Creates a link in the asynchronous callable chain. The
Function,
callback function is called on success. The errback
errback:
function is called when there is an error. Both parameters
Function)
are optional.
always
Promise Registers a callback that will be called when a promise is
(callback:
resolved or rejected. Shortcut for then(callback,
Function)
callback).
otherwise
Promise Registers a rejection handler. Shortcut for then(null,
(errback:
errback).
Function)
TableauException Class
The TableauException class is not a real class, but simply adds an id field to the standard
JavaScript Error object when an exception is thrown from within the API. As the
programmer, this allows you to uniquely identify the error without having to parse the error
string. It also allows you to add localized messages.
Constructor
There is no public constructor. The only way to get a reference to a TableauException is within
a catch block.
Fields
Name
Type
Description
tableauSoftwareErrorCode ErrorCode Represents an ErrorCode enum
value.
message
string
This is already defined on the standard
Error object, but the message will
contain a description of the exception
that the API code specifies.
ErrorCode Enum
Here's a list of the different exceptions that the API can throw:
Name
BROWSER_
NOT_
CAPABLE
DOWNLOAD_
WORKBOOK_
NOT_
ALLOWED
FILTER_
CANNOT_BE_
PERFORMED
INDEX_OUT_
OF_RANGE
Return Type
browserNotCapable
INTERNAL_
ERROR
internalError
INVALID_
CUSTOM_
VIEW_NAME
INVALID_
DATE_
PARAMETER
INVALID_
invalidCustomViewName
downloadWorkbookNotAllowed
filterCannotBePerformed
indexOutOfRange
invalidDateParameter
invalidFilterFieldName
Description
The browser is not capable of
supporting the Tableau
JavaScript API.
The permissions on a workbook
or a view do not allow
downloading the workbook.
An error occurred while
attempting to perform a filter
operation.
Attempted to switch to a sheet
by index that does not exist in
the workbook.
An error occurred within the
Tableau JavaScript API.
Contact Tableau Support.
An operation was attempted on
a custom view that does not
exist.
An invalid date was specified in
a method that required a date
parameter.
A filter operation was attempted
FILTER_
FIELDNAME
INVALID_
FILTER_
FIELDNAME_
OR_VALUE
on a field that does not exist in
the data source.
invalidFilterFieldNameOrValue
Either a filter operation was
attempted on a field that does
not exist in the data source, or
the value supplied in the filter
operation is the wrong data type
or format.
INVALID_
invalidFilterFieldValue
A filter operation was attempted
FILTER_
using a value that is the wrong
FIELDVALUE
data type or format.
INVALID_
invalidParameter
A parameter is not the correct
PARAMETER
data type or format. The name
of the parameter is specified in
the Error.message field.
INVALID_
invalidSelectionDate
An invalid date value was
SELECTION_
specified in a
Sheet.selectMarksAsync
DATE
() call for a date field.
INVALID_
invalidSelectionFieldName
A field was specified in a
Sheet.selectMarksAsync
SELECTION_
FIELDNAME
() call that does not exist in the
data source.
INVALID_
invalidSelectionValue
An invalid value was specified in
SELECTION_
a
Sheet.selectMarksAsync
VALUE
() call.
INVALID_SIZE invalidSize
A negative size was specified or
the maxSize value is less than
minSize in
Sheet.changeSizeAsync().
INVALID_
invalidSizeBehaviorOnWorkshe- A behavior other than
SheetSizeBehavior.AUTOSIZE_
et
MATIC was specified in
BEHAVIOR_
Sheet.changeSizeAsync
ON_
() when the sheet is a
WORKSHEET
Worksheet instance.
INVALID_URL invalidUrl
The URL specified in the Viz
class constructor is not valid.
MISSING_
missingMaxSize
The maxSize field is missing in
Sheet.changeSizeAsync
MAX_SIZE
() when specifying
SheetSizeBehavior.ATMOST.
MISSING_
missingMinSize
The minSize field is missing in
MIN_SIZE
MISSING_
missingMinMaxSize
MINMAX_SIZE
MISSING_
RANGEN_
FOR_
RELATIVE_
DATE_
FILTERS
NO_URL_
FOR_
HIDDEN_
WORKSHEET
NO_URL_OR_
PARENT_
ELEMENT_
NOT_FOUND
NOT_
ACTIVE_
SHEET
NULL_OR_
EMPTY_
PARAMETER
SERVER_
ERROR
SHEET_NOT_
IN_
WORKBOOK
STALE_
DATA_
REFERENCE
UNSUPPORTED_EVENT_
NAME
missingRangeNForRelativeDateFilters
noUrlForHiddenWorksheet
Sheet.changeSizeAsync
() when specifying
SheetSizeBehavior.ATLEAST.
Either or both of the minSize
or maxSize fields is missing in
Sheet.changeSizeAsync
() when specifying
SheetSizeBehavior.RANGE.
The rangeN field is missing for
a relative date filter of type
LASTN or NEXTN.
An attempt was made to access
Sheet.getUrl() on a hidden
sheet. Hidden sheets do not
have URLs.
noUrlOrParentElementNotFoun- One or both of the
d
parentElement or the URL
parameters is not specified in
the Viz constructor.
notActiveSheet
An operation was attempted on
a sheet that is not active or
embedded within the active
dashboard.
nullOrEmptyParameter
A required parameter was not
specified, null, or an empty
string/array.
serverError
A general-purpose server error
occurred. Details are contained
in the Error object.
sheetNotInWorkbook
An operation was attempted on
a sheet that does not exist in the
workbook.
staleDataReference
An operation is performed on a
CustomView object that is no
longer valid (it has been
removed).
unsupportedEventName
An unknown event name was
specified in the call to
Viz.addEventListener or
Viz.removeEventListene-
VIZ_
ALREADY_
IN_MANAGER
vizAlreadyInManager
r.
A Viz object has already been
created as a child of the
parentElement specified in
the Viz constructor.
Viz Classes
Class Diagram
VizManager Class
Manages all of the Viz instances on the page, but does not manage vizzes (views) earlier than
version 8.1. This is a static class, meaning that all properties and methods are static and there
is only a single instance of the class.
Properties
Name
getVizs()
Type
Viz[]
Description
Collection of version 8.1 views on the hosting page.
Viz Class
Wraps an <iframe> showing one or more sheets in a Tableau workbook. Contains all of the
chrome surrounding the view.
Constructor
Signature
Viz
(parentElement:
domNode, url:
Description
Creates a new Tableau Viz inside of the given HTML container,
which is typically a <div> element. Each option as well as the
options parameter is optional. If there is already a Viz
string, options:
associated with the parentElement, an exception is thrown.
VizCreateOptions Before reusing the parentElement you must first call
)
dispose().
Properties
Name
getAreTabsHidden()
Type
bool
Description
Indicates whether the tabs are
displayed in the UI. It does not
actually hide individual tabs.
getIsToolbarHidden()
bool
Indicates whether the toolbar is
displayed.
getIsHidden()
bool
Indicates whether the viz is
displayed on the hosting page.
getParentElement()
domNode Returns the node that was
specified in the constructor.
getUrl()
string
The URL of the viz, as specified in
the constructor
getWorkbook()
Workbook One Workbook is supported per
viz.
getAreAutomaticUpdatesPaused bool
Indicates whether automatic
()
updates are currently paused.
Events
Events are added or removed via the following two calls.
Name
addEventListener(
type:
TableauEventName,
listener: Function)
removeEventListener(
type:
TableauEventName,
listener: Function)
Return
Type
None
Description
None
Removes an event listener from the
specified event.
Adds an event listener to the specified event.
Methods
Name
show()
hide()
dispose()
Type
None
None
Description
Shows or hides the <iframe>
hosting the viz.
Cleans up any resources associated
with the viz, removes the viz from the
VizManager, and removes any DOM
elements from parentElement.
Basically, it restores the page to
what it was before instantiating a
new Viz object.
pauseAutomaticUpdatesAsync() None
resumeAutomaticUpdatesAsync
()
toggleAutomaticUpdatesAsync
()
revertAllAsync()
Promise
refreshDataAsync()
None
showDownloadWorkbookDialog
()
None
showExportImageDialog()
None
showExportPDFDialog()
None
showExportDataDialog(
worksheetInDashboard: Sheet
or SheetInfo or string)
None
showExportCrossTabDialog(
worksheetInDashboard: Sheet
or SheetInfo or string)
None
showShareDialog()
None
setFrameSize(width: int, height:
int)
None
Pauses or resumes layout updates.
This is useful if you are resizing the
viz or performing multiple calls that
could affect the layout.
Equivalent to clicking on the Revert
All toolbar button, which restores the
workbook to its starting state.
Equivalent to clicking on the Refresh
Data toolbar button.
Equivalent to clicking on the
Download toolbar button, which
downloads a copy of the original
workbook.
Equivalent to clicking on the Export
Image toolbar button, which creates
a PNG file of the current viz.
Equivalent to clicking on the Export
PDF toolbar button, which shows a
dialog allowing the user to select
options for the export.
Shows the Export Data dialog, which
is currently a popup window. The
worksheetInDashboard
parameter is optional. If not
specified, the currently active
Worksheet is used.
Shows the Export CrossTab dialog.
The worksheetInDashboard
parameter is optional. If not
specified, the currently active
Worksheet is used.
Equivalent to clicking on the Share
toolbar button, which displays a
dialog allowing the user to share the
viz by email or by embedding its
HTML in a web page.
Sets the size of the iFrame, which
causes the viz to expand or collapse
to fit the iFrame if the viz’s current
sheet’s size is set to AUTOMATIC.
VizCreateOptions Record
These are the options that are specified in the Viz constructor.
Fields
Name
hideTabs
hideToolbar
Type
bool
bool
Description
Indicates whether tabs are hidden or shown.
Indicates whether the toolbar is hidden or
shown.
toolbarPosition
ToolbarPosition Indicates where the toolbar should be placed
if hideToolbar is false.
height
string
Can be any valid CSS size specifier. If not
specified, defaults to 600px.
width
string
Can be any valid CSS size specifier. If not
specified, defaults to 800px.
onFirstInteractive callback(e:
Callback when the viz first becomes
TableauEvent) interactive. This is only called once, but it’s
guaranteed to be called. If the viz is already
interactive, it will be called immediately, but on
a separate "thread."
ToolbarPosition Enum
Enumeration
Name
TOP
BOTTOM
Description
Positions the toolbar along the top of the viz.
Positions the toolbar along the bottom of the viz.
Viz Event Classes
TableauEventName Enum
These are strings passed to Viz.addEventListener/removeEventListener. Note that the value
of the enums are all lowercase strings with no underscores. For example, CUSTOM_VIEW_
LOAD is customviewload. Either the fully-qualified enum
(tableauSoftware.TableauEventName.FILTER_CHANGE) or the raw string
(filterchange) is acceptable.
Name
CUSTOM_VIEW_
LOAD
CUSTOM_VIEW_
REMOVE
CUSTOM_VIEW_
SAVE
CUSTOM_VIEW_
SET_DEFAULT
FILTER_
Event Class
Passed in the
Callback
CustomViewEvent
CustomViewEvent
CustomViewEvent
CustomViewEvent
FilterEvent
Description
Raised when a custom view has finished
loading.
Raised when the user removes a custom
view.
Raised when the user saves a new or
existing custom view.
Raised when a custom view has been
made the default view for this viz.
Raised when any filter has changed
CHANGE
MARKS_
SELECTION
PARAMETER_
VALUE_
CHANGE
TAB_SWITCH
MarksEvent
ParameterEvent
TabSwitchEvent
state. The viz may not be interactive yet.
Raised when marks are selected or
deselected.
Raised when any parameter has
changed state.
Raised after the tab switched, but the viz
may not yet be interactive.
TableauEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
CustomViewEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
Methods
Name
Return Type
getCustomViewAsync Promise<
()
CustomView>
Description
Gets the CustomView object
associated with the event.
FilterEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getWorksheet Worksheet
Gets the Worksheet object associated with
()
the event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
getFieldName string
Gets the name of the field.
()
Methods
Name
Return Type
getFilterAsync() Promise<Field>
Description
Gets the Field object associated with the event.
MarksEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getWorksheet Worksheet
Gets the Worksheet object associated with
()
the event.
getEventName TableauEventName Gets the name of the event which is a string,
()
but is also one of the items in the
TableauEventName enum.
Methods
Name
Return Type Description
getMarksAsync Promise<Mark Gets the selected marks on the Worksheet that
()
[]>
triggered the event.
ParameterEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName()
TableauEventName Gets the name of the event which is a
string, but is also one of the items in the
TableauEventName enum.
getParameterName string
Gets the name of the parameter that
()
changed.
Methods
Name
Return Type
Description
getParameterAsync Promise<Parameter> Gets the Parameter object that
()
triggered the event.
TabSwitchEvent Class
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object associated with the
event.
getEventName()
TableauEventName Gets the name of the event which is a
string, but is also one of the items in the
TableauEventName enum.
getOldSheetName string
Gets the name of the sheet that was
()
active before the tab switch event
occurred.
getNewSheetName string
Gets the name of the sheet that is
()
currently active.
Workbook Classes
Class Diagram
Workbook Class
A Workbook has a collection of Sheets represented as tabs. It also has associated objects like
DataSources and CustomViews.
Properties
Name
getViz()
Type
Viz
Description
Gets the Viz object that contains the
workbook.
getActiveSheet()
Sheet
Gets the currently active sheet (the active
tab)
getActiveCustomView() CustomView Gets the currently active custom view, or
null if no custom view is active.
getPublishedSheetsInfo SheetInfo[]
Note that this is synchronous, meaning
()
getName()
string
that all of the sheets are expected when
loaded.
Gets the name of the workbook saved to
the server. Note that this is not
necessarily the file name.
Methods
Name
revertAllAsync()
Return Type
Promise
Description
Reverts the
workbook to
its last saved
state.
getParametersAsync()
Promise<Parameter[]> Fetches the
parameters
for this
workbook.
changeParameterValueAsync(
Promise<Parameter>
Changes the
name: string,
value of the
value: object)
Parameter
with the given
name and
returns the
new
Parameter.
getCustomViewsAsync()
Promise<CustomView[] Gets the
>
collection of
CustomView
objects
associated
with the
workbook.
showCustomViewAsync(
Promise<CustomView> Changes the
customViewName: string)
viz to show
the named
saved state.
removeCustomViewAsync(
Promise<CustomView> Removes the
customViewName: string)
named
custom view.
rememberCustomViewAsync(
Promise<CustomView> Remembers
customViewName: string)
the current
state of the
workbook by
assigning a
custom view
name.
setActiveCustomViewAsDefaultAsync None
Sets the
()
active custom
view as the
default.
DataSource Class
The Workbook contains one or more data sources. Each Worksheet will have a primary
data source and can have multiple secondary data sources.
Properties
Name
getName()
getIsPrimary
()
getFields()
Type Description
string The name of the DataSource as seen in the UI.
bool Indicates whether this DataSource is a primary or a
secondary data source.
Field Gets an array of Fields associated with the DataSource.
[]
Field Class
A field contains information about what data source it belongs to, its role, and the ability to fetch
the domain values.
Properties
Name
Type
getName()
string
getAggregation FieldAggregationType
()
getDataSource
()
getRole()
DataSource
FieldRoleType
Description
Gets the field name (i.e. caption).
Gets the type of aggregation, which is
one of the following values: SUM, AVG,
MIN, MAX, STDEV, STDEVP, VAR,
VARP, COUNT, COUNTD, MEDIAN,
ATTR, NONE, YEAR, QTR, MONTH, DAY,
HOUR, MINUTE, SECOND, WEEK,
WEEKDAY, MONTHYEAR, MDY, END,
TRUNC_YEAR, TRUNC_QTR, TRUNC_
MONTH, TRUNC_WEEK, TRUNC_DAY,
TRUNC_HOUR, TRUNC_MINUTE,
TRUNC_SECOND, QUART1, QUART3,
SKEWNESS, KURTOSIS, INOUT, USER
Gets the data source to which this field
belongs.
One of the following values: DIMENSION,
MEASURE, UKNOWN
CustomView Class
Represents a named snapshot of the workbook at a specific moment.
Properties
Name
getName()
setName()
getAdvertised()
setAdvertised()
getDefault()
getOwnerName
()
getUrl()
getWorkbook()
Type
string
Description
User-friendly name for the custom view
bool
Indicates whether the custom view is public or private.
bool
string
Gets or sets whether this is the default custom view.
Gets the user that created the custom view.
string
Unique URL to load this view again.
Workbook Gets the Workbook to which this CustomView
belongs.
Methods
Name
Return Type
Description
saveAsync Promise<CustomView> After saveAsync() is called, the result of
()
the getUrl method is no longer blank.
Sheet Classes
Class Diagram
SheetInfo Class
Contains information about a Worksheet or a Dashboard and no methods. Returned as
part of Workbook.getPublishedSheetsInfo().
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getPublishedSheetsInfo().
Properties
Name
getName()
getIndex()
Type
string
int
Description
Gets the name of the sheet.
Gets the index of the sheet within the published tabs.
Note that hidden tabs are still counted in the ordering,
as long as they are published.
getIsActive()
bool
Gets a value indicating whether the sheet is the
currently active sheet.Due to a technical limitation in
version 8.0, this will always return false if the object is a
Worksheet instance that is part of a Dashboard.
getIsHidden() bool
Gets a value indicating whether the sheet is hidden in
the UI. Note that if the entire tab control is hidden, it
does not affect the state of this flag. This sheet may still
report that it is visible even when the tabs control is
hidden.
getSheetType SheetType Gets the type of the sheet. SheetType is an enum
()
with the following values: WORKSHEET and
DASHBOARD.
getSize()
SheetSize Gets the size information that the author specified
when publishing the workbook.
getUrl()
string
Gets the URL for this sheet.
getWorkbook Workbook Gets the Workbook to which this Sheet belongs.
()
Sheet Class
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getActiveSheet()or Dashboard.getObjects().
Properties
Name
getName()
getIndex()
Type
string
int
getIsActive()
bool
getIsHidden()
bool
Description
Gets the name of the sheet.
Gets the index of the sheet within the published tabs.
Note that hidden tabs are still counted in the ordering,
as long as they are published.
Gets a value indicating whether the sheet is the
currently active sheet.
Gets a value indicating whether the sheet is hidden in
the UI. Note that if the entire tab control is hidden, it
does not affect the state of this flag. This sheet may still
report that it is visible even when the tabs control is
hidden.
getSheetType SheetType Gets the type of the sheet. SheetType is an enum
()
with the following values: WORKSHEET and
DASHBOARD.
getSize()
SheetSize Gets the size information that the author specified
when publishing the workbook.
getUrl()
string
Gets the URL for this sheet.
getWorkbook Workbook Gets the Workbook to which this Sheet belongs.
()
Methods
Name
Return
Description
Type
changeSizeAsync Promise< Sets the size information on a sheet. Note that if the
(size: SheetSize)
SheetSize sheet is a Worksheet, only
>
SheetSizeBehavior.AUTOMATIC is allowed
since you can’t actually set a Worksheet to a fixed
size.
SheetSize Record
Describes the way a Sheet should be sized.
Fields
Name
Type
Description
behavior SheetSizeBehavior Contains an enumeration value of one of the
following: AUTOMATIC, EXACTLY, RANGE,
ATLEAST, and ATMOST.
maxSize int
This is only defined when behavior is EXACTLY,
RANGE or ATMOST.
This is only defined when behavior is EXACTLY,
minSize int
RANGE, or ATLEAST.
Worksheet Class
Represents a worksheet tab in the workbook or a dashboard object. These are two separate
concepts: a worksheet and a worksheet instance. However, for simplicity in the API, they are
both combined into the Worksheet class.
Constructor
There is no public constructor. You can only get instances of this class from
Workbook.getPublishedSheets() or Dashboard.getObjects().
Properties
Name
Type
Description
getParentDashboard Dashboard Returns the Dashboard object to which this
()
Worksheet belongs (if it’s on a dashboard).
Otherwise, it returns null.
Methods
Name
Return Type
Description
getDataSourcesAsync Promise<DataSource Gets the primary and all of the
()
[]>
secondary data sources for this
worksheet. Note that by
convention the primary data
source should always be the first
element.
Filtering methods are described in Worksheet Class (Filtering). Marks selection methods are
described in Worksheet Class (Selecting Marks).
Dashboard Class
Contains a collection of DashboardObject instances and a notion of the active object.
Constructor
There is no constructor. You get an instance of this from
Workbook.getPublishedSheets().
Properties
Name
Type
getObjects() DashboardObject[]
getWorkshe- Worksheet[]
ets()
Description
Gets the collection of objects.
Gets the collection of worksheets contained in the
dashboard. Note that this is a helper method and is
equivalent to looping through getObjects() and
collecting all of the
DashboardObject.Worksheet pointers when
DashboardObject.getType() ===
tableauSoftware.DashboardObjectType.WORKSHEET.
DashboardObject Class
Represents one of a series of different areas of the dashboard.
Constructor
There is no constructor. You get an instance of this from Dashboard.getObjects().
Properties
Name
Type
Description
getObjectType DashboardObjectType Gets what the object represents, which is
()
an enum with the following values:
BLANK, WORKSHEET, QUICK_FILTER,
PARAMETER_CONTROL, PAGE_
FILTER, LEGEND, TITLE, TEXT,
IMAGE, WEB_PAGE.
getDashboard
()
getWorksheet
()
Dashboard
getPosition()
Point
getSize()
Size
Worksheet
Gets the Dashboard object that contains
this object.
If getType() returns WORKSHEET, this
contains a pointer to the Worksheet
object.
Gets the coordinates relative to the top-left
corner of the dashboard of the object.
Gets the size of the object.
Parameter Classes
Class Diagram
Parameter Class
Contains information about a workbook parameter. To actually set a parameter’s value, call
workbook.changeParameterValueAsync().
Properties
Name
getName()
Type
string
getCurrentValue()
DataValue
getDataType()
ParameterDataType
getAllowableValuesT- ParameterAllowableValuesype()
Type
getAllowableValues()
DataValue[]
Description
A unique identifier for the
parameter, as specified by
the user.
The current value of the
parameter.
The data type of the
parameter can be one of the
following: FLOAT,
INTEGER, STRING,
BOOLEAN, DATE,
DATETIME.
The type of allowable
values that the parameter
can accept. It can be one of
the following enumeration
items: ALL, LIST, RANGE.
If the parameter is restricted
getMinValue()
DataValue
getMaxValue()
DataValue
getStepSize()
Number
getDateStepPeriod()
PeriodType
to a list of allowable values,
this property contains the
array of those values. Note
that this is not a standard
collection, but a JavaScript
array.
If
getAllowableValuesType is RANGE, this defines
the minimum allowable
value, inclusive. Otherwise
it’s undefined/null.
If
getAllowableValuesType is RANGE, this defines
the maximum allowable
value, inclusive. Otherwise
it’s undefined/null.
If
getAllowableValuesType is RANGE, this defines
the step size used in the
parameter UI control slider.
Otherwise it’s
undefined/null.
If
getAllowableValuesType is RANGE and
getDataType is DATE or
DATETIME, this defines the
step date period used in the
Parameter UI control slider.
Otherwise it’s
undefined/null.
Filtering
There is a difference between querying existing filter state and setting new or existing filters.
Querying filters is done via Worksheet.getFiltersAsync() which returns a collection of
Filter classes. Setting filters is done via Worksheet.applyFilterAsync (and its
variants) and is a function call that doesn't require you to instantiate a Filter class.
When you specify fields in a filter, you should use the caption as shown in the UI, not the
database field name. For example, use Container (the caption) instead of Product
Container (the actual field name). The exception is hierarchical filters, which use the full
hierarchical name (for example, [Product].[All Product].[Espresso]). Captions
can use the optional [] delimiters around names.
Class Diagram
Worksheet Class (Filtering)
These methods are on the Worksheet class, but are listed here for convenience.
Methods
Name
getFiltersAsync()
applyFilterAsync(
fieldName: string,
values: object[] or object,
updateType: FilterUpdateType,
options?: FilterOptions)
Return Type
Promise<Filter
[]>
Promise<string>
applyRangeFilterAsync(
fieldName: string,
range: RangeFilterOptions)
Promise<string>
applyRelativeDateFilterAsync(
Promise<strin-
Description
Fetches the collection of
filters used on the sheet.
Applies a simple categorical
filter (non-date). See the
filtering examples for more
details on these functions.
Returns the fieldName that
was filtered.
Applies a quantitative filter. If
a range is specified that is
outside of the domain
min/max values, no error is
raised and the command is
allowed. Subsequent calls to
getFiltersAsync[] will
return these values even if
they are outside of the
bounds of the domain. This is
equivalent to the behavior in
Tableau Desktop.
Applies a relative date filter.
fieldName: string,
options:
RelativeDateFilterOptions)
applyHierarchicalFilterAsync(
fieldName: string,
values: object,
options:
HierarchicalFilterOptions)
clearFilterAsync(fieldName:
string)
g>
Promise<string>
Promise<string>
Applies a hierarchical filter.
The values parameter is
either a single value, an array
of values, or an object { levels:
["1", "2"] }.
Clears the filter, no matter
what kind of filter it is. Note
that the filter is removed as
long as no associated quick
filter is showing for the field. If
there is a quick filter showing,
then the filter is kept, but it’s
reset to the “All” state
(effectually canceling the
filter). For relative date filters,
however, an error is returned
since there is no “All” state for
a relative date filter. To clear a
relative date filter with a quick
filter showing, you can call
applyRelativeDateFilter() instead using a range
that makes sense for the
specific field.
FilterOptions Record
Passed into the applyFilter methods to control advanced filtering options.
Fields
Name
isExcludeMode
Type
bool
Description
Determines whether the
filter will apply in exclude
mode or include mode. The
default is include, which
means that you use the
fields as part of a filter.
Exclude mode means that
you include everything else
except the specified fields.
RangeFilterOptions Record
Passed into the applyRangeFilterAsync method to control advanced filtering options.
Fields
Name
min
Type
int
max
int
nullOption
NullOption
Description
Minimum value for the range
(inclusive). Optional. Leave
blank if you want a <= filter.
Maximum value for the
range (inclusive). Optional.
Leave blank if you want a >=
filter.
The null values to include.
RelativeDateFilterOptions Record
Passed into the applyRelativeDateFilterAsync method to control advanced filtering
options.
Fields
Name
anchorDate
periodType
rangeType
rangeN
Type
Date
PeriodType
DateRangeType
int
Description
The UTC date from which to filter.
Year, quarter, month, etc.
LAST, LASTN, NEXT, etc.
The number used when the rangeType is LASTN
or NEXTN.
Filter Class
An abstract base class for all of the various filter types.
Properties
Name
getWorksheet
()
getFilterType
()
getFieldName
()
Type
Description
Worksheet Gets the parent worksheet
FilterType
string
Gets the type of the filter. See FilterType Enum for the
values in the enum.
Gets the name of the field being filtered. Note that this
is the caption as shown in the UI and not the actual
database field name.
Methods
Name
getFieldAsync()
Return Type
Promise<Field>
Description
Gets the field that is currently being filtered.
NullOption Enum
An enumeration that indicates what to do with null values for a given filter or mark selection call.
Enumeration
Name
NULL_VALUES
NON_NULL_VALUES
ALL_VALUES
Description
Only include null values in the filter.
Only include non-null values in the filter.
Include null and non-null values in the filter.
CategoricalFilter Class
Properties
Name
getIsExcludeMode
()
getAppliedValues
()
Type
bool
Description
Gets a value indicating whether the filter is exclude
or include (default).
DataValue Gets the collection of values that are currently set
[]
on the filter. Note that this is a native JavaScript
array and not a keyed collection.
QuantitativeFilter Class
Properties
Name
getDomainMinValue
()
getDomainMaxValue
()
getMinValue()
Type
Description
DataValue Gets the minimum value as specified in the
domain.
DataValue Gets the maximum value as specified in the
domain.
DataValue Gets the minimum value, inclusive, applied to
the filter.
getMaxValue()
DataValue Gets the maximum value, inclusive, applied to
the filter.
getIncludeNullValues bool
Indicates whether null values are included in
()
the filter.
RelativeDataFilter Class
Properties
Name
Type
getPeriod() PeriodType
Description
The date period of the filter. See PeriodType Enum
for the values in the enum.
getRange() DateRangeType The range of the date filter (years, months, etc.).
See DateRangeType Enum for the values in the
enum.
getRangeN int
When getRange returns LASTN or NEXTN, this is
()
the N value (how many years, months, etc.).
DataValue Record
A DataValue contains both the raw and formatted value for a filter or parameter. Date values
are always expressed in UTC dates.
Properties
Name
value
Type Description
object Contains the raw native value as a JavaScript type, which is
one of String, Number, Boolean, or Date
formattedValue string The value formatted according to the locale and the
formatting applied to the field or parameter.
FilterType Enum
An enumeration of the valid types of filters that can be applied.
Enumeration
Name
CATEGORICAL
Description
Categorical filters are used to filter to a set of values within the
domain.
QUANTITATIVE Quantitative filters are used to filter to a range of values from a
continuous domain.
HIERARCHICAL Hierarchical filters are used to filter to a set of values organized
into a hierarchy within the domain.
RELATIVE_
Relative date filters are used to filter a date/time domain to a
DATE
range of values relative to a fixed point in time.
FilterUpdateType Enum
An enumeration of the valid types of filtering that can be done.
Enumeration
Name
ALL
Description
Adds all values to the filter. Equivalent to checking the (All) value in a
quick filter.
REPLACE Replaces the current filter values with new ones specified in the call.
ADD
Adds the filter values as specified in the call to the current filter values.
Equivalent to checking a value in a quick filter.
REMOVE
Removes the filter values as specified in the call from the current filter
values. Equivalent to unchecking a value in a quick filter.
PeriodType Enum
An enumeration of a date period used in filters and in parameters.
Enumeration
Name
YEARS
QUARTERS
MONTHS
WEEKS
DAYS
HOURS
MINUTES
SECONDS
DateRangeType Enum
An enumeration of the valid date ranges for a relative date filter.
Enumeration
Name
LAST
LASTN
NEXT
NEXTN
CURRENT
TODATE
Description
Refers to the last day, week, month, etc. of the date period.
Refers to the last N days, weeks, months, etc. of the date period.
Refers to the next day, week, month, etc. of the date period.
Refers to the next N days, weeks, months, etc. of the date period.
Refers to the current day, week, month, etc. of the date period.
Refers to everything up to and including the current day, week, month,
etc. of the date period.
Marks Selection
Selecting marks is almost identical to filtering. For filtering, you use one of the
Worksheet.applyFilterAsync() methods. For selecting marks, you use
Worksheet.selectMarksAsync(). The parameters for marks selection are almost
identical to those used for filtering.This provides a very simple, easy to learn, and consistent
way to accomplish the two most common use cases for the API: filtering and selection.
Worksheet Class (Selecting Marks)
These methods are on the Worksheet class, but are shown here for convenience.
Methods
Name
Return Type
clearSelectedMarksAsync void
()
getSelectedMarksAsync() Promise<Mark
[]>
selectMarksAsync(
void
fieldName: string,
value: object or object[],
updateType:
SelectionUpdateType)
selectMarksAsync(
void
Description
Clears the selection for this
worksheet.
Gets the collection of marks that are
currently selected.
Selects the marks and returns them.
Allows selection based on this syntax
fieldValuesMap: object,
updateType:
SelectionUpdateType)
for the first parameter:
{
"Field1": value,
"Field2": [1, 2, 3]
}
selectMarksAsync(
marks: Mark[],
updateType:
SelectionUpdateType)
void
Mark Class
A mark represents a single data point on the viz. It is independent of the type of viz (bar, line,
pie, etc.).
Constructor
Signature
Pair(fieldName: string, value:
object)
Description
Creates a new Pair with the specified field
name/value pairing
Properties
Name
getPairs
()
Type Description
Pair[] Gets a collection of field name/value pairs associated with the
mark.
Pair Class
A pair contains a field name and a value (both the raw and formatted values).
Constructor
Signature
Mark(pairs: Pair[])
Description
Creates a new Mark with the specified pairs.
Fields
Name
fieldName
value
Type Description
string The field name to which the value is applied.
object Contains the raw native value for the field as a JavaScript
type, which is one of String, Number, Boolean, or Date.
formattedValue string The value formatted according to the locale and the
formatting applied to the field.
SelectionUpdateType Enum
An enumeration of the valid types of marks selection that can be done.
Enumeration
Name
Description
REPLACE Replaces the current marks values with new ones specified in the call.
ADD
Adds the values as specified in the call to the current selection.
Equivalent to control-clicking in desktop.
REMOVE
Removes the values as specified in the call from the current selection.
Equivalent to control-clicking an already selected mark in desktop.
Other Classes
Size Record
Represents a width and height in pixels. This is implemented as a plain JavaScript object (it’s
not a class).
Fields
Name
width
height
Type
int
int
Description
Expressed in pixel units.
Expressed in pixel units.
Point Record
Represents an x/y coordinate in pixels. This is implemented as a plain JavaScript object (it’s not
a class).
Fields
Name
x
y
Type
int
int
Description
Expressed in pixel units.
Expressed in pixel units.
Contacto
En el caso de preguntas sobre ventas, comuníquese con [email protected]
Si necesita soporte al cliente, comuníquese con [email protected]
En el caso de otras preguntas, comuníquese con [email protected]
Teléfono: (206) 633-3400
Copyright
©2013 Tableau Software, Incorporated y sus licenciantes. Todos los derechos reservados.
Patente www.tableausoftware.com/ip.
Partes del código copyright ©2002 The Board of Trustees of the Leland Stanford Junior
University. Todos los derechos reservados.
La instalación de Tableau incluye una version ejecutable sin modificar de la base de datos
Firebird. El código fuente para la base de datos se puede encontrar en
http://www.firebirdsql.org
Para obtener una lista de los avisos de derechos de autor de terceros, consulte el siguiente
archivo que se instala con Tableau Server:
C:\Program Files\Tableau\Tableau Server\8.1\COPYRIGHTS.rtf
Nota: Si instaló Tableau Server de 32-bits en un sistema operativo de 64-bits, estará en
C:\Program Files (x86)\Tableau\Tableau
Server\8.1\COPYRIGHTS.rtf
Este producto incluye software desarrollado por Andy Clark.
Este producto incluye software desarrollado por Apache Software Foundation
(http://www.apache.org/).
Este producto corresponde a Software cliente según se define en el Acuerdo de licencia de
software de usuario final de Tableau Software.

Documentos relacionados