You can use the Text Display widget to show text in the user interface. The text appears in the Text Display widget on the dashboard.

The Text Display widget can read text from a Web page or text file. You specify the URL of the Web page or the name of the text file when you configure the Text widget. To use the Text Display widget to read text files you must set a property in the web.properties file to specify the root folder that contains the file.

You can enter content in the Text Display widget in plain text or rich text format based on the view mode that you configure. Configure the Text Display widget in HTML view mode to display content in rich text format. Configure the Text Display widget in Text mode to display content in plain text format.

The Text Display widget can display web sites that use the HTTPS protocol. The behavior of the Text Display widget with web sites that use HTTP, depends on the individual settings of the web sites.

Note:

If the webpage that you are linking to has X-Frame-Options set to sameorigin, which denies rendering a page in an iframe, the Text Display widget cannot display the contents of the webpage.

How the Text Display Widget Configuration Options Work

You can configure the widget in the Text view mode or HTML view mode. In the HTML view mode, you can click Edit in the widget and use the rich text editor to add content.

If you configure the widget to use Text view mode, you can specify the path to the directory that contains the files to read or you can provide a URL. The content in the URL will be shown as text. If you do not specify the a URL or text file, you can add content in the widget. Double click the widget and enter content in plain text.

You can also use command line interface (CLI) commands to add file content to the Text Display widget.

  • To view a list of parameters, run the file -h|import|export|delete|list txtwidget command.

  • To import text or HTML content, run the import txtwidget input-file [--title title] [--force] command.

  • To export the content to the file, run the export txtwidget all|title[{,title}] [output-dir] command.

  • To delete imported content, run the delete txtwidget all|title[{,title}] command.

  • To view the titles of the content, run the list txtwidget command.

Where You Find Text Display Widget Configuration Options

To customize the data that appears in the dashboard widget, in the menu, click Dashboards. Click Actions > Create Dashboard/Edit Dashboard to add or edit a dashboard. Toggle between the Views and Widgets option to view and add a widget to the dashboard. In the widgets list panel, you will see a list of all the predefined widgets. Drag a widget to the dashboard workspace in the upper panel. On the title bar of the selected widget, click the Edit Widget icon to access the configuration options.

Table 1. Text Display Widget Configuration Options

Option

Description

Title

Enter a custom title that identifies this widget from other instances that are based on the same widget template.

Refresh Content

Enable or disable the automatic refreshing of the data in this widget.

If not enabled, the widget is updated only when the dashboard is opened or when you click the Refresh button on the widget in the dashboard.

Refresh Interval

If you enable the Refresh Content option, specify how often to refresh the data in this widget .

View mode

Display text in text or rich text format. You can configure the widget in HTML view mode only when the URL and File fields are blank.

URL

Enter the URL.

File

Navigate to the file that contains the source text file by clicking the Browse button.

To add, edit, and remove source text files, go to the TxtWidgetContent node in the Metric Configurations page. In the menu, click Administration, and then in the left pane click Configuration > Metric Configurations from the vRealize Operations Manager user interface.

Test

Validates the correctness of the text file or URL that you enter.