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 Invoke Method.
2. Établit une connexion à votre organisation Salesforce à l'aide de vos informations d'identification SecureString (Étendue de l'application Salesforce (Salesforce Application Scope)
3. Crée un nouvel enregistrement de compte Salesforce ( Insérer un enregistrement (Insert Record)).
4. Télécharge un fichier dans votre organisation Salesforce (Télécharger le fichier ( Télécharger le fichier)).
5. Affecte le fichier téléchargé à votre nouvel enregistrement de compte Salesforce ( Affecter fichier (Assign File) ).
6. Vérifie les résultats des activités Insérer un enregistrement ( Insert Record ), Télécharger le fichier ( Upload File ) et Attribuer un fichier ( Assign File ) en sortant chacun de leurs objets StatutSalesforce (SalesforceStatus ) ().

Prérequis

Avant de commencer :

1. Suivez les étapes de Configuration de Salesforce (Salesforce Setup ).

2. Créez un nouveau projet d'automatisation.

   1. Ouvrez UiPath Studio.
   2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
   3. Saisissez un nomde projet , un emplacementet une description.

   4. Cliquez sur Créer (Create).

      
      

      

      
      

3. Installez le package UiPath.Salesforce.Activities .

   1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
   2. Sous Tous les packages, cliquez sur Officiel ( Official) .
   3. Dans la barre de recherche , saisissez Salesforce.

   4. Cliquez sur, installez et acceptez la licence pour UiPath.Salesforce.Activities.

      • Pour plus d'informations sur les packages Uipath Studio, consultez Gestion des packages dans le Guide de Studio.

        
        

        

        
        

Étapes

Construisez votre projet

L'activité Salesforce Application Scope requiert les types de données SecureString pour les propriétés d'entrée Consumer Secret, Passwordet SecurityToken . 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 avez terminé les étapes Obtenir vos informations d’identification ( Get your credentials ) du guide de configuration .

Remarque :

Les étapes ci-dessous sont destinées à montrer comment vous pouvez convertir un String en SecureString. Pour plus de simplicité et pour vous aider à créer rapidement un échantillon de travail, la conversion est effectuée dans la séquence de votre projet et vous oblige à saisir vos valeurs d'identification sous forme de variables. Cela n'est pas recommandé lors de la création de projets partageables ou de projets sans exemple.

Lors de la création de projets partageables ou sans exemple, vous pouvez créer et référencer des workflows externes qui obtiennent votre clé secrète du consommateur, votre mot de passeet SecurityToken à partir d'une source locale (par exemple, .txt, .xlsx fichiers) et effectuez la conversion à l'aide des arguments <in> et <out>.

Convertir des chaînes en SecureStrings

1. Créez les trois variables suivantes :

   1. String avec votre mot de passe de connexion Salesforce comme valeur par défaut (par exemple, Name: textPassword, Default: "UiPath123")
   2. SecureString avec New SecureString() comme valeur par défaut (par exemple, Name: securePassword, Default:New SecureString())
   3. SecureString (par exemple, Name: password)
      • Pour toutes les variables SecureString , sélectionnez le type System.Security.SecurityString .
   4. Ajoutez une nouvelle instruction au processus.
   • Recommandation : remplacez le nom d'affichage par « Create SecureString - Password » ou quelque chose pour faciliter l'identification de son objectif.

2. Ajoutez une activité à l'intérieur de la Sequence.

   1. Dans la propriété TypeArgument , sélectionnez System.Char.
   2. Dans la propriété Values (Valeurs), entrez la variable String (par exemple, textPassword).

3. Dans l’activité For Each , ajoutez l’activité InvokeMethod (Programming > Execute > InvokeMethod).

   1. Dans la propriété ObjetCible , saisissez votre première variable SecureString (par exemple, securePassword)
      • Assurez-vous que la propriété TypeCible est définie sur (null) (l' objet ObjetCible ou le TypeCible est autorisé, mais pas les deux).

   2. Dans la propriété NomMéthode , entrez AppendChar.

      • La méthode AppendChar est utilisée pour ajouter une unité de code UTF-16 après la chaîne.
   3. Dans la propriété Paramètres (Parameters), ajoutez un nouveau paramètre à l'aide des valeurs suivantes : Direction: In, Type: System.Char, Valeur: élément.

4. Ajoutez l’activité après l’activité InvokeMethod .

   1. Dans la propriété À (To), entrez votre deuxième variable SecureString (par exemple, password).
   2. Dans la propriété Valeur (Value), entrez votre première variable SecureString (par exemple, _securePassword).
      
      

      

      
      

5. Créez les trois variables suivantes :

   1. String avec votre clé secrète consommateur comme valeur par défaut (par exemple, Name: textPassword, Default: "4FA94...")
   2. SecureString avec New SecureString() comme valeur par défaut (par exemple, Name: secureConsumerSeret, Default:New SecureString())
   3. SecureString (par exemple, Name: consumerSecret)
      • Pour toutes les variables SecureString , sélectionnez le type System.Security.SecurityString .
   4. Répétez les étapes 2 à 5 pour convertir votre clé secrète consommateur String en SecureString.

6. Créez les 3 variables suivantes :

   1. String avec votre jeton de sécurité comme valeur par défaut (par exemple, Name: textPassword, Default: ""MUc2B...")
   2. SecureString avec New SecureString() comme valeur par défaut (par exemple, Name: secureSecurityToken, Default:New SecureString())
   3. SecureString (par exemple, Name: securityToken)
      • Pour toutes les variables SecureString , sélectionnez le type System.Security.SecurityString .
   4. Répétez les étapes 2 à 5 pour convertir votre jeton de sécurité String en SecureString.

Vous devriez maintenant avoir trois séquences Create Secure String dans votre processus, similaires à l’image ci-dessous.

Maintenant que vous disposez de vos variables SecureString , vous pouvez ajouter l'activité Étendue de l'application Salesforce avec les autres activités Salesforce.

Ajouter les activités Salesforce

1. Ajoutez l'activité Étendue de l'application Salesforce ( Salesforce Application Scope ) à votre projet.

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

      1. Cliquez sur le bouton Configurer (cela ouvre l'assistant de connexion).
      2. Sélectionnez votre serveur (si vous vous connectez à une organisation de développement ou de production non-développeur - sélectionnez "Live", une organisation sandbox/test - sélectionnez "Test").
      3. Saisissez votre clé consommateur, votre clé secrète consommateur, votre nom d' utilisateur, votre mot de passeet votre jeton de sécurité (requis pour les connexions de développeur).

      4. Cliquez sur le bouton Tester la connexion ( Test Connection) et attendez que la fenêtre Connexion réussie (Connexion réussie) .

         • Si vous recevez un message d'erreur, assurez-vous d'avoir 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 ( Get your credentials ) du guide de configuration et saisissez la nouvelle valeur qui vous a été 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 la valeur CléConsommateur ( ConsumerKey ) (String) que vous avez copiée en suivant les étapes Obtenir vos informations d'identification ( Get your credentials ).
   3. Dans la propriétéSecrèteConsommateur, entrez la deuxième variable SecureString que vous avez créée à l'étape 6 ci-dessus (par exemple,Secrèteconsommateur) .
   4. Dans la propriété Mot de passe (Password), saisissez la deuxième variable SecureString que vous avez créée à l'étape 1 ci-dessus (par exemple, password).
   5. Saisissez la valeur de votre serveur ("Live" ou "Test").
   6. Saisissez votre nom d' utilisateur de connexion Salesforce (par exemple, "[e-mail]")
   7. Pour la propriété SalesforceConnection , créez et entrez une variable IConnectionService (par exemple, 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 ( Insert Record ) à l'activité Étendue de l'application Salesforce ( Salesforce Application Scope ).
   9. Créez une nouvelle variable String pour la propriété de sortie de cette activité (par exemple, newAccountID).

   10. Cliquez sur le bouton Configurer (cela ouvre l'assistant d'objet Salesforce).

       • Pour en savoir plus sur le fonctionnement de l'assistant, consultez la section Assistant d'objet Salesforce ( Salesforce Object Wizard ) sur la page À propos des activités Salesforce .
   11. Dans la liste déroulante Objet Salesforce , sélectionnez Compte (les champs ID de compte et Nom doivent apparaître).
   12. Dans la zone de texte Ajouter un seul champ , saisissez Type (Type) et cliquez sur Entrée (vous devriez maintenant avoir 3 champs).
   13. Dans le champ ID de compte ( Account ID ), saisissez la variable String que vous avez créée à l'étape 1 (par exemple, newAcountID).
   14. Saisissez un nom pour le compte (par exemple, « Salesforce Quickstart»).
   15. Saisissez un Type String valide (par exemple, "Prospect").
       • Tous les champs avec un type de données picklist nécessitent une valeur String qui correspond à un élément de la liste, comme indiqué dans l'interface utilisateur de Salesforce.
         • 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 (provenant de l'écran Compte Salesforce). Vous pouvez utiliser l'activité Format Labels And Values pour prévisualiser les valeurs String valides (voir l'exemple ci-dessous).
           
           

           

           
           

       • Cliquez sur Terminé (Done).

         
         

         

         
         
   16. Dans la propriété SalesforceOutput , créez et entrez une variable SalesforceStatus (par exemple, insertRecordStatus).
       
       

       

       
       

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

   1. Saisissez la Description, le Chemindu fichier et le Titrede votre fichier .
   2. Dans la propriété OutputID , créez et entrez une nouvelle variable String (par exemple, newFileID).
   3. Dans la propriété SalesforceStatus , créez et entrez une nouvelle variable SalesforceStatus (par exemple, uploadFileStatus).
      
      

      

      
      

3. Ajoutez l'activité Assign File après l'activité Get Record .

   1. Dans la propriété Id (Id), saisissez la variable String que vous avez créée pour l'activité Upload File (par exemple, newFileID).
   2. Dans la propriété RecordId , entrez la variable String que vous avez créée pour l' activité Insérer une activité (par exemple, newAccountID).
   3. Saisissez une valeur Type de partage (par exemple, « I » pour Inféré).
   4. Saisissez une valeur de visibilité (par exemple, "AllUsers").
   5. Dans la propriété SalesforceStatus , créez et entrez une nouvelle variable SalesforceStatus (par exemple, assignFileStatus).
      
      

      

      
      

Tester votre projet

1. Pour vérifier que votre enregistrement a été inséré, le fichier téléchargé et affecté à l'enregistrement inséré, ajoutez 3 activités après l'activité Affecter fichier (Assign File).

   1. Dans la première activité Write Line , saisissez le textesuivant : "Insert Record Success: "+insertRecordStatus.Success.ToString.

      • insertRecordStatus est la variable SalesforceStatus que vous avez créée pour l'activité Insérer un enregistrement .

   2. Dans la deuxième activité Write Line , saisissez le textesuivant : "Upload File Success: "+uploadFileSuccess.Success.ToString.

      • uploadFileStatus est la variable SalesforceStatus que vous avez créée pour l'activité Télécharger le fichier ( Upload File ).

   3. Dans la troisième activité Write Line , saisissez le textesuivant : "Upload File Success: "+assignFileSuccess.Success.ToString.

      • assignFileStatus est la variable SalesforceStatus que vous avez créée pour l'activité Assign File .

   4. Cliquez sur Démarrer ( Start) et vérifiez les résultats dans la fenêtre de sortie.

      
      

      

      
      

2. Pour vérifier davantage vos résultats, connectez-vous à votre organisation Salesforce et accédez à vos comptes et fichiers pour voir vos nouveaux ajouts.

   
   

   

   
   
   
   

   

   
   

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

Pour approfondir 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 à partir de Salesforce via Flow Builder, Process Builder ou Workflow.