URL パラメーターを使用して web フォームフィールド値を事前に入力する


URL パラメーターを使用して web フォームフィールドに入力する

値を web フォームフィールドに挿入するには、以下の 2 つの項目を把握する必要があります。

  • フィールドが URL パラメーター用に利用可能であることをマークする方法
  • 挿入する URL パラメーターを作成する方法

 

フィールドが URL パラメーター用に利用可能であることをマークする方法

  1. Web フォームを作成または編集して、フィールドへのアクセス権を取得します。

  2. URL を介して入力したいテキストフィールドを追加します。

    •  値を入力できるのは、テキストフィールドのみです。
  3. フィールドをダブルクリックして、フィールドのプロパティを開きます。

  4. 意味のあるフィールド名を入力します。フィールド名は使用するパラメーターの最初の部分となるので、一般的には短い方が望ましいです。

  5. デフォルト値は URL から取得可能」チェックボックスをオンにします。

    • 値を編集不可にするには、「読み取り専用」チェックボックスをオンにします(任意)。
  6. OK」をクリックしてパラメーターを保存します。

  7. URL からパラメーターを取得する必要があるすべてのフィールドに対して、上述の手順を繰り返します。

  8. 保存」をクリックして web フォームを保存します。

URL

この例では、以下の 2 つのフィールドを作成し、URL を介して値を入力します。

  • Branch_Office - 支店文字列を取得するフィールド(上記を参照)
  • Emp_ID - 従業員 ID を取得するフィールド

 

挿入する URL パラメーターを作成する方法

  1. Web フォームから URL をコピーします。この操作をおこなう最も簡単な方法を、以下に示します。

    • 管理ページで、web フォームの「編集」リンクをクリックします。
    • Web フォーム URL をコピー」リンクをクリックします。
    URL

    Web フォームの URL は非常に長いので、ここでは例として省略したものを使用します(実際の URL はこれとは異なります)。

    サンプル URL:

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

  2. Web フォームの URL をテキストエディター(ノートパッドなど)にペーストします。

  3. パラメーターを追加します。

    • パラメーターの始点は、web フォームの URL の最後にハッシュ記号(#)を追加することで識別します。
    • 次に、パラメーターを {field_name}={value} 形式で追加します。

    パラメーターが 1 つあるサンプル URL

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

    • 複数の値を追加するには、フィールド値の間にアンパサンド(&)を挿入します。

    パラメーターが 2 つあるサンプル URL

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

  4. すべてのフィールド値のペアを URL に追加したら、文字列全体をコピーしてブラウザーにペーストします。

    Web フォームは、入力したフィールドでレンダリングされます。

    URL

プロパティと制限

  • ハッシュ記号は、パラメーターの始点を指定するために 1 度のみ使用します。
    • 値の後にハッシュ記号を使用しても、結果に悪影響を与えません。
  • 値の間にスペースを挿入することができます。
  • フィールド名におけるスペースの使用は、%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
    • 一般的に、フィールド名にはスペースではなくアンダースコアを使用することが推奨されます。アンダースコアを使用することで、最終的に作業時間を短縮できます。
  • フィールド名、イコール記号、値の始点(Fieldname=Value)の間には、スペースを挿入できません
  • 複数の値がある場合、アンパサンドの前後にスペースを挿入しないでください。
  • URL パラメーターから値を取得できるフィールド数に制限はありません(URL の長さには制限がある場合があります)。
  • 計算したテキストフィールドは上書きできません。また、フィールドのプロパティにチェックボックスは表示されません。
  • URL パラメーターは、認証済み web フォームでは動作しません。URL のハッシュフラグメントを使用すると、web フォームがパスワードなどの認証によって保護されている場合、認証が完了した後、URL パラメーターはクライアントに返されません(サーバーは URL の該当するパラメーターを取得しません)。

 

エラーの処理

  • フォームフィールド名と一致していない URL パラメーターは無視されます。
  • テキスト以外のフィールド、または「デフォルト値は URL から取得可能」が有効になっていないテキストフィールドに値を割り当てようとしている URL パラメーターは無視されます。