OSID - osid.financials.AccountSmartBusinessSession Service Interface Definition

Interface	osid.financials.AccountSmartBusinessSession
Implements	`osid.OsidSession`
Used By	`osid.financials.FinancialsManager`
Used By	`osid.financials.FinancialsProxyManager`
Description	This session manages queries and sequencing to create "smart" dynamic catalogs. An `AccountQuery` can be retrieved from this session and mapped to this `Business` to create a virtual collection of `Accounts`. The accounts may be sequenced using the `AccountSearchOrder` from this session. This `Business` has a default query that matches any account and a default search order that specifies no sequencing. The queries may be examined using an `AccountQueryInspector`. The query may be modified by converting the inspector back to an `AccountQuery`.
Method	getBusinessId
Description	Gets the `Business` `Id` associated with this session.
Return	`osid.id.Id`		the `Business Id` associated with this session
Compliance	`mandatory`		This method must be implemented.
Method	getBusiness
Description	Gets the `Business` associated with this session.
Return	`osid.financials.Business`		the business
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure
Compliance	`mandatory`		This method must be implemented.
Method	canManageSmartBusinesses
Description	Tests if this user can manage smart businesses. A return of true does not guarantee successful assessment. 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.
Return	`boolean`		`false` if smart business management is not authorized, `true` otherwise
Compliance	`mandatory`		This method must be implemented.
Method	getAccountQuery
Description	Gets an account query.
Return	`osid.financials.AccountQuery`		the account query
Compliance	`mandatory`		This method must be implemented.
Method	getAccountSearchOrder
Description	Gets an account search order.
Return	`osid.financials.AccountSearchOrder`		the account search order
Compliance	`mandatory`		This method must be implemented.
Method	applyAccountQuery
Description	Applies an account query to this business.
Parameters	`osid.financials.AccountQuery`	`accountQuery`	the account query
Errors	NULL_ARGUMENT		`accountQuery` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNSUPPORTED		`accountQuery` not of this service
Compliance	`mandatory`		This method must be implemented.
Method	inspectAccountQuery
Description	Gets an account query inspector for this business.
Return	`osid.financials.AccountQueryInspector`		the account query inspector
Errors	OPERATION_FAILED		unable to complete request
Errors	PERMISSION_DENIED		authorization failure occurred
Compliance	`mandatory`		This method must be implemented.
Method	applyAccountSequencing
Description	Applies an account search order to this business.
Parameters	`osid.financials.AccountSearchOrder`	`accountSearchOrder`	the account search order
Errors	NULL_ARGUMENT		`accountSearchOrder` is `null`
	OPERATION_FAILED		unable to complete request
	PERMISSION_DENIED		authorization failure occurred
	UNSUPPORTED		`accountSearchOrder` not of this service
Compliance	`mandatory`		This method must be implemented.
Method	getAccountQueryFromInspector
Description	Gets an account query from an inspector.
Parameters	`osid.financials.AccountQueryInspector`	`accountQueryInspector`	a query inspector
Return	`osid.financials.AccountQuery`		the account query
Errors	NULL_ARGUMENT		`accountQueryInspector` is `null`
Errors	UNSUPPORTED		`accountQueryInspector` is not of this service
Compliance	`mandatory`		This method must be implemented.