Cómo compartir datos a través de un centro de acciones

Además de publicar contenido en los destinos integrados de Looker, puedes usar acciones (también llamadas integraciones) para publicar contenido en servicios de terceros integrados con Looker a través de un servidor de centro de acciones.

En esta página, se describen las opciones para crear acciones personalizadas que puedes solicitar para agregarlas al centro de acciones de Looker o a tu propio servidor privado de centro de acciones. En esta página, también se describe cómo iniciar un servidor de Action Hub local para probar tus acciones personalizadas o ejecutar un servidor de Action Hub privado.

Para comenzar a usar acciones, puedes hacer lo siguiente:

Una vez que se agrega la acción al centro de acciones, un administrador de Looker puede habilitar la acción para usarla en la publicación de contenido de Looker en esos servicios.

También puedes configurar varios centros de acciones si deseas usar las integraciones de Looker a través del centro de acciones de Looker y alojar tus propias acciones privadas o personalizadas. Las acciones de cada centro de acciones aparecerán en la página Acciones del panel Administrador.

El Action Hub de Looker

Looker aloja y proporciona Action Hub de Looker, un servidor sin estado que implementa la API de Action de Looker y expone acciones populares. Los datos que tus usuarios envíen con una acción se procesarán temporalmente en el servidor de Looker Action Hub en lugar de en tu instancia de Looker.

Looker ya está integrado en varios servicios. Consulta la página de documentación Configuración del administrador: Acciones para obtener información sobre cómo habilitar estos servicios existentes.

Requisitos de Action Hub de Looker

Looker Action Hub debe poder enviar y recibir solicitudes a la API de las siguientes maneras:

Si tu implementación de Looker no puede admitir estas solicitudes o si la función IP Allowlist está habilitada en tu instancia de Looker, considera configurar un servidor de Action Hub local para publicar integraciones de Looker o acciones personalizadas privadas. Los administradores de instancias alojadas por el cliente también pueden implementar un servidor de acciones local específicamente para OAuth y las acciones de transmisión.

Solicitudes de la instancia de Looker a la red de Action Hub de Looker

Las solicitudes a actions.looker.com se resuelven en una dirección IP dinámica. Las solicitudes salientes de la instancia de Looker deben poder llegar a los siguientes extremos:

actions.looker.com/
actions.looker.com/actions/<name>/execute
actions.looker.com/actions/<name>/form

en el que name es el nombre programático de la acción.

Solicitudes del navegador del usuario de Looker a la red de Action Hub de Looker

El navegador del usuario de Looker debe poder realizar solicitudes a los siguientes extremos de Looker Action Hub (para OAuth):

actions.looker.com/actions/<name>/oauth

donde name es el nombre programático de la acción.

Solicitudes de la red de Action Hub de Looker a la instancia de Looker

Looker Action Hub debe realizar solicitudes a la instancia de Looker para acciones que admitan resultados transmitidos o que usen OAuth.

Una acción de transmisión permite que la acción consuma consultas que muestran todos los resultados. Las acciones habilitadas para OAuth usan la autenticación por usuario a través de flujos de OAuth 2.0. Las acciones de OAuth deben almacenar las credenciales del usuario en su instancia de Looker de origen, ya que Looker Action Hub es sin estado y multiusuario, y no almacenará credenciales específicas del usuario de ningún tipo.

Las solicitudes del Action Hub de Looker a una instancia de Looker tienen los siguientes formatos:

GET <host_looker_url>/downloads/<random_40_char_token>
POST <host_looker_url>/action_hub_state/<random_40_char_token>

Estas URLs se generan en la instancia de Looker antes de enviarlas al Centro de acciones de Looker. Por este motivo, Looker Action Hub debe poder resolver el <host_looker_url> en una dirección IP y realizar solicitudes en la red en la que reside tu instancia de Looker.

Looker Action Hub tiene direcciones IP de salida estáticas de las que siempre provendrán las solicitudes: 35.153.89.114, 104.196.138.163 y 35.169.42.87. Los administradores de instancias alojadas en Looker que habilitaron la lista de entidades permitidas de IP deben agregar estas direcciones IP para usar cualquier acción que admita resultados transmitidos o que use OAuth.

Consideraciones para las instancias alojadas por el cliente

Para usar las integraciones de Looker, el Centro de acciones de Looker debe poder comunicarse con la instancia de Looker y cumplir con los requisitos del Centro de acciones de Looker. Esto no siempre es posible con las instancias de Looker alojadas por el cliente, por varios motivos. Si no es posible la comunicación bidireccional entre Looker Action Hub y la instancia de Looker, es posible que Looker Action Hub muestre un comportamiento inesperado o no deseado, como consultas suspendidas o acciones no disponibles.

Para abordar el posible problema de que Looker Action Hub no pueda comunicarse con la instancia de Looker, los administradores de Looker pueden implementar una de las soluciones que se muestran más adelante en esta página. La solución o combinación de soluciones adecuada dependerá de la arquitectura de la instancia de Looker:

  • Si Looker Action Hub no puede resolver la instancia alojada por el cliente (es decir, Looker Action Hub no puede recibir solicitudes de la instancia de Looker), los administradores de Looker pueden comunicarse con un especialista de ventas de Google Cloud para habilitar la función de licencia public_host_url. Esa función de la licencia revela la opción de inicio --public-host-url, que permite a los administradores especificar un nombre de host <public_host_url> que se pueda resolver y que sea diferente de la instancia <host_looker_url>. El public_host_url anula el nombre de host de algunas URLs de devolución de llamada de Looker Action Hub específicas y enruta esas URLs de devolución de llamada a través de un proxy inverso que tiene el public_host_url como un nombre que se puede resolver públicamente. Este proxy inverso solo acepta solicitudes de las direcciones IP de salida estáticas de Looker Action Hub. Los administradores de Looker que usan este método deben agregar a la lista de entidades permitidas las direcciones IP de salida desde las que Looker Action Hub realiza solicitudes a la instancia de Looker: 35.153.89.114, 104.196.138.163 y 35.169.42.87.

  • Si la instancia de Looker puede resolver la URL de la instancia alojada por el cliente, pero Looker Action Hub no puede enviar solicitudes a la instancia de Looker, es posible que los usuarios no puedan configurar ni usar acciones que admitan resultados transmitidos o que usen OAuth. Para resolver este problema, los administradores de Looker deben agregar a la lista de entidades permitidas las direcciones IP de salida desde las que Looker Action Hub realiza solicitudes a la instancia de Looker: 35.153.89.114, 104.196.138.163 y 35.169.42.87.

  • Si ninguna de las soluciones mencionadas anteriormente es adecuada para la arquitectura de la instancia de Looker, los administradores de Looker pueden implementar un centro de acciones alojado por el cliente para todas las acciones o solo para las que admiten resultados transmitidos o que usan OAuth.

  • Para implementar un centro de acciones alojado por el cliente, debes asegurarte de que el archivo JAR esté alojado en un servidor público para que el centro de acciones de Looker pueda comunicarse con él. Sin embargo, no se recomienda esta solución.

Además, es posible que las acciones de OAuth y transmisión no se puedan usar en una instancia de Looker alojada por el cliente si esta usa un certificado SSL emitido por una autoridad certificadora (AC) que no se encuentra en esta lista de certificados raíz.

Cómo compilar una acción personalizada

En esta sección, se describen los pasos que debes seguir para escribir y probar una acción personalizada con el código fuente de Looker Action Hub. Para ver ejemplos de código funcional, consulta las acciones existentes en el repositorio de looker-open-source/actions en GitHub.

Para crear una acción personalizada, sigue estos pasos:

  1. Cómo configurar un repositorio de desarrollo
  2. Cómo escribir tu acción
  3. Cómo probar tu acción
  4. Publicar y habilitar tu acción, ya sea en Looker Action Hub o en tu propio servidor privado de Action Hub

Al igual que con cualquier acción, es posible que debas configurar tus modelos de LookML con parámetros específicos para poder usar la acción y publicar tus datos.

Cómo configurar un repositorio de desarrollo

Looker Action Hub es un servidor de Node.js escrito en TypeScript, una pequeña capa sobre JavaScript moderno que agrega información de tipo para ayudar a detectar errores de programación. Si conoces JavaScript, la mayor parte del lenguaje TypeScript debería resultarte familiar.

Para ejecutar Action Hub de Looker, se requiere el siguiente software:

  • Node.js
  • Node Version Manager (NVM: para seleccionar la versión correcta de Node.js)
  • Yarn (para administrar dependencias)

Una vez que hayas instalado el software necesario, estarás listo para configurar tu entorno de desarrollo. En el siguiente ejemplo, se usa Git.

  1. Clona el repositorio looker-open-source/actions de forma local:

    git clone git@github.com:looker-open-source/actions.git

  2. Crea un directorio con el nombre de tu acción en el directorio actions/src/actions. Por ejemplo:

    mkdir actions/src/actions/my_action

  3. Comienza a propagar tu directorio con los archivos que necesitarás para ejecutar la acción. Consulta el repositorio de GitHub de actions para ver una estructura de archivos de ejemplo.

Looker recomienda que también agregues lo siguiente:

  • Un archivo readme para explicar el propósito y los medios de autenticación de tu acción
  • Un ícono PNG para mostrar en el centro de acciones de Looker (o el centro de acciones privado en tu instancia de Looker) y en las ventanas de entrega de datos de Looker
  • Cualquier archivo para las pruebas que quieras ejecutar en el código de tu acción (esto es diferente de probar tu acción)

Cómo escribir una acción

Un requisito de diseño para el servidor de Looker Action Hub es que permanezca completamente sin estado, por lo que no se permite almacenar información en la aplicación o el servicio de acción. Toda la información necesaria para realizar la acción se debe proporcionar en las llamadas de solicitud del archivo de acción.

El contenido exacto del archivo de acción variará según el servicio, el tipo o el nivel en el que opera la acción, y los datos o formatos de visualización que se deban especificar. La acción también se puede configurar para los flujos de autorización de OAuth 2.0.

Los archivos de acción se basan en el método de la API de /execute. A las solicitudes a la API de Looker se les pasa un DataActionRequest cada vez que un usuario ejecuta la acción en Looker. El DataActionRequest contiene todos los datos y metadatos necesarios para ejecutar tu acción. También está disponible un método /form, que se puede usar para recopilar información adicional del usuario antes de que ejecute la acción. Los campos que especifiques en /form aparecerán en la ventana emergente Enviar o Programar cuando los usuarios seleccionen la acción como destino para la entrega de sus datos.

Cuando escribas el archivo de acción, incluye al menos los siguientes parámetros marcados como Obligatorios en la definición de la acción:

Parámetro Obligatorio Descripción Tipo de datos
name Sí Es un nombre único para la acción. Debe ser único en todas las acciones del Centro de acciones de Looker. string
url Sí Es una URL absoluta del extremo /execute para esta acción. string
label Sí Es una etiqueta legible para la acción. string
supportedActionTypes Sí Es una lista de los tipos de acciones que admite la acción. Los valores válidos son "cell", "query" y "dashboard". string
formURL No Es una URL absoluta del extremo /form para esta acción. string
description No Descripción de la acción. string
params No Es un array de parameters para la acción. Incluye el nombre, la etiqueta y la descripción en formato de cadena para cada parámetro. Estos son los campos que aparecen en la página de habilitación de la acción en el panel Administrador. Para administrar la forma en que los usuarios pueden enviar datos a un destino de acción, puedes especificar un atributo de usuario para el que un usuario debe tener un valor definido. parameters
supportedFormats No Es una lista de los formatos de datos que admite la acción. Los valores válidos son "txt", "csv", "inline_json", "json" y "json_detail", "json_detail_lite_stream", "xlsx", "html", "wysiwyg_pdf", "assembled_pdf", and "wysiwyg_png".. string
supportedFormattings No Es una lista de las opciones de formato que admite la acción. Los valores válidos son "formatted" y "unformatted". string
supportedVisualizationFormattings No Es una lista de opciones de formato de visualización que admite la acción. Los valores válidos son "apply" y "noapply". string
iconName No Es un URI de datos que representa una imagen de ícono para la acción. string
requiredFields No Es una lista de descripciones de los campos obligatorios con los que es compatible esta acción. Si hay varias entradas en esta lista, la acción requiere más de un campo. RequiredField
supportedDownloadSettings No Es un valor booleano que determina si se enviará una URL de descarga de un solo uso a la acción para facilitar la transmisión ilimitada de datos. El parámetro usesStreaming, que es un valor booleano true/false, establece el parámetro. Si es usesStreaming = true, entonces es supportedDownloadSettings = url. Si es usesStreaming = false, entonces es supportedDownloadSettings = push. Booleano
usesOAuth No Es un valor booleano que determina si la acción es una acción de OAuth. Esto determinará si se enviará un vínculo de uso único a la acción para poder establecer state para un usuario específico para esta acción. Booleano
usesStreaming No Un valor booleano que determina si la acción admite resultados de consultas transmitidos. Marca la columna Usa transmisión de datos (Sí/No) en la lista de servicios integrados. Es posible que las acciones que transmiten resultados requieran la configuración de un servidor de centro de acciones local. Para obtener más información, consulta la página de prácticas recomendadas Configura un centro de acciones local para acciones que usan OAuth o transmisión. Booleano
minimumSupportedVersion No Es la versión mínima de Looker en la que aparecerá la acción en la lista de Action Hub del panel Administrador. string

Puedes encontrar ejemplos de las acciones de Looker Action Hub en GitHub como referencia.

Tipos de acciones admitidos

Looker admite tres tipos de acciones, como se especifica en el parámetro supportedActionTypes de tu acción: consulta, celda y panel.

  • Una acción a nivel de la consulta: Es una acción que envía una consulta completa. Por ejemplo, la acción de segmentación es una acción a nivel de la consulta.
  • Una acción a nivel de la celda: Una acción a nivel de la celda envía el valor de una sola celda específica en una tabla de datos. Este tipo de acción es diferente de las acciones de datos, que se pueden definir para dimensiones o medidas con el parámetro action. Para enviar información de una celda específica dentro de una tabla, Looker usa etiquetas para asignar acciones a las celdas correspondientes. Las acciones deben especificar qué etiquetas admiten en requiredFields. Para asignar acciones y campos, los campos de LookML deben especificar a qué etiquetas se asignan con el parámetro tags de LookML. Por ejemplo, la acción de mensaje de Twilio usa una etiqueta phone para que los desarrolladores de LookML puedan controlar en qué campos de número de teléfono aparecerá la acción de Twilio.
  • Una acción a nivel del panel: Una acción a nivel del panel admite el envío de una imagen de un panel. Por ejemplo, la acción de SendGrid envía imágenes de paneles por correo electrónico.

Agrega atributos del usuario a las acciones personalizadas

En el caso de las acciones personalizadas, puedes agregar atributos del usuario en el parámetro params de tu archivo de acción. Si el parámetro es obligatorio, cada usuario debe tener un valor para este atributo definido en su cuenta de usuario o en un grupo de usuarios al que pertenezca, además del permiso send_to_integration, para ver la acción como una opción de destino cuando envíe o programe contenido.

Para agregar un atributo de usuario a tu acción, sigue estos pasos:

  1. Es posible que un administrador de Looker deba crear el atributo del usuario que corresponde al user_attribute_param si aún no existe.
  2. Define un valor válido para el atributo de usuario para los usuarios o grupos de usuarios que deben publicar contenido en el destino de tu acción. (Estos usuarios también deben tener permisos send_to_integration).
  3. El parámetro params representa los campos del formulario que un administrador de Looker debe configurar en la página de habilitación de la acción desde la lista Actions en el panel Admin. En el parámetro params de tu archivo de acción, incluye lo siguiente:
  params = [{
    description: "A description of the param.",
    label: "A label for the param.",
    name: "action_param_name",
    user_attribute_name: "user_attribute_name",
    required: true,
    sensitive: true,
  }]

donde user_attribute_name es el atributo de usuario que se define en el campo Nombre de la página Atributos de usuario en la sección Usuarios del panel Administrador, required: true significa que un usuario debe tener un valor no nulo y válido definido para ese atributo de usuario para ver la acción cuando se entregan los datos, y sensitive: true significa que el atributo de usuario está encriptado y nunca se muestra en la IU de Looker una vez que se ingresa. Puedes especificar varios subparámetros de atributos de usuario.

  1. Implementa tus actualizaciones en el servidor de Action Hub.
    • Si agregas una acción nueva, un administrador de Looker deberá habilitarla haciendo clic en el botón Habilitar junto a la acción en la página Acciones del panel Administrador.
    • Si deseas actualizar una acción existente, haz clic en el botón Actualizar para actualizar la lista de acciones. Luego, haz clic en el botón Configuración.
  2. En la página de configuración o habilitación de la acción, un administrador de Looker debe configurar los campos del formulario de la acción para extraer información del atributo del usuario. Para ello, debe hacer clic en el ícono del atributo del usuario a la derecha del campo correspondiente y seleccionar el atributo del usuario deseado.

Parámetros requiredField en acciones a nivel de la celda

En el caso de las acciones a nivel de la celda, puedes configurar los campos de LookML de tu modelo para enviar datos a ese destino de acción. Para ello, especifica qué etiquetas admite tu acción en el parámetro requiredFields de tu archivo de acción.

Parámetro Obligatorio Descripción Tipo de datos
tag No Si está presente, coincide con un campo que tiene esta etiqueta. string
any_tag No Si está presente, reemplaza a tag y coincide con un campo que tenga cualquiera de las etiquetas proporcionadas. string
all_tags No Si está presente, reemplaza tag y coincide con un campo que tiene todas las etiquetas proporcionadas. string

Formatos de datos compatibles

La clase DataActionRequest define qué formato de entrega de datos está disponible para que la acción funcione. En el caso de las acciones a nivel de la consulta, la solicitud contendrá un archivo adjunto que puede estar en varios formatos. La acción puede especificar uno o más supportedFormats o permitir que el usuario elija el formato especificando todos los formatos posibles. Para las acciones a nivel de la celda, el valor de la celda estará presente en DataActionRequest.

Cómo configurar una acción para OAuth

Puedes configurar la acción para que los usuarios puedan autenticarse en ella con OAuth. Aunque Looker Action Hub debe permanecer sin estado, puedes aplicar un estado a través de una solicitud de formulario de la API de Looker Action.

Flujo de OAuth de la acción de Looker

En el caso de las acciones de Looker Action Hub, puedes extender un OAuthAction en lugar de un Hub.Action para establecer un valor booleano que indique qué métodos de OAuth se necesitan para autenticar a un usuario en una acción. Para cada acción habilitada con OAuth o con estado, Looker almacena un estado por usuario y por acción, de modo que cada combinación de acción y usuario tenga un evento de OAuth independiente.

El flujo para crear acciones suele implicar una solicitud /form seguida de una solicitud /execute. En el caso de OAuth, la solicitud /form debe tener un método para determinar si el usuario está autenticado en el servicio de destino. Si el usuario ya está autenticado, la acción debe mostrar un /form normal de acuerdo con lo que requiera la solicitud /execute. Si el usuario no está autenticado, la acción muestra un vínculo que inicializará un flujo de OAuth.

Cómo guardar el estado con la URL de OAuth

Looker enviará una solicitud HTTP POST con un cuerpo vacío al extremo ActionList. Si la acción muestra uses_oauth: true en su definición, se le enviará un state_url de uso único en cada solicitud /form de Looker. state_url es una URL especial de un solo uso que establece el estado de un usuario para una acción determinada.

Si el usuario no está autenticado con el extremo, el /form que se muestra debe contener un form_field de tipo oauth_link que va al extremo /oauth de una acción. El state_url debe encriptarse y guardarse como un parámetro state en el oauth_url que se muestra. Por ejemplo:

{
        "name": "login",
        "type": "oauth_link",
        "label": "Log in",
        "description": "OAuth Link",
        "oauth_url": "ACTIONHUB_URL/actions/my_action/oauth?state=encrypted_state_url"
}

En este ejemplo, el extremo /oauth redirecciona al usuario al servidor de autenticación. El extremo /oauth construye el redireccionamiento en el método oauthUrl(...) en una acción de OAuth, como se muestra en Dropbox OauthUrl.

El parámetro state que contiene ese state_url encriptado se debe pasar al centro de acciones de Looker.

Cómo guardar el estado con el URI de redireccionamiento del centro de acciones

En el extremo /oauth, también se crea un redirect_uri para el centro de acciones y se pasa al método oauthUrl(...) de la acción. Este redirect_uri tiene el formato /actions/src/actions/my_maction/oauth_redirect y es el extremo que se usa si la autenticación muestra un resultado.

Este extremo llamará al método oauthFetchInfo(...), que debe implementar el método OauthAction para extraer la información necesaria y tratar de recibir o guardar cualquier estado o auth que se reciba del servidor de autenticación.

El state desencripta el state_url encriptado y lo usa para enviar state a POST a Looker. La próxima vez que un usuario realice una solicitud a esa acción, el estado recién guardado se enviará al Centro de acciones de Looker.

Agrega tus archivos de acción al repositorio de Action Hub de Looker

Una vez que se escriba el archivo de acción, en el repositorio de Looker Action Hub, haz lo siguiente:

  1. Agrega el archivo de acción (por ejemplo, my_action.ts) a actions/src/actions/index.ts.

    import "./my_action/my_action.ts"

  2. Agrega cualquier requisito de paquete de Node.js que hayas utilizado para escribir la acción. Por ejemplo:

    yarn add aws-sdk
yarn add express

  3. Instala las dependencias de Node.js del servidor de Looker Action Hub.

    yarn install

  4. Ejecuta las pruebas que hayas escrito.

yarn test

Cómo probar una acción

Para realizar pruebas completas, puedes alojar un servidor privado de Action Hub y probar tu acción en tu instancia de Looker. Este servidor debe estar en la Internet pública con un certificado SSL válido y debe poder iniciar y recibir conexiones o solicitudes HTTPS desde y hacia Looker. Para ello, puedes usar una plataforma basada en la nube, como Heroku, como se muestra en el siguiente ejemplo. Como alternativa, puedes usar cualquier plataforma que cumpla con los requisitos mencionados anteriormente.

Cómo configurar un servidor de centro de acciones local

En este ejemplo, realizaremos la acción que desarrollamos en el repositorio de GitHub de looker-open-source/actions/src/actions y confirmaremos el código en una nueva rama de Git. Te recomendamos que trabajes en las funciones con ramas para que puedas hacer un seguimiento de tu código fácilmente y, si lo deseas, crear una solicitud de cambios con Looker.

  1. Para comenzar, crea tu rama y, luego, envía y confirma tu trabajo. Por ejemplo:

    git checkout -b my-branch-name
git add file-names
git commit -m commit-message

  2. En este ejemplo, para enviar una rama a Heroku, configura tu repositorio de Git con Heroku como una opción remota en la línea de comandos:

    heroku login
heroku create
git push heroku

  3. Heroku mostrará la URL pública que ahora aloja el centro de acciones para que la uses. Visita la URL o ejecuta heroku logs para confirmar que el centro de acciones se esté ejecutando. Si olvidas la URL pública, puedes ejecutar el siguiente comando en la línea de comandos:

    heroku info -s | grep web_url

    Heroku mostrará tu URL pública. Por ejemplo: https://my-heroku-action-server-1234.herokuapp.com

  4. En la línea de comandos, establece la URL base de tu centro de acciones:

    heroku config:set ACTION_HUB_BASE_URL="https://my-heroku-action-server-1234.herokuapp.com"

  5. Establece la etiqueta de tu centro de acciones:

    heroku config:set ACTION_HUB_LABEL="Your Action Hub"

  6. Looker usa un token de autorización para conectarse al centro de acciones. Genera el token en la línea de comandos:

    heroku run yarn generate-api-key

    Si no usas Heroku, como en este ejemplo, usa lo siguiente:

    yarn generate-api-key

    Heroku mostrará tu token de autorización. Por ejemplo: Authorization: Token token="abcdefg123456789"

  7. Configura el secreto de tu centro de acciones con la clave secreta:

    heroku config:set ACTION_HUB_SECRET="abcdefg123456789"

    Es posible que las implementaciones alojadas por el cliente requieran la configuración de variables de entorno adicionales que no se documentan aquí.

  8. Para agregar tu acción a la instancia local de Looker, ve a Administrador > Acciones.

    • En la parte inferior de la lista de acciones, haz clic en Agregar Action Hub.
    • Ingresa la URL de Action Hub y, de forma opcional, una clave secreta.
    • Busca tu acción en la lista Acciones del menú Administrador de Looker.
    • Haz clic en Habilitar.

Si tu acción requiere que se pasen tipos específicos de datos desde Looker, asegúrate de configurar los modelos para que incluyan el parámetro tags adecuado.

Ya está todo listo para probar tu acción.

Prueba acciones a nivel del panel y de la consulta

En tu instancia de Looker, configura tu modelo de LookML con etiquetas, si es necesario. Crea y guarda un aspecto. En el aspecto guardado, haz clic en el menú de la esquina superior derecha y selecciona Enviar con tu acción como destino. Si tienes un formulario para la publicación, Looker lo renderizará en la ventana Enviados.

Haz clic en Enviar prueba para enviar los datos. El estado de la acción aparecerá en el Historial del programador en el panel Administrador. Si tu acción encuentra un error, se mostrará en el panel Administrador y Looker enviará un correo electrónico con el mensaje de error al usuario que envió la acción.

Cómo probar acciones a nivel de la celda

Configura un campo de LookML con las etiquetas adecuadas para tu acción. En tu instancia de Looker, ejecuta una consulta que incluya ese campo. Busca el campo en la tabla de datos. Haz clic en … en la celda y selecciona Enviar en el menú desplegable. Si recibes errores, deberás realizar una actualización completa de la tabla de datos después de corregirlos.

Publica y habilita una acción personalizada

Existen dos opciones de publicación para las acciones personalizadas:

Una vez que se publique la acción, podrás habilitarla en la página Acciones del panel Administrador.

Publicación en el Action Hub de Looker

Este enfoque es el más sencillo y funciona para cualquier acción que quieras poner a disposición de cualquier persona que use Looker.

Después de probar la acción, puedes enviar una solicitud de cambios al repositorio de looker-open-source/actions en GitHub.

  1. Ingresa el siguiente comando:

    git push <your fork> <your development branch>

  2. Crea tu solicitud de extracción con el repositorio de looker-open-source/actions como destino.

  3. Completa el formulario de envío de Looker Marketplace y Action Hub. Para obtener más información sobre los requisitos del formulario, consulta Cómo enviar contenido al mercado de Looker.

    Looker revisará tu código de acción. Nos reservamos el derecho de rechazar tu comunicado de prensa, pero podemos ayudarte con cualquier problema que tengas y ofrecerte sugerencias para mejorar. Luego, combinamos el código en el repositorio de looker-open-source/actions y lo implementamos en actions.looker.com. Una vez que se implemente el código, estará disponible para todos los clientes de Looker.

  4. Habilita la acción en tu instancia de Looker para que aparezca como una opción de publicación de datos.

Publicación en un servidor de Action Hub privado

Si tienes acciones personalizadas que son privadas para tu empresa o caso de uso, no debes agregarlas al repositorio de looker-open-source/actions. En su lugar, crea un centro de acciones privado con el mismo framework de Node.js que usaste para probar tu acción.

Puedes configurar tu servidor interno de Action Hub en tu propia infraestructura o con una plataforma de aplicaciones basada en la nube (en nuestro ejemplo, usamos Heroku). No olvides bifurcar Looker Action Hub a tu servidor privado de Action Hub antes de la implementación.

Cómo configurar un modelo de LookML para usarlo con una acción

En el caso de las acciones personalizadas y las acciones disponibles en el Centro de acciones de Looker, debes identificar los campos de datos relevantes con el parámetro tags en tu modelo de LookML. En la página Acciones del panel Administrador, se proporcionará información sobre las etiquetas que se requieren para el servicio, si las hay.

Por ejemplo, una integración de Twilio Send Message envía un mensaje a una lista de números de teléfono. En la página Actions del panel Admin, la integración muestra el texto secundario "Action can be used with queries that have a field tagged phone".

Esto significa que el servicio Twilio Send Message requiere una consulta que incluya un campo de número de teléfono y que use el parámetro tags para identificar qué campo de la consulta contiene números de teléfono. Para identificar un campo de número de teléfono en LookML, especifica tags: ["phone"] para ese campo. Tu código LookML para un campo de número de teléfono podría verse de la siguiente manera:

dimension: phone {
  tags: ["phone"]
  type: string
  sql: ${TABLE}.phone ;;
}

Una integración que no requiera etiquetas mostrará el texto secundario "La acción se puede usar con cualquier consulta" en la página Acciones del panel Administrador.

Asegúrate de identificar los campos obligatorios en tu modelo de LookML con el parámetro tags para que los usuarios puedan usar el servicio para enviar datos.

¿Qué sigue?

Obtén información para publicar el contenido de una vista o una exploración o de un panel en un servicio integrado.