Salesforce modules

In een Adobe Workfront Fusion-scenario kunt u workflows automatiseren die Salesforce gebruiken en er verbinding mee maken met meerdere toepassingen en services van derden.

Ga voor een video-introductie over de Salesforce-connector naar:

Als u instructies bij het creëren van een scenario nodig hebt, zie een scenario in Adobe Workfront Fusion creëren.

Voor informatie over modules, zie Modules in Adobe Workfront Fusion.

NOTE
  • Niet alle versies van Salesforce hebben API-toegang. Zie voor meer informatie de informatie over Salesforce -edities met API-toegang op de Salesforce -communitysite.
  • Zie de API-documenten van Salesforce voor informatie over specifieke fouten die door de Salesforce API worden geretourneerd. U kunt ook de status van de Salesforce API controleren op mogelijke uitval van de service.

Toegangsvereisten

U moet de volgende toegang hebben om de functionaliteit in dit artikel te kunnen gebruiken:

Adobe Workfront plan*
Pro of hoger
Adobe Workfront licentie*
Plan, Work
Adobe Workfront Fusion licentie**

Huidige licentievereiste: geen Workfront Fusion licentievereiste.

of

Vereiste voor oudere licenties: Workfront Fusion voor werkautomatisering en integratie

Product

Huidige productvereiste: als u het Select - of Prime Adobe Workfront -abonnement hebt, moet uw organisatie Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken. Workfront Fusion wordt opgenomen in het Ultimate Workfront -abonnement.

of

Vereiste verouderd product: uw organisatie moet Adobe Workfront Fusion en Adobe Workfront aanschaffen om de in dit artikel beschreven functionaliteit te kunnen gebruiken.

Neem contact op met de Workfront -beheerder als u wilt weten welk abonnement, licentietype of toegang u hebt.

Voor informatie over Adobe Workfront Fusion vergunningen, zie Adobe Workfront Fusion vergunningen.

Vereisten

Als u Salesforce -modules wilt gebruiken, moet u een Salesforce -account hebben.

Informatie over zoeken naar Salesforce -objecten

Bij het zoeken naar objecten kunt u afzonderlijke zoekwoorden invoeren of een complexere query maken met behulp van jokertekens en operatoren:

  • Gebruik de asterisk wild card (*) als vervanging voor nul of meer tekens. Als u bijvoorbeeld zoekt naar CA*, worden items gevonden die met CA beginnen
  • Wilde kaart met vraagteken gebruiken (?) als vervanging van één teken. Bijvoorbeeld, vindt een onderzoek naar Jo?n punten met de term John of Joan maar niet Jon
  • Gebruik de operator voor aanhalingstekens (" ") om een exacte woordovereenkomst te zoeken. Bijvoorbeeld: "Maandvergadering"

Zie de Salesforce documentatie voor ontwikkelaars over SOQL en SOSL voor meer informatie over zoekmogelijkheden.

Salesforce modules en hun velden

Triggers

Watch for Records

Deze triggermodule voert een scenario uit wanneer een record in een object wordt gemaakt of bijgewerkt. De module retourneert alle standaardvelden die zijn gekoppeld aan de record of records, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Type
Selecteer het type Salesforce record dat u in de module wilt bekijken.
Record Fields
Selecteer de velden die u in de module wilt bekijken. Beschikbare velden zijn afhankelijk van het type record.
Maximal count of records
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.
Watch
Bepaal of u het scenario alleen nieuwe records van het geselecteerde type wilt bekijken, of nieuwe records van het geselecteerde type en alle andere wijzigingen in records van dat type.

Watch Outbound Messages

Deze trekkermodule voert een scenario uit wanneer iemand een bericht verzendt. De module retourneert alle standaardvelden die zijn gekoppeld aan de record of records, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Voor deze module is extra installatie vereist:

  1. Ga naar de instellingspagina van Salesforce .

    Ga naar de knop met het label " Setup" in de rechterbovenhoek van het Salesforce -account en klik op deze knop om de instellingspagina te openen. Van de Salesforce opstellingspagina, bepaal de plaats van de "Quick Find / Search"bar op de linkerkant. Zoek naar "Workflow Rules."

  2. Klik op Workflow Rules.

  3. Voor de Workflow Rules pagina die verschijnt, klik New Rule en selecteer het objecten type de regel zal van toepassing zijn (zoals " Opportunity"als u updates aan verslagen van de Opportunity controleert).

  4. Klik op Next.

  5. Stel een regelnaam, evaluatiecriteria en regelcriteria in en klik op Save en Next .

  6. Klik op Done.

  7. Klik op Edit

  8. Selecteer in de vervolgkeuzelijst Add Workflow Action de optie New Outbound Message.

  9. Geef een naam, beschrijving, URL van eindpunt en velden op die u in het nieuwe uitgaande bericht wilt opnemen en klik op Save .

    Het veld Endpoint URL bevat de URL die wordt opgegeven in de lus Salesforce Outbound Message in Workfront Fusion .

  10. Configureer een scenario dat begint met de gebeurtenis Outbound Message .

  11. Klik </> pictogram in het bodemrecht en kopieer verstrekte URL.

  12. Ga terug naar de pagina Workflow Rules , zoek de nieuwe regel en klik op Activate .

Als u deze module configureert, worden de volgende velden weergegeven.

Webhook

Selecteer de webhaak die u wilt gebruiken om uitgaande berichten te bekijken. Als u een webhaak wilt toevoegen, klikt u op Add en voert u de naam en de verbinding van de webhaak in.

Voor instructies over het aansluiten van uw Salesforce rekening aan Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies

Record Type
Selecteer het type Salesforce record dat de module moet controleren voor uitgaande berichten.
Fields
Selecteer de gebieden die u de module voor uitgaande berichten wilt letten. Beschikbare velden zijn afhankelijk van het type record.

Watch a field

Deze triggermodule start een scenario wanneer een veld wordt bijgewerkt in Salesforce .

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Record Type
Selecteer het type record dat het veld bevat waarop de module moet letten. Kies een recordtype waarvoor Field History is ingeschakeld in Salesforce . Voor meer informatie, zie het Volgen van de Geschiedenis van het Gebiedin de Salesforce documentatie.
Field
Selecteer de gebieden die u de module voor veranderingen wilt controleren.
Limit
Ga of kaart het maximumaantal gebieden in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.

Handelingen

Create a Record

Deze actiemodule maakt een nieuwe record in een object.

In de module kunt u selecteren welke velden van het object beschikbaar zijn in de module. Dit vermindert het aantal gebieden u door moet scrollen wanneer vestiging de module.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Record Type
Selecteer het type Salesforce record dat u met de module wilt maken. Velden worden beschikbaar op basis van het type record dat is geselecteerd in het veld Record Type . Deze velden zijn gebaseerd op de API van Salesforce .
Select fields to map

Selecteer de gebieden die u de module wilt vormen wanneer het creëren van het nieuwe verslag. De vereiste velden staan boven aan de lijst.

De velden die u selecteert, worden geopend onder dit veld. U kunt nu waarden invoeren in deze velden.

Read a Record

Deze actiemodule leest gegevens van één object in Salesforce .

U geeft de id van de record op.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Record Type
Selecteer het type Salesforce record dat de module [action].read moet gebruiken.
Record Fields
Selecteer de velden die u in de module wilt lezen. U moet ten minste één veld selecteren.
ID

Voer de unieke Salesforce -id in of wijs deze toe aan de record die u wilt lezen in de module.

Als u de id wilt ophalen, opent u het object Salesforce in uw browser en kopieert u de tekst aan het einde van de URL na de laatste schuine streep (/). Bijvoorbeeld: https://eu5.salesforce.com/<object ID>

Delete a Record

Deze actiemodule verwijdert een bestaande record in een object.

U geeft de id van de record op.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Record Type
Selecteer het type Salesforce -record dat u wilt verwijderen door de module.
ID

Voer de unieke Salesforce -id in of wijs deze toe aan de record die u wilt verwijderen door de module.

Als u de id wilt ophalen, opent u het object Salesforce in uw browser en kopieert u de tekst aan het einde van de URL na de laatste schuine streep (/). Bijvoorbeeld: https://eu5.salesforce.com/<object ID>

Custom API Call

Met deze actiemodule kunt u een aangepaste, geverifieerde aanroep van de Salesforce API maken. Op deze manier kunt u een automatisering van de gegevensstroom maken die niet door de andere Salesforce -modules kan worden uitgevoerd.

De module retourneert het volgende:

  • Status Code (nummer): Dit geeft aan of uw HTTP-aanvraag is geslaagd of mislukt. Dit zijn standaardcodes die u kunt opzoeken op internet.

  • Headers (object): een gedetailleerdere context voor de respons-/statuscode die geen betrekking heeft op de hoofdtekst van de uitvoer. Niet alle kopteksten in een antwoordkoptekst zijn reactiekoppen. Sommige koppen zijn daarom niet altijd even handig.

    De antwoordheaders zijn afhankelijk van de HTTP-aanvraag die u hebt gekozen bij het configureren van de module.

  • Body (object): afhankelijk van de HTTP-aanvraag die u hebt gekozen bij het configureren van de module, ontvangt u mogelijk gegevens terug. Die gegevens, zoals de gegevens van een GET aanvraag, bevinden zich in dit object.

Als u deze module configureert, worden de volgende velden weergegeven.

Selecteer de HTTP- verzoekmethode u de API vraag moet vormen. Zie HTTP-aanvraagmethoden in Adobe Workfront Fusion voor meer informatie.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
URL

Ga een weg met betrekking tot <Instance URL>/services/data/v46.0/ in.

Voor de lijst van beschikbare eindpunten, verwijs naar de Gids van de Ontwikkelaar van de REST API van Salesforce.

Method
Headers
Voeg de kopteksten van de aanvraag toe in de vorm van een standaard JSON-object. Bijvoorbeeld {"Content-type":"application/json"} . Workfront Fusion voegt de machtigingsheaders voor u toe.
Query String
Voeg de query voor de API-aanroep toe in de vorm van een standaard JSON-object.Bijvoorbeeld: {"name":"something-urgent"}
Body

Voeg de inhoud van de hoofdtekst voor de API-aanroep toe in de vorm van een standaard JSON-object.

Opmerking:

Wanneer u voorwaardelijke instructies gebruikt, zoals if in uw JSON, plaatst u de aanhalingstekens buiten de voorwaardelijke instructie.

INFO
Voorbeeld: de volgende API vraag keert de lijst van alle gebruikers in uw Salesforce rekening terug:
  • URL: query

  • Methode: GET

  • Koord van de Vraag:

  • Sleutel: q

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

Overeenkomsten met de zoekopdracht vindt u in de sectie Uitvoer van de module onder Bundle> Body >records .
In ons voorbeeld werden 6 gebruikers geretourneerd:

Upload Attachment/Document

Deze actiemodule uploadt een bestand en koppelt het aan een record die u opgeeft, of uploadt een document.

De module retourneert de id van de bijlage of het document en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Type of Upload
Selecteer of u een bijlage of een document wilt uploaden in de module.
ID
Voer de id in of wijs de id toe van het object waarnaar u een bijlage wilt uploaden.
Folder
Selecteer de map met het bestand dat u wilt uploaden in de module.
Source File
Selecteer een bronbestand uit een vorige module of wijs de naam en gegevens van het bronbestand toe.

Download Attachment/Document

Deze actiemodule downloadt een document of bijlage uit een record.

U geeft de id van de record op en het gewenste type download.

De module retourneert de id van de bijlage of het document en alle bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Type of Download

Geef het type bestand op dat u van Salesforce wilt downloaden.

  • Attachment
  • Document
  • ContentDocument (Dit is een document dat is geüpload naar een bibliotheek in Saleforce CRM Content of Salesforce Files .)

ID /

Attachment ID /

ContentDocument ID

Voer de unieke Salesforce -id in of wijs deze toe aan de record die u wilt downloaden met de module.

Als u de id wilt ophalen, opent u het object Salesforce in uw browser en kopieert u de tekst aan het einde van de URL na de laatste schuine streep (/). Bijvoorbeeld: https://eu5.salesforce.com/<object ID>

Update a Record

Deze actiemodule bewerkt een record in een object.

In de module kunt u selecteren welke velden van het object beschikbaar zijn in de module. Dit vermindert het aantal gebieden u door moet scrollen wanneer vestiging de module.

De module retourneert de id van de record en de bijbehorende velden, samen met aangepaste velden en waarden die door de verbinding worden geopend. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
ID
Voer de id in van de record die u wilt bijwerken of wijs deze toe.
Record Type
Selecteer het type Salesforce record dat u wilt bijwerken in de module. Velden worden beschikbaar op basis van het type record dat is geselecteerd in het veld Recordtype. Deze velden zijn gebaseerd op de API van Salesforce .
Select fields to map

Selecteer de gebieden die u de module wilt vormen wanneer het creëren van het nieuwe verslag. De vereiste velden staan boven aan de lijst.

De velden die u selecteert, worden geopend onder dit veld. U kunt nu waarden invoeren in deze velden.

Zoekopdrachten

Search with Query

Deze zoekmodule zoekt naar records in een object in Salesforce dat overeenkomt met de zoekquery die u opgeeft. U kunt deze informatie in verdere modules in het scenario in kaart brengen.

Als u deze module configureert, worden de volgende velden weergegeven.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen Adobe Workfront Fusion - Basisinstructies.
Search Type

Selecteer het type onderzoek u de module wilt uitvoeren:

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

Type
Als u het eenvoudige zoektype hebt geselecteerd, kiest u het type Salesforce -record waarnaar u in de module wilt zoeken.
Query / SOSL Query / SOQL Query

Voer de query in waarop u wilt zoeken.

Voor meer informatie over SOSL, zie Taal van het Onderzoek van de Objecten van Salesforce (SOSL)in de Salesforce documentatie.

Voor meer informatie over SOQL, zie Taal van de Vraag van de Vraag van de Objecten van Salesforce (SOQL)in de Salesforce documentatie.

Nota: Gelieve te merken op dat de waarde van de parameter RETURNING de output van de module beïnvloedt. Als u LIMIT gebruikt, negeert Fusion de instellingen in het veld Maximal count of records . Als u geen limiet instelt, voegt Fusion de waarde LIMIT = Maximal count of records in.

Maximal count of records
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugkeren.

Deze actiemodule wint alle verslagen terug die aan een bepaalde criteria voldoen.

Connection
Voor instructies over het verbinden van uw Salesforce rekening met Workfront Fusion, zie een verbinding tot stand brengen ​ Adobe Workfront Fusion - Basisinstructies
Type
Selecteer het type object waarnaar u wilt zoeken.
Search criteria
Selecteer het veld waarnaar u wilt zoeken, de operator die u wilt gebruiken in de query en de waarde die u in het veld zoekt. U kunt vragen verbinden door EN of OF te gebruiken.
Outputs
Selecteer de velden die u in de uitvoer van de module wilt opnemen.
Result set
Selecteer of u de module Alle Overeenkomende Verslagen, of het Eerste Overeenkomende slechts Verslag wilt terugkeren.
Maximal
Ga of kaart het maximumaantal verslagen in u de module tijdens elke cyclus van de scenariouitvoering wilt terugwinnen.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43