Request Form Examples

auto fill employee address information this example illustrates the use of default values to auto fill address information for an employee using values that reference the employee business object from a validation list create a request form with employee address information that includes the following fields a drop down list control to select an employee name from a pick list a text field that shows the email address of the selected employee a text field that shows the street address of the selected employee a text field that shows the city of the selected employee a text field that shows the state of the selected employee address change request form click the edit icon next to the employee name control the item configuration editor opens expand pick list , then enter your parameters sample employee validation list field description validation list check this option validation list to use choose employees or employeebydepartment from the drop down list title field choose display name from the drop down list under cascading validation definition department choose department from the drop down list field choose department name from the drop down list click ok the window closes click the edit icon next to the employee email control the item configuration editor opens expand default value , then enter your parameters sample email employee edit field description expression check this option triggered by choose employee name from the drop down list expression field enter the following into this field \[frs compositecontract contact# servicereqassociatedcustomer]primaryemail click ok the window closes repeat the last procedure to configure the remaining text controls (you may want to set the text controls as read only so that the default values cannot be overwritten ) address city state when you create a record from the service catalog and specify the employee name, the address information is automatically filled in specifying control visibility you can specify whether a control is visible all of the time, none of the time, or part of the time based on an expression you can specify that a field is not visible when you do not require user input, but you need to use the field for workflow fulfillment within the item configuration editor , expand the visible area choose an option option description yes the field is always visible no the field is never visible (that is, it is not used on the form) this setting is typically used for test or temporary fields that should not be shown to end users expression enter an expression or choose an object from the field list to use as the basis for dynamically setting visibility for example, to use the computer type field of the current form to control whether the current control is visible, navigate to this form > computer type in the navigation area and double click computer type edit the resulting expression so that it evaluates to true or false as necessary for your requirements the control is visible when the expression evaluates to true see about expressions docid 0eih f97oc4pmanhy9f29 for more information click ok the window closes specifying a unique id for a control to specify a unique id for a control to be referenced programmatically within the item configuration editor , expand the properties area and enter a unique id in the unique id field click ok sample unique id the system automatically generates a unique id for all form controls the configuration described here changes the generated value to a value of your choice any values that you specify must be unique within the request form making a control read only to make a control read only, within the item configuration editor, expand the read only area and select yes click ok read only option this control is often used with a default value based on an expression for example, you can configure a control as follows so that it is read only and contains the cost center information for a user by default control type text field read only yes default value expression triggered by a drop down list field called recipient expression $(\[profile#employee ]costcentre) specifying a required field you can specify whether a field enforces required input always, never, or sometimes based on an expression within the item configuration editor , expand the required area choose an option option description yes the field is always required no the field is never required expression enter an expression or choose an object from the field list to use as the basis for dynamically setting requirements see about expressions docid 0eih f97oc4pmanhy9f29 for more information click ok the window closes specifying a field type (text or number) and numeric constraints when you use the text, number, or money field control, you must specify whether the field data type is alpha numeric, numeric only, or money for numeric fields, you can optionally set upper and lower boundaries for responses within the item configuration editor for a text, number, or mask control, expand the field options area field type control choose an option from the type drop down list option description alpha numeric formats text fields number formats generic number fields for enter minimum and maximum value constraints for this field , enter numbers to constrain the minimum and maximum field response values with the following results the value entered in the minimum field is displayed as the default value a value is now required and must be entered by a user (or the default value is used) the value entered must conform to and fall within the minimum and maximum settings money formats fields containing currency values the minimum and maximum fields appear enter numbers to constrain response values (optional) phone number automatically formats numbers to phone numbers, such as +1 408 555 1212 social security number automatically formats numbers to social security numbers, such as 123 45 6789 email allows users to enter an email address, such as contact\@heatsoftware com mac address allows users to enter a mac address, such as 00 1c \ b3 09 85 15 url allows users to enter a url address, such as http //www ivanti com click ok the window closes specifying field options you can specify a number of field options including adding an advanced search option to a field to specify the field width, and maximum number of characters allowed in character based fields, do the following within the item configuration editor , expand the field options area in the field width field, specify a maximum width for the field in pixels in the max length field, set a character value up to 3000 in some cases the maximum number of characters will depend on the field for which this limit is specified, and the field width that was set some controls (such as text area) also let you specify a maximum field height (measured in characters) if a field height field displays, specify a maximum character value between 50 and 3000 the system warns the user when the number of characters entered in the text field exceeds the specified settings some controls allow you to specify the type of characters that can be entered select from the choices available in the list field options text area control click ok the window closes specifying an advanced search option you can specify an advanced search option from the field options control for any drop down field specifying this option inserts a search icon into a field clicking the icon opens a window with the available search criteria you can also specify the minimum number of characters that need to be entered before the search is activated select one of the following with advanced search window a checkbox to implement the search and display a search icon in the field minimum type ahead chars a checkbox to specify the minimum number of characters that must be entered before the search is available setting the minimum character entry will also help to restrict the search results the following conditions must be met before this option is available and usable the pick list validation list option within the item configuration editor must be configured a specific validation list must be selected for the validation list to use option the search can only be run against the selected validation list optionally, the drop down may be dependent on data in another field before the search is activated for example if the employee name field is dependent on a prior department field, then you must select a department before the validation list to match an employee is available in this instance the field may appear in red until the appropriate selections have been made specifying response value boundaries to set upper and lower boundaries for date, time, datetime, and text, money, and mask fields, do the following within the item configuration editor of a date, time, datetime, text, money, or mask field, expand the field options area sample date control boundaries expand the lower bound area in the first field, select none to specify no boundary or >= to set a lower boundary if you specified >= in the first field, go to the second field and select a value items in parentheses are date and time functions items not in parentheses are other fields on the form other fields are displayed only if they match the current field type for example, if a date field is being configured, only other date fields are included in the list for datetime fields only, you can specify the time component for a range for date fields and time fields, you can set only date and time, respectively repeat for the upper bound area click ok the window closes adding a dividing line between sections to insert a dividing line beneath a category heading within the item configuration editor for a category heading control, expand the field options area sample category heading control check show a dividing line with this category section click ok the window closes displaying categories on separate form pages to view a category within its own page in a form, do the following check create a new page with the category click ok a request form with navigation controls is created indenting a field to indent a field, do the following in the item configuration editor , expand the field options area check indent this field on the form click ok allowing users to attach files to provide a form control that allows users to attach files when filling out a service catalog form in the item configuration editor of an upload attachments control, expand the field options area upload attachments control specify the maximum attachment file size, number of files, and allowed file types optional enter a description to show in the form to allow pasting attachments from the clipboard, check can copy data from clipboard depending on how you configure the control, it will be similar when shown in a service catalog form control configurable items category heading adds a dividing line displays the category on a separate form page (that is, create a multi page form) check box adds a default value adds a price sets the visibility of the control (that is, make the control visible or invisible based on certain conditions) requires a response makes the control read only text or number or mask field adds a default value specifies numeric or alphanumeric response data type sets the visibility of the control requires a response makes the control read only text area adds a default value sets the visibility of the control requires a response makes the control read only drop down list adds a default value adds a pick list sets the visibility of the control requires a response makes the control read only date field adds a default value adds upper and lower value boundaries sets the visibility of the control requires a response makes the control read only datetime field adds a default value adds upper and lower value boundaries sets the visibility of the control requires a response makes the control read only time field adds a default value adds upper and lower value boundaries sets the visibility of the control requires a response makes the control read only image selects the image file to make an image file available for selection, you must first upload it as an attachment through the attachments tab in the form designer tools pane specifies image size adds a border sets the visibility of the control requires a response makes the control read only optional to change to a two or three column layout, click choose a style and select a new layout by default, forms use a single column layout after completing a draft of the form, click preview to see how it will look when a user in the self service portal opens it in the service catalog to make further changes, repeat any of the steps in this section click next or click the 3 plan request fulfillment tab to go to configuring the request offering entering a default value based on trigger conditions to provide a default value for a field, for example entering data when a checkbox is checked, you can edit the request offering form as follows log in to as a open the request offerings workspace open an offering with a checkbox that requires a default response when the box is checked insert a text, number, or mask field under the checkbox control by dragging it to the layout click the edit icon to configure the text field in the item configuration editor as follows a click default value and select expression b at the triggered by drop down list, select the name of the checkbox c enter an expression or text (delimited by " ") into the field d click next to move to the next dialog box, or save or save and exit to save the change