About this documentation

This documentation is for PcVue 16.3.

There is more to the documentation than meets the eye. This topic gives an overview of the conventions used in this documentation as well as the powerful search tools you can use to find the information you need.

The documentation contains information that helps you navigate the product installation, configuration, deployment and troubleshooting. It includes explanation about the HMI workspace, the Application Explorer, the Application Architect, the Smart Generators, SCADA Basic scripting and deployment tools.

It also contains detailed information about the Add-ons and the reference for those VBA instructions that are specific to PcVue.

The Microsoft VBA reference help is integrated in the VBA environment and can be displayed using function key F1 when the VBA Editor is open.
The technical resources for PcVue SDK & API are available separately when you choose to install them.

Style conventions of this documentation

  • A bulleted list is used for a list of items that has no particular order, and for lists of tab options.
  1. A numbered list is used for a list that has a particular order, such as how to do something.

Text in a mono-spaced font and with a background color is used for
file fragments and data lists.

ClosedShow picture indicates a place where you can click to display a picture about the topic.

The following icons are used to signify:

An essential note.

A warning.

A tip.

The contents panel

The Contents panel on the left side offers a hierarchical view of sub-books and topics. Each sub-book relates to either a workflow such as Installation or to a product feature such as the Application Explorer.

Feel free to drill-down to find the sub-book and topics relevant to what you are looking for.

Basic search features

The documentation system offers a full-text search engine, you can use letters and numbers in the search query. The letters are not case-sensitive. Punctuation marks are ignored except when within quotations. However, you cannot search for quotation marks. Search also matches terms in the glossary and in the index.

The search results page displays the list of topics relevant to your search query. It includes:

  • A search heading with an indication of the number of results.
  • A list of results with a link to the topic, the first sentences of the topic with matching keywords highlighted and the topic path.
  • A search footer to help you navigate the results if multiple result pages are available.

The search engine supports partial word matching. Similar to simple text search, it allows you to search for partial-word and number strings. The search engine matches variant endings. It will find topics with words that match a keyword or only differ in having a commonly used suffix. For example, if you enter 'add' as the search query, the search engine will match 'added' or 'adding' but not 'additive'. Since matches are not case-sensitive, the results will also include topics containing matches such as "Added" and "Adding".

Contrary to Microsoft help systems, wildcards such as the question mark (?) and asterisk (*) are not supported by the documentation system search feature.

The search engine includes a list of stop words to filter out common structure-class words (i.e., function words) from search operations. This means the search engine excludes words (e.g., "an," "for," "of," and "the") by default. Search will not find matches for queries containing stop words in quotes. For example, if you search for the phrase "Pets are fun," search will only include topics with the words "pets" and "fun." This is because the word "are" is part of the stop word list.

Advanced search features

Logical search expressions

The logical operators AND, OR and ^ enable you to define your search precisely by relating several search terms.

Logical search expressions are evaluated left to right unless they contain parentheses (see below). The following table shows how you can use each of these operators.

To search forExampleTopics containing
Both terms in the same topicalarm AND #tBoth words 'alarm' and '#t'.
The symbol plus (+) and ampersand (&) can also be used. When separating keywords with a space, the AND is always inferred by the search engine.
Either term in a topicalarm OR #tThe word 'alarm' or the word '#t' or both. The symbol (|) can also be used.
The first term without the second termalarm ^ #tThe word 'alarm' but not the word '#t'.

Contrary to Microsoft help systems, operators NOT and NEAR are not supported.

Nested expressions

Nested expressions use parentheses '(...)' to construct complex searches.

The basic rules for searching help topics using nested expressions are as follows:

  • The expressions in parentheses are evaluated before the rest of the query.
  • The query is then evaluated from left to right.
  • You cannot nest expressions more than five levels deep, e.g. '(level_1...(level_2...(level_3...(level_4...(level_5...)))))'.
ExampleOperatorsTopics containing
alarm AND (display OR window)'AND', 'OR'The word 'alarm' along with the words 'display' or the word 'alarm'.