Llamar al servicio web REST desde un flujo de trabajo |
Scroll |
¿Cómo llamar al servicio web REST desde un flujo de trabajo?
1. En este ejemplo utilizaremos la función llamada REST para publicar nuevos detalles de Therefore™ en el servicio web. Empiece el proceso creando una función de llamada REST en un flujo de trabajo.
2. Establezca el tipo de solicitud (GET, POST, PUT, DELETE o PATCH según la instrucción). En este ejemplo utilizaremos el tipo POST.
•En el campo de URL de recurso, puede utilizar macros para crear más flexibilidad en el envÃo y la recepción de información al servicio web. •Es necesario establecer parámetros como parte de la llamada REST. Pueden definirse en la pestaña Parámetros del cuadro de diálogo anterior. |
3. Complete los detalles necesarios en la pestaña Autorización para autorizar la aplicación en el sistema externo. En este ejemplo utilizamos OAuth (Authorization Code).
4. A continuación, defina encabezados adicionales que sean necesarios desde la llamada en la pestaña Encabezado. Haga clic en el botón Añadir... para definir encabezados adicionales. En este ejemplo solo requerimos un encabezado 'Aceptar', en el que pedimos al servicio web que queremos que se devuelva un json en lugar de un xml.
5. En la sección Cuerpo es necesario definir una estructura en la que se basará el nuevo documento. En este ejemplo se pueden rellenar los campos del documento con valores de datos de Ãndice.
6. En la sección Códigos de estado, defina los códigos que indican un resultado correcto. Si la llamada proporciona un resultado correcto, la instancia de flujo de trabajo se puede enrutar a la siguiente tarea.
7. A continuación, defina la información de Control de respuestas para establecer cómo se actualiza la información actual en función de la respuesta de la llamada REST. En este ejemplo, el "Bill Id" del documento recién creado se incluirá en los datos de Ãndice de Thereforeâ„¢ (en InvoiceId e Invoice No).
Antes de procesar un flujo de trabajo, haga clic en el botón Probar para comprobar si la función de llamada REST puede comunicarse con la API del servicio web para las acciones definidas. |
8. Cuando termine de incluir toda la información necesaria, haga clic en Aceptar. En este momento podrá iniciar la instancia de flujo de trabajo propiamente dicha.
Las llamadas REST se han diseñado para realizar llamadas salientes a aplicación de terceros. Si bien es posible utilizar llamadas REST para llamar a la API de Therefore, para atender requisitos avanzados, la función está limitada en particular cuando se trabaja con información de datos de Ãndice. |