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.

NOTE
  • 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

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

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:

  • Seleccione o paquete de Prime Workfront: su organización debe adquirir Adobe Workfront Fusion.
  • Paquete de Ultimate Workfront: Workfront Fusion está incluido.

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:

URL básica
{{connection.instanceUrl}}
Versión de API
v62.0
Etiqueta de API
Versión 1.15.14

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:

  1. En cualquier módulo de Salesforce, haga clic en Add junto al cuadro Conexión.

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

Connection
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.
Record Type
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.
Field
Seleccione los campos en los que desea que el módulo vea los cambios.
Limit
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.

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.

Connection
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.
Type
Seleccione el tipo de registro de Salesforce que desea que vea el módulo.
Record Fields
Seleccione los campos que desea que observe el módulo. Los campos disponibles dependen del tipo de registro.
Maximal count of records
Introduzca o asigne el número máximo de registros que desea que el módulo devuelva durante cada ciclo de ejecución de escenario.
Watch
Determine si desea que el escenario observe solo 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.

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:

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

  2. Haga clic en Workflow Rules.

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

  4. Haga clic en Next.

  5. Establezca un nombre de regla, criterios de evaluación y criterios de regla, luego haga clic en Save y Next.

  6. Haga clic en Done.

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

  8. En la lista desplegable Add Workflow Action, seleccione New Outbound Message.

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

    El campo Endpoint URL contiene la dirección URL proporcionada en Salesforce Outbound Message de Workfront Fusion.

  10. Configure un escenario que comience con el evento Outbound Message.

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

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

Webhook

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

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

Record Type
Seleccione el tipo de registro de Salesforce que desea que observe el módulo en busca de mensajes salientes.
Fields
Seleccione los campos que desea que el módulo observe para detectar mensajes salientes. Los campos disponibles dependen del tipo de registro.

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.

Connection
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.
Record Type
Seleccione el tipo de registro de 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 de Salesforce.
Select fields to map

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.

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.

Connection
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 puntos finales disponibles, consulte la Guía para desarrolladores de API de REST de Salesforce.

Method
Headers
Añada 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 para usted.
Query String
Añada la consulta para la llamada de API en forma de objeto JSON estándar. Por ejemplo: {"name":"something-urgent"}
Body

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.

Connection
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.
Record Type
Seleccione el tipo de registro de 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>

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.

Connection
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.
Type of Download

Especifique el tipo de archivo que desea descargar de Salesforce.

  • Attachment
  • Document
  • ContentDocument (Este es un documento que se ha subido a una biblioteca en Saleforce CRM Content o Salesforce Files.)

ID /

Attachment ID /

ContentDocument ID

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

Para obtener el identificador, abra el objeto de 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>

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.

Connection
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.
Record Type
Seleccione el tipo de registro de Salesforce que desea que el módulo [action] lea.
Record Fields
Seleccione los campos que desea que lea el módulo. Debe seleccionar al menos un campo.
ID

Escriba o asigne el ID de Salesforce único 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>

INFO
Ejemplo: La siguiente llamada de API devuelve la lista de todos los usuarios de su cuenta de Salesforce:
  • URLquery

  • Método: GET

  • Cadena de consulta:

  • Claveq

  • ValorSELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

Las coincidencias de la búsqueda se pueden encontrar en la salida del módulo en Bundle> Body >records.
En nuestro ejemplo, se encontraron 6 usuarios:
Coincide con la búsqueda

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.

Connection
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.
Record Type
Seleccione el tipo de registro de 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 de Salesforce.
Select fields to map

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.

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.

Connection
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.
Type of Upload
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.
Folder
Seleccione la carpeta que contiene el archivo que desea que cargue el módulo.
Source File
Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.

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.

Connection
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
Source file
Seleccione un archivo de origen de un módulo anterior o asigne el nombre y los datos del archivo de origen.
Document linking
Seleccione si desea aplicar un vínculo de documento de contenido.
linkedEntityId
Si utiliza enlaces de documentos, introduzca o asigne el ID del objeto vinculado.
ShareType

Si utiliza la vinculación de documentos, seleccione permisos para el archivo.

  • Permiso de visor

    El usuario puede ver el archivo.

  • Permiso de colaborador

    El usuario puede ver y editar el archivo.

  • Permisos deducidos

    Los permisos se basan en los permisos del usuario para el registro relacionado, como una biblioteca.

Visibility

Si utiliza la vinculación de documentos, introduzca o asigne la visibilidad del documento.

  • AllUsers

    Disponible para todos los usuarios con permisos

  • InternalUsers

    Disponible para usuarios internos con permisos de.

  • SharedUsers

    Disponible para los usuarios que pueden ver la fuente en la que se publica el archivo.

Connection
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.
Search Type

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

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

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

Introduzca la consulta con 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 Maximal count of records. Si no establece ningún límite, Fusion insertará el valor LIMIT = Maximal count of records.

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

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

Connection
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
Type
Seleccione el tipo de objeto que desea buscar.
Search criteria
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.
Outputs
Seleccione los campos que desea incluir en la salida del módulo.
Result set
Seleccione si desea que el módulo devuelva todos los registros coincidentes o solo el primero.
Maximal
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
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3