OSID Logo
OSID Specifications
bidding rules package
Version 3.0.0
Release Candidate Preview
Interfaceosid.bidding.rules.AuctionConstrainerRuleApplicationSession
Implementsosid.OsidSession
Description

This session provides methods to apply AuctionConstrainers to Auctions. An Auction with multiple AuctionConstrainers means any positive rule evaluation across the result in an effective Auction.

MethodgetAuctionHouseId
Description

Gets the AuctionHouse Id associated with this session.

Returnosid.id.Idthe AuctionHouse Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetAuctionHouse
Description

Gets the AuctionHouse associated with this session.

Returnosid.bidding.AuctionHousethe auction house
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanAssignAuctionConstrainers
Description

Tests if this user can alter auction constrainer/auction 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 PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer lookup operations to unauthorized users.

Returnboolean false if mapping is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodassignAuctionConstrainerToAuction
Description

Adds an existing AuctionConstrainer to an Auction.

Parametersosid.id.IdauctionConstrainerIdthe Id of the AuctionConstrainer
osid.id.IdauctionIdthe Id of the Auction
ErrorsALREADY_EXISTS auctionConstrainerId already applied to auctionId
NOT_FOUND auctionConstrainerId or auctionId not found
NULL_ARGUMENT auctionConstrainerId or auctionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodunassignAuctionConstrainerFromAuction
Description

Removes an AuctionConstrainer from an Auction.

Parametersosid.id.IdauctionConstrainerIdthe Id of the AuctionConstrainer
osid.id.IdauctionIdthe Id of the Auction
ErrorsNOT_FOUND auctionConstrainerId or auctionId not found or auctionConstrainerId already applied to auctionId
NULL_ARGUMENT auctionConstrainerId or auctionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanSequenceAuctionConstrainers
Description

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

Returnboolean false if AuctionConstrainer ordering is not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethodmoveAuctionConstrainerAhead
Description

Reorders auction constrainers for an auction by moving the specified auction constrainer in front of a reference auction constrainer.

Parametersosid.id.IdauctionConstrainerIdthe Id of an AuctionConstrainer
osid.id.IdauctionIdthe Id of an Auction
osid.id.IdreferenceIdthe reference auction constrainer Id
ErrorsNOT_FOUND auctionConstrainerId, auctionId, or referenceId not found or, auctionConstrainerId or referenceId not related to auctionId
NULL_ARGUMENT auctionConstrainerId, auctionId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodmoveAuctionConstrainerBehind
Description

Reorders auction constrainers for an auction by moving the specified auction constrainer behind a reference auction constrainer.

Parametersosid.id.IdauctionConstrainerIdthe Id of an AuctionConstrainer
osid.id.IdauctionIdthe Id of an Auction
osid.id.IdreferenceIdthe reference auction constrainer Id
ErrorsNOT_FOUND auctionConstrainerId, auctionId, or referenceId not found or, auctionConstrainerId or referenceId not related to auctionId
NULL_ARGUMENT auctionConstrainerId, auctionId, or referenceId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodorderAuctionConstrainers
Description

Reorders a set of auction constrainers for an auction.

Parametersosid.id.Id[]auctionConstrainerIdsthe Ids for a set of AuctionConstrainers
osid.id.IdauctionIdthe Id of an Auction
ErrorsNOT_FOUND auctionId not found or, an auctionConstrainerId not related to auctionId
NULL_ARGUMENT auctionConstrainerIds or auctionId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.