blob: a8d2f4345541ee075b23bbd4d8ab38a58ba5bab9 [file] [log] [blame]
<!--
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
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<section id="tools_csvexport_wizard">
<title>CSV Export wizard</title>
<para>This wizard is used to export entries to CSV files.</para>
<para>
To start the wizard choose one of the following options:
<itemizedlist>
<listitem>
<para>
In the LDAP Browser view select an entry or a search
and choose
<emphasis role="strong">
Export >
<inlinemediaobject>
<imageobject>
<imagedata contentdepth="1em"
fileref="icons/export_csv.gif" format="GIF" />
</imageobject>
</inlinemediaobject>
CSV Export...
</emphasis>
from context menu.
</para>
</listitem>
<listitem>
<para>
In the Connections view select a connection and
choose
<emphasis role="strong">
Export >
<inlinemediaobject>
<imageobject>
<imagedata contentdepth="1em"
fileref="icons/export_csv.gif" format="GIF" />
</imageobject>
</inlinemediaobject>
CSV Export...
</emphasis>
from context menu.
</para>
</listitem>
<listitem>
<para>
In the Workbench menu bar select
<emphasis role="strong">File > Export...</emphasis>
and choose
<emphasis role="strong">
<inlinemediaobject>
<imageobject>
<imagedata contentdepth="1em"
fileref="icons/export_csv.gif" format="GIF" />
</imageobject>
</inlinemediaobject>
LDAP to CSV
</emphasis>
.
</para>
</listitem>
</itemizedlist>
</para>
<simplesect id="tools_csvexport_wizard_1">
<title>Data to Export</title>
<para>
On the Data to Export page you have to specify which
entries and attributes to export.
</para>
<para>
The layout of the page is similar to the
<link
linkend="tools_search_dialog">
LDAP Search page
</link>
. In the <emphasis role="strong">Returning Attributes</emphasis> section
you can also choose the following option:
</para>
<para>
<informaltable frame="all">
<tgroup cols="3">
<colspec colname="Option" colwidth="1*" />
<colspec colname="Description" colwidth="2*" />
<colspec colname="Default" colwidth="1*" />
<thead>
<row>
<entry>Option</entry>
<entry>Description</entry>
<entry>Default</entry>
</row>
</thead>
<tbody>
<row>
<entry>Export DN</entry>
<entry>
Exports the distinguished name as first column in the CSV file.
</entry>
<entry>on</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</simplesect>
<simplesect id="tools_csvexport_wizard_2">
<title>CSV File</title>
<para>
On the CSV File page you have to select the target CSV file.
</para>
<para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata scale="50"
fileref="images/tools_csvexport_wizard_1.png" format="PNG" />
</imageobject>
</mediaobject>
</screenshot>
</para>
<para>
<informaltable frame="all">
<tgroup cols="3">
<colspec colname="Option" colwidth="1*" />
<colspec colname="Description" colwidth="2*" />
<colspec colname="Default" colwidth="1*" />
<thead>
<row>
<entry>Option</entry>
<entry>Description</entry>
<entry>Default</entry>
</row>
</thead>
<tbody>
<row>
<entry>CSV File</entry>
<entry>
The CSV file to export to. Type in the
full path or
<emphasis role="strong">
Browse...
</emphasis>
to select the path on the file system.
The drop-down list provides a history of
recently used files.
</entry>
<entry>empty</entry>
</row>
<row>
<entry>Overwrite existing CSV file</entry>
<entry>
If the export file already exist, you
must permit to overwrite the file.
</entry>
<entry>off</entry>
</row>
<row>
<entry>Text Formats</entry>
<entry>
Opens the
<link
linkend="preferences_text_formats">
Text Formats preferences
</link>
where you could modify the CSV format.
</entry>
<entry>-</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</simplesect>
</section>