Centro de soporte de Workiva

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

Nota: Aunque se denomina «Solicitud HTTP», se admite (y se recomienda) el uso de HTTPS (HTTP seguro).

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. Accede a Chain Builder y busca las hojas de cálculo «Chain CLP | Lista de solicitudes HTTP ».
2. Haz clic en la elipse vertical para copiar 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 esquina superior derecha y cambia el nombre de la cadena a: CLP | Solicitud HTTP para obtener una única hoja de cálculo .
5. ( Opcional ) Introduce una descripción : «Esta cadena genera un nuevo token 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. Salva la cadena.

Etapa 2: Entradas en tiempo de ejecución

Utiliza el evento «Runtime Inputs Chain » 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. Mueve el comando «POST - Obtener un token» fuera del nodo de inicio.
2. Añade un evento «Cadena de entradas en tiempo de ejecución » de la sección «Eventos desencadenantes de cadenas » al nodo de inicio.
3. Haz doble clic en el enlace que une «Runtime Inputs» con el comando «Get - List Spreadsheets » y elimina el enlace.
4. Conecta las entradas de tiempo de ejecución al comando «POST: Recuperar un token ».

5. Conecta el comando POST «Recuperar un token» con el comando GET «Mostrar lista de hojas de cálculo ».

   

6. Haz doble clic en el evento «Cadena de entradas de tiempo de ejecución » para configurarlo.
7. Haz clic en «Añadir entrada » y configura los siguientes campos:
   • Tipo: Campo de texto
   • Nombre para mostrar: ID de la hoja de cálculo. Consulta este documento si necesitas ayuda para encontrar el ID.
   • Obligatorio: Marca esta casilla de selección
8. ( Opcional ) Introduce una descripción : «Este comando permite al usuario especificar los valores de los parámetros de ejecución necesarios».
9. Guarda 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. Nombre del comando: Get - Recuperar una sola hoja de cálculo .

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

      

      1. En el panel de la izquierda, despliega el menú desplegable «Trigger ».
      2. Despliega el menú desplegable «Entradas de tiempo de ejecución ».
      3. Selecciona la variable «ID de la hoja de cálculo ».

2. ( Opcional ) Introduce una descripción : «Este comando devuelve una única hoja de cálculo». Para obtener más información, consulta la documentación para desarrolladores en https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html"
3. Guarda el comando.

Etapa 4: Evalúa el Ejercicio

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

1. Publicar la cadena.
2. Haz clic en «Ejecutar » y, a continuación, en «Ejecutar con datos de entrada ».
3. Encuentra un ID de hoja de cálculo, accediendo 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 «Inicio ».
5. Una vez que la cadena haya finalizado su ejecución, podrás ver que los datos de la hoja de cálculo se han generado en la pestaña «Resultados» , en el «Cuerpo de la respuesta» del comando GET .