Oracle Health Sciences mHealth Connector Cloud Service - Studies, Subjects, and Devices - Create a device to receive clinical data from an eSource

Create a device to receive clinical data from an eSource

post

/api/studies/{studyId}/subjects/{subjectId}/devices

Creates a virtual device to collect / receive clinical data from a datasource. Devices are assiged to a subject in the study.

Request

Path Parameters

studyId: string

Study identifier.
subjectId: string

Subject ID.

Supported Media Types

application/json

Subject attributes.

Root Schema : schema

Type: object

Show Source

esourceName(optional): string

Optional field. Use to identify source cloud incase of cloud-to-cloud (c2c) data integrations. Leave this field empty for device-to-cloud (d2c) data transfer scenario.
srcDeviceName(optional): string

Optional field. Device or eSource name.
surrogateSubjId(optional): string

Optional field. Surrogate subject identifier for the orginal subject. If this field is empty or not included in the request, mHealth Cloud uses subject number (srcSubjId attribute of Subject entity) as the value.
targetSubjIdMap: array targetSubjIdMap

Subject ID in each target application.

{
    "required":[
        "targetSubjIdMap"
    ],
    "type":"object",
    "properties":{
        "surrogateSubjId":{
            "type":"string",
            "description":"Optional field. Surrogate subject identifier for the orginal subject.  If this field is empty or not included in the request,  mHealth Cloud uses subject number (srcSubjId attribute of Subject  entity) as the value."
        },
        "srcDeviceName":{
            "type":"string",
            "description":"Optional field. Device or eSource name."
        },
        "esourceName":{
            "type":"string",
            "description":"Optional field. Use to identify source cloud incase of cloud-to-cloud  (c2c) data integrations. Leave this field empty for device-to-cloud (d2c) data transfer scenario."
        },
        "targetSubjIdMap":{
            "type":"array",
            "description":"Subject ID in each target application.",
            "items":{
                "$ref":"#/components/schemas/TargetSubj"
            }
        }
    }
}

Nested Schema : targetSubjIdMap

Type: array

Subject ID in each target application.

Show Source

Array of: object TargetSubj

{
    "type":"array",
    "description":"Subject ID in each target application.",
    "items":{
        "$ref":"#/components/schemas/TargetSubj"
    }
}

Nested Schema : TargetSubj

Type: object

Show Source

subjId: string

subject ID in the target application.
type: string

Target type. Possible values are INFORM, DMW, or DEFAULT. Use DEFAULT type if the same subject Id is to be used across all targets. If DEFAULT and a specific target type exist in a map, the specific target type gets higher precedence over the DEFAULT type.

{
    "required":[
        "subjId",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"Target type. Possible values are INFORM, DMW, or DEFAULT. Use DEFAULT type if the same subject Id is to be used across all targets. If DEFAULT and a specific target type exist in a map, the specific target type gets higher precedence over the DEFAULT type."
        },
        "subjId":{
            "type":"string",
            "description":"subject ID in the target application."
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Successful operation.

Root Schema : device

Type: object

Show Source

esourceName(optional): string

Representation of the eSource name. Used when a device message gets into the mHealth platform through a cloud-to-cloud (c2c) connector. Leave this field empty for device-to-cloud (d2c) connector.
id: string(uuid)

Device instance identifier.
iotDeviceId: string(uuid)

DeviceId created for the virtual device in the underlying IoT Cloud.
srcDeviceName(optional): string

An arbitrary name set by the caller application when the device instance was created.
studyId: string

mHealth study identifier.
subjectId: string(uuid)

Subject identifier in the mHealth Connector Cloud. Generated when a subject is registered in an mHealth study.
surrogateSubjId: string

Surrogate subject identifier. This could be automatically generated by the mHealth Connector Cloud or set by the customer's subject management system. Device data payload must use this value as KEY_UID field.
targetSubjIdMap: array targetSubjIdMap

Subject ID in each target application.

{
    "required":[
        "id",
        "iotDeviceId",
        "studyId",
        "subjectId",
        "surrogateSubjId",
        "targetSubjIdMap"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Device instance identifier.",
            "format":"uuid"
        },
        "subjectId":{
            "type":"string",
            "description":"Subject identifier in the mHealth Connector Cloud. Generated when a subject is registered in an mHealth study.",
            "format":"uuid"
        },
        "targetSubjIdMap":{
            "type":"array",
            "description":"Subject ID in each target application.",
            "items":{
                "$ref":"#/components/schemas/TargetSubj"
            }
        },
        "surrogateSubjId":{
            "type":"string",
            "description":"Surrogate subject identifier. This could be automatically generated by the mHealth Connector Cloud or set by the customer's subject management system. Device data payload must use this value as KEY_UID field."
        },
        "srcDeviceName":{
            "type":"string",
            "description":"An arbitrary name set by the caller application when the device instance was created."
        },
        "esourceName":{
            "type":"string",
            "description":"Representation of the eSource name. Used when a device message gets\n  into the mHealth platform through a cloud-to-cloud  (c2c) connector.\n  Leave this field empty for device-to-cloud (d2c) connector. "
        },
        "iotDeviceId":{
            "type":"string",
            "description":"DeviceId created for the virtual device in the underlying IoT Cloud.",
            "format":"uuid"
        },
        "studyId":{
            "type":"string",
            "description":"mHealth study identifier."
        }
    },
    "xml":{
        "name":"device"
    }
}

Nested Schema : targetSubjIdMap

Type: array

Subject ID in each target application.

Show Source

Array of: object TargetSubj

{
    "type":"array",
    "description":"Subject ID in each target application.",
    "items":{
        "$ref":"#/components/schemas/TargetSubj"
    }
}

Nested Schema : TargetSubj

Type: object

Show Source

subjId: string

subject ID in the target application.
type: string

Target type. Possible values are INFORM, DMW, or DEFAULT. Use DEFAULT type if the same subject Id is to be used across all targets. If DEFAULT and a specific target type exist in a map, the specific target type gets higher precedence over the DEFAULT type.

{
    "required":[
        "subjId",
        "type"
    ],
    "type":"object",
    "properties":{
        "type":{
            "type":"string",
            "description":"Target type. Possible values are INFORM, DMW, or DEFAULT. Use DEFAULT type if the same subject Id is to be used across all targets. If DEFAULT and a specific target type exist in a map, the specific target type gets higher precedence over the DEFAULT type."
        },
        "subjId":{
            "type":"string",
            "description":"subject ID in the target application."
        }
    }
}

400 Response

Invalid payload.

404 Response

Invalid studyId or subjectId.