OSID Logo
OSID Specifications
profile package
Version 3.0.0
Release Candidate Preview
Interfaceosid.profile.ProfileEntrySmartProfileSession
Implementsosid.OsidSession
Description

This session manages queries and sequencing to create "smart" dynamic catalogs. A ProfileEntryQuery can be retrieved from this session and mapped to this Profile to create a virtual collection of profile entries. The profile entries may be sequenced using the ProfileEntrySearchOrder from this session.

This Profile has a default query that matches any profile Item and a default search order that specifies no sequencing. The queries may be examined using a ProfileEntryQueryInspector. The query may be modified by converting the inspector back to a ProfileEntryQuery.

MethodgetProfileId
Description

Gets the Profile Id associated with this session.

Returnosid.id.Idthe Profile Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetProfile
Description

Gets the Profile associated with this session.

Returnosid.profile.Profilethe Profile associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanManageSmartProfiles
Description

Tests if this user can manage smart profiles. A return of true does not guarantee successful authorization. A return of false indicates that it is known methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer operations to unauthorized users.

Returnboolean false if smart profile management is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodgetProfileEntryQuery
Description

Gets a profile entry query.

Returnosid.profile.ProfileEntryQuerythe profile entry query
CompliancemandatoryThis method must be implemented.
MethodgetProfileEntrySearchOrder
Description

Gets a profile entry search order.

Returnosid.profile.ProfileEntrySearchOrderthe profile entry search order
CompliancemandatoryThis method must be implemented.
MethodapplyProfileEntryQuery
Description

Applies a profile entry query to this profile.

Parametersosid.profile.ProfileEntryQueryprofileEntryQuerythe profile entry query
ErrorsNULL_ARGUMENT profileEntryQuery is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED profileEntryQuery not of this service
CompliancemandatoryThis method must be implemented.
MethodinspectProfileEntryQuery
Description

Gets a profile entry query inspector for this profile.

Returnosid.profile.ProfileEntryQueryInspectorthe profile entry query inspector
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodapplyProfileEntrySequencing
Description

Applies a profile entry search order to this profile.

Parametersosid.profile.ProfileEntrySearchOrderprofileEntrySearchOrderthe profile entry search order
ErrorsNULL_ARGUMENT profileEntrySearchOrder is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED profileEntrySearchOrder not of this service
CompliancemandatoryThis method must be implemented.
MethodgetProfileEntryQueryFromInspector
Description

Gets a profile entry query from an inspector.

Parametersosid.profile.ProfileEntryQueryInspectorprofileEntryQueryInspectora profile entry query inspector
Returnosid.profile.ProfileItemQuerythe profile entry query
ErrorsNULL_ARGUMENT profileEntryQueryInspector is null
UNSUPPORTED profileEntryQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.