Nesta página, abordamos o envio de conteúdo de painéis legados. Para informações sobre a programação de painéis, acesse a página de documentação Como programar e enviar painéis.
Esta página fornece uma visão geral do envio de painéis legados para os destinos de entrega nativos do Looker e para qualquer serviço integrado disponível para sua instância do Looker. Para informações específicas sobre o recurso "Explorar e explorar", consulte a página de documentação Como fornecer aparências e explorações.
O Looker Scheduler é o nome da janela pop-up em que você define as configurações para o envio de conteúdo.
Se você é um desenvolvedor do Looker, desative o Modo de desenvolvimento para ativar essas opções de programação.
As opções de entrega disponíveis dependem das permissões relacionadas à entrega concedidas pelo administrador do Looker.
Como abrir o programador de uma pasta
Para abrir o programador em uma pasta ou subpasta, encontre a pasta ou subpasta que contém o painel a ser exibido. Quando você navega para uma pasta, todas as aparências e painéis dentro da pasta são listados na visualização em lista ou na visualização de grade.
Se o administrador tiver ativado o recurso Labs Navigation avançado, será possível acessar as pastas expandindo a lista de pastas na seção Pastas do novo painel de navegação avançado à esquerda.
Um ícone de calendário indica que você programou pelo menos uma exibição recorrente para esse conteúdo. Na visualização em grade, passe o cursor sobre a miniatura do conteúdo para ver o ícone da agenda, se houver:
Na visualização em lista ou visualização em grade, é possível abrir o programador:
- Clicar no ícone de calendário de um item, se houver, e depois clicar em Novo
- Clicar no menu de três pontos de um item e escolher Programar entrega
O Looker mostra o programador, um pop-up com suas opções de programação. Consulte a página de documentação Como programar e enviar painéis para mais informações sobre como definir as configurações de entrega.
Como criar uma entrega
Para criar uma entrega no conteúdo do Looker, abra o programador legado clicando no menu de engrenagem no canto superior direito do conteúdo e escolhendo Programar (para entregas recorrentes) ou Enviar (para entregas únicas).
O Looker exibe o programador legado, um pop-up com suas opções de programação, semelhante a este, que mostra uma entrega programada de um painel legado para um e-mail no formato PDF:
O programador legado para entrega de um Look poderá ter esta aparência:
Para os envios recorrentes, o painel esquerdo do programador legado mostra todas as programações criadas para o conteúdo e destaca o título da programação que você está criando ou editando. O painel esquerdo lista as programações em ordem cronológica inversa, a partir da última atualização. É possível duplicar ou excluir programações existentes clicando no ícone Duplicar ou Excluir à direita da programação, respectivamente.
Se esta for a primeira programação que você está criando para este conteúdo, o painel principal exibirá opções de programação definidas para os valores padrão. Esses valores podem ser modificados como você quiser. Se você já tiver criado uma ou mais programações para esse conteúdo, o painel principal exibirá as configurações de programação salvas no início da lista. Depois, siga estas instruções:
- Para editar as opções de uma programação existente, selecione essa programação e altere-as conforme necessário. Quando terminar, clique em Salvar tudo.
- Para criar programações adicionais para o mesmo conteúdo, clique em Novo + e insira as configurações dessa programação adicional.
Quando terminar, clique em Salvar tudo.
As seções a seguir explicam cada configuração de programação.
Nomear a entrega
Dê um título exclusivo à programação no campo Dê um nome à programação. O título vai aparecer no painel esquerdo depois que você salvar a programação, na lista de programações criadas e nas páginas de gerenciamento de programações no painel Administrador.
Dependendo do destino da entrega, o título também poderá ser exibido em outros lugares:
- Nas entregas de e-mails, o título é usado para o assunto e como parte do nome do arquivo se você selecionar um formato que usa um anexo de e-mail.
- Para webhooks, o título é incluído no payload do webhook no campo Título.
- Para entregas em um bucket do Amazon S3, o título é usado no nome do arquivo de envio e nos e-mails de erro enviados. O nome do arquivo da entrega segue o formato
TITLE_TIMESTAMP_HASH
, em queHASH
é um identificador aleatório de seis caracteres eTIMESTAMP
segue o padrãoYYYY-MM-DDTHHMM
(por exemplo, a parte do carimbo de data/hora seria2019-05-31T0933
para 31 de maio de 2019 às 9h33). - Para entregas em serviços integrados que geram um anexo de arquivo, o título é incluído no nome de arquivo da entrega.
Para entregas em SFTP, o título está incluído no nome de arquivo da entrega. O nome do arquivo da entrega segue o formato
TITLE_TIMESTAMP_TOKEN
, em queTOKEN
é um identificador aleatório de seis caracteres eTIMESTAMP
segue o padrãoYYYY-MM-DDTHHMM
(por exemplo, a parte do carimbo de data/hora seria2019-05-31T0933
para 31 de maio de 2019 às 9h33).Para entregas via SFTP, somente caracteres alfanuméricos, sublinhados (_) e hifens (-) são aceitos no nome de arquivo da entrega. O Looker excluirá todos os caracteres além dos caracteres
A-Z
,a-z
,0-9
,_
ou-
inseridos no campo Dê um nome à sua programação.
Como escolher o destino da entrega
Dependendo de como o administrador do Looker configurou suas permissões, nem todos os destinos poderão ser visíveis.
A configuração Para onde esses dados devem ir? pode exibir várias opções de destino para entregas de dados. Cada destino oferece diferentes opções de entrega.
Os destinos incluem:
- webhook (em inglês)
- Bucket do Amazon S3
- SFTP
- Os serviços integrados que o administrador do Looker ativou na sua instância. Veja a lista de serviços disponíveis para a exibição de painéis na seção Opções de entrega para integrações de terceiros desta página.
Depois de selecionar um destino de dados, um novo campo de configuração será exibido para você adicionar detalhes específicos sobre esse destino, como um endereço de e-mail ou um URL do webhook.
Opções de entrega de e-mails
Escolha E-mail na seção Para onde esses dados devem ir?. Seu conteúdo será entregue a uma lista de endereços de e-mail que você especificar.
Na seção Para quem deve ser enviado, por e-mail, digite os endereços de e-mail dos destinatários. Insira apenas um ou vários endereços separados por vírgulas e clique em Adicionar.
Dependendo das configurações da sua instância do Looker e das permissões atribuídas, talvez seja possível enviar e-mails para endereços de e-mail que não estão associados a uma conta de usuário na instância do Looker. Eles são classificados como e-mails externos. Para enviar conteúdo para usuários externos, seu administrador do Looker precisa ter concedido a você permissões para entregar conteúdo para usuários externos ou ter adicionado os domínios de e-mail desses destinatários ao Permitir domínio de e-mail para conteúdo programado.
Se um destinatário for outro usuário do Looker, a opção para vincular novamente ao painel será exibida no e-mail, a menos que o administrador do Looker tenha definido a política de dados enviados por e-mail da instância do Looker como Somente dados enviados ou se a opção Incluir links estiver desmarcada.
Se todos os destinatários cancelarem a inscrição em uma entrega de e-mail programada, essa programação será excluída do Looker, mesmo das páginas de gerenciamento de programação para usuários e administradores. Se um destinatário cancelar a inscrição em nome de um grupo de e-mails, nenhum membro do grupo receberá entregas de e-mails programadas.
Consulte a seção Como aplicar opções de entrega avançadas nesta página para mais informações sobre as entregas de e-mails.
Marque a opção Incluir uma mensagem personalizada para adicionar uma mensagem personalizada ao corpo do e-mail. O Looker limita o número de caracteres em uma mensagem personalizada a 1.500.
As entregas por e-mail não podem exceder 20 MB (para formatos no corpo do e-mail) e 15 MB (para formatos entregues como anexo).
Opções de entrega para webhooks
Os webhooks são uma forma cada vez mais comum 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 em uma ampla variedade de aplicativos. Por exemplo, você pode programar a entrega periódica de um Look ou painel para um webhook. Quando você configurar uma entrega, o Looker solicitará o endereço do webhook.
Na seção Onde os dados devem ser enviados?, escolha Webhook. Na seção URL do webhook, insira o URL para onde a Looker deve enviar uma solicitação HTTPS para essa entrega. Você pode acessar esse URL no serviço da Web que está usando para processar o webhook. Para configurar um webhook, acesse o serviço da Web e faça o seguinte:
- Receber um URL para o qual 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 usados para exibir o painel. Consulte esta postagem da Comunidade do Looker sobre Como programar aparências e painéis usando webhooks (3.46+) para ver diretrizes sobre como configurar outro aplicativo para receber os dados de webhook do Looker.
O Looker tentará enviar para um webhook por no máximo 30 minutos. O destino precisa responder em até 30 minutos à tentativa de entrega do webhook.
Opções de entrega para buckets do Amazon S3
Os buckets do Amazon S3 são uma forma comum de armazenar grandes quantidades de dados. Você ou sua empresa precisarão criar um bucket do S3 com a Amazon para que o Looker possa usá-lo.
Se você escolher a opção de destino do Amazon S3, o Looker solicitará configurações adicionais sobre a formatação e sobre o bucket do Amazon S3, conforme descrito nesta página. Veja esta postagem da Comunidade do Looker sobre programação (ilimitada) de resultados para S3 para mais detalhes sobre o envio de dados usando um bucket do Amazon S3.
Na seção Para onde esses dados devem ir?, escolha Amazon S3. A seção Detalhes do S3 aparece e solicita informações sobre seu bucket do Amazon S3:
- Bucket: o nome do seu bucket do Amazon S3.
- Caminho opcional: a pasta em que você quer salvar os dados, se houver.
- Chave de acesso: o ID da chave de acesso ao seu bucket S3, fornecido pela Amazon.
- Chave secreta: é a chave de acesso secreta do seu bucket S3, fornecida pela Amazon.
- Região: a região de serviços da Amazon em que seu bucket do S3 está hospedado.
Opções de entrega para servidores SFTP
Escolha SFTP na seção Para onde esses dados devem ir? e envie seu painel para um servidor SFTP. Enviar resultados a um servidor SFTP é um bom método a ser usado quando os dados ou a visualização são muito grandes para serem enviados por e-mail. Se você escolher essa opção de exibição, o Looker solicitará o endereço do servidor SFTP, o nome de usuário e a senha conforme descrito abaixo.
Observe o seguinte sobre as entregas de SFTP:
- Para receber entregas SFTP do Looker, verifique se o administrador da rede adicionou endereços IP do Looker à lista de permissões de IP ou às regras de tráfego de entrada do servidor SFTP.
- Ao enviar para um servidor SFTP, somente caracteres alfanuméricos, sublinhados (_) e hifens (-) são aceitos no nome de arquivo da entrega. O Looker excluirá todos os caracteres além dos caracteres
A-Z
,a-z
,0-9
,_
ou-
inseridos no campo Dê um nome à sua programação.
Quando você escolhe o SFTP, o Looker solicita o URL e as informações de login do servidor:
Endereço: o URL ou o endereço IP do servidor SFTP para onde você quer enviar os dados. Por exemplo:
sftp://files.looker.com/Marketing/In/
ousftp://192.168.0.10/Marketing/In/
Este URL de exemplo termina com o caractere
/
. Isso indica que o arquivo será salvo em uma pasta chamadaIn
. Se você não incluir a/
, o arquivo será salvo na pastaMarketing
e "In
" será anexado ao nome do arquivo. É preciso ter acesso de gravação à pasta em que você quer criar o arquivo.Nome de usuário e senha: credenciais de login para o servidor SFTP
Algoritmo de troca de chaves preferido: este campo é opcional. Para configurá-la, escolha o algoritmo de troca de chaves SSH que preferir. Veja a seguir as opções aceitas:
diffie-hellman-group-exchange-sha1
diffie-hellman-group1-sha1
diffie-hellman-group14-sha1
diffie-hellman-group-exchange-sha256
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 demorar menos. A escolha de um dos algoritmos o torna o algoritmo 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 próximas tentativas. Quando ele é definido como Padrão, a ordem original dos algoritmos na biblioteca de conexão é usada.
No momento, o suporte a SFTP é limitado a credenciais de nome de usuário e senha. As credenciais da chave privada SSH não são compatíveis.
Os algoritmos da chave de host compatíveis com os envios SFTP do Looker são:
ssh-rsa
ssh-dss
ssh-rsa-cert-v01@openssh.com
ssh-rsa-cert-v00@openssh.com
O Looker armazena impressões digitais de SFTP no seu servidor SFTP. Se você encontrar erros na entrega 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.
O erro
Java::JavaLang::NullPointerExceptions
pode acontecer quando você envia dados para um servidor SFTP porque um bug no JRuby impede o uso de algoritmos de curva elíptica (EC, na sigla em inglês) e/ou chaves de host para conexões SSH do Looker nos destinos SFTP. Para evitar problemas com o envio de dados para destinos SFTP, não use algoritmos de EC nos arquivos~/.ssh/config
ou/etc/ssh_config
nem armazene chaves de host de EC em~/.ssh
no seu host do Looker.
O Looker faz upload do arquivo para o diretório especificado no servidor SFTP, usando a seguinte convenção para o nome de arquivo:
<name>_<timestamp>_<token>.<file extension>
- O nome informado no campo Dê um nome à sua programação depois que o Looker remove todos os caracteres além de
A-Z
,a-z
,0-9
,_
ou-
. - O carimbo de data/hora em que a programação foi enviada, no formato
%Y-%m-%dT%H%M
- Um token que consiste em uma string aleatória de seis caracteres
- A extensão de arquivo
Exemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv
Opções de entrega para integrações de terceiros
O programador exibirá todas as ações que foram ativadas pelo administrador do Looker. Dependendo do serviço, pode haver campos adicionais específicos do destino. Esses campos fornecem ao serviço integrado outras informações necessárias para executar a ação selecionada com seus dados. Saiba mais sobre como enviar dados de integrações na seção Entregar dados do painel ou da consulta da página de documentação Como compartilhar dados usando um hub de ações.
Para ver uma descrição das informações exigidas por cada serviço, encontre o destino dele em uma das listas abaixo e navegue até o URL mostrado na coluna Como usar este destino.
A lista a seguir mostra todos os serviços integrados em que você pode fornecer um painel:
Como escolher o formato dos dados
Para entregas por e-mail, a opção de selecionar um formato de dados não estará disponível se o administrador do Looker tiver definido a política de dados por e-mail da instância do Looker como Enviar somente link.
Para escolher o formato da entrega, selecione o ícone apropriado na seção Formatar dados como do programador. Consulte a tabela abaixo para ver uma explicação sobre como cada formato é exibido em cada destino.
Formato | Webhook | Amazon S3 | SFTP | |
---|---|---|---|---|
O painel de controle no formato PDF. Para entregas por e-mail, o PDF é enviado como um anexo de arquivo. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | O painel de controle no formato PDF. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | O painel de controle no formato PDF. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | O painel de controle no formato PDF. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | |
Visualização | A visualização no corpo do e-mail como uma imagem PNG. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | Visualização do painel em um único arquivo de imagem PNG. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | Visualização do painel em um único arquivo de imagem PNG. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. | Visualização do painel em um único arquivo de imagem PNG. O layout padrão exibe blocos conforme eles são organizados no painel de controle, mas outras opções de layout e tamanho estão disponíveis em Opções avançadas. |
Arquivo ZIP CSV | Os dados não formatados do painel de controle entregues como uma coleção de arquivos de valores separados por vírgula (CSV) em um diretório compactado. Para entregas de e-mails, o arquivo ZIP é enviado como um anexo de e-mail. | Os dados não formatados do painel de controle entregues como uma coleção de arquivos de valores separados por vírgula (CSV) em um diretório compactado. | Os dados não formatados do painel de controle entregues como uma coleção de arquivos de valores separados por vírgula (CSV) em um diretório compactado. | Os dados não formatados do painel de controle entregues como uma coleção de arquivos de valores separados por vírgula (CSV) em um diretório compactado. |
Os limites de consulta do painel dependem do formato de entrega de dados:
- Os arquivos ZIP CSV incluem quantas linhas a consulta especificar, até um limite de 5.000 linhas.
- Os formatos PDF e de visualização mostram uma imagem estática de cada bloco no momento da execução. No caso de um Bloco que mostra uma visualização em tabela, você vai ver quantas linhas ficaram visíveis no bloco quando o arquivo foi renderizado e não vai poder rolar o bloco.
Acionamento da entrega
Essa opção não estará disponível se você enviar uma entrega única.
Ao programar entregas recorrentes, você tem duas opções para acioná-las:
- Intervalo de repetição: selecione essa opção para usar a programação de entrega definida na seção Especificar a recorrência de exibição nesta página.
- Atualização do grupo de dados: se o desenvolvedor do LookML tiver configurado grupos de dados, será possível programar a entrega para que ele seja acionado depois que um grupo de dados for acionado, tiver gerenciado o cache e recriado PDTs relevantes.
Como especificar o gatilho do grupo de dados
Você não verá essa opção se estiver enviando uma entrega única ou se tiver especificado um acionador de intervalo de repetição para a entrega recorrente.
Para usar um gatilho de grupo de dados, selecione Atualização do grupo de dados na seção Acionador do programador. Em seguida, escolha o grupo de dados de origem no menu suspenso Selecionar grupo de dados:
Para programar o conteúdo usando um gatilho de grupo de dados, o arquivo de modelo em que o conteúdo se baseia precisa incluir um datagroup. O Looker lista todos os grupos de dados definidos nos modelos que estão incluídos no bloco Acesso específico ou no painel, mesmo que os grupos de dados não sejam usados para lidar com o armazenamento em cache de consultas ou PDTs.
As programações baseadas em grupos de dados só são acionadas quando o processo de regeneração é concluído para todos os PDTs que persistem nesse grupo, garantindo que a entrega inclua os dados mais atualizados.
No caso de painéis, que podem ter vários blocos associados a vários grupos de dados, você tem a opção de escolher qualquer um dos grupos de dados associados ao painel. Todo o painel será enviado quando o grupo de dados selecionado for concluído.
Como especificar a recorrência da entrega
Você não verá essa opção se estiver enviando uma entrega única ou se tiver especificado um acionador de atualização do grupo de dados para sua entrega recorrente.
Para entregas que usam um intervalo recorrente, é possível personalizar o tempo da programação na seção Enviar esta programação. Selecione Intervalo repetido na seção Acionador do programador. As opções de tempo mudam conforme você escolhe entre Diariamente, Semanalmente, Mensalmente, Por hora ou Por minuto. É possível ajustar o fuso horário da programação na seção Opções avançadas.
O horário de término para os intervalos Por hora e Por minuto não é inclusivo. A última entrega será enviada no intervalo selecionado antes do horário de término especificado. Por exemplo, se o conteúdo estiver programado para A cada hora, entre 0h e 23h, ele será enviado na hora, de hora em hora, das 00h às 22h. Se o conteúdo estiver programado para Por minuto, a cada 30 minutos, entre 00h e 11h, e 11h, e 11h,
Aplicar filtros à exibição
Se você estiver exibindo uma interface ou um painel que tenha filtros, poderá modificar as condições de filtro para filtrar ainda mais os resultados exibidos.
Clique em Filtros para ver e modificar os filtros associados à aparência ou ao painel para a exibição. Alterar essas opções no filtro não altera os filtros no painel ou na aparência. Se um filtro do painel requer um valor de filtro e o filtro de programação está em branco, uma programação não vai mostrar resultados após a exibição.
Se você mudar os nomes dos campos que servem como filtros nas suas aparências ou painéis, revise a seção Filtros das visualizações e painéis programados e atualize os filtros conforme necessário para refletir as alterações. Se uma exibição de conteúdo programada incluir filtros que não funcionam mais (por exemplo, se o campo referenciado tiver mudado), a exibição programada poderá expor dados não filtrados.
Para personalizar ainda mais as entregas, é possível usar a opção de filtro corresponde a um atributo de usuário se os administradores do Looker tiverem configurado valores específicos do usuário chamados atributos de usuário. Definir um filtro para um desses atributos personaliza automaticamente os resultados para cada usuário, o que significa que você pode enviar resultados personalizados para vários usuários, mesmo que envie uma entrega única. Leia mais sobre isso na página de documentação Atributos do usuário.
Como aplicar opções de entrega avançadas
A seção Opções avançadas fornece personalização adicional para sua exibição. Clique na seta ao lado de Opções avançadas para expandir esse menu. As opções disponíveis dependem do destino e do formato selecionados de envio e se você está exibindo um painel, uma aparência ou uma opção "Explorar". Os links na tabela abaixo direcionam para uma descrição de cada opção disponível para entregas de painéis aos destinos nativos do Looker. As entregas para integrações de terceiros podem ter opções avançadas exclusivas disponíveis.
Opções de e-mail
As seguintes opções estão disponíveis apenas quando você programa a entrega de dados por e-mail:
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 administradores especifiquem uma lista de usuários que receberão a entrega de conteúdo como se eles tivessem executado a consulta com base nas permissões. 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 usuário de cada usuário serão aplicados aos dados incluídos em cada e-mail.
Por exemplo, digamos que um administrador do Looker precise programar o relatório a seguir para uma série de usuários e cada usuário tenha valores de filtro de acesso diferentes:
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 seguintes resultados filtrados ao usuário A:
Essa opção leva em conta as permissões do usuário que cria a programação, bem como os tipos de endereços de e-mail adicionados ao campo de texto Para quem deve ser enviado por e-mail?.
Em alguns casos, a opção Executar programação como destinatário não está disponível:
- Quando um usuário que não é administrador adiciona um endereço de e-mail diferente
- Quando um administrador do Looker adiciona o e-mail de um usuário desativado
- Quando um administrador do Looker adiciona um e-mail que não pertence a um usuário do Looker (uma conta do Looker é indicada por um ícone do Looker ao lado do destinatário):
- Se o e-mail tiver sido adicionado antes da opção Executar programação como destinatário ser selecionada, a opção será desativada automaticamente. Ele fica disponível novamente quando o endereço de e-mail é excluído da lista de destinatários.
- Se o endereço de e-mail tiver sido adicionado depois que a opção Executar programação como destinatário for selecionada, adicionar o endereço de e-mail produzirá um erro e o e-mail será removido automaticamente do campo Para quem deve ser enviado por e-mail?. A opção Executar programação como destinatário permanecerá ativada.
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 a conta desse usuário está desativada, a programação não é entregue ao usuário desativado a partir da próxima vez que é executada. Se a conta desse usuário for excluída, a programação inteira não será entregue a nenhum destinatário. Um administrador ou usuário do Looker com a permissão see_schedules
poderá diagnosticar essa falha na página Histórico do programador no painel Administrador.
Incluir links
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, o programador exibirá uma opção para Incluir vinculações. Quando essa opção está marcada, as entregas de dados de e-mail incluem um link de volta para o Looker: "Ver relatório completo" para visualizações e explorações entregues e "Ver painel completo" para painéis entregues.
Essa vinculação permite que os destinatários dos e-mails explorem ainda mais os dados na sua instância do Looker. Os destinatários precisam fazer login no Looker e ter permissões para acessar o modelo no qual o conteúdo enviado se baseia para visualizar esse conteúdo no Looker. Se você quiser remover esse link dos e-mails de entrega de dados, desmarque a caixa de seleção Incluir links.
Opções de formatação
As opções de formato disponíveis dependem do formato de dados e do destino selecionados.
Usar layout de coluna única
O layout de uma coluna está disponível para envios de PDF e visualização para todos os destinos nativos.
Para envios do painel de controle em formato PDF ou de visualização, você tem a opção de imprimir o PDF em um único layout de coluna que exibe os blocos do painel em uma única coluna vertical. Marque a caixa Usar layout de coluna única para usar essa opção ou deixe a caixa desmarcada para mostrar os blocos organizados no painel.
Resolução da tabela
Nos painéis, marque a opção Usar layout de coluna única para que ela apareça.
Ao enviar conteúdo para e-mail no formato de visualização, você pode personalizar a largura da visualização usando o menu suspenso Resolução da tabela. As opções de largura são as seguintes:
- Normal: 800 pixels
- Amplo: 1.680 pixels
Se você escolher Amplo e a largura da visualização exceder o limite definido pelo cliente de e-mail, talvez os destinatários da entrega de e-mail precisem rolar horizontalmente para ver toda a visualização.
Abrir tabelas
Para exibir todas as linhas de uma tabela de dados, e não apenas aquelas que aparecem na miniatura do bloco do painel, em uma exibição ou download de um painel PDF, marque a caixa Expandir tabelas. Se a opção Expandir tabelas não for exibida, fale com seu administrador do Looker sobre como instalar a versão apropriada do renderizador do Chromium para sua instância do Looker.
Aplicar opções de visualização
Essa opção está disponível para entregas em CSV para todos os destinos.
Você pode configurar se a entrega de dados usará as mesmas opções da sua visualização:
Selecione Aplicar opções de visualização para aplicar algumas das configurações de visualização à sua exibição, fazendo com que ela apareça de maneira semelhante a um gráfico de tabelas. Qualquer uma das seguintes configurações nos menus Plotar, Série e Formatação definidas para a visualização será aplicada à entrega de dados:
- Mostrar números das linhas
- Ocultar totais
- Ocultar totais da linha
- Limitar linhas exibidas a, no máximo, 500 linhas mostradas ou ocultas.
- Mostrar nome do campo completo
- Rótulos personalizados para cada coluna
Desmarque Aplicar opções de visualização se não quiser que essas opções sejam aplicadas. O Looker envia os dados como aparecem na seção Dados do pop-up Explorar a partir do painel do bloco do painel.
Valores de dados formatados
Essa opção está disponível para entregas em CSV para todos os destinos.
É possível configurar a formatação dos dados:
- Selecione Valores de dados formatados para mostrar os dados de forma mais semelhante à experiência de exploração no Looker. No entanto, alguns recursos (como a vinculação) não são compatíveis com todos os tipos de arquivo.
- Desmarque Valores de dados formatados se não quiser aplicar nenhuma formatação especial dos 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.
Fuso horário
Essa opção está disponível para entregas em todos os formatos de dados em todos os destinos nativos.
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á o Fuso horário do aplicativo. Se você quiser especificar um fuso horário diferente, selecione Usar fuso horário personalizado. O fuso horário selecionado não afeta os dados no seu painel ou aparência, apenas o tempo de exibição.
Tamanho do papel
Essa opção está disponível para entregas em PDF para todos os destinos nativos.
É possível especificar o tamanho e a orientação ideais dos PDFs do painel no menu suspenso Tamanho do papel. É possível redimensionar visualizações ou grupos grandes de blocos de painéis sobrepostos para que caibam na página PDF. Se a opção Tamanho do papel não aparecer, fale com seu administrador do Looker sobre como instalar a versão mais recente do renderizador do Chromium para sua instância do Looker.
Como testar a exibição
Clique no botão Enviar teste para enviar uma entrega de teste única ao destino especificado.
Salvando a entrega
Um resumo das configurações de exibição será exibido na parte inferior do programador.
Para entregas únicas, quando terminar de configurar as opções de entrega, clique no botão Enviar para enviar o conteúdo imediatamente ao destino especificado.
Para entregas recorrentes, quando terminar de configurar as opções de entrega, clique no botão Salvar todas para salvar a programação e fechar a janela. O conteúdo será exibido de acordo com suas configurações de envio. Se você reabrir o programador, a programação salva aparecerá no painel esquerdo. Você tem a opção de duplicar ou excluir a programação. Para isso, clique no ícone Duplicar ou Excluir, respectivamente.
A programação salva também aparecerá na página Programações que você criou no seu perfil de usuário e nas páginas Programações e Histórico de programações no painel Administrador. Consulte a seção Como exibir entregas nesta página para mais informações.
Como ver entregas
Você pode ver as programações que criou e, com as permissões adequadas, todas as programações para a instância do Looker.
Como ver as entregas que você criou
Para ver uma lista de todas as programações criadas, acesse a página Programações que você criou. Para acessá-las, clique no ícone do seu perfil de usuário e selecione Programações. Consulte a página Como ver suas entregas de dados programadas para saber como ver e gerenciar as programações que você criou.
Ver entregas criadas por outros usuários
Se o administrador do Looker tiver concedido permissões para ver as páginas de administrador das Programações e do Histórico de programações, você verá a lista de todas as programações de toda a instância do Looker. No entanto, você não poderá editar ou excluir essas programações.
Informações úteis
Às vezes, uma entrega programada de e-mail pode não alcançar um ou mais destinatários. Isso poderá 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.
Outros desafios podem surgir:
- Caso sua empresa tenha definido as próprias configurações de e-mail na seção Administrador do Looker, os administradores do Looker precisarão verificar se as configurações estão corretas e se seu provedor de e-mail está funcionando corretamente.
- Dependendo da configuração do Limite, a entrega de dados será limitada a 5.000 linhas ou a um tamanho máximo de arquivo de 15 MB para e-mails com anexos e 20 MB para e-mails com conteúdo inline. E-mails com mais linhas ou dados que esses limites não serão enviados.
- Se um e-mail não for enviado no horário esperado, mas for recebido, é provável que você esteja concorrendo com outras tarefas do Looker. Essas tarefas podem incluir outros e-mails programados, várias pessoas explorando dados ao mesmo tempo ou tabelas derivadas permanentes criadas. Se isso acontecer, consulte seus administradores do Looker sobre tarefas concorrentes.
- Se um e-mail específico continuar desaparecendo da sua lista de distribuição, é provável que um usuário tenha cancelado a inscrição nesse e-mail programado. Isso pode ser muito desafiador se você usar um alias de e-mail de grupo para enviar para várias pessoas, porque qualquer destinatário pode cancelar a inscrição de todo o alias de e-mail. Se você precisa entender como funcionam as cancelamentos de inscrição, confira esta postagem da Comunidade do Looker sobre eventos de cancelamento de inscrição de um programador.