Get a program
get
/fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}
Request
Path Parameters
-
projectProgramsUniqID(required): string
This is the hash key of the attributes which make up the composite key for the Project Programs resource and used to uniquely identify an instance of Project Programs. The client should not generate the hash key value. Instead, the client should query on the Project Programs collection resource in order to navigate to a specific instance of Project Programs to get the hash key.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : projectPrograms-item-response
Type:
Show Source
object-
AssessmentCode: string
Title:
Assessment CodeMaximum Length:30The code that represents the program owner's ongoing assessment for the likelihood that the program will meet the program objectives. Examples for assessments are On track and At risk. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_ASSESSMENT. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
AssessmentMeaning: string
Title:
Assessment CodeThe program owner's ongoing assessment for the likelihood that the program will meet the program objectives. Examples for assessments are On track and At risk. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_ASSESSMENT. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the record was created. -
FinishDate: string
(date)
Title:
Finish DateThe date when the program is finished. The value is for informational purposes only. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the record was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the record. -
LineOfBusinessCode: string
Title:
Line of Business CodeMaximum Length:30The code that represents the line of business name for the set of products and services that are managed by the program. Examples for line of business names are Product development and All lines of business. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_BUSINESS. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
LineOfBusinessMeaning: string
The line of business name for the set of products and services that are managed by the program. Examples for line of business names are Product development and All lines of business. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_BUSINESS. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OwningOrganizationId: integer
(int64)
Title:
Owning Organization IDThe unique identifier of the owning organization. -
OwningOrganizationName: string
The name of the owning organization. The value is for informational purposes only. Review and update organizations classified as owning organizations using the Setup and Maintenance work area and the task Manage Project Organization Classifications.
-
ParentProgramId: integer
(int64)
Title:
Parent Program IDThe unique identifier of the parent program. A program without a parent is the root node in the hierarchy structure. -
ParentProgramNumber: string
The unique number of the parent program. A program without a parent is the root node in the hierarchy structure.
-
PriorityCode: string
Title:
Priority CodeMaximum Length:30The code that represents the priority for the program. Examples for priority are High, Medium, and Low. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_PRIORITY. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
PriorityMeaning: string
The priority for the program. Examples for priority are High, Medium, and Low. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_PRIORITY. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task.
-
ProgramAvatars: array
Program Avatars
Title:
Program AvatarsThe Program Avatars resource is used to manage the avatar image for a program. A program can have only one avatar at a time. -
ProgramBudget: number
The budgeted amount allotted to the program.
-
ProgramBudgetCurrency: string
Maximum Length:
15The currency of the budgeted amount allotted to the program. -
ProgramDescription: string
Maximum Length:
2000The description of the program. -
ProgramDFF: array
ProgramDFF
-
ProgramName: string
Maximum Length:
240The unique name of the program. A value is required to create a program. -
ProgramNotes: array
Program Notes
Title:
Program NotesThe Program Notes resource is used to manage notes for programs. -
ProgramNumber: string
Title:
Program NumberMaximum Length:25The unique number of the program. The default value is the unique identifier of the program. -
ProgramObjective: string
Maximum Length:
400The objective of the program. -
ProgramProjects: array
Project Assignments
Title:
Project AssignmentsThe Project Assignments resource is used to manage the assignments of projects to a program. -
ProgramStakeholders: array
Stakeholders
Title:
StakeholdersThe Stakeholders resource is used to manage the assignment of stakeholders and program administrators for a program. -
ProgramStatusName: string
The status of the program. Examples for status are Draft and Active. A value is required to create a program. Review and update the program status list of values using the Setup and Maintenance work area and the Manage Project Statuses task.
-
ProgramSystemStatusCode: string
Maximum Length:
30Default Value:ORA_PROGRAM_ACTIVEThe code that represents the system status defined for the program status. Values are DRAFT, SUBMITTED, ACTIVE, PENDING_CLOSE, and CLOSED. Review and update the program status list of values using the Setup and Maintenance work area and the Manage Project Statuses task. -
ProjectProgramId: integer
(int64)
Title:
Program IDRead Only:trueThe unique identifier of the program. -
PublicFlag: boolean
Title:
Public accessMaximum Length:1Default Value:falseIndicates whether the program hierarchy can be viewed by all. If true, then programs in the hierarchy can be viewed by all. If false, then only the persons assigned as stakeholders directly or inherited from a parent or grandparent program can view their programs. The value is defined for the root node of the hierarchy. The default value is false. -
RegionCode: string
Title:
Region CodeMaximum Length:30The code that represents the geographic or divisional region that's covered by the program. Examples for region names are North America and All regions. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_REGION. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
RegionMeaning: string
The geographic or divisional region that's covered by the program. Examples for region names are North America and All regions. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_REGION. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task.
-
StartDate: string
(date)
Title:
Start DateThe date on which the program starts. The value is for informational purposes only. -
StrategyCode: string
Title:
Strategy CodeMaximum Length:30The code that represents the strategic plan of actions and policies that are targeted by the program. An example for strategy is Innovation. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_STRATEGY. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task. -
StrategyMeaning: string
The strategic plan of actions and policies that are targeted by the program. An example strategy is Innovation. A list of accepted values is defined in the lookup type ORA_PROJECT_PROGRAM_STRATEGY. Review and update the list of values using the Setup and Maintenance work area and the Manage Standard Lookups task.
-
TreeStructureId: integer
(int64)
Title:
Tree Structure IDThe unique identifier of the program hierarchy structure.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Program Avatars
Type:
arrayTitle:
Program AvatarsThe Program Avatars resource is used to manage the avatar image for a program. A program can have only one avatar at a time.
Show Source
Nested Schema : Program Notes
Type:
arrayTitle:
Program NotesThe Program Notes resource is used to manage notes for programs.
Show Source
Nested Schema : Project Assignments
Type:
arrayTitle:
Project AssignmentsThe Project Assignments resource is used to manage the assignments of projects to a program.
Show Source
Nested Schema : Stakeholders
Type:
arrayTitle:
StakeholdersThe Stakeholders resource is used to manage the assignment of stakeholders and program administrators for a program.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : projectPrograms-ProgramAvatars-item-response
Type:
Show Source
object-
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the record was created. -
Image: string
(byte)
Title:
ImageThe base 64 encoded image. -
ImageId: integer
(int64)
Title:
Image IDRead Only:trueThe unique identifier of the image for a program. -
ImageName: string
Title:
Image NameMaximum Length:240The name of the image. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the record was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPrograms-ProgramDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context SegmentMaximum Length:30Context Segment -
__FLEX_Context_DisplayValue: string
Title:
Context SegmentContext Segment -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ProjectProgramId: integer
(int64)
Title:
Program IDRead Only:true
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPrograms-ProgramNotes-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CreatorPartyId: integer
(int64)
Title:
Creator Party IDUnique identifier of the user who created the note. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NoteId: integer
(int64)
Title:
Note IDRead Only:trueThe unique identifier of the program note. -
NoteNumber: string
Title:
Note NumberMaximum Length:30The unique number of the program note. The default value is a system-generated number. -
NoteTxt: string
(byte)
Title:
Note TextThe text for the program note. -
PartyName: string
Read Only:
trueMaximum Length:360Name of the user who created the note.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPrograms-ProgramProjects-item-response
Type:
Show Source
object-
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the record was created. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the record was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ProgramProjectNotes: array
Project Assignment Notes
Title:
Project Assignment NotesThe Project Assignment Notes resource is used to manage notes for the project assignments to a program. -
ProjectId: integer
(int64)
Title:
Project IDThe unique identifier of the project. -
ProjectNumber: string
The unique number of the project.
-
RelationshipId: integer
(int64)
Title:
Project Association IDThe unique identifier of the project assignment to a program.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Project Assignment Notes
Type:
arrayTitle:
Project Assignment NotesThe Project Assignment Notes resource is used to manage notes for the project assignments to a program.
Show Source
Nested Schema : projectPrograms-ProgramProjects-ProgramProjectNotes-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CreatorPartyId: integer
(int64)
Title:
Creator Party IDUnique identifier of the user who created the note. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NoteId: integer
(int64)
Title:
Note IDRead Only:trueThe unique identifier of the project assignment note. -
NoteNumber: string
Title:
Note NumberMaximum Length:30The unique number of the project assignment note. The default value is a system-generated number. -
NoteTxt: string
(byte)
Title:
Note TextThe text for the project assignment note. -
PartyName: string
Read Only:
trueMaximum Length:360Name of the user who created the note.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : projectPrograms-ProgramStakeholders-item-response
Type:
Show Source
object-
AccessType: string
The access type for the assignee. The assignee with owner access can edit and delete the program. An assignee with contributor access can edit the program. An assignee with viewer access can view the program and receive stakeholder communications. The person who creates the program is the default owner. Only one direct assignment can have owner access at a given time. Valid values are Owner, Contributor, and Viewer. The default value is Viewer.
-
AccessTypeCode: string
Title:
Access Type CodeMaximum Length:30The code that represents the access type for the assignee. The assignee with owner access can edit and delete the program. An assignee with contributor access can edit the program. An assignee with viewer access can view the program and receive stakeholder communications. The person who creates the program is the default owner. Only one direct assignment can have owner access at a given time. Valid values are OWNER, EDIT, and VIEW. The default value is VIEW. -
AssignmentCategory: string
Read Only:
trueThe assignment category for the assignee as directly assigned or inherited from the program's parent or grandparent in the program hierarchy. Values are Inherited and Direct. -
AssignmentCategoryCode: string
Title:
Assignment Category CodeRead Only:trueMaximum Length:30Default Value:ORA_PJS_DIRECTThe code that represents the assignment category for the assignee as directly assigned or inherited from the program's parent or grandparent in the program hierarchy. Values are INHERITED and DIRECT. -
CreatedBy: string
Read Only:
trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Read Only:
trueThe date when the record was created. -
Image: string
(byte)
Title:
ImageRead Only:trueThe avatar image for a person. -
ImageId: integer
(int64)
Read Only:
trueThe unique identifier of the avatar image for a person. -
ImageName: string
Read Only:
trueMaximum Length:240The name of the avatar image for a person. -
LastUpdateDate: string
(date-time)
Read Only:
trueThe date when the record was last updated. -
LastUpdatedBy: string
Read Only:
trueMaximum Length:64The user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PersonEmail: string
Title:
EmailMaximum Length:240The email of the person who's assigned to the program as a stakeholder. -
PersonId: integer
(int64)
Title:
Person IDThe unique identifier of the person who's assigned to the program as a stakeholder. -
PersonName: string
Title:
NameMaximum Length:240The name of the person who's assigned to the program as a stakeholder. -
StakeholderAssociationId: integer
(int64)
Title:
Stakeholder Assignment IDThe unique identifier of the stakeholder assignment to a program.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ProgramAvatars
-
Operation: /fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}/child/ProgramAvatarsParameters:
- projectProgramsUniqID:
$request.path.projectProgramsUniqID
The Program Avatars resource is used to manage the avatar image for a program. A program can have only one avatar at a time. - projectProgramsUniqID:
- ProgramDFF
-
Operation: /fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}/child/ProgramDFFParameters:
- projectProgramsUniqID:
$request.path.projectProgramsUniqID
- projectProgramsUniqID:
- ProgramNotes
-
Operation: /fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}/child/ProgramNotesParameters:
- projectProgramsUniqID:
$request.path.projectProgramsUniqID
The Program Notes resource is used to manage notes for programs. - projectProgramsUniqID:
- ProgramProjects
-
Operation: /fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}/child/ProgramProjectsParameters:
- projectProgramsUniqID:
$request.path.projectProgramsUniqID
The Project Assignments resource is used to manage the assignments of projects to a program. - projectProgramsUniqID:
- ProgramStakeholders
-
Operation: /fscmRestApi/resources/11.13.18.05/projectPrograms/{projectProgramsUniqID}/child/ProgramStakeholdersParameters:
- projectProgramsUniqID:
$request.path.projectProgramsUniqID
The Stakeholders resource is used to manage the assignment of stakeholders and program administrators for a program. - projectProgramsUniqID:
Examples
The following example shows how to get a program by submitting a GET request on the REST resource using cURL.
curl --user ppm_cloud_user -X GET -d @example_request_payload.json "https://your_organization.com:port/fscmRestApi/resources/11.13.18.05/projectPrograms/<projectProgramId>"
Response Body Example
The following shows an example of the response body in JSON format.
{
"AssessmentCode" : "ORA_PJS_ON_TRACK",
"AssessmentMeaning" : "On Track",
"CreatedBy" : "Monica.Suchet",
"CreationDate" : "2022-03-01T21:09:06.001+00:00",
"FinishDate" : "2022-06-30",
"LastUpdateDate" : "2022-03-01T20:36:30+00:00",
"LastUpdatedBy" : "Monica.Suchet",
"LineOfBusinessCode" : "CONSULTING",
"LineOfBusinessMeaning" : "Services",
"ParentProgramId" : 300100549427237,
"ParentProgramNumber" : "NA202201",
"PriorityCode" : "ORA_PJS_HIGH",
"PriorityMeaning" : "High",
"ProgramDescription" : "Applications for North America",
"ProjectProgramId" : 300100549427567,
"ProgramName" : "Hilman & Associates - Applications",
"ProgramNumber" : "NA202201-1",
"ProgramObjective" : "Coordinate and track strategic programs to achieve high customer satisfaction and expand market share.",
"ProgramStatusName" : "Active",
"ProgramSystemStatusCode" : "ORA_PROGRAM_ACTIVE",
"PublicFlag" : false,
"RegionCode" : "PROGRAM_NORTH_AMERICA",
"RegionMeaning" : "North America",
"StartDate" : "2022-01-01",
"StrategyCode" : "SERVICE_EXCELLENCE",
"StrategyMeaning" : "Service excellence",
"TreeStructureId" : 300100549427237,
"OwningOrganizationName" : "Vision Operations",
"OwningOrganizationId" : 204,
"ProgramBudget" : 11174772,
"ProgramBudgetCurrency" : "USD",
"links" : [ {
"rel" : "self",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567",
"name" : "projectPrograms",
"kind" : "item",
"properties" : {
"changeIndicator" : "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000478"
}
}, {
"rel" : "canonical",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567",
"name" : "projectPrograms",
"kind" : "item"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567/child/ProgramAvatars",
"name" : "ProgramAvatars",
"kind" : "collection"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567/child/ProgramNotes",
"name" : "ProgramNotes",
"kind" : "collection"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567/child/ProgramProjects",
"name" : "ProgramProjects",
"kind" : "collection"
}, {
"rel" : "child",
"href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/projectPrograms/300100549427567/child/ProgramStakeholders",
"name" : "ProgramStakeholders",
"kind": "collection"
}
]
}