Programa entregas en 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 de Slack públicos y privados. 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 para tu lugar de trabajo de Slack.

La integración con Slack no es compatible con las instancias alojadas por el cliente.
La integración de Slack está disponible para implementaciones alojadas en Looker que cumplan con estas condiciones:

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

Habilita la integración en el Centro de acción de Looker

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

  1. En el panel Administrador en 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, haga clic en Conectar para conectarse a su lugar de trabajo de Slack.

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

  4. Haga clic en Permitir y regrese a la página de acción Slack.

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

Administrar conexiones de lugar de trabajo de Slack a Looker

Puedes administrar las conexiones del lugar de trabajo de Slack de la instancia desde la página de acciones de Slack. Haga 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: conectar, desconectar y restablecer.

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

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

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

Autentica 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 en Looker.

Puedes autenticarte en un lugar de trabajo de Slack por primera vez desde las siguientes plataformas:

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

Autenticar en un lugar de trabajo de Slack desde la página Cuenta

  1. En Looker, haga clic en su ícono de perfil del usuario, en la esquina superior derecha de la pantalla, y seleccione Cuenta.
  2. Todas las integraciones habilitadas para tu instancia aparecen en Integraciones. Si el administrador de Looker habilitó al menos un lugar de trabajo de Slack, verá 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 su instancia de Looker, aparecerá un menú desplegable en la parte superior derecha de la página de OAuth. Selecciona el lugar de trabajo de Slack adecuado en el menú desplegable. Haga clic en Allow.
  4. Volviendo a la página de su Cuenta, aparece una opción para revocar sus credenciales de Slack en todos los lugares de trabajo a los que está conectado.

Ten cuidado de no revocar tu token de Slack; si lo haces, fallarán las programaciones que creaste.

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

Autenticar en un lugar de trabajo de Slack desde la ventana Enviar o Programar

  1. En Looker, navegue al contenido que se publicará, haga clic en el menú de ajustes y, luego, en Enviar o Programar.
  2. En la ventana Enviar o Programar, seleccione la acción Slack como destino de entrega en ¿A dónde deben dirigirse estos datos?
  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 su instancia de Looker, aparecerá un menú desplegable en la parte superior derecha de la página de OAuth. Selecciona el lugar de trabajo de Slack adecuado en el menú desplegable. Haga clic en Allow.
  5. La ventana Enviar o Programar ahora muestra las opciones de entrega de Slack, incluidos los canales públicos y privados de tu espacio de trabajo de Slack. 

Entrega datos a Slack

Para entregar datos a la integración de Slack, un administrador de Looker primero debe otorgar el permiso send_to_integration a los usuarios y habilitar la integración de Slack en el centro de acciones de Looker. Los usuarios también deben autenticarse en los mismos lugares de trabajo de Slack que el administrador conectó a Looker.

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 de la Cuenta del usuario. Luego, puedes seleccionar un lugar de trabajo de destino entre los que aparecen en la lista desplegable Lugares de trabajo de la ventana emergente Enviar o Programar.

En el siguiente ejemplo, se muestran opciones de formato para la publicación de un panel, que incluye lo siguiente:

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

El envío o la programación de un Look o Explore tienen diferentes opciones de formato disponibles, incluidas las siguientes:

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

Para enviar la opción Explorar en formato PDF o PNG, guarda la opción Look to a dashboard y programa el panel en el formato deseado. Para programar una exploración, primero debes guardarla como un estilo.

Para enviar o programar un estilo en formato PDF o PNG, guárdalo en un panel y programa el panel en el formato que desees.

Para publicar un panel definido por el usuario, un panel LookML o un Look o Explorar, navegue a su contenido y siga 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).
  2. En la ventana Enviar o Programar, seleccione la integración de Slack como destino de entrega en ¿Dónde deben ir estos datos? 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 opciones de entrega que son específicas del lugar de trabajo de Slack o de lugares de trabajo conectados a esta instancia de Looker.
    • En el campo Compartir, ingrese el nombre del canal de Slack en el que desea publicar sus datos. Puedes enviar mensajes directos o mensajes a canales públicos o privados. Incluya el carácter inicial #, por ejemplo, #Ventas.
    • En el campo Comentario, ingrese el texto que desee incluir en la publicación.
      • Para mencionar a un usuario, incluye <@user_ID>, que puedes copiar haciendo clic en el botón ... de su perfil de usuario de Slack.
      • Para mencionar un grupo, incluye <@group_ID>, que puedes copiar de la URL del navegador cuando te encuentres en el perfil del grupo.
      • Para mencionar un canal específico, incluye <#channel_ID>, que puedes copiar de la URL del navegador cuando te encuentres en el canal.
      • Para otras menciones especiales, usa <!here>, <!channel> o <!everyone>.
    • En el campo Nombre de archivo, ingresa un nombre para el archivo adjunto.
  4. Si está programando una entrega de datos, haga clic en Guardar todo. Tu consulta o panel se entregarán a Slack según la programación. Si envías tus datos, haz clic en Enviar. Tus datos se entregarán a tu canal de Slack.

Accede a Looker desde Slack

Puedes acceder a los datos de Looker desde Slack de la siguiente manera:

Comparte vínculos al contenido de Looker en Slack

En Slack, puedes compartir vínculos a visualizaciones de SQL Runner, paneles definidos por el usuario (incluido el contenido de paneles heredados), paneles de LookML, apariencias (pero no apariciones públicas) o exploraciones.

El vínculo se desvía en Slack para mostrar el título del contenido y algunos de sus metadatos, que solo son visibles para quienes tienen acceso al contenido subyacente. Una vez que se desvierta el vínculo, tú y otros usuarios pueden hacer lo siguiente:

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

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 tiene habilitado Lookerbot, es posible que deba 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 configurarlos en Lookerbot. Asegúrese de utilizar Lookerbot versión 0.0.16 o posterior mediante la actualización del repositorio de GitHub del robot de Google, como se indica en la sección Cómo actualizar la aplicación de Lookerbot del artículo 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 saluda por su nombre, te indica la instancia de Looker a la que estás conectado y proporciona vínculos a la carpeta 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 enumera el contenido de la carpeta Favoritos de Looker. Haz clic en la elipsis (...) situada junto a cada contenido para acceder a un menú desde el cual puedes publicar en este canal o eliminar de favoritos.
  • /looker folder: La app de Looker en Slack enumera el contenido de tu carpeta personal de Looker. Haz clic en la elipsis (...) situada junto a cada contenido para acceder a un menú desde el cual puedes publicar en este canal o eliminar de favoritos (si el contenido también está en tu carpeta de Favoritos).
  • /looker select: La app de Looker en Slack enumera las instancias conectadas a ese lugar de trabajo de Slack. A fin de establecer una instancia predeterminada para tu lugar de trabajo de Slack, haz clic en esta lista de 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 Página principal de la app de Looker en Slack

Para ver una lista de su contenido y carpetas favoritos de Looker en Slack, haga clic en la pestaña Página principal en la aplicación 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 su administrador de Looker conectó solo una instancia de Looker a su lugar de trabajo de Slack, esa será su instancia predeterminada.

Si tu administrador de Looker conectó varias instancias de Looker a tu lugar de trabajo de Slack, puedes establecer una como la instancia predeterminada de Looker. Cualquier comando de barra específico de la instancia (la mayoría de los comandos excepto /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 aplicación de Looker pregunta ¿Qué instancia te gustaría establecer como predeterminada? Haz clic en el botón correspondiente al nombre de la instancia de Looker para establecerla como predeterminada.

    La app de Looker confirmará su selección.

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