Webster+

Webster+ Inspector

The Webster+ Inspector page displays the contents of the directory that contains your Webster+ installation (defaults to the docroot directory). It provides options for viewing, creating, editing and deleting files and directories.

When the security system in Webster+ is enabled, a new Inspector option displays on the left side. Clicking the Inspector option brings up the Webster+ Inspector page if the user is allowed to access it. Only users who are part of the Admin group (System Administrators) or the Dev group (Application Developers) are allowed to access the Webster+ Inspector page.

To open a file or a directory, click on the file or directory to select it and then click the Explore button. This opens the file in view-only mode or displays a list of the files in the directory. Double clicking on a file or directory does not open it.

The ability to edit text files, program files or HTML files depends on whether the user is part of the Inspector Edit Access group selected for the Access Control option. PxPlus data files can only be viewed, not edited, within Webster+.

For information on working with text files, data files, report definition files (*.pvr), and PDF files within Webster+, see Viewing Text Files, Data Files, Report Files and PDFs.

For information on working with program files and HTML files within Webster+, see Viewing Program Files and Viewing HTML Files.

(The ability to view, create, edit and delete files and directories through Webster+ Inspector was added in PxPlus 2021 Update 1.)

The Webster+ Inspector page consists of the following:

Directory	When the Inspector option is selected, the directory defaults to the docroot directory where webster.pxp was installed. Enter a different directory or click the Up button to change to a directory one level up. To set the top level directory, see Setting the Top Level Directory.
Explore	Opens the selected file in view-only mode or displays a list of the files in the selected directory.
Up	Changes to a directory one level up.
Refresh	Refreshes the list of files in the selected directory.
New Text	This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display. Invokes the New Text File window for creating a new text file using the Text editor within Webster+. The types of text files that can be created are ".txt", ".js", ".json", ".css", ".csv", ".conf", ".ini", ".log" and ".xml". When naming a new text file, the file extension needs to be included so that Webster+ will recognize the file type and open it. (The New Text button was added in PxPlus 2022.)
New Program	This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display. Invokes the New Program window for creating a new program file using the ED+ program editor within Webster+.
New HTML	This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display. Invokes the New HTML File window for creating a new HTML file using the HTML editor within Webster+.
New Directory	This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display. Invokes the New Directory window for creating a new directory.
Delete	This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display. Deletes the selected file or directory. Prior to deleting, a message will display.
Print	Prints a listing of the selected directory contents to the viewer.
(Files List)	Displays details about the files in the selected directory, including file size, creation date and last modified date.

Viewing Text Files, Data Files, Report Files and PDFs

Text files can be viewed and edited within Webster+.

PxPlus data files, however, can only be viewed, not edited. When a data file is opened, the records (sorted by prime key) and the prime key definition are displayed. The File Info button allows you to view detailed data dictionary information, if applicable.

When a report definition file (*.pvr) is opened, it is opened as a text file, which can be viewed and edited within Webster+. The Generate Report button generates the report based on the report definition (*.pvr) file, and if applicable, allows you to specify the parameters and/or filter criteria to be applied to the report at run time.

PDF files can be viewed within Webster+. When a PDF file is opened, its contents are displayed in a new tab on the Web browser.

(The ability to create text files, view data files and open PDFs was added in PxPlus 2022.)
(The ability to view, edit, filter and generate reports was added in PxPlus 2022 Update 1.)

Below is an example of a text file opened in view-only mode:

Below is an example of a PxPlus data file opened in view-only mode with navigation buttons shown near the bottom (when applicable):

Below is an example of a PxPlus report file opened as a text file in view-only mode:

This page consists of the following:

Close

Closes the contents page and returns to the Webster+ Inspector page.

Refresh

Refreshes the contents of the displayed text file, data file or report file.

Edit

(Applicable for Text Files and Report Files Only)

This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display.

Clicking this button opens the selected text file or report (.pvr) file in the Text editor within Webster+:

This window consists of the following:

Save	Writes the current text file.
Save As	Invokes a separate window for entering the text file/path name to be written.
New	Invokes a separate window for creating a new text file.
Close	Closes the current text file. If you have made changes to the file without saving them, you are asked if you want to save the changes.
Undo	Reverse the last change(s).
Redo	Reverses the previous Undo operation.
Goto	Invokes a separate window for entering a specific line number to jump to in the program. Clicking the Jump button positions the insertion cursor at the beginning of the specified line.
Find	Invokes the logic to search for a specified text value. Click the up/down arrows to search for the previous/next occurrence of this text. A Regexp check box option is available if the search text is a regular expression. A Match Case option is also available if the search is case sensitive. A Whole Word option is used to search for the specified text value as a whole word only rather than as part of another word.
Replace	Invokes the logic to search for and replace the specified text value. Enter the text value to be replaced and then below that, enter the replacement text value. Click the up/down arrows to search for the previous/next occurrence of the text to be replaced. A Regexp check box option is available if the text to be replaced is a regular expression. A Match Case option is also available if the search is case sensitive. A Whole Word option is used to search for the specified text value as a whole word only rather than as part of another word.

File Info

(Applicable for PxPlus Data Files Only)

Opens a PxPlus Wiki page in a new tab on the Web browser that shows detailed data dictionary information. If a data class was used to define a field, the class name shows as a link that can be selected to view the data class information.

Example:

Generate Report

(Applicable for Report Files Only)

Generates the report based on the report definition (*.pvr) file. If a report was defined with parameters and/or data filters, a page will display to allow you to specify the parameters and/or filter criteria to be applied to the report at run time.

Example:

The report for this example was defined with both parameters and run-time filters:

This window consists of the following:

Report Parameters Run-time Filters	Displays any report parameters and/or run-time filters that were defined for the report, if applicable.
Run Report	Displays the report in a new tab on the Web browser, applying any filter criteria.
Cancel Report	Closes this page, cancelling any selections, and returns to the report's contents page.

(The Generate Report button was added in PxPlus 2022 Update 1.)

Print

Prints a listing of the selected text or report file or data file contents to the viewer.

Viewing Program Files

Below is an example of a program file opened in view-only mode:

This page consists of the following:

Close

Closes the contents page and returns to the Webster+ Inspector page.

Refresh

Refreshes the displayed program file contents.

Edit

This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display.

Clicking this button opens the file in the ED+ program editor within Webster+:

This window consists of the following:

Save	Saves the current program file.
Save As	Allows you to name and save the current program file.
New	Invokes a separate window for creating a new program file.
Close	Closes the current program file. If you have made changes to the program without saving them, you are asked if you want to save the changes.
Undo	Reverses a change.
Redo	Reverses the previous Undo operation.
Strip Lines	Strips line numbers from a program that currently has line numbers. All line number references will be replaced with statement labels or same or next logical statement labels where applicable. You are prompted for a label prefix that will be used for the base label name for any labels that must be generated.
Reformat	Reorganizes the lines of code for the current program by applying proper formatting for indentation, if applicable.
Goto	Invokes a separate window for entering a specific line number to jump to in the program. Clicking the Jump button positions the insertion cursor at the beginning of the specified line.
Find	Invokes the logic to search for a specified text value. Click the up/down arrows to search for the previous/next occurrence of this text. A Regexp check box option is available if the search text is a regular expression. A Match Case option is also available if the search is case sensitive. A Whole Word option is used to search for the specified text value as a whole word only rather than as part of another word.
Replace	Invokes the logic to search for and replace the specified text value. Enter the text value to be replaced and then below that, enter the replacement text value. Click the up/down arrows to search for the previous/next occurrence of the text to be replaced. A Regexp check box option is available if the text to be replaced is a regular expression. A Match Case option is also available if the search is case sensitive. A Whole Word option is used to search for the specified text value as a whole word only rather than as part of another word.
Bookmarks	Provides a list of the file's methods and labels for quick access to a specific part of the file. Use the vertical scroll bar to locate the method or label you want to modify and then click on that bookmark to jump directly to that location in the file.

Print

Prints a listing of the selected program file contents to the viewer.

Viewing HTML Files

Below is an example of an HTML file opened in view-only mode:

This page consists of the following:

Close

Closes the contents page and returns to the Webster+ Inspector page.

Refresh

Refreshes the displayed HTML file contents.

Edit

This button is only available to users who are part of the Inspector Edit Access group selected for the Access Control option; otherwise, this button does not display.

Clicking this button opens the file in the HTML editor within Webster+:

This window consists of the following:

Save	Writes the current HTML file.
Save As	Invokes a separate window for entering the HTML file/path name to be written.
New	Invokes a separate window for creating a new HTML file.
Close	Closes the current HTML file. If you have made changes to the file without saving them, you are asked if you want to save the changes.

For an explanation of the HTML editor menu bar and tool bar options, see Menu Bar Options and Tool Bar Options.

Preview

Opens the selected HTML file in a new tab in your browser.

Print

Prints a listing of the selected HTML file contents to the viewer.

Setting the Top Level Directory

The setting of %inspector_top$ controls the top level directory allowed in the Webster+ Inspector. It can be set in webster.pxp.

Example:

%inspector_top$="C:\webster-plus\"