Centro de soporte de Workiva

¿Quieres conectarte a una aplicación de terceros más allá de los Conectores premium predefinidos de Workiva? Puedes conseguirlo aprovechando los Comandos del Conector de Solicitudes HTTP para interactuar con las API REST. En esta Ruta de aprendizaje conectada, actualizaremos nuestra Cadena para utilizar el Token de portador en un Comando que utiliza el punto final de la lista Hojas de cálculo para darnos una lista de Hojas de cálculo dentro del Espacio de trabajo.

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

Paso 1: Crear las Variables del Espacio de Trabajo

Para utilizar los detalles de la API Workiva en varias Cadenas y Comandos, crearemos Variables del Espacio de Trabajo para almacenar esa información. Crearemos una nueva Variable de espacio de trabajo para la URL de la API de la Plataforma.

1. Desde Generador de cadenas, navega a Configuración del espacio de trabajo.
2. En Variables del Espacio de Trabajo, haz clic en el signo más para crear una nueva Variable del Espacio de Trabajo.

3. Configura las variables utilizando la siguiente información:

   • Nombre: wsv-BaseURL-Plataforma
   • Valor: En función de tu región, utiliza el valor adecuado. Puedes verificar la región comprobando la URL; si la URL contiene UE o APAC, utiliza la URL correspondiente. Para , utiliza el valor US.

   Nota: La región de EE.UU. solo contiene "aplicación".

   • Región de EE. UU.
   • Región de la UE
   • Región APAC

   Campo	Valor US
   URL base IAM	https://api.app.wdesk.com/platform/v1

   Campo	Valor UE
   URL base IAM	https://api.eu.wdesk.com/platform/v1

   Campo	Valor APAC
   URL base IAM	https://api.apac.wdesk.com/platform/v1

4. Guardar Configuración del espacio de trabajo.

Nota: Deberías ver estas cuatro variables en la Configuración del espacio de trabajo.  Si no es así, vuelve a consultar Requisitos previos indicados anteriormente.

Paso 2: Copiar y Modificar una Cadena

1. Navega hasta el Generador de cadenas y localiza la cadena denominada CLP | Generar un token.
2. Haz clic en la elipse vertical de la derecha y selecciona Copiar a.
3. Una vez creada la copia de la cadena, 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.
5. Cambia nombre de la Cadena: CLP | Lista de Solicitudes HTTP Hojas de cálculo.
6. (Opcional) Introduce una Descripción: "Esta Cadena genera un nuevo Token de Acceso a la API 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. A continuación, obtiene una lista de todas las Hojas de cálculo del Espacio de trabajo. Tu Espacio de trabajo debe tener al menos una o más Hojas de cálculo".
7. Guarda la cadena.

Paso 3: Enumerar Hojas de cálculo.

Para obtener una lista de nuestras Hojas de cálculo, esta cadena utiliza un comando GET del Conector de solicitud HTTP.

4. Añade un comando Obtener desde el conector Solicitud HTTP al lienzo Cadena.
5. Conecta el comando Post - Retrieve a Token al comando Get.
6. Haz clic dos veces en el Comando para configurarlo.
   1. Cambiar nombre del comando: Obtener - Lista de Hojas de Cálculo
   2. Haz clic en el Comando y luego en el icono de lápiz asociado para editar el Comando.
   3. Marca la casilla Mostrar respuesta.
   4. Haz clic en URL y, a continuación, haz clic en Espacio de trabajo en el panel "Seleccionar una variable", y selecciona la variable que creaste en el Paso 1 (wsv-BaseURL-Platform).
   5. Añade /hojas de cálculo después de la variable.  
      
      
      A continuación, le diremos al endpoint cómo ejecutarse, especificando Encabezados en el formulario Obtener. 
      Estos Encabezados pasarán el Token de portador a la API para mostrar que tenemos acceso a obtener una lista de hojas de cálculo.
   6. Haz clic en el botón gris más (+) situado junto a la sección Encabezado dos veces y rellena cada campo con los valores que aparecen a continuación, prestando especial atención a las mayúsculas y minúsculas y al espacio después de "Portador".
      • Campo Encabezado 1:
        • Tecla: Aceptar
        • Valor: application/json
      • Campo Encabezado 2:
        • Tecla: Autorización

        • Valor: Portador <Post>
          Reemplazar <Post> por el resultado desde el comando POST - Recuperar un token.

          

          1. Dentro del panel Seleccionar una variable, haz clic en la flecha hacia abajo Tiempo de ejecución para expandir POST - Recuperar un token .
          2. Haz clic en la flecha hacia abajo junto a Respuesta para expandir las opciones de variables.
          3. Selecciona Access_token.

7. Rellena Tipo de contenido con: application/json.

   

8. Rellena la Respuesta con la Carga útil de ejemplo que aparece a continuación. Por hacer esto, estamos proporcionando un formato a la salida del comando, haciendo que cada variable devuelta sea más fácil de utilizar.

   { "datos": [ { "creado": { "fechaHora": "2018-10-21T15:03:27Z" }, "nombre": "Revisión de final de año", "id": "124efa2a142f472ba1ceab34ed18915f", "modificado": { "dateTime": "2018-10-21T15:03:27Z" }, "template": false }, { "created": { "dateTime": "2020-02-20T15:03:27Z" }, "name": "Revisión Q1", "id": "164cfb2b132c4623a2cfaa31ef13925a", "modified": { "dateTime": "2020-03-29T13:15:27Z" }, "template": false } ], "@nextLink": "<opaque_url>" }

9. (Opcional) Introduce una Descripción: "Este comando devuelve una página de una lista de Hojas de cálculo. Para más información, consulta la documentación para desarrolladores en https://developers.workiva.com/platform-v1/platform-getspreadsheets/".

   ¡Consejo! Para determinar cómo rellenar los campos Encabezado y Respuesta, consulta la documentación para desarrolladores del punto final de la API al que te estás conectando, en este caso estamos utilizando el punto final "Obtener Hojas de Cálculo".

10. Guarda el comando.

Etapa 4: Evaluar el Ejercicio

Ahora que la Cadena está completa, evalúa el resultado.

1. Publica en la Cadena.
2. Haz clic en Ejecutar y luego en Ejecutar cadena.
3. Una vez que la Cadena haya completado su ejecución, deberías ver una lista de hojas de cálculo en la pestaña Resultados - Cuerpo de la respuesta del comando Obtener.

Para seguir poniéndote a prueba y aprender más cosas sobre cómo utilizar el Conector de Solicitudes HTTP para conectarte a una API de terceros, consulta el siguiente ejercicio: CLP - Solicitud HTTP para obtener una Hoja de cálculo.