Using Custom Subsections

Custom subsections provide the following features:

• adding arbitrary subsections using an xmlfragment definition.

• positioning relative to subsections defined by facets or other custom facets.

• using a localized subsection title.

To define a subsection on UI level - you do this if you want to add a custom look and feel, or to use controls that are not supported by default - you can extend the settings of the corresponding object page in the manifest.json file with a content block. You can enrich the body of the object page with additional subsections. To do so, you define header facets by using a custom key that you later reference by providing the following properties:

• a title

• the name (which must point to the corresponding fragment and the outer section, which can be just the name of an existing section or a custom section)

• the corresponding fragment

{
	"sap.ui5": {
		"routing": {
			"targets": {
				"SalesOrderManageObjectPage": {
					"options": {
						"settings": {
							"content": {
								"body": {
									"sections": {
										"myObjectPageSection": {
											"subSections": {
												"customSubSection": {
													"type": "XMLFragment",
													"name": "SalesOrder.ext.CustomSubSection",
													"title": "{i18n>customSubSection}",
													"position": {
														"placement": "After",
														"anchor": "someSubSection"
													}
												}
											}
										}
									}
								}
							}
						}
					}
				}
			}
		}
	}
}

The result looks as shown in the following screenshot. The highlighted subsection has been added using the extension point.

For more information, see Extension Points for Sections on the Object Page.

Live Example: Custom Subsection

You can explore and work with the coding yourself. For more information and live examples, see the SAP Fiori development portal at Standard Floorplans - Extensions - Extensions for Object Pages - Custom Subsection.