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-Methode.
2. Stellt eine Verbindung mit Ihrer Salesforce-Organisation mithilfe Ihrer SecureString -Anmeldeinformationen her (Salesforce Application Scope)
3. Erstellt einen neuen Salesforce-Kontodatensatz (Insert Record).
4. Lädt eine Datei in Ihre Salesforce-Organisation hoch (Upload File).
5. Weist die hochgeladene Datei Ihrem neuen Salesforce-Kontodatensatz (Assign File) zu.
6. Überprüft die Ergebnisse der Aktivitäten Insert Record, Upload File und Assign File , indem jedes ihrer SalesforceStatus-Objekte ausgegeben wird ().

Voraussetzungen

Bevor Sie beginnen:

1. Schließen Sie die Schritte zum Salesforce -Setup ab.
2. Erstellen Sie ein neues Automatisierungsprojekt.

   1. Öffnen Sie UiPath Studio.

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

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

   4. Klicken Sie auf Erstellen (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.

      • 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 SecureString Datentypen für die Eingabeeigenschaften Verbrauchergeheimnis, Kennwort und Sicherheitstoken . Um diese SecureString -Datentypen abzurufen, konvertieren Sie die String -Werte, die Sie für diese Eigenschaften gespeichert haben, als Sie die Schritte Abrufen Ihrer Anmeldeinformationen in der Setup- Anleitung ausgeführt haben.

Hinweis:

Die folgenden Schritte sollen veranschaulichen, wie Sie einen String in einen SecureString konvertieren können. Der Einfachheit halber und damit Sie schnell funktionierende Beispiele erstellen können, erfolgt die Konvertierung innerhalb Ihrer Projekt-Sequence und erfordert, dass Sie Ihre Anmeldeinformationswerte als Variablen eingeben. Dies wird beim Erstellen von gemeinsam nutzbaren oder Nicht-Beispielprojekten nicht empfohlen. Beim Erstellen von gemeinsam nutzbaren oder Nicht-Beispielprojekten können Sie externe Workflows erstellen und referenzieren, die Ihr Verbrauchergeheimnis, Ihr Kennwort und SecurityToken aus einer lokalen Quelle abrufen (z. B. .txt, .xlsx Dateien) und führen die Konvertierung mit durch und Argumente.

Konvertieren von Strings in SecureStrings

1. Erstellen Sie die folgenden drei Variablen:
   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. Fügen Sie dem Prozess eine neue Anweisung hinzu.
   • Recommendation: change the Display Name to "Create SecureString - Password" or something to make it easy to identify its purpose.
2. Fügen Sie eine Aktivität innerhalb der Sequence hinzu.
   1. In the TypeArgument property, select System.Char.
   2. In the Values property, enter the String variable (e.g., textPassword).
3. Fügen Sie in der For Each- Aktivität die Aktivität InvokeMethod (Programmierung > Ausführen > InvokeMethod) hinzu.
   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.
      • Die AppendChar- Methode wird verwendet, um eine UTF-16-Codeeinheit nach der Zeichenfolge einzufügen.
   3. In the Parameters property, add a new parameter using the following values: Direction: In, Type: System.Char, Value: item.
4. Fügen Sie die Aktivität nach der Aktivität InvokeMethod hinzu.

   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. Erstellen Sie die folgenden drei Variablen:
   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. Erstellen Sie die folgenden drei Variablen:
   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.

Salesforce-Aktivitäten hinzufügen

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

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

      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.

         • Wenn Sie einen Fehler erhalten, stellen Sie sicher, dass Sie den richtigen Server ausgewählt haben. Versuchen Sie als Nächstes, Ihr Sicherheitstoken zurückzusetzen, indem Sie den letzten Schritt im Abschnitt Abrufen Ihrer Anmeldeinformationen im Setup- Handbuch 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 Verbraucherschlüsselwert (String) ein, den Sie beim Ausführen der Schritte Abrufen Ihrer Anmeldeinformationen kopiert haben.

   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. Geben Sie Ihren Salesforce- Anmeldebenutzernamen ein (z. B. "[e-mail]")

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

      • 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 ein.

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

       • Weitere Informationen zur Funktionsweise des Assistenten finden Sie im Abschnitt Salesforce-Objektassistent auf der Seite Über die Salesforce-Aktivitäten .

   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.

         • Wenn Sie das Feld Typ als Beispiel verwenden: Die Auswahlliste enthält standardmäßig die Werte, die in der folgenden Abbildung angezeigt werden (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).

           

       • Click Done.

         

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

       

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

   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. Fügen Sie die Aktivität Assign File nach der Aktivität Get Record hinzu.

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

      

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 „Assign File“ hinzu.

   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.

   

   

Alles erledigt! Sie haben jetzt ein Automatisierungsprojekt, das Salesforce-Aktivitäten enthält. Weitere Informationen zu Salesforce-Aktivitäten finden Sie unter Aktivitäten für Links zu den Seiten mit Aktivitätsdetails.

Weitere Informationen zur 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 dem UiPath Orchestrator (lokale oder Cloud-Instanzen). Damit haben Sie die Möglichkeit, UiPath-Aufträge einzureichen oder Warteschlangenelemente aus Salesforce über Flow Builder, Prozessgenerator oder Workflow hinzuzufügen.