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 SecureString variables para sus credenciales de Salesforce y métodode invocación.
2. Establece una conexión con su organización de Salesforce utilizando sus credenciales de SecureString (ámbito de la aplicación Salesforce)
3. Crea un nuevo registro de cuenta de Salesforce (Insertar registro).
4. Carga un archivo a su organización de Salesforce (Cargar archivo).
5. Asigna el archivo cargado a su nueva cuenta de Salesforce (Asignar archivo).
6. Verifica los resultados de las actividades Insertar registro, Cargar archivoy Asignar archivo generando cada uno de sus objetos SalesforceStatus ().

Requisitos previos

Antes de comenzar:

1. Complete los pasos de configuración de Salesforce.

2. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.
   2. En Nuevo proyecto, haz clic en Proceso (se abre una ventana Nuevo proceso en blanco ).
   3. Introduce un Nombre, una Ubicacióny una Descripcióndel proyecto.

   4. Haz clic en Crear.

      
      

      

      
      

3. Instale el paquete UiPath.Salesforce.Activities .

   1. En la cinta Diseño , haz clic en Administrar paquetes (se abre la ventana Administrar paquetes ).
   2. En Todos los paquetes, haz clic en Oficial.
   3. En la barra de búsqueda , escribe Salesforce.

   4. Haga clic en, instale y acepte la licencia de 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 SecureString tipos de datos para las propiedades Secreto del consumidor, Contraseñay Token de seguridad . Para obtener estos SecureString tipos de datos, convierte los String valores que almacenaste para estas propiedades al completar los pasos de Obtén tus credenciales en la guía de configuración .

Nota:

Los siguientes pasos están destinados a demostrar cómo convertir un String en un SecureString. Para simplificar y 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 son de ejemplo.

Al crear proyectos compartibles o que no son de ejemplo, puede crear y hacer referencia a flujos de trabajo externos que obtengan su Secreto del Consumidor, Contraseñay Token de Seguridad de una fuente local (por ejemplo, .txt, .xlsx files) y realice la conversión utilizando los argumentos <in> y <out>.

Convertir cadenas en SecureStrings

1. Cree las siguientes tres variables:

   1. String con su contraseña de inicio de sesión de Salesforce como valor predeterminado (por ejemplo, Nombre: textPassword, Predeterminado: "UiPath123")
   2. SecureString con Nueva SecureString () como valor predeterminado (por ejemplo, Nombre: contraseña segura, Predeterminado:Nueva SecureString ())
   3. SecureString (p. Ej., Nombre: contraseña)
      • Para todas las variables SecureString , selecciona el tipo System.SeguridadString .
   4. Añadir una nueva declaración al proceso.
   • Recomendación: cambie el Nombre para mostrar a "Crear CadenaSegura - Contraseña" o algo para facilitar la identificación de su propósito.

2. Añade una actividad dentro de la Secuencia.

   1. En la propiedad TypeArgument , selecciona System.Char.
   2. En la propiedad Valores , introduce la variable String (p. Ej., TextPassword).

3. En la actividad Para cada , añade la actividad InvocarMétodo (Programación> Ejecutar> InvocarMétodo).

   1. En la propiedad TargetObject , introduzca su primera SecureString variable (p. Ej., SecurePassword)
      • Asegúrese de que la propiedad TargetType sea (nula) (se permite TargetObject o TargetType , no ambos).

   2. En la propiedad MethodName , introduce attachChar.

      • El método attachChar se usa para añadir una unidad de código UTF-16 después de la cadena.
   3. En la propiedad Parámetros , añade un nuevo parámetro utilizando los siguientes valores: Dirección: Entrada, Tipo: System.Char, Valor: item.

4. Añade la actividad después de la actividad InvokeMethod .

   1. En la propiedad Para , introduce tu segunda variable SecureString (p. Ej., Contraseña).
   2. En la propiedad Valor , introduce tu primera SecureString variable (p. Ej., _SecurePassword).
      
      

      

      
      

5. Cree las siguientes tres variables:

   1. String con su secreto de consumidor como valor predeterminado (p. Ej., Nombre: textPassword, Predeterminado: "4FA94 ...")
   2. SecureString con New SecureString () como valor predeterminado (por ejemplo, Nombre: SecureConsumerSeret, Predeterminado:New SecureString ())
   3. SecureString (p. Ej., Nombre: SecretoDelConsumidor)
      • Para todas las variables SecureString , selecciona el tipo System.SeguridadString .
   4. Repite los pasos 2-5 para convertir su Secreto de consumidor String en un SecureString.

6. Cree las siguientes, 3 variables:

   1. String con su token de seguridad como valor predeterminado (p. Ej., Nombre: textPassword, Predeterminado: "" MUc2B ... ")
   2. SecureString con Nueva CadenaSegura () como valor predeterminado (por ejemplo, Nombre: tokenDeSeguridadSeguro, Predeterminado:Nueva SecureString ())
   3. SecureString (p. Ej., Nombre: tokenDeSeguridad)
      • Para todas las variables SecureString , selecciona el tipo System.SeguridadString .
   4. Repite los pasos 2-5 para convertir tu token de seguridad String en un SecureString.

Ahora debería tener tres secuencias Crear cadena segura en su proceso, similares a la imagen de abajo.

Ahora que tiene sus variables SecureString , puede agregar la actividad Ámbito de aplicación de Salesforce junto con las otras actividades de Salesforce.

Añadir las actividades de Salesforce

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

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

      1. Haz clic en el botón Configurar (se abre el asistente de conexión).
      2. Seleccione su servidor (si se conecta a, una organización de desarrollador u organización de producción que no sea de desarrollador, seleccione "En directo", una organización de prueba / sandbox seleccione "Prueba").
      3. Introduce tu clavede consumidor, secretode consumidor, nombre de usuario, contraseñay token de seguridad (obligatorio para los inicios de sesión de desarrollador).

      4. Haz clic en el botón Probar conexión y espera la ventana Conexión correcta .

         • Si recibe un error, asegúrese de haber seleccionado el servidorcorrecto. A continuación, intente restablecer su token de seguridad siguiendo el último paso de la guía Obtenga sus credenciales en la configuración e introduzca el nuevo valor que se le 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. Introduzca el valor de la Clave del consumidor (String) que copió al completar los pasos de Obtenga sus credenciales .
   3. En la propiedad SecretoDelConsumidor , introduce la segunda variable SecureString que creaste en el paso 6 anterior (p. Ej., SecretoDelConsumidor).
   4. En la propiedad Contraseña , introduce la segunda variable SecureString que creaste en el paso 1 anterior (p. Ej., La contraseña).
   5. Introduce el valor de tu servidor ("En directo" o "Prueba").
   6. Introduzca su nombre de usuario de inicio de sesión de Salesforce (por ejemplo, "[e-mail]")
   7. Para la propiedad ConexiónDeSalesforce , crea e introduce una variable IConnectionService (por ejemplo, ConexiónDeSalesforce).

      • 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 la aplicación de Salesforce .
   9. Crea una nueva variable String para la propiedad de salida de esta actividad (por ejemplo, newAccountID).

   10. Haga clic en el botón Configurar (esto abre el Asistente de objetos de Salesforce).

       • Para obtener más información sobre cómo funciona el asistente, consulta la sección Asistente para objetos de Salesforce en la página Acerca de las actividades de Salesforce .
   11. En la lista desplegable Objeto de Salesforce , seleccione Cuenta (deben aparecer los campos ID de cuenta y Nombre ).
   12. En el cuadro de texto Agregar un solo campo , escribe Tipo y haz clic en Intro (ahora deberías tener 3 campos).
   13. En el campo ID de cuenta , introduce la variable String que creaste en el paso 1 (p. Ej., NewAcountID).
   14. Introduzca un nombre para la cuenta (por ejemplo, "Inicio rápido de Salesforce").
   15. Introduce un tipo String válido (p. Ej., "Cliente potencial").
       • Todos los campos con un tipo de datos picklist requieren un valor String que coincida con un elemento de la lista, como se muestra en la interfaz de usuario de Salesforce.
         • Usando 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 usar la actividad Etiquetas y valores de formato para previsualizar los valores String válidos (consulta el ejemplo a continuación).
           
           

           

           
           

       • Haz clic en Listo.

         
         

         

         
         
   16. En la propiedad SalidaDeSalesforce , crea e introduce una variable SalesforceStatus (por ejemplo, insertRecordStatus).
       
       

       

       
       

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

   1. Introduce la Descripción, la Rutadel archivo y el Títulode tu archivo.
   2. En la propiedad IDDeSalida , crea e introduce una nueva variable String (por ejemplo, nuevo IDDeArchivo).
   3. En la propiedad EstadoDeSalesforce , crea e introduce una nueva variable SalesforceStatus (por ejemplo, cargar EstadoDeArchivo).
      
      

      

      
      

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

   1. En la propiedad ID , introduce la variable String que creaste para la actividad Cargar archivo (p. Ej., NewFileID).
   2. En la propiedad IDDeRegistro , introduce la variable String que creaste para la actividad Insertar actividad (p. Ej., NewAccountID).
   3. Introduce un valor de ShareType (por ejemplo, "I" para Inferido).
   4. Introduce un valor de visibilidad (p. Ej., "Todos los usuarios").
   5. En la propiedad EstadoDeSalesforce , crea e introduce una nueva variable SalesforceStatus (por ejemplo, asignar EstadoDeArchivo).
      
      

      

      
      

Pruebe su proyecto

1. Para verificar que su registro se insertó, se cargó un archivo y se asignó al registro insertado, agregue 3 actividades después de la actividad Asignar archivo .

   1. En la primera actividad Escribir línea , introduzca el siguiente texto: "Insertar registro correcto:" + insertRecordStatus.Success.ToString.

      • insertRecordStatus es la variable SalesforceStatus que creaste para la actividad Insertar registro .

   2. En la segunda actividad Escribir línea , introduce el siguiente texto: "Cargar archivo correctamente:" + uploadFileSuccess.Success.ToString.

      • cargar EstadoDeArchivo es la variable SalesforceStatus que creaste para la actividad Cargar archivo .

   3. En la tercera actividad Escribir línea , introduce el siguiente texto: "Carga de archivo correcta:" + asignarDeExitoDeArchivo.ParaString.

      • Asignar EstadoDelArchivo es la variable SalesforceStatus que creaste para la actividad Asignar archivo .

   4. Haz clic en Iniciar y verifica los resultados en la ventana de salida.

      
      

      

      
      

2. Para verificar aún más sus resultados, inicie sesión en su organización de Salesforce y vaya a Cuentas y archivos para ver sus nuevas incorporaciones.

   
   

   

   
   
   
   

   

   
   

¡Listo! Ahora tiene un proyecto de automatización que incluye actividades de Salesforce. Para obtener más información sobre las actividades de Salesforce, consulte Actividades para obtener enlaces a las páginas de detalles de las actividades.

Para promover su automatización de Salesforce, consulte la documentación de Conector de UiPath para Salesforce . El Conector de UiPath para Salesforce crea una conexión de "servidor - servidor" entre Salesforce y UiPath Orchestrator (instancias locales o en la nube). Le da la capacidad de enviar trabajos de UiPath o agregar elementos de cola desde Salesforce a través de Flow Builder, Process Builder o Workflow.