Toad Data Point 6.1 - User Guide

Export Data with One Click Export

Use One Click Export to quickly export data to an Excel report. You can also export data and include a linked query in the file. A linked query lets you create a "live" Excel report that can be refreshed dynamically. Because a linked query contains the underlying SQL for a report, each time you refresh the report the query executes and retrieves the latest data. The dynamic nature of linked query reports makes them ideal for distribution to users who need to see changes to data on demand without waiting for new static reports to be distributed.

Click here to view a video of this feature.

Notes:

• Before you can export to Excel, the Primary Interop Assemblies (PIAs) for your version of Excel must be installed. Typically, the PIAs are installed automatically when you install Microsoft Office.

• Use the Export wizard if you need to specify column delimiters and advanced field options when exporting data. See Export Data with the Export Wizard for more information.

To export data in one click

1. Select the range of data to export or click any row in a data grid to export all data.

2. Right-click the selected range or data grid and select Quick Export.

3. Select an export option. Review the following for additional information:

   Icon	Option	Description
   	Excel File	Export data to an Excel file. The file is automatically saved under a default name in the default export folder.
   	CSV File	Export data to a CSV file (comma separated value file). The file is automatically saved under a default name in the default export folder.
   	HTML File	Export data to an HTML file. The file is automatically saved under a default name in the default export folder.
   	Excel Instance	Export data to an Excel instance. Data is copied to a clipboard, Excel is launched, and a worksheet is populated with data. You can save the worksheet under a name and folder you specify or save it in the default export folder.
   	Excel Instance at active cell	Export data to an active cell in Excel. First open Excel and select a cell. Then select the Excel Instance at active cell option.
   	Excel Pivot Table	Export data to an Excel pivot grid report. See the Excel documentation for information on creating a Pivot Table report with external data.
   	Excel Pivot Table at active cell	Export data to an active cell for an Excel Pivot Table report. First open Excel and select a cell. Then select the Excel Pivot Table at active cell option.
   	Excel Linked Query	Export the underlying query for data to Excel.
   	Excel Linked Query at active cell	Export the underlying query for data to an active cell in Excel. First open Excel and select a cell. Then select the Excel Linked Query at active cell option.
   	Excel Linked Query with pivot table	Export the underlying query for data to an Excel Pivot Table report. See the Excel documentation for information on creating a pivot grid report with external data.
   	Excel Linked Query at active cell with pivot table	Export the underlying query for data to an active cell for an Excel Pivot Table report. First open Excel and select a cell. Then select the Excel Linked Query at active cell with pivot table option.
   	Excel Column Chart	Export data to an Excel chart instance. Data is copied to the clipboard, Excel is launched, and a chart is created with the data. You can then modify the chart's design and save the Excel file.
   Tip: To refresh data in a linked query report, click in Excel's External Data toolbar. This executes the underlying query for the report. See Share Excel Linked Queries for more information about creating and using linked queries.

Note: If the window containing data does not have the focus when you select a One Click Export option, the following message displays: "Export did not find any results sets to process."

Tips:

• To specify a default export folder, go to Tools | Options | Environment | Export.
• To always open a Save File dialog when exporting using One Click Export, go to Tools | Options | Environment | Export and select the option. This allows you to always customize the file name.

Related Topics

Import Data

Export Data with the Export Wizard

Share Excel Linked Queries

You can use linked queries to create "live" Excel reports that can be refreshed dynamically. Because a linked query contains the underlying SQL for a report, each time you refresh the report the query is executed and the latest data is retrieved. The dynamic nature of linked query reports makes them ideal for distribution to users who need to see changes to data without waiting for scheduled updates or for new reports to be distributed.  

Notes:  

• Any user who opens an Excel linked query must have access to a user name and password for the queried database to refresh the data. If a user does not have access to the database, they can only see the original data in the spreadsheet.

• If the Excel linked query was created from an ODBC connection that uses a Data Source Name (DSN), the DSN must also exist on the computer where the Excel file is opened to refresh the data.

To create an Excel linked query

1. Connect to the database.
2. Create a query in the Query Builder or Editor.
3. Execute the query to display data results.

4. Select the result set and click one of the following options from the toolbar:
   

   

5. Save the Excel spreadsheet.
6. Email or upload the spreadsheet to a shared network folder to share it with colleagues.

To refresh data in an Excel linked query

1. Open the spreadsheet with the linked query in Excel. The original data from the query displays.
2. In Excel, select Data | Refresh to update the original data with the current data.

3. If prompted, enter a user name and password to connect to the database and refresh the data.

   or

   If the following error displays: "[Microsoft][ODBC Driver Manager] Data source name not found and no default driver specified", you must specify the DSN used by the query on your computer. Complete the following steps to resolve this issue:

   (Excel 2003)

   1. Click OK.
   2. Select the Machine Data Source tab, and then click New.
   3. Use the wizard to select a User Data Source and create a DSN that points to the database.
   4. Click OK to return to Excel and open an ODBC Driver Connect window.
   5. Enter a user name and password to refresh the data.

Report

Tutorial: Create a Toad Data Report

Use the Data Report Designer to design reports visually. Stored in .tdr files, data reports are "live" reports that can be refreshed dynamically. What makes them dynamic is that they contain the underlying queries for report data sets. Each time a data report is opened, its query runs and the latest data is retrieved. The dynamic nature of data reports makes them ideal for distribution to users who need to see changes to data without waiting for scheduled updates or for new reports to be distributed.

The process of creating a data report has the following steps:

• Step 1: Run the Toad Data Report Wizard
• Step 2: Update Fields
• Step 3: Use Styles to Format the Report Appearance
• Step 4: Update Bands and Add Controls

Note: This procedure does not cover all of the possible steps of creating a data report. It only covers the steps required to create a report for the scenario. See About Designing Toad Data Reports for more information.

Step 1: Run the Toad Data Report Wizard

The Toad Data Report wizard creates an initial layout of the report based on options you select, including what columns to include, whether to group data, and the basic style.

To run the wizard

1. Right-click the data grid in the Results tab and select Send To | Data Report Designer. The Toad Report Designer displays.
2. Select Standard Report and click Next.
3. Click to include all columns in the report and click Next.

4. Select COUNTRY_NAME and click , and then click Next. This groups the data by the country name so that each country is listed as a heading and its sales per year display below it.

   Tip: You can create a secondary group by selecting another column and clicking again. A secondary group is not appropriate for this scenario, but it would be if the data included regions in each country or fiscal quarters. You would need to make the region or fiscal quarter a secondary group for the data to be organized appropriately.

5. Select the Sum and Avg checkboxes for the SUM(SALES.AMOUNT) row, and then click Next. These options calculate the sum and average sales amount for each country.

6. Select Outline 1 and click Next.

   Tip: The Outline and Align Left options are good choices if you grouped the data.

7. Select Casual and click Next.
8. Enter Countries with Sales Less Than $500,000 in the Report Title field, and then click Finish. The initial report layout displays in the Report window with the information grouped under bands. See Add Report Bands for more information for more information about bands.
9. Click Preview to see what the report looks like in print. Previewing the report makes it easier to see how the bands and their content display in the printable report.

Step 2: Update Fields

You can move, rename, and update the category of a field.

To update the fields

1. Complete the following steps to update the field category:
   1. Select the FISCAL_YEAR field in detailBand1.

   2. Click directly above the field.

      

   3. Click by the Format String field.
   4. Clear the Prefix field and click OK.
2. Double-click the following fields and enter their new name:

   Field	Band	Name
   FISCAL YEAR	groupHeaderBand2	Fiscal Year
   SUM(SALES.AMOUNT_SOLD)	groupHeaderBand2	Sales Amount
   Avg	groupFooterBand1	Average

3. Select the following fields one at a time and make them wide enough to see the full text: Sum (groupFooterBand1), Average (groupFooterBand1), and Grand Total (reportFooterBand1).
4. Select the following fields one at a time and drag them to the one inch mark on the ruler: Sum, Average, and Grand Total.

5. Right-click the COUNTRY NAME field (not the COUNTRY_NAME field on the right) in groupHeaderBand1 and select Delete.

   Note: The COUNTRY NAME field is a label that precedes the COUNTRY_NAME field value. If you preview the report before you delete the COUNTRY NAME field, the country displays as 'COUNTRY NAME Argentina'. It is clear that Argentina is the country name, so this field is redundant.

6. Select the COUNTRY_NAME field and drag it to align with the report title.
7. Select the COUNTRY_NAME field and make it three inches wide to accommodate long country names.

Step 3: Use Styles to Format the Report Appearance

The Data Report Designer uses styles to format different objects and kinds of data. Once you define a style, you can apply it to similar fields to create a consistent and easy-to-update design.

To create, update, and apply styles

1. Complete the following steps to update the report title style:
   1. Select the Styles field in the Properties pane.
   2. Click . The Styles Editor window displays.
   3. Select Title.

   4. Select the Foreground Color field, and then select MidnightBlue in the Web tab.

      Note: All colors in this scenario are from the Web tab.

   5. Select the Font field and click . The Font window displays.
   6. Select 22 in the Size field and click OK.
2. Complete the following steps in the Styles Editor window to create and define four new styles:
   1. Click four times in the Styles Editor window to create four new styles.

   2. Set the following properties for the new styles:

      First Style	Properties
      Name	OddRow
      Background Color	WhiteSmoke
      Border Color	MidnightBlue
      Borders	Bottom
      Font	Tahoma, 10pt
      Second Style	Properties
      Name	EvenRow
      Border Color	MidnightBlue
      Borders	Bottom
      Font	Tahoma, 10pt
      Third Style	Properties
      Name	TableHeading
      Background Color	MidnightBlue
      Font	Tahoma, 10pt, bold
      Foreground Color	White
      Fourth Style	Properties
      Name	CountryName
      Font	Tahoma, 14pt, bold
      Foreground Color	Black

3. Complete the following steps to apply the new styles:
   1. Expand the Styles field in the Properties pane.

   2. Select TableHeading in the Style field (under Styles) for the Fiscal Year and Sales Amount fields in groupHeaderBand2.

      

   3. Set the following fields for [FISCAL_YEAR] and [SUM(SALES.AMOUNT_SOLD)] in detailBand1:

      Field	Property
      Even Style	EvenRow
      Odd Style	OddRow

   4. Select the COUNTRY_NAME field in groupHeaderBand1 and then select CountryName in the Style field.

Step 4: Update Bands and Add Controls

Bands group the information layout in the report and you can add controls to include additional tables, images, fields, and other items in the report. See Add Controls for more information about controls. For the scenario, you will expand bands, delete a band, and add a control.

1. Right-click pageHeaderBand1 and select Delete.
2. Complete the following steps to add a line under the report title:

   1. Select the groupHeaderBand1 and move it down half an inch.

      Tip: It is helpful to expand a band before adding controls to give you plenty of room in which to work.

   2. Drag Line from the Toolbox into reportHeaderBand1.
   3. Expand it to the width of the page.
   4. Drag and position it directly below the report title.
   5. Enter 2 in the Line Width field in the Properties pane.
3. Select reportFooterBand1 and drag it down half an inch. This adds white space between the country information.Click here to see the Data Report Designer layout.

   

4. Click Preview. Click here to see the report preview.

   

5. To save the report, right-click the Data Report Designer tab and select Save File.