Salesforce módulos

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:

Si necesita instrucciones para crear un escenario, consulte Crear un escenario en Adobe Workfront Fusion.

Para obtener información acerca de los módulos, vea Módulos en Adobe Workfront Fusion.

NOTE
  • No todas las ediciones de Salesforce tienen acceso a API. Para obtener más información, consulte la información sobre Salesforce ediciones con acceso a la API en el sitio de la comunidad Salesforce.
  • Para obtener información sobre los errores específicos devueltos por la API Salesforce, consulte los documentos de la API Salesforce. También puede comprobar el estado de la API Salesforce en busca de posibles interrupciones del servicio.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Product

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.

Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.

Requisitos previos

Para usar módulos de Salesforce, debe tener una cuenta de Salesforce.

Acerca de la búsqueda de Salesforce objetos

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 comienzan con 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.

Salesforce módulos y sus campos

Déclencheur

Ver registros

Este módulo de déclencheur 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo
Seleccione el tipo de registro Salesforce que desea que el módulo vea.
Campos de registro
Seleccione los campos que desea que vea el módulo. Los campos disponibles dependen del tipo de registro.
Recuento máximo de registros
Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.
Watch
Determine si desea que el escenario vea sólo los registros nuevos del tipo seleccionado, o los registros nuevos del tipo seleccionado y todos los demás cambios realizados en los registros de ese tipo.

Ver mensajes salientes

Este módulo de déclencheur 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:

  1. Vaya a la página de configuración de Salesforce.

    Para tener acceso a la página de instalación, busque y haga clic en el botón con la etiqueta "Configuración" en la esquina superior derecha de la cuenta Salesforce. En la página de configuración de Salesforce, busque la barra "Búsqueda rápida / Búsqueda" en el lado izquierdo. Busque "Reglas de flujo de trabajo".

  2. Haga clic en Reglas de flujo de trabajo.

  3. En la página Reglas de flujo de trabajo que aparece, haga clic en Nueva regla y seleccione el tipo de objeto al que se aplicará la regla (como "Oportunidad" si supervisa las actualizaciones de los registros de oportunidad).

  4. Haga clic en Siguiente.

  5. Defina un nombre de regla, criterios de evaluación y criterios de regla, luego haga clic en Guardar y Siguiente.

  6. Haga clic en Listo.

  7. En la regla de flujo de trabajo recién creada, haga clic en Editar.

  8. En la lista desplegable Agregar acción de flujo de trabajo, seleccione Nuevo mensaje saliente.

  9. 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 Guardar.

    El campo Dirección URL de extremo contiene la dirección URL proporcionada en el Salesforce Mensaje saliente de Workfront Fusion.

  10. Configure un escenario que comience con el evento Mensaje saliente.

  11. Haga clic en el icono </> en la parte inferior derecha y copie la dirección URL proporcionada.

  12. Vuelva a la página Reglas de flujo de trabajo, busque la regla recién creada y haga clic en Activar.

Al configurar este módulo, se muestran los campos siguientes.

Webhook

Seleccione el webhook que desee utilizar para ver los mensajes salientes. Para agregar un webhook, haga clic en Agregar e introduzca el nombre y la conexión del webhook.

Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion - Instrucciones básicas

Tipo de registro
Seleccione el tipo de registro Salesforce que desea que el módulo supervise en busca de mensajes salientes.
Campos
Seleccione los campos que desea que el módulo inspeccione para detectar mensajes salientes. Los campos disponibles dependen del tipo de registro.

Ver un campo

Este módulo de déclencheur inicia un escenario cuando se actualiza un campo en Salesforce.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de registro
Seleccione el tipo de registro que contiene el campo que desea que el módulo vea. Debe elegir un tipo de registro que tenga Field History activado en la configuración de Salesforce. Para obtener más información, consulte Seguimiento del historial de campos en la documentación de Salesforce.
Campo
Seleccione los campos en los que desea que el módulo observe los cambios.
Límite
Introduzca o asigne el número máximo de campos que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de registro
Seleccione el tipo de registro Salesforce que desea que cree el módulo. Los campos estarán disponibles en función del tipo de registro seleccionado en el campo Record Type. Estos campos se basan en la API Salesforce.
Seleccionar campos para asignar

Seleccione los campos que desea que configure el módulo al crear el nuevo registro. Los campos obligatorios están en la parte superior de la lista.

Los campos que seleccione se abren debajo de este campo. Ahora puede introducir valores en estos campos.

Leer un registro

Este módulo de acción lee datos de un solo objeto en Salesforce.

Especifique el ID 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de registro
Seleccione el tipo de registro Salesforce que desea que el módulo [action].read.
Campos de registro
Seleccione los campos que desea que lea el módulo. Debe seleccionar al menos un campo.
ID

Escriba o asigne el identificador único Salesforce del registro que desea que lea el módulo.

Para obtener el identificador, abra el objeto Salesforce en el explorador y copie el texto al final de la dirección URL después de la última barra diagonal (/). Por ejemplo: https://eu5.salesforce.com/<object ID>

Eliminar un registro

Este módulo de acción elimina un registro existente en un objeto.

Especifique el ID 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de registro
Seleccione el tipo de registro Salesforce que desea que elimine el módulo.
ID

Escriba o asigne el identificador único Salesforce del registro que desea que elimine el módulo.

Para obtener el identificador, abra el objeto Salesforce en el explorador y copie el texto al final de la dirección URL después de la última barra diagonal (/). Por ejemplo: https://eu5.salesforce.com/<object ID>

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 Salesforce módulos.

El módulo devuelve lo siguiente:

  • Código de estado (número): esto indica si la solicitud HTTP se realizó correctamente o no. Estos son 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 encabezados de respuesta, por lo que algunos podrían no ser útiles para usted.

    Los encabezados de respuesta dependen de la solicitud HTTP elegida al configurar el módulo.

  • Cuerpo (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 solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
URL

Escriba una ruta relativa a <Instance URL>/services/data/v46.0/.

Para obtener la lista de extremos disponibles, consulte la Guía para desarrolladores de API de REST de Salesforce.

Método
Encabezados
Agregue los encabezados de la solicitud en forma de objeto JSON estándar. Por ejemplo, {"Content-type":"application/json"}. Workfront Fusion añade los encabezados de autorización por usted.
Cadena de consulta
Añada la consulta para la llamada de API en forma de objeto JSON estándar. Por ejemplo: {"name":"something-urgent"}
Cuerpo

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.

INFO
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 devolvieron 6 usuarios:

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de carga
Seleccione si desea que el módulo cargue un archivo adjunto o un documento.
ID
Introduzca o asigne el ID del objeto en el que desea cargar un archivo adjunto.
Carpeta
Seleccione la carpeta que contiene el archivo que desea que cargue el módulo.
Archivo Source
Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de descarga

Especifique el tipo de archivo que desea descargar de Salesforce.

  • Datos adjuntos
  • Documento
  • ContentDocument (Documento que se ha cargado en una biblioteca de Saleforce CRM Content o Salesforce Files.)

ID /

Id. de datos adjuntos /

ContentDocument ID

Escriba o asigne el identificador único Salesforce del registro que desea que descargue el módulo.

Para obtener el identificador, abra el objeto Salesforce en el explorador y copie el texto al final de la dirección URL después de la última barra diagonal (/). Por ejemplo: https://eu5.salesforce.com/<object ID>

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 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
ID
Introduzca o asigne el ID del registro que desea actualizar.
Tipo de registro
Seleccione el tipo de registro Salesforce que desea que actualice el módulo. Los campos están disponibles en función del tipo de registro seleccionado en el campo Tipo de registro. Estos campos se basan en la API Salesforce.
Seleccionar campos para asignar

Seleccione los campos que desea que configure el módulo al crear el nuevo registro. Los campos obligatorios están en la parte superior de la lista.

Los campos que seleccione se abren debajo de este campo. Ahora puede introducir valores en estos campos.

Búsquedas

Buscar con 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión con Adobe Workfront Fusion: instrucciones básicas.
Tipo de búsqueda

Seleccione el tipo de búsqueda que desea que realice el módulo:

  • Simple

  • Using SOSL (Lenguaje de búsqueda de objetos de Salesforce)

  • Using SOQL (Salesforce Object Query Language)

Tipo
Si seleccionó el tipo de búsqueda simple, elija el tipo de registro Salesforce que desea que busque el módulo.
Query / SOSL Query / SOQL Query

Introduzca la consulta por la que desea buscar.

Para obtener más información sobre SOSL, consulte Lenguaje de búsqueda de objetos de Salesforce (SOSL) en la documentación de Salesforce.

Para obtener más información sobre SOQL, consulte Lenguaje de consulta de objetos de Salesforce (SOQL) en la documentación de Salesforce.

Nota: Tenga en cuenta que el valor del parámetro RETURNING influye en la salida del módulo. Si usa LIMIT, Fusion omitirá la configuración del campo Recuento máximo de registros. Si no define ningún límite, Fusion insertará el valor LIMIT = Número máximo de registros.

Recuento máximo de registros
Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

Búsqueda

Este módulo de acción recupera todos los registros que cumplen un criterio determinado.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Salesforce a Workfront Fusion, vea Crear una conexión a​ Adobe Workfront Fusion - Instrucciones básicas
Tipo
Seleccione el tipo de objeto que desea buscar.
Criterios de búsqueda
Seleccione el campo por el que desea buscar, el operador que desea utilizar en la consulta y el valor que está buscando en el campo. Puede conectar consultas mediante AND u OR.
Salidas
Seleccione los campos que desea incluir en la salida del módulo.
Conjunto de resultados
Seleccione si desea que el módulo devuelva todos los registros coincidentes o solo el primer registro coincidente.
Máximo
Introduzca o asigne el número máximo de registros que desea que el módulo recupere durante cada ciclo de ejecución de escenario.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43