blob: 58bf5c5a1ad612204b1e8f4d828988f085645df9 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--***********************************************************
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
***********************************************************-->
<helpdocument version="1.0">
<meta>
<topic id="textsharedguidexformsxml" indexer="include" status="PUBLISH">
<title xml-lang="en-US" id="tit">XML Form Documents (XForms)</title>
<filename>/text/shared/guide/xforms.xhp</filename>
</topic>
</meta>
<body>
<section id="xforms">
<bookmark xml-lang="en-US" branch="index" id="bm_id5215613"><bookmark_value>web documents;XForms</bookmark_value>
<bookmark_value>forms;XForms</bookmark_value>
<bookmark_value>XML Forms, see XForms</bookmark_value>
<bookmark_value>XForms;opening/editing</bookmark_value>
<bookmark_value>editing;XForms</bookmark_value>
<bookmark_value>opening;XForms</bookmark_value>
</bookmark>
<comment>MW made a cross-reference of "XML Forms" and made a two level entry of "XForms"</comment>
<paragraph xml-lang="en-US" id="par_idN106E5" role="heading" level="1" l10n="NEW"><link href="text/shared/guide/xforms.xhp">XML Form Documents (XForms)</link></paragraph>
<paragraph xml-lang="en-US" id="par_idN106F5" role="paragraph" l10n="NEW">XForms are a new type of web form that was developed by the World Wide Web Consortium. The XForm model is defined in Extensible Markup Language (XML). The model uses separate sections to describe what a form does and what a form looks like. You can view the specification for XForms at: <link href="http://www.w3.org/MarkUp/Forms/">http://www.w3.org/MarkUp/Forms/</link>.</paragraph>
</section>
<paragraph xml-lang="en-US" id="par_idN10746" role="heading" level="2" l10n="NEW">Working with XForms</paragraph>
<paragraph xml-lang="en-US" id="par_idN1074A" role="paragraph" l10n="NEW">In %PRODUCTNAME, an XForms document is a special type of Writer document. The Design Mode for an XForm document has additional toolbars and panes. </paragraph>
<paragraph xml-lang="en-US" id="par_idN1074D" role="paragraph" l10n="NEW">After you create and save an XForms document, you can open the document, fill out the form, and submit the changes to a server.</paragraph>
<paragraph xml-lang="en-US" id="par_idN10774" role="paragraph" l10n="NEW"><comment>What's the role of UBL?</comment><comment>We do not officially support exporting to XHTML - but should be possible using XSLT</comment></paragraph>
<paragraph xml-lang="en-US" id="par_idN10706" role="heading" level="2" l10n="NEW">To Create a New XForms Document</paragraph>
<list type="ordered">
<listitem>
<paragraph xml-lang="en-US" id="par_idN1070D" role="paragraph" l10n="NEW">Choose <emph>File - New - XML Form Document</emph>.</paragraph>
<paragraph xml-lang="en-US" id="par_idN10714" role="paragraph" l10n="NEW">The XForms design window opens in an empty Writer document.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10718" role="paragraph" l10n="NEW">Design your form.</paragraph>
</listitem>
</list>
<list type="unordered">
<listitem>
<paragraph xml-lang="en-US" id="par_idN1071E" role="paragraph" l10n="NEW">Insert a control, select the default model in the property browser, and enter a binding statement.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10722" role="paragraph" l10n="NEW">In the data navigator, add an element to the instance.</paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10726" role="paragraph" l10n="NEW">Load a new instance from an XML file and add controls to the relevant XML elements or attributes.</paragraph>
</listitem>
</list>
<paragraph xml-lang="en-US" id="par_idN10729" role="heading" level="2" l10n="NEW">To Open an XForms Document</paragraph>
<list type="unordered">
<listitem>
<paragraph xml-lang="en-US" id="par_idN10730" role="paragraph" l10n="NEW">Choose <emph>File - Open</emph> and select the XForms document. An XForm document has the same extension as a Writer text document (*.odt).</paragraph>
</listitem>
</list>
<paragraph xml-lang="en-US" id="par_idN10737" role="heading" level="2" l10n="NEW">To Edit an XForms Document</paragraph>
<paragraph xml-lang="en-US" id="par_idN1073B" role="paragraph" l10n="NEW">Open the XForms document and use the following toolbars and windows:</paragraph>
<list type="unordered">
<listitem>
<paragraph xml-lang="en-US" id="par_idN10741" role="paragraph" l10n="CHG"><link href="text/shared/main0226.xhp">Form Design toolbar</link></paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN10757" role="paragraph" l10n="NEW"><link href="text/shared/02/01170000.xhp">Form Controls toolbar</link></paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN1075F" role="paragraph" l10n="NEW"><link href="text/shared/01/xformsdata.xhp">Data Navigator</link></paragraph>
</listitem>
<listitem>
<paragraph xml-lang="en-US" id="par_idN1075B" role="paragraph" l10n="NEW"><link href="text/shared/02/01170600.xhp">Form Navigator</link></paragraph>
</listitem>
</list>
<paragraph xml-lang="en-US" id="par_idN10848" role="paragraph" l10n="NEW"><comment>UFI: currently only StarOffice can render and evaluate our XForms docs. Mozilla has announced a planned support recently. There may be plugins for other browsers. Should we tell the user?</comment></paragraph>
</body>
</helpdocument>