OSID Logo
OSID Specifications
recipe package
Version 3.0.0
Release Candidate Preview
Interfaceosid.recipe.ProcedureSmartCookbookSession
Implementsosid.OsidSession
Description

This session manages queries and sequencing to create "smart" dynamic catalogs. A ProcedureQuery can be retrieved from this session and mapped to this Cookbook to create a virtual collection of Procedures. The awards may be sequenced using the ProcedureSearchOrder from this session.

This Cookbook has a default query that matches any procedure and a default search order that specifies no sequencing. The queries may be examined using a ProcedureQueryInspector. The query may be modified by converting the inspector back to a ProcedureQuery.

MethodgetCookbookId
Description

Gets the Cookbook Id associated with this session.

Returnosid.id.Idthe Cookbook Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetCookbook
Description

Gets the Cookbook associated with this session.

Returnosid.recipe.Cookbookthe Cookbook associated with this session
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanManageSmartCookbooks
Description

Tests if this user can manage smart cook books. 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 cook book management is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodgetProcedureQuery
Description

Gets a procedure query.

Returnosid.recipe.ProcedureQuerythe procedure query
CompliancemandatoryThis method must be implemented.
MethodgetProcedureSearchOrder
Description

Gets a procedure search order.

Returnosid.recipe.ProcedureSearchOrderthe procedure search order
CompliancemandatoryThis method must be implemented.
MethodapplyProcedureQuery
Description

Applies a procedure query to this cookbook.

Parametersosid.recipe.ProcedureQueryprocedureQuerythe procedure query
ErrorsNULL_ARGUMENT procedureQuery is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED procedureQuery not of this service
CompliancemandatoryThis method must be implemented.
MethodinspectProcedureQuery
Description

Gets a procedure query inspector for this cookbook.

Returnosid.recipe.ProcedureQueryInspectorthe procedure query inspector
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
CompliancemandatoryThis method must be implemented.
MethodapplyProcedureSequencing
Description

Applies a procedure search order to this cookbook.

Parametersosid.recipe.ProcedureSearchOrderprocedureSearchOrderthe procedure search order
ErrorsNULL_ARGUMENT procedureSearchOrder is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure occurred
UNSUPPORTED procedureSearchOrder not of this service
CompliancemandatoryThis method must be implemented.
MethodgetProcedureQueryFromInspector
Description

Gets a procedure query from an inspector.

Parametersosid.recipe.ProcedureQueryInspectorprocedureQueryInspectora query inspector
Returnosid.recipe.ProcedureQuerythe procedure query
ErrorsNULL_ARGUMENT procedureQueryInspector is null
UNSUPPORTED procedureQueryInspector is not of this service
CompliancemandatoryThis method must be implemented.