Adobe Sign til Salesforce: automatiserede flows med Process Builder

Søg

Sidst opdateret den 30. sep. 2022 | Gælder også for Adobe Acrobat Sign

Oversigt

Process Builder i Salesforce er et grafisk peg-og-klik-værktøj, der lader dig automatisere handlinger baseret på udløsende hændelser i dit Salesforce-miljø.

Processer er bygget op omkring en hvis/når-type af logisk flow og indeholder én udløserhændelse ved mindst én betingelse og mindst én handling, der kan ske i realtid og/eller som en planlagt hændelse.

Adobe Sign understøtter to handlingstyper: opdatering af poster og Apex

Hver handlingstype har flere anvendelige handlinger:

Send
Annuller
Slet
Påmind
Opdater
Indlæs (skabelon) er kun tilgængelig ved brug af Apex-handlingstypen

Process Builder er et særligt kraftfuldt værktøj, og den fulde beskrivelse af, hvordan det virker, er uden for dette dokuments omfang.

Dette dokument fremhæver de handlinger, der er tilgængelige via v20 af Adobe Sign til Salesforce-pakken.

Hvis du vil vide mere om Process Builder generelt, er der dokumentation og et interaktivt Trailhead tilgængelig fra Salesforce.

Processer, der bruger "Opdater poster" som handlingstypen

Denne tilgang anvender handlingstypen Opdateringsposter i Salesforce Process Builder for at indstille valglisten Baggrundshandling på aftaleposten for at fremkalde en handling.

Ny proces kan oprettes (som udløses baseret på postændringer), som kan fremkalde en handling på en relateret Adobe Sign-aftale. Brugere kan styre, hvornår handlingen skal opstå (f.eks. efter feltopdatering på masterposten) og hvilke relaterede aftaler der vælges for handlingen.

Følgende handlinger understøttes i øjeblikket:

Send
Annuller
Slet
Påmind
Opdater

Ting at huske på:

Enhver fejl, der registreres i løbet af processen, gemmes i feltet Fejlbesked og kan ses på den tilsvarende Aftale-side
Planlagte handlinger understøttes
Adobe Sign-biblioteksdokumenter understøttes
Én eller flere overordnede eller underordnede aftaler kan vælges
Når en aftales opdateres, er den relaterede post objektet echosign_dev1
- Objektet echosign_dev1 er associeret med de mest almindelige Salesforce-objekter (Kunde, Salgsmulighed, Kontakt osv.). Hvis aftalerne er relateret til et brugerdefineret objekt, vil dette navn være unikt for organisationen.

the_ agreement_ objectwhenupdatingrecords

Handlinger udløses ved at opdatere valglisten Baggrundshandling på aftaleposten med den tilsvarende handlingsværdi

Begrænsninger:

Aftaleposten skal allerede findes. Den kan ikke oprettes eller indlæses fra en aftaleskabelon med en handlingstype "Opdater poster"

Processer, der bruger Apex som handlingstypen

Denne tilgang anvender Apex-handlingstypen i Salesforce Process Builder for at udløse en Aktiverbar metode, der medfølger i den administrerede pakke, for at udføre den tilsvarende handling.

Ny proces kan oprettes (som udløses baseret på postændringer), som kan fremkalde en handling på en relateret Adobe Sign-aftale.

De følgende aktiverbare handlinger er blevet defineret:

Aftaleskabelon: Indlæs aktiverbar handling
- AgreementTemplateLoadInvocableAction.load
  - Send skabelonen og master-id'erne og eventuelle kørselsvariabler.
  - Send en valgfri parameter for at styre, om skabelongenereringen kører i asynkron tilstand
    - Kræves, hvis skabelonen indeholder et dokument fra Adobe Sign-biblioteket
  - Returner det genererede aftalepost-id eller en fejlbesked
    - Fejlen vil ikke være synlig for de brugere, der udfører udløserhandlingen

Når Indlæs aftaletype kaldes, er der fire feltmuligheder, som du kan konfigurere:

Masterpost-id – Salesforces post-id for det objekt, hvortil aftalen bør være relateret.
- Typisk indstillet til Feltreference og værdi "[Object].Id", hvor objekt er Salgsmulighed, Kunde osv.
Aftaleskabelon-id – Salesforces post-id for den aftaleskabelon, der skal indlæses. Indstil type til "ID" og værdi til post-id
Aftaleskabelonens kørselsvariabler – modtagere og/eller dokumenter fra en variabel.
- Én variabel: myRecipient=auserguy@adobe.com
- To variabler: myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
Asynkron behandling – valgfri, angiv ikke, medmindre det er nødvendigt. Dette vil som standard være falsk, så skabelonaktiveringen vil køre i synkron tilstand (dvs. den samme transaktion/tråd)
- Indstil til Sand, hvis din aftaleskabelon indlæser et Adobe Sign-biblioteksdokument
- Sørg for, værdien er Falsk, hvis AutoSend er sand for skabelonen
- Du kan ikke have AutoSend med Adobe Sign-biblioteksdokumenter sammen
- Vær opmærksom på de indbyggede Salesforce-begrænsninger, hvis processen aktiveres fra et batch eller anden asynkron proces

Aftale Annuller Aktiverbar Handling
- AgreementCancelInvocableAction.cancelAgreement
  - Send aftale-id'et
  - Returner enhver fejlbesked

Aftale Slet Aktiverbar Handling
- AgreementDeleteInvocableAction.deleteAgreement
  - Send aftale-id'et
  - Returner enhver fejlbesked

Aftale Påmind Aktiverbar Handling
- AgreementRemindInvocableAction.sendReminder
  - Send aftale-id'et
  - Returner enhver fejlbesked

Aftale Send Aktiverbar Handling
- AgreementSendInvocableAction.sendAgreement
  - Send aftale-id'et
  - Returner enhver fejlbesked

Aftale Opdater Aktiverbar Handling
- AgreementUpdateInvocableAction.updateAgreement
  - Send aftale-id'et
  - Returner enhver fejlbesked

Handlingerne Annuller, Slet, Påmind, Send og Opdater kræver kun Aftale-id for den aftale, som handlingen skal udføres på:

Ting at huske på:

Planlagte handlinger understøttes
Aftaleskabeloner med AutoSend understøttes (dvs. generer og send)
Alle handlinger kan acceptere flere anmodninger i én aktivering
Enhver undtagelse fanges og gemmes i resultatposten og logges som en fejl i Apex-fejlfindingsloggen for at undgå at blokere processen.
Parameteren til funktionen Skabelonindlæsning (Asynkron behandling) styrer, om skabelonbehandlingen sker i synkron eller asynkron tilstand. Kalderen skal angive, om skabelonindlæsningen skal køre i synkron eller asynkron tilstand
- Standardprocessen kører i synkron tilstand. Størstedelen af processer skal køre synkront
- Hvis AutoSend er aktiveret, skal processen være i synkron tilstand
- Den synlige asynkrone proces vil være, hvis du skal indlæse et Adobe Sign-biblioteksdokument

Begrænsninger:

Kombinationen af skabeloner til AutoSend og Adobe Sign-biblioteksdokumenter er ikke understøttet pga. en begrænsning i Salesforce, hvor én tråd ikke kan fjerne en anden tråd
For parametre, der sendes til den aktiverbare handling, kan kun overordnede felter (ikke underordnede felter) refereres. Du kan ikke foretage handlinger på underordnede aftaler under en masterpost
Returværdier fra en Apex-aktivering kan ikke forbruges i en Process Builder. Ingen handlinger, som returnerer en værdi, understøttes (dvs. hent dokumentinfo, eller hent underskrivelses-URL).

Queueable Service

Et nyt tjenestelag er blevet implementeret for at aktivere aftalehandlingerne via Salesforces "queueable" grænseflade. Flere gode oplysninger om Queueable findes her. Handlingerne aktiverer kernetjeneste-API'erne, som derefter kalder til Adobe Sign API.

Følgende handlinger understøttes:

Send
Annuller
Slet
Påmind
Opdater

Den globale echosign_dev1.AdobeSignApiQueueableService er den Apex-tjenesteklasse, som modtager en parameter af typen echosign_dev1.QueueableServiceParameter, der indeholder den handling, der skal aktiveres, og aftalepost-id'et:

echosign_dev1.AdobeSignApiQueueableService.QueueableServiceParameter param = new echosign_dev1.AdobeSignApiQueueableService.QueueableServiceParameter();

param.actionType = EchoSignApiService.ACTION_TYPE.AGREEMENT_REMIND;
param.agreementId = 'a0I0S000000KwkaUAC';

ID jobID = System.enqueueJob(new echosign_dev1.AdobeSignApiQueueableService(param));