Adobe Sign for Salesforce: Process Builderin automaattiset työnkulut

Yleiskatsaus

Salesforcen Process Builder on osoittamalla ja napsauttamalla toimiva graafinen työkalu, jonka avulla voit automatisoida toiminnot Salesforce-ympäristön käynnistystapahtumien mukaan.

Prosessit perustuvat jos/niin-tyyppiseen loogiseen työnkulkuun ja sisältävät yhden käynnistystapahtuman, vähintään yhden ehdon ja vähintään yhden toiminnon, joka voidaan suorittaa reaaliajassa ja/tai ajoitettuna tapahtumana.

Adobe Sign tukee kahta toimintotyyppiä, jotka ovat Tietueiden päivittäminen ja Apex.

Kummallakin toimintotyypillä on useita käynnistettävissä olevia toimintoja:

• Lähetä
• Peruuta
• Poista
• Muistuta
• Päivitä
• Lataa (malli) on käytettävissä vain Apex-toimintotyyppiä käytettäessä.

Process Builder on hyvin tehokas työkalu, ja sen toimintatavan täydellinen kuvaus ei kuulu tämän dokumentin piiriin.

Tässä dokumentissa esitellään Adobe Sign for Salesforce -paketin versiossa v20 käytettävissä olevat toiminnot.

Jos haluat tietää enemmän Process Builderista yleisesti, Salesforcessa on käytettävissä dokumentaatio ja interaktiivinen Trailhead.

Päivitä tietueet -toimintotyyppiä käyttävät prosessit

Tätä lähestymistapaa käytettäessä sopimustietueen Taustatoimi-valintaluettelokenttä asetetaan toiminnon käynnistämiseksi Salesforce Process Builderin Päivitä tietueet -toimintotyypillä.

Näin voidaan luoda uusi prosessi (joka käynnistetään tietueen muutostapahtumien mukaan) ja sitten käynnistää siihen liittyvään Adobe Sign -sopimukseen liittyvä toiminto. Käyttäjät voivat hallita toiminnon ajoitusta (eli sen jälkeen, kun päätietueen kenttä päivittyy) ja valita toimintoon liittyvät sopimukset.

Tällä hetkellä tuetaan seuraavia toimintoja:

• Lähetä
• Peruuta
• Poista
• Muistuta
• Päivitä

Asioita, joista on hyvä olla tietoinen:

• Prosessin aikana havaitut virheet tallennetaan Virheilmoitus-kenttään, ja niitä voidaan tarkastella vastaavalla Sopimus-sivulla.
• Ajoitettuja toimintoja ei tueta.
• Adobe Sign -kirjastodokumentit ovat tuettuja.
• Pää- tai alisopimuksia voidaan valita yksi tai useampia.
• Kun sopimustietue päivitetään, siihen liittyvä tietue on echosign_dev1-objekti.
  • echosign_dev1-objekti liitetään yleisiin Salesforce-objekteihin (Tili, Mahdollisuus, Yhteyshenkilö jne.). Jos sopimukset liittyvät mukautettuun objektiin, tämä nimi on organisaatiolle yksilöllinen.

• Toiminnot käynnistetään päivittämällä sopimustietueen Taustatoimen valintaluettelokenttä vastaavalla toiminnon arvolla

• Sopimustietueen on oltava jo olemassa. Sitä ei voi luoda tai ladata sopimusmallista Päivitä tietueet -toimintotyypillä.

Apex-toimintotyyppiä käyttävät prosessit

Tässä lähestymistavassa käytetään Salesforce Process Builderin Apex-toimintotyyppiä hallittuun pakettiin sisältyvän Käynnistettävissä oleva menetelmä -toiminnon käynnistämiseen ja vastaavan toiminnon suorittamiseen. 

Näin voidaan luoda uusi prosessi (joka käynnistetään tietueen muutostapahtumien mukaan) ja sitten käynnistää siihen liittyvään Adobe Sign -sopimukseen liittyvä toiminto.

Seuraavat käynnistettävissä olevat toiminnot on määritetty:

• Sopimusmallin lataamisen käynnistettävissä oleva toiminto
  • AgreementTemplateLoadInvocableAction.load
    • Syötä mallin ja päätietueen tunnukset ja käytönaikaiset muuttujat.
    • Syötä valinnainen parametri, jolla voit hallita, suoritetaanko mallin luonti asynkronisessa tilassa.
      • Tarvitaan, jos malli sisältää dokumentin Adobe Sign -kirjastosta.
    • Palauta luotu sopimustietuetunnus tai virheilmoitus
      • Virhe ei näy käynnistystoiminnon suorittaville käyttäjille.

Kun käynnistät Lataa sopimustyypin luokka -toiminnon, voit määrittää neljä kenttäasetusta:

• Päätietueen tunnus – Sen objektin Salesforce-tietuetunnus, johon sopimuksen pitäisi liittyä. 
  • Yleensä tyyppinä on Kenttäviittaus ja arvona on [Object].Id, jossa objekti on esimerkiksi Mahdollisuus tai Tili.
• Sopimusmallin tunnus – Ladattavan sopimusmallin Salesforce-tietuetunnus. Aseta tyypiksi Tunnus ja arvo tunnuksen tallennusta varten.
• Sopimusmallin käytönaikaiset muuttujat – Vastaanottajat ja/tai dokumentit muuttujasta. 
  • Yksi muuttuja: myRecipient=auserguy@adobe.com 
  • Kaksi muuttujaa: myRecipient=auserguy@adobe.com,myAttachment=00Pf4000002df0q
• Asynkroninen käsittely – Valinnainen, älä määritä, paitsi jos on tarpeen. Oletusarvoisesti tämä on epätosi, joten mallin käynnistys toimii synkronitilassa (eli samassa transaktiossa/säikeessä)
  • Aseta arvoksi Tosi, jos sopimusmalli lataa Adobe Sign -kirjastodokumentin.
  • Varmista, että arvona on Epätosi, jos mallin AutoSend-arvo on tosi.
  • Automaattista lähetystä ei voi käyttää yhdessä Adobe Sign -kirjastodokumenttien kanssa.
  • Ole tietoinen Salesforcen sisäisistä rajoituksista, jos prosessi käynnistetään eräkäsittelystä tai muusta asynkronisesta prosessista.

• Sopimuksen peruuttamisen käynnistettävissä oleva toiminto
  • AgreementCancelInvocableAction.cancelAgreement
    • Syötä sopimustunnus
    • Palauta mikä tahansa virheilmoitus

• Sopimuksen poistamisen toiminto, jota ei voida käynnistää
  
  • AgreementDeleteInvocableAction.deleteAgreement
    • Syötä sopimustunnus
    • Palauta mikä tahansa virheilmoitus

• Sopimusta koskevan muistutuksen käynnistettävissä oleva toiminto
  • AgreementRemindInvocableAction.sendReminder
    • Syötä sopimustunnus
    • Palauta mikä tahansa virheilmoitus

• Sopimuksen lähettämisen toiminto, jota ei voida käynnistää
  
  • AgreementSendInvocableAction.sendAgreement
    • Syötä sopimustunnus
    • Palauta mikä tahansa virheilmoitus

• Sopimuksen sopimuksen päivittämisen toiminto, jota ei voida käynnistää
  
  • AgreementUpdateInvocableAction.updateAgreement
    • Syötä sopimustunnus
    • Palauta mikä tahansa virheilmoitus

Peruuta-, Poista-, Muistuta-, Lähetä- ja Päivitä-toiminnot edellyttävät vain käsiteltävän sopimuksen sopimustunnusta:

Asioita, joista on hyvä olla tietoinen:

• Ajoitettuja toimintoja ei tueta.
• Automaattisen lähetyksen sisältäviä sopimusmalleja tuetaan (eligeneroida ja lähettää)
• Kaikki toiminnot pystyvät hyväksymään useita pyyntöjä yhdessä kutsussa.
• Poikkeukset siepataan ja tallennetaan tulostietueeseen ja kirjataan virheenä Apexin virheenkorjauslokiin estoprosessin suorittamisen estämiseksi.
• Mallin lataus -toiminnon parametri (Asynkroninen käsittely) määrää, suoritetaanko mallin käsittely synkronisessa vai asynkronisessa tilassa. Kutsujan on määritettävä, suoritetaanko mallin lataus synkronisessa vai asynkronisessa tilassa. 
  • Oletusprosessi suoritetaan asynkronisessa tilassa. Suurin osa prosesseista suoritetaan synkronisesti.
  • Jos automaattinen lähetys on käytössä, prosessin on oltava synkronisessa tilassa.
  • Asynkronista prosessia on käytettävä esimerkiksi silloin, jos haluat ladata Adobe Sign -kirjastodokumentin.

Rajoitukset:

• Automaattisesti lähetettävien mallien ja Adobe Sign -kirjastodokumenttien yhdistelmää ei tueta, sillä Salesforcessa on rajoitus, jossa yksi säie voi käynnistää toisen säikeen.
  
• Käynnistettävissä olevaan toimintoon siirrettyjen parametrien tapauksessa voidaan viitata vain pääkenttiin (ei alikenttiin). Päätietueen alla oleville alisopimuksille ei voi suorittaa toimintoja.
• Apex-kutsun palautusarvoja ei voi käyttää prosessien luonnissa. Arvon palauttavia toimintoja ei tueta (elihae asiakirjan tiedot tai allekirjoituksen URL)

Jonotettavissa oleva palvelu

Lisätty uusi palvelutaso, joka käynnistää sopimustoiminnot Salesforcen jonotettavan käyttöliittymän kautta. Lisää hyödyllisiä tietoja jonotettavasta palvelusta on täällä. Toiminnot käynnistävät ydinpalvelun API:t, jotka sitten kutsuvat Adobe Sign API:n. 

Tuettuja ovat seuraavat toiminnot:

• Lähetä
• Peruuta
• Poista
• Muistuta
• Päivitä

Yleinen echosign_dev1.AdobeSignApiQueueableService on palvelun Apex-luokka, joka hyväksyy parametrityypin echosign_dev1.QueueableServiceParameter. Se sisältää käynnistettävän toiminnon ja sopimuksen tietuetunnuksen: