Crear una Operación de Entidad API¶

Introducción¶

Esta página describe cómo crear una operación de entidad API. La Entidad Jitterbit y la operación de entidad de API se utilizan para crear una API de Servicio OData. Cuando se complete la operación de la entidad API, la operación se asignará a una API de Servicio OData.

Creación de una Operación de Entidad API¶

1. Abra su proyecto en la aplicación Design Studio. La pantalla de inicio debe mostrar:

   

   • El panel en el lado izquierdo de Design Studio enumera los elementos del proyecto que utilizará para crear su integración, como Operaciones, Transformaciones, Secuencias de Comandos, etc. Desplácese hacia abajo en el panel hasta Operaciones.
   • Haga clic derecho en Operaciones y seleccione Nueva operación del menú desplegable.

2. La ventana emergente Seleccionar tipo muestra la lista de tipos de operación disponibles en Design Studio. Seleccione Operación de entidad API de la lista de opciones y luego haga clic en Continuar:

   

3. La ventana emergente del Asistente de entidad debería mostrarse similar a la imagen que se muestra a continuación. Una Entidad define los datos disponibles para un Servicio OData y consta de un extremo, una selección de objetos y una selección de campos específicos. Cualquier entidad existente disponible dentro del proyecto aparece debajo de la carpeta Entidades de Jitterbit:

   

   • Crear nueva entidad Jitterbit: Seleccione esta opción si una entidad no está disponible en el proyecto y no aparece en el Asistente de entidades como se muestra arriba. El Asistente de entidades luego lo guía a través de la creación de la entidad, la selección de tablas u objetos y la selección de campos. Siga las instrucciones descritas en Creación de una entidad Jitterbit a medida que continúa en el Asistente de entidades.
   • Utilice una Entidad Jitterbit existente en el proyecto: Puede crear la entidad antes de crear su operación siguiendo las instrucciones en Crear una Entidad Jitterbit. Las entidades existentes disponibles dentro de su proyecto se enumeran debajo de la carpeta Entidades de Jitterbit en la sección superior derecha de Entidad Asistente como se muestra arriba. Al hacer clic en una entidad existente en la lista de entidades disponibles, se selecciona automáticamente Usar una entidad Jitterbit existente en el proyecto.

   • Para este ejemplo, se selecciona la entidad Clientes. Haga clic en Siguiente en la parte inferior de la pantalla para continuar:

     

4. Aparecerá la pantalla Transformaciones:

   

   1. Transformaciones de transferencia:

      • Jitterbit crea una operación de transferencia de forma predeterminada.
      • Deje las casillas de verificación Solicitar Transformación y Respuesta de Transformación en blanco si no se requiere una asignación personalizada.

      • En este ejemplo, hemos optado por la transformación de transferencia básica y no seleccionamos ninguna casilla de verificación:

        

      • Haga clic en Finalizar en la parte inferior de la ventana. La operación de transferencia se crea y se muestra en la pestaña Operaciones de Design Studio:

        

   2. Necesito asignaciones personalizadas en:

      • Solicitar Transformación: Haga clic en la casilla de verificación si se requiere un mapeo personalizado de la solicitud.
      • Transformación de respuesta: Haga clic en la casilla de verificación si se requiere un mapeo personalizado de la respuesta.

      • En este ejemplo, las casillas de verificación Transformación de respuesta y Transformación de solicitud están seleccionadas:

        

      • El botón Siguiente se activa automáticamente. Haga clic en Siguiente.**

      • Aparece un mensaje de advertencia en el asistente de entidades: " La transformación personalizada solo se admite con entidades GET (API de OData )".

      • Haga clic en Finalizar en la parte inferior de la ventana. La operación se crea y se muestra en Design Studio con una solicitud personalizada y una transformación de respuesta personalizada:

        

      • Haga clic con el botón derecho en la transformación Clientes - Solicitud y seleccione Editar clientes - Solicitud para abrir la pantalla de asignación de campos en la pestaña Transformaciones. Puede crear asignaciones personalizadas con secuencias de comandos según sea necesario:

        

      • Repita este paso en la transformación Clientes - Respuesta para asignar los campos de respuesta de forma adecuada.

      • Una vez completado el mapeo, haga clic en Icono Guardar en la barra de herramientas. Haga clic en Implementar en la barra de herramientas para desplegar todo el proyecto en Harmony.

5. Siguiente paso: Consulte Configuración del Servicio OData sobre el uso de la nueva entidad y la operación de entidad API.