Modify the Summary Section of an Existing Page

The AlterPageSummarySection element allows you to modify an existing page's summary section without directly editing the spec for that page. When you include the AlterExistingPages element on a spec, you can then include the child AlterPageSummarySection element to edit data form sections, data list sections, report sections, custom component sections, or dashboard sections that appear in the target page's summary section.

For example, you can use the AlterPageSummarySection element and its child elements to replace the data form in a summary section. After you identify the page with its GUID in the AlterPage element's PageID attribute, you can insert the AlterPageSummarySection element. Then you can identify the summary section and its data form by their GUIDs in the AlterDataFormSection element's DataFormID and SectionID attributes. And finally, you can specify the replacement data form by its GUID in the NewDataFormID attribute of the ReplaceDataForm element.

<AlterExistingPages>
 <AlterPages>
  <AlterPage PageID="edafd74a-b523-4842-8fd7-6a925d232b58">
   <AlterPageSummarySection>
    <AlterDataFormSection DataFormID="ee80b578-2602-43fc-99e3-97ab2dd11153" SectionID="2dc350f8-a91d-4b24-ac10-eb3451ea4a43">
     <ReplaceDataForm NewDataFormID="f415cbed-1499-4617-9889-295e010fb5ed"/>
    </AlterDataFormSection>
   </AlterPageSummarySection>
  </AlterPage>
 </AlterPages>
</AlterExistingPages>

With these lines in your new spec, you can replace the data form in an existing page's summary section without touching the spec for the page.

As another example, you may want to change the context for the summary section instead of replacing the data form. To do this, you can add the AlterSectionContext element instead of the ReplaceDataForm element. Within the AlterSectionContext element, you can then add the SectionContext element and then the PageContextID element that defines the section context as the page context ID.

<AlterExistingPages>
 <AlterPages>
  <AlterPage PageID="edafd74a-b523-4842-8fd7-6a925d232b58">
   <AlterPageSummarySection>
    <AlterDataFormSection DataFormID="ee80b578-2602-43fc-99e3-97ab2dd11153" SectionID="2dc350f8-a91d-4b24-ac10-eb3451ea4a43">
     <AlterSectionContext>
      <SectionContext>
       <common:PageContextID/>
      </SectionContext>
     </AlterSectionContext>
    </AlterDataFormSection>
   </AlterPageSummarySection>
  </AlterPage>
 </AlterPages>
</AlterExistingPages>

In this example, if you don't want to use the page context ID, you can use the Expression or PageExpressionField elements instead to define the section context as an expression or as a page expression field.