OSID Logo
OSID Specifications
financials package
Version 3.0.0
Release Candidate Preview
Interfaceosid.financials.FiscalPeriodLookupSession
Implementsosid.OsidSession
Description

This session defines methods for retrieving fiscal periods.

This lookup session defines several views:

  • comparative view: elements may be silently omitted or re-ordered
  • plenary view: provides a complete result set or is an error condition
  • isolated business view: All fiscal period methods in this session operate, retrieve and pertain to fiscal periods defined explicitly in the current business. Using an isolated view is useful for managing FiscalPeriods with the FiscalPeriodAdminSession.
  • federated business view: All fiscal period lookup methods in this session operate, retrieve and pertain to all fiscal periods defined in this business and any other fiscal periods implicitly available in this business through business inheritence.

The methods useFederatedBusinessView() and useIsolatedBusinessView() behave as a radio group and one should be selected before invoking any lookup methods.

MethodgetBusinessId
Description

Gets the Business Id associated with this session.

Returnosid.id.Idthe Business Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetBusiness
Description

Gets the Business associated with this session.

Returnosid.financials.Businessthe business
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanLookupFiscalPeriods
Description

Tests if this user can perform FiscalPeriod lookups. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may not offer lookup operations to unauthorized users.

Returnboolean false if lookup methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseComparativeFiscalPeriodView
Description

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

CompliancemandatoryThis method is must be implemented.
MethodusePlenaryFiscalPeriodView
Description

A complete view of the FiscalPeriod returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

CompliancemandatoryThis method is must be implemented.
MethoduseFederatedBusinessView
Description

Federates the view for methods in this session. A federated view will include fiscal periods in catalogs which are children of this catalog in the business hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedBusinessView
Description

Isolates the view for methods in this session. An isolated view restricts retrievals to this business only.

CompliancemandatoryThis method is must be implemented.
MethodgetFiscalPeriod
Description

Gets the FiscalPeriod specified by its Id. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned FiscalPeriod may have a different Id than requested, such as the case where a duplicate Id was assigned to a FiscalPeriod and retained for compatibility.

Parametersosid.id.IdfiscalPeriodIdthe Id of the FiscalPeriod to retrieve
Returnosid.financials.FiscalPeriodthe returned FiscalPeriod
ErrorsNOT_FOUNDno FiscalPeriod found with the given Id
NULL_ARGUMENT fiscalPeriodId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriodsByIds
Description

Gets a FiscalPeriodList corresponding to the given IdList. In plenary mode, the returned list contains all of the fiscal periods specified in the Id list, in the order of the list, including duplicates, or an error results if an Id in the supplied list is not found or inaccessible. Otherwise, inaccessible FiscalPeriods may be omitted from the list and may present the elements in any order including returning a unique set.

Parametersosid.id.IdListfiscalPeriodIdsthe list of Ids to retrieve
Returnosid.financials.FiscalPeriodListthe returned FiscalPeriod list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT fiscalPeriodIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriodsByGenusType
Description

Gets a FiscalPeriodList corresponding to the given fiscal period genus Type which does not include fiscal periods of types derived from the specified Type. In plenary mode, the returned list contains all known fiscal periods or an error results. Otherwise, the returned list may contain only those fiscal periods that are accessible through this session.

Parametersosid.type.TypefiscalPeriodGenusTypea fiscal period genus type
Returnosid.financials.FiscalPeriodListthe returned FiscalPeriod list
ErrorsNULL_ARGUMENT fiscalPeriodGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriodsByParentGenusType
Description

Gets a FiscalPeriodList corresponding to the given fiscal period genus Type and include any additional fiscal periods with genus types derived from the specified Type. In plenary mode, the returned list contains all known fiscal periods or an error results. Otherwise, the returned list may contain only those fiscal periods that are accessible through this session.

Parametersosid.type.TypefiscalPeriodGenusTypea fiscal period genus type
Returnosid.financials.FiscalPeriodListthe returned FiscalPeriod list
ErrorsNULL_ARGUMENT fiscalPeriodGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriodsByRecordType
Description

Gets a FiscalPeriodList containing the given fiscal period record Type. In plenary mode, the returned list contains all known fiscal periods or an error results. Otherwise, the returned list may contain only those fiscal periods that are accessible through this session.

Parametersosid.type.TypefiscalPeriodRecordTypea fiscal period record type
Returnosid.financials.FiscalPeriodListthe returned FiscalPeriod list
ErrorsNULL_ARGUMENT fiscalPeriodRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriodsByDate
Description

Gets a FiscalPeriodList containing the given date . In plenary mode, the returned list contains all known fiscal periods or an error results. Otherwise, the returned list may contain only those fiscal periods that are accessible through this session.

Parametersosid.calendaring.DateTimedatea date
Returnosid.financials.FiscalPeriodListthe returned FiscalPeriod list
ErrorsNULL_ARGUMENT date is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetFiscalPeriods
Description

Gets all FiscalPeriods. In plenary mode, the returned list contains all known fiscal periods or an error results. Otherwise, the returned list may contain only those fiscal periods that are accessible through this session.

Returnosid.financials.FiscalPeriodLista list of FiscalPeriods
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.