1*b1cdbd2cSJim Jagielski<?xml version="1.0" encoding="UTF-8"?> 2*b1cdbd2cSJim Jagielski 3*b1cdbd2cSJim Jagielski 4*b1cdbd2cSJim Jagielski<!--*********************************************************** 5*b1cdbd2cSJim Jagielski * 6*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 7*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 8*b1cdbd2cSJim Jagielski * distributed with this work for additional information 9*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 10*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 11*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 12*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 13*b1cdbd2cSJim Jagielski * 14*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 15*b1cdbd2cSJim Jagielski * 16*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 17*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 18*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 19*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 20*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 21*b1cdbd2cSJim Jagielski * under the License. 22*b1cdbd2cSJim Jagielski * 23*b1cdbd2cSJim Jagielski ***********************************************************--> 24*b1cdbd2cSJim Jagielski 25*b1cdbd2cSJim Jagielski 26*b1cdbd2cSJim Jagielski 27*b1cdbd2cSJim Jagielski<helpdocument version="1.0"> 28*b1cdbd2cSJim Jagielski<meta> 29*b1cdbd2cSJim Jagielski<topic id="textshared0201170201xml" indexer="include" status="PUBLISH"> 30*b1cdbd2cSJim Jagielski<title id="tit" xml-lang="en-US">General</title> 31*b1cdbd2cSJim Jagielski<filename>/text/shared/02/01170201.xhp</filename> 32*b1cdbd2cSJim Jagielski</topic> 33*b1cdbd2cSJim Jagielski<history> 34*b1cdbd2cSJim Jagielski<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> 35*b1cdbd2cSJim Jagielski<lastedited date="2004-09-13T11:25:19">converted from old format - fpe</lastedited> 36*b1cdbd2cSJim Jagielski</history> 37*b1cdbd2cSJim Jagielski</meta> 38*b1cdbd2cSJim Jagielski<body> 39*b1cdbd2cSJim Jagielski<section id="allgemein"> 40*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="index" id="bm_id3152551"><bookmark_value>submitting forms</bookmark_value> 41*b1cdbd2cSJim Jagielski<bookmark_value>get method for form transmissions</bookmark_value> 42*b1cdbd2cSJim Jagielski<bookmark_value>post method for form transmissions</bookmark_value> 43*b1cdbd2cSJim Jagielski</bookmark> 44*b1cdbd2cSJim Jagielski<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> 45*b1cdbd2cSJim Jagielski</section> 46*b1cdbd2cSJim Jagielski<section id="howtoget"> 47*b1cdbd2cSJim Jagielski <embed href="text/shared/00/00040501.xhp#formulareigenschaftenallgemein"/> 48*b1cdbd2cSJim Jagielski</section> 49*b1cdbd2cSJim Jagielski<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> 50*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3149283" xml-lang="en-US" level="2" l10n="U" oldref="20">Name</paragraph> 51*b1cdbd2cSJim Jagielski<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> 52*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3152425" xml-lang="en-US" level="2" l10n="U" oldref="33">URL</paragraph> 53*b1cdbd2cSJim Jagielski<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> 54*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3154751" xml-lang="en-US" level="2" l10n="U" oldref="31">Frame</paragraph> 55*b1cdbd2cSJim Jagielski<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> 56*b1cdbd2cSJim Jagielski<embed href="text/shared/02/01170101.xhp#fuerformulareigenschaft"/> 57*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SUBMIT_METHOD" id="bm_id3145313" localize="false"/> 58*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3152551" xml-lang="en-US" level="2" l10n="U" oldref="27">Type of submission</paragraph> 59*b1cdbd2cSJim Jagielski<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> 60*b1cdbd2cSJim Jagielski<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> 61*b1cdbd2cSJim Jagielski<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> 62*b1cdbd2cSJim Jagielski<bookmark xml-lang="en-US" branch="hid/EXTENSIONS_HID_PROP_SUBMIT_ENCODING" id="bm_id3154047" localize="false"/> 63*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3147275" xml-lang="en-US" level="2" l10n="U" oldref="26">Submission encoding</paragraph> 64*b1cdbd2cSJim Jagielski<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> 65*b1cdbd2cSJim Jagielski<paragraph role="heading" id="hd_id3155419" xml-lang="en-US" level="2" l10n="U" oldref="36">Data transfer of control information</paragraph> 66*b1cdbd2cSJim Jagielski<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> 67*b1cdbd2cSJim Jagielski<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> 68*b1cdbd2cSJim Jagielski<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> 69*b1cdbd2cSJim Jagielski<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> 70*b1cdbd2cSJim Jagielski<table id="tbl_id3156326"> 71*b1cdbd2cSJim Jagielski<tablerow> 72*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 73*b1cdbd2cSJim Jagielski<paragraph role="tablehead" id="par_id3153698" xml-lang="en-US" l10n="U" oldref="38">Control</paragraph> 74*b1cdbd2cSJim Jagielski</tablecell> 75*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 76*b1cdbd2cSJim Jagielski<paragraph role="tablehead" id="par_id3153562" xml-lang="en-US" l10n="U" oldref="39">Value Pair</paragraph> 77*b1cdbd2cSJim Jagielski</tablecell> 78*b1cdbd2cSJim Jagielski</tablerow> 79*b1cdbd2cSJim Jagielski<tablerow> 80*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 81*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3153823" xml-lang="en-US" l10n="U" oldref="40">Numeric field, currency field</paragraph> 82*b1cdbd2cSJim Jagielski</tablecell> 83*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 84*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3149734" xml-lang="en-US" l10n="U" oldref="41">A decimal separator is always displayed as a period.</paragraph> 85*b1cdbd2cSJim Jagielski</tablecell> 86*b1cdbd2cSJim Jagielski</tablerow> 87*b1cdbd2cSJim Jagielski<tablerow> 88*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 89*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3148563" xml-lang="en-US" l10n="U" oldref="42">Date field</paragraph> 90*b1cdbd2cSJim Jagielski</tablecell> 91*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 92*b1cdbd2cSJim Jagielski<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> 93*b1cdbd2cSJim Jagielski</tablecell> 94*b1cdbd2cSJim Jagielski</tablerow> 95*b1cdbd2cSJim Jagielski<tablerow> 96*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 97*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3149670" xml-lang="en-US" l10n="U" oldref="44">Time field</paragraph> 98*b1cdbd2cSJim Jagielski</tablecell> 99*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 100*b1cdbd2cSJim Jagielski<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> 101*b1cdbd2cSJim Jagielski</tablecell> 102*b1cdbd2cSJim Jagielski</tablerow> 103*b1cdbd2cSJim Jagielski<tablerow> 104*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 105*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3153361" xml-lang="en-US" l10n="U" oldref="46">Pattern field</paragraph> 106*b1cdbd2cSJim Jagielski</tablecell> 107*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 108*b1cdbd2cSJim Jagielski<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> 109*b1cdbd2cSJim Jagielski</tablecell> 110*b1cdbd2cSJim Jagielski</tablerow> 111*b1cdbd2cSJim Jagielski<tablerow> 112*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 113*b1cdbd2cSJim Jagielski<paragraph role="tablecontent" id="par_id3150767" xml-lang="en-US" l10n="U" oldref="48">Table control</paragraph> 114*b1cdbd2cSJim Jagielski</tablecell> 115*b1cdbd2cSJim Jagielski<tablecell colspan="" rowspan=""> 116*b1cdbd2cSJim Jagielski<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> 117*b1cdbd2cSJim Jagielski</tablecell> 118*b1cdbd2cSJim Jagielski</tablerow> 119*b1cdbd2cSJim Jagielski</table> 120*b1cdbd2cSJim Jagielski 121*b1cdbd2cSJim Jagielski</body> 122*b1cdbd2cSJim Jagielski</helpdocument> 123