BACK

JPWS CSV EXTERNAL FILE FORMAT

CSV Format

The basis of JPasswords CSV serialization is RFC-4180. The format type "DATABASE" conforms rather purely to this definition, while format type "SPREADSHEET" has a variant field delimiter, namely semicolon.

Comment Lines

Deviant to RFC-4180, any number of comment lines is tolerated before the header line of a file. A comment line is marked by starting with character "#". In a JPWS export file the comment lines inform about the format parameters used to create the file.

CSV Header Fields

Note that JPWS CSV file format requires a line with header fields as the first text line (after comments). If you see CSV as a set of columns, the header fields define the column names. Using column names allows a great variety of column compositions to serve as input for JPasswords (or other reading applications); also you don't have to care about ordering of columns in an input file.

The following columns are mandatory:
TITLE Text. Entry title (such as an account-id, etc.)
PASSWORD Text. Your login password

The following columns are optional data fields:
USER Text. Your login username
GROUP Text. A group identifier assigning this entry to a group of entries. The group name may be multi-level, each level separated by a "." character (e.g. "Forums.Games.ImmortalCities")
NOTES Text. Free comment text about this entry
URL Text. URL denomination, e.g. to address a homepage or other Internet location.
PWHISTORY Text. Password history in a special format which is a list of lists, encoded in RFC-4180 convention. The elements of the history list are pairs (a,b) consisting of a = XML-time notation (UT) of the password creation time, and b = the historical password value.
UUID Text. Hexadecimal notation of a 16-byte integer. This value represents a technical, universal identifier for this entry.
T_CREATED Time. The timepoint when this entry was created.
T_MODIFIED Time. The timepoint when this entry was last modified.
T_PASSEXPIRY Time. The timepoint when the password will expire.
T_PASSMODIFIED Time. The timepoint when the password was last modified.
T_PASSACCESS Time. The timepoint when the password was last accessed.

Data Types

Text - is any sequence of characters of your chosen character set. If the text contains a separator sign, a double-quote or a linefeed, the whole field value is to be included in double-quotes.

Time - allows various notations of a timepoint, all of them referring to Universal Time (GMT). There are three subtypes available: a) a long integer (digits) representing the number of seconds since 1st Jan 1970 0:00 UT, b) XML standard time-format, and c) any standard notation that can be understood by your Java Virtual Machine.

Record Data

Password entry records immediately follow the header line. Number and sequence of fields per record must be identical to the pattern which was given by the header line. Records are separated by CRLF (line feed). Carefully note, however, that the occurence of CRLF in the file's text does not necessarily mark the end of a record!