Käyttöopas Peruuta

Acrobat Sign for Salesforce: vianmääritysopas

Etkö voi lähettää sopimuksia Salesforcesta? Eivätkö tietojen vastaavuusmääritykset päivitä Salesforcen kenttiä?

Adobe Acrobat Sign for Salesforce: vianmääritysopas on suunniteltu auttamaan sinua ratkaisemaan ongelmia, jotka liittyvät sopimusten lähettämiseen Salesforcelta, tietojen vastaavuusmäärityksiin tai automaattisiin tilapäivityksiin. Tutustu seuraaviin ohjeisiin:

Tietojenvastaavuusmääritysten epäonnistumisen vianmääritys

Acrobat Signin tietojen vastaavuusmäärityksillä päivitetään Salesforce-objektit, kun Acrobat Sign -sopimus allekirjoitetaan, tai tietyssä sopimuksen työnkulun vaiheessa. Jokainen tietojen vastavuusmääritys asetetaan etuajassa ja sisältää tietojen vastaavuusmääritysten säännöt. Jokainen tietojen vastaavuusmäärityssääntö määrittää sen datalähteen ja Salesforcen kohdekentän, jonka sen on päivitettävä. Katso lisätietoja Salesforce-tietojen vastaavuusmäärityksestä.

Jos tietojen vastaavuusmääritys ei päivitä Salesforce-kenttää, suorita seuraavat vianmääritysvaiheet ongelman tunnistamiseksi ja korjaamiseksi:

Tietojen vastaavuusmäärityksen ja yhdistämisen vastaavuusmäärityksen käyttö sopimusten lähettämiseen: esimerkkitilanne 

Esimerkkikäyttäjä:

John Smith

Esimerkkikäyttötapaus:

John haluaa:

  • lähettää sopimuksia mukautetusta objektista nimeltä ”Demo 1” käyttäen sopimusmallia,
  • hakea tietoja toisesta mukautetusta objektista nimeltä ‘Demo 2’, joka on liitetty ‘Demo 1’ -objektiin, ja työntää ne sopimukseen, ja
  • työntää tietoja Demo 2 -objektitietueeseen, kun sopimus on allekirjoitettu. 

 Kuinka käyttötapaus saavutetaan:

  1. Luo Acrobat Signin Sopimus-objektissa Demo 1 -objektille hakukenttä.
  2. Luo Demo 1 -objektissa Demo 2 -objektille hakukenttä.
    Tietoja ei voi hakea tai työntää niihin liittyvästä luettelosta. 
  3. Luo tietojen vastaavuusmääritysmalli seuraavasti:
    1. Anna mallille yksilöllinen nimi.
    2. Valitse Kenttien kuvaukset -kohdasta Valittu objekti ja sen jälkeen avattavasta valikosta Demo 1
    3. Valitse toisesta latautuvasta pudotusvalikosta Demo 2 ID.
    4. Jätä kolmanteen latautuvaan pudotusvalikkoon ”Ei mitään” ja valitse Valitse.
    5. Valitse kohtaan "Which Salesforce Field to Update?" päivitettävä Salesforce-kenttä. 
    6. Suorita tietojen vastaavuusmääritys loppuun noudattamalla vastaavuuksien ja mallipohjien oppaan kohdan Käytä tietojen vastaavuuksia siirtääksesi allekirjoittajan tiedot ja tiedostot Salesforce-tietueisiin ohjeita.
  4. Luo yhdistämismääritysmalli seuraavasti:
    1. Anna mallille yksilöllinen nimi.
    2. Valitse Lisää kentän vastaavuusmääritys
    3. Valitse kohdasta Lähdearvo ensin Valittu objekti ja sitten pudotusvalikosta Demo 1
    4. Valitse toisesta latautuvasta pudotusvalikosta Demo 2 ID.
    5. Valitse seuraavasta latautuvasta pudotusvalikosta kentän nimi, jossa on haluamasi arvo, ja valitse Valmis.
    6. Viimeistele yhdistämisasetukset noudattamalla kohtaa Luo Yhdistämismääritykset-asetuksella Salesforce-tietoja sisältäviä asiakirjoja vastaavuusmääritysten ja mallipohjien oppaassa.
  5. Luo sopimusmalli toimimalla kohdan Luo mallin työnkulut ohjeiden mukaan.
  6. Varmista edellä luomassasi sopimusmallissa, että yhdistämismääritys- ja tietojen vastaavuusmääritysmallit sisältyvät Tietojen vastaavuusmääritys -osioon.
  7. Valitse Sopimusmallin Mallin tiedot -osiosta Salesforce-objekti Demo 1:ksi.
  8. Valitse Määritä tiedot sopimuskenttiin ja sitten avautuvasta valintaikkunasta:
    1. Valitse vaihtoehto Valitse objektista.
    2. Valitse Lähdetyypistä Demo 1 ID.
    3. Valitse Kohdesopimuksen kenttä -kohdan hakukentästä Demo 1 -objekti.
    4. Valitse Tallenna
  9. Valitse sopimusmallista Tallenna.
    Se luo Demo 1 -objektiin linkitetyn sopimusmallin, jossa yhdistämismääritys ja tietojen vastaavuusmääritys on käytössä. 
  10. Avaa Demo 1 -objektitietue ja valitse  > Muokkaa sivua. Vedä ja pudota sitten vasemman paneelin Mukautettu hallinta -osiosta Sopimuspaneeli ja valitse Tallenna.
  11. Valitse Aktivointi ja määritä tietuesivu tarpeidesi mukaan. Valitse testausta varten Määritä organisaation oletukseksi, jolloin kaikki käyttäjät näkevät Sopimuspaneelin. 
  12. Valitse Seuraava ja Tallenna.
  13. Siirry Demo 1 -objektitietueeseen ja päivitä sivu. Sen pitäisi näyttää lisäämäsi Sopimuspaneeli.
  14. Valitse Lähetä sopimus allekirjoitettavaksi. Siinä näkyy luomasi sopimusmalli.
  15. Valitse sopimusmalli ja lähetä sopimus näytöllä olevien ohjeiden mukaan. Varmista, että sopimus sisältää yhdistetyt tiedot Demo 2:sta. 
  16. Allekirjoita sopimus. Siinä näkyy Demo 2 -tietue, johon on päivitetty sopimuksen arvo. 

Vianmääritys, kun sopimusten lähettäminen Salesforcesta epäonnistuu

Jos et pysty lähettämään sopimuksia Salesforcesta, suorita seuraavat vianmääritysvaiheet:  

  1. Varmista, että käytät Adobe Acrobat Signin tuettua versiota. Katso tuetut versiot.

  2. Varmista, että sinulla on lähettäjänä tarvittavat oikeudet.
    Katso, miten käyttäjille myönnetään vaaditut käyttöoikeudet. Oppaassa mainittujen objektien ja kenttien lisäksi lähettäjällä on oltava pääsy muihin Salesforce-objekteihin, joita käytetään työnkulussa.

  3. Tarkista, onko Sopimus-objektilla tai muilla Acrobat Sign -objekteilla Salesforcessa mukautuksia, kuten käynnistimiä, työnkulkuja tai sääntöjä. Mikäli on, poista kaikki mukautukset käytöstä ja lähetä testisopimus nähdäksesi, onnistuuko se.
    Jos sopimuksen lähettäminen onnistuu, kun mukautukset on poistettu käytöstä, katso ohjeet kehittäjäoppaastamme.

    Huomautus:

    Emme tue mukautusten vianetsintää.

  4. Määrittele sopimuksen lähettämisen yhteydessä saamasi virhetyyppi jollakin seuraavista tavoista:

    • Avaa kyseessä oleva sopimustietue Salesforcessa ja etsi punainen banneri, jossa on virheilmoitus. Tämän virheen pitäisi ilmaista, mikä perimmäinen syy on.
    • Tarkista Virheilmoitus-kenttä Sopimusilmoitus-objektissa.
    • Kehittäjäkonsolin kautta tarkistaminen ja seuraavan SOQL-kyselyn suorittaminen:

    Select echosign_dev1__Error_Message__c from

    echosign_dev1__Agreement_Notification__c where

    echosign_dev1__Agreement__c = ‘<enter agreement id>

  5. Virheitä ja niiden ratkaisukeinoja on seuraavassa taulukossa.

    Virhe

    Ratkaisu

    x-api-user-otsikossa annettu käyttäjätunnus tai sähköpostiosoite on virheellinen
    Tai

    Sinulla ei ole kelvollista Adobe Acrobat Sign -käyttäjätiliä

    Nämä virheet osoittavat, että lähettäjällä ei ole voimassa olevaa Acrobat Sign -lisenssiä. Ratkaisu:

    1. Tarkasta sopimustietueen Lähettäjä kirjattu -kenttä, josta tunnistat sopimuksen lähettäjän.
      Jos Lähettäjä kirjattu -kentässä olevaa käyttäjää ei löydy Salesforcesta, Acrobat Sign -paketti käyttää Luoja-kenttää sopimuksen lähettäjänä.
    2. Siirry Lähettäjän käyttäjätiedot -sivulle Salesforcessa ja varmista, että Sähköposti-kentässä on kelvollinen sähköpostiosoite ja aktiivinen Sign-yrityslisenssi. Sähköpostiosoitteen aktiivisen Sign-yrityslisenssin tarkastus.
      1. Kirjaudu Acrobat Signiin hallinnoijan tunnuksilla.
      2. Siirry kohtaan Tili > Käyttäjät ja etsi sähköpostiosoite.
      3. Käyttäjän tilan tulee olla aktiivinen. Käyttäjät, jotka eivät ole aktiivisessa tilassa, eivät voi lähettää sopimuksia. Jos käyttäjä ei ole aktiivinen, katso miten käyttäjien lisääminen ja hallinta tapahtuu ja lue ohjeet kohdasta ”Sähköposti on käytössä, mutta käyttäjän tila ei ole aktiivinen”.
      4. Jos käytetään lähettämistä käyttäjän puolesta, vahvista sähköpostiosoite valitsemalla Sopimus-objektin Lähetä käyttäjän puolesta -kenttä. Varmista, että tämän käyttäjän sähköpostiosoitteella on voimassa oleva allekirjoituslisenssi kirjautumalla Acrobat Signiin. Varmista, että Salli lähettäminen muuna käyttäjänä -kenttä on valittu puolestalähettävän käyttäjän Käyttäjätiedot-sivulla. Tämä kenttä ei välttämättä ole oletusarvoisesti näkyvissä Käyttäjän objektisivun asettelussa.
    3. Vahvista käyttöoikeudet edellä olevan vaiheen 2 mukaisesti. Katso, miten käyttäjille myönnetään vaaditut käyttöoikeudet.

    Tiedostomuotoa ei tueta

    Tämä virhe ilmenee, kun asiakirja, jonka yrität lähettää allekirjoitettavaksi, ei ole tuetussa muodossa.

    Acrobat Signin järjestelmävaatimukset -osiossa on Tuetut asiakirjamuodot -osio, josta voit tarkistaa, mitä tiedostomuotoja tuetaan Acrobat Signiin lähetettäessä.

    Allekirjoituspainikkeessa käytetty objektitunnus on virheellinen

     Tämä virhe ilmenee, kun Lähetä tämän käyttäjän puolesta -painikkeen mallin tunnus tai objektin päätunnus ei ole kelvollinen.

    Suosittelemme, että annat oikean objektitunnuksen ja aloitat prosessin uudelleen.

Automaattisen tilapäivityksen epäonnistumisen vianmääritys 

Jos sopimus ei päivity oikeaan tilaan, suorita seuraavat vianmääritysvaiheet:

  1. Varmista, että olet toteuttanut Adobe Acrobat Sign for Salesforce: asennusoppaassa mainitut ennakkoedellytykset ja asennuksen jälkeiset kokoonpanot (pakollinen). 

  2. Siirry Salesforce Lightning -sivun kohtaan Adobe Acrobat Signin ylläpito > Ota automaattiset tilapäivitykset käyttöön ja varmista, että näet viestin ”Automaattiset tilapäivitykset on otettu tässä organisaatiossa käyttöön”.

    salesforce-faq-status-update-enabled

    Jos et näe viestiä, suorita seuraavat vaiheet:

    1. Kirjaudu ulos ja sitten uudelleen sisään järjestelmänvalvojana.
    2. Siirry kohtaan Adobe Acrobat Signin ylläpito > Ota automaattiset tilapäivitykset käyttöön ja valitse Ota käyttöön.
    3. Esiin tulevassa Salli Acrobat Signin käyttö -ikkunassa:
      1. Huomaa dialogin alareunassa oleva sähköpostiosoite.
      2. Varmista, että tällä sähköpostiosoitteella on voimassa oleva allekirjoituslisenssi ja että sähköpostiosoite on järjestelmänvalvoja Salesforcessa.
      3. Varmista, että käyttäjälle on myönnetty Adobe Sign Integration User -käyttöoikeus. 
      4. Valitse Salli.

    Sen pitäisi näyttää viesti ”Automaattiset tilapäivitykset on otettu tässä organisaatiossa käyttöön”.

  3. Tarkista Sopimusilmoitus-objektin Virheviesti-kenttä. Voit tarkistaa kentän arvon suorittamalla alla olevan SOQL-kyselyn Developer Consolessa: 

    SELECT Id, echosign_dev1__Agreement_Event_Type__c, echosign_dev1__Agreement_Status__c, echosign_dev1__Document_Key__c, echosign_dev1__Error_Message__c, echosign_dev1__Notification_Type__c, echosign_dev1__Status__c FROM echosign_dev1__Agreement_Notification__c where echosign_dev1__Agreement__c='<agreementId>'

  4. Jos sopimus on puskusopimus, joka on luotu Salesforce-ympäristön ulkopuolella, varmista, että noudatat Adobe Acrobat Sign for Salesforce: suuret asiakirjat ja työntösopimukset -palveluopasta.

  5. Valitse Asetukset > Mukautetut asetukset > Adobe Sign -sopimuksen päivitysasetukset > Hallitse > Uusi (tai Muokkaa). Varmista avautuvalta sivulta, että Päivitä sopimuksen tila -valintaruutu (organisaation oletustason arvon alla) on valittu. 

  6. Siirry Sopimukset-välilehdelle, valitse kaikki sopimukset, joiden päivittäminen epäonnistui ja valitse sitten oikeasta yläkulmasta Päivitä sopimus

    salesforce-faq-update-agreement

  7. Tarkista, päivittyykö kyseisten sopimusten tila. Jos ne päivittyvät nyt, tarkista uudella testisopimuksella, onko ongelma vielä toistettavissa. Jos se on toistettavissa, jatka alla olevien vianmääritysvaiheiden mukaisesti.

    Jos ongelma ei ole toistettavissa, se on saattanut olla kertaluonteinen, ja suosittelemme, että tutustut tähän vianmääritysoppaaseen, kun ongelma toistuu. 

  8. Tarkista, onko Sopimus-objektilla tai muilla Acrobat Sign -objekteilla Salesforcessa mukautuksia, kuten käynnistimiä, työnkulkuja tai sääntöjä.

    Jos on, poista kaikki mukautukset käytöstä ja lähetä testisopimus tavallisten vaiheiden mukaisesti ja katso, onnistuuko se. Tilan tulisi muuttua luonnoksesta allekirjoitettavaksi.

    Jos sopimuksen tila muuttuu allekirjoitettavaksi sen jälkeen, kun olet poistanut mukautukset käytöstä, katso ohjeet kehittäjäoppaastamme.

    Jos tila ei päivity, lähetä testisopimus suoraan Sopimukset-välilehdeltä mukautukset poistettuna käytöstä, ja tarkista, meneekö se läpi. Jos tila ei vieläkään muutu, tarkista yllä mainitut vaiheet 1 ja 2.

    Huomautus:

    Emme tue mukautusten vianetsintää.

    Acrobat Sign -objektit
    Lisää liitetiedostoja Tiedostojen vastaavuusmääritykset Määritä tiedot sopimuskenttiin
    Lisää lomakekenttämallit  Lomakekenttien tuonti Yhdistämismääritykset
    Lisää vastaanottajat Lomakekenttien alimääritys Toisensa poissulkevat ehdot
    Sopimukset Lomakekenttien alimääritystiedot  Objektien määritykset
    Sopimustapahtumat Lomakekenttien määritykset Vastaanottajat
    Sopimusmallit Lomakekenttien vastaavuustiedot Allekirjoitettu sopimus
    Tietojen yhdistämismääritykset Ryhmän yhdistämismääritykset Käynnistimet
    Kenttien määritykset Kirjastomallit Käyttäjien synkronoinnin tulokset
    Sopimustyyppi    

Tee vianmääritys ongelmille, joita saattaa ilmetä paranneltujen toimialueiden käyttöönoton jälkeen.

Kaikilla organisaatioilla on nyt Salesforcen parannetut toimialueet oletusarvoisesti käytössä, eikä tämä vaikuta Acrobat Sign for Salesforce -pakettiin. Asiakkaat, jotka ovat määrittäneet sivustonsa suuria tiedostojen lataus- ja palveluviestisopimuksia varten, kohtaavat kuitenkin ongelmia, kun heidän laajennetut toimialueensa otetaan käyttöön, mikä johtaa sivuston muuttuneisiin URL-osoitteisiin ja rikkinäisiin sopimuksiin.

Sopimusten sujuvan toiminnan varmistamiseksi asiakkaiden on päivitettävä suurten tiedostojen lataamisen mukautetut asetukset sivuston päivitetyn URL-osoitteen mukaisiksi.

Push-sopimusten takaisinsoiton URL-osoitteen päivittämistä varten asiakkaiden on Otettava yhteyttä tukeen ja annettava tarvittavat tiedot. Lisätietoja on kohdassa Hanki Acrobat Sign -tilillesi määritettyjä yksittäisiä palveluja.

Vianmääritysongelmia etsittäessä liidejä Government Cloud -ympäristössä

Acrobat Sign Salesforcella voi etsiä liidejä ja lisätä niitä sopimuksen vastaanottajiksi, kun vastaanottajatyypiksi on valittu Liidit. Jos Government Cloud -käyttäjät luovat liidejä, yhteyshenkilöitä tai käyttäjiä mutta eivät löydä niitä hakukentästä, Salesforce-organisaation järjestelmänvalvojat voivat ratkaista ongelman seuraavalla tavalla:

  1. Siirry kohtaan Asetukset > Objektien hallinta ja etsi sitten Liidi.
  2. Valitse vasemmasta paneelista Kentät ja suhteet.
  3. Tarkista kaikkien pakollisten kenttien (kuten Nimi, Sähköposti ja Mobiili) kohdalla, että ne ovat käyttäjien käytettävissä. Se tehdään näin:
    1. Valitse mikä tahansa kenttä, jonka haluat tarkistaa. Valitse esimerkiksi Mobiili.
    2. Valitse Näkyvä-valintaruutu kaikille käyttäjille, joille haluat myöntää kenttien käyttöoikeudet.
    3. Napsauta Tallenna.
Lähetä sopimuksia liideihisi Acrobat Sign Salesforcesta Government Cloudissa.

Lähetä sopimuksia liideihisi Acrobat Sign Salesforcesta Government Cloudissa.

Ota yhteyttä tukeen

Jos ongelma ei ratkea noudattamalla yllä mainittuja vianmääritysvaiheta, ota yhteyttä tukeen ja anna meille seuraavat tiedot:

  • Ongelman kuvaus
  • Integraation määrittämiseen käytetyn Acrobat Sign -tilin järjestelmänvalvojan sähköpostiosoite
  • Acrobat Sign -tilin järjestelmänvalvojan sähköpostiosoite, jota käytettiin automaattisten tilapäivitysten käyttöönottamiseen:
  • Salesforceen asennettu Acrobat Sign -paketin versio
  • Salesforce-organisaation tunnus
  • Salesforce-tietuetunnukset niille sopimuksille, joita ongelma koskee
  • Sen käyttäjän sähköpostiosoite, jota ongelma koskee
  • Voidaanko ongelma toistaa jatkuvasti vai onko se ajoittainen tai kertaluonteinen?
  • Viimeisimmän esiintymän päivämäärä: <Syötä viimeisimmän esiintymän päivämäärä/aika/aikavyöhyke>
  • Yksityiskohtaiset ohjeet ongelman toistamiseksi
  • Odotettu käyttäytyminen: <Kuvaile odottamaasi käyttäymistä, kun vaiheet on suoritettu>
  • Vianmääritystä koskevat huomautukset: <Kuvalile tähän mennessä tehdyt vianmäärityksen toimenpiteet tällä dokumentaatiolla>

Pyydä apua nopeammin ja helpommin

Oletko uusi käyttäjä?