OSID - osid.installation.Installation Service Interface Definition

Interface	osid.installation.Installation
Implements	`osid.OsidObject`
Description	A `Installation` represents a `Package` installed on a `Site.`
Method	getSiteId
Description	Gets the `Site Id` in which this installation is installed.
Return	`osid.id.Id`		the site `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getSite
Description	Gets the `Site` in which this installation is installed.
Return	`osid.installation.Site`		the package site
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getPackageId
Description	Gets the package `Id` of this installation.
Return	`osid.id.Id`		the package `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getPackage
Description	Gets the package.
Return	`osid.installation.Package`		the package
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getDepotId
Description	Gets the `Id` of depot from which the package was installed.
Return	`osid.id.Id`		the depot `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getDepot
Description	Gets the depot from which the package was installed.
Return	`osid.installation.Depot`		the depot
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getInstallDate
Description	Gets the date the package was installed.
Return	`osid.calendaring.DateTime`		the installation date
Compliance	`mandatory`		This method must be implemented.
Method	getAgentId
Description	Gets the `Id` of the agent who installed this package.
Return	`osid.id.Id`		the agent `Id`
Compliance	`mandatory`		This method must be implemented.
Method	getAgent
Description	Gets the agent who installed this package.
Return	`osid.authentication.Agent`		the agent
Errors	OPERATION_FAILED		unable to complete request
Compliance	`mandatory`		This method must be implemented.
Method	getLastCheckDate
Description	Gets the date the installation was last checked for updates.
Return	`osid.calendaring.DateTime`		the last check date
Compliance	`mandatory`		This method must be implemented.
Method	getInstallationRecord
Description	Gets the installation record corresponding to the given `Installation` record `Type.` This method is used to retrieve an object implementing the requested record. The `installationRecordType` may be the `Type` returned in `getRecordTypes()` or any of its parents in a `Type` hierarchy where `hasRecordType(installationRecordType)` is `true` .
Parameters	`osid.type.Type`	`installationRecordType`	the type of the record to retrieve
Return	`osid.installation.records.InstallationRecord`		the installation record
Errors	NULL_ARGUMENT		`installationRecordType` is `null`
	OPERATION_FAILED		unable to complete request
	UNSUPPORTED		`hasRecordType(installationRecordType)` is `false`
Compliance	`mandatory`		This method must be implemented.