1<?xml version="1.0" encoding="UTF-8"?> 2 3<!--*********************************************************** 4 * 5 * Licensed to the Apache Software Foundation (ASF) under one 6 * or more contributor license agreements. See the NOTICE file 7 * distributed with this work for additional information 8 * regarding copyright ownership. The ASF licenses this file 9 * to you under the Apache License, Version 2.0 (the 10 * "License"); you may not use this file except in compliance 11 * with the License. You may obtain a copy of the License at 12 * 13 * http://www.apache.org/licenses/LICENSE-2.0 14 * 15 * Unless required by applicable law or agreed to in writing, 16 * software distributed under the License is distributed on an 17 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 18 * KIND, either express or implied. See the License for the 19 * specific language governing permissions and limitations 20 * under the License. 21 * 22 ***********************************************************--> 23 24<helpdocument version="1.0"> 25<meta> 26<topic id="textshared0201170201xml" indexer="include" status="PUBLISH"> 27<title id="tit" xml-lang="en-US">General</title> 28<filename>/text/shared/02/01170201.xhp</filename> 29</topic> 30</meta> 31<body> 32<section id="allgemein"> 33<bookmark xml-lang="en-US" branch="index" id="bm_id3152551"><bookmark_value>submitting forms</bookmark_value> 34<bookmark_value>get method for form transmissions</bookmark_value> 35<bookmark_value>post method for form transmissions</bookmark_value> 36</bookmark> 37<paragraph role="heading" id="hd_id3151100" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/shared/02/01170201.xhp" name="General">General</link></paragraph> 38</section> 39<section id="howtoget"> 40<embed href="text/shared/00/00040501.xhp#formulareigenschaftenallgemein"/> 41</section> 42<paragraph role="paragraph" id="par_id3153539" xml-lang="en-US" l10n="U" oldref="23">A form is a text document or spreadsheet with different form controls. If you create a form for a Web page, the user can enter data into it to send over the Internet. The data from the form controls of a form is transmitted to a server by specifying a URL and can be processed on the server.</paragraph> 43<paragraph role="heading" id="hd_id3149283" xml-lang="en-US" level="2" l10n="U" oldref="20">Name</paragraph> 44<paragraph role="paragraph" id="par_id3150789" xml-lang="en-US" l10n="U" oldref="24">Specifies a name for the form. This name is used to identify the form in the <link href="text/shared/02/01170600.xhp" name="Form Navigator">Form Navigator</link>.</paragraph> 45<paragraph role="heading" id="hd_id3152425" xml-lang="en-US" level="2" l10n="U" oldref="33">URL</paragraph> 46<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="34">Specifies the URL to which the data of the completed form is to be transmitted.</paragraph> 47<paragraph role="heading" id="hd_id3154751" xml-lang="en-US" level="2" l10n="U" oldref="31">Frame</paragraph> 48<paragraph role="paragraph" id="par_id3154823" xml-lang="en-US" l10n="U" oldref="32">Defines the target frame in which the loaded URL is to appear.</paragraph> 49<embed href="text/shared/02/01170101.xhp#fuerformulareigenschaft"/> 50<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SUBMIT_METHOD" id="bm_id3145313" localize="false"/> 51<paragraph role="heading" id="hd_id3152551" xml-lang="en-US" level="2" l10n="U" oldref="27">Type of submission</paragraph> 52<paragraph role="paragraph" id="par_id3155338" xml-lang="en-US" l10n="U" oldref="28"><ahelp hid="HID_PROP_SUBMIT_METHOD">Specifies the method to transfer the completed form information.</ahelp></paragraph> 53<paragraph role="paragraph" id="par_id3145065" xml-lang="en-US" l10n="U" oldref="29">Using the "Get" method, the data of every control is transmitted as an environment variable. They are appended to the URL in the form "?Control1=Content1&Control2=Content2&..."; the character string is analyzed by a program on the recipient's server.</paragraph> 54<paragraph role="paragraph" id="par_id3150443" xml-lang="en-US" l10n="U" oldref="30">Using the "Post" method, a document is created from the content of the form that is sent to the specified URL.</paragraph> 55<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SUBMIT_ENCODING" id="bm_id3154047" localize="false"/> 56<paragraph role="heading" id="hd_id3147275" xml-lang="en-US" level="2" l10n="U" oldref="26">Submission encoding</paragraph> 57<paragraph role="paragraph" id="par_id3159147" xml-lang="en-US" l10n="U" oldref="35"><ahelp hid="HID_PROP_SUBMIT_ENCODING">Specifies the type for encoding the data transfer.</ahelp></paragraph> 58<paragraph role="heading" id="hd_id3155419" xml-lang="en-US" level="2" l10n="U" oldref="36">Data transfer of control information</paragraph> 59<paragraph role="paragraph" id="par_id3153717" xml-lang="en-US" l10n="U" oldref="37">When sending a form, all controls available in $[officename] are taken into consideration. The name of the control and the corresponding value, if available, are transmitted.</paragraph> 60<paragraph role="paragraph" id="par_id3153252" xml-lang="en-US" l10n="U" oldref="50">Which values are transmitted in each case depends on the respective control. For text fields, the visible entries are transmitted; for list boxes, the selected entries are transmitted; for check boxes and option fields, the associated reference values are transmitted if these fields were activated.</paragraph> 61<paragraph role="paragraph" id="par_id3150984" xml-lang="en-US" l10n="U" oldref="51">How this information is transmitted depends on the selected transfer method (Get or Post) and the coding (URL or Multipart). If the Get method and URL encoding are selected, for example, value pairs in the form <Name>=<Value> are sent.</paragraph> 62<paragraph role="paragraph" id="par_id3157909" xml-lang="en-US" l10n="U" oldref="52">In addition to the controls that are recognized in HTML, $[officename] offers other controls. It should be noted that, for fields with a specific numerical format, the visible values are not transmitted but rather fixed default formats. The following table shows how the data of the $[officename]-specific controls is transmitted:</paragraph> 63<table id="tbl_id3156326"> 64<tablerow> 65<tablecell colspan="" rowspan=""> 66<paragraph role="tablehead" id="par_id3153698" xml-lang="en-US" l10n="U" oldref="38">Control</paragraph> 67</tablecell> 68<tablecell colspan="" rowspan=""> 69<paragraph role="tablehead" id="par_id3153562" xml-lang="en-US" l10n="U" oldref="39">Value Pair</paragraph> 70</tablecell> 71</tablerow> 72<tablerow> 73<tablecell colspan="" rowspan=""> 74<paragraph role="tablecontent" id="par_id3153823" xml-lang="en-US" l10n="U" oldref="40">Numeric field, currency field</paragraph> 75</tablecell> 76<tablecell colspan="" rowspan=""> 77<paragraph role="tablecontent" id="par_id3149734" xml-lang="en-US" l10n="U" oldref="41">A decimal separator is always displayed as a period.</paragraph> 78</tablecell> 79</tablerow> 80<tablerow> 81<tablecell colspan="" rowspan=""> 82<paragraph role="tablecontent" id="par_id3148563" xml-lang="en-US" l10n="U" oldref="42">Date field</paragraph> 83</tablecell> 84<tablecell colspan="" rowspan=""> 85<paragraph role="tablecontent" id="par_id3146794" xml-lang="en-US" l10n="U" oldref="43">The date format is sent in a fixed format (MM-DD-YYYY), regardless of the user's local settings.</paragraph> 86</tablecell> 87</tablerow> 88<tablerow> 89<tablecell colspan="" rowspan=""> 90<paragraph role="tablecontent" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="44">Time field</paragraph> 91</tablecell> 92<tablecell colspan="" rowspan=""> 93<paragraph role="tablecontent" id="par_id3153779" xml-lang="en-US" l10n="U" oldref="45">The time format is sent in a fixed format (HH:MM:SS), regardless of the user's local settings.</paragraph> 94</tablecell> 95</tablerow> 96<tablerow> 97<tablecell colspan="" rowspan=""> 98<paragraph role="tablecontent" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="46">Pattern field</paragraph> 99</tablecell> 100<tablecell colspan="" rowspan=""> 101<paragraph role="tablecontent" id="par_id3145419" xml-lang="en-US" l10n="U" oldref="47">The values of pattern fields are sent as text fields, that is, the value visible in the form is sent.</paragraph> 102</tablecell> 103</tablerow> 104<tablerow> 105<tablecell colspan="" rowspan=""> 106<paragraph role="tablecontent" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="48">Table control</paragraph> 107</tablecell> 108<tablecell colspan="" rowspan=""> 109<paragraph role="tablecontent" id="par_id3152933" xml-lang="en-US" l10n="U" oldref="49">From the table control, the individual columns are always transmitted. The name of the control, the name of the column, and the value of the column are sent. Using the Get method with URL encoding, the transmission is done in the form <Name of the table control>.<Name of the column>=<Value>, for example, with the value being dependent on the column.</paragraph> 110</tablecell> 111</tablerow> 112</table> 113</body> 114</helpdocument> 115