AEM Forms はフォームポータル経由で送信されたフォームデータに対してクエリーを実行する際に使用できる API を提供します。また、この文書で説明されている API を使用し、送信済みフォームに対してコメントを投稿したりプロパティを更新したりできます。 

注意:

送信レビュー担当者のフォームへの関連付け」で説明されているように、API を呼び出すユーザーは、レビュー担当者グループに追加する必要があります。

GET /content/forms/portal/submission.review.json?func=getFormsForSubmissionReview

すべての有効なフォームのリストを返します。

URL パラメーター

この API はその他のパラメーターを必要としません。

応答

この応答オブジェクトにはフォーム名とそのリポジトリパスを含む JSON 配列が含まれています。応答の構造は次のとおりです。

[
{formName: "<フォーム名>",
formPath: "<フォームのパス>" },
{.....},
......]

要求 URL

http://[host]:[port]/content/forms/portal/submission.review.json?func=getFormsForSubmissionReview

応答

[{"formPath":"/content/dam/formsanddocuments/forms-review/form2","formName":"form2"},{"formPath":"/content/dam/formsanddocuments/forms-review/form1","formName":"form1"}]

GET /content/forms/portal/submission.review.json?func=getAllSubmissions

すべての送信済みフォームの詳細を返します。ただし、URL パラメーターを使用して結果を制限できます。

URL パラメーター

要求 URL で次のパラメーターを指定します。

パラメーター 説明
formPath フォームが常駐する CRX リポジトリパスを指定します。フォームパスを指定しない場合、空の応答を返します。
offset
(オプション)
結果セットのインデックスでスタートポイントを指定します。デフォルト値は 0 です。
limit
(オプション)
結果の数を制限します。デフォルト値は 30 です。
orderby
(オプション)
結果を並べ替えるプロパティを指定します。デフォルト値は jcr:lastModified で、最終変更時刻に基づいて結果を並べ替えます。
sort
(オプション)
結果を並べ替える順序を指定します。デフォルト値は desc で、結果を降順で並べ替えます。asc を指定すると、結果を昇順で並べ替えできます。
cutPoints
(オプション)
結果に含めるフォームプロパティのコンマ区切りリストを指定します。デフォルトのプロパティは次のとおりです。
formNameformPathsubmitIDformTypejcr:lastModifiedowner
search
(オプション)
フォームプロパティで指定した値で検索し、一致する値を持つフォームを返します。デフォルト値は "" です。

応答

応答オブジェクトには指定したフォームの詳細を含む JSON 配列が含まれています。応答の構造は次のとおりです。

{
total: "<送信の総数>",
items: [{ formName: "<フォームの名前>", formPath: "<フォームのパス>", owner: "<フォームの所有者>"},
....]}

要求 URL

http://[host]:[port]/content/forms/portal/submission.review.json?func=getAllSubmissions&formPath=/content/dam/formsanddocuments/forms-review/form2

応答

{"total":1,"items":[{"formName":"form2","formPath":"/content/dam/formsanddocuments/forms-review/form2","submitID":"1403037413508500","formType":"af","jcr:lastModified":"2015-11-05T17:52:32.243+05:30","owner":"admin"}]}

POST /content/forms/portal/submission.review.json?func=addComment

指定した送信インスタンスにコメントを追加します。

URL パラメーター

要求 URL で次のパラメーターを指定します。

パラメーター 説明
submitID 送信インスタンスに関連付けられているメタデータ ID を指定します。
Comment 指定した送信インスタンスに追加するコメントのテキストを指定します。

応答

コメントが正常に投稿されるとコメント ID を返します。

要求 URL

http://[host:[port]/content/forms/portal/submission.review.json?func=addComment&submitID=1403037413508500&comment=API+test+comment

応答

1403873422601300

GET /content/forms/portal/submission.review.json?func=getComments  

指定した送信インスタンスに投稿したすべてのコメントを返します。

URL パラメーター

要求 URL で次のパラメーターを指定します。

パラメーター 説明
submitID 送信インスタンスのメタデータ ID を指定します。

応答

応答オブジェクトには、指定した送信 ID に関連付けられているすべてのコメントを含む JSON 配列が含まれています。応答の構造は次のとおりです。

[{
owner: "<コメント作成者の名前>",
comment: "<コメントテキスト>",
time: "<コメントが投稿された時刻>"},
{ }......]

要求 URL

http://[host]:[port]/content/forms/portal/submission.review.json?func=getComments&submitID=1403037413508500

応答

[{"owner":"fr1","comment":"API test comment","time":1446726988250}]

POST /content/forms/portal/submission.review.json?func=updateSubmission

指定した送信済みフォームインスタンスの指定したプロパティの値を更新します。

URL パラメーター

要求 URL で次のパラメーターを指定します。

パラメーター 説明
submitID 送信インスタンスに関連付けられているメタデータ ID を指定します。
property 更新対象のフォームプロパティを指定します。
value 更新対象のフォームプロパティの値を指定します。

応答

投稿された更新に関する情報を持つ JSON オブジェクトを返します。

要求 URL

http://[host]:[port]/content/forms/portal/submission.review.json?func=updateSubmission&submitID=1403037413508500&value=sample_value&property=some_new_prop

応答

{"formName":"form2","owner":"admin","jcr:lastModified":1446727516593,"path":"/content/forms/fp/admin/submit/metadata/1403037413508500.html","submitID":"1403037413508500","status":"submitted"}

本作品は Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License によってライセンス許可を受けています。  Twitter™ および Facebook の投稿には、Creative Commons の規約内容は適用されません。

法律上の注意   |   プライバシーポリシー