Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Mybanner

This version of the app's documentation is outdated. Please find the information you're looking for here:

panel


The Table Excerpt and Table Excerpt Include macros

were designed to

combine different kinds of table excerption and multi-excerption in one tool:

  • excerption within one page
  • multi-excerption within multiple pages and spaces searched by:
    • page names
    • page trees
    • labels

The macros improve the performance

and response

of pages storing large tables

. You can work with the original table without creating multiple copies of it for filtering and building several pivot tables or charts on its basis. You can use the macros both within one page and within several pages of your Confluence instance.

and let you use the original tables for any purpose, including filtering, building multiple charts and pivot tables.

The macros are available

in 

in Confluence Server

only. 

The main objectives of using the macros are: 

  • providing dynamic changing of multiple pivot tables and charts when the source tables changing;
  • avoiding loss of productivity when working with large tables (compared to multiple copies of the table within one page);
  • comfort to operate in the edit mode, when there is only one large table with the small macros instead of multiple large tables.

    and Data Center. Image Added

    Widget Connector
    width432
    urlhttp://youtube.com/watch?v=r-nLyUOUaLA
    height243
     

    And actually, why

    Why should I use these macros?




    When you build multiple pivot tables and charts from table ➜ 

    Multiple copies of a large source table within one page cause reducing of processing speed  ➜ 

    Inserting references to a source table with the Table Excerpt/Table Excerpt Include macros leads to continued productivity.



    Table of Contents
    maxLevel1
    indent20px



    Using the Table Excerpt Macro

    Adding the Table Excerpt macro to a page:

    1. In the Confluence editor, choose Insert > Other Macros.
    2. Find and select the required macro.
    3. Enter the unique identifier for the macro.
    4. Click Insert.
    Tip

    You will be able to reference the marked table by inserting the Table Excerpt Include macro (on the same page only) and entering the specified unique name.


    Tip

    Speeding up macro entry with autocomplete: type  type { and the beginning of the macro name 'Table Excerpt", to see a list of suggested macros. Select the Table Excerpt macro from the prompted results.

    Adding a Table into the Table Excerpt Macro:

    1. Copy (cut) a table.
    2. Paste the table into the Table Excerpt macro placeholder.


    Handy Carousel
    delay1000
    items0

    Image RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage Added Image Added Image Added Image Added Image Added



    Using the Table Excerpt Include Macro

    Adding the Table Excerpt Include

    macro

    Macro to a

    page and specify the settings

    Page and  Specifying the Settings:

    1. In the Confluence editor, choose Insert > Other Macros.
    2. Find and select the required macro.
    3. Specify the settings:
      • Enter the
      excerpt Set the Search for excerpt on option to
      • Select the Excerpt source to define the pages containing the Table Excerpt macro:

        - Current page
        -

      Another
      • Specific page (specify the page title)
        - Page and

      childpages 
      • childpages (specify the page title)
        - Page and all

      decsendants 
      • descendants (specify the page title)
        - Pages with

      labels 
      • labels (specify the page labels and the space title)

      Select the
      • If you select the Current page option, select the  Show copy of source table
      checkbox
      •  checkbox in case you want to show a copy of a source table in the page view mode.
    4. Click Insert.
    Tip

    Speeding up macro entry with autocomplete: type { and the beginning of the macro name 'Table Excerpt Include', to see a list of suggested macros. Select the Table Excerpt Include macro from the prompted results.


    Tip

    You can use the Table Excerpt Include macro withing one page without showing the source table within in combination with the Pivot Table macro and the Chart from Table macro macros because a pivot table and a chart can be built without displaying a source table.

    On the other hand, if you want to use the Table Excerpt Include macro within one page in combination with the Table Filter macro you

    should

    need to select the "Show copy of source table" checkbox because this macro requires a table for its correct work.






    Handy Carousel
    delay1000
    items0

    Image RemovedImage RemovedImage Added Image Added

    Image RemovedImage Added



    Using the Same Table for Generating Multiple Charts

    1. Insert the Table Excerpt macro and place the source table into the macro body according to the instructions above.
    2. Insert the Table Excerpt Include macro according to the instructions above and place it into the Table Filter, Pivot Table or Chart from Table macros or their combination.
    3. Adjust the parameters of the filtering, pivot tables and charts.
    4. Save the page.

    As the result, you will receive multiple charts generated on the basis of the same data table from multiple pages.

    View mode:

    Edit mode: