Programa entregas a la integración de Slack

Puedes instalar la app de Looker en tu espacio 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 de tu espacio de trabajo de Slack.

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

Habilita la integración en el Action Hub 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 acciones de 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 + Conectarse al 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 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 Settings junto a la integración de Slack en la página Actions, en el panel Admin.

Los administradores pueden realizar las siguientes operaciones con cada conexión de lugar de trabajo de Slack: conectarse, 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 lugar 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 del 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 espacio 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.

Para autenticarte en un lugar de trabajo de Slack por primera vez, sigue estos pasos:

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 tu ícono de perfil de usuario en la esquina superior derecha de la pantalla y selecciona Cuenta.
  2. Las integraciones que están habilitadas para tu instancia aparecen en Integraciones. Si el administrador de Looker habilitó al menos un espacio de trabajo de Slack, aparecerá el botón 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 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.
  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 todas las programaciones que hayas creado.

Ahora que te autenticaste, puedes 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.

Autentícate 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 de control, selecciona Programar entrega.
  2. En la ventana Enviar o Programar de una exploración o una vista, selecciona la acción Slack como destino de la entrega en ¿Dónde deben ir estos datos?. Para los paneles, selecciona Programar entrega 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 espacio 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 medición como su valor renderizado en lugar de la etiqueta del campo.
  • Texto
  • HTML

Para ofrecer 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. Para los paneles, selecciona Programar entrega 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? Para los paneles, selecciona la integración de Slack como el destino de entrega 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 (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, #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 un análisis especial para mencionar grupos, usuarios o canales específicos, o 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 entregará a Slack según lo programado. Si deseas 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, puedes hacer lo siguiente:

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, Looks (pero no vistas incorporadas públicamente) ni de Exploraciones en Slack.

El vínculo se despliega en Slack para mostrar el título del contenido y algunos de sus metadatos. Solo podrán verlo quienes tengan 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 una carpeta Favorites de Looker y haz clic en Add toFavorite. Después de agregar contenido a tu carpeta Favorites, la app de Looker en Slack mostrará un mensaje en Slack con un vínculo para acceder a la carpeta Favorites 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 con Slack, pero puedes configurarlos en Lookerbot. Asegúrate de usar la versión 0.0.16 o una posterior de Lookerbot. Para ello, actualiza desde el repositorio de GitHub de Lookerbot como se indica en la sección Comienza a usar Lookebot de la página Prácticas recomendadas de 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 (...) situados junto a cada porción de 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 muestra el contenido de tu carpeta personal de Looker. Haz clic en los puntos suspensivos (...) situados junto a cada porción de contenido para acceder a un menú desde el cual puedes Publicar en este canal o Eliminar de Favoritos (si el contenido también se encuentra en tu carpeta Favoritos).
  • /looker select: La app de Looker en Slack muestra las instancias conectadas a ese espacio de trabajo de Slack. Si quieres 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 tus carpetas y contenido favoritos de Looker en Slack, haz clic en la pestaña Home 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 será la predeterminada.

Si tu administrador de Looker conectó varias instancias de Looker a tu lugar 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 otra instancia de Looker. Debes cambiar las instancias predeterminadas si despliegas vínculos de 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.