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="textshared0000000208xml" indexer="include" status="PUBLISH">
27<title id="tit" xml-lang="en-US">Text Import</title>
28<filename>/text/shared/00/00000208.xhp</filename>
29</topic>
30</meta>
31<body>
32<bookmark xml-lang="en-US" branch="hid/sc:ModalDialog:RID_SCDLG_ASCII" id="bm_id3148919" localize="false"/><paragraph role="heading" id="hd_id3150960" xml-lang="en-US" level="1" l10n="U" oldref="1">Text Import</paragraph>
33<paragraph role="paragraph" id="par_id3149987" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid="SC:MODALDIALOG:RID_SCDLG_ASCII">Sets the import options for delimited data.</ahelp></paragraph>
34<section id="howtoget">
35<embed href="text/shared/00/00000401.xhp#textimport"/>
36</section>
37<switch select="appl">
38<case select="CALC"><embed href="text/scalc/guide/csv_files.xhp#csv_files"/>
39<embed href="text/scalc/guide/csv_formula.xhp#csv_formula"/>
40</case>
41</switch>
42<paragraph role="heading" id="hd_id3147588" xml-lang="en-US" level="2" l10n="U" oldref="45">Import</paragraph>
43<bookmark xml-lang="en-US" branch="hid/sc:ListBox:RID_SCDLG_ASCII:LB_CHARSET" id="bm_id3155934" localize="false"/><paragraph role="heading" id="hd_id3154788" xml-lang="en-US" level="3" l10n="U" oldref="9">Character Set</paragraph>
44<paragraph role="paragraph" id="par_id3149495" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="SC:LISTBOX:RID_SCDLG_ASCII:LB_CHARSET">Specifies the character set to be used in the imported file.</ahelp></paragraph>
45<bookmark xml-lang="en-US" branch="hid/sc:ListBox:RID_SCDLG_ASCII:LB_CUSTOMLANG" id="bm_id315593499" localize="false"/><paragraph role="heading" id="hd_id315478899" xml-lang="en-US" level="3" l10n="NEW">Language</paragraph>
46<paragraph role="paragraph" id="par_id314949588" xml-lang="en-US" l10n="NEW"><ahelp hid=".">Determines how the number strings are imported.</ahelp></paragraph>
47<paragraph role="paragraph" id="par_id314949587" xml-lang="en-US" l10n="NEW">If Language is set to Default (for CSV import) or Automatic (for HTML import), Calc will use the globally set language. If Language is set to a specific language, that language will be used when importing numbers.</paragraph>
48<paragraph role="paragraph" id="par_id314949586" xml-lang="en-US" l10n="NEW">When importing an HTML document, the Language selection can conflict with the global HTML option <link href="text/shared/optionen/01030500.xhp" name="Use">Use 'English (USA)' locale for numbers</link>. The global HTML option is effective only when the Automatic language option is selected. If you select a specific language in the HTML Import Options dialog, the global HTML option is ignored.</paragraph>
49<bookmark xml-lang="en-US" branch="hid/sc:NumericField:RID_SCDLG_ASCII:NF_AT_ROW" id="bm_id3153377" localize="false"/><paragraph role="heading" id="hd_id3154894" xml-lang="en-US" level="3" l10n="U" oldref="47">From Row</paragraph>
50<paragraph role="paragraph" id="par_id3150247" xml-lang="en-US" l10n="U" oldref="48"><ahelp hid="SC:NUMERICFIELD:RID_SCDLG_ASCII:NF_AT_ROW">Specifies the row where you want to start the import.</ahelp> The rows are visible in the preview window at the bottom of the dialog.</paragraph>
51<paragraph role="heading" id="hd_id3149999" xml-lang="en-US" level="2" l10n="U" oldref="3">Separator Options</paragraph>
52<paragraph role="paragraph" id="par_id3149640" xml-lang="en-US" l10n="U" oldref="4">Specifies whether your data uses separators or fixed widths as delimiters.</paragraph>
53<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_ASCII:RB_FIXED" id="bm_id3153894" localize="false"/><paragraph role="heading" id="hd_id3156553" xml-lang="en-US" level="3" l10n="U" oldref="7">Fixed width</paragraph>
54<paragraph role="paragraph" id="par_id3150710" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_ASCII:RB_FIXED">Separates fixed-width data (equal number of characters) into columns.</ahelp> Click on the ruler in the preview window to set the width.</paragraph>
55<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_ASCII:RB_SEPARATED" id="bm_id3147043" localize="false"/><paragraph role="heading" id="hd_id3156560" xml-lang="en-US" level="3" l10n="U" oldref="5">Separated by</paragraph>
56<paragraph role="paragraph" id="par_id3145136" xml-lang="en-US" l10n="U" oldref="6"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_ASCII:RB_SEPARATED">Select the separator used in your data.</ahelp></paragraph>
57<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CKB_TAB" id="bm_id3153345" localize="false"/><paragraph role="heading" id="hd_id3147250" xml-lang="en-US" level="3" l10n="U" oldref="49">Tab</paragraph>
58<paragraph role="paragraph" id="par_id3147576" xml-lang="en-US" l10n="U" oldref="50"><ahelp hid="SC:CHECKBOX:RID_SCDLG_ASCII:CKB_TAB">Separates data delimited by tabs into columns.</ahelp></paragraph>
59<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CKB_SEMICOLON" id="bm_id3157959" localize="false"/><paragraph role="heading" id="hd_id3154317" xml-lang="en-US" level="3" l10n="U" oldref="51">Semicolon</paragraph>
60<paragraph role="paragraph" id="par_id3157863" xml-lang="en-US" l10n="U" oldref="52"><ahelp hid="SC:CHECKBOX:RID_SCDLG_ASCII:CKB_SEMICOLON">Separates data delimited by semicolons into columns.</ahelp></paragraph>
61<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CKB_COMMA" id="bm_id3147089" localize="false"/><paragraph role="heading" id="hd_id3145313" xml-lang="en-US" level="3" l10n="U" oldref="53">Comma</paragraph>
62<paragraph role="paragraph" id="par_id3150693" xml-lang="en-US" l10n="U" oldref="54"><ahelp hid="SC:CHECKBOX:RID_SCDLG_ASCII:CKB_COMMA">Separates data delimited by commas into columns.</ahelp></paragraph>
63<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CKB_SPACE" id="bm_id3109848" localize="false"/><paragraph role="heading" id="hd_id3163802" xml-lang="en-US" level="3" l10n="U" oldref="55">Space</paragraph>
64<paragraph role="paragraph" id="par_id3153663" xml-lang="en-US" l10n="U" oldref="56"><ahelp hid="SC:CHECKBOX:RID_SCDLG_ASCII:CKB_SPACE">Separates data delimited by spaces into columns.</ahelp></paragraph>
65<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CKB_OTHER" id="bm_id3149098" localize="false"/>
66<bookmark xml-lang="en-US" branch="hid/sc:Edit:RID_SCDLG_ASCII:ED_OTHER" id="bm_id3149801" localize="false"/><paragraph role="heading" id="hd_id3147335" xml-lang="en-US" level="3" l10n="U" oldref="57">Other</paragraph>
67<paragraph role="paragraph" id="par_id3156329" xml-lang="en-US" l10n="U" oldref="58"><ahelp hid="SC:EDIT:RID_SCDLG_ASCII:ED_OTHER">Separates data into columns using the custom separator that you specify. Note: The custom separator must also be contained in your data.</ahelp></paragraph>
68<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CB_ASONCE" id="bm_id3146807" localize="false"/><paragraph role="heading" id="hd_id3150978" xml-lang="en-US" level="3" l10n="U" oldref="59">Merge delimiters</paragraph>
69<paragraph role="paragraph" id="par_id3153827" xml-lang="en-US" l10n="U" oldref="60"><ahelp hid="SC:CHECKBOX:RID_SCDLG_ASCII:CB_ASONCE">Combines consecutive delimiters and removes blank data fields.</ahelp></paragraph>
70<bookmark xml-lang="en-US" branch="hid/sc:ComboBox:RID_SCDLG_ASCII:CB_TEXTSEP" id="bm_id3147619" localize="false"/><paragraph role="heading" id="hd_id3155341" xml-lang="en-US" level="3" l10n="U" oldref="15">Text delimiter</paragraph>
71<paragraph role="paragraph" id="par_id3156326" xml-lang="en-US" l10n="CHG" oldref="16"><ahelp hid="SC:COMBOBOX:RID_SCDLG_ASCII:CB_TEXTSEP">Select a character to delimit text data. You can can also enter a character in the text box.</ahelp></paragraph>
72<paragraph role="heading" id="hd_id315538811" xml-lang="en-US" level="2" l10n="NEW">Other options</paragraph>
73<paragraph role="paragraph" id="par_id315366511" xml-lang="en-US" l10n="NEW">Sets some other import options.</paragraph>
74<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CB_QUOTED_AS_TEXT" id="bm_id315790911" localize="false"/>
75<paragraph role="heading" id="hd_id314847411" xml-lang="en-US" level="3" l10n="NEW">Quoted fields as text</paragraph>
76<paragraph role="paragraph" id="par_id314995711" xml-lang="en-US" l10n="NEW"><ahelp hid=".">When this option is enabled, fields or cells whose values are quoted in their entirety (the first and last characters of the value equal the text delimiter) are imported as text.</ahelp></paragraph>
77<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_ASCII:CB_DETECT_SPECIAL_NUMBER" id="bm_id315790922" localize="false"/>
78<paragraph role="heading" id="hd_id314847422" xml-lang="en-US" level="3" l10n="NEW">Detect special numbers</paragraph>
79<paragraph role="paragraph" id="par_id314995722" xml-lang="en-US" l10n="NEW"><ahelp hid=".">When this option is enabled, Calc will automatically detect all number formats, including special number formats such as dates, time, and scientific notation.</ahelp></paragraph>
80<paragraph role="paragraph" id="par_id314995723" xml-lang="en-US" l10n="NEW">The selected language influences how such special numbers are detected, since different languages and regions many have different conventions for such special numbers.</paragraph>
81<paragraph role="paragraph" id="par_id314995724" xml-lang="en-US" l10n="NEW">When this option is disabled, Calc will detect and convert only decimal numbers. The rest, including numbers formatted in scientific notation, will be imported as text. A decimal number string can have digits 0-9, thousands separators, and a decimal separator. Thousands separators and decimal separators may vary with the selected language and region.</paragraph>
82<paragraph role="heading" id="hd_id3155388" xml-lang="en-US" level="2" l10n="U" oldref="61">Fields</paragraph>
83<paragraph role="paragraph" id="par_id3153665" xml-lang="en-US" l10n="U" oldref="62">Shows how your data will look when it is separated into columns.</paragraph>
84<bookmark xml-lang="en-US" branch="hid/sc:ListBox:RID_SCDLG_ASCII:LB_TYPE1" id="bm_id3157909" localize="false"/><paragraph role="heading" id="hd_id3148474" xml-lang="en-US" level="3" l10n="U" oldref="63">Column type</paragraph>
85<paragraph role="paragraph" id="par_id3149957" xml-lang="en-US" l10n="U" oldref="24"><ahelp hid="SC:LISTBOX:RID_SCDLG_ASCII:LB_TYPE1">Choose a column in the preview window and select the data type to be applied the imported data.</ahelp> You can select one of the following options:</paragraph>
86<table id="tbl_id3155179">
87<tablerow>
88<tablecell colspan="" rowspan="">
89<paragraph role="tablehead" id="par_id3152945" xml-lang="en-US" l10n="U" oldref="25">Type</paragraph>
90</tablecell>
91<tablecell colspan="" rowspan="">
92<paragraph role="tablehead" id="par_id3145121" xml-lang="en-US" l10n="U" oldref="26">Function</paragraph>
93</tablecell>
94</tablerow>
95<tablerow>
96<tablecell colspan="" rowspan="">
97<paragraph role="tablecontent" id="par_id3149763" xml-lang="en-US" l10n="U" oldref="27">Standard</paragraph>
98</tablecell>
99<tablecell colspan="" rowspan="">
100<paragraph role="tablecontent" id="par_id3155923" xml-lang="en-US" l10n="U" oldref="28">$[officename] determines the type.</paragraph>
101</tablecell>
102</tablerow>
103<tablerow>
104<tablecell colspan="" rowspan="">
105<paragraph role="tablecontent" id="par_id3152472" xml-lang="en-US" l10n="U" oldref="29">Text</paragraph>
106</tablecell>
107<tablecell colspan="" rowspan="">
108<paragraph role="tablecontent" id="par_id3148946" xml-lang="en-US" l10n="U" oldref="30">Imported data are treated as text.</paragraph>
109</tablecell>
110</tablerow>
111<tablerow>
112<tablecell colspan="" rowspan="">
113<paragraph role="tablecontent" id="par_id3147265" xml-lang="en-US" l10n="U" oldref="31">Date (DMY)</paragraph>
114</tablecell>
115<tablecell colspan="" rowspan="">
116<paragraph role="tablecontent" id="par_id3156434" xml-lang="en-US" l10n="U" oldref="32">Applies a date format (Day, Month, Year) to the imported data in a column.</paragraph>
117</tablecell>
118</tablerow>
119<tablerow>
120<tablecell colspan="" rowspan="">
121<paragraph role="tablecontent" id="par_id3148740" xml-lang="en-US" l10n="U" oldref="33">Date (MDY)</paragraph>
122</tablecell>
123<tablecell colspan="" rowspan="">
124<paragraph role="tablecontent" id="par_id3149688" xml-lang="en-US" l10n="U" oldref="34">Applies a date format (Month, Day, Year) to the imported data in a column.</paragraph>
125</tablecell>
126</tablerow>
127<tablerow>
128<tablecell colspan="" rowspan="">
129<paragraph role="tablecontent" id="par_id3150230" xml-lang="en-US" l10n="U" oldref="35">Date (YMD)</paragraph>
130</tablecell>
131<tablecell colspan="" rowspan="">
132<paragraph role="tablecontent" id="par_id3153207" xml-lang="en-US" l10n="U" oldref="36">Applies a date format (Year, Month, Day) to the imported data in a column.</paragraph>
133</tablecell>
134</tablerow>
135<tablerow>
136<tablecell colspan="" rowspan="">
137<paragraph role="tablecontent" id="par_id3148981" xml-lang="en-US" l10n="U" oldref="65">US English</paragraph>
138</tablecell>
139<tablecell colspan="" rowspan="">
140<paragraph role="tablecontent" id="par_id3153178" xml-lang="en-US" l10n="U" oldref="66">Numbers formatted in US English are searched for and included regardless of the system language. A number format is not applied. If there are no US English entries, the <emph>Standard</emph> format is applied.</paragraph>
141</tablecell>
142</tablerow>
143<tablerow>
144<tablecell colspan="" rowspan="">
145<paragraph role="tablecontent" id="par_id3154329" xml-lang="en-US" l10n="U" oldref="37">Hide</paragraph>
146</tablecell>
147<tablecell colspan="" rowspan="">
148<paragraph role="tablecontent" id="par_id3154946" xml-lang="en-US" l10n="U" oldref="38">The data in the column are not imported.</paragraph>
149</tablecell>
150</tablerow>
151</table>
152<paragraph role="paragraph" id="par_id3149767" xml-lang="en-US" l10n="U" oldref="75">If you selected one of the date formats (DMY), (MDY), or (YMD) and you enter numbers without date delimiters, the numbers are interpreted as follows:</paragraph>
153<table id="tbl_id3145745">
154<tablerow>
155<tablecell colspan="" rowspan="">
156<paragraph role="tablehead" id="par_id3150650" xml-lang="en-US" l10n="U" oldref="76">Number of characters </paragraph>
157</tablecell>
158<tablecell colspan="" rowspan="">
159<paragraph role="tablehead" id="par_id3150495" xml-lang="en-US" l10n="U" oldref="77">Date format</paragraph>
160</tablecell>
161</tablerow>
162<tablerow>
163<tablecell colspan="" rowspan="">
164<paragraph role="tablecontent" id="par_id3156212" xml-lang="en-US" l10n="U" oldref="78">6</paragraph>
165</tablecell>
166<tablecell colspan="" rowspan="">
167<paragraph role="tablecontent" id="par_id3153056" xml-lang="en-US" l10n="U" oldref="79">Two characters each are taken for day, month, and year in the selected order.</paragraph>
168</tablecell>
169</tablerow>
170<tablerow>
171<tablecell colspan="" rowspan="">
172<paragraph role="tablecontent" id="par_id3147352" xml-lang="en-US" l10n="U" oldref="80">8</paragraph>
173</tablecell>
174<tablecell colspan="" rowspan="">
175<paragraph role="tablecontent" id="par_id3153768" xml-lang="en-US" l10n="U" oldref="81">Four characters are taken for the year, two each for month and day, in the selected order.</paragraph>
176</tablecell>
177</tablerow>
178<tablerow>
179<tablecell colspan="" rowspan="">
180<paragraph role="tablecontent" id="par_id3147295" xml-lang="en-US" l10n="U" oldref="82">5 or 7</paragraph>
181</tablecell>
182<tablecell colspan="" rowspan="">
183<paragraph role="tablecontent" id="par_id3151168" xml-lang="en-US" l10n="U" oldref="83">As with 6 or 8 characters, but the first part of the sequence has one character less. This will suppress a leading zero for month and day.</paragraph>
184</tablecell>
185</tablerow>
186</table>
187<paragraph role="tip" id="par_id3153143" xml-lang="en-US" l10n="U" oldref="44">If you want to include the leading zero in the data you import, in telephone numbers for example, apply the "Text" format to the column.</paragraph>
188<paragraph role="heading" id="hd_id3149287" xml-lang="en-US" level="3" l10n="U" oldref="39">Preview</paragraph>
189<paragraph role="paragraph" id="par_id3147377" xml-lang="en-US" l10n="U" oldref="40">Shows how the imported text will look after it is separated into columns. To apply a format to a column when it is imported, click a column and select a <emph>Column type</emph>. When you select a <emph>Column type</emph>, the column heading displays the applied format.</paragraph>
190<paragraph role="paragraph" id="par_id3150105" xml-lang="en-US" l10n="U" oldref="64">If you want to use a fixed width to separate the imported data into columns, click in the ruler to set the width boundaries.</paragraph>
191<paragraph role="paragraph" id="par_id3155746" xml-lang="en-US" l10n="U" oldref="74"><link href="text/shared/guide/keyboard.xhp" name="Navigating Without the Mouse">Navigating Without the Mouse</link></paragraph>
192<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US" l10n="U" oldref="43">For more information, see <link href="text/shared/00/00000020.xhp" name="Information about Import and Export Filters">Information about Import and Export Filters</link>.</paragraph>
193</body>
194</helpdocument>
195