Saltar al contenido

Configurar Salesforce Connect para Consumir una API de Servicio OData

Introducción

Esta página describe cómo instalar y 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 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 aprovisionada 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. Dentro del panel en el lado izquierdo de la página, desplácese hacia abajo hasta Crear, seleccione Desarrollar y seleccione Fuentes de datos externos. Necesitará acceso a estas funciones para configurar Salesforce Connect. Si no tiene acceso a estas funciones, comuníquese con su representante de Salesforce:

    adjunto

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

    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 API Fuente de datos externa y Nombre pueden ser la misma.

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

      Nota

      Actualmente, Harmony solo es compatible con 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, coloque el cursor sobre el ficha API y haga clic en el enlace Copiar URL .)

      Nota

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

    • Objetos externos grabables:

      • Marque esta casilla si desea permitir que Salesforce PUBLICAR, PUBLICAR, BORRAR o FUSIONAR datos en SAP o en la fuente de la base de datos utilizando la API del Servicio OData. En este caso, se asignarán múltiples operaciones a la API a las que se les asignará uno o más de estos métodos.
      • Deje esta casilla sin marcar para acceso de solo lectura. En este caso, el método de operación en la API del Servicio OData debe configurarse en 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:

    adjunto

  4. La página Validar fuente de datos externa muestra:

    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:

    adjunto

    • La sección 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 APIs y otras personalizaciones. Cuando utilice un objeto externo, recuerde proporcionar siempre 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 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:

    adjunto

  3. Nueva pestaña Objeto personalizado, Paso 1 de 3:

    adjunto

    • 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 que contiene opciones de estilo. Seleccione un estilo de pestaña en la ventana emergente.
    • Descripción: Introduzca una breve descripción del objeto externo.
    • Haga clic en Siguiente.

  4. Nueva pestaña Objeto personalizado, Paso 2 de 3:

    adjunto

    • Personalice la visibilidad de las pestañas con perfiles como desee. En este ejemplo, Visibilidad de pestañas está configurada en Activado de forma predeterminada para todos los perfiles.
    • Haga clic en Siguiente.

  5. Nueva pestaña Objeto personalizado, Paso 3 de 3:

    adjunto

    • Seleccione 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.
    • Haga clic en Guardar.

  6. Haga clic en Inicio en la barra de herramientas superior:

    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.
    • Haga clic en la nueva pestaña que creó (en este ejemplo, Clientes).
    • Haga clic en Crear nueva vista
    • Personaliza Ver como desees. Introduzca 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.:

    adjunto

    • Los datos se recuperan en tiempo real y no se almacenan en Salesforce.
    • Puede profundizar para obtener más detalles o cambiar los filtros según sea necesario.
    • API Manager de Harmony 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: