The following sections explain how to add the three types of custom panels to the xMatters web server.
When creating custom pages and directories, it is recommended that you use lower-case characters only, and do not include any spaces in the folder name. This is important as different operating systems may not process white spaces and upper-case characters in the same way.
If you have multiple web servers, ensure that you synchronize the webserver/webapps/cocoon/alarmpoint/jsp directory across all of them.
When creating subscription domains there is an optional field that allows the user to specify a custom web page. This custom page will be used when users want to create subscriptions for that specific domain. This custom page is specified using a URL that is relative to the xMatters web application home directory.
A new JSP file can be stored anywhere in the webserver/webapps/cocoon/alarmpoint directory. For custom subscription panels, the recommended directory is:
webserver/webapps/cocoon/alarmpoint/jsp/subscription/custom
The path in the Custom Page URL field on the Subscription Domain details page must be relative to the webserver/webapps/cocoon/alarmpoint directory.
For example, if you create a new CustomSubscription.jsp file and store it in the webserver/webapps/cocoon/alarmpoint/jsp/subscription/custom/ folder, the Custom Page URL would be:
jsp/subscription/custom/CustomSubscription.jsp
Before developing custom messaging JSP panels, you must enter the information into the xMatters web application. Each custom messaging panel is associated to a single event domain, and there is a required field that allows the user to specify the name of the JSP page. The custom page is used to create messages for that specific domain. The required page URL is a relative path and file name based on the location of the file within the web application.
You cannot create a custom messaging panel using the Event Domain for Advanced Messaging.
On the Custom Messaging Panel Details page, the path in the Page URL field must be relative to the webserver/webapps/cocoon/alarmpoint/jsp/custom directory.
For example, if you create a new CustomMessaging.jsp file and store it in the webserver/webapps/cocoon/alarmpoint/jsp/custom/mypages folder, the Page URL would be:
mypages/CustomMessaging.jsp
You can create a messaging panel for use on another Event Domain by copying and editing the default Quick Message Panel.
For more information, see the xMatters installation and administration guide.
On the Custom Page Details page, the path in the Page URL field must be relative to the webserver/webapps/cocoon/alarmpoint directory.
For example, if you create a new CustomPage.jsp file and store it in the webserver/webapps/cocoon/alarmpoint/jsp/custom/mypages/folder, the Page URL would be:
jsp/custom/mypages/CustomPage.jsp
If you have multiple web servers, synchronize the webserver/webapps/cocoon/alarmpoint/jsp directory across all of them.