Acerca del paquete de actividades de Salesforce

El paquete UiPath.Salesforce.Activities te permite automatizar los procesos de Salesforce. Puede conectarse a una organización de Salesforce a través del ámbito de aplicación de Salesforce y, junto con el resto de actividades, te permite realizar acciones como manipulación de archivos, manipulación de registros, ejecución de informes y ejecución de comandos SOQL.

Una vez establecida, la conexión a la organización de Salesforce se puede almacenar en un objeto IConnectionService y reutilizar fácilmente en todas las actividades de ámbito secundario. Las credenciales de conexión se cifran mediante el uso de la API de protección de datos de Microsoft .NET (DPAPI) y solo el mismo usuario y en la misma máquina en la que se introdujeron pueden acceder a ellas.

Requisitos previos

A Salesforce account as well as a Salesforce Connected App are both required to use the Salesforce activities. These can be acquired from your Salesforce Administrator.

Como alternativa, los desarrolladores de RPA pueden utilizar una cuenta de desarrollador de Salesforce para automatizar procesos en Salesforce.

El objeto EstadoDeSalesforce

Todas las actividades que realizan la manipulación de datos en Salesforce devuelven un tipo de datos propietario, llamado SalesforceStatus. Este objeto contiene detalles sobre el estado de ejecución de cada actividad en interacción con Salesforce. El objeto está estructurado para contener las siguientes propiedades:

• Success - States whether the action was successful or an error was thrown.
• ErrorCode - In case an error is thrown upon execution, returns the error code from Salesforce.
• Message - In case an error is thrown upon execution, returns the error message from Salesforce.

El asistente de objetos de Salesforce

Las actividades Obtener registro, Insertar registro y Actualizar registro pueden configurarse utilizando el asistente de objetos de Salesforce . Al hacer clic en el botón Configurar presente en el cuerpo de las actividades se abre esta ventana.

The Salesforce Object drop-down lets you select the object you want to interact with, displaying all its details. The first record in that object is also retrieved as a Sample Record. The Sample Value column shows the value of the field for that record.

Nota:

When a Salesforce Object is selected, the list of fields is populated with the list of fields that are marked as mandatory across all the layouts of the object in Salesforce. Due to the limitation of the available configuration details from Salesforce, there could be more fields that are mandatory, but are not added by default. Use the Test with sample values to test the activity.

By using the Add Single Field text box, you can add fields to the selected object. The Add Multiple Fields button opens a different section of the wizard, which lets you choose multiple fields to add to the object. This can be done by selecting the check marks for all of the fields you want to add and clicking Done.

Nota:

In the Insert Record activity, only the fields that are identified as being allowed to be created by the Salesforce Lightning API are available. In the Update Record activity, only the fields that are identified as being allowed to be updated are available.

Clicking Done again saves the changes you made to the activity that was being configured.

The Insert Record and Update Record activities also have the option of testing the operation with sample values. This can be done by clicking the Test with sample values button. This executes the operations with the values in the Sample Value column, and reports success or errors.

Campos de objeto de Salesforce y tipo de datos

En las actividades Obtener registro, Insertar registro y Actualizar registro , todos los valores de campo se pasan como String.

Para los campos con el tipo de datos Picklist , la cadena pasada debe ser el valor válido y no la etiqueta como se ve en la aplicación. Utiliza la actividad Formatear etiquetas y valores para configurar la cadena correctamente.

Para los campos con el tipo de datos Multiplicklist , la cadena pasada debe ser una lista de los valores válidos separados por punto y coma y no las etiquetas como se ve en la aplicación. Utiliza la actividad Formatear etiquetas y valores para configurar la cadena correctamente.

Para los campos con el tipo de datos Boolean , la cadena pasada debe ser verdadera o falsa. Ten en cuenta que cuando Salesforce devuelve estos valores en la actividad Obtener registro , los valores mostrados en la columna Valor de muestra pueden ser cualquiera de los siguientes: Verdadero, verdadero, Falso o falso, dependiendo de cómo se hayan introducido originalmente los datos en Salesforce.

Para los campos con el tipo de datos Date , la cadena pasada debe tener el formato YYYY-MM-DD.

Funciones de extensión de Salesforce

We have implemented two new functions that are shipped with the Salesforce activities pack, which help you to better automate processes in Salesforce:

Formatear como booleano

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceFormatAsBoolean(String Value)

Introducir un valor de tipo booleano que no está en el formato admitido por Salesforce arroja un error en runtime. La función SalesforceFormatAsBoolean te permite convertir cualquier tipo de valor booleano en una cadena al formato compatible con Salesforce.

Valores admitidos

For True, the following values are convertible: 1, x, t, true, yes, y.

For False, the following values are convertible: 0, null, f, false, no, n.

Nota:

All of the values mentioned above are case-insensitive (which means that they are identified whether they are capitalized or not) and are recognized from any available alphabet.

Término de búsqueda de escape

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceEscapeSearchTerm(String SearchTerm, Boolean IsLike = true)

Esta función escapa a los términos de búsqueda que pueden utilizarse en la propiedad ComandoSOQL en la actividad Ejecutar SOQL , según lo requiera Salesforce. Para obtener más información sobre Escape de cadena entre comillas, puedes ir aquí.