Adobe Acrobat Sign for Salesforce: veiledning for oppgradering

Fra og med v21.0 er objektet SIGN_Signed_Agreement__c (etikettnavn: Signert avtale) avskrevet.

Kunder som ønsker å få URL-en til den signerte avtalen, bør bruke REST API-kallet agreement GET /agreements/{agreementId}/combinedDocument/url

Merk: URL-en som returneres fra API-kallet, er sikret, og bare gyldig i en begrenset periode.

Nedenfor er den nye sekvensen (per v21.0) som avtalen og dens relaterte objekter oppdateres etter:

1. Vedlegg 
2. Mottakere 
3. Avtale (status og dens andre attributter)
4. Avtalehendelser 
5. Chatter-feeder 

Per v21.x er alle asynkrone prosesser (som inkluderer automatiske oppdateringer og datatilordninger) endret fra Future method til Queuebale, som er den nye tilnærmingen anbefalt av Salesforce.

På grunn av denne endringen vil alle tilpassinger i abonnentorganisasjonen som legger til jobber i Salesforce-køen som en del av den automatiske oppdaterings- og/eller datatilordningsprosessen, mislykkes med feilen «System.LimitException: Too many queueable jobs added to the queue: 2»

Dette skjer fordi en køleggingsprosess bare kan legge til én underordnet køjobb, som allerede er gjort av Adobe Sign (se delen "Apex-grenser for kølegging" her).

"Ved kjeding av jobber kan du bare legge til én jobb fra en kjørende jobb med System.enqueueJob, som betyr at bare én underordnet jobb kan finnes for hver overordnede køjobb. Det er ikke støtte for å starte flere underordnede jobber fra samme køjobb."

Symptomet på denne feilen er at avtalestatusen ikke endres og/eller datatilordningen ikke kjører riktig. 

For å rette denne feilen må du se etter den problematiske utløseren, prosessbyggeren eller arbeidsflyten og deaktivere den eller endre den til å bruke et synkront kall eller planlegge den for senere kjøring, for eksempel 1 time senere.

• Avtalestatusen oppdateres nå etter at dokumentene og mottakerne er oppdatert.
  For V 21 eller tidligere ble statusen fastsatt før.

• Det signerte avtaleobjektet som lagrer bilde-URL-ene, settes ikke inn nå.
  Før v21 ble det satt inn etter at alle de andre oppdateringene ble fullført.
• Maksimal størrelse på oppkallforespørsel eller respons er begrenset til 12 MB for asynkron apex i henhold til Salesforce-styringsgrenser: https://developer.salesforce.com/docs/atlas.en-us.210.0.apexcode.meta/apexcode/apex_gov_limits.htm
  Dokumenter som er større enn 12 MB, kan ikke hentes fra Sign grunnet grensen ovenfor.

• De samsvarer nå med beskrivelsen som returneres fra Sign API og med revisjonsrapportene.
• Oppdateringsprosessen kjøres nå som en innebygd Apex-batchprosess (en asynkron prosess) innenfor Salesforce.
  Tidligere var det en oppdatering som brukte API-oppkall fra utsiden av Salesforce. Utløsere fra disse statusoppdateringene som starter asynkrone prosesser, fungerer ikke lenger fordi Salesforce begrenser oppkall av en asynkron prosess fra en annen asynkron prosess som allerede kjører.
• Avtaleobjektet oppdateres nå i én transaksjon.
  Før v21 ble oppdateringer av avtaleattributter delt opp i adskilte oppdateringskall.
• Oppdateringer er nå mer pålitelige siden Sign-siden automatisk prøver på nytt mislykkede hendelser et angitt antall ganger.
  Før v21 kunne mislykkede avtaler kun forsøkes på nytt ved å utføre en manuell oppdatering fra Salesforce
• Manuelle oppdateringer oppdaterer nå alle aspekter ved avtaler, inkludert de relaterte objektene.
• Push-avtaler kjøres nå i asynkron modus, samtidig som vanlige avtaler og tilleggsattributter oppdateres, det samme som vanlige oppdateringer.
• Det er introdusert nye innstillinger for å muliggjøre deaktivering av oppdateringer av ulike aspekter ved avtalen.
• Når en signert PDF-fil lagres i Salesforce, vil det ikke lenger være en deskriptor (-signert eller -godkjent) tilføyd på slutten av PDF-filnavnet.

Når oppgraderingen er fullført, følger du trinnene nedenfor for å gjenopprette en OAuth-tilkobling til Acrobat Sign:

1. Velg Adobe Acrobat Sign-administrator-fanen.
2. Aktiver automatiske statusoppdateringer.
3. Velg Aktiver.
4. Velg Tillat.

I v20 var det ikke påkrevd at tilbakekallsbrukeren i Salesforce var Adobe Sign-lisensiert bruker. 

Forbedringene av Push Mapping i v21 krever at tilbakekallsbrukeren er aktiv bruker-ID i Adobe Sign-kontoen som er tilkoblet Salesforce-organisasjonen.

v20-kunder som bruker push-tilordning, må kontrollere at tilbakekallsbrukeren allerede er klargjort i Adobe Acrobat Sign før oppgradering. Ellers vil Push Mapping slutte å fungere (til brukeren er klargjort) etter oppgradering til v21.

Push Mapping-funksjonaliteten som automatisk kobler sammen relaterte objekter ved å bruke innstillingen «Kopier Kontaktkonto/salgsmulighet», er utvidet til å omfatte avtaler som sendes fra Salesforce.

• Det betyr at avtaler som sendes fra Salesforce, automatisk vil kopiere den første Kontakt-mottakerens salgsmulighetsoppslag til avtalens salgsmulighetsoppslag, og første Kontakt-mottakers kontooppslag til avtalens kontooppslag, dersom avtalene som sendes, ikke har noen tilknyttet konto/salgsmulighet.

Før v21 ble Chatter-feeder fylt ut bare når avtalen ble sendt innenfra Salesforce.

Denne oppdateringen utvider Chatter-feeden til å inkludere avtaler som sendes fra utsiden av Salesforce (Push-avtaler)

Før v21 oppdaterte avtalevisningen bare PDF-bildet og URL-adressen etter at den første mottakeren fullførte sin handling.

Bildet og URL-adressen blir nå oppdatert tidligere, når i en Forhåndsutfyll-status eller når Ute til signering hos den føste mottakeren.

Det kreves ingen konfigurasjon for å bruke denne funksjonaliteten.

Den nye avtalestatusen Venter på min delegering blir introdusert for å vise når en avtale venter på at avsenderen skal delegere gjeldende mottaker.

Det kreves ingen konfigurasjon for å bruke denne statusen.

Avtalemalen har et "Dager til utløp"-felt (echosign_dev1__Days_Until_Expiration__c).  Dette er et numerisk felt, og er tatt bort i v21.

Et nytt «Dager til utløp»-felt (api-navn: echosign_dev1__Days_Until_Expiration2__c) er lagt til, men det er et tekstfelt slik at det kan referere til andre felt i hovedobjektet (f.eks. {!Expiry_Date__c})

Ved oppgradering fra en tidligere versjon blir alle skjemadata som er tilordnet det eldre utløpsfeltet, automatisk kopiert til det nye feltet, så det er ikke nødvendig å gjøre noe.

Feltene Konto, Salgsmulighet og Kontrakt er ikke lenger tilgjengelig på malsiden.

Administratorer kan konfigurere disse feltene i malen ved å bruke funksjonen Tilordne data til avtalefelt

Tidligere kunne avsenderen definere sin absolutte posisjon i signaturstakken som «Avsender signerer først» eller «Avsender signerer sist».

Dette feltet er ikke lenger tilgjengelig på de nye malsidene. Avsendere kan velge å sette inn seg selv i hvilken som helst posisjon i stakken.

Innstillingen for å styre den totale signaturflyten som Sekvensiell eller Parallell er fjernet.

Den nye malstilen tillater en fullt konfigurerbar arbeidsflyt som kan være helt sekvensiell (underskriverindeks 1 til og med 1+N), parallell (alle underskriverindekser er 1) eller en blanding av sekvensiell og parallell der signaturindeksen konfigureres for den spesifikke arbeidsflyten.

Fem innstillinger er tatt vekk i v21. Alle innstillingene var under Innstillinger for Adobe Sign i Tilpassede innstillinger.

De fem innstillingene er:

• Legg til revisjons-PDF i vedleggsliste: Aktiver denne innstillingen for å legge ved PDF-en med revisjonssporet i avtaleposten etter at avtalen er signert.
• Legg til signert PDF som separate vedlegg: Aktiver denne innstillingen for å legge ved PDF-en med de signerte avtalene som separate vedlegg når flere dokumenter sendes i én transaksjon. Kontakt Adobes kundestøtte for å få hjelp hvis du vil slutte å motta signerte avtaler som flettede PDF-filer. 
• Legg til støttefiler i vedleggsliste: Aktiver denne innstillingen for å legge ved PDF-ene med støttedokumenter i avtaleposten etter at avtalen er signert. Gjennom støttedokumentfeltene i avtalen kan underskriverne laste opp og legge ved støttedokumentene i avtaletransaksjonen.
• Legg til lenke for signert PDF-fil for sendte avtaler (aktivert som standard): Denne innstillingen gjelder kun for sendte avtaler som sendes til utsiden av Salesforce. Aktiver denne innstillingen for å legge til en lenke for signerte PDF-filer i Avtale-posten.
• Legg til signert PDF for pushede avtaler (aktivert som standard) – innstillingen gjelder for avtaler som sendes til Salesforce fra utsiden og pushes inn i Salesforce. Aktiver denne innstillingen for å legge ved den signerte PDF-en i avtaleoppføringen. 

Kunder som bruker innstillingene over, kan konfigurere de nye innstillingene under Avtaleoppdateringsinnstillinger for Adobe Sign.