Crear una entidad Jitterbit

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.

Crear una entidad Jitterbit

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

   

   • 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 dentro del 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 inicia la pantalla Tipo dentro del Asistente de entidades Jitterbit:

   

   • 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 entidad 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 dentro del Asistente de entidad Jitterbit debería mostrarse como se muestra a continuación. Esta pantalla proporciona la opción de seleccionar un extremo existente o crear uno nuevo para la entidad. Las pantallas y los pasos para crear un nuevo extremo son diferentes según la selección de base de datos o SAP como tipo de entidad. El paso 3.a. describe las instrucciones para configurar un extremo de base de datos. Desplácese hacia abajo 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.

      

      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, debería aparecer la misma pantalla 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 continuar con la pantalla Objeto dentro del asistente. Desplácese hasta el paso 4 para continuar configurando la entidad.

      3. Al seleccionar Crear nuevo, se deberían mostrar 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.

         

         • 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. Referencias adicionales también están disponibles en Fuentes y objetivos.
         • Una vez configurada la fuente de la base de datos, haga clic en Siguiente en la parte inferior de la pantalla para continuar con la pantalla Objeto dentro del asistente. Desplácese hasta el paso 4 para continuar configurando 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.

      

      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 continuar con 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 un nuevo extremo de SAP, como se muestra en la imagen a continuación. En este caso, siga los pasos que se describen debajo de la imagen.

         

         • Nombre: Ingrese 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 que se haya configurado la fuente de la base de datos o el extremo de SAP, al seleccionar Siguiente se debería mostrar la pantalla Objeto dentro del Asistente de entidad de Jitterbit. Este paso le permite seleccionar tablas específicas en su base de datos o extremo de SAP:

   

   • El nombre contiene: Ingrese caracteres en el campo El nombre contiene para filtrar la consultar. En el ejemplo, ingresamos KNA1 para filtrar las 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 de la lista desplegable. En este ejemplo, se ha seleccionado Solo tablas.

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

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

5. La pantalla Campos y filtros dentro del Asistente de entidades Jitterbit debería mostrarse de manera similar a la imagen que se muestra a continuación. En este paso, se seleccionarán campos específicos para definir el conjunto de datos.

   

   • Buscar: Ingrese nombres de campos parciales o completos en el campo Buscar para mostrar la lista de campos disponibles en una categoría en particular. Deje el campo Buscar en blanco para mostrar todos los campos disponibles en el objeto o la tabla seleccionados previamente.
     • Haga clic en la casilla de verificación asociada para seleccionar cada campo que se incluirá en el conjunto de datos.
     • Puede ingresar varios nombres de campo en el campo Buscar y seleccionar varios campos de cada lista resultante. En este ejemplo, las palabras Ciudad, Código postal, Dirección, Nombre, País y Cliente se ingresaron 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 dentro del Asistente de entidades Jitterbit debería mostrarse de manera similar a la imagen que se muestra a continuación. En este paso se define el nombre de la entidad y el campo de identificación principal:

   

   • Jitterbit creó una nueva entidad en función de las selecciones anteriores.

   • Nombre de la entidad: Ingrese el nombre que desea utilizar 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 el campo ID principal y que sea la clave única que identifique la entidad o el nuevo objeto. En este ejemplo, el campo Customer_1 está seleccionado como la clave única.

     Nota

     • Aparecerá un mensaje de error emergente si no se selecciona un campo de ID: "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 regresar a la pantalla del asistente.
     • Si la entidad finaliza sin un campo de ID definido, aparece 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 de 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 tiempo de ejecución.

   • Haga clic en Finalizar para continuar.

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

   

8. Próximo 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:

   

5. Para cambiar el ID principal, haga clic en la casilla de verificación asociada con el ID principal actual para desmarcar primero la casilla de verificación y eliminar el ID principal existente del conjunto de datos. Haga clic en la casilla de verificación asociada con el nuevo ID principal para definir el nuevo campo de ID en el conjunto de datos.

6. Haga clic en Guardar 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 Se abre la ventana emergente Seleccionar campos:

   

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

     • Haga clic en la casilla de verificación asociada para seleccionar cada campo que se incluirá en el conjunto de datos.
     • Puede ingresar 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 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 en el conjunto de datos todos los campos incluidos en la tabla.
   • Deseleccionar todo: Haga clic en el botón Deseleccionar todo para eliminar del conjunto de datos todos los campos incluidos en la tabla.
   • Una vez que se hayan seleccionado todos los campos obligatorios, haga clic en Aceptar para cerrar la ventana emergente.
   • Haga clic en Guardar en la barra de herramientas en la esquina superior derecha de la pestaña Entidades Jitterbit para guardar los cambios.