Introduction to Forms and Configuration Management
This portion of the MAS documentation deals with the "Forms" part of the MAS Web App. Before using forms, it is important to understand their purpose. MAS Forms are an integral part of MAS Configuration Management.
MAS Configuration Management is an organization tool for managing parameters. MAS Configuration Management is used to provide parameters to processes that have large numbers of parameters. A good example of this are the parameters used to provision a server, install database software, or use database features like Oracle datapump.
MAS Configuration Management consists of two distinct items: prototypes and forms.
Prototypes serve to define parameters needed for a particular process. Prototypes are defined outside of the MAS web user interface currently.
Once a prototype is defined for a particular process, it can be used to define one or more forms. The ultimate use of forms is as an input parameter to a process.
Creating Forms from Prototypes
Creating Forms from Prototypes with the Web App can be accomplished from the MAS Entities page, shown below.
Select the prototype you would like to use for the new form, and press "New Form". Enter a name for the new form, then enter all parameters for the form.
Note that the name of a form can only contain letters, numbers, or the underscore character. When all fields have been entered press "SAVE" to save the form
Editing, Copying, Deleting Forms
Within the entity section of MAS, press "FORMS" to view only forms. You can also search with a form by typing some part of the form name in the search box. Move the mouse cursor over a form to select it. Once a form is selected you can use the buttons to the right on the web form to edit an existing form, copy the form onto a new form, or delete a form. See the diagram below.
The "Copy" button will allow a new form to be created from an existing form. With this feature, you must specify a new form name, which includes its namespace. Be sure to save the form into a namespace where you have permissions. Form copy will copy all values from the form, and avoid the need to enter all fields on a form. This can greatly reduce the effort required to create a form. Once a form is copied, existing values can be changed as needed.
Once a form has been created, its values can be changed at any time, with the edit form feature described above. When you edit a form, its values can be changed. In the screenshot below, a form open for an Oracle datapump process.
Scroll through all fields on a form. Press "Close" when the form is complete.