Jump to: navigation, search
(Created target blank page For Version: HTCC:9.0.0)
 
(Update with the copy of version: 9.0.0DRAFT)
Line 1: Line 1:
−
<!-- Creation of the target page -->
+
= System Namespace=
 +
__TOC__
 +
==Methods==
 +
The System namespace includes the following methods:
 +
* [[SystemNamespace#getAllowedServices|getAllowedServices]]
 +
* [[SystemNamespace#triggerActivity|triggerActivity]]
 +
* [[SystemNamespace#closeToast|closeToast]]
 +
* [[SystemNamespace#popupToast|popupToast]]
 +
* [[SystemNamespace#updateToast|updateToast]]
 +
 
 +
===getAllowedServices===
 +
{|
 +
! Signature
 +
| <static> getAllowedServices() → {Array.<string>}
 +
|-
 +
! Description
 +
| Gets the list of allowed services, as determined by the [[ServiceClientAPI#Security_Configuration|Security Configuration]]. If the domain of the web application that calls this method isn't listed in the [[Documentation:HTCC:IWWDep:ServiceClientAPI#service-client-api.accepted-web-content-origins|service-client-api.accepted-web-content-origins]] option, then this method fails.
 +
|-
 +
! Returns
 +
| Array.<string>
 +
|}
 +
 
 +
===triggerActivity===
 +
{|
 +
! Signature
 +
| <static> triggerActivity()
 +
|-
 +
! Description
 +
| Triggers a fake activity to prevent the [[Documentation:HTCC:IWWDep:Security#security.inactivity-timeout|inactivity timer]] from closing the agent session.
 +
|}
 +
 
 +
===popupToast===
 +
 
 +
{|
 +
! Signature
 +
| <static> popupToast(parameters) → {string}
 +
|-
 +
! Description
 +
| Pops up a new custom toast.
 +
|-
 +
! Parameters
 +
|
 +
{|
 +
! Name
 +
! Type
 +
! Description
 +
|-
 +
| title
 +
| string
 +
| The title
 +
|-
 +
| iconUrl
 +
| string
 +
| The URL of the icon you want to display in the title bar of the custom toast popup.
 +
|-
 +
| subject
 +
| string
 +
| Optional. The subject
 +
|-
 +
| message
 +
| string
 +
| Optional. The message
 +
|-
 +
| keyValues
 +
| string
 +
| Optional. JSON object used to fill the key value pair list. For example: <tt>{"key1" ; "value one","key2" ; "value two","key3" ; "value three"}</tt>.
 +
|-
 +
| buttons
 +
| Array.<string>
 +
| Optional. Each character string in this array becomes a button.
 +
|-
 +
| buttonShowDismiss
 +
| boolean
 +
| Optional.  If set to <tt>true</tt>, displays the '''Show''' and '''Dismiss''' buttons and pops up the current iframe if the '''Show''' button is pushed. If set to <tt>false</tt> , displays '"OK"' or custom buttons based on the parameter's buttons.
 +
|-
 +
| autoCloseTimeout
 +
| object
 +
| Optional. If set to greater than <tt>0</tt>, the popup is automatically closed after the specified milliseconds.
 +
|-
 +
| sendToMyMessage
 +
| object
 +
| Optional. If set to <tt>true</tt>, sends the '''subject''', '''iconUrl''', '''title''', '''keyValues''', and  '''message''' parameters to the '''MyMessage''' panel.
 +
|}
 +
|-
 +
! Returns
 +
| A unique identifier
 +
|}
 +
 
 +
===updateToast===
 +
 
 +
{|
 +
! Signature
 +
| <static> updateToast(id, parameters) → {boolean}
 +
|-
 +
! Description
 +
| Updates the specified toast.
 +
|-
 +
! Parameters
 +
|
 +
{|
 +
! Name
 +
! Type
 +
! Description
 +
|-
 +
| id
 +
| string
 +
| The identifier of the toast to update. The identifier is returned by the [[SystemNamespace#popupToast|popupToast]] method.
 +
|-
 +
| parameters
 +
| object
 +
|
 +
{| border="1"
 +
|-
 +
! Name
 +
! Type
 +
! Description
 +
|-
 +
| title
 +
| string
 +
| The title
 +
|-
 +
| iconURL
 +
| string
 +
| The URL of the icon you want to display in the title bar of the custom toast popup.
 +
|-
 +
| subject
 +
| string
 +
| Optional. The subject.
 +
|-
 +
| message
 +
| string
 +
| Optional. The subject.
 +
|-
 +
| keyValues
 +
| object
 +
| Optional. JSON object used to fill the key value pair list. For example: <tt>{"key1" : "value one","key2" : "value two","key3" : "value three"}</tt>.
 +
|-
 +
| buttons
 +
| Array.<string>
 +
| Each character string in this array becomes a button.
 +
|-
 +
| buttonShowDismiss
 +
| boolean
 +
| If  set to <tt>true</tt>, displays '''Show''' and '''Dismiss''' buttons and pops up the current iframe if the '''Show'''  button is pushed. If set to <tt>false</tt>,  displays '"OK"' or custom buttons based on the parameter's buttons.
 +
|}
 +
|}
 +
|-
 +
!Returns
 +
| <tt>true</tt> if the toast has been updated; <tt>false</tt> if the toast identifier has not been found.
 +
|}
 +
 
 +
===closeToast===
 +
 
 +
{|
 +
! Signature
 +
| <static> closeToast(id) → {boolean}
 +
|-
 +
! Description
 +
| Closes the specified toast.
 +
|-
 +
! Parameters
 +
|
 +
{|
 +
! Name
 +
! Type
 +
! Description
 +
|-
 +
| id
 +
| string
 +
| The identifier of the toast to close. The identifier is returned by the [[SystemNamespace#popupToast|popupToast]] method.
 +
|}
 +
|-
 +
!Returns
 +
| <tt>true</tt> if the toast has been updated; <tt>false</tt> if the toast identifier has not been found.
 +
|}
 +
 
 +
 
 +
 
 +
[[Category:V:HTCC:9.0.0]]

Revision as of 14:07, March 14, 2019

System Namespace

Methods

The System namespace includes the following methods:

getAllowedServices

Signature <static> getAllowedServices() → {Array.<string>}
Description Gets the list of allowed services, as determined by the Security Configuration. If the domain of the web application that calls this method isn't listed in the service-client-api.accepted-web-content-origins option, then this method fails.
Returns Array.<string>

triggerActivity

Signature <static> triggerActivity()
Description Triggers a fake activity to prevent the inactivity timer from closing the agent session.

popupToast

Signature <static> popupToast(parameters) → {string}
Description Pops up a new custom toast.
Parameters
Name Type Description
title string The title
iconUrl string The URL of the icon you want to display in the title bar of the custom toast popup.
subject string Optional. The subject
message string Optional. The message
keyValues string Optional. JSON object used to fill the key value pair list. For example: {"key1" ; "value one","key2" ; "value two","key3" ; "value three"}.
buttons Array.<string> Optional. Each character string in this array becomes a button.
buttonShowDismiss boolean Optional. If set to true, displays the Show and Dismiss buttons and pops up the current iframe if the Show button is pushed. If set to false , displays '"OK"' or custom buttons based on the parameter's buttons.
autoCloseTimeout object Optional. If set to greater than 0, the popup is automatically closed after the specified milliseconds.
sendToMyMessage object Optional. If set to true, sends the subject, iconUrl, title, keyValues, and message parameters to the MyMessage panel.
Returns A unique identifier

updateToast

Signature <static> updateToast(id, parameters) → {boolean}
Description Updates the specified toast.
Parameters
Name Type Description
id string The identifier of the toast to update. The identifier is returned by the popupToast method.
parameters object
Name Type Description
title string The title
iconURL string The URL of the icon you want to display in the title bar of the custom toast popup.
subject string Optional. The subject.
message string Optional. The subject.
keyValues object Optional. JSON object used to fill the key value pair list. For example: {"key1" : "value one","key2" : "value two","key3" : "value three"}.
buttons Array.<string> Each character string in this array becomes a button.
buttonShowDismiss boolean If set to true, displays Show and Dismiss buttons and pops up the current iframe if the Show button is pushed. If set to false, displays '"OK"' or custom buttons based on the parameter's buttons.
Returns true if the toast has been updated; false if the toast identifier has not been found.

closeToast

Signature <static> closeToast(id) → {boolean}
Description Closes the specified toast.
Parameters
Name Type Description
id string The identifier of the toast to close. The identifier is returned by the popupToast method.
Returns true if the toast has been updated; false if the toast identifier has not been found.
Comments or questions about this documentation? Contact us for support!