Difference between revisions of "InstalledApp Object"
(fixed an example that was formatted incorrectly and documented most of the updateSetting overloads.) |
|||
| Line 24: | Line 24: | ||
:;Example | :;Example | ||
| − | + | def appLabel = app.getLabel() | |
| − | log.debug "app label is ${appLabel}" | + | log.debug "app label is ${appLabel}" |
| − | |||
=== <code>updateLabel</code> === | === <code>updateLabel</code> === | ||
| Line 36: | Line 35: | ||
:;Parameters | :;Parameters | ||
::label - new label for installed app | ::label - new label for installed app | ||
| + | |||
| + | :;Returns | ||
| + | ::None | ||
| + | |||
| + | ===<code>updateSetting</code>=== | ||
| + | :Updates the value of a setting (preference) to the specified value. If the setting does not exist, this method will create it. | ||
| + | |||
| + | :;Signature | ||
| + | ::<code>void updateSetting(String name, Long value)</code> | ||
| + | ::<code>void updateSetting(String name, Boolean value)</code> | ||
| + | ::<code>void updateSetting(String name, String value)</code> | ||
| + | ::<code>void updateSetting(String name, Double value)</code> | ||
| + | ::<code>void updateSetting(String name, Date value)</code> | ||
| + | ::<code>void updateSetting(String name, List value)</code> | ||
| + | |||
| + | :;Parameters | ||
| + | ::name - The name of the setting to update | ||
| + | ::value - The value to store in the setting | ||
:;Returns | :;Returns | ||
| Line 42: | Line 59: | ||
== <code>Additional Methods to Document</code> == | == <code>Additional Methods to Document</code> == | ||
void updateSetting(String name, Map options) | void updateSetting(String name, Map options) | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
void removeSetting(String name) | void removeSetting(String name) | ||
void clearSetting(String name) | void clearSetting(String name) | ||
Revision as of 18:22, 5 April 2020
Contents
getInstallationState
- Returns a value indicating whether the app is currently installed or, if you are in the initial setup, that it is not.
- Signature
String getInstallationState()
- Parameters
- None
- Returns
COMPLETEif the app is installed, otherwiseINCOMPLETE.
getLabel
- Get the current label of the installed app.
- Signature
String getLabel()
- Parameters
- None
- Returns
- The current label of the installed app
- Example
def appLabel = app.getLabel()
log.debug "app label is ${appLabel}"
updateLabel
- Update the label of the installed app
- Signature
- void updateLabel(String label)
- Parameters
- label - new label for installed app
- Returns
- None
updateSetting
- Updates the value of a setting (preference) to the specified value. If the setting does not exist, this method will create it.
- Signature
void updateSetting(String name, Long value)void updateSetting(String name, Boolean value)void updateSetting(String name, String value)void updateSetting(String name, Double value)void updateSetting(String name, Date value)void updateSetting(String name, List value)
- Parameters
- name - The name of the setting to update
- value - The value to store in the setting
- Returns
- None
Additional Methods to Document
void updateSetting(String name, Map options) void removeSetting(String name) void clearSetting(String name) Long getId() Long getName() List<EventSubscriptionWrapper> getSubscriptions()