Programa entregas a la integración de Slack

Puedes instalar la app de Looker en tu lugar de trabajo de Slack para enviar o programar entregas de datos directamente a canales públicos y privados de Slack. Para habilitar la instalación de la app de Looker, es posible que el propietario de tu espacio de trabajo de Slack deba ajustar la configuración de instalación de la app.

La integración del archivo adjunto de Slack (token de API) también está disponible para su uso.

Habilita la integración en Action Hub de Looker

Si tu instancia de Looker cumple las condiciones requeridas, el administrador de Looker debe habilitar la integración de Slack en el Centro de acciones de Looker para cada instancia de Looker antes de que los usuarios puedan entregar datos con esta integración.

  1. En el panel Administrador, debajo de Plataforma, ve a la página Acciones.
  2. Haz clic en el botón Habilitar para habilitar la integración de Slack en el Centro de acciones de Looker.
  3. En la página de acción Slack, haz clic en Conectar para conectarte a tu lugar de trabajo de Slack.

    Looker solicitará acceso al lugar de trabajo de Slack que se indica en el menú desplegable de la parte superior derecha de la página. Para conectar varios espacios de trabajo de Slack a una sola instancia de Looker, haz clic en el vínculo + Conectar a un espacio de trabajo de Slack.

  4. Haz clic en Permitir y regresa a la página de acciones de Slack.

  5. Haz clic en el interruptor Habilitar y, luego, en Guardar.

Administra las conexiones del lugar de trabajo de Slack a Looker

Puedes administrar las conexiones del espacio de trabajo de Slack de la instancia desde la página de acciones de Slack. Haz clic en el botón Configuración junto a la integración de Slack en la página Acciones del panel Administrador.

Los administradores pueden realizar las siguientes operaciones con cada conexión del lugar de trabajo de Slack: conectarse, desconectarse y restablecerse.

  • Para conectar espacios de trabajo adicionales de Slack a la instancia de Looker, haz clic en el vínculo + Conectar a un espacio de trabajo de Slack.

  • Para desconectar una conexión de lugar de trabajo de Slack existente, haz clic en el botón Desconectar y, luego, en Aceptar, en el mensaje de advertencia emergente. No es necesario que hagas clic en Guardar en la página de acción Slack para guardar esta configuración, y la acción seguirá apareciendo como Habilitada incluso si no hay ningún espacio de trabajo de Slack conectado.

  • Para actualizar la conexión del espacio de trabajo de Slack sin tener que desconectarla y volver a conectarla, haz clic en el botón Restablecer.

Realiza la autenticación en tu lugar de trabajo de Slack

Los usuarios deben autenticarse en el mismo lugar de trabajo de Slack que el administrador de Looker conectó a Looker. Los usuarios también deben ser miembros existentes del lugar de trabajo para poder autenticarse desde Looker.

Puedes autenticarte en un lugar de trabajo de Slack por primera vez desde estas opciones:

Recibirás un mensaje de confirmación de Slack después de autenticarte correctamente en Slack desde Looker.

Autentícate en un lugar de trabajo de Slack desde la página Cuenta

  1. En Looker, haz clic en el ícono de tu perfil de usuario en la esquina superior derecha de la pantalla y selecciona Cuenta.
  2. Todas las integraciones que están habilitadas para tu instancia aparecen en Integraciones. Si el administrador de Looker habilitó al menos un lugar de trabajo de Slack, aparecerá un botón para Acceder con Slack. Si el administrador de Looker conectó más de un lugar de trabajo de Slack a tu instancia de Looker, aparecerá una lista de lugares de trabajo con opciones para acceder a cada uno de manera individual.
  3. Looker solicitará acceso al lugar de trabajo de Slack. Si el administrador de Looker conectó varios lugares de trabajo de Slack a tu instancia de Looker, aparecerá un menú desplegable en la esquina superior derecha de la página de OAuth. Selecciona el lugar de trabajo de Slack correspondiente en el menú desplegable. Haga clic en Allow.
  4. Cuando regreses a la página de tu Cuenta, aparecerá una opción en la sección Integraciones que te permitirá revocar tus credenciales de Slack para todos los lugares de trabajo a los que estés conectado. Precaución: Ten cuidado de no revocar tu token de Slack, si lo haces, cualquier programa que creaste fallará.

Ahora que te autenticaste, puedes enviar o programar paneles, vistas y exploraciones. Consulta la sección Envía datos a Slack de esta página para obtener más información.

Cómo autenticarte en un lugar de trabajo de Slack desde la ventana Enviar o programar

  1. En Looker, navega al contenido que se entregará, haz clic en el menú de ajustes y, luego, en Enviar o Programar. En los paneles, selecciona Programar entrega.
  2. En la ventana Send o Schedule de una exploración o de una vista, selecciona la acción Slack como destino de entrega en ¿Dónde deben ir estos datos?. En el caso de los paneles de control, selecciona Programar entrega en la ventana de programación y envío.
  3. Junto a Slack, haz clic en Acceder.
  4. Looker solicitará acceso al lugar de trabajo de Slack. Si el administrador de Looker conectó varios lugares de trabajo de Slack a tu instancia de Looker, aparecerá un menú desplegable en la esquina superior derecha de la página de OAuth. Selecciona el lugar de trabajo de Slack correspondiente en el menú desplegable. Haga clic en Allow.
  5. En las ventanas Enviar o Programar (o Programar entrega para los paneles) ahora se muestran las opciones de entrega de Slack, incluidos los canales públicos y privados de tu lugar de trabajo de Slack.

Envía datos a Slack

Puedes entregar contenido a uno de varios lugares de trabajo de Slack. Después de que un administrador de Looker configure las conexiones del lugar de trabajo, podrás acceder a cada una desde la página Cuenta de usuario. Luego, puedes seleccionar un lugar de trabajo de destino entre los que aparecen en el menú desplegable Lugares de trabajo de la ventana emergente Enviar o Programar, o bien Programar ventana de entrega para los paneles.

El siguiente ejemplo muestra las opciones de formato para entregar un panel, que incluyen:

  • PDF
  • Visualización (PNG)
  • Archivo ZIP de CSV

Para enviar o programar una vista o una exploración, existen diferentes opciones de formato disponibles, incluidas las siguientes:

  • CSV
  • XLSX
  • JSON: Simple: En este formato, Looker usa el nombre del campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo.
  • JSON: Etiqueta: En este formato, Looker usa etiquetas de campo como su valor renderizado en su resultado JSON.
  • JSON: Simple, intercalado: En este formato, Looker usa el nombre del campo de una dimensión o medida como su valor renderizado en lugar de la etiqueta del campo.
  • JSON: Detallado, intercalado: En este formato, Looker usa el nombre del campo de una dimensión o medida como su valor renderizado en lugar de la etiqueta del campo.
  • Texto
  • HTML

Para entregar un panel definido por el usuario, un panel de LookML, una vista o una exploración, navega a tu contenido y sigue estos pasos:

  1. Haz clic en el menú de ajustes y, luego, en Enviar o Programar. (No tendrás la opción de programar una exploración). En el caso de los paneles, selecciona Programar entrega en el menú de tres puntos del panel.
  2. En la ventana Send o Schedule, selecciona la integración de Slack como destino de la entrega en ¿Dónde deben ir estos datos? Para los paneles, selecciona la integración de Slack como destino de la entrega en Destino. Si es la primera vez que usas la integración de Slack, primero debes autenticarte en el lugar de trabajo de Slack.
  3. Looker muestra las opciones de entrega específicas del lugar de trabajo de Slack o los lugares de trabajo conectados a esta instancia de Looker.
    • En el campo Share In, ingresa el nombre del canal de Slack en el que quieres publicar tus datos. Puedes enviar mensajes directos o mensajes a canales públicos o privados. Incluye el carácter # inicial, por ejemplo, #Ventas.
    • En el campo Comentario, ingresa cualquier texto que desees incluir con la publicación. También puedes utilizar el formato avanzado de Slack con análisis especiales para mencionar grupos, usuarios o canales específicos, o para hacer cualquier otra mención especial.
    • En el campo Nombre de archivo, ingresa un nombre para el archivo adjunto.
  4. Si estás programando una entrega de datos, haz clic en Guardar todo. Tu consulta o panel se enviará a Slack según lo programado. Si quieres enviar tus datos, haz clic en Enviar. Los datos se enviarán a tu canal de Slack.

Accede a Looker desde Slack

Puedes acceder a los datos de Looker desde Slack de las siguientes maneras:

Puedes compartir vínculos a visualizaciones del ejecutor de SQL, paneles definidos por el usuario, paneles de Looker, vistas (pero no vistas incorporadas de forma pública) o exploraciones en Slack.

El vínculo se muestra en Slack para mostrar el título del contenido y algunos de sus metadatos, que solo pueden ver los usuarios que tienen acceso al contenido subyacente. Después de que se muestre el vínculo, tú o algún otro usuario podrán hacer lo siguiente:

  • Publica un vínculo al contenido en Looker y un resumen del contenido del canal. Haz clic en Publicar en este canal. Después de que el contenido se publica en el canal, cualquier persona en él puede ver el resumen y el título del contenido, incluso si no tiene acceso al contenido subyacente en Looker.
  • Agrega el contenido a una carpeta de Favoritos de Looker: haz clic en Agregar a favoritos. Después de agregar contenido a tu carpeta Favoritos, la app de Looker en Slack mostrará un mensaje en Slack con un vínculo para acceder a tu carpeta Favoritos en Looker.

Si tienes varias instancias de Looker conectadas al lugar de trabajo, debes configurar la instancia predeterminada para que coincida con la instancia de Looker desde la que compartes el vínculo.

Usa comandos de barra para recuperar información de Looker en Slack

Si también habilitaste Lookerbot, es posible que debas cambiar el nombre de algunos comandos de barra. Los comandos personalizados de Slack no están disponibles para la integración de Slack, pero puedes configurar comandos personalizados en Lookerbot. Asegúrate de usar Lookerbot versión 0.0.16 o posterior. Para ello, actualiza desde el repositorio de Lookerbot de GitHub como se indica en la sección Comienza a usar Lookebot de la página de prácticas recomendadas Cómo usar Lookerbot para Slack.

Usa los siguientes comandos de barra para recuperar información de Looker y publicarla en Slack:

  • /looker y /looker whoami: La app de Looker en Slack te recibe por nombre, te indica la instancia de Looker a la que te conectaste y proporciona vínculos a tu carpeta de Favoritos de Looker, a tu carpeta personal y a Ayuda.
  • /looker help: La app de Looker en Slack enumera los comandos de barra compatibles.
  • /looker favorites: La app de Looker en Slack muestra el contenido de tu carpeta Favoritos de Looker. Haz clic en los puntos suspensivos (...) junto a cada contenido para acceder a un menú desde el que puedes Publicar en este canal o Eliminar de Favoritos.
  • /looker folder: La app de Looker en Slack muestra el contenido de tu carpeta personal de Looker. Haz clic en los puntos suspensivos (...) junto a cada contenido para acceder a un menú desde el que puedes Publicar en este canal o Eliminar de Favoritos (si el contenido también se encuentra en la carpeta Favoritos).
  • /looker select: La app de Looker en Slack muestra las instancias conectadas a ese lugar de trabajo de Slack. Si quieres establecer una instancia predeterminada para tu lugar de trabajo de Slack, haz clic en ella en la lista. Todos los comandos de barra específicos de la instancia se aplicarían a la instancia predeterminada de Looker.

Visualiza la pestaña principal de la app de Looker en Slack

Para ver una lista de tu contenido y tus carpetas favoritos de Looker en Slack, haz clic en la pestaña Página principal en la app de Looker.

Si configuras una instancia predeterminada de Looker para tu lugar de trabajo de Slack, solo verás el contenido de esa instancia en la pestaña Página principal de la app de Looker.

Configura una instancia predeterminada de Looker para tu lugar de trabajo de Slack

Si el administrador de Looker conectó solo una instancia de Looker a tu lugar de trabajo de Slack, esa instancia es la predeterminada.

Si el administrador de Looker conectó varias instancias de Looker a tu lugar de trabajo de Slack, puedes establecer una de las instancias como la instancia de Looker predeterminada. Cualquier comando de barra específico de la instancia (la mayoría de los comandos además de /looker help) y el despliegue de vínculos se aplicarían a la instancia predeterminada.

  1. En Slack, ejecuta el comando de barra /looker select para ver una lista de las instancias de Looker conectadas a tu lugar de trabajo de Slack.

  2. La app de Looker pregunta: ¿Qué instancia quieres establecer como predeterminada? Haz clic en el botón correspondiente al nombre de la instancia de Looker para establecer esta instancia como predeterminada.

    La app de Looker confirmará tu selección.

Para cambiar tu instancia predeterminada de Looker, vuelve a ejecutar /looker select y selecciona una instancia diferente. Debes cambiar las instancias predeterminadas si quieres mostrar vínculos desde una instancia de Looker que no sea la predeterminada. Si no cambias de instancia y tratas de deshacer un vínculo de una instancia de Looker que no sea la predeterminada, se te pedirá que accedas a esa instancia.