To use this functionality, your company must have a license for Assignment Export. Go to this page to read more. 

By using Assignment Export, it is possible to send assignment data from Brainville to your system. This is done in 2 steps:

1. Configure the export

2. From any assignment in Brainville, use the Export-button

Configure the export

1. Visit https://www.brainville.com/Configuration/Developer/RequisitionExportSettings

2. Choose type of integration:

Oden - Integration against the Oden platform (https://oden.bi/).
Custom - Integration against custom platform

3. Choose type of authentication (only for Custom integration)

Basic - API call will include specified client secret when calling your end point
OAuth - OAuth authentication, API call will include receied OAuth token when calling your end point

4. Enter endpoint details

Endpoint URL - This is where the assignment data will be posted

If Basic was selected as authentication type:
Client Secret  - When assignment data is posted to the end point, the authentication header "Bearer" will contain the value entered here. Use this value on your side to validate the posting.

If OAuth was selected as authentication type:
OAuth URL  - OAuth authorization server URL
OAuth access token URL - URL for issuing OAuth access token
OAuth scope (optional) - Any scope needed for the OAuth call
Client ID
Client Secret

Use the Export-button

Use the Brainville marketplace to view any assignment. You should now see a button (upper right hand side) for exporting the assignment 


When this button is clicked, the following happens:

1. OAuth-authentication (if configured) is performed. OAuth access token is received by Brainville

2. The assignment data is formatted as a json (see example here) and sent together with the access token (if using OAuth) or configured client secret to the configured endpoint (i.e. your system)

3. The endpoint processes the request and returns a json containing a unique ID identifying the assignement in your system

4. The unique ID from step 3 is stored in Brainville together with the assignment, making it possible to update it in your system by exporting it again

More information on the request and response