1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* 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 .
-->
<meta>
<topic id="textshared0000000208xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">Text Import</title>
<filename>/text/shared/00/00000208.xhp</filename>
</topic>
</meta>
<body>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/TextImportCsvDialog" id="bm_id3148919" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/@@nowidget@@" id="bm_id3148919" localize="false"/>
<paragraph id="hd_id3150960" role="heading" level="1" xml-lang="en-US">Text Import</paragraph>
<paragraph id="par_id3149987" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/TextImportCsvDialog">Sets the import options for delimited data.</ahelp></paragraph>
<section id="howtoget">
<embed href="text/shared/00/00000401.xhp#textimport"/>
</section>
<switch select="appl">
<case select="CALC">
<embed href="text/scalc/guide/csv_files.xhp#csv_files"/>
<embed href="text/scalc/guide/csv_formula.xhp#csv_formula"/>
</case>
</switch>
<paragraph id="hd_id3147588" role="heading" level="2" xml-lang="en-US">Import</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/charset" id="bm_id3155934" localize="false"/>
<paragraph id="hd_id3154788" role="heading" level="3" xml-lang="en-US">Character Set</paragraph>
<paragraph id="par_id3149495" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/charset">Specifies the character set to be used in the imported file.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/language" id="bm_id315593499" localize="false"/>
<paragraph id="hd_id315478899" role="heading" level="3" xml-lang="en-US">Language</paragraph>
<paragraph id="par_id314949588" role="paragraph" xml-lang="en-US"><ahelp hid=".">Determines how the number strings are imported.</ahelp></paragraph>
<paragraph id="par_id314949587" role="paragraph" xml-lang="en-US">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>
<paragraph id="par_id314949586" role="paragraph" xml-lang="en-US">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>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/fromrow" id="bm_id3153377" localize="false"/>
<paragraph id="hd_id3154894" role="heading" level="3" xml-lang="en-US">From Row</paragraph>
<paragraph id="par_id3150247" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/fromrow">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>
<paragraph id="hd_id3149999" role="heading" level="2" xml-lang="en-US">Separator Options</paragraph>
<paragraph id="par_id3149640" role="paragraph" xml-lang="en-US">Specifies whether your data uses separators or fixed widths as delimiters.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/tofixedwidth" id="bm_id3153894" localize="false"/>
<paragraph id="hd_id3156553" role="heading" level="3" xml-lang="en-US">Fixed width</paragraph>
<paragraph id="par_id3150710" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/tofixedwidth">Separates fixed-width data (equal number of characters) into columns.</ahelp> Click on the ruler in the preview window to set the width.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/toseparatedby" id="bm_id3147043" localize="false"/>
<paragraph id="hd_id3156560" role="heading" level="3" xml-lang="en-US">Separated by</paragraph>
<paragraph id="par_id3145136" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/toseparatedby">Select the separator used in your data.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/tab" id="bm_id3153345" localize="false"/>
<paragraph id="hd_id3147250" role="heading" level="3" xml-lang="en-US">Tab</paragraph>
<paragraph id="par_id3147576" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/tab">Separates data delimited by tabs into columns.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/semicolon" id="bm_id3157959" localize="false"/>
<paragraph id="hd_id3154317" role="heading" level="3" xml-lang="en-US">Semicolon</paragraph>
<paragraph id="par_id3157863" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/semicolon">Separates data delimited by semicolons into columns.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/comma" id="bm_id3147089" localize="false"/>
<paragraph id="hd_id3145313" role="heading" level="3" xml-lang="en-US">Comma</paragraph>
<paragraph id="par_id3150693" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/comma">Separates data delimited by commas into columns.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/space" id="bm_id3109848" localize="false"/>
<paragraph id="hd_id3163802" role="heading" level="3" xml-lang="en-US">Space</paragraph>
<paragraph id="par_id3153663" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/space">Separates data delimited by spaces into columns.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/other" id="bm_id3149098" localize="false"/>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/inputother" id="bm_id3149801" localize="false"/>
<paragraph id="hd_id3147335" role="heading" level="3" xml-lang="en-US">Other</paragraph>
<paragraph id="par_id3156329" role="paragraph" xml-lang="en-US"><ahelp hid=".">Separates data into columns using the custom separator that you specify. Note: The custom separator must also be contained in your data.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/mergedelimiters" id="bm_id3146807" localize="false"/>
<paragraph id="hd_id3150978" role="heading" level="3" xml-lang="en-US">Merge delimiters</paragraph>
<paragraph id="par_id3153827" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/mergedelimiters">Combines consecutive delimiters and removes blank data fields.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/removespace" id="bm_id3146808" localize="false"/>
<paragraph id="hd_id3150979" role="heading" level="3" xml-lang="en-US">Trim spaces</paragraph>
<paragraph id="par_id3153828" role="paragraph" xml-lang="en-US"><ahelp hid=".">Removes starting and trailing spaces from data fields.</ahelp></paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/textdelimiter" id="bm_id3147619" localize="false"/>
<paragraph id="hd_id3155341" role="heading" level="3" xml-lang="en-US">String delimiter</paragraph>
<paragraph id="par_id3156326" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/textdelimiter">Select a character to delimit text data. You can also enter a character in the text box.</ahelp></paragraph>
<paragraph id="hd_id315538811" role="heading" level="2" xml-lang="en-US">Other options</paragraph>
<paragraph id="par_id315366511" role="paragraph" xml-lang="en-US">Sets some other import options.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/quotedfieldastext" id="bm_id315790911" localize="false"/>
<paragraph id="hd_id314847411" role="heading" level="3" xml-lang="en-US">Format quoted field as text</paragraph>
<paragraph id="par_id314995711" role="paragraph" xml-lang="en-US"><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>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/detectspecialnumbers" id="bm_id315790922" localize="false"/>
<paragraph id="hd_id314847422" role="heading" level="3" xml-lang="en-US">Detect special numbers</paragraph>
<paragraph id="par_id314995722" role="paragraph" xml-lang="en-US"><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>
<paragraph id="par_id314995723" role="paragraph" xml-lang="en-US">The selected language influences how such special numbers are detected, since different languages and regions many have different conventions for such special numbers.</paragraph>
<paragraph id="par_id314995724" role="paragraph" xml-lang="en-US">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>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/skipemptycells" id="bm_id315790923" localize="false"/>
<paragraph id="hd_id171220172142361711" role="heading" level="3" xml-lang="en-US">Skip empty cells</paragraph>
<paragraph id="par_id171220172144419125" role="paragraph" xml-lang="en-US"><ahelp hid=".">When this option is enabled, Calc preserves previous content of cells when pasting empty ones. Otherwise, Calc deletes content of previous cells.</ahelp></paragraph>
<paragraph id="par_id171220172156279613" role="paragraph" xml-lang="en-US">In <emph>Text to Columns</emph> conversion, if cell content begins with a separator and this option is disabled, then first column will be emptied.</paragraph>
<paragraph id="hd_id3155388" role="heading" level="2" xml-lang="en-US">Fields</paragraph>
<paragraph id="par_id3153665" role="paragraph" xml-lang="en-US">Shows how your data will look when it is separated into columns.</paragraph>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/columntype" id="bm_id3157909" localize="false"/>
<paragraph id="hd_id3148474" role="heading" level="3" xml-lang="en-US">Column type</paragraph>
<paragraph id="par_id314995725" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/textimportcsv/columntype">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>
<table id="tbl_id3155179">
<tablerow>
<tablecell>
<paragraph id="par_id3152945" role="tablehead" xml-lang="en-US">Type</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3145121" role="tablehead" xml-lang="en-US">Function</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3149763" role="tablecontent" xml-lang="en-US">Standard</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3155923" role="tablecontent" xml-lang="en-US">$[officename] determines the type.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3152472" role="tablecontent" xml-lang="en-US">Text</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3148946" role="tablecontent" xml-lang="en-US">Imported data are treated as text.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3147265" role="tablecontent" xml-lang="en-US">Date (DMY)</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3156434" role="tablecontent" xml-lang="en-US">Applies a date format (Day, Month, Year) to the imported data in a column.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3148740" role="tablecontent" xml-lang="en-US">Date (MDY)</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3149688" role="tablecontent" xml-lang="en-US">Applies a date format (Month, Day, Year) to the imported data in a column.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3150230" role="tablecontent" xml-lang="en-US">Date (YMD)</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3153207" role="tablecontent" xml-lang="en-US">Applies a date format (Year, Month, Day) to the imported data in a column.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3148981" role="tablecontent" xml-lang="en-US">US English</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3153178" role="tablecontent" xml-lang="en-US">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>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3154329" role="tablecontent" xml-lang="en-US">Hide</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3154946" role="tablecontent" xml-lang="en-US">The data in the column are not imported.</paragraph>
</tablecell>
</tablerow>
</table>
<paragraph id="par_id3149767" role="paragraph" xml-lang="en-US">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>
<table id="tbl_id3145745">
<tablerow>
<tablecell>
<paragraph id="par_id3150650" role="tablehead" xml-lang="en-US">Number of characters </paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3150495" role="tablehead" xml-lang="en-US">Date format</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3156212" role="tablecontent" xml-lang="en-US">6</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3153056" role="tablecontent" xml-lang="en-US">Two characters each are taken for day, month, and year in the selected order.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3147352" role="tablecontent" xml-lang="en-US">8</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3153768" role="tablecontent" xml-lang="en-US">Four characters are taken for the year, two each for month and day, in the selected order.</paragraph>
</tablecell>
</tablerow>
<tablerow>
<tablecell>
<paragraph id="par_id3147295" role="tablecontent" xml-lang="en-US">5 or 7</paragraph>
</tablecell>
<tablecell>
<paragraph id="par_id3151168" role="tablecontent" xml-lang="en-US">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>
</tablecell>
</tablerow>
</table>
<paragraph id="par_id3153143" role="tip" xml-lang="en-US">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>
<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/textimportcsv/scrolledwindowcolumntype" id="bm_id3157910" localize="false"/>
<paragraph id="hd_id3149287" role="heading" level="3" xml-lang="en-US">Preview</paragraph>
<paragraph id="par_id3147377" role="paragraph" xml-lang="en-US"><ahelp hid=".">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.</ahelp></paragraph>
<paragraph id="par_id3150105" role="paragraph" xml-lang="en-US">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>
<paragraph id="par_id3155746" role="paragraph" xml-lang="en-US"><link href="text/shared/guide/keyboard.xhp" name="Navigating Without the Mouse">Navigating Without the Mouse</link></paragraph>
<paragraph id="par_id3146120" role="paragraph" xml-lang="en-US">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>
</body>
</helpdocument>
|
