The bridge between a timing device and the destinations that receive its readings
Every time a timing device reads a chip, that reading has to reach a destination: a race, Commentators or third-party software. The export determines where those readings are sent.
Contents
What is an export?
An export is a TSCloud connection that defines where the readings generated by a timing device are sent.
When a timing device (TS2+, TS3 or another compatible device) detects a chip, it generates a reading. For that reading to be useful, it has to reach a specific destination: a race, Commentators or third-party software.
The export is the mechanism that routes those readings to the right software or service.
The export is not a Copernico concept. It is a TSCloud concept: TSCloud acts as the layer that distributes readings between devices and destinations.
How is an export created?
You create exports yourself, with no extra steps, when you set up your race in Copernico or configure TSConnector. The process is transparent: you do not have to create them separately.
During that setup, you specify which Timingpoint each device's readings should be sent to.
A Timingpoint can represent:
- Start
- Finish
- Split point
- Any other timing checkpoint
| Platform | Typical use |
|---|---|
| Copernico | Races and tools such as Commentators |
| TSConnector | Integration with third-party timing software |
N-to-N relationship between devices and destinations
The relationship between devices and destinations is many-to-many (N-to-N):
- A single device can have several active exports at the same time.
- A single destination can receive readings from several devices.
Practical example
The device TS2+ 1 can have all of these at once:
- An export to a race in Copernico.
- An export to Commentators in Copernico.
- An export to a race managed through TSConnector.
Every reading that device generates can be sent through all of those exports simultaneously.
In the same way, another device can point to one or more of those same destinations without causing conflicts.
Exports are not exclusive. Several devices can send readings to the same destination, and a single device can send readings to several destinations at the same time.
What you can (and cannot) do from my.timingsense.com
You cannot create or delete exports from my.timingsense.com. They are always created and deleted from Copernico or TSConnector. On my.timingsense.com you can view them, enable or disable them, see their stats and download their readings.
Where to see a device's exports
- From My Devices. In Devices › My Devices, open the ⋯ menu in the device's row and select Exports. The Exports panel opens with all of that device's exports. This is the only place where you can enable or disable them.
- From the Dashboard. In Devices › Dashboard, click the device card and open the Exports tab in the device detail. It shows the stats for each export in the group you opened the device from and lets you Download readings.
What the Exports panel shows
Each export appears in a row with these columns:
- Type: the export type (for example, HTTP), with its ID below it. Hover over it to see the destination (endpoint) the readings are sent to.
- Status: Scheduled (not started yet), In progress, Finished or Deleted.
- Enabled: shows whether the export is Enabled or Disabled.
- Filters: how many filters the export applies.
- Window: the start and end dates of the export.
At the top of the panel you can type in Search exports, filter by one or more Status values, click Refresh to reload the list or start the Help tour.
Actions for each export
Open the ⋯ menu in the export's row:
- Enable / Disable: turns the export on or off. Only the option that applies to its current state is shown. Exports with the status Deleted cannot be enabled or disabled.
- View stats: shows Total readings received, Total readings exported, and the date of the Last reading received, the Last reading exported and the Last export run.
- Download readings: downloads the export's readings as a CSV file. It is also available for finished or deleted exports.
Download readings
When you select Download readings, a form opens with the export's period:
- Check the period in From and To. It is set by the export and cannot be changed.
- If the export has filters, select Include filters to apply them to the download. If you leave it unselected, all readings in the period are downloaded.
- In Chip encoding, choose how chip codes are written in the file: Inherit (the same encoding the export uses), Simple or Extended.
- Click Download. A counter shows the readings fetched so far ("Fetched N readings…"), and you can click Cancel at any time.
When it finishes, your browser saves a CSV file named after the device and the export. If there are no readings in the period, the message "No readings for this period" appears.
Exports with many readings can take a while, because readings are downloaded in batches. The counter shows you the progress.
Exports define which destinations a device's readings are sent to.
Device Telemetry (the Telemetry option in the ⋯ menu in My Devices) lets you analyze the device's activity and historical behavior.
Quick summary
| Question | Answer |
|---|---|
| What is an export? | A TSCloud connection that routes a device's readings to a specific destination. |
| Where is it created? | You create it when you set up your race in Copernico or configure TSConnector. |
| Can a device have several exports? | Yes. The relationship is N-to-N. |
| Can exports be created or deleted from my.timingsense.com? | No. From My Devices › Exports you can only view them, enable or disable them, see their stats and download their readings as a CSV file. |
Comments
Article is closed for comments.