Creación de acciones de datos HTTP

Puede utilizar una acción de datos de API HTTP en un libro de trabajo de modo que cuando seleccione una columna, esta envíe el valor a una API de REST que devuelve una respuesta.

Debe configurar el dominio al que intenta conectarse como un dominio seguro antes de crear una acción de datos de API HTTP. Consulte Registro de dominios seguros.

  1. En la página de inicio, pase el cursor por encima de un libro de trabajo, haga clic en Acciones y, a continuación, seleccione Abrir.
  2. Haga clic en el menú del libro de trabajo y, a continuación, seleccione Acciones de datos.
  3. Haga clic en Agregar acción e introduzca un nombre para la nueva acción de datos de la API de HTTP. Por ejemplo, HTTP API Example.
  4. Haga clic en el campo Tipo y seleccione API de HTTP.
  5. Haga clic en el campo Anclar a y seleccione las columnas en las que desea aplicar la acción de datos de API de HTTP. No seleccione columnas de medida o columnas ocultas. Si no especifica un valor en el campo Anclar a, la acción de datos se aplicará a todos los elementos de datos en las visualizaciones.
  6. En la lista del método HTTP , seleccione un método.
  7. Introduzca la URL de API de REST que empiece por http o https y que, opcionalmente, incluya tokens de sustitución.
  8. Si ha seleccionado el método POST:
    • Al seleccionar el valor Datos de formulario de Tipo de carga útil, introduzca cada parámetro en una línea diferente.
    • Al seleccionar el valor Datos no procesados de Tipo de carga útil, introduzca los datos no procesados.
  9. Introduzca una cabecera HTTP personalizada si desea agregar o sustituir la cabecera HTTP para que se adapte a la API con la que trabaja.
  10. Haga clic en Soporta la selección múltiple para definir el valor.
    • Activado: la acción de datos se puede llamar cuando se seleccionen uno o varios puntos de datos.
    • Desactivado: la acción de datos solo se puede llamar cuando se seleccione un solo punto de datos.

      Esta opción es especialmente útil cuando la selección de varios puntos de datos pueda producir un error (por ejemplo, con algunas API de terceros).

  11. Haga clic en Aceptar para guardar.
  12. Haga clic en un punto de datos de la visualización.

    Por ejemplo, podría seleccionar "Books" en una columna Category de token para mostrar una API de REST concreta.

  13. Haga clic con el botón derecho y seleccione Ejemplo de API de HTTP para mostrar el resultado.

    Los puntos de datos seleccionados determinan qué valores se transfieren a los tokens de URL.

    Se muestra un mensaje de ejecución correcta o de error que confirma si la API de REST se ha llamado correctamente utilizando el valor seleccionado.