Writer/Input Fields

From Apache OpenOffice Wiki
< Writer
Revision as of 11:05, 6 November 2013 by Od (Talk | contribs)

Jump to: navigation, search

Writer Icon.png

Writer Project

Please view the guidelines
before contributing.

Popular Subcategories:

Internal Documentation:

API Documentation:

Ongoing Efforts:

Sw.OpenOffice.org


In-place editing of Input Fields

Purpose of this page is provide information on the solution for Issue 33737 . This information should serve the corresponding quality assurance efforts. It can be also used as the source for the corresponding user interface changes for the users.


Input Fields - three of a kind

We have three fields which are all named 'Input Field' in the user interface each for different purpose.

Text Input Field

This is a field to prompt the user for an input. The field has a description and its content holds the user's input.

In the OpenDocument file format (ODF) such a field is represented by ODF element <text:text-input>.

When importing Microsoft Word documents (binary file format, *.doc) Microsoft Word fields FILLIN and FORMTEXT are imported as Text Input Fields.

The user interface to create such a field is found in the Fields dialog (Menu - Insert - Fields - Others) on pane Functions. Here the user has to choose Type 'Input Field'.

dialog to create Text Input Field


User Variable Input Field

This is a field to prompt the user to set the value of a user variable. The value of a user variable is the same throughout the complete document.

In ODF such a field is represented by ODF element <text:user-field-input>.

Microsoft Word has support for so-called Document Variables. The value of such variables can be shown in a Microsoft Word document, but are created/deleted/set via Microsoft Word macro (aka Visual Basic). These Document Variables seem to be comparable with ODF's User Variables, but currently there is no mapping between these in OpenOffice. A User Variable Input Field is treated as Text Input Field when exporting an OpenOffice text document to the Microsoft Word binary format.

The user interface to create such a field is found in the Fields dialog on pane Variables. In advance the user has to create a user field. Then the user has to choose Type 'Input Field' and has to select the corresponding created user variable.

dialog to create User Variable and a corresponding User Variable Text Input Field


Simple Variable Input Field

This is a field to prompt the user to set the value of a simple variable. The value of a simple variable at a certain document position equals the value of the last set value - that is the difference to a user variable.

In ODF such a field is represented by ODF element <text:variable-input>.

The user interface to create such a field is found in the Fields dialog on pane Variables. In advance the user has to create a simple variable. Then the user has to choose Type 'Input Field' and has to select the corresponding created simple variable.

dialog to create Simple Variable and a corresponding Simple Variable Text Input Field



Changes in detail

Areas affected by the changes

Personal tools