Salesforce moduler

I ett Adobe Workfront Fusion-scenario kan du automatisera arbetsflöden som använder Salesforce och ansluta det till flera tredjepartsprogram och -tjänster.

En videointroduktion till Salesforce Connector finns på:

Om du behöver instruktioner om hur du skapar ett scenario kan du läsa Skapa ett scenario i Adobe Workfront Fusion.

Mer information om moduler finns i Moduler i Adobe Workfront Fusion.

NOTE
  • Alla utgåvor av Salesforce har inte API-åtkomst. Mer information finns i informationen om Salesforce utgåvor med API-åtkomst på Salesforce Community-webbplatsen.
  • Information om specifika fel som returneras från API:t Salesforce finns i API-dokumenten för Salesforce. Du kan också kontrollera status för Salesforce API:t för eventuella tjänstavbrott.

Åtkomstkrav

Du måste ha följande åtkomst för att kunna använda funktionerna i den här artikeln:

Adobe Workfront plan*
Pro eller högre
Adobe Workfront licens*
Plan, Work
Adobe Workfront Fusion licens**

Aktuellt licenskrav: Inget Workfront Fusion-licenskrav.

eller

Gammalt licenskrav: Workfront Fusion för Automatisering och integrering av arbetet

Produkt

Aktuellt produktkrav: Om du har planen Select eller Prime Adobe Workfront måste din organisation köpa både Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln. Workfront Fusion ingår i planen Ultimate Workfront.

eller

Äldre produktkrav: Din organisation måste köpa Adobe Workfront Fusion och Adobe Workfront för att kunna använda de funktioner som beskrivs i den här artikeln.

Kontakta Workfront-administratören om du vill ta reda på vilken plan, licenstyp eller åtkomst du har.

Mer information om Adobe Workfront Fusion licenser finns i Adobe Workfront Fusion licenser.

Förutsättningar

Du måste ha ett Salesforce-konto för att kunna använda Salesforce-moduler.

Salesforce API-information

Salesforce Connector använder följande:

Bas-URL
{{connection.instanceUrl}}
API-version
v46.0
API-tagg
v1.15.14

Om att söka efter Salesforce objekt

När du söker efter objekt kan du antingen ange enskilda sökord eller skapa en mer komplex fråga med jokertecken och operatorer:

  • Använd asteriskens jokertecken (*) som ersättning för noll eller flera tecken. En sökning efter Ca* söker efter objekt som börjar med Ca
  • Använd frågetecken som jokertecken (?) som ersättning för ett enda tecken. Om du söker efter Jo?n hittas objekt med termen John eller Joan men inte Jon
  • Använd operatorn för citattecken (" ") för att hitta en exakt frasmatchning. Till exempel:"Månadsmöte"

Mer information om sökmöjligheter finns i Salesforce-utvecklardokumentationen om SOQL och SOSL.

Salesforce-moduler och deras fält

Utlösare

Watch for Records

Den här utlösarmodulen kör ett scenario när en post i ett objekt skapas eller uppdateras. Modulen returnerar alla standardfält som är associerade med posten eller posterna, tillsammans med anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Type
Välj den typ av Salesforce-post som du vill att modulen ska bevaka.
Record Fields
Markera de fält som du vill att modulen ska bevaka. Vilka fält som är tillgängliga beror på posttypen.
Maximal count of records
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.
Watch
Ange om du vill att scenariot bara ska bevaka nya poster av den typ som du har valt, eller nya poster av den typ som du har valt och alla andra ändringar av poster av den typen.

Watch Outbound Messages

Den här utlösarmodulen kör ett scenario när någon skickar ett meddelande. Modulen returnerar alla standardfält som är associerade med posten eller posterna, tillsammans med anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

Den här modulen kräver extra inställningar:

  1. Gå till konfigurationssidan för Salesforce.

    Om du vill komma åt konfigurationssidan letar du upp och klickar på knappen Setup i det övre högra hörnet av Salesforce-kontot. Gå till fältet Quick Find / Search till vänster på konfigurationssidan för Salesforce. Sök efter Workflow Rules.

  2. Klicka på Workflow Rules.

  3. På sidan Workflow Rules som visas klickar du på New Rule och väljer den objekttyp som regeln ska gälla för (till exempel Opportunity om du övervakar uppdateringar av säljprojektsposter).

  4. Klicka på Next.

  5. Ange ett regelnamn, utvärderingskriterier och regelvillkor och klicka sedan på Save och Next.

  6. Klicka på Done.

  7. Klicka på Edit från den nyligen skapade arbetsflödesregeln.

  8. I listrutan Add Workflow Action väljer du New Outbound Message.

  9. Ange namn, beskrivning, slutpunkts-URL och fält som du vill inkludera i det nya utgående meddelandet och klicka sedan på Save.

    Fältet Endpoint URL innehåller URL:en som anges för Salesforce Outbound Message i Workfront Fusion.

  10. Konfigurera ett scenario som börjar med händelsen Outbound Message.

  11. Klicka på ikonen </> längst ned till höger och kopiera den angivna URL:en.

  12. Gå tillbaka till sidan Workflow Rules, leta reda på den nya regeln och klicka sedan på Activate.

När du konfigurerar den här modulen visas följande fält.

Webhook

Välj den webkrok som du vill använda för att bevaka utgående meddelanden. Om du vill lägga till en webkrok klickar du på Add och anger webkrokens namn och anslutning.

Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner

Record Type
Välj den typ av Salesforce-post som du vill att modulen ska bevaka för utgående meddelanden.
Fields
Markera de fält som du vill att modulen ska bevaka för utgående meddelanden. Vilka fält som är tillgängliga beror på posttypen.

Watch a field

Denna utlösarmodul startar ett scenario när ett fält uppdateras i Salesforce.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Record Type
Välj den typ av post som innehåller fältet som du vill att modulen ska bevaka. Du måste välja en posttyp som har Field History aktiverat i Salesforce-konfigurationen. Mer information finns i Spåra fälthistorik i Salesforce-dokumentationen.
Field
Markera de fält som du vill att modulen ska bevaka för ändringar.
Limit
Ange eller mappa det maximala antal fält som du vill att modulen ska returnera under varje körningscykel för scenario.

Åtgärder

Create a Record

Den här åtgärdsmodulen skapar en ny post i ett objekt.

I modulen kan du välja vilka av objektets fält som är tillgängliga i modulen. Detta minskar antalet fält som du måste bläddra igenom när du ställer in modulen.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Record Type
Välj den typ av Salesforce-post som du vill att modulen ska skapa. Fälten blir tillgängliga baserat på den typ av post som valts i fältet Record Type. Dessa fält är baserade på Salesforce-API:t.
Select fields to map

Markera de fält som du vill att modulen ska konfigurera när den nya posten skapas. Obligatoriska fält visas högst upp i listan.

Fälten som du väljer öppnas under det här fältet. Du kan nu ange värden i dessa fält.

Read a Record

Den här åtgärdsmodulen läser data från ett enskilt objekt i Salesforce.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Record Type
Välj den typ av Salesforce-post som du vill att modulen ska [åtgärd].read.
Record Fields
Markera de fält som du vill att modulen ska läsa. Du måste markera minst ett fält.
ID

Ange eller mappa det unika Salesforce-ID:t för posten som du vill att modulen ska läsa.

Om du vill hämta ID:t öppnar du objektet Salesforce i webbläsaren och kopierar texten i slutet av URL:en efter det sista snedstrecket (/). Exempel: https://eu5.salesforce.com/<object ID>

Delete a Record

Den här åtgärdsmodulen tar bort en befintlig post i ett objekt.

Du anger postens ID.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Record Type
Välj den typ av Salesforce-post som du vill att modulen ska ta bort.
ID

Ange eller mappa det unika Salesforce-ID:t för posten som du vill att modulen ska ta bort.

Om du vill hämta ID:t öppnar du objektet Salesforce i webbläsaren och kopierar texten i slutet av URL:en efter det sista snedstrecket (/). Exempel: https://eu5.salesforce.com/<object ID>

Custom API Call

Med den här åtgärdsmodulen kan du göra ett anpassat autentiserat anrop till API:t Salesforce. På så sätt kan du skapa en dataflödesautomatisering som inte kan utföras av de andra Salesforce-modulerna.

Modulen returnerar följande:

  • Status Code (tal): Detta anger om HTTP-begäran lyckades eller misslyckades. Det här är standardkoder som du kan söka efter på Internet.

  • Headers (objekt): En mer detaljerad kontext för svars-/statuskoden som inte relaterar till utdatatexten. Alla sidhuvuden som visas i en svarshuvud är inte svarshuvuden, så en del kanske inte är användbara för dig.

    Svarshuvuden beror på den HTTP-begäran du valde när du konfigurerade modulen.

  • Body (objekt): Beroende på den HTTP-begäran du valde när du konfigurerade modulen kan du få tillbaka data. Dessa data, till exempel data från en GET-begäran, finns i det här objektet.

När du konfigurerar den här modulen visas följande fält.

Välj den HTTP-förfrågningsmetod som du behöver för att konfigurera API-anropet. Mer information finns i Metoder för HTTP-begäran i Adobe Workfront Fusion.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
URL

Ange en relativ sökväg till <Instance URL>/services/data/v46.0/.

En lista över tillgängliga slutpunkter finns i Salesforce REST API Developer Guide.

Method
Headers
Lägg till rubrikerna för begäran i form av ett standard-JSON-objekt. Exempel: {"Content-type":"application/json"}. Workfront Fusion lägger till auktoriseringsrubrikerna åt dig.
Query String
Lägg till frågan för API-anropet i form av ett standard-JSON-objekt. Till exempel: {"name":"something-urgent"}
Body

Lägg till brödinnehållet för API-anropet i form av ett standard-JSON-objekt.

Obs!

När du använder villkorssatser som if i JSON placerar du citattecknen utanför villkorssatsen.

INFO
Exempel: Följande API-anrop returnerar listan över alla användare i ditt Salesforce-konto:
  • URL: query

  • Metod: GET

  • Frågesträng:

  • Nyckel: q

  • Värde: SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10

Det går att hitta matchningar av sökningen i modulens utdata under Bundle> Body >records.
I vårt exempel returnerades sex användare:

Upload Attachment/Document

Den här åtgärdsmodulen överför en fil och bifogar den till en post som du anger, eller överför ett dokument.

Modulen returnerar ID:t för den bifogade filen eller dokumentet och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Type of Upload
Välj om du vill att modulen ska överföra en bifogad fil eller ett dokument.
ID
Ange eller mappa ID:t för objektet som du vill överföra en bifogad fil till.
Folder
Markera den mapp som innehåller den fil som du vill att modulen ska överföra.
Source File
Välj en källfil från en tidigare modul eller mappa källfilens namn och data.

Download Attachment/Document

Den här åtgärdsmodulen hämtar ett dokument eller en bifogad fil från en post.

Du anger postens ID och vilken typ av hämtning du vill använda.

Modulen returnerar ID:t för den bifogade filen eller dokumentet och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Type of Download

Ange vilken typ av fil du vill hämta från Salesforce.

  • Attachment
  • Document
  • ContentDocument (Detta är ett dokument som har överförts till ett bibliotek i Saleforce CRM Content eller Salesforce Files.)

ID /

Attachment ID /

ContentDocument ID

Ange eller mappa det unika Salesforce-ID:t för posten som du vill att modulen ska hämta.

Om du vill hämta ID:t öppnar du objektet Salesforce i webbläsaren och kopierar texten i slutet av URL:en efter det sista snedstrecket (/). Exempel: https://eu5.salesforce.com/<object ID>

Update a Record

Denna åtgärdsmodul redigerar en post i ett objekt.

I modulen kan du välja vilka av objektets fält som är tillgängliga i modulen. Detta minskar antalet fält som du måste bläddra igenom när du ställer in modulen.

Modulen returnerar postens ID och eventuella associerade fält, tillsammans med eventuella anpassade fält och värden som anslutningen har åtkomst till. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
ID
Ange eller mappa ID:t för den post som du vill uppdatera.
Record Type
Välj den typ av Salesforce-post som du vill att modulen ska uppdatera. Fälten blir tillgängliga baserat på vilken typ av post som har valts i fältet Posttyp. Dessa fält är baserade på Salesforce-API:t.
Select fields to map

Markera de fält som du vill att modulen ska konfigurera när den nya posten skapas. Obligatoriska fält visas högst upp i listan.

Fälten som du väljer öppnas under det här fältet. Du kan nu ange värden i dessa fält.

Sökningar

Search with Query

Den här sökmodulen söker efter poster i ett objekt i Salesforce som matchar den sökfråga du anger. Du kan mappa den här informationen i efterföljande moduler i scenariot.

När du konfigurerar den här modulen visas följande fält.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till Adobe Workfront Fusion - grundläggande instruktioner.
Search Type

Välj den typ av sökning som du vill att modulen ska utföra:

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

Type
Om du valde den enkla söktypen väljer du den typ av Salesforce-post som du vill att modulen ska söka efter.
Query / SOSL Query / SOQL Query

Ange frågan som du vill söka efter.

Mer information om SOSL finns i Salesforce Object Search Language (SOSL) i Salesforce -dokumentationen.

Mer information om SOQL finns i Salesforce Object Query Language (SOQL) i Salesforce -dokumentationen.

Obs! Observera att värdet för parametern RETURNING påverkar modulens utdata. Om du använder LIMIT ignorerar Fusion inställningarna i fältet Maximal count of records. Om du inte anger någon gräns infogas värdet LIMIT = Maximal count of records.

Maximal count of records
Ange eller mappa det maximala antal poster som du vill att modulen ska returnera under varje körningscykel för scenario.

Den här åtgärdsmodulen hämtar alla poster som uppfyller ett visst villkor.

Connection
Instruktioner om hur du ansluter ditt Salesforce-konto till Workfront Fusion finns i Skapa en anslutning till ​ Adobe Workfront Fusion - grundläggande instruktioner
Type
Välj den typ av objekt som du vill söka efter.
Search criteria
Markera fältet som du vill söka efter, operatorn som du vill använda i frågan och värdet som du söker efter i fältet. Du kan koppla frågor med hjälp av AND eller OR.
Outputs
Markera de fält som du vill inkludera i modulens utdata.
Result set
Välj om du vill att modulen ska returnera alla matchande poster eller endast den första matchande posten.
Maximal
Ange eller mappa det maximala antal poster som du vill att modulen ska hämta under varje körningscykel för scenario.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43