Servicely Administration
Application Administration
Application Properties
6 min
application properties provide the ability to hold easy to maintain, configurable values that can provide the ability to separate and toggle functionality based on its value these properties can be used within code and also can be secured based on a user's role on who can edit them within the base platform this is used in a few places to provide the ability to turn on and off and change functionality without having to change the code that refers to it application properties create/update go to application properties by navigating to application > application > application properties the following are the fields you can populate when creating/updating a property field type example notes / description application property key string incident auto closure enabled the value that is used when referencing this property from within a script or within the system it needs to be unique for the whole platform property type string boolean the type of value this property holds available types include byte, locale, timezone, string, boolean, integer and long client side accessible boolean false this determines if the property can be accessed via client side scripts roles multiple reference \[role table] itsm administrator a user needs one of the following roles to be able to update this property if this is blank, it defaults to administrator note that it only provides the ability to update the value and no other fields application properties value string true the value of the application property that will be provided upon being accessed organization reference \[organization table] global the organization this is for as of the current version of the platform, this should be kept as global application reference \[application table] itsm the application that this property is a part of description string this property is used to flag whether or not the auto closure (resolved > closed) is active for incidents a description of what the property does, however has no functionality tied to it example how to access application properties application properties can be accessed both on server side by default and client side if the client side accessible flag has been set to true to access the property, there are different ways to access these properties depending on if it is server or client side server side when trying to access an application property on the server side, there is one way to access these properties these will return the application property value as a string these can be accessed as per below applicationpropertymanager getproperty(\<property name>) client side when trying to access an application on the server side, there are multiple ways to access properties if you are attempting to access a boolean property, you can use the following method to return the value in the boolean data type //only using 1 parameter will simply return the property or undefined user getbooleanproperty(\<property name>); //if you include both parameters and the property does not exist, the second parameter will be the default value where the property doesn't exist user getbooleanproperty(\<property name>, \<default value>); for any other properties, you can use the following method to return the value in the string data type //only using 1 parameter will simply return the property or undefined user getproperty(\<property name>); //if you include both parameters and the property does not exist, the second parameter will be the default value where the property doesn't exist user getproperty(\<property name>, \<default value>);