OSID - osid.relationship.rules.RelationshipRulesManager Service Interface Definition

Interface	osid.relationship.rules.RelationshipRulesManager
Implements	`osid.OsidManager`
Implements	`osid.relationship.rules.RelationshipRulesProfile`
Used By	`osid.relationship.RelationshipManager`
Description	The relationship rules manager provides access to relationship rules sessions and provides interoperability tests for various aspects of this service. The sessions included in this manager are: `RelationshipEnablerLookupSession`: a session to retrieve relationship enablers `RelationshipEnablerQuerySession`: a session to query for relationship enablers `RelationshipEnablerSearchSession`: a session to search for relationship enablers `RelationshipEnablerAdminSession`: a session to create and delete relationship enablers `RelationshipEnablerNotificationSession`: a session to receive notifications pertaining to relationship enabler changes `RelationshipEnablerFamilySession`: a session to look up relationship enabler family mappings `RelationshipEnablerFamilyAssignmentSession`: a session to manage relationship enabler to family mappings `RelationshipEnablerSmartFamilySession`: a session to manage dynamic families of relationship enablers `RelationshipEnablerRuleLookupSession`: a session to look up relationship enabler to relationship mappings `RelationshipEnablerRuleApplicationSession`: a session to apply relationship enablers to relationships
Method	getRelationshipEnablerLookupSession
Description	Gets the `OsidSession` associated with the relationship enabler lookup service.
Return	`osid.relationship.rules.RelationshipEnablerLookupSession`		a `RelationshipEnablerLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerLookup()` is `true`.
Method	getRelationshipEnablerLookupSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler lookup service for the given family.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerLookupSession`		a `RelationshipEnablerLookupSession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId is null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerLookup()` and `supportsVisibleFederation()` are `true`.
Method	getRelationshipEnablerQuerySession
Description	Gets the `OsidSession` associated with the relationship enabler query service.
Return	`osid.relationship.rules.RelationshipEnablerQuerySession`		a `RelationshipEnablerQuerySession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerQuery()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerQuery()` is `true`.
Method	getRelationshipEnablerQuerySessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler query service for the given family.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerQuerySession`		a `RelationshipEnablerQuerySession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId is null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerQuery()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerQuery()` and `supportsVisibleFederation()` are `true`.
Method	getRelationshipEnablerSearchSession
Description	Gets the `OsidSession` associated with the relationship enabler search service.
Return	`osid.relationship.rules.RelationshipEnablerSearchSession`		a `RelationshipEnablerSearchSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerSearch()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerSearch()` is `true`.
Method	getRelationshipEnablerSearchSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enablers earch service for the given family.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerSearchSession`		a `RelationshipEnablerSearchSession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId is null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerSearch()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerSearch()` and `supportsVisibleFederation()` are `true`.
Method	getRelationshipEnablerAdminSession
Description	Gets the `OsidSession` associated with the relationship enabler administration service.
Return	`osid.relationship.rules.RelationshipEnablerAdminSession`		a `RelationshipEnablerAdminSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerAdmin()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerAdmin()` is `true`.
Method	getRelationshipEnablerAdminSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler administration service for the given family.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerAdminSession`		a `RelationshipEnablerAdminSession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId is null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerAdmin()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerAdmin()` and `supportsVisibleFederation()` are `true`
Method	getRelationshipEnablerNotificationSession
Description	Gets the `OsidSession` associated with the relationship enabler notification service.
Parameters	`osid.relationship.rules.RelationshipEnablerReceiver`	`relationshipEnablerReceiver`	the notification callback
Return	`osid.relationship.rules.RelationshipEnablerNotificationSession`		a `RelationshipEnablerNotificationSession`
Errors	NULL_ARGUMENT		`relationshipEnablerReceiver` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerNotification()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerNotification()` is `true`.
Method	getRelationshipEnablerNotificationSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler notification service for the given family.
Parameters	`osid.relationship.rules.RelationshipEnablerReceiver`	`relationshipEnablerReceiver`	the notification callback
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerNotificationSession`		a `RelationshipEnablerNotificationSession`
Errors	NOT_FOUND		no family found by the given `Id`
	NULL_ARGUMENT		`relationshipEnablerReceiver` or `familyId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerNotification()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerNotification()` and `supportsVisibleFederation()` are `true`
Method	getRelationshipEnablerFamilySession
Description	Gets the `OsidSession` to lookup relationship enabler family mappings for relationship enablers.
Return	`osid.relationship.rules.RelationshipEnablerFamilySession`		a `RelationshipEnablerRelationshipSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerFamily()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerFamily()` is `true`.
Method	getRelationshipEnablerFamilyAssignmentSession
Description	Gets the `OsidSession` associated with assigning relationship enablers to families.
Return	`osid.relationship.rules.RelationshipEnablerFamilyAssignmentSession`		a `RelationshipEnablerFamilyAssignmentSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerFamilyAssignment()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerFamilyAssignment()` is `true`.
Method	getRelationshipEnablerSmartFamilySession
Description	Gets the `OsidSession` to manage relationship enabler smart families.
Parameters	`osid.id.Id`	`familyId`	the Id of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerSmartFamilySession`		a `RelationshipEnablerSmartFamilySession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerSmartFamily()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerSmartFamily()` is `true`.
Method	getRelationshipEnablerRuleLookupSession
Description	Gets the `OsidSession` associated with the relationship enabler mapping lookup service for looking up the rules applied to the relationship.
Return	`osid.relationship.rules.RelationshipEnablerRuleLookupSession`		a `RelationshipEnablerRuleLookupSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerRuleLookup()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerRuleLookup()` is `true`.
Method	getRelationshipEnablerRuleLookupSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler mapping lookup service for the given relationship for looking up rules applied to a relationship.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerRuleLookupSession`		a `RelationshipEnablerRuleLookupSession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerRuleLookup()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerRuleLookup()` and `supportsVisibleFederation()` are `true`
Method	getRelationshipEnablerRuleApplicationSession
Description	Gets the `OsidSession` associated with the relationship enabler assignment service to apply enablers to relationships.
Return	`osid.relationship.rules.RelationshipEnablerRuleApplicationSession`		a `RelationshipEnablerRuleApplicationSession`
Errors	OPERATION_FAILED		unable to complete request
Errors	UNIMPLEMENTED		`supportsRelationshipEnablerRuleApplication()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerRuleApplication()` is `true` .
Method	getRelationshipEnablerRuleApplicationSessionForFamily
Description	Gets the `OsidSession` associated with the relationship enabler assignment service for the given relationship to apply enablers to relationships.
Parameters	`osid.id.Id`	`familyId`	the `Id` of the `Family`
Return	`osid.relationship.rules.RelationshipEnablerRuleApplicationSession`		a `RelationshipEnablerRuleApplicationSession`
Errors	NOT_FOUND		no `Family` found by the given `Id`
	NULL_ARGUMENT		`familyId` is `null`
	OPERATION_FAILED		unable to complete request
	UNIMPLEMENTED		`supportsRelationshipEnablerRuleApplication()` or `supportsVisibleFederation()` is `false`
Compliance	`optional`		This method must be implemented if `supportsRelationshipEnablerRuleApplication()` and `supportsVisibleFederation()` are `true`