Saltar al contenido

Actividad Coupa Update en Jitterbit Studio

Introducción

Una actividad Update de Coupa, usando su conexión Coupa, actualiza datos de objetos en Coupa y está diseñada para usarse como destino para consumir datos en una operación.

Nota

Debido a una limitación presente en la API de Coupa Core Platform, la actividad Update de Coupa no puede realizar actualizaciones para el objeto Approval. Cuando se utiliza este objeto en una operación, se produce un error durante la ejecución.

Crear una actividad Coupa Update

Se crea una instancia de una actividad Update de Coupa desde una conexión Coupa usando su tipo de actividad Update.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Update de Coupa existente desde estas ubicaciones:

Configurar una actividad Coupa Update

Sigue estos pasos para configurar una actividad Update de Coupa:

Paso 1: Ingresa un nombre y selecciona un objeto

En este paso, proporciona un nombre para la actividad y selecciona un objeto. A continuación se describe cada elemento de la interfaz de usuario de este paso.

  • Menú Endpoint: Si tienes múltiples endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

    • Editar endpoint: Aparece cuando pasas el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado actualmente.

  • Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad Update de Coupa y no debe contener barras / ni dos puntos :.

  • Selecciona un objeto: Esta sección muestra los objetos disponibles en el endpoint de Coupa.

    • Objeto seleccionado: Después de seleccionar un objeto, se lista aquí.

    • Búsqueda: Ingresa el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de objetos. La búsqueda no distingue mayúsculas de minúsculas. Si ya se muestran objetos dentro de la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar objetos desde el endpoint al buscar, ingresa los criterios de búsqueda y luego actualiza, como se describe a continuación.

    • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para recargar objetos desde el endpoint de Coupa. Esto puede ser útil si se han agregado objetos a Coupa. Esta acción actualiza todos los metadatos utilizados para construir la tabla de objetos mostrada en la configuración.

    • Seleccionar un objeto: Dentro de la tabla, haz clic en cualquier parte de una fila para seleccionar un objeto. Solo se puede seleccionar un objeto. La información disponible para cada objeto se obtiene del endpoint de Coupa:

  • Nombre: El nombre del objeto en Coupa.

  • Descripción: La descripción del objeto en Coupa.

Sugerencia

Si la tabla no se completa con los objetos disponibles, es posible que la conexión con Coupa no haya sido exitosa. Asegúrate de estar conectado reabriendo la conexión y volviendo a probar las credenciales.

  • Continuar en caso de error: Selecciona esta opción para continuar la ejecución de la actividad si se encuentra un error en un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para guardar temporalmente la configuración de este paso y continuar al siguiente. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Seleccionar un subobjeto

En este paso, selecciona un subobjeto. A continuación se describe cada elemento de la interfaz de usuario de este paso.

  • Seleccionar un objeto: Esta sección muestra los subobjetos disponibles en el punto de conexión de Coupa.

    • Objeto seleccionado: El objeto seleccionado en el paso anterior se enumera aquí.

    • Subobjeto seleccionado: Después de seleccionar un subobjeto, se enumera aquí.

    • Búsqueda: Introduce el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de subobjetos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los subobjetos ya se muestran en la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar subobjetos desde el punto de conexión durante la búsqueda, introduce los criterios de búsqueda y luego actualiza, tal como se describe a continuación.

    • Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para recargar subobjetos desde el punto de conexión de Coupa. Esto puede ser útil si se han añadido objetos a Coupa. Esta acción actualiza todos los metadatos utilizados para crear la tabla de subobjetos que se muestra en la configuración.

    • Seleccionar un subobjeto: En la tabla, haz clic en cualquier lugar de una fila para seleccionar un subobjeto. Solo se puede seleccionar un subobjeto. La información disponible para cada subobjeto se obtiene del punto de conexión de Coupa:

      • Nombre: El nombre del subobjeto en Coupa.

      • Tipo: El tipo del subobjeto en Coupa.

      • Descripción: La descripción del subobjeto en Coupa.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional:

    • Habilitar campos de solo lectura: Selecciona esta opción para exponer campos de solo lectura en Coupa. Si habilitas esta opción, los esquemas de datos serán muy grandes.

    • Mostrar todos los campos: Selecciona esta opción para incluir los campos de los nodos created-by y updated-by en el esquema de respuesta. Por defecto, estos nodos se generan sin sus campos. Si habilitas esta opción, los esquemas de datos serán muy grandes.

  • Atrás: Haz clic para guardar temporalmente la configuración de este paso y volver al paso anterior.

  • Siguiente: Haz clic para guardar temporalmente la configuración de este paso y continuar al siguiente. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 3: Revisar los esquemas de datos

Se muestran los esquemas de solicitud o respuesta generados desde el punto de conexión. A continuación se describe cada elemento de la interfaz de usuario de este paso.

Nota

Debido a una limitación presente en la API de Coupa Core Platform, la actividad Update (Actualizar) de Coupa no puede realizar actualizaciones para el objeto Approval (Aprobación). Cuando se utiliza este objeto en una operación, ocurre un error en tiempo de ejecución.

  • Edit (Editar): Haz clic en el icono de edición encima de cada esquema de datos para entrar en el modo de edición de ese esquema. El editor permite agregar, eliminar y reorganizar nodos y campos, así como cambiar sus tipos de datos. Todas las ocurrencias de nodos y campos se establecen con una cardinalidad de [0, 1]. Los cambios realizados en los esquemas de datos deben ser aceptables para el endpoint y solo se deben hacer después de consultar la documentación disponible del endpoint. Después de editar los esquemas, se muestra una fecha de última edición en la parte superior del esquema correspondiente para indicar que el esquema ha tenido ediciones manuales. Actualizar los esquemas los restablecerá a sus estructuras predeterminadas.

  • Refresh (Actualizar): Haz clic en el icono de actualización o en la palabra Refresh para regenerar esquemas desde el endpoint de Coupa. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Back (Atrás): Haz clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Finished (Finalizado): Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Discard Changes (Descartar cambios): Después de hacer cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te solicita que confirmes que deseas descartar los cambios.

Pasos siguientes

Después de configurar una actividad Update (Actualizar) de Coupa, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentren en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Las acciones de menú de una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para más detalles, consulta Menú de acciones de actividades en Conceptos básicos de conectores.

Las actividades Update (Actualizar) de Coupa se pueden usar como destino con estos patrones de operación:

Para usar la actividad con funciones de secuencias de comandos, escribe los datos en una ubicación temporal y luego usa esa ubicación temporal en la función de secuencias de comandos.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento consultando los registros de operación.