Módulos de Salesforce
En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que utilizan Salesforce, así como conectarlo a varias aplicaciones y servicios de terceros.
Para ver un vídeo introductorio del conector de Salesforce, consulte:
Para obtener instrucciones sobre cómo crear un escenario, vea los artículos en Crear escenarios: índice de artículos.
Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.
- No todas las ediciones de Salesforce tienen acceso a la API. Para obtener más información, consulte la información sobre ediciones de Salesforce con acceso a la API en el sitio de la comunidad de Salesforce.
- Para obtener información sobre los errores específicos que devuelve la API de Salesforce, consulte los documentos de la API de Salesforce. También puede comprobar el estado de la API de Salesforce en busca de posibles interrupciones del servicio.
Requisitos de acceso
Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| paquete de Adobe Workfront | Cualquiera |
| Licencia de Adobe Workfront |
Nuevo: estándar O Actual: Trabajo o superior |
| Licencia de Adobe Workfront Fusion** |
Actual: No se requiere licencia de Workfront Fusion O Heredado: Workfront Fusion para la automatización e integración del trabajo |
| Producto |
Nuevo:
O Actual: Su organización debe comprar Adobe Workfront Fusion. |
Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.
Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
Requisitos previos
Para usar módulos Salesforce, debe tener una cuenta de Salesforce.
Información de API de Salesforce
El conector de Salesforce utiliza lo siguiente:
Acerca de la búsqueda de objetos de Salesforce
Al buscar objetos, puede introducir palabras de búsqueda individuales o crear una consulta más compleja utilizando comodines y operadores:
- Utilice el comodín de asterisco (*) como sustituto de cero o más caracteres. Por ejemplo, una búsqueda de Ca* encuentra elementos que empiezan por Ca
- Utilice un signo de interrogación comodín (?) como sustituto de un solo carácter. Por ejemplo, una búsqueda de Jo?n encuentra elementos con el término John o Joan pero no Jon
- Utilice el operador de comillas ("") para encontrar una coincidencia de frase exacta. Por ejemplo: “reunión del lunes"
Para obtener más información sobre las posibilidades de búsqueda, consulte la documentación para desarrolladores de Salesforce sobre SOQL y SOSL.
Crear una conexión a Salesforce
Para crear una conexión para los módulos de Salesforce:
-
En cualquier módulo de Salesforce, haga clic en Añadir junto al cuadro Conexión.
-
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Connection name Introduzca un nombre para la nueva conexión. Environment Seleccione si se está conectando a un entorno de producción o de no producción. Type Seleccione si desea conectarse a una cuenta de servicio o a una personal. Client ID Introduzca su ID de cliente de Salesforce. Client Secret Escriba el secreto de cliente de Salesforce. Sandbox Active esta opción si se trata de un entorno de zona protegida. API Version Introduzca la versión de la API de Salesforce que desea utilizar. La versión predeterminada es 62.0. -
Haga clic en Continuar para guardar la conexión y volver al módulo.
Módulos de Salesforce y sus campos
Activadores
Ver un campo
Este módulo activador inicia un escenario cuando se actualiza un campo en Salesforce.
Observar registros
Este módulo activador ejecuta un escenario cuando se crea o actualiza un registro de un objeto. El módulo devuelve todos los campos estándar asociados con el registro o registros, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Observar mensajes salientes
Este módulo activador ejecuta un escenario cuando alguien envía un mensaje. El módulo devuelve todos los campos estándar asociados con el registro o registros, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Este módulo requiere alguna configuración adicional. Debe haber un flujo configurado para los mensajes salientes.
- Para obtener instrucciones sobre los flujos en Salesforce, consulte Automatizar tareas con flujos en la documentación de Salesforce.
- Para obtener información sobre cómo configurar un mensaje saliente en Salesforce, consulte Enviar un mensaje saliente desde un flujo activado por registros en la documentación de Salesforce
Al configurar este módulo, se muestran los campos siguientes.
Acciones
Crear un registro
Este módulo de acción crea un nuevo registro en un objeto.
El módulo le permite seleccionar qué campos del objeto están disponibles en el módulo. Esto reduce el número de campos por los que debe desplazarse al configurar el módulo.
El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Llamada de API personalizada
Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Salesforce. De este modo, puede crear una automatización del flujo de datos que no puedan realizar los otros módulos de Salesforce.
El módulo devuelve lo siguiente:
-
Código de estado (número): esto indica si la solicitud HTTP se realizó correctamente o no. Se trata de códigos estándar que puede buscar en internet.
-
Encabezados (objeto): contexto más detallado para el código de respuesta/estado que no está relacionado con el cuerpo de salida. No todos los encabezados que aparecen en un encabezado de respuesta son de respuesta, por lo que algunos podrían no resultarle útiles.
Los encabezados de respuesta dependen de la petición HTTP elegida al configurar el módulo.
-
Cuerpo (objeto): según la petición HTTP elegida al configurar el módulo, es posible que reciba de vuelta algunos datos. Esos datos, como los datos de una solicitud GET, están contenidos en este objeto.
Al configurar este módulo, se muestran los campos siguientes.
Escriba una ruta relativa a <Instance URL>/services/data/v62.0/.
Para obtener la lista de puntos finales disponibles, consulte la Guía para desarrolladores de API de REST de Salesforce.
{"Content-type":"application/json"}. Workfront Fusion añade los encabezados de autorización para usted.{"name":"something-urgent"}Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.
Nota:
Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.
Ejemplo: La siguiente llamada de API devuelve la lista de todos los usuarios de su cuenta de Salesforce:
-
URL:
query -
Método: GET
-
Cadena de consulta:
-
Clave:
q -
Valor:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Las coincidencias de la búsqueda se encuentran en la salida del módulo en Paquete > Cuerpo > registros.
En nuestro ejemplo, se encontraron 6 usuarios:
Eliminar un registro
Este módulo de acción elimina un registro existente en un objeto.
Especifique el identificador del registro.
El módulo devuelve el identificador del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Descargar archivo adjunto/documento
Este módulo de acción descarga un documento o archivo adjunto de un registro.
Especifique el ID del registro y el tipo de descarga que desee.
El módulo devuelve el ID del archivo adjunto o documento y cualquier campo asociado, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Leer un registro
Este módulo de acción lee datos de un solo objeto en Salesforce.
Especifique el identificador del registro.
El módulo devuelve el ID del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Actualizar un registro
Este módulo de acción edita un registro en un objeto.
El módulo le permite seleccionar qué campos del objeto están disponibles en el módulo. Esto reduce el número de campos por los que debe desplazarse al configurar el módulo.
El módulo devuelve el identificador del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Cargar archivo adjunto/documento
Este módulo de acción carga un archivo y lo adjunta al registro que especifique o carga un documento.
El módulo devuelve el ID del archivo adjunto o documento y cualquier campo asociado, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Cargar archivo
Este módulo de acción carga un solo archivo en Salesforce.
Búsquedas
Búsqueda
Este módulo de acción recupera todos los registros que cumplen un criterio determinado.
Buscar con una consulta
Este módulo de búsqueda busca registros en un objeto de Salesforce que coincidan con la consulta de búsqueda especificada. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.