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 publicaciones 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 lugar de trabajo de Slack deba ajustar la configuración de instalación de la app.

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

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

Si tu instancia de Looker cumple con las condiciones requeridas, el administrador de Looker debe habilitar la integración de Slack en el Looker Action Hub, para cada instancia de Looker, antes 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, 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 lugares de trabajo de Slack a una sola instancia de Looker, haz clic en el vínculo + Conectar a un lugar de trabajo de Slack.

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

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

Administra las conexiones de lugares de trabajo de Slack a Looker

Puedes administrar las conexiones del lugar de trabajo de Slack de la instancia desde la página de acción 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 de espacio de trabajo de Slack: Conectar, Desconectar y Restablecer.

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

  • Para desconectar una conexión existente del espacio de trabajo de Slack, 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 acciones de 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 de tu lugar de trabajo de Slack sin tener que desconectarla y volver a conectarla, haz clic en el botón Restablecer.

Cómo autenticarte en tu espacio 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 espacio de trabajo para poder autenticarse en él desde Looker.

Puedes autenticarte en un espacio de trabajo de Slack por primera vez desde los siguientes lugares:

  • Cuenta. (Esta es tu única opción si hay varios lugares de trabajo de Slack conectados a tu instancia de Looker).
  • Ventana Enviar o Programar.

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

Cómo autenticarse en un espacio de trabajo de Slack desde la página Cuenta

  1. En Looker, haz clic en el ícono de perfil de usuario que se encuentra en la parte superior derecha de la pantalla y selecciona Cuenta.
  2. Todas las integraciones habilitadas para tu instancia aparecen en Integraciones. Si tu administrador de Looker habilitó al menos un lugar de trabajo de Slack, aparecerá un botón para Acceder con Slack. Si tu 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 ellos de forma individual.
  3. Looker solicitará acceso al lugar de trabajo de Slack. Si tu administrador de Looker conectó varios espacios de trabajo de Slack a tu 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. Haz clic en Permitir.
  4. Cuando vuelvas a la página Cuenta, aparecerá una opción en la sección Integraciones que te permitirá revocar tus credenciales de Slack para los lugares de trabajo a los que te conectaste. Precaución: Ten cuidado de no revocar tu token de Slack. Si lo haces, fallarán las programaciones que hayas creado.

Ahora que se autenticó, puede enviar o programar paneles, vistas y exploraciones. Consulta la sección Cómo enviar datos a Slack en esta página para obtener más información.

Autenticación en un espacio de trabajo de Slack desde la ventana Enviar o Programar

  1. En Looker, navega al contenido que se publicará, haz clic en el menú de ajustes y, luego, en Enviar o Programar. En el caso de los paneles de control, selecciona Programar publicación.
  2. En la ventana Enviar o Programar de una exploración o una búsqueda, selecciona la acción Slack como destino de publicación en ¿Adónde deben ir estos datos?. En el caso de los paneles, selecciona Programar publicación en la ventana Programar y enviar.
  3. Junto a Slack, haz clic en Acceder.
  4. Looker solicitará acceso al lugar de trabajo de Slack. Si tu administrador de Looker conectó varios espacios de trabajo de Slack a tu 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. Haz clic en Permitir.
  5. La ventana Enviar o Programar (o la ventana Programar publicación para los paneles) ahora muestra tus opciones de publicación en Slack, incluidos los canales públicos y privados de tu lugar de trabajo de Slack.

Cómo enviar datos a Slack

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

Las opciones de formato para publicar un panel son las siguientes:

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

Cuando envías o programas una vista o una exploración, tienes diferentes opciones de formato disponibles, como las siguientes:

  • CSV
  • XLSX
  • JSON: Simple: 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: En este formato, Looker usa las etiquetas de campo como su valor renderizado en su salida JSON.
  • JSON: Simple, intercalado: 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: Detallado, intercalado: 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
  • HTML

Para publicar un panel definido por el usuario, un panel de LookML, un aspecto 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 envío en el menú de tres puntos del panel.
  2. En la ventana Enviar o Programar, selecciona la integración de Slack como destino de entrega en ¿A dónde deben ir estos datos? En el caso de los paneles, selecciona la integración de Slack como destino de publicación 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 opciones de publicación específicas para el lugar de trabajo de Slack o los lugares de trabajo conectados a esta instancia de Looker.
    • En el campo Compartir en, ingresa el nombre del canal de Slack en el que deseas publicar tus datos. Puedes enviar mensajes directos o mensajes a canales públicos o privados. Incluye el carácter # al principio, por ejemplo, #Ventas.
    • En el campo Comentario, ingresa el texto que deseas incluir con la publicación. También puedes usar el formato avanzado de Slack con análisis especiales para mencionar grupos, usuarios o canales específicos, o bien hacer cualquier otra mención especial.
    • En el campo Nombre del 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 vas a enviar tus datos, haz clic en Enviar. Tus datos se enviarán a tu canal de Slack.

Cómo acceder a Looker desde Slack

Para acceder a los datos de Looker desde Slack, sigue estos pasos:

Cómo compartir vínculos al contenido de Looker en Slack

Puedes compartir vínculos a visualizaciones de SQL Runner, paneles definidos por el usuario, paneles de LookML, vistas (pero no vistas incorporadas públicamente) o Exploraciones en Slack.

El vínculo se despliega en Slack para mostrar el título del contenido y algunos de sus metadatos, que solo pueden ver quienes tienen acceso al contenido subyacente. Después de que se despliegue el vínculo, tú y otros usuarios podrán hacer lo siguiente:

  • Publica un vínculo al contenido de Looker y una instantánea del contenido del canal. Haz clic en Publicar en este canal. Después de que el contenido se publica en el canal, cualquier persona que lo visite podrá ver el título y el resumen del contenido, 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 la carpeta Favoritos, la app de Looker en Slack muestra un mensaje en Slack con un vínculo para acceder a la carpeta Favoritos en Looker.

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

Cómo usar comandos de barra para recuperar información de Looker en Slack

Si también tienes habilitado 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 configurarlos en Lookerbot. Asegúrate de usar la versión 0.0.16 de Lookerbot o una posterior. Para ello, actualiza desde el repositorio de GitHub de Lookerbot según se indica en la sección Cómo comenzar a usar Lookerbot 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 saluda por tu nombre, te indica la instancia de Looker a la que te conectaste y te proporciona vínculos a la carpeta Favoritos, a tu carpeta personal y a Ayuda.
  • /looker help: La app de Looker en Slack muestra una lista de los comandos de barra compatibles.
  • /looker favorites: La app de Looker en Slack muestra el contenido de la carpeta Favoritos de Looker. Haz clic en los puntos suspensivos (...) junto a cada elemento de contenido para acceder a un menú en el que puedes Publicar en este canal o Quitar 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 (...) que aparecen junto a cada elemento de contenido para acceder a un menú en el que puedes publicar contenido en este canal o quitarlo de Favoritos (si el contenido también está en la carpeta Favoritos).
  • /looker select: La app de Looker en Slack muestra la instancia o instancias conectadas a ese lugar de trabajo de Slack. Para establecer una instancia predeterminada para tu lugar de trabajo de Slack, haz clic en ella en esta lista. Todos los comandos de barra específicos de la instancia se aplicarían a la instancia predeterminada de Looker.

Cómo ver la pestaña Principal de la app de Looker en Slack

Para ver una lista de tu contenido y carpetas de Looker favoritos en Slack, haz clic en la pestaña Home de 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 Principal de la app de Looker.

Cómo configurar una instancia predeterminada de Looker para tu lugar de trabajo de Slack

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

Si tu administrador de Looker conectó varias instancias de Looker a tu lugar de trabajo de Slack, puedes establecer una de ellas como la instancia predeterminada de Looker. 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 establecerla como la predeterminada.

    La app de Looker confirmará tu selección.

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