Salesforce-Module
In einem Adobe Workfront Fusion-Szenario können Sie Workflows automatisieren, die Salesforce verwenden, und sie mit mehreren Anwendungen und Services von Drittanbietern verbinden.
Eine Videoeinführung zum Salesforce-Connector finden Sie unter:
Anweisungen zum Erstellen eines Szenarios finden Sie in den Artikeln unter Erstellen von Szenarios: Artikelindex.
Informationen zu Modulen finden Sie in den Artikeln unter Module: Artikelindex.
- Nicht alle Editionen von Salesforce verfügen über API-Zugriff. Weitere Informationen finden Sie in den Informationen zu Salesforce Editionen mit API-Zugriff auf der Salesforce Community-Site.
- Informationen zu bestimmten Fehlern, die von der Salesforce-API zurückgegeben werden, finden Sie in den Dokumenten zur Salesforce-API. Sie können auch den Status der Salesforce-API auf mögliche Service-Ausfälle überprüfen.
Zugriffsanforderungen
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront-Paket |
Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket Workfront Ultimate Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion. |
| Adobe Workfront-Lizenzen |
Standard Work oder höher |
| Adobe Workfront Fusion-Lizenz |
Betriebsbasiert: keine Workfront Fusion-Lizenz erforderlich Connector-basiert (veraltet): Workfront Fusion for Work Automation and Integration |
| Produkt | Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben. |
Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.
Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.
Voraussetzungen
Um Salesforce-Module verwenden zu können, müssen Sie über ein Salesforce-Konto verfügen.
Salesforce-API-Informationen
Der Salesforce-Connector verwendet Folgendes:
Über die Suche nach Salesforce Objekten
Bei der Suche nach Objekten können Sie entweder einzelne Suchbegriffe eingeben oder eine komplexere Abfrage mit Platzhaltern und Operatoren erstellen:
- Verwenden Sie den Sternchen-Platzhalter (*) als Ersatz für null oder mehr Zeichen. Bei einer Suche nach Ca* werden beispielsweise Elemente gefunden, die mit Ca beginnen
- Mit einem Fragezeichen (?) als Ersatz für ein einzelnes Zeichen. Bei einer Suche nach Jon?n werden beispielsweise Elemente mit dem Begriff John oder Joan, aber nicht Jon gefunden
- Verwenden Sie den Anführungszeichen-Operator (“ „), um eine exakte Übereinstimmung der Phrasen zu finden. Beispiel: „Montagstreffen“
Weitere Informationen zu Suchmöglichkeiten finden Sie in der Salesforce Entwicklerdokumentation zu SOQL und SOSL.
Erstellen einer Verbindung zu den Salesforce
So erstellen Sie eine Verbindung für Ihre Salesforce-Module:
-
Klicken Sie in einem beliebigen Salesforce-Modul neben dem Feld „Verbindung“ auf Hinzufügen.
-
Füllen Sie die folgenden Felder aus:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Verbindungsname Geben Sie einen Namen für die neue Verbindung ein. Umgebung Wählen Sie aus, ob eine Verbindung zu einer Produktions- oder Nicht-Produktionsumgebung hergestellt werden soll. Typ Wählen Sie aus, ob eine Verbindung zu einem Service-Konto oder einem persönlichen Konto hergestellt werden soll. Client-ID Geben Sie Ihre Salesforce-Client-ID ein. Client-Geheimnis Geben Sie Ihr Salesforce-Client-Geheimnis ein. Sandbox Aktivieren Sie diese Option, wenn es sich um eine Sandbox-Umgebung handelt. API-Version Geben Sie die Version der Salesforce-API ein, die Sie verwenden möchten. Die Standardversion ist 62.0. -
Klicken Sie auf Continue, um die Verbindung zu speichern und zum Modul zurückzukehren.
Salesforce-Module und ihre Felder
Auslöser
Feld ansehen
Dieses Feldmodul startet ein Trigger, wenn ein Feld in Salesforce aktualisiert wird.
Auf Datensätze achten
Dieses Trigger-Modul führt ein Szenario aus, wenn ein Datensatz in einem Objekt erstellt oder aktualisiert wird. Das Modul gibt alle Standardfelder zurück, die mit dem Eintrag bzw. den Einträgen verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Ausgehende Nachrichten ansehen
Dieses Trigger-Modul führt ein Szenario aus, wenn jemand eine Nachricht sendet. Das Modul gibt alle Standardfelder zurück, die mit dem Eintrag bzw. den Einträgen verknüpft sind, sowie alle benutzerdefinierten Felder und Werte, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Dieses Modul erfordert einige zusätzliche Einstellungen. Für ausgehende Nachrichten muss ein Fluss konfiguriert sein.
- Anweisungen zu Datenflüssen in Salesforce finden Sie unter Automatisieren von Aufgaben mit Datenflüssen in der Dokumentation zu Salesforce.
- Informationen zum Konfigurieren einer ausgehenden Nachricht in Salesforce finden Sie unter Senden einer ausgehenden Nachricht aus einem datensatzausgelösten Fluss in der Dokumentation zu Salesforce
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Aktionen
Datensatz erstellen
Dieses Aktionsmodul erstellt einen neuen Datensatz in einem -Objekt.
Mit dem Modul können Sie auswählen, welche Objektfelder im Modul verfügbar sind. Dadurch wird die Anzahl der Felder reduziert, die beim Einrichten des Moduls durchgescrollt werden müssen.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Benutzerdefinierter API-Aufruf
Mit diesem Aktionsmodul können Sie einen benutzerdefinierten authentifizierten Aufruf an die Salesforce-API durchführen. Auf diese Weise können Sie eine Datenflussautomatisierung erstellen, was über die anderen Salesforce-Module nicht möglich ist.
Das -Modul gibt Folgendes zurück:
-
Status-Code (Zahl): Gibt den Erfolg oder Misserfolg Ihrer HTTP-Anfrage an. Hierbei handelt es sich um Standard-Codes, die Sie im Internet recherchieren können.
-
Header (Objekt): Ein ausführlicherer Kontext für die Antwort/den Status-Code, der sich nicht auf den Ausgabetext bezieht. Nicht alle Header, die in einem Antwort-Header angezeigt werden, sind Antwort-Header. Einige sind also möglicherweise nicht nützlich für Sie.
Die Antwort-Header hängen von der beim Konfigurieren des Moduls ausgewählten HTTP-Anfrage ab.
-
Text (Objekt): Je nach HTTP-Anfrage, die Sie beim Konfigurieren des Moduls ausgewählt haben, erhalten Sie möglicherweise bestimmte Daten zurück. Diese Daten, z. B. die Daten aus einer GET-Anfrage, sind in diesem Objekt enthalten.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Geben Sie einen Pfad relativ zu <Instance URL>/services/data/v62.0/ ein.
Eine Liste der verfügbaren Endpunkte finden Sie im Salesforce REST API-Entwicklerhandbuch.
{"Content-type":"application/json"}. Workfront Fusion fügt die Autorisierungskopfzeilen für Sie hinzu.{"name":"something-urgent"}Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.
Hinweis:
Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.
Beispiel: Der folgende API-Aufruf gibt die Liste aller Benutzer in Ihrem Salesforce-Konto zurück:
-
URL:
query -
Method: GET
-
Abfragezeichenfolge:
-
key:
q -
Wert:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Treffer der Suche finden Sie in der Modulausgabe unter Bundle > Body > records.
In unserem Beispiel wurden 6 Benutzer zurückgegeben:
Löschen eines Datensatzes
Dieses Aktionsmodul löscht einen vorhandenen Datensatz in einem Objekt.
Geben Sie die ID des Eintrags an.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Anlage/Dokument herunterladen
Dieses Aktionsmodul lädt ein Dokument oder eine Anlage aus einem Datensatz herunter.
Sie geben die ID des Datensatzes und den gewünschten Download-Typ an.
Das Modul gibt die ID des Anhangs oder Dokuments und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Eintrag lesen
Dieses Aktionsmodul liest Daten aus einem einzelnen -Objekt in Salesforce.
Geben Sie die ID des Eintrags an.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Aktualisieren eines Datensatzes
Dieses Aktionsmodul bearbeitet einen Datensatz in einem -Objekt.
Mit dem Modul können Sie auswählen, welche Objektfelder im Modul verfügbar sind. Dadurch wird die Anzahl der Felder reduziert, die beim Einrichten des Moduls durchgescrollt werden müssen.
Das Modul gibt daraufhin die ID des Eintrags und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Anlage/Dokument hochladen
Dieses Aktionsmodul lädt eine Datei hoch und hängt sie an einen von Ihnen angegebenen Datensatz an oder lädt ein Dokument hoch.
Das Modul gibt die ID des Anhangs oder Dokuments und alle zugehörigen Felder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.
Datei hochladen
Dieses Aktionsmodul lädt eine einzelne Datei in Salesforce hoch.
Suchvorgänge
Suche
Dieses Aktionsmodul ruft alle Datensätze ab, die ein bestimmtes Kriterium erfüllen.
Suche mit Abfrage
Dieses Suchmodul sucht in einem -Objekt nach Datensätzen, Salesforce mit der angegebenen Suchanfrage übereinstimmen. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.
Beim Konfigurieren dieses Moduls werden die folgenden Felder angezeigt.