See all operations
POST: data-syncs
Description
Creates a new data sync system entry
Does not activate the sync for any projects
How to Execute
To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):
https://api.inflectra.com/spira/services/v7_0/RestService.svc/data-syncs
Request Body
|
Property
|
Description
|
|
DataSyncSystemId
|
The id the data-sync plug-in
|
|
DataSyncStatusId
|
The id of the synchronization status (for the last time it ran)
|
|
Name
|
The name of the data-sync plug-in
|
|
DisplayName
|
The display name of the data-sync plug-in
|
|
Description
|
The description of the data-sync plug-in
|
|
ConnectionString
|
The connection string (often a URL) for accessing the external system
|
|
Login
|
The username / login for accessing the external system
|
|
Password
|
The password for accessing the external system
|
|
TimeOffsetHours
|
The number of hours to add to the last-updated date/times when making comparisons
|
|
Custom01
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom02
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom03
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom04
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom05
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
AutoMapUsers
|
Should we attempt to auto-map user in the two systems
|
|
IsActive
|
Is the data-sync system active
|
<RemoteDataSyncSystem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<AutoMapUsers>false</AutoMapUsers>
<ConnectionString i:nil="true" />
<Custom01 i:nil="true" />
<Custom02 i:nil="true" />
<Custom03 i:nil="true" />
<Custom04 i:nil="true" />
<Custom05 i:nil="true" />
<DataSyncStatusId>0</DataSyncStatusId>
<DataSyncStatusName i:nil="true" />
<DataSyncSystemId>0</DataSyncSystemId>
<Description i:nil="true" />
<DisplayName i:nil="true" />
<IsActive>false</IsActive>
<LastSyncDate i:nil="true" />
<Login i:nil="true" />
<Name i:nil="true" />
<Password i:nil="true" />
<TimeOffsetHours>0</TimeOffsetHours>
</RemoteDataSyncSystem>
{"DataSyncSystemId":0,
"DataSyncStatusId":0,
"Name":null,
"DisplayName":null,
"Description":null,
"ConnectionString":null,
"Login":null,
"Password":null,
"TimeOffsetHours":0,
"LastSyncDate":null,
"Custom01":null,
"Custom02":null,
"Custom03":null,
"Custom04":null,
"Custom05":null,
"AutoMapUsers":false,
"DataSyncStatusName":null,
"IsActive":false}
Return Data
The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.
|
Property
|
Description
|
|
DataSyncSystemId
|
The id the data-sync plug-in
|
|
DataSyncStatusId
|
The id of the synchronization status (for the last time it ran)
|
|
Name
|
The name of the data-sync plug-in
|
|
DisplayName
|
The display name of the data-sync plug-in
|
|
Description
|
The description of the data-sync plug-in
|
|
ConnectionString
|
The connection string (often a URL) for accessing the external system
|
|
Login
|
The username / login for accessing the external system
|
|
Password
|
The password for accessing the external system
|
|
TimeOffsetHours
|
The number of hours to add to the last-updated date/times when making comparisons
|
|
LastSyncDate
|
The date/time that the data-sync last ran
|
|
Custom01
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom02
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom03
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom04
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
Custom05
|
Custom value, its use is dependent on the specific data-sync plug-in
|
|
AutoMapUsers
|
Should we attempt to auto-map user in the two systems
|
|
DataSyncStatusName
|
The display name of the synchronization status
|
|
IsActive
|
Is the data-sync system active
|
<RemoteDataSyncSystem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<AutoMapUsers>false</AutoMapUsers>
<ConnectionString i:nil="true" />
<Custom01 i:nil="true" />
<Custom02 i:nil="true" />
<Custom03 i:nil="true" />
<Custom04 i:nil="true" />
<Custom05 i:nil="true" />
<DataSyncStatusId>0</DataSyncStatusId>
<DataSyncStatusName i:nil="true" />
<DataSyncSystemId>0</DataSyncSystemId>
<Description i:nil="true" />
<DisplayName i:nil="true" />
<IsActive>false</IsActive>
<LastSyncDate i:nil="true" />
<Login i:nil="true" />
<Name i:nil="true" />
<Password i:nil="true" />
<TimeOffsetHours>0</TimeOffsetHours>
</RemoteDataSyncSystem>
{"DataSyncSystemId":0,
"DataSyncStatusId":0,
"Name":null,
"DisplayName":null,
"Description":null,
"ConnectionString":null,
"Login":null,
"Password":null,
"TimeOffsetHours":0,
"LastSyncDate":null,
"Custom01":null,
"Custom02":null,
"Custom03":null,
"Custom04":null,
"Custom05":null,
"AutoMapUsers":false,
"DataSyncStatusName":null,
"IsActive":false}