Entrega de vistas y exploraciones

En esta página, se proporciona una descripción general de cómo entregar vistas y exploraciones a los destinos de entrega nativos de Looker y a cualquier servicio integrado que esté disponible para tu instancia de Looker. Si desea obtener información para programar paneles, visite la página de documentación Programación y envío de paneles.

Looker Scheduler es el nombre de la ventana emergente en la que configuras los parámetros de entrega de contenido. En el caso de las vistas, puedes usar el programador para enviar entregas únicas o recurrentes. Las exploraciones se pueden enviar solo como entregas únicas. Si quieres programar la publicación recurrente de contenido de Explorar, primero debes guardarlo como 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 otorgue el administrador de Looker.

Abre el programador desde una carpeta

En Explorar, puedes abrir el programador solo desde Explorar, no desde una carpeta.

Para abrir el programador desde una carpeta o subcarpeta, busca la carpeta que contiene el panel que quieres publicar. Cuando navegues a una carpeta, las vistas y los paneles de la carpeta aparecerán en la vista de lista o en la vista de cuadrícula.

El ícono de calendario indica que programaste al menos una publicación recurrente para ese contenido (en la vista de cuadrícula, debes colocar el cursor sobre la miniatura del contenido para ver ese í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)
  • Haz clic en el menú de tres puntos de un elemento y elige Editar programación (si ya existe 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).
  • Abrir el contenido, hacer clic en el menú de ajustes en la esquina superior derecha y elegir Programar (para las entregas recurrentes) o Enviar (para las 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)
  • Abrir el contenido, hacer clic en el menú de ajustes en la esquina superior derecha y elegir Programar (para las entregas recurrentes) o Enviar (para las entregas únicas)

Crea 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 elige Programar (para las entregas recurrentes) o Enviar (para las entregas únicas).

Looker muestra el programador heredado.

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 de la programación que estás creando o editando. El panel izquierdo enumera las programaciones en orden cronológico inverso desde la última actualización. Puedes duplicar o borrar programaciones existentes haciendo clic en los íconos 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 muestra las opciones de programación establecidas en sus valores predeterminados. Puedes modificar esos valores como desees. Si ya creaste una o más programaciones para este contenido, el panel principal muestra la configuración de programación guardada para el programa en la parte superior de la lista. Luego, haz lo siguiente:

  • Para editar las opciones de un programa existente, selecciónalo y cambia las opciones como desees. Cuando hayas terminado, haz clic en Guardar todo.
  • Si quieres crear programaciones adicionales para el mismo contenido, haz clic en New + 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.

Cómo asignar un nombre a la entrega

Asígnale un título único a la programación en el campo Assign your schedule a name. El título aparecerá en el panel izquierdo después de guardar la programación, en la lista de programas que creaste y en las páginas de administración de programas en el panel Administrador.

Según el destino de la entrega, el título puede aparecer en otros lugares:

  • Para las entregas de correo electrónico, el título se utiliza para el asunto del correo 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 Título.
  • En el caso de las entregas a un bucket de Amazon S3, el título se usa en el nombre del archivo de la entrega y en cualquier correo electrónico de error que se envíe. El nombre de archivo de la publicación tiene el formato TITLE_TIMESTAMP_HASH, en el que HASH es un identificador aleatorio de seis caracteres y TIMESTAMP sigue el patrón YYYY-MM-DDTHHMM (por ejemplo, la parte de la marca de tiempo se vería como 2019-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 del archivo de la entrega.
  • En el caso de las entregas mediante SFTP, el título se incluye en el nombre de archivo de la entrega. El nombre de archivo de la publicación tiene el formato TITLE_TIMESTAMP_TOKEN, en el que TOKEN es un identificador aleatorio de seis caracteres y TIMESTAMP sigue el patrón YYYY-MM-DDTHHMM (por ejemplo, la parte de la marca de tiempo se vería como 2019-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 el caso de las publicaciones 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 lo que ingreses en el campo Asigna un nombre a tu programación.

Elige el destino de entrega

Según cómo el administrador de Looker haya configurado tus permisos, es posible que no todos los destinos estén 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:

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 de 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 o varias direcciones de correo electrónico 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 con ninguna cuenta de usuario en tu instancia de Looker. Estos se clasifican como correos electrónicos externos. Para entregar contenido a usuarios externos, el administrador de Looker debe haberte otorgado permisos para entregar contenido a usuarios externos o haber agregado los dominios de correo electrónico de esos destinatarios al Permitido del dominio de correo electrónico 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 de correos electrónicos, esa programación se borra de Looker, incluso de las páginas de administración de la programación de los usuarios y los administradores. Si un destinatario anula la suscripción en nombre de un grupo de correo electrónico, ningún miembro del grupo recibirá entregas 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 por 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 los mensajes personalizados a 1,500.

Los envíos por correo electrónico no pueden superar los 20 MB (para los formatos que se entregan en el cuerpo del correo electrónico) y los 15 MB (para los formatos que se entregan como archivos adjuntos).

Opciones de publicación 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 variedad de aplicaciones. Por ejemplo, puedes programar la publicación periódica de una vista o un panel en un webhook. Cuando configures una publicación, Looker te pedirá 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 en la que Looker debe enviar una solicitud HTTPS para esta entrega. Puede obtener esta URL desde el servicio web que está usando para administrar su webhook. Para configurar un webhook, ve a tu servicio web y haz lo siguiente:

  1. Obtener una URL en la que Looker debe enviar una solicitud HTTPS
  2. 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 varía según el servicio web y la aplicación de destino que uses para proporcionar el panel. Consulta esta publicación de Comunidad de Looker sobre Cómo programar vistas y paneles con webhooks (3.46 o versiones posteriores) para conocer los lineamientos sobre cómo configurar otra aplicación que reciba los datos de webhooks de Looker.

Looker intentará publicar en un webhook durante un máximo de 30 minutos. Asegúrate de que el destino pueda responder al intento de entrega del webhook en 30 minutos.

Opciones de entrega para los 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 sobre Programa resultados (ilimitados) en 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 y 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 la clave de acceso al bucket de S3, proporcionado por Amazon.
  • Clave secreta: la clave de acceso secreta al bucket de S3, proporcionada por Amazon.
  • Región: Es la región de los servicios de Amazon en la que se aloja tu bucket de S3.

Opciones de entrega para servidores SFTP

Elige SFTP en la sección ¿Dónde deben ir estos datos? para enviar tu panel a un servidor SFTP. Enviar los resultados a un servidor SFTP es un buen método para usar cuando tus datos o visualización son demasiado grandes para enviarlos por correo electrónico. Si eliges esta opción de entrega, Looker te solicitará la dirección del servidor SFTP, el nombre de usuario y la contraseña como se describe a continuación.

Ten en cuenta lo siguiente sobre las publicaciones mediante SFTP:

  • Para recibir entregas SFTP de Looker, asegúrate de que el administrador de red haya agregado las direcciones IP de Looker a la lista de entidades permitidas de IP de tu servidor SFTP o a las reglas de tráfico entrante.
  • Cuando publicas contenido a 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 lo que ingreses en el campo Asigna un nombre a tu programación.

Cuando eliges SFTP, Looker te solicita la URL y la información de acceso del servidor:

  • Dirección: 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 llamada In. Si omites el elemento / final, el archivo se guardará en la carpeta Marketing y se antepone "In" al nombre del archivo. Debes tener acceso de escritura a la carpeta en la que deseas crear el archivo.

  • Nombre de usuario y Contraseña: 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 otro algoritmo. Algunos algoritmos tardan mucho tiempo en generar una clave SSH. Esta opción te permite usar un algoritmo que podría llevar menos tiempo. La elección de 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 en intentos posteriores. Cuando este campo se establece como Default, se usa el orden original de los algoritmos en la biblioteca de conexión.

Actualmente, la compatibilidad con SFTP se limita a credenciales de nombre de usuario y contraseña. No se admiten credenciales de clave privada SSH.

Los algoritmos de 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 de SFTP de tu servidor SFTP. Si encuentras errores en la publicación mediante SFTP, podrían indicar que las huellas digitales del SFTP no son válidas. En este caso, comunícate con el administrador de Looker.

Si recibes el error Java::JavaLang::NullPointerExceptions cuando entregas datos a un servidor SFTP, puede deberse 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 SFTP. Para evitar problemas con el envío de datos a destinos SFTP, no uses algoritmos de conversiones avanzadas en los archivos ~/.ssh/config o /etc/ssh_config, ni almacenes claves de host de conversiones avanzadas en ~/.ssh, en tu host de Looker.

Looker sube el archivo al directorio especificado en tu servidor SFTP según 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 programa (Assign your schedule a name), después de que Looker quite todos los caracteres que no sean A-Z, a-z, 0-9, _ o -
  • Es la marca de tiempo en la que se envió el programa, 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 publicación 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. Las integraciones deben estar habilitadas por el administrador de Looker. Los administradores de Looker deben otorgar permisos específicos para que los usuarios y los usuarios incorporados 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 de Looker Action Hub a los que puedes enviar una vista o los resultados de una exploración.

Aquí te explicamos cómo usar la lista:

  • Las URLs que se muestran en la columna Vínculo al archivo README proporcionan instrucciones para habilitar y configurar el servicio integrado de modo que funcione con Looker.
  • Las URLs que se muestran en 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 de LookML obligatorias, 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 el nivel de datos que envía el servicio integrado: campo, consulta o panel. Una acción a nivel de campo envía el valor de una única celda especificada en una tabla de datos. Una acción a nivel de la consulta envía los resultados de una consulta completa, como todas las filas de una exploración o una vista. Una acción a nivel de panel envía una imagen de un panel.
  • Usa la autenticación de Google OAuth indica si el servicio integrado utiliza credenciales de Google OAuth para la autenticación.
  • Utiliza la transmisión de datos, que indica si el servicio integrado admite resultados de consultas transmitidos.
Servicio integrado Descripción Vínculo al archivo LÉEME Cómo usar esta integración Etiquetas de LookML obligatorias Tipo de acción Usa la autenticación de Google OAuth (Sí/No) Utiliza transmisión de datos (Sí/No)
Mesa de aire Agregar registros a una tabla en Airtable Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No No
Amazon SageMaker Infer Realizar una inferencia con Amazon SageMaker No hay archivos README disponibles No hay artículos disponibles Ninguna Consulta No
Amazon SageMaker Train: aprendizaje lineal Comenzar un trabajo de entrenamiento en Amazon SageMaker con el algoritmo de aprendizaje lineal No hay archivos README disponibles No hay artículos disponibles Ninguna Consulta No
Amazon SageMaker Train: Xgboost Comenzar un trabajo de entrenamiento en Amazon SageMaker con el algoritmo Xgboost No hay archivos README disponibles No hay artículos disponibles Ninguna Consulta No
Instancia de detención de EC2 de Amazon Web Services Detén una instancia de EC2 con la API de Amazon EC2. Ver readme en GitHub Ver artículo de la comunidad aws_resource_id Campo, consulta No No
Barreno Usa los resultados de la consulta para crear un modelo predictivo. Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta No
Azure Storage Enviar y almacenar un archivo de datos en Azure Storage Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No
Soltar La acción Braze permite marcar usuarios en Braze mediante 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ÁX.: 10,000. Ver readme en GitHub Consulta el archivo LÉEME braze_id Consulta No
DataRobot Envía datos a DataRobot y crea un proyecto nuevo. Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta No
DigitalOcean: Stop Droplet Detén el proceso de DigitalOcean con la API de DigitalOcean. Ver readme en GitHub Ver artículo de la comunidad digitalocean_droplet_id Campo, consulta No No
Espacios de DigitalOcean Envía y almacena un archivo de datos en DigitalOcean Storage. Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No
Dropbox Enviar y almacenar un archivo de datos en Dropbox No hay archivos README disponibles Ver la documentación Ninguna Consulta No
Públicos personalizados de Facebook Subir datos a los públicos personalizados de anuncios de Facebook desde la lista de clientes Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta
Firebase Usa Firebase para enviar notificaciones push a dispositivos móviles. No hay archivos README disponibles No hay artículos disponibles Ninguna Consulta No No
Segmentación por clientes de Google Ads Sube los datos a la Segmentación por clientes de Google Ads. Ver readme en GitHub Ver la documentación Ninguna Consulta
Importación de datos de Google Analytics Subir los datos a un conjunto de datos de Google Analytics Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta
Google Cloud Storage Escribir archivos de datos en un bucket de Google Cloud Storage Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No
Google Drive Enviar datos a Google Drive No hay archivos README disponibles Ver la documentación Ninguna Consulta
Hojas de cálculo de Google Enviar datos CSV a una hoja de cálculo de Google No hay archivos README disponibles Ver la documentación Ninguna Consulta
HubSpot Company Agrega propiedades a tus empresas con la API de HubSpot V3. Ver readme en GitHub Consulta el archivo LÉEME hubspot_company_id Consulta No
Contactos de HubSpot Agrega propiedades a tus contactos con la API de HubSpot V3. Ver readme en GitHub Consulta el archivo LÉEME hubspot_contact_id Consulta No
Kloudio Agregar datos a una hoja de cálculo de Google Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta No No
mParticle Exporta de forma masiva tus datos de usuarios o eventos de Looker a mParticle. Ver readme en GitHub Consulta el archivo LÉEME Consulta el archivo LÉEME Consulta No
Campañas de Salesforce Agregar contactos o clientes potenciales a la campaña de Salesforce Ver readme en GitHub Consulta el archivo LÉEME sfdc_contact_id o sfdc_lead_id Consulta No
Grupo de segmentos Agregar características o usuarios a tus grupos de segmentos Ver readme en GitHub Ver la documentación segment_group_id y user_id, o segment_group_id y segment_anonymous_id Consulta No
Identificación del segmento Agregar características a los usuarios del segmento mediante la identificación Ver readme en GitHub Ver la documentación email o user_id, segment_anonymous_id o segment_group_id Consulta No
Seguimiento del segmento Conéctate a varias integraciones proporcionadas por Segment para identificar usuarios y segmentarlos para tus flujos de trabajo de marketing. Ver readme en GitHub Ver la documentación email o user_id, segment_anonymous_id o segment_group_id Consulta No
SendGrid Envía datos y programa los resultados para enviarlos a una dirección de correo electrónico con la API de SendGrid. Ver readme en GitHub Ver artículo de la comunidad Ninguna 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 implementaciones alojadas en Looker a partir de la versión 6.24 con la función Lista de IP permitidas inhabilitada. No hay archivos README disponibles Ver la documentación Ninguna Consulta
Adjunto de Slack (token de API) Envía los datos directamente a un canal de Slack junto con las credenciales de usuario. También puedes consultar la documentación de Lookerbot para obtener funciones adicionales de Slack. Ver readme en GitHub Ver la documentación Ninguna Consulta No No
Teams: Webhook entrante Envía datos a Microsoft Teams mediante un webhook entrante. Ver readme en GitHub Consulta el archivo LÉEME Ninguna Consulta No No
Bandeja Conéctate a varias integraciones que proporciona Tray.io para automatizar flujos de trabajo. Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No
Twilio: Enviar datos Envía datos desde una vista o programa resultados para enviarlos a un número de teléfono con la API de Twilio. Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No No
Twilio: Enviar mensaje Envía un mensaje a una serie de números de teléfono (columnas de datos etiquetadas como números de teléfono) en una vista. Ver readme en GitHub Consulta el archivo LÉEME phone Campo, consulta No No
Zapier Conéctate a varias integraciones que proporciona Zapier para automatizar flujos de trabajo. Ver readme en GitHub Ver artículo de la comunidad Ninguna Consulta No

Elegir el formato de los datos

En las entregas por correo electrónico, la opción para 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 el vínculo.

Las vistas y exploraciones presentan diferentes opciones de formato según el destino de entrega. Para elegir el formato de la entrega, selecciona el ícono adecuado en la sección Aplicar formato a los datos como del programador.

Consulta la siguiente tabla para obtener una explicación de cómo se entrega cada formato a 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 imagen PNG No disponible para este destino No disponible para este destino No disponible para este destino
CSV La tabla de datos como un archivo adjunto de texto separado por comas La tabla de datos como un archivo adjunto de texto separado por comas La tabla de datos como un archivo adjunto de texto separado por comas La tabla de datos como un archivo adjunto 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 medida 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 medida 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 medida 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 medida 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 su resultado de JSON. No disponible para este destino No disponible para este destino
JSON: simple, intercalado 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 medida 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 Es la tabla de datos enviada directamente en formato JSON con detalles adicionales, como los metadatos del campo, la información de la caché, la hora en que se completó la consulta y el tiempo que tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medida como su valor renderizado en lugar de la etiqueta del campo. Es la tabla de datos enviada directamente en formato JSON con detalles adicionales, como los metadatos del campo, la información de la caché, la hora en que se completó la consulta y el tiempo que tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medida como su valor renderizado en lugar de la etiqueta del campo. Es la tabla de datos enviada directamente en formato JSON con detalles adicionales, como los metadatos del campo, la información de la caché, la hora en que se completó la consulta y el tiempo que tardó en ejecutarse. En este formato, Looker usa el nombre de campo de una dimensión o medida como su valor renderizado en lugar de la etiqueta del campo.
Texto La tabla de datos como un archivo adjunto de texto delimitado por tabulaciones La tabla de datos como un archivo adjunto de texto delimitado por tabulaciones La tabla de datos como un archivo adjunto de texto delimitado por tabulaciones La tabla de datos como un 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

Activa la publicación

No verás esta opción si envías una exploración o una publicación única de una vista.

Cuando programas entregas recurrentes, tienes dos opciones para activar las publicaciones:

Especifica el activador del grupo de datos

No verás esta opción si envías una exploración, una publicación única de una vista o si especificaste un activador de intervalo recurrente para la publicación recurrente.

Para usar un activador de grupo de datos, selecciona Actualización del 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 una vez que se completa el proceso de regeneración para todas las PDT que se conserven con 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, una publicación única de una vista o si especificaste un activador de actualización de grupo de datos para tu publicación recurrente.

En el caso de las entregas que usan un intervalo que se repite, puedes personalizar el momento de la programación en la sección Publicar esta programación. Selecciona Intervalo de repetición en la sección Activador del programador. Las opciones de horarios cambian según si eliges Diariamente, Semanalmente, Mensualmente, 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 publicación se enviará en el último intervalo seleccionado antes de la hora de finalización especificada. Por ejemplo, si el contenido se programa por hora entre las 12:00 a.m. y las 11:00 p.m., se enviará a esa hora, cada hora, desde las 12:00 a.m. hasta las 10:00 p.m. Si se programa por minuto cada 30 minutos entre las 12:00 a.m. y la 1:00 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 a esta vista o panel de tu publicación. Si cambias estas opciones de filtro en el programador, no se cambiarán los filtros de tu vista o panel. Si un filtro del panel requiere un valor de filtro y el filtro de programación está en blanco, una programación no mostrará resultados después de la entrega.

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), esta podría exponer datos sin filtrar.

Para personalizar aún más las entregas, puedes usar la opción de filtro coincide con un atributo de usuario (si tus administradores de Looker configuraron valores específicos del usuario llamados atributos de usuario). Si configuras el filtro como 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 haces una entrega única. Para obtener más información, consulta la página de documentación Atributos de usuario.

Cómo aplicar opciones de publicación avanzadas

La sección Opciones avanzadas proporciona un nivel de personalización adicional para tu 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 de tu publicación, y si deseas publicar un panel, una vista o una exploración. Los vínculos de la siguiente tabla dirigen a una descripción de cada opción disponible para las entregas de vistas o exploraciones a los destinos nativos de Looker. Es posible que las entregas a integraciones de terceros tengan opciones avanzadas únicas disponibles.

Formato Correo electrónico Webhook Amazon S3 SFTP
Tabla de datos
Enviar este programa si No disponible para este destino No disponible para este destino No disponible para este destino
Límite
Opciones de correo electrónico Ejecutar programación como destinatario
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato
Zona horaria
Visualización
Límite No disponible para este destino No disponible para este destino No disponible para este destino
Opciones de correo electrónico Ejecutar programación como destinatario
Incluir vínculos
Resolución de la tabla
Zona horaria
CSV
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
XLSX
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
JSON: simple; JSON: etiqueta; JSON: simple, intercalado
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
JSON: intercalado y detallado No disponible para este destino Límite Límite Límite
No disponible para este destino Zona horaria Zona horaria Zona horaria
Texto
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria
HTML
Enviar este programa si Enviar este programa si Enviar este programa si Enviar este programa si
Límite Límite Límite Límite
Opciones de correo electrónico Ejecutar programación como destinatario No disponible para este destino No disponible para este destino No disponible para este destino
Incluir vínculos
Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización Opciones de formato Cómo aplicar opciones de visualización
Valores de datos con formato Valores de datos con formato Valores de datos con formato Valores de datos con formato
Zona horaria Zona horaria Zona horaria Zona horaria

Enviar este programa si

En las entregas recurrentes de vistas, puedes personalizar el programa para entregar el contenido de la vista solo cuando se cumplen ciertas condiciones. Las alertas proporcionan una función similar para los mosaicos de panel.

En el menú desplegable Send this schedule if, especifica si deseas publicar el contenido de la vista solo si hay resultados, si no hay resultados o si hay o no. Por ejemplo, puedes usar filtros para crear condiciones para las situaciones que deseas supervisar, como artículos que estén por debajo de una cantidad determinada de inventario, gastos superiores a un valor determinado, etc., y, luego, publicar el contenido solo si se cumple esa condición.

También puedes especificar que haya una publicación 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 está disponible si deseas usar la opción de límite Todos los resultados.

Límite

Puedes limitar el tamaño de tu publicación seleccionando una de las siguientes opciones de límite 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 el artículo ¿Cuáles son todos los límites de filas en Looker? Prácticas recomendadas). Esto es útil para conjuntos de datos grandes, ya que evita limitaciones de tamaño de archivo, navegador y memoria.

Si eliges Resultados en la tabla, Looker obedecerá cualquier limitación de filas que hayas configurado en la vista o exploración guardadas. Si eliges Todos los resultados, Looker mostrará todas las filas de la consulta, sin importar la configuración de vista guardada ni el 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.

Limitar las opciones del correo electrónico

Cuando envías vistas y exploraciones, puedes limitar el tamaño de los correos electrónicos para que se mantengan dentro de las limitaciones de tamaño de los mensajes del 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 de Tabla de datos o Visualización. No se enviarán los correos electrónicos con más de 5,000 filas.
  • Todos los resultados: Si usas opciones de formato de 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, hay 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 de más de 15 MB que contengan archivos adjuntos. 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 que estás dentro del límite de filas o de datos de los correos electrónicos programados, puedes ingresar tu propia dirección de correo electrónico como destinatario y hacer 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 de los correos electrónicos.

Opciones de correo electrónico

Las entregas por correo electrónico tienen opciones de entrega adicionales, como se describe a continuación.

Ejecutar programación como destinatario

Esta opción solo está disponible para el destino del correo electrónico.

La opción Ejecutar programación como destinatario permite a los administradores especificar 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 se aplicarán los filtros de acceso y los atributos de cada usuario 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 a una serie de usuarios, y cada uno tiene diferentes valores de 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 una fila solo para California.

Esta opción tiene en cuenta los permisos del usuario que crea la programación y los tipos de direcciones de correo electrónico que se agregan al campo de texto ¿A quién se debe enviar un correo electrónico?.

En algunos casos, la opción Ejecutar programación como destinatario no está disponible:

  1. Cuando una persona que no es administrador agrega una dirección de correo electrónico que no es la suya
  2. Cuando un administrador de Looker agrega el correo electrónico de un usuario inhabilitado
  3. 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 que se seleccionara la opción Ejecutar programación como destinatario, esta se inhabilitará automáticamente. Volverá a estar disponible 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, esto 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.

Si 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 se inhabilita, la programación no se entregará al usuario inhabilitado a partir de la próxima vez que se ejecute. Si se borra la cuenta de ese usuario, no se podrá entregar toda la programación a ningún destinatario. Un administrador o usuario de Looker con el permiso see_schedules podrá diagnosticar este error en la página Historial del programador del panel Administrador.

Si el administrador de Looker configuró la política de datos enviados por correo electrónico de tu instancia de Looker como Enviar vínculos y datos, el programador mostrará una opción para 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” para las vistas y exploraciones entregadas y “Ver panel completo” para los paneles entregados.

Este vínculo permite que los destinatarios del correo electrónico exploren más a fondo 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 publicado para poder verlo en Looker. Si quieres quitar este vínculo de tus correos electrónicos de entrega de datos, desmarca la casilla de verificación Incluir vínculos.

Opciones de formato

Las entregas que no utilizan el formato de visualización tienen opciones de entrega adicionales, como se describe a continuación.

Aplicar opciones de visualización

Esta opción no está disponible para las entregas de vista o exploración en formato de visualización.

  • Selecciona Aplicar opciones de visualización para que la entrega de datos sea 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 estén configurados para la visualización:

    El formato condicional se muestra en las entregas de Excel de vistas y exploraciones con visualizaciones de gráficos de tablas solo si se aplica la regla A lo largo de una 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í del 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 entregas de vista o exploración en formato de visualización.

Puedes configurar el formateo de los datos:

  • Selecciona Valores de datos con formato si quieres que los datos se parezcan más a la experiencia de 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 de tus resultados de consulta, como redondear los 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

Al enviar contenido por correo electrónico en formato de visualización, puedes personalizar el ancho de la visualización por medio del menú desplegable Resolución de tabla. Las opciones de ancho son:

  • Normal: 800 píxeles
  • Ancho: 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 entrega de correo electrónico deban desplazarse horizontalmente para ver la visualización completa.

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 afectará los datos de tu vista o panel, solo el tiempo de la publicación.

Cómo probar la publicación

Haz clic en el botón Enviar prueba para enviar una entrega de prueba única al destino especificado.

Guardando la publicación

Aparecerá un resumen de la configuración de la publicación en la parte inferior del programador.

En el caso de las entregas únicas, cuando termines de configurar las opciones de entrega, haz clic en el botón Enviar para entregar el contenido de inmediato al destino especificado.

En el caso de las entregas recurrentes, cuando hayas terminado de configurar las opciones de entrega, haz clic en el botón Guardar todo para guardar tu agenda y cerrar la ventana. El contenido se publicará según tu configuración de envío. Si vuelves a abrir el programador, tu programación guardada aparecerá en el panel izquierdo. Haz clic en los íconos Duplicar o Borrar, respectivamente, para duplicar o borrar la programación.

La programación guardada también aparecerá en la página Programaciones que creaste en tu perfil de usuario y en las páginas Historial de programaciones y Programaciones del panel Administrador. Para obtener más información, consulta la sección Cómo ver las publicaciones en esta página.

Cómo ver las entregas

Puedes ver los programas que creaste y, con los permisos correspondientes, todos los programas de la instancia de Looker.

Cómo ver las publicaciones que creaste

Puedes ver una lista de todas las programaciones que creaste en la página Programas que creaste, a la que puedes acceder haciendo clic en el ícono de tu perfil de usuario y seleccionando Programas. Consulta la página Cómo visualizar 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 entregas creadas por otros usuarios

Si el administrador de Looker te otorgó permisos para ver las páginas de administrador Historial de programas y Programas, puedes ver la lista de todos los programas de toda la instancia de Looker. Sin embargo, no podrás editar ni borrar esas programaciones.

Qué debes saber

A veces, una entrega programada de correo electrónico podría no llegar a uno o más de sus destinatarios. Esto podría 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, tus administradores de Looker deberán asegurarse de que la configuración sea correcta y de que tu proveedor de correo electrónico funcione 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 correos electrónicos con archivos adjuntos y 20 MB para correos electrónicos con contenido intercalado. No se enviarán los correos electrónicos con más filas o datos que estos límites.
  • Si un correo electrónico no se envía en el momento esperado, pero finalmente llega, es probable que esté compitiendo con otras tareas de Looker. Estas tareas pueden incluir otros correos electrónicos programados, muchas personas explorando datos al mismo tiempo o tablas derivadas persistentes que se estén creando. Si esto sucede, consulta a los administradores de Looker sobre las tareas que compiten.
  • Si un correo electrónico específico desaparece de la lista de distribución, es probable que se deba a que un usuario anuló la suscripción a ese correo electrónico programado. Esto puede representar un desafío particular si usas un alias de correo electrónico grupal para enviar mensajes a varias personas, ya que cualquier destinatario individual puede anular la suscripción a todo el 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 suscripción del programador.