|
|
User:Lorinda/In-Progress
From NeoWiki
| Revision as of 03:21, 3 March 2007 (edit) Lorinda (Talk | contribs) ← Previous diff |
Current revision (19:16, 15 July 2007) (edit) (undo) Lorinda (Talk | contribs) (→Creating an Input Field (Optional) - polish) |
||
| (18 intermediate revisions not shown.) | |||
| Line 1: | Line 1: | ||
| - | [[ | + | Using Fields Without Data Sources |
| + | |||
| + | Sometimes you want to insert data such as name, address, etc. into a standard document without resorting to a data source. This article describes how to do so, using some of the many field types available in NeoOffice Writer. | ||
| + | |||
| + | ==Predefined Fields== | ||
| + | NeoOffice includes several pre-defined fields that can be easily entered into any document. These include: date, time, page number, and page count. To insert these fields: | ||
| + | *Click at the spot where you want the field inserted | ||
| + | *Go to the {{Menu|Insert}} menu and choose {{Menu|Fields}} | ||
| + | *Select the field type you want to insert | ||
| + | -->The field is inserted | ||
| + | <br> | ||
| + | |||
| + | ==Document Specific Fields== | ||
| + | NeoOffice also includes some fields that make use of information from the {{Window|Properties}} window. (You can set the document properties by going to the {{Menu|File}} menu and choosing {{Menu|Properties...}}.) Three of these fields are available directly from the menu bar by choosing the {{Menu|Insert}} menu and then {{Menu|Fields}}, following the instructions above. | ||
| + | |||
| + | More fields related to document properties are available by doing the following: | ||
| + | *Click at the spot where you want the field inserted | ||
| + | *Go to the {{Menu|Insert}} menu and choose {{Menu|Fields}} | ||
| + | *Choose {{Menu|Other...}} | ||
| + | :-->The {{Window|Fields}} window opens | ||
| + | *Click on the {{Section|Document}} or {{Section|DocInformation}} tab near the top of the menu. | ||
| + | :''Which tab you need will depend on which field you want to insert.'' | ||
| + | *Select the type of field you want from the {{Section|Type}} column. | ||
| + | *If necessary, choose the specific field from the {{Section|Select}} column. | ||
| + | *If needed, select the desired format from the {{Section|Format}} column. | ||
| + | |||
| + | ''N.B. Not all the fields available in these two tabs are from the {{Window|Document Properties}} window. Some of the fields in these two tabs are discussed elsewhere in this wiki. See [[#Related Links|Related Links]] below. '' | ||
| + | <br> | ||
| + | |||
| + | ==User Fields== | ||
| + | |||
| + | You can also insert User-defined fields. To do so; | ||
| + | |||
| + | *Under the {{Menu|Insert}} Menu, choose {{Menu|Fields}} and then {{Menu|Other...}} | ||
| + | *Click on the {{Section|Variables}} tab | ||
| + | *Select {{prefName|User Field}} in the {{Section|Type}} column | ||
| + | *Choose the desired field format in the {{Section|Format}} column | ||
| + | **-->''Note that {{prefName|Additional formats...}} opens a dialog box allowing you to choose other formats, include date formats.'' | ||
| + | *Enter a {{prefName|Name}} for the field in the appropriate box | ||
| + | **-->''Note that there cannot by any spaces in the field name.'' | ||
| + | *Click on the green check symbol to create (but not insert) the field | ||
| + | **-->To delete a field from the list, select it in the {{Section|Selection}} and click on the red x. | ||
| + | *To insert the field at the cursor point, click on the {{Button|Insert}} | ||
| + | **-->''If you want the field contents to be hidden in the document, check the {{prefName|Invisible}} box before clicking {{Button|Insert}}. | ||
| + | *Create as many fields as needed, then click {{Button|Close}} | ||
| + | <br> | ||
| + | |||
| + | ==Input Fields== | ||
| + | |||
| + | Input fields are special fields tied to another field type. When a new document is created from a template, the user will be asked to fill in the values for all the input fields. To use Input Fields: | ||
| + | |||
| + | *Create [[#User Fields|User Fields]] as described above | ||
| + | ::''Note that Input Fields can also relate to Set Variables'' | ||
| + | *While the {{Window|Fields}} is still open, select {{prefName|InputField}} in the {{Section|Type}} column. | ||
| + | *Choose the User Field (or Variable) to which the Input Field is to be linked | ||
| + | *Enter a description in the {{prefName|Reference}} box. This is the prompt that will be shown when a user is asked to provide the value for this field. | ||
| + | *Make sure the cursor is where you want the input field to appear (usually the first place the User Field or Variable in question needs to occur in the document) | ||
| + | *Click on {{Button|OK}} | ||
| + | *Thereafter in the document, insert a "plain" User Field or Variable for that field. Whenever the Insert Field is updated, the related User Fields (or Variables) will be updated, too. | ||
| + | <br> | ||
| + | ''N.B. Due to an OpenOffice.org bug, Input Fields relating to User Fields defined as dates will not retain the correct date or formatting. It will also corrupt any related User Fields inserted in the document. Therefore do not use Input Fields with User Fields defined as dates. User Fields defined as dates work correctly as long as you do not insert a related Input Field in the document. | ||
| + | |||
| + | ==Formatting Fields== | ||
| + | To format the way a field appears in your document, right-click or control-click on the field and choose {{Menu|Fields...}} from the contextual menu. A dialog box will appear, allowing you to modify the appearance of the field. | ||
| + | <br> | ||
| + | ===Concerning Date Fields=== | ||
| + | In the {{Window|Edit Fields}} window for Date fields, you will have a choice between Date (fixed) and Date. Date (fixed) will insert today's date, or a date with a specified offset from today. That date will remain fixed, regardless of when the document is opened. Date will insert a date that is updated each time the document is opened. | ||
| + | <br> | ||
| + | |||
| + | ==Conditional Fields== | ||
| + | |||
| + | Conditional fields let you specify one of two values or text strings to use in a document, depending on the value of a related Variable. For example, a pastor might have a funeral liturgy with conditional fields inserted to supply the correct pronoun, depending on the gender of the deceased. | ||
| + | |||
| + | ===Setting the Variable=== | ||
| + | The first thing you need to do is define and set the variable to be used in the condition. | ||
| + | *Under the {{menu|Insert}} menu, choose {{menu|Fields}} and then {{menu|Other}} (Or simply press {{Key|Command-F2}}) | ||
| + | *Click on the {{section|Variables}} tab and choose {{prefName|Set Variable}}. | ||
| + | *Type a name for the variable in the {{prefName|Name}} box and a value in the {{prefName|Name}} box | ||
| + | *If you don't want the variable to be visible, you may check the {{prefName|Invisble}} box. | ||
| + | *Click {{Button|Insert}} | ||
| + | |||
| + | ===Creating an Input Field (Optional)=== | ||
| + | If desired, you may insert an Input field tied to this variable, so that users are asked for the value of the variable when a new document is created based on this template. Use the method specified in the [[#Input Fields]] section above. Once you have created and inserted the Input field for your variable, you may delete the "plain" variable field from the document. (But be sure to leave the input field in the document). | ||
| + | |||
| + | ===Creating the Conditional Field=== | ||
| + | *Make sure the cursor is place where you what the conditional field to appear. | ||
| + | *Under the {{Menu|Insert}} menu, choose {{Menu|Fields}} and then {{Menu|Other...}} | ||
| + | *Click on the {{Section|Functions}} tab | ||
| + | *Click on {{prefName|Conditional text}} in the {{Section|Type}} column | ||
| + | *Type the condition in the {{prefName|Condition}} box. For example: Gender=="Male" | ||
| + | :''-->For a guide to condition syntax, go to the {{Menu|Help}} menu, choose {{Menu|NeoOffice Help}} and type <tt>Conditions and Variables</tt> into the {{prefName|Search Term}} box.'' | ||
| + | *In the {{prefName|Then}} box, enter the value you want if the condition is true. For example: he | ||
| + | *In the {{prefName|Else}} box, enter, the value you want if the condition is false. For example: she | ||
| + | *Click {{Button|Insert}} | ||
| + | |||
| + | ==Related Links== | ||
| + | :[[How to Add Page Numbers]] | ||
| + | :[[Cross-references in NeoOffice Writer|References in NeoOffice Writer]] | ||
| + | :[[Cross-references in a Master Document|References in a Master Document]] | ||
| + | |||
| + | ==Related External Links== | ||
| + | [http://trinity.neooffice.org/modules.php?name=Forums&file=viewtopic&t=3739&highlight=fields Brief discussion of Input and User Fields at trinity]<br> | ||
| + | [http://www.oooforum.org/forum/viewtopic.phtml?t=48211&highlight=input+field A thread on Input and User Fields at the OpenOffice.org Forum] (This is the same thread referred to in the trinity link above)<br> | ||
| + | [http://searchenterpriselinux.techtarget.com/tip/0,289483,sid39_gci1191662,00.html Skip the User Fields...] An article by Solveig Haugland describing how to use XML Forms instead of Input Fields. Part-way through the article there is a link to a PDF files with instructions for Input Fields.<br> | ||
| + | |||
| + | A series of articles on fields by Bruce Byfield: | ||
| + | :[http://www.linuxjournal.com/article/8071 Fielding Questions, Part 1 - The Basics]<br> | ||
| + | :[http://www.linuxjournal.com/article/8112 Fielding Questions, Part 2 - Cross References and User-Defined Fields]<br> | ||
| + | :[http://www.linuxjournal.com/article/8154 Fielding Questions, Part 3]<br> | ||
| + | :[http://www.linuxjournal.com/article/8238 Fielding Questions, Part 4 - Mail Merges] | ||
Current revision
Using Fields Without Data Sources
Sometimes you want to insert data such as name, address, etc. into a standard document without resorting to a data source. This article describes how to do so, using some of the many field types available in NeoOffice Writer.
Contents |
Predefined Fields
NeoOffice includes several pre-defined fields that can be easily entered into any document. These include: date, time, page number, and page count. To insert these fields:
- Click at the spot where you want the field inserted
- Go to the Insert menu and choose Fields
- Select the field type you want to insert
-->The field is inserted
Document Specific Fields
NeoOffice also includes some fields that make use of information from the Properties window. (You can set the document properties by going to the File menu and choosing Properties....) Three of these fields are available directly from the menu bar by choosing the Insert menu and then Fields, following the instructions above.
More fields related to document properties are available by doing the following:
- Click at the spot where you want the field inserted
- Go to the Insert menu and choose Fields
- Choose Other...
- -->The Fields window opens
- Click on the Document or DocInformation tab near the top of the menu.
- Which tab you need will depend on which field you want to insert.
- Select the type of field you want from the Type column.
- If necessary, choose the specific field from the Select column.
- If needed, select the desired format from the Format column.
N.B. Not all the fields available in these two tabs are from the Document Properties window. Some of the fields in these two tabs are discussed elsewhere in this wiki. See Related Links below.
User Fields
You can also insert User-defined fields. To do so;
- Under the Insert Menu, choose Fields and then Other...
- Click on the Variables tab
- Select User Field in the Type column
- Choose the desired field format in the Format column
- -->Note that Additional formats... opens a dialog box allowing you to choose other formats, include date formats.
- Enter a Name for the field in the appropriate box
- -->Note that there cannot by any spaces in the field name.
- Click on the green check symbol to create (but not insert) the field
- -->To delete a field from the list, select it in the Selection and click on the red x.
- To insert the field at the cursor point, click on the Insert
- -->If you want the field contents to be hidden in the document, check the Invisible box before clicking Insert.
- Create as many fields as needed, then click Close
Input Fields
Input fields are special fields tied to another field type. When a new document is created from a template, the user will be asked to fill in the values for all the input fields. To use Input Fields:
- Create User Fields as described above
- Note that Input Fields can also relate to Set Variables
- While the Fields is still open, select InputField in the Type column.
- Choose the User Field (or Variable) to which the Input Field is to be linked
- Enter a description in the Reference box. This is the prompt that will be shown when a user is asked to provide the value for this field.
- Make sure the cursor is where you want the input field to appear (usually the first place the User Field or Variable in question needs to occur in the document)
- Click on OK
- Thereafter in the document, insert a "plain" User Field or Variable for that field. Whenever the Insert Field is updated, the related User Fields (or Variables) will be updated, too.
N.B. Due to an OpenOffice.org bug, Input Fields relating to User Fields defined as dates will not retain the correct date or formatting. It will also corrupt any related User Fields inserted in the document. Therefore do not use Input Fields with User Fields defined as dates. User Fields defined as dates work correctly as long as you do not insert a related Input Field in the document.
Formatting Fields
To format the way a field appears in your document, right-click or control-click on the field and choose Fields... from the contextual menu. A dialog box will appear, allowing you to modify the appearance of the field.
Concerning Date Fields
In the Edit Fields window for Date fields, you will have a choice between Date (fixed) and Date. Date (fixed) will insert today's date, or a date with a specified offset from today. That date will remain fixed, regardless of when the document is opened. Date will insert a date that is updated each time the document is opened.
Conditional Fields
Conditional fields let you specify one of two values or text strings to use in a document, depending on the value of a related Variable. For example, a pastor might have a funeral liturgy with conditional fields inserted to supply the correct pronoun, depending on the gender of the deceased.
Setting the Variable
The first thing you need to do is define and set the variable to be used in the condition.
- Under the Insert menu, choose Fields and then Other (Or simply press Command-F2)
- Click on the Variables tab and choose Set Variable.
- Type a name for the variable in the Name box and a value in the Name box
- If you don't want the variable to be visible, you may check the Invisble box.
- Click Insert
Creating an Input Field (Optional)
If desired, you may insert an Input field tied to this variable, so that users are asked for the value of the variable when a new document is created based on this template. Use the method specified in the #Input Fields section above. Once you have created and inserted the Input field for your variable, you may delete the "plain" variable field from the document. (But be sure to leave the input field in the document).
Creating the Conditional Field
- Make sure the cursor is place where you what the conditional field to appear.
- Under the Insert menu, choose Fields and then Other...
- Click on the Functions tab
- Click on Conditional text in the Type column
- Type the condition in the Condition box. For example: Gender=="Male"
- -->For a guide to condition syntax, go to the Help menu, choose NeoOffice Help and type Conditions and Variables into the Search Term box.
- In the Then box, enter the value you want if the condition is true. For example: he
- In the Else box, enter, the value you want if the condition is false. For example: she
- Click Insert
Related Links
Related External Links
Brief discussion of Input and User Fields at trinity
A thread on Input and User Fields at the OpenOffice.org Forum (This is the same thread referred to in the trinity link above)
Skip the User Fields... An article by Solveig Haugland describing how to use XML Forms instead of Input Fields. Part-way through the article there is a link to a PDF files with instructions for Input Fields.
A series of articles on fields by Bruce Byfield:
