Centro de soporte de Workiva

Con el conector Salesforce®, puedes utilizar comandos para interactuar con Salesforce como parte de una cadena. Por ejemplo, con este conector, puedes:

• Sube, extrae y elimina datos en Salesforce mediante SOQL y operaciones masivas.
• Crear y gestionar objetos de Salesforce
• Actualiza y crea Registros en Salesforce

El conector interactúa con todas las versiones de Salesforce Sales Cloud:

• Salesforce Essentials
• Salesforce Net Zero Cloud
• Lightning® Profesional
• Lightning Enterprise
• Rayo Ilimitado

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos

Para que el conector esté disponible para utilizarlo en tu organización, primero debe habilitarlo un administrador de seguridad de la organización.

A continuación, puedes asegurar tu conexión a Salesforce utilizando uno de los métodos siguientes:

• Autenticación OAuth de Salesforce, utilizando un Id de cliente, un secreto y un ámbito.
• Autenticación básica, utilizando un nombre de usuario y una Contraseña
• Credenciales de cliente, utilizando únicamente un ID de cliente y una clave secreta
   

Autenticación OAuth de Salesforce

Para conectarte a Workiva, necesitarás el ID de cliente y el secreto de Salesforce, así como el ámbito de OAuth de la aplicación conectada.

La autenticación OAuth requiere, además, el uso de una aplicación conectada a Salesforce. Para crearla en Salesforce, , instala la aplicación y configura los siguientes ajustes obligatorios:

• En el campo « » (URL de devolución de llamada), introduce una de las siguientes opciones que se corresponda con tu AppSpot:
  • EE. UU., América Central, América del Sur: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Canadá: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
• Debajo de Ámbitos OAuth seleccionados, incluye Realizar solicitudes en tu nombre en cualquier hora (refresh_token, offline_access) y al menos otro ámbito.
   

autenticación básica|autenticación básica

Para conectarte a Workiva, necesitarás el nombre de usuario, la contraseña y el token de seguridad de Salesforce del usuario de integración.

La autenticación básica requiere un usuario de integración con permisos habilitados para API, además de permisos relacionados con cualquier tarea que vaya a realizar el conector.

Nota: Para establecer los permisos del usuario de integración en Salesforce, selecciona Administrar, Gestionar usuarios, Perfiles, y selecciona su perfil.

1. En « » (Permisos administrativos), selecciona « » (API habilitada).
2. Para que el conector pueda ejecutar un comando, el usuario necesita al menos Leer permisos para sus datos relacionados. 
3. Para realizar actualizaciones masivas de objetos de Salesforce, el usuario necesita Editar permisos para el objeto.
    

Autenticación de credenciales de clientes

Para conectarte a Workiva, necesitarás el ID de cliente y el secreto de Salesforce.

La autenticación mediante credenciales de cliente requiere el uso de una aplicación conectada a Salesforce. Para crearla en Salesforce, configura la aplicación utilizando el flujo de credenciales de cliente .

Establecer el conector de Salesforce para la autenticación OAuth

La autenticación OAuth te permite acceder a Salesforce utilizando un ID de cliente y un secreto. A diferencia del método de inicio de sesión con credenciales de cliente, la autenticación OAuth incluye un testigo de actualización y requiere un ámbito.

Se recomienda este método para comandos de ejecución más larga que, de lo contrario, agotan el tiempo de espera utilizando el método de las credenciales de clientes.

1. Desde Chain Builder, haz clic en compare_arrows Connections en la barra lateral izquierda y, a continuación, en compare_arrows Create en la esquina superior derecha.
2. En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar el conector.

4. En « » (Propiedades), introduce la instancia de Salesforce o el dominio personalizado al que deseas conectarte:

   Propiedad	Detalles
   Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, deja este campo en blanco. Nota: En tu URL de Salesforce, los caracteres anteriores a salesforce.com-como na73-representan el caso.
   Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en .my.salesforce.com.

5. Para Tipo de Autenticación, selecciona Salesforce OAuth.

6. Introduce el ID de cliente, el secreto y el ámbito en « » (Autenticación) y, a continuación, haz clic en « » (Conectar).
   

   Nota: Cuando se establece correctamente la conexión con Salesforce, el token de actualización del conector , el token de acceso y , y el token de accesose rellenan automáticamente. Si la conexión falla, haz clic en Para y espera a conectarte de nuevo.

   Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con encriptación AES-256.

7. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
8. Para probar la conexión, crea y ejecuta una cadena con el comando Listar informe del conector, y comprueba que devuelve una salida válida.

Establece el conector de Salesforce para la autenticación básica

La autenticación básica te permite iniciar sesión en Salesforce utilizando el Nombre de usuario y la Contraseña de un usuario de la integración.

1. Desde Chain Builder, haz clic en compare_arrows Connections en la barra lateral izquierda y, a continuación, en compare_arrows Create en la esquina superior derecha.
2. En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar el conector.

4. En « » (Propiedades), introduce la instancia de Salesforce o el dominio personalizado al que deseas conectarte:

   Propiedad	Detalles
   Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, déjalo en blanco. Nota: En tu URL de Salesforce, los caracteres anteriores a salesforce.com-como na73-representan el caso.
   Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en .my.salesforce.com.

5. Para Tipo de Autenticación, selecciona Autenticación básica.

6. En Autenticación, introduce el Nombre de usuario, la Contraseña y el Token de seguridad del usuario de la integración.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

7. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
8. Para probar la conexión, crea y ejecuta una cadena con el comando Listar informe del conector, y comprueba que devuelve una salida válida.
    

Establece el conector de Salesforce para las credenciales de clientes.

La autenticación de credenciales de clientes te permite acceder a Salesforce utilizando un ID de cliente y un secreto. Esto difiere del método de inicio de sesión OAuth en que no requiere un ámbito y no necesitarás autenticarte en Salesforce a través del botón Conectar. 

Advertencia: Este método de autenticación no incluye un testigo de actualización. Por ello, no es adecuado para comandos de larga ejecución y puede provocar tiempos de espera en determinadas cadenas.

1. Desde Chain Builder, haz clic en compare_arrows Connections en la barra lateral izquierda y, a continuación, en compare_arrows Create en la esquina superior derecha.
2. En Conector Conexión, selecciona Salesforce y el CloudRunner predeterminado.
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar el conector.

4. En « » (Propiedades), introduce la instancia de Salesforce o el dominio personalizado al que deseas conectarte:

   Propiedad	Detalles
   Instancia	Introduce la instancia de Salesforce a la que conectarte. Si tu organización utiliza un dominio personalizado de Salesforce, déjalo en blanco. Nota: En tu URL de Salesforce, los caracteres que preceden a salesforce.com —como na73—representan la instancia.
   Dominio personalizado	Introduce el dominio personalizado de Salesforce al que conectar, si se utiliza. Nota: Para ver tu dominio personalizado en Salesforce, selecciona Configuración de la empresa, Mi dominio. Un dominio a medida suele terminar en .my.salesforce.com.

5. Para Tipo de Autenticación, selecciona Credenciales de cliente.

6. Debajo de Autenticación, introduce el identificador y el secreto del cliente.

   Nota: Todas las credenciales sensibles se cifran automáticamente y se almacenan con encriptación AES-256.

7. Selecciona los entornos que vas a utilizar con la conexión y haz clic en Guardar.
8. Para probar la conexión, crea y ejecuta una cadena con el comando Listar informe del conector, y comprueba que devuelve una salida válida.

Solución de problemas

Si falla la conexión con Salesforce, puedes comprobar varios ajustes de configuración, según el tipo de autenticación.

 

Autenticación OAuth2

Si la conexión con la aplicación conectada a Salesforce falla al hacer clic por primera vez en Conectar, haz clic en Detener y espera a conectarte de nuevo. Si la conexión sigue fallando al utilizar la autenticación OAuth2:

• Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
• Comprueba el Id de cliente y el secreto de la aplicación conectada a Salesforce que utiliza el conector.
• En la aplicación conectada de Salesforce:
  • Comprueba que la URL de devolución de llamada sea correcta:
  • Para EE. UU., América Central y América del Sur: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para la región APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para Canadá: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • Para EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • Asegúrate de que sus ámbitos OAuth seleccionados incluyen Realizar solicitudes en tu nombre en cualquier hora (refresh_token, offline_access) y al menos otro ámbito.

Si el conector pierde la conexión con la aplicación Salesforce:

1. En el generador de cadenas de (), haz clic en compare_arrows Conexiones en la barra lateral izquierda y, a continuación, haz clic en Editar (icono del lápiz) para la conexión.
2. Debajo de OAuth, haz clic en Restablecer.
3. Para permitir que el conector se conecte a Salesforce, haz clic en Permitir.
    

autenticación básica|autenticación básica

Si la conexión falla utilizando la autenticación básica:

• Verifica las credenciales de inicio de sesión y el token de seguridad del usuario de la integración. Para solicitar un nuevo token de seguridad en Salesforce, inicia sesión como usuario de integración y selecciona Configuraciones, Mi información personal, y haz clic en Restablecer token de seguridad.
• Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
• Asegúrate de que el usuario de la integración tiene permisos para API Habilitada, además de los permisos relacionados con cualquier tarea que realice el conector.
   

Autenticación de credenciales de clientes

Si la conexión falla utilizando la autenticación de credenciales de clientes:

• Verifica que se ha introducido la instancia de Salesforce o el dominio personalizado correctos para el conector.
• Comprueba el Id de cliente y el secreto de la aplicación conectada a Salesforce que utiliza el conector.