Tabcmd para gerar e enviar por e-mail um PDF de uma exibição do Tableau

Publicado: 03 Apr 2017
Data da última modificação: 20 Jul 2023

Pergunta

Como usar o tabcmd ou a CLI do TSM para gerar um arquivo PDF de uma exibição do Tableau e enviá-lo por e-mail.

Ambiente

Tableau Server

Resposta

Todas as versões do Tableau Server

Este exemplo usa o shareware de email chamado febootimail, mas qualquer cliente de e-mail como o Google G-suite ou o AWS Simple Email Service (SES) pode ser usado.

Para gerar um PDF, digite o seguinte comando:

tabcmd get "<url-of-view>.pdf" -f "<filename>.pdf"
Substitua <url-of-view> pelo caminho da URL da exibição depois que ela tiver sido publicada.

Por exemplo, o comando tabcmd pode ter esta aparência:

tabcmd get "/views/Wow/SummaryReports.pdf" -f "progressReport.pdf"

Se o PDF for gerado com sucesso, o comando tabcmd colocará o arquivo PDF "progressReport.pdf" no diretório de trabalho atual.

Usar tabcmd para enviar mensagens de e-mail com anexos

Este exemplo usa um shareware de e-mail chamado febootimail, que permite total controle sobre os aspectos de geração de e-mail. (Consulte Links relacionados abaixo.)

Este exemplo envia o relatório de progresso em PDF gerado como anexo de e-mail.

tabcmd login -s http://tableauserver:80 -u admin -p admin

tabcmd get "/views/Wow/SummaryReports.pdf" -f "progressReport.pdf"

febootimail.exe -SMTP yourSMTPhost.yourcompany.com -TO "recipient1@yourcompany.com; recipient2@yourcompany.com;recipient3@yourcompany.com" -FROM sender@yourcompany.com -SUBJECT "Generated Tableau View - Tableau Server Automated Alert System (TSAAS)" -ATTACH " C:\Program Files\Tableau\Tableau Command Line\progressReport.pdf" -BODY " this is the text of the body"

Use tabcmd para enviar e-mails formatados com imagens inseridas

Tabcmd pode gerar arquivos PNG e febootimail pode enviar e-mail em HTML. O arquivo HTML deve estar no mesmo diretório que febootimail.

Este exemplo envia uma imagem PNG da exibição do relatório de progresso gerado como um anexo de e-mail.

tabcmd login -s http://tableauserver:80 -u admin -p admin

tabcmd get "/views/Wow/SummaryReports.png" -f "progressReport.png"

Observe que a marca BODY foi substituída por uma marca HTMLFILE. Como tabcmd é capaz de gerar automaticamente uma imagem em PNG, é possível fazer referência a essa imagem no corpo de um modelo de e-mail em HTML, como ilustrado acima.

<html>

<head><title>Email Alert</title></head>

<body><img src="progressReport.png"></body>

</html>

Informações adicionais

Se você instalar febootimail e analisar os arquivos de ajuda desse programa, observará o seguinte:

Em vez de digitar os endereços de e-mail de destinatários usando a marca TO, você pode consultar um arquivo.
Em vez de digitar o corpo do e-mail usando a marca BODY, você pode especificar uma marca HTMLFILE.
É possível anexar vários arquivos.

Esses recursos oferecem controle sobre o processo de geração de e-mails do Tableau. Muitos outros aplicativos e linguagens de script também têm esse tipo de suporte.

Embora o tabcmd propriamente dito não possa enviar mensagens de e-mail, você pode configurar alertas de e-mail a serem gerados se houver uma falha no sistema ou para enviar notificações que permitam aos usuários inscrever suas exibições favoritas.Para obter mais informações sobre esses recursos, consulte o tópico Alertas de e-mail/assinaturas na Ajuda on-line do Tableau Server.
Febooti Commandline Email: http://www.febooti.com/products/command-line-email/