Centro de soporte de Workiva

¿Quieres conectarte a una aplicación de terceros más allá de los Conectores premium prediseñados de Workiva? Puedes conseguirlo utilizando los comandos del conector de solicitudes HTTP para interactuar con las API REST. 

Nota: Aunque está etiquetada como Solicitud HTTP, se admite HTTPS (HTTP seguro) (y es recomendable).

En esta Ruta de aprendizaje conectada, actualizaremos nuestra Cadena para que utilice Entradas de tiempo de ejecución en las que podemos especificar qué hoja de cálculo queremos recuperar.

Paso 1: Copiar y Modificar una Cadena

1. Navega hasta el Generador de cadenas y localiza la Cadena CLP | HTTP Request List Hojas de cálculo.
2. Haz clic en la elipse vertical para Copiar a la cadena.
3. Haz clic en el icono del lápiz para editar la Cadena.
4. Haz clic en Configuración de la Cadena en la parte superior derecha, y cambia el nombre de la Cadena: CLP | Solicitud HTTP Obtener una única Hoja de cálculo.
5. (Opcional) Introduce una Descripción: "Esta cadena genera un nuevo Identificador de Acceso a la API de Workiva. Debes proporcionar un Id. de cliente y un Secreto de cliente válidos de una Concesión de API generada previamente en los valores de las variables que aparecen a continuación. Cuando se ejecute la Cadena, pedirá al usuario que introduzca un ID de Hoja de cálculo.  La Cadena recuperará la Hoja de cálculo".
6. Guarda la Cadena.

Etapa 2: Entradas en tiempo de ejecución

Utiliza el Evento de la Cadena de Entradas en Tiempo de Ejecución para iniciar la Cadena.
Esto nos permite especificar el ID de la Hoja de cálculo que queremos obtener. Leer más sobre Entradas en Tiempo de Ejecución.

1. Desplaza el comando POST - Recuperar un Token del Nodo de Inicio.
2. Añadir un Entradas en tiempo de ejecución Evento en cadena de Eventos de activación de cadena al Nodo de Inicio.
3. Haz clic dos veces en el enlace que une Entradas de tiempo de ejecución con el comando Obtener - Listar hojas de cálculo y elimina el enlace.
4. Conecta Entradas en tiempo de ejecución al comando POST - Recuperar un token.

5. Conecta el comando POST - Recuperar un token al comando GET - Hojas de cálculo de la lista.

   

6. Haz doble clic en Entradas en tiempo de ejecución Evento en cadena para configurarlo.
7. Haz clic en Añadir Entrada y configura los siguientes campos:
   • Tipo de: Campo de texto
   • Nombre para mostrar: ID de la Hoja de cálculo - consulta este documento para obtener ayuda para encontrar el ID
   • Obligatorio: Marca esta casilla de verificación
8. (Opcional) Introduce una Descripción: "Este comando permite al usuario especificar valores de entradas de tiempo de ejecución requeridas."
9. Guardando el comando.

Paso 3: Actualizar el comando Obtener .

Actualizaremos el Comando Obtener Solicitud HTTP para que nos dé los detalles sobre una sola Hoja de Cálculo en lugar de listar todas las Hojas de Cálculo del Espacio de Trabajo.

1. Haz doble clic en el comando Obtener - Lista de Hojas de Cálculo para configurarlo.
   1. Ponle Nombre al Comando: Obtener - Recuperar una única Hoja de cálculo.

   2. Utiliza la variable ID de hoja de cálculo de las Entradas en tiempo de ejecución dentro del campo URL para especificar qué hoja de cálculo recuperar.
      Para ello, haz clic en el campo URL, y después de /hojas de cálculo añade "/<>",
      sustituyendo <Spreadsheet> por la Variable de Entradas en tiempo de ejecución como se indica a continuación:

      

      1. En el panel izquierdo, despliega la lista desplegable Activador.
      2. Despliega el menú desplegable Entradas en tiempo de ejecución.
      3. Selecciona la variable ID Hoja de cálculo.

2. (Opcional) Introduce una Descripción: "Este comando devuelve una única Hoja de cálculo. Para más información, consulta la documentación para desarrolladores en https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/"
3. Guarda el comando.

Etapa 4: Evalúa el Ejercicio

Ahora que la Cadena está completa, podemos Evaluar el resultado.

1. Publica en la Cadena.
2. Haz clic en Ejecutar, y luego en Ejecutar con Entradas.
3. Busca un ID de Hoja de cálculo , navegando a una Hoja de cálculo en la Plataforma Workiva.  Asegúrate de que el usuario concedente tiene permiso para esta hoja de cálculo.
4. Haz clic en Iniciar.
5. Una vez que la Cadena ha completado su ejecución, puedes ver que los detalles de la hoja de cálculo se han generado dentro de la pestaña Salidas - Cuerpo de respuesta del comando Obtener.

To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).