<?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="textscalcguidecsv_filesxml" indexer="include">
<title id="tit"> Importing and Exporting CSV Files </title>
<filename>/text/scalc/guide/csv_files.xhp</filename>
</topic>
</meta>
<body>
<bookmark branch="index" id="bm_id892361"><bookmark_value>number series import</bookmark_value>
<bookmark_value>data series import</bookmark_value>
<bookmark_value>exporting; tables as text</bookmark_value>
<bookmark_value>importing; tables as text</bookmark_value>
<bookmark_value>delimited values and files</bookmark_value>
<bookmark_value>comma separated files and values</bookmark_value>
<bookmark_value>text file import and export</bookmark_value>
<bookmark_value>csv files;importing and exporting</bookmark_value>
<bookmark_value>tables; importing/exporting as text</bookmark_value>
<bookmark_value>text documents; importing to spreadsheets</bookmark_value>
<bookmark_value>opening;text csv files</bookmark_value>
<bookmark_value>saving;as text csv</bookmark_value>
</bookmark><comment>MW deleted "importing;text data bases" and copied 4 index entries from scalc/guide/csv_formula.xhp</comment><comment>mw added "saving;" and "opening;"</comment>
<h1 id="par_idN10862"><variable id="csv_files"><link href="text/scalc/guide/csv_files.xhp">Opening and Saving Text CSV Files</link>
</variable></h1>
<paragraph id="par_idN10880" role="paragraph">Comma Separated Values (CSV) is a text file format that you can use to exchange data from a database or a spreadsheet between applications. Each line in a Text CSV file represents a record in the database, or a row in a spreadsheet. Each field in a database record or cell in a spreadsheet row is usually separated by a comma. However, you can use other characters to delimit a field, such as a tabulator character.</paragraph>
<paragraph id="par_idN10886" role="paragraph">If the field or cell contains a comma, the field or cell <emph>must</emph> be enclosed by single quotes (') or double quotes (").</paragraph>
<h2 id="par_idN10890">To Open a Text CSV File in Calc</h2>
<list type="ordered">
    <listitem><paragraph id="par_idN10897" role="listitem">Choose <item type="menuitem">File - Open</item>.</paragraph></listitem>
    <listitem>
        <paragraph id="par_idN1089F" role="listitem">Locate the CSV file that you want to open.</paragraph>
        <paragraph id="par_idN108A2" role="listitem">If the file has a *.csv extension, select the file.</paragraph>
        <paragraph id="par_idN108A5" role="listitem">If the CSV file has another extension, select the file, and then select "Text CSV" in the <emph>Filter</emph> box</paragraph></listitem>
    <listitem><paragraph id="par_id341751561571932"  role="listitem">Select <menuitem>Edit filter settings</menuitem> checkbox to open the <link href="text/shared/00/00000208.xhp"><menuitem>Text Import</menuitem></link> dialog and set the import options for delimited data. If the <menuitem>Edit filter settings</menuitem> checkbox is not selected, %PRODUCTNAME Calc uses the settings of the last text import operation.</paragraph></listitem>
    <listitem><paragraph id="par_idN1082D" role="listitem">Click <item type="menuitem">Open</item>.</paragraph></listitem>
</list>
<paragraph role="paragraph" id="par_id991751562754613">If the <menuitem>Edit filter settings</menuitem> checkbox is selected, the <link href="text/shared/00/00000208.xhp"><menuitem>Text Import</menuitem></link> dialog opens. Then: </paragraph>
<list type="unordered" bullet="circle">
    <listitem><paragraph id="par_idN108B1" role="listitem">Specify the options to divide the text in the file into columns.</paragraph></listitem>
    <listitem><paragraph id="par_id8444166" role="listitem">Right-click a column in the preview to set the format or to hide the column.</paragraph></listitem>
    <listitem><paragraph id="par_idN108C5" role="listitem">Click <item type="menuitem">OK</item>.</paragraph></listitem>
</list>
<tip id="par_idN108E2">Check the text delimiter box that matches the character used as text delimiter in the file. In case of an unlisted delimiter, type the character into the input box.</tip>

<h2 id="par_idN108FA">To Save a Sheet as a Text CSV File</h2>
<note id="par_idN106FC">When you export a spreadsheet to CSV format, only the data on the current sheet is saved. All other information, including formulas and formatting, is lost.</note>
<list type="ordered">
<listitem>
<paragraph id="par_idN10901" role="listitem">Open the Calc sheet that you want to save as a Text CSV file.</paragraph>
<note id="par_idN107AF">Only the current sheet can be exported.</note>
</listitem>
<listitem>
<paragraph id="par_idN10905" role="listitem">Choose <item type="menuitem">File - Save as</item>.</paragraph>
</listitem>
<listitem>
<paragraph id="par_idN10915" role="listitem">In the <item type="menuitem">File name</item> box, enter a name for the file.</paragraph>
</listitem>
<listitem>
<paragraph id="par_idN1090D" role="listitem">In the <emph>Filter</emph> box, select "Text CSV".</paragraph>
</listitem>
<listitem>
<paragraph id="par_idN107DD" role="listitem">(Optional) Set the field options for the Text CSV file.</paragraph>
<paragraph id="par_idN1091C" role="listitem">Select <item type="menuitem">Edit filter settings</item>.</paragraph>
<paragraph id="par_idN107ED" role="listitem">In the <item type="menuitem">Export of text files</item> dialog, select the options that you want.</paragraph>
<paragraph id="par_idN107F4" role="listitem">Click <item type="menuitem">OK</item>.</paragraph>
</listitem>
<listitem>
<paragraph id="par_idN107FC" role="listitem">Click <item type="menuitem">Save</item>.</paragraph>
</listitem>
</list>
<section id="relatedtopics">
<embed href="text/scalc/guide/csv_formula.xhp#csv_formula"/>
<embed href="text/shared/guide/data_im_export.xhp#data_im_export"/>
<paragraph id="par_id3153487" role="paragraph"><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060100.xhp">%PRODUCTNAME Calc - View</link></paragraph>
<paragraph id="par_id3153008" role="paragraph"><link href="text/shared/00/00000207.xhp">Export text files</link></paragraph>
<paragraph id="par_id3155595" role="paragraph"><link href="text/shared/00/00000208.xhp">Import text files</link></paragraph>
</section>
</body>
</helpdocument>
