Incremental fetch divides large documents or layouts into pages, thereby loading the data in batches (or blocks) rather than all at the same time. This improves the usability and performance of a large document or layout, by reducing the load and overall memory usage on the web server.
You can define the incremental fetch options in both MicroStrategy Web and in Desktop, but incremental fetch is applied only when the document is executed in Editable Mode, Interactive Mode, or Express Mode in MicroStrategy Web. Desktop does not apply incremental fetch to documents.
The blocks of data are defined by the number of objects (the block size) to return at a certain level. If the document or layout is grouped, you can select any group as the level. If it is not, then the block size is applied to the Detail section.
For example, each row in the Details section of a document contains the Item attribute and several metrics. Incremental fetch is applied, with a block size of ten. In MicroStrategy Web, only ten rows of items are displayed on a single page. You can navigate to another page to display more information.
If the same document is grouped by Call Center, incremental fetch can be applied at the level of Call Center, with a block size of five. In MicroStrategy Web, data for five Call Centers are displayed on a single page.
For more detailed examples, see the MicroStrategy Report Services Document Creation Guide.
Note: Groups that are displayed as only a single element cannot be used as the level, since "All" needs to be the selected grouping option. If the document or layout is not grouped or all the groups are displayed as single elements only, the only option is the Detail section.
You can also apply incremental fetch to Grid/Graphs on a document. For details, see Incremental Fetch on Grid/Graphs.
Open a document in the Document Editor.
If the document contains multiple layouts, select the layout to apply incremental fetch to.
From the Format menu, choose Document Properties. The Document Properties dialog box opens.
Select Incremental Fetch.
Select the Enable Incremental Fetch check box.
From the Fetch Level drop-down list, select the object to be counted for the incremental fetch level.
If the document or layout is grouped, the groups are displayed in the drop-down list. Groups that are displayed as single element only are not shown on this list.
If the document or layout is not grouped or all the groups are displayed as single elements only, the only option is the Detail section.
Enter the Block Size, which is the number of objects (of the Fetch Level) that are returned in each block.
Click OK to return to the document.
To see the results of the incremental fetch, open the document in MicroStrategy Web in Editable Mode, Interactive Mode, or Express Mode.
Related topics