Podręcznik użytkownika Anuluj

Wstępne wypełnianie wartości pól formularza internetowego przy użyciu parametrów adresu URL

 

Podręcznik Adobe Acrobat Sign

Nowości

Pierwsze kroki

Administrowanie

Wysyłanie i podpisywanie umów oraz zarządzanie nimi

Zaawansowane możliwości umów i obiegów pracy

Integracja z innymi produktami

Programista Acrobat Sign

Pomoc techniczna i rozwiązywanie problemów

Używanie parametrów URL do wypełniania pól formularza internetowego

Aby wstawić wartości do pola formularza internetowego, należy zapoznać się z dwoma zagadnieniami:

  • W jaki sposób oznaczyć pole jako dostępne dla parametrów adresu URL
  • W jaki sposób konstruować parametry adresu URL do wstawienia

 

W jaki sposób oznaczyć pole jako dostępne dla parametrów adresu URL

  1. Utwórz lub edytuj formularz internetowy, aby uzyskać dostęp do pól.

  2. Dodaje pole tekstowe, które chcesz wypełnić przy użyciu adresu URL.

    •  Tylko pola tekstowe mogą przyjmować wartości.
  3. Otwórz właściwości pola, klikając je dwukrotnie.

  4. Edytuj nazwę pola, tak aby łatwo ją rozpoznać. Nazwa pola stanowi pierwszą część parametru, którego będziesz używać, dlatego krótsza nazwa jest zazwyczaj lepsza.

  5. Zaznacz pole wyboru Wartość domyślna może pochodzić z adresu URL.

    • Opcjonalnie zaznacz pole wyboru Tylko do odczytu, jeśli nie chcesz, aby można było edytować tę wartość.
  6. Kliknij przycisk OK, aby zapisać parametry.

  7. Powtórz te czynności dla wszystkich pól, które mają przyjmować parametry z adresu URL.

  8. Kliknij Zapisz, aby zapisać formularz internetowy.

URL

W tym przykładzie utworzymy dwa pola wypełniane za pomocą adresu URL:

  • Branch_Office – pole przyjmujące ciąg określający oddział firmy (pokazane wyżej).
  • Emp_ID – pole przyjmujące ciąg określający identyfikator pracownika.

 

W jaki sposób konstruować parametry adresu URL do wstawienia

  1. Skopiowanie adresu URL z formularza internetowego. Poniżej znajduje się najprostsza instrukcja:

    • Edytuj formularz internetowy na stronie Zarządzaj.
    • Kliknij łącze Kopiuj adres URL formularza internetowego.
    URL

    Adresy URL formularzy internetowych są bardzo długie, dlatego w tym przykładzie użyjemy skróconego adresu (Twój będzie wyglądać inaczej):

    Przykładowy adres URL:

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

  2. Wklej adres URL formularza internetowego do edytora tekstu (np. Notatnika).

  3. Dodaj swoje parametry.

    • Początek parametru oznacza się, dodając symbol hasha (#) na końcu adresu URL formularza internetowego.
    • Następnie dodaj parametry w formacie {nazwa_pola}={wartość}.

    Przykładowy adres URL z jednym parametrem:

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

    • Wiele wartości można wstawić, dodając między nimi symbol et (&).

    Przykładowy adres URL z dwoma parametrami:

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

  4. Po dodaniu do adresu URL wszystkich par pole=wartość skopiuj pełny ciąg i wklej go w przeglądarce.

    Formularz internetowy zostanie zrenderowany z wypełnionymi polami:

    Parametry URL  w formularzu internetowym

Właściwości i ograniczenia

  • Znaku hasha używa się tylko raz w celu określenia początku parametru(-ów).
    • Użycie w wartości kolejnego znaku hasha nie ma negatywnego wpływu na wynik.
  • Używanie spacji w wartościach jest dopuszczalne.
  • Używanie spacji w nazwach pól jest dozwolone wyłącznie w przypadku wstawienia %20 jako znaku spacji w adresie URL.
    • Poniższy przykład będzie działać prawidłowo: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Poniższy przykład jest nieprawidłowy: https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Generalnie w przypadku nazw pól zaleca się używanie znaków podkreślenia zamiast spacji. Pozwala to zaoszczędzić czas.
  • Znak spacji nie jest dozwolony między nazwą pola, znakiem równości i początkiem wartości NazwaPola=Wartość
  • W przypadku wielu wartości spacji nie stawia się przed ani po symbolu &.
  • Nie ma żadnych ograniczeń (innych niż długość adresu URL) co do liczb pól, które mogą pobierać swoje wartości z parametrów adresu URL.
  • Tekstowe pola obliczeniowe nie mogą być zastępowane, a w swoich właściwościach pola nie mają wyświetlanego pola wyboru.
  • Parametry adresu URL nie działają w przypadku uwierzytelnianych formularzy internetowych. Ze względu na używanie fragmentów adresu URL z hashem, jeśli formularz internetowy jest chroniony za pomocą hasła lub innej metody uwierzytelniania, po zakończeniu uwierzytelniania parametrów adresu URL nie można przekazywać z powrotem do klienta (ta część adresu URL nigdy nie jest widoczna dla serwera).

 

Obsługa błędów

  • Wszystkie parametry adresu URL, które nie będą dokładnie pasować do nazwy pola formularza, zostaną zignorowane.
  • Wszystkie parametry adresu URL, które podejmą próbę przypisania wartości do pola innego niż tekstowe lub pola tekstowego bez włączonej opcji Wartość domyślna może pochodzić z adresu URL, również zostaną zignorowane.