Cómo programar 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 en canales de Slack públicos y privados. A fin de habilitar la instalación de la aplicación de Looker, es posible que el propietario del lugar de trabajo de Slack deba ajustar la configuración de instalación de la aplicación para el lugar de trabajo de Slack.

La integración del archivo adjunto de Slack (token de API) 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 el Centro de acciones de Looker para cada instancia de Looker a fin de que los usuarios puedan entregar datos con la integración en Slack.

  1. En el panel Administrador en Plataforma, ve a la página Acciones.
  2. Haga 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 de Slack, haz clic en Conectar para conectarte al 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 de Slack.

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

Administra conexiones de Slack al lugar de trabajo en Looker

Puedes administrar las conexiones al lugar de trabajo de Slack de la instancia desde la página de acción 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 de 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 Slack en el lugar de trabajo, haz clic en el botón Desconectar y, luego, en Aceptar en el mensaje emergente de advertencia. No es necesario que haga clic en Save 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 un 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 Looker.

Autenticación en un lugar de trabajo de Slack desde la página Cuenta

  1. En Looker, haga clic en su ícono de perfil de usuario en la parte superior derecha de la pantalla y seleccione Cuenta.
  2. Cualquier integración que esté habilitada para tu instancia aparecerá en Integraciones. Si el administrador de Looker habilitó al menos un lugar de trabajo de Slack, aparecerá el botón 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 forma 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 adecuado en el menú desplegable. Haga clic en Allow.
  4. Cuando regrese a su página Cuenta, ahora aparecerá una opción en la sección Integraciones que le permitirá revocar sus credenciales de Slack para los lugares de trabajo a los que esté conectado. Precaución: Tenga cuidado de no revocar su token de Slack. Si lo hace, fallarán todas las programaciones que haya creado.

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

Autentica en un lugar 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 Paneles de control, selecciona Programar publicación.
  2. En la ventana Send o Schedule de Explorar o Look, selecciona la acción Slack como destino de entrega en ¿A dónde deben ir estos datos?. En el caso de los paneles, selecciona Programar entrega 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 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 adecuado en el menú desplegable. Haga clic en Allow.
  5. La ventana Enviar o Programar (o la ventana Programar entrega de los paneles) 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

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, puedes acceder a cada una desde la página de cuentas de 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, o en Programar ventana de entrega para los paneles.

En el siguiente ejemplo, se muestran las opciones de formato para publicar un panel, incluidas las siguientes:

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

El envío o la programación de un aspecto o exploración tiene diferentes opciones de formato disponibles, que incluyen 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 label del campo.
  • JSON: Etiqueta: En este formato, Looker usa etiquetas del campo como su valor procesado 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 publicar un panel definido por el usuario, un panel LookML o un Look, o Explorar, navega a tu contenido y sigue estos pasos:

  1. Haga 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 Enviar o Programar, seleccione la integración de Slack como destino de entrega en ¿A dónde deben dirigirse estos datos? Para los paneles, seleccione la integración de Slack como destino de entrega en Destino. Si es la primera vez que usa la integración de Slack, primero debe autenticarse en el lugar de trabajo de Slack.
  3. Looker muestra opciones de entrega específicas para el lugar de trabajo de Slack o los 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. Incluye el carácter # inicial, por ejemplo, #Sales.
    • En el campo Comentar, ingresa el texto que quieras incluir con la publicación. También puede usar el formato avanzado de Slack con análisis especial para mencionar grupos, usuarios o canales específicos, o hacer cualquier otra mención especial.
    • En el campo Nombre de archivo, ingresa un nombre para el archivo adjunto.
  4. Si quiere programar una entrega de datos, haga clic en Guardar todo. Tu consulta o panel se entregarán a Slack según la programación. Si estás enviando los datos, haz clic en Enviar. Tus datos se enviarán a tu canal de Slack.

Accede a Looker desde Slack

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

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

Puede compartir vínculos a visualizaciones de SQL Runner, paneles definidos por el usuario, paneles de LookML, diseños (pero no diseños incorporados de forma pública) o exploraciones en Slack.

El vínculo se desenlaza en Slack para mostrar el título del contenido y algunos de sus metadatos, y solo pueden verlos los usuarios con acceso al contenido subyacente. Una vez que se desvincule el vínculo, tú o algún otro usuario pueden 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 se publica el contenido en el canal, cualquier persona 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; haz clic en Agregar a favoritos. Después de agregar contenido a tu carpeta Favorites, la app de Looker en Slack mostrará un mensaje con un vínculo para acceder a tu 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 tiene Lookerbot habilitado, 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 en Slack, pero puedes configurar comandos personalizados en Looker. Asegúrate de usar Lookerbot 0.0.16 o una versión posterior mediante la actualización del repositorio de GitHub de Lookerbot según las instrucciones que se indican en la sección Cómo comenzar a usar Lookebot de la página 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 tu 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 tu carpeta Favoritos de Looker. Haz clic en la elipsis (...) que se encuentra 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 enumera el contenido de tu carpeta personal de Looker. Haz clic en la elipsis (...) que se encuentra junto a cada contenido para acceder a un menú desde el que puedes Publicar contenido en este canal o Quitar de favoritos (si el contenido también está en tu carpeta 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 ella desde 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 Inicio de la app de Looker en Slack

Para ver una lista de tu contenido y carpetas favoritos de Looker en Slack, haz clic en la pestaña Home (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 tu administrador de Looker conectó solo una instancia de Looker a tu lugar de trabajo de Slack, esa instancia será la predeterminada.

Si el administrador de Looker conectó varias instancias de Looker a tu lugar de trabajo de Slack, puedes configurar una 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 del vínculo 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 configurarla 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 desplegar vínculos de una instancia de Looker que no sea la predeterminada. Si no cambias de instancia y tratas de desvincular el vínculo de una instancia no predeterminada de Looker, se te pedirá que accedas a esa instancia.