From 5a91be35bf16757602aa1600a0c154bd5560b2bf Mon Sep 17 00:00:00 2001 From: Olivier Hallot Date: Mon, 4 Jul 2022 11:31:26 -0300 Subject: tdf#149846 tdf#149759 Update CSV import Help page Change-Id: I1a3453a2ac8bf8a5db4df8c5fabecb3e5d83b873 Reviewed-on: https://gerrit.libreoffice.org/c/help/+/136807 Tested-by: Jenkins Reviewed-by: Olivier Hallot --- source/text/shared/00/00000208.xhp | 75 ++++++++++++++++++--------------- source/text/shared/00/00000401.xhp | 2 +- source/text/shared/guide/csv_params.xhp | 24 ++++++----- 3 files changed, 56 insertions(+), 45 deletions(-) diff --git a/source/text/shared/00/00000208.xhp b/source/text/shared/00/00000208.xhp index 756cc66343..91dfefd914 100644 --- a/source/text/shared/00/00000208.xhp +++ b/source/text/shared/00/00000208.xhp @@ -30,104 +30,101 @@ -Text Import +

Text Import

Sets the import options for delimited data.
- - - - - - -Import +

Import

-Character Set +

Character Set

Specifies the character set to be used in the imported file. -Language +

Language

Determines how the number strings are imported. 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. When importing an HTML document, the Language selection can conflict with the global HTML option Use 'English (USA)' locale for numbers. 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. -From Row +

From Row

Specifies the row where you want to start the import. The rows are visible in the preview window at the bottom of the dialog. -Separator Options +

Separator Options

Specifies whether your data uses separators or fixed widths as delimiters. -Fixed width +

Fixed width

Separates fixed-width data (equal number of characters) into columns. Click on the ruler in the preview window to set the width. -Separated by +

Separated by

Select the separator used in your data. -Tab +

Tab

Separates data delimited by tabs into columns. -Semicolon +

Semicolon

Separates data delimited by semicolons into columns. -Comma +

Comma

Separates data delimited by commas into columns. -Space +

Space

Separates data delimited by spaces into columns. -Other +

Other

Separates data into columns using the custom separator that you specify. Note: The custom separator must also be contained in your data. -Merge delimiters +

Merge delimiters

Combines consecutive delimiters and removes blank data fields. -Trim spaces +

Trim spaces

Removes starting and trailing spaces from data fields. -String delimiter +

String delimiter

Select a character to delimit text data. You can also enter a character in the text box. -Other options +

Other options

Sets some other import options. -Format quoted field as text +

Format quoted field as text

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. -Detect special numbers +

Detect special numbers

When this option is enabled, Calc will automatically detect all number formats, including special number formats such as dates, time, and scientific notation. The selected language influences how such special numbers are detected, since different languages and regions many have different conventions for such special numbers. 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. -Skip empty cells -When this option is enabled, Calc preserves previous content of cells when pasting empty ones. Otherwise, Calc deletes content of previous cells. +

Skip empty cells

+Available when using Paste Special: when this option is enabled, Calc preserves previous content of cells when pasting empty ones. Otherwise, Calc deletes content of previous cells. In Text to Columns conversion, if cell content begins with a separator and this option is disabled, then first column will be emptied. -Fields +

Evaluate formulas

+Determines whether formula expressions starting with a = equal sign character are to be evaluated as formulas or imported as textual data. If checked evaluate formulas on input. Otherwise formulas are input as text. + +

Fields

Shows how your data will look when it is separated into columns. -Column type +

Column type

Choose a column in the preview window and select the data type to be applied the imported data. You can select one of the following options: @@ -210,7 +207,7 @@ - 6 + 6 Two characters each are taken for day, month, and year in the selected order. @@ -218,7 +215,7 @@ - 8 + 8 Four characters are taken for the year, two each for month and day, in the selected order. @@ -234,14 +231,24 @@
-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. +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. -Preview +

Preview

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 Column type. When you select a Column type, the column heading displays the applied format. If you want to use a fixed width to separate the imported data into columns, click in the ruler to set the width boundaries. +
Navigating Without the Mouse -For more information, see Information about Import and Export Filters. +Information about Import and Export Filters. + + + + + + + + +
diff --git a/source/text/shared/00/00000401.xhp b/source/text/shared/00/00000401.xhp index 5db89a06f7..8e8383d6f7 100644 --- a/source/text/shared/00/00000401.xhp +++ b/source/text/shared/00/00000401.xhp @@ -323,7 +323,6 @@ - @@ -335,6 +334,7 @@
Choose File - Open - File type, select Text CSV. Choose Data - Text to Columns (Calc). +Copy data to clipboard, then choose Edit - Paste Special - Paste Special (Calc).
Choose File - Export, if EPS is selected as file type, this dialog opens automatically. Choose File - Export, if PBM, PPM or PGM is selected as file type, the dialog opens automatically. diff --git a/source/text/shared/guide/csv_params.xhp b/source/text/shared/guide/csv_params.xhp index cc49b5ba76..5881c41fbd 100644 --- a/source/text/shared/guide/csv_params.xhp +++ b/source/text/shared/guide/csv_params.xhp @@ -82,14 +82,11 @@ 4 + Line number to start reading. CSV Import - - - N Line number to start reading. Example: 3 (start from third line). - - + N: line number to start reading. Example: 3 (start from third line). @@ -98,6 +95,7 @@ Cell Format Codes for Each Column + CSV Import A sequence of column/formatting code, where the formatting code is given in the table below. Example: "1/5/2/1/3/1/4/1". @@ -121,7 +119,7 @@ 7 - CSV Import, CSV Export + Quoted field as text String, either false or true. Default value: false. This token is the equivalent of the check box "Quoted field as text". @@ -132,7 +130,7 @@ 8 - CSV Import, CSV Export + Detect special numbers Import: String, either false or true. Default value: false. This token is the equivalent of the check box "Detect special numbers". @@ -144,6 +142,7 @@ 9 + Save cell contents as shown CSV Export @@ -155,6 +154,7 @@ 10 + Export cell formulas CSV Export @@ -166,6 +166,7 @@ 11 + Remove spaces CSV Import @@ -177,19 +178,20 @@ 12 + Export sheets CSV Export Export the entire document to individual sheets .csv files or a specified sheet. - 0 or absent means the default behaviour, first sheet from command line, or current sheet in macro filter options, exported to sample.csv + 0 or absent: means the default behaviour, first sheet from command line, or current sheet in macro filter options, exported to sample.csv - -1 for all sheets, each sheet is exported to an individual file of the base file name concatenated with the sheet name, for example sample-Sheet1.csv, sample-Sheet2.csv and sample-Sheet3.csv + -1: for all sheets, each sheet is exported to an individual file of the base file name concatenated with the sheet name, for example sample-Sheet1.csv, sample-Sheet2.csv and sample-Sheet3.csv - N export the N-th sheet within the range of number of sheets. Example: to export the second sheet, set 2 here to get sample-Sheet2.csv + N: export the N-th sheet within the range of number of sheets. Example: to export the second sheet, set 2 here to get sample-Sheet2.csv @@ -199,6 +201,7 @@ 13 + Import as formulas CSV Import @@ -282,6 +285,7 @@
+
-- cgit