申請URLリクエスト パラメータ定義
URLで指定したフォームテンプレートから申請(InputData)を新規作成 / 過去申請参照し、その申請画面を開くインターフェースの仕様です。
基本情報
| 項目 | 内容 |
|---|---|
| エンドポイント | https://<Salesforceドメイン>/apex/docutizeform__beginNewApplication |
| HTTPメソッド | GET |
| 認証 | Salesforceへのログインが必要(ログインユーザーの権限・共有設定で実行される) |
リクエストパラメータ
| パラメータ名 | 必須 | 型 | 説明 |
|---|---|---|---|
formTemplateId | ○ | ID(15桁または18桁) | 申請の元になるフォームテンプレート(FormTemplate__c)のレコードID。 |
referenceInputDataId | - | ID(15桁または18桁) | 過去申請参照の参照先となる申請(InputData__c)のレコードID。指定した場合は過去申請参照として、省略時は新規申請としてレコードが作成される。 |
URLの形式
新規申請:
https://<Salesforceドメイン>/apex/docutizeform__beginNewApplication?formTemplateId=<フォームテンプレートID>
過去申請参照:
https://<Salesforceドメイン>/apex/docutizeform__beginNewApplication?formTemplateId=<フォームテンプレートID>&referenceInputDataId=<申請ID>
レスポンス(画面遷移)
| 結果 | 挙動 |
|---|---|
| 成功 | 作成された申請のレコードページへリダイレクト |
| 失敗 | レコードは作成されずにエラーページが表示される |
エラーになる主な条件
- formTemplateId が未指定。
- 指定した formTemplateId が実在しない、または参照権限がない。
- 指定した referenceInputDataId が実在しない。
注意事項
- エラー時はいずれの原因でも同一のエラーページが表示され、エラー理由はレスポンスから判別できません。
- 申請の作成はログインユーザーの権限で行われるため、フォームテンプレートおよび申請関連オブジェクトへのアクセス権が必要です。
申請の手順
組織に接続した状態で、上記のパラメータ定義に沿ってリクエストURLを作成してアクセスします。
申請ページにリダイレクトされれば成功です。過去申請参照の場合は値もセットされた状態となります。