Benutzerhandbuch Abbrechen

Acrobat Sign für Salesforce: Handbuch zur Fehlerbehebung

Du kannst keine Vereinbarungen aus Salesforce senden? Datenzuordnungen aktualisieren die Salesforce-Felder nicht?

Das Adobe Acrobat Sign für Salesforce: Handbuch zur Fehlerbehebung soll Sie bei Problemen beim Senden von Vereinbarungen aus Salesforce, bei Datenzuordnungen oder bei automatischen Statusaktualisierungen unterstützen. Erfahre, wie du:

Fehler bei Datenzuordnungen beheben

Acrobat Sign-Datenzuordnungen aktualisieren Salesforce-Objekte, wenn eine Acrobat Sign-Vereinbarung signiert wird oder sich in einer bestimmten Phase des Vereinbarungs-Workflows befindet. Jede Datenzuordnung wird im Voraus eingerichtet und beinhaltet Regeln für die Datenzuordnung. Jede Datenzuordnungsregel definiert die Datenquelle und das Salesforce-Zielfeld, das aktualisiert werden soll. Weitere Informationen findest du unter Salesforce-Datenzuordnung.

Wenn die Datenzuordnung ein Salesforce-Feld nicht aktualisieren kann, führe die folgenden Schritte aus, um das Problem zu identifizieren und zu beheben:

Verwenden der Datenzuordnung und Zusammenführungszuordnung zum Senden von Vereinbarungen: Beispielszenario 

Beispielbenutzer:

John Smith

Anwendungsbeispiel:

John möchte folgende Aktionen ausführen:

  • Vereinbarungen aus einem selbstdefinierten Objekt namens „Demo 1“ mithilfe einer Vereinbarungsvorlage senden
  • Informationen aus einem anderen selbstdefinierten Objekt namens „Demo 2“, das dem Objekt „Demo 1“ zugeordnet ist, abrufen und an die Vereinbarung übertragen
  • Informationen an den Objektdatensatz „Demo 2“ übertragen, sobald die Vereinbarung signiert wurde 

 Erforderliche Schritte für diesen Anwendungsfall:

  1. Erstelle im Acrobat Sign-Objekt „Vereinbarung“ ein Suchfeld für das Objekt „Demo 1“.
  2. Erstelle im Objekt „Demo 1“ ein Suchfeld für das Objekt „Demo 2“.
    Du kannst keine Informationen aus einer zugehörigen Liste abrufen bzw. in eine zugehörige Liste übertragen. 
  3. Erstelle wie folgt eine Datenzuordnungsvorlage:
    1. Gib einen eindeutigen Vorlagennamen an.
    2. Wähle unter Feldzuordnungen die Option Ausgewähltes Objekt aus und wähle dann aus dem Dropdown-Menü Demo 1 aus. 
    3. Wähle aus dem zweiten Dropdown-Menü, das geladen wird, die Option Demo 2-ID aus.
    4. Behalte im dritten Dropdown-Menü, das geladen wird, die Option „Keine“ bei und wähle Auswählen aus.
    5. Wähle unter „Welches Salesforce-Feld soll aktualisiert werden?“ den Feldnamen aus, den du aktualisieren möchtest. 
    6. Um die Einrichtung der Datenzuordnung abzuschließen, führe die im Handbuch für Zuordnungen und Vorlagen im Abschnitt Verwenden von Datenzuordnungen, um Daten und Dateien von Unterzeichnenden in Salesforce-Datensätze zu übertragen aufgeführten Schritte aus.
  4. Erstelle wie folgt eine Vorlage für Zusammenführungszuordnungen:
    1. Gib einen eindeutigen Vorlagennamen an.
    2. Wähle Feldzuordnung hinzufügen aus. 
    3. Wähle unter Quellwert die Option Ausgewähltes Objekt und dann aus dem Dropdown-Menü Demo 1 aus. 
    4. Wähle aus dem zweiten Dropdown-Menü, das geladen wird, die Option Demo 2-ID aus.
    5. Wähle aus dem nächsten Dropdown-Menü, das geladen wird, den Feldnamen mit dem Wert aus, den du abrufen musst, und wähle dann Fertig aus.
    6. Um die Einrichtung der Zusammenführungszuordnung abzuschließen, folge den Anleitungen im Handbuch für Zuordnungen und Vorlagen im Abschnitt Verwenden von Zusammenführungszuordnungen, um Dokumente mit Salesforce-Daten zu generieren.
  5. Erstelle eine Vereinbarungsvorlage, indem du die Schritte unter Workflows für Vorlagen erstellen ausführst.
  6. Stelle in der oben erstellten Vereinbarungsvorlage sicher, dass die Vorlagen für die Zusammenführungszuordnung und die Datenzuordnung im Abschnitt „Datenzuordnung“ enthalten sind.
  7. Wähle im Abschnitt Vorlagendetails der Vereinbarungsvorlage das Salesforce-Objekt als Demo 1 aus.
  8. Wähle Daten Vereinbarungsfeldern zuordnen aus und führe dann in dem daraufhin angezeigten Dialogfeld die folgenden Aktionen aus:
    1. Wähle die Option Aus Objekt auswählen aus.
    2. Wähle unter Quelltyp die Option Demo 1-ID aus.
    3. Wähle unter Zielvereinbarungsfeld das Objekt Demo 1 im Suchfeld aus.
    4. Wähle Speichern aus.
  9. Wähle in der Vereinbarungsvorlage Speichern aus.
    Es wird eine Vereinbarungsvorlage erstellt, die mit dem Objekt „Demo 1“ verknüpft ist, wobei die Zusammenführungszuordnung und die Datenzuordnung aktiviert sind. 
  10. Öffne den Objektdatensatz „Demo 1“ und wähle  > Seite bearbeiten aus. Ziehe dann per Drag & Drop AgreementPanel aus dem linken Bereich im Abschnitt „Eigene Verwaltung“ und wähle Speichern aus.
  11. Wähle Aktivierung aus und weise die Datensatzseite deinen Anforderungen entsprechend zu. Wähle zu Testzwecken „Als Organisationsstandard zuweisen“ aus, wodurch „AgreementPanel“ allen Benutzenden zur Verfügung gestellt wird. 
  12. Wähle Weiter und Speichern aus.
  13. Navigiere zum Objektdatensatz „Demo 1“ und aktualisiere die Seite. Es sollte der von dir hinzugefügte Bereich „AgreementPanel“ angezeigt werden.
  14. Wähle Vereinbarung zum Signieren senden aus. Die von dir erstellte Vereinbarungsvorlage wird angezeigt.
  15. Wähle die Vereinbarungsvorlage aus und befolge die Schritte auf dem Bildschirm, um die Vereinbarung zu senden. Stelle sicher, dass die Vereinbarung die zusammengeführten Daten aus „Demo 2“ enthält. 
  16. Signiere die Vereinbarung. Der Datensatz von „Demo 2“ wird angezeigt, der mit dem Wert aus der Vereinbarung aktualisiert wurde. 

Fehlerbehebung beim Senden von Vereinbarungen aus Salesforce

Wenn du keine Vereinbarungen aus Salesforce senden kannst, führe die folgenden Schritte zur Fehlerbehebung aus: 

  1. Stelle sicher, dass du eine unterstützte Version von Adobe Acrobat Sign verwendest. Siehe Unterstützte Versionen.

  2. Stelle sicher, dass du als sendende Partei über die erforderlichen Berechtigungen verfügst.
    Siehe Benutzenden den erforderlichen Zugriff gewähren. Zusätzlich zu den im Handbuch genannten Objekten und Feldern muss die sendende Partei Zugriff auf andere Salesforce-Objekte haben, die im Workflow verwendet werden.

  3. Überprüfe, ob dein Vereinbarungsobjekt oder andere Acrobat Sign-Objekte in Salesforce Anpassungen wie Auslöser, Workflows oder Regeln enthalten. Wenn ja, deaktiviere alle Anpassungen und sende eine Testvereinbarung, um zu überprüfen, ob sie gesendet wird.
    Wenn die Vereinbarung nach dem Deaktivieren der Anpassungen erfolgreich gesendet wurde, kannst du im Entwicklungshandbuch weitere Anleitungen nachlesen.

    Hinweis:

    Wir bieten keinen Support für die Fehlerbehebung bei Anpassungen.

  4. Verwende eine der folgenden Methoden, um zu identifizieren, welche Art von Fehler du beim Senden der Vereinbarung erhalten hast:

    • Öffne den betroffenen Vereinbarungsdatensatz in Salesforce und suche nach einem roten Banner mit einer Fehlermeldung. Dieser Fehler sollte die Ursache angeben.
    • Überprüfe das Feld „Fehlermeldung“ im Objekt „Vereinbarungsbenachrichtigung“.
    • Um die Überprüfung über die Entwicklerkonsole vorzunehmen, führe die folgende SOQL-Abfrage aus:

    SELECT echosign_dev1__Error_Message__c FROM

    echosign_dev1__Agreement_Notification__c WHERE

    echosign_dev1__Agreement__c = <Vereinbarungs-ID eingeben>.

  5. Sieh dir die folgende Tabelle mit Fehlern und Schritte zum Beheben an:

    Fehler

    Lösung

    Ungültige Benutzenden-ID oder E-Mail-Adresse im x-API-user-Header angegeben
    oder

    Du hast kein gültiges Adobe Acrobat Sign-Benutzerkonto

    Diese Fehler weisen darauf hin, dass die sendende Partei keine gültige Acrobat Sign-Lizenz hat. Fehlerbehebung:

    1. Aktiviere im Vereinbarungsdatensatz das Feld Erfasste sendende Partei, um die die Vereinbarung sendende Partei zu identifizieren.
      Wenn eine nutzende Person im Feld Erfasste sendende Partei nicht in Salesforce gefunden wird, verwendet das Acrobat Sign-Paket den Eintrag im Feld Erstellt von als „sendende Partei“ der Vereinbarung.
    2. Navigiere zur Seite Benutzendendetails der sendenden Partei in Salesforce und stelle sicher, dass das Feld E-Mail-Adresse eine gültige E-Mail-Adresse mit einer aktiven Sign Enterprise-Lizenz enthält. So überprüfst du, ob für die E-Mail-Adresse eine aktive Sign Enterprise-Lizenz hinterlegt ist:
      1. Melde dich bei Acrobat Sign mit Admin-Anmeldeinformationen an.
      2. Navigiere zu Konto > Benutzende und suche die E-Mail-Adresse.
      3. Der Status der benutzenden Person muss aktiv sein. Benutzende ohne den Status „Aktiv“ können keine Vereinbarungen senden. Wenn die benutzende Person nicht aktiv ist, lies nach, wie du Benutzende hinzufügen und verwalten kannst und sieh dir die Schritte im Abschnitt „Die E-Mail-Adresse wird verwendet, aber der Benutzendenstatus ist nicht ‚Aktiv‘“ an.
      4. Wenn die Option Senden im Namen von verwendet wird, überprüfe die E-Mail-Adresse, indem du das Feld Senden im Namen von im Objekt Vereinbarung aktivierst. Stelle sicher, dass für die E-Mail-Adresse dieser benutzenden Person eine gültige Sign-Lizenz hinterlegt ist, indem du dich bei Acrobat Sign anmeldest. Stelle sicher, dass das Feld Senden als andere Benutzende zulassen auf der Seite Benutzendendetails der Person, in deren Namen gesendet wird, aktiviert ist. Dieses Feld ist möglicherweise nicht standardmäßig im Seitenlayout des Benutzungsobjekts sichtbar.
    3. Überprüfe die Benutzungsberechtigungen wie im obenstehenden Schritt 2 erläutert. Siehe Benutzenden den erforderlichen Zugriff gewähren.

    Dateiformat wird nicht unterstützt

    Dieser Fehler tritt auf, wenn das Dokument, das du zur Signatur versenden möchtest, nicht in einem unterstützten Format vorliegt.

    In Systemanforderungen für Acrobat Sign kannst du im Abschnitt Unterstützte Dokumentformate prüfen, welche Dateiformate für das Hochladen in Acrobat Sign unterstützt werden.

    Falsche Objekt-ID in Signaturschaltfläche

     Dieser Fehler tritt auf, wenn die Vorlagen-ID der Schaltfläche Senden im Namen von oder die Master-ID des Objekts ungültig ist.

    Wir empfehlen, dass du die richtige Objekt-ID eingibst und dann den Vorgang erneut durchführst.

Fehler bei automatischen Statusaktualisierungen beheben 

Wenn eine Vereinbarung nicht mit dem richtigen Status aktualisiert wird, führe die folgenden Schritte zur Fehlerbehebung aus:

  1. Stelle sicher, dass du die Voraussetzungen und die Konfiguration nach der Installation (erforderlich) implementiert hast, die im Adobe Acrobat Sign für Salesforce: Installationshandbuch erläutert sind. 

  2. Gehe auf der Salesforce Lightning-Seite zu Adobe Acrobat Sign-Admin > Automatische Statusaktualisierungen aktivieren und stelle sicher, dass die Meldung „Automatische Statusaktualisierungen sind für diese Organisation aktiviert“ angezeigt wird.

    salesforce-faq-Statusaktualisierung-aktiviert

    Wenn die Meldung nicht angezeigt wird, führe die folgenden Schritte aus:

    1. Melde dich ab und melde dich dann als System-Admin an.
    2. Gehe zu Adobe Acrobat Sign-Admin > Automatische Statusaktualisierungen aktivieren und wähle Aktivieren aus.
    3. Führe in dem daraufhin angezeigten Dialogfeld „Zugriff auf Acrobat Sign zulassen“ die folgenden Schritte aus:
      1. Notiere dir die unten im Dialogfeld aufgeführte E-Mail-Adresse.
      2. Stelle sicher, dass für die E-Mail-Adresse eine gültige Sign-Lizenz hinterlegt und sie einer für die System-Administration in Salesforce zuständigen Person zugeordnet ist.
      3. Stelle sicher, dass der nutzenden Person der Berechtigungssatz „Adobe Sign-Integrationsbenutzer*in“ zugewiesen ist. 
      4. Wähle Zulassen aus.

    Die Meldung „Automatische Statusaktualisierungen sind für diese Organisation aktiviert“ sollte angezeigt werden.

  3. Überprüfe das Feld Fehlermeldung im Objekt „Vereinbarungsbenachrichtigung“. Um den Wert im Feld zu überprüfen, führe die folgende SOQL-Abfrage in der Entwicklungskonsole aus: 

    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. Wenn die Vereinbarung eine Push-Vereinbarung ist, die außerhalb der Salesforce-Umgebung erstellt wurde, stelle sicher, dass du die Anleitungen im Adobe Acrobat Sign für Salesforce: Service-Handbuch für große Dokumente und Push-Vereinbarungen befolgst.

  5. Gehe zu Setup > Selbstdefinierte Einstellungen > Aktualisierungseinstellungen für Adobe Sign-Vereinbarungen > Verwalten > Neu (oder „Bearbeiten“). Stelle auf der daraufhin geöffneten Seite sicher, dass das Kontrollkästchen Vereinbarungsstatus aktualisieren (unter „Standardwert auf Organisationsebene“) aktiviert ist. 

  6. Wechsle zur Registerkarte Vereinbarungen, wähle alle Vereinbarungen aus, die nicht aktualisiert werden konnten, und wähle dann in der oberen rechten Ecke Vereinbarung aktualisieren aus. 

    salesforce-faq-Vereinbarung-aktualisieren

  7. Überprüfe, ob der Status für diese Vereinbarungen aktualisiert wurde. Wenn die Aktualisierung nun stattfindet, überprüfe, ob das Problem mit einer neuen Testvereinbarung immer noch reproduzierbar ist. Wenn es erneut hervorgerufen werden kann, fahre mit den folgenden Schritten zur Fehlerbehebung fort.

    Wenn das Problem nicht erneut hervorgerufen werden kann, handelte es sich möglicherweise um ein einmaliges Vorkommen. Wir empfehlen dir, dich an diese Anleitung zur Fehlerbehebung zu halten, wenn das Problem erneut auftritt. 

  8. Überprüfe, ob dein Vereinbarungsobjekt oder andere Acrobat Sign-Objekte in Salesforce Anpassungen wie Auslöser, Workflows oder Regeln enthalten.

    Wenn ja, deaktiviere alle Anpassungen und sende wie gewohnt eine Testvereinbarung, um zu überprüfen, ob sie gesendet wird. Der Status sollte von „Entwurf“ zu „Zur Signatur versandt“ geändert werden.

    Wenn der Vereinbarungsstatus nach dem Deaktivieren der Anpassungen in „Zur Signatur versandt“ geändert wurde, kannst du im Entwicklungshandbuch weitere Anleitungen nachlesen.

    Wenn der Status nicht aktualisiert wurde, sende eine Testvereinbarung mit deaktivierten Anpassungen direkt von der Registerkarte „Vereinbarungen“ und überprüfe, ob sie gesendet wird. Wenn sich der Status immer noch nicht ändert, überprüfe die oben aufgeführten Schritte 1 und 2.

    Hinweis:

    Wir bieten keinen Support für die Fehlerbehebung bei Anpassungen.

    Acrobat Sign-Objekte
    Dateianlagen hinzufügen Dateizuordnungen Daten Vereinbarungsfeldern zuordnen
    Formularfeldvorlagen hinzufügen  Formularfeldimporte Zusammenführungszuordnungen
    Empfänger hinzufügen Untergeordnete Formularfeldzuordnung Mutexes
    Vereinbarungen Untergeordneter Formularfeldzuordnungseintrag Objektzuordnungen
    Vereinbarungsereignisse Formularfeldzuordnungen Empfänger
    Vereinbarungsvorlagen Formularfeldzuordnungseinträge Signierte Vereinbarung
    Datenzuordnungen Gruppenzuordnungen Trigger
    Feldzuordnungen Bibliotheksvorlagen Benutzersynchronisierungsergebnisse
    Vereinbarungstyp    

Fehler beheben, die nach der Aktivierung von erweiterten Domänen auftreten können

Für alle Organisationen sind jetzt standardmäßig die erweiterten Domänen von Salesforce aktiviert, was sich nicht auf das Acrobat Sign für Salesforce-Paket auswirkt. Bei Kund*innen, die ihre Sites für den Download großer Dateien und Push-Vereinbarungen konfiguriert haben, treten jedoch bei aktivierten erweiterten Domänen Probleme auf, die zu geänderten Site-URLs und fehlerhaften Vereinbarungen führen.

Um das reibungslose Funktionieren von Vereinbarungen zu gewährleisten, müssen Kund*innen die benutzerdefinierten Einstellungen für Downloads großer Dateien mit der neuen Site-URL aktualisieren.

Zum Aktualisieren der-Rückruf-URL für Push-Vereinbarungen müssen Kund*innen den Support kontaktieren und die erforderlichen Informationen angeben. Weitere Informationen finde unter Einzelne Services für dein Acrobat Sign-Konto konfigurieren lassen.

Fehler bei der Suche nach Leads in der Government Cloud-Umgebung beheben

In Acrobat Sign für Salesforce kannst du nach Leads suchen und diese als Vereinbarungsempfangende hinzufügen, wenn Leads als Typ der empfangenden Partei ausgewählt ist. Wenn Benutzende der Government Cloud jedoch Leads, Kontakte oder Benutzende erstellen, diese jedoch nicht über das Suchfeld finden können, können Admins der Salesforce-Organisation die folgenden Lösungsschritte ausführen:

  1. Wechsle zu Setup > Objekt-Manager und suche dann nach Lead.
  2. Wähle im linken Bedienfeld Felder und Beziehungen aus.
  3. Überprüfe für alle erforderliche Felder (z. B. unter anderem Name, E-Mail-Adresse, Mobiltelefonnummer) den Zugriff für Benutzende. Gehe hierzu folgendermaßen vor:
    1. Wähle ein beliebiges Feld aus, das du prüfen möchtest. Wähle zum Beispiel Mobiltelefonnummer.
    2. Aktiviere die Option SichtbarFür alle Benutzenden aus, für die du den Feldzugriff aktivieren möchtest.
    3. Wähle Speichern aus.
Sende Vereinbarungen aus Acrobat Sign für Salesforce in Government Cloud an deine Leads.

Sende Vereinbarungen aus Acrobat Sign für Salesforce in Government Cloud an deine Leads.

Kontaktiere den Support

Wenn das Problem auch nach Ausführung der oben aufgeführten Schritte zur Fehlerbehebung nicht behoben ist, kontaktiere den Support und teile uns die folgenden Details mit:

  • Problembeschreibung
  • E-Mail-Adresse der für die Administration des Acrobat Sign-Kontos zuständigen Person, die für die Einrichtung der Integration verwendet wurde
  • E-Mail-Adresse der für die Administration des Acrobat Sign-Kontos zuständigen Person, die für die Aktivierung der automatischen Statusaktualisierungen verwendet wurde:
  • In Salesforce installierte Acrobat Sign-Paketversion
  • Salesforce-Organisations-ID
  • Salesforce-Datensatz-IDs der betroffenen Vereinbarungen
  • E-Mail-Adresse der betroffenen nutzenden Person
  • Lässt sich das Problem konsistent reproduzieren, tritt es sporadisch auf oder einmalig?
  • Datum des letzten Vorkommens: <Datum/Uhrzeit/Zeitzone des letzten Auftretens angeben>
  • Versuche, den Fehler erneut hervorzurufen:
  • Erwartetes Verhalten: <Das Verhalten beschreiben, das du nach Ausführung der Schritte erwartest>
  • Hinweise zur Fehlerbehebung: <Details zu den Fehlerbehebungsschritten angeben, die du anhand der vorliegenden Dokumentation bereits ausgeführt hast7>

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?