Ga op de pagina Salesforce Lightning naar het tabblad Adobe Acrobat Sign-beheerder.
Laatst bijgewerkt op
16 okt. 2024
Kunt u geen overeenkomsten verzenden vanuit Salesforce? Kunnen de Salesforce-velden niet worden bijgewerkt met gegevenstoewijzingen?
Adobe Acrobat Sign voor Salesforce: handleiding voor probleemoplossing is ontworpen om u te helpen problemen op te lossen bij het verzenden van overeenkomsten vanuit Salesforce, gegevenstoewijzingen of automatische statusupdates. Zie voor oplossingen:
- Problemen met gegevenstoewijzingen oplossen
- Problemen met het verzenden van overeenkomsten oplossen
- Problemen met automatische statusupdates oplossen
- Problemen oplossen die kunnen optreden nadat uitgebreide domeinen zijn ingeschakeld
- Problemen oplossen zoekt naar leads in de Government Cloud-omgeving
- Contact opnemen met ondersteuning
Gegevenstoewijzingen in Acrobat Sign werken Salesforce-objecten bij wanneer een Acrobat Sign-overeenkomst wordt ondertekend, of in een opgegeven fase in de overeenkomstworkflow. Elke gegevenstoewijzing wordt van tevoren ingesteld en bevat de regels voor gegevenstoewijzing. Elke regel voor gegevenstoewijzing definieert de databron en het Salesforce-doelveld dat moet worden bijgewerkt. Raadpleeg Salesforce-gegevenstoewijzingen voor meer informatie.
Als met gegevenstoewijzingen een Salesforce-veld niet kan worden bijgewerkt, voert u de volgende stappen uit om het probleem te identificeren en op te lossen:
Dat doet u als volgt:
Selecteer Toestaan. Dit toont de melding Automatische statusupdates zijn ingeschakeld voor deze organisatie.
Zorg ervoor dat de gebruiker van de automatische statusupdate (meestal de beheerder van de Sign-account die u hebt gebruikt om de integratie in te stellen) en de afzender toegang hebben tot de objecten die u probeert bij te werken met gegevenstoewijzingen.
Om de waarde van het veld te controleren kunt u het veld toevoegen aan de lijstweergave Overeenkomsten, de developerconsole gebruiken of de Workbench gebruiken.
Zorg ervoor dat het veld 'Data Mapping Result' op het object 'Agreement' de waarde 'Completed' of 'Failed' heeft. Als er geen waarde is, betekent dit dat data mapping helemaal niet is geactiveerd. Als de waarde leeg is en als het veld Gegevenstoewijzing de gebruikers-ID bevat, probeert u de gegevenstoewijzing als volgt opnieuw te activeren:
Het veld Gegevenstoewijzingsfout slaat fouten in gegevenstoewijzing op. U kunt de waarde van het veld controleren door het veld toe te voegen aan de lijstweergave Overeenkomsten met behulp van de developerconsole of via Workbench. Hieronder volgt een lijst met veelvoorkomende fouten en bijbehorende stappen voor probleemoplossing:
| Fout | Failed to map data field: System.DmlException Update failed. Eerste uitzondering op rij 0 met ID 00ZxxqwertasdmjVUAR; eerste fout: STRING_TOO_LONG, Owner Title: data value too large: Adobe Acrobat Sign Adobe inc (max length=20): [Owner_Title__c] (echosign_dev1) 165 |
Resolutie: Deze fout betekent dat de gegevens in het formulierveld van het bijgewerkte document de maximale grootte overschrijden van het Salesforce-veld dat u probeert bij te werken. Dit lost u als volgt op:
|
|
| Fout |
Poging tot koppelen aan een gerelateerde objectreferentie die niet was ingesteld in de overeenkomst: <api-naam van het veld op het Salesforce-object dat u probeert bij te werken>" |
Resolutie: Deze fout betekent dat er geen koppeling is gemaakt tussen het Overeenkomstobject en het Salesforce-object dat u probeert bij te werken. Zie stap 4 hierboven. |
|
| Fout |
Failed to map data field: System.NullPointerException Attempt to de-reference a null object (echosign_dev1) 656 |
Resolutie Deze fout geeft aan dat het toewijzen van gegevens is mislukt omdat er geen toegang is tot een vereist object. Voer de volgende stappen uit om het probleem op te lossen:
|
Voorbeeld van een gebruiker:
Jan Smit
Voorbeeld van een gebruiksscenario:
Jan wil het volgende doen:
- Overeenkomsten verzenden vanuit een aangepast object met de naam 'Demo 1' met behulp van een overeenkomstsjabloon
- Informatie ophalen uit een ander aangepast object genaamd 'Demo 2' dat is gekoppeld aan het 'Demo 1'-object, en dit sturen naar de overeenkomst, en
- Informatie sturen naar de objectrecord 'Demo 2' zodra de overeenkomst is ondertekend.
Stappen om het gebruiksscenario te bereiken:
- Maak op het object Overeenkomst van Acrobat Sign een zoekveld voor het object Demo 1.
- Maak op het object 'Demo 1' een opzoekveld voor het object 'Demo 2'.
Je kunt geen informatie opvragen of pushen van/naar een gerelateerde lijst. - Maak als volgt een sjabloon voor gegevenstoewijzing:
- Geef een unieke sjabloonnaam op.
- Selecteer onder Veldtoewijzingen de optie Geselecteerd object en selecteer vervolgens in het vervolgkeuzemenu Demo 1.
- Selecteer Demo 2-ID in de tweede vervolgkeuzelijst die wordt geladen.
- In de derde vervolgkeuzelijst die wordt geladen, laat u deze als Geen staan en selecteert u Selecteren.
- Kies voor Welk Salesforce-veld moet worden bijgewerkt? de veldnaam die u wilt bijwerken.
- Om de instelling van de gegevenstoewijzing te voltooien volgt u de stappen onder het gedeelte Gegevenstoewijzingen gebruiken om ondertekenaarsgegevens en bestanden naar Salesforce-records te sturen in de Handleiding voor toewijzingen en sjablonen.
- Een sjabloon voor samenvoegingstoewijzing maken doet u als volgt:
- Geef een unieke sjabloonnaam op.
- Selecteer Veldtoewijzing toevoegen.
- Selecteer Geselecteerd object onder Bronwaarde en selecteer vervolgens Demo 1 in het vervolgkeuzemenu.
- Selecteer Demo 2 ID in de tweede vervolgkeuzelijst die wordt geladen.
- Selecteer in de volgende vervolgkeuzelijst die wordt geladen, de veldnaam met de waarde die u wilt ophalen en selecteer Gereed.
- Volg het gedeelte Toewijzingen samenvoegen gebruiken om documenten te genereren met Salesforce-gegevens in de Handleiding voor toewijzingen en sjablonen om de instellingen voor samenvoegingstoewijzingen te voltooien.
- Maak een overeenkomstsjabloon door de stappen onder Sjabloonworkflows te volgen.
- In de overeenkomstsjabloon die u hierboven hebt gemaakt, moet u ervoor zorgen dat de sjablonen voor samenvoegingstoewijzing en gegevenstoewijzing zijn opgenomen in het gedeelte Gegevenstoewijzing.
- Selecteer in het gedeelte Sjabloongegevens van de overeenkomstsjabloon het Salesforce-object als Demo 1.
- Selecteer Gegevens toewijzen aan overeenkomstvelden en vervolgens in het dialoogvenster dat wordt weergegeven:
- Selecteer de optie Selecteren uit object.
- Onder Brontype selecteert u Demo 1 ID.
- Onder Doelovereenkomstveld selecteert u het object Demo 1 in het zoekveld.
- Selecteer Opslaan.
- Selecteer Opslaan op het agreement template.
Dit maakt een agreement template gekoppeld aan het object 'Demo 1' met merge mapping en data mapping ingeschakeld. - Open een Demo 1-objectrecord en selecteer
> Pagina bewerken. Sleep vervolgens AgreementPanel vanuit het gedeelte Aangepast beheer in het linkerdeelvenster en selecteer Opslaan. - Selecteer Activering en wijs de recordpagina toe volgens uw wensen. Voor testdoeleinden kiest u Toewijzen als standaardorganisatie, waardoor AgreementPanel voor alle gebruikers te zien is.
- Selecteer Volgende en Opslaan.
- Navigeer naar de Demo 1-objectrecord en vernieuw de pagina. Het venster Overeenkomstpaneel dat u hebt toegevoegd, wordt weergegeven.
- Selecteer Overeenkomst verzenden ter ondertekening. Dit toont de overeenkomstsjabloon die u hebt gemaakt.
- Selecteer de overeenkomstsjabloon en volg de stappen op het scherm om de overeenkomst te verzenden. Controleer of de overeenkomst de samengevoegde gegevens van Demo 2 bevat.
- Onderteken de overeenkomst. Deze toont de bijgewerkte Demo 2-record met de waarde van de overeenkomst.
Als u geen overeenkomsten kunt verzenden vanuit Salesforce, voert u de volgende stappen voor probleemoplossing uit:
Zorg ervoor dat u een ondersteunde versie van Adobe Acrobat Sign gebruikt. Zie ondersteunde versies.
Zorg ervoor dat jij als afzender de vereiste toestemmingen hebt.
Bekijk hoe u de vereiste toegang verleent aan gebruikers. Naast de objecten en velden die in de handleiding worden genoemd, moet de afzender ook toegang hebben tot andere Salesforce-objecten die in de workflow worden gebruikt.
Controleer of uw Overeenkomst-object of andere Acrobat Sign-objecten in Salesforce aanpassingen hebben, zoals triggers, workflows of regels. Zo ja, schakel alle aanpassingen uit en verstuur een testovereenkomst om te zien of deze doorgaat.
Als het agreement succesvol wordt verzonden na het uitschakelen van de aanpassingen, raadpleeg dan onze ontwikkelaarsgids voor richtlijnen.
Notitie
We bieden geen ondersteuning voor het oplossen van problemen met aanpassingen.
Gebruik een van de volgende manieren om het type fout te identificeren dat u hebt ontvangen tijdens het verzenden van de overeenkomst:
- Open de betreffende overeenkomstrecord in Salesforce en zoek een rode banner met een foutbericht. Deze foutmelding moet de hoofdoorzaak aangeven.
- Controleer het veld Foutbericht op het object Overeenkomstmelding.
- Via de Developer Console controleren en de volgende SOQL-query uitvoeren:
Select echosign_dev1__Error_Message__c from
echosign_dev1__Agreement_Notification__c where
echosign_dev1__Agreement__c = ‘<enter agreement id>
Raadpleeg de volgende tabel met fouten en stappen om deze op te lossen:
|
Fout |
Resolutie |
|---|---|
|
Ongeldige gebruikers-ID of ongeldig e-mailadres opgegeven in koptekst van x-api-gebruiker U hebt geen geldig Adobe Acrobat Sign-gebruikersaccount |
Deze fouten geven aan dat de afzender geen geldige Acrobat Sign-licentie heeft. Voor probleemoplossing:
|
|
Deze indeling wordt niet ondersteund |
Deze fout treedt op wanneer het document dat u ter ondertekening probeert te verzenden, niet in een ondersteunde indeling staat. Raadpleeg de sectie Ondersteunde documentnotaties in Systeemvereisten voor Acrobat Sign om te controleren welke bestandsindelingen worden ondersteund voor het uploaden naar Acrobat Sign. |
|
Onjuiste object-ID gebruikt in de knop voor ondertekening |
Deze fout treedt op wanneer de sjabloon-ID van de knop Verzenden namens of de hoofd-ID van het object ongeldig is. We raden u aan om de juiste object-ID in te voeren en het proces opnieuw te proberen. |
Als een overeenkomst niet met de juiste status wordt bijgewerkt, voert u de volgende stappen uit om het probleem op te lossen:
Controleer of u de vereisten en de configuraties na de installatie (vereist) hebt geïmplementeerd die worden vermeld in Adobe Acrobat Sign voor Salesforce: Installatiehandleiding.
Ga op de Salesforce Lightning-pagina naar Adobe Acrobat Sign-beheerder > Automatische statusupdates inschakelen en controleer of u het bericht Automatische statusupdates zijn ingeschakeld voor deze organisatie ziet.
Als u het bericht niet ziet, voert u de volgende stappen uit:
- Meld u af en weer aan als systeembeheerder.
- Ga naar Adobe Acrobat Sign beheerder > Automatische statusupdates inschakelen en selecteer Inschakelen.
- In het dialoogvenster Toegang tot Acrobat Sign toestaan dat verschijnt:
- Noteer het e-mailadres onder aan het dialoogvenster.
- Zorg ervoor dat dit e-mailadres een geldige Sign-licentie heeft en een systeembeheerder is in Salesforce.
- Zorg ervoor dat aan de gebruiker de machtigingenset Adobe Sign Integration-gebruiker is toegewezen.
- Selecteer Toestaan.
Het bericht ‘Automatische statusupdates zijn ingeschakeld voor deze organisatie’ moet worden weergegeven.
Controleer op het object Overeenkomstmelding het veld Foutmelding. Om de waarde in het veld te controleren voert u de onderstaande SOQL-query uit op de Developer Console:
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>'
Als de overeenkomst een pushovereenkomst is die buiten de Salesforce-omgeving is gemaakt, zorg er dan voor dat u de Adobe Acrobat Sign voor Salesforce: servicehandleiding voor grote documenten en pushovereenkomsten volgt.
Ga naar het tabblad Overeenkomsten, selecteer alle overeenkomsten die niet zijn bijgewerkt en selecteer vervolgens in de rechterbovenhoek Overeenkomst bijwerken.
Controleer of de status van die overeenkomsten wordt bijgewerkt. Als ze nu worden bijgewerkt, controleer dan of het probleem nog steeds reproduceerbaar is met een nieuwe testovereenkomst. Als het reproduceerbaar is, gaat u verder met de onderstaande stappen voor probleemoplossing.
Als het probleem niet reproduceerbaar is, kan het een eenmalig geval zijn geweest en we raden u aan deze handleiding voor probleemoplossing te raadplegen wanneer het probleem zich opnieuw voordoet.
Controleer of uw object Overeenkomst of andere Acrobat Sign-objecten in Salesforce zijn aangepast, zoals triggers, workflows of regels.
Zo ja, schakel dan alle aanpassingen uit en stuur een testovereenkomst volgens uw gebruikelijke stappen en kijk of deze doorgaat. De status moet worden gewijzigd van Concept naar Uit voor ondertekening.
Als de status van de overeenkomst verandert in Uit voor ondertekening nadat de aanpassingen zijn uitgeschakeld, raadpleegt u onze handleiding voor ontwikkelaars voor richtlijnen.
Als de status niet wordt bijgewerkt, stuur dan een testovereenkomst rechtstreeks vanuit het tabblad Overeenkomsten met aanpassingen uitgeschakeld en controleer of deze wordt verzonden. Als de status nog steeds niet verandert, controleer dan de stappen #1 en #2 hierboven.
Notitie
We bieden geen ondersteuning voor het oplossen van problemen met aanpassingen.
| Acrobat Sign-objecten | ||
|---|---|---|
| Bestandsbijlagen toevoegen | Bestandstoewijzingen | Gegevens toewijzen aan overeenkomstvelden |
| Formulierveldsjablonen toevoegen | Importbewerkingen formulierveld | Toewijzingssamenvoegingen |
| Ontvangers toevoegen | Toewijzing onderliggend formulierveld | Mutexen |
| Overeenkomsten | Toewijzingsvermelding onderliggend formulierveld | Objecttoewijzingen |
| Overeenkomstgebeurtenissen | Formulierveldtoewijzingen | Ontvangers |
| Overeenkomstsjablonen | Invoer voor formulierveldtoewijzing | Ondertekende overeenkomst |
| Gegevenstoewijzingen | Groepstoewijzingen | Triggers |
| Veldtoewijzingen | Bibliotheeksjablonen | Resultaten van gebruikerssynchronisatie |
| Overeenkomsttype | ||
Alle organisaties hebben nu standaard de uitgebreide domeinen van Salesforce ingeschakeld, wat geen invloed heeft op het Acrobat Sign voor Salesforce-pakket. Klanten die hun sites hebben geconfigureerd voor het downloaden van grote bestanden en het uitvoeren van pushovereenkomsten, ondervinden echter problemen als hun uitgebreide domeinen zijn ingeschakeld. Dit leidt tot gewijzigde site-URL's en verbroken overeenkomsten.
Voor soepel werkende overeenkomsten moeten klanten de aangepaste instellingen voor het downloaden van grote bestanden bijwerken om de bijgewerkte site-URL weer te geven.
Voor het bijwerken van de callback-URL voor pushovereenkomsten moeten klanten Contact opnemen met ondersteuning en de vereiste informatie verstrekken. Zie Individuele services configureren voor uw Acrobat Sign-account voor meer informatie.
Met Acrobat Sign voor Salesforce kunt u naar leads zoeken en deze als ontvangers van overeenkomsten toevoegen wanneer Leads is geselecteerd als het type ontvanger. Als gebruikers van de Government Cloud echter leads, contactpersonen of gebruikers maken, maar deze niet kunnen vinden met behulp van het zoekveld, kunnen Saleforce-organisatiebeheerders de volgende stappen voor probleemoplossing volgen:
- Ga naar Instellen > Objectbeheer en zoek vervolgens naar Lead.
- Selecteer Velden en relaties in het linkerdeelvenster.
- Controleer voor alle vereiste velden (zoals Naam, E-mail, Mobiel en meer) de toegankelijkheid voor de gebruikers. Dat doet u als volgt:
- Selecteer het veld dat u wilt controleren. Selecteer bijvoorbeeld Mobiel.
- Voor alle gebruikers voor wie u de veldtoegang wilt inschakelen, selecteert u het selectievakje Zichtbaar.
- Selecteer Opslaan.
Als het probleem zelfs na het volgen van de bovenstaande stappen voor probleemoplossing niet is opgelost, neemt u contact op met de ondersteuning en verstrekt u ons de volgende gegevens:
- Beschrijving van het probleem
- E-mailadres van de Acrobat Sign-accountbeheerder die is gebruikt om de integratie in te stellen
- E-mailadres van de Acrobat Sign-accountbeheerder die is gebruikt om automatische statusupdates in te schakelen:
- Acrobat Sign-pakketversie geïnstalleerd in Salesforce
- Salesforce-organisatie-ID
- Salesforce-records-ID's van betreffende overeenkomsten
- E-mailadres van de betrokken gebruiker
- Is het probleem consistent reproduceerbaar, periodiek of eenmalig?
- Datum van laatste voorval: <Provide the date/time/timezone of the last known occurrence>
- Stappen om het probleem te repliceren
- Verwacht gedrag: <Describe the behavior that you expect when the steps are performed>
- Opmerkingen over probleemoplossing: <Provide details of troubleshooting done so far with this documentation>
Je werk stroomlijnen met Acrobat Sign
Beheer en onderteken documenten snel en eenvoudig online.
