En esta página, se proporciona una descripción general de la entrega de Vistas y Exploraciones a los destinos de entrega integrados de Looker y a cualquier servicio integrado que esté disponible para tu instancia de Looker. Para obtener información sobre la programación de paneles, visita la página de documentación Programa y envía paneles.
Looker Scheduler es el nombre de la ventana emergente en la que estableces los parámetros de configuración de la publicación de contenido. En el caso de las vistas, puedes usar el programador para enviar entregas únicas o recurrentes. Las exploraciones pueden enviarse solo como entregas únicas. Si quieres programar el contenido de Explorar para su publicación recurrente, primero debes guardarlo como una vista.
Si eres desarrollador de Looker, debes desactivar el Modo de desarrollo para habilitar estas opciones de programación.
Las opciones de entrega disponibles dependen de los permisos relacionados con la entrega que te haya otorgado tu administrador de Looker.
Abrir Scheduler desde una carpeta
En el caso de las exploraciones, puedes abrir el programador solo desde Explorar, no desde una carpeta.
Para abrir el programador desde una carpeta o subcarpeta, busca la carpeta o subcarpeta que contiene el panel que quieres entregar. Cuando navegas a una carpeta, las Vistas y los paneles de la carpeta aparecen en vista de lista o vista de cuadrícula.
El ícono de calendario indica que programaste al menos una entrega recurrente para ese contenido (en la vista de cuadrícula, debes colocar el cursor sobre la miniatura del contenido para ver el ícono de calendario, si está presente).
En la vista de lista, puedes abrir el programador de las siguientes maneras:
- Hacer clic en el ícono de calendario de un elemento, si está presente
- Hacer clic en el menú de tres puntos de un elemento y elegir Editar programación (si ya hay una programación para el elemento), Agregar programación (si aún no hay una programación para el elemento) o Enviar (para crear una entrega única)
- Abre el contenido, haz clic en el menú de ajustes en la esquina superior derecha y elige Programar (para entregas recurrentes) o Enviar (para entregas únicas).
En la vista de cuadrícula, puedes abrir el programador de las siguientes maneras:
- Hacer clic en el ícono de calendario de un elemento, si está presente
- Abre el contenido, haz clic en el menú de ajustes en la esquina superior derecha y elige Programar (para entregas recurrentes) o Enviar (para entregas únicas).
Cómo crear una entrega
Para crear una entrega desde el contenido de Looker, abre el programador heredado. Para ello, haz clic en el menú de ajustes en la esquina superior derecha del contenido y selecciona Programar (para entregas recurrentes) o Enviar (para entregas únicas).
En el caso de las entregas recurrentes, el panel izquierdo del Programador heredado muestra todas las programaciones creadas para el contenido y destaca el título del programa que estás creando o editando. El panel de la izquierda muestra las programaciones en orden cronológico inverso desde la fecha de la última actualización. Para duplicar o borrar programaciones existentes, haz clic en el ícono Duplicar o Borrar a la derecha de la programación, respectivamente.
Si esta es la primera programación que creas para este contenido, el panel principal mostrará las opciones de programación establecidas con sus valores predeterminados. Puedes modificar esos valores según sea necesario. Si ya creaste uno o más programas para este contenido, el panel principal mostrará la configuración de la programación guardada para ese programa en la parte superior de la lista. Luego:
- Para editar las opciones de un programa existente, selecciónalo y cambia las opciones según sea necesario. Cuando hayas terminado, haz clic en Guardar todo.
- Si quieres crear programaciones adicionales para el mismo contenido, haz clic en Nuevo y, luego, ingresa la configuración de esa programación adicional.
Cuando hayas terminado, haz clic en Guardar todo.
En las siguientes secciones, se explica cada parámetro de configuración de programación.
Asigna un nombre a la publicación
Asigna un título único a la programación en el campo Asigna un nombre a la programación. El título aparecerá en el panel izquierdo después de guardar la programación, en la lista de programaciones que creaste y en las páginas de administración de la programación del panel Administrador.
Según el destino de la entrega, el título también puede aparecer en otros lugares:
- En el caso de las entregas de correo electrónico, el título se utiliza como asunto del correo electrónico y como parte del nombre del archivo si seleccionas un formato que utiliza un archivo adjunto de correo electrónico.
- En el caso de los webhooks, el título se incluye en la carga útil del webhook en el campo Title.
- Para las entregas a un bucket de Amazon S3, el título se usa en el nombre de archivo de la entrega y en cualquier correo electrónico de error que se envíe. El nombre del archivo de la publicación sigue el formato
TITLE_TIMESTAMP_HASH
, en el queHASH
es un identificador aleatorio de seis caracteres yTIMESTAMP
sigue el patrónYYYY-MM-DDTHHMM
(por ejemplo, la parte de la marca de tiempo se vería como2019-05-31T0933
para el 31 de mayo de 2019 a las 9:33 a.m.). La zona horaria de la marca de tiempo coincidirá con la Zona horaria de entrega del programa. - Para las entregas a servicios integrados que generan un archivo adjunto, el título se incluye en el nombre de archivo de la entrega.
En el caso de las entregas mediante SFTP, el título se incluye en el nombre de archivo de la publicación. El nombre del archivo de la publicación sigue el formato
TITLE_TIMESTAMP_TOKEN
, en el queTOKEN
es un identificador aleatorio de seis caracteres yTIMESTAMP
sigue el patrónYYYY-MM-DDTHHMM
(por ejemplo, la parte de la marca de tiempo se vería como2019-05-31T0933
para el 31 de mayo de 2019 a las 9:33 a.m.). La zona horaria de la marca de tiempo coincidirá con la Zona horaria de entrega del programa.En las entregas mediante SFTP, solo se admiten caracteres alfanuméricos, guiones bajos (_) y guiones (-) en el nombre de archivo de la publicación. Looker quitará los caracteres que no sean
A-Z
,a-z
,0-9
,_
o-
de los caracteres que ingreses en el campo Asigna un nombre a tu agenda.
Elige el destino de entrega
Según cómo el administrador de Looker haya configurado los permisos, es posible que no todos los destinos sean visibles.
El parámetro de configuración ¿Dónde deben ir estos datos? puede mostrar varias opciones de destino para las entregas de datos. Cada destino ofrece diferentes opciones de entrega.
Los destinos incluyen:
- Correo electrónico
- webhook
- Bucket de Amazon S3
- SFTP
- Cualquier servicio integrado que el administrador de Looker haya habilitado para tu instancia (puedes ver una lista de servicios disponibles para entregar vistas y exploraciones en la sección Opciones de entrega para integraciones de terceros de esta página)
Una vez que selecciones un destino de datos, aparecerá un nuevo campo de configuración para que agregues detalles específicos sobre ese destino, como una dirección de correo electrónico o una URL de webhook.
Opciones de entrega para el correo electrónico
Selecciona Correo electrónico en la sección ¿Dónde deben ir estos datos?. Tu contenido se enviará a la lista de direcciones de correo electrónico que especifiques.
En la sección A quién se debe enviar el correo electrónico, ingresa las direcciones de correo electrónico de los destinatarios. Ingresa una sola dirección de correo electrónico, o varias separadas por comas, y haz clic en Agregar.
Según la configuración de tu instancia de Looker y los permisos que tengas asignados, es posible que puedas enviar correos electrónicos a direcciones que no estén asociadas a ninguna cuenta de usuario en tu instancia de Looker. Estos se clasifican como correos electrónicos externos. Si quieres enviar contenido a usuarios externos, tu administrador de Looker debe haberte otorgado permisos para entregar contenido a usuarios externos o haber agregado los permisos de esos destinatarios. dominios de correo electrónico a la lista de entidades permitidas para el contenido programado.
Si un destinatario es otro usuario de Looker, esa persona verá la opción para volver al panel desde el correo electrónico, a menos que el administrador de Looker haya establecido la política de datos enviados por correo electrónico de tu instancia de Looker como Enviar solo datos o que la opción Incluir vínculos no esté seleccionada.
Si todos los destinatarios anulan la suscripción a una entrega programada por correo electrónico, ese programa se borra de Looker, incluso de las páginas de administración de programas para usuarios y administradores. Si un destinatario anula la suscripción en nombre de un grupo de correo electrónico, ningún miembro del grupo recibirá entregas de correo electrónico programadas.
Consulta la sección Cómo aplicar opciones de entrega avanzadas en esta página para obtener más información sobre las entregas de correo electrónico.
Marca Incluir un mensaje personalizado para agregar un mensaje personalizado en el cuerpo del correo electrónico. Looker limita la cantidad de caracteres de un mensaje personalizado a 1,500.
Los envíos por correo electrónico no pueden superar los 20 MB (en el caso de los formatos que se entregan en el cuerpo del correo electrónico) y los 15 MB (en el caso de los formatos que se envían como archivos adjuntos).
Opciones de entrega para webhooks
Los webhooks son una forma cada vez más común de activar intercambios entre servicios basados en Internet. Con un servicio web como Zapier, los webhooks pueden permitir que los datos de Looker se entreguen a una amplia gama de aplicaciones. Por ejemplo, es posible que puedas programar la entrega periódica de una Vista o un panel a un webhook. Cuando configures una entrega, Looker te solicitará la dirección del webhook.
En la sección ¿Dónde deben ir estos datos?, elige Webhook. En la sección URL de webhook, ingresa la URL a la que Looker debe enviar una solicitud HTTPS para esta entrega. Puedes obtener esta URL del servicio web que usas para controlar tu webhook. Para configurar un webhook, ve a tu servicio web y haz lo siguiente:
- Obtener una URL a la que Looker debería enviar una solicitud HTTPS
- Especifica una aplicación de destino para la entrega de datos de Looker. Es posible que la aplicación de destino requiera una configuración adicional para recibir datos de Looker.
El procedimiento exacto difiere según qué servicio web y aplicación de destino uses para entregar el panel. Consulta esta publicación de Comunidad de Looker sobre Programa vistas y paneles con webhooks (3.46 o más) para conocer los lineamientos sobre la configuración de otra aplicación para recibir los datos de webhook desde Looker.
Looker intentará entregar a un webhook durante un máximo de 30 minutos. Asegúrate de que el destino pueda responder en un plazo de 30 minutos al intento de entrega de webhook.
Opciones de entrega para buckets de Amazon S3
Los buckets de Amazon S3 son una forma común de almacenar grandes cantidades de datos. Tú o tu empresa deberán haber creado un bucket de S3 con Amazon para que Looker pueda usarlo.
Si eliges la opción de destino de Amazon S3, Looker te solicitará parámetros de configuración adicionales sobre el formato y el bucket de Amazon S3, como se describe en esta página. Consulta esta publicación de Comunidad de Looker en Programa resultados (ilimitados) para S3 para obtener más detalles sobre la entrega de datos con un bucket de Amazon S3.
En la sección ¿Dónde deben ir estos datos?, elige Amazon S3. Aparecerá la sección Detalles de S3, en la que se te solicitará información sobre el bucket de Amazon S3:
- Bucket: Es el nombre de tu bucket de Amazon S3.
- Ruta de acceso opcional: Es la carpeta en la que deseas guardar los datos, si corresponde.
- Clave de acceso: El ID de clave de acceso de tu bucket de S3, proporcionado por Amazon.
- Clave secreta: La clave de acceso secreta a tu bucket de S3, proporcionada por Amazon.
- Región: Es la región de servicios de Amazon en la que se aloja tu bucket de S3.
Opciones de entrega para los servidores SFTP
Elige SFTP en la sección ¿Dónde deben ir estos datos? para enviar tu panel a un servidor SFTP. Enviar resultados a un servidor SFTP es una buena opción cuando tus datos o visualizaciones son demasiado grandes para enviarlos por correo electrónico. Si eliges esta opción de entrega, Looker te solicitará la dirección, el nombre de usuario y la contraseña del servidor SFTP como se describe a continuación.
Ten en cuenta lo siguiente sobre las entregas mediante SFTP:
- Para recibir entregas de SFTP de Looker, asegúrate de que el administrador de red haya agregado las direcciones IP de Looker a la lista de IP permitidas o a las reglas de tráfico entrante de tu servidor SFTP.
- Cuando publicas contenido en un servidor SFTP, solo se admiten caracteres alfanuméricos, guiones bajos (_) y guiones (-) en el nombre de archivo de la publicación. Looker quitará los caracteres que no sean
A-Z
,a-z
,0-9
,_
o-
de los caracteres que ingreses en el campo Asigna un nombre a tu agenda.
Si eliges SFTP, Looker te solicitará la URL y la información de acceso del servidor:
Dirección: Es la URL o la dirección IP del servidor SFTP al que deseas enviar tus datos. Por ejemplo:
sftp://files.looker.com/Marketing/In/
sftp://192.168.0.10/Marketing/In/
Esta URL de ejemplo termina con el carácter
/
. Esto indica que el archivo se guardará en una carpeta llamadaIn
. Si omites el/
final, el archivo se guardará en la carpetaMarketing
y en "In
". se antepondrá al nombre del archivo. Debes tener acceso de escritura a la carpeta en la que quieres crear el archivo.Nombre de usuario y Contraseña: Son las credenciales de acceso para el servidor SFTP.
Algoritmo de intercambio de claves preferido: Este campo es opcional. Para configurarlo, elige el algoritmo de intercambio de claves SSH preferido para establecer la conexión. Las opciones compatibles son las siguientes:
diffie-hellman-group-exchange-sha1
diffie-hellman-group1-sha1
diffie-hellman-group14-sha1
diffie-hellman-group-exchange-sha256
Si la conexión no se establece en cinco minutos, elige un algoritmo diferente. Algunos algoritmos tardan mucho tiempo en generar una clave SSH. Esta opción te permite usar un algoritmo que podría tardar menos tiempo. Elegir uno de los algoritmos lo convierte en el algoritmo preferido para establecer la conexión SSH. Si el servidor no admite el algoritmo, se usarán todos los demás algoritmos en los intentos posteriores. Cuando este campo se establece como Predeterminado, se usa el orden original de los algoritmos en la biblioteca de conexión.
Actualmente, la compatibilidad con SFTP solo admite credenciales de nombre de usuario y contraseña. No se admiten credenciales de clave privada SSH.
Los algoritmos clave de host que admiten las entregas de SFTP de Looker son los siguientes:
ssh-rsa
ssh-dss
ssh-rsa-cert-v01@openssh.com
ssh-rsa-cert-v00@openssh.com
Looker almacena las huellas digitales del SFTP de tu servidor SFTP. Si encuentras errores con la entrega del SFTP, es posible que las huellas digitales del SFTP no sean válidas. En este caso, comunícate con el administrador de Looker.
Si recibes el error
Java::JavaLang::NullPointerExceptions
cuando envías datos a un servidor SFTP, es posible que se deba a un error en JRuby que impide el uso de algoritmos de curva elíptica (EC) o claves de host para conexiones SSH de Looker a destinos de SFTP. Para evitar problemas con el envío de datos a destinos de SFTP, no uses algoritmos de EC en los archivos~/.ssh/config
o/etc/ssh_config
, ni almacenes claves de host de EC en~/.ssh
, en tu host de Looker.
Looker sube el archivo al directorio especificado en tu servidor SFTP con la siguiente convención para el nombre del archivo:
<name>_<timestamp>_<token>.<file extension>
- El nombre que proporcionaste en el campo Asigna un nombre a tu programación, después de que Looker quite todos los caracteres excepto
A-Z
,a-z
,0-9
,_
o-
- La marca de tiempo en la que se envió la programación, en el formato
%Y-%m-%dT%H%M
- Un token que consta de una cadena aleatoria de seis caracteres
- La extensión de archivo
Por ejemplo: Test_Schedule_2019-04-11T1130_HWkvys.csv
Opciones de entrega para integraciones de terceros
Puedes programar o enviar una vista o los resultados de una exploración a un servicio integrado en Looker, como Slack, Dropbox, Google Drive y otros. El administrador de Looker debe habilitar las integraciones. Los administradores de Looker deben otorgar permisos específicos para que los usuarios y para incorporar usuarios envíen y programen datos a integraciones de terceros.
Cuando se selecciona un servicio integrado en el campo Destino del programador, es posible que aparezcan varios campos nuevos en los que se te solicite más información.
En la siguiente lista, se muestran los servicios del Centro de acciones de Looker a los que puedes entregar una vista o los resultados de una exploración.
A continuación, te indicamos cómo utilizar la lista:
- Las URLs que se muestran en la columna Vínculo al archivo README proporcionan instrucciones para habilitar y configurar el servicio integrado para que funcione con Looker.
- Las URLs de la columna Cómo usar esta integración proporcionan instrucciones para enviar datos de Looker al servicio integrado. Algunos de estos artículos también contienen instrucciones para la habilitación.
- En Etiquetas obligatorias de LookML, se enumeran las etiquetas obligatorias que se deben usar con el parámetro
tags
en el modelo subyacente del contenido. - El tipo de acción indica qué nivel de datos envía el servicio integrado: campo, consulta o panel. Una acción a nivel de campo envía el valor de una única celda específica en una tabla de datos. Una acción a nivel de la búsqueda envía los resultados de una consulta completa, como todas las filas de una exploración o una vista. Una acción a nivel del panel envía una imagen de un panel.
- Usa la autenticación de Google OAuth indica si el servicio integrado usa credenciales de OAuth de Google para la autenticación.
- Usa la transmisión de datos indica si el servicio integrado admite resultados de consultas transmitidos.
Servicio integrado | Descripción | Vínculo al archivo README | Cómo usar esta integración | Etiquetas de LookML obligatorias | Tipo de acción | Usa la autenticación de Google OAuth (Sí/No). | Utiliza la transmisión de datos (Sí/No) |
---|---|---|---|---|---|---|---|
Airtable | Agrega registros a una tabla en Airtable. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | No |
Amazon SageMaker Infer | Realiza una inferencia con Amazon SageMaker. | No hay archivos README disponibles | No hay artículos disponibles | Ninguno | Consulta | No | Sí |
Entrenador de Amazon SageMaker: Aprendizaje lineal | Iniciar un trabajo de entrenamiento en Amazon SageMaker mediante el algoritmo de aprendizaje lineal. | No hay archivos README disponibles | No hay artículos disponibles | Ninguno | Consulta | No | Sí |
Tren de Amazon SageMaker: Xgboost | Iniciar un trabajo de entrenamiento en Amazon SageMaker mediante el algoritmo Xgboost. | No hay archivos README disponibles | No hay artículos disponibles | Ninguno | Consulta | No | Sí |
Instancia de detención de Amazon Web Services EC2 | Detén una instancia de EC2 con la API de Amazon EC2. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | aws_resource_id | Campo, consulta | No | No |
Barreno | Usa el resultado de la consulta para crear un modelo predictivo. | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | No | Sí |
Azure Storage | Enviar y almacenar un archivo de datos en Azure Storage. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | Sí |
Braze | La acción Braze te permite marcar usuarios en Braze con el extremo de la API de REST desde una vista. Asegúrate de que haya un campo braze_id etiquetado en los resultados. EXPORTACIÓN MÁXIMA: 10,000. |
Ver el archivo README en GitHub | Ver README | braze_id | Consulta | No | Sí |
DataRobot | Envía datos a DataRobot y crea un proyecto nuevo. | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | No | Sí |
DigitalOcean: Stop Droplet | Detén el proceso de DigitalOcean con la API de DigitalOcean. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | digitalocean_droplet_id | Campo, consulta | No | No |
Espacios DigitalOcean | Envía y almacena un archivo de datos en el almacenamiento de DigitalOcean. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | Sí |
Dropbox | Enviar y almacenar un archivo de datos en Dropbox | No hay archivos README disponibles | Ver la documentación | Ninguno | Consulta | Sí | No |
Públicos personalizados de Facebook | Subir datos a los públicos personalizados de los anuncios de Facebook desde la lista de clientes | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | Sí | Sí |
Firebase | Usa Firebase para enviar notificaciones push a dispositivos móviles. | No hay archivos README disponibles | No hay artículos disponibles | Ninguno | Consulta | No | No |
Segmentación por clientes de Google Ads | Subir datos a la Segmentación por clientes de Google Ads | Ver el archivo README en GitHub | Ver la documentación | Ninguno | Consulta | Sí | Sí |
Importación de datos de Google Analytics | Subir datos a un conjunto de datos de Google Analytics | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | Sí | Sí |
Google Cloud Storage | Escribir archivos de datos en un bucket de Google Cloud Storage | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | Sí |
Google Drive | Enviar datos a Google Drive | No hay archivos README disponibles | Ver la documentación | Ninguno | Consulta | Sí | Sí |
Hojas de cálculo de Google | Envía datos CSV a una hoja de cálculo de Google. | No hay archivos README disponibles | Ver la documentación | Ninguno | Consulta | Sí | Sí |
Empresas de Hubspot | Agrega propiedades a tus empresas con la API de Hubspot V3. | Ver el archivo README en GitHub | Ver README | hubspot_company_id | Consulta | No | Sí |
Contactos de HubSpot | Agrega propiedades a tus contactos con la API de Hubspot V3. | Ver el archivo README en GitHub | Ver README | hubspot_contact_id | Consulta | No | Sí |
Kloudio | Agregar datos a una hoja de cálculo de Google | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | No | No |
mParticle | Exporta de forma masiva tus datos de usuarios o eventos de Looker a mParticle. | Ver el archivo README en GitHub | Ver README | Ver README | Consulta | No | Sí |
Campañas de Salesforce | Agrega contactos o clientes potenciales a una campaña de Salesforce. | Ver el archivo README en GitHub | Ver README | sfdc_contact_id o sfdc_lead_id | Consulta | Sí | No |
Grupo de segmentos | Agrega características o usuarios a tus grupos de segmentos. | Ver el archivo README en GitHub | Ver la documentación | segment_group_id y user_id, o segment_group_id y segment_anonymous_id | Consulta | No | Sí |
Identificación del segmento | Agrega rasgos a los usuarios de Segment con Identificar. | Ver el archivo README en GitHub | Ver la documentación | correo electrónico, user_id, segment_anonymous_id o segment_group_id | Consulta | No | Sí |
Tramo de segmento | Conéctate a una serie de integraciones proporcionadas por Segment para identificar usuarios y segmentarlos para los flujos de trabajo de marketing. | Ver el archivo README en GitHub | Ver la documentación | correo electrónico, user_id, segment_anonymous_id o segment_group_id | Consulta | No | Sí |
SendGrid | Envía datos y programa los resultados para enviarlos a una dirección de correo electrónico con la API de SendGrid. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | No |
Slack | Envía contenido de Looker en mensajes directos, canales públicos y canales privados en Slack con OAuth. Está disponible para las implementaciones alojadas en Looker en la versión 6.24 y versiones posteriores con la función Lista de IP permitidas inhabilitada. | No hay archivos README disponibles | Ver la documentación | Ninguno | Consulta | Sí | Sí |
Adjunto de Slack (token de API) | Envía datos directamente a un canal de Slack junto con las credenciales del usuario. También puedes consultar la documentación de Looker para obtener funciones adicionales de Slack. | Ver el archivo README en GitHub | Ver la documentación | Ninguno | Consulta | No | No |
Equipos: Webhook entrante | Enviar datos a los equipos de Microsoft mediante un webhook entrante | Ver el archivo README en GitHub | Ver README | Ninguno | Consulta | No | No |
Para bandejas | Conéctate a una serie de integraciones proporcionadas por Tray.io para automatizar los flujos de trabajo. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | Sí |
Twilio: Enviar datos | Envía datos de una vista o programa los resultados para enviarlos a un número de teléfono con la API de Twilio. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | No |
Twilio: Enviar mensaje | Envía un mensaje a una serie de números de teléfono (columnas de datos etiquetados como números de teléfono) en una vista. | Ver el archivo README en GitHub | Ver README | teléfono | Campo, consulta | No | No |
Zapier | Conéctate a una serie de integraciones proporcionadas por Zapier para automatizar los flujos de trabajo. | Ver el archivo README en GitHub | Ver artículo de la Comunidad | Ninguno | Consulta | No | Sí |
Elegir el formato de datos
En las entregas por correo electrónico, la opción de seleccionar un formato de datos no está disponible si el administrador de Looker estableció la política de datos enviados por correo electrónico de tu instancia de Looker como Enviar solo vínculo.
Las Vistas y Exploraciones presentan diferentes opciones de formato en función del destino de la entrega. Para elegir el formato de tu publicación, selecciona el ícono adecuado en la sección Formatear datos como del programador.
Consulta la siguiente tabla para ver una explicación de cómo se publica cada formato en cada destino.
Formato | Correo electrónico | Webhook | Amazon S3 | SFTP |
---|---|---|---|---|
Tabla de datos | La tabla de datos en el cuerpo del correo electrónico en formato HTML | No disponible para este destino | No disponible para este destino | No disponible para este destino |
Visualización | La visualización en el cuerpo del correo electrónico como una imagen PNG | No disponible para este destino | No disponible para este destino | No disponible para este destino |
CSV | La tabla de datos como archivo adjunto de un archivo de texto separado por comas | La tabla de datos como archivo adjunto de un archivo de texto separado por comas | La tabla de datos como archivo adjunto de un archivo de texto separado por comas | La tabla de datos como archivo adjunto de un archivo de texto separado por comas |
XLSX | La tabla de datos como un archivo adjunto de Excel | La tabla de datos como un archivo adjunto de Excel | La tabla de datos como un archivo adjunto de Excel | La tabla de datos como un archivo adjunto de Excel |
JSON: simple | La tabla de datos como un archivo adjunto JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | La tabla de datos como un archivo adjunto JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | La tabla de datos como un archivo adjunto JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | La tabla de datos como un archivo adjunto JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. |
JSON: etiqueta | No disponible para este destino | La tabla de datos en formato JSON. En este formato, Looker usa etiquetas de campo como su valor renderizado en el resultado de JSON. | No disponible para este destino | No disponible para este destino |
JSON: intercalado y simple | No disponible para este destino | La tabla de datos enviada directamente en formato JSON. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | No disponible para este destino | No disponible para este destino |
JSON: intercalado y detallado | No disponible para este destino | La tabla de datos se envió directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, el tiempo en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | La tabla de datos se envió directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, el tiempo en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. | La tabla de datos se envió directamente en formato JSON, con detalles adicionales, como metadatos de campo, información de caché, el tiempo en que se completó la consulta y cuánto tiempo tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo. |
Texto | La tabla de datos como archivo adjunto de texto delimitado por tabulaciones | La tabla de datos como archivo adjunto de texto delimitado por tabulaciones | La tabla de datos como archivo adjunto de texto delimitado por tabulaciones | La tabla de datos como archivo adjunto de texto delimitado por tabulaciones |
HTML | La tabla de datos como un archivo adjunto HTML | La tabla de datos como un archivo adjunto HTML | La tabla de datos como un archivo adjunto HTML | La tabla de datos como un archivo adjunto HTML |
Activando la entrega
No verás esta opción si envías una exploración o una entrega única de una vista.
Cuando programas entregas recurrentes, tienes dos opciones para activarlas:
- Intervalo de repetición: Selecciona esta opción para usar el programa de entrega que estableciste en la sección Especificar la recurrencia de la entrega de esta página.
- Actualización de grupos de datos: Si el desarrollador de LookML configuró grupos de datos, puedes programar la publicación para que se produzca después de que se active un grupo de datos, administre la caché y vuelva a compilar PDT relevantes.
Especifica el activador de grupo de datos
No verás esta opción si envías una exploración, la publicación única de una vista o si especificaste un activador de intervalo recurrente para tu publicación recurrente.
Para usar un activador de grupo de datos, selecciona Actualización de grupo de datos en la sección Activador del programador. Luego, elige el grupo de datos de origen en el menú desplegable Seleccionar grupo de datos.
Para programar contenido con un activador de grupo de datos, el archivo de modelo en el que se basa el contenido debe incluir un grupo de datos. Looker enumera todos los grupos de datos definidos en los modelos que se incluyen en la vista o el mosaico del panel determinados, incluso si los grupos de datos no se usan para controlar el almacenamiento en caché de consultas o PDT.
Los programas basados en grupos de datos solo se activan para publicarse una vez que se completa el proceso de regeneración de todas las PDT que se mantienen en ese grupo de datos, lo que garantiza que la publicación incluya los datos más actualizados.
Cómo especificar la recurrencia de la entrega
No verás esta opción si envías una exploración, la publicación única de una vista o si especificaste un activador de actualización de grupos de datos para la publicación recurrente.
Para las entregas que utilizan un intervalo recurrente, puedes personalizar los horarios de la programación en la sección Entregar esta programación. Selecciona Intervalo de repetición en la sección Activador del programador. Las opciones de tiempo cambian en función de si eliges Por día, Semanal, Mensual, Por hora o Por minuto. Puedes ajustar la zona horaria del programa en la sección Opciones avanzadas.
La hora de finalización de los intervalos Por hora y Por minuto no es inclusiva. La última entrega se enviará en el último intervalo seleccionado antes de la hora de finalización especificada. Por ejemplo, si el contenido está programado por hora entre las 12:00 a.m. y las 11:00 p.m., se enviará a cada hora, de 12:00 a.m. a 10:00 p.m. Si el contenido se programa Por minuto cada 30 minutos entre las 12:00 a.m. y las 11:00 p.m., la última entrega en ese período se enviará a las 10:30 p.m.
Cómo aplicar filtros a la publicación
No verás esta opción si envías una exploración.
Si publicas una vista o un panel que tiene filtros, puedes modificar las condiciones del filtro para filtrar aún más los resultados publicados.
Haz clic en Filtros para ver y modificar los filtros asociados con esta vista o panel para tu publicación. Cambiar estas opciones de filtro en el Programador no cambia los filtros de tu vista o panel. Si un filtro para panel requiere un valor de filtro y el filtro de programación está en blanco, la programación no mostrará resultados en el momento de la publicación.
Si cambias los nombres de los campos que funcionan como filtros en tus Vistas o paneles, asegúrate de revisar la sección Filtros de tus Vistas y paneles programados y de actualizar los filtros según sea necesario para reflejar los cambios. Si una publicación de contenido programada incluye filtros que ya no funcionan (por ejemplo, si cambió el campo al que se hace referencia), la publicación programada podría exponer datos sin filtros.
Para personalizar aún más las entregas, puedes usar la opción de filtro coincide con un atributo de usuario (si los administradores de Looker configuraron valores específicos del usuario llamados atributos del usuario). Cuando configuras un filtro en uno de estos atributos, se personalizan automáticamente los resultados para cada usuario, lo que significa que puedes enviar resultados personalizados a muchos usuarios, incluso si envías una entrega única. Puedes obtener más información al respecto en la página de documentación Atributos de usuario.
Cómo aplicar opciones de publicación avanzadas
La sección Opciones avanzadas ofrece una personalización adicional para su publicación. Haz clic en la flecha junto a Opciones avanzadas para expandir este menú. Las opciones disponibles dependen del destino y el formato seleccionados para la publicación y si publicas un panel, una vista o una exploración. Los vínculos de la siguiente tabla dirigen a la descripción de cada opción que está disponible para las entregas de vistas o exploraciones a los destinos integrados de Looker. Es posible que las publicaciones a integraciones de terceros tengan disponibles opciones avanzadas exclusivas.
Enviar este programa si
En el caso de las publicaciones recurrentes de vistas, puedes personalizar el programa para que se publique el contenido de las vistas solo cuando se cumplan ciertas condiciones. Las alertas proporcionan una función similar para los mosaicos del panel.
En el menú desplegable Enviar esta programación si (Send this schedule if), especifica si deseas publicar el contenido de la vista solo si hay resultados, solo si no hay resultados, o si hay alguno o ninguno. Por ejemplo, puedes usar los filtros para crear condiciones para situaciones que desees supervisar, como artículos que están por debajo de una determinada cantidad de inventario, gastos que superan un valor determinado, etc. Luego, publicar el contenido solo si se cumple esa condición.
También puedes especificar que se genere una entrega solo si los resultados de la consulta cambiaron desde que se envió la última entrega de datos. Para ello, marca la casilla junto a y los resultados cambiaron desde la última ejecución. Esta opción no se encuentra disponible si quieres usar la opción de límite Todos los resultados.
Límite
Si quieres limitar el tamaño de la publicación, selecciona una de las siguientes opciones para los datos:
- Resultados en la tabla: Los datos se envían como una sola entrega.
- Todos los resultados: Se transmiten los datos (obtén más información en la sección ¿Cuáles son los límites de filas en Looker? en la página Prácticas recomendadas). Esto es útil para conjuntos de datos grandes, ya que omite las limitaciones de tamaño de archivo, navegador y memoria.
Si eliges Resultados en la tabla, Looker obedecerá las limitaciones de filas que hayas configurado en la vista guardada o la exploración. Si eliges Todos los resultados, Looker mostrará todas las filas de la consulta, independientemente de la configuración de la Vista guardada y del límite típico de 5,000 filas de Looker. Esto puede ser conveniente para recuperar conjuntos de datos muy grandes, pero debes tener cuidado para asegurarte de que la consulta no sea demasiado grande para tu base de datos.
Limita las opciones para el correo electrónico
Cuando envías vistas y exploraciones, puedes limitar el tamaño de tu correo electrónico para que se mantenga dentro de las limitaciones de tamaño de los mensajes de tu servidor de correo electrónico. Selecciona una de las siguientes opciones de límite para tus datos:
- Resultados en la tabla: Los datos se envían con un límite de 5,000 filas. Esta es la única opción disponible para los correos electrónicos que usan las opciones de formato Tabla de datos o Visualización. Los correos electrónicos con más de 5,000 filas no se enviarán.
- Todos los resultados: Si usas las opciones de formato Texto, CSV, JSON: Simple, XLSX o HTML, puedes enviar todas las filas de los resultados de una vista guardada. Esta opción ignora los límites establecidos en una vista guardada o el límite típico de 5,000 filas de Looker. Sin embargo, existe un límite de datos total de 15 MB para que las aplicaciones de correo electrónico acepten el archivo adjunto. No se enviarán los correos electrónicos que superen los 15 MB y que incluyan un archivo adjunto. Si especificas un formato de tabla de datos o visualización y, luego, seleccionas Todos los resultados, Looker cambiará automáticamente el formato para usar un archivo adjunto de texto que admita el envío de todos los resultados.
Para verificar si estás dentro del límite de filas o datos de los correos electrónicos programados, ingresa tu dirección de correo electrónico como destinatario y haz clic en Enviar prueba para enviarte los datos de inmediato. Si no recibes el correo electrónico, es probable que hayas alcanzado el límite de filas o de datos para los correos electrónicos.
Opciones de correo electrónico
Las entregas por correo electrónico tienen opciones de entrega adicionales, que son Incluir vínculos y Programar como destinatario.
Ejecutar programación como destinatario
Esta opción solo está disponible para el destino de correo electrónico.
La opción Ejecutar programación como destinatario permite que los administradores especifiquen una lista de usuarios que recibirán la entrega de contenido como si ejecutaran la consulta, en función de sus permisos. Los usuarios que no son administradores también pueden ingresar su propia dirección de correo electrónico para recibir una entrega como si hubieran consultado el contenido en función de sus permisos. Esto significa que los filtros de acceso y los atributos de usuario de cada usuario se aplicarán a los datos incluidos en cada correo electrónico.
Por ejemplo, un administrador de Looker debe programar un informe que cuente los usuarios agrupados por Estado en una serie de usuarios, y cada usuario tiene diferentes valores del filtro de acceso.
El usuario A tiene un filtro de acceso configurado como users.state = 'California'
. Cuando se selecciona Ejecutar programación como destinatario, la consulta programada aplicará el filtro de acceso users.state = 'California'
y enviará los resultados filtrados al usuario A. Los resultados mostrarán solo una fila para California.
Esta opción tiene en cuenta los permisos del usuario que crea la programación, así como los tipos de direcciones de correo electrónico que se agregaron al campo de texto ¿A quién se debe enviar el correo electrónico?.
En algunos casos, la opción Ejecutar programación como destinatario no está disponible:
- Cuando un usuario que no es administrador agrega una dirección de correo electrónico que no es la suya
- Cuando un administrador de Looker agrega el correo electrónico de un usuario inhabilitado
- Cuando un administrador de Looker agrega un correo electrónico que no pertenece a un usuario de Looker (una cuenta de Looker se indica con un ícono de Looker junto al destinatario)
- Si el correo electrónico se agregó antes de seleccionar la opción Ejecutar programación como destinatario, esta se inhabilitará automáticamente. Estará disponible nuevamente si esa dirección de correo electrónico se borra de la lista de destinatarios.
- Si la dirección de correo electrónico se agregó después de seleccionar la opción Ejecutar programación como destinatario, agregar la dirección de correo electrónico producirá un error y el correo electrónico se quitará automáticamente del campo ¿A quién se debe enviar el correo electrónico?. La opción Ejecutar programación como destinatario permanecerá habilitada.
En el caso especial en el que un usuario aparece como destinatario en una programación que tiene habilitada la opción Ejecutar programación como destinatario y, luego, la cuenta de ese usuario está inhabilitada, la programación no se entregará al usuario inhabilitado la próxima vez que se ejecute. Si se borra la cuenta de ese usuario, no se enviará toda la programación a ningún destinatario. Un administrador o usuario de Looker con el permiso see_schedules
podrá diagnosticar esta falla en la página Historial del programador del panel Administrador.
Incluir vínculos
Si el administrador de Looker estableció la política de datos enviados por correo electrónico de tu instancia de Looker como Enviar vínculos y datos, el programador mostrará la opción Incluir vínculos. Cuando esta opción está marcada, las entregas de datos por correo electrónico incluyen un vínculo a Looker que dice “Ver informe completo” por las Vistas y Exploraciones publicadas y la opción "Ver el panel completo" para los paneles entregados.
Con este vínculo, los destinatarios del correo electrónico pueden explorar con más detalle los datos de tu instancia de Looker. Los destinatarios deben acceder a Looker y tener permisos para acceder al modelo en el que se basa el contenido entregado para verlo en Looker. Si quieres quitar este vínculo de los correos electrónicos de entrega de datos, desmarca la casilla de verificación Incluir vínculos.
Opciones de formato
Los envíos que no usan el formato de visualización tienen opciones de entrega adicionales, que son Aplicar opciones de visualización y Valores de datos con formato.
Aplicar opciones de visualización
Esta opción no está disponible para las publicaciones de Vista o Explorar en formato de visualización.
Selecciona Aplicar opciones de visualización para que la entrega de datos tenga un aspecto similar a un gráfico de tabla. Se aplicará cualquiera de los siguientes parámetros de configuración de los menús Trama, Serie y Formato que se hayan definido para la visualización:
- Mostrar números de fila
- Ocultar totales
- Ocultar totales de filas
- Limitar las filas que se muestran a un máximo de 500 filas visibles u ocultas
- Mostrar el nombre completo del campo
- Etiquetas personalizadas para cada columna (el formato JSON: Detalle, intercalado siempre usa nombres de campo sin procesar, no la etiqueta de campo. Consulta la publicación de Comunidad Cambio en el formato JSON para obtener más información sobre cómo Looker renderiza los campos en formato JSON)
- Formato condicional para las entregas de visualizaciones de gráficos de tabla en formato Excel
El formato condicional se muestra en las entregas de Vistas y Exploraciones de Excel con visualizaciones de gráfico de tabla solo si se aplica la regla A la escala.
Anula la selección de Aplicar opciones de visualización para que Looker envíe los datos como aparecen en la sección Datos de la vista o en la ventana Explorar desde aquí de un mosaico del panel. JSON: Etiqueta usa el campo label, incluso si no está seleccionada la opción Aplicar opciones de visualización.
Valores de datos con formato
Esta opción no está disponible para las publicaciones de Vista o Explorar en formato de visualización.
Puedes configurar el formato de los datos:
- Selecciona Valores de datos con formato si quieres que los datos se vean más similares a la experiencia Explorar en Looker, aunque algunas funciones (como la vinculación) no son compatibles con todos los tipos de archivos.
- Anula la selección de Valores de datos con formato si no quieres aplicar ningún formato especial a los resultados de la consulta, como redondear números largos o agregar caracteres especiales que los desarrolladores de Looker podrían haber establecido. Por lo general, esto es lo que se prefiere cuando los datos se ingresan a otra herramienta para su procesamiento.
Resolución de la tabla
Cuando envías contenido al correo electrónico en formato Visualización, puedes personalizar el ancho de la visualización con el menú desplegable Resolución de la tabla. Sus opciones de ancho son:
- Normal: 800 píxeles
- Gran angular: 1680 píxeles
Si eliges Ancho y el ancho de la visualización supera el límite establecido por tu cliente de correo electrónico, es posible que los destinatarios de la entrega de correo electrónico deban desplazarse horizontalmente para ver toda la visualización.
Zona horaria
De forma predeterminada, Looker usa la zona horaria asociada a tu cuenta para determinar cuándo enviar la entrega de datos. Si no tienes una zona horaria asociada a tu cuenta, Looker usa la zona horaria de la aplicación. Si deseas especificar una zona horaria diferente, selecciona Usar zona horaria personalizada. La zona horaria que selecciones no afecta los datos de tu vista o panel, solo el momento de la publicación.
Prueba la publicación
Haz clic en el botón Enviar prueba para enviar una entrega de prueba por única vez al destino especificado.
Guardando la entrega
En la parte inferior del programador, se muestra un resumen de la configuración de la publicación.
En envíos únicos, cuando termines de configurar las opciones de entrega, haz clic en el botón Enviar para enviar el contenido de inmediato al destino especificado.
En el caso de las entregas recurrentes, cuando termines de configurar las opciones de entrega, haz clic en el botón Guardar todo para guardar la programación y cerrar la ventana. El contenido se publicará según tu configuración de publicación. Si vuelves a abrir el programador, tu programación guardada aparecerá en el panel izquierdo. Puedes duplicar o borrar la programación haciendo clic en los íconos Duplicar o Borrar, respectivamente.
La programación guardada también aparecerá en la página Programas que creaste en tu perfil de usuario y en las páginas Programas e Historial de programas del panel Administrador. Para obtener más información, consulta la sección Cómo ver las publicaciones de esta página.
Cómo ver las entregas
Puedes ver los programas que creaste y, con los permisos correspondientes, todos los programas para la instancia de Looker.
Cómo ver las publicaciones que creaste
En la página Programas que creaste, puedes ver una lista de todos los programas que creaste. Para acceder a ellos, haz clic en el ícono de tu perfil de usuario y selecciona Programas. Consulta la página Visualiza tus publicaciones de datos programadas para obtener más información sobre cómo ver y administrar las programaciones que creaste.
Cómo ver las publicaciones que crearon otros usuarios
Si tu administrador de Looker te otorgó permisos para ver las páginas de administración Programas e Historial de programas, puedes ver la lista de todas las programaciones de toda la instancia de Looker. Sin embargo, no podrás editar ni borrar esas programaciones.
Qué debes saber
En ocasiones, es posible que uno o más de sus destinatarios no reciban la entrega programada por correo electrónico. Esto puede ocurrir si el modelo subyacente tiene un error, si el destinatario no tiene acceso a los datos o si hay problemas de renderización o errores de página.
Pueden surgir otros desafíos:
- Si tu empresa estableció su propia configuración de correo electrónico en la sección Administrador de Looker, los administradores de Looker deberán asegurarse de que la configuración sea correcta y de que tu proveedor de correo electrónico esté funcionando correctamente.
- Según el parámetro de configuración Límite, la entrega de datos se limitará a 5,000 filas o a un tamaño máximo de archivo de 15 MB para los correos electrónicos con archivos adjuntos y de 20 MB para los correos electrónicos con contenido intercalado. No se enviarán los correos electrónicos que tengan más filas o datos que estos límites.
- Si un correo electrónico no se envía a la hora esperada, pero finalmente llega, es probable que compitas con otras tareas de Looker. Estas tareas pueden incluir otros correos electrónicos programados, muchas personas que exploran datos al mismo tiempo o la creación de tablas derivadas persistentes. Si esto sucede, consulta con los administradores de Looker sobre las tareas en competencia.
- Si un correo electrónico específico sigue desapareciendo de tu lista de distribución, es probable que se deba a que un usuario está anulando la suscripción a ese correo electrónico programado. Esto puede ser un desafío particular si usas un alias de correo electrónico de grupo para enviar mensajes a varias personas, ya que cualquier destinatario individual puede anular la suscripción a todo ese alias de correo electrónico. Si necesitas comprender las anulaciones de suscripciones, consulta esta publicación de Comunidad de Looker sobre cómo supervisar los eventos de anulación de suscripciones de los programadores.