Interface | osid.offering.ResultAdminSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session creates, updates, and deletes Create and update operations differ in their usage. To
create an For updates, The delete operations delete This session includes an | ||
Method | getCatalogueId | ||
Description |
Gets the | ||
Return | osid.id.Id | the Catalogue Id associated with this session | |
Compliance | mandatory | This method must be implemented. | |
Method | getCatalogue | ||
Description |
Gets the | ||
Return | osid.offering.Catalogue | the catalogue | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canCreateResults | ||
Description |
Tests if this user can create results. A return of true
does not guarantee successful authorization. A return of
false indicates that it is known creating an | ||
Return | boolean | false if Result creation is not authorized,
true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | canCreateResultWithRecordTypes | ||
Description |
Tests if this user can create a single | ||
Parameters | osid.type.Type[] | resultRecordTypes | array of result record types |
Return | boolean | true if Result creation using the specified
record Types is supported, false otherwise | |
Errors | NULL_ARGUMENT | resultRecordTypes is null | |
Compliance | mandatory | This method must be implemented. | |
Method | getResultFormForCreate | ||
Description |
Gets the result form for creating new results. A new form should be requested for each create transaction. | ||
Parameters | osid.id.Id | canonicalUnitId | the canonical unit Id |
osid.id.Id | particpantId | the particpant Id | |
osid.type.Type[] | resultRecordTypes | array of result record types to be included in the create operation or an empty list if none | |
Return | osid.offering.ResultForm | the result form | |
Errors | NOT_FOUND | canonicalUnitId or particpantId is not found | |
NULL_ARGUMENT | canonicalUnitId, particpantId, or resultRecordTypes
is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
UNSUPPORTED | cannot get form for requested record types | ||
Compliance | mandatory | This method must be implemented. | |
Method | createResult | ||
Description |
Creates a new | ||
Parameters | osid.offering.ResultForm | resultForm | the form for this Result |
Return | osid.offering.Result | the new Result | |
Errors | ILLEGAL_STATE | resultForm already used in a create transaction | |
INVALID_ARGUMENT | one or more of the form elements is invalid | ||
NULL_ARGUMENT | resultForm is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
UNSUPPORTED | resultForm did not originate from
getResultFormForCreate() | ||
Compliance | mandatory | This method must be implemented. | |
Method | canUpdateResults | ||
Description |
Tests if this user can update results. A return of true
does not guarantee successful authorization. A return of
false indicates that it is known updating an | ||
Return | boolean | false if Result modification is not
authorized, true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | getResultFormForUpdate | ||
Description |
Gets the result form for updating an existing result. A new result form should be requested for each update transaction. | ||
Parameters | osid.id.Id | resultId | the Id of the Result |
Return | osid.offering.ResultForm | the result form | |
Errors | NOT_FOUND | resultId is not found | |
NULL_ARGUMENT | resultId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | updateResult | ||
Description |
Updates an existing result. | ||
Parameters | osid.offering.ResultForm | resultForm | the form containing the elements to be updated |
Errors | ILLEGAL_STATE | resultForm already used in an update transaction | |
INVALID_ARGUMENT | the form contains an invalid value | ||
NULL_ARGUMENT | resultForm is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
UNSUPPORTED | resultForm did not originate from
getResultFormForUpdate() | ||
Compliance | mandatory | This method must be implemented. | |
Method | canDeleteResults | ||
Description |
Tests if this user can delete results. A return of true
does not guarantee successful authorization. A return of
false indicates that it is known deleting an | ||
Return | boolean | false if Result deletion is not authorized,
true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | deleteResult | ||
Description |
Deletes an | ||
Parameters | osid.id.Id | resultId | the Id of the Result to remove |
Errors | NOT_FOUND | resultId not found | |
NULL_ARGUMENT | resultId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canManageResultAliases | ||
Description |
Tests if this user can manage | ||
Return | boolean | false if Result aliasing is not authorized,
true otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | aliasResult | ||
Description |
Adds an | ||
Parameters | osid.id.Id | resultId | the Id of an Result |
osid.id.Id | aliasId | the alias Id | |
Errors | ALREADY_EXISTS | aliasId is in use as a primary Id | |
NOT_FOUND | resultId not found | ||
NULL_ARGUMENT | resultId or aliasId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |