Opis funkcji

Adresy URL widżetów można zmodyfikować, tak aby wypełniały wyznaczone pola zawartością, rozszerzając w ten sposób użyteczność pojedynczego widżetu, który może wymagać unikatowych wartości w różnych sytuacjach.

Na przykład, jeśli na określonym terenie znajduje się kilka kiosków i chcesz automatycznie umieścić w widżecie numer sklepu i pracownika, możesz to zrobić w prosty sposób, dołączając kilka parametrów na koniec adresu URL widżetu. 

Wymaga to jedynie, aby pola do uzupełnienia były prawidłowo zidentyfikowane, a wartości do wstawienia poprawnie dodane do adresu URL.

Do zapewniania tej funkcji Adobe Sign używa fragmentów adresu URL z hashem. Gwarantuje to, że serwery Adobe Sign nigdy nie widzą wartości przesyłanych poprzez adres URL, chroniąc tym samym dane osobowe, które mogą być częścią wprowadzonych parametrów.


Korzystanie

Aby wstawić wartości do pola widżetu, 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

Aby dane pole było dostępne dla parametrów adresu URL:

  • Utwórz lub edytuj widżet, aby uzyskać dostęp do pól
  • Dodaje pole tekstowe, które chcesz wypełnić przy użyciu adresu URL
    •  Tylko pola tekstowe mogą przyjmować wartości
  • Otwórz właściwości pola, klikając je dwukrotnie
  • 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
  • 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ść
  • Kliknij przycisk OK, aby zapisać parametry
  • Powtórz te czynności dla wszystkich pól, które mają przyjmować parametry z adresu URL
  • Kliknij przycisk Zapisz, aby zapisać widżet
field_settings_toallowvaluestopassinviaurl

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

Łatwym sposobem na utworzenie adresu URL jest:

  • skopiowanie adresu URL z widżetu. Poniżej znajduje się najprostsza instrukcja:
    • Edytuj widżet na stronie Zarządzaj
    • Kliknij łącze Kopiuj adres URL widżetu
  • Wklej adres URL widżetu do edytora tekstu (np. Notatnika)
copy_widget_url

Adresy URL widżetów 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.echosign.com/public/esignWidget?wid=CBF2s*

 

  • Dodaj swoje parametry

Początek parametru oznacza się, dodając symbol hasha (#) na końcu adresu URL widżetu.

Następnie dodaj parametry w formacie {nazwa_pola}={wartość} 

Przykładowy adres URL z jednym parametrem

https://secure.na1.echosign.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.echosign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

 

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

Widżet zostanie zrenderowany z wypełnionymi polami:

populated_widget

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.echosign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Poniższy przykład jest nieprawidłowy: https://secure.na1.echosign.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 widżetów. Ze względu na używanie fragmentów adresu URL z hashem, jeśli widżet 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


Opcje konfiguracji

Dla tej funkcji nie ma dostępnych żadnych opcji.


Włączanie i wyłączanie

Możliwość wypełnia pól za pomocą adresu URL jest nieodłączną właściwością widżetów i nie można jej wyłączać.

Ta zawartość jest licencjonowana na warunkach licencji Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Posty z serwisów Twitter™ i Facebook nie są objęte licencją Creative Commons.

Informacje prawne   |   Zasady prywatności online