Benutzerhandbuch Abbrechen

Vorausfüllen von Webformularfeldwerten mithilfe von URL-Parametern

 

Adobe Acrobat Sign-Handbuch

Neue Funktionen

Erste Schritte

Verwaltung

Senden, Signieren und Verwalten von Vereinbarungen

Erweiterte Vereinbarungsfunktionen und Workflows

Integration in andere Produkte

Acrobat Sign-Entwickler

Support und Fehlerbehebung

URL-Parameter zum Ausfüllen von Webformularfeldern verwenden

Wenn Sie Werte in ein Webformular-Feld einfügen möchten, gibt es zwei Dinge zu beachten:

  • Wie zu kennzeichnen ist, dass ein Feld für URL-Parameter verfügbar ist
  • Wie die einzufügenden URL-Parameter aufzubauen sind

 

Wie zu kennzeichnen ist, dass ein Feld für URL-Parameter verfügbar ist

  1. Erstellen oder bearbeiten Sie ein Webformular so, dass es Zugriff auf die Felder hat.

  2. Fügen Sie das Textfeld hinzu, das Sie über die URL ausfüllen möchten.

    •  Nur Textfelder können Werte akzeptieren.
  3. Öffnen Sie die Eigenschaften des Felds durch einen Doppelklick darauf.

  4. Geben Sie dem Feld einen bedeutungsvollen Namen. Der Feldname ist der erste verwendete Teil des Parameters, also gilt in der Regel: je kürzer, desto besser.

  5. Aktivieren Sie das Kontrollkästchen Standardwert stammt unter Umständen aus URL.

    • Aktivieren Sie optional das Kontrollkästchen Schreibgeschützt, wenn der Wert nicht bearbeitbar sein soll.
  6. Klicken Sie auf OK, um die Parameter zu speichern.

  7. Wiederholen Sie den Vorgang für alle Felder, die einen Parameter aus der URL akzeptieren sollen.

  8. Klicken Sie auf Speichern, um das Webformular zu speichern.

URL

In diesem Beispiel werden zwei durch die URL befüllte Felder erstellt:

  • Branch_Office: ein Feld, das die Zeichenfolge für die Zweigstelle akzeptiert (siehe oben)
  • Emp_ID: ein Feld, das die Mitarbeiter-ID akzeptiert

 

Wie die einzufügenden URL-Parameter aufzubauen sind

  1. Kopieren Sie die URL vom Webformular.  Die einfachste Möglichkeit hierfür ist:

    • Bearbeiten Sie das Webformular auf der Seite „Verwalten“.
    • Klicken Sie auf den Link Webformular-URL kopieren.
    URL

    Webformular-URLs sind sehr lang, also wird hier als Beispiel eine gekürzte URL verwendet (Ihre wird anders aussehen):

    Beispiel-URL:

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*

  2. Fügen Sie die Webformular-URL in einen Texteditor ein (z. B. in Notepad).

  3. Fügen Sie Ihre Parameter hinzu.  

    • Der Beginn der Parameter wird durch das Hinzufügen eines Raute-Symbols (Pfund, #) am Ende der Webformular-URL gekennzeichnet.
    • Fügen Sie dann die Parameter im Format {field_name}={value} hinzu.

    Beispiel-URL mit einem Parameter

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621

    • Mehrere Werte werden durch das Einfügen eines Und-Zeichens (&) zwischen den Feldwerten hinzugefügt.

    Beispiel für URL mit zwei Parametern

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

  4. Nachdem alle „Feld=Wert“-Paare zur URL hinzugefügt wurden, kopieren Sie die vollständige Zeichenfolge und fügen Sie sie in Ihren Browser ein.

    Das Webformular wird mit befüllten Feldern gerendert:

    URL  Parameter in einem Webformular

Eigenschaften und Beschränkungen

  • Sie verwenden das Raute-Symbol nur einmal, um den Beginn des/der Parameter(s) zu kennzeichnen.
    • Die Verwendung eines folgenden Raute-Zeichens in einem Wert wirkt sich nicht negativ auf das Ergebnis aus.
  • Die Verwendung von Leerzeichen in Werten ist akzeptabel.
  • Die Verwendung von Leerzeichen im Feldnamen ist nur zulässig, wenn Sie explizit %20 als Leerzeichen in die URL einfügen.
    • Folgendes funktioniert: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Folgendes funktioniert nicht: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Es empfiehlt sich im Allgemeinen, in Feldnamen statt Leerzeichen Unterstriche zu verwenden. Dies spart Ihnen am Ende Zeit.
  • Zwischen dem Feldnamen, dem Gleichheitszeichen und dem Anfang des Werts ist kein Leerzeichen zulässig (Feldname=Wert).
  • Es darf kein Leerzeichen zu beiden Seiten des Ampersands stehen, wenn Sie über mehrere Werte verfügen.
  • Es gibt keine Einschränkung (abgesehen vielleicht von Längenbeschränkungen für die URL) für die Anzahl von Feldern, die über URL-Parameter ihren Wert erhalten können.
  • Berechnete Textfelder können nicht außer Kraft gesetzt werden und verfügen nicht über das in den Feldeigenschaften angezeigte Kontrollkästchen.
  • URL-Parameter sind mit authentifizierten Webformularen nicht kompatibel. Aufgrund der Verwendung von URL-Hash-Fragmenten werden die URL-Parameter nicht an den Client zurückgegeben, nachdem die Authentifizierung abgeschlossen wurde, wenn ein Webformular mit einem Kennwort oder anderen Authentifizierungsmethode geschützt ist (der Server sieht diesen Teil der URL nie).

 

Fehlerbehandlung

  • Alle URL-Parameter, die nicht genau einem Formfeldnamen entsprechen, werden ignoriert.
  • Alle URL-Parameter, die versuchen, einem Feld einen Wert zuzuweisen, das kein Textfeld oder ein Textfeld ohne ausgewähltes Kontrollkästchen Standardwert stammt unter Umständen aus URL ist, werden ignoriert.