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, tu administrador de Looker debe habilitar la integración de Slack en 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 Looker Action Hub.

  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 espacio 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 conexiones de lugares 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 de espacio de trabajo de Slack: Conectar, Desconectar y Restablecer.

  • Para conectar espacios de trabajo adicionales de Slack a la instancia de Looker, haz clic en el vínculo + Conectar al espacio 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 acción 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.

Autentícate 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 él desde Looker.

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

Recibes 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 perfil de usuario 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 espacio 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 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 regreses a la página Cuenta, aparecerá una opción en la sección Integraciones que te permitirá revocar tus credenciales de Slack para cualquier lugar de trabajo al que te hayas conectado. 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. Para obtener más información, consulta la sección Cómo entregar datos a Slack de esta página.

Cómo autenticarse 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 espacio 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 esquina 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. En la ventana Enviar o Programar (o en la ventana Programar entrega de 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.

Entrega datos a Slack

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

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

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

Para enviar o programar 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 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 el resultado de JSON.
  • JSON: simple, intercalado: En este formato, Looker usa el nombre de campo de una dimensión o medición como su valor renderizado en lugar de la etiqueta del campo.
  • JSON: 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, 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 publicación en el menú de tres puntos del panel.
  2. En la ventana Enviar o Programar, selecciona la integración de Slack como el destino de entrega en ¿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 espacio de trabajo de Slack.
  3. Looker muestra opciones de entrega específicas para los lugares de trabajo de Slack 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 # inicial, por ejemplo, #Sales.
    • En el campo Comentario, ingresa el texto que desees incluir en 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.

Accede a Looker desde Slack

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

Comparte 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. Una vez que se despliegue 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. Para ello, haz clic en Publicar en este canal. Después de que se publica el contenido en el canal, cualquier persona puede ver el resumen y el título del contenido, incluso si no tienen acceso al contenido subyacente en Looker.
  • Agrega el contenido a la carpeta Favorites de Looker y haz clic en Add toFavorite. 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 con 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 proporciona vínculos a tu carpeta Favorites de Looker, a tu carpeta personal y a Help.
  • /looker help: La app de Looker en Slack muestra los comandos de barra compatibles.
  • /looker favorites: La app de Looker en Slack muestra el contenido de tu carpeta Favorites 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.

Visualiza la pestaña Principal de tu 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 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 será la predeterminada.

Si tu administrador de Looker conectó varias instancias de Looker a tu espacio de trabajo de Slack, puedes establecer una de las instancias como la 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 te pregunta: ¿Qué instancia te gustaría 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 de Looker diferente. 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 desenrollar un vínculo de una instancia no predeterminada de Looker, se te pedirá que accedas a esa instancia.