Acerca del paquete de actividades Salesforce – Classic

El paquete UiPath.Salesforce.Activities le 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, permite realizar Actions como la manipulación de archivos, la manipulación de registros, la ejecución de informes y la 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

Se requieren tanto una cuenta de Salesforce como una aplicación conectada de Salesforce para utilizar las actividades de Salesforce. Puede obtenerlos de su administrador de Salesforce.

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

El objeto SalesforceStatus

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:

• Correcto : indica si la acción se realizó correctamente o se produjo un error.
• CódigoDeError : en caso de que se arroje un error durante la ejecución, devuelve el código de error de Salesforce.
• Mensaje : en caso de que se arroje un error durante la ejecución, devuelve el mensaje de error de Salesforce.

El Asistente de objetos de Salesforce

Las actividades Obtener registro, Insertar registroy Actualizar registro se pueden configurar mediante 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.

El menú desplegable Objeto de Salesforce te permite seleccionar el objeto con el que quieres interactuar, mostrando todos sus detalles. El primer registro de ese objeto también se recupera como registro de muestra. La columna Valor de muestra muestra el valor del campo para ese registro.

Nota: Cuando se selecciona un objeto de Salesforce, la lista de campos se rellena con la lista de campos marcados como obligatorios en todos los diseños del objeto en Salesforce. Debido a la limitación de los detalles de configuración disponibles de Salesforce, podría haber más campos que son obligatorios, pero no se agregan de forma predeterminada. Utilice la Prueba con valores de muestra para probar la actividad.

Al usar el cuadro de texto Agregar un solo campo , puedes agregar campos al objeto seleccionado. El botón Añadir varios campos abre una sección diferente del asistente, que le permite elegir varios campos para añadir al objeto. Puedes hacerlo seleccionando las marcas de verificación de todos los campos que desees añadir y haciendo clic en Listo.

Nota: En la actividad Insertar registro , solo están disponibles los campos que la API Lightning de Salesforce ha identificado como permitidos. En la actividad Actualizar registro , solo están disponibles los campos identificados como autorizados.

Al hacer clic en Listo de nuevo, se guardan los cambios realizados en la actividad que se estaba configurando.

Las actividades Insertar registro y Actualizar registro también tienen la opción de probar la operación con valores de muestra. Esto puede hacerse haciendo clic en el botón Probar con valores de muestra . Esto ejecuta las operaciones con los valores de la columna Valor de muestra e informa de si se han realizado correctamente o de si hay errores.

Campos de objetos y tipo de datos de Salesforce

En las actividades Obtener registro, Insertar registroy 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. Use la actividad Formato de 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 valores válidos separados por punto y coma y no las etiquetas como se ven en la aplicación. Use la actividad Formato de 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 que se muestran en la columna Valor de muestra pueden ser cualquiera de los siguientes: Verdadero, Verdadero, Falsoo Falso, dependiendo de cómo se introdujeron los datos originalmente 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

Hemos implementado dos nuevas funciones que se incluyen con el paquete de actividades de Salesforce , que le ayudarán a automatizar mejor los procesos en 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

Para Verdadero, los siguientes valores son convertibles: 1, x, t, true, yes, y.

Para Falso, los siguientes valores son convertibles: 0, null, f, false, no, n.

Nota: Todos los valores mencionados anteriormente no distinguen entre mayúsculas y minúsculas (lo que significa que se identifican tanto si están en mayúsculas como si no) y se reconocen a partir de cualquier alfabeto disponible.

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