REST API for Clinical One Platform

Generate a report based on the direct report payload

post

/ec-reporting-svc/rest/v2.0/studies/{studyId}/{mode}/reports/direct

Generate a direct report by passing data into payload as JSON with query parameters. Right: ReportingPost.

Request

Path Parameters

mode(required): string

Mode of the study. Accepts test, active, or training.
studyId(required): string

ID of the study for which you want to generate report. Tenant reports such as HSL report etc can be generated by making study id as null.

Query Parameters

format: string

Report format
reportid: string

Report ID

Supported Media Types

Root Schema : schema

Type: object

Response

Supported Media Types

text/html
application/json

202 Response

Success

Root Schema : ExecutionLog

Type: object

Show Source

comment: string

Minimum Length: 0

Maximum Length: 4000
currSearchSpec: string

Minimum Length: 0

Maximum Length: 32000
currSortSpec: string

Minimum Length: 0

Maximum Length: 512
fileStorageId: string (uuid)
id: string (uuid)
objectVersionNumber: number
operationType: string

Minimum Length: 0

Maximum Length: 1024
reason: string

Minimum Length: 0

Maximum Length: 4000
recCount: integer (int32)
rptFormat(required): string

Minimum Length: 0

Maximum Length: 255
rptId: string (uuid)
rptKickoffDatetime(required): string (date-time)
rptName(required): string

Minimum Length: 0

Maximum Length: 255
rptStatCd: string

Minimum Length: 0

Maximum Length: 255
runDuration: integer
softwareVersionNumber: number
userId(required): string (uuid)
versionEnd(required): string (date-time)
versionStart(required): string (date-time)

{
    "required":[
        "rptFormat",
        "rptKickoffDatetime",
        "rptName",
        "userId",
        "versionEnd",
        "versionStart"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "rptId":{
            "type":"string",
            "format":"uuid"
        },
        "versionStart":{
            "type":"string",
            "format":"date-time"
        },
        "runDuration":{
            "type":"integer"
        },
        "userId":{
            "type":"string",
            "format":"uuid"
        },
        "versionEnd":{
            "type":"string",
            "format":"date-time"
        },
        "operationType":{
            "maxLength":1024,
            "minLength":0,
            "type":"string"
        },
        "reason":{
            "maxLength":4000,
            "minLength":0,
            "type":"string"
        },
        "comment":{
            "maxLength":4000,
            "minLength":0,
            "type":"string"
        },
        "rptKickoffDatetime":{
            "type":"string",
            "format":"date-time"
        },
        "rptName":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "rptStatCd":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "rptFormat":{
            "maxLength":255,
            "minLength":0,
            "type":"string"
        },
        "recCount":{
            "type":"integer",
            "format":"int32"
        },
        "currSearchSpec":{
            "maxLength":32000,
            "minLength":0,
            "type":"string"
        },
        "currSortSpec":{
            "maxLength":512,
            "minLength":0,
            "type":"string"
        },
        "objectVersionNumber":{
            "type":"number"
        },
        "softwareVersionNumber":{
            "type":"number"
        },
        "fileStorageId":{
            "type":"string",
            "format":"uuid"
        }
    }
}

400 Response

Bad request

Root Schema : BaseResponse

Type: object

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result
status: string

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "result":{
            "type":"object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        }
    }
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

401 Response

Unauthorized user

Root Schema : BaseResponse

Type: object

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result
status: string

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "result":{
            "type":"object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        }
    }
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.

500 Response

Empty payload

Root Schema : BaseResponse

Type: object

Show Source

errorData: object ErrorResponseData

Title: ErrorResponseData

Error Response Details Information
result: object result
status: string

{
    "type":"object",
    "properties":{
        "status":{
            "type":"string"
        },
        "result":{
            "type":"object"
        },
        "errorData":{
            "$ref":"#/components/schemas/ErrorResponseData"
        }
    }
}

Nested Schema : ErrorResponseData

Type: object

Title: ErrorResponseData

Error Response Details Information

Show Source

details: object Object

Title: Object

Object with error details information.
errorCode: string

Error code which is stored in ErrorCode enum. Example : C1-003

Example: C1-003
errorMessage: string

Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved

Example: Cannot modify object after a study version has been approved

{
    "title":"ErrorResponseData",
    "type":"object",
    "properties":{
        "errorCode":{
            "type":"string",
            "description":"Error code which is stored in ErrorCode enum. Example : C1-003",
            "example":"C1-003"
        },
        "errorMessage":{
            "type":"string",
            "description":"Error message which is stored in service property file. Example : Cannot modify object after a study version has been approved",
            "example":"Cannot modify object after a study version has been approved"
        },
        "details":{
            "title":"Object",
            "type":"object",
            "description":"Object with error details information."
        }
    },
    "description":"Error Response Details Information"
}

Nested Schema : result

Type: object

Nested Schema : Object

Type: object

Title: Object

Object with error details information.