Creating Multi-Page Documents

Some complex objects are best represented as a series of linked objects and images. A book or similar document may be made up of pages, each page may be a separate object in the collection. The Multi-Page Document Tool enables Insight Administrators to create objects within Insight which contain multiple data records and images. More specifically, the Multi-Page Document Tool leverages the existing metadata which defines the structure of the document into a visual representation.
You can create multi-page documents in two ways: * Use the Multi-Page Template (to create multiple multi-page documents at one time)

• Use the Multi-Page Document Creation dialog (to create a single multi-page document).

NOTE: There are specific requirements to the structure of the Multi-Page Document. Each hierarchical section must be managed by a numeric field (to properly support grouping and sorting). h2. Sample Data for a Multi-Page Document
The example below shows the logic of how the following documents are to be compiled to create multiple Multi-Page Documents in Insight. This example will be referenced throughout the following section.

From the sample data above, three Multi-Page Documents will be created: Book A, Book B, and Book C. The books will be organized as follows:
• Book A:
Chapter 1, Section 1, page 1, (Object ID) 0001
Chapter 1, Section 1, page 2, (Object ID) 0002
Chapter 1, Section 1, page 3, (Object ID) 0003
• Book B:
Chapter 1, Section 1, page 1, (Object ID) 0040
Chapter 2, Section 1, page 2, (Object ID) 0041
• Book C:
Chapter 1, Section 1, page 2, (Object ID) 0060
Chapter 6, Section 1, page 25, (Object ID) 0070h2. Creating Multiple Multi-Page Documents Using Multi-Page Templates
To create a set of Multi-Page Documents in a collection using a Multi-Page Template:

1. Open the Administrator Tools and connect to the collection.
2. Open the Collection Settings node.
3. Right-click Multi-Page Document and select Create Multi-Page Template.Multi-Page Documents have a hierarchical structure, and each level field, such as Title, Level, or Page Order is unique. There is a maximum of seven levels. At least one level of definition is required in using the Multi-Page Document Template (definition should start from Level 1, then Level 2, etc.).The highest level, the Document ID Field, is the object itself (book, manuscript, and so forth). The lowest level is a page in a book. The page has to be defined in numeric terms (1, 2, 5, 8) and not in text or roman numerals (one, five, iv, iii) format. You can specify a minimum number of pages to generate a Multi-Page Document from an entire book or manuscript. The default is ten pages.
4. Select a collection from the pull-down list.
5. Select a Document ID Field. All Fields defined in the collection will appear in the selection pull-down list. All records containing common values in this field will be grouped together as a Multi-Page Document.
6. Next to each Level Number, provide a Level Name. The Level Name explains the hierarchical level. For example, level 1 can be Plays, level 2 can be Acts, level 3 can be Scenes.
7. For each Level Name, select a Level Field. Only numeric fields will be presented in the dropdown list.
8. Enter Minimum Page Count. You can specify a minimum number of pages to generate a Multi-Page Document. The default is ten pages. A book cannot be created as a Multi-Page Document if it has less than the minimum number of pages specified in the Minimum Page Count Field. For example, if the minimum pages is set to 99, then a book with 87 pages will not be created as a Multi-Page Document. Only books with 99 pages or more will be created as Multi-Page Documents.
9. In order to reset the Multi-Page Document Template counter to zero and to create new Multi-Page Documents as specified, check or enable the checkbox that states, "Remove all existing entries and create new documents."
10. Press Create Documents to generate document entries into the collection's document database.
11. Once you have created your Multi-Page Document Template(s) you must run the indexer with the Multi-Page Document option enabled. For more information, see Running the Indexer for Fuzzy Date or Multi-page Document Indexing on page .

Creating a Single Multi-Page Document

The administrator will use the Administrator Tools within Insight Collection Manager to create Multi-Page Documents. Follow the steps below to create a single Multi-Page Document.

1. To invoke the Multi-Page Document options, open the Collection Manager node in Administrator Tools.
2. Right-click on Multi-Page Document and select New. The Multi-Page Document Creation window appears.
3. In the Multi-Page Document Creation panel, create a document name that you want to display in Insight which reflects your record structure, for example, "W. Shakespeare Portfolio of Plays."
4. Next to the Level Number, provide a level name. The level number determines the order of the records that you will provide (number 1 being the highest level). The Level Name should be indicative of those areas or various levels that make up the document. In the example above, we've used Chapter, Section, and Page.
5. Select a Level Field. The level fields should correspond to the numeric field in your data record with information on where each page should be placed within the hierarchy.
6. Select a collection. This is pre-loaded by you (Administrator).
7. Select a Document ID Field. This is based on the collection that is loaded on your system. Use a value from the highest level for this selection.
8. Provide a Document ID Value. This is based on the value of your Document ID Field. This can be a title, author for a group of contents, or even an ISBN number. For example, it can be William Shakespeare or it can be ISBN: 0-395-74876-3.
9. Press Save.
10. Once you have created your Multi-Page Document(s) you must run the indexer with the Multi-Page Document option enabled. For more, see "Running the Indexer for Fuzzy Date or Multi-page Document Indexing" on page .

Managing the Stop List

A stop list is a set of words that are not indexed – generally used to eliminate words that appear too universally to be of value in searching. Insight's default list includes:
Table 3: Default values for Insight Stop List

To add new terms to Insight's Stop List:

1. Open the Administrator Tools and connect to your Collection Manager.
2. Open the Server Settings node.
3. Right-click on the "Stop List" Entry and choose "new…"
4. Enter the term you would like to add to the stop list in the dialog box:
5. Press Save to add the term to the list.

Configuring the Insight Measurement Tool

The Measurement Tool allows insight to display images actual size in the Image Workspace, or allows comparison of images, displaying them in their relative sizes.
In order to use this tool, you must have numeric fields in your data for Height and Width values. Insight generates default values for measurement fields when creating a new collection and these default values are made accessible to the Measurement Tool.
Depending on your data, the measurement tool provides two basic configurations:

1. Where data for Height and Width are stored in different fields.

1. Where one field may be used for either Height or Width, and another field is needed to tell which dimension the number represents.

To set up the Measurement Tool in Insight:

1. Open Administrator Tools and Connect to the Collection Manager.
2. Open the Collection Settings Node and open the node for your collection.
3. Click on the "Measurement Tool" node.
4. Right-click on the entry in the table to the right of the tree and select Edit from the pop-up menu. The Measurement Tool window appears:
   
5. Select a width field, height field, and define a metric from the pull-down list. When selecting the width and height fields, make sure you are only selecting numeric fields and not text fields.

1. 1. To configure the Measurement Tool where both height and width data is stored within the same field.
      1. Select the same numeric field for both Width Field and Height Field. This field contains the measurement.
      2. Set both Width Qualifier Field and Height Qualifier Field to the field which specifies whether the numeric value is a height or width.
      3. Set the Width Qualifier Value and Height Qualifier Value to the values which should be matched for height and width. (common values may be "width", "height", "w", or "h").
      4. If you have a field which specifies the dimension unit, (i.e. whether a given value is in inches, centimeters, meters, or another dimension, then specify that field in Width Metric and Height Metric).

1. 1. 1. Continue with steps "c" and "d" below.
   2. To configure the Measurement Tool where the height and width data are stored in different fields.
      1. Set the Width Field to the data field which contains the numeric width data.
      2. Set the Height Field to the data field which contains the numeric height data.
      3. If you have a field which specifies the dimension unit, (i.e. whether a given value is in inches, centimeters, meters, or another dimension, then specify that field in Width Metric and Height Metric).
   3. Specify the preferred measurement unit in Metric.
   4. If you have entries with multiple unit types, (i.e. some records with widths in centimeters, some in inches) you can specify a metric map which will convert values from the unit field into the preferred unit type.

To construct a unit value map:

1. 1. 1. Identify all of the various conventions for specifying units (i.e. inches, in., cm., etc.).
      2. Construct a string with your mappings where specific values are separated by commas, and mapped to the numeric value for a unit in the pull-down by number. Separate different units with a semi-colon:

in,inch,inches=2;cm,centimeters,centimeters=4 …
(In this example, in, inch, and inches are mapped to value 2 in the pull-down.)

1. 1. 1. Enter the unit value map into the Metric Name Map field.
2. When you have completed your settings, click Save.

To test your configuration for the measurement tool

1. Start the Insight Java Client.
2. Double-click on an image in the Group Workspace to add it to the Image Workspace.
3. In the Image Workspace, open the Measurement and Scaling Tool from the Image Workspace Toolbar.
4. If measurement values are not displayed as expected, review your configuration in the Administrator Tools.