Create a home page setup definition
post
/fscmRestApi/resources/11.13.18.05/hedHomePageSetups
Request
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.
-
Upsert-Mode:
Contains one of the following values: true or false. If true, the server performs an Upsert operation instead of a Create operation. During an Upsert operation, the server attempts to find an existing resource that matches the payload. If a match is found, the server updates the existing resource instead of creating a new one. If not found or false (default), the server performs a Create operation. Note that the Upsert operation isn't supported for date-effective REST resources.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
PageCode(required): string
Title:
Page CodeMaximum Length:50Alternate identifier for the home page setup. -
PageDescription: string
Title:
Page DescriptionMaximum Length:240A description is assigned to each version of a home page setup. -
roles: array
Roles
Title:
RolesThe roles resource is used to define the security roles that have access to a home page. -
StatusCode(required): string
Title:
Status CodeMaximum Length:30Code defining the status of a home page version. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS. -
VersionName(required): string
Title:
Version NameMaximum Length:50A name is assigned to each version of a home page setup. -
zones: array
Zones
Title:
ZonesThe zones resource is used to define where a widget is displayed on the home page.
Nested Schema : Roles
Type:
arrayTitle:
RolesThe roles resource is used to define the security roles that have access to a home page.
Show Source
Nested Schema : Zones
Type:
arrayTitle:
ZonesThe zones resource is used to define where a widget is displayed on the home page.
Show Source
Nested Schema : schema
Type:
Show Source
object-
RoleCode: string
Title:
Role CodeMaximum Length:128The alternate identifier for the security role.
Nested Schema : hedHomePageSetups-zones-item-post-request
Type:
Show Source
object-
PageZoneCode(required): string
Title:
Page Zone CodeMaximum Length:30Alternate identifier for the page zone. -
widgets: array
Widgets
Title:
WidgetsThe widgets resource is used to define which widgets appear on a home page. -
ZoneDescription: string
Title:
Zone DescriptionMaximum Length:240The description of the page zone. -
ZoneSequence(required): integer
(int32)
Title:
Zone SequenceThe sequence in which page zones are displayed in a home page. -
ZoneTypeCode(required): string
Title:
Zone Type CodeMaximum Length:30Indicates the zone type. A list of accepted values for a zone is defined in the lookup type: ORA_HEY_HOME_PAGE_ZONE
Nested Schema : Widgets
Type:
arrayTitle:
WidgetsThe widgets resource is used to define which widgets appear on a home page.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-item-post-request
Type:
Show Source
object-
CollapsibleFlag: boolean
Title:
CollapsibleMaximum Length:1Indicates whether a widget can be collapsed on the home page. The default value is true. -
PageWidgetCode(required): string
Title:
Page Widget CodeMaximum Length:30Alternate identifier for the widget within the page zone. -
PageZoneId(required): integer
(int64)
Title:
Page Zone IDThe unique identifier for the page zone in which the page widget is placed. -
WidgetId(required): integer
(int64)
Title:
Widget IDThe unique identifier for a home page widget. -
widgetProperties: array
Widget Properties
Title:
Widget PropertiesThe widget properties resource is used to define how a widget functions on a home page. -
WidgetSequence(required): integer
(int32)
Title:
Widget SequenceThe sequence widgets are displayed within a zone. -
WidgetTitle(required): string
Title:
Widget TitleMaximum Length:30The display name of the widget.
Nested Schema : Widget Properties
Type:
arrayTitle:
Widget PropertiesThe widget properties resource is used to define how a widget functions on a home page.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-widgetProperties-item-post-request
Type:
Show Source
object-
PageWidgetPropertyCode(required): string
Title:
Page Widget Property CodeMaximum Length:30Alternate identifier for the widget property within the page zone. -
propertyValidations: array
Property Validations
Title:
Property ValidationsThe property validations resource is used to define how to validate a widget property. -
PropertyValue: string
Title:
Property ValueMaximum Length:512The value given for a widget property. -
WidgetPropertyId(required): integer
(int64)
Title:
Widget Property IDThe unique identifier of a widget property.
Nested Schema : Property Validations
Type:
arrayTitle:
Property ValidationsThe property validations resource is used to define how to validate a widget property.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-widgetProperties-propertyValidations-item-post-request
Type:
Show Source
objectResponse
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 : hedHomePageSetups-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the row. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date the row was created. -
HomePageSetupId: integer
(int64)
Title:
Home Page Setup IDRead Only:trueUnique identifier for a home page setup. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date the row was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the row. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PageCode: string
Title:
Page CodeMaximum Length:50Alternate identifier for the home page setup. -
PageDescription: string
Title:
Page DescriptionMaximum Length:240A description is assigned to each version of a home page setup. -
roles: array
Roles
Title:
RolesThe roles resource is used to define the security roles that have access to a home page. -
StatusCode: string
Title:
Status CodeMaximum Length:30Code defining the status of a home page version. A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS. -
StatusMeaning: string
Title:
StatusRead Only:trueMaximum Length:80A list of accepted values is defined in the lookup type ORA_HEY_VERSION_STATUS. -
ValidSetupFlag: boolean
Title:
Valid SetupRead Only:trueMaximum Length:1Indicates whether the setup is currently valid and able to be published. The default value is false. -
VersionName: string
Title:
Version NameMaximum Length:50A name is assigned to each version of a home page setup. -
VersionNumber: integer
(int32)
Title:
Version NumberRead Only:trueA number is assigned to each version of a home page setup. -
zones: array
Zones
Title:
ZonesThe zones resource is used to define where a widget is displayed on the home page.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Roles
Type:
arrayTitle:
RolesThe roles resource is used to define the security roles that have access to a home page.
Show Source
Nested Schema : Zones
Type:
arrayTitle:
ZonesThe zones resource is used to define where a widget is displayed on the home page.
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 : hedHomePageSetups-roles-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
RoleCode: string
Title:
Role CodeMaximum Length:128The alternate identifier for the security role. -
RoleMapId: integer
(int64)
Title:
Role Map IDRead Only:trueThe unique identifier of the role to home page mapping. -
RoleName: string
Title:
Role NameRead Only:trueMaximum Length:240The name of the security role.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : hedHomePageSetups-zones-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PageZoneCode: string
Title:
Page Zone CodeMaximum Length:30Alternate identifier for the page zone. -
PageZoneId: integer
(int64)
Title:
Page Zone IDRead Only:trueThe unique identifier of the page zone. -
widgets: array
Widgets
Title:
WidgetsThe widgets resource is used to define which widgets appear on a home page. -
ZoneDescription: string
Title:
Zone DescriptionMaximum Length:240The description of the page zone. -
ZoneSequence: integer
(int32)
Title:
Zone SequenceThe sequence in which page zones are displayed in a home page. -
ZoneTypeCode: string
Title:
Zone Type CodeMaximum Length:30Indicates the zone type. A list of accepted values for a zone is defined in the lookup type: ORA_HEY_HOME_PAGE_ZONE -
ZoneTypeMeaning: string
Title:
Zone TypeRead Only:trueMaximum Length:80The name of the Page Zone Code.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Widgets
Type:
arrayTitle:
WidgetsThe widgets resource is used to define which widgets appear on a home page.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-item-response
Type:
Show Source
object-
CollapsibleFlag: boolean
Title:
CollapsibleMaximum Length:1Indicates whether a widget can be collapsed on the home page. The default value is true. -
ComponentName: string
Title:
Component NameRead Only:trueMaximum Length:100The component name for the widget. -
DefaultZoneTypeCode: string
Title:
Default Zone Type CodeRead Only:trueMaximum Length:30Indicates the zone in which a widget will display by default. A list of accepted values for a zone is defined in the lookup type: ORA_HEY_HOME_PAGE_ZONE. -
DefaultZoneTypeMeaning: string
Title:
Default Zone TypeRead Only:trueMaximum Length:80The meaning of a default zone code. An example of a meaning is the locked zone. A list of accepted values is defined in lookup type ORA_HEY_HOME_PAGE_ZONE. -
EnabledFlag: boolean
Title:
EnabledRead Only:trueMaximum Length:1Indicates whether a widget is active and can be displayed. The default value is true. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PageWidgetCode: string
Title:
Page Widget CodeMaximum Length:30Alternate identifier for the widget within the page zone. -
PageWidgetId: integer
(int64)
Title:
Page Widget IDRead Only:trueThe unique identifier of the widget within the page zone. -
PageZoneId: integer
(int64)
Title:
Page Zone IDThe unique identifier for the page zone in which the page widget is placed. -
PermissionCode: string
Title:
Permission CodeRead Only:trueMaximum Length:132The page permission code used to grant access to a widget. -
WidgetCode: string
Title:
Widget CodeRead Only:trueMaximum Length:30The alternate identifier for a widget. -
WidgetDescription: string
Title:
Widget DescriptionRead Only:trueMaximum Length:256The description of a widget. -
WidgetId: integer
(int64)
Title:
Widget IDThe unique identifier for a home page widget. -
WidgetName: string
Title:
Widget NameRead Only:trueMaximum Length:30The name of a widget. -
widgetProperties: array
Widget Properties
Title:
Widget PropertiesThe widget properties resource is used to define how a widget functions on a home page. -
WidgetSequence: integer
(int32)
Title:
Widget SequenceThe sequence widgets are displayed within a zone. -
WidgetTitle: string
Title:
Widget TitleMaximum Length:30The display name of the widget.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Widget Properties
Type:
arrayTitle:
Widget PropertiesThe widget properties resource is used to define how a widget functions on a home page.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-widgetProperties-item-response
Type:
Show Source
object-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PageWidgetPropertyCode: string
Title:
Page Widget Property CodeMaximum Length:30Alternate identifier for the widget property within the page zone. -
PageWidgetPropertyId: integer
(int64)
Title:
Page Widget Property IDRead Only:trueThe unique identifier of a widget property for a home page setup. -
PropertyDescription: string
Title:
Property DescriptionRead Only:trueMaximum Length:512The description of a widget property. -
PropertyKey: string
Title:
Property KeyRead Only:trueMaximum Length:30Unique key used to identify the widget property. -
PropertyName: string
Title:
Property NameRead Only:trueMaximum Length:240The display name of a widget property. -
PropertyTypeCode: string
Title:
Property Type CodeRead Only:trueMaximum Length:30Indicates the property type for a widget property. Examples of property types include: string, number, boolean. A list of accepted values for a property type is defined in the lookup type: ORA_HEY_HOME_PROPERTY. -
PropertyTypeMeaning: string
Title:
Property TypeRead Only:trueMaximum Length:80The meaning of a property type code. An example of a meaning is the string property type. A list of accepted values is defined in lookup type ORA_HEY_HOME_PROPERTY. -
propertyValidations: array
Property Validations
Title:
Property ValidationsThe property validations resource is used to define how to validate a widget property. -
PropertyValue: string
Title:
Property ValueMaximum Length:512The value given for a widget property. -
RequiredFlag: boolean
Title:
RequiredRead Only:trueMaximum Length:1Indicates whether a value is required and the field can't be left blank. The default value is false. -
WidgetPropertyId: integer
(int64)
Title:
Widget Property IDThe unique identifier of a widget property.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Property Validations
Type:
arrayTitle:
Property ValidationsThe property validations resource is used to define how to validate a widget property.
Show Source
Nested Schema : hedHomePageSetups-zones-widgets-widgetProperties-propertyValidations-item-response
Type:
Show Source
object-
ErrorMessage: string
Title:
Error MessageRead Only:trueDefault Value:adf.object.getErrorMessageBundle()The error message describes the validation error. -
ErrorMessageCode: string
Title:
Error Message CodeRead Only:trueMaximum Length:30The alternate identifier for the validation error message. -
FunctionBody: string
Title:
Function BodyRead Only:trueThe executable validation code. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ParameterOne: string
Title:
Parameter 1Read Only:trueMaximum Length:512The first optional value used during validation. -
ParameterTwo: string
Title:
Parameter 2Read Only:trueMaximum Length:512The second optional value used during validation. -
PropertyValidationId: integer
(int64)
Title:
Property Validation IDRead Only:trueThe unique identifier of a widget property validator. -
ValidatorCode: string
Title:
Validator CodeRead Only:trueMaximum Length:30The alternate identifier for the home page widget property validator.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- roles
-
Parameters:
- HomePageSetupId:
$request.path.HomePageSetupId
The roles resource is used to define the security roles that have access to a home page. - HomePageSetupId:
- statusCodesLOV
-
Parameters:
- finder:
ByLookupTypeFinder%3BLookupType%3DORA_HEY_VERSION_STATUS%2CLookupCode%3D{StatusCode}
The following properties are defined on the LOV link relation:- Source Attribute: StatusCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- zones
-
Parameters:
- HomePageSetupId:
$request.path.HomePageSetupId
The zones resource is used to define where a widget is displayed on the home page. - HomePageSetupId: