Services - Documentation Ametys

Forms are available from version 2.15.0 onwards

Form
My submissions
1. How it works
2. Setting
Dashboard
1. How it works
2. Setting

Several services are available for forms:

Form

The Form service displays a form.

The Form service can be inserted at the root of the sitemap. In this way, the service will be inherited on all subpages of the root.

Name	Description	Mandatory
Title	Service title	No
Form	Select the form to be displayed. A tree view with an open filter is available to facilitate selection. This tree view shows only correctly configured forms.	Yes
Submission	Page displayed after form submission. Redirect to a page with a standard message (Default) Redirect to the page selected below Staying on the same page	No
Redirect page (Available only if the value "Redirect to the page selected below" has been selected for Submission.)	Selects the page to be displayed once the form has been submitted. A tree view of pages is available to facilitate selection.	Yes
Submit in new window (Available only if the Submission property corresponds to a redirection to a page).	If the box is checked, a new window opens with the selected page. The user can then close the window and continue browsing.	No
Display	Defines how the form will be displayed by the service. Default Mini-survey (see definition below)	Yes

A mini-survey is a form containing a single "Choice list" field, limited to a single person .

If a form inserted via the service is modified and becomes misconfigured, the service is displayed as follows:

My submissions

The My Submissions service displays the current user's form submissions dashboard.

How it works

The service displays the list of submissions for the current user in a table, containing one row per submission and the following columns:

Form name
Submission date
Date of last update
Status (filled in if the form has a life cycle, empty otherwise)
History (filled in if the form has a life cycle, empty otherwise)

Clicking on the Form column opens a window containing the submission details:

Clicking on "View history" opens a window containing the submission status history:

Setting

Name	Description	Mandatory
Title	Dashboard title	No
Forms without life cycle	By checking this box, forms without a lifecycle will appear in the dashboard.	No
Display	Dashboard rendering	No

Dashboard

The Dashboard service displays a dashboard for processing various user requests.

How it works

The service displays a list of forms containing submissions to be processed.

Only forms with a life cycle are displayed by the service.

Once a form has been selected, the list of submissions for that form is displayed in a table containing one row per submission, and the following columns:

Input number
Data: click on the opens a window containing details of the submission (this is the same window as the My Submissions service)
Author
Submission date
Date of last update
Status
History: click on the opens a window containing the submission status history (the same window as the My Submissions service)
Actions: to change the status of the submission.

Setting

Name	Description	Mandatory
Title	Dashboard title	No
Data per page	Default value: 10	Yes
Display	Dashboard rendering	No