Benutzerhandbuch Abbrechen

Adobe Acrobat Sign für Salesforce: Upgrade-Handbuch

Übersicht

Das Upgrade-Handbuch für Adobe Acrobat Sign für Salesforce enthält Anweisungen zum Aktualisieren des Pakets Adobe Acrobat Sign für Salesforce von einer älteren Version auf die neueste veröffentlichte Version.

Adobe verlangt aus den folgenden Gründen ein Upgrade auf die neueste Version von Adobe Acrobat Sign für Salesforce:

  • Jede Version von Adobe Acrobat Sign für Salesforce besitzt neue Funktionen und Erweiterungen, die deine Dokument-Workflows erheblich verbessern können. 
  • Adobe Acrobat Sign für Salesforce unterstützt nur die aktuelle Version (N) sowie zwei Hauptversionen vor der aktuellen Version (N-1 und N-2). Bei nicht unterstützten Versionen bestehen erhöhte Sicherheitsrisiken und sie erhalten keinen API-Zugriff auf den Adobe Acrobat Sign-Dienst.

Wichtige Upgrade-Hinweise 

  • Deinstalliere dein vorhandenes Adobe Acrobat Sign für Salesforce-Paket nicht, da dies zum Verlust deiner Acrobat Sign-Daten in Salesforce führen kann.
  • Wenn es in deiner Salesforce-Organisation Benutzer*innen gibt, die mehreren Adobe Sign-Konten angehören, kontaktiere vor der Aktualisierung deine*n Adobe Client Success Manager*in oder den Adobe-Kundensupport.
  • Führe vor dem Aktualisieren deines Produktionskontos ein Upgrade und einen Test in deiner Sandbox-Umgebung durch.
    Achte darauf, dass du auf die in der Sandbox-Umgebung verwendete E-Mail-Adresse zugreifen kannst, falls du die E-Mail-Adresse für dein Acrobat Sign-Konto ändern musst.
  • Stelle sicher, dass die Einstellung Alle Sitzungen einer nutzenden Person an diejenige IP-Adresse binden, von der aus sie gestartet wurden deaktiviert ist. Um dies zu konfigurieren, navigiere zu Setup > Einstellungen > Sicherheit > Sitzungseinstellungen.
  • Lies die Abschnitte zu den Neuen Funktionen unten, um zu prüfen, ob bestimmte Optionen manuell konfiguriert werden müssen.
    Jede Version bietet viele neue Funktionen und Einstellungen, die möglicherweise manuell aktualisiert werden müssen.
  • Informationen zu den neuesten Funktionen in Adobe Acrobat Sign für Salesforce findest du in den Versionshinweisen zu Adobe Acrobat Sign für Salesforce.
  • Wenn du eine neue Instanz des Pakets installierst, findest du weitere Informationen dazu im Installationshandbuch zu Adobe Acrobat Sign für Salesforce.
  • Ab Version 24.14 unterstützt Adobe Acrobat Sign für Salesforce nicht mehr das SOAP-API-basierte Push-Modell zum Auslösen automatischer Statusaktualisierungen. Die automatischen Aktualisierungen des Vereinbarungsstatus werden nur mit dem REST-API-basierten Pull-Modell ausgelöst.
    Wenn du Adobe Acrobat Sign für Salesforce in der Paketversion 20.x oder niedriger installiert hast, teste das Upgrade in deiner Sandbox-Organisation. Wenn das Upgrade des Vereinbarungsstatus nicht funktioniert, wechsle zur Registerkarte Admin auf der Registerkarte Adobe Acrobat Sign für Salesforce und führe Automatische Statusaktualisierung aktivieren erneut aus.
  • Benutzer*innen, die ein Upgrade auf Adobe Acrobat Sign für Salesforce V 24.14 durchführen, müssen die neuen Auswahllistenwerte manuell hinzufügen, um Erinnerungen in Vereinbarungen festlegen zu können. Die neuen Werte aus der Auswahlliste sind jedoch standardmäßig für Benutzer*innen verfügbar, die die Paketversion 24.14 neu installieren. 

Überprüfen der aktuellen Version

Suche vor dem Upgrade nach der Version des derzeit installierten Pakets:

  1. Melde dich mit deinen Admin-Anmeldeinformationen bei Salesforce an.
  2. Navigiere zu SetupPlattform-Tools > Anwendungen > Pakete > Installierte Pakete und überprüfe dann die Versionsnummer für das Adobe Acrobat Sign-Paket.
Prüfe die Version der installierten Adobe Acrobat Sign für Salesforce-Anwendung.

Das Paket aktualisieren

  1. Navigiere zu Salesforce AppExchange, um auf das neueste Paket für Adobe Acrobat Sign für Salesforce zuzugreifen, und wähle Jetzt installieren aus.

  2. Wähle Bei AppExchange anmelden aus und gib deine Anmeldeinformationen ein, um den Vorgang fortzusetzen.

  3. Führe im angezeigten Dialogfeld folgende Schritte aus:

    • Wähle In Produktion installieren aus, um das Paket in der Produktionsumgebung zu installieren.
    • Wähle In Sandbox installieren aus, um das Paket in einer Sandbox-Umgebung zu installieren.

    Wir empfehlen, dass du jede Installation zuerst in der Sandbox-Umgebung testest.

  4. Überprüfe die Installationsinformationen sowie die Nutzungsbedingungen. Bestätige, dass du die Bedingungen gelesen hast und sie akzeptierst und wähle dann Bestätigen und installieren aus.

  5. Wenn du aufgefordert wirst, dich bei deiner Salesforce-Organisation anzumelden, gib deine Anmeldedaten ein und wähle Bei Salesforce anmelden aus.

  6. Wähle auf der daraufhin angezeigten Seite Adobe Acrobat Sign-Upgrade erst Für alle Benutzenden installieren und dann Upgrade durchführen aus.

    Hinweis: Die Installation kann einige Minuten dauern.

    Aktualisiere die Paketversion von Adobe Acrobat Sign für Salesforce.

  7. Bei Anzeige des Dialogs Drittanbieterzugriff genehmigen:

    • Aktiviere Ja, Zugriff auf diese Drittanbieter-Websites gewähren.
    • Wähle Weiter aus, um die Installation zu starten.
  8. Wenn die Meldung angezeigt wird, dass die Installation einige Zeit dauern kann, wähle Fertig aus und warte, bis du die E-Mail mit der Bestätigung der erfolgreichen Installation des Pakets erhältst.

    Sobald du die Bestätigungs-E-Mail erhalten hast, wird auf der Seite Installiertes Paket die aktuelle Paketversion angezeigt.

    Um dein neues Paket zu konfigurieren, lies unter „Konfiguration nach der Installation“ nach.

    Aktualisieren der Paketversion von Adobe Acrobat Sign für Salesforce.

Aktualisiertes Paket konfigurieren

Du musst die OAuth-Verbindung zwischen Adobe Acrobat Sign und Salesforce aktualisieren. 

Adobe Acrobat Sign für Salesforce-Objekte können sich mit den einzelnen Paketversionen verändern. Daher musst du deine Workflows überprüfen. Wenn du benutzerdefinierte Lösungen nutzt, die von den geänderten Objekten abhängig sind, musst du deine Anpassungen möglicherweise aktualisieren.

  1. Navigiere zu Setup > Plattform-Tools > Apps > Pakete > Installierte Pakete.

  2. Wähle für das Adobe Acrobat Sign-Paket Konfigurieren aus.

    Dann wird der Einrichtungsassistent für Adobe Acrobat Sign für Salesforce geöffnet.

    Hinweis: Wenn der Einrichtungsassistent nicht automatisch startet, navigiere zur Registerkarte Adobe Acrobat Sign Admin und wähle Einrichtungsassistent starten aus.

    Einrichtung starten

  3. Gehe in „Schritt 1: Dein Adobe-Konto mit Salesforce verknüpfen“ des Einrichtungsassistenten wie folgt vor:

    1. Wähle Bei Adobe anmelden aus. 
    2. Melde dich mit deinen Admin-Anmeldedaten bei Adobe Acrobat Sign an.
    3. Wenn du dazu aufgefordert wirst, wähle Zugriff erlauben aus.

    Folgende Meldung wird angezeigt: Herzlichen Glückwunsch! du haben die Autorisierung deines Adobe-Kontos erfolgreich abgeschlossen.

  4. Wenn du die Benachrichtigung erhalten, dass Schritt 1 erfolgreich war, wähle Weiter aus.

  5. Gehe in „Schritt 2: Automatische Statusaktualisierungen für Adobe Sign aktivieren“ wie folgt vor:

    1. Wähle Aktivieren aus.
    2. Klicke auf Zulassen, wenn du aufgefordert werden, den Zugriff auf Adobe Acrobat Sign zuzulassen.

    Folgende Meldung wird angezeigt: Herzlichen Glückwunsch! du haben die automatischen Statusaktualisierungen für dein Konto erfolgreich aktiviert.

  6. Wähle Weiter aus.

  7. Wenn der Einrichtungsassistent Herzlichen Glückwunsch! Die Einrichtung ist abgeschlossen anzeigt, wähle Fertig aus.

  8. Konfiguriere bei Bedarf alle manuellen Aktualisierungen, die im Abschnitt Neue Funktionen aufgeführt sind.

Hinweis:

Nach Abschluss der Installation und Konfiguration des neuen Pakets lies in den entsprechenden Abschnitten von Acrobat Sign für Salesforce: Upgrade-Handbuch nach, welche Einstellungen und Felder in den Vorgängerversionen hinzugefügt wurden.

Aktivieries diese neuen Einstellungen und Feldwerte manuell in deiner Organisation, damit das neue Paket richtig funktioniert. Wenn du beispielsweise ein Upgrade von Version 19 auf Version 23 vornehmen, aktivieries die manuellen Bearbeitungen, die für die Versionen 20, 21 und 22 aufgeführt sind.

Neue Funktionen

Paketversion 24.26

Füge den Auswahllistenwert „E-Mail-OTP“ hinzu

Für mobile Benutzende, die ein Upgrade von Version 24.26 durchführen, ist die E-Mail-OTP-Option nicht standardmäßig aktiviert. Du musst sie wie folgt manuell aktivieren:

  1. Navigiere zu Einrichten > Objekt-Manager > Empfangende > Felder und Beziehungen > Verifizierungsmethode für Unterzeichnende.
  2. Scrolle nach unten zum Abschnitt Werte und wähle dann Neu.
  3. Gib E-Mail-OTP ein.
  4. Wähle Speichern aus.

Paketversion 24.14

  • Adobe Acrobat Sign für Salesforce Version 24.14 enthält (in der folgenden Abbildung gezeigte) neue Auswahllistenwerte zum Festlegen von Erinnerungen in Vereinbarungsvorlagen und Vereinbarungen. 
    Beim Upgrade auf das Paket V 24.14 müssen Salesforce-Administrator*innen die folgenden Auswahllistenwerte manuell zum benutzerdefinierten Feld „Automatische Erinnerungen“ in der Vereinbarungsvorlage und zum benutzerdefinierten Feld „Empfangende an Signieren erinnern“ in der Vereinbarung hinzufügen:
    • Jeden Werktag bis zur Signatur
    • Jeden zweiten Tag bis zur Signatur
    • Jeden dritten Tag bis zur Signatur
    • Jeden fünften Tag bis zur Signatur
Adobe Acrobat Sign für Salesforce Version 24.14 beinhaltet neue Auswahllistenwerte, mit denen du Erinnerungen an Empfangende senden oder automatische Erinnerungen für Vereinbarungsvorlagen generieren können.
Adobe Acrobat Sign für Salesforce Version 24.14 beinhaltet neue Auswahllistenwerte, mit denen du Erinnerungen an Empfangende senden oder automatische Erinnerungen für Vereinbarungsvorlagen generieren können.

  • Um die Verifizierungsmethode Acrobat Sign zu aktivieren, müssen Salesforce-Admins den neuen Auswahllistenwert „Acrobat Sign“ zum Feld „Unterzeichnenden-Verifizierungsmethode“ (API-Name echosign_dev1_Signer_Verification_Methodc) im Empfangenden-Objekt (API-Name echosign_dev1SIGN_Recipients_c) hinzufügen.
NewSignerVerificationPickListValue.png

  • Version 24.14 unterstützt die Namenssperre für Empfangende, wodurch der Empfängername für die KBA-Authentifizierung für alle Vereinbarungen ein Pflichtwert wird. Um die Einstellung „KBA-Name erforderlich“ erfolgreich zu implementieren, müssen Admins den neuen Auswahllistenwert „Acrobat Sign-Authentifizierung“ zur „Verifizierungsmethode für interne Unterzeichnende“ in den Objekten Vereinbarung und Vereinbarungsvorlage wie unten gezeigt hinzufügen. 
AgreementTemplateInternalSignerVerificationMethod.png

AgreementTemplateNewPicklistValue.png

  • Ab Version 24.14 unterstützt Adobe Acrobat Sign für Salesforce das SOAP-API-basierte Push-Modell zum Auslösen automatischer Statusaktualisierungen nicht mehr. Die automatische Aktualisierung des Vereinbarungsstatus wird jetzt nur noch mit dem REST-API-basierten Pull-Modell ausgelöst.

Paketversion 23.x

Paketversion 22.x

Paketversion 21.5.11
Erforderliches Installationspaket für alle Versionen vor Version 21.5.9

Für jede vorhandene Installation, die von 21.5.9 oder einer älteren Version aktualisiert wird, muss zuerst das 21.5.11-Paket installiert werden.

Nach der Installation von Version 21.5.11 kann das aktuelle Paket installiert werden.

Für jede vorhandene Installation, die von 21.5.9 oder einer älteren Version aktualisiert wird, muss zuerst das 21.5.11-Paket installiert werden. Nach der Installation von Version 21.5.9 und höher kann das aktuelle Paket installiert werden.

Paketversion v21.x

Hinweis:

Version 21.x bietet mehrere Aktualisierungen bezüglich der Arbeitsweise von Adobe Sign für Salesforce. 

Es wird dringend empfohlen, Version 21.x zuerst in deiner Sandbox-Umgebung zu installieren, um prüfen, ob alle Aspekte der Anwendung wie erwartet funktionieren.

Entwickler*innen sollten die Änderungen bei der Aktualisierungsreihenfolge und die Änderung der Apex-Methode sorgfältig überprüfen. 

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?