Saltar al contenido

¡Transforma tus conexiones en dinero para el final del año con nuestro nuevo Programa de Indicación de Clientes! Descubre más

✕

Crear una entidad Jitterbit en Design Studio

Introducción

Esta página describe cómo crear y editar una entidad Jitterbit. Una entidad Jitterbit se utiliza para crear un servicio OData. La entidad define una base de datos o un extremo de SAP, tablas y campos que proporcionarán los datos a un servicio OData.

Consejo

  • Debes estar usando Design Studio (no Integration Studio) para crear una entidad Jitterbit.
  • Las entidades Jitterbit residen dentro de un proyecto. Antes de crear una entidad Jitterbit, deberá seguir las instrucciones para Crear un nuevo proyecto en Design Studio.
  • Un proyecto puede contener varias entidades Jitterbit.

Crear una entidad Jitterbit

  1. Abra su proyecto en la aplicación Design Studio. La pantalla de inicio debería ser similar a la de la imagen a continuación:

    archivo adjunto

    • El panel en el lado izquierdo del 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 Entidades Jitterbit.

    • Haga clic derecho en Entidades Jitterbit y seleccione Nueva entidad Jitterbit en el menú desplegable.

  2. Al seleccionar Nueva entidad Jitterbit, se abre la pantalla Tipo dentro del Asistente de entidades Jitterbit:

    attachment

    • Seleccionar Tipo de entidad Jitterbit:

      • Base de datos: Seleccione Base de datos si los datos a los que desea acceder están almacenados en una base de datos como SQL Server, Oracle, MySQL, etc.
      • SAP: Seleccione SAP si los datos a los que desea acceder están almacenados dentro de un sistema SAP.

    • Haga clic en Siguiente en la parte inferior de la pantalla para continuar. Mientras trabaja en el Asistente de Entidades Jitterbit, haga clic en Atrás en cualquier paso para volver al paso anterior y realizar cambios, o haga clic en Cancelar para salir del asistente sin guardar la entidad.

  3. La pantalla Extremo del Asistente de entidad Jitterbit debería mostrarse como se muestra a continuación. Esta pantalla permite seleccionar un extremo existente o crear extremo nuevo para la entidad. Las pantallas y los pasos para crear un extremo varían según el tipo de entidad seleccionado: base de datos o SAP. El paso 3.a. describe las instrucciones para configurar un extremo de base de datos. Desplácese hasta el paso 3.b. para obtener las instrucciones para configurar un extremo de SAP.

    1. Entidad de base de datos: Si seleccionó base de datos como el tipo de entidad, el asistente debería mostrar la pantalla Seleccionar fuente.

      adjunto

      1. Fuentes disponibles: Haga clic en Seleccionar o Crear nuevo para mostrar la lista de fuentes de base de datos disponibles en su proyecto.

        1. Seleccione una fuente de base de datos existente de la lista desplegable si está disponible.
        2. Seleccione Crear nuevo si la fuente de base de datos requerida no está disponible en el proyecto.

      2. Al seleccionar una fuente de base de datos existente, se mostrará la misma pantalla que la que se muestra a continuación, pero con los campos de Parámetros de conexión ya completados. En ese caso, haga clic en Siguiente en la parte inferior de la pantalla para pasar a la pantalla Objeto dentro del asistente. Desplácese hasta el paso 4 para continuar configurando la entidad.

      3. Al seleccionar Crear nuevo, se mostrarán los campos para crear una nueva fuente de base de datos, como se muestra en la imagen a continuación. En este caso, siga los pasos que se describen debajo de la imagen.

        adjunto

        • Nombre: Ingrese un nombre apropiado para el extremo en el campo Nombre. El valor predeterminado es "Nueva fuente".
        • Tipo: El tipo se selecciona automáticamente como Base de datos en función de su selección en el paso anterior.
        • Parámetros de conexión: Las instrucciones para configurar una fuente de base de datos se describen en Fuente de la base de datos. También hay referencias adicionales disponibles en Fuentes y destinos.
        • Una vez configurada la fuente de la base de datos, haga clic en Siguiente en la parte inferior de la pantalla para pasar a la pantalla Objeto dentro del asistente. Desplácese hasta el paso 4 para continuar con la configuración de la entidad.

    2. Entidad SAP: Si seleccionó SAP como el tipo de entidad, el asistente debería mostrar la pantalla Seleccionar el Extremo de SAP.

      adjunto

      1. Extremos de SAP disponibles: Haga clic en Seleccionar o crear nuevo para mostrar la lista de extremos de SAP disponibles dentro de su proyecto.
        1. Seleccione un extremo de SAP existente de la lista desplegable si está disponible.
        2. Seleccione Crear nuevo si el extremo de SAP requerido no está disponible en el proyecto.
      2. Al seleccionar una fuente SAP existente, debería aparecer la misma pantalla que se muestra a continuación, con los campos de Parámetros de Conexión ya completados. En ese caso, haga clic en Siguiente en la parte inferior de la pantalla para pasar a la pantalla Objeto dentro del asistente. Desplácese hasta el paso 4 para continuar con la configuración de la entidad.

      3. Al seleccionar Crear nuevo, se mostrarán los campos para crear un nuevo extremo de SAP, como se muestra en la imagen a continuación. En este caso, siga los pasos que se indican debajo de la imagen.

        adjunto

        • Nombre: Introduzca un nombre apropiado en el campo Nombre. El valor predeterminado es «Nuevo Extremo de SAP».
        • Parámetros de conexión: Las instrucciones para configurar un extremo de SAP se describen en extremo del conector SAP
        • Una vez configurado el extremo de SAP, haga clic en Siguiente en la parte inferior de la pantalla para continuar.

  4. Una vez configurado el origen de la base de datos o el extremo de SAP, al seleccionar Siguiente se mostrará la pantalla Objeto dentro del Asistente de Entidades Jitterbit. Este paso le permite seleccionar tablas específicas en su base de datos o extremo de SAP:

    archivo adjunto

    • El nombre contiene: Introduzca caracteres en el campo El nombre contiene para filtrar la consultar. En el ejemplo, se introdujo KNA1 para filtrar por tablas de clientes. Deje el campo El nombre contiene en blanco para ver todos los objetos o tablas disponibles.
    • Tipo de objeto: Seleccione el Tipo de objeto en la lista desplegable. En este ejemplo, se ha seleccionado Solo tablas.

    • Haga clic en el archivo adjunto Botón para mostrar la lista de objetos o tablas disponibles:
      attachment

      • Haga clic en el Nombre del objeto o tabla de la lista para crear el conjunto de datos requerido. En este ejemplo, se ha seleccionado la tabla KNA1, que contiene la información maestra del cliente. Haga clic en Siguiente para continuar.

  5. La pantalla Campos y filtros del Asistente de entidades Jitterbit debería mostrarse de forma similar a la imagen de abajo. En este paso, se seleccionarán los campos específicos para definir el conjunto de datos.

    adjunto

    • Buscar: Introduzca nombres de campos parciales o completos en el campo Buscar para mostrar la lista de campos disponibles en una categoría específica. Deje el campo Buscar en blanco para mostrar todos los campos disponibles en el objeto o tabla previamente seleccionado.
      • Haga clic en la casilla de verificación asociada para seleccionar cada campo que se incluirá en el conjunto de datos.
      • Puede introducir varios nombres de campo en el campo Buscar y seleccionar varios campos de cada lista resultante. En este ejemplo, se introdujeron las palabras Ciudad, Código postal, Dirección, Nombre, País y Cliente en el campo Buscar y se seleccionaron varios campos de cada lista.
    • Mostrar siempre los campos seleccionados: Haga clic en esta casilla de verificación para continuar mostrando todos los campos seleccionados previamente a medida que recorre varias listas de campos.
    • Seleccionar todo: Haga clic en el botón Seleccionar todo para seleccionar e incluir todos los campos contenidos en la tabla en el conjunto de datos.
    • Deseleccionar todo: Haga clic en el botón Deseleccionar todo para eliminar todos los campos contenidos en la tabla del conjunto de datos.
    • Filtro base (opcional): También puede ingresar un filtro base específico para su base de datos o sistema SAP en la columna derecha de la pantalla para filtrar sus datos.
    • Una vez seleccionados todos los campos obligatorios, haga clic en Siguiente para continuar.

  6. La pantalla Entidad JDML del Asistente de Entidades de Jitterbit debería ser similar a la imagen a continuación. En este paso se definen el nombre de la entidad y el campo ID principal:

    archivo adjunto

    • Jitterbit creó una nueva entidad basándose en las selecciones anteriores.

    • Nombre de la entidad: Ingrese el nombre que desea usar en el campo Nombre de la entidad. En este ejemplo, la entidad se llama Clientes.

      Nota

      El nombre de la entidad debe ser una sola palabra. Los consumidores que accedan a la API también podrán ver el nombre.

    • ID: Haga clic en la casilla de verificación asociada para seleccionar un campo como ID principal y que sea la clave única que identifica la entidad o el nuevo objeto. En este ejemplo, se selecciona el campo Cliente_1 como clave única.

      Nota

      • Si no se selecciona un campo de ID, se mostrará un mensaje de error emergente: "No hay ningún campo de ID definido. ¿Desea continuar?". Haga clic en Continuar para cerrar la ventana emergente y finalizar la entidad sin el ID definido, o haga clic en Cancelar para volver a la pantalla del asistente.
      • Si la entidad finaliza sin un campo ID definido, se mostrará Estado: Advertencia en la esquina superior derecha de la pantalla Entidades Jitterbit. El mensaje emergente es: "Problemas de validación. No hay ningún campo ID definido".
      • Si los datos devueltos incluyen registros duplicados con el mismo valor de ID principal o registros sin valores de ID principal, dichos datos pueden omitirse en el tiempo de ejecución.

    • Haga clic en Finalizar para continuar.

  7. La pestaña Entidades Jitterbit se muestra de forma similar a esta imagen:

    archivo adjunto

  8. Siguiente paso: Para obtener más información sobre cómo configurar un servicio OData, consulte Configuración del servicio OData.

Editar una entidad Jitterbit

  1. Abra el proyecto que contiene la entidad en Design Studio.
  2. Desplácese hacia abajo dentro del panel de elementos del proyecto en el lado izquierdo de Design Studio a Entidades Jitterbit.
  3. Haga clic derecho en el nombre de la entidad que desea editar. Seleccione Abrir en el menú desplegable.

  4. La pestaña Entidades Jitterbit se muestra de forma similar a esta imagen:

    archivo adjunto

  5. Para cambiar el ID principal, marque la casilla de verificación asociada al ID principal actual para desmarcarla y eliminar el ID principal existente del conjunto de datos. Marque la casilla de verificación asociada al nuevo ID principal para definir el nuevo campo de ID en el conjunto de datos.

  6. Haga clic en Guardar archivo adjunto en la barra de herramientas en la esquina superior derecha de la pestaña Entidades Jitterbit.

  7. Para agregar o eliminar campos del conjunto de datos, haga clic en el archivo adjunto adjunto se abrirá la ventana emergente Seleccionar campos:

    adjunto

    • Buscar: Introduzca nombres de campo parciales o completos en el campo Buscar para mostrar la lista de campos disponibles en una categoría específica. Deje el campo Buscar en blanco para mostrar todos los campos disponibles en el objeto o tabla previamente seleccionado.

      • Haga clic en la casilla de verificación asociada para seleccionar cada campo que se incluirá en el conjunto de datos.

      • Puede introducir varios nombres de campo en el campo Buscar y seleccionar varios campos de cada lista resultante.

    • Casilla de verificación Mostrar siempre los campos seleccionados: Haga clic en esta casilla de verificación para seguir mostrando todos los campos previamente seleccionados al recorrer varias listas de campos.

    • Seleccionar todo: Haga clic en el botón Seleccionar todo para seleccionar e incluir en el conjunto de datos todos los campos de la tabla.
    • Deseleccionar todo: Haga clic en el botón Deseleccionar todo para eliminar del conjunto de datos todos los campos de la tabla.
    • Una vez seleccionados todos los campos obligatorios, haga clic en Aceptar para cerrar la ventana emergente.
    • Haga clic en Guardar adjunto en la barra de herramientas en la esquina superior derecha de la pestaña Entidades Jitterbit para guardar los cambios.