Configure Form Space Properties

   Journey Manager (JM) The transaction engine for the platform. |   System Manager / DevOps |  23.04This feature was updated in 23.04

Manager comes with a set of standard form space properties that can be applied to all spaces that are created in this Manager instance. These properties have default values that can be configured via the Properties and Properties Edit tabs. You can use form spaces properties to override organization's properties. Subsequently, you can create form's properties to override the form space's properties.

Manager automatically sends emails to form users to notify the form has been changed. You can adjust the email format using the settings below.

To configure the properties in the Properties tab:

1. Select Forms > Form Spaces.
2. Locate a form space and then click Edit.
3. Select the Properties tab.
4. Click Edit to configure the selected property. Check the standard properties to learn more about their functionality.
5. Edit the value of the property.
6. Click Save to update the changes.

To configure form space properties in the Properties Edit tab:

1. Select Forms > Form Spaces.
2. Locate a form space and click Edit.
3. Select the Properties Edit tab to view and edit properties. Check the standard properties to learn more about their functionality.

   

4. Edit Account Locked Message, which is a message displayed at login to users whose accounts are locked.
5. Select the Account Quick Lists Enabled checkbox to show Account Home Page quick selection lists and Tasks menu count. Note enabling this option can impact performance.
6. Select the Allow Form Cancel checkbox to allow users to cancel a submission at the payment stage.
7. Select the Allow Form Retry checkbox to allow users to go back to the form if payment has not been completed yet.
8. Select the Allow XML Redirect Target checkbox to allow XML form data to specify redirect target.
9. Select the Allow XML Request Param Form Prefill checkbox to allow XML request parameters, such as xmlData and schemaSeed, to be used in form prefill.
10. Edit a timeout for an anonymous user to access submitted form receipts in the Anonymous Submission Access Timeout field. After an anonymous user submits a form, Manager sends them a URL link to download a form receipt. This link will timeout after the Anonymous Submission Access Timeout period. However, if the user accesses the URL link using the same user agentUser agent is software (a software agent) that is acting on behalf of a user. One common use of the term refers to a web browser that retrieves, renders and facilitates end user interaction with Web content. (browser) with the same IP addressIP address is a unique string of numbers separated by full stops that identifies each computer using the Internet Protocol to communicate over a network., this timeout doesn't apply, because Manager re-establishes a session. In this case, the user can access the form receipt multiple times without any time restrictions. The default timeout is 15 min.
    Note

    Check the Session Timeout option of a Security Manager used by the form space to adjust time after which a user session times out.

    Alternatively, you can implement session expiry within the form logic itself independently of Manager.

11. Edit CDN Server URL - Optional CDN Server URL for caching static content.
12. Edit CORS Headers.
13. Select the CSRF Protection Host Check checkbox to enable Cross Site Request Forgery (CSRFCross-site request forgery (CSRF), also known as one-click attack or session riding, is a type of malicious exploit of a website where unauthorized commands are transmitted from a user that the web application trusts.) protection by validating the host name in a request.
14. Select the CSRF Protection checkbox to enable CSRF protection by using an the extra token in a request.  |  21.11 This feature was introduced in 21.11.
    Note

    You must restart a Manager server or re-deploy a form space for the change to take effect.

15. Edit Datetime Format used in the date pickers.
16. Edit Email 2FA Message - an email message, which is sent to a user, for 2FATwo-factor authentication (2FA), sometimes referred to as two-step verification or dual factor authentication, is a security process in which the user provides two different authentication factors to verify themselves to better protect both the user's credentials and the resources the user can access. Two-factor authentication provides a higher level of assurance than authentication methods that depend on single-factor authentication (SFA), in which the user provides only one factor -- typically a password or passcode. Two-factor authentication methods rely on users providing a password as well as a second factor, usually either a security token or a biometric factor like a fingerprint or facial scan. user account enrolment.
17. Edit Email 2FA Subject - an email subject, which is sent to a user, for 2FA user account enrolment.
18. Edit Email Form Receipt Message - an email message for form confirmation or receipt email.
19. Edit Email Form Receipt Subject - to change an email subject for form confirmation or receipt email.
20. Edit Email Lost Password Message - a lost password reset email message.
21. Edit Email Lost Password Subject - a lost password reset email subject.
22. Edit Email Saved Form Message - an email message for user saved form email.
23. Edit Email Saved Form Subject - an email subject for user saved form email.
24. Edit Email Sender Address that is a sender email address for generated emails and save challenge validations. It overrides the global email sender address, which is configured on an organization's level. For more information, see Configure Organization Properties.
    Note

    Make sure the address is correct so the SMTP server won't throw errors.

    Note

    You can overrides this email address on a form's level by adding the Email Sender Address property to a form version.

25. Edit Email Share Form Message - an email message for user shared form email.
26. Edit Email Share Form Subject - an email Share Form Subject.
27. Edit Email Submission Status Message - an email message for submission processing status update.
28. Edit Email Submission Status Subject - an email subject for submission processing status update, for example, ${submission.formName} Update.
29. Edit Email Task Notification Message - an email message for task notification.
30. Edit Email Task Notification Subject - an email subject for task notification.
31. Edit Email Template HTML - an email border template HTML.
32. Edit Email Template Mode - the location of the email HTML border template to use.
33. Edit Form Terms And Conditions - the form Terms and Conditions statement the user must accept before accessing the form.
34. Edit Google API Key - Google API Services Access Key.
35. Edit Max Save Challenge Requests, default 3, which is the maximum number of save challenge requests that can be performed when returning to a saved form before a user is locked out. This maximum is inclusive of any attempts from other sessions for the same submission.
36. Select the Require Client Key checkbox to append a client key of an organization, where the form is deployed, to a form render URL. This prevents unauthorized access to a rendered form when a hacker guesses a form code and uses it to generate a valid URL.  |  23.04 This feature was introduced in 23.04
    Warning

    If there is a missing or mismatching client key in the URL, Manager displays the Form Not Found error page with The form you are looking for could not be found. Please check the form name and try again. error message.

37. Edit Save Challenge Lockout Minutes, default 15, which is the duration in minutes a submission is locked out when the maximum number of save challenge requests has been exceeded, as per the Max Save Challenge Requests property. If the Save Challenge Lockout Minutes is set to 0, then the submission is permanently locked out, which requires an administrator to manually unlock this submission.
    Note

    You can also configure the Save Challenge Lockout Minutes property in a form version to override this form space level's property.  |  21.05 This feature was introduced in 21.05.

38. Select the Search Filter Group Select checkbox to enable the Groups dropdown list in the Journey Space Tasks and History tabs. This is the default option.
39. Select the Search Consistent Read checkbox to search using database Consistent Read in the Task List, History, Reviews and Help Desk pages.
40. Select the Search Data Extracts checkbox to search for the Submission Data extracts in Task List, History, Reviews and Help Desk pages.
41. Select a data load type from the Search Data Load dropdown list, such as Eager Data Load or Lazy Data Load, to apply to certain portal pages (Help Desk). If "Lazy Data Load" is used, the page will not attempt to load result data on initial access, instead waiting for the user to initiate a search. This can help with performance on systems with large transaction volumes. "Eager Data Load" means that the page will automatically load data when initially accessed.
42. Select the search results fetch limit for the Task List, History, Reviews and Help Desk pages from the Search Fetch Limit dropdown list. Default is 200.
43. Select the Search Filter Group Select checkbox to show the Group Select in the Search Filter on Task, History pages.
44. Select the Search Filter Jobs by User Org checkbox to enable the Job Groups dropdown list in the Journey Space Reviews tab and allows only job coordinators to see collaboration jobs that they are responsible for.
45. Select the default Search Period for the Help Desk pages from the Search Period Help Desk dropdown list.
46. Select the default Search Period for the History pages from the Search Period History dropdown list.
47. Select the default Search Period for the Reviews pages from the Search Period Reviews dropdown list.
48. Select the default Search Period for the Task List pages from the Search Period Tasks dropdown list.
49. Select the Search Task Attributes checkbox to search for the Task attributes Subject, Message and Address in the Task List and History pages.
50. Edit Server Busy Redirect URL - external resource URL to redirect users to if the server is too busy to handle the form request. The default is the Server Busy form space page.
51. Select the Use Email for Login checkbox to use the email address as the user login name for Local Manager user accounts. It's not selected by default.
52. Edit User Account Creation URL to specify an alternative user create account URL.
53. Edit Welcome Page URL - the default welcome page URL, such as index.htm.
54. Edit X-Frame-Options.
55. Click Save to update the changes.

To create a new form space property in the Properties Edit tab:

1. Select Forms > Form Spaces.
2. Locate a form space and click Edit.
3. Click New to create a new property.
4. Provide a property unique name in the Name field.
5. Select a property type from the Type dropdown list.
6. Click Save to update the changes.

Next, learn how to a configure form space email template.