Saltar al contenido

Configurar Salesforce Connect para consumir una API de servicio OData

Introducción

En esta página se describe cómo configurar Salesforce Connect (anteriormente Salesforce Lightning Connect) para consumir de forma segura una API de servicio OData y mostrar los datos en tiempo real. El ejemplo que se muestra expondrá y mostrará datos de una fuente SAP mediante el protocolo OData 2.0.

Requisitos previos

  1. Su organización de Salesforce debe estar preparada para acceder a los módulos de Salesforce Connect, incluidas 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 del servicio 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. En el panel del lado izquierdo de la página, desplácese hacia abajo hasta Crear, 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:

    archivo adjunto

  2. Haga clic en el botón Nueva fuente de datos externa:

    archivo adjunto

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

    • Fuente de datos externa: Ingrese el Nombre de la API del servicio OData en el campo Fuente de datos externa.

    • Nombre: Presione la tecla Tab. El campo Nombre se completa automáticamente con el nombre de la API del servicio OData. La Fuente de datos externa de la API y el Nombre pueden ser los mismos.

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

      Nota

      Actualmente, Harmony solo admite OData 2.0.

    • URL: Ingrese o pegue la URL completa de su API de servicio OData en el campo URL. (En Mis APIs página en API Manager, pase el cursor sobre el ficha API y haga clic en el enlace Copiar URL.)

      Nota

      Asegúrate de que la URL comience con HTTPS (y no HTTP). Si usas una URL HTTP, los datos no estarán protegidos cuando se soliciten y se envíen de vuelta a Salesforce.

    • Objetos externos que se pueden escribir:

      • Marque esta casilla si desea permitir que Salesforce PUBLIQUE, COLOQUE, ELIMINE o FUSIONE datos en la fuente de SAP o de la base de datos mediante la API del servicio OData. En este caso, se asignarán varias operaciones a la API a las que se les asigne uno o más de estos métodos.
      • Deje esta casilla sin marcar para obtener acceso de solo lectura. En este caso, el método de operación en la API del servicio OData debe configurarse como GET.
    • Tipo de identidad: Haga clic en este campo y seleccione Principal nombrado en la lista desplegable si tiene perfiles asignados a la API y si desea utilizar un nombre central para todos sus usuarios de Salesforce.

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

      • Se muestran campos adicionales según el protocolo seleccionado.
      • En el ejemplo que se muestra arriba, se seleccionó Autenticación de contraseña y se mostraron los campos Nombre de usuario y Contraseña. Ingrese el Nombre de usuario y la Contraseña correspondientes.
    • Haga clic en Guardar.

  3. Desplácese hacia abajo hasta la sección Autenticación. Haga clic en el botón Validar y sincronizar:

    archivo adjunto

  4. Aparece la página Validar fuente de datos externa:

    archivo adjunto

    • Haga clic en la casilla de verificación correspondiente 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 Autenticación:

    archivo adjunto

    • La sección Objetos externos muestra el nuevo objeto externo que usted 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 desde la fuente de datos. El objeto externo admite APIs y otras personalizaciones. Cuando utilice 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 del lado izquierdo de la página, desplácese hacia abajo hasta Crear, seleccione Crear y seleccione Pestañas:

    adjunto

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

    archivo adjunto

  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ó en la lista desplegable. En este ejemplo, se seleccionó Clientes.
    • Estilo de pestaña: haga clic en el campo Estilo de pestaña para mostrar una ventana emergente con opciones de estilo. Seleccione un estilo de pestaña en la ventana emergente.
    • 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:

    archivo adjunto

    • Personalice la visibilidad de las pestañas con los perfiles como desee. En este ejemplo, Visibilidad de pestañas está configurada en Activada de forma predeterminada para todos los perfiles.
    • Haga clic en Siguiente.
  5. Nueva pestaña de objeto personalizado, paso 3 de 3:

    adjunto

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

    archivo adjunto

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

    archivo adjunto

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

Recursos adicionales de Salesforce Connect

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