This guide gives an overview of the steps required for a Local Actor to add a new capability to the data exchange.


Prerequisites

Before capabilities can be produced or consumed, the following tasks need to be completed:


  1. The organisation needs to be registered and a FreshDesk account is required to create support desk tickets.
  2. A Local Actor needs to be created, including registration of the associated security certificate.


For more details, see the Quick Start Guide and the guide for Creating a Local Actor.


Terminology

Local Actor

Participant organisations may develop one or several C-ITS systems that publish or consume data on the Sweden exchange. Each system that connects to the data exchange is referred to as a “Local Actor”.

One security certificate is registered per Local Actor.


Capability

A capability refers to a data set that is published by one Local Actor and consumed by one or more other Local Actors.

A single Local Actor can publish or consume multiple capabilities.


Capabilities definition formats are described in the C-Roads document “C-ITS IP Based Interface Profile”. The capability description is in JSON format using data fields as shown in the example below:


{ "messageType": "DENM", "publisherId": "SE12345", "publicationId": "SE12345:MY_UNIQUE_ID", "originatingCountry": "SE", "protocolVersion": "DENM:1.2.2", "quadTree": ["01220111","01200132"], "causeCode": ["6","4","5"]
}
JavaScript


Permission

Access and rights for the Sweden data exchange are arranged by Monotch.



Steps for Adding New Capabilities

  1. Describe each capability that will be produced by the actor using data fields as shown in the example above (in JSON format).
  2. Download and fill in the “Add New Capabilities” form which is attached to this article.
  3. Create a new FreshDesk support ticket by clicking on “New Support Ticket” on the Support Home Page.
  4. Attach the form to the support ticket, along with a JSON file for each capability.
  5. Submit the support ticket.
  6. The person who created the support ticket will be notified in a response to the support ticket whether or not the request has been approved.
  7. Once approved, the capabilities will appear in the dashboard as “available” for the Local Actor associated with the capability. 

A new capability can be tested by producing data and consuming it.