På Salesforce Lightning-sidan går du till fliken Adobe Acrobat Sign-administratör.
Senast uppdaterad den
16 okt. 2024
Kan du inte skicka avtal från Salesforce? Kan datamappningar inte uppdatera Salesforce-fälten?
Adobe Acrobat Sign för Salesforce: felsökningsguide är utformad för att hjälpa dig att lösa problem med att skicka avtal från Salesforce, datamappningar eller automatiska statusuppdateringar. Se hur du kan:
Acrobat Sign-datamappningar uppdaterar Salesforce-objekt när ett Acrobat Sign-avtal har signerats eller under en angiven fas i arbetsflödet. Varje datamappning konfigureras i förväg och innehåller datamappningsregler. Varje datamappningsregel anger datakällan och målfältet i Salesforce som måste uppdateras. Mer information finns i Datamappning i Salesforce.
Om datamappningen inte lyckas uppdatera ett Salesforce-fält kör du följande felsökningssteg för att identifiera och åtgärda problemet:
Så här gör du:
Välj Tillåt. Det visar meddelandet Automatiska statusuppdateringar har aktiverats för den här organisationen.
Se till att användaren av automatisk statusuppdatering (vanligtvis Sign-kontoadministratören som du använde för att konfigurera integreringen) och att avsändaren har åtkomst till de objekt som du försöker uppdatera med datamappning.
Om du vill kontrollera fältets värde kan du lägga till fältet i listvyn över Avtal, använda Developer Console, eller använda Workbench.
Kontrollera att fältet 'Data Mapping Result' på objektet 'Agreement' har värdet 'Completed' eller 'Failed.' Om det inte finns något värde betyder det att datamappning inte utlösades alls. Om värdet är tomt och om fältet Datamappning har användar-ID ifyllt kan du försöka återaktivera datamappning på följande sätt:
Fältet Datamappningsfel lagrar fel från datamappningen. Du kan kontrollera fältets värde genom att lägga till fältet i listvyn över Avtal, med Developer Console eller via Workbench. Nedan visas en lista över vanliga fel och motsvarande lösningssteg:
| Fel | Failed to map data field: System.DmlException Update failed. Det första undantaget på rad 0 med ID 00ZxxqwertasdmjVUAR, första fel STRING_TOO_LONG, ägartitel: datavärde för stort: Adobe Acrobat Sign Adobe Inc (max längd=20): [Owner_Title__c] (echosign_dev1) 165 |
Upplösning: Det här felet innebär att data i formulärfältet i det uppdaterade dokumentet överskrider storleksgränsen för det fält i Salesforce som du försöker uppdatera. Lös problemet:
|
|
| Fel |
Försökte mappa till en relaterad objektreferens som inte angavs i avtalet: <api name of field on the Salesforce object you are trying to update>” |
Upplösning: Det här felet innebär att det inte finns någon etablerad koppling mellan objektet Avtal och Salesforce-objektet som du försöker uppdatera. Se steg 4 ovan. |
|
| Fel |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Upplösning Felet indikerar att datamappningen misslyckades eftersom det inte gick att komma åt ett nödvändigt objekt. Prova följande steg för att lösa problemet:
|
Exempelanvändare:
Johan Svensson
Exempel på användningsfall:
Johan vill:
- Skicka avtal från ett anpassat objekt med namnet Demo 1 med en avtalsmall,
- Hämta information från ett annat anpassat objekt med namnet Demo 2 som är associerat med objektet Demo 1 och skicka till avtalet, och
- Skicka information till objektposten Demo 2 när avtalet har signerats.
Steg för att uppnå användningsfallet:
- Skapa ett uppslagsfält för objektet Demo 1 i Acrobat Sign-objektet Avtal.
- På objektet 'Demo 1' skapar du ett sökfält för objektet 'Demo 2'.
Du kan inte hämta eller skicka information från/till en relaterad lista. - Skapa en datamappningsmall enligt följande:
- Ange ett unikt mallnamn.
- Under Fältmappningarväljer du Markerat objekt och från rullgardinsmenyn väljer du sedan Demo 1.
- I den andra rullgardinsmenyn som visas väljer du Demo 2 ID.
- I den tredje listrutan som visas väljer du Ingen och väljer Välj.
- Välj det fältnamn som du behöver uppdatera i Vilket fält i Salesforce ska uppdateras?.
- Följ stegen i avsnittet Använd datamappningar för att överföra undertecknardata och -filer till Salesforce-poster i användarhandboken för mappningar och mallar för att slutföra konfigurationen av datamappning.
- Så här skapar du en mall för kopplingsmappning:
- Ange ett unikt mallnamn.
- Välj Lägg till fältmappning.
- Under Källvärde väljer du Markerat objekt, och från rullgardinsmenyn väljer du sedan Demo 1.
- I den andra rullgardinsmenyn som visas väljer du Demo 2 ID.
- I nästa rullgardinsmeny som visas väljer du fältnamnet med det värde du behöver hämta och väljer Klart.
- För att slutföra konfigurationen av kopplingsmappningen följer du avsnittet Använda kopplingsmappningar för att generera dokument med Salesforce-data i användarhandboken för mappningar och mallar.
- Skapa en avtalsmall genom att följa stegen under Skapa mallarbetsflöden.
- I avtalsmallen som du skapade ovan ser du till att kopplingsmappningen och mallarna för datamappning ingår i avsnittet Datamappning.
- I avsnittet Mallinformation i avtalsmallen väljer du Salesforce-objektet som Demo 1.
- Välj Mappa data till avtalsfält och sedan i dialogrutan som visas:
- Välj alternativet Markera från objekt.
- Under Källtyp väljer du Demo 1 ID.
- Under Målavtalsfält väljer du objektet Demo 1 i uppslagsfältet.
- Välj Spara.
- På avtalsmallen väljer du Spara.
Det skapar en avtalsmall som är länkad till objektet 'Demo 1' med sammanslagning och datamappning aktiverad. - Öppna en Demo 1-objektpost och välj
> Redigera sida. Dra och släpp sedan AgreementPanel från avsnittet Anpassad hantering på den vänstra panelen och välj Spara. - Välj Aktivering och tilldela postsidan efter behov. För teständamål väljer du Tilldela som standardorganisation, vilket innebär att AgreementPanel visas för alla användare.
- Välj Nästa och Spara.
- Gå till objektposten Demo 1 och uppdatera sidan. Den ska visa panelen AgreementPanel som du har lagt till.
- Välj Skicka avtal för signering. Då visas avtalsmallen som du skapade.
- Välj avtalsmallen och följ stegen på skärmen för att skicka avtalet. Kontrollera att avtalet innehåller de sammanfogade uppgifterna från Demo 2.
- Signera avtalet. Den visar posten Demo 2 uppdaterad med värdet från avtalet.
Kör följande felsökningssteg om du inte kan skicka avtal från Salesforce:
Se till att du använder en version av Adobe Acrobat Sign som stöds. Se versioner som stöds.
Kontrollera att du som avsändare har de behörigheter som krävs.
Se så här ger du användarna nödvändig åtkomst. Utöver de objekt och fält som nämns i användarhandboken måste avsändaren ha åtkomst till andra Salesforce-objekt som används i arbetsflödet.
Kontrollera om objektet Avtal eller andra Acrobat Sign-objekt i Salesforce har anpassningar som utlösare, arbetsflöden eller regler. Om ja, inaktivera alla anpassningar och skicka ett testavtal för att se om det går igenom.
Om avtalet skickas utan problem efter att anpassningarna har inaktiverats kan du läsa vår utvecklarguide för riktlinjer.
Obs!
Vi tillhandahåller inte support för felsökning av anpassningar.
Använd ett av följande sätt för att identifiera typen av fel som du fick när du skickade avtalet:
- Öppna den påverkade avtalsposten i Salesforce och sök efter en röd banderoll med ett felmeddelande. Detta fel bör ange grundorsaken.
- Markera fältet Felmeddelande på objektet Avtalsmeddelande.
- Så här kontrollerar du via utvecklarkonsolen och kör följande SOQL-fråga:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
Se följande tabell över fel och steg för att lösa dem:
|
Fel |
Lösning |
|---|---|
|
Användar-ID eller e-postadress i x-api-användarrubrik är ogiltig Du har inget giltigt användarkonto för Adobe Acrobat Sign |
Dessa fel anger att avsändaren inte har en giltig Acrobat Sign-licens. För felsökning:
|
|
Det här formatet stöds inte |
Felet uppstår när dokumentet du försöker skicka för signering inte är i ett format som stöds. Se avsnittet Dokument som stöds i Systemkrav för Acrobat Sign för att kontrollera vilka filformat som stöds för överföring till Acrobat Sign. |
|
Felaktigt objekt-ID används i signaturknappen |
Felet uppstår när knappens mall-ID eller objektets huvud-ID är ogiltig för Skicka på uppdrag av. Vi föreslår att du anger rätt objekt-ID och sedan gör om processen. |
Kör följande felsökningssteg om ett avtal inte uppdateras med rätt status:
Kontrollera att du har implementerat de krav och de konfigurationer efter installationen (som är obligatoriska) som nämns i Adobe Acrobat Sign för Salesforce: installationshandbok.
På sidan Salesforce Lightning går du till Adobe Acrobat Sign-administratör > Aktivera automatiska statusuppdateringar och ser till att du ser meddelandet Automatiska statusuppdateringar har aktiverats för den här organisationen.
Kör följande steg om meddelandet inte visas:
- Logga ut och logga in igen som systemadministratör.
- Gå till Adobe Acrobat Sign-administratör > Aktivera automatiska statusuppdateringar och välja Aktivera.
- I dialogrutan Tillåt åtkomst till Acrobat Sign som visas:
- Observera e-postadressen längst ned i dialogrutan.
- Se till att e-postadressen har en giltig Sign-licens och är systemadministratör i Salesforce.
- Se till att användaren har behörighetsuppsättningen Adobe Sign-integreringsanvändare tilldelad.
- Välj Tillåt.
Meddelandet Automatiska statusuppdateringar har aktiverats för den här organisationen ska visas.
På objektet Avtalsmeddelande kontrollerar du fältet Felmeddelande. Kör nedanstående SOQL-fråga i Developer Console för att kontrollera värdet i fältet:
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>'
Om avtalet är ett push-avtal som har skapats utanför Salesforce-miljön ser du till att du följer Adobe Acrobat Sign för Salesforce: handbok för tjänster i stora dokument och push-avtal.
Gå till fliken Avtal, markera alla avtal som inte kunde uppdateras och välj sedan i det övre högra hörnet Uppdatera avtal.
Kontrollera om statusen uppdateras för dessa avtal. Om de uppdateras nu kontrollerar du om problemet fortfarande reproduceras med ett nytt testavtal. Om det reproduceras fortsätter du med felsökningsstegen nedan.
Om problemet inte reproduceras kan det ha varit en engångsföreteelse och vi föreslår att du läser den här felsökningsguiden när problemet uppstår på nytt.
Kontrollera om objektet Avtal eller andra Acrobat Sign-objekt i Salesforce har anpassningar som utlösare, arbetsflöden eller regler.
Om ja, inaktiverar du alla anpassningar och skickar ett testavtal enligt de vanliga stegen och ser om det går igenom. Statusen bör ändras från Utkast till Skickat för signering.
Om avtalsstatusen ändras till Skickat för signering efter att du har inaktiverat anpassningarna, se riktlinjer i Användarhandbok för utvecklare.
Om statusen inte uppdateras skickar du ett testavtal direkt från fliken Avtal med inaktiverade anpassningar och kontrollerar om det går igenom. Om statusen fortfarande inte ändras kontrollerar du stegen 1 och 2 som nämns ovan.
Obs!
Vi tillhandahåller inte support för felsökning av anpassningar.
| Acrobat Sign-objekt | ||
|---|---|---|
| Lägg till bifogade filer | Filmappningar | Mappa data till avtalsfält |
| Lägg till formulärfältsmallar | Import för formulärfält | Kopplingsmappningar |
| Lägg till mottagare | Underordnad formulärfältsmappning | Mutexer |
| Avtal | Post för underordnad formulärfältsmappning | Objektmappningar |
| Avtalshändelser | Formulärfältsmappning för | Mottagare |
| Avtalsmallar | Poster för formulärfältsmappning | Signerat avtal |
| Datamappningar för | Gruppmappningar | Utlösare |
| Fältmappningar | Biblioteksmallar | Användarsynkroniseringsresultat |
| Avtalstyp | ||
Alla organisationer har nu Salesforces förbättrade domäner aktiverade som standard, vilket inte påverkar Acrobat Sign för Salesforce-paketet. Kunder som har konfigurerat sina webbsidor för stora filhämtningar och push-avtal får dock problem när deras förbättrade domäner aktiveras, vilket leder till ändrade webbadresser och felaktiga avtal.
För att säkerställa att avtalen fungerar smidigt måste kunderna uppdatera de anpassade inställningarna för stora filhämtningar så att de återspeglar den uppdaterade webbadressen.
För att uppdatera webbadressen för återanrop för push-avtal måste kunderna kontakta support och uppge den begärda informationen. Mer information finns i avsnittet om hur du får enskilda tjänster konfigurerade för ditt Acrobat Sign-konto.
Acrobat Sign för Salesforce tillåter att du söker efter och lägger till leads som avtalsmottagare när leads är valda som mottagartyp. Men om Government Cloud-användare skapar leads, kontakter eller användare, men inte kan hitta dem med sökfältet, kan administratörer för Saleforce-organisationer följa dessa steg för en lösning:
- Gå till Inställningar > Objekthanteraren och sök sedan efter Lead.
- I den vänstra panelen väljer du Fält och relationer.
- För alla obligatoriska fält (som Namn, E-post, Mobil med mera), kontrollera användarnas tillgänglighet. Så här gör du:
- Välj det fält som du vill kontrollera. Välj till exempel Mobil.
- För alla användare som du vill aktivera fältåtkomst för väljer du kryssrutan Synlig.
- Välj Spara.
Om problemet inte åtgärdats efter att du har utfört ovanstående felsökning, kontakta support och uppge följande information:
- Felbeskrivning
- E-postadress till Acrobat Sign-kontoadministratören som användes för att konfigurera integreringen
- E-postadress till Acrobat Sign-kontoadministratören som användes för att aktivera automatiska statusuppdateringar:
- Versionen av Acrobat Sign-paketet som är installerad i Salesforce
- Organisations-ID för Salesforce
- ID:n för Salesforce-poster för påverkade avtal
- Den berörda användarens e-postadress
- Kan problemet återskapas, är det återkommande eller är det ett enstaka problem?
- Datum för senaste förekomst: <Provide the date/time/timezone of the last known occurrence>
- Detaljerade steg för att replikera problemet
- Förväntat beteende: <Describe the behavior that you expect when the steps are performed>
- Felsökningsinformation: <Provide details of troubleshooting done so far with this documentation>
Effektivisera ditt arbete med Acrobat Sign
Hantera och signera dokument online snabbt och enkelt.
