Programação e envio de painéis

Esta página explica como programar e enviar um painel. Para saber como programar Looks ou Explores, acesse a página de documentação Como usar o programador do Looker para enviar conteúdo.

O Looker permite programar entregas imediatas ou recorrentes de painéis com a opção de menu Programar entrega.

Dependendo de como o administrador do Looker configurou suas permissões para entrega de dados, é possível enviar seu conteúdo a um ou mais destinos de envio nativos do Looker:

Também é possível agendar a entrega de dados para um serviço de terceiros integrado ao Looker, como o Slack.

Se houver resultados válidos no cache, o Looker os entregará. Se não houver resultados ou se os resultados armazenados em cache expirarem, o Looker executará a consulta novamente e armazenará esses resultados em cache.

Como iniciar uma entrega em um painel

Verifique se o painel não está no modo de edição. Selecione o menu de três pontos Ações do painel no canto superior direito e escolha Programar entrega. Se a opção Programar entrega não estiver disponível, converse com o administrador do Looker sobre as permissões atribuídas.

Depois de selecionar Programar entrega, uma janela de programações existente ou uma janela de programação e envio é exibida, dependendo se você já criou programações no painel.

Janela de programações atual

Se você já tiver criado programações para este dashboard, uma janela de programações existente será exibida. Essa janela mostra as programações que você definiu, além de informações sobre cada uma delas, como destino e formato. As entregas que usam a recorrência Enviar agora e as programações criadas por outras pessoas não aparecem nessa janela.

Janela de programação atual mostrando uma entrega programada do painel chamada "Análise de pedidos".

Você pode executar as seguintes funções na janela de programações atual:

  • Selecione Enviar agora para enviar uma entrega imediata de conteúdo programado sem interromper a cadência programada.

  • Selecione o menu de três pontos para editar, duplicar ou excluir uma programação.

  • Selecione Concluído para sair da janela.

  • Selecione Nova para abrir a janela de programação e envio e criar uma nova programação ou enviar imediatamente uma nova entrega.

Janela "Programar e enviar"

Se você selecionar Nova na janela de programações existente ou se você não tiver programações pré-existentes para o painel, uma janela de programação e envio será aberta. Essa janela permite personalizar a recorrência, o destino, o formato, os filtros e muito mais:

Janela de programação e envio com opções para personalizar o nome, a recorrência, o destino e o formato de entrega de um painel.

A guia Configurações na janela de programação e envio permite personalizar a recorrência, o destino, o formato da entrega e muito mais.

Como iniciar uma entrega em uma pasta

Também é possível iniciar a entrega de um painel na pasta em que o painel está localizado.

Selecione Programar entrega no menu de três pontos à direita da linha do painel (na visualização em lista) ou no menu de três pontos no canto superior direito da miniatura (na visualização em grade).

Nomear uma entrega

A parte superior da janela de programação e envio mostra o nome atribuído automaticamente à entrega. O nome padrão é o do painel. Para editar o nome da entrega, selecione o nome (indicado pelo sublinhado pontilhado) e faça suas edições.

Dependendo do destino da entrega, o título também pode aparecer em outros lugares:

  • Para entregas de e-mails, o título é usado na linha de assunto do e-mail e como parte do nome do arquivo se você selecionar um formato que use um anexo de e-mail.
  • Para webhooks, o título é incluído no payload do webhook no campo Title.
  • Para entregas a um bucket do Amazon S3, o título é usado no nome do arquivo da entrega e nos e-mails de erro enviados. O nome do arquivo do envio segue o formato TITLE_TIMESTAMP_HASH, em que HASH é um identificador aleatório de seis caracteres e TIMESTAMP segue o padrão YYYY-MM-DDTHHMM. Por exemplo, a parte do carimbo de data/hora seria 2019-05-31T0933 para 31 de maio de 2019 às 9h33. O fuso horário do carimbo de data/hora corresponderá ao Fuso horário de entrega.
  • Para envios SFTP, o título é incluído no nome do arquivo do envio. O nome do arquivo do envio segue o formato TITLE_TIMESTAMP_HASH, em que HASH é um identificador aleatório de seis caracteres e TIMESTAMP segue o padrão YYYY-MM-DDTHHMM. Por exemplo, a parte do carimbo de data/hora seria 2019-05-31T0933 para 31 de maio de 2019 às 9h33. O fuso horário do carimbo de data/hora vai corresponder ao Fuso horário de entrega.
  • Para entregas em serviços integrados que geram um anexo, o título é incluído no nome do arquivo do envio.

Recorrência

Personalize o cronograma de entrega na seção Recorrência.

Enviar agora

Se você selecionar Enviar agora no menu suspenso Recorrência, uma entrega única do painel será enviada depois que você preencher os campos obrigatórios e selecionar o botão Enviar agora na parte inferior da janela.

Programações com base em data e hora

Selecione uma das seguintes opções no menu suspenso Recorrência:

  • Mensal
  • Semanalmente
  • Diariamente
  • Por hora
  • Minutos
  • Meses específicos
  • Dias específicos

As opções de tempo mudam de acordo com a opção escolhida. Por exemplo, as configurações em Por hora incluem um horário de Início e um de Término. O Looker vai enviar a entrega a cada hora, começando no horário de Início e terminando no horário de Término.

Os campos Time, Start e End usam um relógio de 24 horas. Se o horário desejado não estiver disponível no menu suspenso, selecione o campo e digite manualmente o horário, como 9h15 ou 15h37.

As programações Por hora e Minutos se repetem diariamente dentro do período Início e Término que você definiu. O horário de término dos intervalos Por hora e Minutos não é incluído. A última exibição é enviada no último intervalo selecionado, antes do horário de término especificado. Por exemplo, se um painel estiver programado Por hora entre 0h e 23h, ele será enviado na hora, a cada hora, das 0h às 22h. Se uma recorrência for a cada 30 minutos entre 0h e 11h, a entrega será de 12h até 11h.

Programações acionadas por atualizações do datagroup

Se o desenvolvedor LookML tiver configurado datagroups, será possível programar a entrega de um dashboard para depois que um grupo de dados for acionado, tiver gerenciado o cache e recriado as TDPs relevantes.

Selecione Atualização do datagroup no menu suspenso Recorrência. Isso revela um campo Datagroup com um menu suspenso. Selecione o grupo de dados cuja atualização deve solicitar a entrega.

Para programar um painel usando um gatilho de atualização do datagroup, o painel precisa conter pelo menos um bloco baseado em um arquivo de modelo que inclua um parâmetro datagroup. O menu suspenso Datagroup lista todos os grupos de dados definidos nos modelos incluídos no painel, mesmo que os grupos de dados não sejam usados para processar o armazenamento em cache de consultas ou TDPs. Mesmo que o datagroup seja usado no modelo de apenas um bloco, o dashboard inteiro será enviado quando a atualização do grupo de dados selecionado for concluída.

As programações com base em grupos de dados só são enviadas após a conclusão do processo de regeneração para todas as TDPs mantidas com esse parâmetro, garantindo que a entrega inclua os dados mais atualizados.

Destino

A configuração Destino pode exibir várias opções de destino para as entregas do painel. Depois que você seleciona um destino de dados, um novo campo de configuração aparece para que você adicione detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL do webhook. Consulte as seções abaixo para saber mais sobre as configurações de cada destino.

E-mail

Quando E-mail é selecionado no campo Destino, um novo campo Endereços de e-mail é exibido. Este campo é obrigatório.

Insira os endereços de e-mail dos destinatários no campo Endereços de e-mail. Se você inserir vários endereços de e-mail, selecione a tecla Enter ou adicione uma vírgula depois de cada um.

Dependendo das configurações da sua instância do Looker e das permissões atribuídas, você pode enviar e-mails para endereços que não estão associados a qualquer conta de usuário na sua instância do Looker. Esses e-mails são classificados como externos. Os indicadores Todos e Externo à direita do campo mostram o número de todos os destinatários do e-mail e apenas o número de destinatários de e-mail externos. Selecione cada indicador para alternar entre mostrar todos os destinatários de e-mail e apenas os destinatários de e-mail externos. Para que você possa enviar conteúdo a usuários externos, o administrador do Looker precisa ter concedido a você permissões para enviar conteúdo a usuários externos ou adicionado os domínios de e-mail desses destinatários à Lista de permissões de domínios de e-mail para conteúdo programado.

Se um destinatário for outro usuário do Looker, essa pessoa vai ter a opção de se vincular ao painel do e-mail, a menos que o administrador do Looker tenha definido a política de dados enviados por e-mail da instância do Looker como Enviar apenas dados ou a opção Incluir links esteja desmarcada.

Os envios por e-mail não podem exceder 20 MB (para formatos enviados no corpo do e-mail) e 15 MB (para formatos enviados como anexo).

Consulte a seção Opções avançadas nesta página para mais informações sobre entregas de e-mail.

Webhook

Os webhooks são uma maneira de acionar trocas entre serviços baseados na Internet. Com um serviço da Web como o Zapier, os webhooks permitem que os dados do Looker sejam entregues a uma ampla variedade de aplicativos. Por exemplo, você pode programar a entrega periódica de um painel para um webhook.

Para configurar um webhook, acesse seu serviço da Web e faça o seguinte:

  • Consiga um URL que vai receber uma solicitação HTTPS do Looker.
  • Especifique um aplicativo de destino para a entrega de dados do Looker. O aplicativo de destino pode exigir mais configurações para receber dados do Looker.

O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino usados para entregar os dados. Consulte a postagem da comunidade Programação de Looks e painéis usando webhooks para conferir diretrizes sobre como configurar outro aplicativo e receber dados de webhook do Looker.

Quando Webhook é selecionado no campo Destino, um novo campo URL de Webhook aparece. Este campo é obrigatório.

Insira o URL em que o Looker vai enviar uma solicitação HTTPS para essa entrega no campo URL do webhook. Você pode acessar esse URL no serviço da Web que está usando para processar o webhook.

Amazon S3

Os buckets do Amazon S3 são uma maneira comum de armazenar grandes quantidades de dados. Você ou sua empresa precisam ter criado um bucket do S3 com a Amazon para que o Looker possa usá-lo.

Quando o Amazon S3 é selecionado no campo Destino, vários campos novos aparecem e solicitam informações sobre o bucket do Amazon S3:

  • Bucket: o nome do bucket do Amazon S3. Este campo é obrigatório.
  • Caminho opcional: a pasta, se houver, na qual você quer salvar os dados.
  • Access Key: o ID da chave de acesso ao seu bucket do S3, fornecido pela Amazon. Este campo é obrigatório.
  • Chave secreta: a chave de acesso secreta ao bucket do S3, fornecida pela Amazon. Este campo é obrigatório.
  • Região: a região de serviços da Amazon em que seu bucket do S3 está hospedado.

Confira a postagem na comunidade Programação (ilimitado) de resultados para S3 (em inglês) para mais detalhes sobre a entrega de dados usando um bucket do Amazon S3.

SFTP

Enviar resultados para um servidor SFTP é um bom método a ser usado quando seus dados ou visualização são muito grandes para serem enviados por e-mail.

Quando SFTP é selecionado no campo Destino, vários campos novos aparecem e solicitam informações sobre o bucket do Amazon S3:

  • Endereço: o URL ou endereço IP do servidor SFTP para onde você quer enviar seus dados. Este campo é obrigatório. Exemplo:

    • sftp://files.looker.com/Marketing/In/
    • sftp://192.168.0.10/Marketing/In/

  • Nome de usuário e Senha: credenciais de login para o servidor SFTP. Esses campos são obrigatórios.

  • Algoritmo preferencial de troca de chaves: este campo é opcional. Para configurá-la, escolha o algoritmo preferido de troca de chaves SSH para estabelecer a conexão. Se a conexão não for estabelecida em cinco minutos, escolha outro algoritmo. Alguns algoritmos levam muito tempo para gerar uma chave SSH. Essa opção permite usar um algoritmo que talvez leve menos tempo. A escolha de um dos algoritmos o torna o algoritmo preferido para estabelecer a conexão SSH. Se o servidor não oferecer suporte ao algoritmo, todos os outros algoritmos serão usados nas tentativas subsequentes. Quando esse campo é definido como Padrão, a ordem original dos algoritmos na biblioteca de conexão é usada.

O suporte ao SFTP é limitado a credenciais de nome de usuário e senha. As credenciais da chave privada SSH não são compatíveis.

O Looker armazena impressões digitais do SFTP para o servidor SFTP. Se você encontrar erros no envio do SFTP, isso pode indicar que as impressões digitais são inválidas. Nesse caso, entre em contato com seu administrador do Looker.

Destinos de serviço integrados

É possível programar ou enviar entregas de painel para um serviço integrado ao Looker, como Slack, Dropbox, Google Drive e outros. As integrações precisam ser ativadas pelo administrador do Looker. Os administradores do Looker precisam conceder permissões especificamente para que usuários e usuários incorporados enviem e programem dados para integrações de terceiros.

Quando um serviço integrado é selecionado no campo Destination do Programador, vários campos novos podem aparecer e solicitar mais informações.

A lista a seguir mostra os serviços do Looker Action Hub para enviar o conteúdo de um painel.

Veja como usar a lista:

  • Os URLs na coluna Link para o arquivo README fornecem instruções para ativar e configurar o serviço integrado para funcionar com o Looker.
  • Os URLs na coluna Como usar essa integração fornecem instruções sobre como enviar dados do Looker ao serviço integrado. Alguns artigos também contêm instruções de ativação.
  • Tags do LookML obrigatórias lista aquelas que precisam ser usadas com o parâmetro tags no modelo de base do conteúdo.
  • O tipo de ação indica o nível de dados que o serviço integrado está enviando: campo, consulta ou painel. Uma ação no nível do campo envia o valor de uma única célula especificada em uma tabela de dados. Uma ação no nível da consulta envia os resultados de uma consulta inteira, como todas as linhas em um Explore ou Look. Uma ação no nível do painel envia uma imagem de um painel.
  • Usa a autenticação do Google OAuth indica se o serviço integrado usa as credenciais do Google OAuth para autenticação.
  • Usa streaming de dados indica se o serviço integrado é compatível com resultados de consulta transmitidos. Os painéis não podem transmitir dados.
Serviço integrado Descrição Link para o arquivo README Como usar essa integração Tags do LookML obrigatórias Usa a autenticação do Google OAuth (Sim/Não) Usa streaming de dados (Sim/Não)
Armazenamento do Azure Envie e armazene um arquivo de dados no Armazenamento do Azure. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma No No
Espaços da DigitalOcean Envia e armazena um arquivo de dados no DigitalOcean Storage. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma No No
Dropbox Enviar e armazenar um arquivo de dados no Dropbox. Nenhum README disponível Consulte a documentação Nenhuma Sim No
Google Cloud Storage Gravar arquivos de dados em um bucket do Google Cloud Storage. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma No No
Google Drive Enviar dados para o Google Drive. Nenhum README disponível Consulte a documentação Nenhuma Sim No
SendGrid Envie dados e programe resultados para enviá-los a um endereço de e-mail usando a API do SendGrid. Consulte o README no GitHub Confira o artigo da comunidade Nenhuma No No
Slack Envie conteúdo do Looker em mensagens diretas, canais públicos e canais privados no Slack usando o OAuth. Ele está disponível para implantações hospedadas pelo Looker na versão 6.24 ou mais recente com o recurso Lista de permissões de IP desativado. Nenhum README disponível Consulte a documentação Nenhuma Sim No
Anexo do Slack (token de API) Envie dados diretamente para um canal do Slack com as credenciais do usuário. Consulte também a documentação do Lookerbot para ver outras funcionalidades do Slack. Consulte o README no GitHub Consulte a documentação Nenhuma No No
Equipes: webhook de entrada Enviar dados para o Microsoft Teams usando um webhook de entrada. Consulte o README no GitHub Consulte o README Nenhuma No No

Formato

O campo Formato contém um menu suspenso de formatos disponíveis:

  • Arquivo ZIP CSV: os dados não formatados do painel entregues como uma coleção de arquivos de valores separados por vírgulas (CSV) em um diretório compactado. Nas entregas por e-mail, o arquivo ZIP é enviado como um anexo de e-mail.
  • PDF: uma imagem do painel como um único arquivo PDF. O layout padrão mostra os blocos organizados no painel de controle, mas outras opções de layout e dimensionamento estão disponíveis em Opções avançadas. Nas entregas por e-mail, o arquivo é enviado como um anexo.
  • Visualização em PNG: uma imagem do painel como um único arquivo PNG. O layout padrão mostra os blocos conforme eles são organizados no painel de controle, mas outras opções de layout estão disponíveis em Opções avançadas. Para entregas por e-mail, a imagem aparece inline no corpo do e-mail.

Opções avançadas

A guia Opções avançadas oferece mais personalização para sua entrega. As opções disponíveis dependem do destino e formato selecionados de sua entrega.

Mensagem personalizada

Essa opção está disponível apenas para o destino do e-mail.

Digite uma mensagem que você quer incluir no corpo dos e-mails para os destinatários. O Looker limita o número de caracteres de uma mensagem personalizada a 1.500.

Executar programação como destinatário

Essa opção está disponível apenas para o destino do e-mail.

A opção Executar programação como destinatário permite que os usuários especifiquem uma lista de destinatários que receberão o envio de conteúdo como se cada um deles tivesse executado a consulta, com base nas permissões de cada pessoa. Isso significa que os filtros de acesso e os atributos de usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.

Se um usuário for um administrador do Looker, a opção Executar programação como destinatário vai permitir que o administrador especifique uma lista de usuários que vão receber o envio de conteúdo como se cada um deles tivesse executado a consulta, com base nas permissões de cada pessoa. Usuários que não são administradores também podem inserir o próprio endereço de e-mail para receber uma entrega, como se tivessem consultado o conteúdo, com base nas permissões deles. Isso significa que os filtros de acesso e os atributos de usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.

No exemplo abaixo, um administrador do Looker precisa programar um relatório que liste o número de usuários por estado.

O usuário A tem um filtro de acesso definido como users.state = 'California'. Quando a opção Executar programação como destinatário for selecionada, a consulta programada aplicará o filtro de acesso users.state = 'California' e enviará os resultados filtrados ao usuário A. Os resultados filtrados incluirão dados somente sobre a Califórnia.

Na guia Opções avançadas, marque a caixa de seleção Executar programação como destinatário e adicione os endereços de e-mail dos destinatários no campo de texto Endereços de e-mail da guia Configurações. Essa opção considera as permissões do usuário que criou a programação, bem como os tipos de endereços de e-mail adicionados ao campo Endereços de e-mail. Em alguns casos, a opção Executar programação como destinatário não está disponível:

  1. Quando um usuário adiciona o e-mail de um usuário desativado

  2. Quando um usuário adiciona um e-mail que não pertence a um usuário do Looker, conforme indicado pela contagem Externo acima da lista de destinatários:

    Um exemplo de programação que mostra a contagem externa de endereços de e-mail de destinatários que não são usuários do Looker.

Nessas situações, independentemente de a opção ter sido selecionada antes ou depois da inserção do endereço de e-mail externo, a opção Executar programação como destinatário permanecerá ativada, mas a programação não poderá ser salva até que a opção Executar programação como destinatário seja desmarcada ou o endereço de e-mail externo seja removido da lista de destinatários.

No caso especial em que um usuário está listado como um destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta dele é desativada, a programação não será entregue para o usuário desativado na próxima vez que for executada. Se a conta do usuário for excluída, a programação inteira não será entregue a nenhum destinatário. Um administrador ou usuário do Looker com a permissão see_schedules vai poder diagnosticar essa falha na página Histórico do programador do painel Administrador.

Essa opção está disponível apenas para o destino do e-mail.

Se o administrador do Looker tiver definido a política de dados enviados por e-mail da instância do Looker como Enviar links e dados, a janela de programação e envio vai mostrar a opção Incluir links. Selecione essa opção para incluir nos e-mails de entrega de dados um link Ver painel completo que direciona para o painel no Looker. Os links do painel não incluem parâmetros hide_filter.

Os destinatários precisam fazer login no Looker e ter permissões para acessar os modelos em que o painel enviado se baseia para visualizar esse conteúdo no Looker. Se você quiser remover esse link dos e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.

Essa opção está disponível apenas para o destino do e-mail e apenas para painéis incorporados. Ele é exibido quando a opção Incluir links é selecionada.

A opção Incluir link personalizado permite configurar um URL personalizado ao qual o link Ver painel completo se conecta, em vez de vincular ao painel no Looker. Também é possível alterar o texto do link Visualizar painel completo.

Para usar essa opção, um administrador do Looker ou um usuário com a permissão schedule_look_emails ou create_alerts primeiro precisa especificar os domínios permitidos para o link personalizado e selecionar o formato do URL do link personalizado na página Incorporar no menu Administrador.

Domínio

Selecione o domínio do URL na lista de domínios configurados na lista de permissões. Por exemplo, app.customer.com.

Caminho

A opção Caminho só será exibida se a opção URL definido pelo usuário estiver selecionada no campo Selecionar caminho de conteúdo da página Incorporar no menu Administrador.

Insira um caminho personalizado para o URL do link aqui. Por exemplo, se você quiser que seu link personalizado aponte para o URL app.customer.com/my_embed_app, insira o caminho /my_embed_app aqui.

Identificador do URL

Use esse campo para inserir o novo texto do link, que substituirá o texto Visualizar painel completo nos envios de e-mail. Por padrão, esse campo mostra qualquer texto digitado no campo Rótulo do URL da página Incorporar no menu Administrador.

Resultados

Este campo está disponível apenas para formatos de arquivo ZIP CSV de entregas do painel. Ela contém duas opções: Com as opções de visualização aplicadas ou Conforme exibido na tabela de dados. É possível escolher uma das opções.

Escolha a opção Com opções de visualização aplicadas para aplicar algumas das configurações de visualização dos blocos do painel à exibição do seu painel. Isso faz com que os arquivos no seu envio sejam semelhantes aos gráficos de tabela. Todas as configurações a seguir nos menus Gráfico, Série e Formatação definidas para uma visualização serão aplicadas à entrega de dados:

Escolha a opção Conforme exibido na tabela de dados para exibir os dados da forma como aparecem na tabela de dados da janela Explorar aqui de cada bloco do dashboard.

Valores

Este campo está disponível apenas para formatos de arquivo ZIP CSV de entregas do painel. Ele contém duas opções: Formatado ou Não formatado. É possível escolher uma das opções.

  • Selecione Formatado se você quiser que os dados apareçam como na experiência de Análise do Looker, embora alguns recursos, como a vinculação, não sejam compatíveis com todos os tipos de arquivo.
  • Selecione Não formatado se você não quiser aplicar nenhuma formatação especial dos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais, aplicados pelos desenvolvedores do Looker. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.

Abrir tabelas para mostrar todas as linhas

Essa opção está disponível apenas para formatos PDF de envios do painel.

Selecione a caixa Expandir tabelas para mostrar todas as linhas para mostrar todas as linhas das visualizações de tabela no painel, em vez de apenas as linhas mostradas nas miniaturas de blocos do painel.

Se a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos do painel que contêm visualizações de tabela podem ser um pouco diferentes nos PDFs enviados do que no Looker. As seguintes diferenças podem ser perceptíveis no PDF:

  • As personalizações das cores de fundo e tamanhos de fonte foram removidas dos cabeçalhos das colunas e das linhas do subtotal.
  • As tabelas aparecem no tema branco.
  • O ícone de classificação não aparece nas tabelas dinâmicas que não foram classificadas manualmente.
  • As tabelas com a opção Dimensionar colunas para caber ativada se estendem até a largura total do bloco.

Além disso, para tabelas com mais de 20.000 células, as seguintes diferenças podem ser perceptíveis no PDF:

Se a opção Expandir tabelas para mostrar todas as linhas não aparecer depois de escolher PDF no campo Formato, fale com seu administrador do Looker sobre como instalar a versão adequada do renderizador do Chromium para sua instância do Looker.

Organizar os blocos do dashboard em uma coluna

Essa opção está disponível apenas para os formatos de visualização PDF e PNG de envios do painel. Quando o Slack é selecionado como destino de entrega, somente PDFs são aceitos.

Selecione a caixa Organizar blocos do dashboard em uma única coluna para formatar sua visualização em PDF ou PNG em um layout de coluna única. Esse layout mostra blocos do dashboard em uma única coluna vertical. Deixe a caixa desmarcada para mostrar os blocos conforme são organizados no painel de controle.

Tamanho do papel

Essa opção está disponível apenas para formatos PDF de envios do painel.

Você tem a opção de especificar o tamanho e a orientação ideais dos PDFs do painel, selecionando no menu suspenso Tamanho do papel. Grandes visualizações ou grupos de blocos de painel sobrepostos podem precisar ser redimensionados para caberem perfeitamente em uma página de PDF. Se a opção Tamanho do papel não estiver disponível, converse com seu administrador do Looker sobre a instalação da versão mais recente do renderizador do Chromium na instância do Looker.

Resolução da tabela

Essa opção está disponível apenas para o formato de visualização PNG e quando a caixa Organizar blocos do dashboard em uma única coluna está marcada.

É possível personalizar a largura da visualização usando o menu suspenso Resolução da tabela. As opções de largura são:

  • Normal: 800 pixels
  • Grande: 1680 pixels

No caso de envios por e-mail, se você escolher Amplo e a largura da visualização exceder o limite definido pelo cliente de e-mail, os destinatários talvez precisem rolar horizontalmente para acessar a visualização completa.

Fuso horário de entrega

Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar a entrega de dados. Se você não tiver um fuso horário associado à sua conta, o Looker vai usar a configuração Fuso horário do aplicativo.

Se você quiser especificar um fuso horário diferente, selecione-o no menu suspenso. O fuso horário selecionado não afeta os dados no Look ou no dashboard, apenas o horário da exibição.

Filtros

A guia Filtros na janela de programação e envio mostra os filtros aplicados ao painel e os valores deles. Nessa guia, você pode editar os valores de quaisquer filtros existentes aplicados ao painel, e os novos valores serão aplicados à exibição. O painel em si não será afetado.

Não é possível adicionar filtros à sua programação na guia Filtros. Apenas confira e edite os valores dos filtros do painel.

Por exemplo, é possível enviar resultados de equipes regionais filtrados de acordo com os estados de interesse delas.

Se um filtro do painel exigir um valor de filtro, insira um valor na guia Filtros para criar ou salvar as edições na exibição.

Quando os filtros do painel mudam

Às vezes, os filtros do painel mudam depois que uma programação é criada. A tabela abaixo explica como isso afeta os filtros aplicados às entregas programadas.

Ação Efeito no filtro da programação
Uma programação é criada com um filtro. Mais tarde, o valor do filtro é alterado no painel. Nenhum efeito no valor do filtro de programação. Ele continua sendo o valor definido na guia Filtros, mesmo que seja qualquer valor.
Uma programação é criada com um filtro. Posteriormente, o filtro é renomeado no painel. O filtro é removido dos dados enviados.
Uma programação é criada com um filtro. Posteriormente, o filtro será excluído do painel. O filtro é removido dos dados enviados.
Uma programação é criada. Depois, um novo filtro (não obrigatório ou obrigatório) é adicionado ao painel. O filtro é aplicado aos dados enviados usando o valor do filtro definido na guia Filtros. Se nenhum valor for definido na guia Filtros, o valor será interpretado como qualquer valor, basicamente removendo o filtro.

Como usar filtros de atributo do usuário

Se o administrador do Looker tiver configurado valores específicos do usuário, chamados de atributos do usuário, e você tiver privilégios de edição em um painel, crie um filtro que use a opção corresponde a um atributo do usuário. Um filtro desse tipo personaliza automaticamente o valor do filtro para cada visualizador do painel. Com esse tipo de filtro, você pode fornecer resultados personalizados para cada destinatário de entrega. Para saber mais sobre atributos do usuário, acesse a página de documentação Atributos do usuário.

Como testar uma programação

Se você definir o campo Recorrência para algo diferente de Enviar agora, o botão Testar agora vai aparecer no canto inferior esquerdo da janela de programação e envio.

Selecione o botão Testar agora para enviar um teste único da programação somente para você. Uma marca de seleção verde será exibida para confirmar que o teste foi enviado.

Salvar uma programação ou enviar agora

Se você definir o campo Recorrência como Enviar agora, selecione o botão Enviar agora na parte inferior da janela para uma entrega única no destino listado.

Caso tenha definido o campo Recorrência para algo diferente de Enviar agora, selecione o botão Salvar para salvar sua programação e fechar a janela.

Selecione o botão Cancelar para sair da janela sem salvar ou enviar a programação.

Suas programações salvas para um painel aparecem na janela de programações atual. Suas programações salvas para todo o conteúdo aparecem na página Programações do seu perfil de usuário.

Como editar uma programação

Você pode editar somente as programações que criou. Para editar uma programação:

  1. Selecione o menu de três pontos Ações do painel no canto superior direito do painel.
  2. Selecione Programar entrega no menu suspenso.
  3. Na janela de programações atual, selecione o menu de três pontos referente à programação que você quer editar.
  4. Escolha Editar no menu suspenso.
  5. A janela de programação e envio aparece para essa programação. Faça as edições nessa janela.
  6. Selecione Salvar quando as edições forem concluídas ou Cancelar para cancelar.

Como duplicar uma programação

Talvez você queira duplicar uma programação e depois editá-la. Para duplicar uma programação:

  1. Selecione o menu de três pontos Ações do painel no canto superior direito do painel.
  2. Selecione Programar entrega no menu suspenso.
  3. Na janela de programações atual, selecione o menu de três pontos referente à programação que você quer editar.
  4. Escolha Duplicar no menu suspenso.
  5. A janela de agendamento e envio é exibida para a programação duplicada. "Copy" é anexado ao nome da programação.
  6. Faça as edições necessárias.
  7. Selecione Salvar quando as edições forem concluídas ou Cancelar para cancelar as edições e excluir a programação duplicada.

A programação original permanece inalterada quando você cria uma cópia.

Os filtros em uma programação duplicada serão definidos com os mesmos valores que estão na guia Filtros da programação original, embora seja possível editar esses valores. Se algum filtro tiver sido alterado desde a criação da programação original, ele será afetado, conforme mostrado na seção Quando os filtros do painel mudarem. Se um filtro obrigatório tiver sido adicionado posteriormente ao painel que serviu de base para a programação original, será necessário selecionar um valor para esse filtro antes de salvar a programação duplicada.

Como excluir uma programação

Você pode excluir somente as programações criadas. Para excluir uma programação:

  1. Selecione o menu de três pontos no canto superior direito do painel.
  2. Selecione Programar entrega no menu suspenso.
  3. Na janela de programações atual, selecione o menu de três pontos referente à programação que você quer editar.
  4. Escolha Excluir no menu suspenso.
  5. Uma nova janela será exibida. Selecione Excluir para excluir a programação ou Cancelar para mantê-la.

Também é possível excluir uma programação na página Programações do seu perfil de usuário.

Desafios de programação

Às vezes, uma entrega programada pode não atingir um ou mais destinatários. Isso pode acontecer se o modelo subjacente tiver um erro, o destinatário não tiver acesso aos dados ou se houver problemas de renderização ou erros na página. O destino dos dados informará um erro se não for possível se conectar ao endpoint especificado.

Nesse caso, o Looker envia um e-mail para notificar o criador da programação. O e-mail inclui um link para o conteúdo programado, uma lista dos destinatários que ele não conseguiu alcançar e mais informações, se disponíveis, sobre o problema que o Looker encontrou ao tentar falar com os destinatários.

Considerações de entrega para administradores

Os administradores do Looker podem conferir, editar, reatribuir e excluir as programações dos usuários. Além disso, os administradores do Looker precisam ter em mente algumas coisas ao configurar a entrega de dados para a instância do Looker e conceder aos usuários permissões para enviar ou programar entregas de dados. Para mais informações, acesse as seguintes páginas da documentação: