The event import API is designed to allow the import of event data from third party systems, such as federations, who have their own internal competition management.
The primary goal is to transfer data from the third party system into ScoreExpress, however the option of returning data from ScoreExpress to the third party system is taken into account.
In the following topics, we will describe how the data transfer works, and how the third party system should be adapted to support the process.
From here on the third party system will be called the source system.
General concept and workflow
Within ScoreExpress an event corresponds to the whole of competitions organized together, e.g. at one location in the same weekend. Within one event, multiple sections of competition can be created, mostly corresponding to different disciplines that are included in the event. Therefor we will call these sections event disciplines.
The transfer of data is initiated from within ScoreExpress (by the user) and consists of two major steps. The first step is to retrieve a list of events from the source system, such that the user can select the event which needs to be imported. In order to do so the source must implement a web service which returns a a list of events in the correct format. The web service must also support a number of filter parameters in order to limit the list that is retrieved.
From the list, the user will select from which events and event disciplines data will be imported.
In the second step data from the event disciplines is collected with a second web service that the source system must provide. Again the service should return the requested data using the correct format, as specified in this document.
The data formats, include many fields, where the source system can add its own ID values for the corresponding data objects. Most of these fields are optional, however, they have crucial role in synchronizing data after the initial import. Therefor, it is strongly advised to include these external ID’s, as they are called.