Adobe Sign für Salesforce: Konfiguration des Dienstes für große Dokumente/Push-Vereinbarungen

Umfangreiche Dokumente werden bei Sendetransaktionen und Hintergrundaktionen bis zu bestimmten Höchstgrenzen automatisch unterstützt:

• Send-Transaktionen – Wenn Sie auf der Vereinbarungsseite auf die Schaltfläche Zum Unterschreiben senden klicken, können Sie ein einzelnes Dokument mit einer Größe von 4,0 MB oder mehrere Dokumente mit einer Gesamtgröße von 4,0 MB senden.
• Hintergrundaktionen – Mithilfe von Hintergrundaktionen können Sie ein einzelnes Dokument mit einer Größe von bis zu 9,0 MB oder mehrere Dokumente mit einer Gesamtgröße von bis zu 9,0 MB senden. (Weitere Informationen zu Hintergrundaktionen finden Sie im Handbuch für die erweiterte Anpassung).

Um größere Dokumente zu aktivieren, müssen Sie Folgendes tun:

• Bearbeiten Sie das Rückrufbenutzerprofil, um zusätzlichen Zugriff zu gewähren.
• Aktivieren Sie die Zählung der Anhangsdienstaufrufe für die Rückrufbenutzerprofile.
• Bearbeiten Sie die Site, um die LargeFileDownloadService-Apex-Klasse zu aktivieren.
• Aktualisieren Sie die benutzerdefinierten Einstellungen zur Verwendung der Rückruf-URL.

Um dem Anwender für die Adobe Sign-Rückruf-Site Berechtigungen auf Objektebene zu gewähren, gehen Sie wie folgt vor.

• Klicken Sie auf der Seite für das Adobe Sign-Rückrufprofil auf Bearbeiten und scrollen Sie zu Benutzerdefinierte Objektberechtigungen.
• Aktivieren Sie alle Objektberechtigungen (Lesen, Erstellen, Bearbeiten, Löschen, Alle anzeigen, Alle ändern) für Vereinbarungen.
• Aktivieren Sie die echosign_dev1. AgreementAttachmentDownloadService-Apex-Klasse
• Klicken Sie auf Speichern.

• Navigieren Sie zu Objektmanager > Vereinbarung > Felder & Beziehungen.
• Klicken Sie auf die Feldbezeichnung Zählung der Anhangsdienstaufrufe.
• Klicken Sie auf die Schaltfläche Sicherheit auf Feldniveau einstellen.
• Aktivieren Sie Sichtbar und Schreibgeschützt für das Rückrufbenutzerprofil.
• Klicken Sie auf Speichern.

Sie müssen auch das Profil für Ihre Adobe Sign-Rückruf-Site anpassen, um die LargeFileDownloadService-Apex-Klasse hinzuzufügen, damit sie sichtbar ist.

1. Navigieren Sie zu Setup > Plattform-Tools > Benutzeroberfläche > Sites und Domänen > Sites.
2. Klicken Sie auf die Site-Bezeichnung für die Adobe Sign-Rückruf-Site.
3. Klicken Sie auf die Schaltfläche Einstellungen für öffentlichen Zugriff.

    4. Klicken Sie auf den Link Zugriff auf Apex-Klassen aktivieren, um zu diesem Abschnitt zu wechseln, und klicken Sie auf Bearbeiten. 

• Wählen Sie auf der linken Seite in der Liste Verfügbare Apex-Klassen den Eintrag echosign_dev1.LargeFileDownloadService aus und klicken Sie auf Hinzufügen, um ihn auf der rechten Seite in der Liste Aktivierte Apex-Klassen hinzuzufügen.
• Klicken Sie auf Speichern.

1. Navigieren Sie zu Setup > Benutzeroberfläche > Sites und Domains > Sites.

2. Klicken Sie auf Site-Bezeichnung, um zur Rückruf-Site zu gelangen.

3. Klicken Sie im Abschnitt Benutzerdefinierte URLs auf den Link Ansicht.

• Eine neue Registerkarte wird geöffnet.

4. Auf der neuen Registerkarte kopieren Sie den Wert der URL im Browser und fügen ihn in eine Textdatei ein.

• Wenn Sie auf Sandbox-Instanzen Tests durchführen, kopieren Sie die URL, der „http“ vorangestellt ist, und nicht die URL mit dem Präfix „https“.

Ihre URL sollte etwa wie die folgende URL aussehen:

5. Navigieren Sie zu Setup > Plattform-Tools > Benutzerdefinierter Code > Benutzerdefinierte Einstellungen.

• Hierdurch wird die Seite Benutzerdefinierte Einstellungen geladen.

6. Klicken Sie auf die Bezeichnung Adobe Sign-Einstellungen.

• Die Seite Adobe Sign-Einstellungen wird geladen.

7.  Klicken Sie auf die Schaltfläche Verwalten.

8. Klicken Sie auf Neu oder Bearbeiten.

• Die Seite Adobe Sign Settings bearbeiten wird geladen.

9.  Legen Sie für Rückruf-URL Adobe zu Salesforce-Site die sichere Webadresse fest, die Sie nach dem Konfigurieren Ihrer Adobe Sign-Rückruf-Site (siehe Schritt 7 oben) kopiert haben.

• Stellen Sie sicher, dass das Adressenpräfix „https“ und nicht „http“ lautet.

10. Klicken Sie auf Speichern zum Speichern Ihrer Einstellungen.

Der Dienst für große Dokumente ist jetzt aktiviert.

Sie können die Adobe Sign-API verwenden, um Vereinbarungen zum Signieren zu senden oder Widgets zu erstellen und sie auf Ihrer Website einzubetten. Außerdem können Sie Vereinbarungen übertragen und in Salesforce generieren, als ob diese Vereinbarungen aus Salesforce gesendet worden wären. Sie können Vereinbarungen auch über die Webanwendung echosign.adobe.com senden und dann an Salesforce zurückübertragen lassen.

So aktivieren Sie diese Push-Vereinbarungen:

• Bearbeiten Sie den Rückrufbenutzer, um den Berechtigungssatz für den Adobe Sign-Integrationsbenutzer zur Verfügung zu stellen.
• Bearbeiten Sie die Rückruf-Site, um die Visualforce-Seite EchoSignAgreementPushCallback hinzuzufügen.
• Bearbeiten Sie die Berechtigungen für Site-Objekt und Feldebene.
• Je nachdem, wie Sie Adobe Sign verwenden möchten, können Sie unterschiedliche Konfigurationen verwenden.

1. Navigieren Sie zu Setup > Verwaltung > Benutzer > Benutzer.
2. Suchen Sie den Rückrufbenutzer und klicken Sie auf den Link Vollständiger Name, um die Seite mit den Benutzerdetails zu öffnen.

3. Bewegen Sie den Mauszeiger über den Link Berechtigungssatzzuweisungen und klicken Sie auf die Schaltfläche Zuweisungen bearbeiten.

4. Wählen Sie im Bereich über Verfügbare Berechtigungssätze die Option Adobe Sign-Integrationsbenutzer aus.

• Klicken Sie auf die Schaltfläche Hinzufügen.
• Klicken Sie auf Speichern

1. Navigieren Sie zu Setup > Plattform-Tools > Benutzeroberfläche > Sites und Domänen > Sites.
2. Klicken Sie auf die Site-Bezeichnung für die Adobe Sign-Rückruf-Site.

3. Scrollen Sie zum Abschnitt Site-Visualforce-Seiten und klicken Sie auf Bearbeiten.

4. Gehen Sie zu echosign_dev1.EchoSignAgreementPushCallback und wählen Sie es durch einmaliges Klicken aus.

5. Klicken Sie auf Hinzufügen, um die Seite auf die Seite Aktivierte Visualforce-Seiten zu verschieben.

6. Klicken Sie auf Speichern.

Nach dem Hinzufügen der Visualforce-Seite werden Sie zurück zur Seite Site-Details der Rückruf-Site geleitet.

• Klicken Sie auf die Einstellungen für öffentlichen Zugriff, um die Seite Profile zu öffnen.
• Klicken Sie auf der Seite Profile auf Bearbeiten.
• Blättern Sie hinunter zum Abschnitt über die Standard-Objektberechtigungen.
• Aktiveren Sie die Berechtigungen Lesen und Erstellen für die folgenden Objekte:
  • Konto
  • Kontakt
  • Vertrag
  • Lead
  • Opportunity
• Klicken Sie auf Speichern, Sie werden zurück zum Rückrufprofil geleitet.

Für einige Objekte müssen zudem Anpassungen auf Feldniveau vorgenommen werden:

• Blättern Sie nach unten zum Abschnitt über die Sicherheit auf Feldniveau und bearbeiten Sie Folgendes:
  • Standardsicherheit auf Feldniveau
    • Kontakt
      • Konto > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.
      • E-Mail > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.
      • Name > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.
    • Lead
      • Unternehmen > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.
      • E-Mail > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.
      • Name > stellen Sie sicher, dass Lese- und Schreibzugriff gegeben sind.

Wenn alle Vereinbarungen in Ihrem Konto, die außerhalb von Adobe Sign versendet wurden, in Salesforce erstellt und übertragen werden sollen, befolgen Sie diese Anweisungen:

• Kopieren Sie die sichere URL-Adresse von der Adobe Sign-Rückruf-Site, die Sie erstellt haben, und hängen Sie /echosign_dev1__EchoSignAgreementPushCallback an, um die Rückruf-URL zusammenzustellen. Senden Sie Ihre Rückruf-URL an den Adobe-Support, damit die URL als Standard-Rückruf-URL für Ihr Adobe Sign-Konto eingestellt werden kann. Beispiel: Wenn Ihre Site-Adresse https://echov11-dev.na12.force.com/AdobeSignCallback lautet, dann ist Ihre Rückruf-URL: https://echov11-dev.na12.force.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback
• Der Adobe-Support sollte außerdem Ihre Adobe Sign-Benutzer-ID für die standardmäßige Rückruf-URL-API-Benutzereinstellung eingeben. Für alle Konten, die Salesforce verwenden, sollte eingestellt sein, dass der Dokumentschlüssel an die Rückruf-URL angehängt wird.

Wenn Sie Vereinbarungen über die API senden, befolgen Sie diese Anweisungen:

• Kopieren Sie die sichere URL-Adresse von der Adobe Sign-Rückruf-Site, die Sie erstellt haben, und hängen Sie /echosign_dev1__EchoSignAgreementPushCallback an, um die Rückruf-URL zusammenzustellen, die in der Adobe Sign-API verwendet werden soll.
  • Beispiel: Wenn Ihre Site-Adresse https://echov11-dev.na12.force.com/AdobeSignCallback
    lautet, dann sollten Sie diese URL in der Adobe Sign-API verwenden: https://echov11-dev.na12.force.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback
• Wenn Sie eine Vereinbarung senden oder ein Webformular über die API erstellen, müssen Sie eine Rückruf-URL angeben (siehe https://secure.echosign.com/redirect/latestApiMethods und API-Parameter „CallbackInfo“).
• Vergewissern Sie sich außerdem, dass Ihre Kontoeinstellungen so konfiguriert sind, dass der Dokumentschlüssel an die Rückruf-URL angehängt wird, die standardmäßig für Salesforce-Kunden, die Adobe Sign verwenden, benutzt wird. Bei Problemen wenden Sie sich bitte an den Adobe Sign-Support.
• Rufen Sie außerdem die Zuordnungseinstellungen für Übertragungen auf, um Voreinstellungen für die Datensätze zu definieren, die beim Übertragen von Vereinbarungen an Salesforce erstellt werden.