Démarrage rapide

Vue d'ensemble (Overview)

L'objectif de ce guide est de vous aider à créer un exemple de travail pour vérifier rapidement la connexion à votre organisation Salesforce et à vous familiariser avec les types de données d'entrée/sortie des activités incluses.

Une fois les étapes de ce guide terminées, vous disposerez d'une séquence d'automatisation qui effectuera les opérations suivantes :

1. Crée des variables SecureString pour vos informations d'identification Salesforce et votre méthode d'appel.
2. Établit une connexion à votre organisation Salesforce à l’aide de vos SecureString informations d’identification (Étendue de l’application Salesforce)
3. Crée un nouvel enregistrement de compte Salesforce (Insérer un enregistrement).
4. Charge un fichier dans votre organisation Salesforce (Upload File).
5. Attribue le fichier téléchargé à votre nouvel enregistrement de compte Salesforce (Attribuer un fichier).
6. Vérifie les résultats des activités Insérer un enregistrement, Télécharger le fichier et Affecter un fichier en extrayant chacun de leurs objets StatutSalesforce ().

Prérequis

Avant de commencer :

1. Suivez les étapes de Configuration de Salesforce.
2. Créez un nouveau projet d'automatisation.

   1. Ouvrez UiPath Studio.

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

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

   4. Cliquez sur Créer (Create).

      

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.

      • Pour plus d’informations sur les packages Uipath Studio, consultez la section Gestion des packages dans le guide de Studio.

        

Étapes

Construisez votre projet

L’activité Étendue de l’application Salesforce nécessite des types de données SecureString pour les propriétés d’entrée Clé secrète du consommateur, Mot de passe et JetonSécurité . Pour obtenir ces types de données SecureString , vous convertissez les valeurs String que vous avez stockées pour ces propriétés lorsque vous effectuez les étapes Obtenir vos informations d’identification dans le guide de configuration .

Remarque :

Les étapes ci-dessous sont destinées à montrer comment convertir une String en SecureString Par souci de simplicité et pour vous aider à créer rapidement un exemple pratique, la conversion est effectuée dans votre séquence de projet et vous oblige à saisir vos valeurs d’informations d’identification en tant que variables. Cela n’est pas recommandé lors de la création de projets partageables ou sans exemples. Lors de la création de projets partageables ou non-exemple, vous pouvez créer et référencer des workflows externes qui obtiennent votre Clé secrète client, votre mot de passe et votre JetonSécurité à partir d’une source locale (par exemple, .txt, fichier.xlsx et effectuerons la conversion à l'aide de et arguments.

Convertir des chaînes en SecureStrings

1. Créez les trois variables suivantes :
   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. Ajoutez une nouvelle instruction au processus.
   • Recommendation: change the Display Name to "Create SecureString - Password" or something to make it easy to identify its purpose.
2. Ajoutez une activité dans la séquence.
   1. In the TypeArgument property, select System.Char.
   2. In the Values property, enter the String variable (e.g., textPassword).
3. Dans l'activité Pour chaque , ajoutez l'activité Appeler la méthode (Programme > Exécuter > Appeler la méthode).
   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.
      • La méthode AppendChar est utilisée pour ajouter une unité de code UTF-16 après la chaîne.
   3. In the Parameters property, add a new parameter using the following values: Direction: In, Type: System.Char, Value: item.
4. Ajoutez l'activité sous l'activité Appeler la méthode .

   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. Créez les trois variables suivantes :
   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. Créez les 3 variables suivantes :
   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.

Ajouter les activités Salesforce

1. Ajoutez l’activité Étendue de d’application Salesforce à votre projet.

   1. Avant de saisir les valeurs de vos propriétés, testons votre connexion.

      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 vous recevez un message d'erreur, assurez-vous que vous avez sélectionné le bon serveur. Ensuite, essayez de réinitialiser votre jeton de sécurité en suivant la dernière étape du guide Obtenir vos informations d’identification dans le guide Configuration et entrez la nouvelle valeur qui vous est envoyée par e-mail.

           

      5. Après une connexion réussie, vous pouvez maintenant ajouter vos valeurs de propriété, y compris les variables SecureString que vous avez créées dans les étapes ci-dessus (les valeurs saisies dans l'assistant de connexion sont indépendantes des valeurs de propriété et ne sont pas partagées).

   2. Saisissez votre valeur Clé utilisateur (String) que vous avez copiée lors de la finalisation des étapes Obtenir vos informations d'identification .

   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. Saisissez votre nom d’utilisateur de connexion Salesforce (par ex., "[e-mail]")

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

      • Vous n'utiliserez pas cette variable lors de l'exécution des étapes de ce guide, mais il est recommandé de créer vos variables de sortie pour les utiliser dans les activités suivantes.

        

   8. Ajoutez l’activité Insérer un enregistrement dans l’activité Étendue de l’application 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).

       • Pour en savoir plus sur le fonctionnement de l'assistant, consultez la section Assistant d'objet Salesforce dans la page À propos des activités 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.

         • En utilisant le champ Type comme exemple, la liste de sélection inclut par défaut les valeurs affichées dans l’image ci-dessous (depuis l’écran Compte Salesforce). Vous pouvez utiliser l'activité Formater les libellés et les valeurs pour prévisualiser les valeurs String valides (voir l'exemple ci-dessous).

           

       • Click Done.

         

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

       

2. Ajoutez l'activité Charger le fichier après l'activité Insérer un enregistrement .

   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. Ajoutez l'activité Affecter un fichier après l'activité Obtenir l'enregistrement .

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

      

Tester votre projet

1. Pour vérifier que votre enregistrement a été inséré, que le fichier a été téléchargé et attribué à l’enregistrement inséré, ajoutez 3 activités après l’activité Attribuer un fichier .

   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.

   

   

Vous avez terminé! Vous disposez désormais d'un projet d'automatisation qui inclut des activités Salesforce. Pour en savoir plus sur les activités Salesforce, consultez la section Activités pour obtenir des liens vers les pages de détails des activités.

Pour optimiser votre automatisation Salesforce, consultez la documentation du connecteur UiPath pour Salesforce . Le connecteur UiPath pour Salesforce crée une connexion « serveur - serveur» entre Salesforce et UiPath Orchestrator (instances sur site ou Cloud). Il vous donne la possibilité de soumettre des tâches UiPath ou d'ajouter des éléments de file d'attente depuis Salesforce via le générateur de flux, le générateur de processus ou le workflow.