Saltar al contenido

Configurar Salesforce Connect para consumir una API OData de Jitterbit Design Studio en Jitterbit API Manager

Introducción

Esta página describe cómo configurar Salesforce Connect (anteriormente Salesforce Lightning Connect) para consumir de manera segura una API OData y mostrar los datos en tiempo real. El ejemplo mostrado expondrá y mostrará datos de una fuente SAP utilizando el protocolo OData 2.0.

Requisitos previos

  1. Su organización de Salesforce debe estar provisionada para acceder a los módulos de Salesforce Connect, incluyendo fuentes de datos externas y objetos externos.
  2. Crear un nuevo proyecto en Design Studio.
  3. Crear una entidad Jitterbit en Design Studio.
  4. Crear una operación de entidad API en Design Studio.
  5. Configuración de API OData en API Manager.

Crear una fuente de datos externa y un objeto externo en Salesforce

  1. Inicie sesión en su organización de Salesforce. Dentro del panel en el lado izquierdo de la página, desplácese hacia abajo hasta Construir, seleccione Desarrollar y seleccione Fuentes de Datos Externas. Necesitará acceso a estas funciones para configurar Salesforce Connect. Si no tiene acceso a estas funciones, comuníquese con su representante de Salesforce:

    attachment

  2. Haga clic en el botón Nueva Fuente de Datos Externa:

    attachment

    • Los campos requeridos muestran una barra vertical roja a la izquierda del campo.

    • Fuente de Datos Externa: Ingresa el Nombre de la API OData en el campo Fuente de Datos Externa.

    • Nombre: Presiona la tecla Tab. El campo Nombre se completa automáticamente con el nombre de la API OData. La Fuente de Datos Externa y el Nombre de la API pueden ser iguales.

    • Tipo: Haz clic en el campo Tipo y selecciona Salesforce Connect: OData 2.0 en la lista desplegable.

      Nota

      Harmony actualmente solo admite OData 2.0.

    • URL: Ingresa o pega la URL completa de tu API OData en el campo URL. (En la página de APIs en API Manager, pasa el cursor sobre el mosaico de la API y haz clic en el enlace Copiar URL.)

      Nota

      Asegúrate de que la URL comience con HTTPS (y no con HTTP). Si estás utilizando una URL HTTP, los datos no estarán protegidos al ser solicitados y enviados de vuelta a Salesforce.

    • Objetos Externos Escriturables:

      • Marca esta casilla si deseas permitir que Salesforce realice operaciones POST, PUT, DELETE o MERGE en la fuente SAP o base de datos utilizando la API OData. En este caso, se asignarán múltiples operaciones a la API que están asignadas a uno o más de estos métodos.
      • Deja esta casilla desmarcada para acceso solo de lectura. En este caso, el método de operación en la API OData debe estar configurado como GET.
    • Tipo de Identidad: Haz clic en este campo y selecciona Principal Nombrado en la lista desplegable si tienes perfiles asignados a la API y si deseas usar un nombre central para todos tus usuarios de Salesforce.

    • Protocolo de Autenticación: Haz clic en este campo y selecciona el Protocolo de Autenticación apropiado de la lista desplegable según el perfil de seguridad asignado a la API.

      • Se mostrarán campos adicionales dependiendo del protocolo seleccionado.
      • En el ejemplo mostrado arriba, se seleccionó Autenticación por Contraseña y se mostraron los campos Nombre de Usuario y Contraseña. Ingresa el Nombre de Usuario y la Contraseña apropiados.
    • Haz clic en Guardar.

  3. Desplázate hacia abajo hasta la sección de Autenticación. Haz clic en el botón Validar y Sincronizar:

    attachment

  4. La página de Validar Fuente de Datos Externa muestra:

    attachment

    • Haga clic en la casilla de verificación apropiada para seleccionar el Nombre de la Tabla. En este ejemplo, se seleccionó Clientes.
    • Haga clic en el botón Sincronizar para verificar la URL, validar que el formato sea aceptable y crear automáticamente un nuevo Objeto Externo en Salesforce.
  5. Desplácese hacia abajo hasta la sección de Autenticación:

    attachment

    • La sección de Objetos Externos muestra el nuevo Objeto Externo que creó.
    • Los objetos externos de Salesforce son similares a otros objetos personalizados, excepto que los datos no se almacenan en Salesforce. Los datos se recuperan en tiempo real de la fuente de datos. El objeto externo admite API y otras personalizaciones. Al usar un objeto externo, recuerde siempre proporcionar un filtro para refinar los datos.
    • Consulte la documentación de Salesforce Definir Objetos Externos para obtener información adicional sobre los objetos externos de Salesforce.

Crear una nueva pestaña personalizada en Salesforce

  1. Dentro del panel en el lado izquierdo de la página, desplácese hacia abajo hasta Construir, seleccione Crear y seleccione Pestañas:

    attachment

  2. Desplácese hacia abajo hasta la sección de Pestañas de Objetos Personalizados y haga clic en Nuevo para crear una nueva pestaña en Salesforce:

    attachment

  3. Nueva Pestaña de Objeto Personalizado, Paso 1 de 3:

    attachment

    • Objeto: Haga clic en el campo Objeto y seleccione el nuevo objeto externo que creó de la lista desplegable. En este ejemplo, se seleccionó Clientes.
    • Estilo de Pestaña: Haga clic en el campo Estilo de Pestaña para mostrar un popup que contiene opciones de estilo. Seleccione un estilo de pestaña en el popup.
    • Descripción: Ingrese una breve descripción del objeto externo.
    • Haga clic en Siguiente.
  4. Nueva pestaña de objeto personalizado, paso 2 de 3:

    attachment

    • Personaliza la visibilidad de la pestaña con los perfiles según sea necesario. En este ejemplo, Visibilidad de la pestaña está configurada como Predeterminado Activado para todos los perfiles.
    • Haz clic en Siguiente.
  5. Nueva pestaña de objeto personalizado, paso 3 de 3:

    attachment

    • Selecciona las Aplicaciones personalizadas para las cuales la nueva pestaña personalizada estará disponible haciendo clic en las casillas de verificación asociadas. Todas las aplicaciones están incluidas en el ejemplo anterior.
    • Haz clic en Guardar.
  6. Haz clic en Inicio en la barra de herramientas superior:

    attachment

    • Si tu nueva pestaña no se muestra automáticamente, haz clic en el signo más en el lado derecho de la barra de herramientas para listar todas las pestañas.
    • Haz clic en la nueva pestaña que creaste (en este ejemplo Clientes).
    • Haz clic en Crear nueva vista
    • Personaliza la Vista según sea necesario. Ingresa un Nombre para la vista.
    • Haz clic en Guardar.
  7. En el ejemplo mostrado en la imagen a continuación, la vista Clientes en EE. UU. está configurada para mostrar todos los clientes donde País = EE. UU.:

    attachment

    • Los datos se recuperan en tiempo real y no se almacenan en Salesforce.
    • Puedes profundizar para obtener más detalles o cambiar filtros según sea necesario.
    • Jitterbit API Manager continuará atendiendo las solicitudes en tiempo real y trabajará junto con Salesforce Connect para proporcionar acceso a los datos.

Recursos adicionales de Salesforce Connect

Estos recursos de la documentación de Salesforce pueden ser útiles: