Inicio rápido

Información general

El propósito de esta guía es ayudarle a crear una muestra de trabajo para verificar rápidamente la conexión a su organización de Salesforce y familiarizarse con los tipos de datos de entrada / salida de las actividades incluidas.

Después de completar los pasos de esta guía, tendrá una secuencia de automatización que hará lo siguiente:

1. Crea variables SecureString para tus credenciales de Salesforce e Invocar método.
2. Establece una conexión a su organización de Salesforce utilizando sus credenciales SecureString (Ámbito de aplicación de Salesforce)
3. Crea un nuevo registro de cuenta de Salesforce (Insertar registro).
4. Carga un archivo en tu organización de Salesforce (Cargar archivo).
5. Asigna el archivo cargado a tu nuevo registro de cuenta de Salesforce (Asignar archivo).
6. Verifica los resultados de las actividades Insertar registro, Cargar archivo y Asignar archivo dando salida a cada uno de sus objetos SalesforceStatus ().

Requisitos previos

Antes de comenzar:

1. Completa los pasos de Configuración de Salesforce.
2. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Enter a project Name, Location, and Description.

   4. Haz clic en Crear.

      

3. Install the UiPath.Salesforce.Activities package.
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Official.
   3. In the Search bar, enter Salesforce.
   4. Click, install and accept the license for the UiPath.Salesforce.Activities.

      • Para obtener más información sobre los paquetes de Uipath Studio, consulta Gestionar paquetes en la Guía de Studio.

        

Pasos

Construya su proyecto

La actividad Ámbito de aplicación de Salesforce requiere tipos de datos SecureString para las propiedades de entrada Secreto de consumidor, Contraseña y TokenDeSeguridad . Para obtener estos tipos de datos SecureString , convierte los valores String que almacenaste para estas propiedades al completar los pasos Obtener tus credenciales en la guía de Configuración .

Nota:

Los siguientes pasos están destinados a demostrar cómo puedes convertir un String en un SecureString. Para simplificar y para ayudarte a crear rápidamente una muestra de trabajo, la conversión se realiza dentro de la secuencia de tu proyecto y requiere que introduzcas tus valores de credenciales como variables. Esto no se recomienda al crear proyectos compartibles o que no sean de ejemplo. Al crear proyectos compartibles o que no sean de ejemplo, puedes crear y hacer referencia a flujos de trabajo externos que obtengan tu Secreto de consumidor, Contraseña y SecurityToken de una fuente local (por ejemplo, .txt, Archivo.xlsx ) y realiza la conversión utilizando y argumentos.

Convertir cadenas en SecureStrings

1. Cree las siguientes tres variables:
   1. String with your Salesforce login password as the Default value (e.g., Name: textPassword, Default: "UiPath123")
   2. SecureString with New SecureString() as the Default value (e.g., Name: securePassword, Default:New SecureString())
   3. SecureString (e.g., Name: password)
      • For all SecureString variables, select the System.Security.SecurityString type.
   4. Añadir una nueva declaración al proceso.
   • Recommendation: change the Display Name to "Create SecureString - Password" or something to make it easy to identify its purpose.
2. Añade una actividad dentro de la Secuencia.
   1. In the TypeArgument property, select System.Char.
   2. In the Values property, enter the String variable (e.g., textPassword).
3. En la actividad Para cada , añade la actividad InvokeMethod (Programación > Ejecutar > InvokeMethod).
   1. In the TargetObject property, enter your first SecureString variable (e.g., securePassword)
      • Make sure the the TargetType property is (null) (either the TargetObject or TargetType is allowed, not both).
   2. In the MethodName property, enter AppendChar.
      • El método AppendChar se utiliza para añadir una unidad de código UTF-16 después de la cadena.
   3. In the Parameters property, add a new parameter using the following values: Direction: In, Type: System.Char, Value: item.
4. Añade la actividad después de la actividad InvokeMethod .

   1. In the To property, enter your second SecureString variable (e.g., password).

   2. In the Value property, enter your first SecureString variable (e.g., _securePassword).

      

5. Cree las siguientes tres variables:
   1. String with your Consumer Secret as the Default value (e.g., Name: textPassword, Default: "4FA94...")
   2. SecureString with New SecureString() as the Default value (e.g., Name: secureConsumerSeret, Default:New SecureString())
   3. SecureString (e.g., Name: consumerSecret)
      • For all SecureString variables, select the System.Security.SecurityString type.
   4. Repeat steps 2-5 to convert your Consumer Secret String to a SecureString.
6. Cree las siguientes, 3 variables:
   1. String with your Security Token as the Default value (e.g., Name: textPassword, Default: ""MUc2B...")
   2. SecureString with New SecureString() as the Default value (e.g., Name: secureSecurityToken, Default:New SecureString())
   3. SecureString (e.g., Name: securityToken)
      • For all SecureString variables, select the System.Security.SecurityString type.
   4. Repeat steps 2-5 to convert your Security Token String to a SecureString.

You should now have three Create Secure String sequences in your process, similar to the image below.

Now that you have your SecureString variables, you can add the Salesforce Application Scope activity along with the other Salesforce activities.

Añadir las actividades de Salesforce

1. Añade la actividad Ámbito de aplicación de Salesforce a tu proyecto.

   1. Antes de introducir los valores de su propiedad, probemos la conexión.

      1. Click the Configure button (this opens the connection wizard).
      2. Select your Server (if connecting to, a developer org or non-developer production org- select "Live", a sandbox/test org - select "Test").
      3. Enter your Consumer Key, Consumer Secret, Username, Password, and Security Token (required for developer logins).
      4. Click the Test Connection button and wait for the Connection Successful window.

         • Si recibes un error, asegúrate de haber seleccionado el servidor correcto. A continuación, intenta restablecer tu token de seguridad siguiendo el último paso de la guía Obtener tus credenciales en la configuración e introduce el nuevo valor que se te ha enviado por correo electrónico.

           

      5. Después de una conexión correcta, ahora puede añadir sus valores de propiedad, incluidas las variables SecureString que creó en los pasos anteriores (los valores introducidos en el asistente de conexión son independientes de los valores de propiedad y no se comparten).

   2. Introduce el valor de tu ConsumerKey (String) que copiaste al completar los pasos Obtener tus credenciales .

   3. In the ConsumerSecret property, enter the second SecureString variable you created in step 6 above (e.g., consumerSecret).

   4. In the Password property, enter the second SecureString variable you created in step 1 above (e.g., password).

   5. Enter your Server value ("Live" or "Test").

   6. Introduzca su nombre de usuario de inicio de sesión de Salesforce (por ejemplo, "[e-mail]")

   7. For the SalesforceConnection property, create and enter a IConnectionService variable (e.g., salesforceConnection).

      • No usará esta variable cuando complete los pasos de esta guía, pero es una buena práctica crear sus variables de salida para usarlas en actividades posteriores.

        

   8. Añade la actividad Insertar registro en la actividad Ámbito de aplicación de Salesforce .

   9. Create a new String variable for this activity's output property (e.g., newAccountID).

   10. Click the Configure button (this opens the Salesforce Object Wizard).

       • Para obtener más información sobre cómo funciona el asistente, consulta la sección Asistente de objetos de Salesforce en la página Acerca de las actividades de Salesforce .

   11. In the Salesforce Object drop-down list, select Account (the Account ID and Name fields should appear).

   12. In the Add Single Field text box, enter Type and click Enter (you should now have 3 fields).

   13. In the Account ID field, enter the String variable you created in step 1 (e.g., newAcountID).

   14. Enter a Name for the Account (e.g., "Salesforce Quickstart").

   15. Enter a valid Type String (e.g., "Prospect").

       • All fields with a picklist Data Type require a String value that matches an item in the list as shown in the Salesforce user interface.

         • Utilizando el campo Tipo como ejemplo, la lista de selección incluye de forma predeterminada los valores que se muestran en la imagen a continuación (de la pantalla Cuenta de Salesforce). Puedes utilizar la actividad Formatear etiquetas y valores para obtener una vista previa de los valores String válidos (consulta el ejemplo a continuación).

           

       • Click Done.

         

   16. In the SalesforceOutput property, create and enter a SalesforceStatus variable (e.g., insertRecordStatus).

       

2. Añade la actividad Cargar archivo después de la actividad Insertar registro .

   1. Enter your file Description, FilePath, and Title.

   2. In the OutputID property, create and enter a new String variable (e.g., newFileID).

   3. In the SalesforceStatus property, create and enter a new SalesforceStatus variable (e.g., uploadFileStatus).

      

3. Añade la actividad Asignar archivo después de la actividad Obtener registro .

   1. In the Id property, enter the String variable you created for the Upload File activity (e.g., newFileID).

   2. In the RecordId property, enter the String variable you created for the Insert Activity activity (e.g., newAccountID).

   3. Enter a ShareType value (e.g., "I" for Inferred).

   4. Enter a Visibility value (e.g., "AllUsers").

   5. In the SalesforceStatus property, create and enter a new SalesforceStatus variable (e.g., assignFileStatus).

      

Pruebe su proyecto

1. Para verificar que tu registro se insertó, se cargó el archivo y se asignó al registro insertado, añade 3 actividades después de la actividad Asignar archivo .

   1. In the first Write Line activity, enter the following Text: "Insert Record Success: "+insertRecordStatus.Success.ToString.

      • insertRecordStatus is the SalesforceStatus variable you created for the Insert Record activity.

   2. In the second Write Line activity, enter the following Text: "Upload File Success: "+uploadFileSuccess.Success.ToString.

      • uploadFileStatus is the SalesforceStatus variable you created for the Upload File activity.

   3. In the third Write Line activity, enter the following Text: "Upload File Success: "+assignFileSuccess.Success.ToString.

      • assignFileStatus is the SalesforceStatus variable you created for the Assign File activity.

   4. Click Start and verify the results in the output window.

      

2. To further verify your results, login to your Salesforce Org and go to your Accounts and Files to see your new additions.

   

   

¡Ya está! Ahora tienes un proyecto de automatización que incluye actividades de Salesforce. Para obtener más información sobre las actividades de Salesforce, consulta Actividades para obtener enlaces a las páginas de detalles de la actividad.

Para promover tu automatización de Salesforce, consulta la documentación de UiPath Connector para Salesforce . El conector de UiPath para Salesforce crea una conexión "servidor-servidor" entre Salesforce y UiPath Orchestrator (instancias locales o en la nube). Te da la posibilidad de enviar trabajos de UiPath o añadir elementos de cola desde Salesforce a través de Flow Builder, Process Builder o Workflow.