Chat now with support
Chat with Support

Foglight 5.9.2 - Web Component Tutorial

Using the Web Component Tutorial Tutorial 1: Drag and Drop Tutorial 2: Creating a Dashboard Tutorial 3: Adding a Drilldown Page Tutorial 4: Adding Views Tutorial 5: Using a Grid Tutorial 6: Reports Tutorial 7: Creating a Form Tutorial 8: Renderers Tutorial 9: Adding Questions and Answers Tutorial 10: Sending Messages to Other Users

Creating Script Functions

Script Functions execute scripts and return desired results. In this we will create two Script Functions: Send Warning Message and Send Error Message. These functions call the sendMessage() function and that uses a Message Association as input. This function is defined in the FunctionHelper interface available in the WCF API.

For the purpose of this example, we are making a call to the sendMessage() function when a label is selected in order to display a message in the browser interface and illustrate the usage of Message Associations. However, in a typical scenario, you will likely use messages in your code, for example, to inform the users that a background process has finished. This can be done by calling the sendMessage() function from the code instead of creating a Script Function and invoking it from a view.

For complete information about the sendMessage() function and the WCF API, see the WCF API Reference in the online help, accessible from the Getting Started page under Developing Foglight Cartridges.

To create Script Functions that call the sendMessage() function:
1
Start by creating a new Script Function.
d
In the Module Contents pane, click Associations and select Functions from the list that appears.
e
Click .
f
In the Add Function dialog box that appears, on the Blank Function tab, select Script and click OK.
A New Function tab appears in the Definition/Edit pane.
g
Specify the name for this Script Function. In the Name box, type Send Warning Message.
2
In the Script Text box, type the following text:
package system._wcf_tutorials_tutotial2010.scripts;
functionHelper.sendMessage("system:wcf_tutorials_tutotial2010.7", 'site',
null,'never', 0, null);
The package name in the first line of code references your working module. If you are working in a different module, there is no need to edit that line.
The second line calls the sendMessage() function. The first argument shown in the above example, "system:wcf_tutorials_tutotial2010.7", should contain the reference ID of the Warning Association. Edit that value to reflect the reference ID.
 
* 
TIP: You can quickly find the reference ID of the Warning Association when you have it open in view mode in the Definition/Edit pane.
For more information about this function, see the WCF API Reference in the online help, accessible from the Getting Started page under Developing Foglight Cartridges.
Figure 1. Warning Association reference ID
3
Observe the Output Data Type property.
By default, this Script Function returns an Object. This object will contain the message that will be passed as an input key to the flow of the Label component later in this tutorial. This action results in a new message.
4
Save your changes.
5
Create another Script Function using the same steps, that references the Error Association.

The Script Functions are created. Next, create Label views that invoke these Script Functions in their flow.

Creating Label Views

In this you will create two Label views: Warning Label and Error Label. Each of these Labels will invoke the appropriate Script Function in their flow.

To create Label views:
1
Start by creating a new Label view.
h
In the Module Contents pane, click Functions and select Views from the list that appears.
i
Click .
j
In the Add View dialog box that appears, on the Create a Blank View tab, choose Common > Label and click OK.
A New View tab appears in the Definition/Edit pane.
k
Specify the name for this Label. In the Name box, type Send Warning Label.
2
Specify the label text.
a
Open the Configuration tab.
b
In the row containing the Label property, in the Value column, click Edit , and choose Set to Value > String.
c
In the Edit - Label dialog box that appears, in the String name box, type Send a Warning Message.
d
Click Set.
3
Enable the triggering of the Send Warning Message function when the Label is selected.
The Send Warning Message returns an Object. This object contains the message that will be passed as an input key to the flow. For that reason, we need to add an input key to receive this Object instance.
a
Open the Flow tab.
b
Click Selection in the list.
c
In the Edit - Selection dialog box that appears, clear the Leave unspecified check box.
d
Click Flow type and select Update from the list that appears.
e
In the Context table, click to add a new context key.
f
In the Key column, type the key name. For example, message.
g
In the Value column, click Edit , and choose Set to Binding > Function.
h
In the Edit dialog box that appears, click the selector button (). In the Available Functions dialog box that appears, navigate to the Send Warning Message function.
 
* 
TIP: You will find the function in your current working module.
4
Save your changes.
5
Follow Step 1 through Step 4 to create another Label view with the following definitions:
•
Name: Error Label
•
Label: Send an Error Message
•
Update Flow: Configure it to include a context key pointing to the Send Error Message function.

The Label views are created. Next, add these labels to a dashboard and send test messages.

Testing Messages

In this you will create a simple dashboard, Send Messages, and add the Label views to the layout. You will then test the messaging actions by invoking Warning and Error messages and observe the resulting flow.

Figure 2. Testing messages

To test messaging actions:
1
Start by creating a new dashboard.
i
In the Module Contents pane, ensure that Views is selected.
j
Click .
k
In the Add View dialog box that appears, on the Create a Blank View tab, choose Common > Grid Layout. Click OK.
A New View tab appears in the Definition/Edit pane.
l
Specify the name for this dashboard. In the Name box, type Send Messages.
2
Add Label views to the dashboard layout.
a
Open the Layout tab.
b
Click Add.
c
In the Add View dialog box that appears, ensure that Selecting existing view is selected and click Next.
d
Navigate to your working module and select the Warning Label from the tree.
e
Accept the default sizing properties and click Finish.
f
Follow Step b through Step e to add the Error Label to the layout and save your changes.
3
Test the messaging action.
g
In the Definition Editor, navigate to the Send Messages definitions. Click Test.
The Send Messages dashboard appears in the display area.
The dashboard contains two links: Send a Warning Message and Send an Error Message.
Figure 3. Send Messages dashboard
h
Click Send a Warning Message.
After a few moments, a Warning message appears in the top-right corner.
Figure 4. Warning Message
i
Click Send an Error Message.
After a few moments, an Error message appears in the top-right corner.
Figure 5. Error Message
j
Click to expand the list of messages.
Figure 6. List of messages
k
Optional. Clear all or individual messages, or close the list.

Summary

In this tutorial you have learned to create Message Associations, Script Functions, Label, and Grid Layout views, and now to send messages to active Foglight™ users.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating