Adobe Sign for Salesforce: Process Builderin automaattiset työnkulut

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, milloin toiminto suoritetaan (eli minkä päätietueen kenttäpäivityksen jälkeen) ja mitkä liittyvät sopimukset valitaan toimintoa varten.

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. Tämä on oletusarvoisesti epätosi, joten mallin käynnistäminen suoritetaan synkronointitilassa (eli samassa tapahtumassa/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ävät sopimusmallit ovat tuettuja (eli luo ja lähetä).
• 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 (esim. dokumentin tietojen tai allekirjoitus-URL-osoitteen haku).

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: