Visual Forms-Based Configuration File Editor

The visual, forms-based editor for LiveView configuration files is a validating XML editor that is aware of the schema that defines the XML syntax of LiveView configuration files. The visual editor is the default editor for new and existing lvconf files.

The visual editor presents the lvconf file under edit as a form with fields to be filled in, in one or more tabs. Edits made in the fields of any tab are automatically reflected in the underlying XML source file. You can view the XML source any time using the Source tab.

The visual editor reads and stores the same XSD-defined XML format as the text-based editor, but greatly improves and accelerates your ability to create and maintain lvconf files without constant reference to the XSD specification in the LiveView Configuration XML Reference.

Each lvconf type has its own form; when creating a new lvconf file, you specify the lvconf table type, which determines the form to use:

Every field has pop-up help text when you hover the pointer in or over each field. This is the same help text found in the lvconf XSD specification reference.

The valid features for each lvconf type are organized into tabs along the bottom of the visual editor window. The last tab for each form provides a Source view, which allows you to view and edit the underlying XML file you are editing. Edits made in the Source view are immediately reflected on the forms tabs. However, the Source view is not itself a validating XML editor, but relies on the various forms tabs to validate the lvconf file being edited.

You can use the Source tab (or the text-based XML editor) to enter the elements of advanced features that are not supported with a form field in the visual editor. As long as the elements and attributes you enter are valid against the lvconf XSD file, they are accepted by the visual editor, even when there is no form to display such changes.

There are two exceptions to this rule: the visual editor does not support either XML comments or xinclude processing instructions.

  • If any lvconf file in your existing projects includes XML comments in <!-- --> blocks, such comments are not preserved when the lvconf file is opened and saved in the visual editor.

    You can continue to use the description and short-description attributes of the <data-table> element to annotate your files, using the Description and Short Description fields on the Data Table tab of the visual editor.

  • The visual lvconf editor does not support the xinclude processing instruction described in Using xinclude Processing Instructions.

    When you open an lvconf file that Xincludes another XML file, Studio shows the following warning message. When you click OK, Studio opens the file in the text-based validating XML editor, and marks the file to open again in that editor the next time you open it.

For features not supported by the visual lvconf edtor, the text-based validating XML editor is still available. To access the validating text-based XML editor directly, select an lvconf file in the Package Explorer view, right-click, and select Open WithLiveView Confguration XML Editor.