Описание функции

URL виджета можно изменить таким образом, чтобы заполнить указанные поля значениями. Благодаря этому повышается эффективность отдельного виджета, предоставляющего уникальные значения для различных ситуаций.

Например, если несколько интерактивных терминалов рассредоточены по определенной зоне, можно автоматически заполнить виджет данными о магазине и сотруднике, добавив несколько параметров в конце URL виджета. 

Для этого требуется только правильно указать поля, которые нужно заполнить, и значения для них. Это можно сделать, добавив соответствующие параметры в URL.

Для обеспечения этой функциональности Adobe Sign использует якорь URL после символа #. Благодаря этому серверы Adobe не видят значения, передаваемые через URL. Таким образом обеспечивается защита личных данных, которые могут присутствовать во вставляемых параметрах.


Способ применения

Чтобы вставить значения в поле виджета, необходимо знать две вещи:

  • Как указать поле для добавления параметров URL
  • Как составить параметры URL для вставки

 

Как указать поле для добавления параметров URL

Чтобы сделать поле доступным для добавления параметров URL, выполните следующие действия:

  • Создайте или отредактируйте виджет, чтобы получить доступ к полям.
  • Добавьте текстовое поле, которое хотите заполнить с помощью URL.
    •  Принимать значения могут только текстовые поля.
  • Откройте свойства поля, дважды нажав на него.
  • Измените имя поля (укажите реальную информацию). Имя поля — это первая часть параметра, который вы будете использовать. Поэтому, чем имя короче, тем лучше.
  • Установите флажок Значение по умолчанию может быть добавлено из URL-адреса.
    • При необходимости установите флажок Только для чтения, если не хотите, чтобы это значение изменяли.
  • Нажмите кнопку ОК, чтобы сохранить параметры.
  • Повторите эти шаги для всех полей, которые должны принимать параметры из URL.
  • Нажмите кнопку Сохранить, чтобы сохранить виджет.
field_settings_toallowvaluestopassinviaurl

В данном примере создаются два поля, которые будут заполнены с помощью URL:

  • Branch_Office — поле, которое принимает строку филиала компании (показана выше).
  • Emp_ID — поле для ввода идентификатора сотрудника.

 

Как составить параметры URL для вставки

Самый простой способ составить URL:

  • Скопируйте URL из виджета. Самый простой способ это сделать:
    • Отредактируйте виджет на странице «Управление».
    • Нажмите ссылку Копировать URL-адрес виджета.
  • Вставьте URL виджета в текстовый редактор (например, «Блокнот»).
copy_widget_url

URL-адреса виджетов очень длинные, поэтому здесь в качестве примера используется сокращенный адрес (ваши будет выглядеть иначе):

Пример URL:

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

 

  • Добавьте свои параметры.

Начало параметров обозначается знаком «решетки» (#) в конце URL виджета.

Затем добавляются параметры в формате {имя_поля}={значение}

Пример URL с одним параметром:

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

 

Чтобы добавить несколько значений, вставьте знак амперсанда (&) между значениями поля.

Пример URL с двумя параметрами:

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

 

Добавив в URL все пары «поле=значение», скопируйте всю строку и вставьте ее в браузер.

Виджет осуществит рендеринг, заполняя поля:

populated_widget

Свойства и ограничения

  • Знак «решетки» используется только один раз для обозначения начала параметров.
    • Последующее применение знака «решетки» в значении не повлияет негативно на результат.
  • Допустимо использование пробелов в значениях.
  • Использование пробелов в имени поля допускается только при явном указании кода %20 в качестве символа пробела в URL.
    • Это будет работать: https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • Это не будет работать: https://secure.na1.echosign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • Как правило, рекомендуется использовать символ подчеркивания в именах полей вместо пробелов. В конечном итоге, так вы сэкономите время.
  • Не допускается использование пробела между именем поля, знаком равенства и началом значения (Имяполя=Значение).
  • Не допускаются пробелы с любой стороны амперсанда при наличии нескольких значений.
  • Не ограничено количество полей (за исключением возможных ограничений длины URL), которые могут получать значения из параметров URL.
  • Нельзя перезаписать значения в вычисленных текстовых полях, и не отображается флажок в их свойствах поля.
  • Параметры URL не работают с виджетами, требующими аутентификации пользователя. Если виджет защищен с помощью пароля или других средств аутентификации, параметры URL не передаются обратно клиенту после завершения аутентификации (сервер никогда не видит эту часть URL) в результате использования фрагментов URL после знака «решетки».

 

Обработка ошибок

  • Любой параметр URL, который точно не совпадает с именем поля в форме, игнорируется.
  • Любой параметр URL, который пытается назначить значение нетекстовому полю или текстовому полю, для которого не установлен флажок Значение по умолчанию может быть добавлено из URL-адреса, игнорируется.


Параметры конфигурации

Отсутствуют параметры, связанные с этой функцией.


Включение и отключение функции

Возможность заполнить поля с помощью URL — унаследованное свойство виджета, которое нельзя отключить.

Эта работа лицензируется в соответствии с лицензией Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported  На посты, размещаемые в Twitter™ и Facebook, условия Creative Commons не распространяются.

Правовые уведомления   |   Политика конфиденциальности в сети Интернет