Using channel notifications

Channel notifications provide a list of the most recently completed file jobs. When a document file job completes, a notice containing a URL link to the generated document appears in the Personal Channel of the user who scheduled the job and to any other subscribed channels where the user has write privileges.

Figure 2-43  Showing subscribed channels

Channel notifications display in a summary view and can expand to a detailed view. Summary channel notifications contain the following information for the completed file job:

n

File size

n	Finished date and time

n

Headline

n

Job name

n	Version name

n	Version number

Figure 2-44 shows a channel notification as a summary of the file job.

Figure 2-44  Viewing personal channel notifications with a filter

Choose View job detail for the selected channel notification to display the following information:

n	Notification settings

n	Output document information

n	Report information

n	Schedule information

n

Status

The BIRT iServer administrator creates multiple channels to group report notifications together. For example, all sales managers in the US can subscribe to the US Sales channel and automatically receive all the US sales report notifications.

Information Console provides every user with a Personal Channel. This channel lists the user’s most recently completed document file jobs. Choose Channels to view the currently subscribed channels or to subscribe to a new channel, as shown in Figure 2-45.

Figure 2-45  Viewing available channels

Users with the appropriate security role can subscribe to additional channels. An Encyclopedia volume administrator can also subscribe users to additional channels. These additional channels receive finished job reports for completed document jobs when configured to do so by the Encyclopedia administrator.

Users can remove channel notifications in their Personal Channel by deleting the job report that created the notification.

Similar to the way privileges permit a user to perform a specific action on files and folders, channels require a user to have specific file privileges. Table 2-5 lists the privileges necessary for performing channel tasks.

Table 2-5  Required privileges for channel tasks 

Channel tasks	Required privilege settings
Reading a notice in a channel	Read or secure read on the report document associated with the notice
Sending a notice to a channel	Write privilege for the channel
Subscribing to a channel	Read
Updating the contents of a channel	Write Visible on the files that generate the report documents Execute on the files that generate the report documents
Viewing a channel	Read privilege for the channel

Filtering channel notifications limits the notifications shown to a user. Use the same process as filtering files and folders to find a report within a channel. Choose Filter On and type the search string. Use the asterisk (*) special character to search for unknown characters.

(c) Copyright Actuate Corporation 2011