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 adquirir 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 Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.
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 Add 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 Continue para guardar la conexión y volver al módulo.
Módulos de Salesforce y sus campos
Activadores
Watch a field
Este módulo activador inicia un escenario cuando se actualiza un campo en Salesforce.
Watch for Records
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.
Watch Outbound Messages
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 cierta configuración adicional:
-
Vaya a la página de configuración de Salesforce.
Para acceder a la página de configuración, busque y haga clic en el botón con la etiqueta "Setup" en la esquina superior derecha de la cuenta Salesforce. En la página de configuración de Salesforce, busque la barra "Quick Find / Search" en el lado izquierdo. Buscar "Workflow Rules".
-
Haga clic en Workflow Rules.
-
En la página Workflow Rules que aparece, haga clic en New Rule y seleccione el tipo de objeto al que se aplicará la regla (como "Opportunity" si está supervisando las actualizaciones de los registros de oportunidad).
-
Haga clic en Next.
-
Establezca un nombre de regla, criterios de evaluación y criterios de regla, luego haga clic en Save y Next.
-
Haga clic en Done.
-
En la regla de flujo de trabajo recién creada, haga clic en Edit.
-
En la lista desplegable Add Workflow Action, seleccione New Outbound Message.
-
Especifique el nombre, la descripción, la dirección URL de extremo y los campos que desee incluir en el nuevo mensaje saliente y, a continuación, haga clic en Save.
El campo Endpoint URL contiene la dirección URL proporcionada en Salesforce Outbound Message de Workfront Fusion.
-
Configure un escenario que comience con el evento Outbound Message.
-
Haga clic en el icono </> en la parte inferior derecha y copie la dirección URL proporcionada.
-
Vuelva a la página Workflow Rules, busque la regla recién creada y haga clic en Activate.
Al configurar este módulo, se muestran los campos siguientes.
Acciones
Create a Record
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 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.
Custom API Call
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:
-
Status Code (número): esto indica el éxito o el error de la solicitud HTTP. Se trata de códigos estándar que puede buscar en internet.
-
Headers (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.
-
Body (objeto): Según la solicitud HTTP elegida al configurar el módulo, es posible que vuelva a recibir 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.
Seleccione el método de petición HTTP que necesita para configurar la llamada de la API. Para obtener más información, vea Métodos de solicitud HTTP.
Escriba una ruta relativa a <Instance URL>/services/data/v46.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.
Delete a Record
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.
Download Attachment/Document
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.
Read a Record
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.
-
URL:
query -
Método: GET
-
Cadena de consulta:
-
Clave:
q -
Valor:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Update a Record
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.
Upload Attachment/Document
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
Search with Query
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.
Search
Este módulo de acción recupera todos los registros que cumplen un criterio determinado.