Interface | osid.authentication.AgentAgencyAssignmentSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session provides methods to re-assign Moving or adding a reference of an | ||
Method | canAssignAgents | ||
Description |
Tests if this user can alter agent/agency 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 mapping is not authorized, true
otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | canAssignAgentsToAgency | ||
Description |
Tests if this user can alter agent/agency 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 | agencyId | the Id of the Agency |
Return | boolean | false if mapping is not authorized, true
otherwise | |
Errors | NULL_ARGUMENT | agencyId is null | |
Compliance | mandatory | This method must be implemented. | |
Method | getAssignableAgencyIds | ||
Description |
Gets a list of agencies including and under the given agency node in which any agent can be assigned. | ||
Parameters | osid.id.Id | agencyId | the Id of the Agency |
Return | osid.id.IdList | list of assignable agency Ids | |
Errors | NULL_ARGUMENT | agencyId is null | |
OPERATION_FAILED | unable to complete request | ||
Compliance | mandatory | This method must be implemented. | |
Method | getAssignableAgencyIdsForAgent | ||
Description |
Gets a list of agencies including and under the given agency node in which a specific agent can be assigned. | ||
Parameters | osid.id.Id | agencyId | the Id of the Agency |
osid.id.Id | agentId | the Id of the Agent | |
Return | osid.id.IdList | list of assignable bin Ids | |
Errors | NULL_ARGUMENT | agencyId or agentId is null | |
OPERATION_FAILED | unable to complete request | ||
Compliance | mandatory | This method must be implemented. | |
Method | assignAgentToAgency | ||
Description |
Adds an existing | ||
Parameters | osid.id.Id | agentId | the Id of the Agent |
osid.id.Id | agencyId | the Id of the Agency | |
Errors | ALREADY_EXISTS | agentId is already assigned to agencyId | |
NOT_FOUND | agentId or agencyId not found | ||
NULL_ARGUMENT | agentId or agencyId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | unassignAgentFromAgency | ||
Description |
Removes an | ||
Parameters | osid.id.Id | agentId | the Id of the Agent |
osid.id.Id | agencyId | the Id of the Agency | |
Errors | NOT_FOUND | agentId or agencyId not found or
agentId not assigned to agencyId | |
NULL_ARGUMENT | agentId or agencyId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | reassignAgentToAgency | ||
Description |
Moves an | ||
Parameters | osid.id.Id | agentId | the Id of the Agent |
osid.id.Id | fromAgencyId | the Id of the current Agency | |
osid.id.Id | toAgencyId | the Id of the destination Agency | |
Errors | NOT_FOUND | agentId, fromAgencyId, or toAgencyId not
found or agentId not mapped to fromAgencyId | |
NULL_ARGUMENT | agentId, fromAgencyId, or toAgencyId is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. |