Difference between revisions of "New Function Wizard"

From PresenceWiki
Jump to: navigation, search
(Create Function)
 
Line 6: Line 6:
 
=== Class name and Description ===
 
=== Class name and Description ===
  
http://www.international-presence.com/wikidocs/images/function_wiz_1.png
+
[[file:function_wiz_1.png]]
  
 
The Class name refers to the fully qualified name of the Java class that contains the execution code for the new Function. Function classes must extend the abstract class com.internationalpresence.exec.FunctionAbstract.
 
The Class name refers to the fully qualified name of the Java class that contains the execution code for the new Function. Function classes must extend the abstract class com.internationalpresence.exec.FunctionAbstract.
Line 12: Line 12:
 
Clicking the "Browse" button launches the Presence [[Jar Manager]] where you can import a Java archive (jar) file or select an existing class from previously imported jars:
 
Clicking the "Browse" button launches the Presence [[Jar Manager]] where you can import a Java archive (jar) file or select an existing class from previously imported jars:
  
http://www.international-presence.com/wikidocs/images/function_jar_man.png
+
[[file:function_jar_man.png]]
  
 
The Function Description should contain:
 
The Function Description should contain:
Line 24: Line 24:
 
=== Specify Function Syntax ===
 
=== Specify Function Syntax ===
  
http://www.international-presence.com/wikidocs/images/function_wiz_2.png
+
[[file:function_wiz_2.png]]
  
 
Here you should specify the command that should be associated with the new Function and the expected parameters.
 
Here you should specify the command that should be associated with the new Function and the expected parameters.
Line 34: Line 34:
 
=== Create Function ===
 
=== Create Function ===
  
http://www.international-presence.com/wikidocs/images/function_wiz_3.png
+
[[file:function_wiz_3.png]]
  
 
Clicking "Next" will show a summary of the information about the function.
 
Clicking "Next" will show a summary of the information about the function.

Latest revision as of 12:32, 20 August 2015

Administration Client > New Function Wizard


The New Function Wizard guides you through the process of registering a new Presence Function. To access the New Function Wizard first launch the Function Manager then right-click in the Functions list and select "Create New" from the pop-up menu that appears.

Class name and Description

Function wiz 1.png

The Class name refers to the fully qualified name of the Java class that contains the execution code for the new Function. Function classes must extend the abstract class com.internationalpresence.exec.FunctionAbstract.

Clicking the "Browse" button launches the Presence Jar Manager where you can import a Java archive (jar) file or select an existing class from previously imported jars:

Function jar man.png

The Function Description should contain:

  • Explanation of function's purpose
  • Syntax
  • Usage instructions

The Function Group determines where the Function is placed in the list on the Function Manager.

Specify Function Syntax

Function wiz 2.png

Here you should specify the command that should be associated with the new Function and the expected parameters.

The command should not include the ampersand marker (&) which identifies a function.

To add a parameter, select the expected type (String, Integer, Float, Long), enter a default value (this will appear when the user selects the function from the suggestion provider). If the parameter can be recurring make sure the checkbox labelled "Can this parameter be recurring?" is selected. Click "Add" to add the parameter to the list on the right.

Create Function

Function wiz 3.png

Clicking "Next" will show a summary of the information about the function.

After clicking "Finish" the Function will be created, after which it can be called from (just about) anywhere within Presence.


Architecture > Administration Client > New Function Wizard

Task Explorer | Resources Explorer | Task Designer
Menu Options | Toolbar Items