Common Format Type for Comma-Separated Values (CSV) Files
Assets and Inventory plugin for JIRA follows the Microsoft CSV file format as below:
1. Each file must contain the form headers. Please see Import Assets from CSV "Import/Export via Excel (CSV)" / "Export template" section.
2. Each record is located on a separate line, delimited by a line break (CRLF). For example:
Asset name,bbb,ccc CRLF zzz,yyy,xxx CRLF
3. The last record in the file may or may not have an ending line break. For example:
Asset name,bbb,ccc CRLF zzz,yyy,xxx
4. Each line should contain the same number of fields throughout the file.
5. Each field may or may not be enclosed in double quotes. If fields are not enclosed with double quotes, then double quotes ma not appear inside the fields. For example:
"Asset name","bbb","ccc" CRLF zzz,yyy,xxx
6. Fields containing line breaks (CRLF), double quotes, and commas should be enclosed in double-quotes. For example:
"Asset name","b CRLF bb","ccc" CRLF zzz,yyy,xxx
7. If double-quotes are used to enclose fields, then a double-quote appearing inside a field must be escaped by preceding it with another double quote. For example:
Asset Name, bb, cc "aaa","b""bb","ccc"
Reference: https://tools.ietf.org/html/rfc4180
New Line Characters
Windows standard CR+LF or Unix-like systems (Linux, Mac) standard LF may be used as new line character. (Reference: https://en.wikipedia.org/wiki/Newline.)
If you upload a CSV file that contains new line characters in the fields other than Text Area Field, it will be saved to the system but only Text Area Field preserves the new line if you edit the Asset. Other fields like "Text Field" will trim the new line character if you edit and save Asset at Asset Edit page.
Sample CSV File with Double Quotes and New Line Characters
Below is a screenshot of the MS-Excel. Form has an asset name, and two extra fields Author(Text) and Notes(TextArea). First line is the header from the template.
And here is the text representation of the file:
Asset Name,Author [Text],Notes [TextArea] Sample one from csv upload,"New line character at Text field This is the second line including commas; (1,2,3) This is the third line including double quotes ("" and "")","This field has 3 lines This is the second line including commas; (1,2,3) This is the third line including double quotes ("" and "")" Sample two from csv upload,"New line character at Text field second line and this is "" double quotes third line and this is , comma","first line and this is "" double quotes second line and this is , comma"