[333dd9]: help / default / html / export.html Maximize Restore History

Download this file

export.html    184 lines (181 with data), 8.9 kB

  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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Exporting Entries</title>
<!-- pwsafe version: 2.11-->
<!-- Modified: 15/06/2005 --><!--Popup control -->
<script language="javascript" src="html/popups.js">
</script><link rel="stylesheet" type="text/css" href="style.css">
</head>
<body>
<object id="popup" type="application/x-oleobject" classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"></object>
<!-- Popup Source File -->
<h2>Exporting Entries</h2>
<p><b>Password Safe</b> supports exporting (and importing)
of the stored passwords to (and from) various formats. To export
password entries use the
"File&nbsp;&rarr;&nbsp;Export To" menu. The supported formats are:</p>
<ul>
<li>Password Safe v1 (for use by versions 1.x of Password Safe)</li>
<li>Password Safe v2 (for use by versions 2.x of Password Safe)</li>
<li><a href="#te">Plain text</a></li>
<li><a href="#xml">XML</a></li>
</ul>
<p>For previous versions of <b>Password Safe</b>, just select the
desired
format and specify the name of the database file you wish to
create.</p>
<p>In addition, to 'export' a subset of entries to another Password
Safe database,
just start <b>Password Safe</b> (assuming you permit multiple
instances via
<a href="system_tab.html">"Manage&nbsp;?&nbsp;Options&nbsp;?&nbsp;System"</a>
tab) and create a new database, whilst having your normal database
open in another instance.
Then you can simply drag and drop any entries or groups from your
open database
to this 'export' database.</p>
<p>Export uses a Wizard interface. You may also select the Advanced
field selection in order to restrict which entries you export and
which
field of these entries you export from your current database.
See <a href="wzselectdb.html">here</a> for more details.</p>
<p>A report of the actions taken will be available on completion and this may be copied
to the clipboard or saved to disk as a text file in the same directory as the database.
The <a href="view_menu.html">"View&nbsp;&rarr;&nbsp;Reports"</a> menu item may then be
used to view the reports at a later date. The name of the report file is fixed and
dependent on the function that created it. If the same function is repeated
and its report saved to disk, any existing report for this function will be
overwritten. <span style="color=red;"><b>Note:</b> The report may contain sensitive data and
care should be taken when selecting the "save to disk" option.</span></p>
<h3><a name="te"></a>Text Export</h3>
<hr>
<small>
<span style="color: rgb(255, 0, 0);"><b>Note:</b> The exported
text is an
unprotected copy of the specified password entries. Deleting
this copy after use is
<b>not</b> sufficient for making it inaccessible to a determined
attacker
and in effect bypasses the security of the program. Please <b>DO
NOT</b>
use this function unless you understand and accept the risks.</span><br>
</small>
<hr>
<p><b>Password Safe</b> allows you to export password entries to
text files.
These files may then be used or modified by other applications.</p>
<p>You will be asked to enter the master password (safe combination)
to confirm that you may export the database into a clear text
unencrypted file before you can export its contents. If you're
using YubiKey authentication, click on the Yubikey button, then
activate your YubiKey. You will also be required to supply the
name of the new file and to confirm overwriting of it if a file of
the same name if it already exists in the directory you specified.</p>
<img alt="Export Text" src="images/export.jpg">
<p>You can also specify some options:</p>
<ul>
<li>Password entries will be exported with a tab character between
fields i.e., between the Group.Title, Username, Password and the
Notes fields. The "Group.Title" is considered a single field.
Any field containing a blank will be output inside double
quotation characters. Only the Notes field can contain multiple
line entries. The normal processing is to place each Notes line
on a separate line in the exported text field. However, this
makes it difficult to sort or to use when comparing two
different export files. To overcome this, you may specify a
delimiter to separate multiple lines when exporting them. If you
are going to import a text file created with such a delimiter,
then it must be specified, all the Notes lines will appear as
one single line in the resulting database.<br>
If required, tick that you want to put all separate lines
in the Notes field onto one line and enter the character to be
used as
the delimiter. Since the whole Notes field is enclosed between
double
quotation marks, this character is prohibited from being
selected as
the multi-line delimiter.
</li>
</ul>
<p><img alt="Advanced Text Export Options" src="images/export_text_adv.jpg"></p>
<p>Selecting "Advanced field selection" will display this Wizard
page
to allow you to export only some of the entries,
based on the text in specified fields, and/or specify which fields
are
to be exported. See <a href="wzselectdb.html">here</a> for more
details.</p>
<hr style="width: 100%; height: 2px;">
<small><b>Note:</b> Details on the format of the exported text file may be found in the
"<a href="imp_exp_text_details.html">Plain Text Export &amp; Import Format</a>" section.</small>
<hr style="width: 100%; height: 2px;">
<h3><a name="xml"></a>XML</h3>
<p>XML (eXtensible Markup Language) is a popular format for
transferring
data between applications. <b>Password Safe</b> can export (and
import) the
database entries to this format. The structure (or <i>schema</i>)
against which the data is exported and validated is defined in the
file <i>pwsafe.xsd</i>,
which is provided as part of the distribution. This file is used
by
<b>Password Safe</b> when XML data is imported, and should be
provided to
applications that wish to use the exported data.<br>
</p>
<hr style="width: 100%; height: 2px;">
<small>
<span style="color: rgb(255, 0, 0);">
<b>Note:</b> The exported text is an unprotected copy of the
specified password entries.
Deleting this copy after use is <b>not</b> sufficient for
making it inaccesible to a determined
attacker and in effect bypasses the security of the program.
Please <b>DO NOT</b> use this function
unless you understand and accept the risks.
</span>
</small>
<hr style="width: 100%; height: 2px;">
<p>The display of XML files is specified by <i>pwsafe.xsl</i>
- an eXtensible Stylesheet Language file. A sample file, which may
be
modified for your own needs, is supplied as part of the
distribution.
This file is only an example and you can easily modify it to
display
whatever fields you want to show. As this only displays the data
and will not alter it, you will still be able to import it into
<b>Password Safe</b> at some later time.</p>
<p>As in the Text Export option, you can control what entries and
field to
export to the XML file by selecting the "Advanced field
selection".
This will display the following Wizard page:</p>
<p>
<img alt="Advanced XML Export Options" src="images/export_xml_adv.jpg"><br>
</p>
<p>Selecting "Advanced field selection" will display this Wizard
page
to allow you to export only some of the entries, based on the text
in
specified fields, and/or specify which fields are to be exported.
<b>Note:</b>
that the XML schema <u>requires</u> the Title and Password
fields, hence these
cannot be deselected. See <a href="wzselectdb.html">here</a> for
more details.</p>
<p></p>
<!-- Added some white space at the bottom for natural scrolling -->
<br>
<br>
<br>
<object type="application/x-oleobject" classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
<param name="Keyword" value="Export Password Entries">
<param name="Keyword" value="Import Password Entries">
<param name="Keyword" value="Excel Password Data">
<param name="Keyword" value="Converting Existing Password Data">
</object>
</body>
</html>