Professional Documents
Culture Documents
User Guide
Vision Word
Contents
ABOUT THIS GUIDE ............................................................................................................................... 1
Recommended Audience and Prerequisite Knowledge......................................................................................................... 1
Course Objectives....................................................................................................................................................................... 1
Typographical Conventions....................................................................................................................................................... 2
Vision Documentation............................................................................................................................................................... 2
SECTION 1: VISION WORD OVERVIEW ................................................................................................... 3
Query Templates......................................................................................................................................................................... 3
Query Definitions ....................................................................................................................................................................... 3
Equation Editor .......................................................................................................................................................................... 4
Graph............................................................................................................................................................................................ 4
Format Tables ............................................................................................................................................................................. 4
Alerts............................................................................................................................................................................................. 4
Merge............................................................................................................................................................................................ 5
Utilities.......................................................................................................................................................................................... 5
Recalculate ................................................................................................................................................................................... 8
Drilldown ..................................................................................................................................................................................... 8
V3................................................................................................................................................................................................... 8
SECTION 2: STARTING VISION .............................................................................................................. 9
Loading the Vision Word Add-In (Template) ........................................................................................................................ 9
Logging On and Off Vision .................................................................................................................................................... 10
Show or Hide the Vision Toolbar and Menu........................................................................................................................ 11
Changing Your Password ........................................................................................................................................................ 11
Setting Options ......................................................................................................................................................................... 11
SECTION 3: QUERY DEFINITION FORMS .............................................................................................13
Components of a Query Definition Form ............................................................................................................................ 13
Working with Query Definition Forms ................................................................................................................................. 16
SECTION 4: DETAIL REPORTS ............................................................................................................. 26
Overview.................................................................................................................................................................................... 26
Creating a Detail Report .......................................................................................................................................................... 26
Wildcard Characters.................................................................................................................................................................. 29
SECTION 5: TARGETS, BOOKMARKS AND SUMMARY LINK .................................................................. 30
Targets ........................................................................................................................................................................................ 30
Bookmarks................................................................................................................................................................................. 31
Table Bookmark Name Manager............................................................................................................................................ 31
Summary Link ........................................................................................................................................................................... 32
Creating a Summary Link ........................................................................................................................................................ 32
SECTION 6: TABLE FORMULA COPY AND DEFINE CRITERIA ............................................................. 34
Table Formula Copy................................................................................................................................................................. 34
Copying Formulas in a Table .................................................................................................................................................. 34
Define Criteria........................................................................................................................................................................... 35
Modifying Multiple Formulas.................................................................................................................................................. 36
Course Objectives
By the end of the course you will be able to:
Load the Vision Add-in.
Use the Vision Word functions of Data Link, Summary Link, Detail Report and Summary
Report to extract data from your financial database into an Word worksheet.
Create your own User Defined Output data items.
Use Drilldown to drilldown on data associated with formulas.
Create simple Format Tables.
Lasata Software 1
Vision Word
Typographical Conventions
To facilitate your use of the Vision Training Guide, the following conventions have been used:
Vision Documentation
Online Help
Vision includes Online Help that provides detailed information for using the Vision features.
To gain access to Online Help select Help from the Vision menu.
Internet Resources
Print Documentation
Lasata Software 2
Vision Word
Vision Word provides an intelligent link between your database tables and Microsoft Word, allowing
you to access and exchange data held in your database tables from within Microsoft Word.
Access to Vision Word commands can be found in the Vision menu on the Word menu bar or on the
Vision Word toolbar.
Vision Word provides the following purpose-built functions and utilities, which can be used together
or separately:
Query Templates
Query Templates facilitates the sharing and management of predefined query definitions across Vision
client applications, such as Vision Word. A template contains details of Data Filter Items, Data
Output Items and Report Style settings. Completed and incomplete templates can be saved for future
refinement. Templates are stored on the server in the Vision centralized database. Users are able to
create and then share templates by placing them in the ‘Library’ folder work area. In addition, each
Vision user is provided with their own dedicated folder, which is not accessible to other Vision users
connected to the server. Users are able create customized sub-folders in the ‘Library’ and their
personal folder work area. A lock ensures that the template or folder can not be deleted by another
Vision user.
Query Definitions
Data Link
Data Link returns the value of a single record. A single formula can output multiple data items for
that record. Data Link provides a dynamic link between Word and your database. The link is
represented by a formula in a Target within a Word document.
Summary Link
Summary Link can be used to extract the balance of a filtered range. One formula can output multiple
data items for the selected range of records. Summary Link also maintains a dynamic link to your
tables. The link is represented by a formula in a Target within a Word document.
Summary Report
Summary Report can be used to extract a summarized listing from your database into a Word
document. There is one row in the Word table containing all the Data Output Items for each
Lasata Software 3
Vision Word
summary level. For example, if the summary level is a date, there would be one row in the Word table
for each date.
Summary Report query can be saved as a formula so the function can be re-run to extract the current
data from your database. The report definition can be saved as a Setup File or Document File for
retrieval later.
After Vision Word has generated the values for your worksheet you can apply all the usual Word
facilities. You can save, print and export it as you would any other Word document.
Detail Report
Detail Report provides a detailed listing from your database into a Word table. There is one row in the
Word table for each record in your database.
Detail Report query can be saved as a formula so the function can be re-run to extract the current
data from your database. The report definition can be saved as a Setup File or Workbook File for
retrieval later.
Equation Editor
The Equation Editor enables you to define your own equations (formulas). The result of the equation
is stored in a Vision bookmark. The bookmark containing the result can be used in other equations or
in Document Rules.
Graph
The Graph feature inserts a graph into a document to represent report definition results. Graphs can
be displayed for Summary Reports and Detail Reports.
The data source for the graph can be held as a target, Setup file or Document file. The graph can be
recalculated as if it were a regular formula.
Format Tables
A Format Tables allows the user to define bookmarks driven by the value of another bookmark or
calculated value in the document. If a value falls in a user-defined range, the value can be replaced
with text, formulas, field references or any combination of these. You can also change the font and
background color.
Alerts
Alerts are used in conjunction with the Vision Alert product to do conditional processing depending
on whether the Alert has fired or not fired.
Lasata Software 4
Vision Word
An Alert is defined in Format Tables and is activated when any of the conditions defined in a Format
Table are met.
Merge
The Merge function is used to create multiple letters or reports that contain standard text and are each
tailored by information from a data source file.
There are three components required for the merge process:
• A Main document is the template for the generated merge file. It contains standard text and
merge field links to a data source file.
• A data source file contains data that populates the merge document. The data is held in a
table, with each column a potential merge field. The table cells can contain text or a report
definition formula. Alternatively, the table itself can be generated by a Summary Report or
Detail Report definition. The data source file can be a separate document, stored as a Setup
File (file system) or Document File (within the Main document).
• A merge file is generated by extracting each row in the data source's table into the Main
document's merge fields. The merge file can be created as a single document, sent to a
printer or created as multiple documents.
Utilities
Criteria View
Criteria View enables the user to display all Data Link, Summary Link and Equation Editor definition
bookmark names and values for a selected range in one window. Microsoft Word bookmarks are also
included in the window.
Lasata Software 5
Vision Word
Define Criteria
Define Criteria allows the user to change the filter criteria or Data Output Items in multiple Data Link
or Summary Link definitions in a selected range with the same parent table.
Vision will group multiple definitions in the selected range by the parent table. For example, there
would a group for definitions that selected Chart of Accounts and another group for definitions that
select Ledger.
If you select a group of definitions and the Data Filter Items or filter criteria are different in the
selected definitions then these data items are displayed with a key to indicate they are locked. You can
override this lock and the filter criteria in all the definitions will be changed for that data item. If the
selected definitions have different Data Output Items in the Output window then the relevant data
items are displayed with a key. You can override this lock and all the definitions will be changed to
include the amended Data Output Items.
Group Manager
The Group Manager utility is used to assign a collective Group Name and Group Values to single
value targets (results). This provides a mechanism for preventing new targets from unintentionally
being part of an existing filter.
The output of the following definition types can be grouped: Data Link, Summary Link, Equation
Editor and Format Table.
Group names can be used as part of an advanced target filter rule in Document Rule Manager or
Equation Editor. This removes the dependence on target names when creating filter rules and
provides greater flexibility when filtering.
Lasata Software 6
Vision Word
The value of the bookmark may also be included in the bookmark name. For example, including the
account code in the bookmark name.
Individual bookmark names can also be edited using this function.
Output to PDF
A Vision Word document can be output to a PDF document. A PDF document file size is smaller
than a Word file so it can be quickly sent via e-mail. A PDF document provides a secure means to
transfer confidential documents. Security passwords and permissions use 128-bit encryption to ensure
that the original PDF document can not be tampered. To view PDF documents, Adobe PDF Reader
or Adobe Acrobat 5 or above is required
Languages
The Languages utility allows you to change Product translations for predefined names for tables,
fields and lookups listed in the query definition form. These changes can be exported and imported
and so shared with other Vision users.
Lasata Software 7
Vision Word
Hierarchies
Hierarchies are used to represent parent-child relationships between records in your data source.
Specific data items have hierarchical lookups and optional data extraction available. Hierarchies can be
used to extract data for a parent data item and all of its descendents, thereby optionally enabling
consolidated data to be returned.
Hierarchies are created by the Hierarchy Designer and shown as green Data Items in the Selection
List. See Vision XL Training Guide for further details on Hierarchies.
Recalculate
There are three Vision Recalculate functions:
• Recalculate Range
• Recalculate Paragraph
• Recalculate Document
Drilldown
Drilldown will allow you to perform ad hoc drill downs Vision Word Targets.
Data items may be added or removed from the Output window in the Drilldown definition form to
allow you to define your analysis.
After the initial drill down on a single Target, different types of analysis can be performed using the
Adhoc Inquiries utility on one row in the Drill worksheet.
The Drilldown button on the query definition form allows you to perform Drilldown Analysis
without first extracting the data.
V3
V-cubed allows you to perform multi-dimensional analysis on Summary Link and Summary Report
Targets generated by Vision Word.
V-cubed can be performed across multiple serducts and across multiple dimensions. Multiple Product
formulas can only be viewed if they contain an identical number of fields and field types; the Validate
feature checks this.
V-cubed Profiles can be saved into a file and then viewed offline. No changes can be made to the
Cube when it is offline, but all the Drilldown information can be viewed.
Lasata Software 8
Vision Word
When the Vision product is installed the Vision Word Add-in, LsAgoWrd.dot, is automatically
included in your Vision folder as well as your Word Startup folder (typically C:\Program
Files\Microsoft\Office11\Word\Startup). Vision Word is automatically loaded each time you launch
Microsoft Word.
Lasata Software 9
Vision Word
The Vision dialog box is displayed. Enter valid User ID and Password details.
To logoff Vision, from the Vision menu select Logoff or click the logoff button on the Vision
toolbar.
Lasata Software 10
Vision Word
Setting Options
To customize Vision Word, from the Vision menu select Options.
The Options dialog box is displayed. Click the Assist button to select either a Yes or No setting.
Lasata Software 11
Vision Word
Lasata Software 12
Vision Word
Definition forms are used to define and select criteria for Summary or Data Links and Summary or
Detail Reports. Vision Word functions can be opened from the Vision menu on the Word toolbar.
Filter Window
The filter window is used to define data item filters. Mandatory data item filters are automatically
displayed in bold in the Filter window. The mandatory filters displayed are dependent on the Product
and Table selected, and they must always have filter values applied.
Lasata Software 13
Vision Word
Output Window
The Output window shows data items that will be output to Excel. The Output window also displays
the file path of each data output item to assist in identifying its source.
For Data Link and Summary Link functions, the Output window displays the Target Cells column.
This displays the cell where the data item will be extracted.
Lasata Software 14
Vision Word
Settings
Setup File: save the definition to the file system
Document File: save the definition in your Word document
Formula: if set to Y, the definition is saved as a formula in a Target and can be re-extracted using
Vision Word Recalculate.
Note: If Formula is set to Y, then the results in the table cannot be used as filter criteria for other
Vision Word definitions.
Suppress header when no data: if this is set to Y and either Output Table Names or Output Data
Item Names is enabled (under Report Style below) and no data is extracted when the definition is run,
then a table is not created in Word.
Target: allows you to define your own bookmark name for a new report when Formula is set to Y. If
you do not enter anything in Target and Formula is set to Y, then the bookmark will be named using
the default Microsoft Word bookmark naming convention. You can also edit the bookmark name for
the Target containing the report definition using this option.
Report Style
Report Style sets the layout of the report. There are two Report Style options:
• None: apply no style.
• Auto Format: apply a format selected from the Auto Format area.
Borders, Shading, Font, Colour: If the checkbox is cleared then the relevant default for the format
style selected is ignored.
Output Table Names: if checked, the first row of the Word table contains the table name.
Output Data Item Names: if checked, the second row of the Word table contains the data item
name displayed in the Output window. If Output Table Names is not enabled then this information
is in the first row of the table.
Total: if checked, numeric data output items will automatically be summed and a Total row will be
inserted at the end of the report.
Lasata Software 15
Vision Word
Lookup List
The simplest and quickest way to set filter criteria is to use available values for the Data Filter Item.
Selecting the Data Filter Item and clicking the assist button displays a lookup list. The lookup list
contains all the values for the Data Item returned from the database. Select values from the list. The
values are inserted into the Query definition form next to the selected Data Filter Item.
With the Combinations feature, contiguous and non-contiguous ranges can be selected in the lookup
list. Hold down the SHIFT or CTRL key when making selections.
The selection in the dialog box can be replicated by the syntax: <<10000..12000,19000,22200 typed
into the Filter From text box on the query definition form.
To clear your selection in the lookup list click the Clear button, .
Lasata Software 16
Vision Word
Bookmark
A Data Filter Item can refer to the value of bookmark to set filter criteria. The value of bookmark can
be modified in the document without changing the Data Filter Item directly in the query definition. A
change to a referenced bookmark will alter the query extracted from the database.
For example, a bookmark called ‘Year’ has the value 2004. The query includes a Data Filter Item that
uses the bookmark to determine which year to return results for. If ‘Year’ is revised to 2005, the query
will now return values for the year 2005. It has not been necessary to open and modify the original
query definition form.
To use a bookmark:
1. In the document, type the value of the bookmark (e.g., 2004).
2. Highlight the value and insert a bookmark.
3. Give the bookmark a name (e.g.,Year).
4. Create a Query definition and select the Data Filter Item requiring the bookmark value.
5. Double-click the ‘Filter From’ field box. A list of available bookmarks is shown.
6. Select the bookmark. The bookmark name is assigned to the Data Filter Item.
Filter Options
Filter Options can assist with setting filter criteria for Data Filter Items by providing comparison
operator and pattern matching syntax.
Right-click the Data Filter Item and select Options from the short-cut menu.
Lasata Software 17
Vision Word
Segment Filtering
Segment is used to filter a small section of a longer code. Within the code the array of segment
characters may represent a region, country or department. By filtering with a segment from a list of
codes it is possible to perform detail Drill analysis in both setting Data Filter Items and Data Output
Items.
Segment is reserved for alphanumeric fields. Segment functionality can not be applied to numeric
reference fields, where the field is referential and numeric.
In Vision, Segment is implemented in two areas:
• As Data Filter Item criteria, such as part of an account code which represent a company
department. Only account codes matching the specified segment are extracted.
• In Extraction Type, where the Data Output Item value can be stripped by a set number of
characters.
There are two settings two determine a Segment: Offset and Length. Where Offset is the starting
point of the segment in the string and Length is the number of characters in the segment.
Lasata Software 18
Vision Word
Associated Buttons
Add / Remove all Data Output Items relating to the parent or selected
dependent table to the Output window.
Associated Buttons
Promote / Demote Data Output Items in the Output Window. Data is
extracted to the Executive worksheet in the order in which Data Output Items
are listed.
Lasata Software 19
Vision Word
To toggle between sorting the Data Output item in ascending ( ) or descending ( ) order, click
the data item.
Click the arrows on the right hand side of the Sorting list to change the output order. The Sort
Number displays the order number, and includes parenthesis ‘( )’ for items sorted in descending order.
Select the Top option to limit either the number of sorted records returned or as percentage of total
records.
Associated Buttons
Sort Data Output Item values in ascending or descending order.
Lasata Software 20
Vision Word
The default extract mode for quantity and amount data items is Sum. For all other data items the
default is Count for Summary Link and None for Summary Report. Data items displayed in red in the
Selection List have additional extract modes associated with them.
The available extract modes are different for the type of data item selected for output. For example,
Sum and Average are available for quantity or amount data items but not for any other data item type.
Data items transferred more than once to the Output window are displayed with the next available
extract mode.
For example, the first time ‘Other Amount’ is added to the Output window Sum icon is displayed, as
Sum is the default extract mode for quantity data items. A second ‘Other Amount’ data item output
item automatically displays the Count extract mode and if ‘Other Amount’ is added a third time, the
extract mode is Average.
Associated Buttons
Change the Extraction type for a Data Output Item.
Lasata Software 21
Vision Word
Distinct Average: Output the average of the unique values in a column for all rows.
Reverse Sign option Change numbers that normally appear as positive to negative and
vice versa (i.e. revenue account balances will appear as positive
numbers).
Short Description
Description
These are displayed automatically when applicable data items are transferred to the Output window.
These modes are predefined on some data items to resolve issues between how the data is stored in a
database and the value required when output to a report.
Users have the choice of outputting Code, Short Description or Description by changing the default
Extract Mode. A data item can also be output multiple times with a different Extract Mode, for
example Code and Description.
Lasata Software 22
Vision Word
codes it is possible to perform detail Drill analysis in both setting Data Filter Items and Data Output
Items.
Segment is reserved for alphanumeric fields. Segment functionality can not be applied to numeric
reference fields, where the field is referential and numeric. In this case consider using text functions
such MID as part of a User Defined Output.
In Vision, Segment is implemented in two areas:
• As Data Filter Item criteria, such as part of an account code which represent a company
department. Only account codes matching the specified segment are extracted.
• As Extraction Type, where the Data Output Item value can be stripped by a set number of
characters.
There are two settings two determine a Segment: Offset and Length. Where Offset is the starting
point of the segment in the string and Length is the number of characters in the segment.
For example:
A Data Output Item has a Segment setting of Offset = 3 and Length = 3. If the Data Output Item
value is 'ID235ZA', then the string '235' is output.
Lasata Software 23
Vision Word
Associated Buttons
Format a date or numeric Data Output Item.
Associated Buttons
Rename Targets.
Associated Buttons
User Defined Output defines customized output items. Preset text string
functions, mathematical and data functions can be incorporated into formulas.
Lasata Software 24
Vision Word
saves the extraction criteria within the Word document. Enter the name of the Setup or Document
File in the corresponding field. To retrieve a file that has been saved, click the Setup File or
Document File button at the bottom of the definition form.
Step 10: Report Style – Tab 2 (Summary and Detail Reports only)
The Report Style section allows you to set the layout and formatting of the report. To apply a
predefined format, select the AutoFormat option and then from the AutoFormat dropdown select the
desired format. The checkboxes allow you to override the AutoFormat and exclude elements from the
output.
Lasata Software 25
Vision Word
Overview
Detail Reports provide a detailed listing from your database into a Word table. Use Detail Report to
extract data from a range of data into a Word document. There is one row in the table for each record
in your database.
Detail Report does not retain a dynamic link to your database; therefore the function must be re-run if
data in your database changes. The report definition can be saved as a Setup File or Document File.
If a Setup File Formula is set to Y on tab 2 of the Definition Form, then the report can be run using
the Vision Recalculate functions. The formula is stored in a Target or text form field.
You can set a transaction limit in Vision Setup to limit the number of transactions extracted at any
one time. When the transactions extracted reach that number, a message appears notifying you of the
limit. You must reset the limit in Vision Setup to view further transactions.
Lasata Software 26
Vision Word
4. Select a Table. Click the Filter From assist button to present a list of available 'parent' tables.
Select the required table and click OK. Alternatively, click the Find button and enter the table's
name.
5. Enter filter criteria in the From field for the listed data filter items. If this filter criteria is:
• Unknown: Click the Filter assist button. A list of records is obtained from the table. Select a
record to extract data from. Click OK.
Lasata Software 27
Vision Word
• To be accessed from a bookmark: Double-click the Filter field. Select the bookmark from
the bookmark list. Click OK. The bookmark is inserted into the Filter field, the field turns
yellow.
• A date filter: Click the assist button. The Period Selection dialog box is displayed.
In addition to the mandatory filters, shown in bold, additional data filter items can be
included in the definition. Drag data items from the Selection List into the Filter window.
When a data item is added to the Filter window more than once it has a number added to
make it unique (i.e. #2 added will indicate that this filter is being used for a second time).
6. Enter Filter To criteria details.
7. Select data items to output. There are several ways to place an item in the data output window,
either:
• Drag the item from the Selection List to the Output window.
• Double-click the item in the Selection List. It is automatically transferred to the Output
window.
• Click the Add Table button to transfer all items to the Output window.
Lasata Software 28
Vision Word
• Drilldown.
9. Select Tab 2, the following options are available:
• Save the definition form details as a Setup or Workbook File so it can be retrieved later.
• Set the Formula option.
• Set the Suppress header when no data option.
• Enter a Target bookmark value.
• Select a Report Style.
10. Click OK on the Definition Form to perform the query.
Wildcard Characters
Wildcard filters are available when defining Target Filter Rules. Filters with wildcards only use a single
filter value not a range. Any value entered in the Filter To field is ignored.
The wildcard filters are:
“%” (asterisk) to substitute any number of characters for the asterisk.
“*=_” (underscore mark) to substitute any single character for each underscore mark.
Lasata Software 29
Vision Word
Targets
Vision Word inserts the result of a report definition into a document using a Target. By default the
Targets are named AgFld1...AgFldn, where n is the number of Data Output Items. By applying
meaningful names to Targets it becomes easier to navigate and develop Vision Word documents.
5. Use the Clear and Clear All buttons to remove existing Target names. Unnamed Targets are
assigned the Vision Word default name.
6. Enter the Target's new name. Click OK.
7. Click OK on the Target Maintenance dialog box to update the Target names in the data output item
list.
Lasata Software 30
Vision Word
Bookmarks
A bookmark is a Microsoft Word function that is an item or location point you identify and name for
future reference. In Microsoft Word some of the ways you would use bookmarks is to quickly jump
to a specific location, create cross-reference or mark page ranges for index entries.
Note: If you change a name of bookmark that is included in a Target Filter Rule you will need to
amend the Target Filter Rule to reflect the name change.
Lasata Software 31
Vision Word
Bookmark names must start with an alpha character cannot contain spaces or use reserved characters.
There is a test button to validate the name specified.
The value of the bookmark may also be included in the bookmark name. For example, the account
code can be included in the bookmark name.
Note: Contiguous cells from a single column in a table must be selected prior to using Table
Bookmark Name Manager.
If you change a name of bookmark that is included in a Target Filter Rule you will need to amend the
Target Filter Rule to reflect the name change.
Summary Link
Summary Link maintains a dynamic link to your tables. The link is represented by a formula retained
in a bookmark within a Word table.
Summary Link can be used to extract the balance of the filtered range. One formula can output
multiple data items for the selected range of records.
The output is calculated using the selected Extract Mode such as Sum, Count, Distinct Count and
Minimum. User defined calculations are also available.
Once you have set up a table using Summary Link, you can edit the formulas within the definition
form to return the same information against different data.
Lasata Software 32
Vision Word
Lasata Software 33
Vision Word
Note: Table Formula Copy can only be used on rectangular (uniform) tables, i.e. the table has the
same number of columns in every row and vice versa.
Lasata Software 34
Vision Word
2. Select Vision > Utilities > Table > Formula Copy. The Table Formula Copy dialog box appears
displaying a list of bookmark items used in the formula.
3. Select the direction in which the formula should be copied, either down a column or across a
row.
4. Select the bookmark check boxes to maintain an absolute reference when the formula is copied.
A relative reference is denoted by an unchecked box, an absolute reference is denoted by a “$”. A
bookmark associated with a red cross indicates that the bookmark is outside the table and so
absolute and relative referencing does not apply.
5. Click the OK button to proceed with copying the formula in the selected direction.
Define Criteria
Define Criteria allows the user to change the filter criteria or Data Output Items in multiple Data Link
or Summary Link definitions in a selected range with the same parent table.
Vision will group multiple definitions in the selected range by the parent table. For example, there
would a group for definitions that selected Chart of Accounts and another group for definitions that
select Ledger.
If you select a group of definitions and the Data Filter Items or filter criteria are different in the
selected definitions then these data items are displayed with a key to indicate they are locked. You can
override this lock and the filter criteria in all the definitions will be changed for that data item. If the
selected definitions have different Data Output Items in the Output window then the relevant data
items are displayed with a key. You can override this lock and all the definitions will be changed to
include the amended Data Output Items.
Lasata Software 35
Vision Word
3. Select the Table group to be modified. The Formula window is updated with the corresponding
queries that refer to the selected Table group. Each query is preceded by a check box.
4. Select the check box for each query Target to be updated. Use the Select All button to include all
queries and the Clear All button to remove all query selections.
5. Click the Define Criteria button. The definition form applicable to the selected Table group
appears.
6. Make the necessary modifications to the queries. When the selected bookmarks contain
mismatched filter criteria, the Filter fields are marked with a key and have an orange background
to indicate that they have been locked. Making a universal change to locked bookmark fields can
produce unexpected results.
7. Click OK to close the definition form.
8. Click OK to close the Define Criteria dialog box.
9. Recalculate the document.
Lasata Software 36
Vision Word
Lasata Software 37
Vision Word
Overview
The Equation Editor enables you to define your own equations (formulas). The result of the equation
is stored in a Vision Target. The bookmark containing the result can be used in other equations or in
Document Rules.
Equation Editor uses VBScript and therefore you are not limited to just mathematical equations.
There are five equation types:
Bookmark: This enables you to apply an equation to the value of a single bookmark.
Bookmark in selection: This enables you to insert a delimiter between multiple bookmark values.
Delimiters can be mathematical operators or text.
Group Sum: This enables you to sum a group of Targets that have been defined in a Target Filter
Rule. You use a Target Filter Rule that has already been created in your currently selected Word
document or create a new Target Filter Rule as part of the process of defining an equation.
Group Average: This enables you to define an equation with the result being the average of a group
of Targets that have been defined in a Target Filter Rule. You use a Target Filter Rule that has already
been created in your currently selected Word document or create a new Target Filter Rule as part of
the process of defining an equation.
The average is calculated on the sum of the value of the Targets divided by the count of the
bookmarks.
Group Count: This enables you to count the number of bookmarks that have been defined in a
Target Filter Rule. You use a Target Filter Rule that has already been created in your currently selected
Word document or create a new Target Filter Rule as part of the process of defining an equation.
Note: Vision bookmarks and Word bookmarks behave differently if the value of a bookmark looks
like a number. For example, account code 11000 extracted using a Vision query will be treated as an
alphanumeric field and will not be treated as a number in an equation. Word bookmarks treat all
values that look like numbers as numbers and can therefore be included in mathematical equations
Lasata Software 38
Vision Word
Defining an Equation
1. Select Vision > Equation Editor. The Equation Editor dialog box appears.
Lasata Software 39
Vision Word
Lasata Software 40
Vision Word
Overview
Criteria View enables the user to display all Data Link, Summary Link and Equation Editor definition
bookmark names and values for a selected range in one window. Microsoft Word bookmarks are also
included in the window.
If there are multiple definitions of the same type in the selected range, for example Summary Link,
then the relevant information for all the definitions for the selected item will be displayed.
When an item is selected in the Criteria View window the definition information is displayed in the
relevant Target in your Word document. Displaying the definition information in Criteria View does
not overwrite the extracted value.
Vision definition criteria are highlighted in yellow and Microsoft Word bookmarks in cyan. If a
bookmark has not been defined then <unspecified> is displayed.
Lasata Software 41
Vision Word
• Click the plus sign '+' to expand the Criteria View tree.
• Click the minus sign '-' to contract the Criteria View tree.
3. Click a value or output item. The value of the item is displayed in the Target, which is highlighted
in yellow. Any Targets used in the selected Target's equation calculation are highlighted in cyan.
4. Click OK to close the Criteria View window.
Lasata Software 42
Vision Word
Overview
The Document Rule Manager has two functions:
• Creating new Target Filter Rules
You can define your own Target Filter Rule to modify the face value of the extracted value
in existing Targets. For example: If wish amounts to displays in thousands, you would define
a rule to divide the bookmark value by 1000.
Target Filter Rules can only be applied to Target values calculated using Data Link, Summary
Link or Equation Editor.
• Managing the documents rules
You can define the processing sequence of Target Filter Rules.
You can enable or disable a Target Filter Rule processing.
Lasata Software 43
Vision Word
Table Copy
The Table Copy utility should be used to copy a Word table with cells containing Summary Link,
Data Link and Equation Editor Targets and Word bookmarks. A table can be copied to the same
Word document, an open Word document or a new Word document. Vision Word Table Copy will
automatically increment any bookmark names, Setup file and Document file names associated with
the table being copied. The formatting of the table is maintained.
If the table is being copied within the existing document the copy of the table will be underneath the
table being copied. If the table is being copied to an open or new Word document then the table will
appear at the top of the document.
Hint: To keep a table aligned whilst moving it to a new location, select the table and hold down the
shift key.
Note: Copying as table using the Microsoft Word copy will not copy Word bookmarks and the
Vision Word targets will have to be manually renamed.
Lasata Software 44
Vision Word
Copying a Table
1. Select the table.
2. Select Vision > Table > Table Copy. The Table Copy dialog box appears displaying a list of
documents. The list includes the current document, documents that are open in Word and the
New Document option.
3. Select the required document.
4. Click OK. If the document selected is the current document the new table is pasted underneath
the existing table. If the document selected is already open in Word the new table is pasted at the
beginning of the document. If the New Document option is selected, a new document is created
and a new table pasted in.
Lasata Software 45
Vision Word
Overview
Vision Word functions are not mutually exclusive and can be used in conjunction with each other.
Reports can be created with combinations of Data Link, Summary Link, Detail Report and Summary
Report. Functions can also be used as filter criteria. For example, a Detail Report can use a Data Link
as a company or account filter. A change to the Data Link function would then cause a change in the
Detail Report on recalculation. This allows you to create more robust reporting solutions.
Formula Field
Formula Field is used in conjunction with Data Link, Summary Link or Equation Editor Targets. The
Formula Field function should be used if value being extracted from your database is inserted multiple
times in the same Word document.
Lasata Software 46
Vision Word
Note: You can reduce extraction time when the same information is being inserted multiple times in
the same Word document by using Formula Field. Vision Word reads the database once for every
formula whereas using Formula Field means the information can be inserted multiple times using the
same Vision formula and therefore will only do one read of the database.
Hint: If you wish the result of an extraction to only display in the header and footer section and not
in body of the Word document where the formula is defined change the format of the text to have
the same colour as the paper, for example white on white.
Lasata Software 47
Vision Word
Overview
The Merge function is used to create multiple letters or reports that contain standard text and are each
tailored by information from a data source file.
There are three components required for the merge process:
• Main document: the template for the generated merge file. It contains standard text and
merge field links to a data source file.
• Data source file: a document or report definition that contains data in a table and is used to
populate the merge document. Each column can be used as a merge field in the Main
document. The table cells can contain text or a report definition formula. Alternatively, the
table itself can be generated by a Summary Report or Detail Report definition. The data
source file can be a separate document, stored as a Setup File (file system) or Document File
(within the Main document).
• Merge file: is generated by extracting each row in the data source's table into the Main
document's merge fields. The merge file can be created as a single document, sent to a
printer or created as multiple documents.
Note: It is recommended that the data source is stored as a Document File within the Main
document. Create the table with the report definition, save the definition, and then delete the table
from the document. Use the blank document to create the Main document. Now, both data source
and template are in the same document.
Note: Without a page break the generated merge document concatenates all resulting text with no
natural break to separate the information. The page break ensures that each generated letter or report
starts on a new page. If you are merging Multiple Documents, a page break is not required and each
document will be separate.
Lasata Software 48
Vision Word
5. Click the Style assist button. Select Document as the Main document style.
6. Click the Data Source Name assist button. There are three data source options:
• Word document
• Setup file
• Document file
7. Click the Merge to assist button and select how to output the merge document:
• Document: creates a single document which contains concatenated records from the data
source file.
• Printer: sends the merge file to the default printer. It is recommended that the merge
process first be tested by creating a merge document. If successful, repeat the merge process
with output to a printer.
• Multiple Documents: creates a document for each record in the data source file. You are
prompted for the first merge file name and its folder location. The merge file name is
incremented, i.e. mergefile1.doc...mergefilen.doc, where n is the number of records in the
data source file. If the merge file name already exists it is not overwritten; the next available
number is used. A merge folder is created if it no longer exists but had been previously
specified in the multiple documents lookup.
8. Close the Merge Manager and open Merge Designer to specify merge fields in the Main
document.
Lasata Software 49
Vision Word
2. Select Vision > Merge > Designer. The Merge Designer opens.
3. Click Merge field's Insert... button and select a table column. The merge field is inserted into the
Main document. Continue to add merge fields from the data source file as required.
Note: When the document is recalculated it is processed from left to right, then top to bottom. In
some circumstances it might be necessary to first recalculate fields at the bottom of the document to
provide accurate results from formulae at the beginning of the document that use these fields in the
filter.
Command fields force the order of recalculation. Command fields refer to formulas held as targets.
4. If required, click the Command Insert... button and select either to recalculate the field or
document.
5. Select the target to be recalculated. The command field is inserted. Use display controls to toggle
between viewing the merge field names and data source values.
6. Click Field to view merge field names. Click Value to view data held within the merge field and
use the arrow buttons to scroll through the values in the data source. The Recalculate option
allows the user to control whether Command fields perform recalculations when the record is
changed. This is useful when the Main document contains Vision formulas that use merge field
values as filter conditions and the Main document recalculates the resulting formula.
Note: Recalculate only applies in Merge Designer and not when a merge is being processed.
Lasata Software 50
Vision Word
2. Click the Yes button to proceed with the merge process. If the new document is being sent to a
printer, you are prompted to enter Windows printer options.
Lasata Software 51
Vision Word
Overview
Drilldown is available from Vision Word and allows you to perform ad hoc drill inquiries on a single
extract query formula created by:
• Summary Link
• Summary Report
Using Drilldown, you can drill down on the amount to display the composition of that amount to the
summary or transaction level. The Target is analyzed in greater detail so as to return the transactions
that contributed to the total value of the Target.
Once the drill result has been extracted further analysis can be performed on the result with Adhoc
Inquiries.
Adhoc Inquiry shares similar functionality to Vision Executive, so in addition to Drilldown and
Transaction Drilldown, it also provides access to Breakout and Expand analysis tools. Drill paths can
be saved and replayed on extracted drill results.
By incorporating Vision Executive capabilities it is possible to output the analysis results to a printer
or multiple file types from Vision Word.
Using Drilldown
The Drilldown definition form is displayed each time you drill down. Data items may be added or
removed from the Output window in the Drilldown definition form to allow you to define your
analysis criteria.
The Drilldown button on the query definition forms allow you to perform a drill down without first
extracting the data. Extracted information can be sorted in ascending or descending order.
Adhoc Inquiries starts when the Drilldown definition form is extracted. Adhoc Inquiries is derived
from Vision Executive analysis tools. From the Adhoc Inquries interface further analysis can be
perform on the returned results.
Drill results are retained even after the Adhoc Inquiries window is closed, and are only purged once
you have logged off from Vision Word. However, the customizations of templates or style settings are
retained based on the user name.
Lasata Software 52
Vision Word
To use Drilldown:
1. Recalculate the document.
Failure to recalculate may cause a mismatch between the original extracted value and the Adhoc
Inquiries results.
2. Select the query definition formula result you wish to perform further analysis.
3. On the Vision menu, point to Drilldown then select one of the following:
• Summary - to perform drill to transactions.
• Transaction - to drill to drill transaction level.
• Cube - perform Cube Analysis.
If Cube is selected, the Criteria tab of the Cube Analysis definition form is displayed, See V-
cubed section for details on this analysis tool. If Summary or Transaction is selected, the Criteria
tab of the Drilldown definition form is displayed.
The original Data Output Item(s) extracted is shown in bold type.
4. From the Selection list, select data items for the Output window. The values of the new Data
Output Items are used to perform the Drill analysis.
5. On the definition form, complete the Options tab to apply report layout formatting.
6. Click OK. The Adhoc Inquiries interface is displayed.
Lasata Software 53
Vision Word
Adhoc Inquries
Expand Analysis
Expand is a form of drill analysis made on all Summary Link definitions found in a single row. Adhoc
Inquries expands the query based on data output items specified. The original row effectively
becomes the sum total.
The Expand supports multiple level expands, with the inclusion of sub-totaling where appropriate.
Expand (+) and collapse (-) toggle buttons control the level of detail displayed.
Example
Before Expand:
Lasata Software 54
Vision Word
Breakout Analysis
Breakout analysis can be performed on results returned from Summary Link and Summary Report
queries. Breakout automatically creates mirror images of a report on separate dependent worksheets
utilizing the Breakout criteria. The Breakout criteria are defined by Data Output Items in the Output
window.
A Dependent Worksheet is created for each value of the selected Data Output Item. By combining
the results of the individual Dependent Worksheets would produce the results found in the Primary
Worksheet.
On the right a Breakout is made on
the Data Output Item 'Code'. 'Code' is
comprised of the values A, B and C.
Dependent worksheets are created for
each value of 'Code'.
For example, after creating an initial
report for a company, Breakout could
further divide the report into
individual reports for each department
within the company.
The Data Output Item would be the
collective name for the departments.
Lasata Software 55
Vision Word
Lasata Software 56
Vision Word
Overview
V-cubed provides insight into summarized business operations and trends. The cube can be
populated from a query extraction from a relational database or an OLAP Product.
Data source columns are selected to form the dimensions of the cube. The dimensions can be a row
(x-axis), column (y-axis) or slicer (z-axis). A measure is a quantity value returned from the data
source, its location is determined by the intersection of three dimensions. By default, the slicer
dimension displays all values from the output item which effectively squashes the cube to produce a
two-dimensional view.
Additional dimensions can be used to further 'slice' through the formula result. A 'slice' acts as a filter
by only applying a single value from the dimension to locate the measure result. This provides a third
dimensional view of the measure result. The slicer dimension can be toggled through each successive
value using the Slicer window.
By default, a slicer dimension initially includes all values in the calculation of the measure. As further
row or column dimensions are included in V-cubed, new levels are created.
Cube analysis can be performed on several formulas, but they must be from the same product and
have the same tables.
V3 Tabs
V-cubed has four tabs:
• Criteria: contains the Criteria definition form. It displays the current filter criteria and allows
you to select the dimensions you want to use for analysis from the Selection List.
• Options: is used to specify whether a data output item is a measure, dimension or slicer.
• Cube: displays the results of V-cubed. Data output items can be used as column, row or
slice dimensions.
• Chart: displays the selected measure results from the Cube tab in a chart.
Menu Controls
The Cube tab display is controlled by a right-click menu and a series of sub-menus.
Drilldown
Perform an ad-hoc drilldown on a measure result.
Measures
Visible: Display measure in cube.
V-cubed can report measure results as follows:
• Sum: total summation of measure members. [Default]
• Count: total number of measure members.
• Average: average of measure members.
• Minimum: minimum values for measure members.
• Maximum: maximum values for measure members.
Options
Edit Format Tables: Opens the Format Tables dialog.
Show Format Tables: Implement the Format Table in the cube.
Show Empty Cells: Displays dimension members with no values.
Show Row Totals: Activates totals for all row dimensions.
Show Column Totals: Activates totals for all column dimensions.
Hide Single Totals: For dimensions with only one member, only display the total once.
Working with V3
1. Select a Target containing a Vision formula.
2. Select Vision > Cube Analysis.
3. In the Criteria definition form tab select output items to be used as dimensions and measures.
4. In the Options tab, nominate data output items as measures, dimensions or slicers.
The ‘Totals’ option includes a total field for the row or column values. The ‘Split’ option only
applies to dates or period dimensions. If enabled, the dimension can be expressed in terms of
Year, Month, Week of Year, Weekday and Day.
6. Drag dimension fields to the different axes to display data in rows or columns.
7. Expand or collapse the dimensions to view different levels of data.
8. Use the Filter window to filter dimensions and members.
9. Use the Slicer window to filter measure results.
10. Drill down on a measure result.
11. Use the Charting feature to show trends in the data.
Note: It is recommended that V-cubed is not performed on over 10000 transactions as defined in
Vision Setup.
Format Tables
Format Tables controls the visual appearance of Measure results based on satisfying a set of criteria.
Format Tables are assigned to Measures.
The Format Table consists of a series of conditional statements. From the top of the list, the first
statement that is true is implemented, even if further statements can be fulfilled.
2. Click the '+' add Format Table button. A 'New Format Table' definition is created. Double-click
the Format Table definition to rename it.
3. Click the '+' button to add a conditional statement. Click the '-' remove button to delete a
conditional statement.
4. Select a Type comparison.
5. Type in a From value.
6. If required, type in a To value. This is only required for the Type 'Is Between' and 'Is Not
Between'.
7. Click the Font Colour cell and select a colour.
8. Click the Background Colour cell and select a colour.
9. Select the Measure and Format Table.
10. Click the Assign button.
11. Click OK to return to the Cube tab. To implement Format Table in the Cube, select the option
Show Format Tables.
The V-cubed file (*.lcf) can be viewed without the need for the query definition. Cube analysis can be
performed 'offline'. When viewed offline, analysis can only be performed on existing extracted output
items and so it is not possible to add further dimensions or measures that don't already exist in the V-
cubed file.