WIP
RAFT Service
Name
RAFT Service
Version
Dev ([0.1])
[Release Notes]
Description
The RAFT Service is focused on providing a consistent interface for:
- Searching for Cost Objects and Cost Object Collections
- Viewing Budget, Actual, Commitments, and Forecast information for Cost Object Collections
- Creating What If scenarios as collections of speculations
- Viewing the projected impacts of those speculations
- Generating and viewing reports on this information
References
see RAFT Requirements Documentation (RAFT-*)
Operations
Domain Operations
getModelTypes
searchbyParm(&parm)
searchCollectionbyParm(&collection,&parm)
Listinfo about user sets
getSearchLists
listSupervisor(#count)
listAddressee(#count)
listSponsor(#count)
listPrimeSponsor(#count)
listId(#count)
listWorksets(#count)
listFlaggedCostObjects(#count)
addComment
deleteComment
updateComment
getComment
getCommentsforObject
addWorksetAuthorizations
dropWorksetAuthorizations
viewAuthorizationsforUser
viewAuthorizationsforObject
List info about cost objects
listBudgets(CO,withchildren)
listWorksetScenarios(Workset,withchildren)
listCOScenarios(CO, withchildren)
listProjectPeriods
updateProjectPeriods
addProjectPeriod
dropProjectPeriod
validateProjectPeriods
listReport
executeReport
listDomain
buildDomainReport
executeDomainReport
Summary
BvAQueryDay
RvEQueryDay
BvAQueryMonth
RvEQueryMonth
Query
queryActualsSumm
queryActualsPODetail
queryActualsPEDetail
queryBudgetDay
queryCommitmentsSumm
queryCommitmentsPODetail
queryCommitmentsPEDetail
queryForecastSumm
queryForecastPODetail
queryForecastPEDetail
workset Management
createWorkset
deleteWorkset
archiveWorkset
listWorksets
showWorkset
addWorksetObj
delWorksetObj
addWorksetRule
deleteWorksetRule
updateWorksetfromRules
showWorksetChanges
showAccessChanges
showBalanceExceptions
showworksetCOSummary
showworksetApptSummary
scenario Management
showCOAttributes
showApptAttributes
showScenarioOverview
showScenaroFinImpact
showScenarioPersonImpact
showScenarioDetail
showCOExpenseDetail
showCOPersonDetail
showCODetail
showApptDetail
createScenario
deleteScenario
addCOtoScenario
addAppttoScenario
dropCOfromScenario
dropApptfromScenario
copyScenario
archiveScenario
addAssumption
dropAssumption
updateAssumption
addExpenseAllocSpec
addApptAllocSpec
updateExpenseAllocSpec
updateApptAllocSpec
dropExpenseAllocSpec
dropApptAllocSpec
addTBACOSpec
addTBHApptSpec
dropTBACOSpec
dropTBHApptSpec
updateCOSpec
updateApptSpec
addAdjSpec
dropAdjSpec
addCORateSpec
dropCORateSpec
updateFTESpec
updateVacationSpec
createExpenseAllocSpecfromCOEUS
createExpenseAllocSpecfromSAP
createPersonAllocSpecfromCOEUS
recalcApptDetail
recalcExpenseDetail
buildScenarioSummary
buildWorksetSummary
updateUserPrefGL
updateUserPrefBudget
checkSystemStatus
setScenarioVisibility
setWorksetVisibility
checkProjectedBalance
checkGLBudget
checkMonthlyBurn
checkPersonAlloc
checkRemainingGLBalance
checkRemainingBalance
addProjectTerm
dropProjectTerm
checkProjectTerms
showGlsInCategory
showGLHierarchy
showRatesonObj
showVarianceonScenario
showlineItemsonGL
Search">Search
Method
searchByParm
Description
Searches the cost collector set and returns matches based on the passed in parameters
Parameters
Array
Parm
An associative array of key value pairs for search parameters
Return
[coResultType]
Returns cost object details for all of the matching cost objects.
Errors
NO_MATCH
No cost objects found
MAX_COUNT
Number of objects returned >250
Capabilities
Use Cases
See RAFT-Search
Comments/Feedback
Method
searchCollectionByParm
Description
Performs a collection search based off the identified parameters. Collection searches cannot be used to define sets
Parameters
String
Collection
Which collection will be searched, one of supervisor, sponsor, fund_center, profit_center, workset
Array
Parm
An associative array of key value pairs for search parameters
Return
[collectionResultType]
Returns cost object details for all of the matching cost objects wrapped in a metadata header for the collection.
Errors
NO_MATCH
No cost objects found
MAX_COUNT
Count of returned objects (including the collection header) exceeds 250 and cannot be displayed.
Capabilities
Use Cases
Comments/Feedback
Method
getSearchLists
Description
Returns the default collection of selection items for each of the search lists.
Parameters
Array
Parm
An associative array of key value pairs for search parameters
Return
[listSetResultType]
Master structure for list data that includes supervisor, addressee, sponsor, prime_sponsor, workset. The set always returns a max of 150 entries. To extend beyond that requires the user to use the autocomplete methods.
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listSupervisor
Description
Returns the list of supervisors accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listAddressee
Description
Returns the list of adressees accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listSponsor
Description
Returns the list of sponsors accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listPrimeSponsor
Description
Returns the list of prime sponsors accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listWorkset
Description
Returns the list of worksets accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listId
Description
Returns the list of cost object ids and titles accessible by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[listResultType]
Array list of key, value pairs
Errors
Capabilities
Use Cases
Comments/Feedback
Method
listFlaggedCostObjects
Description
Returns the list of flagged cost objects flagged by the requesting user.
Parameters
Integer
Count
The number of entries to return.
Return
[coResultType]
Returns cost object details for all of the matching cost objects
Errors
Capabilities
Use Cases
Comments/Feedback
Comment">Comment
Method
addComment
Description
Adds a comment to the identified object
Parameters
Comment_Type
Comment_Type
Denotes whether a particular comment is public or private.
Ref_Type
Ref_Type
Identifies what sort of speculation the reference is on (EXPENSE_RULE, APPT_RULE, APPT, CO, SCENARIO, WORKSET)
String
REF_ID
The object id for the associated item (cost_collector_key, etc.)
Return
[confirmResultType]
Returns status information and object id for the action (in this case, the comment)
Errors
EXISTS
Object already exists
NO_MATCH
Object identified by REF_ID does not exist
EMPTY
Comment body is empty
NO_AUTH
User does not have comment authorizations here.
Capabilities
Use Cases
Comments/Feedback
Method
deleteComment
Description
Sets the status for the identified comment to 'D', effectively removing the comment from display.
Parameters
Array
Parm
An associative array of key value pairs for search parameters
Return
[confirmResultType]
Returns the result status and objectId for the action.
Errors
NO_MATCH
No comment match found
NO_AUTH
User cannot delete this authorization.
Capabilities
Use Cases
Comments/Feedback
Method
getComment
Description
Requests the Comment from the system.
Parameters
String
Comment_Id
The specific comment to retreive
Return
[commentResultType]
Object containing the associated comments
Errors
NO_MATCH
No comment found
NO_AUTH
User does not have access to this comment
Capabilities
Use Cases
Comments/Feedback
Method
getCommentsforObject
Description
Returns all comments associated with the identified object
Parameters
String
REF_TYPE
The type of object to look up comments for
String
REF_ID
The Id for the object to look up comments for (cost_collector_key, personell_key, etc.)
Return
[commentResultType]
Object containing the associated comments. If there is no match than an empty structure is returned.
Errors
NO_MATCH
No object found
NO_AUTH
User does not have access to look at comments on this object.
Capabilities
Use Cases
Comments/Feedback