Professional Documents
Culture Documents
Tables View: Duck Creek Technologies
Tables View: Duck Creek Technologies
TABLES VIEW
• Tables View
◦ Tables View Controls
◦ Adding or Editing Data Names
◦ Creating Tables
◦ Editing Tables
◦ Search Types
◦ Selecting Tables By Class
◦ Viewing Table Inheritance
◦ Working with Table Keys
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 1 of 31
1
Duck Creek Technologies
TABLES VIEW
Overview
The Tables view lists the tables of a ManuScript. You use the Tables view to edit the content of each table. A table contains the raw data of a
ManuScript and is structured with keys by name and values. In Tables view, you can enter and edit data for tables in a ManuScript.
When working with a large amount of data in a table (more than 100,000 cells), it is recommended to create the table as an external
table in a database.
What's Next
For additional information on working in Tables view, see:
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 2 of 31
2
Duck Creek Technologies
• Tables View Controls
• Adding or Editing Data Names
• Creating Tables
• Editing Tables
• Search Types
• Selecting Tables By Class
• Viewing Table Inheritance
• Working with Table Keys
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 3 of 31
3
Duck Creek Technologies
Overview
This article describes ways you can control the Tables view using toolbar buttons, menus, and keyboard shortcuts. Click a table name to open the
Table Properties dialog box. Click a key name or key value to open the Key Properties dialog box.
BUTTON
NAME ACTION
Table properties Opens the Table Properties dialog box for the selected table.
Enter key down Enters data down the columns of the table.
Enter key across Enters data across the rows of the table.
Insert a record in data on the page Inserts a cell into the table, pushing the data down by one cell. The data in the last
cell is lost.
Delete the current record from data on the Deletes data from the current cell and moves the existing data up.
page
KEYBOARD
OPTION ACTION SHORTCUT
CTRL+Z
Undo Undoes the last action performed.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 4 of 31
4
Duck Creek Technologies
KEYBOARD
OPTION ACTION SHORTCUT
CTRL+A
New Table Opens the Table Properties dialog box for you to create a new regular table.
New Opens the Table Properties dialog box for you to create a new conditional table.
Condition
Table
New External Opens the Table Properties dialog box for you to create a new external table.
Table
New Opens the Table Properties dialog box for you to create a new datasheet table.
DataSheet
Table
Delete Table Deletes the selected table. This option is not available for inherited tables.
Demote/ Removes local table definition, returning it to inherited status. This option is only available on modified
Revert inherited tables.
Select by Opens the Select by Class dialog box for you to choose a table from the Class-ordered dropdown list.
Class
F5
Refresh Refreshes the list of tables.
Table
Import Opens the Table Import Wizard for you to import table data.
External
Table
Properties Opens the Table Properties dialog box for the selected table. You also can double-click a table name to
open the Table Properties dialog box.
Duplicate Opens the Table Properties dialog box for you to duplicate the selected table and retain the information
Table from the copied table.
View Table Opens the XML Viewer dialog box, for you to view the source XML for the selected table.
XML
Compare Opens the XML Comparison dialog box for you to compare the current XML with the base XML. This option
XML is only available when changes are made to inherited tables.
CTRL+U
Used By Opens the Usage dialog box for you to see the items that use the selected table. To go to an item, click the
item and then click Go To.
Key The options available when working with table keys vary by table type.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 5 of 31
5
Duck Creek Technologies
KEYBOARD
OPTION ACTION SHORTCUT
• Edit Key
• Add Key
• Delete Key
• CTRL+X
Data The following options are available for editing table data: (Cut)
• Modify Data • CTRL+C
• Insert Record (Copy)
• Delete Record • CTRL+V
(Paste)
• Delete Data
• Cut Data
• Copy Data
• Paste Data
Cell Size Available only for conditional tables. The following options are available for modifying cell size:
• Increase Min Height
• Decrease Min Height
• Increase Min Width
• Decrease Min Width
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 6 of 31
6
Duck Creek Technologies
Move row(s) up
Click to move the current row or all marked rows up.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 7 of 31
7
Duck Creek Technologies
Overview
Data Names in the Table Properties dialog box are the column titles for the table. In this section you will learn how to add or edit Data Names.
3. Enter the new data name into the Data Names field, or edit an old name.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 8 of 31
8
Duck Creek Technologies
CREATING TABLES
Overview
In this section, you will learn how to create three types of tables:
• Regular tables that contain values corresponding to table keys.
• Conditional tables that contain values determined by specified conditions.
• DataSheet tables that allow unlimited key and key-value combinations.
• External tables that contain data not included in the ManuScript.
You will also learn how to import external tables or map the XML of a ManuScript to import Excel data.
When working with a large amount of data in a table (more than 100,000 cells), it is recommended to create the table as an external
table in a database.
The name cannot exist as a field or group name in the current or base ManuScript.
b. Enter the Data Names.
The Key Name identifies the data to be passed into the table.
b. In the Span list, click Row, Column, or Page.
The Span refers to the way you search for data in the table. You can search down the rows, across the columns, or across pages, which
appear as tabs in the display.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 9 of 31
9
Duck Creek Technologies
c. In the Search Type list, click the appropriate search type.
The Search Type defines the way to look up the data. The default method is =. Other options are >, <, >=, <=, Range Check,
Interpolated, and Graduated. For more information on search types, see Key Search Types.
d. In the Data Type list, click the appropriate data type.
Data types can be Boolean, Currency, Date, Datetime, Float, Int, String, or Time.
e. Enter the Key Values to be used in the table.
These are the values that can potentially be passed into the table by the lookup field.
f. Click OK.
4. Enter the table data.
You can enter the information directly into the table, or cut and paste it from a table in a different program, such as Microsoft Excel or
Microsoft Word.
You can manipulate the size of the cells in the table by dragging the cell borders.
After you build a table, you must create a lookup field to access the information from the table. For more information, see Lookup.
2. In the Get Group for this Table dialog box, click the group level for the table, and then click OK.
The group level for the table is important for conditional tables because the table checks the condition by looking for the value of the field at
the level where the table is placed.
3. Complete the Table Properties dialog box:
a. Enter a Name for the table.
The name cannot exist as a field or group name in the current ManuScript or a base ManuScript.
b. Enter the Data Names.
This causes the table to always execute, even if not called from a field.
e. Click OK.
The main Table pane displays cells in which you can define conditions. These cells default to 1, which indicates True and is used if no
condition must be met to retrieve the corresponding value from the table.
4. Edit the conditions for all condition cells.
a. Right-click the condition cell.
b. Click Edit Condition.
c. Use the Condition Builder dialog box to define the condition.
5. Enter data values into the cells of the table.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 10 of 31
10
Duck Creek Technologies
You can manipulate the size of the cells in the table by dragging the cell borders.
After you build a table, you must create a lookup field to access the information from the table. For more information, see Lookup.
The name cannot exist as a field or group name in the current or base ManuScript.
b. Enter the Data Names.
d. (Optional) Modify the value in the Separator dropdown list for the table.
e. Click OK.
The Key Name identifies the data to be passed into the table.
b. In the Span list, click Row, Column, or Page.
The Span refers to the way you search for data in the table. You can search down the rows, across the columns, or across pages, which
appear as tabs in the display.
c. In the Search Type list, click the appropriate search type.
The Search Type defines the way to look up the data. The default method is =. Other options are >, <, >=, <=, Range Check. For more
information on search types, see Key Search Types.
d. In the Data Type list, click the appropriate data type.
Data types can be Boolean, Currency, Date, Datetime, Float, Int, String, or Time.
e. Enter the Key Values to be used in the table.
These are the values that can potentially be passed into the table by the lookup field.
f. Click OK.
4. Enter the table data.
You can enter the information directly into the table, or cut and paste it from a table in a different program, such as Microsoft Excel or
Microsoft Word.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 11 of 31
11
Duck Creek Technologies
You can manipulate the size of the cells in the table by dragging the cell borders.
5. After you build a table, you must create a lookup field to access the information from the table. For more information, see Lookup.
2. In the Get Group for this Table dialog box, click the group level for the table, and then click OK.
3. Complete the Table Properties dialog box:
a. Enter a Name for the table.
The name cannot exist as a field or group name in the current ManuScript or a base ManuScript.
b. Enter the Data Names.
This causes the table to always execute, even if not called from a field.
e. Click OK.
4. In the External Source list, click ODBC Data Source.
5. (Optional) Select the Preview table check box to view a preview of the table information.
6. In the Table/View Name field, enter the table name.
7. In the Data Source field, enter the appropriate data source name, and then click Next.
8. Define the keys for the table:
a. Enter a Key Name.
b. In the Data Type list, click the appropriate data type.
c. In the Find list, click the method to find the key in the external table.
9. (Optional) Enter an External Name for each key.
10. (Optional) Select the Use Default check box and enter a default value for the table.
After you build a table, you must create a lookup field to access the information from the table. For more information, see Lookup.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 12 of 31
12
Duck Creek Technologies
Creating an External Table Using a Data Service
To add an external table in Author:
1. On the Edit menu, click New External Table.
2. In the Get Group for this table dialog box, click the group level for the table, and then click OK.
3. Complete the Table Properties dialog box:
a. Enter a Name for the table.
The name cannot exist as a field or group name in the current ManuScript or a base ManuScript.
b. Enter the Data Names.
You can enter one or more items to retrieve from the table.
c. (Optional) Enter the Class for the table.
This causes the table to always execute even if not called from a field.
e. Click OK.
4. In the External Source list, click Data Service.
5. In the Data Service list, click dataSet or dataKey.
6. (Optional) Click View Catalog to select a data service file, which will fill the Data Name and appropriate Key Name fields.
7. Enter the Data Name.
Click the Ellipsis button to use the Reference Select dialog box to select a field reference, or specify a value. The name entered here is
the source entered in the SELECT clause of the SQL query string passed to the ODBC driver.
8. Define the keys for the table. For each key:
a. Enter the Key Name.
b. Click the Data Type.
c. Click the method to Find the key in the external table.
d. (Optional) Enter the External Name.
After you build a table, you must create a lookup field to access the information from the table. For more information, see Lookup.
3. In the Confirm dialog box, click Yes to confirm Demote/Revert Table or No to cancel.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 13 of 31
13
Duck Creek Technologies
The contents of the table reverts to the original state.
The tables in the selected ManuScript are displayed in the Select the item(s) to import list.
5. Click the tables to import, and then click Next.
The tables you selected are listed. Tables that you selected in the previous display that already exist in the current ManuScript are not
selected for importing.
You can clear any element you do not want to import by clearing the check box. You can force the importation of an element you already have
in the current ManuScript by selecting an unselected check box or by clicking Select All.
6. Click Finish.
METHOD BENEFITS
Importing an External Table • Share existing data without creating new tables in Author
• Quick access to easily specified data within a spreadsheet
If the data being accessed is efficiently managed in an Excel spreadsheet, it is recommended that you create a table in Author to manage the
data more reliably.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 14 of 31
14
Duck Creek Technologies
Mapping XML to Import Excel Files
To map XML to import Excel files, server requests are coordinated and called from a ManuScript. Tables must be imported into fields or groups,
and columns must be collected.
To collect specific columns, create a public group named Mapping as a child of the Upload group.
1. For each column of data you wish to import, create another public group with the word Map prepended to the field name.
2. (Optional) Repeat step 1 for each column of data you wish to import.
3. (Optional) If this group represents data that will also have a value map section to match existing dropdown options, include
[@valueMap="1"] as part of the path attribute.
Each of these public groups has one field that describes the mapping of the field information to the column in the Excel spreadsheet using the
<ExcelImport.inferValueRq> request.
4. On the Column field, do the following:
Each of the data item fields must have the identical path value as the column name on the spreadsheet.
The first parameter for this request specifies the spreadsheet file name and location. The second parameter specifies the type of data in
this column of the spreadsheet. This request identifies which column of the spreadsheet to use for the import.
d. Add an Options setting of <ExcelImport.getColumnNamesRq> request with the following values:
▪ A response path columns/column
▪ Value item @name
▪ Caption item @caption.
This loads the data of the column whose name is in the Caption attribute of this field.
The Default value and the Caption value of the map field must be identical, and these values should also be identical to the
Caption value of the target data field.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 15 of 31
15
Duck Creek Technologies
i. Insert an Action and the following three requests:
▪ <ExcelImport.getcolumnnamesRq> request
▪ <ExcelImport.importvaluesRq> request
▪ <ExcelImport.importdataRq> request
j. Add a response path identifying where to put the data to the <ExcelImport.importdataRq> request.
k. Add the data fields specified in step f.
For the engine to access the tables through ODBC, you must define a data source on the machine that is performing the rating.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 16 of 31
16
Duck Creek Technologies
Using a DSN data source in the ManuScript is recommended to allow an abstraction layer between a named data source and the
actual location and name of the database.
To use a DSN data source, use the ODBC Data Source Administrator to setup a system or file-based DSN. The DSN connection is specified in a
data source file that is created using the ODBC Data Source Administrator tool (accessible from the Windows Start menu). The default path for
this tool is: Settings/Control Panel/Administrative Tools/Data Sources (ODBC). The user must specify a DSN connection, save the XML file, and
then point to the saved file location using the specified DSN connection. Because the process for creating a DSN connection varies depending on
the version of Windows used, click the Windows Help menu for assistance.
After creating the connection, test it to ensure that it makes a successful connection to the data source.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 17 of 31
17
Duck Creek Technologies
EDITING TABLES
Overview
In this section, you will learn how to delete or duplicate a table. You will also learn how to change the data entry method, insert or delete data
records, modify data in tables, and change the separator on table data. The method of data entry can be completed first down and then across, or
first across and then down.
Deleting a Table
To delete a table:
1. In the Tables list, right-click the table, and then click Delete.
2. In the Confirm dialog box, click Yes to confirm the deletion or No to cancel.
Duplicating a Table
To duplicate a table:
1. In the Tables list, click the table.
2. On the Edit menu, click Duplicate Table.
3. Click the Enter Down button or the Enter Across button to define the data entry method.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 18 of 31
18
Duck Creek Technologies
The new cell is empty and the current values are moved down in the table. If the table is full, the bottom value is lost.
The current values are moved up in the table and the last value is blank.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 19 of 31
19
Duck Creek Technologies
The maximum number of characters allowed is 100. Formatting is not available for comments.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 20 of 31
20
Duck Creek Technologies
SEARCH TYPES
Overview
This section provides information on search types within Tables view.
The comparative types search down a column until the comparison of the key value and the search value is true. The data type of the key is
important because the comparison treats the values in the key list according to data type, comparing numbers, strings, or dates. When the less-
than or greater-than types are used it is important to ensure the key value order make sense as a top-down search, from the most restrictive value
to the least restrictive value.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 21 of 31
21
Duck Creek Technologies
Range Check Search Types
The Range Check search type searches the key to find if the search value is in any part of the range specified by each key value. The Range
Check search type uses the hyphen (-) and the comma (,) to specify range values. A non-range key value can use either the less-than sign (<) or
greater-than sign (>) to indicate the search value can be either less than or equal to, or greater than or equal to, the key value. Any combination of
comma-delimited values and range values can be entered for each key item.
A hyphen indicates inclusive range (low to high) and a comma separates individual values. When both sides of a range phrase are numeric, the
range is checked numerically. When non-numeric values are specified as a range, the comparison is done alphabetically. Each comma-delimited
item is checked for enumeration using the same numeric or string logic. The following table provides examples of appropriate Range Check
syntax.
KEY VALUE
1-10000 10
10001-20000 22
20001-30000 35
[eachadd]5000 5
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 22 of 31
22
Duck Creek Technologies
amount, and must be smaller than the previous key value. The fact that the last key value is smaller than the previous value is the indicator to the
system that extrapolation is desired of higher values than the next to the last value.
The system automatically adds an asterisk (*) after each additional key values as an indicator.
The interpolation/extrapolation lookup works by searching the key values to find the two entries that are closest to the search value. If the two key
values are one lower and one higher, then the returned lookup value is the interpolated value of the associated data in the table of these two
keys. If the key is set up to extrapolate (has an each additional value) and the search value is greater than the largest key value, the returned
value is the extrapolated value.
The following table is defined with a single key with a search type of Interpolate.
KEY VALUE
0 10
20 15
30 20
40 25
50 30
60 35
70 40
80 45
10* 5
To prevent a lookup from returning a value with many decimal places, you can set a precision, which is the number of decimal places to round.
For example, if you set a precision of 2, the lookup returns a value that has only two decimal places (9.99). Interpolation precision is only valid for
table lookups that use the Interpolate search type.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 23 of 31
23
Duck Creek Technologies
that has the search type of Graduated. There can be other keys, but only one can be a Graduated key. The data in a Graduated table identifies a
base value as the first key value and then each ensuing key value identifies an additional amount as either a factor or additive value to apply to
the base. The returned lookup value is the cumulative total of all key values that apply to the search value.
• The Graduated search type uses a specific syntax for each key item that defines how the key is to be processed. The rules of the key values
for the Graduated type are separated into the first key value, the last key value and the interior key values:
• First key value — Identifies the base amount. The data associated with the first key is used as the starting value. The numeric value of the
first key defines the included amount, or the first threshold amount (for instance, the first 200 dollars). The syntax of the first key value is:
First IncludedValue
• Interior key values — Identify the graduated steps of the value. The data associated with these keys are the additive amounts that are
applied to the base amount. The numeric value of the interior keys identifies the increment amount (for instance, the next 100 dollars). Key
values can also be defined with an optional per amount by including a comma and the per amount. If there is no per amount, the entire data
value of the key is added to the base when the search value applies. If there is a per amount specified, the data value of the key is multiplied
by the fractional number of per amounts the search value requires, interpolating the per value.
The following table is defined with a single key with a search type of Graduated.
KEY VALUE
First 200 80
Next 100,25 12
Next 300,50 4
Excess, 100 5
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 24 of 31
24
Duck Creek Technologies
Overview
You can sort and select tables by their optional property Class. The Class allows you to enter a filter or grouping for tables. For example, you can
set Class=BaseRate for all tables that are Base Rates for premiums. BaseRate tables may then be displayed as a smaller list of tables. In this
section, you will learn how to select tables by Class.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 25 of 31
25
Duck Creek Technologies
Overview
You can view the ManuScript inheritance chain for tables in the current ManuScript in the Inheritance dialog box. In this section, you will learn how
to access the Inheritance (Data) dialog box from tables view.
You can access the Inheritance (Data) dialog box from Tables view in two ways:
• On the View menu, point to Inheritance, and then click Data.
• On the shortcut menu for Tables View, click View Inheritance (Data).
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 26 of 31
26
Duck Creek Technologies
Overview
Keys are the information a ManuScript passes into a table in order to find the appropriate data. In this section, you will learn how to add keys and
auto-fill, remove, and insert key values. You will also learn how to format keys for a caption and set default key values.
Adding a Key
Keys are used to define the structure of a table.
The Key Name identifies the data to be passed into the table.
b. In the Span list, click Row, Column, or Page.
The Span refers to the way you search for data in the table. You can search down the rows, across the columns, or across pages, which
appear as tabs in the display.
c. In the Search Type list, click the appropriate search type.
The Search Type defines the way you look up the data. The default method is =. Other options are >, <, >=, <=, Range Check,
Interpolated, and Graduated. For more information on search types, see Key Search Types.
d. In the Data Type list, click the appropriate data type.
Data types can be Boolean, Currency, Date, Datetime, Float, Int, String, or Time.
e. Enter the Key Values to be used in the table.
4. Click OK.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 27 of 31
27
Duck Creek Technologies
The Code Select dialog box appears.
3. Move the codes to use to the right column from the list of available codes on the left.
Click codes and use the arrow buttons to move them between boxes.
4. Click OK.
5. In the Key Properties dialog box, click OK.
If this check box is cleared, the numbers appear with only the first number of the range.
4. Click OK.
5. In the Key Properties dialog box, click OK.
3. Click OK.
The Modify Data dialog box appears.
Truncate data The data at the end of the columns/rows will be removed.
Delete data at key change The data at the point in the column/row where the key is different will be removed.
Delete data past key change The data one entry point past the point in the column/row where the key is different will be removed.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 28 of 31
28
Duck Creek Technologies
The Key Properties dialog box appears. A Caption Values column appears to the right of the Key Values
column.
In Author, the caption now appears in parentheses beside the key in Tables View, and Caption As shown below, captions are the displayed value
in lists in Express.
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 29 of 31
29
Duck Creek Technologies
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 30 of 31
30
Duck Creek Technologies
Supporting a Default Key Value
To support a default key:
• Type an asterisk (*) into the cell.
Key values set to * are valid for any key value being requested.
Another approach is to use the Range Check key search type, and then enter the starting and ending data as the range value (e.g.
2017-01-01 - 2017-06-12).
Copyright 2022 Duck Creek Technologies LLC. All Rights Reserved. solutioncenter.duckcreek.com 31 of 31
31