Viewing Library Content

The Workspaces area of the start page or the WebFOCUS Home pageWorkspaces area of the Hub or the WebFOCUS Home page provides access to Library reports from a multi-level folder organization. Library reports can be in the same folder as other ReportCaster or Managed Reporting content. However, it is a best practice for burst Library reports to be in their own folder so that all the burst report sections list together in the same folder. In addition, the Title assigned to each burst report is the data value of the burst field for that report section.

When a Library report is selected, the options available are determined by WebFOCUS Client security authorization. Users can be authorized to view, track, cut, delete, share, publish, and manage the security of Library report.

The View options View Last Version and Versions allow you to view the most recent version of a Library report or to obtain a list of all versions of the Library report. You can change the default View setting for viewing Library reports in the WebFOCUS Administration Console, on the Configuration tab. For more information, see the TIBCO WebFOCUS® Security and Administration manual.

The following image shows the list of all versions available for the Product Packaging and Price Library report.

From the Library Versions listing, you can view a Library report in a new window by selecting the version of the report and then selecting the Open option from the toolbar or the context menu. You can also view the report in the view pane, displayed to the right of the version listing, by selecting the Show View Pane toolbar option. The following image shows the Product Packaging and Price report displayed in the View pane.

To hide the Library view pane, select the Hide View Pane toolbar option. The Hide View Pane toolbar option is highlighted when the view pane is displayed.

The ReportCaster Explorer provides access to Library reports you are authorized to access. See the ReportCaster Explorer for information on the ReportCaster Explorer toolbar Filter and List folder options to list Library and Watch List reports with columns that provide information specific to Library reports.

When a Library report is selected in the ReportCaster Explorer pane listing, you can click the Show version list pane icon to view the available versions of the report at the bottom of the dialog box. The following image shows the ReportCaster Explorer with the versions and options available for the Product Packaging and Price Library report.

You can view the last, most recent version of the Library report by selecting the Open Last Version option, which will display the Library report in a new window.

You can view a specific Library report version by selecting the report version in the pane below the Library report list. When a Library report version is selected, the Library report is displayed in the view pane to the right of the Library report list pane, as shown in the following image.

To view a Library report version in a new window, double-click the report version or right-click the report version and select the Open option, as shown in the following image.

The Library Watch List provides a quick and easy way to focus on information that is of interest to you by sending you an email when a new Library report version is available. You can add any Library report you are authorized to access to the Watch List, whether or not you own it.

Note: An administrator can unsubscribe another user from a library report on their watch list. If SMTP authentication is enabled, subscribers to the watch list are SMTP authenticated.

• For Windows, this feature can be enabled by running the unsubscribe.bat file, located in the \ibi\WebFOCUS82\ReportCaster\bin directory.

• For UNIX, this feature can be enabled by running the unsubscribe shell script, located in the /ibi/WebFOCUS82/ReportCaster/bin directory.

The Watch List email notification includes the report Title and a link to the report in the Report Library. Watch List email notification parameters are defined in the ReportCaster Server Console Configuration tab, under the Report Library folder. For more information, see ReportCaster Configuration.

You can add or remove a Library report to the Watch List using the Subscribe and Unsubscribe options available when a Library report is selected from the Resources tree or ReportCaster Explorer interface.

Note: The Subscribe option is available only if the Enable Library Watch List check box within the ReportCaster Console Configuration tab is selected. For more information, see Report Library Settings.

The following examples show how to add a library report to your Watch List from the Resources tree and the ReportCaster Explorer.

• In the Resources tree, right-click the Library report that you want to add your Watch List, and select Subscribe from the drop-down list. If the report is burst, subscribe to each report section you want to add to your Watch List. The following image shows the Subscribe option from the Resources tree, for the Product Packaging report.
  
• In the ReportCaster Explorer interface, select the Library Report Filter option located on the toolbar and the folder in the Resources tree that contains the Library reports or is the folder path that the Library reports you are authorized to access are located in. The ReportCaster Explorer List Files options, located on the toolbar, allow you to view Library reports within the selected folder or within the selected folder and its subfolders. For more information on Filter and List Files toolbar options, see ReportCaster Explorer.

  Right-click the Library report you want to add to your Watch List and select Subscribe from the drop-down list. If the report is burst, subscribe to each report section you want to add to your Watch List. The following image shows the Subscribe option from the ReportCaster Explorer Library report list for the Product Packaging and Price Library report.

  
• Watch List reports display in the Resources tree and ReportCaster Explorer Library with the following image to identify it as a Watch List report:
  

  The following image shows the Resources tree with a Regional Product Sales (Weekly Reports) folder expanded to list the burst report sections. The Northeast report section is a Watch List report.

  

  The ReportCaster Explorer Watch List Filter and List files toolbar options allow you to quickly and easily access Watch List reports within a single folder or within a folder path. For more information, see ReportCaster Explorer.

When a Watch List report is selected, the report displays in a view pane to the right of the Watch List report list.

To hide the View pane, select an empty area at the end of the Watch List report listing. You can also open the Watch List report in a separate window by right-clicking the Watch List report and selecting Open.

Note: If you need to control when the View pane is displayed, access the Versions dialog box from the Resources tree by right-clicking the Library or Watch List report you want to view and selecting View, then Versions. Use the Show View Pane icon located on the toolbar of the Versions dialog box to enable the display of the View pane. You can toggle to hide the View pane by clicking the Hide View Pane icon on the toolbar.

To remove a report from the Watch List, do one of the following:

• In the Resources tree, right-click the Watch List report and select Unsubscribe.
• In the ReportCaster Explorer Library or Watch List report listing, right-click the Watch List report and select Unsubscribe. Click Refresh to clear the Watch List report icon.

How to: Publish Library Reports Unpublish Library Reports

Authorized users can publish and unpublish Library Reports to make them available to users authorized to access the folder in which the Library Report is located. Publishing requires the folder in which the item is located to be published in order to publish an item within the folder. If the folder is subsequently unpublished, all items in that folder are unpublished. For more information on Publishing folders and items, see the TIBCO WebFOCUS® Security and Administration manual.

Note: The My Content folder and the content within its folder path cannot be published.

How to: Perform a Save As on a Library Report in the Business Intelligence Portal Perform a Save As on a Library Report in the ReportCaster Explorer

You can save a Library report to your machine using the Save As context menu option that is available when a Library report is selected from the Report Library Versions dialog box or the ReportCaster Explorer tree. The Save As context menu option downloads the Library report file to your machine. When the file is downloaded, the Windows File Download dialog box displays with the options to Open the file, Save the file, or Cancel the file download. The following image shows the file download for a PDF format Library report.

The Name value displayed in the Windows File Download dialog box is the Library report name assigned when the report was distributed to the Report library. You can change the Name value and select the location in which to save the Library report in the Windows Save dialog box that displays when the File Download Save option is selected.

To delete content from the Library, you must be the owner of the Library report or be authorized to manage Library content or the private content of other users.

Deleting the Library report in the Resources tree does not delete all versions of a Library report. The Library report displayed in the Resources tree or ReportCaster Explorer Library report list is associated with the schedule that created the report or reports to provide you access to the Library report versions. Deleting the Library report in the Resources tree will not allow users to access existing versions of the report or reports from the Resources tree until the Library report associated with the schedule is recreated when the schedule that created the report or reports runs again and successfully distributes a new version of the report or reports.

To delete a specific Library or Watch List report version, obtain a list of the available versions for the Library or Watch List report. A list of Library report versions can be obtained from the Resources tree and the ReportCaster Explorer as follows:

• In the Resources tree, right-click the Library or Watch List report and select the Versions option.
• In the ReportCaster Explorer, select Library Reports or Watch List Reports from the Filter toolbar option and in the Resources tree, select the folder in which the Library report is located. To list the files within the selected folder path, select the List files in selected folder and subfolders toolbar option. In the report list pane, select the report. The versions available for the selected report will display in a pane below the Library report list.

Right-click the Library or Watch List report version you want to delete and click Delete.

When you delete a version of a Library report, ReportCaster does not renumber the remaining versions. For example, if there are six versions of a report and you delete versions 1, 2, and 4, the remaining versions are 3, 5, and 6, and the next version of this report to be distributed to the library will be version 7.

When all versions of a Library report are deleted, the Library report will continue to display in the Resources tree, as it is the item associated with the schedule for future distributions of the report.

A Library report remains in the Report Library until all of the following are deleted:

• All versions of the Library report (or reports) distributed by the schedule.
• Library report listed in the Resources tree folder associated with the schedule.
• Delete the schedule associated with the Library report (or reports) if you do not want any future versions of the Library report to be created.

How to: Cut and Paste a Library Report

You can use the Cut and Paste options to move Library reports between folders in the Repository. The ability to cut and paste a Library report is determined by your user permissions or privileges for the folders. For more information, see the TIBCO WebFOCUS® Security and Administration technical content.

The Report Library On-demand Paging feature enables you to view a report one page at a time from the Library while the web application server holds the remaining pages and feeds them at your request. This feature is useful for large reports because it decreases the amount of time you must wait before you can begin viewing the report.

On-demand Paging reports open from the Library inside the WebFOCUS Viewer. This tool provides the framework to view report pages and allows you to search for specific pages or information in the report.

Note: When Library distribution is selected, the Distribution Server adds SET WEBVIEWTARG=OFF to the procedure to control the behavior of the frames in the Library.

SET WEBVIEWTARG does not override ON TABLE SET WEBVIEWTARG. Therefore, the scheduled procedure should not contain an ON TABLE SET WEBVIEWTARG statement with a target_frame value specified. See the Developing Reporting Applications manual for additional information on the WEBVIEWTARG command and other On-demand Paging settings.

As with all Library reports, you can open the On-demand Paging report in a separate window or in the View pane from the Library Versions listing. For more information on viewing Library reports, see Viewing Library Content or ReportCaster Explorer.

Note: When you double-click an On-demand Paging Library report in the BI Portal tree, the report displays, but is missing the Web Viewer control bar at the bottom. Select the View option to view the report. ReportCaster Explorer displays the report in the View pane.

The following image is an example of an On-demand Paging report opened with the Library View pane.

When viewing an On-demand Paging report from the Library Versions View Pane, the Web Viewer control panel is not fully visible and displays with a vertical scroll control. This can be resolved by viewing the On-demand Paging report in a new window by selecting the Open option from the toolbar or the context menu for the selected Library report, as shown in the following image.

The WebFOCUS Viewer control panel, shown in the following image, appears at the bottom of the WebFOCUS Viewer.

The controls enable you to display a specific page. To display a specific page, type a page number in the Page field and press Enter, or click the Go To icon next to the Page field and type in a page number. The following image shows the Page field and icon in the control panel.

Display the previous or next page in a sequence by clicking the Previous and Next arrows, as shown in the following image.

Display the first or last page of the report by clicking the First Page or Last Page arrows, as shown in the following image.

Download the entire report to the browser as a single document by clicking the All Pages icon, as shown in the following image.

Close the WebFOCUS Viewer by clicking the Close icon, as shown in the following image.