ALVAO Standard HW/SW Request Forms

Computer Requirements

• ALVAO Asset Management
• ALVAO Service Desk

Installation

Select the Enter activation key command in the ALVAO WA – Management – License menu and enter the activation key you obtain from your ALVAO system supplier.

On the server where the ALVAO WebApp application is installed, run the AlvaoStandardHWSWRequestForms.msi installation package and follow the Wizard instructions.

Creating the Request for HW Custom Form

Copy the Custom/Templates/StandardHwSwRequestForm/StandardHwSwRequestForm_Hw_NewTicket.cshtml file to the Custom/<functionality_name> folder and the Custom/Templates/StandardHwSwRequestForm/Code/StandardHwSwRequestForm_Hw_NewTicket.cs file to the Custom/<functionality_name>/Code/ folder. You can rename the files but both files (.cshtml and .cs) need to have the same file name.

1. Replace "Templates.StandardHwSwRequestForm" in the namespace at the beginning of the .cs file with the name of the functionality, i.e. Alvao.ServiceDesk.ServiceDeskWebApp.Custom.<functionality_name>.
2. If you renamed the .cs file, change the class name (at the beginning of the file next to the class keyword) to <file_name>Controller.

Devices Provided

First define the list of devices and categories, from which the users can select. We recommend to create "HW" folder in the "Object samples" folder; folders for individual categories in the "HW" folder; and the samples of devices provided will be provided in the categories folders.

E.g.:

1. [Object samples]
   1. [HW]
      1. [Notebooks ("Folder" kind)]
         1. [Lenovo ("Computer/notebook" type), (Property Users = "Managers")]
         2. [HP ("Computer/notebook" type)(Property Users = "Managers; Directors")]
      2. [PC ("Folder" type)]
         1. [Standard PC ("Computer/desktop" type), (Property Users = "Users")]
      3. [Monitors ("Folder" type)]
         1. [Standard monitor ("Monitor" type), (Property Users = "")]

Editing the Request for HW Form

You can edit the following variables values in the .cs file in front of the LoadPage() function beginning:

1. folderName – enter the folder name including the path in the tree, which contains individual categories of the provided devices, e.g. "Object samples/HW."
Tip:

We recommend to set the folderName variable on the "Object samples" folder or any of its sub-folders ("Object samples/HW").

2. categoryObjectKind – enter the objects kind representing categories, e.g. "Folder". Sub-object of those categories will be displayed in the form as provided devices. The objects not having the categoryObjectKind kind won't be displayed in the form as object categories (and their sub-objects won't display).
   Notification:

   The user can request any child of the object specified by the folderName and categoryObjectKind variables (i.e. even the object to which he/she wouldn't have access in the Asset Managment tree).
3. properties – list the properties names you want to be displayed for objects in the form. Separate the individual values by comma, e.g.: "Price, Name."
   Notification:

   You also have to edit the .cshtml file to display the properties. You can access the properties via their names written without diacritics (e.g. "Name").
4. userGroupProperty – specify the name of the property (e.g. "Users") which determines the name of a user group for objects. The objects are then visible only to the members of that group.
   Note:

   If the value is empty, the objects will be visible to all users.

Displaying the Device Picture in the Form

The form displays the HW pictures loaded form the Custom/images-AM/ folder. Every picture name must be the same as a name of the object found in the Asset Management tree. Therefore, for example, the "PC" object will use the Custom/images-AM/PC.jpg image. If the file does not exist, the picture is not displayed.

Creating the Request for SW Custom Form

Follow the same steps as when creating a custom HW request form, but use the Custom/Templates/StandardHwSwRequestForm/StandardHwSwRequestForm_Sw_NewTicket.cshtml and Custom/Templates/StandardHwSwRequestForm/Code/StandardHwSwRequestForm_Sw_NewTicket.cs files.

The form displays the software products being in the Approved status, please refer to product status.

In this form you can not set displaying pictures for individual products.

Service Settings

In the ALVAO WebApp – Management – Service Desk – Services, create a service (for example, IT/Request for a New HW) which will use the form, or use the existing one. Use one service for every form. Set the form of this service.

1. In the ALVAO WebApp – Management – Service Desk – Services in the service tree, select the service (IT/Request for a New HW) and use the Edit – Properties command.
2. Enter the address used by the request form, e.g. ~/Custom/<functionality_name>/<form_name>, in Custom form (URL) in the Service Catalog section.

Set the service process. You can use the existing process or create a new one.

Did not find what you were looking for? Ask our technical support team.