Report Pages in CDL

You can add, manage, copy and remove pages and subpages in your report using CDL.

In Studio, report pages and subpages are organized in the Page Tabs Bar in the report editor for ease of design and navigation.

These tabs can be accessed in the design area by designers to switch between pages and subpages during report design, and by end users for quick navigation when viewing the report. You can add widgets to pages and subpages. From these widgets, you can navigate to other pages or subpages.

1: Adding a Page

Your first page has already been added to your report. Select the three vertical dots icon, and select Edit CDL from the dropdown menu to open the CDL panel in the sidebar at the page code.

If you have not added any widgets, the page code block will display as follows:

page #Page1 {
  label: 'Page 1'
  }

To add another page, add a new line below the existing page code, then add the above code block again. Change the ID name (#Page1) to be unique as you cannot have duplicate ID names in CDL. Change the label ('Page1') as desired so your end users can differentiate between the two pages in the report.

page #Page1 {
  label: 'Page 1'
  }
page #Page2 {
  label: 'Page 2'
  }

You now have two pages.

2: Adding a Subpage

To add a subpage, add the following code within the page code block.

page #Page1_pagea {
  label: 'Page 1a'
  }

Change the subpage name (#Page1_page) to be unique. ID names cannot be duplicated in CDL. Change the label ('Page1c') as desired for your end users.

The page code block with a subpage will display as follows:

page #Page1 {
	label: 'Page 1'
	page #Page1_pagea {
		label: 'Page 1c'
	}
	}

3: Rearranging, Duplicating and Deleting Pages

To rearrange a page or subpage, cut and paste the page (or subpage) code block above or below the page (or subpage) code block where you want it to appear.

To duplicate a page or subpage, copy and paste the page (or subpage) code block above or below the page (or subpage) code block where you want it to appear.

To delete a page or subpage, highlight and delete the page (or subpage) code block you want to remove.

To comment out a page or subpage, highlight the page (or subpage) code block you want to comment out and press CTRL + / .

4: Page Elements

To view all page elements, while in the page code block, press CTRL + SPACE. A list of elements available for use will display. Some of the common page elements are described here.

Element	Description	Values
hide	Page type is Hidden Page.	true / false
ignoreFilters	The specified filter does not display on this page. If there's a subpage without this ignoreFilters, the filter will still appear on the primary page.	the name of a filter
ignoreFiscalCalendar	If the report has a fiscal calendar specified, true means the Gregorian calendar is used instead.	true / false
ignoreWeights	Ignores any weighted values.	true / false
label	The name of the page displayed to the end user.	alphanumeric
modal	Page type is Modal Overlay.	true / false
modalSize	Size of the modal. Must be used with modal: true.	huge, large, medium, small
showPrintButton	Shows print button in vertical three dot dropdown menu.	true / false
useWeights	Specify the weight model to use on the page. See Weighting Data in Studio Reports to learn more.	the name of a weight model

Additionally, there are many code blocks you can include within a page code block, including config layout, subpages (a page block within a page block), and widgets. To learn more about adding widgets, see Configuring Widgets using CDL.

5: Learn More

To learn more about pages in the user interface, see the following articles:

• About Pages

• Adding, Duplicating and Deleting Pages

• Copying and Pasting Pages

• Customizing Page Settings in Reports

To add breadcrumb navigation to more easily move between subpages and primary pages, see Customizing the Header Bar in CDL.