Руководство пользователя Отмена

Предварительное заполнение значений полей веб-формы с помощью параметров URL

 

Руководство пользователя Adobe Acrobat Sign

Новые возможности

Начало работы

Администрирование

Отправка, подписание соглашений и управление ими

Расширенные возможности и рабочие процессы для работы с соглашениями

Интеграция с другими продуктами

Разработчик Acrobat Sign

Поддержка и устранение неполадок

Использование параметров URL-адреса для заполнения полей веб-форм

Чтобы вставить значения в поле веб-формы, необходимо знать две вещи.

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

 

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

  1. Создайте или отредактируйте веб-форму, чтобы получить доступ к полям.

  2. Добавьте текстовое поле, которое хотите заполнить с помощью URL.

    •  Принимать значения могут только текстовые поля.
  3. Откройте свойства поля, дважды нажав на него.

  4. Измените имя поля (укажите реальную информацию). Имя поля — это первая часть параметра, который вы будете использовать. Поэтому, чем имя короче, тем лучше.

  5. Установите флажок Значение по умолчанию может быть добавлено из URL-адреса.

    • При необходимости установите флажок Только для чтения, если не хотите, чтобы это значение изменяли.
  6. Нажмите кнопку ОК, чтобы сохранить параметры.

  7. Повторите эти шаги для всех полей, которые должны принимать параметры из URL.

  8. Нажмите кнопку Сохранить, чтобы сохранить веб-форму.

URL

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

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

 

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

  1. Скопируйте URL-адрес из веб-формы. Самый простой способ это сделать:

    • Отредактируйте веб-форму на странице «Управление».
    • Нажмите ссылку Копировать URL-адрес веб-формы.
    URL

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

    Пример URL:

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

  2. Вставьте URL-адрес веб-формы в текстовый редактор (например, «Блокнот»).

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

    • Начало параметров обозначается знаком «решетки» (#) в конце URL-адреса веб-формы.
    • Затем добавляются параметры в формате {field_name}={value}

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

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

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

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

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

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

    Веб-форма осуществит рендеринг, заполняя следующие поля.

    URL  параметры в веб-форме

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

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

 

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

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