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 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 del Servicio OData.

Crear una Operación de Entidad API¶

1. Abra su proyecto en la aplicación Design Studio. La pantalla Primeros pasos debería 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 dentro del panel hasta Operaciones.
   • Haga clic derecho en Operaciones y seleccione Nueva operación en el 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 Entity Wizard 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 Jitterbit Entities:

   

   • 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 para entidades luego lo guiará a través de la creación de la entidad, la selección de las tablas u objetos y la selección de los campos. Siga las instrucciones descritas en Crear 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. Todas las entidades existentes disponibles dentro de su proyecto se enumeran debajo de la carpeta Jitterbit Entities en la sección superior derecha del 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. Aparece la pantalla Transformaciones:

   

   1. Transformaciones de transferencia:

      • Jitterbit crea una operación de transferencia de forma predeterminada.
      • Deje en blanco las casillas de verificación Solicitar Transformación y Respuesta de Transformación 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 de las casillas 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 una asignación personalizada 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 Solicitar Transformación 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 ( APIs 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 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 Desplegar 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.