Como programar e enviar painéis

Esta página é sobre 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.

Com o Looker, você pode 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 envio de dados, é 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 tiverem expirado, o Looker vai executar a consulta novamente e armazenar os 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á tiver criado programações para esse painel, uma janela de programações vai aparecer. Essa janela mostra as programações que você definiu e informações sobre cada uma delas, como destino e formato. As entregas que usam a repetição 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.

É 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 anteriores para o painel, uma janela de programação e envio será aberta. Nela, você pode personalizar recorrência, destino, formato, filtros e muito mais:

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 personalizar a repetição, o destino, o formato e muito mais da sua entrega.

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 no lado direito 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 de cima da janela de programação e envio mostra o nome que é 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 as edições.

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

  • Para envios por e-mail, o título é usado para o 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.
  • Para 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 vai corresponder ao fuso horário de entrega.
  • 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, o painel será enviado uma única vez depois que você preencher os campos obrigatórios e selecionar o botão Enviar agora na parte de baixo 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 dependendo da 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 enviar 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 o horário desejado, como 9h15 ou 15h37.

As programações por hora e por minuto são repetidas diariamente dentro do período Início e Término definido. O horário de término dos intervalos por hora e por minuto não é incluído. A última entrega é enviada no último intervalo selecionado antes do horário de término especificado. Por exemplo, se um painel for programado a cada hora entre 12h e 22h, ele será enviado no horário, a cada hora, de 12h a 22h. Se a recorrência for a cada 30 minutos entre 12h e 22h, o último envio será às 22h30.

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

Se o desenvolvedor do LookML tiver configurado datagroups, você poderá programar o envio de um painel para ocorrer depois que um datagroup for acionado, gerenciar o cache e reconstruir os 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 acionar o envio.

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 para lidar com o 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 após a conclusão do processo de regeneração 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 de selecionar um destino de dados, um novo campo de configuração vai aparecer para você adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL de 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ê estiver inserindo vários endereços de e-mail, pressione a tecla Enter ou adicione uma vírgula após cada um deles.

Dependendo das configurações da sua instância do Looker e das permissões atribuídas, você pode enviar e-mails para endereços não associados a nenhuma conta de usuário na sua instância. Esses e-mails sã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 os destinatários 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 um destinatário for outro usuário do Looker, ele vai ter a opção de vincular o painel novamente a partir do e-mail, a menos que o administrador do Looker tenha definido a política de dados por e-mail da sua instância do Looker como Enviar apenas dados ou a opção Incluir links estiver desmarcada.

As entregas 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 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 enviados para uma ampla gama de aplicativos. Por exemplo, você pode programar o envio periódico 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 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 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 em que o Looker precisa 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 do S3 com a Amazon para que o Looker possa usá-lo.

Quando 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 em que você quer salvar seus dados.
  • Chave de acesso: 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 do bucket do S3, fornecida pela Amazon. Este campo é obrigatório.
  • Região: a região dos serviços da Amazon em que seu bucket do S3 está hospedado.

Confira a postagem da comunidade Programação de resultados ilimitados para o S3 para mais detalhes sobre como enviar 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 para o servidor SFTP. Estes campos são obrigatórios.

  • Algoritmo de troca de chaves preferido: esse 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 demoram muito 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 compatível com o servidor, todos os outros algoritmos serão usados nas tentativas seguintes. 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ço 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 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 para os quais você pode enviar o conteúdo de um painel.

Confira como usar a lista:

  • Os URLs mostrados na coluna Link to README file (link para o arquivo README) fornecem instruções para 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.
  • 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 uma imagem de um painel.
  • Usar a autenticação do Google OAuth indica se o serviço integrado usa credenciais do Google OAuth para autenticação.
  • Uso de streaming de dados: indica se o serviço integrado oferece suporte a resultados de consulta transmitidos por 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 Azure Storage. Conferir o README no GitHub Leia o artigo da Comunidade Nenhum Não Não
Espaços da DigitalOcean Enviar e armazenar um arquivo de dados no DigitalOcean Storage. Conferir o README no GitHub Leia 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 Grave arquivos de dados em um bucket do Google Cloud Storage. Conferir o README no GitHub Leia 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. Conferir o README no GitHub Leia o artigo da Comunidade Nenhum Não Não
Slack Envie conteúdo do Looker em mensagens diretas, canais públicos e 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 também a documentação do Lookerbot para conferir outras funcionalidades do Slack. Conferir o README no GitHub Consulte a documentação Nenhum Não Não
Teams: webhook de entrada Envie dados para o Microsoft Teams usando um webhook de entrada. Conferir o README no GitHub Consulte o README Nenhum Não Não

Formato

O campo Formato contém um menu suspenso com os 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. Para envios por e-mail, o arquivo ZIP é enviado como um anexo.
  • 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. Para envios 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, mas outras opções de layout estão disponíveis em Opções avançadas. Para envios 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 de entrega selecionados.

Mensagem personalizada

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

Digite uma mensagem que você quer incluir no corpo dos e-mails enviados aos 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 vão receber o conteúdo como se tivessem executado a consulta, com base nas permissões de cada pessoa. 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.

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 deles. 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 as 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 considera as permissões do usuário que cria 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:

    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, a opção Executar programação como destinatário vai permanecer ativada, mas a programação não poderá ser salva até que a opção Executar programação como destinatário seja desativada ou o endereço de e-mail externo 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 vai poder diagnosticar essa falha na página Histórico do agendador 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 enviados por e-mail da sua 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 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 de base do painel entregue 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 de e-mail e apenas para painéis incorporados. Ele aparece quando a opção Incluir links está selecionada.

A opção Incluir link personalizado permite configurar um URL personalizado ao qual o link Ver painel completo será conectado, 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 precisa especificar os domínios permitidos para o link personalizado e selecionar o formato do URL do link personalizado na página Inserir 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 um caminho personalizado para o URL do link aqui. Por exemplo, se você quiser que o 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 um novo texto de link, que vai substituir o texto Ver painel completo nas entregas de e-mail. Esse campo mostra qualquer texto inserido no campo Rótulo do URL na página Inserir no menu Administrador por padrão e pode ser alterado nesse campo.

Resultados

Esse campo está disponível apenas para formatos de arquivos ZIP CSV de envios de painéis. Ela contém duas opções: Com opções de visualização aplicadas ou Como mostrado na tabela de dados. Você pode escolher uma ou outra.

Escolha a opção Com as opções de visualização aplicadas para aplicar algumas das configurações de visualização dos blocos do painel à entrega do painel. Isso faz com que os arquivos na entrega pareçam gráficos de tabela. Qualquer uma das seguintes configurações nos menus Plot, Series e Formatting que forem configuradas para uma visualização será aplicada ao envio 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 envios de painéis. Ele contém duas opções: Formatado ou Sem formatação. Você pode escolher uma delas.

  • Selecione Formatado se quiser que os dados apareçam de forma semelhante à experiência Análise no Looker. No entanto, alguns recursos (como vinculação) não são 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 formatos de PDF de envios de painéis.

Selecione a caixa Abrir tabelas para mostrar todas as linhas para mostrar todas as linhas de qualquer visualização de tabela no painel, em vez de apenas as linhas que aparecem nas miniaturas do bloco do painel.

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

  • As personalizações de cores de plano de fundo e tamanhos de fonte são removidas dos cabeçalhos de coluna 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 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 notadas 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 os blocos do dashboard em uma única coluna para formatar a visualização em PDF ou PNG em um layout de coluna única. Esse layout mostra os blocos do painel em uma única coluna vertical. Deixe a caixa desmarcada para mostrar os blocos como eles estão organizados no painel.

Tamanho do papel

Essa opção está disponível apenas para formatos de PDF de envios de painéis.

Você pode especificar o tamanho e a orientação ideais dos PDFs do painel selecionando uma opção 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 os blocos do painel 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 vai 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 escolhido não afeta os dados do seu Look ou painel, apenas o tempo de exibição.

Filtros

A guia Filtros na janela de programação e envio mostra todos os filtros aplicados ao painel, além dos valores deles. Nela, você pode editar os valores de todos os filtros aplicados ao painel, e os novos valores serão aplicados à entrega. O próprio painel não será afetado.

Não é possível adicionar filtros à programação na guia Filtros, apenas visualizar e editar os valores dos filtros do painel.

Por exemplo, você pode enviar resultados de equipes regionais filtrados para os estados de interesse.

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

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. Mais tarde, o valor do filtro é alterado no painel. Não tem efeito no valor do filtro da programação. O valor definido na guia Filtros permanece, mesmo que seja qualquer valor.
Uma programação é criada com um filtro. Mais tarde, 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 para um painel, crie um filtro de painel 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 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.

Testar uma programação

Se você definir o campo Recorrência como qualquer coisa que não seja 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 envio de teste único da programação apenas para você. Uma marca de seleção verde vai aparecer 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 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 Ações do painel 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. 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 estiverem concluídas ou Cancelar para cancelar as edições.

Duplicar uma programação

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

  1. Selecione o menu Ações do painel 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 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 muda 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 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 remover 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 programação

Às vezes, uma entrega programada pode não chegar a um ou mais 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 de dados informa um erro se não conseguir se conectar ao endpoint especificado.

Se isso acontecer, 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 sobre a entrega para administradores

Os administradores do Looker podem conferir, editar, reatribuir e excluir as programações de qualquer usuário. Além disso, os administradores do Looker precisam considerar alguns aspectos ao configurar o envio de dados para a instância do Looker e conceder permissões aos usuários para enviar ou programar envios de dados. Para mais informações, acesse as seguintes páginas de documentação: