Schnellstart

Überblick

Dieses Handbuch soll Ihnen helfen, ein funktionierendes Beispiel zu erstellen, um schnell die Verbindung zu Ihrer Salesforce-Organisation zu überprüfen und sich mit den enthaltenen Eingabe-/Ausgabedatentypen der Aktivitäten vertraut zu machen.

Nachdem Sie die Schritte in dieser Anleitung ausgeführt haben, verfügen Sie über eine Automatisierungs-Sequence, die Folgendes ausführt:

1. Erstellt SecureString -Variablen für Ihre Salesforce-Anmeldeinformationen und die Invoke Method.
2. Stellt eine Verbindung mit Ihrer Salesforce-Organisation mithilfe Ihrer SecureString -Anmeldeinformationen her (Salesforce Application Scope)
3. Erstellt einen neuen Salesforce-Kontodatensatz (Datensatz einfügen).
4. Lädt eine Datei in Ihre Salesforce-Organisation hoch (Upload File).
5. Weist die hochgeladene Datei Ihrem neuen Salesforce-Kontodatensatz zu (Assign File).
6. Überprüft die Ergebnisse der Aktivitäten Insert Record, Upload Fileund Assign File , indem jedes ihrer SalesforceStatus-Objekte ausgibt ().

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zur Salesforce -Einrichtung ab.

2. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.
   2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
   3. Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.

   4. Klicken Sie auf Erstellen.

      
      

      

      
      

3. Installieren Sie das UiPath.Salesforce.Activities -Paket.

   1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
   2. Klicken Sie unter Alle Paketeauf Offiziell.
   3. Geben Sie in der Suchleiste Salesforceein.

   4. Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für UiPath.Salesforce.Activities.

      • Weitere Informationen zu Uipath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

        
        

        

        
        

Schritte

Erstellen Sie Ihr Projekt

Die Aktivität Salesforce Application Scope erfordert den Datentyp SecureString für die Eingabeeigenschaften Consumer Secret, Passwordund SecurityToken . Um diese SecureString -Datentypen abzurufen, konvertieren Sie die String -Werte, die Sie bei den Schritten zum Abrufen Ihrer Anmeldeinformationen im Setup- Handbuch für diese Eigenschaften gespeichert haben.

Hinweis:

Die folgenden Schritte sollen veranschaulichen, wie Sie eine String in eine SecureStringkonvertieren können. Der Einfachheit halber und damit Sie schnell ein funktionierendes Beispiel erstellen können, erfolgt die Konvertierung innerhalb Ihrer Projektsequenz und erfordert, dass Sie Ihre Anmeldeinformationen als Variablen eingeben. Dies wird beim Erstellen gemeinsam nutzbarer Projekte oder Projekte, die keine Beispielprojekte sind, empfohlen.

Beim Erstellen gemeinsam nutzbarer Projekte oder Projekte, die nicht als Beispiel dienen, können Sie externe Workflows erstellen und darauf verweisen, die Ihr Consumer Secret, Passwordund SecurityToken aus einer lokalen Quelle abrufen (z. B. TXT, .xlsx Dateien) und führen Sie die Konvertierung mit den Argumenten <in> und <out> durch.

Konvertieren von Strings in SecureStrings

1. Erstellen Sie die folgenden drei Variablen:

   1. String mit Ihrem Salesforce-Anmeldekennwort als Standardwert (z. B. Name: textPassword, Standard: „UiPath123“)
   2. SecureString mit New SecureString() als Standardwert (z. B. Name: securePassword, Default:New SecureString())
   3. SecureString (z. B. Name: Kennwort)
      • Wählen Sie für alle SecureString -Variablen den Typ System.Security.SecurityString aus.
   4. Fügen Sie dem Prozess eine neue Anweisung hinzu.
   • Empfehlung: Ändern Sie den Anzeigenamen in „Create SecureString – Password“ oder etwas, um den Zweck einfacher zu identifizieren.

2. Fügen Sie eine Aktivität innerhalb der Sequence hinzu.

   1. Wählen Sie in der Eigenschaft TypeArgument die Option System.Charaus.
   2. Geben Sie in der Eigenschaft Werte die Variable String ein (z. B. textPassword).

3. Fügen Sie in der For Each -Aktivität die InvokeMethod- Aktivität hinzu (Programmierung > Ausführen > InvokeMethod).

   1. Geben Sie in der Eigenschaft TargetObject Ihre erste SecureString -Variable ein (z. B. securePassword).
      • Stellen Sie sicher, dass die Eigenschaft TargetType (null) ist (entweder TargetObject oder TargetType ist zulässig, nicht beides).

   2. Geben Sie in der Eigenschaft MethodName AppendCharein.

      • Die AppendChar -Methode wird verwendet, um eine UTF-16-Codeeinheit nach der Zeichenfolge hinzuzufügen.
   3. Fügen Sie in der Eigenschaft Parameters einen neuen Parameter mit den folgenden Werten hinzu: Direction: In, Type: System.Char, Value: item.

4. Fügen Sie die Aktivität nach der InvokeMethod- Aktivität hinzu.

   1. Geben Sie in der Eigenschaft An Ihre zweite SecureString -Variable ein (z. B. password).
   2. Geben Sie in der Eigenschaft Wert Ihre erste SecureString -Variable ein (z. B. _securePassword).
      
      

      

      
      

5. Erstellen Sie die folgenden drei Variablen:

   1. String mit Ihrem geheimen Verbrauchergeheimnis als Standardwert (z. B. Name: textPassword, Standard: "4FA94...")
   2. SecureString mit New SecureString() als Standardwert (z. B. Name: secureConsumerSeret, Default:New SecureString())
   3. SecureString (z. B. Name: ConsumerSecret)
      • Wählen Sie für alle SecureString -Variablen den Typ System.Security.SecurityString aus.
   4. Wiederholen Sie die Schritte 2–5, um Ihr Consumer Secret String in ein SecureStringzu konvertieren.

6. Erstellen Sie die folgenden drei Variablen:

   1. String mit Ihrem Sicherheitstoken als Standardwert (z. B. Name: textPassword, Standard: ""MUc2B...")
   2. SecureString mit New SecureString() als Standardwert (z. B. Name: secureSecurityToken, Default:New SecureString())
   3. SecureString (z. B. Name: securityToken)
      • Wählen Sie für alle SecureString -Variablen den Typ System.Security.SecurityString aus.
   4. Wiederholen Sie die Schritte 2–5, um Ihr Sicherheitstoken String in ein SecureStringzu konvertieren.

Ihr Prozess sollte nun drei Create Secure String -Sequenzen haben, ähnlich wie in der Abbildung unten.

Da Sie nun über Ihre SecureString -Variablen verfügen, können Sie die Salesforce Application Scope- Aktivität zusammen mit den anderen Salesforce-Aktivitäten hinzufügen.

Salesforce-Aktivitäten hinzufügen

1. Fügen Sie die Aktivität Salesforce Application Scope zu Ihrem Projekt hinzu.

   1. Bevor Sie Ihre Eigenschaftswerte eingeben, testen wir Ihre Verbindung.

      1. Klicken Sie auf die Schaltfläche Konfigurieren (dadurch wird der Verbindungsassistent geöffnet).
      2. Wählen Sie Ihren Server aus (wenn Sie eine Verbindung mit einer Entwicklerorganisation oder einer Produktionsorganisation ohne Entwickler herstellen – wählen Sie „Live“ aus, eine Sandbox-/Testorganisation – wählen Sie „Testen“ aus).
      3. Geben Sie Ihren Verbraucherschlüssel, Verbrauchergeheimnis, Benutzername, Kennwortund Sicherheitstoken ein (erforderlich für Entwickleranmeldungen).

      4. Klicken Sie auf die Schaltfläche Verbindung testen und warten Sie, bis das Fenster Verbindung erfolgreich angezeigt wird.

         • Wenn Sie einen Fehler erhalten, stellen Sie sicher, dass Sie den richtigen Serverausgewählt haben. Versuchen Sie als Nächstes, Ihr Sicherheitstoken zurückzusetzen, indem Sie den letzten Schritt unter Abrufen Ihrer Anmeldeinformationen in der Setup -Anleitung ausführen und den neuen Wert eingeben, der Ihnen per E-Mail zugeschickt wird.

           
           

           

           
           
      5. Nach einer erfolgreichen Verbindung können Sie nun Ihre Eigenschaftswerte hinzufügen, einschließlich der SecureString -Variablen, die Sie in den obigen Schritten erstellt haben (die im Verbindungsassistenten eingegebenen Werte sind unabhängig von den Eigenschaftswerten und werden nicht freigegeben).
   2. Geben Sie Ihren ConsumerKey- Wert (String) ein, den Sie beim Abschließen der Schritte zum Abrufen Ihrer Anmeldeinformationen kopiert haben.
   3. Geben Sie in der Eigenschaft ConsumerSecret die zweite SecureString -Variable ein, die Sie in Schritt 6 oben erstellt haben (z. B. ConsumerSecret).
   4. Geben Sie in der Eigenschaft Kennwort die zweite SecureString -Variable ein, die Sie in Schritt 1 oben erstellt haben (z. B. Kennwort).
   5. Geben Sie Ihren Serverwert ein („Live“ oder „Test“).
   6. Geben Sie Ihren Salesforce-Anmeldebenutzernamen ein (z. B. „ [e-mail] “)
   7. Erstellen Sie für die Eigenschaft SalesforceConnection eine IConnectionService -Variable (z. B. salesforceConnection), und geben Sie sie ein.

      • Sie verwenden diese Variable nicht, wenn Sie die Schritte in diesem Handbuch ausführen, aber es empfiehlt sich, Ihre Ausgabevariablen für die Verwendung in nachfolgenden Aktivitäten zu erstellen.

        
        

        

        
        
   8. Fügen Sie die Aktivität Insert Record in der Aktivität Salesforce Application Scope hinzu.
   9. Erstellen Sie eine neue Variable String für die Ausgabeeigenschaft dieser Aktivität (z. B. newAccountID).

   10. Klicken Sie auf die Schaltfläche Konfigurieren (dadurch wird der Salesforce-Objektassistent geöffnet).

       • Weitere Informationen zur Funktionsweise des Assistenten finden Sie im Abschnitt Salesforce-Objekt-Assistent auf der Seite Über Salesforce-Aktivitäten .
   11. Wählen Sie in der Dropdownliste Salesforce-Objekt die Option Konto aus (die Felder Konto-ID und Name sollten angezeigt werden).
   12. Geben Sie im Textfeld Einzelnes Feld hinzufügen Typ ein, und klicken Sie auf Eingabe (Sie sollten jetzt über 3 Felder verfügen).
   13. Geben Sie im Feld Konto-ID die Variable String ein, die Sie in Schritt 1 erstellt haben (z. B. newAcountID).
   14. Geben Sie einen Namen für das Konto ein (z. B. „Salesforce Quickstart“).
   15. Geben Sie einen gültigen Typ String ein (z. B. „Prospect“).
       • Alle Felder mit einem picklist -Datentyp erfordern einen String -Wert, der einem Element in der Liste entspricht, wie in der Salesforce-Benutzeroberfläche angezeigt.
         • Am Beispiel des Felds „ Typ “ als Beispiel enthält die Auswahlliste standardmäßig die in der Abbildung unten gezeigten Werte (aus dem Bildschirm „Salesforce-Konto“). Sie können die Aktivität Format Labels And Values verwenden, um eine Vorschau der gültigen String -Werte anzuzeigen (siehe Beispiel unten).
           
           

           

           
           

       • Klicken Sie auf Fertig.

         
         

         

         
         
   16. Erstellen Sie in der SalesforceOutput -Eigenschaft eine SalesforceStatus -Variable (z. B. insertRecordStatus), und geben Sie sie ein.
       
       

       

       
       

2. Fügen Sie die Aktivität Upload File nach der Aktivität Insert Record hinzu.

   1. Geben Sie Ihre Dateibeschreibung, den Dateipfadund den Titelein.
   2. Erstellen Sie in der Eigenschaft OutputID eine neue String -Variable (z. B. newFileID), und geben Sie sie ein.
   3. Erstellen Sie in der Eigenschaft SalesforceStatus eine neue SalesforceStatus -Variable (z. B. uploadFileStatus), und geben Sie sie ein.
      
      

      

      
      

3. Fügen Sie die Aktivität Assign File nach der Aktivität Get Record hinzu.

   1. Geben Sie in der Eigenschaft Id die Variable String ein, die Sie für die Aktivität Datei hochladen erstellt haben (z. B. newFileID).
   2. Geben Sie in der Eigenschaft RecordId die Variable String ein, die Sie für die Aktivität Insert Activity erstellt haben (z. B. newAccountID).
   3. Geben Sie einen ShareType- Wert ein (z. B. „I“ für Abgeleitet).
   4. Geben Sie einen Sichtbarkeitswert ein (z. B. „AllUsers“).
   5. Erstellen Sie in der Eigenschaft SalesforceStatus eine neue SalesforceStatus -Variable (z. B. AssignFileStatus), und geben Sie sie ein.
      
      

      

      
      

Testen Sie Ihr Projekt

1. Um zu überprüfen, ob Ihr Datensatz eingefügt, die Datei hochgeladen und dem eingefügten Datensatz zugewiesen wurde, fügen Sie drei Aktivitäten nach der Aktivität Datei zuweisen hinzu.

   1. Geben Sie in der ersten Write Line- Aktivität den folgenden Textein: „Insert Record Success: „+insertRecordStatus.Success.ToString.

      • insertRecordStatus ist die Variable SalesforceStatus , die Sie für die Aktivität „ Datensatz einfügen“ erstellt haben.

   2. Geben Sie in der zweiten Aktivität „ Write Line “ den folgenden Textein: „Upload File Success: „+uploadFileSuccess.Success.ToString.

      • uploadFileStatus ist die Variable SalesforceStatus , die Sie für die Aktivität Datei hochladen erstellt haben.

   3. Geben Sie in der dritten Aktivität „ Write Line “ den folgenden Textein: „Upload File Success: „+assignFileSuccess.Success.ToString.

      • AssignFileStatus ist die Variable SalesforceStatus , die Sie für die Aktivität „ Assign File “ erstellt haben.

   4. Klicken Sie auf Start und überprüfen Sie die Ergebnisse im Ausgabefenster.

      
      

      

      
      

2. Um Ihre Ergebnisse weiter zu überprüfen, melden Sie sich bei Ihrer Salesforce-Organisation an und wechseln Sie zu Ihren Konten und Dateien , um Ihre Neuzugänge anzuzeigen.

   
   

   

   
   
   
   

   

   
   

Alles erledigt! Sie haben jetzt ein Automatisierungsprojekt, das Salesforce-Aktivitäten enthält. Weitere Informationen zu den Salesforce-Aktivitäten finden Sie unter Aktivitäten . Dort finden Sie die Links zu den Aktivitätsdetailseiten.

Weitere Informationen zu Ihrer Salesforce-Automatisierung finden Sie in der Dokumentation zu UiPath Connector für Salesforce . Der UiPath Connector für Salesforce erstellt eine „Server – Server“-Verbindung zwischen Salesforce und UiPath Orchestrator (lokale oder Cloud-Instanzen). Sie haben die Möglichkeit, UiPath-Aufträge zu senden oder Warteschlangenelemente aus Salesforce über Flow Builder, Process Builder oder Workflow hinzuzufügen.