{"id":752,"date":"2008-02-29T03:45:53","date_gmt":"2008-02-29T09:45:53","guid":{"rendered":"http:\/\/www.mrc-productivity.com\/docs\/?page_id=752"},"modified":"2026-08-13T11:59:13","modified_gmt":"2026-08-13T16:59:13","slug":"page-breaks-in-a-report","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/page-breaks-in-a-report","title":{"rendered":"Page Breaks in a Report"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Overview<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">m-Power\u2019s Page Break feature allows developers to separate data whenever a dimension key changes. This option is configured under the \u201cDimensions\u201d screen within the \u201cData Model\u201d.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on the output type selected at run time, this feature behaves in two ways:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Print and PDF Outputs:<\/strong> When using PDF or Print Optimized HTML, a new printed page is issued every time the specified dimension key changes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Excel Outputs:<\/strong> When using Normal Excel (13) or Formatted Excel (16), the data is automatically separated into individual, organized worksheet tabs for each dimension group.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Example<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Let\u2019s assume we want to create a report of all our salespeople, sorting on the Salesman Number. However, we would like all of our salespeople to be grouped by state, with each state either printed on a different page or placed on its own separate Excel tab.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Navigate to the <strong>Dimensions<\/strong> screen within your Data Model.<\/li>\n\n\n\n<li>Select <strong>\u2018Yes\u2019<\/strong> on the <strong>\u201cPage Break?\u201d<\/strong> dropdown for the field on which you wish to page break (in this case, the State field).<\/li>\n<\/ol>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a883c46cdc2a&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6a883c46cdc2a\" class=\"wp-block-image size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"\/docs\/images\/ai\/PageBreakDimensions.png\" alt=\"\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\"><strong>Note:<\/strong> Page break dimension keys should be placed <em>first<\/em> in your sequence, as the new page\/tab is issued every time this key field is changed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Run Time<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Depending on your chosen output format, the Page Break feature will structure your data accordingly:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Print &amp; PDF Outputs<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When viewing the report in the browser, you will notice the groupings\u2014for example, Cassandra Townsend and Michael Gross of Colorado will be separated from all of the Illinois salespeople.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">While m-Power places all of the data adjacent to each other on the screen without any spaces, this is not an accurate representation of the data as it will appear when it is printed on a page. When you select \u201cPrint,\u201d your browser will know to send each subsection to the printer as its own distinct page.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" src=\"\/docs\/images\/ai\/PageBreakRuntime.png\" alt=\"\"\/><\/figure>\n\n\n\n<h3 id=\"excel-page-break\" class=\"wp-block-heading\">Excel Outputs<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">When exporting your report to Excel, the page break logic is applied directly to the workbook structure. Instead of downloading a single, continuous spreadsheet, m-Power dynamically generates a new wor<sup><\/sup>ksheet tab for every dimension key change.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Following our example, your downloaded Excel file will automatically feature one tab dedicated to the Colorado salespeople, a second tab for the Illinois salespeople, and so on.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Notice how Cassandra Townsend and Michael Gross of Colorado are on a separate page from all of the Illinois salespeople.<\/p>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a883c46cec0d&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6a883c46cec0d\" class=\"wp-block-image size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"\/docs\/images\/ai\/PageBreakExcel1.png\" alt=\"\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;6a883c46ceddb&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"6a883c46ceddb\" class=\"wp-block-image size-large wp-lightbox-container\"><img decoding=\"async\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on--pointerdown=\"actions.preloadImage\" data-wp-on--pointerenter=\"actions.preloadImageWithDelay\" data-wp-on--pointerleave=\"actions.cancelPreload\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"\/docs\/images\/ai\/PageBreakExcel2.png\" alt=\"\"\/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\tdata-wp-bind--aria-label=\"state.thisImage.triggerButtonAriaLabel\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.thisImage.buttonRight\"\n\t\t\tdata-wp-style--top=\"state.thisImage.buttonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview m-Power\u2019s Page Break feature allows developers to separate data whenever a dimension key changes. This option is configured under the \u201cDimensions\u201d screen within the \u201cData Model\u201d. Depending on the output type selected at run time, this feature behaves in two ways: Print and PDF Outputs: When using PDF or&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[250],"ht-kb-tag":[],"class_list":["post-752","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-report"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/752","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=752"}],"version-history":[{"count":13,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/752\/revisions"}],"predecessor-version":[{"id":15230,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/752\/revisions\/15230"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=752"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=752"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=752"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}