Creating an Ad Hoc Page

1. In the DiveTab script containing the report page you want to use, copy and paste a report page code block.

   NOTE: You can paste the code block into the same, or a different, data-area .

   Here is an example of a report page code block.

     report-page { 
       title "Report Page Example" 
       cplan "/cplans/basic_101.cplan" 
       
       dimension "Vendor" 
       dimension "Premise" 
       dimension "Corporate Brand" 
       
       text column = "Cost" { 
         value-format "$#,###.00" 
       } 
     } 

2. In the copied block, change the report-page tag to ad-hoc-page.

3. Change the page title or the button icon or both so you can identify each more easily in the client.

   Here is an example of the code altered for an ad hoc page.

         ad-hoc-page { 
           title "Ad Hoc Page Example 1" 
           cplan "/cplans/basic_101.cplan" 
           
           dimension "Vendor" 
           dimension "Premise" 
           dimension "Corporate Brand" 
           
           text column = "Cost" { 
             value-format "$#,###.00" 
           } 
         } 

4. Click File > Save or press Ctrl+S to save the file.
5. In the DiveTab client, click Sync.

6. Compare and contrast the content and behavior of the report page versus the ad hoc page.

   Here is the result of the report page code in DiveTab.

   

   Here is the result of the ad hoc page code in DiveTab.

   

   Notice the different context menus that allow you to switch the dimension in the first column, or remove the MultiColumn and replace it with a dive dimension. For example, click on Corporate Brand > Remove MultiColumn.

   Here is an example of the resulting altered ad hoc page.

   

You can also add additional dimensions, such as available-dimensions, dimcount-dimensions, and quickview-dimensions, and include summary columns in an available-columns block. For example, if you wanted to have the dimension Corporate Brand appear initially as a dive dimension, you change it to a dimcount-dimension.

NOTE: If a dimension is defined as both a dimension and a dimcount-dimension, the DimCount definition is ignored.

Here is an ad hoc page with more dimension types.

  ad-hoc-page { 
    title "Ad Hoc Page Example 2" 
    cplan "/cplans/basic_101.cplan" 
    
    dimension "Vendor" 
    dimension "Premise" 
    
    dimcount-dimension "Corporate Brand" 
    
    quickview-dimension "Customer" 
    quickview-dimension "Resp Team" 
    
    available-dimension "Posting Period" 
    available-dimension "Product Name" 
    
    text column = "Cost" { 
      value-format "$#,###.00" 
    } 
  } 

Here is the result of the code in DiveTab.

1. In your DiveTab project in Workbench, open the main.divetab.

2. Click the green plus sign, and select New Area > Data Area.

   

3. Under Button Properties on the right, enter a Title and an Icon.

   

4. Note the Area ID value, and then click Click here to edit Area.

   

   The script opens.

5. Locate the Area ID block in the script.

   NOTE: You may need to reposition the title and icon tags above the sections tag.

6. Enter the information needed to define the ad-hoc-page in the sections block.

   An ad hoc page requires a cplan, title, and dimension tags.

   Here is an example of an ad hoc page.

     ad-hoc-page { 
       title "Ad Hoc Page Example 3" 
       cplan "/cplans/basic_101.cplan" 
       
       dimension "Corporate Supplier" 
       dimension "Corporate Product Group" 
       
       dimcount-dimension "Corporate Item" 
       
       quickview-dimension "Customer" 
       quickview-dimension "Corporate Chain" 
       
       available-dimension "Corporate Brand" 
       available-dimension "Product Name" 
       
       text column = "Cost" { 
         value-format "$#,###.00" 
       } 
     } 

   NOTE: If a dimension is defined as both a dimension and a dimcount-dimension, the DimCount definition is ignored.

7. Save and Sync frequently and check the page from the DiveTab client.

Here is the result of the code in DiveTab.

Each additional dimension becomes a MultiColumn and has an option for switching with the primary dimension.