7.5.3 Capturing column view

Since column view is just an overlay over a buffer, it cannot be exported or printed directly. If you want to capture a column view, use this columnview dynamic block (see Dynamic blocks). The frame of this block looks like this:

     * The column view
     #+BEGIN: columnview :hlines 1 :id "label"
     
     #+END:

This dynamic block has the following parameters:

:id

This is most important parameter. Column view is a feature that is often localized to a certain (sub)tree, and the capture block might be in a different location in the file. To identify the tree whose view to capture, you can use 3 values:

          local     use the tree in which the capture block is located
          global    make a global view, including all headings in the file
          "file:path-to-file"
                    run column view at the top of this file
          "ID"      call column view in the tree that has an :ID:
                    property with the value label.  You can use
                    M-x org-id-copy to create a globally unique ID for
                    the current entry and copy it to the kill-ring.

:hlines

When t, insert a hline after every line. When a number N, insert a hline before each headline with level <= N.

:vlines

When set to t, enforce column groups to get vertical lines.

:maxlevel

When set to a number, don't capture entries below this level.

:skip-empty-rows

When set to t, skip row where the only non-empty specifier of the column view is ITEM.

The following commands insert or update the dynamic block:

C-c C-x i

Insert a dynamic block capturing a column view. You will be prompted for the scope or id of the view.

C-c C-c

C-c C-x C-u

Update dynamical block at point. The cursor needs to be in the #+BEGIN line of the dynamic block.

C-u C-c C-x C-u

Update all dynamic blocks (see Dynamic blocks). This is useful if you have several clock table blocks in a buffer.

You can add formulas to the column view table and you may add plotting instructions in front of the table - these will survive an update of the block. If there is a #+TBLFM: after the table, the table will actually be recalculated automatically after an update.