Über das Salesforce-Aktivitätspaket

Mit dem Paket UiPath.Salesforce.Activities können Sie Salesforce-Prozesse automatisieren. Es kann über den Salesforce Application Scope eine Verbindung mit einer Salesforce-Organisation herstellen und Ihnen neben den restlichen Aktivitäten die Durchführung von Actions wie Dateimanipulation, Datensatzmanipulation, Ausführung von Berichten und Ausführung von SOQL-Befehlen ermöglichen.

Sobald die Verbindung zur Salesforce-Organisation hergestellt wurde, kann sie in einem IConnectionService -Objekt gespeichert und in allen nachfolgenden untergeordneten Scope-Aktivitäten problemlos wiederverwendet werden. Die Anmeldeinformationen für die Verbindung werden mithilfe der Microsoft .NET Data Protection API (DPAPI) verschlüsselt und können nur von demselben Benutzer und auf derselben Maschine abgerufen werden, auf der sie eingegeben wurden.

Voraussetzungen

Für die Verwendung der Salesforce-Aktivitäten sind sowohl ein Salesforce-Konto als auch eine Salesforce Connected App erforderlich. Diese können von Ihrem Salesforce-Administrator bezogen werden.

Alternativ können RPA-Entwickler ein Salesforce Developer -Konto zum Automatisieren von Prozessen in Salesforce verwenden.

Das SalesforceStatus-Objekt

Alle Aktivitäten, die eine Datenmanipulation in Salesforce durchführen, geben einen proprietären Datentyp namens SalesforceStatuszurück. Dieses Objekt enthält Details zum Status der Ausführung jeder Aktivität in Interaktion mit Salesforce. Das Objekt ist so strukturiert, dass es die folgenden Eigenschaften enthält:

• Erfolg – Gibt an, ob die Aktion erfolgreich war oder ein Fehler ausgelöst wurde.
• ErrorCode – Falls bei der Ausführung ein Fehler ausgegeben wird, wird der Fehlercode von Salesforce zurückgegeben.
• Meldung – Falls bei der Ausführung ein Fehler ausgegeben wird, wird die Fehlermeldung von Salesforce zurückgegeben.

Der Salesforce-Objekt-Assistent

Die Aktivitäten Get Record, Insert Recordund Update Record können mithilfe des Salesforce-Objekt- Assistenten konfiguriert werden. Wenn Sie auf die Schaltfläche Konfigurieren im Hauptteil der Aktivitäten klicken, wird dieses Fenster geöffnet.

In der Dropdownliste Salesforce-Objekt können Sie das Objekt auswählen, mit dem Sie interagieren möchten, und alle Details anzeigen. Der erste Datensatz in diesem Objekt wird auch als Beispieldatensatz abgerufen. Die Spalte Beispielwert zeigt den Wert des Felds für diesen Datensatz an.

Hinweis: Wenn ein Salesforce-Objekt ausgewählt ist, wird die Liste der Felder mit der Liste der Felder ausgefüllt, die in allen Layouts des Objekts in Salesforce als obligatorisch markiert sind. Aufgrund der Einschränkung der verfügbaren Konfigurationsdetails von Salesforce kann es mehr Felder geben, die obligatorisch sind, aber nicht standardmäßig hinzugefügt werden. Verwenden Sie Test mit Beispielwerten , um die Aktivität zu testen.

Mit dem Textfeld Einzelnes Feld hinzufügen können Sie dem ausgewählten Objekt Felder hinzufügen. Die Schaltfläche Mehrere Felder hinzufügen öffnet einen anderen Abschnitt des Assistenten, in dem Sie mehrere Felder auswählen können, die dem Objekt hinzugefügt werden sollen. Aktivieren Sie dazu die Häkchen für alle Felder, die Sie hinzufügen möchten, und klicken Sie auf Fertig.

Hinweis: In der Aktivität „ Datensatz einfügen“ sind nur die Felder verfügbar, die als von der Salesforce Lightning API erstellt werden dürfen. In der Aktivität Datensatz aktualisieren sind nur die Felder verfügbar, die als aktualisierbar identifiziert wurden.

Wenn Sie erneut auf Fertig klicken, werden die Änderungen gespeichert, die Sie an der Aktivität vorgenommen haben, die konfiguriert wurde.

Die Aktivitäten Datensatz einfügen und Datensatz aktualisieren haben auch die Möglichkeit, den Vorgang mit Beispielwerten zu testen. Klicken Sie dazu auf die Schaltfläche Mit Beispielwerten testen . Dadurch werden die Vorgänge mit den Werten in der Spalte Beispielwert ausgeführt und Erfolg oder Fehler gemeldet.

Salesforce-Objektfelder und -Datentyp

In den Aktivitäten Get Record, Insert Recordund Update Record werden alle Feldwerte als Stringübergeben.

Bei Feldern mit dem Datentyp Picklist muss die übergebene Zeichenfolge der gültige Wert und nicht die Bezeichnung sein, wie sie in der Anwendung angezeigt wird. Verwenden Sie die Aktivität Format Labels And Values , um die Zeichenfolge korrekt einzurichten.

Bei Feldern mit dem Datentyp Multiplicklist muss die übergebene Zeichenfolge eine Liste der gültigen Werte sein, die durch Semikolons und nicht die Beschriftungen getrennt sind, wie in der Anwendung angezeigt. Verwenden Sie die Aktivität Format Labels And Values , um die Zeichenfolge korrekt einzurichten.

Bei Feldern mit dem Datentyp Boolean muss die übergebene Zeichenfolge true oder falsesein. Beachten Sie Folgendes: Wenn Salesforce diese Werte in der Aktivität „ Get Record “ zurückgibt, können die in der Spalte Beispielwert angezeigten Werte entweder True, True, Falseoder Falsesein, je nachdem, wie die Daten ursprünglich in Salesforce eingegeben wurden.

Bei Feldern mit dem Datentyp Date muss die übergebene Zeichenfolge das Format YYYY-MM-DDhaben.

Salesforce-Erweiterungsfunktionen

Wir haben zwei neue Funktionen implementiert, die mit dem Salesforce- Aktivitätspaket geliefert werden und Ihnen helfen, Prozesse in Salesforce besser zu automatisieren:

Als Boolean formatieren

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceFormatAsBoolean(String Value)

Die Eingabe eines Werts vom Typ Boolean, der nicht das von Salesforce unterstützte Format aufweist, löst zur Laufzeit einen Fehler aus. Mit der Funktion SalesforceFormatAsBoolean können Sie jeden booleschen Werttyp in einer Zeichenfolge in das von Salesforce unterstützte Format konvertieren.

Unterstützte Werte

Für Truesind die folgenden Werte konvertierbar: 1, x, t, true, yes, y.

Für Falsesind die folgenden Werte konvertierbar: 0, null, f, false, no, n.

Hinweis: Bei allen oben genannten Werten wird die Groß-/Kleinschreibung nicht beachtet (d. h., sie werden unabhängig davon identifiziert, ob sie groß geschrieben sind oder nicht) und werden von jedem verfügbaren Alphabet erkannt.

Escape-Suchbegriff

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceEscapeSearchTerm(String SearchTerm, Boolean IsLike = true)

Diese Funktion maskiert Suchbegriffe, die in der Eigenschaft SOQLCommand in der Aktivität SOQL ausführen verwendet werden können, wie von Salesforce erforderlich. Weitere Informationen zu Escape in Anführungszeichen in Anführungszeichen finden Sie hier.