Jobs
Execution Manager job scheduling.
Example Telerik.TestStudio.Shared.Communication.Transports.Job object:
{
    "Id": "GUID",
    "Path": "string",
    "PathType": "integer",
    "Credentials": {
        "StorageUri": "string"
    },
    "MachinesToUse": [
        "machine1",
        "machine2"
    ],
    "Schedule": {
        "DayOfMonth": "optional integer",
        "DayOrdinal": "optional integer",
        "DaysOfWeekMask": "integer",
        "FirstDayOfWeek": "integer",
        "Frequency": "integer",
        "Interval": "integer",
        "IsRecurring": "boolean",
        "MaxOccurences": "optional integer",
        "MonthOfYear": "optional integer",
        "RecursUntil": "optional DateTime",
        "TimeToRun": "DateTime"
    },
    "Notification": {
        "AttachAiiResult": "boolean",
        "AttachExcel": "boolean",
        "AttachWord": "boolean",
        "EmailsList": [
            "a@company.com",
            "b@company.com"
        ],
        "Notify": "integer",
        "ShowFailureInformation": "boolean",
        "ShowGeneralInformation": "boolean",
        "Subject": "email subject",
        "TextAfter": "text",
        "TextBefore": "text",
        "TextBetween": "text"
    },
    "ProjectInfo": {
        "ProjectSourceLocation": "path",
        "SchedulingServerUri": "http://localhost:8015",
        "SourceControlServerAddress": "http://tfs.host.domain:port",
        "ProjectRemotePath": "uri",
        "UseSourceControlVersion": "boolean"
    },
    "RootFolder": "string",
    "Distributed": "boolean"
}
Job.PathType allowable values:
0 = RelativeToProjectOnDisk
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
Job.NotificationSettings.Notify allowable values:
0 = NeverNotify
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
Job.Schedule.DaysOfWeekMask allowable values:
0 = None
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
Job.Schedule.FirstDayOfWeek allowable values:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Job.Schedule.Frequency allowable values:
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
GET /Jobs Get all jobs scheduled on the execution manager
Get all jobs scheduled on the execution manager

Parameters

/Jobs

Returns

An array of Telerik.TestStudio.Shared.Communication.Transports.Job objects
Example:
[
    {
        "Id": "GUID",
        "Path": "string",
        "PathType": "integer",
        "Credentials": {
            "StorageUri": "string"
        },
        "MachinesToUse": [
            "machine1",
            "machine2"
        ],
        "Schedule": {
            "DayOfMonth": "optional integer",
            "DayOrdinal": "optional integer",
            "DaysOfWeekMask": "integer",
            "FirstDayOfWeek": "integer",
            "Frequency": "integer",
            "Interval": "integer",
            "IsRecurring": "boolean",
            "MaxOccurences": "optional integer",
            "MonthOfYear": "optional integer",
            "RecursUntil": "optional DateTime",
            "TimeToRun": "DateTime"
        },
        "Notification": {
            "AttachAiiResult": "boolean",
            "AttachExcel": "boolean",
            "AttachWord": "boolean",
            "EmailsList": [
                "a@company.com",
                "b@company.com"
            ],
            "Notify": "integer",
            "ShowFailureInformation": "boolean",
            "ShowGeneralInformation": "boolean",
            "Subject": "email subject",
            "TextAfter": "text",
            "TextBefore": "text",
            "TextBetween": "text"
        },
        "ProjectInfo": {
            "ProjectSourceLocation": "path",
            "SchedulingServerUri": "http://localhost:8015",
            "SourceControlServerAddress": "http://tfs.host.domain:port",
            "ProjectRemotePath": "uri",
            "UseSourceControlVersion": "boolean"
        },
        "RootFolder": "string",
        "Distributed": "boolean"
    }
]
Job.PathType allowable values:
0 = RelativeToProjectOnDisk
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
Job.NotificationSettings.Notify allowable values:
0 = NeverNotify
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
Job.Schedule.DaysOfWeekMask allowable values:
0 = None
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
Job.Schedule.FirstDayOfWeek allowable values:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Job.Schedule.Frequency allowable values:
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
HTTP Status
Reason
200
OK
GET /Jobs/{id} Get job scheduled on the execution manager by job id
Get a job scheduled on the execution manager.

Parameters

/Jobs/{id}
id [Guid] required
Job id

Returns

Telerik.TestStudio.Shared.Communication.Transports.Job object or null
Example:
{
    "Id": "GUID",
    "Path": "string",
    "PathType": "integer",
    "Credentials": {
        "StorageUri": "string"
    },
    "MachinesToUse": [
        "machine1",
        "machine2"
    ],
    "Schedule": {
        "DayOfMonth": "optional integer",
        "DayOrdinal": "optional integer",
        "DaysOfWeekMask": "integer",
        "FirstDayOfWeek": "integer",
        "Frequency": "integer",
        "Interval": "integer",
        "IsRecurring": "boolean",
        "MaxOccurences": "optional integer",
        "MonthOfYear": "optional integer",
        "RecursUntil": "optional DateTime",
        "TimeToRun": "DateTime"
    },
    "Notification": {
        "AttachAiiResult": "boolean",
        "AttachExcel": "boolean",
        "AttachWord": "boolean",
        "EmailsList": [
            "a@company.com",
            "b@company.com"
        ],
        "Notify": "integer",
        "ShowFailureInformation": "boolean",
        "ShowGeneralInformation": "boolean",
        "Subject": "email subject",
        "TextAfter": "text",
        "TextBefore": "text",
        "TextBetween": "text"
    },
    "ProjectInfo": {
        "ProjectSourceLocation": "path",
        "SchedulingServerUri": "http://localhost:8015",
        "SourceControlServerAddress": "http://tfs.host.domain:port",
        "ProjectRemotePath": "uri",
        "UseSourceControlVersion": "boolean"
    },
    "RootFolder": "string",
    "Distributed": "boolean"
}
Job.PathType allowable values:
0 = RelativeToProjectOnDisk
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
Job.NotificationSettings.Notify allowable values:
0 = NeverNotify
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
Job.Schedule.DaysOfWeekMask allowable values:
0 = None
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
Job.Schedule.FirstDayOfWeek allowable values:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Job.Schedule.Frequency allowable values:
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous
HTTP Status
Reason
200
OK
POST /Jobs Schedule a new job on the execution manager
Schedules a new job.
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body.
If no Schedule object is supplied, the job will run immediately.
Credentials is optional. MachinesToUse and ProjectInfo are required to schedule/run a job.
Example:
{
    "Id": "GUID",
    "Path": "string",
    "PathType": "integer",
    "Credentials": {
        "StorageUri": "string"
    },
    "MachinesToUse": [
        "machine1",
        "machine2"
    ],
    "Schedule": {
        "DayOfMonth": "optional integer",
        "DayOrdinal": "optional integer",
        "DaysOfWeekMask": "integer",
        "FirstDayOfWeek": "integer",
        "Frequency": "integer",
        "Interval": "integer",
        "IsRecurring": "boolean",
        "MaxOccurences": "optional integer",
        "MonthOfYear": "optional integer",
        "RecursUntil": "optional DateTime",
        "TimeToRun": "DateTime"
    },
    "Notification": {
        "AttachAiiResult": "boolean",
        "AttachExcel": "boolean",
        "AttachWord": "boolean",
        "EmailsList": [
            "a@company.com",
            "b@company.com"
        ],
        "Notify": "integer",
        "ShowFailureInformation": "boolean",
        "ShowGeneralInformation": "boolean",
        "Subject": "email subject",
        "TextAfter": "text",
        "TextBefore": "text",
        "TextBetween": "text"
    },
    "ProjectInfo": {
        "ProjectSourceLocation": "path",
        "SchedulingServerUri": "http://localhost:8015",
        "SourceControlServerAddress": "http://tfs.host.domain:port",
        "ProjectRemotePath": "uri",
        "UseSourceControlVersion": "boolean"
    },
    "RootFolder": "string",
    "Distributed": "boolean"
}
Job.PathType allowable values:
0 = RelativeToProjectOnDisk
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
Job.NotificationSettings.Notify allowable values:
0 = NeverNotify
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
Job.Schedule.DaysOfWeekMask allowable values:
0 = None
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
Job.Schedule.FirstDayOfWeek allowable values:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Job.Schedule.Frequency allowable values:
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous

Parameters

/Jobs
job [Job] required
Job object. Should be in request body.

Returns

201 Created with job id in response body.
HTTP Status
Reason
201
Created
500
Internal Server Error
555
Custom: No Drones have been registered with this scheduler
556
Custom: Storage service not reachable
558
Custom: Source control server not reachable
PUT /Jobs/{id} Update scheduled job
Updates only scheduled jobs. If no schedule object is supplied update will be rejected.
Expects a Telerik.TestStudio.Shared.Communication.Transports.Job in the request body. Example:
{
    "Id": "GUID",
    "Path": "string",
    "PathType": "integer",
    "Credentials": {
        "StorageUri": "string"
    },
    "MachinesToUse": [
        "machine1",
        "machine2"
    ],
    "Schedule": {
        "DayOfMonth": "optional integer",
        "DayOrdinal": "optional integer",
        "DaysOfWeekMask": "integer",
        "FirstDayOfWeek": "integer",
        "Frequency": "integer",
        "Interval": "integer",
        "IsRecurring": "boolean",
        "MaxOccurences": "optional integer",
        "MonthOfYear": "optional integer",
        "RecursUntil": "optional DateTime",
        "TimeToRun": "DateTime"
    },
    "Notification": {
        "AttachAiiResult": "boolean",
        "AttachExcel": "boolean",
        "AttachWord": "boolean",
        "EmailsList": [
            "a@company.com",
            "b@company.com"
        ],
        "Notify": "integer",
        "ShowFailureInformation": "boolean",
        "ShowGeneralInformation": "boolean",
        "Subject": "email subject",
        "TextAfter": "text",
        "TextBefore": "text",
        "TextBetween": "text"
    },
    "ProjectInfo": {
        "ProjectSourceLocation": "path",
        "SchedulingServerUri": "http://localhost:8015",
        "SourceControlServerAddress": "http://tfs.host.domain:port",
        "ProjectRemotePath": "uri",
        "UseSourceControlVersion": "boolean"
    },
    "RootFolder": "string",
    "Distributed": "boolean"
}
Job.PathType allowable values:
0 = RelativeToProjectOnDisk
1 = AbsoluteOnDisk
2 = Guid
3 = SourceControlWithLocalResults
4 = SourceControlWithCloudResults
Job.NotificationSettings.Notify allowable values:
0 = NeverNotify
1 = OnCompleteOrFailure
2 = OnExecutionFailure
3 = OnTestFailure
Job.Schedule.DaysOfWeekMask allowable values:
0 = None
1 = Sunday
2 = Monday
4 = Tuesday
8 = Wednesday
16 = Thursday
32 = Friday
62 = WeekDays
64 = Saturday
65 = WeekendDays
127 = EveryDay
Job.Schedule.FirstDayOfWeek allowable values:
0 = Sunday
1 = Monday
2 = Tuesday
3 = Wednesday
4 = Thursday
5 = Friday
6 = Saturday
Job.Schedule.Frequency allowable values:
0 = None
1 = Secondly
2 = Minutely
3 = Hourly
4 = Daily
5 = Weekly
6 = Monthly
7 = Yearly
8 = Continuous

Parameters

/Jobs/{id}
id [Guid] required
Job id
job [Job] required
Job object. Should be in request body.

Returns

202 Accepted
HTTP Status
Reason
202
Accepted
500
Internal Server Error
DELETE /Jobs/{id} Stop scheduled/running job by id
Attempts to stop the specified job in the execution manager.

Parameters

/Jobs/{id}
id [Guid] required
Job Id

Returns

Telerik.TestStudio.Shared.Communication.Transports.JobCancelResult object Example:
{
    "CancelledTestListId": [
        "GUID",
        "GUID"
    ]
}
HTTP Status
Reason
200
OK
DELETE /Jobs Stop all scheduled jobs
Attempts to stop the all jobs in the execution manager

Parameters

/Jobs

Returns

Telerik.TestStudio.Shared.Communication.Transports.JobCancelResult object Example:
{
    "CancelledTestListId": [
        "GUID",
        "GUID"
    ]
}
HTTP Status
Reason
200
OK