Programação e envio de painéis

Nesta página, explicamos como programar e enviar um painel. Para saber como programar Looks ou Análises, acesse a página de documentação Usar o Looker Scheduler para enviar 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 envio de dados, talvez seja possível enviar seu conteúdo para um ou mais destinos de envio nativos do Looker:

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

Se houver resultados válidos no cache, o Looker vai exibir os resultados armazenados. 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 Agendar entrega. Se a opção Agendar entrega não aparecer, fale com o administrador do Looker sobre suas permissões atribuídas.

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

Janela de programações

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 realizar as seguintes funções na janela de programações:

  • Selecione Enviar agora para enviar imediatamente o conteúdo programado sem interromper a cadência.

  • 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 de programação e envio

Se você selecionar Novo na janela de programação atual ou se não tiver programações 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 mostrando opções para personalizar o nome, a repetição, 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 o envio de um painel 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 Title.
  • Para envios a um bucket do Amazon S3, o título é usado no nome do arquivo do envio e em todos os 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 vai corresponder ao fuso horário de entrega.
  • 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.
  • Para envios a serviços integrados que geram um anexo de arquivo, o título é incluído no nome do arquivo do envio.

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 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 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 Hora, Início e Término 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 estiver programado para A cada hora entre 0h e 23h, ele será enviado nessa hora, a cada hora, das 0h às 22h. Se uma recorrência ocorrer a cada 30 minutos entre 0h e 23h, a última entrega será enviada às 22h30.

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

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 de grupo de dados, ele precisa ter pelo menos um bloco baseado em um arquivo de modelo que inclua um parâmetro de grupo de dados. 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 apenas no modelo de um bloco, o painel inteiro será enviado quando a atualização do grupo de dados selecionado for concluída.

Os agendamentos com base em grupos de dados só são enviados depois que o processo de regeneração é concluído para todos os PDTs que são mantidos com esse parâmetro, garantindo que a entrega inclua os dados mais atualizados.

Destino

A configuração Destino pode mostrar 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 E-mail é selecionado no campo Destino, um novo campo Endereços de e-mail aparece. Este campo é obrigatório.

Insira os endereços de e-mail dos destinatários no campo Endereços de e-mail. Se você quiser inserir 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 alternar entre mostrar todos os destinatários de e-mail e mostrar apenas os destinatários externos. Para que você possa enviar conteúdo a usuários externos, o administrador do Looker precisa ter concedido permissões para 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ínio 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 de volta ao painel no 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 ter mais de 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 as 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 podem permitir que os dados do Looker sejam entregues a uma ampla variedade de aplicativos. por exemplo, é possível 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:

  • Receba um URL para o qual o Looker precisa 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 que você está usando para enviar os dados. Consulte a postagem da comunidade sobre como programar visualizações e painéis usando webhooks para conferir diretrizes sobre como configurar outro aplicativo para receber os dados do webhook do Looker.

Quando Webhook é selecionado no campo Destino, um novo campo URL do webhook aparece. 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 encontrar 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 S3 com a Amazon antes que o Looker possa usá-lo.

Quando 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.
  • Chave de acesso: o ID da chave de acesso ao seu 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 os resultados para um servidor SFTP é um bom método quando os dados ou a 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 seu 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. Estes campos são obrigatórios.

  • Algoritmo de troca de chaves preferido: 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 outro algoritmo. 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 faz com que ele seja o 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, a ordem original dos algoritmos na biblioteca de conexão é usada.

O suporte a SFTP é limitado a credenciais de nome de usuário e senha. Não há suporte para credenciais de chave privada SSH.

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

Destinos de serviços integrados

É possível programar ou enviar entregas de painéis 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 usuários e incorporar usuários para enviar e programar 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.

Confira como usar a lista:

  • Os URLs mostrados na coluna Link para o arquivo README incluem 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 fornecem instruções sobre como enviar dados do Looker para o serviço integrado. Alguns desses artigos também contêm instruções de ativação.
  • Tags obrigatórias do LookML lista todas as tags obrigatórias 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 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 uma Análise detalhada 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 streaming 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 Nenhum Não Não
Espaços da DigitalOcean Envie e armazene um arquivo de dados no armazenamento da DigitalOcean. Conferir o README no GitHub Confira o artigo da comunidade Nenhum Não Não
Dropbox Enviar e armazenar um arquivo de dados no Dropbox. Nenhum README disponível Consulte a documentação Nenhum Sim Não
Google Cloud Storage Gravar arquivos de dados em um bucket do Google Cloud Storage. Ver o README no GitHub Conferir o artigo da Comunidade Nenhum Não Não
Google Drive Enviar dados para o Google Drive. Nenhum README disponível Consulte a documentação Nenhum Sim Não
SendGrid Envie dados e programe o envio de resultados para um endereço de e-mail usando a API do SendGrid. Ver o README no GitHub Confira o artigo da comunidade Nenhum Não Não
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 Nenhum Sim Não
Apêndice 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. Conferir o README no GitHub Consulte a documentação Nenhum Não Não
Equipes: webhook de entrada Enviar dados para o Microsoft Teams usando um webhook de entrada. Ver o README no GitHub Consulte o arquivo README Nenhum Não Não

Formato

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

  • Arquivo ZIP CSV: os dados não formatados do painel são enviados como uma coleção de arquivos CSV (valores separados por vírgulas) 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 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 outras opções de layout estão 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 de 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 o administrador especifique uma lista de usuários que vão receber o conteúdo como se cada um deles tivesse executado a consulta, com base nas permissões de cada pessoa. 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 do usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.

No exemplo a seguir, um administrador do Looker precisa programar uma entrega de dados 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 vão incluir apenas dados sobre a Califórnia.

Na guia Opções avançadas, selecione 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 na guia Configurações. Essa opção leva em conta as permissões do usuário que cria a programação e 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 para 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 é listado como destinatário em uma programação com a opção Executar programação como destinatário ativada e a conta desse usuário é desativada, a programação não será entregue ao usuário desativado a partir da próxima execução. Se a conta desse usuário for excluída, toda a programação vai falhar na entrega 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 de e-mail.

Se o administrador do Looker tiver definido a política de dados 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 envio de dados um link Acessar o painel completo que leva ao 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 aparece 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 mudar o texto do link Ver 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ó aparece se URL definido pelo usuário estiver selecionado no campo Selecionar caminho do conteúdo na página Inserir no 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 um novo texto de link, que vai 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. Você pode escolher uma dessas 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 painel. Isso faz com que os arquivos na entrega pareçam gráficos de tabela. Qualquer uma das seguintes configurações nos menus Enredo, Série e Formatação configuradas para uma visualização será aplicada à entrega de dados:

Escolha a opção Conforme exibido na tabela de dados para exibir os dados conforme aparecem na tabela de dados da janela Aqui você pode explorar 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 Sem formatação. Você pode escolher uma dessas opções.

  • 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 Sem formatação se você não quiser aplicar nenhuma formatação especial nos 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 exibir 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 pivotadas que não foram classificadas manualmente.
  • As tabelas com a opção Tamanho das colunas para ajustar ativada se estendem por toda a largura 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 a instalação da 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 de painéis. Quando o Slack é selecionado como destino de entrega, apenas 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 formatos de PDF de envios de painéis.

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. Visualizações grandes ou grupos de blocos de painel sobrepostos podem precisar ser redimensionados para caber em uma página em PDF. Se a opção Tamanho do papel não aparecer, converse com o administrador do Looker sobre a instalação da 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. As opções de largura são:

  • Normal: 800 pixels
  • Grande: 1680 pixels

Para 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 do envio por e-mail talvez precisem rolar horizontalmente para ver toda a visualização.

Zona de tempo 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 usará a configuração Fuso horário do aplicativo.

Se você quiser especificar um fuso horário diferente, selecione o fuso 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, é possível editar os valores de qualquer filtro existente aplicado ao painel, e os novos valores serão aplicados à exibição. O próprio painel 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 a 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 depois que uma programação é criada. A tabela a seguir 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. Mais tarde, o filtro é excluído no 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 definido na guia Filtros. Se nenhum valor for definido na guia Filtros, o valor será interpretado como é qualquer valor, 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 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 enviar resultados personalizados para cada destinatário. Para saber mais sobre os 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 como qualquer coisa que não seja Enviar agora, um 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 como Enviar agora, selecione o botão Enviar agora na parte de baixo da janela para uma entrega única ao destino listado.

Se você definir o campo Repetição como qualquer outra opção que não seja 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.

As programações salvas de um painel aparecem na janela de programações. As 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

Só é possível editar as programações que você 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 horários, selecione o menu de três pontos que se aplica ao horário 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.

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 horários, selecione o menu de três pontos que se aplica ao horário 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" é adicionado ao nome da programação.
  6. Faça as edições.
  7. Selecione Salvar quando as edições forem concluídas ou Cancelar para descartar as edições e excluir a programação duplicada.

A programação original não é alterada quando você cria 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 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 for adicionado posteriormente ao painel em que a programação original é baseada, você precisará selecionar 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 horários, selecione o menu de três pontos que se aplica ao horário que você quer editar.
  4. Selecione Excluir no menu suspenso.
  5. Uma nova janela será aberta. 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 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 esses problemas ocorrerem, o Looker vai 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 que não receberam o conteúdo e mais informações, se disponíveis, sobre o problema encontrado pelo Looker ao tentar alcançar os destinatários.

Considerações de entrega para administradores

Os administradores do Looker podem consultar, editar, reatribuir e excluir as programações. Além disso, os administradores 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 agendar entregas de dados. Para mais informações, acesse as seguintes páginas de documentação: