Saltar al contenido

Guía de conexión ADO.NET de Salesforce para Jitterbit App Builder

Descripción general

Esta guía describe los requisitos del sistema e instrucciones para conectar App Builder a una fuente de datos ADO.NET de Salesforce. Esta conexión utiliza un Proveedor de Seguridad OAuth, con el tipo de concesión de Código de Autorización.

Requisitos del sistema

Servidor de base de datos

Cuenta de Salesforce con ADO.NET

Navegador web del cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instrucciones de conexión

El siguiente paso es un requisito previo y debe completarse en la aplicación de Salesforce o en el entorno de sandbox.

Crear una aplicación OAuth personalizada en Salesforce

  1. Inicie sesión en Salesforce.com o en su entorno de sandbox de Salesforce

  2. Desde la página de inicio, vaya a Herramientas de Plataforma > Aplicaciones > Administrador de Aplicaciones

  3. Haga clic en el botón Nueva Aplicación Conectada

  4. Ingrese un Nombre que se mostrará a los usuarios cuando inicien sesión para otorgar permisos a su aplicación, junto con una dirección de Correo Electrónico de contacto

  5. Haga clic en Habilitar Configuración de OAuth

  6. Ingrese un valor en el campo URL de Callback. Esta debe ser la URL de su instancia de App Builder con un Proveedor de Seguridad agregado.

    Nota

    La sensibilidad a mayúsculas y minúsculas es importante, por lo que el nombre del proveedor de seguridad que creamos a continuación debe coincidir con la sensibilidad en la URL de Callback.

  7. Los Ámbitos de OAuth Seleccionados deben configurarse según el ámbito de permisos que la aplicación debe solicitar al usuario.

    1. Configúrelo en "Acceso completo (full)" y "Realizar solicitudes en cualquier momento (refresh_token,offline_acesss)"

    Interfaz gráfica de usuario, descripción de la aplicación generada automáticamente

  8. Haga clic en Administrar Detalles del Consumidor para ver el valor de ID de Cliente y Secreto. Tome nota de estos valores en un lugar que se pueda consultar fácilmente al configurar desde App Builder.

Crear un proveedor de seguridad OAuth en App Builder

  1. Configura un Proveedor de Seguridad en App Builder navegando a IDE > Proveedores de Seguridad

  2. Haz clic en el botón + Autenticación de Fuente de Datos

  3. Proporciona los siguientes detalles:

    • Nombre: Identifica el Proveedor de Seguridad y aparece en la URL en ocasiones. Ejemplo: Salesforce

    • Tipo: OAuth

    • Tipo de Autenticación: OAuth

    • Concesión OAuth: Código de Autorización

    • Autenticación del Cliente OAuth: Básica

    • Autenticación de Recursos OAuth: Portador

    • Propietario del Token: Usuario

    • Redirigir en Desafío: Verdadero

    attachment

  4. Haz clic en + Puntos finales y configura los siguientes 3 registros:

  5. Haz clic en + Credencial y crea el siguiente registro:

    • Tipo: Cliente

    • Nombre de Usuario: ID de Cliente de Salesforce

    • Contraseña: Secreto de Salesforce

  6. Haz clic en + Reclamación y crea los siguientes 3 registros para la provisión de usuarios:

    • Nombre: preferred_username

    • ID de Nombre: preferred_username

    • Dirección de Correo Electrónico: email

attachment

Crear la fuente de datos Salesforce ADO.NET en App Builder

  1. Ve al IDE de App Builder y haz clic en Servidores de Datos

  2. Haz clic en el botón + Servidor para agregar una nueva fuente de datos

  3. Asigna un Nombre de Servidor. Este nombre debe coincidir con la URL de Callback configurada en Salesforce. Ejemplo: SalesForce

  4. Selecciona el Tipo como Salesforce ADO.NET

  5. Expande la Configuración de Seguridad y establece el Proveedor de Seguridad en el que creamos. Ejemplo: SalesForce

    attachment

  6. Por último, si estás utilizando un entorno de sandbox de Salesforce, haz clic en el botón Configuración Avanzada y configura la URL del servidor OAuth

attachment

  1. Expande Pruebas y haz clic en el botón Probar Conexión para asegurarte de que la configuración esté funcionando como se espera.

Nota

Se deberá realizar una importación de las tablas de Salesforce para acceder a ellas desde dentro de App Builder.

Solución de Problemas

Si experimentas problemas con Salesforce ADO.NET, se recomiendan los siguientes pasos de solución de problemas:

  1. Habilita el registro de datos para generar archivos de registro y datos, que puedes descargar e inspeccionar.

  2. Consulta la documentación del Proveedor ADO.NET de CData para Salesforce para obtener información detallada.

Recursos