Channels

When you publish a file to a channel, the file is distributed to all of the users or groups who subscribe to that channel. The channel must be assigned to a page which has been published to the users or groups before the channel contents can be displayed.

The Channel pages are used to create, edit and publish the channels and the channel content.

Introduction

Your use of the Netcool Reporter channels feature depends on the group you have been assigned to by the administrator.

ReporterAdmin Group

A Netcool Reporter user who is a member of the ReporterAdmin group, for example the administrator user, has the ability to create and modify channels and publish channels to other Netcool Reporter users.

ReporterDesigners Group

A Netcool Reporter user who is a member of the ReporterDesigners group, for example the netcool and administrator users, has the ability to view channels and publish files to any channels they subscribe to.

For a member of the Report Designer group to subscribe to a new channel, a member of the ReporterAdmin group must first publish the channel to this group.

ReporterEndUsers Group

A Netcool Reporter user who is a member of the ReporterEndUsers group, for example the reporter user, has no direct access to channels. If a channel is published to the ReporterEndUsers group the users cannot view the channel since there is no access to the My Channels link.

To view the content of a channel, the channel must be saved as a new page in the Page Repository. When this page is published to the ReporterEndUsers group, the page can be added and appears as a link in the navigation panel.

Viewing Channels

You can view the documents that have been published to any channel to which you have subscribed. To display the My Channels page, shown below, click the My Channels link.

   Figure 18: My Channels Folder

The My Channels link can be found in the Channels Management section of the Advanced Utilities page.

 

   Note:


    The My Channels link is only available to members of the ReportAdmin and ReportDesigners groups.


The files in the My Channels page are viewed and sorted in the same way as the files in the Inbox. The viewing and sorting options are described in Viewing and Running Reports on page 95.

Managing Channel Content

You can use the Manage Channel Content page, shown below, to delete and modify the items in your channel folders.

   Figure 19: Manage Channel Content Page

To open the Manage Channel Content page, click the Manage Channel Content button in the Channels Management section of the Advanced Utilities page.

The My Channels list shows files and sub-directories. You can navigate through the My Channels list using the Browse and Search buttons, as described in Moving Files on page 33.

The name of the item you selected in the list is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple files at one time from the list then only the name of the top file is displayed in the text field.

Deleting an Item in a Channel

To delete an item in a channel, select the item and click the Delete button. Selecting the Cascade Delete checkbox can remove the selected item from all the channels and users that it has been published to. It will also delete the item from its owner. 

 

   Note:


    The Cascade Delete option enables you to delete files not only from the Netcool Reporter, but also from the machine on which the Netcool Reporter server resides.


Modify an Item in a Channel

To modify an item in a channel:

1.   Select the item to be modified and click the Modify button. The Modify Content page is displayed.

   Figure 20: Modify Content

2.   Change the file name and description as required.

3.   Click the Modify button.

Adding Portlets to a Channel

A portlet is a Netcool Reporter component. You can add a link to this component into your channel.

You must be a Netcool Reporter administrator to add portlets to channels.

To add a portlet to a channel:

1.   Click the Advanced Utilities link in the navigation panel to open the Advanced Utilities page.

2.   Click the Publish Portlets link in the Admin section. The Publish Portlets window is displayed with the Publish tab selected, as shown below.

   Figure 21: Publish Portlets Window

3.   Select the portlets you would like to publish from the All Portlets list. You can select multiple portlets from this list.

The name of the item you selected is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple items at one time from the left panel then only the name of the top item is displayed in the text field.

4.   The Publish to Channel list lists channels and files in those channels. Channel names are marked with angle brackets. By default, the directory displays the My Channels folder content.

Select a destination channel then click the Browse button. The selected channel is opened and the name of the channel is displayed above the Publish to Channel list.

5.   Click the Publish button to add the portlet to the channel.

Removing Portlets from a Channel

To remove a portlet from a channel.

1.   Click the Advanced Utilities link in the navigation panel to open the Advanced Utilities page.

2.   Click the Publish Portlets link in the Admin section. The Publish Portlets window is displayed.

3.   Select the Unpublish tab. The Select Portlet(s) list lists channels and files in those channels. Channel names are marked with angle brackets. By default, the directory displays the My Channels folder content.

Select the channel name then click the Browse button to open the channel. The selected channel is opened and the name of the channel is displayed above the Select Portlet(s) list.

4.   Select the portlets you would like to unpublish from the list. You can select multiple portlets from this list.

The name of the item you selected is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple files at one time from the left panel then only the name of the top file is displayed in the text field.

5.   Click the Unpublish button to remove the portlet from the channel.

Publishing Channel Content

You can publish any file in an existing channel to another channel using the Publish Channel Content page, as shown below.

   Figure 22: Publish Channel Content Page

To open the Publish Channel Content page, click the Publish Channel Content button in the Channels Management section of the Advanced Utilities page.

The My Channels list shows files and sub-directories. You can navigate through the My Channels list using the Browse and Search buttons, as described in Moving Files on page 33.

Publish Channel Content 

To publish a channel:

1.   Select the Publish tab on the Publish Channel Content page.

2.   Select the destination channel in the My Channels list on the right of the page.

The name of the item you selected is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple files at one time from the left panel then only the name of the top file is displayed in the text field.

3.   Click the Browse button to open the selected channel.

4.   Select the file to be published in the left My Channels list.

5.   Click the Publish button.

All users who subscribe to the destination channel can view the file.

If you publish a file to a channel, and the channel is saved within a page in the Page Repository, then a user with no access to the My Channels button can access the file using this page.

Unpublish Channel Content

You can unpublish a file in a channel using the Unpublish Channel Content page.

To unpublish a channel:

1.   Open the Unpublish Channel Content page by selecting the Unpublish tab on the Publish Channel Content page, as shown below.

   Figure 23: Unpublish Channel Content Page

2.   Select the channel containing the file to unpublish in the My Channels list.

The name of the item you selected in the list is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple files at one time from the list then only the name of the top file is displayed in the text field.

3.   Click the Browse button to open the selected channel.

4.   Select the file to unpublish.

5.   Click the Unpublish button.

The selected file is removed from the channel for all subscribers of that channel.

Managing Channels

Once created, channels can be published to selected groups or users. Creating a channel is the first step in creating a new page.

You must be a Netcool Reporter administrator to access the Manage Channels window.

Creating Channels

To create a new channel:

1.   Open the Administration page by clicking the Administration button in the navigation panel.

2.   Click the Manage Channels icon in the Advanced Channel Management section. The Manage Channels page is displayed, as shown below.

   Figure 24: Manage Channels Page

3.   Select the Create New Channel tab.

4.   Type a name for the new channel into the Name field.

The following characters cannot be used: ~` !@#$%^&*()+ {[}]|\:;"'<,>?/.

5.   Enter an optional description for the channel into the Description field. The same character exclusions apply.

6.   Click Create to create the new channel at the root (My Channels) level.

7.   If you wish to create a channel that is contained in another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate back up to the previous channel.

The name of the channel you selected is displayed in the text field below. This long text field is able to fully display long names. If you selected multiple channels at one time from the list then only the name of the top channel is displayed in the text field.

Deleting Channels

You can only delete a channel if you are the owner of the channel.

To delete a channel:

1.   Open the Manage Channels page, as described in Creating Channels on page 56.

2.   Select the Delete Channel tab.

3.   By default, the tab displays the channels at the root (My Channels) level. If you wish to delete a channel that is contained in another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

The name of the channel you selected is displayed in the text field below. This long text field is able to fully display long names. If you selected multiple channels at one time from the list then only the name of the top channel is displayed in the text field.

4.   Select the channel to delete and click the Delete button. A message window is displayed warning you that the channel you selected, its subchannels, and all of its contents are about to be deleted.

5.   Click Delete to delete the channel.

Editing a Channel's Name or Description

To edit a channel name or description:

1.   Open the Manage Channels page as described in Creating Channels on page 56.

2.   Select the Edit Channel tab. The tab contains the same Name and Description fields as the Create New Channel tab.

3.   By default, the tab displays a list of channels at the root (My Channels) level. If you wish to edit a channel that is contained within another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

4.   Select the channel to edit.

The name of the channel you selected is displayed in the text field below. This long text field is able to fully display long names. If you selected multiple channels at one time from the list then only the name of the top channel is displayed in the text field.

5.   Type a new name for the channel into the Name field.

The following characters cannot be used: ~` !@#$%^&*()+ {[}]|\:;"'<,>?/.

6.   Enter or change the optional description for the channel in the Description field. The same character exclusions apply.

7.   Click Edit to apply your changes.

Publishing and Modifying Channels

After you have created a channel, you must publish it to make it available to groups of users. Only an administrator can publish channels.

Publish Channels

To publish a channel:

1.   Open the Administration page by clicking the Administration button in the navigation panel.

2.   Click the Publish Channels icon in the Advanced Channel Management section. The Publish Channels page is displayed, as shown below.

   Figure 25: Publish Channels Page

3.   By default, the tab displays the list of channels at the root (My Channels) level. If you wish to edit a channel that is contained within another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

4.   Select the channel to publish.

The name of the channel you selected is displayed in the text field below. This long text field is able to fully display long names. If you selected multiple channels at one time from the left panel then only the name of the top channel is displayed in the text field.

5.   The Select destination groups: list displays all of the groups to which you may publish the channel. Select a group from this list. You cannot select more than one group at a time.

6.   Click the Publish button. The Set Access Rights page is displayed, as shown below.

   Figure 26: Set Access Rights Page

7.   Set the group's access rights. Select the checkboxes for the access rights you wish to assign to the group.

The access rights icons are described in the following table.

Table 15: Access Rights Descriptions

Access Rights

Description

Read

Allows all users in groups to whom the channel is published to view the channel. This checkbox is selected by default and cannot be deselected when you are publishing a channel.

Write

Allows all users in groups to whom the channel is published to upload items into the channel and remove items from the channel.

Publish

Allows all users in groups to whom the channel is published to republish the channel. It also gives users in those groups the right to modify the channel's contents.

8.   Click Publish to publish the channel.

Modifying Group Access Rights to Channels

To modify a groups access rights to a channel:

1.   Open the Administration page by clicking the Administration button in the navigation panel.

2.   Click the Publish Channels icon in the Advanced Channel Management section. The Publish Channels page is displayed.

3.   Click the Modify tab to display the Modify Channels page, as shown below.

   Figure 27: Modify Channels Page

4.   By default, the tab displays the list of channels at the root (My Channels) level. If you wish to edit a channel that is contained within another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

The name of the channel you selected is displayed in the text field below. This long text field is able to fully display long names. If you selected multiple channels at one time from the list then only the name of the top channel is displayed in the text field.

5.   Select the channel to modify.

6.   Click the Modify button. The Modify Access Rights page is displayed. The access rights in this window are identical to the ones shown in Figure 26 on page 60.

7.   Change the group's access rights by selecting or deselecting the checkboxes. Descriptions of the checkboxes are given in Table 15 on page 60.

8.   Click the Modify button to change the group access rights.

Unpublishing Channels

To unpublish a channel:

1.   Open the Modify Channels page, as described in Modifying Group Access Rights to Channels on page 60.

2.   Select the channel to unpublish.

3.   Click the Modify button. The Modify Access Rights page is displayed.

4.   Deselect the Read checkbox.

5.   Click Modify to unpublish the channel.

Uploading Data to Channels

The Upload Content page allows you to upload files into either a channel or folder.

For information on uploading to a folder, see Uploading Data to a Folder on page 38.

Uploading to a Channel

To upload data to a channel:

1.   Click the Advanced Utilities link in the navigation panel to open the Advanced Utilities page.

2.   Click the Upload Content icon in the Upload section. The Upload Content page is displayed with the Channel tab selected, as shown below.

   Figure 28: Upload Content - Channels Page

The My Channels list allows you to choose the channel into which an item should be uploaded.

3.   By default, the My Channels list displays the list of channels at the root (My Channels) level. If you wish to upload to a channel within another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

4.   Select the type of the item to upload from the Content Type drop-down list. The options are described in the following table.

Table 16: Content Types

Content Type

Description

File

To upload a file.

URL

To create a link to the address of an ordinary Web page. For example, http://www.micromuse.com.

Dynamic URL

To create a link which contains parameters. For example, a link incorporating a user name and password.

JavaScript URL

To create a link where the URL returns JavaScript rather than an HTML page.

The fields below this drop-down list change according to the selection made.

The name of the item you selected is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple items at one time from the list then only the name of the top item is displayed in the text field.

5.   If the item you are uploading is a file, enter the following information:

6.   If the item you are uploading is a URL, Dynamic URL, or JavaScript URL, enter the following information:

                      For example, you can enter an e-mail address by adding the mailto: prefix.

7.   Select the Overwrite existing files checkbox if you want to overwrite any existing files with the same name.

If you do not select this option and the file you are uploading has the same name as an existing file, an error message is displayed.

 

   Note:


    Upload time can be reduced if you select the Overwrite existing files checkbox. This method is effective for reducing upload time even if you do not have an existing file to overwrite.


8.   Click Upload to upload the data.

Netcool Reporter cancels the upload if it takes too long (several minutes). This may be a problem if you try to upload a very large file over a dial-up connection.

The file is initially published only to you, with full access rights. You may have to click the Reload button before the item appears. To make the file available to others, you must publish it to them.

Upload JSP

The Upload JSP page allows you to upload Java Server Pages (JSPs) into a channel.

The Upload Content page is used to upload content to a channel, for example, files, documents and URLs. The Upload JSP page allows you to upload complete pages.

To upload a JSP into a channel:

1.   Click the Advanced Utilities link in the navigation panel to open the Advanced Utilities page.

2.   Click the Upload JSP link in the Upload section. The Upload JSP page is displayed, as shown below.

   Figure 29: Upload JSP Page

The My Channels list allows you to choose the channel into which an item should be uploaded.

3.   By default, the My Channels list displays the list of channels at the root (My Channels) level. If you wish to upload to a channel within another channel, you must select the parent channel from the list and click the Browse button.

You can click the <..> list item and click Browse to navigate to the parent channel.

The name of the item you selected is displayed in the text field below. This long text field is able to fully display long filenames. If you selected multiple items at one time from the list then only the name of the top item is displayed in the text field.

4.   Enter the full file path and file name in the Name field. You may select the JSP from the appropriate directory by clicking the Browse button.

5.   (Optional) Enter a description for the JSP in the Description field. The following characters cannot be used: ~`!@#$%^&*()+{[}]|\:;"' <,>?/.

6.   (Optional) Enter any keywords you would like to associate with the JSP in the Keywords field (up to 254 total characters). Users can perform a search using these keywords to locate the JSP later. The list of character exclusions for the Description field also apply to this field.

7.   Select the Overwrite existing files checkbox if you want to overwrite any existing files with the same name.

If you do not select this option and the file you are uploading has the same name as an existing file, an error message is displayed.

 

   Note:


    Upload time can be reduced if you select the Overwrite existing files checkbox. This method is effective for reducing upload time even if you do not have an existing file to overwrite.


8.   Click Upload to upload the data.

Netcool Reporter cancels the upload if it takes too long (several minutes). This may be a problem if you try to upload a very large file over a dial-up connection.

Once it is uploaded, the JSP is stored in the JSP root directory. This directory is set to infospc\jsp\JSP_Uploads by default, however, it can be changed by configuring the UploadJSP servlet in the servlet initialization settings of the servlet engine.

The JSP is initially published only to you, with full access rights. You may have to click the Reload button before the item appears. To make the JSP available to others, you must publish it to them. Published JSPs are indistinguishable from other Netcool Reporter pages and are viewed in the same way.

Uploading JSPs that Include Other JSPs

If an uploaded JSP includes another JSP within its body, the included JSP must be physically copied into the appropriate directory in order for the uploaded page to function correctly. For example, the file MyPage.jsp includes Page2.jsp in its body using the statement:

<jsp:include page="infospc/my_JSPs/Page2.jsp" flush="true" />

While MyPage.jsp is uploaded using the Upload JSP page, in order for it to function correctly, Page2.jsp must be physically copied into the directory infospc\my_JSPs.