Programação e envio de painéis

Nesta página, explicamos como programar e enviar um painel. Para saber mais sobre a programação de Looks ou Análises, acesse a página de documentação Como usar o programador do Looker para exibir conteúdo.

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

Dependendo de como o administrador do Looker configurou suas permissões para entrega de dados, você poderá enviar seu conteúdo para um ou mais destinos de envio nativos do Looker:

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

Se houver resultados válidos em cache, o Looker vai entregar resultados armazenados em cache. Se não houver resultados ou se os resultados armazenados em cache expirarem, o Looker vai 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 do painel e escolha Programar entrega. Se a opção Programar entrega não aparecer, converse com o administrador do Looker sobre as permissões atribuídas.

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

Janela de programações atuais

Se você já criou programações para o painel, uma janela de programações será exibida. Essa janela mostra as programações que você definiu e informações sobre cada uma, como destino e formato. Os envios que usam a recorrência Enviar agora e as programações criadas por outras pessoas não aparecem nessa janela.

A janela de programação atual mostrando a entrega programada de um painel chamado "Análise do pedido".

É possível executar as seguintes funções na janela de programações:

  • Selecione Enviar agora para fazer uma entrega imediata do 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 fechar a janela.

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

Janela de programação e envio

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

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

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

Como iniciar uma entrega de uma pasta

Também é possível iniciar a entrega de um dashboard na pasta em que ele 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).

Como nomear uma entrega

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

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

  • Para entregas de e-mail, o título será 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 Título.
  • Nas entregas em um bucket do Amazon S3, o título é usado no nome do arquivo de entrega e nos e-mails de erro enviados. O nome do arquivo da entrega 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 exibição.
  • Nos envios por SFTP, o título é incluído no nome do arquivo do envio. O nome do arquivo da entrega 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 exibição.
  • Nas entregas em serviços integrados que geram um anexo de arquivo, o título é incluído no nome do arquivo da entrega.

Recorrência

Personalize o tempo 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 baseadas em hora e data

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 Por hora incluem um horário de início e um de término. O Looker vai fazer 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 insira manualmente, como 9h15 ou 15h37.

As programações Por hora e Minutos se repetem diariamente no período de Início e Fim que você definir. O horário de término para intervalos Por hora e Minutos não é inclusivo. A última entrega é enviada no último intervalo selecionado antes do horário de término especificado. Por exemplo, se um painel está programado para A cada hora entre 0h e 23h, ele é enviado a cada hora, das 0h às 22h. Se uma recorrência ocorre a cada 30 minutos entre 0h e 11h, ele é enviado a cada hora, das 0h às 22h. Se uma recorrência ocorre a cada 30 minutos entre 0h e 11:00,

Programações acionadas por atualizações do grupo de dados

Se o desenvolvedor do LookML tiver configurado grupos de dados, será possível programar a entrega de um dashboard para ocorrer depois que um grupo de dados for acionado, gerenciar o cache e recriar as PDTs relevantes.

Selecione Atualização do grupo de dados 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 acionador de atualização do grupo de dados, o dashboard precisa ter pelo menos um bloco baseado em um arquivo de modelo que inclua um parâmetro de datagroup. O menu suspenso Datagroup lista todos os grupos de dados definidos nos modelos incluídos no painel, mesmo que eles não sejam usados no armazenamento em cache de consultas ou PDTs. Mesmo que o grupo de dados seja usado em apenas o modelo de um Bloco, o painel 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 PDTs mantidas com esse parâmetro de grupo de dados, garantindo que sua 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 é exibido para adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL do webhook. Consulte as seções a seguir para saber mais sobre as configurações de cada destino.

E-mail

Quando a opção E-mail é selecionada no campo Destino, um novo campo Endereços de e-mail é exibido. Este campo é obrigatório.

Digite os endereços de e-mail dos destinatários no campo Endereços de e-mail. Se você estiver digitando vários endereços de e-mail, pressione a tecla Enter ou adicione uma vírgula após cada endereço.

Dependendo das configurações da sua instância do Looker e das permissões atribuídas a você, talvez seja possível enviar e-mails para endereços não associados a qualquer conta de usuário na instância do Looker. Esses e-mails estão classificados como externos. Os indicadores Todos e Externos à direita do campo mostram o número de todos os destinatários de e-mail e apenas o número de destinatários de e-mail externos. Selecione cada indicador para exibir todos os destinatários de e-mail e apenas os destinatários de e-mail externos. Para você enviar conteúdo a usuários externos, o administrador do Looker precisa ter concedido permissões para você enviar conteúdo a usuários externos ou ter 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 o destinatário for outro usuário do Looker, essa pessoa vai ter a opção de vincular o painel ao painel pelo e-mail, a menos que o administrador do Looker tenha definido a política de dados por e-mail da instância do Looker como Enviar somente 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-mails.

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 podem permitir 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 o serviço da Web e faça o seguinte:

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

O procedimento exato varia de acordo com o serviço da Web e o aplicativo de destino utilizados para entregar os dados. Consulte a postagem na Comunidade Como programar Looks e painéis usando webhooks para ver diretrizes sobre como configurar outro aplicativo para receber dados de webhook do Looker.

Quando Webhook for selecionado no campo Destino, um novo campo URL de Webhook será exibido. Este campo é obrigatório.

Insira o URL para onde o Looker deve enviar uma solicitação HTTPS para essa entrega no campo URL do webhook. Você pode conseguir esse URL no serviço da Web que está usando para lidar com o webhook.

Amazon S3

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

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

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

Confira a postagem na Comunidade sobre programação (ilimitada) para S3 (em inglês) para mais detalhes sobre o fornecimento de dados usando um bucket do Amazon S3.

SFTP

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

Quando a opção SFTP for selecionada no campo Destino, vários campos novos vão aparecer e solicitar informações sobre o bucket do Amazon S3:

  • Endereço: o URL ou endereço IP do servidor SFTP para onde você quer enviar os 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 do servidor SFTP. Esses campos são obrigatórios.

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

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

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

Destinos de serviço integrados

Programe ou envie 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 específicas 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 Destino 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 a que você pode enviar o conteúdo de um dashboard.

Veja como usar a lista:

  • Os URLs na coluna Link para o arquivo README têm instruções sobre como ativar e configurar o serviço integrado para funcionar com o Looker.
  • Os URLs mostrados na coluna Como usar essa integração dão instruções de como enviar dados do Looker para o serviço integrado. Alguns desses artigos também contêm instruções de ativação.
  • Tags do LookML obrigatórias lista todas as tags que precisam ser usadas com o parâmetro tags no modelo subjacente 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 em nível de 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 uma Análise ou um Look. Uma ação no nível do painel envia a imagem de um painel.
  • Usa a autenticação OAuth do Google indica se o serviço integrado usa as credenciais do Google OAuth para autenticação.
  • Usa o streaming de dados indica se o serviço integrado oferece suporte aos resultados da consulta com streaming. 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 OAuth do Google (Sim/Não) Usa fluxo de dados (Sim/Não)
Armazenamento do Azure Envie e armazene um arquivo de dados no Armazenamento do Azure. Ver o README no GitHub Confira o artigo da comunidade Nenhuma No No
Espaços da DigitalOcean Envie e armazene um arquivo de dados no armazenamento da DigitalOcean. Ver o README no GitHub Confira o artigo da comunidade Nenhuma No No
Dropbox Envie e armazene 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. Ver 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 Enviar dados e programar resultados para enviar a um endereço de e-mail usando a API do SendGrid. Ver 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 particulares 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 a documentação do Lookerbot (em inglês) para acessar outras funcionalidades do Slack. Ver 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. Ver o README no GitHub Consulte o arquivo README Nenhuma No No

Formatar

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 exibe os blocos conforme eles são organizados no painel, 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 de PNG: uma imagem do painel como um único arquivo PNG. O layout padrão exibe os blocos conforme eles são organizados no painel, mas há outras opções de layout disponíveis em Opções avançadas. Nas 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 do formato selecionados da sua entrega.

Mensagem personalizada

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

Digite a mensagem que você quer incluir no corpo dos e-mails para os destinatários. O Looker limita o número de caracteres em 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 tivessem realizado a consulta, com base nas permissões de cada pessoa. Isso significa que os filtros de acesso e os atributos de cada usuário serão aplicados aos dados incluídos nos e-mails.

Se um usuário for um administrador do Looker, a opção Executar programação como destinatário permite que ele especifique uma lista de usuários que vão receber o envio de conteúdo como se tivessem executado a consulta, com base nas permissões de cada um. Os 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. Isso significa que os filtros de acesso e os atributos de cada usuário serão aplicados aos dados incluídos nos e-mails.

No exemplo a seguir, um administrador do Looker precisa programar um relatório que liste contagens 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 é selecionada, a consulta programada aplica o filtro de acesso users.state = 'California' e envia os resultados filtrados para o 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 endereços de e-mail para seus destinatários no campo de texto Endereços de e-mail na guia Configurações. Essa opção considera as permissões do usuário que está criando 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 ao lado da lista de endereços de e-mail:

    Um exemplo de programação mostrando 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 permanece ativada, mas a programação não pode ser salva até que a opção Executar programação como destinatário seja desmarcada ou o e-mail externo endereçado seja removido da lista de destinatários.

No caso especial em que um usuário está listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e, em seguida, a conta desse usuário é desativada, a programação não será entregue a ele na próxima vez que for executada. Se a conta desse usuário for excluída, toda a programação não será entregue para os destinatários. Um administrador ou usuário do Looker com a permissão see_schedules poderá diagnosticar essa falha na página Histórico do programador no 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 vinculações. 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 dashboard enviado é baseado para visualizar esse conteúdo no Looker. Se você quiser remover esse link dos seus e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.

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

A opção Incluir link personalizado permite configurar um URL personalizado a que o link Ver painel completo vai se conectar, 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 será exibida somente se URL definido pelo usuário estiver selecionado no campo Selecionar caminho do conteúdo na página Incorporar do menu Administrador.

Insira aqui um caminho personalizado para o URL do link. Por exemplo, se você quiser que o link personalizado direcione 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 Ver painel completo nas entregas de e-mail. Esse campo exibe qualquer texto digitado no campo Rótulo do URL na página Incorporar do menu Administrador por padrão e pode ser alterado.

Resultados

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

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 painel. Isso faz com que os arquivos no envio pareçam semelhantes aos gráficos de tabela. Qualquer uma das seguintes configurações nos menus Enredo, Série e Formatação definidas para uma visualização será aplicada à entrega de dados:

Escolha a opção Como exibido na tabela de dados para enviar os dados como aparecem na tabela de dados da janela Explorar a partir daqui de cada bloco do painel.

Valores

Esse 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 ou outra.

  • Selecione Formatados se você quiser que os dados apareçam de maneira semelhante à experiência de Análise no Looker, embora alguns recursos (como a vinculação) não sejam compatíveis com todos os tipos de arquivo.
  • Selecione Não formatado se não quiser aplicar nenhuma formatação especial aos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais, que os desenvolvedores do Looker possam ter aplicado. 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 os 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 que aparecem 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 tabelas poderão parecer um pouco diferentes nos PDFs enviados em comparação com o Looker. As seguintes diferenças podem ser perceptíveis no PDF:

  • As personalizações de cores de plano de fundo e tamanhos de fonte são removidas dos cabeçalhos das colunas e das linhas de subtotal.
  • As tabelas aparecem no tema branco.
  • O ícone de classificação não aparece em tabelas dinâmicas que não foram classificadas manualmente.
  • As tabelas com a opção Dimensionar colunas para ajustar ativada são esticadas 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 quando você escolher PDF no campo Formato, converse com o administrador do Looker sobre como instalar a versão apropriada 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 dos 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 exibe blocos do dashboard em uma única coluna vertical. Deixe a caixa desmarcada para mostrar os blocos conforme são organizados no painel.

Tamanho do papel

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

Você tem a opção de especificar o tamanho e a orientação ideais dos PDFs do painel. Para isso, selecione no menu suspenso Tamanho do papel. Grandes visualizações ou grupos de blocos de painel sobrepostos podem precisar ser redimensionados para caber perfeitamente em uma página PDF. Se a opção Tamanho do papel não aparecer, converse com o administrador do Looker sobre como instalar a versão mais recente do renderizador do Chromium para sua 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. Estas são as opções de largura:

  • Normal: 800 pixels
  • Grande: 1680 pixels

Para entregas por e-mail, se você escolher Ampla e a largura da visualização exceder o limite definido pelo cliente, talvez os destinatários precisem rolar a tela horizontalmente para exibir a visualização inteira.

Fuso horário de entrega

Por padrão, o Looker usa o fuso horário associado à sua conta para determinar quando enviar os dados. Se você não tiver um fuso horário associado à sua conta, o Looker 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 todos os filtros aplicados ao painel e os valores deles. Nessa guia, você pode editar os valores de qualquer filtro existente aplicado 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 à programação na guia Filtros, apenas acessar e editar os valores dos filtros atuais do painel.

Por exemplo, é possível enviar resultados para equipes regionais filtrados pelos estados de interesse.

Se um filtro do painel requer 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 após a criação de uma programação. A tabela abaixo explica como isso afeta os filtros aplicados às entregas programadas.

Ação Efeito no filtro de programação
Uma programação é criada com um filtro. Depois, 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. Depois, o filtro é renomeado no painel. O filtro é removido dos dados enviados.
Uma programação é criada com um filtro. Depois, ele é 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 de 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, poderá criar um filtro de painel que use a opção de filtro corresponde a um atributo do usuário. Esse tipo de filtro personaliza automaticamente o valor do filtro para cada visualizador do painel. Com esse tipo de filtro, você pode fornecer resultados personalizados para os destinatários de cada entrega. Para ler 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 de entrega da programação somente para você. Uma marca de seleção verde vai aparecer para confirmar que o teste foi enviado.

Salvando uma programação ou enviando agora

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

Se você definir 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 nem enviar a programação.

As programações salvas em 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ê só pode editar 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 atuais, 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 é exibida para ela. Faça suas edições nessa janela.
  6. Selecione Salvar quando as edições forem concluídas ou selecione Cancelar para cancelar as edições.

Como duplicar uma programação

É possível duplicar uma programação e, em seguida, 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 atuais, selecione o menu de três pontos referente à programação que você quer editar.
  4. Escolha Duplicar no menu suspenso.
  5. A janela de programação e envio aparece para a programação duplicada. "Cópia" é anexado ao nome da programação.
  6. Faça suas edições.
  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 não é alterada quando você faz uma cópia.

Os filtros em uma programação duplicada serão definidos com os mesmos valores presentes na guia Filtros da programação original, mas você pode editar esses valores. Se os filtros tiverem sido alterados desde a criação da programação original, eles serão afetados conforme mostrado na seção Quando os filtros do painel mudarem. Se um filtro obrigatório tiver sido adicionado posteriormente ao painel em que a programação original se baseia, selecione um valor para esse filtro antes de salvar a programação duplicada.

Como excluir uma programação

Só é possível excluir as programações que você criou. 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 atuais, 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 manter a programação.

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

Desafios de agendamento

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

Se ocorrerem esses problemas, o Looker enviará 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 com a falha de contato e mais informações, se disponíveis, sobre o problema que o Looker encontrou ao tentar entrar em contato com os destinatários.

Considerações de entrega para administradores

Os administradores do Looker podem ver, editar, reatribuir e excluir as programações dos usuários. Além disso, é preciso considerar 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 o envio de dados. Para mais informações, acesse as seguintes páginas de documentação: