Saltar al contenido

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.

Consejo

  • Debes estar usando Design Studio (no Cloud Studio ) para crear una operación de entidad API.
  • Antes de poder crear una operación de entidad API, debe haber completado lo siguiente:
    • Las operaciones residen dentro de un proyecto. Antes de poder crear una operación de entidad API, deberá seguir las instrucciones para Crear un nuevo proyecto en Design Studio.
    • Las operaciones de la entidad API se asignan a una entidad Jitterbit. Deberá seguir las instrucciones en Crear una entidad Jitterbit antes de crear una operación de entidad API.
    • Un proyecto puede contener varias entidades. Cada entidad puede contener una o más operaciones de entidad API, pero solo una operación por método HTTP.

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:

    archivo adjunto

    • 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:

    archivo adjunto

  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:

    archivo adjunto

    • 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:

      archivo adjunto

  4. Aparecerá la pantalla Transformaciones:

    archivo adjunto

    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:

        archivo adjunto

      • 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:

        archivo adjunto

    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:

        archivo adjunto

      • 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:

        archivo adjunto

      • 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:

        archivo adjunto

      • 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 adjunto Icono Guardar en la barra de herramientas. Haga clic en Implementar archivo adjunto 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.