Procedure Editor Toolbar

The following table lists the procedure editor’s toolbar buttons, where they are found, and what they do. To find out the purpose of any panel button, let the cursor hover over it so its name appears. You can then look it up in the alphabetized table below.

Label

Location

Functionality

Add

SQL Script, Packaged Query, XSLT Procedure, and Parameterized Query Parameters panels; XSLT Transformation Data Map and Outputs panels; XQuery Transformation Inputs panel

Opens a dialog to add a column to a procedure.

Add Resources

SQL Script SQL Script panel; Parameterized Query Model and SQL Script panels

Opens a window to add a resource to a procedure.

Change Type

SQL Script, Packaged Query and Parameterized Query Parameters panels; XSLT Transformation Data Map and Outputs panels; XQuery Transformation Inputs panel

Opens a Choose Data Type dialog in which you can change the data type of the selected column.

Choose Source

XQuery Transformation Model panel

Opens a dialog in which to select a source for the transformation. If you change the source, a dialog opens explaining which sources and target mappings will be affected by the change. Click OK if you want to make the change.

Choose Target Schema

XQuery Transformation Model, Inputs and Outputs panels

Opens a dialog in which to select the definition set that is to be the target schema.

Changing the target schema may cause source mappings and settings to break. Studio will attempt to preserve source mappings and settings for target elements of the same name, ignoring case.

Clear Source

XQuery Transformation Model panel

Opens a dialog explaining which sources and target mappings will be affected by the change. Click OK if you want to make the change.

Collapse All Rows

XQuery Transformation Model panel

Hides all rows below the selected namespace in the hierarchy.

Create Link

XSLT Transformation Data Map panel

Creates a link between the selected source and the selected target. See Mapping Source Data to Target Output Columns (XSLT or Streaming).

Create Link and Target

XSLT Transformation Data Map panel

Creates a new target and a link from the selected source to it. See Mapping Source Data to Target Output Columns (XSLT or Streaming).

Cycle I/O Direction

SQL Script, Packaged Query and Parameterized Query Parameters panels; XSLT Transformation Outputs panel; XQuery Transformation Inputs panel

Cycles the input/output directions. A blue arrow indicates an input parameter; a red arrow indicates an output parameter.

Delete

SQL Script, Packaged Query and Parameterized Query Parameters panels; Parameterized Query Model panel; XSLT Transformation Data Map and Outputs panels; XQuery Transformation Inputs panel

Deletes the selected object or objects.

Delete Row

Parameterized Query Grid panel

Deletes the currently selected row.

Deselect All Outputs

Parameterized Query Grid panel

Unchecks all check boxes in the Output column.

Design By Example

Packaged Query Parameters panel

Lets you select and define parameters (columns and data types) for a cursor. See Designing a Cursor by Example .

Design Mode (check box)

SQL Script, Stored Procedure and XML to Tabular Transformation Parameters panels; Streaming, XSLT and XQuery Transformation Inputs and Outputs panels

Lets you manually define parameters and their data types, or formulate input and output parameters for a procedure. See Design Mode Check Box, page 567.

Execute

All panels except XSLT Procedure Info tab

Executes the procedure. A Results tab opens below the panel, showing up to 50 rows of results of a query, or showing the results of a transformation.

Format Query

SQL Script and Parameterized Query SQL Script panels

Formats the SQL text.

Format XSLT

XSLT Transformation XSLT panel

Indents lines of the XSLT listing to show the hierarchy of elements, making it more readable.

Insert from File

SQL, SQL Script, XSLT, and XQuery panels

Opens a window in which to specify a location from which to upload a procedure’s SQL or SQL script.

Insert Row

Parameterized Query Grid panel

Inserts an empty row above the currently selected row.

List Columns

Parameterized Query Grid panel

Opens a List Columns from Tables dialog.

Native Only (check box)

SQL Script and Parameterized Query SQL Script panels

When checked, pushes custom function execution to the data source. For details, see Pushing a Custom Function to the Native Data Source.

Navigate

Parameterized Query Model panel

Opens a small Navigator window with a box outlining the visible portion of the panel. You can position the cursor over the box, hold down the left mouse button, and drag the box around to choose the panel area you want to see.

Open Lineage Panel

All panels

Opens the Lineage Panel, which shows the dependency relationships between objects.

Save to File

SQL, SQL Script, XSLT, and XQuery panels

Opens a window for specifying where to save the procedure’s SQL.

Select All Outputs

Parameterized Query Grid panel

Checks all check boxes in the Output column.

Show Contents

Parameterized Query Model panel

When a table is selected in the Model panel, or you right-click a table or procedure in the resource tree and select this button, displays all columns that contain data.

Show Details
Hide Details

All Parameters, Inputs and Outputs panels

Opens an area on the right side of the panel with a table of properties and values for the source row selected on the left side of the panel. Checking the Show All Properties check box at the top adds rows on the right with all other hidden values.

Click Hide Details to hide the property-value area on the right.

Show Execution Plan

All SQL Script and Parameterized Query panels

Generates the query execution plan and displays it in the Execution Plan Panel. The query execution plan shows how the CIS query engine plans to execute the view’s SQL. For details, see Working with the SQL Execution Plan.

Show Rebind Panel

All panels except the XQuery Procedure XQuery panel and the XSLT Procedure XSLT panel

Opens the Rebind Panel.

Show Source Settings

XQuery Transformation Model panel

Opens five panels in the lower part of the Model panel (Join, Filter, Sort Order, Inputs, Schema) that show detailed transformation settings.

Single Select (check box)

Packaged Query SQL panel

Tells the CIS query engine that the packaged query is equivalent to a single SELECT statement that can be treated as a derived table. See Creating a Packaged Query.

Toggle Alpha Sort

Parameterized Query Grid panel

Changes the order of available columns in the Columns column drop-down list. Initially off, meaning available columns are listed in their order within their respective tables. When toggled on, lists available columns by table and then column name.

Toggle Syntax Highlighting

SQL Script and Parameterized Query SQL Script panels

Changes between displaying all SQL text in the same font color (usually black) and displaying comments, keywords and literals in the colors you selected in the Editors tab of the Options dialog.

Trace

All SQL Script and Parameterized Query panels

If you select Trace and then click Execute, a Console panel opens alongside the Result panel showing execution details for each line of SQL code. See Executing a Procedure or Parameterized Query.