public interface CompetencyFoundrySession extends OsidSession
This session provides methods to retrieve Competency
to
Foundry
mappings. A Competency
may appear in
multiple Foundry
objects. Each foundry may have its own
authorizations governing who is allowed to look at it.
This lookup session defines several views:
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupCompetencyFoundryMappings()
Tests if this user can perform lookups of competency/foundry mappings.
|
CompetencyList |
getCompetenciesByFoundries(IdList foundryIds)
Gets the list of competencies corresponding to a list of
Foundries. |
CompetencyList |
getCompetenciesByFoundry(Id foundryId)
Gets the list of competencies associated with a
Foundry. |
IdList |
getCompetencyIdsByFoundries(IdList foundryIds)
Gets the list of
Competency Ids corresponding to a list
of Foundries. |
IdList |
getCompetencyIdsByFoundry(Id foundryId)
Gets the list of
Competency Ids associated with a
Foundry. |
FoundryList |
getFoundriesByCompetency(Id competencyId)
Gets the
Foundries mapped to a Competency. |
IdList |
getFoundryIdsByCompetency(Id competencyId)
Gets the
Foundry Ids mapped to a
Competency. |
void |
useComparativeCompetencyFoundryView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
usePlenaryCompetencyFoundryView()
A complete view of the
Competency and Foundry
returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
boolean canLookupCompetencyFoundryMappings()
PERMISSION_DENIED.
This is intended as
a hint to an application that may opt not to offer lookup operations
to unauthorized users. false
if looking up mappings is not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeCompetencyFoundryView()
mandatory
- This method is must be implemented. void usePlenaryCompetencyFoundryView()
Competency
and Foundry
returns is desired. Methods will return what is requested or
result in an error. This view is used when greater precision is
desired at the expense of interoperability.mandatory
- This method is must be implemented. IdList getCompetencyIdsByFoundry(Id foundryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Competency Ids
associated with a
Foundry.
foundryId
- Id
of the Foundry
Ids
NotFoundException
- foundryId
is not
foundNullArgumentException
- foundryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CompetencyList getCompetenciesByFoundry(Id foundryId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Foundry.
foundryId
- Id
of the Foundry
NotFoundException
- foundryId
is not
foundNullArgumentException
- foundryId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getCompetencyIdsByFoundries(IdList foundryIds) throws OperationFailedException, PermissionDeniedException
Competency Ids
corresponding to a list
of Foundries.
foundryIds
- list of foundry Ids
Ids
NullArgumentException
- foundryIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CompetencyList getCompetenciesByFoundries(IdList foundryIds) throws OperationFailedException, PermissionDeniedException
Foundries.
foundryIds
- list of foundry Ids
NullArgumentException
- foundryIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. IdList getFoundryIdsByCompetency(Id competencyId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Foundry
Ids
mapped to a
Competency.
competencyId
- Id
of a Competency
NotFoundException
- competencyId
is not
foundNullArgumentException
- competencyId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. FoundryList getFoundriesByCompetency(Id competencyId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Foundries
mapped to a Competency.
competencyId
- Id
of a Competency
NotFoundException
- competencyId
is not
foundNullArgumentException
- competencyId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.