Invintus Importer Specification for Comma-Separated Value (CSV) Files


General Rules

  1. The first row of the CSV file must be this string exactly (case-sensitive); this is the "Header row"
title,customID,startDateTime,description,encoder,category,location

Formatting for each column can be found below

  1. Each row thereafter must belong to one (and only one event).

  2. Each row of Event data must adhere to the order of items in the Header.

  3. The customID may not include white-spaces, but may itself be empty (e.g.: ,,)

  4. It's best to wrap your title and description entries in double quotes so that, if the description contains a comma the parser does not misinterpret it as the beginning of the next column.

  5. For Estimated Run Times (estRuntime), the hours must be padded with a zero if less than 10. For example for an Estimated Run Time of 1 hour, the format would look like: 01:00. Defaults to 1 hour if no value given


Formatting

ColumnFormatIs Required
TitleStringYes
customIDString, No white-spacesNo
startDateTimeYYYY-MM-DD HH:mm:ss, 24 hour timeYes
descriptionStringNo
encoderString, must be existing EncoderIDNo
categoryString, must be existing CategoryNo
locationString, must be existing LocationNo
estRuntimeString, HH:mm, 24hrs MaxNo
liveToBreakString, TRUE or FALSE, all CapsNo

Example CSV File with two Events

title,customID,startDateTime,description,encoder,category,location
"New Years Day",,2020-01-01 00:00:00,,,,Holiday,"Times Square, New York City",01:30,TRUE
"Independence Day",,2018-07-04 00:00:00,"July 4th BBQ",,,,,,
Event 1
TitleNew Years Day
customID
startDateTime01/01/2020, 12:00:00 am
description
encoder
categoryHoliday
locationTimes Square, New York City
estRuntime01:30
liveToBreakTRUE
Event 2
TitleIndependence Day
customID
startDateTime07/04/2018, 12:00:00 am
descriptionJuly 4th BBQ
encoder
category
location
estRuntime
liveToBreak