Interface | osid.control.DeviceSystemAssignmentSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session provides methods to re-assign Adding a reference of a | ||
Method | canAssignDevices | ||
Description |
Tests if this user can alter device/system mappings. A
return of true does not guarantee successful
authorization. A return of false indicates that it is
known mapping methods in this session will result in a
| ||
Return | boolean | false if control is not authorized, true
otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | canAssignDevicesToSystem | ||
Description |
Tests if this user can alter device/system mappings. A
return of true does not guarantee successful
authorization. A return of false indicates that it is
known mapping methods in this session will result in a
| ||
Parameters | osid.id.Id | systemId | the Id of the System |
Return | boolean | false if control is not authorized, true
otherwise | |
Errors | NULL_ARGUMENT | systemId is null | |
Compliance | mandatory | This method must be implemented. | |
Method | getAssignableSystemIds | ||
Description |
Gets a list of systems including and under the given system node in which any device can be assigned. | ||
Parameters | osid.id.Id | systemId | the Id of the System |
Return | osid.id.IdList | list of assignable system Ids | |
Errors | NULL_ARGUMENT | systemId is null | |
OPERATION_FAILED | unable to complete request | ||
Compliance | mandatory | This method must be implemented. | |
Method | getAssignableSystemIdsForDevice | ||
Description |
Gets a list of systems including and under the given system node in which a specific device can be assigned. | ||
Parameters | osid.id.Id | systemId | the Id of the System |
osid.id.Id | deviceId | the Id of the Device | |
Return | osid.id.IdList | list of assignable system Ids | |
Errors | NULL_ARGUMENT | systemId or deviceId is null | |
OPERATION_FAILED | unable to complete request | ||
Compliance | mandatory | This method must be implemented. | |
Method | assignDeviceToSystem | ||
Description |
Adds an existing | ||
Parameters | osid.id.Id | deviceId | the Id of the Device |
osid.id.Id | systemId | the Id of the System | |
Errors | ALREADY_EXISTS | deviceId is slready assigned to systemId | |
NOT_FOUND | deviceId or systemId not found | ||
NULL_ARGUMENT | deviceId or systemId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | unassignDeviceFromSystem | ||
Description |
Removes a | ||
Parameters | osid.id.Id | deviceId | the Id of the Device |
osid.id.Id | systemId | the Id of the System | |
Errors | NOT_FOUND | deviceId or systemId not found or
deviceId not assigned to systemId | |
NULL_ARGUMENT | deviceId or systemId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | reassignDeviceToSystem | ||
Description |
Moves a | ||
Parameters | osid.id.Id | deviceId | the Id of the Device |
osid.id.Id | fromSystemId | the Id of the current System | |
osid.id.Id | toSystemId | the Id of the destination System | |
Errors | NOT_FOUND | deviceId, fromSystemId, or toSystemId not
found or deviceId not mapped to fromSystemId | |
NULL_ARGUMENT | deviceId, fromSystemId, or toSystemId is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |