← LoadfileKit / Guides / Excel → DAT/OPT

Excel → DAT / OPT: building a load file from a spreadsheet

For small productions assembled by hand · what the spreadsheet must become before any platform will import it

Not every production comes out of a processing vendor. Small matters get assembled by hand: a spreadsheet of documents, a folder of PDFs, and a receiving party that expects a proper load file. The gap between "CSV I can edit" and "DAT the platform accepts" is small but full of traps — generic tools don't speak Concordance delimiters, which is why the conversion has to be done deliberately.

What a DAT needs that a CSV doesn't have

RequirementDetailSpreadsheet trap
Field delimiterASCII 20 / DC4 (the invisible control char); some shops use the visible ¶ = 0xB6 variantExcel exports commas; renaming the file to .dat changes nothing
Text qualifierþ (0xFE in Windows-1252) wraps every field; a literal þ inside a value is written twiceCells containing þ look identical to delimiters — they're not
In-value line break® (0xAE) stands in for CR/LF so one record stays on one physical lineAlt-Enter newlines in cells become literal line breaks and shred the record
Header rowFirst line: field names, same grammar, same order for every recordExcel headers with commas or special chars must be wrapped too
EncodingOne family for the whole file — Windows-1252 for legacy targets, UTF-8 (ideally with BOM) for modern onesExcel re-encodes CSV on save and silently changes the family
Line endingsCRLFUsually fine on Windows; Mac exports can arrive LF-only

The OPT side: seven columns, one row per page

The image cross-reference is positional — seven comma-separated columns, no qualifier:

#ColumnContent
1Image keyThe Bates number / page key of this image
2VolumeVolume identifier (e.g. VOL001) matching the volume's folder
3PathRelative path to the single-page image file
4Document breakY on the first page of a document, blank otherwise
5Folder breakY when a folder boundary is crossed
6Box breakY when a box boundary is crossed
7Page countNumber of pages in the document, written on the break row

Empty trailing columns are preserved, not trimmed. Every Y row's page count must equal the inclusive span of keys in that document — the checker in the Bates checker verifies exactly that, along with gaps and duplicates across the whole run.

Excel-specific traps, in order of how often they bite

The workflow

Sheet → CSV (deliberate encoding) → DAT/OPT via the converter → verify (field counts, Bates spans, page counts) → test import on the target platform. If you need to hand-edit afterwards, convert DAT→CSV, edit, convert back — never edit the DAT in a text editor that might re-encode it (see the encoding trap). The DAT format and OPT format guides have the full grammars.