DokumentationWorkfrontWorkfront-Handbuch

Salesforce Module

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende

In einem Adobe Workfront Fusion-Szenario können Sie Workflows automatisieren, die Salesforce verwenden, und sie mit mehreren Anwendungen und Diensten von Drittanbietern verbinden.

Eine Videoeinführung zum Salesforce-Connector finden Sie unter:

Wenn Sie Anweisungen zum Erstellen eines Szenarios benötigen, finden Sie weitere Informationen unter Erstellen eines Szenarios in Adobe Workfront Fusion.

Weitere Informationen zu Modulen finden Sie unter Module in Adobe Workfront Fusion.

NOTE
  • Nicht alle Editionen von Salesforce haben API-Zugriff. Weitere Informationen finden Sie in den Informationen zu Salesforce Editionen mit API-Zugriff auf die Salesforce Community-Site.
  • Informationen zu spezifischen Fehlern, die von der Salesforce -API zurückgegeben werden, finden Sie in den API-Dokumenten von Salesforce . Sie können auch den Status der Salesforce-API auf mögliche Dienstausfälle überprüfen.

Zugriffsanforderungen

Sie müssen über den folgenden Zugriff verfügen, um die Funktionalität in diesem Artikel verwenden zu können:

Adobe Workfront plan*
Pro oder höher
Adobe Workfront license*
Plan, Arbeit
Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Wenden Sie sich an Ihren Workfront -Administrator, um zu erfahren, welchen Plan, welchen Lizenztyp oder welchen Zugriff Sie haben.

Informationen zu Adobe Workfront Fusion -Lizenzen finden Sie unter Adobe Workfront Fusion Lizenzen.

Voraussetzungen

Um Salesforce -Module zu verwenden, müssen Sie über ein Salesforce -Konto verfügen.

Salesforce-API-Informationen

Der Salesforce-Connector verwendet Folgendes:

Basis-URL
{connection.instanceUrl}
API-Version
v46.0
API-Tag
v1.15.14

Über die Suche nach Salesforce -Objekten

Bei der Suche nach Objekten können Sie entweder einzelne Suchbegriffe eingeben oder mithilfe von Platzhaltern und Operatoren eine komplexere Abfrage erstellen:

  • Verwenden Sie die Platzhalterkarte (*) als Ersatz für null oder mehr Zeichen. Beispielsweise findet eine Suche nach Ca* Elemente, die mit Ca beginnen
  • Verwenden Sie eine Fragezeichen-Platzhalter (?) als Ersatz für ein einzelnes Zeichen. Beispielsweise findet eine Suche nach Jo?n Elemente mit dem Begriff John oder Joan, aber nicht Jon
  • Verwenden Sie den Anführungszeichen-Operator ("""), um eine exakte Wortübereinstimmung zu finden. Beispiel: "Montag-Sitzung"

Weitere Informationen zu Suchmöglichkeiten finden Sie in der Salesforce Entwicklerdokumentation zu SOQL und SOSL.

Salesforce Module und ihre Felder

Trigger

Auf Aufzeichnungen achten

Dieses Trigger-Modul führt ein Szenario aus, wenn ein Datensatz in einem Objekt erstellt oder aktualisiert wird. Das Modul gibt alle mit dem Datensatz oder den Datensätzen verknüpften Standardfelder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Typ
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul überwachen soll.
Datensatzfelder
Wählen Sie die Felder aus, die das Modul überwachen soll. Die verfügbaren Felder hängen vom Datensatztyp ab.
Maximale Anzahl der Datensätze
Geben Sie die maximale Anzahl von Datensätzen ein oder ordnen Sie sie zu, die das Modul während der verschiedenen Ausführungszyklen eines Szenarios zurückgeben soll.
Watch
Bestimmen Sie, ob im Szenario nur neue Datensätze des ausgewählten Typs oder neue Datensätze des ausgewählten Typs sowie alle anderen Änderungen an Datensätzen dieses Typs berücksichtigt werden sollen.

Ausgehende Nachrichten ansehen

Dieses Trigger-Modul führt ein Szenario aus, wenn jemand eine Nachricht sendet. Das Modul gibt alle mit dem Datensatz oder den Datensätzen verknüpften Standardfelder sowie alle benutzerdefinierten Felder und Werte zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Dieses Modul erfordert einige zusätzliche Einstellungen:

  1. Gehen Sie zur Setup-Seite Salesforce .

    Um auf die Einrichtungsseite zuzugreifen, suchen Sie die Schaltfläche mit der Bezeichnung "Setup" in der oberen rechten Ecke des Salesforce-Kontos und klicken Sie darauf. Suchen Sie auf der Setup-Seite Salesforce die Leiste "Schnellsuche/Suche" auf der linken Seite. Suchen Sie nach "Workflow-Regeln".

  2. Klicken Sie auf Workflow-Regeln.

  3. Klicken Sie auf der angezeigten Seite Workflow-Regeln auf Neue Regel und wählen Sie den Objekttyp aus, auf den die Regel angewendet werden soll (z. B. "Chancen", wenn Sie Aktualisierungen von Opportunity-Datensätzen überwachen).

  4. Klicken Sie auf Weiter.

  5. Legen Sie einen Regelnamen, Bewertungskriterien und Regelkriterien fest und klicken Sie dann auf Speichern und Weiter.

  6. Klicken Sie auf Fertig.

  7. Klicken Sie in der neu erstellten Workflow-Regel auf Bearbeiten.

  8. Wählen Sie aus der Dropdownliste Workflow-Aktion hinzufügen die Option Neue ausgehende Nachricht hinzufügen aus.

  9. Geben Sie den Namen, die Beschreibung, die Endpunkt-URL und die Felder an, die Sie in die neue ausgehende Nachricht aufnehmen möchten, und klicken Sie dann auf Speichern.

    Das Feld Endpunkt-URL enthält die URL, die auf der Salesforce Ausgehende Nachricht ​ in Workfront Fusion angegeben ist.

  10. Konfigurieren Sie ein Szenario, das mit dem Ereignis Ausgehende Nachricht ​ beginnt.

  11. Klicken Sie unten rechts auf das Symbol </> und kopieren Sie die angegebene URL.

  12. Kehren Sie zur Seite Workflow-Regeln zurück, suchen Sie die neu erstellte Regel und klicken Sie dann auf Aktivieren.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Webhook

Wählen Sie den Webhook aus, den Sie zum Anzeigen ausgehender Nachrichten verwenden möchten. Um einen Webhook hinzuzufügen, klicken Sie auf Add und geben Sie den Namen und die Verbindung des Webhooks ein.

Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung mit Adobe Workfront Fusion - Grundlegende Anweisungen

Record Type
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul auf ausgehende Nachrichten überwachen soll.
Felder
Wählen Sie die Felder aus, die das Modul auf ausgehende Nachrichten überwachen soll. Die verfügbaren Felder hängen vom Datensatztyp ab.

Ein Feld ansehen

Dieses Trigger-Modul startet ein Szenario, wenn ein Feld in Salesforce aktualisiert wird.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Record Type
Wählen Sie den Datensatztyp aus, der das Feld enthält, das das Modul überwachen soll. Sie müssen einen Datensatztyp auswählen, für den Feldverlauf bei der Einrichtung von Salesforce aktiviert ist. Weitere Informationen finden Sie unter Feldverlauf-Tracking in der Dokumentation zu Salesforce.
Field
Wählen Sie die Felder aus, die das Modul auf Änderungen überwachen soll.
Limit
Geben Sie die maximale Anzahl von Feldern ein oder ordnen Sie sie zu, die das Modul während der Ausführung jedes Szenarios zurückgeben soll.

Aktionen

Erstellen eines Datensatzes

Dieses Aktionsmodul erstellt einen neuen Datensatz in einem Objekt.

Mit dem -Modul können Sie auswählen, welche der Objektfelder im -Modul verfügbar sind. Dadurch wird die Anzahl der Felder reduziert, die beim Einrichten des Moduls durchsucht werden müssen.

Das Modul gibt die Kennung des Datensatzes 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Record Type
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul erstellen soll. Felder werden je nach dem im Feld Record Type ausgewählten Datensatztyp verfügbar. Diese Felder basieren auf der Salesforce -API.
Felder zur Zuordnung auswählen

Wählen Sie die Felder aus, die das Modul beim Erstellen des neuen Datensatzes konfigurieren soll. Die erforderlichen Felder befinden sich oben in der Liste.

Die ausgewählten Felder werden unter diesem Feld geöffnet. Sie können jetzt Werte in diese Felder eingeben.

Datensatz lesen

Dieses Aktionsmodul liest Daten aus einem einzelnen Objekt in Salesforce.

Sie geben die Kennung des Datensatzes an.

Das Modul gibt die Kennung des Datensatzes 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Record Type
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul [action].read lauten soll.
Datensatzfelder
Wählen Sie die Felder aus, die das Modul lesen soll. Sie müssen mindestens ein Feld auswählen.
ID

Geben Sie die eindeutige Salesforce-ID des Datensatzes ein oder ordnen Sie sie zu, den das Modul lesen soll.

Um die ID abzurufen, öffnen Sie das Objekt Salesforce in Ihrem Browser und kopieren Sie den Text am Ende der URL nach dem letzten Schrägstrich (/). Beispiel: https://eu5.salesforce.com/<object ID>

Einen Datensatz löschen

Dieses Aktionsmodul löscht einen vorhandenen Datensatz in einem Objekt.

Sie geben die Kennung des Datensatzes an.

Das Modul gibt die Kennung des Datensatzes 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Record Type
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul löschen soll.
ID

Geben Sie die eindeutige Salesforce-ID des Datensatzes ein oder ordnen Sie sie zu, den das Modul löschen soll.

Um die ID abzurufen, öffnen Sie das Objekt Salesforce in Ihrem Browser und kopieren Sie den Text am Ende der URL nach dem letzten Schrägstrich (/). Beispiel: https://eu5.salesforce.com/<object ID>

Benutzerspezifischer 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, die von anderen Salesforce -Modulen nicht ausgeführt werden kann.

Das Modul gibt Folgendes zurück:

  • Status-Code (Zahl): Zeigt an, ob Ihre HTTP-Anforderung erfolgreich oder fehlgeschlagen ist. Dies sind Standardcodes, die Sie im Internet nachschlagen können.

  • Kopfzeilen (Objekt): Ein detaillierterer Kontext für den Antwort-/Statuscode, der sich nicht auf den Ausgabetext bezieht. Nicht alle Header, die in einem Antwortheader angezeigt werden, sind Antwortheader, sodass einige möglicherweise nicht nützlich für Sie sind.

    Die Antwortheader hängen von der HTTP-Anforderung ab, die Sie beim Konfigurieren des Moduls ausgewählt haben.

  • Hauptteil (Objekt): Je nach der HTTP-Anforderung, die Sie beim Konfigurieren des Moduls ausgewählt haben, erhalten Sie möglicherweise einige Daten zurück. Diese Daten, z. B. die Daten einer GET -Anfrage, sind in diesem Objekt enthalten.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anforderungsmethoden in Adobe Workfront Fusion.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
URL

Geben Sie einen Pfad relativ zu <Instance URL>/services/data/v46.0/ ein.

Die Liste der verfügbaren Endpunkte finden Sie im Salesforce REST API Developer Guide.

Methode
Header
Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu, z. B. {"Content-type":"application/json"}. Workfront Fusion fügt die Autorisierungskopfzeilen für Sie hinzu.
Abfragezeichenfolge
Fügen Sie die Abfrage für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu. Beispiel: {"name":"something-urgent"}
Body

Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Bei Verwendung von bedingten Anweisungen wie if in Ihrer JSON platzieren Sie die Anführungszeichen außerhalb der bedingten Anweisung.

INFO
Beispiel: Der folgende API-Aufruf gibt die Liste aller Benutzer in Ihrem Salesforce -Konto zurück:

  • URL: query

  • Methode: GET

  • Abfragezeichenfolge:

  • Schlüssel: q

  • Wert: SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

Übereinstimmungen der Suche finden Sie in der Ausgabe des Moduls unter Bundle > Hauptteil > Datensätze.
In unserem Beispiel wurden 6 Benutzer zurückgegeben:

Anhang/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 sowie alle zugehörigen Felder zusammen mit benutzerdefinierten Feldern und Werten zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Typ des Uploads
Wählen Sie aus, ob das Modul eine Anlage oder ein Dokument hochladen soll.
ID
Geben Sie die ID des Objekts ein, in das Sie eine Anlage hochladen möchten, oder ordnen Sie sie zu.
Ordner
Wählen Sie den Ordner aus, der die Datei enthält, die das Modul hochladen soll.
Source-Datei
Wählen Sie eine Quelldatei aus einem vorherigen Modul aus oder ordnen Sie den Namen und die Daten der Quelldatei zu.

Anhang/Dokument herunterladen

Dieses Aktionsmodul lädt ein Dokument oder eine Anlage aus einem Datensatz herunter.

Sie geben die Kennung des Datensatzes und den gewünschten Download-Typ an.

Das Modul gibt die ID des Anhangs oder Dokuments sowie alle zugehörigen Felder zusammen mit benutzerdefinierten Feldern und Werten zurück, auf die die Verbindung zugreift. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Download-Typ

Geben Sie den Dateityp an, den Sie von Salesforce herunterladen möchten.

  • Anhang
  • Document
  • ContentDocument (Dies ist ein Dokument, das in Saleforce CRM Content oder Salesforce Files in eine Bibliothek hochgeladen wurde.)

ID /

Attachment ID /

ContentDocument ID

Geben Sie die eindeutige Salesforce-ID des Datensatzes ein oder ordnen Sie sie zu, den das Modul herunterladen soll.

Um die ID abzurufen, öffnen Sie das Objekt Salesforce in Ihrem Browser und kopieren Sie den Text am Ende der URL nach dem letzten Schrägstrich (/). Beispiel: https://eu5.salesforce.com/<object ID>

Datensatz aktualisieren

Dieses Aktionsmodul bearbeitet einen Datensatz in einem Objekt.

Mit dem -Modul können Sie auswählen, welche der Objektfelder im -Modul verfügbar sind. Dadurch wird die Anzahl der Felder reduziert, die beim Einrichten des Moduls durchsucht werden müssen.

Das Modul gibt die Kennung des Datensatzes 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.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
ID
Geben Sie die Kennung des Datensatzes ein, den Sie aktualisieren möchten, oder ordnen Sie sie zu.
Record Type
Wählen Sie den Typ von Salesforce Datensatz aus, den das Modul aktualisieren soll. Felder werden je nach dem im Feld Datensatztyp ausgewählten Datensatztyp verfügbar. Diese Felder basieren auf der Salesforce -API.
Felder zur Zuordnung auswählen

Wählen Sie die Felder aus, die das Modul beim Erstellen des neuen Datensatzes konfigurieren soll. Die erforderlichen Felder befinden sich oben in der Liste.

Die ausgewählten Felder werden unter diesem Feld geöffnet. Sie können jetzt Werte in diese Felder eingeben.

Suchvorgänge

Suche mit Abfrage

Dieses Suchmodul sucht nach Datensätzen in einem Objekt in Salesforce, die mit der von Ihnen angegebenen Suchabfrage übereinstimmen. Sie können diese Informationen in nachfolgenden Modulen im Szenario zuordnen.

Wenn Sie dieses Modul konfigurieren, werden die folgenden Felder angezeigt.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu Adobe Workfront Fusion - Grundlegende Anweisungen.
Suchtyp

Wählen Sie den Suchtyp aus, den das Modul ausführen soll:

  • Simple

  • Verwenden von SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

Typ
Wenn Sie den Typ Einfache Suche ausgewählt haben, wählen Sie den Typ von Salesforce Datensatz aus, nach dem das Modul suchen soll.
Abfrage / SOSL-Abfrage / SOQL-Abfrage

Geben Sie die Abfrage ein, nach der Sie suchen möchten.

Weitere Informationen zu SOSL finden Sie unter Salesforce Object Search Language (SOSL) in der Dokumentation zu Salesforce.

Weitere Informationen zu SOQL finden Sie unter Salesforce Object Query Language (SOQL) in der Dokumentation zu Salesforce.

Hinweis: Beachten Sie, dass der Wert des Parameters RETURNING die Ausgabe des Moduls beeinflusst. Wenn Sie LIMIT verwenden, ignoriert Fusion die Einstellungen im Feld Maximale Anzahl von Datensätzen. Wenn Sie keine Begrenzung festlegen, fügt Fusion den Wert LIMIT = Maximale Anzahl an Datensätzen ein.

Maximale Anzahl der Datensätze
Geben Sie die maximale Anzahl von Datensätzen ein oder ordnen Sie sie zu, die das Modul während der verschiedenen Ausführungszyklen eines Szenarios zurückgeben soll.

Suche

Dieses Aktionsmodul ruft alle Datensätze ab, die bestimmte Kriterien erfüllen.

Verbindung
Anweisungen zum Verbinden Ihres Salesforce-Kontos mit Workfront Fusion finden Sie unter Erstellen einer Verbindung zu ​ Adobe Workfront Fusion - Grundlegende Anweisungen
Typ
Wählen Sie den Objekttyp aus, nach dem Sie suchen möchten.
Suchkriterien
Wählen Sie das Feld aus, nach dem Sie suchen möchten, den Operator, den Sie in Ihrer Abfrage verwenden möchten, und den Wert, nach dem Sie im Feld suchen. Sie können Abfragen mit UND oder ODER verbinden.
Ausgaben
Wählen Sie die Felder aus, die Sie in die Ausgabe des Moduls aufnehmen möchten.
Result set
Wählen Sie aus, ob das Modul alle übereinstimmenden Datensätze zurückgeben soll oder nur den ersten übereinstimmenden Datensatz.
Maximal
Geben Sie die maximale Anzahl von Datensätzen ein oder ordnen Sie sie zu, die das Modul während der verschiedenen Ausführungszyklen des Szenarios abrufen soll.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43