Skip to main content
EMS Software, LLC

Customizing Virtual EMS

After you have installed Virtual EMS you can customize many aspects of it. You can change the “look and feel” of Virtual EMS by inserting your own logo. Experienced web developers can also modify the system’s style sheet to change fonts and colors.  For information on how to configure Virtual EMS, define help text for various pages or re-label menus, please refer to your EMS Setup Guide.

Important:  Do not alter any of the Virtual EMS web page files themselves. The maintenance agreement for Virtual EMS extends to the original page content only.

Logo

The logo that appears in the upper left corner of all pages within Virtual EMS comes from a file named LOGO.GIF, which is found in the \VirtualEMS\Images folder. If you choose to have the system display a different logo, create a new file called CUSTOMLOGO.GIF in that folder. If the system detects this file, it will use it rather than the default file. The advantage of creating the new file instead of simply replacing the LOGO.GIF file is that in an upgrade to a new version of Virtual EMS the LOGO.GIF file is overwritten, whereas CUSTOMLOGO.GIF is not.

The system will accept nearly any size logo image, but you should avoid images more than 200 pixels wide and images that are too tall, to avoid extra scrolling. If you create a custom logo file, you may need clear your browser’s cache before you see the new image.

Style Sheets

Experienced web developers are welcome to modify the look and feel of Virtual EMS using a custom style sheet, which controls fonts and colors throughout the application. To do so, name your custom style sheet CUSTOM.CSS and place it in the \VirtualEMS\Styles directory. If the system detects this file, it will use the styles found there rather than those in the system’s default style sheet, VEMS.CSS. Create the CUSTOM.CSS style sheet rather than modifying VEMS.CSS, since VEMS.CSS may be overwritten whenever new versions of the software are installed.

To Customize Links

The Virtual EMS Browse Events page allows web users to view all public events scheduled in EMS. Users have the option to manually filter this list of events by facility, room, event type, event name or group name.  Virtual EMS contains functionality to create a custom Browse Events link (i.e. URL) that when accessed, pre-filters the event listing displayed to a specific building, event type, client, etc. To create a Custom Link, please follow the steps outlined below.

  1. Log into Virtual EMS using a web user ID that belongs to a Web Security Template containing the Web Administrator Role.  For information on how to configure a web user and/or Web Security Template, please refer to your EMS Setup Guide.
  2. Under the Admin menu, click Generate Custom Link.

  1. Indicate whether or not Display On Web settings should be ignored. This setting is available on various configuration items in EMS (e.g. event type, status, etc.) to intentionally hide events from public view.
  2. Select your Filter Type.
  3. The results displayed in the Select Item dropdown will reset based on the Filter Type selected. Pick a value in the Select Item dropdown.
  4. Select your Display Format.
  5. To display a custom logo that is different than the default logo used for your Virtual EMS site, enter the logo name in the Logo field. The logo will need to exist within the Virtual EMS physical directory on your web server (typically C:\inetpub\wwwroot\VirtualEMS\).
  6. To display a custom title, enter a value in the Title field.
  7. To collapse booking information so that only the reservation information is displayed, select the Roll Up To Reservation option. 

 

Roll Up To Reservation Enabled

 

Roll Up To Reservation Disabled

  1. Click the Generate Link button to display a friendly URL and HTML code that can be added to a web page.  The URL can also be used to test your Custom Link.

To Customize JavaScript

With custom JavaScript, you can extend the functionality of Virtual EMS to suit your business needs.  Please keep in mind that including custom JavaScript on Virtual EMS pages can affect performance.

When VEMS receives a request for a page, it checks for the existence of a CustomJs folder. If the folder exists, VEMS checks for any files that match the name of the page. For instance, on the RoomRequest.aspx page, if there is a file called RoomRequest.js in the CustomJs folder, VEMS will include the RoomRequest.js file on the page. 

In addition to the name-matched file, VEMS will also check for and include the file named global.js on EVERY page. Follow the below steps to enable custom JavaScript

Perform the following steps to enable Custom JavaScript:

  1. Enable Custom JavaScript. Open the VEMS web.config file (i.e., C:\inetpub\wwwroot\VirtualEms\web.config).
    1. Locate the following node under the <appSettings> node

i.<add key="allowCustomJs" value="false" />

  1. Change the false value to true.
  2. Save the file.
  3. Create the CustomJs folder within the root of you VEMS Install Directory (i.e., C:\inetpub\wwwroot\VirtualEms\CustomJs).

You are now ready to implement your Custom JavaScript. There are a couple of options:

  • In the newly created CustomJs folder, create a file for each of the above pages you wish to include your custom JavaScript on (such as RoomRequest.js, EditReservation.js, or Default.js).
  • In the newly created CustomJs folder, create one file called global.js that will be included on every page in the system.

Your custom JavaScript should be included on global.js OR on each of the applicable page-specific JavaScript files.  If you include the script in both places, it could cause problems.