Show Menu
화제×

양식 포털에서 제출된 양식을 사용한 작업 API

AEM Forms은 양식 포털을 통해 제출된 양식 데이터를 쿼리하는 데 사용할 수 있는 API를 제공합니다. 또한 이 문서에 설명된 API를 사용하여 의견을 게시하거나 제출된 양식의 속성을 업데이트할 수 있습니다.
API를 호출하는 사용자는 제출 검토자를 양식에 연결 에 설명된 대로 검토자 그룹에 추가해야 합니다 .

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

모든 자격 조건을 갖춘 양식 목록을 반환합니다.

URL parameters

이 API에는 추가 매개 변수가 필요하지 않습니다.

응답

응답 개체에는 양식 이름과 해당 저장소 경로를 포함하는 JSON 배열이 포함되어 있습니다. 응답의 구조는 다음과 같습니다.
[
 {formName: "<form name>",
 formPath: "<path to the form>" },
 {.....},
 ......]

요청 URL
https://[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 parameters

요청 URL에 다음 매개 변수를 지정합니다.
매개 변수 설명
formPath 양식이 있는 CRX 저장소 경로를 지정합니다. 양식 경로를 지정하지 않으면 빈 응답이 반환됩니다.
offset (옵션) 결과 세트의 인덱스의 시작점을 지정합니다. The default value is 0 .
limit (옵션) 결과 수를 제한합니다. The default value is 30 .
orderby (옵션) 결과 정렬 속성을 지정합니다. 기본값은 jcr:lastModified 로, 마지막 수정 시간을 기준으로 결과를 정렬합니다.
sort (옵션) 결과 정렬 순서를 지정합니다. 기본값은 결과를 내림차순으로 정렬하는 desc 입니다. 결과를 오름차순 asc 으로 정렬하도록 지정할 수 있습니다.
cutPoints (옵션) 결과에 포함할 양식 속성의 쉼표로 구분된 목록을 지정합니다. 기본 속성은 다음과 같습니다. formName , formPath , submitID , formType , jcr:lastModified , owner
search (옵션) 양식 속성에서 지정된 값을 검색하고 일치하는 값이 있는 양식을 반환합니다. The default value is "" .

응답

응답 개체에는 지정된 양식의 세부 사항을 포함하는 JSON 배열이 포함되어 있습니다. 응답의 구조는 다음과 같습니다.
{
 total: "<total number of submissions>",
 items: [{ formName: "<name of the form>", formPath: "<path to the form>", owner: "<owner of the form>"},
 ....]}

요청 URL
https://[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 parameters

요청 URL에 다음 매개 변수를 지정합니다.
매개 변수
설명
submitID
제출 인스턴스와 연결된 메타데이터 ID를 지정합니다.
Comment
지정된 제출 인스턴스에 추가할 주석 텍스트를 지정합니다.

응답

댓글을 성공적으로 게시할 때 댓글 ID를 반환합니다.

요청 URL
https://[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 parameters

요청 URL에 다음 매개 변수를 지정합니다.
매개 변수
설명
submitID
제출 인스턴스의 메타데이터 ID를 지정합니다.

응답

응답 개체에는 지정된 제출 ID와 관련된 모든 주석을 포함하는 JSON 배열이 포함되어 있습니다. 응답의 구조는 다음과 같습니다.
[{
 owner: "<name of the commenter>",
 comment: "<comment text>",
 time: "<time when the comment was posted>"},
 { }......]

요청 URL
https://[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=update제출

지정된 제출된 양식 인스턴스의 지정된 속성 값을 업데이트합니다.

URL parameters

요청 URL에 다음 매개 변수를 지정합니다.
매개 변수
설명
submitID
제출 인스턴스와 연결된 메타데이터 ID를 지정합니다.
property
업데이트할 양식 속성을 지정합니다.
value
업데이트할 양식 속성의 값을 지정합니다.

응답

게시된 업데이트에 대한 정보가 있는 JSON 개체를 반환합니다.

요청 URL
https://[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"}