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 mostrarse similar a la siguiente imagen:

   

   • 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 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 Escriba pantalla dentro del Asistente de entidades de 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 entidades de Jitterbit, haga clic en Volver en cualquier paso para regresar 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 Jitterbit Entity Wizard debería aparecer como se muestra a continuación. Esta pantalla proporciona la opción de seleccionar un extremo existente o crear un nuevo extremo para la entidad. Las pantallas y los pasos para crear un nuevo extremo son diferentes según su selección de base de datos o SAP como tipo de entidad. 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 instrucciones para configurar un extremo de SAP.

   1. Entidad de base de datos: Si seleccionó la base de datos como 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 bases de datos disponibles dentro de 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 la 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 a la pantalla Objeto dentro del asistente. Desplácese hacia abajo hasta el paso 4 para continuar configurando la entidad.

      3. Al seleccionar Crear nuevo se deben 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: Introduzca 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 según 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 continuar a la pantalla Objeto dentro del asistente. Desplácese hacia abajo hasta el paso 4 para continuar configurando la entidad.

   2. Entidad SAP: Si seleccionó SAP como tipo de entidad, el asistente debería mostrar la pantalla Seleccione 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 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 a la pantalla Objeto dentro del asistente. Desplácese hacia abajo hasta el paso 4 para continuar configurando la entidad.

      3. Al seleccionar Crear nuevo se deben mostrar 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 debería aparecer 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 por tablas de clientes. Deje el campo El nombre contiene en blanco para ver todos los objetos o tablas disponibles.
   • Tipo de objeto: Seleccione Tipo de objeto de la lista desplegable. En este ejemplo, se selecciona Solo tablas.

   • Haga clic en para mostrar la lista de objetos o tablas disponibles:
     

     • Haga clic en 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 filtro dentro del Asistente de entidad de Jitterbit debería mostrarse 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 campo parciales o completos en el campo Buscar para mostrar la lista de campos disponibles en una categoría particular. 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 para incluirlo en el conjunto de datos.
     • Puede ingresar varios nombres de campos en el campo Buscar y seleccionar varios campos de cada lista resultante. En este ejemplo, las palabras Ciudad, 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 mientras 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.
   • Anular selección de todo: Haga clic en el botón Anular selección de 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 que se hayan seleccionado todos los campos obligatorios, haga clic en Siguiente para continuar.

6. La pantalla Entidad JDML dentro del Asistente de entidad Jitterbit debería mostrarse similar a la imagen que se muestra a continuación. En este paso se define el nombre de la entidad y el campo de ID principal:

   

   • Jitterbit creó una nueva entidad basada 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 denomina 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 para que sea la clave única que identifica la entidad o el nuevo objeto. En este ejemplo, el campo Cliente_1 se selecciona como clave única.

     Nota

     • Aparece un mensaje de error emergente si no se selecciona un campo de ID: "No hay ningún campo de ID definido. ¿Quieres 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 un Estado: Advertencia en la esquina superior derecha de la pantalla Entidades de 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 primarios, dichos datos pueden omitirse en tiempo de ejecución.

   • Haga clic en Finalizar para continuar.

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

   

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 similar a esta imagen:

   

5. Para cambiar la ID principal, haga clic en la casilla de verificación asociada con la ID principal actual para borrar primero la casilla y eliminar la 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 icono 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 botón. Se abre la ventana emergente Seleccionar campos:

   

   • Buscar: Ingrese nombres de campo parciales o completos en el campo Buscar para mostrar la lista de campos disponibles en una categoría particular. 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 para incluirlo en el conjunto de datos.
     • Puede ingresar varios nombres de campos 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 todos los campos contenidos en la tabla en el conjunto de datos.
   • Anular selección de todo: Haga clic en el botón Anular selección de todo para eliminar todos los campos contenidos en la tabla del conjunto de datos.
   • Una vez seleccionados 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.