Smeadlink Administrator`s Guide

Transcription

Smeadlink Administrator`s Guide
Contents
System Administrator's Guide
i
ii
Contents
No part of this document may be reproduced or transmitted in any form or by any
means, electronic or mechanical, for any purpose, without prior written permission from Records Management Automation Group, LLC (RMAG). The information in this document and the product it describes are subject to change without
notice. Companies, names and data used in examples herein are fictitious unless
otherwise noted. The software program described in this document is provided to
its users pursuant to a license or nondisclosure agreement. Such software program may only be used, copied or reproduced pursuant to the terms of such agreement. This manual does not contain or represent any commitment of any kind on
the part of RMAG.
© 2002 Records Management Automation Group, LLC. All rights reserved.
Smeadlink is a trademark of Smead Manufacturing Company.
Other products and company names herein may be the trademarks of their respective owners.
Printed and bound in the United States of America.
iii
Contents
Smeadlink System
Administrator's Guide
Contents
Read Me First! .............................................................................. 1
Introduction .................................................................................... 1
1. Introduction to Smeadlink ......................................................... 5
Administrative Utilities .............................................................. 5
Introduction ..............................................................................6
About Your Smeadlink System .................................................7
New Features in Smeadlink .......................................................8
Smeadlink Administrative Utilities ............................................9
2. Opening a Smeadlink Program ............................................... 31
Introduction ............................................................................ 32
Opening a Smeadlink Program ................................................ 33
Using Smeadlink General Options .......................................... 40
Opening an Add-In from a Smeadlink Program ....................... 44
Using Smeadlink Help ............................................................. 45
Viewing Version and Registration Information ....................... 47
Exiting a Smeadlink Program ................................................... 48
3. Introduction to Security Manager .......................................... 49
Introduction ............................................................................ 50
Basic Security Manager Terms ............................................... 51
Basic Security Manager Concepts ......................................... 52
4. Using Security Manager ......................................................... 59
Introduction ............................................................................ 60
Creating a Group ..................................................................... 61
Creating an Operator .............................................................. 63
Assigning Operators to Groups ............................................. 66
Removing a Group or Operator ............................................... 70
Using Network Security .......................................................... 71
Assigning Access Rights for the Groups in a Database ........ 73
iv
Contents
Printing, Exporting and Resizing the Rows in a View .............. 80
5. Using Import Wizard ................................................................ 81
Introduction ............................................................................ 82
Creating an Import for a Delimited Text File ............................ 83
Creating an Import for a Fixed Width Text File ........................ 91
Creating an Import for an Excel Object ................................. 100
Creating an Import for an Access Table ................................ 108
Setting up an Import for Importing Images ........................... 116
Creating an Import for the Denso Portable Scanner ............. 117
Modifying an Import ............................................................ 124
Creating an Import Job ......................................................... 125
Modifying an Import Job ...................................................... 127
Removing an Import or an Import Job .................................. 130
Running an Import or an Import Job ..................................... 131
6. Introduction to Directory Settings ........................................ 133
Introduction .......................................................................... 134
Directory Settings Terms ...................................................... 135
Directory Settings Concepts ................................................ 137
7. Using Directory Settings ....................................................... 141
Introduction .......................................................................... 142
Creating a Path for a Magnetic Storage Device .................... 143
Creating a Path for an Optical Storage Device ...................... 148
Creating Multiple Paths Using Shared Components ............ 154
8. Introduction to Database Map .............................................. 149
Introduction .......................................................................... 150
Basic Database Map Terms .................................................. 151
Basic Database Map Concepts ............................................ 152
9. Using Database Map ............................................................. 161
Introduction .......................................................................... 162
Working with the Database Map Tree Diagram .................... 163
Creating a Workgroup .......................................................... 167
Creating a Folder .................................................................. 170
Creating a Subfolder ............................................................. 175
Creating a Dropdown ........................................................... 178
Working with Foreign Tables ............................................... 182
Using the Field Maintenance Utility ..................................... 187
Modifying Existing Items in a Database ............................... 191
Modifying the Bar Code Search Order for the Open Database201
10. Introduction to Label Manager ........................................... 205
Introduction .......................................................................... 206
Basic Label Manager Terms .................................................. 207
Basic Label Manager Concepts ............................................ 208
Contents
v
11. Using Label Manager .......................................................... 209
Introduction .......................................................................... 210
Creating a New Label Design ............................................... 211
Creating Text Objects on a Label Design .............................. 215
Creating Bar Code Objects on a Label Design ...................... 217
Creating Field Objects on a Label Design ............................. 221
Deleting a Label Design ........................................................ 224
12. Introduction to ColorBar Label Integrator ......................... 225
Introduction .......................................................................... 226
Basic Terms for ColorBar Label Integrator ............................ 227
Basic Concepts for ColorBar Label Integrator ...................... 229
Requirements for ColorBar Label Integrator ......................... 233
13. Using ColorBar Label Integrator ........................................ 235
Creating a New Job ............................................................... 237
Modifying an Existing Job .................................................... 243
Removing an Existing Job ..................................................... 246
14. Using Data Director ............................................................ 247
Introduction .......................................................................... 248
Data Director Concepts ........................................................ 249
Creating a Format ................................................................. 251
Running a Format ................................................................. 257
15. Using Smeadlink's Administrative Utilities I ...................... 259
Introduction .......................................................................... 260
Opening the Views Utility ..................................................... 261
Saving a View ....................................................................... 262
Adjusting the View Order ..................................................... 263
Deleting a View ..................................................................... 265
Modifying the Properties of a View ...................................... 266
Opening the Columns Utility ................................................ 267
Creating a Column in a View ................................................. 268
Deleting a Column from a View ............................................. 273
Modifying the Properties of a Column in a View .................. 274
16. Using Smeadlink's Administrative Utilities II .................... 279
Introduction .......................................................................... 280
Creating an Add-In ............................................................... 281
Deleting an Add-In ............................................................... 285
Modifying an Add-In ........................................................... 286
Report Generator Concepts .................................................. 288
Steps to Creating a Formatted Report ................................... 292
Using the Column Print Properties Window ......................... 294
Using the Report Setup Window .......................................... 299
Using the Report Styles Window ......................................... 308
Opening the Report Styles Window ..................................... 309
vi
Contents
17. Directly Modifying a Smeadlink Database ........................ 323
Introduction .......................................................................... 324
Opening a Table .................................................................... 325
Executing a Script File ........................................................... 326
Executing a Single SQL Statement ........................................ 328
Compacting and Repairing a Database ................................. 329
Demonstration and Template Databases .............................. 332
Appendix A: Smeadlink System Requirements ....................... 333
Appendix B: Smeadlink User Counting .................................... 334
Read Me First!
Welcome to the Smeadlink System Administrator guide. This guide will show
you how to use all the administrative utilities in your Smeadlink system. The
first chapter introduces you to the different Smeadlink administrative utilities, and the second chapter explains how to open a Smeadlink program.
The remaining chapters in this guide are divided into sections of one or two
chapters each, and each section explains how to use an administrative utility. Utilities that are simpler to use are explained in one-chapter sections,
and utilities that are more complicated are explained in two-chapter sections.
In the sections that contain two chapters, the first chapter explains basic
concepts about the utility, and the second chapter explains how to use it. If
you are not familiar with the utility, then reading the first chapter in the
section will give you a basic understanding of what it looks like, what tasks
it is intended for and how it accomplishes those tasks. If you are already
familiar with the utility you need to use, then going straight to the second
chapter in the section will take you to the step-by-step instructions for using
it.
Introduction
1
Introduction
Welcome to Smeadlink
Welcome to Smeadlink, a complete 32-Bit modular software system for managing both paper and electronic documents. This Introduction explains the
basic information you might want to know before learning how to use
Smeadlink, such as:
• the scope of each Smeadlink manual
• installing Smeadlink
• upgrading Smeadlink in the future
• customizing Smeadlink
• Smeadlink training
• Smeadlink contact information
Note: This introduction is very similar to the introduction in the User's
Guide, because the information covered is general information that applies
to both administrators and end-users. The information is included in both
manuals so that you do not have to flip back and fourth between them. If you
have already read the introduction in the User's Guide, you may just want
to skip this introduction and go straight to chapter 1.
The Scope of each Smeadlink Manual
Your Smeadlink system comes with two manuals. This manual that you are
reading is called the System Administrator's Guide, and it is intended for the
administrator of your Smeadlink system. The second manual is called the
User's Guide, and it is intended for end users.
There are three user names that are frequently used to access Smeadlink
systems: Guest, Editor and Manager. These names give three degrees of user
access to the programs in the system. Guest allows you to view a Smeadlink
program’s main contents and make nonpermanent changes to the program,
Editor allows you to edit tables or rows in the program and Manager allows
you to make permanent changes to the program’s appearance or default settings.
Introduction
2
The purpose of the User's Guide is to explain how to use the modules and
features that are available in Smeadlink when you log in with the standard
Guest or Editor user names. This includes everything a typical user will use
in Smeadlink. The User's Guide assumes that you have a basic knowledge of
Windows®-based programs, but it does not assume that you have any prior
knowledge of records management software.
The purpose of this manual is to explain how to use the administrative utilities that are available in Smeadlink when you log in with the standard
Manager user name. This includes all the tools needed for setup, maintenance and repair of your Smeadlink system. This manual assumes that you
have a basic knowledge of Windows-based programs and networking, but
it does not assume that you have any prior knowledge of records management software.
Installing Smeadlink
This manual and the User's Guide both assume that your Smeadlink system
has already been correctly installed. Smeadlink systems are typically installed by Smeadlink dealers. The dealer who installs your system should be
the one who sold you the system, and who worked with you to design and
build the database that your system will use.
In some cases, Smeadlink systems are installed by RMAG Services Development Representatives (SDR's). This usually occurs when a customer has
RMAG Professional Services design and build a database for them, instead
of having the database done by the dealer.
Upgrading Smeadlink in the Future
Every Smeadlink system sold comes with a maintenance contract. The contract describes how much support the customer can receive from the dealer
or RMAG Professional Services, and it describes how long the customer will
be entitled to free version upgrades. The actual terms of your contract will
depend on which dealer you purchased your system from, and which terms
you agreed on with the dealer.
Introduction
3
When a new version of Smeadlink is released, all customers with current
maintenance contracts will be sent a free upgrade package. The package will
include a CD with the new Smeadlink program (.exe file) on it, manuals expanded to include the latest features in the new version, and any white
papers necessary to explain specific setup issues or system requirements for
the new version. The customer can then either install the upgrade themselves using the white papers as a guide, or they can have the upgrade
professionally installed. Professional installation is available from both dealers and Smead Software Support.
In addition to upgrading to new versions as they are released, you may also
want to expand the capabilities of your existing system by adding one or
more new modules. For instance, you may originally purchase Smeadlink for
bar code tracking, but later on decide you would like to use it for imaging as
well. In this case, you would need to add the Imaging module to your existing
Smeadlink system. If you do decide to add one or more modules, then you
can purchase the additional modules through your dealer at any time.
Smeadlink Training
To get the most out of their Smeadlink system, many companies purchase
professional training for their employees who will be using Smeadlink on a
regular basis. Professional training is currently offered by authorized resellers
and by Smead Software Support, and it explains how to use both the enduser features and the administrative features in Smeadlink. For more information about Smeadlink training, contact your dealer or Smead Software
Support at (800) 800-6131.
Introduction
4
Smeadlink Contact Information
Technical Support
To obtain technical support for your Smeadlink system, contact your authorized Smeadlink reseller. For information about resellers in your area, call
Phone: (800) 800-6131
Sales Information
If you are interested in sales information about Smeadlink, Smead Sales can
be contacted by phone or email. The phone number and email address for
Smead Sales are both listed below.
Phone: (800) 216-3832
Email: [email protected]
On the Web
Once your Smeadlink system is installed, the latest version of each Smeadlink
program can be downloaded from the Smeadlink Web site shown below.
Website: www.smeadlink.com
Introduction to Smeadlink Administrative Utilities
1. Introduction to Smeadlink
Administrative Utilities
Chapter contents
Introduction
About Your Smeadlink System
New Features in Smeadlink
Smeadlink Administrative Utilities
5
Chapter 1
6
Introduction
Every Smeadlink system comes with a number of administrative utilities.
Some of these utilities are separate programs, and some of them are additional components that become available in end-user programs when you log
in with the standard Manager user name. These administrative utilities allow
you to set up and maintain a Smeadlink system—there is no longer any need
to use an external program such as Microsoft® Access to perform setup and
maintenance tasks.
This chapter will introduce you to Smeadlink in general and to the administrative utilities in your Smeadlink system. The first section explains all the
basic components that make up a Smeadlink system, and the second section
explains the new features that were added to Smeadlink in the latest version.
The last section includes a brief summary of each administrative utility in
Smeadlink. By the end of this chapter, you should have a good basic idea
about what administrative utilities are included with each Smeadlink system,
and how they work together with the other components in Smeadlink.
Once you have been introduced to Smeadlink and its administrative utilities
in this chapter, then chapter 2 will show you how to open Smeadlink. You
will learn the general procedure that can be used to open any Smeadlink
program, including both end-user programs and administrative utilities. Chapter 2 will also explain some general features that all Smeadlink programs
have in common. For instance, you will learn how to set Smeadlink general
options, which can be used to remember information about previous
Smeadlink sessions.
After you finish chapter 2, you will know how to open any Smeadlink program. The remaining chapters in this manual are divided into sections of
one or two chapters each, and each section explains how to use an administrative utility. Utilities that are simpler to use are explained in one-chapter
sections, and utilities that are more complicated are explained in two-chapter sections.
In the sections that contain two chapters, the first chapter explains basic
concepts about the utility, and the second chapter explains how to use it. If
you are not familiar with the utility, then reading the first chapter in the
section will give you a basic understanding of what it looks like, what tasks
it is intended for and how it accomplishes those tasks. If you are already
familiar with the utility you need to use, then going straight to the second
chapter in the section will take you to the step-by-step instructions for using
it.
Introduction to Smeadlink Administrative Utilities
7
About Your Smeadlink System
Note: This section is identical to the section About Your Smeadlink System
in chapter 1 of the User's Guide. The information is included here because it
applies to administrators as well as end-users. If you have already read the
section About Your Smeadlink System in the User's Guide, then you may
want to skip this section.
Smeadlink is a complete 32-Bit modular software system for managing both
electronic and paper documents. The main module in Smeadlink is a powerful database browsing program. Smeadlink uses an intuitive system to organize rows of data and display them in a way that is both informative and easy
to use. You can add additional modules to your Smeadlink system to enhance its functionality and give it the features that best fit your application.
Each Smeadlink system includes a start-up screen, a database, any optional
modules to enhance the Smeadlink's functionality, and a number of administrative utilities. The start-up screen is the central hub of your Smeadlink
system. It is the tool you will use to locate and view data. All data that is
specific to your Smeadlink application is contained in a file called a database. In order to view data in the start-up screen or other Smeadlink programs, you will need to open the database that contains the data you wish to
view.
To enhance the capabilities of Smeadlink, systems usually include one or
more optional modules. Unlike the start-up screen module, which only includes the one module, these optional modules include several components
each. The first component in each optional module is a separate program for
data input. The remaining components are add-on utilities for Smeadlink
that allow you to view data that was input with the first component. For
instance, the Smeadlink Imaging module includes the Scanner program and
an image viewer for the start-up screen. The Scanner program allows you to
scan images of paper or electronic documents into Smeadlink, and the image
viewer allows you to view the scanned images in Smeadlink.
Note: The start-up screen and the other end-user modules can be accessed
with the standard Guest and Editor user names, so they are not explained in
this manual. For more information about them, see the User's Guide.
Finally, each Smeadlink system includes a number of administrative utilities. Together, these utilities allow you to perform setup and maintenance on
your Smeadlink system. For instance, the Security Manager utility allows
you to create the user names and passwords that can be used to access your
system, and the Database Toolkit utility allows you to repair your database
if it becomes corrupted.
Chapter 1
8
New Features in Smeadlink
Note: This section is identical to the section New Features in Smeadlink in
chapter 1 of the User's Guide. The information is included here because it
applies to administrators as well as end-users. If you have already read the
section New Features in Smeadlink in the User's Guide, then you may want
to skip this section and go to the next section in this chapter.
This version of Smeadlink contains enhancements to the user interface and
additional options designed to make Smeadlink even more effective and
efficient for users in the document management industry. The new features
are summarized below:
• Enhanced records management
• Additional indexing and tracking abilities
• Streamlined user interface
New enhancements have been implemented to simplify requesting documents, streamline retention of legal documents, and assist with bar code
tracking. Other tools now part of Smeadlink make it even easier to manage
documents electronically. These new tools include enhanced integration of
Microsoft and email documents into Smeadlink. Other special tools such as
iAccess and iPublish enable users to easily and quickly create customized
HTML pages and web-based documents.
Smeadlink now offers more options to index images, request files and track
both electronic and printed records. In addition, bar code tracking enhancements build in flexibility to add memos, fields, and even drop down menus.
Smeadlink's enhanced user interface has been designed to be intuitive, allowing even a first-time user to start working with Smeadlink's various modules immediately. The main screen is divided into three sections; a "Find"
screen for quick searches, a clickable listing of the records management
workgroups, and the active work screen, with a menu of document management options.
Another obvious enhancement to the Smeadlink program is the updated and
streamlined main screen. The tool bar at the top of the screen has been simplified, and the screen now features a smaller menu bar for workgroup use.
Users will now be able to request files, transfer files and perform a variety of
functions using the new menu bar.
Introduction to Smeadlink Administrative Utilities
9
Smeadlink Administrative Utilities
As you learned earlier, your Smeadlink system comes with a number of
administrative utilities in addition to a database and the end-user modules
you have purchased. Some of these utilities are separate programs, and some
of them are additional components that become available in end-user programs when you log in with the standard Manager user name. These administrative utilities allow you to set up and maintain a Smeadlink system—
there is no longer any need to use an external program such as Microsoft
Access to perform setup and maintenance tasks.
There are thirteen administrative utilities currently available in Smeadlink.
Each Smeadlink system includes all thirteen utilities, regardless of which
end-user modules it comes with. The table below contains a brief description of each administrative utility in your Smeadlink system. The rest of this
section then includes a one or two page summary of each Smeadlink administrative utility. The summaries explain what each utility does, and how it
works with the other components in your Smeadlink system.
Administrative utility
Description
Security Manager
• create groups and operators for the
open Smeadlink database.
• assign operators to groups.
• assign access rights for groups.
Import Wizard
• import various types of data into the
open Smeadlink database, including
text files, images, Excel® objects,
Access® tables and ERM data.
Data Director
• automatically capture label data sent
from an external program and
import it into a Smeadlink table.
• if desired, print the captured label
data out on one of the existing label
designs for the table.
Directory Settings
• specify image output directories,
which are used to store image data
for the open Smeadlink database.
continued on the following page
Chapter 1
10
Database Map
• view and modify the table relationships in a Smeadlink database.
• add or remove fields to the tables in
a database.
Label Manager
• create label designs for printing
black-and-white labels.
ColorBar® Label Integrator
• integrate existing ColorBar label
designs with the tables in the open
Smeadlink database.
Smeadlink Columns Utility
• add, edit or remove columns from
the views in the open Smeadlink
database.
Smeadlink Views Utility
• add, edit or remove views from the
folders in the open Smeadlink
database.
Smeadlink Add-Ins Utility
• add, edit or remove add-ins from the
open Smeadlink database.
Smeadlink Report Generator Utility
• add, edit or remove a formatted
Database Toolkit
• provides direct access to all the
report from each view in the open
Smeadlink database.
tables in the open Smeadlink
database.
• allows you to directly modify the
open Smeadlink database by
executing single or multiple SQL
statements.
Database Compact and Repair
Utility
• compact and repair existing
Smeadlink databases
• update Smeadlink databases to
newer versions of Access.
• create backups of Smeadlink
databases.
Introduction to Smeadlink Administrative Utilities
11
Security Manager
Security Manager is a program that allows you to assign access rights for
your Smeadlink system. Each time a user opens your Smeadlink system,
they will need to log in to a database with a user name and a corresponding
password. The user name and password determine what components in the
database that user will have access to. For instance, if someone logs into a
Smeadlink database with the standard Editor user name and password, they
will have access to the Tracking program but they will not have access to the
Import Wizard program.
Security Manager allows you to create the different user names and passwords that can be used to access your Smeadlink database. Each user name
and the corresponding password are treated in Security Manager as one object called an operator. The first step in assigning access rights for a database is creating all the operators that will be able to access the database.
After you use Security Manager to create the different operators, the next
step is to divide all the operators into different groups. You can then specify
exactly which components in your Smeadlink database each group of operators can access. The example below shows what the Security Manager program looks like.
Security Manager program
Each Smeadlink database comes with three default operators: Guest, Editor
and Manager. These three operators are divided into three groups: Everyone
Group, Editor Group and Administrator Group. By default, the Everyone
Group includes the Guest, Editor and Manager operators, the Editor Group
contains the Editor and Manager operators and the Administrator Group includes the Manager operator.
Chapter 1
12
The three default groups come set up with the following security levels.
• The operators in the Everyone group allow you to open any end-user
program in your Smeadlink system, and make nonpermanent changes
to the program such as filtering columns.
• The operators in the Editor group allow you to open any end-user
program in your Smeadlink system, and edit tables or rows in the program.
• Finally, the operator in the Manager group allow you to open any enduser program or administrative utility in your Smeadlink system, and
make temporary or permanent changes to the program.
After you have created the operators and groups for your Smeadlink system,
you can specify which Smeadlink components each group has access to.
Security Manager displays all the components in your Smeadlink system
using a number of views, or grids. Each view contains a group of related
components. For instance, the Tables view contains a list of all the tables in
the open Smeadlink database. The example below shows what the Tables
view looks like.
Tables view in Security Manager
You can go through each component in each view, and specify which group
has access to that component. If you want every Smeadlink operator to have
access to a component, regardless of which group they are assigned to, then
you can set the component to No Security. When you are finished going
through the Security Manager views in this way, you will have specified
exactly which Smeadlink components each one of your groups can access.
Introduction to Smeadlink Administrative Utilities
13
Import Wizard
Import Wizard is a program that allows you to import various types of data
into a Smeadlink database. You can use Import Wizard to import text files,
Excel objects or Access tables into your database. You can also use special
kinds of text files to import images or tracking data from a portable scanner
(like the Denso BHT-6000) into a Smeadlink database. The example below
shows what the main Import Wizard window looks like.
Import Wizard window
The first step in using Import Wizard is to create an import load. An import
load is similar to a Scanner rule—it is a group of settings that determines
things like which file to import data from and which folder or subfolder to
import data into.
The process for creating an import load varies somewhat according to what
type of file you are creating the import for. For instance, if you are creating
an import load for a delimited text file you will need to specify what type of
character is used as a delimiter, but if you are creating an import load for a
fixed width text file you will need to manually divide the data in the file into
columns. After you specify the type of file you are creating an import load
for, Import Wizard will walk you through the appropriate process for that
type of file.
Chapter 1
14
Once you have created an import load with Import Wizard, then you will be
able to run it and import the selected data into Smeadlink. After your import
load has been run, Import Wizard will create a status report. The status report will display basic information about the import load, such as how many
rows were added to the destination folder or subfolder and how many errors
were generated during the process. The example below shows what an Import Wizard status report looks like.
Import Wizard status report
If any errors were generated when your import load was run, then they will
be written to an error log. You can view the error log after the import load
finishes, to determine exactly what errors occurred and how to solve them.
In addition to creating imports loads, Import Wizard also allows you to create import jobs. A job is a group of import loads. When you run a job, its
import loads are automatically executed in the order they were added to the
job. The capability to group import loads into jobs was added to Import
Wizard to streamline the import process when you need to run multiple import loads. Previously, you would have needed to run the first import load,
wait for it to finish, run the second import load, wait for it to finish, run the
third import load, etc. Now you can simply group the import loads into a job
and run the job.
When you run an import job, Import Wizard creates a status report and an
error log, just like it does for a standard import. Both the status report and
the error log will be divided into sections, one for each import load in the
job. Apart from the expanded status report and error log, running a job is
just like running an import load.
Introduction to Smeadlink Administrative Utilities
15
Directory Settings
Directory Settings is a program that allows you to specify which directories
on your computer can be used by Smeadlink programs for storing image
files. Image files can be either document images created in the Scanner or
PC Files programs, or ERM files created in the Import Wizard program.
Smeadlink programs do not store image files in your Smeadlink database.
They store them in designated directories elsewhere on your computer. Directory Settings is the utility for designating which directories on your computer can be used for storing image files. The example below shows what
the Directory Settings program looks like.
Directory Settings program
When you want to designate a directory for storing image files (this is called
an image output directory), you use the Directory Settings program to create
a path that points to that directory on your computer. Once the path has been
created, it will become available to other Smeadlink programs. Now when
you are using a Smeadlink program that works with image files, like the
Scanner program or the Import Wizard program, you can set the image output directory for that program using the path you created in Directory Settings.
The paths that you create in Directory Settings are made up of three components: a devices component, a volumes component and a directories component. Each path that you create in Directory Settings must include all three
components, but the way you break the path into components is completely
up to you.
16
Chapter 1
For instance, say you were setting up the Smeadlink Scanner program, and
you wanted the Scanner to save all the images it scans to the C:\sdlk\images1
directory on your computer. You could create a new path in Directory Settings, and then set C: as the devices component for the new path, \sdlk as the
volumes component and \images1 as the volumes component.
You could also set C:\sdlk as the devices component, \images1 as the volumes component and a dummy entry as the directories component. (A dummy
entry is an entry that only has a name and an ID number — it does not include any path information.) Basically, as long as the path information is
contained in at least one of the three components, you are free to enter the
path as you wish. This flexibility allows Directory Settings to model a wide
variety of directory structures.
The paths that you can create in Directory Settings are all paths for magnetic
storage devices. A magnetic device is a standard hard drive. This could either be the hard drive on your computer, or the hard drive in a server that is
part of your computer network. When you create a path in Directory Settings for a magnetic storage device, you specify the exact directory on the
device that you want to use for storing image files. The C:\sdlk\images1
example in the paragraph above is a path for a magnetic storage device.
Note: Directory Settings is a mapping utility only—it does not allow you to
create or remove directories from your computer. If you need to alter the
actual directory structure on your computer, you can use Windows Explorer®
or DOS.
Introduction to Smeadlink Administrative Utilities
17
Database Map
Database Map is a program that allows you to view and modify the table
relationships in a Smeadlink database. It displays all the workgroups, folders, subfolders and dropdowns in a database using a tree diagram similar to
Windows Explorer. Clicking on any item in the Database Map's tree diagram will bring up a popup menu that allows you to change the properties of
the item, delete it entirely or add a new item below it. You can also use the
popup menu to adjust things like the name of the item or the icon it uses. The
example below shows what the Database Map tree diagram looks like.
Database Map tree diagram
The first item in the Database Map's tree diagram is the name of the open
Smeadlink database. In the example above, the name of the open Smeadlink
database is Basic Demo. The workgroups in the open Smeadlink database
are then listed in the tree diagram immediately beneath the database item.
The Basic Demo database in the example above contains three workgroups
called Records, Tracking and Test Set.
The Records and Tracking workgroups in the example are in a fully expanded state. This means that all of the folders, subfolders and dropdowns
contained in these workgroups are visible in the Database Map's tree diagram. The Test Set workgroup, on the other hand, is in a fully collapsed
state. This means that none of the folders, subfolders and dropdowns contained in this workgroup are visible in the tree diagram. You can expand or
collapse an item in the Database Map's tree diagram just like you do in
Windows Explorer—by placing the mouse pointer over the item and doubleclicking the left mouse button, and you can also expand or collapse an item
automatically using the commands on the Database Map's View menu.
18
Chapter 1
When you place the mouse pointer over an item in the tree diagram and click
the right mouse button once, one of several popup menus will appear. As you
learned earlier, these popup menus contain commands that you can use to
modify the selected item. For instance, you can use the commands to rename
an item or to change the icon that it uses. In addition to modifying the selected item in the tree diagram, however, you can also use the popup menus
to create a new item beneath the selected item. For instance, if you opened a
popup menu from a workgroup item, you could use it to create a new folder in
that workgroup.
Typically, the Database Map program is used for making minor changes to
an existing database. For instance, you could use it to quickly change the
background color of a folder or to add a new folder to an existing workgroup. However, you could also open an empty database in the Database
Map program and build up multiple workgroups, folders, subfolders and
dropdowns in the database.
Database Map has been expanded in Smeadlink to work with foreign tables
created outside of Smeadlink). You can now connect a Smeadlink database
to one or more external databases. Once you have connected to an external
database, you can register any table in that database with Smeadlink. The
foreign table (or tables) will then behave just like a regular Smeadlink table,
and you will be able to use it to create folders or subfolders in the open
Smeadlink database.
Some foreign tables are already located in a Smeadlink database, but they
are not visible in the database. For instance, if you used Microsoft Access®
to create a new table in a Smeadlink database, the table would not be visible
when you reopened the database in Smeadlink. If you want to create a folder
or subfolder based on one of these tables, you can now simply register the
table in Smeadlink. Once the table has been registered, it will behave like a
regular Smeadlink table, and you will be able to use it to create your folder
or subfolder.
Several other features have been added to the Database Map in Smeadlink
(from previous versions) to make it easier to work with. First, the Field Maintenance utility allows you to add or remove fields from any table in the open
database. It displays the name of each field in a table, along with the type and
size of the field. You can then either remove existing fields, or add new ones.
Another new feature is drag-and-drop capabilities. You can now reposition
workgroups, tables in a workgroup or table children by dragging them from
their current position in the tree diagram and dropping them in a new position. Finally, there are now two ways to attach tables to each other. You can
attach two tables automatically, where Smeadlink will create the Id field for
you, or you can attach them manually, where you pick existing fields
Introduction to Smeadlink Administrative Utilities
19
Label Printing Utilities
If your Smeadlink system includes the Tracking module, then you will need
to use labels to identify the physical items that you want to track (i.e. file
folders, boxes, etc.) and the physical destinations for your trackable items
(i.e. rooms, warehouses, employees, etc.). Each label needs to have a unique
Id number that identifies an item or destination. Each label can also have
some basic information about the item or destination, like a name or a description. When your Smeadlink operators begin tracking items, they will
use the label Id numbers to specify which destination each item is assigned
to.
There are two ways to print labels for Smeadlink Tracking: you can have
them printed by an outside source, or you can print them yourself from the
start-up screen. There are two types of labels you can print from the
Smeadlink—ColorBar® labels and black-and-white labels. The difference
between the two label types is that ColorBar labels include a color pattern
that identifies what type of item each label was printed for, in addition to the
Id number and item description. ColorBar labels are typically used to identify file folders, and the different color patterns helps users identify different
groups of folders. Without the color patterns, it would be hard for users to
locate one folder in a large group of folders.
In order to print either ColorBar labels or black-and-white labels from
Smeadlink, you will need to perform some setup procedures. The utility for
setting up black-and-white labels is called Label Manager, and the utility for
setting up ColorBar labels is called ColorBar Label Integrator. The next two
parts of this section will introduce you to these two utilities.
The last part of this section will introduce you to the Data Director. Data
Director is a utility in Smeadlink that allows you to automatically capture
label data sent from an external program, import the data into a Smeadlink
table, and print it out on one of the existing label designs for that table. Data
Director contains all the necessary setup tools for this procedure, so the
program the label data gets sent from is not affected and operates in exactly
the same was as it did before (i.e. it still behaves like it is sending data directly
to the printer). Data Director is typically used to take data for black-and-white
labels sent from a large, mainframe computer, and print ColorBar labels with
the data from Smeadlink.
Chapter 1
20
Label Manager
Label Manager is a program that allows you to create label designs for blackand-white labels. Black-and-white labels are used for tracking purposes to
identify all kinds of items and destinations, from file folders and boxes to
shelves, rooms and warehouses.
A label design is like a template—it determines what type of information
will be on the labels, and where the information will be placed. You will
need to create at least one label design for each Smeadlink folder or subfolder
that you want to print labels from. Once you have created a design for a
folder, your Smeadlink users will be able to use the design to print blackand-white labels for the rows in that folder. The example below shows what
a label design looks like in the Label Manager program.
A label design in the Label Manager program
Label Manager allows you to place three kinds of data on a label design: bar
codes, text and fields. When you place text on a label design, the text is
static—the same text appears on all labels printed with this design. When
you place bar codes or fields on a label design, however, the information in
the bar code or field changes with each label that is printed. This is because
each bar code or field object on the label design is attached to a column in
the folder or subfolder, and each label printed with the design uses data from
a different row in the column.
In addition to features for inserting bar codes, text and fields on a label
design, the Label Manager also includes some formatting features to make it
easier to position objects on a label design. For instance, the Center Horizontal feature allows you to center an object horizontally in the design, and
the Center Vertical feature allows you to center an object vertically.
Introduction to Smeadlink Administrative Utilities
21
ColorBar Label Integrator
ColorBar Label Integrator is a program that allows you to configure ColorBar
labels for printing from Smeadlink. ColorBar labels are color-coded strip
labels that are typically used to identify file folders. In order to print ColorBar
labels, you will need to have at least one label design configured for each
Smeadlink folder or subfolder you want to print labels from. The label design specifies how the data will appear on any labels printed from that folder,
and it also specifies what color pattern the labels will have. Label designs
are created in the ColorBar Gold® program, and they are typically created by
Smeadlink resellers.
On its own, a label design is not connected in any way to a Smeadlink folder
or subfolder. Instead, the label design is connected to its own ColorBar database, and it pulls data from the fields in that database. ColorBar Label
Integrator is the tool you will use to connect each of your label designs to a
folder or subfolder. This process is called configuring a label design. The
example below shows what the ColorBar Label Integrator program looks
like.
ColorBar Label Integrator program
ColorBar Label Integrator connects a label design to a Smeadlink folder by
mapping the columns in the folder to the fields in the label design's ColorBar
database. When a user then prints labels from that folder, Smeadlink sends
the data in the folder's columns to the corresponding fields in the label design's
ColorBar database, and the labels are printed from that database.
Chapter 1
22
Data Director
Data Director is a program that allows you to automatically capture label
data sent from an external program, route it into a Smeadlink table, and print
it out on one of the existing label designs for that table. Data Director was
created to give customers who already have high-end software for printing
black-and-white labels the capability to print color labels.
The advantage of Data Director is that it does not require you to make any
changes to the original label-printing program, or use it any differently. Data
Director automatically captures the data as it is sent to the printer (by monitoring a COM port), and it then extracts the necessary information, puts it
into the specified Smeadlink table and prints it using one of the table's label
designs. The example below shows what the Data Director program looks
like.
Data Director program
The first step in using Data Director is to create a format. A format is a group
of settings that determines what information to extract from captured label
data, how to place that information into a Smeadlink table and what label
design to print that information with. You will need to create a separate
format for each for each type of label that you send into Smeadlink with
Data Director.
Once you have created a format, you can open it and Data Director will
begin to monitor the COM port specified in the format for label data. You
can choose to have Data Director print labels one at a time as it receives
information, or wait to print out a group of labels at once (this is helpful for
label types that print multiple labels to a sheet). You can also hide, or minimize, the Data Director program while it is monitoring a COM port. This is
helpful if you want to work on something else in Smeadlink while Data
Director is open.
Introduction to Smeadlink Administrative Utilities
23
Smeadlink Administrative Utilities
Unlike the other administrative utilities, which are separate programs, the
Smeadlink administrative utilities are additional components that become
available in the program when you log in with the standard Manager user
name. There are four main administrative utilities in Smeadlink—the Views
utility, the Columns utility, the Add-Ins Manager utility and the Report Generator utility.
The Views utility allows you to create new views, save the current view and
delete or edit the properties of existing views. The Columns utility allows
you to create new columns and delete or edit the properties of existing columns. Both of these utilities are made up of a number of menu commands.
These commands are not visible when a user logs in to Smeadlink with the
standard Guest or Editor user names, but they become visible when a user
logs in with the standard Manager user name. The example below shows
what the Views and Columns utilities look like.
As you can see in the example above, both the Views utility and the Columns utility are opened from the Tools menu. The Views utility consists of
the last five commands on the View Settings submenu, and the Columns
utility consists of the New Column, Delete and Column Properties commands on the Columns submenu. Because columns in Smeadlink are components of views, the Columns utility is a component of the Views utility.
Chapter 1
24
The first three menu commands that make up the Views utility—Save View,
Save View As and Delete View, are very straightforward. The next command, View Order, allows you to adjust what order will be used to display
the views in the open folder or subfolder on the View menu (this command
also allows you to specify the default view for a folder or subfolder). Finally, the View Properties command allows you to modify the property settings of the open view. These settings determine things like the name of the
view, whether rows can be added to the view and what SQL statement will
be used to display the rows in the view. The example below shows what the
View Properties window looks like.
View Properties window
The first command on the Column utility is called New Column. This command allows you to create new columns in the open view. The second command is called Delete, and it allows you to delete any column from the open
view. The last command on the Columns utility is called Column Properties,
and it is very similar to the View Properties command on the Views utility.
Selecting the Column Properties command will bring up the Column Properties window, which allows you to adjust the properties of any column in
the open view. Column properties determine things like whether or not users can sort or filter a column, and whether the column is always visible or
hidden in certain situations.
The third administrative utility in Smeadlink is the Add-Ins Manager. The
Add-Ins Manager allows you to create, delete and modify the add-ins in a
database. An add-in is a shortcut from Smeadlink to an external program or
file. An add-in can also be a shortcut to a page on the Internet. The capability
to create and use add-ins was added to Smeadlink in version 3.1 to make it
easier to use Smeadlink with external utilities.
Introduction to Smeadlink Administrative Utilities
25
For instance, you might want to use Crystal Reports® along with Smeadlink
to provide custom report capabilities for your system. To make it easy for
your users to switch from Smeadlink to Crystal Reports, you could create a
Crystal Reports add-in. Your users could then use the add-in to open the
Crystal Reports program from within Smeadlink.
The Add-Ins Manager utility is opened from the Add-Ins menu, which is
located on the main menu bars of all Smeadlink programs (including both
end-user programs and administrative programs). The Add-Ins menu also
lists all the add-ins that have been created for the open database. The AddIns menu has built-in security, so if an add-in points to a file that a user does
not have access to, then that add-in will not appear on the Add-Ins menu
when that user logs into Smeadlink. The example below shows what the
Add-Ins Manager looks like after it is opened from the Add-Ins menu.
Add-Ins Manager utility
The Add-Ins Manager lists all the add-ins that have been created for the
open database. In the example above, the Add-Ins Manager lists four addins, starting with one called Auction Info. You can use the Add-Ins Manager
to create new add-ins for the open database, and to delete or modify existing
add-ins. You can also use the Add-Ins Manager to change the menu order of
an add-in (i.e. whether it is the first add-in displayed in the Add-Ins menu,
the second, the third, etc.).
Chapter 1
26
The last administrative utility in Smeadlink is the Report Generator. The
Report Generator is a group of components in that allow you to create formatted reports for Smeadlink views. Formatted reports differ from basic reports printed using the Print...All Rows or Print...Selected Rows commands,
because they allow you to determine what data appears on reports and how
the data is displayed. With the Report Generator, you can create one custom,
formatted report for each view in the open Smeadlink database.
The three components in the Report Generator are the Column Print Properties window, the View Setup window and the Report Styles window. Together, these three components give you maximum flexibility in setting up
your own formatted reports.
The Column Print Properties window allows you to set the print attributes
for each column in the open view. For instance, you can use the Column
Print Properties window to set whether or not data in a column will be included in reports printed from the view. The Column Print Properties window is divided into two sections: one section contains options that only apply to formatted reports created in the Report Generator, and the other section contains options that apply to both formatted reports and basic reports
printed using the Print...Selected Rows or Print...All Rows commands. The
example below shows what the Column Print Properties window looks like.
Column Print Properties window
The second component in the Report Generator is the Report Setup window.
The Report Setup window allows you to set the print attributes for the open
view. For instance, you can use it to select whether or not to include data
from a subtable when printing a formatted report for the view. The example
on the following page shows what the Report Setup window looks like.
Introduction to Smeadlink Administrative Utilities
27
Report Setup window
One of the options on the Report Setup window allows you to select a style
for the open view's formatted report. While the Column Print Properties
window and the other options on the Report Setup window are used to specify
which data to include in the report, the style determines how the data in the
report is displayed. Styles are created and modified with the Report Styles
window, which is the third component in the Report Generator. The example below shows what the Report Styles window looks like.
Report Styles window
Chapter 1
28
Database Utilities
There are two administrative utilities in your Smeadlink system that give
you direct access to your Smeadlink database. The first utility is called the
Database Toolkit, and the second is called the Compact & Repair Database
Utility. Unlike the other Smeadlink administrative utilities, these two programs are not intended for normal setup and maintenance of a Smeadlink
system. Instead, they are intended mainly as troubleshooting tools that can
be used to repair damaged or corrupted components in a Smeadlink database. The rest of this section will introduce you to these two utilities.
Database Toolkit
The Database Toolkit utility is a program that gives you direct access to all
the tables in a Smeadlink database. It also allows you to modify a database
by executing SQL statements.
Because the Database Toolkit program gives users direct access to a
Smeadlink database, either by modifying table data or by executing SQL
statements, it needs to be used with caution. In most cases, the Database
Toolkit is only used by Smeadlink users when they are directed to do so by
Smeadlink Technical Support. In this kind of situation, the Technical Support representative would walk you in detail through whatever changes you
needed to make or whatever settings you needed to verify in the Database
Toolkit program.
There are two main modes in the Database Toolkit program—Tables mode
and Scripts mode. The Tables mode allows you to view and modify the
different tables in the open Smeadlink database, and the Scripts mode allows
you to enter SQL statements and then execute them. The example on the
following page shows what the Database Toolkit program looks like in Tables
mode.
Introduction to Smeadlink Administrative Utilities
29
Database Toolkit program in Tables mode
As you can see in the example above, activating Tables mode in the Database Toolkit program displays a list of all the tables in the open Smeadlink
database. You can then double-click any of the tables on the list, and it will
be opened in the Database Toolkit program.
Tables mode is often used in the troubleshooting process to see whether or
not Smeadlink has saved a change that was made. For instance, say you use
the Database Map program to change the background color of a Smeadlink
folder. Now say that when you open the folder, it does not have the new
background color. To see whether or not your change was saved, you could
open the Database Toolkit program, open the appropriate table for the
Smeadlink folder and check the appropriate row in the table. You would then
know whether or not Smeadlink had saved the change you made, and you
could continue the troubleshooting process from there.
The second mode in the Database Toolkit program is Scripts mode. Scripts
mode allows you to modify the open Smeadlink database by executing SQL
statements. The SQL statements can either be statements that you type directly into the Database Toolkit program, or statements that are contained in
a script file. (A script file is a standard text file that contains a number of
SQL statements. When you execute the file, the statements are executed
one-by-one in the order they appear in the file. )
Chapter 1
30
Compact and Repair Database Utility
As its name implies, the main purpose of the Compact and Repair Database
Utility is to compact and repair Smeadlink databases. In addition, it can also
convert databases to newer versions of Access and it can automatically create backups of databases.
The Compact and Repair Database Utility is a stand-alone program. In other
words, you have to open it directly—you cannot open it from the start-up
screen. This is so you will be able to open the utility if your Smeadlink database becomes corrupted (If the Compact and Repair Database Utility was
bundled with the other Smeadlink programs and utilities, then you would not
be able to open it if your database became heavily corrupted). The example
below shows what the Compact and Repair Database Utility looks like.
Compact and Repair Database Utility
The Compact and Repair Database Utility is typically used after a database
has become corrupted, or after large amounts of data have been removed
from a database. During the compact and repair process, the Compact and
Repair Database Utility will recreate the indexes for all the tables in the
open database. This will fix any index problems that have been created by
adding and removing information to the database over time.
In addition, the database will be resized so that it only takes up as much
storage space as it currently needs. This will release any unused space that
the database was taking up. (Unused spaced is caused by deleting information from the database. When information is deleted, the database is not
resized—it takes up the same amount of space as it did when it contained the
information.)
Opening a Smeadlink Program
2. Opening a Smeadlink Program
Chapter contents
Introduction
Opening a Smeadlink Program
Using Smeadlink General Options
Opening an Add-In from a Smeadlink Program
Using Smeadlink Help
Exiting a Smeadlink Program
31
32
Chapter 2
Introduction
As you learned in chapter 1, some of the administrative utilities in your
Smeadlink system are separate programs, and some are additional components that become available in end-user programs when you log in with the
standard Manager user name. In order to use any one of these utilities, you
will need to know how to open a program in Smeadlink.
This chapter will show you how to open a Smeadlink program. All programs are opened with the same basic procedure, so you can use the information in this chapter to open any program in your Smeadlink system—
including both end-user programs and administrative utilities. After you learn
how to open a program, the next sections in this chapter will explain some
general features that all Smeadlink programs have in common. For instance,
you will learn how to use general options, which can be used to remember
information about previous Smeadlink sessions.
Once you have gone through this chapter, you will be ready to learn about
the different administrative utilities. The remaining chapters in this manual
are divided up into sections—one for each administrative utility in
Smeadlink. Terms and concepts that you will need to know in order to use a
utility are explained in the introductory chapter of that utility's section. Any
optional hardware that can be used with the utility will also be listed and
explained in the introductory chapter. The remaining chapter or chapters in
the section will then explain the different tasks that the utility was intended
for.
Note: The information in this chapter is basically the same as the information in chapter 2 of the Smeadlink User's Guide. It is included again here so
that you do not have to flip between two manuals. If you have already read
chapter 2 of the User's Guide and you know how to start a program in
Smeadlink, then you may want to skip most of this chapter.
The one part of this chapter that is different from chapter 2 of the User's
Guide is the section Opening a Smeadlink Program. In chapter 2 of the
User's Guide, the second part of this section explains how to open other
end-user programs from the Smeadlink. In this chapter, however, the second
part of the section explains how to open administrative utilities from the
program.
Opening a Smeadlink Program
33
Opening a Smeadlink Program
This section will show you how to open a Smeadlink program. In Smeadlink,
the first step in opening a program is to open the start-up screen. You can
then open other Smeadlink programs, including both end-user programs and
administrative utilities, from the start-up screen. The first part of this section
will show you how to open the start-up screen, the second part will show
you how to open Smeadlink administrative utilities from the start-up screen
and the third part will show you how to open multiple copies of Smeadlink at
once.
Opening Smeadlink
The following instructions will show you how to open Smeadlink.
To open Smeadlink:
1. Double-click the Smeadlink icon on your desktop. The example below
shows what the Smeadlink icon looks like.
Smeadlink desktop icon
If you do not have a Smeadlink icon on your desktop, then you will need to
use the Start menu as explained below.
• Click once on the Start button. The Start menu will now appear.
• Click the Programs command on the Start menu. The Programs submenu will now appear.
• Click the Smeadlink Document Management command on the Programs submenu. The Smeadlink submenu will now appear.
• Click the Smeadlink command on the submenu.
Once you double-click the Smeadlink desktop icon or click the Smeadlink
submenu command, then the Log in window will appear. The Log in window allows you to specify which database Smeadlink will be opened with.
The example on the following page shows what the Log in window looks
like.
34
Chapter 2
Smeadlink Log in window
2. Select the appropriate type option for the database you wish to open. To
select a type:
• Click the Access or SQL button in the Database Type section of the
Log in window.
The type you will need to select is determined by the database you want to
open (i.e. if you want to open an Access database then you will need to
select the Access type, and if you want to open a SQL database then you will
need to select the SQL type). Once you select a type, all the recently opened
databases of that type will be listed in the database box beneath the two type
buttons.
Note: If you are unsure which database type to select, check with your
Smeadlink administrator.
3. Select the desired database. To select a database:
• If the database is listed in the database box beneath the two type
buttons, then click the database. It will turn blue once you click it, to
indicate that it is now selected.
• If the database is not listed in the database box, then double-click the
More Files option in the database box. The Open Database window will
now appear. Use the window to locate the database you wish to open,
and then double-click the database to select it.
Opening a Smeadlink Program
35
The database you select will determine what data is displayed in Smeadlink
programs and utilities (i.e. what workgroups and folders are displayed, what
images are displayed in the Scanner program, etc.).
Note: If you are unsure which database to select, check with your Smeadlink
administrator.
4. Type your user name in the Name box.
5. Type your password in the Password box.
6. Click the OK button or press the ENTER key on the keyboard.
The Smeadlink program will now open. The example below shows what
Smeadlink looks like immediately after it has been opened.
Smeadlink program immediately after being opened
When you first open Smeadlink, it will probably look somewhat different
than the example above. This is because the exact appearance of the program depends on the structure of the database you selected earlier, and the
current settings of the Smeadlink's preference options (located on the Options window in the Smeadlink folder). You will learn more about these options later on.
36
Chapter 2
Opening Administrative Utilities from Smeadlink
This section will show you how to open the different administrative utilities
in your Smeadlink system. The information in this section applies to all
Smeadlink administrative utilities that are separate programs, such as Security Manager or Directory Settings. You will learn how to open administrative
utilities that are not separate programs, like the Views utility or the Columns
utility in Smeadlink, in their respective sections of this manual.
To open an administrative utility from Smeadlink:
1. Open the Tools menu from Smeadlink's main menu bar.
The top section of the Tools menu lists the all the administrative utilities in
your Smeadlink system except the Database Toolkit (which is opened as a
separate program, as explained in chapter 1). The example below shows what
the Tools menu looks like.
Tools menu
2. If you want to open any utility except the Data Director or the Import
Wizard, then simply click the name of the desired utility on the Tools menu.
The selected Smeadlink utility will now open. The data displayed in the
program will be determined by the open Smeadlink database.
Note: For a summary of each administrative utility in your Smeadlink system, see the section Smeadlink Administrative Utilities in chapter 1.
Opening a Smeadlink Program
37
3. If you want to open the Data Director utility, follow the steps below:
• Click the Data Director command on the Tools menu. The Data Director
submenu will now appear as shown below.
Data Director submenu
• Click the Setup command on the Data Director submenu. The Data
Director Setup window will now appear, which allows you to add or edit
the label formats for the open database.
4. If you want to open the Import Wizard utility, follow the steps below:
• Click the Import command on the Tools menu. The Import submenu will
now appear as shown below.
Import submenu
• Click the Setup command on the Import Wizard submenu. The main
Import Wizard window will now appear, which allows you to add, edit or
run any import load or import job in the open database.
38
Chapter 2
Opening Multiple Copies of Smeadlink
For most Smeadlink programs, such as the Scanner program or the Tracking
program, you can only have one copy of the program open at once (this is
called one instance of the program). For the start-up screen, however, you
can have up to five copies open at once.
When you have multiple copies of Smeadlink open, the same database is
open in each copy, but each copy can display a different section of that
database. For instance, one copy could display a Clients folder in the database, one copy could display an Employees folder and another copy could
display a Purchase Orders folder. You could also display the same folder in
all three copies, because they are not mutually exclusive. Each open copy
retains all the original functionality of Smeadlink. The following instructions will show you how to open multiple copies of Smeadlink. The instructions assume that at least one copy of Smeadlink is currently open.
To open multiple copies of Smeadlink:
1. Open the Go menu from the Smeadlink's menu bar, and then click the
Smeadlink command in the middle section of the Go menu.
Note: You can also click the Smeadlink button on the toolbar.
The Smeadlink submenu will now appear. If only one copy of Smeadlink is
currently open, then the submenu will contain one command called New
Smeadlink. If multiple copies of Smeadlink are already open, then the submenu will contain the New Smeadlink command and a list of the other open
copies. The copies will be called Smeadlink 1, Smeadlink 2, etc.
Smeadlink submenu
Opening a Smeadlink Program
39
2. Click the New Smeadlink command on the Smeadlink submenu.
A new copy, or instance, of Smeadlink will now be opened. The new instance will appear in front of any previous instances. If five instances of
Smeadlink are already open, then you will get an error message stating that
there can only be five open instances of Smeadlink.
3. The default mode for displaying multiple Smeadlink instances is a cascade mode. This means that the copies appear stacked on top of each other,
and the only copy that is fully visible is the active copy at the front of the
stack. If you want, you can also display multiple Smeadlink instances using
a tile mode. Tile mode divides the screen up, giving an equal screen area to
each open instance. To activate tile mode for the open Smeadlink instances:
• Open the Window menu from Smeadlink's menu bar.
• Click the Tile All command on the Windows menu.
The open Smeadlink instances will now be arranged in tile mode. The
example below shows what two Smeadlink instances look like in tile
mode. The top instance in the example is currently active.
Multiple Smeadlink instances displayed with tile mode
40
Chapter 2
Using Smeadlink General Options
Once you have opened a Smeadlink program for the first time, it is a good
idea to look at the general options. The general options can be accessed
through any Smeadlink program's Tools menu, and they allow you to determine what information will be saved each time a user exits a Smeadlink program or exits Smeadlink entirely. For instance, you can choose to have a
Smeadlink database remember the last user name that was used to open it.
Next time someone begins opening the database, the last user name will then
be automatically entered in the Log in window.
This section is divided into two parts. The first part shows you how to
access the general options from any Smeadlink program, and the second
part explains what each option does.
Accessing the General Options
The following instructions will show you how to access the Smeadlink general options. You can use these instructions to access the general options
from any Smeadlink program.
To access the general options from a Smeadlink program:
1. Open the Tools menu from the program's menu bar. The example below
shows what the Tools menu looks like.
Tools menu
2. Click the Options command on the Tools menu.
The Options window will now appear as shown on the following page. The
folder that is open in the Options window will be determined by what
Smeadlink program you opened it from. In the example on the following
page, the Smeadlink folder is open.
Opening a Smeadlink Program
41
Smeadlink folder in the Options window
3. Click the General tab on the Options window.
The General folder will now open as shown below. The Smeadlink general
options will be displayed in the middle of the General folder.
General folder in the Options window
42
Chapter 2
General Options
The previous part of this section showed you how to access the general
options from any Smeadlink program. The rest of this section will explain
the purpose of each option.
Restore Open Windows on Startup
If this option is enabled, any programs that were open in Smeadlink when it
was last closed will be automatically opened next time it is opened. For instance, if the Scanner and Tracking programs were open along with the
Smeadlink when it was last closed, then both of these programs will be automatically opened next time Smeadlink is opened. In addition, this option
will also reopen any windows that were open in a program (like the Position
Viewer in Smeadlink).
Restore User Name on Startup
If this setting is activated, the last user name that was used to open the
current database will automatically be entered in the Log in window the
next time someone begins to open the database. This setting is helpful if
one user uses a database on a regular basis, because it saves them from
having to enter their user name each time they want to open the database.
Show Menu Tips
If this setting is activated, a menu tip will appear in the lower left corner of the
program window each time you click a menu, or place your mouse pointer
over a command on an open menu. The example below shows where menu
tips are displayed on a program's window.
Menu tip for highlighted menu command
Opening a Smeadlink Program
43
Monitor for Labels on Startup
If this setting is activated, then the Data Director format that was open when
the current database was last closed will be automatically reopened the next
time the database is opened. This setting only applies if a format was open
when the current database was last shut down—if no formats were open at
that time, then no formats will be automatically reopened the next time the
database is opened.
This setting is helpful if you have a Smeadlink workstation dedicated exclusively to Data Director, and if you use the same format on a regular basis to
capture label data and print labels. Monitor for Labels on Startup saves you
from having to reopen a Data Director format each time you open your
Smeadlink database.
Note: For more information about Data Director, see chapter 14 in the
System Administrator's Guide.
Monitor Imports on Startup
If this setting is activated, then the import or load that was running with Quiet
Processing when the current database was last closed will be automatically
reopened the next time the database is opened. If no imports or loads were
running with Quiet Processing when the database was last closed, then no
imports or loads will be automatically reopened the next time someone opens
the database.
This setting is helpful if you have a Smeadlink workstation dedicated exclusively to Import Wizard, and if you use the same import or load on a regular
basis to import data into Smeadlink. Monitor Imports on Startup saves you
from having to reopen the import or load each time you reopen your Smeadlink
database.
Note: For more information about Import Wizard, see chapter 5 in the System Administrator's Guide.
Database Connection Timeout
This setting only applies to SQL databases, and it determines how much
time Smeadlink has to connect to the database after the OK button on the
Log in window is clicked (i.e. how much time Smeadlink has to make the
initial database connection). To set Database Connection Timeout, simply
type the desired connection timeout in seconds into the Database Connection Timeout box.
44
Chapter 2
Opening an Add-In from a Smeadlink Program
Some Smeadlink programs are integrated with outside utilities. For instance,
Crystal Reports is often used with Smeadlink to provide extended report
capabilities beyond Smeadlink's Report Generator. To simplify this process,
Smeadlink allows you to create shortcuts to other programs, files or Web
pages. These shortcuts are called add-ins, and they are created with an administrative utility called the Add-Ins Manager.
Once an add-in has been created, it becomes visible in the Add-Ins menu of
each Smeadlink program. The Add-Ins menu has built-in security, so if an
add-in points to an item that a user does not have access to, then that add-in
will not appear on the Add-Ins menu when that user logs into Smeadlink.
Once an add-in is selected, the corresponding program or file will be opened.
If the selected add-in was for a program, then that program will be opened in
its default mode, if the selected add-in was for a file, then that file will be
opened in the appropriate program and if the add-in was for a web page, then
that web page will be opened in your default browser. This section will show
you how to open an add-in.
Note: If no add-ins have been created for the open database, then the AddIns menu will not be visible in Smeadlink programs. This section assumes
that at least one add-in has been created for the open database.
To open an add-in from a Smeadlink program:
1. Open the Add-Ins menu from the program's menu bar.
The Add-Ins menu lists all the add-ins that have been created for the open
database. The number of commands on the menu, and the name of each
command, will vary from system to system. The example below shows what a
typical Add-Ins menu looks like. The menu in the example contains three
add-ins, starting with one called Smeadlink Online.
Add-Ins menu
2. Click the desired command on the Add-Ins menu.
Opening a Smeadlink Program
45
Using Smeadlink Help
Selecting Help from the menu bar of any Smeadlink program will bring up
the menu shown below.
Help menu
The Help menu allows you to view PDF versions of this manual or the
Smeadlink User's Guide, and it also allows you to view the exact version
number and registration information for your Smeadlink system. The first
part of this section will show you how to view a PDF version of this manual,
and the second section will show you how to view the version and registration information for your Smeadlink system.
Viewing the PDF Manuals
The PDF format preserves page layout and typography, so when you open
either Smeadlink manual from the Help menu it will look the same as it looks
in printed form. The advantage of viewing the manuals online is that you can
find information and move from topic to topic much faster in the online versions, and also you do not have to keep track of any physical documents.
PDF Requirements
In order to view the PDF manuals, you will need to have the following items
installed on your computer:
• the Smeadlink PDF help files
• the Adobe® Acrobat Reader
The PDF files for both manuals are included on your Smeadlink CD-ROM,
and they were installed automatically when your Smeadlink system was
installed. The Acrobat Reader is also included on the Smeadlink CD-ROM,
but it was not automatically installed. If you do not already have the Acrobat Reader and you want to be able to view the PDF manuals, then the steps
on the following page will show you how to install the Reader from your
Smeadlink CD-ROM.
46
Chapter 2
To install the Adobe Acrobat 4.0 Reader:
1. Place the Smeadlink CD-ROM into the CD drive on your computer. The
Smeadlink Installation System window will now appear as shown below.
Smeadlink Installation System window
2. Click the Adobe Acrobat Reader command on the Smeadlink Installation
System window.
The install wizard will now walk you through the process of installing the
Acrobat Reader on your computer.
To open a PDF version of either manual:
1. Open the Help menu from any Smeadlink program.
Help menu
2. Click the appropriate command on the Help menu for the manual you want
to open. The manual you selected will now open automatically in the Acrobat
4.0 Reader.
Opening a Smeadlink Program
47
Viewing Version and Registration Information
The second section of the Smeadlink Help menu allows you to view the
version and registration information for your Smeadlink system. Customer
service representatives will often ask you for the version number when they
are helping you with your system. The version and registration information
are both displayed in the About window.
To open the About window and view version and registration information:
• Click the About command on the Smeadlink Help menu. The About
window will now appear as shown below.
About window
• The version number of your Smeadlink system is displayed in green in
the middle of the About window. In the example above, the version
number is 5.0.48.
• The registration information for your Smeadlink system is displayed
also. The registration information is grayed out in the example above.
48
Chapter 2
Exiting a Smeadlink Program
There are two ways to exit a Smeadlink program and return to Windows.
Both methods are explained below. You can use these methods to exit any
Smeadlink program, whether it is an end-user program or an administrative
utility.
To exit a Smeadlink program:
1. Open the File menu from the program's menu bar.
2. Click the Exit command at the bottom of the File menu. The program will
now close.
OR
Click the Close (X) button in the upper right corner of the program's window.
The example below shows what the Close button looks like on a Smeadlink
program's window.
Close Button
Introduction to Security Manager
3. Introduction to Security Manager
Chapter contents
Introduction
Basic Security Manager Terms
Basic Security Manager Concepts
49
50
Chapter 3
Introduction
The first two chapters in this manual introduced you to the administrative
utilities in your Smeadlink system, and showed you how to start a Smeadlink
program. The information covered in these chapters is general information,
so it applies to all the administrative utilities in your Smeadlink system.
The remaining chapters in this manual will show you how to use each administrative utility in Smeadlink. The chapters are divided into sections of
several chapter each, and each section explains one utility. The first chapter
in each section explains the basic information you should know before you
begin using the utility, and the remaining chapter or chapters explain the
different components in the utility and the tasks it is intended for.
This chapter will introduce you to the Security Manager program. As you
learned in chapter 1, Security Manager is a program that allows you to assign access rights for your Smeadlink database. The first section of this chapter
will explain some terms that are often used in discussing Security Manager.
The next section will explain the basic concepts you should know before
you begin using Security Manager. Chapter 4 will then show you how to use
Security Manager to assign access rights for your Smeadlink database.
Note: For a summary of the Security Manager utility and its function in
your Smeadlink system, see the section Smeadlink Administrative
Utilities...Security Manager in chapter 1 of this manual.
Introduction to Security Manager
51
Basic Security Manager Terms
There are several terms that are often used in discussing the Security Manager program. This section will introduce you to those terms and explain
how they are typically used.
Operator
The operators in a Smeadlink database determine what user names and passwords can be used to log in to that database. Each operator consists of one
row in the Security Manager Operators view, and it includes a user name, a
full name and a password. The user name and password are used together to
log in to the database, and the full name is used as a reference to distinguish
different operators.
Each operator also includes an entry called Last Password Change that lets
you know when the password for this operator was last changed. This information is sometimes used for security reasons. (For instance, your security
system may require you to change your passwords every month.)
Operators are typically referred to in Security Manager by their user names.
Therefore, the default operators that come with your Smeadlink system are
typically called Guest, Editor and Manager.
Group
A group is a collection of operators. Security Manager assigns access rights
on a group-by-group basis, not on an operator-by-operator basis. The default groups that come with your Smeadlink system are the Everyone Group,
the Editor Group and the Administrator Group. The Everyone Group includes the Guest, Editor and Manager operators, the Editor Group includes
the Editor and Manager operators, and the Administrator Group includes
the Manager operator.
52
Chapter 3
Basic Security Manager Concepts
As you learned earlier, Security Manager is a program that is used to set up
access rights for your Smeadlink database. The first step in setting up access
rights with Security Manager is to create the different groups that your operators will be divided into. Once all your groups have been created, you
can create the different operators in each group. You can then specify which
components in your Smeadlink database each group of operators has access
to.
Typically, you will use Security Manager when you are first setting up your
Smeadlink database to assign access rights for each of your users. You may
also use Security Manager again from time to time if you would like to
change the access rights for one of your users, or if you create a new Smeadlink
table and you need to assign access rights for it.
The Security Manager program includes five views, or grids. Each view
includes a number of related rows. The Groups view and the Operators view
allow you to create the groups and operators for your Smeadlink system.
The Tables, Workgroups and System views then allow you to specify which
components in your Smeadlink system each group can access.
When you are assigning access rights for your Smeadlink system, the first
view that you will use is the Groups view. The Groups view contains one
row for each group in the open Smeadlink database. You can add new groups
to your database by adding new rows to the Groups view, and you can delete
existing groups by deleting their rows in the Groups view. The example
below shows what the Groups view looks like. The Groups view in the example contains one row for each of the three default Smeadlink groups.
Groups view in Security Manager
Introduction to Security Manager
53
Once you have used the Groups view to create the desired groups for your
Smeadlink database, then the next step in assigning access rights is to create
the different operators in the database. Operators are created in Security
Manager with the Operators view.
The Operators view contains one row for each operator in the open Smeadlink
database. You can add new operators to the database by adding new rows to
the Operators view, and you can delete existing operators by deleting their
rows in the Operators view. The example below shows what the Operators
view looks like. The Operators view in the example contains three rows for
the default Smeadlink operators.
Operators view in Security Manager
After you have created all the operators for your Smeadlink database, then
you will need to assign each operator to a group. There are two methods for
assigning an operator to a group in Security Manager: the first method uses
the Groups view and the second method uses the Operators view.
The Groups view has a special subtable that allows you to add or remove
operators from any group in the view. This subtable is called the User Name
list, and it looks and functions just like a standard subfolder in Smeadlink.
When you select a row in the Groups view and then open the User Name list,
you will see the names of all the operators in the open database that are
members of that group. You can assign operators to this group by adding
rows to the User Name list, and you can remove operators by removing
rows. Adding or removing operators to the User Name list does not modify
the actual operator rows in the Operators view; it only determines whether
or not the operators are members of the selected group.
54
Chapter 3
The example below shows what the User Name list looks like. The User
Name list in the example was opened from the Everyone group's row in the
Groups view, so it displays the three default members of the Everyone group.
User Name list
The second method for assigning an operator to a group uses the Operators
view. Like the Groups view, the Operators view includes a special subtable
that looks and functions just like a subfolder in Smeadlink. The subtable in
the Operators view is called the Group list, and it allows you to specify
which group or groups each operator in the Operator's view is a member of.
When you select a row in the Operators view and then open the Group list,
you will see the names of all the groups in the open database that the selected operator is a member of. You can modify which groups the selected
operator is a member of by adding or removing rows to the Group list. Just
like the User Name list, adding or removing groups to the Group list does
not modify the actual group rows in the Groups view; it only determines
whether or not the selected operator is a member of those groups.
The example on the following page shows what the Group list looks like.
The Group list in the example was opened from the Manager operator in the
Operators view, so it shows the three groups that the default Manager operator is a member of.
Introduction to Security Manager
55
Group list
Once you have assigned your operators to the appropriate groups, then you
can begin assigning access rights for your groups. The Tables view, Workgroups view and System view list all the different components in the open
Smeadlink database, from specific tables and workgroups to general system
components. You can use these three view to specify exactly which components in your Smeadlink system each group can access.
The Tables view lists all the user tables in the open Smeadlink database.
Each row in the Tables view corresponds to one table in the database. You
can use the Tables view to specify which tables each one of your groups will
have view privileges for. If a group does not have view privileges for a
table, then the operators in that group will not be able to see the folders or
subfolders in Smeadlink that are based on that table.
You can also use the Tables view to specify which tables each group will
have add, edit and delete privileges for. Add privileges determine whether
or not the operators in a group can add rows to a table. If a group does not
have add privileges for a table, then the operators in that group will not be
able to add rows to the folders or subfolders in Smeadlink that are based on
that table. Similarly, edit privileges determine whether or not the operators
in a group can edit the rows in a table. If a group does not have edit privileges for a table, then the operators in that group will not be able to edit rows
in the folders or subfolders in Smeadlink that are based on that table.
56
Chapter 3
Finally, delete privileges determine whether or not the operators in a group
can delete the rows in a table. If a group does not have delete privileges for
a table, then the operators in that group will not be able to delete rows in the
folders or subfolders in Smeadlink that are based on that table. The example
below shows what the Tables view looks like. The Tables view in the example contains ten rows for the ten user tables in the Basic Demo database
(a standard Smeadlink demo database).
Tables view
The default setting for each table in the Tables view is Everyone Group. This
means that the Guest, Editor and Manager operators will all have view, add,
edit and delete privileges for all the tables in the database. You can leave the
security settings in the Tables view as they come, or you can modify them so
that some of your operators only have privileges for certain tables.
In addition to setting access rights for the user tables in the database, the
Tables view also allows you to set view rights for the views that are based on
each table. To accomplish this, the Tables view includes a special subtable
called the View list, that looks and functions just like a subfolder in Smeadlink.
When you select a row in the Tables view and then open the View list, you
will see all the views in the open database that are based on that table. You
can then specify which group will have view privileges rights for each view.
If a group does not have view privileges for a view, then its operators will
not be able to see it in Smeadlink, although they may be able to see other
views that are based on the same table. The example on the following page
shows what the View list looks like. The View list in the example contains
three rows for the three views based on the Clients table.
Introduction to Security Manager
57
View list
The next view for assigning access rights is the Workgroups view. The Workgroups view lists all the workgroups in the open Smeadlink database, and
each row in the Workgroups view corresponds to one workgroup in the
open database.
The purpose of the Workgroups view is to specify which workgroups in the
open Smeadlink database each one of your groups will have view privileges
for. If a group does not have view privileges for a workgroup, then the
operators in that group will not be able to see the work- group in the Smeadlink
program or the Database Map program. The example below shows what the
Workgroups view looks like.
Workgroups view
58
Chapter 3
The default setting for each workgroup in the Workgroups view is No Security. This means that every operator in the open Smeadlink database will
have view privileges for all the workgroups in the database. You can leave
the Workgroup security settings as they come by default, or you can modify
them so that some of your operators can only view certain workgroups in
the database.
The last view in Security Manager is the System view. The System view
lists all the remaining components in your Smeadlink system that you may
want to set access rights for. For instance, you can use the System view to
determine whether or not your operators will have access to the Scanner
program and the Security Manager program. When you finish setting the
options on the System view, you will be finished setting up the access rights
for your Smeadlink system. The example below shows what the System
view looks like.
System view
Using Security Manager
4. Using Security Manager
Chapter contents
Introduction
Creating a Group
Creating an Operator
Assigning Operators to Groups
Removing a Group or Operator
Using Network Security
Assigning Access Rights for the Groups in a Database
Printing, Exporting and Resizing the Rows in a View
59
60
Chapter 4
Introduction
The previous chapter introduced you to the Smeadlink Security Manager
program. You learned about basic Security Manager terms, and about the
basic concepts for using Security Manager. This chapter will show you how
to use Security Manager to assign access rights for a Smeadlink database.
As you learned earlier, the first step in assigning access rights for a Smeadlink
database is to create the different groups that your operators will be divided
into. Once all your groups have been created, you can create the different
operators and assign them to the appropriate groups. You can then specify
which components in your Smeadlink database each group will have access
to.
The first section in this chapter will show you how to create a group. The
second section will show you how to create an operator. You can use the
information in these first two sections to create any number of groups and
operators in a Smeadlink database. The third section in this chapter will then
show you how to assign operators to groups. You will need to assign each
one of your operators to a group before you can set up access rights for it.
The fourth section will show you how to remove existing groups and operators from a Smeadlink database. If you want to remove the default groups
and operators that came with your Smeadlink database, you could do so
using the information in this section. The fifth section in this chapter will
show you how to use network security with a group. Using network security
means that you do not have to create any operators for a group. Instead, you
specify a network file, and if a system user has access to that network file
then they will become members of the group.
The sixth section in this chapter will show you how to assign access rights
for the groups in a database. This section will explain the options on the
Tables, Workgroups and System views, and show you how to use them to
specify which components your groups can access. The last section in this
chapter will then show you how to print, export and resize the rows in a
Security Manager view.
Using Security Manager
61
Creating a Group
The first step in assigning access rights for a Smeadlink database is to create
the different groups that your operators will be divided into. As you learned
earlier, each Smeadlink database comes with three default groups: the Everyone Group, the Editor Group and the Administrator Group. The Everyone Group includes the default Guest, Editor and Manager operators, the
Editor Group includes the default Editor and Manager operators and the
Manager group includes the default Manager operator.
If you do not want to create any additional groups in your database, then you
may want to skip this section and go straight to the next section. Otherwise,
this section will show you how to create a new group in the open Smeadlink
database. You can use the information in this section to add any number of
groups to the open database.
To add a group to the open Smeadlink database:
1. Open the Groups view in the Security Manager program. To open the
Groups view:
• Open the Go menu from the main menu bar.
• Click the Groups command in the bottom section of the Go menu.
The Groups view will now appear in the main Security Manager window.
The number of rows in the Groups view will be determined by the number
of groups in the open Smeadlink database. The example below shows what
the Groups view looks like.
Groups view
62
Chapter 4
2. In the Name cell of the blank row at the bottom of the view, type the
desired name for the new group.
As soon as you begin typing, a pencil will appear in the row selector of the
row you are typing in, and a new, blank row will be created at the bottom of
the view. The example below shows what the Groups view will look like
after you begin adding a new group. The new group in the example is called
Test Group.
New group in the Groups view
3. Now save the new group. There are several ways to save a group, and
each method is explained below.
• Click the Save Row command on the Rows menu.
• Use the Up or Down arrow keys on the keyboard to move to another
row in the open view.
• Use the TAB key on the keyboard to move to the row beneath the new
row.
• Click on another row in the open view.
After you use one of the methods above to save the new group, the Id cell of
the new group's row will automatically be filled in, and the pencil at the left
of the group's row will disappear to let you know that the group has been
saved.
Using Security Manager
63
Creating an Operator
Once you have created the groups in the open database that your operators
will be divided into, then you will be ready to create the different operators
for each group. As you learned earlier, each Smeadlink database includes
three default operators called Guest, Editor and Manager. If you want to
leave the default operators as they are, then you may want to skip this section and go straight to the section later in this chapter called Assigning Access Rights for a Group. Otherwise, this section will show you how to create
a new operator. You can use the information in this section to create any
number of operators in the open Smeadlink database.
To create an operator in a Smeadlink database:
1. Open the Operators view in the Security Manager program. To open the
Operators view:
• Open the Go menu from the main menu bar.
• Click the Operators command in the bottom section of the Go menu.
The Operators view will now appear in the main Security Manager window.
The number of rows in the Operators view will be determined by the number of operators in the open Smeadlink database. The example below shows
what the Operators view looks like.
Operators view
64
Chapter 4
2. In the User Name cell of the blank row at the bottom of the view, type the
desired user name for the new operator.
The user name will be used along with the password to log in to the open
Smeadlink database. As soon as you begin typing the user name for the new
operator, a pencil will appear in the row selector of the row you are typing in
and a new, blank row will be created at the bottom of the view. The example
below shows what the Operators view looks like when you begin adding an
operator.
New operator in Operators view
3. In the Full Name cell of the same row, type the desired full name for the
new operator.
Full Names are used for reference purposes only—they help to distinguish
between the different operators in a database.
4. If your security system requires you to change passwords at regular intervals, then enter today's date in the Last Password Update cell.
Like the Full Name cell, the Last Password Update cell is used for reference
purposes. It gives you a convenient place to store the date that the password
for each operator was last changed. The Last Password Update cell is entirely optional, so if your security system does not require you to change
passwords at regular intervals or if you have another place to store the dates
when you change passwords, you can leave this cell blank.
Using Security Manager
65
5. Enter the desired password for the new operator in the Password cell.
Each password can be at most eight characters long, and it can be any combination of letters, numbers or symbols. The password for this operator will
be used along with the user name to log in to the open Smeadlink database.
6. If you would like to enter any miscellaneous information about the new
operator, then type it now in the Miscellaneous 1 and Miscellaneous 2 cells.
Both Miscellaneous cells are entirely optional, so you can leave them blank
if you would like.
7. Now save the new operator. There are several ways to save an operator,
and each method is explained below.
• Click the Save Row command on the Rows menu.
• Use the Up or Down arrow keys on the keyboard to move to another
row in the open view.
• Use the TAB key on the keyboard to move to the row beneath the new
row.
• Click on another row in the open view.
After you use one of the methods above to save the new operator, the pencil
at the left of the operator's row will disappear to let you know that the operator has been saved.
66
Chapter 4
Assigning Operators to Groups
After you have created the groups and operators for your database, the next
step in assigning access rights for the database is to assign your operators to
the appropriate groups. As you learned in the previous chapter, there are two
methods for assigning an operator to a group. The first method is convenient
if you would like to assign multiple operators to one group, and the second
method is convenient if you would like to make one operator a member of
multiple groups. You can use either method to assign one operator to a group.
This section will explain both methods.
To assign multiple operators to one group:
1. Open the Groups view.
2. Activate the row of the group you would like to add operators to. You can
activate a row by selecting it or by clicking in one of its cells. To select a
row:
• Click the row selector of the desired row.
The row selector is the gray box at the very left side of each row. The row
will appear highlighted after you click its row selector, to indicate that it is
now selected.
3. Open the User Name list. There are multiple ways to open the User Name
list, and each method is explained below:
• Open the Go menu and click the Down One Level command.
OR
• Place the mouse pointer over the selected row, and then double-click
the right mouse button.
The User Name list will now appear. The User Name list will display the
names of all the operators that are members of the group you activated in
step 2. The example on the following page shows what the User Name list
looks like. The operators in the example are the default members of the
Everyone group.
Using Security Manager
67
User Name list
4. Open the Operators dropdown menu from the empty cell at the bottom of
the User Name list. To open the Operators dropdown:
• Click once in the empty cell at the bottom of the User Name list. A
down arrow will appear on the right side of the cell after you have
clicked in it.
• Click the down arrow. The Operators dropdown will now appear. This
dropdown lists all the operators in the open database.
5. Click the desired operator in the Operators dropdown.
The operator you selected will now appear in the selected row, and a new,
empty row will appear at the bottom of the User Name list.
6. Click in another cell on the User Name list.
The row you just created will now be saved, and the operator will be added
to the selected group.
7. You can continue adding operators to the selected group by repeating
steps 4, 5 and 6 for each operator that you would like to add to this group.
68
Chapter 4
To make one operator a member of multiple groups:
1. Open the Operators view.
2. Activate the row of the desired operator. You can activate a row by selecting it or by clicking in one of its cells. To select a row:
• Click the row selector of the desired row.
The row selector is the gray box at the very left side of each row. The row
will appear highlighted after you click its row selector, to indicate that it is
now selected.
3. Open the Group list. There are multiple ways to open the Group list, and
each method is explained below:
• Open the Go menu and click the Down One Level command.
OR
• Place the mouse pointer over the selected row, and then double-click
the right mouse button.
The Group list will now appear. The Group list displays the names of all the
groups that the selected operator is a member of. The example below shows
what the Group list looks like. The groups in the example are the groups that
the default Manager operator is a member of.
Group list
Using Security Manager
69
4. Open the Groups dropdown menu from the empty cell at the bottom of
the Group list. To open the Groups dropdown:
• Click once in the empty cell at the bottom of the Group list. A down
arrow will appear on the right side of the cell after you have clicked it.
• Click the down arrow. The Groups dropdown will now appear. This
dropdown lists all the groups in the open database.
5. Click the desired group in the Groups dropdown.
The group you selected will now appear in the selected row, and a new,
empty row will appear at the bottom of the Group list.
6. Click in another row on the Group list.
The row you just created will now be saved, and the selected operator will
become a member of this group.
7. You can continue adding groups by repeating steps 4, 5 and 6 for each
group that you would like the selected operator to be a member of.
70
Chapter 4
Removing a Group or Operator
As you work with Security Manager, you will eventually want to remove
some of your existing groups and operators. For instance, you may want to
remove the default groups and operators that come with a Smeadlink database, and then create all the groups and operators for the database from
scratch. This section will show you how to remove a group or operator. You
can use the information in this section to remove any number of groups or
operators from the open Smeadlink database.
To remove a group or operator:
1. Open the Groups or Operators view.
2. Activate the row of the desired group or operator. You can activate a row
by selecting it or by clicking in one of its cells. To select a row:
• Click the row selector of the desired row.
The row selector is the gray box at the very left side of each row. The row
will appear highlighted after you click its row selector, to indicate that it is
now selected.
Note: You can select multiple rows for deletion by holding down the SHIFT
key while you click the row selectors.
3. Click the Delete Row command on the Rows menu, or press the delete key
on your keyboard.
The Delete Rows window will appear as shown below asking if you want to
delete the selected row (or rows).
Delete Rows message window
4. Click the OK button on the message window, or press ENTER. The selected row or rows will now be deleted from the open view.
Using Security Manager
71
Using Network Security
If your Smeadlink system will be used by a lot of different people, then
using network security can dramatically reduce the time it takes you to assign and maintain access rights for your system. Using network security
means that you do not need to create any operators for the groups in your
Smeadlink database. Instead, you specify a network file for each group, and
if any system users have access to the specified network file, then they will
become members of that group.
When a system user logs into a Smeadlink database that has been set up for
network security, they will only need to enter their Windows user name (no
password). Smeadlink will then assume that any security issues have been
handled at the system level, and it will allow the user to view all the Smeadlink
components that the user's group has access to.
Network security options are available in Security Manager because most
larger companies have already set up access rights for their employees at a
system level. Network security eliminates the need to create and work with
operators for a large number of Smeadlink users. This section will show you
how to enable network security for a Smeadlink database, and how to specify
a network file for each group in the database.
Note: This section assumes that you have already created the groups in the
database you will be working with. For information about creating a group,
see the section earlier in this chapter called Creating a Group.
To enable network security for a Smeadlink database:
1. Open the Tools menu from Security Manager's main menu bar, and click
the Options command.
The Options window will now appear, and the Security folder in the Options
window will be open because the Options window was opened from Security Manager. The example on the following page shows what the Options
window looks like when you open it from Security Manager.
72
Chapter 4
Options window
2. Set the Network Security enabled option in the Security folder to Yes.
Network security will now be enabled for the open Smeadlink database, and
you will need to specify a network file for each group in the database. The
instructions below will show you how to specify a network file for a group.
You can use this procedure to specify network files for any number of groups.
To specify a network file for a group:
1. Open the Groups view.
2. In the Network File cell of the group's row, type the name of the desired
network file.
3. Press the Down arrow key once to move to the next row in the view and
save your changes.
Using Security Manager
73
Assigning Access Rights for the Groups in a Database
Once you have created the groups in a database and specified the operators
in each group, then you will be ready to assign access rights for your groups.
Access rights are assigned in Security Manager using the Tables, Workgroups and System views. This section will show you how to use these three
views to specify access rights for the groups in a database.
Assigning Access Rights in the Tables View
Tables view
The Tables view lists all the user tables in the open Smeadlink database.
Each row in the Tables view corresponds to one user table in the database.
You can use the Tables view to specify which groups have view, add, edit
and delete privileges for each table. View privileges determine which group
can see the folders or subfolders in Smeadlink that are based on the table,
add privileges determine which group can add rows to the those folders or
subfolders, edit privileges determine which group can edit rows in those
folders or subfolders and delete privileges determine which group can delete rows from those folders or subfolders.
The Tables view contains five columns: Table, View Privileges, Edit Privileges, Add Privileges and Delete Privileges. The Table column displays all
the different tables in the open database, and the remaining columns display
the groups that have view, edit, add and delete privileges for each table. The
default setting for all the cells in the View, Edit, Add and Delete Privileges
columns is Everybody Group. This means that the default Guest, Editor and
Manager operators will all be able to see every table in the Smeadlink or
Database Layout programs, and they will all have edit, add and delete privileges for every table.
74
Chapter 4
In addition to assigning view, edit, add and delete privileges for the tables in
the open database, the Tables view also allows you assign access privileges
for the Smeadlink views that are based on each table. This is helpful if you
have some views that can only be viewed by certain users, and other views
in the same folders that need to be viewed by all users.
The first part of this section will show you how to modify the setting in one
cell of the Tables view. You can use this information to adjust the table
privileges for all the groups in your database. The second part will then
show you how to modify access privileges for all the Smeadlink views that
are based on a table. You can use this information to modify the access
privileges for any view in the open database.
To modify the setting in one cell of the Tables view:
1. Click the desired cell in the View, Edit, Add or Delete Privileges columns. A down arrow will now appear at the right side of the cell you clicked
in.
2. Click the down arrow. A dropdown menu will now appear listing the
different groups in the open database. The example below shows what the
dropdown menu looks like.
Tables dropdown menu
3. Click the desired group in the dropdown menu. The group you selected
will now appear in this cell.
4. Save your change.
Using Security Manager
75
To modify the access privileges for all the views based on a table:
1. Activate the row of the table that the desired views are based on.
2. Click the Down One Level button on the Go menu.
The View list will now appear. The View list contains two columns. The first
column lists the name of all the Smeadlink views that are based on the
selected table, and second column lists the group that has access privileges
for each view. The example below shows what the View list looks like. The
list in the example contains three views.
View list
3. Click the View Privileges cell of the desired view. A down arrow will now
appear at the right side of the cell you clicked in.
4. Click the down arrow. A dropdown menu will now appear listing the
different groups in the open database.
5. Click the desired group in the dropdown menu. The group you selected
will now appear in the selected cell.
6. Save your change.
7. Repeat steps 3–6 for each view in the list that you want to modify access
privileges.
76
Chapter 4
Assigning Access Rights in the Workgroups View
Workgroups view
The Workgroups view lists all the workgroups in the open Smeadlink database. Each row in the Workgroups view corresponds to one workgroup in
the database. The Workgroups view allows you to specify which groups
have view privileges for the workgroups in the database. View privileges
determine which groups can see each workgroup in the Smeadlink or Database Map programs.
The Workgroups view contains two columns called Workgroup and View
Privileges. The Workgroup column displays the different workgroups in the
database, and the View Privileges column displays the groups that have view
privileges for each workgroup. The default setting for all the cells in the
View Privileges column is No Security. This means that every Smeadlink
operator in the database will be able to see all the workgroups in the database. The following instructions will show you how to adjust the setting for
a cell in the View Privileges column. You can use these instructions to set
the view privileges for any number of workgroups.
To adjust the setting for a cell in the View Privileges column:
1. Click the desired cell in the View Privileges column. A down arrow will now
appear at the right side of the cell you clicked in.
2. Click the down arrow. A dropdown menu will now appear listing the different groups in the open database.
3. Click the desired group in the dropdown menu. The menu will now close,
and the group you selected will appear in the selected cell.
4. Save your change.
Using Security Manager
77
Assigning Access Rights in the System View
System view
Unlike the Tables and Workgroups views, the System view does not list
specific components in your Smeadlink database. Instead, it lists all the general components in your Smeadlink system, and it allows you to specify
which group will have access to each component. The System view contains
two columns called Property and Value. The Property column displays all
the general components in your Smeadlink system, and the Value column
displays the groups that have access to each component.
The cells in the Property column are set according to the default Smeadlink
access rights you learned about in chapter 3, so administrative components
are only available to the default Manager group, editing components are
only available to the default Editor group and general components are available to the default Everyone group. Components that are used separately
from other Smeadlink programs, such as the PC Files program, are set to No
Security. This means that any Smeadlink operator will have access to these
components, regardless of whether or not the operator is assigned to a group.
Some of the names in the Property column refer to multiple components in
Smeadlink. The table on the following pages explains which components
each name refers to. To change the Value setting for one of these items, you
can use the same method explained on the previous page for adjusting the
setting of a cell in the View Privileges column (i.e. click in the desired cell,
open the dropdown menu, click the desired group and save the change).
78
Chapter 4
Property Name
Refers to
Manager Group
The Columns and Views utilities in
Smeadlink, and the Database Map utility. If a group does not have access
rights to the Manager group, then its operators will not see any of the commands on the Columns or Views utilities, and they will only be able to view
the Database Map, they will not be able
to create or edit any tables in it.
Redlining/Annotations Add/Edit/
Delete
The Redlining and Annotations features
in Smeadlink's Image Viewer and
Manual Indexing Viewer. If a group does
not have rights to Redlining/Annotations
Add/Edit/Delete, then its operators will
not be able to modify annotations or
redlining objects on images in the Image Viewer or the Manual Indexing utility.
Redlining/Annotations View
The Redlining and Annotations features
in Smeadlink's Image Viewer and
Manual Indexing Viewer. If a group
does not have rights to Redlining/Annotations View, then its operators will
not be able to view annotations or
redlining objects on images in the Image Viewer or the Manual Indexing utility.
ERM Group
ERM imports in the Import Wizard utility. If a group does not have rights to
the ERM Group, then its operators will
not be able to view ERM imports.
Import Group
The Import Wizard utility. If a group
does not have rights to the Import
Group, then its operators will not be able
to open the Import Wizard, and the Import command on Smeadlink's Tools
menu will be unavailable.
Using Security Manager
79
ColorBar Label Integrator
Group
The ColorBar Label Integrator utility. If
a group does not have rights to the
ColorBar Label Integrator Group, then
the ColorBar Label Integrator command
on Smeadlink's Tools menu will be unavailable to the group's operators.
Database Toolkit Group
The Database Toolkit utility. If a group
does not have rights to the Database
Toolkit Group, then the Database Toolkit command on Smeadlink's Tools menu
will be unavailable to the group's operators.
Scanner Group
The Scanner program and the Manual
Indexing utility in Smeadlink. If a group
does not have rights to the Scanner
Group, then the Scanner command on
the Tools menu will be unavailable to
the group's operators. The Manual Indexing command on the View menu will
also be unavailable to the operators in
the group.
Security Manager Group
The Security Manager utility. If a group
does not have rights to the Security
Manager Group, then the Security Manager command on Smeadlink's Tools
menu will be unavailable to the group's
operators.
Tracking Group
The Tracking program. If a group does
not have rights to the Tracking Group,
then the Bar Code Tracking command
on Smeadlink's Go menu will be unavailable to the group's operators.
80
Chapter 4
Printing, Exporting and Resizing the Rows in a View
The five views in the Security Manager program function similarly to views
in Smeadlink. You can select different rows in each view, and then print or
export the data in the selected rows. You can also resize the rows in a view
by stretching the row cells horizontally or by stretching them vertically. The
procedures for printing, exporting and resizing rows are explained in detail
in the Smeadlink User's Guide. The section names and page numbers for
each task are listed below.
• For information about printing (including both the print setup process
and the actual print process), see the sections Print Setup and Printing
Reports in chapter 7 of the User's Guide. The Print Setup section starts
on page 109, and the Printing a Report section starts on page 112.
Note: When going through the print setup process in Smeadlink, it is
necessary to go through the process two times if you will be printing
both reports and images. In Security Manager, however, you only need
to go through the print setup process once.
• For information about exporting, see the section Exporting Rows in
chapter 7 of the User's Guide. The Exporting Rows section starts on
page 127.
• For information about resizing the rows in a view, see the section Adjusting the Size of Rows in a View in chapter 5 of the User's Guide.
This section starts on page 69.
Using Import Wizard
5. Using Import Wizard
Chapter contents
Introduction
Creating an Import for a Delimited Text File
Creating an Import for a Fixed Width Text File
Creating an Import for an Excel Object
Creating an Import for an Access Table
Setting up an Import for Importing Images
Creating an Import for the Denso Portable Scanner
Modifying an Import
Creating an Import Job
Modifying an Import Job
Removing an Import or an Import Job
Running an Import or an Import Job
81
82
Chapter 5
Introduction
The previous chapter showed you how to assign access rights for a Smeadlink
database. You learned how to use the Groups and Operators views in Security Manager to create the groups in a database and assign the operators for
each group, and you also learned how to assign access rights for your groups
using the Tables, Workgroups and System views.
This chapter will show you to use Import Wizard to import data into your
Smeadlink database. As you learned in chapter 1, the first step in importing
data into a Smeadlink database is to create an import load. An import load is
similar to a Scanner rule—it is a group of settings that determines things like
which file to import data from and which folder or subfolder to import data
into. The process for creating import loads varies somewhat according to
what type of file you want to import. This chapter will show you how to
create import loads for the various types of files that you can import with
Import Wizard, including delimited text files, fixed width text files, Excel
objects and Access tables.
In addition to creating import loads for general file types, this chapter will
also show you how to set up two kinds of specialized imports. The first
specialized import load is for importing tracking data from the Denso BHT6000 portable scanner, and the second is for importing images into Smeadlink
and attaching them to Smeadlink rows. After you learn how to create the
different types of import loads, this chapter will show you how to modify or
remove existing import loads. You will then learn how to import data into
your Smeadlink database by running an existing import load.
Note: From this point forward, this chapter will refer to import loads as
simply imports. This is done to make the chapter easier to read, and also to
reflect what import loads are called by Smeadlink Technical Support.
In addition to working with imports, this chapter will also show you how to
work with import jobs. A job is a group of imports. When you run a job, the
imports it contains are run one after another in the order they were added to
the job. The capability to group imports into jobs was added to Import Wizard in Smeadlink 3 to streamline the import process when multiple imports
need to be run.
Note: For a summary of the Import Wizard utility and its function in your
Smeadlink system, see the section Smeadlink Administrative Utilities...Import
Wizard in chapter 1 of this manual.
Using Import Wizard
83
Creating an Import for a Delimited Text File
Creating an import is the first step in the process of importing a file into your
Smeadlink database. An import is similar to a Scanner rule—it is a group of
settings that determines things like which file to import data from, which
table to import data into and which column to import rows by.
The process for creating an import varies somewhat depending on what type
of file you would like to import data from. This section will show you how
to create an import for a delimited text file. If you need to create an import
for a different type of file, see one of the next three sections in this chapter
(these sections explain how to create imports for fixed-length text files, Excel objects and Access tables).
To create an import for a delimited text file:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Load command on the New submenu. The Select Import File
window will now appear as shown below.
Select Import File window
3. Select the desired delimited text file in the Select Import File window,
and then click the Open button.
The Select Import File window will now close, and the second Import Wizard window will appear. The example on the following page shows what the
second Import Wizard window looks like.
84
Chapter 5
Second Import Wizard window
4. Select the desired number of rows to sample from the import file. To
select the desired number of rows:
• Click the arrows at the right of the box labeled Number of Rows to
Sample. Clicking an arrow will increase or decrease the current number by 10.
You can sample between 10 and 90 rows from the import file. The sample
rows will be displayed in the middle of the second, third, fourth and fifth
Import Wizard windows, and the purpose of the sample rows is to help you
set the options on these windows. The default number of rows to sample is
20, so when the second Import Wizard window appears you will see the first
20 rows in the selected file.
5. Make sure the Delimited option is selected (the Delimited option is the
first option in the Format section of the window).
6. If the first row of your import file contains column names, then check the
First Row contains Field Names box.
Once you check this option, Import Wizard will remove the column names
from the other sample rows and place each name in the column header of the
appropriate column. If the first row of your import file contains column
names and you leave this box unchecked, then the column names will be
imported as data.
Using Import Wizard
85
7. Select the delimiter for the columns in your import file.
• If the delimiter is a comma, tab, semicolon or space, then select the
appropriate option.
• If the delimiter is another symbol, then select the Other option and
type your delimiter in the provided text box.
Once you select the correct delimiter for your import file, the sample row
columns will become correctly aligned. If you select the wrong delimiter,
then only one column in your sample rows will be displayed.
8. Click the Next button at the bottom of the second Import Wizard window.
The third Import Wizard window will now appear as shown below.
Third Import Wizard window
9. Select the desired destination table in the open Smeadlink database. To
select a destination table:
• Click the down arrow at the right of the Destination box. A dropdown
will now appear that lists all the tables in the open database.
• Click the desired table in the dropdown. The name of the table you
clicked will now appear in the Destination box.
86
Chapter 5
10. Select which columns in the import file will correspond to which columns in the destination table. Data from each column in the import file will
be imported into the specified corresponding column in the destination table.
To select corresponding columns:
• Click the column header of one of your sample data columns. The
column will now turn blue to indicate that it is selected.
• Click the column in the Available Fields box that you would like to set
as the corresponding column for the selected sample data column.
Note: In addition to the columns in the destination folder, there are
several other options that may appear in the Available Fields box.
These options are listed below.
• The <<SKIP FIELD>> option will always be displayed in the
Available Fields box. This option allows you to skip a column in
the import file, so that none of the data in the column is imported
into the destination table.
• The <<IMAGE COPY>> option will always be displayed in the
Available Fields box. This option is used for importing images. If
the delimited text file contains information for importing images,
then map the column that contains image paths to the <<IMAGE COPY>> option.
• The five tracking options <<TRACKING DESTINATION>>,
<<TRACKING DATE>>, <<TRACKING OPERATOR>>,
<<TRACKING DESTINATION>> and TRACKING OPERATOR>> will be displayed in the Available Fields box if the specified destination table is a tracking folder. These options are used
when setting up an import for a file that contains tracking data.
You will learn more about them later in this chapter.
• Click the single right arrow button once. The single right arrow button
is the first of four buttons that are located between the Available Fields
box and the Selected Fields box. Once you click this button, the column you selected from the Available Fields box will appear in the
Selected Fields box.
Using Import Wizard
87
Note: Clicking the double right arrow button will transfer all the columns in the Available Fields box to the Selected Fields box. Clicking
on a column in the Selected Fields box and then clicking the single left
arrow button will remove that column from the Selected Fields box.
Finally, clicking the double left arrow button will remove all the columns in the Selected Fields box.
• If you want to create a default value for the highlighted column in the
Selected Fields box, click the Properties button above the box. A window will now appear that allows you to enter a default value for the
highlighted column. This value will be used for any blank or zero values in the import column. If the highlighted column contains dates,
you will also be able to select the date format in the Properties window.
• Repeat the above four steps for each sample data column (i.e. for each
column in the delimited source file).
11. Click the Next button at the bottom of the third Import Wizard window.
The fourth Import Wizard window will now appear as shown below.
Fourth Import Wizard window
88
Chapter 5
12. Type the desired name for this import in the Load Name box at the top
of the fourth Import Wizard window.
13. Make sure that the Source File box displays the name of the desired
source file. If it does not, enter the desired file in the Source File box.
14. Select the desired overwrite/add option. The three overwrite/add options are explained below.
Overwrite/Add option
Description
Overwrite Existing and
Add New Records
If a row in the source file contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
source file. If a row in the source file
contains a unique Id number, then create a new row for it in the destination
table.
Overwrite Existing
Records Only
If a row in the source file contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
source file. If a row in the source file
contains a unique Id number, then write
the row to the error log.
Add New Records Only
If a row in the source file contains a
unique Id number, then create a new
row for it in the destination table. If a
row in the source file contains the same
Id number as a row in the destination
table, then write the row to the error log.
Using Import Wizard
89
15. If you would like the delimited source file to be deleted after its data has
been imported into the specified Smeadlink table, then check the Delete
Source File after Processing box.
16. Select the desired Import By option. The Import By setting determines
which column, if any, will be used as the Id column in the destination table.
• If you selected one of the two overwrite options in step 14, then you
will need to specify an Id column in this step. Smeadlink will use the
Id column and the corresponding column in the import file to determine when to overwrite rows.
• If you selected the Add New Records Only option in the previous step,
then you will not need to specify an Id column. You can select None as
your Import By setting.
17. If you would like the rows in the import file to be imported in reverse
order, check the Process in Reverse Order box.
18. Click the Next button at the bottom of the fourth Import Wizard window. The fifth Import Wizard window will now appear as shown below.
Fifth Import Wizard window
90
Chapter 5
19. The SQL Statement box allows you to update or modify other columns
in the open Smeadlink database as the import is running.
If you want to use this option, enter the desired SQL statement in the SQL
Statement box. Smeadlink will execute the SQL statement after it imports
each row into the destination table. You will need to use the token %ID% in
your SQL statement to refer to the rows in the destination table.
20. The Tracking Destination and Due Date options are both used when
creating imports for the Denso portable scanner. These options allow you to
specify a default destination and due date for objects without a specified
destination or due date. You will learn more about these options later in this
chapter.
21. If the import file contains information for importing images, you will
now need to specify which output settings will used to store the images. To
specify output settings:
• Click the arrow at the right of the Use ScanRule box. A dropdown will
now appear listing all the Scanner rules in the open database.
• Click the rule that contains the desired output settings.
• Now click the appropriate option for saving images with the Id of a
row that already has an image attached to it. Save As New Version will
save the image as a new version of the first image. Save As New Page
will save the image as a new page for the first image.
22. Click the Finish button at the bottom of the fifth Import Wizard window.
The fifth Import Wizard window will now close, and the first window will
reappear. The import you just created will be selected in the Saved Imports
box on the first Import Wizard window.
Using Import Wizard
91
Creating an Import for a Fixed Width Text File
Creating an import is the first step in the process of importing a file into your
Smeadlink database. An import is similar to a Scanner rule—it is a group of
settings that determines things like which file to import data from, which
table to import data into and which column to import rows by.
The process for creating an import varies somewhat depending on what type
of file you would like to import data from. This section will show you how
to create an import for a fixed width text file. If you need to create an import
for a different type of file, see the previous section in this chapter for information about creating an import for a delimited text file, or see the next two
sections in this chapter for information about creating imports for Excel
objects and Access tables.
To create an import for a fixed width text file:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Load button on the Smeadlink window. The Select Import File
window will now appear as shown below.
Select Import File window
3. Select the desired import file in the Select Import File window, and then
click the Open button.
The Select Import File window will now close, and the second Import Wizard window will appear. The example on the following page shows what the
second Import Wizard window looks like.
92
Chapter 5
Second Import Wizard window
4. Select the number of rows that you would like to sample from the import
file. To select the desired number of rows:
• Click the arrows at the right of the box labeled Number of Rows to
Sample. Clicking an arrow will increase or decrease the current number by 10.
You can sample between 10 and 90 rows from the import file. The sample
rows will be displayed in the middle of the second, third, fourth and fifth
Import Wizard windows, and the purpose of the sample rows is to help you
set the options on these windows. The default number of rows to sample is
20, so when the second Import Wizard window appears you will see the first
20 rows in the selected file.
5. Check the Fixed Width (Aligned by column) option in the Format section. The delimited options above the sample rows will now disappear, and
a scale, or ruler, will appear in their place.
Using Import Wizard
93
6. Divide the rows in the fixed width import file into columns.
To divide the rows in the import file into columns, you will need to create a
number of break lines. For instance, if your import file contains three columns of data, you will need to create two break lines to separate the columns. To create a break line:
• Place your mouse pointer over the desired break line position on the
ruler, and click the left mouse button once.
A break line will now appear over the sample rows. If you need to move the
break line, simply click it and drag it to the desired position. If you need to
remove a break line, simply double-click it. The example below shows how
two break lines have been used to separate data in an import file into three
columns.
Ruler for creating and
moving break lines
First break line
Second break line
7. Click the Next button at the bottom of the second Import Wizard window.
The third Import Wizard window will now appear as shown on the following page.
94
Chapter 5
Third Import Wizard window
8. Select the desired destination table in the open Smeadlink database. The
destination table is the table that the data in the fixed width file will be
imported into. To select a destination table:
• Click the down arrow at the right of the Destination box. A dropdown
will now appear that lists all the tables in the open database.
• Click the desired table on the dropdown. The name of the table you
clicked will now appear in the Destination box.
9. Select which columns in the import file will correspond to which columns
in the destination table. Data from each column in the import file will be
imported into the specified corresponding column in the destination table.
To select corresponding columns:
• Click the column header of one of your sample data columns. The
column will now turn blue to indicate that it is selected.
• Click the column in the Available Fields box that you would like to set
as the corresponding column for the selected sample data column.
Using Import Wizard
95
Note: In addition to the columns in the destination folder, there are
several other options that may appear in the Available Fields box.
These options are listed below.
• The <<SKIP FIELD>> option will always be displayed in the
Available Fields box. This option allows you to skip a column in
the import file, so that none of the data in the column is imported
into the destination table.
• The <<IMAGE COPY>> option will always be displayed in the
Available Fields box. This option is used for importing images. If
the fixed width text file contains information for importing images, then map the column that contains image paths to the <<IMAGE COPY>> option.
• The five tracking options <<TRACKING DESTINATION>>,
<<TRACKING DATE>>, <<TRACKING OPERATOR>>,
<<TRACKING DESTINATION>> and TRACKING OPERATOR>> will be displayed in the Available Fields box if the specified destination folder is a tracking folder. These options are used
when setting up an import for a file that contains tracking data.
You will learn more about them later in this chapter.
• Click the single right arrow button once. The single right arrow button
is the first of four buttons that are located between the Available Fields
box and the Selected Fields box. Once you click this button, the column you selected from the Available Fields box will appear in the
Selected Fields box.
Note: Clicking the double right arrow button will transfer all the columns in the Available Fields box to the Selected Fields box. Clicking
on a column in the Selected Fields box and then clicking the single left
arrow button will remove that column from the Selected Fields box.
Finally, clicking the double left arrow button will remove all the columns in the Selected Fields box.
• If you want to create a default value for the highlighted column in the
Selected Fields box, click the Properties button above the box. A window will now appear that allows you to enter a default value for the
highlighted column. This value will be used for any blank or zero value
in the import file. If the highlighted column contains dates, you will
also be able to select the date format in the Properties window.
• Repeat the above four steps for each sample data column (i.e. for each
column in the fixed width source file).
96
Chapter 5
10. Click the Next button at the bottom of the third Import Wizard window.
The fourth Import Wizard window will now appear as shown below.
Fourth Import Wizard window
11. Type the desired name for this import in the Load Name box at the top
of the fourth Import Wizard window.
12. Make sure that the Source File box displays the name of the desired
source file. If it does not, enter the desired file in the Source File box.
13. Select the desired overwrite/add option. The three overwrite/add options are explained on the following page.
Using Import Wizard
97
Overwrite/Add option
Description
Overwrite Existing and
Add New Records
If a row in the import file contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
import file. If a row in the import file
contains a unique Id number, then create a new row for it in the destination
table.
Overwrite Existing
Records Only
If a row in the import file contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
import file. If a row in the import file
contains a unique Id number, then write
the row to the error log.
Add New Records Only
If a row in the import file contains a
unique Id number, then create a new
row for it in the destination table. If a
row in the import file contains the same
Id number as a row in the destination
table, then write the row to the error log.
14. Select the desired Import By option. The Import By setting determines
which column, if any, will be used as the Id column in the destination table.
• If you selected one of the two overwrite options in the previous step,
then you will need to specify an Id column in this step. Smeadlink will
use the Id column and the corresponding column in the import file to
determine when to overwrite rows.
• If you selected the Add New Records Only option in the previous step,
then you will not need to specify an Id column. You can select None as
your Import By setting.
98
Chapter 5
15. If you would like the rows in the import file to be imported in reverse
order, check the Process in Reverse Order box.
16. Click the Next button at the bottom of the fourth Import Wizard window. The fifth Import Wizard window will now appear as shown below.
Fifth Import Wizard window
17. The SQL Statement box allows you to update or modify other columns
in the open Smeadlink database as the import is running.
If you want to use this option, enter the desired SQL statement in the SQL
Statement box. Smeadlink will execute the SQL statement after it imports
each record into the destination table. You will need to use the token %ID%
in your SQL statement to refer to the rows in the destination table.
18. The Tracking Destination and Due Date options are both used when
creating imports for the Denso portable scanner. These options allow you to
specify a default destination and due date for objects without a specified
destination or due date. You will learn more about these options later in this
chapter.
Using Import Wizard
99
19. If the import file contains information for importing images, you will
now need to specify which output settings will used to store the images. To
specify output settings:
• Click the arrow at the right of the Use ScanRule box. A dropdown will
now appear listing all the Scanner rules in the open database.
• Click the rule that contains the desired output settings.
• Now click the appropriate option for saving images with the Id of a
row that already has an image attached to it. Save As New Version will
save the image as a new version of the first image. Save As New Page
will save the image as a new page for the first image.
20. Click the Finish button at the bottom of the fifth Import Wizard window.
The fifth Import Wizard window will now close, and the first window will
reappear. The import you just created will be selected in the Saved Imports
box on the first Import Wizard window.
100
Chapter 5
Creating an Import for an Excel Object
Creating an import is the first step in the process of importing a file into your
Smeadlink database. An import is similar to a Scanner rule—it is a group of
settings that determines things like which file to import data from, which
table to import data into and which column to import rows by.
The process for creating an import varies somewhat depending on what type
of file you would like to import data from. This section will show you how
to create an import for an Excel object. If you need to create an import for a
different type of file, see the previous sections in this chapter for information about creating an import for a delimited text file or a fixed width text
file, or see the next section in this chapter for information about creating an
import for an Access table.
To create an import for an Excel object:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Yes button on the Smeadlink window. The Select Import File
window will now appear as shown in the example below.
Select Import File window
3. Select the desired Excel object in the Select Import File window, and then
click the Open button.
The Select Import File window will now close, and the second Import Wizard window will appear as shown on the following page.
Using Import Wizard
101
Second Import Wizard window
4. Select the number of rows that you would like to sample from the Excel
object. To select the desired number of rows:
• Click the arrows at the right of the box labeled Number of Rows to
Sample. Clicking an arrow will increase or decrease the current number by 10.
You can sample between 10 and 90 rows from the Excel object. The sample
rows will be displayed in the middle of the second, third, fourth and fifth
Import Wizard windows, and the purpose of the sample rows is to help you
set the options on these windows. The default number of rows to sample is
20, so when the second Import Wizard window appears you will see the first
20 rows in the selected Excel object.
5. If the Excel object you selected in step 3 contains more than one worksheet
or named range, then you will now need to select which one you would like
to import data from. To select a worksheet or named range:
• Click the desired worksheet or named range in the list under the Number of Rows to Sample box.
102
Chapter 5
6. If the first row of the Excel object contains column names, then check the
First Row contains Field Names box.
Once you check this option, Import Wizard will remove the column names
from the other sample row data and place each name in the column header
of the appropriate column. If the first row of your Excel object contains
column names and you leave this box unchecked, then the column names
will be imported as data.
7. Click the Next button at the bottom of the second Import Wizard window.
The third Import Wizard window will now appear as shown below.
Third Import Wizard window
8. Select the desired destination table in the open Smeadlink database. The
destination table is the table that the data in the Excel object will be imported into. To select a destination table:
• Click the down arrow at the right of the Destination box. A dropdown
will now appear that lists all the tables in the open database.
• Click the desired table on the dropdown. The name of the table you
clicked will now appear in the Destination box.
Using Import Wizard
103
9. Select which columns in the Excel object will correspond to which columns in the destination table. Data from each column in the Excel object
will be imported into the corresponding column in the destination table. To
specify corresponding columns:
• Click the column header of one of your sample data columns. The
column will now turn blue to indicate that it is selected.
• Click the column in the Available Fields box that you would like to set
as the corresponding column for the selected sample data column.
Note: In addition to the columns in the destination folder, there are
several other options that may appear in the Available Fields box.
These options are listed below.
• The <<SKIP FIELD>> option will always be displayed in the
Available Fields box. This option allows you to skip a column in
the import file, so that none of the data in the column is imported
into the destination folder.
• The <<IMAGE COPY>> option will always be displayed in the
Available Fields box. This option is used for importing images. If
the import object contains information for importing images, map
the column that contains image paths to the <<IMAGE COPY>>
option.
• The five tracking options <<TRACKING DESTINATION>>,
<<TRACKING DATE>>, <<TRACKING OPERATOR>>,
<<TRACKING DESTINATION>> and TRACKING OPERATOR>> will be displayed in the Available Fields box if the specified destination folder is a tracking folder. These options are used
when setting up an import for a file that contains tracking data.
You will learn more about them later in this chapter.
• Click the single right arrow button once. The single right arrow button
is the first of four buttons that are located between the Available Fields
box and the Selected Fields box. Once you click this button, the column you selected from the Available Fields box will appear in the
Selected Fields box.
104
Chapter 5
Note: Clicking the double right arrow button will transfer all the columns in the Available Fields box to the Selected Fields box. Clicking
on a column in the Selected Fields box and then clicking the single left
arrow button will remove that column from the Selected Fields box.
Finally, clicking the double left arrow button will remove all the columns in the Selected Fields box.
• If you want to create a default value for the highlighted column in the
Selected Fields box, click the Properties button above the box. A window will now appear that allows you to enter a default value for the
highlighted column. This value will be used for any blank or zero
value in the import file. If the highlighted column contains dates, you
will also be able to select the date format in the Properties window.
• Repeat the above four steps for each sample data column (i.e. for each
column in the Excel object).
10. Click the Next button at the bottom of the third Import Wizard window.
The fourth Import Wizard window will now appear as shown below.
Fourth Import Wizard window
Using Import Wizard
105
11. Type the desired name for this import in the Load Name box at the top
of the fourth Import Wizard window.
12. Make sure that the Source File box displays the name of the desired
source file. If it does not, enter the desired file in the Source File box.
13. Select the desired overwrite/add option. The three overwrite/add options are explained in the table below.
Overwrite/Add option
Description
Overwrite Existing and
Add New Records
If a row in the Excel object contains
the same Id number as a row in the destination table, then replace the row in
the destination table with the row from
the Excel object. If a row in the Excel
object contains a unique Id number,
then create a new row for it in the destination table.
Overwrite Existing
Records Only
If a row in the Excel object contains
the same Id number as a row in the destination table, then replace the row in
the destination table with the row from
the Excel object. If a row in the Excel
object contains a unique Id number,
then write the row to the error log.
Add New Records Only
If a row in the Excel object contains a
unique Id number, then create a new
row for it in the destination table. If a
row in the Excel object contains the
same Id number as a row in the destination table, then write the row to the
error log.
106
Chapter 5
14. Select the desired Import By option. The Import By setting determines
which column, if any, will be used as the Id column in the destination folder
or subfolder.
• If you selected one of the two overwrite options in the previous step,
then you will need to specify an Id column in this step. Smeadlink will
use the Id column and the corresponding column in the Excel object to
determine when to overwrite rows.
• If you selected the Add New Records Only option in the previous step,
then you will not need to specify an Id column. You can select None as
your Import By setting.
15. If you would like the rows in the Excel object to be imported in reverse
order, check the Process in Reverse Order box.
16. Click the Next button at the bottom of the fourth Import Wizard window.
The fifth Import Wizard window will now appear. The example below shows
what the fifth Import Wizard window looks like.
Fifth Import Wizard window
Using Import Wizard
107
17. The SQL Statement box allows you to update or modify other columns
in the open Smeadlink database as the import is running.
If you want to use this option, enter the desired SQL statement in the SQL
Statement box. Smeadlink will execute the SQL statement after it imports
each record into the destination table. You will need to use the token %ID%
in your SQL statement to refer to the rows in the destination table.
18. The Tracking Destination and Due Date options are both used when
creating imports for the Denso portable scanner. These options allow you to
specify a default destination and due date for objects without a specified
destination or due date. You will learn more about these options later in this
chapter.
19. If the Excel object contains information for importing images, you will
now need to specify which output settings will used to store the images. To
specify output settings:
• Click the arrow at the right of the Use ScanRule box. A dropdown will
now appear listing all the Scanner rules in the open database.
• Click the rule that contains the desired output settings.
• Now click the appropriate option for saving images with the Id of a
row that already has an image attached to it. Save As New Version will
save the image as a new version of the first image. Save As New Page
will save the image as a new page for the first image.
20. Click the Finish button at the bottom of the fifth Import Wizard window.
The fifth Import Wizard window will now close, and the first window will
reappear. The import you just created will be selected in the Saved Imports
box on the first Import Wizard window.
108
Chapter 5
Creating an Import for an Access Table
Creating an import is the first step in the process of importing a file into your
Smeadlink database. An import is similar to a Scanner rule—it is a group of
settings that determines things like which file to import data from, which
table to import data into and which column to import rows by.
The process for creating an import varies somewhat depending on what type
of file you would like to import data from. This section will show you how
to create an import for an Access table. If you need to create an import for a
different type of file, see the previous three sections in this chapter for information about creating an import for a delimited text file a fixed width text
file, or an Excel object.
To create an import for an Access table:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Yes button on the Smeadlink window. The Select Import File
window will now appear as shown in the example below.
Select Import File window
3. Select the database that contains the desired table, and then click the Open
button.
The Select Import File window will now close, and the second Import Wizard window will appear as shown on the following page.
Using Import Wizard
109
Second Import Wizard window
4. Select the number of rows that you would like to sample from the import
table. To select the desired number of rows:
• Click the arrows at the right of the box labeled Number of Rows to
Sample. Clicking an arrow will increase or decrease the current number by 10.
You can sample between 10 and 90 rows from the import table. The sample
rows will be displayed in the middle of the second, third, fourth and fifth
Import Wizard windows, and the purpose of the sample rows is to help you
set the options on these windows. The default number of rows to sample is
20, so when the second Import Wizard window appears you will see the first
20 rows in the selected Access table.
5. If the database you selected in step 3 contains more than one table, then
you will now need to select which table in the database you would like to
import data from. To select a table:
• Click the desired table in the list under the Number of Rows to Sample
box. In the example at the top of this page, the open database contains
two Access tables called Customers and Employees.
110
Chapter 5
6. Click the Next button at the bottom of the second Import Wizard window.
The third Import Wizard window will now appear as shown below.
Third Import Wizard window
7. Select the desired destination table in the open Smeadlink database. The
destination table is the table that the data in the selected Access table will be
imported into. To select a destination table:
• Click the down arrow at the right of the Destination box. A dropdown
will now appear that lists all the tables in the open database.
• Click the desired table on the dropdown. The name of the table you
clicked will now appear in the Destination box.
8. Select which columns in the import Access table will correspond to which
columns in the destination table. Data from each column in the import table
will be imported into the specified corresponding column in the destination
table. To select corresponding columns:
• Click the column header of one of your sample data columns. The
column will now turn blue to indicate that it is selected.
• Click the column in the Available Fields box that you would like to set
as the corresponding column for the selected column.
Using Import Wizard
111
Note: In addition to the columns in the destination table, there are
several other options that may appear in the Available Fields box.
These options are listed below.
• The <<SKIP FIELD>> option will always be displayed in the
Available Fields box. This option allows you to skip a column in
the import file, so that none of the data in the column is imported
into the destination folder.
• The <<IMAGE COPY>> option will always be displayed in the
Available Fields box. This option is used for importing images. If
the import table contains information for importing images, map
the column that contains image paths to the <<IMAGE COPY>>
option.
• The five tracking options <<TRACKING DESTINATION>>,
<<TRACKING DATE>>, <<TRACKING OPERATOR>>,
<<TRACKING DESTINATION>> and TRACKING OPERATOR>> will be displayed in the Available Fields box if the specified destination folder is a tracking folder. These options are used
when setting up an import for a file that contains tracking data.
You will learn more about them later in this chapter.
• Click the single right arrow button once. The single right arrow button
is the first of four buttons that are located between the Available Fields
box and the Selected Fields box. Once you click this button, the column you selected from the Available Fields box will appear in the
Selected Fields box.
Note: Clicking the double right arrow button will transfer all the columns in the Available Fields box to the Selected Fields box. Clicking
on a column in the Selected Fields box and then clicking the single left
arrow button will remove that column from the Selected Fields box.
Finally, clicking the double left arrow button will remove all the columns in the Selected Fields box.
• If you want to create a default value for the highlighted column in the
Selected Fields box, click the Properties button above the box. A window will now appear that allows you to enter a default value for the
highlighted column. This value will be used for any blank or zero value
in the import table. If the highlighted column contains dates, you will
also be able to select the date format in the Properties window.
112
Chapter 5
• Repeat the above four steps for each sample data column (i.e. for each
column in the Access table).
9. Click the Next button at the bottom of the third Import Wizard window.
The fourth Import Wizard window will now appear as shown below.
Fourth Import Wizard window
10. Type the desired name for this import in the Load Name box at the top
of the fourth Import Wizard window.
11. Make sure that the Source File box displays the name of the desired
source file. If it does not, enter the desired file in the Source File box.
12. Select the desired overwrite/add option. The three overwrite/add options are explained in the table on the following page.
Using Import Wizard
113
Overwrite/Add option
Description
Overwrite Existing and
Add New Records
If a row in the import table contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
import table. If a row in the import table
contains a unique Id number, then create a new row for it in the destination
table.
Overwrite Existing
Records Only
If a row in the import table contains the
same Id number as a row in the destination table, then replace the row in the
destination table with the row from the
import table. If a row in the import table
contains a unique Id number, then write
the row to the error log.
Add New Records Only
If a row in the import table contains a
unique Id number, then create a new
row for it in the destination table. If a
row in the import table contains the
same Id number as a row in the destination table, then write the row to the
error log.
13. Select the desired Import By option. The Import By setting determines
which column, if any, will be used as the Id column in the destination table.
• If you selected one of the two overwrite options in the previous step,
then you will need to specify an Id column in this step. Smeadlink will
use the Id column and the corresponding column in the import table to
determine when to overwrite records.
• If you selected the Add New Records Only option in the previous step,
then you will not need to specify an Id column. You can select None as
your Import By setting.
114
Chapter 5
14. If you would like the rows in the import table to be imported in reverse
order, check the Process in Reverse Order box.
15. Click the Next button at the bottom of the fourth Import Wizard window. The fifth Import Wizard window will now appear as shown below.
Fifth Import Wizard window
16. The SQL Statement box allows you to update or modify other columns
in the open Smeadlink database as the import is running.
If you want to use this option, enter the desired SQL statement in the SQL
Statement box. Smeadlink will execute the SQL statement after it imports
each record into the destination table. You will need to use the token %ID%
in your SQL statement to refer to the records in the destination table.
17. The Tracking Destination and Due Date options are both used when
creating imports for the Denso portable scanner. These options allow you to
specify a default destination and due date for objects without a specified
destination or due date. You will learn more about these options later in this
chapter.
Using Import Wizard
115
18. If the import file contains information for importing images, you will
now need to specify which output settings will used to store the images. To
specify output settings:
• Click the arrow at the right of the Use ScanRule box. A dropdown will
now appear listing all the Scanner rules in the open database.
• Click the rule that contains the desired output settings.
• Now click the appropriate option for saving images with the Id of a
row that already has an image attached to it. Save As New Version will
save the image as a new version of the first image. Save As New Page
will save the image as a new page for the first image.
19. Click the Finish button at the bottom of the fifth Import Wizard window.
The fifth Import Wizard window will now close, and the Import Manager
window will appear. The import you just created will be selected in the
Saved Imports box.
116
Chapter 5
Setting up an Import for Importing Images
Smeadlink 3 now allows you to import images, and attach the images to
rows in Smeadlink folders or subfolders. You can import images with a text
file, an Excel object or an Access table, as long as you include certain information. This section will show you what information needs to be included
for importing images. Once you have verified that your file, object or table
is set up correctly for importing images, you can create an import for it using
one of the four previous sections in this chapter. You can then run the import, and all the images listed in the file, table or object will be imported into
Smeadlink and attached to the specified rows.
Requirements for importing images:
The following requirements apply to any delimited text file, fixed length
text file, Excel object or Access table that you want to use for importing
images.
1. One column needs to include the entire path of each image that you want
imported into Smeadlink. When you are creating the import, this column
needs to be mapped to the <<IMAGE COPY>> option, instead of to a field
in the destination table.
2. One column needs to include the Id number of the Smeadlink row you
want each image attached to. The entries in the Id column need to correspond to the entries in the image path column (i.e. the first entry in the Id
column needs to be the Id of the row you want the first image attached to,
the second entry in the Id column needs to be the Id of the row you want the
second image attached to, etc.).
Using Import Wizard
117
Creating an Import for the Denso Portable Scanner
Creating an import is the first step in the process of importing a file into your
Smeadlink database. An import is similar to a Scanner rule—it is a group of
settings that determines things like which file to import data from, which
table to import data into and which column to import rows by. The previous
sections in this chapter showed you how to create imports for the various
file types that can be imported into Smeadlink, including delimited text files,
fixed width text files, Excel objects and Access tables. You also learned
how files of any one of these four types need to be set up for importing
images into Smeadlink.
This section will show you how to create an import for the Denso BHT6000 portable scanner. The Denso scanner is a hand-held unit that is optional for use with Smeadlink Tracking, and it allows Smeadlink operators to
track objects away from their computers. After the Denso scanner has been
used to track some objects, you will need to create an import for it so that the
data in the scanner can be imported into a Smeadlink database.
You will need to create at least one Denso import for each Smeadlink database that you would like to import tracking data into. After you have created
the initial import for a database, you will be able to use it each time you want
to download some new tracking information from the Denso scanner into
the database. Once the import has been run, the database will then be updated with the new tracking information. You may eventually want to modify
the Denso import for a database, or create a new one with different settings,
but this is entirely optional and up to you.
Note: This section assumes that your Denso scanner already has the
Smeadlink Tracking program on it, and that it has already been configured
for Smeadlink. Fore more information about these tasks, see the section
Tracking Objects with the Denso Scanner in chapter 14 of the User's Guide.
To create a Denso import:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Load from Denso button on the Smeadlink window. The second
Import Wizard window will now appear as shown on the following page.
118
Chapter 5
Second Import Wizard window
3. Click the Acquire button on the second Import Wizard window.
A Smeadlink window will now appear as shown below telling you to prepare the Denso scanner for transmitting. The data you will transmit here is
not going to be imported into Smeadlink. Instead, it will be used as sample
data to set up the import. You can use either dummy data created expressly
for this purpose, or actual tracking data (once data is transmitted from the
scanner it is not automatically deleted, so you do not have to worry about
losing real tracking information).
Smeadlink window
4. To prepare the Denso scanner for transmitting:
• Make sure that the Denso scanner's cradle is connected to the appropriate COM port on your computer. If you are not sure which COM port
the cradle needs to be connected to, open the Options window and then
open the COM Port folder in the Options window. Now look at the
current COM Port setting in the Denso Settings section. The cradle
needs to be connected to this COM port.
Using Import Wizard
119
• Make sure that the cradle's power cord (it looks like a DC adapter) is
attached to the cradle, and then turn the cradle on.
• Place the Denso scanner in the cradle, and then turn the Denso scanner
on.
• Open the main menu in the scanner.
• From the main menu, press the 5 button.
5. Click the OK button on the Smeadlink window, then press the ENT button on the Denso scanner.
Once you have clicked the OK button on the Smeadlink window, it will
disappear and an status window will appear in its place. You will now have
30 seconds to click the ENT button on the Denso scanner. If you wait longer
than 30 seconds to press the ENT button or if you click the Abort command
on the status window during the transfer process, then no data will be sent
from the scanner to Smeadlink.
Once data has been transferred from the Denso scanner to Smeadlink, a Transfer Completed! message will appear in the scanner, and sample data will
appear in the second Import Wizard window. As in normal imports, the
sample data will be displayed in the second, third, fourth and fifth Import
Wizard windows, and the purpose of it is to allow you to set the options on
these windows.
6. Create break lines between each field in the sample data. Import Wizard
will use the break lines to determine how the data should be separated into
fields. To create a break line:
• Place your mouse pointer over the desired break line position on the
ruler above the sample data, and click the left mouse button once. A
break line will now appear over the sample data. If you need to move
the break line, simply click it and drag it to the desired position. If you
need to remove a break line, simply double-click it.
You will need to create break lines for five or six fields: Location, Object,
Scan Date, Operator, the Transmit Code: T and, if set, the Due Back Date.
7. Click the Next button at the bottom of the second Import Wizard window.
The third Import Wizard window will now appear as shown on the following page.
120
Chapter 5
Third Import Wizard window
8. In the Destination box at the top of the third Import Wizard window,
select the <<TRACKING IMPORT>> option.
Selecting the <<TRACKING IMPORT>> option specifies that the data in
the Denso scanner will be imported into the Tracking table of the open database, and not any user tables (i.e. tables used to create folders or subfolders).
Once you have selected the <<TRACKING IMPORT>> option, the Available Fields box will be updated so that only the tracking fields are displayed
in it.
9. Now map the tracking fields in the Available Fields box to the Selected
Fields box. The tracking fields need to be mapped to the Selected Fields box
in the order they are listed in the Available Fields box: To map a field:
• Click the desired field in the Available Fields box.
• Click the single right arrow button between the Available Fields and
Selected Fields boxes. The field will now appear in the Selected Fields
box.
Note: If you want to skip a field, such as the <<TRACKING DUE DATE>>
field, map the <<SKIP FIELD>> option to the Selected Fields box in place
of the field you want to skip. Fields skipped in this way will not be imported
into Smeadlink.
Using Import Wizard
121
10. If you have not set the <<TRACKING DATE>> or <<TRACKING
DUE DATE>> fields to be skipped, then select the correct format for them
now. To select the format for either field:
• Click the field in the Selected Fields box.
• Click the Properties button above the Selected Fields box. The Properties window will now appear as shown below.
<<TRACKING DATE>> Properties window
• Select the mmddyyhhmmss format in the Date Format box, and then
click OK to close the Properties window.
11. Click the Next button at the bottom of the third Import Wizard window.
The fourth Import Wizard window will now appear as shown below.
Fourth Import Wizard window
122
Chapter 5
12. Enter the desired name for the import in the Import Name box at the top
of the fourth Import Wizard window.
13. If a copy of the tracking data from the Denso scanner needs to be saved
for other purposes, then enter the desired name in the Storage File for Denso
Import box (i.e. Denso.txt).
Note: If you use this import multiple times to import data from the Denso
scanner, then the data in the storage file specified here will be overwritten
each time the import is run (i.e. the storage file will only contain data from
the last import). If you want to save a copy of your tracking data each time
you download it from the Denso scanner, then you will need to enter a different file name in the Storage File for Denso Import box before you run the
import.
If you do not enter a name in the Storage File for Denso Import box, then the
Denso scanner will still automatically create a text file each time you import
data from it. This text file is part of the import process. Data cannot be sent
directly from the Denso scanner to Smeadlink, so instead the Denso scanner
exports its data to the text file. Once the tracking data is in the text file, it can
be imported into Smeadlink.
14. Check the Delete Source File after Processing option if your want the
text file created during each import process deleted after the data has been
imported into Smeadlink.
15. Click the Next button at the bottom of the fourth Import Wizard window. The fifth Import Wizard window will now appear as shown on the
following page.
Using Import Wizard
123
Fifth Import Wizard window
16. If would like, you can now specify a default destination and due date for
the tracking objects that will be imported from the Denso scanner. The default destination and due date will be used if there is no data in the <<TRACKING DESTINATION>> and <<TRACKING DATE>> columns, or if you
skipped one or both of these columns.
• To specify a default tracking destination, type the Id number of the
desired destination in the Destination box.
• To specify a default tracking due date, enter the desired date in the
Date Due box. You can also click the down arrow at the right of the
Date Due box and use the calendar that appears to specify a due date.
To specify a due date with the calendar, click on the desired day in the
calendar.
17. Click the Finish button at the bottom of the fifth Import Wizard window.
You have now have finished creating an import for the Denso scanner. Remember that you can use this import as many times as you like to import
data from the Denso scanner into the open Smeadlink database.
124
Chapter 5
Modifying an Import
Once you have created an import, you may eventually want to go back through
your import and modify some of its settings. For instance, you may want to
specify a different source file. This section will show you how to modify an
import. You can use the information in this section to modify any existing
import in your Smeadlink database.
To modify an existing import:
1. Select the desired import in the Saved Imports box.
2. Click the Setup button on the Import Manager's toolbar. The second Import Wizard window will now appear as shown below.
Note: The options on the second Import Wizard window will differ depending on what type of import you selected in step 1.
Second Import Wizard window
3. You can now modify any of the settings on the second Import Wizard
window. If the settings you want to modify are on another Import Wizard
window, use the Next button to open the appropriate window and then make
the desired changes.
4. Once you are finished modifying the selected import, open the fifth Import Wizard window and click the Finish button. The import will now be
saved with your new changes.
Using Import Wizard
125
Creating an Import Job
Some import procedures require you to run multiple imports. In previous
versions of Smeadlink, you would have needed to run each import individually to accomplish these kinds of tasks. In Smeadlink 3.5, however, you can
create a group of imports and run the whole group at once. This group is
called an import job, or job, for short.
When you run a job, each import in the job is run automatically in the order
it was added to the job. Import Wizard creates a status report and an error
log for the job, just like it does for a standard import. Both the status report
and the error log are divided into sections, one for each import in the job.
Apart from the expanded status report and error log, running a job is just like
running an import. This section will show you how to create an import job.
To create an import job:
1. Click the New button on the Import Wizard's toolbar. The New submenu
will now appear. The New submenu contains three commands called Load,
Load from Denso and Job.
2. Click the Job button on the Smeadlink window. The Import Job window
will now appear as shown below.
Import Job window
3. Create a name for the new job. To create a name:
• Type the desired name in the Job Name box at the top of the Import
Job window.
126
Chapter 5
4. Add the desired imports to the new job. To add imports:
• Click the blank cell under Name. A down arrow will appear at the right
side of the Name cell.
• Click the down arrow to display a dropdown listing all the imports in
the open database.
• Click the import in the dropdown that you want to run first when the
entire job is run. The dropdown will now close, and the import you
selected will appear in the Name cell. An editing pencil will also appear in the row selector at the far left of the row, and a new, blank
import row will be added beneath the first row.
• If you want to use the input file specified in the import, check the Use
Load Input File option.
• If you want to use a different input file than the file specified in the
import, then type the name of the desired file in the Input File box.
Note: You can also specify an input file by clicking the dot box that
appears at the right side of the Input File cell once it is activated. After
you click the dot box, a standard Select File window will appear that
you can use to specify the desired input file.
• Once you have finished filling out the options for the first import in the
job, use the mouse button, the TAB key or the arrow keys to move the
cursor to the next import row. Once you move to the second row, the
editing pencil at the left of the first row will disappear, to let you know
that the row is no longer being edited.
• Repeat the above six steps for each import that you want in the job.
Remember that when you run the job, the imports it contains will be
run in the order they were added to it.
5. Once you have finished adding the desired imports to the new job, then
click the Finish button in the lower right corner of the Import Jobs window.
The Import Jobs window will now close, and the first Import Wizard window will reappear. The import job you just created will be listed in the Saved
Imports box on the first Import Wizard window.
Using Import Wizard
127
Modifying an Import Job
Once you have created an import job, you may eventually want to go back
through it and modify some of its settings. For instance, you may want to
specify a different input file for one of the imports in the job, or you may
want to remove some of the existing imports and add new ones. This section
will show you how to modify an import job. You can use the information in
this section to modify any existing job in the open database.
To modify an import job:
1. On the first Import Wizard window, select the desired import job in the
Saved Imports box.
2. Click the Setup button on the Import Wizard's toolbar.
The first Import Wizard window will now close, and the Import Jobs window will appear as shown below. The name of the selected job will be displayed in the Job Name box at the top of the window, and the various imports in the job will be listed in the records grid in the middle of the window.
The job in the example below is called Test Job, and it contains three imports called Matters, Attorneys and Tracking.
Import Job window
128
Chapter 5
3. If you would like to delete one or more of the imports in the job, then follow
the steps below:
• Click the row selector of the first import that you want to delete (the row
selector is the gray box at the far left of each row in the import records
grid). Once you click the row selector, the first import row will turn blue
to indicate that it is selected.
• If you want to delete additional imports, hold down the CTRL key while
you click the row selector of each import.
• Once you have selected the import (s) you want to delete, press the
DELETE key. The Delete Rows popup window will now appear. This
window will tell you how many import rows you have selected to delete, and it will ask you to verify that the selected imports should in
fact be deleted.
• Click the Yes button on the Delete Rows popup window, or press the
ENTER key. The selected imports will now be removed from the open
import job.
4. If you would like to add one or more imports to the job, then follow the
steps below:
• Click the Name cell of the blank row at the bottom of the import records
grid. A down arrow will now appear at the right of the cell.
• Click the down arrow to display a dropdown listing all the imports in
the open database.
• Click the desired import in the dropdown. The dropdown will now
close, and the import you selected will appear in the Name cell. An
editing pencil will also appear in the row selector at the far left of the
row, and a new, blank import row will be added beneath the active
row.
• If you want to use the input file specified in the import, check the Use
Load Input File option in the active row.
• If you want to use a different input file than the file specified in the
import, then type the name of the desired file in the Input File box of
the active row.
Using Import Wizard
129
Note: You can also specify an input file by clicking the dot box that
appears at the right side of the Input File cell once it is activated. After
you click the dot box, a standard Select File window will appear that
you can use to specify the desired input file.
• Once you have finished filling out the options for the new import, use
the mouse button, the TAB key or the arrow keys to move the cursor to
the next row in the import records grid. Once you move to the next
row, the editing pencil at the left of the first row will disappear, to let
you know that the row has been saved and it is no longer being edited.
• Repeat the above six steps for each import that you want in the job.
Remember that when you run the job, the imports it contains will be
run in the order they were added to it.
5. If you want to modify the input file for one or more of the imports in the
job, then follow the steps below:
• Click the Input File cell in the row of the desired import. A dot box will
now appear at the far right side of the Input File cell.
• You can now either delete the current input file path and type in the
new one, or you can click the dot box to open a standard Select File
window, and use this window to specify the desired input file.
Note: If you want to use the input file specified in the import, you do
not have to type it in or select it in the Select File window. Instead,
simply check the Use Load Input File cell. The import's default input
file will now be automatically entered in the Input File cell.
6. Once you have made the desired changes to the open job, click the Finish
button in the lower right corner of the Import Jobs window.
The Import Jobs window will now close, and the first Import Wizard window will reappear. The import job you just modified will be listed in the
Saved Imports box on the first Import Wizard window.
130
Chapter 5
Removing an Import or an Import Job
This section will show you how to remove an import or an import job. You
can use the information in this section to remove any existing import or
import job from the open Smeadlink database.
To remove an existing import or import job:
1. On the first Import Wizard window, select the desired import or job in the
Saved Imports box.
2. Click the Remove button on the toolbar.
A message box will now appear asking if you would like to remove the
selected import or job. The example below shows what the message box
looks like.
Remove import or job message box
Note: There is no way to restore an import or import job once it has been
deleted, so make sure the message box displays the name of the import or
job that you want to delete.
3. Click the Yes button on the message box. The selected import will now be
permanently removed.
Using Import Wizard
131
Running an Import or an Import Job
This section will show you how to run an import or an import job. You can
use the procedure explained in this section to run any existing import or
import job in the open Smeadlink database.
To run an existing import or import job:
1. On the first Import Wizard window, select the desired import or import
job in the Saved Imports box.
2. Click the Run button on the toolbar.
The selected import or import job will now be run, and a status bar will
appear beneath the toolbar to display it's progress. When the import or import job is finished, a button called View Report will appear beneath the
status bar. The example below shows what the first Import Wizard window
looks like immediately after an import or an import job has been run.
Status Bar
View Report button
3. If you would like to view a status report for the import or import job you
just executed, then click the View Report button. The Import Report window will now appear as shown on the following page.
• If you executed a single import, then your report will look like the one
in the example—it will display the start and end time at the top, followed by information about the table that was modified and any records
that were affected by the import.
132
Chapter 5
• If you executed an import job, then your report will look slightly different than the one in the example—it will contain one section for each
import in the job. Each section will have the start and end time for one
import at the top, followed by information about the table that was
modified and any records that were affected by the import.
Import Report window
4. If any errors are generated when your import or import job is run, then
they will be written to an error log and a View Errors button will appear
underneath the status bar. If you would like to view the error log, then click
the View Errors button. The Import Error Log window will now appear as
shown below.
Import Error Log window
Introduction to Directory Settings
133
6. Introduction to Directory Settings
Chapter contents
Introduction
Directory Settings Terms
Directory Settings Concepts
134
Chapter 6
Introduction
The previous chapter showed you how to import different objects into
Smeadlink using the Import Wizard program. You learned how to create
imports for the various types of objects that can be imported into Smeadlink,
and how to work with imports once they have been created. You also learned
how to group imports together into a job, and how to work with jobs once
they have been created.
This chapter will introduce you to the Directory Settings utility. As you
learned in chapter 1, Directory Settings is a program that allows you to specify
which directories on your computer can be used by Smeadlink programs for
storing image files. Image files can be either document images created in the
Scanner or PC Files programs, or ERM files created in the Import Wizard
program. Smeadlink programs do not store image files in your Smeadlink
database. They store them in designated directories elsewhere on your computer. Directory Settings is the utility for designating which directories on
your computer can be used for storing image files.
When you want to designate a directory for storing image files (this is called
an image output directory), you use the Directory Settings program to create
a path that points to that directory on your computer. Once the path has been
created, it will become available to other Smeadlink programs and they can
use it to specify which image output directory they will use for storing image files.
The first section in this chapter explains basic Directory Settings terms, and
the second section explains basic Directory Settings concepts. If you are
familiar with earlier versions of Directory Settings, then you may want to
skip this chapter and go straight to chapter 7. If you have not used Directory
Settings before, then reading this chapter should give you a good basic understanding of what the different components in the Directory Settings program look like and how they are used.
Note: For a summary of the Directory Settings utility and its function in
your Smeadlink system, see the section Smeadlink Administrative
Utilities...Directory Settings in chapter 1 of this manual.
Introduction to Directory Settings
135
Directory Settings Terms
There are three terms that you will need to know when you are using Directory Settings. These terms are: devices component, volumes component and
directories component. As you learned in chapter 1, these are the three components in each path created with Directory Settings. This section will introduce you to these three components.
Devices component
The devices component of a path typically specifies which drive the image
output directory is located on. For instance, suppose you were setting up the
Scanner program and you wanted it to store all the images it scanned to the
c:\sdlk\images1 directory on your computer. The drive in this path is c:, so
the devices component of the path in Directory Settings would probably be
set to c:.
Directory Settings is very flexible in how it allows paths to be entered, however, so the devices component of this path could also be c:\sdlk or even
c:\sdlk\images1. This flexibility allows Directory Settings to model a wide
variety of directory structures. Directory Settings requires every path to include a devices component, a volumes component and a directories component, so if you entered all the file path information in one or two components, you would need to use one or two dummy components to complete
the path (a dummy component is a component that does not include any path
information).
In addition to the actual file path information (i.e. c:\ in the example above),
the devices component of each path in Directory Settings also includes several other pieces of information. For instance, one of them allows you to
enter a name for the specified drive letter. Using a name instead of just a
drive letter often makes a drives easier to identify, for when the path is modified later on.
Volumes component
The volumes component of a path typically specifies which one of the main
directories on the drive contains the image output directory. For instance,
going back to the example from above, suppose you were setting up the
Scanner program and you wanted it to store all the images it scanned to the
c:\sdlk\images1 directory on your computer. The main directory in this path
is devices, so the devices component of the path in Directory Settings would
probably be set to \devices.
136
Chapter 6
Again, Directory Settings is very flexible in how it allows paths to be entered, so the volumes component of this path could also be c:\sdlk or even
c:\sdlk\images1. Remember that Directory Settings requires every path to
include a devices component, a volumes component and a directories component, so if you entered all the file path information in one or two components, you would need to use one or two dummy components to complete
the path (a dummy component is a component that does not include any
path information).
Directories component
The directories component of the path typically specifies the actual image
output directory. For instance, going back to the previous example one more
time, suppose you were setting up the Scanner program and you wanted it to
store all the images it scanned to the c:\sdlk\images1 directory on your computer. The image output directory in this path is images1, so the directories
component of the path in Directory Settings would probably be set to images1.
Again, Directory Settings is very flexible in how it allows paths to be entered, so the directories component of this path could also be \sdlk\images1
or even a dummy component if all the path information was already entered
in the devices and volumes components (a dummy component is a component that does not include any path information).
Introduction to Directory Settings
137
Directory Settings Concepts
This section summarizes the basic Directory Settings concepts. It explains
what the different components on the Directory Settings window are and
how they are typically used.
As you learned earlier, in a normal Directory Settings session you will be
creating paths that point to image output directories. Once you create each
path in Directory Settings, it will become available to other Smeadlink programs. It can then be used by the Scanner program, the PC Files program or
the Import Wizard program to specify where they will store image files.
Typically, you will use Directory Settings when you are initially setting up
your Smeadlink system. Once you begin using Smeadlink, you may use Directory Settings again from time to designate new directories as the existing
ones fill up with image files and become difficult to work with.
There are three main views, or grids, that can appear in the Directory Settings window—one for each component of a file path. The views are set up
so that they form a three part hierarchy. The Devices view is the top element
in the hierarchy, the Volumes view is the next element down and the Directories view is the lowest level in the hierarchy. Each row in the Devices view
can be attached to multiple rows in the Volumes view, and each row in the
Volumes view can be attached to multiple rows in the Directories view.
Because of the way it is organized, Directory Settings can model many different types of directory structures—from simple to very complex.
The diagram below shows how three paths would typically be entered into
Directory Settings. The file paths used in the diagram are c:\sdlk\images1,
c:\sdlk\images2 and c:\sdlk\images3. Each box in the diagram represents
one row in the labeled view. Each line represents a connection between two
rows.
Devices view:
c:
Volumes view:
\sdlk
Directories view:
images1
images2
images3
138
Chapter 6
The paths used in the diagram on the previous page have two shared components: the devices component, which in this case is c:, and the volumes component, which in this case is \sdlk. A shared component in Directory Settings is a component that is used in more than one path. In the diagram, the
c: row in the Devices grid and the \sdlk row in the Volumes grid are each
used to define three different paths.
There are several advantages to using shared components when you are entering paths into Directory Settings. The first advantage is that it saves time
when you are initially entering the paths. Instead of entering the same component any number of times, you only need to enter it once. The second
advantage is that if the actual directory structure on your computer ever
changes and you need to modify the existing paths to match the new structure, you only have one component to modify instead of possibly many.
Finally, shared components are easier to read in Directory Settings, because
they eliminate duplicate information in the views.
Directory Settings displays one view at a time in its main window. When
you first open Directory Setting, the Devices view will be displayed in the
top portion of the Directory Settings window. The Devices view will be
empty if you have not used Directory Settings before. The first step in creating a path with Directory Settings is to create a blank row in the Devices
view and enter the device information for your file path into the blank row's
fields. The example below shows what the Devices view looks like in Directory Settings. The Devices view in the example contains one row, and the
device information for a path has been entered into the row's fields.
Devices view
Introduction to Directory Settings
139
As you learned earlier, the devices component of a path in Directory Settings typically specifies which drive the image output directory is located
on. However, because there are no internal checks in Directory Settings,
you can put as much path information as you want into the Devices view. It
is normally not very efficient to put a lot of information into one view, though,
and it may require dummy rows in later views that make the entire path
harder to work with. It is usually recommended that you put only one or two
pieces of a path into the Devices view. As you learned earlier, this saves you
time in initial setup, makes it easier to alter the paths in Directory Settings if
your actual directory structure changes later on and increases readability.
Once you have created a row in the Devices view and entered your device
information into the row, then the next step in creating a path is to select the
row you just made and open the Volumes view. When the Volumes view
opens, it will display all the volume rows that are attached to the selected
row in the Devices view. If you are creating a new path, then the Volumes
view will be empty. The example below shows what the Volumes view looks
like. The Volumes view in the example contains one row, and the volume
information for a path has been entered into the row's fields.
Volumes view
140
Chapter 6
After the Volumes view is open, you create a new blank row in it just like in
the Devices view, and fill in the row's fields with the volume information of
the path you are creating. Once you have created a row in the Volumes view
and entered your volume information into the row, then the next step in
creating a path is to select the row you just created and open the Directories
view.
The Directories view is related to the Volumes view just like the Volumes
view is related to the Devices view. When the Directories view opens, it will
display all the directory rows that are attached to the selected row in the
Volumes view. If you are creating a new path, then the Directories view will
be empty. The example below shows what the Directories view looks like.
Directories view
After the Directories view opens, you create a blank row in it just like in the
other views, and fill in the row's fields with the directory information of the
path you are creating. The path will now be completely entered into Directory Settings, and it will become available to other Smeadlink programs,
including the Scanner program, the PC Files program and the Import Wizard program.
Using Directory Settings
7. Using Directory Settings
Chapter contents
Introduction
Creating a Path for a Magnetic Storage Device
Creating a Path for an Optical Storage Device
Creating Multiple Paths Using Shared Components
141
142
Chapter 7
Introduction
The previous chapter introduced you to the Smeadlink Directory Settings
program. You learned about basic Directory Settings terms, and about the
basic concepts for using Directory Settings. This chapter will show you how
to use Directory Settings to create paths for your Smeadlink programs.
As you learned earlier, there are two main types of paths that can be created
in Directory Settings: paths for magnetic storage devices, and paths for optical storage devices. A magnetic storage device is a standard hard drive,
either on your computer or on another computer attached to your computer's
network, and an optical storage device is a drive in a jukebox. You use the
same options to create paths for both types of storage devices, but the way
you use the options differs somewhat depending on which type of device
you are creating a path for.
The first section of this chapter will show you how to create a path for a
magnetic storage device, and the second section will show you how to create a path for an optical storage device. The third section will then show you
how to enter multiple paths at once into Directory Settings and share common components between the paths. The information in the third section
applies to paths for both types of storage devices.
Using Directory Settings
143
Creating a Path for a Magnetic Storage Device
This section will show you how to create a path in Directory Settings for a
magnetic storage device, which is a standard hard drive. Once you have
created the path in Directory Settings, it will become available to the
Smeadlink Scanner, Import Wizard and PC Files programs, and they will be
able to use it to specify an image output directory.
Before you begin going through this section, remember that there is no one
way to divide a path into components in Directory Settings. This section
will show you the typical way a file path for a magnetic storage device would
be divided and entered into Directory Settings. Depending on the directory
structure in your computer, you may want to divide your file paths differently, but the basic process for creating the path will remain the same.
Note: Directory Settings is a mapping utility only, it does not actually create
directories. You need to create all image output directories in Windows Explorer or DOS before you create paths for them in Directory Settings.
To create a path for a magnetic drive:
1. Open the Devices layout.
The Devices layout will open automatically when you first open the Directory Settings program. If you are in another layout, though, you will need to
open it manually. To open the Devices layout from another layout:
• Click the Up One Level command on the Go menu, or click the Up
One Level button on the toolbar.
The Up One Level command will take you back one level in the layout
hierarchy, so if you are in the Directories layout you will need to select Up
One Level twice to get back to the Devices layout (the name of each layout
is displayed above the field names on the left side of the Directory Settings
window).
144
Chapter 7
2. Create a new row in the Devices layout.
The new row will contain all the devices information for your file path. To
begin creating the new row:
• Type the desired name into the Name cell of the blank row at the
bottom of the Devices layout.
The purpose of the name is to describe the device whose drive letter or
UNC path you will put in this row. You do not have to put anything in
the Name cell, but an actual name for a device makes it easier to identify than a just a drive letter or a UNC path.
Once you begin typing the name, a pencil will appear at the left of the
row to indicate that the row is being edited, and a new, blank row will
be added to the bottom of the Devices layout. The example below
shows what the Devices layout looks like when you begin creating a
new row.
New row being created in the Devices layout
• Now press the Tab key on the keyboard to move to the row's second
field (you can also use the right arrow key on the keyboard or the
mouse pointer to move from one field to another).
3. Enter the desired devices information into the Drive Letter or UNC field
of the new row. Once you are finished, move to the next field in the row.
You can enter the devices information using standard drive letter notation,
like c:\sdlk, or using UNC notation, like \\my_machine\c\sdlk. Typically,
the devices component of a path in Directory Settings identifies which drive
the image output directory is located on. For instance, in the path
c:\sdlk\images1 the images1 directory is located on the c: drive, so the devices component for this path would typically be set to c:. There are no
internal checks in Directory Settings, though, so you can enter as much file
path information as you want into the devices component of a path.
Using Directory Settings
145
4. Enable or disable the Require Temporary box for the new row. To enable
the Require Temporary box:
• Click the box once.
A check mark will now appear in the Require Temporary box for the new row,
to indicate that Require Temporary is enabled. Require Temporary is used to
determine how images stored with this path will be viewed. When Require
Temporary is set to True and a user opens an image in Smeadlink, the server
will create a copy of the image in the user's c:\windows\temp directory and
Smeadlink's image viewer will display the local copy of the image. When
Require Temporary is set to False and a user opens an image in Smeadlink,
the image viewer will display the original image on the server.
5. Ignore the Active box for the new row. The Active field is only used when
you are creating a path for an optical drive—it does not apply when you are
creating a path for a magnetic drive.
6. Save the new row in the Devices layout. There are several ways to save a
row in Security Manager. These procedures are explained below.
• Click the Save Row command on the Rows menu.
• Use the Up or Down arrow keys on the keyboard to move to another
row.
• Use the Tab key on your keyboard to move to the row beneath the
edited row.
• Click on another row in the open layout.
After you use one of the methods above to save your row, the pencil at the
left of the row will disappear to let you know that your changes have been
saved.
7. Select the row you just created. To select the row:
• Click the row selector at the left of the desired row.
The row selector is the gray box at the very left of each row. Once you click
a row selector, the row will turn blue to indicate that it is selected.
146
Chapter 7
8. Open the Volumes layout. To open the Volumes layout:
• Click the Down One Level command on the Go menu, or click the
Down One Level button on the toolbar.
The Volumes layout will now appear. Since no volumes rows have been
created for the selected row in the Devices layout, the Volumes layout will
be empty. You should see one, blank row in the Volumes layout. The example below shows what the Volumes layout should look like.
Empty Volumes layout
9. Type the desired name into the Name cell of the blank row in the Volumes layout. After you enter the name, or if you do not want to enter a name
at all, move to the second field in the row.
The Name field in the Volumes layout is similar to the Name field in the
Devices layout—it allows you to give a name to the information you will
put in the Path field. A real name often makes path information easier to
work with, but it is not a necessary piece of information.
10. Enter the desired volumes information into the Path field of the new
row. Once you are finished, move to the next field in the row.
Typically, the volumes component of a path identifies which one of the
main directories on a device the image output directory is located on. For
instance, in the path c:\sdlk\images1 the sdlk directory is the main directory
on the c: drive, so the volumes component for this path would typically be
set to \sdlk. There are no internal checks in Directory Settings, though, so
you can enter as much path information as you want into the Path field.
Using Directory Settings
147
11. Ignore the Juke Box Volume Id cell of the new row . This field is used
when creating paths for optical storage devices, but it does not apply when
creating paths for magnetic storage devices.
12. Save the new volumes row just like you saved the devices row in step 6.
Once you have saved the row, select it and open the Directories layout. The
example below shows what the Directories layout should look like.
Directories layout
The Id field of the new row will be automatically filled in for you when you
save the row. This field is used internally to keep track of the entire path.
13. Type the desired name into the Name cell of the blank row in the Directories layout. After you enter the name, or if you do not want to enter a
name at all, move to the third field in the row.
14. Enter the desired directories information into the Path field of the new
row.
Typically, the directory component of a path specifies the exact image output directory. For instance, in the path c:\sdlk\images1, images1 is the actual directory specified by the whole path, so the directory component of
this path would typically be set to \images1. Just like the other layouts though,
there are no internal checks in the Directories layout, so you can enter whatever path information you want into this field.
15. Now save this row just like you saved the others in the Devices and
Volumes layouts.
When you have finished saving this row, you will be finished entering your
file path into Directory Settings, and it will immediately become available
to the Smeadlink Scanner, Import Wizard and PC Files programs.
148
Chapter 7
Creating a Path for an Optical Storage Device
This section will show you how to create a path in Directory Settings for an
optical storage device, which is a cartridge in a jukebox. Once you have
created a path in Directory Settings, it will become available to the Smeadlink
Scanner, Import Wizard and PC Files programs, and they will be able to use
it to specify which cartridge in the jukebox they will use to store images.
Even though you use the same options in Directory Settings to create paths
for both magnetic and optical drives, the procedures for creating each type
of path are not the same. When you are creating a path for a magnetic drive
you specify the exact location of a directory on the drive, and the way that
you break the path up into components is basically left up to you. When you
are creating a path for an optical drive you first specify a cache directory on
the jukebox's server, and then you specify one of the cartridge's in the jukebox. There is not as much flexibility in Directory Settings when you are
creating a path for an optical drive, as you have to enter the path in a certain
way. This section will walk you through the process of creating a path in
Directory Settings for an optical drive.
To create a path for an optical drive:
1. The Devices layout will open automatically when you first open the Directory Settings program. If you are in another layout, though, you will need
to open it manually. To open the Devices layout from another layout:
• Click the Up One Level command on the Go menu, or click the Up
One Level button on the toolbar.
The Up One Level command will take you back one level in the layout
hierarchy, so if you are in the Directories layout you will need to select Up
One Level twice to get back to the Devices layout (the name of each layout
is displayed above the field names on the left side of the Directory Settings
window).
2. Create a new row in the Devices layout.
The new row will contain all the devices information for your file path. To
begin creating the new row:
• Type the desired name into the Name cell of the blank row at the
bottom of the Devices layout.
Using Directory Settings
149
The purpose of the name is to describe the device whose drive letter or
UNC path you will put in this row. You do not have to put anything in
the Name cell, but an actual name for a device makes it easier to identify than a just a drive letter or a UNC path.
Once you begin typing the name, a pencil will appear at the left of the
row to indicate that the row is being edited, and a new, blank row will
be added to the bottom of the Devices layout. The example below
shows what the Devices layout looks like when you begin creating a
new row.
New row being created in the Devices layout
• Now press the Tab key on the keyboard to move to the row's second
field (you can also use the right arrow key on the keyboard or the
mouse pointer to move from one field to another).
3. Enter the desired devices information into the Drive Letter or UNC field
of the new row. Once you are finished, move to the next field in the row.
You can use standard drive letter notation, like R:\cache, or you can use
UNC notation, like \\jukebox_server\cache. When you are creating a path
for an optical drive, the devices component of the path needs to specify a
directory on the jukebox's server that the jukebox will always have access
to. Typically, the jukebox will always have access to the cache directory, so
the Drive Letter or UNC field typically specifies the cache directory on the
jukebox's server.
150
Chapter 7
4. Enable or disable the Require Temporary box for the new row. To enable
the Require Temporary box:
• Click the box once.
A check mark will now appear in the Require Temporary box for the new
row, to indicate that Require Temporary is enabled. Require Temporary is
used to determine how images stored with this path will be viewed. When
Require Temporary is set to True and a user opens an image in Smeadlink,
the server will create a copy of the image in the user's c:\windows\temp
directory and Smeadlink's Image Viewer will display the local copy of the
image. When Require Temporary is set to False and a user opens an image in
Smeadlink, the Smeadlink's Image Viewer will display the original image on
the server.
5. Enable or disable the Active box for the new row. To enable the Active
box:
• Click the box once.
A check mark will now appear in the Active box for the new row, to indicate
that Active is enabled. The purpose of the Active field is to let you know if
a cartridge is in the jukebox or not. When Active is enabled, Smeadlink
assumes that the cartridge you specified in the Drive Letter or UNC field is
in the jukebox (in other words, that the cartridge is active). You will be able
to save or import image files using the path, and Smeadlink users will be
able to view any images saved with this path. When Active is disabled,
Smeadlink assumes that the cartridge is not in the jukebox. Smeadlink will
display an error message if you try to save images using the path, or if a user
tries to open an image saved using this path. Enter the appropriate value in
this field.
6. Save the new row in the Devices layout. There are five ways to save a row
in Security Manager. These procedures are explained below.
• Click the Save Row command on the Rows menu.
• Use the Up or Down arrow keys on the keyboard to move to another
row.
• Use the Tab key on your keyboard to move to the row beneath the
edited row.
• Click on another row in the open layout.
• Click the Save Row button on the toolbar.
Using Directory Settings
151
After you use one of the methods on the previous page to save your row, the
pencil at the left of the row will disappear to let you know that your changes
have been saved.
7. Select the row you just created. To select the row:
• Click the row selector at the left of the desired row.
The row selector is the gray box at the very left of each row. Once you click
a row selector, the row will turn blue to indicate that it is selected.
8. Open the Volumes layout. To open the Volumes layout:
• Click the Down One Level command on the Go menu, or click the
Down One Level button on the toolbar.
The Volumes layout will now appear. Since no volumes rows have been
created for the selected row in the Devices layout, the Volumes layout will
be empty. You should see one, blank row in the Volumes layout. The example below shows what the Volumes layout should look like.
Empty Volumes layout
9. Type the desired name into the Name cell of the blank row in the Volumes layout. After you enter the name, or if you do not want to enter a name
at all, move to the second field in the row.
The Name field in the Volumes layout is similar to the Name field in the
Devices layout—it allows you to give a name to the information you will
put in the Path field. A real name often makes path information easier to
work with, but it is not a necessary piece of information.
152
Chapter 7
10. Enter the desired volumes information into the Path field of the new
row. Once you are finished, move to the next field in the row.
When you are creating a path for an optical drive, you do not have to enter
anything into this field if you have already specified a directory on the
jukebox's server in the Devices layout. If you did not enter the entire path to
the jukebox's directory in the Drive Letter or UNC field of the Devices layout, then you will need to enter the rest of the path to that directory in this
field.
For instance, say the directory that you want to specify on the jukebox's
server has the path \\server1\cache. If you enter this entire path in the Drive
Letter or UNC field of the Devices layout, then you do not have to enter
anything else here. If you entered just the first component of the path in the
Drive Letter or UNC field, then you would need to enter \cache here.
11. The Juke Box Volume Id field is used to specify which cartridge in the
jukebox you want to save image files to. Enter the desired cartridge name in
this field.
12. Save this row like you saved the devices row earlier. Once you have
saved the row, select it and open the Directories layout.
The Directories layout will be empty when it opens, because no rows have
been created in it for the selected row in the Volumes layout. The example
below shows what the Directories layout will look like.
Directories layout
Using Directory Settings
153
The Id field of the new row will be automatically filled in for you when you
save the row. This field is used internally to keep track of the entire path.
14. Type the desired name into the Name cell of the blank row in the Directories layout. After you enter the name, or if you do not want to enter a name
at all, move to the third field in the row.
16. The third field in the Directories layout is called Path. This field contains the actual directory information of the file path you are creating. This
field is not used when you are creating a path for an optical drive.
17. Save this row just like you saved the others in the Devices and Volumes
layout.
When you finish saving this row you will be finished entering your file path
into Directory Settings, and it will immediately become available to the
Smeadlink Scanner, Import Wizard and PC Files programs.
154
Chapter 7
Creating Multiple Paths Using Shared Components
An image output directory can typically hold about 10,000 Smeadlink image files before it becomes difficult to use. If you will be working with more
than 10,000 images in your Smeadlink system, you will need to create multiple paths in Directory Settings to specify multiple image output directories.
The previous two sections in this chapter showed you how to create individual paths for both magnetic and optical storage devices. You could use
the information in these sections to create multiple paths in Directory Settings, but the paths would need to be created one at a time. Also, each path
would need to have its own devices, volumes and directories component. As
you learned earlier, it is usually most efficient to share components when
you are entering more than one path in Directory Settings. You can share
either the Devices component or the Devices and Volumes components between any number of paths. This section will show you how to create multiple paths at once in Directory Settings using shared components. The information in this section applies to paths for both magnetic and optical storage devices.
To create multiple paths using shared components:
1. The first step is to add a new row to the Devices layout. This new row will
be shared by all the paths that you are creating, and it will contain the devices information that is used by each path.
Open the Devices layout now and add a new row to it just like you did when
creating an individual file path. Once you have added the new row, enter the
devices information for the paths you are creating into its fields and then
save the row. When the row has been saved, select it and open the Volumes
layout.
2. You will now need to create one or more rows in the Volumes layout,
depending on whether you want to share one volumes row between the paths
you are creating, or use a separate volumes row for each one. Each volumes
row that you create will be attached to the selected row in the Devices layout, so they will all share the same devices component.
• If the paths you are creating share the same volumes component, add
one row to the Volumes layout, enter the desired volumes information
into its fields and then save the row. When the row has been saved,
select it and open the Directories layout.
Using Directory Settings
155
• If the paths you are creating have different volumes components, create one volumes row for each path. As you create new rows in the
Volumes layout, enter the desired volumes information into each one
and save it. When you have finished creating rows in the Volumes
layout, select the first row and open the Directories layout.
3. The last step in creating multiple paths in Directory Settings is to create
the directories component of each path. The directories component cannot
be shared between paths, or the paths would be identical. You will need to
create a separate row in the Directories layout for each path that you are
creating.
• If you shared both the directories and volumes components of the paths
you are creating (in other words, if you created one row in the Devices
layout and one row in the Volumes layout), then you will now need to
add one row to this grid for each path that you are creating. As you add
new rows to the Directories layout, enter the desired information into
each one and save it. A path will be completed as you save each directories row, and it will become available to the Smeadlink Scanner, Import Wizard and PC Files programs.
• If you shared just the directories component of the paths you are creating (in other words, if you created one row in the Directories layout
and multiple rows in the Volumes layout), then you will now need to
add one row to this grid. This row will be attached to the first row that
you created in the Volumes layout. Enter the desired directories information into this row, and then save it when you are finished. The path
that you just completed will now become available to the Smeadlink
Scanner, Import Wizard and PC Files programs.
Now go back to the Volumes layout, select the second row from the
top and open the Directories layout again. Create a new row, enter the
desired information into its fields and save it. A second path will now
be completed, and it will become available to the Smeadlink Scanner,
Import Wizard and PC Files programs. Keep repeating this process
until you have created one directories row for each row in the Volumes layout.
Introduction to Database Map
8. Introduction to Database Map
Chapter contents
Introduction
Basic Database Map Terms
Basic Database Map Concepts
149
150
Chapter 8
Introduction
The previous chapter showed you how to create paths in Directory Settings
for specifying image output directories on your computer. You learned how
to create a path for a magnetic storage device, and you learned how to create
a path for an optical storage device. You also learned how to create multiple
paths at once using shared components.
This chapter will introduce you to the Database Map program. As you learned
in chapter 1, Database Map is a program that allows you to view and modify
the table relationships in your Smeadlink databases. You can use Database
Map to modify or delete existing workgroups, folders, subfolders and dropdowns in a Smeadlink database, and you can also use it to create new work
groups, folders, subfolders or dropdowns in the database. The first section
in this chapter will explain some terms that are often used in discussing
Database Map. The second section will explain the basic concepts you should
know before you begin using Database Map.
Introduction to Database Map
151
Basic Database Map Terms
There are several terms that are often used in discussing the Database Map
program. This section will introduce you to those terms and explain how
they are typically used.
Item
An item is one of the components in the Database Map's tree diagram. There
is one item in the tree diagram that corresponds to the Smeadlink database
that is currently open, and there is another item in the tree diagram for each
workgroup, folder, subfolder and dropdown in the open database. Each item
includes an icon and a name. The maximum number of items in your tree
diagram will be determined by the number of workgroups, folders, subfolders and dropdowns in the open database. The example below shows what an
item looks like in the Database Map's tree diagram. The item in the example
is a workgroup item.
An item in the tree diagram
Level
As you have seen in the examples so far, the items in the Database Map's
tree diagram are organized into a hierarchy that is made up of different levels. The first level in the diagram includes just one item, and that is the item
at the top of the diagram that corresponds to the open Smeadlink database.
The second level in the diagram includes all the workgroup items, the third
level in the diagram includes all the folder items, and so on. The maximum
number of levels in your tree diagram will be determined by the structure of
the open database. You can determine which level an item is on by starting
at the database item in the tree diagram and counting each item that contains
the item you are interested in.
152
Chapter 8
Basic Database Map Concepts
Database Map is a program that allows you to view and modify the table
relationships in your Smeadlink databases. The main component in the Database Map program is a tree diagram that displays all the workgroups, folders, subfolders and dropdowns in the open database. You can choose to
have the tree diagram start out in a fully expanded or collapsed state when
you open the Database Map program.
When the tree diagram starts out in a fully expanded state, every workgroup,
folder, subfolder and dropdown in the open database is visible in the diagram. This allows you to see the structure of the entire database. When the
tree diagram starts out in a fully collapsed state, on the other hand, only the
database item is visible in the tree diagram. You can then expand just the
portion of the tree diagram that you will be using. Starting the tree diagram
in a fully collapsed state and then expanding just the area you need is helpful
if you are already familiar with the structure of the open database, and you
know exactly which item in it you want to modify. This is because it allows
you to focus on just the area you are working with, and it prevents you from
being distracted by other items in the database.
As you have probably noticed in the examples so far, you can choose whether
or not you want plus/minus buttons to be displayed in the Database Map's
tree diagram. Plus/minus buttons in the tree diagram work just like plus/minus
buttons in Windows Explorer—they are displayed to the left of each item in
the tree diagram, and they allow you to quickly see whether or not an item
contains any subitems. If the button to the left of an item contains a plus
sign, then that item contains at least one subitem, and if the button to the left
of an item contains a minus sign, then that item does not contain any subitems.
The example on the following page shows what a button with a plus in it and
a button with a minus on it look like in the Database Layout's tree diagram.
Introduction to Database Map
153
A minus button
A plus button
You can expand any item in the Database Map's tree diagram by placing the
mouse pointer over that item and double-clicking the left mouse button once.
After you click the left mouse button, the contents of the selected item will
appear underneath it in the tree diagram. For instance, if you place the mouse
pointer over a workgroup item and click the left mouse button once, then the
folders in that workgroup will appear underneath it in the tree diagram.
You can collapse an expanded item in the same way you expand a collapsed
item—just place the mouse pointer over the item you want to collapse and
double-click the left mouse button. In addition to using the mouse pointer
and left mouse button to expand and collapse items, you can also use the
features on the Database Map's View menu. The View menu has several
features that allow you to expand or collapse one item in the tree diagram.
You can also use the View menu to expand or collapse the entire tree diagram at once.
After you have adjusted the tree diagram to your liking by expanding or
collapsing the desired items on it, you can use the popup menus to modify
any of the items displayed in the tree diagram. There are three popup menus:
the database menu, the workgroup menu and the table menu. As you learned
in chapter 1, you open a popup menu by placing the mouse pointer over the
item in the diagram you want to modify and clicking the right mouse button
once. The popup menu for that item will then appear in front of the tree
diagram. The example on the following page shows what the database popup
menu looks like. This menu appears when you click the right mouse button
over the database item at the top of the tree diagram.
154
Chapter 8
Database popup menu
Like the other popup menus, the database popup menu contains commands
for renaming the item the menu was opened from and changing its icon.
You can also expand or collapse the tree diagram from the database popup
menu, and you can create a new item underneath the selected item (in this
case, a new workgroup in the open database). Finally, you can open a Properties window from the database popup menu, which allows you to adjust
several properties for the selected item (in this case, these are general properties for the open database, like whether or not rows in the database's folders and subfolders will alternate colors).
In addition to the standard options on the database popup menu, there are
also several options that only apply at the database level. These options allow you to create folders and subfolders based on foreign tables, and modify
the bar code search order for the open database.
As you learned in chapter 1, Database Map now supports foreign tables
(tables created outside of Smeadlink). There are two types of foreign tables:
tables located in an external database, and tables located in a Smeadlink
database that were created with another program (such as Microsoft Access). In earlier versions of Smeadlink, the only way to work with a foreign
table was to modify several Smeadlink tables at the system level. In 3.1,
however, all the required tools for working with foreign tables are included
in the Database Map program.
Introduction to Database Map
155
For foreign tables located in an external database, the first step is to connect
the external database to the Smeadlink database you want to use the foreign
table in. Once you have connected the external database, you can register
any table in the database with Smeadlink. The foreign table (or tables) will
then behave just like a regular Smeadlink table, and you will be able to use it
to create folders or subfolders in the Smeadlink database.
For foreign tables that are already located in a Smeadlink database, you simply register the table in Smeadlink. Once the table has been registered, it will
behave like a regular Smeadlink table, and you will be able to use it to create
folders or subfolders.
The last function of the database popup menu is that it allows you to modify
the bar code search order for the open database. The bar code search order is
used by Smeadlink Tracking to find objects or destinations that do not have
a bar code prefix. Typically, when you enter an Id number in Smeadlink
Tracking, Smeadlink will search through the open database, looking for a
row with the same Id number as the number you entered (this is true for both
object Id numbers and destination Id numbers). Smeadlink will use a bar
code prefix to determine what folder or subfolder the matching row is located in. It will then go straight to that folder or subfolder, and search the
entries in its Id column for a matching number.
Although this system works well when the labels used for tracking have bar
code prefixes on them, it is not very reliable or efficient if the tracking labels
do not have bar code prefixes. In that situation, duplicate Id numbers on the
labels can lead to incorrect tracking assignments, and even if the correct
match is found, it may take a long time.
For situations where the labels used for tracking do not have bar code prefixes on them, Database Map allows you to set up a bar code search order for
the open database. The bar code search order lists what tables in the database to look through when trying to find a matching Id number, and what
order to look through the tables. It also specifies what field in each table
contains Id numbers for Tracking, and what mask and strip characters to
apply for the field, if necessary. The Bar Code Search Order utility is the tool
you can use to view and modify the bar code search order for the open
database. This utility is opened from the database popup menu, and the
example on the following page shows what it looks like.
156
Chapter 8
Bar Code Search Order utility
The second Database Map popup menu is the workgroup menu. This menu
appears when you click the right mouse button over any workgroup item in
the tree diagram, and it is the smallest popup menu. It includes several of the
general commands you learned about on the database popup menu. For
instance, you can use it to rename the workgroup item the menu was opened
from and to change its icon. You can also expand or collapse the tree diagram from the this popup menu, and you can create a new item underneath
the selected item (in this case, a new folder in the open workgroup). The
example below shows what the workgroup popup menu looks like.
Workgroup popup menu
Introduction to Database Map
157
The third Database Map popup menu is the table menu. This menu appears
when you click the right mouse button over any folder or subfolder item in
the tree diagram. It includes all the general commands you learned about on
the database popup menu. For instance, you can use it to rename the folder
or subfolder item the menu was opened from and to change its icon. You
can also expand or collapse the tree diagram from the this popup menu, and
you can create an item underneath the selected item (in this case, you would
be creating a subfolder underneath the selected folder or subfolder). The
example below shows what the table popup menu looks like.
Table popup menu
In addition to the standard options on the tables popup menu, there are also
several options that only apply at the table level. These options allow you to
view and modify the fields in a table, and adjust the table properties.
In previous versions of Smeadlink, the utility for adding new fields to a table
was in the Smeadlink. In 3.1, however, this utility has been expanded and
moved to the Database Map. When you click the Fields command on the
Table popup menu, the Field Maintenance utility will appear in front of the
tree diagram. This utility allows you to add, edit and remove the fields in the
selected table. It also allows you to print out a list of all the fields in the
table. The Field Maintenance utility has been moved from Smeadlink to the
Database Map program so that you can add fields to new tables as you create them. The example on the following page shows what the Field Maintenance utility looks like.
158
Chapter 8
Field Maintenance utility
The last function of the Tables popup menu is that it allows you to modify the
properties of the selected table. Clicking the Table Properties command on
the Table menu will bring up a window called the Properties window. If you
are familiar with earlier versions of Smeadlink, then you will see that the
Properties window contains many of the options that used to be located on
the Tab Manager utility in Smeadlink. For instance, you can use the options
on the Properties window to change the background color of a folder or
subfolder, modify the bar code prefix for the rows it contains and determine
whether or not attachments are allowed for the rows in the folder. The example below shows what the Properties window looks like.
Properties window
Introduction to Database Map
159
In addition to standard properties, the Properties window also allows you to
adjust the tracking properties for the selected folder or subfolder. The tracking properties determine things like the container level of the of the items in
the folder or subfolder, and whether or not the folder or subfolder contains
an active field. All the tracking properties are contained in a separate window that you can open from the standard Properties window. The example
below shows what the Tracking Properties window looks like.
Tracking Properties window
Using Database Map
9. Using Database Map
Chapter contents
Introduction
Working with the Database Map Tree Diagram
Creating a Workgroup
Creating a Folder
Creating a Subfolder
Creating a Dropdown
Working with Foreign Tables
Using the Field Maintenance Utility
Modifying Existing Items in a Database
Modifying the Bar Code Search Order for the Open Database
161
162
Chapter 9
Introduction
The previous chapter introduced you to the Database Map program. You
learned about some terms that are frequently used while discussing the Database Map program, and you also learned about the basic concepts for using Database Map. You should now have a basic idea about what the Database Map program looks like and what it is used for.
This chapter will show you how to use the Database Map program to modify
a Smeadlink database. The first section of this chapter will show you how to
work with the Database Map's tree diagram using the options on the View
menu and the Options window. The remaining sections in this chapter will
then show you how to use the tree diagram and the Database Map popup
menus to create and modify workgroups, folders, subfolders and dropdowns
in the open Smeadlink database.
Using Database Map
163
Working with the Database Map Tree Diagram
As you learned earlier, the main component in the Database Map program is
a tree diagram that displays all the work groups, folders and subfolders in
the open Smeadlink database. You can expand any collapsed item in the tree
diagram by placing your mouse pointer over that item and double-clicking
the left mouse button (if an item is already expanded, you can collapse it
using the same procedure).
In addition to the mouse pointer and mouse buttons, you can also work with
the Tree Diagram using the options on the View menu and the Options window. This section will show you how to use these options to work with the
Database Map's tree diagram. The remaining sections in this chapter will
then show you how to use the tree diagram and the Database Map popup
menus to modify the workgroups, folders and subfolders in the open
Smeadlink database.
Options on the View Menu
The View menu contains four commands that you can use to automatically
expand or collapse the items in the tree diagram (these commands are also
listed at the bottom of each of the three popup menus). Each command is
explained below.
Expand All
The first option on the View menu is called Expand All. This option allows
you to expand every collapsed item in the tree diagram at once. If your tree
diagram contains one or more collapsed items, you can simultaneously expand them all by selecting Expand All. If your tree diagram is already fully
expanded, then clicking the Expand All option will not change the appearance of your tree diagram.
Expand All Children
The second option on the View menu is called Expand All Children. This
option allows you to fully expand a collapsed item in the tree diagram. For
instance, if you selected a collapsed workgroup item in the tree diagram and
then clicked the Expand All Children option, the workgroup item would
become fully expanded. All the folders in that workgroup would be displayed in the tree diagram, and any subfolders contained in those folders
would also be displayed.
164
Chapter 9
To fully expand a collapsed item in the tree diagram, place the mouse pointer
over the desired item and click the left mouse button once. The item will
turn blue after you click on it, to indicate that it is selected. Now select the
Expand All Children command. The selected item will now be fully expanded in the tree diagram.
Collapse All
The third option on the View menu is called Collapse All. This option allows you to collapse every expanded item in the tree diagram at once. If
your tree diagram contains one or more expanded items, you can simultaneously collapse them all by selecting the Collapse All option. If your tree
diagram is already fully collapsed, then selecting the Collapse All option
will not change its appearance.
Note: Another way to fully collapse your tree diagram is to place your mouse
pointer over the database item at the top of the diagram and then doubleclick the left mouse button.
Collapse All Children
The final option on the View menu is called Collapse All Children. This
option allows you to fully collapse an expanded item in the tree diagram.
For instance, say you had a workgroup item in your tree diagram that was
fully expanded. It had several folders underneath it, and each of these folders contained several subfolders. You could use the Collapse All Children
command to remove all these folders and subfolders from the tree diagram
at once. Once the Collapse All Children command had been selected, no
more items would be displayed under the workgroup item in the tree diagram.
The first step in fully collapsing an expanded item in the tree diagram is to
place the mouse pointer over the item and click the left mouse button once.
The item will turn blue after you click on it to indicate that it is selected.
Now select the Collapse All Children command. The selected item will now
be fully collapsed, and no more subitems will be displayed under it in the
tree diagram.
Note: Another way to fully collapse an item in the tree diagram is to place
your mouse pointer over the item you want to collapse and then double-click
the left mouse button.
Using Database Map
165
Using the Options Window
The Options window contains two options that allow you to determine how
your tree diagram will be displayed. Each of these two options are explained
below. As you learned earlier, you can open the Options window by selecting the Options command on the Tools menu. The Options window will
open with the Database Map folder selected.
Show Plus / Minus on Database Tree Display
The first option in the Database Map folder is Show Plus / Minus on Database Tree Display. This option allows you to select whether or not plus/minus
buttons will be displayed in the Database Map's tree diagram. As you learned
in the previous chapter, plus/minus buttons in the Database Map's tree diagram work just like plus/minus buttons in Windows Explorer—they are displayed to the left of each item in the tree diagram, and they allow you to
quickly see whether or not an item in the tree diagram contains any subitems.
If the button to the left of an item contains a plus sign, then that item contains at least one subitem, and if the button to the left of an item contains a
minus sign, then that item does not contain any subitems.
In addition to being a visual reference, you can also use plus/minus buttons
to expand and collapse the items in the tree diagram. If the button for an
item in your tree diagram contains a plus sign, then you can expand that item
by placing your mouse pointer over the button and clicking the left mouse
button once. The item will now be expanded, and a minus sign will appear
in its button to indicate that all the subitems contained in this item are currently displayed. Once you are done working with the item in its expanded
state, you can collapse it again by placing your mouse pointer over the item's
button and clicking the left mouse button once.
If your tree diagram does not currently have plus/minus buttons displayed in
it, you can add them to the tree diagram by opening the Options window and
enabling the Show Plus / Minus on Database Tree Display command. A
button will now appear to the left of each item in your tree diagram. If an
item contains any subitems, then a plus sign will be displayed in that item's
button. If an item does not contain any subitems, then a minus sign will be
displayed in that item's button. The two examples on the following page
show what a tree diagram looks like with and without plus/minus buttons.
The first example shows what a tree diagram looks like without plus/minus
buttons on it, and the second example shows what the same tree diagram
looks like with plus/minus buttons.
166
Chapter 9
Database Map program without plus/minus buttons
Database Map program with plus/minus buttons
Startup with Database Tree Expanded
The second option in the Database Map folder is Startup with Database Tree
Expanded. This option allows you to determine what your tree diagram will
look like each time you open the Database Map program. You can choose to
have the tree diagram start in a fully expanded or a fully collapsed state. If
you would like your tree diagram to start in a fully expanded state each time
you open the Database Map program, then enable the Startup with Database
Tree Expanded option. If you would like your tree diagram to start out in a
fully collapsed state each time you open the Database Map program, then
make sure the Startup with Database Tree Expanded option is not enabled.
Using Database Map
167
Creating a Workgroup
The previous section in this chapter showed you how to use the options on
the View menu and the Options window to work with the tree diagram. The
remaining sections in this chapter will show you how to use the tree diagram and the Database Map popup menus to modify existing items in the
open Smeadlink database, and add new items to the database.
This section will begin by showing you how to create a new workgroup.
When you finish creating your new workgroup, it will have a name and an
icon but it will not contain any folders. You will learn how to add folders to
a workgroup in the next section of this chapter.
To create a new workgroup in the open Smeadlink database:
1. Place your mouse pointer over the database item at the top of the tree
diagram, and then click the right mouse button once.
The database popup menu will now appear as shown in the example below.
Database Map popup menu
2. Click the New Workgroup command on the database popup menu.
A new workgroup will now be added to the open Smeadlink database. The
workgroup will be called "Workgroup X", where X is the number of workgroups in the open database, and it will appear at the bottom of the tree
diagram. It will have the default cloud icon, and it will not yet contain any
folders. The example on the following page shows what a new workgroup
looks like in the tree diagram.
168
Chapter 9
A new work group in the tree diagram
Note: If your tree diagram is fully collapsed when you click the New command on the popup menu, then you will not notice any changes in its appearance. Expand your tree diagram by double-clicking the database item
or by using one of the Expand commands on the View menu, and you will
then see the new workgroup at the bottom of your tree diagram.
3. You can now select an icon for the new work group. To select an icon:
• Place your mouse pointer over the new work group item in your tree
diagram, and then click the right mouse button once.
The workgroup popup menu will now appear. Notice that this popup menu
contains several workgroup-specific commands that were not on the database popup menu. You will learn how to use all of these commands later on in
this chapter.
Using Database Map
169
4. The last step in creating the new workgroup is to rename it from "Workgroup X" to the name you would like it to be called. To rename the workgroup:
• Place your mouse pointer over the workgroup item and click the left
mouse button once. The item will turn blue to indicate that it is selected.
• Now place your mouse pointer over the selected item and click the left
mouse button once again. A box will appear around the item to let you
know that it is in Edit Mode, and a blinking cursor will appear inside
the item to let you modify its name.
• Press the Backspace key on the keyboard to delete the name "Workgroup X", and then type in the desired name.
• When you are finished entering the name for the new workgroup, press
the Enter key on the keyboard.
You will now be finished creating the new work group. At this point, your
workgroup will have a name and an icon, but it will not yet contain any
folders. The next section in this chapter will show you how to add new
folders to an existing workgroup.
170
Chapter 9
Creating a Folder
There are two ways to create a new folder in a workgroup. First, you can
create a folder based on an existing table, and second, you can create a folder
based on a new table that you add to a database (either the open Smeadlink
database or a connected external database). This section will show you how
to create a folder using each method.
Creating a Folder based on an Existing Table
The following instructions will show you how to create a folder based on an
existing table in the open Smeadlink database. If you want to create a folder
based on an existing foreign table (a table created outside of Smeadlink),
then you will first need to attach the foreign table to the open database. For
information about attaching foreign tables, see the section in this chapter
called Working with Foreign Tables.
When you finish creating the new folder, it will have a name, an icon and
one Id column. You can add other columns to the folder by using Database
Map's Field Maintenance utility and the Columns utility in Smeadlink, and
you can add new rows to the folder by using Smeadlink's editing features or
the Import Wizard utility.
To create a folder based on an existing table:
1. Place your mouse pointer over the workgroup that you want the folder to
be added to, and then click the right mouse button once.
The workgroup popup menu will now appear as shown in the example below.
Workgroup popup menu
Using Database Map
171
2. Click the Attach Table command on the workgroup popup menu.
The Attach Table window will now appear. The example below shows what
the Attach Table window looks like.
Attach Table window
3. Select the table that you want the new folder to be based on. To select a
folder:
• Click the down arrow at the right of the Existing Tables box on the
Attach Table window. A dropdown will now appear listing all the tables
in the database.
• Click the desired table. The table you selected will now appear in the
Existing Tables box.
4. Now press Enter or click the OK button on the Attach Table window.
The Attach Table window will now close, and the new folder will be added
to the selected workgroup. The folder will appear in the tree diagram beneath the workgroup item, and it will include the default cloud icon. If you
would like to change the icon from a cloud to something else, see the section
in this chapter called Modifying Existing Items in a Database. The third part
of that section explains how to change the icon of an item in the tree diagram.
172
Chapter 9
Creating a Folder Based on a New Table
The following instructions will show you how to create a folder based on a
new table that you add to a database. The database that you add the table to
can either be the open Smeadlink database, or an external database that you
have connected to the open Smeadlink database. When you finish creating
the new folder, it will have a name, an icon and one Id column. You can then
add other columns to the folder by using Database Map's Field Maintenance
utility and the Columns utility in Smeadlink, and you can add new rows to
the folder by using Smeadlink's editing features or the Smeadlink Import
Wizard utility.
To create a folder based on a new table:
1. Place your mouse pointer over the workgroup that you want the folder to
be added to, and then click the right mouse button once.
The workgroup popup menu will now appear as shown in the example below.
Workgroup popup menu
2. Click the New Table command on the workgroup popup menu.
The Create New Table window will now appear as shown in the example on
the following page.
Using Database Map
173
Create New Table window
3. Select the database that you want that you want the new table be added to.
To select a database:
• Click the down arrow at the right of the database box. A dropdown will
now appear listing the open Smeadlink database and any external databases that you have connected to Smeadlink.
• Click the desired database on the dropdown. The dropdown will now
close, and the database you selected will appear in the Database box.
Note: If you selected an external database, the new table will be automatically registered for you. You will not need to register the table manually.
4. Type the desired name for the new folder in the Name box on the Create
New Table window.
There are no limitations on the number or type of characters that you can
enter in the Name box. Whatever name you enter in this box is the name that
the new folder will be called in Smeadlink. This is different than the internal
name, which is the name the folder will be called if you work with it in
Microsoft Access or Microsoft SQL Server.
5. Type the desired internal name for the new folder in the Internal Name
box.
The Internal Name box is located directly under the Name box on the Create
New Table window. You can enter any combination of upper or lower case
letters in the Internal Name box. As you learned in step 3, the difference
between the name of a folder and the internal name of a folder is that the
name is what the folder is called in any Smeadlink program, and the internal
name is what the folder is called if you work with it in Microsoft Access or
Microsoft SQL Server.
174
Chapter 9
6. Type the desired unique field name in the Unique Field box.
You can type any combination of upper or lower case letters in the Unique
Field box. The name you enter will be used to identify the "unique field" (or
the Id column) in the new folder.
7. Select the field type for the new folder's unique field. To select a field type:
• Click the down arrow at the right of the Field Type box.
A dropdown menu will now appear listing the three different field type
options. The first option is called Long Integer. If you select this option, each cell in the new folder's unique field will need to contain a
unique integer from 0 to approximately 2 billion. The second field
type option is Automatic Counter. If you select this option, the cell in
the new folder's unique field will be filled in automatically for you
each time you create a row. The first cell will contain the integer 1, the
second cell will contain the integer 2, and so on. The third field type
option is Text. If you select this option, each cell in the new folder's
unique field will need to contain a unique text string.
• Click the desired field type option in the dropdown menu. The dropdown
menu will now close, and the field type you selected will be entered in
the Field Type box.
8. If you selected the Text field type option, then type the desired field length
for the new folder or subfolder's unique field in the Field Length box.
The field length determines how many text characters can be contained in
each cell of the new folder or subfolder's unique field. The maximum field
length is 99, which corresponds to 99 characters in each cell of the unique
field.
9. Press Enter or click the OK button on the Create New Table window.
A new folder will now be added to the open Smeadlink database. It will
appear in the tree diagram beneath the selected workgroup (the item that
you opened the popup menu from in step 1). By default, the new folder will
include a cloud icon. If you would like to change the icon from a cloud to
something else, see the section in this chapter called Modifying Existing
Items in a Database. The third part of that section explains how to change
the icon of an item in the tree diagram.
Using Database Map
175
Creating a Subfolder
A subfolder is a folder that is attached underneath another folder. Subfolders
are sometimes called child folders, and the folders that contain them are
sometimes called parent folders. Once you select a row in a parent folder,
you will be able to open any subfolder contained in that parent folder. When
the subfolder opens, it will display all the rows it contains that are attached
to the selected row in the parent folder. If the subfolder does not contain any
rows that are attached to the selected row in the parent folder, then it will be
empty when it is opened from that row.
There are two different ways to create subfolders in the Database Map program. First, you can attach a folder's table to another table that already exists
in the open database. If you use this method, the subfolder you create will
contain a number of rows to start with, but none of the rows will be attached
to the rows in the parent folder. Unless you use dropdowns, you will need to
manually create all the rows in the subfolder that you want visible from the
rows in the parent folder. One advantage of using this method is that you can
see all the rows in the subfolder at once. To do so, simply open the original
folder that you used to create the subfolder. The folder will contain all the
rows it originally contained, plus all the rows that you added to the subfolder based on this folder.
The second way to create a subfolder is to attach an existing folder to a new,
unique folder. This method is basically the same as creating a new folder for
a workgroup—you select the New Table command on the Table popup menu,
the Create New Table window appears and you fill in the desired options on
the Create New Table window for table name and unique field. If you use this
method, you will not be able to see all the rows in the subfolder at once.
This section will show you how to create a subfolder using the first method
explained above. If you want to create a subfolder using the second method,
simply follow the steps that you use to create regular folders. The only difference is that you will need to open the popup menu from the desired parent
folder, not the desired workgroup.
To create a subfolder:
1. Place your mouse pointer over the desired parent folder item in the tree
diagram, and then click the right mouse button once.
The Table popup menu will now appear as shown in the example on the
following page.
176
Chapter 9
Table popup menu
2. Click the Attach Table command on the Table popup menu.
The Attach Table submenu will now appear. This submenu contains two
options: "Automatic" and "Using Existing Fields". If you select the Automatic option, Smeadlink will automatically attach the two tables by creating
the appropriate Id field. If you select the Using Existing Fields option,
Smeadlink will let you choose an existing field to attach the two tables. The
Using Existing Fields option is helpful if the tables are external tables attached in another program. In this case, the required Id field for attaching
the tables will already exist.
3. Select the desired option on the Attach Table submenu.
If any other Smeadlink programs are open, a message box will now appear
stating that all other Smeadlink windows need to be closed before you can
continue. Press Enter or click the Yes button on the message box window.
Any other open Smeadlink programs will now be closed.
4. If you selected the Automatic option in step 3, the Attach Table window
will now appear as shown below.
Attach Table window
Using Database Map
177
• Select the desired table for the subfolder.
• Once you have selected a table, press Enter or click the OK button on
the Attach Table window.
A subfolder will now be created for the selected parent folder based on the
table you just selected. The subfolder will appear in the tree diagram beneath the folder item, and it will include the default cloud icon. If you would
like to change the icon from a cloud to something else, see the section in this
chapter called Modifying Existing Items in a Database. The third part of that
section explains how to change the icon of an item in the tree diagram.
5. If you selected the Using Existing Fields option in step 3, the Attach
Tables Using Existing Fields window will now appear as shown below.
Attach Tables Using Existing Fields
• Select the desired table for the subfolder. If the selected table does not
contain any fields matching the data type of the Id field in the parent
table, a window will appear with a message to this effect and the Fields
box will be disabled.
• Select the desired Id field for the subfolder's table.
• Once you have selected a table and an Id field, press Enter or click the
OK button on the Attach Tables Using Existing Fields window.
A subfolder will now be created for the selected parent folder based on the
table you just selected. The subfolder will appear in the tree diagram beneath the folder item, and it will include the default cloud icon. If you would
like to change the icon from a cloud to something else, see the section in this
chapter called Modifying Existing Items in a Database. The third part of that
section explains how to change the icon of an item in the tree diagram.
178
Chapter 9
Creating a Dropdown
Creating a dropdown is similar to creating a subfolder. Both procedures involve setting up a parent-child relationship between two folders in the open
Smeadlink database. The difference between the two procedures is that creating a subfolder sets up the relationship from the parent folder to the child
folder, but creating a dropdown sets up the relationship from the child folder
to the parent folder.
The purpose of dropdowns is to attach rows in child folders to rows in parent folders. When you create a dropdown, a new column is created in the
child folder. This column is attached to a column you select in the parent
folder, that easily identifies each row in the parent folder. For instance, if the
parent folder contained client rows, the dropdown column would probably
be attached to the column in the parent folder that contained client names.
Once the new column has been created in the child folder, any Smeadlink
operator can use the column to attach rows in that folder to rows in the
parent folder. To attach a row, simply click the new column's cell in the
desired row. A dropdown will appear listing the entries from the selected
column in the parent folder. Clicking the entry of the desired row in the
parent folder will attach it to the selected row in the child folder.
The example below shows what a dropdown looks like in a Smeadlink folder
called Clients. The dropdown in the example contains a list of billing attorneys, and it allows Smeadlink operators to attach rows in the child folder
(Clients) to rows in the parent folder (Billing Attorney).
A dropdown in a Smeadlink folder
Using Database Map
179
In order to create a dropdown, you will need to use both the Database Map
program and the administrative utilities in Smeadlink. You will use the Database Map program to attach the table of the parent folder to the table of the
child folder, and you will use Smeadlink to create the column that the
dropdown can be opened from in the child folder.
This section explains the whole process for creating a dropdown in a
Smeadlink folder. There is no limit on the number of dropdowns in a folder,
so you can use the information in this section to create any number of
dropdowns in a folder (or subfolder).
To create a dropdown in a Smeadlink folder:
1. Place your mouse pointer over the desired parent folder item in the tree
diagram, and then click the right mouse button once.
The Table popup menu will now appear. The example below shows what the
Table popup menu looks like.
Table popup menu
2. Click the Attach Table command on the Table popup menu.
The Attach Table submenu will now appear. This submenu contains two
options: "Automatic" and "Using Existing Fields". If you select the Automatic option, Smeadlink will automatically attach the two tables by creating
the appropriate Id field. If you select the Using Existing Fields option,
Smeadlink will let you choose an existing field to attach the two tables. The
Using Existing Fields option is helpful if the tables are external tables attached in another program. In this case, the required Id field for attaching
the tables will already exist.
180
Chapter 9
3. Select the desired option on the Attach Table submenu.
If any other Smeadlink programs are open, a message box will now appear
stating that all other Smeadlink windows need to be closed before you can
continue. Press Enter or click the Yes button on the message box window.
Any other open Smeadlink programs will now be closed.
4. If you selected the Automatic option in step 3, the Attach Table window
will now appear as shown below.
Attach Table window
• Select the desired table for the child folder.
• Once you have selected a table, press Enter or click the OK button on
the Attach Table window.
The Attach Table window will now close, and you will be done using the
Database Map program. You can close it now if you will not be using it for
any other tasks.
5. If you selected the Using Existing Fields option in step 3, the Attach
Tables Using Existing Fields window will now appear as shown below.
Attach Tables Using Existing Fields
Using Database Map
181
• Select the desired table for the child folder. If the selected table does
not contain any fields matching the data type of the Id field in the
parent table, a window will appear with a message to this effect and
the Fields box will be disabled.
• Select the desired Id field for the child folder's table.
• Once you have selected a table and an Id field, press Enter or click the
OK button on the Attach Tables Using Existing Fields window.
The Attach Table window will now close, and you will be done using the
Database Map program. You can close it now if you will not be using it for
any other tasks.
6. Open the Smeadlink program.
7. Open the folder in Smeadlink that you want the dropdown to be in (the
child folder in the dropdown relationship), and open the desired layout in
the folder.
8. Add a new column to the open layout. This column will be the column
that the dropdown is opened from.
When you create the column, make sure the column type is Upper Table
Field. Once you select the Upper Table Field option, select which field in
the parent folder you want displayed in the dropdown. For information about
creating a new column in a layout, see the section Creating a Column in a
Layout in chapter 12.
Note: Because a dropdown column in a folder does not pull its data from the
folder's table, you do not need to create a new field in the layout before you
create the new column.
After you finish creating the dropdown column in the child folder, you will
be finished creating your dropdown. Your Smeadlink operators will now be
able to use the dropdown to attach rows in the child folder to rows in the
parent folder.
182
Chapter 9
Working with Foreign Tables
As you learned in chapter 8, Database Map has been expanded in Smeadlink
3.1 to work with foreign tables (tables created outside of Smeadlink). You
can now connect a Smeadlink database to one or more external databases.
Once you have connected to an external database, you can register any table
in the database with Smeadlink. The foreign table (or tables) will then behave just like a regular Smeadlink table, and you will be able to use it to
create folders or subfolders in the open Smeadlink database.
Some foreign tables are already located in a Smeadlink database, but they
are not visible in the database. For instance, if you used Microsoft Access to
create a new table in a Smeadlink database, the table would not be visible
when you reopened the database in Smeadlink. If you want to create a folder
or subfolder based on one of these tables, you can now simply register the
table in Smeadlink. Once the table has been registered, it will behave like a
regular Smeadlink table, and you will be able to use it to create your folder
or subfolder.
This section is divided into two parts. The first part explains how to connect
an external database to Smeadlink, and the second part explains how to register a foreign table. If you want to work with a foreign table in an external
database, you will need to connect the database and then register the desired
table in Smeadlink. If you want to work with a foreign table in a Smeadlink
database, you will just need to register the table. Once you have finished the
appropriate procedure, the foreign table (or tables) will behave just like a
regular table, and you will be able to use it to create folders or subfolders.
Connecting an External Database to a Smeadlink Database
The following instructions will show you how to connect an external database to a Smeadlink database. If you want to work with a foreign table in an
external database, the first step is to connect the database to Smeadlink. If
you want to work with a foreign table in a Smeadlink database, however,
you will not need to connect a database, and you can go straight to the instructions for registering a foreign table.
Using Database Map
183
To connect an external database to Smeadlink:
1. Place your mouse pointer over the database item in the tree diagram, and
click the right mouse button once.
The database popup menu will now appear. The example below shows what
that the database popup menu looks like.
Database popup menu
2. Click the Define External Database connections command on the database
popup menu.
If any other Smeadlink programs are running, a message will now appear
stating that all other Smeadlink programs must be closed before you can
continue. Press Enter or click the Yes button on the window. Any other
Smeadlink programs that were running will now be closed, and the Database
Maintenance window will appear. The example on the following page shows
what the Database Maintenance window looks like.
184
Chapter 9
Database Maintenance window
3. Click the Add button on the toolbar at the bottom of the Database Maintenance window. The Add New Database window will now appear as shown
below.
Add New Database window
4. Fill in the options on the Modify Database Properties window with the
appropriate information for the external database you want to connect.
Note: If you do not enter a User Id and Password, then the access rights for
the external database will be determined at the system level. If you do enter
a User Id and Password, then anyone who opens the database through
Smeadlink will have the access rights of the User Id and Password you enter.
5. Press Enter or click the OK button at the bottom of the Modify Database
Properties window.
The external database you specified in step 4 will now be connected to the
open Smeadlink database. You will now need to register any tables in the
external database that you want to work with in Smeadlink. The next part in
this section will show you how to register a foreign table.
Using Database Map
185
Registering a Foreign Table in a Smeadlink Database
The following instructions will show you how to register a foreign table in a
Smeadlink database. If the table is contained in an external database, then
you will need to register it after you have connected the external database to
Smeadlink. If the table is contained in a Smeadlink database, then you will
need to register the table before it becomes visible in the database from
Smeadlink.
To register a foreign table in a Smeadlink database:
1. Place your mouse pointer over the database item in the tree diagram, and
click the right mouse button once.
The database popup menu will now appear. The example below shows what
that the database popup menu looks like.
Database popup menu
2. Click the Register Table with Smeadlink command on the database popup
menu.
If any other Smeadlink programs are running, a message will now appear
stating that all other Smeadlink programs must be closed before you can
continue. Press Enter or click the Yes button on the window. Any other
Smeadlink programs that were running will now be closed, and the Add
Table Definition window will appear as shown on the following page.
186
Chapter 9
Add Table Definition window
3. In the Available Databases box, select the database that contains the desired foreign table.
4. In the Available Tables box, select the desired foreign table.
5. In the Primary Field box, select the desired Id field for the foreign table.
6. Now press Enter or click the OK button on the Add Table Definition
window.
The foreign table will now become visible in Smeadlink, and you will be
able to use it to create folders and subfolders just like regular Smeadlink
tables.
Using Database Map
187
Using the Field Maintenance Utility
In Smeadlink 3.0, fields were created in Smeadlink using the Layouts utility.
In newer versions, however, the utility for creating fields has been expanded
and moved to the Database Map program. The new utility for creating fields
is called the Field Maintenance utility, and in addition to creating fields it also
allows you to view all the fields in a table, edit or remove existing fields and
print a list of all the table's fields. This section will show you how to use the
Field Maintenance utility. The first part will show you how to open the utility,
and the remaining parts will show you how to use it to add, edit, delete and
print the fields in a table.
To open the Field Maintenance utility:
1. Place your mouse pointer over a folder or subfolder item in the tree diagram
that is based on the desired table, and then click the right mouse button once.
The Table popup menu will now appear. The example below shows what the
Table popup menu looks like.
Table popup menu
2. Click the Fields command on the Table popup menu.
The Field Maintenance utility will now appear, and it will list all the fields in
the selected table. The example on the following page shows what the Field
Maintenance utility looks like.
188
Chapter 9
Field Maintenance utility
To add a field to a table:
1. Open the Field Maintenance utility for the table you would like to add a
field to.
2. Click the Add button on the toolbar at the bottom of the Field Maintenance utility. The Create New Field window will now appear as shown below.
Create New Field window
3. Type the desired name for the new field in the Internal Name box.
4. Select the desired type for the field in the Field Type box. To select a field
type:
• Click the down arrow at the right of the Field Type box. A dropdown
will now appear listing the different available types.
• Click the desired type. The dropdown will now close, and the type you
selected will appear in the Field Type box.
5. If the type you selected does not specify a certain field length, then type
the desired length for the new field in the Field Length box.
6. Press Enter or click the OK button at the bottom of the Create New Field
window. The window will now close, and the new field will now be added
to the table the Field Maintenance utility was opened from.
Using Database Map
189
To edit a field in a table:
1. Open the Field Maintenance utility for the table that contains the field
you would like to edit.
2. Select the desired field in the table. To select a field:
• Place the mouse pointer over the row of the desired field in the Field
Maintenance utility.
• Click the left mouse button once. The field's row will turn blue after
you click it to indicate that it is now selected.
3. Click the Edit button on the toolbar at the bottom of the Field Maintenance utility. The Modify Field window will now appear as shown below.
Modify Field window
4. You can now edit the name, type and length of the selected field.
• To edit the name, simply click the Internal Name text box and type in
the desired name. You will not be able to rename a field if the field is
the primary Id field for its table, or if the field is used in any table
relationships.
• To edit the type, simply click the down arrow at the right of the Field
Type box. A dropdown will now appear listing the different available
types. Click the desired type on the dropdown. It will now close, and
the type you selected will appear in the Field Type box. If the selected
type specifies a certain field length, then that length will automatically
appear in the Field Length box and you will not be able to change it.
• To edit the field length (if the selected type does not specify a certain
length), simply type the desired length in the Field Length box.
5. Once you have finished editing the selected field, press Enter or click the
OK button on the Modify Field window. The window will now close, and
your changes will be added to the table.
190
Chapter 9
To delete a field from a table:
1. Open the Field Maintenance utility for the table that contains the field you
would like to delete.
2. Select the desired field in the table. To select a field:
• Place the mouse pointer over the row of the desired field in the Field
Maintenance utility.
• Click the left mouse button once. The field's row will turn blue after
you click it to indicate that it is now selected.
3. Click the Remove button on the toolbar at the bottom of the Field Maintenance utility.
If the field you selected to delete is used in any layouts, a window will now
appear listing each layout that the field is used in. You will not be able to
delete a field while it is a member of any layouts, so if you still want to
delete the field you will need to go into Smeadlink and remove it from all the
layouts it is a part of.
If the field you selected is not used in any layouts, then a Smeadlink window
will now appear asking if you want to delete the field.
4. Press Enter or click the OK button on the Smeadlink window. The field
will now be permanently removed from its table.
To print a list of all the fields in a table:
1. Open the Field Maintenance utility for the desired table.
2. Click the Print button on the toolbar at the bottom of the Field Maintenance utility. A standard windows Print window will now appear.
3. Set the options on the Print window to the desired settings.
4. Press Enter or click the OK button at the bottom of the Print window.
Smeadlink will now print a list of the fields in the selected table. The list will
be divided into three labeled columns—one for field names, one for field
types and one for field widths.
Using Database Map
191
Modifying Existing Items in a Database
This section will show you how to use Database Map to modify the existing
items in a Smeadlink database. The first part of this section will show you
how to delete an item from a database, the second part will show you how to
rename an item, the third part will show you how to change the icon of an
item and the fourth part will show you how to relocate an item.
The last part of this section will then show you how to adjust the properties
of an item. You can adjust the properties of any folder or subfolder item in
the tree diagram. The properties of a folder or subfolder determine things
like what the background color will be and whether or not images can be
attached to the folder or subfolder's rows.
To delete an item from the open Smeadlink database:
1. Place your mouse pointer over the item in the tree diagram that you want to
delete, and then click the right mouse button once.
The Workgroup or Table popup menu will now appear. You will use the
Remove command on the popup menu to delete the selected item from the
open Smeadlink database. If the Remove command on the popup menu is
lowlighted, then it is not available for the selected item and you will not be
able to delete that item.
The Remove command is not available for the database item at the top of the
tree diagram, because deleting this item would delete the entire database.
Remove is also not available for any item in the database that contains at
least one subitem. For instance, Remove would not be available for a workgroup item that contained three folders. If you would like to delete an item
that contains subitems, you will need to delete all the subitems first. Once
you have deleted all the subitems, the Remove command will become available for the item you want to delete.
Note: There is no undo feature in Database Map, so once you delete an item
you cannot get it back. Make sure you have selected the proper item in the
tree diagram before proceeding to step 2.
2. Click the Remove command on the popup menu. A popup window will now
appear asking if you want to delete the selected item.
3. Press Enter or click the OK button on the message window. The selected
item will now be permanently removed from the open Smeadlink database.
192
Chapter 9
To rename an item in the open Smeadlink database:
1. Place your mouse pointer over the item in the tree diagram that you would
like to rename, and then click the right mouse button once.
The Database, Workgroup or Table popup menu will now appear, depending
on what type of item you selected.
2. Click the Rename command on the popup menu.
The popup menu will now disappear, and the selected item in the tree diagram
will be put into edit mode. A box will appear around the item's name, the letters
in the name will be highlighted and a blinking cursor will appear at the right
side of the name. The example below shows what an item in the tree diagram
looks like after it has been put into edit mode.
An item in edit mode
3. Type desired name for the selected item.
There are no limitations on the number or type of characters that you can use
for the name of an item. The original name of the item will be removed as
soon as you start typing the new name.
4. Once you are finished typing in the new name for the selected item, press
the Enter key on your keyboard. This will turn off Edit mode.
Using Database Map
193
To adjust the properties of an item in the open Smeadlink database:
1. Place your mouse pointer over the item in the tree diagram whose properties you would like to adjust, and then click the right mouse button once.
The Table popup menu will now appear.
2. Click the Table Properties command on the popup menu.
The Properties window will now appear. The Properties window contains all
the properties that can be adjusted for Smeadlink folders and subfolders.
You can use this window to view the current properties settings for the selected item, and to adjust some or all of the settings. The example below
shows what the Properties window looks like.
Properties window
The first two options on the Properties window are for reference only—they
cannot be modified. The Database option displays the name of the database
that contains the table for the selected item, and the Internal Name option
displays the internal name of this table.
194
Chapter 9
3. If you would like to modify the background color of the selected item,
follow the steps below.
• Click the down arrow at the right of the Color Selection option.
A dropdown menu will now appear listing the different color options.
The color options in the dropdown menu are numbered from 1–16.
The example below shows what the Color Selection dropdown menu
looks like.
Color Selection dropdown menu
• Click the desired option on the Color Selection dropdown menu. The
Color Selection dropdown menu will now disappear, and the color
you selected will appear in the Color Selection box.
4. If you would like to modify the bar code prefix of the selected item, or
create a new bar code prefix if it does not yet have one, type the desired bar
code prefix in the Bar Code Prefix box.
The bar code prefix you enter for this item needs to be unique from the other
bar code prefixes in the database. Typically, the bar code prefix for an item
is the first letter of that item's name. For instance, the bar code prefix for a
folder called Boxes would probably be "B". Although this is the typical way
bar code prefixes are created, you could also create a bar code prefix with
multiple letters in it, or even one with numbers.
Using Database Map
195
If you are not familiar with bar code prefixes, they are used in Smeadlink to
help speed up the tracking process, and to eliminate incorrect tracking assignments. Bar code prefixes are entirely optional—you can choose whether
or not each folder or subfolder in your Smeadlink database will contain a bar
code prefix. Typically, bar code prefixes are only created for folders that
contain tracking rows. For instance, a folder that contained rows for different boxes would probably have a bar code prefix, but a folder that contained
customer rows would probably not have a bar code prefix.
If you do decide to create a bar code prefix for an item, you will need to
make sure that any labels printed for the objects in this item contain the
same prefix in their bar codes as the prefix you specified for the item. For
instance, say you had a folder called Locations that contained rows for different tracking locations, and say that the bar code prefix for this folder was
"L". After you specified "L" as the bar code prefix for this folder, you would
need to open the label design for this folder in Smeadlink Label Manager,
and specify "L" as the first character in the label's bar code. Any labels
printed for the objects in the Locations folder would then contain the prefix
"L" in their bar codes.
When you begin to track an object by scanning its bar code, Smeadlink will
look at the first character in the bar code and see if it matches any existing
bar code prefix in the open database. If Smeadlink finds a matching prefix, it
will go immediately to that folder or subfolder's unique field. It will then
scan through the cells in that field until it finds an entry that matches the rest
of the bar code that you scanned. If Smeadlink does not find a matching
prefix, then it will use the bar code search order for the open database to
look through the database until it finds a match. The last section in this
chapter will show you how to modify the bar code search order of the open
database.
As you can see, the advantage of using a bar code prefix is that Smeadlink
knows immediately which folder or subfolder contains the row of the object
you scanned, so it only has one unique field to look through. Without a bar
code prefix, Smeadlink has to search through the unique field of each table
in the bar code search order until it finds a match. This can noticeably increase the processing time when you track objects.
196
Chapter 9
5. If you would like to specify one or more strip characters for the selected
item, then type them now in the Strip Characters box.
You can only enter one character or group of characters in the Strip Character box; you cannot enter multiple groups of characters. For instance, you
could specify the character group "--" as the strip characters for an item, but
you could not specify the character "-" and the character "?" as separate strip
characters for the same item.
Like Bar Code Prefix, the Strip Characters feature is used for items that
contain tracking rows. When you track one of the objects in a folder or
subfolder by scanning the object's bar code or entering its Id number,
Smeadlink will begin searching for a row in the open database that contains
a matching Id number with the object you scanned. When Smeadlink is comparing the number you entered with the numbers in the unique field of an
item, it will temporarily remove any characters in the number you entered
that match the strip characters that have been specified for this item. If
Smeadlink cannot find any matching number in this item, then it will proceed to the next item, remove the appropriate strip characters from your
original number and search through the unique field of this item looking for
a matching number. Smeadlink will continue this process until it has either
found a row that matches the number you entered, or it has gone through all
the items in the bar code search order for the database.
The Strip Characters feature is often used with the Mask feature to make
sure that special characters in a tracking bar code are positioned correctly.
For instance, say you have a folder that contains rows for tracking objects,
and the Id number of each row in this folder is made up of three numbers, a
dash and then two more numbers. When someone tries to track one of the
objects in this folder by typing in the object's bar code, there is a good chance
that they will either place the dash incorrectly in the Id number, or not type
in the dash at all. To avoid problems with users entering the dash incorrectly, you could specify the dash as a strip character in this folder. Smeadlink
would then remove all dashes typed in while tracking the objects in this
folder. You could then use the Mask feature to automatically put a dash
back into the Id number in the correct position (the Mask feature is explained on the following page).
Using Database Map
197
6. If you would like to create a mask for the selected item, then type the
desired mask into the Mask box.
As you learned on the previous page, the Mask feature is used in conjunction with the Strip Characters feature to temporarily reformat bar codes or Id
numbers that are entered while tracking Smeadlink objects. You can use
these two features to make sure that when users try to track one of the objects in this folder or subfolder, the number they enter matches the format of
the numbers in this item's unique field.
The format characters for creating masks in Smeadlink are standard mask
characters. The characters are listed and explained below.
Mask Character
#
.
,
Description
Digit placeholder.
Decimal placeholder. The
actual character used is the
one specified as the decimal
placeholder in your regional settings. This character is treated as a literal
for masking purposes.
Thousands separator. The actual character used is the one specified as the
thousands placeholder in your regional
settings. This character is treated as a
literal for masking purposes.
:
Time separator. The actual character
used is the one specified as the time
placeholder in your regional settings.
This character is treated as a literal for
masking purposes.
/
Date separator. The actual character
used is the one specified as the date
placeholder in your regional settings.
This character is treated as a literal for
masking purposes.
198
Chapter 9
\
Treat the next character in the mask
string as a literal. This allows you to include the #, &, A and ? characters in the
mask. This character is treated as a literal for masking purposes.
&
Character placeholder. Valid values for
this placeholder are ANSI characters in
the following ranges: 32–126 and 128–
255.
>
Convert all the characters that follow to
uppercase.
<
Convert all the characters that follow to
lowercase.
A
Alphanumeric character placeholder
(entry required).
a
Alphanumeric character placeholder
(entry optional).
9
Digit placeholder (entry optional).
C
Character or space placeholder (entry
optional). This operates exactly like the
& placeholder, and ensures compatibility with Microsoft Access.
?
Letter placeholder.
Literals
All other characters are displayed as literals.
7. If you would like to modify the four headers and fields for the selected
item, then type the desired headers in the two header boxes, select the desired field in the two field boxes and type the desired width in the width
boxes.
The header and field options are used to identify the rows in the selected
item when they are displayed in other Smeadlink utilities. For instance, these
options will be used to identify any rows that are displayed in the Smeadlink
Tracking Viewer. The example on the following page shows how these options are used to identify a row in the Tracking Viewer.
Using Database Map
199
Data in Display 1 Heading box
Data in Display 2 Heading box
Data from field in
Display 2 Field box
Data from field in
Display 1 Field box
The data that you enter in the two heading boxes will be displayed exactly
as it is entered in the boxes, regardless of which row is selected. On the other
hand, the data that you enter in the two field boxes will be used to specify
fields in the selected item. The data that is displayed for these fields will
change depending on which row is selected. For instance, in the example
above the headings Description: and ID: will be displayed in the Viewer for
any row that is selected in the Locations folder. However, the data "Records
Center" and "1" will change if another row is selected in the Locations folder.
The width options allow you to specify the width in twips of each field (1
twip = 1/1440 of an inch). Field width is not relevant in the Tracking Viewer,
because all the tracking information for a row is displayed in one line. Field
width is used in dropdowns, though, because the header is displayed above
each field. In that case, each width you enter defines the width of both a
header and a field. If you leave the width options blank, a default width will
be used.
8. If you want to be able to attach images, enterprise report documents and
PC Files documents to the rows in the selected item, make sure the Allow
Attachments option is checked.
9. If you would like to adjust the tracking properties for the selected item,
click the Tracking button at the bottom of the Properties window.
The Tracking Properties window will now appear as shown in the example
on the following page.
200
Chapter 9
Tracking Properties window
10. If you would like to modify the container level of the selected item,
select the desired level in the Container Level box.
A container is a tracking object that can both be tracked and have other
objects tracked to it. In other words, sometimes it behaves like a an object,
and other times it behaves like a destination. For instance, boxes are often
containers because they can have objects like folders tracked to them, but
they themselves can then be tracked to employees or shelves or rooms.
The Container Level setting determines what objects can be tracked to the
rows in this item, and what destinations the rows themselves can be tracked
to. Objects with a higher container level than the rows in this item can be
tracked to the rows, and objects with a lower container level can serve as
destinations for the rows. If the rows in an item cannot be tracked to other
objects at all, then you can select the Not a Container option on the Container Level dropdown.
11. If you would like to modify the tracking status field of the selected item,
enter the desired field in the Tracking Status Field box.
12. If the selected item has a container level between 1 and 7 and you do not
want the rows in the item to be tracked to other locations, then make sure the
Tracking Object option is disabled. Otherwise, make sure the Tracking Options is enabled.
13. Once you have made all the desired changes on the Tracking Properties
window, press Enter or click the OK button to save your changes. The Tracking Properties window will now close, and the standard Properties window
will become active once more.
14. Press Enter or click the OK button on the standard Properties window to
save the changes you made. The Properties window will now close.
Using Database Map
201
Modifying the Bar Code Search Order for the Open Database
When you enter an Id number in Smeadlink Tracking, Smeadlink searches
through the open database, looking for a row with the same Id number as the
number you entered (this is true for both object Id numbers and destination
Id numbers). Typically, Smeadlink uses a bar code prefix to determine what
folder or subfolder the matching row is located in. Smeadlink then goes
straight to that folder or subfolder, and searches the entries in its Id column
for a matching number. Although this system works well when the labels
used for tracking have bar code prefixes on them, it is not very reliable or
efficient if the tracking labels do not have bar code prefixes. In that situation, duplicate Id numbers on the labels can lead to incorrect tracking assignments, and even if the correct match is found, it may take a long time.
For situations where the labels used for tracking do not have bar code prefixes on them, Smeadlink allows you to set up a bar code search order for the
open database. The bar code search order lists what tables in the database to
look through when trying to find a matching Id number, and what order to
look through the tables. It also specifies what field in each table contains
Tracking Id numbers, and what mask and strip characters to apply for the
field, if necessary. This section will show you how to modify the bar code
search order for the open database.
To modify the bar code search order for the open database:
1. Place your mouse pointer over the database item at the top of the tree
diagram, and click the right mouse button. The database popup menu will
now appear.
2. Click the Bar Code Search Order command on the database popup menu.
The Bar Code Search Order window will now appear as shown below.
Bar Code Search Order window
202
Chapter 9
3. You can remove as many tables as you want from the bar code search
order list. To remove a table from the list:
• Select the row of the table you want to remove (to select a row, click
the row selector of the desired row—the row selector is the gray box at
the left of each row).
• Now click the Delete Row button at the bottom of the Bar Code Search
Order window. A message window will appear asking if you want to
delete the selected row.
• Press Enter or click the OK button on the message box to delete the
selected row
4. If you want to move an existing table in the list to a different position:
• Select the row of the desired table.
• Click the Move Up or Move Down buttons at the bottom of the Bar
Code Search Order window, until the selected row is in the desired
position.
5. The Field Name column determines which field in each table contains
tracking Id numbers. To modify the Id field of an existing table:
• Click the Field Name cell of the desired row. A dropdown will now
appear listing the different fields in the selected table.
• Click the desired field on the dropdown. The dropdown will now close,
and the field you selected will appear in the Field Name cell of the
selected row.
6. The Strip Characters column determines what characters, if any, to temporarily pull out of tracking Id numbers before comparing them to the entries in the Id field of the selected table. If no match is found in the selected
table, any stripped characters will be put back into the tracking Id number,
and Smeadlink will proceed to the next table in the list. For information
about the format for entering stripped characters, see step 5 of the previous
section in this chapter.
Using Database Map
203
7. The Mask column determines what mask, if any, to apply to tracking Id
numbers before comparing them to the entries in the Id field of the selected
table. Like Strip Characters, Mask is a temporary feature that only applies
while tracking Id numbers are compared to the Id numbers of the selected
table. If no match is found in the table, the mask is removed and Smeadlink
proceeds to the next table in the bar code search order list. For information
about the format for entering masks, see step 6 of the previous section in this
chapter.
8. If you would like to add another table to the bar code search order list:
• Click the Table Name cell of the blank row at the bottom of the list. A
dropdown will now appear listing the different tables in the open database.
• Click the desired table in the dropdown. The dropdown will now close,
and the table you selected will appear in the Table Name cell of the
row. Also, a pencil will appear to the left of the row to indicate that the
row is in Edit Mode, and a new, blank row will be added to the bottom
of the list.
• Click the Field Name cell of the same row. A dropdown will now
appear listing the different fields in the selected table.
• Click the desired field in the dropdown. The dropdown will now close
and the field you selected will appear in the Field Name cell of the
row.
• In the Strip Characters cell of the row, enter the desired strip character
or characters. If this option does not apply for the selected table, then
you can leave it blank. Otherwise, see step 5 of the previous section
for information about formatting strip characters.
• In the Mask cell of the row, enter the desired mask. If this option does
not apply for the selected table, then you can leave it blank. Otherwise,
see step 6 of the previous section for information about formatting
masks.
• Click the Up Arrow or Down Arrow key once to save the row you just
created.
• Click the Close button to close the Bar Code Search Order window.
Introduction to Label Manager
10. Introduction to Label Manager
Chapter contents
Introduction
Basic Label Manager Terms
Basic Label Manager Concepts
205
206
Chapter 10
Introduction
The previous chapter showed you how to use the Database Toolkit program.
You learned how to open tables in the Database Toolkit, and you learned
how to execute single and multiple SQL statements.
This chapter will introduce you to the Label Manager program. Label Manager is a program that allows you to create label designs for black-and-white
labels. Once you have created the designs in Label Manager, you will be
able to print black-and-white labels from Smeadlink. The first section of this
chapter will introduce you to some basic Label Manager terms, and the second section will explain the basic concepts for using Label Manager.
Introduction to Label Manager
207
Basic Label Manager Terms
There are several terms that are often used in discussing the Label Manager
program. This section will introduce you to those terms and explain how
they are typically used.
Black-and-white label
Black-and-white labels are basic labels used to identify tracking objects and
destinations. Each black-and-white label includes a unique ID number for
identifying an object or destination, and some basic information about the
object or destination (like a name or description).
The difference between black-and-white labels and ColorBar labels is that
black-and-white labels do not include color patterns. ColorBar labels include color patterns because they are made for identifying file folders, and
the color patterns help distinguish between different groups of folders. Blackand-white labels, on the other hand, are made for identifying all types of
tracking objects and destinations, so the color patterns are not necessary.
Label design
A label design is a template for printing labels. In order to print either blackand-white labels or ColorBar labels, you will need to first set up a label
design. Label Manager is the tool you will use to set up label designs for
black-and-white labels. Label Manager allows you to create label designs
for any table in the open Smeadlink database. Once you have created a design for a table, your Smeadlink operators will be able to print labels from
the folders or subfolders in Smeadlink that are based on that table. The information on the labels will be laid out according to your label design, and the
actual data that appears on each label will be taken from the rows in the
folder or subfolder.
208
Chapter 10
Basic Label Manager Concepts
Label Manager is a program that allows you to create label designs for blackand-white labels. A label design is like a template—it determines what type
of information will be on the labels, and where the information will be placed.
You will need to create at least one label design for each Smeadlink folder or
subfolder that you want to print labels from. Once you have created a design
for a folder, your Smeadlink users will be able to use the design to print
black-and-white labels for the rows in that folder. The example below shows
what a label design looks like in the Label Manager program.
A label design in the Label Manager program
Label Manager allows you to place three kinds of data on a label design:
barcodes, text and fields. When you place text on a label design, the text is
static—the same text appears on all labels printed with the design. When
you place bar codes or fields on a label design, however, the information in
the bar code or field changes with each label that is printed. This is because
the bar code and field objects on the design are attached to the design's
Smeadlink table. The first label printed includes data from the first row in
the table, the second label includes data from the second row, etc.
In addition to features for inserting bar codes, text and fields on a label
design, the Label Manager also includes some formatting features to make it
easier to position objects on a label design. For instance, the Center Horizontal feature allows you to center an object horizontally in the design, and
the Center Vertical feature allows you to center an object vertically in the
design.
Using Label Manager
11. Using Label Manager
Chapter contents
Introduction
Creating a New Label Design
Creating Text Objects on a Label Design
Creating Bar Code Objects on a Label Design
Creating Field Objects on a Label Design
Deleting a Label Design
209
210
Chapter 11
Introduction
The previous chapter introduced you to the Label Manager program. You
learned about basic Label Manager terms, and about the basic concepts for
using Label Manager.
This chapter will show you how to use the Label Manager program to create
label designs for printing black-and-white labels. Once you have created the
designs in Label Manager, your Smeadlink operators will be able to use the
designs to print black-and-white labels from Smeadlink. For information about
printing labels from Smeadlink, see chapter 7 of the Smeadlink User's Guide.
Using Label Manager
211
Creating a New Label Design
This section will show you how to create a new, blank label design for a
table in the open Smeadlink database. Once you have created the design,
you will then need to add the desired text objects, bar code objects and field
objects to it. You will learn how to add text, bar code and field objects to a
label design later in this chapter.
When you have finished adding the desired objects to your design, your
Smeadlink operators will be able to use the design to print black-and-white
labels from Smeadlink. The design can be used to print labels from any folder
or subfolder in Smeadlink based on the design's Smeadlink table. If your
operators need to print labels from folders or subfolders that are based on a
different table, then you will need to create another label design for that
table. You can create label designs for any user table in a Smeadlink database.
To create a blank label design for a Smeadlink table:
1. Open the Label Manager program from the Librarian.
For information about opening Label Manager, see chapter 2 of this manual.
The example below shows what the Label Manager program looks like after
it has just been opened.
Label Manager program immediately after being opened
2. Open the File menu from the main menu bar, and click the New Label
command.
The Enter Label Information window will now appear. The example on the
following page shows what the Enter Label Information window looks like.
212
Chapter 11
Enter Label Information window
3. Enter the desired name for the new design in the Label Name box at the
top of the Enter Label Information window.
4. Select the desired Smeadlink table for the new label design. To select a
table:
• Click the down arrow at the right of the Table Name box. A dropdown
will now appear listing the tables in the open Smeadlink database.
• Click the desired table in the dropdown. The dropdown will now close,
and the table you selected will appear in the Table Name box.
5. Select the desired stock type for the new label design. To select a stock
type:
• Click the down arrow at the right of the Form box.
A grid will now appear listing the different available stock types, and
the print information for each type. The example on the following page
shows what the Form grid looks like.
Using Label Manager
213
Form grid
The Form column lists the names of the different types. The remaining
columns in the Form grid list the print information for each label type.
The Page Width and Page Height Columns list the dimensions of the
sheet each type is printed on, and the Across and Down columns list
the number of labels printed on each sheet.
• Click the desired stock type in the Form grid. The grid will now close,
and the stock type you selected will appear in the Form box.
6. Enter the desired SQL statement in the SQL String box.
The SQL String statement is used to retrieve the actual data that will be on
the labels printed with this design. For a basic statement that will print labels
for all the rows in the selected table, click the Create SQL button under the
SQL String box. The SQL statement will now be automatically created for
you, and entered into the SQL String box.
Note: The SQL String statement will be modified at print time, if one or more
rows are selected in the Smeadlink folder or subfolder that the labels are
being printed from. In this situation, Smeadlink will automatically modify
the SQL String statement so that labels are only printed for the selected
rows.
7. Enter the desired update statement in the SQL Update box.
The SQL Update statement is run after the labels have been printed, and it is
typically used to set print flags.
8. If you would like all the labels printed with this design to have an outline
around them, then enable the Display Label Outline option.
214
Chapter 11
9. Click the OK button at the bottom of the Enter Label Information window.
The Enter Label Information window will now close, and a blank label design will appear in the main Label Manager window. The shape of the blank
design will be determined by the form you specified in the Enter Label Information window. The example below shows what a blank design looks
like in the Label Manager window.
A blank label design
Once you have created a new label design, you will need to add the desired
text objects, bar code objects and field objects to the design. The next three
sections in this chapter will show you how to add text, bar code and field
objects to a label design.
Using Label Manager
215
Creating Text Objects on a Label Design
This section will show you how to create one text object on an existing label
design. You can use the procedure explained in this section to create as
many text objects as you want on a label design. The text in each text object
will be static, so it will appear the same on all labels printed with the design.
If you are building a label design from scratch, then you will need to add bar
code and field objects to the label after adding the desired text objects. The
next two sections in this chapter will show you how to add bar code and
field objects to an exiting label design.
To create a text object on an existing label design:
1. Select the label design that you want to create a text object for. To select
a label design:
• Open the File menu from the main menu bar, and click the Load Label
command. A submenu will now appear listing all the label designs in
the open Smeadlink database.
• Click the desired label design on the Load Label submenu. The selected design will now appear in the main Label Manager window. If
you have not added any text, bar code or field objects to the design yet,
then it will be blank.
2. Add a new text object to the open design. To add a new text object:
• Click the Insert New Text... button on the button bar.
OR
• Click the Insert command on the Tools menu, and then click the
Text command on the Insert submenu.
A new text object will now appear in the top, left corner of the design.
The text object will contain a red outline around it to indicate that it is
selected, and it will contain the text "New".
216
Chapter 11
3. Drag the new text object to the desired location on the label design.
If you want the text object to be centered horizontally or vertically on the
design, you can position it automatically by clicking the Center Horizontal
or Center Vertical commands on the Format menu.
4. Enter the desired text information for the new text object.
The text information options determine the actual text in the object, and they
also determine the properties of the text (i.e. size, font, alignment, etc.). To
enter text information:
• Double-click the new text object. A window will now appear as shown
below that contains all the text information options.
Text information window
• All the options on the Text information window are standard text options. Enter the desired setting for each option now, and then press
Enter or click the OK button. The Text information window will now
close, and the settings for the text options will be applied to the selected text object.
5. Once you have added the desired text objects to the open label design,
open the File menu and click the Save Label command. The label design
will now be permanently saved.
Using Label Manager
217
Creating Bar Code Objects on a Label Design
This section will show you how to create one bar code object on an existing
label design. The bar code object will be attached to a column in the design's
table that contains unique numbers (or letters), so the actual data in the bar
code object will be unique for each label printed with this design. If you
want, you can use the procedure explained in this section to create several
bar code objects on a label design.
To create a bar code object on an existing label design:
1. Select the label design that you want to create a bar code object for. To
select a label design:
• Open the File menu from the main menu bar, and click the Load Label
command. A submenu will now appear listing all the label designs in
the open Smeadlink database.
• Click the desired label design on the Load Label submenu. The selected design will now appear in the main Label Manager window. If
you have not added any text, bar code or field objects to the design yet,
then it will be blank.
2. Add a new bar code object to the open design. To add a new bar code
object:
• Click the Insert a New Bar Code... button on the button bar.
OR
• Click the Insert command on the Tools menu, and then click the Bar
Code command on the Insert submenu.
A new bar code object will now appear in the top, left corner of the
design. The bar code object will contain a red outline around it to indicate that it is selected.
218
Chapter 11
3. Drag the new bar code object to the desired location on the label design.
If you want the bar code object to be centered horizontally or vertically on
the design, you can position it automatically by clicking the Center Horizontal or Center Vertical commands on the Format menu.
4. Enter the desired bar code information for the new bar code object.
The bar code information options determine the column that the bar code
object is attached to, and they also determine the properties of the bar code
(i.e. type, alignment, format, etc.). To enter bar code information:
• Double-click the bar code object. The bar code information window
will now appear. The example below shows what the bar code information window looks like.
Bar code information window
• In the Field Name box, select the column in the design's Smeadlink
table that you want this bar code object to be attached to.
• If you want to format the data in the bar code, enter the desired format
in the Format box. For information about Smeadlink formatting commands, see chapter 9 in this manual. Format commands are listed and
explained in step 6 of the section Modifying Existing Items in a Database.
Using Label Manager
219
• The Start Character Position and Maximum Characters options allow
you to specify which digits from the column in the Field Name box
will appear in the bar code object. For instance, if you wanted to skip
all the first digits in this column, you could set Start Character Position
to 2. If you wanted to use just the first four digits in the column, you
could set Start Character Position to 1 and Maximum Characters to 4.
• If you want to change the color of the bars in the bar code object, click
the Text box in the Colors section (the Background box does not apply
to bar code objects). A standard Windows Color window will now
appear as shown below. Click the desired color in the window, and
then press Enter or click the OK button to save your changes and close
the window.
Color window
• If you want to change the alignment of the characters in the bar code
object, select the desired Alignment option.
• In the Type box, select the desired type for the bar code.
• If you want the bar code to contain UPC notches, select the desired
option in the UPC Notches box. Otherwise, make sure the None option is selected.
220
Chapter 11
• If you want to change the direction of the characters in the bar code
(i.e. left to right, right to left, centered, etc.), select the desired option
in the Direction box.
• If you want to adjust the size of the entire bar code, enter the desired
values in the Width and Height boxes. Both values need to be entered
in twips (1 twip = 1/1440 inch).
• If you want all the bars in the bar code to be at least a certain width,
enter the desired minimum width in the Bar Width box. Unlike the
Width and Height values, the Bar Width value needs to be entered in
pixels (remember that the size of a pixel depends on the resolution of
the printer). If you set the Bar Width value to 0, then the bars in the bar
code will be sized automatically.
• Once you have finished setting the options on the bar code information
window, press Enter or click the OK button. The new settings will
now be applied to the selected bar code object.
5. Once you have added the desired bar code objects to the open label design, open the File menu and click the Save Label command. The label design will now be permanently saved.
Using Label Manager
221
Creating Field Objects on a Label Design
This section will show you how to create one field object on an existing
label design. The field object will be attached to a column in the design's
table, so the actual data in the field object will be unique for each label
printed with this design. If you want, you can use the procedure explained in
this section to create several field objects on a label design.
To create a field object on an existing label design:
1. Select the label design that you want to create a field object for. To select
a label design:
• Open the File menu from the main menu bar, and click the Load Label
command. A submenu will now appear listing all the label designs in
the open Smeadlink database.
• Click the desired label design on the Load Label submenu. The selected design will now appear in the main Label Manager window. If
you have not added any text, bar code or field objects to the design yet,
then it will be blank.
2. Add a new field object to the open design. To add a new field object:
• Click the Insert a New Field... button on the button bar.
OR
• Click the Insert command on the Tools menu, and then click the
Field command on the Insert submenu.
A new field object will now appear in the top, left corner of the design.
The field object will contain a red outline around it to indicate that it is
selected.
222
Chapter 11
3. Drag the new field object to the desired location on the label design.
If you want the field object to be centered horizontally or vertically on the
design, you can position it automatically by clicking the Center Horizontal
or Center Vertical commands on the Format menu.
4. Enter the desired field information for the new field object.
The field information options determine the column that the field object is
attached to, and they also determine the properties of the field (i.e. font,
alignment, format, etc.). To enter field information:
• Double-click the field object. The field information window will now
appear. The example below shows what the field information window
looks like.
Field information window
• In the Field Name box, select the column in the design's Smeadlink
table that you want this field object to be attached to.
• If you want to format the data in the field object, enter the desired
format in the Format box. For information about Smeadlink formatting commands, see chapter 9 in this manual. Format commands are
listed and explained in step 6 of the section Modifying Existing Items
in a Database.
Using Label Manager
223
• The Start Character Position and Maximum Characters options allow
you to specify which characters from the column in the Field Name
box will appear in the field object. For instance, if you wanted to skip
all the first digits in this column, you could set Start Character Position
to 2. If you wanted to use just the first four digits in the column, you
could set Start Character Position to 1 and Maximum Characters to 4.
• If you want to change the color of the characters or background in the
field object, click the appropriate box in the Colors section. A standard
Windows Color window will now appear as shown below. Click the
desired color in the window, and then press Enter or click the OK
button to save your changes and close the window.
Color window
• If you want to change the alignment of the characters in the bar code
object, select the desired Alignment option.
• If you want to modify any of the font information for the field object,
set the appropriate Font options to the desired settings.
• Once you have finished setting the options on the bar code information
window, press Enter or click the OK button. The new settings will
now be applied to the selected bar code object.
5. Now save the changes you have made to the open label design. To save
your changes:
• Open the File menu and click the Save Label command. The label
design will now be permanently saved.
224
Chapter 11
Deleting a Label Design
This section will show you how to delete an existing label design. You can
use the information in this section to delete any label design in the open
Smeadlink database.
To delete an existing label design:
1. Select the label design that you want to delete. To select a label design:
• Open the File menu from the main menu bar, and click the Load Label
command. A submenu will now appear listing all the label designs in
the open Smeadlink database.
• Click the desired label design on the Load Label submenu. The selected design will now appear in the main Label Manager window. If
you have not added any text, bar code or field objects to the design yet,
then it will be blank.
2. Open the File menu from the main menu bar, and click the Delete Label
command.
A Smeadlink window will now appear asking if you want to delete the selected label.
3. Press Enter or click the OK button on the Smeadlink window.
The selected label design will now be permanently removed from the open
Smeadlink database.
Introduction to ColorBar Label Integrator
12. Introduction to ColorBar Label
Integrator
Chapter contents
Introduction
Basic Terms for ColorBar Label Integrator
Basic Concepts for ColorBar Label Integrator
Requirements for ColorBar Label Integrator
225
226
Chapter 12
Introduction
The previous chapter showed you how to use the Database Map program to
modify a Smeadlink database. You learned how to work with the Database
Map's tree diagram, and you learned how to use the tree diagram and the
popup menus to create new items in a database or modify existing items.
This chapter will introduce you to the ColorBar Label Integrator program. As
you learned in chapter 1, ColorBar Label Integrator is a program that allows
you to configure ColorBar labels for printing from Smeadlink. It allows you
to map the columns in a Smeadlink folder or subfolder to the fields in a
ColorBar label design's database, so that users can then print ColorBar labels
from that folder or subfolder. The first section of this chapter will explain
some terms that are often used in discussing ColorBar Label Integrator, the
next section will explain basic concepts and the last section will explain system requirements.
Introduction to ColorBar Label Integrator
227
Basic Terms for ColorBar Label Integrator
ColorBar label
Colorbar labels are color-coded strip labels that are typically used to identify file folders. Each ColorBar label includes a unique bar code and a specific color pattern. The bar code identifies the label and allows it to be scanned
into Smeadlink, and the color pattern identifies what type of folder the label
was printed for. For instance, labels for customer folders might all have one
color pattern, and labels for employee folders might all have another color
pattern.
Label design
A label design is a template for printing ColorBar labels. Each design specifies how the data will appear on any labels printed with the design, and it
also specifies what color pattern the labels will have. Label designs are created in the ColorBar Gold program, and they are typically created by
Smeadlink resellers. The example below shows what a label design looks
like in the ColorBar Gold program.
A label design in the ColorBar Gold program
On its own, a label design is not connected in any way to a Smeadlink folder
or subfolder. ColorBar Label Integrator is the tool you will use to connect
each label design to a folder or subfolder in Smeadlink. This process is called
configuring a label.
228
Chapter 12
Configured label design
A configured label design is a label design that has been connected by the
ColorBar Label Integrator program to a folder or subfolder in Smeadlink.
Specifically, the columns in the Smeadlink folder or subfolder have been
mapped to the fields in the label design's ColorBar database.
Once a label design has been configured, users can print ColorBar labels
from the Smeadlink folder or subfolder that has been mapped to the design.
Data from the columns in the folder or subfolder will be copied to the corresponding fields in the label design's ColorBar database, and that data will
then be used to print the labels from the ColorBar Gold program.
Introduction to ColorBar Label Integrator
229
Basic Concepts for ColorBar Label Integrator
ColorBar Label Integrator is a program that allows you to configure ColorBar
labels for printing from Smeadlink. It includes four main windows set up
like a wizard. Each window prompts you to select or enter some information. Once you have selected or entered the required information, you will
be able to open the next window.
When you first open the ColorBar Label Integrator program, you will see
the window shown below. This window allows you to create a new job or
select an existing job for modification (a job is a configured label design). If
you choose to create a new job, you will be able to select a label design for
the job from the first window.
First Label Integrator window
In addition to creating a new job or selecting an existing one, the first Label
Integrator window allows you to remove existing jobs. When a job is removed, the Smeadlink folder or subfolder and the label design in the job are
both unaffected—only the mapping between the two items is deleted. Removing a job only involves the first Label Integrator window, but if you are
creating a new job or modifying an existing one you will need to use the
other windows as well. The example on the following page shows what the
second window looks like.
230
Chapter 12
Second Label Integrator window
The second Label Integrator window allows you to select a Smeadlink table
for the current job. If you are modifying an existing job, then you will not
want to change the table. This is because changing the table would require
you to redefine the rest of the job. On the other hand, if you are creating a
new job, you will want to specify the table of the Smeadlink folder or subfolder that you want mapped to the selected label design.
Once you have selected a Smeadlink table, if necessary, then you will be
ready to set the options on the third Label Integrator window. This window
is the window you will use to map fields in the selected Smeadlink table to
the ColorBar fields used by the selected label design. The example below
shows what the third Label Integrator window looks like.
Third Label Integrator window
Introduction to ColorBar Label Integrator
231
The main feature in the third Label Integrator window is a records grid. The
first column in the records grid is called CBGOLD Field. This column lists
all the fields in the ColorBar database that are used by the selected label
design. The CBGOLD Field column will be automatically filled in when
you first open the third Label Integrator window, but the other columns in
the records grid will be empty.
The second column in the records grid is called Smeadlink Field. This column allows you to specify which field in the selected Smeadlink table corresponds with each ColorBar field used by the label design. Clicking a cell in
the Smeadlink Field column will open a dropdown that lists all the fields in
the selected Smeadlink table. You can then select which Smeadlink field you
want to map to the ColorBar field in the cell to the left of the selected cell.
In some situations, you may want to assign some static text to a ColorBar
field, or concatenate multiple Smeadlink fields into one ColorBar field. You
can accomplish either one of these tasks with the third field in the records
grid—the Manual field. If you want to assign some static text to a ColorBar
field, you can do so by typing the text in the appropriate cell of the Manual
column. If you want to concatenate multiple Smeadlink fields into one
ColorBar field, simply enter the desired fields in the appropriate cell of the
Manual column. One situation where you might want to concatenate multiple Smeadlink fields into one ColorBar field is if you had a First Name and
a Last Name field in a Smeadlink table, and you wanted to put data from
both these fields into one ColorBar Name field.
The last column in the records grid is called Format. This column allows
you to format the data in each Smeadlink field before it is copied to the
ColorBar field. For instance, you could use this field to insert dashes in a
Smeadlink field that contains social security numbers, or you could use it to
put parentheses around the area codes of a field containing phone numbers.
The Format field accepts standard formatting notation.
After you have mapped the fields in the selected Smeadlink table to the
ColorBar fields of the selected label design, you will be ready to set the
options on the fourth Label Integrator window. This window allows you to
modify the two SQL statements used in the label printing process. The example on the following page shows what the fourth Label Integrator window looks like.
232
Chapter 12
Fourth Label Integrator window
The fourth Label Integrator window lists the two SQL statements used in
the label printing process, and it allows you to modify each statement. The
top section of the window lists the SQL statement that identifies what rows
in the selected Smeadlink table to print labels for. You can modify this SQL
statement as you wish. The second section of the window lists the SQL
statement that is run after the labels are printed. This statement is called the
SQL Update statement, and it is often used to set print flags. Again, you can
modify it as you wish. Once you finish modifying the SQL statements used
for label printing, then you can save the open job by clicking the Finish
button.
Introduction to ColorBar Label Integrator
233
Requirements for ColorBar Label Integrator
In order to configure label designs with ColorBar Label Integrator or print
ColorBar labels from Smeadlink, you will need to have the ColorBar Gold
program installed. If your Smeadlink system includes the ColorBar Gold
module, then your Smeadlink installation CD will have the ColorBar Gold
program on it.
In addition to having ColorBar Gold installed, you will also need to have the
appropriate label designs created in ColorBar Gold. Label designs are typically created by Smeadlink resellers.
Using ColorBar Label Integrator
13. Using ColorBar Label Integrator
Chapter contents
Introduction
Creating a New Job
Modifying an Existing Job
Removing an Existing Job
235
236
Chapter 13
Introduction
The previous chapter introduced you to the ColorBar Label Integrator program. You learned about some terms that are frequently used while discussing ColorBar Label Integrator, and you also learned about its basic concepts. You should now have a basic idea about what the ColorBar Label
Integrator program looks like, and how it is typically used.
This chapter will show you how to use the ColorBar Label Integrator program to configure ColorBar label designs. As you learned in the previous
chapter, a configured label design is called a job in ColorBar Label Integrator. The first section of this chapter will show you how to create a new job,
the second section will show you how to modify an existing job and the
third section will show you how to delete an existing job.
Using ColorBar Label Integrator
237
Creating a New Job
This section will show you how to create a new job in ColorBar Label Integrator. The job will connect an existing ColorBar label design to a folder or
subfolder in the Librarian. Once you have created the job, any Smeadlink
user can open the job's Librarian folder and print ColorBar labels from it.
The data from the columns in the folder will be formatted according to the
job's specifications, and copied to the corresponding columns in the label
design's ColorBar database. The labels will then be printed from the ColorBar
Gold program using the data in the ColorBar database.
Note: As explained in the previous chapter, you will need to have the ColorBar
Gold program installed in order to print labels from the Librarian. You will
also need to have at least one label design created in ColorBar Gold before
you can begin creating a job in ColorBar Label Integrator.
To create a new job:
1. Open the ColorBar Label Integrator program from the Librarian.
For information about opening ColorBar Label Integrator, see chapter 2 of
this manual. The example below shows what the ColorBar Label Integrator
program looks like immediately after it has been opened.
ColorBar Label Integrator program after opening
2. Click the New button on the ColorBar Label Integrator window.
The Open a ColorBar Gold Label Design window will now appear. This
window lists all your available label designs. The example on the following
page shows what the Open a ColorBar Gold Label Design window looks
like.
238
Chapter 13
Open a ColorBar Gold Label Design window
3. Select the desired label design for the new job. To select a label design:
• Click the desired label design. The label design will turn blue after you
click it to indicate that it is selected.
• Click the Open button on the Open a ColorBar Gold Label Design
window.
The Open a ColorBar Gold Label Design window will now close, and the
design you selected will appear in the box on the first ColorBar Label Integrator window.
4. Click the Next button at the bottom of the first ColorBar Label Integrator
window.
The second ColorBar Label Integrator window will now appear. The example below shows what the second window looks like.
Second ColorBar Label Integrator window
Using ColorBar Label Integrator
239
5. Select the desired Smeadlink table for the new job. To select a Smeadlink
table:
• Click the down arrow at the right of the box in the middle of the second
ColorBar Label Integrator window.
A dropdown will now appear that lists all the Smeadlink tables in the
open Smeadlink database. The dropdown will have two columns. The
first column lists the user name of each Smeadlink table in the database, and the second column lists the actual table name. The example
below shows what the tables dropdown looks like.
Tables dropdown
• Click the desired table on the tables dropdown. The table you selected
will now appear in the tables box.
6. Click the Next button at the bottom of the second ColorBar Label Integrator window.
The third window will now appear. The example on the following page
shows what the third ColorBar Label Integrator window looks like.
240
Chapter 13
Third ColorBar Label Integrator window
7. Select which column in the selected Smeadlink table corresponds with
each ColorBar field in the selected label design. To map the columns in the
selected Smeadlink table to the fields used by the selected label design:
• Click a cell in the Smeadlink Field box. A dropdown will now appear
listing all the columns in the selected Smeadlink table.
• Click the Smeadlink column in the dropdown that you would like to
map to the corresponding field in the CBGOLD Field column. The
column you selected will now appear in the cell.
• Repeat the above two steps for each field in the CBGOLD Field column that you would like to map one Smeadlink field to.
• If you would like to map static text to a field in the CBGOLD Field
column, or if you would like to concatenate multiple Smeadlink fields
to one field in the CBGOLD Field column, then skip the corresponding cell for that field in the Smeadlink Field column.
Note: If the fields in the selected Smeadlink table have the same names as
the fields in the selected ColorBar label design, you can click the Autofill
button to have the fields automatically matched up for you. Once you click
Autofill, Label Mapper will automatically enter the column name in the
Smeadlink Field column that matches the corresponding field name in the
CBGOLD Field column.
Using ColorBar Label Integrator
241
8. If you would like to map some static text to a field in the CBGOLD Field
column, then type the desired text in the corresponding cell of the Manual
column.
9. If you would like to map multiple Smeadlink fields to one field in the
CBGOLD Field column, then enter the desired fields in the corresponding
cell of the Manual column.
You will need to use standard table notation (i.e. TableName.FirstFieldName
+ TableName.SecondFieldName), and you will need to specify a space between the two tables if you want one to appear in the labels.
10. If you would like to format the data from the Smeadlink columns before
it is copied to the ColorBar fields, then enter the desired format in the appropriate cell of the Format column.
The Format column accepts standard format notation, and it is typically used
to reformat things like social security numbers, dates or phone numbers.
11. Click the Next button at the bottom of the third ColorBar Label Integrator window.
The fourth window will now appear. The example below shows what the
fourth ColorBar Label Integrator window looks like.
Fourth ColorBar Label Integrator window
242
Chapter 13
12. If you would like to modify the SQL statement, enter the desired changes
(the SQL statement is the top statement on the fourth Label Mapper window).
The SQL statement determines what rows in the selected Smeadlink table
will have labels printed for them. The example on the previous page shows
a typical Smeadlink SQL statement.
13. If you would like to modify the SQL Update statement, enter the desired
changes (the SQL statement is the lower statement on the fourth Label Mapper window).
The SQL Update statement is run after the labels have been printed, and it is
typically used to set print flags. The example on the previous shows a typical Smeadlink SQL Update statement.
14. Click the Finish button to save the new job.
Your Smeadlink operators will now be able to print labels from the folders
or subfolders in the Librarian that are based on the table specified in this job.
Using ColorBar Label Integrator
243
Modifying an Existing Job
This section will show you how to modify an existing job in the ColorBar
Label Integrator program. Modifying a job means keeping the Smeadlink
table and ColorBar label design specified in the job, but changing more
minor things like corresponding fields or formatting. You can use the information in this section to modify any existing job.
To modify an existing job:
1. Open the ColorBar Label Integrator program from the Librarian.
For information about opening ColorBar Label Integrator, see chapter 2 of
this manual. The example below shows what the ColorBar Label Integrator
program looks like immediately after it has been opened.
ColorBar Label Integrator program after opening
2. Click the down arrow at the right of the box in the middle of the ColorBar
Label Integrator window. A dropdown will now appear listing all the existing jobs.
3. Click the job on the dropdown that you would like to modify. The job
name will now appear in the box.
4. Click the Next button at the bottom of the first ColorBar Label Integrator
window.
The second window will now appear. The example on the following page
shows what the second ColorBar Label Integrator window looks like.
244
Chapter 13
Second ColorBar Label Integrator window
5. Click the Next button at the bottom of the second Label Integrator window. The third window will now appear as shown below.
Third ColorBar Label Integrator window
6. You can now modify any of the settings on the third window. For more
information about these settings, see steps 7–10 of the previous section in
this chapter.
7. Click the Next button at the bottom of the third Label Integrator window.
The fourth window will now appear as shown on the following page.
Using ColorBar Label Integrator
245
Fourth ColorBar Label Integrator window
8. You can now modify either of the SQL statements on the fourth window.
For information about these statements, see steps 12 and 13 in the previous
section of this chapter.
9. Click the Finish button in the lower right corner of the fourth window to
save the changes you have made to the selected job.
246
Chapter 13
Removing an Existing Job
This section will show you how to remove an existing job from ColorBar
Label Integrator. Removing a job does not affect the Smeadlink table or the
ColorBar label design specified in the job—it only affects the relationship
between the two items. You can use the information in this section to remove any existing job in ColorBar Label Integrator.
To remove an existing job:
1. Open the ColorBar Label Integrator program from the Librarian.
For information about opening ColorBar Label Integrator, see chapter 2 of
this manual. The example below shows what the ColorBar Label Integrator
program looks like immediately after it has been opened.
ColorBar Label Integrator program after opening
2. Click the down arrow at the right of the box in the middle of the first
ColorBar Label Integrator window. A dropdown will now appear listing all
your existing jobs.
3. Click the job on the dropdown that you would like to remove. The job
name will now appear in the box.
4. Click the Remove button underneath the box. The selected job will now
be permanently removed from ColorBar Label Integrator.
Using Data Director
14. Using Data Director
Chapter contents
Introduction
Data Director Concepts
Creating a Format
Running a Format
247
248
Chapter 14
Introduction
The previous chapter showed you how to use ColorBar Label Integrator.
This chapter will show you how to use Data Director. As you learned in
chapter 1, Data Director is a utility that allows you to automatically capture
label data sent from an external program, import the data into a Smeadlink
table, and print it out on one of the existing label designs for that table. Data
Director was created to give customers who already have high-end software
for printing black-and-white labels the capability to print color labels.
The first section in this chapter will explain the basic concepts for using
Data Director. If you are already familiar with the Data Director utility, then
you may just want to skim this section. The second section will then explain
how to create a format. A format is similar to a rule in the Scanner program
or an import in the Import Wizard utility—it is a group of settings that Data
Director uses to determine what information should be extracted from captured label data and how that information should be printed. Finally, the last
section in this chapter will show you how to use an existing format to capture label data and print labels.
Using Data Director
249
Data Director Concepts
Data Director is a program that allows you to automatically capture label
data sent from an external program, route it into a Smeadlink table, and print
it out on one of the existing label designs for that table. Currently, Data
Director captures label data by monitoring a COM port. In the future, Data
Director will also be able to capture label data by monitoring a specified file.
Data Director was created to give customers who already have high-end
software for printing black-and-white labels the capability to print color labels. For many of these customers, the cost and effort required to replace
their existing black-and-white label software with color label software would
be prohibitive. Data Director gives them the best of both worlds—it allows
them to print color labels when they want, and it leaves their existing software (and hardware) in place and untouched.
The first step in using Data Director is to create a format. A format is similar
to a Scanner rule— it is a group of settings that determines what information
to extract from captured label data, how to place that information into a
Smeadlink table and what label design to print that information with. You
will need to create a separate format for each type of label that you capture
and print with Data Director. The window for creating formats in Data Director is called the Data Director Setup window. The example below shows
what this window looks like.
Data Director Setup window
250
Chapter 14
Once you have created a format, then you can open it and the Data Director
Monitoring window will appear. This window displays which format is open,
and which stock type (i.e. Avery, Intermec, etc.) will be used to print any
label data that is captured. Once Data Director starts to receive data and
print labels, the Data Director Monitoring window will display the number
of records that have been saved and the number of labels that have been
printed since the format was opened. The example below shows what the
Data Director Monitoring window looks like.
Data Director Monitoring window
You can choose to have Data Director print labels one at a time as it receives
information, or wait to print out a group of labels at once (this is helpful for
stock types that print multiple labels to a sheet). You can also hide, or minimize, the Data Director program while it is monitoring a COM port. This is
helpful if you want to work on something else in Smeadlink while Data
Director is open.
Using Data Director
251
Creating a Format
The first step in using Data Director is to create a format. A format is a group
of settings that determines what information to extract from captured label
data, how to place that information into a Smeadlink table and what label
design to print that information with. You will need to create a separate
format for each type of label that you capture and print with Data Director.
Before you begin creating a format, make sure that your system is set up as
follows:
• The computer that you will be capturing data from needs to be connected to the COM port of the computer with Smeadlink on it. In most
cases, a standard DB-9 Null Modem cable can be used for this purpose, however, some systems may need a different type of cable. Consult the documentation that came with your hardware for information
about the type of cable you will need.
• The Port monitoring for Label input option in Smeadlink needs to be
set to the active COM port. This option is located in the General folder
of the Options window.
To create a format:
1. Open the Data Director Setup window. To open the Data Director Setup
window:
• Open the Tools menu the Smeadlink and click the Data Director command. The Data Director submenu will now appear.
• Click the Setup command on the Data Director submenu. The Data
Director Setup window will now appear as shown on the following
page.
252
Chapter 14
Data Director Setup window
The Data Director Setup window lists all the formats in the open database. If
no formats have been created, then the Data Director Setup window will be
blank as shown in the example above.
2. Click the Add button in the lower left corner of the Data Director Setup
window.
The Format setup window will now appear. This window contains all the
options for creating a format. The example below shows what the Format
setup window looks like.
Format setup window
Using Data Director
253
3. Type the desired name for the new format in the Label Name box (located
in the top left corner of the Format setup window).
4. Select the table for the new format in the Table box.
When you begin using the new format, the label data it receives will be
imported into the table selected in the Table box, and then printed using one
of the table's label designs. Label designs in Smeadlink are specific to individual tables, so the table you select in the Table box will determine what
label designs you can use to print captured label data.
5. Select the desired design for the new format in the Labels for this table
box.
The design you select will be used as a template for printing label data captured with the new format—it will determine how the label data is arranged
on each label, and it will determine what colors are on the label (if it is a
ColorBar design). If you do not want to print the captured label data at all,
then you can select the Import Only option and the data will only be imported into the specified Smeadlink table, it will not be printed.
The Labels for this table dropdown displays all the label designs and configured label designs that have been created for the table selected in the Table
box. Remember that label designs are templates for printing black-and-white
labels, and configured label designs are templates for printing ColorBar labels. There is no way to distinguish label designs from configured label
designs in the Labels for this table dropdown, so you will need to know
beforehand which is which. If you are unsure which design to pick, you can
open the Label Manager utility to view the different label designs in the
open database, and you can open the ColorBar Label Integrator utility to
view the different configured label designs in the open database.
6. Now print one or more labels with the program you will be capturing
label data from (printing two or more labels may make the setup process
easier later on).
If your system is set up as explained at the beginning of this section, then
Data Director will capture the label data and it will appear in the Printer
Output box on the Format setup window. The example on the following
page shows what captured label data looks like.
Note: The data that appears in the Printer Output box depends on the program the labels were printed from and the labels that were printed, so the
data you see will not look exactly like the data shown in the example.
254
Chapter 14
Captured label data
7. You will now need to specify what information you want extracted from
the captured label data, and which fields in the Smeadlink table you want the
extracted information mapped to. For each field in the captured label data
(i.e. for each field in the original labels that were printed), follow the steps
below:
• Find one of the field's entries in the captured label data.
• Use the entry to locate the start string for this field. The start string is a
unique group of characters that identifies the entries in each field. Every entry in the field will have the same start string located immediately before it in the captured label data. You may need to use two
entries from the field to determine what characters make up the start
string.
• Highlight one of the start strings for this field. The Add Start String
and Add End String buttons beneath the Printer Output box will now
become available.
• Click the Add Start String button. The characters you selected in the
Printer Output box will now be entered into the Field Definition table,
in the Text Start String cell of the blank row.
Note: Data Director will not allow you to type text directly into the Text
Start String, Text End String, Label Start String or Label End String cells.
This is because start and end strings may include characters that you cannot enter from the keyboard.
Using Data Director
255
• Use the same procedure (replacing the Add Start String button with the
Add End String button) to specify the end string for this field. Once
you have defined the field by specifying a start string and an end
string, then the first entry in the field should appear in the Sample Data
cell of the row.
• Select which field in the specified Smeadlink table the data in the field
you just defined will be imported into. To select a field, click in the
Field Name cell of the row. A down arrow will now appear that you
can use to open a dropdown listing all the fields in the specified
Smeadlink table. Click the desired field in the dropdown.
• If you want the field you just defined to be the Find by field for the
label data captured with this format, then check the Find by cell in the
active row. When Data Director imports captured label data into the
specified Smeadlink table, it will compare each entry in the captured
data's Find by field to the entries in the Smeadlink table's Id column. If
a match is found, then the existing row in the table will be replaced
with the matching row in the captured data. If no match is found, then
a new row will be created in the Smeadlink table for the row in the
captured data.
8. Specify the start and end strings for the captured label data. The start
string is a unique group of characters that at the beginning of the captured
label data, and the end string is a unique group of characters at the end of the
captured label data. To specify the start and end strings:
• Locate the characters that make up the start string in the captured label
data.
• Highlight the entire start string. The Set button at the right of the Label
Start String box will become available once you highlight the characters in the start string.
• Click the Set button. The selected characters in the captured label data
will now be entered in the Label Start String box.
• Use the same procedure (replacing the Label Start String box with the
Label End String box) to specify the end string for the captured label
data.
256
Chapter 14
9. Enter the lowercase character string for captured label data in the
Lowercasing Characters box. To enter the lowercase character string:
• Type the string into the Lowercasing Characters box.
• Click the Add button at the right of the Lowercasing Characters box to
save the string.
The lowercase character string is a unique group of characters that identifies
which characters in captured label data should be imported as lowercase
characters. The lowercase character string will appear in captured label data
immediately before each lowercase character.
Note: If the original label data does not contain lowercase characters, or if
you do not care whether characters are imported as lowercase or uppercase, then you can leave this option blank.
10. If you want Data Director to automatically remove certain characters in
captured label data, then enter the desired characters into the Characters to
remove box. To enter the characters:
• Type the desired characters into the Characters to remove box.
• Click the Add button at the right of the Lowercasing Characters box to
save the characters.
11. Set the desired time out for the captured label data.
The time out only applies if a label design has been selected in the Labels
for this table box. The time out determines how long Data Director will wait
each time it receives captured label data before it begins printing the data
from Smeadlink.
You can set the time out to a number of minutes by entering the desired
number into the Time Out (in minutes) box, or you can set it to infinite by
checking the Infinite Time Out box. If you set the time out to infinite, then
Data Director will wait until it has received enough information to print out
an entire sheet of labels at once before it starts printing (this option only
applies to label designs that use a stock type with multiple labels per sheet),
or it will wait until you manually click the Print button on the Data Director
Monitoring window.
12. Click the OK button on the Format setup window.
The new format will now be saved. The Format setup window will close,
and the Data Director Setup window will reappear. The new format will be
selected in the Data Director Setup window's format list.
Using Data Director
257
Running a Format
Once you have created a format, then you can run it and Data Director will
process and print captured label data according to the format's settings. When
you are running a format, you can hide, or minimize, the Data Director program so that you can do other work in Smeadlink while Data Director is
capturing label data. This section will show you how to run a format. You
can use the information in this section to run any format in the open Smeadlink
database.
To run a format:
1. Open the Data Director Monitoring window. To open the Data Director
Monitoring window:
• Open the Tools menu the Smeadlink and click the Data Director command. The Data Director submenu will now appear.
• Click the Load command on the Data Director submenu. The Load
submenu will now appear as shown below. This submenu lists all the
formats in the open database. The submenu in the example contains
one format called test_format.
Load submenu
• Open the desired format on the Load submenu. The Data Director
Monitoring window will now appear as shown on the following page.
258
Chapter 14
Data Director Monitoring window
As long as the Data Director Monitoring window is open, label data coming
through the active Com port will be captured and processed according to the
open format's settings. The top box in the Data Director Monitoring window
displays the name of the open format, and the second box displays the name
of the open format's stock type.
The last three boxes display how much information Data Director has received and processed since the format was opened. This includes the total
number of rows imported into the format's table, the total number of labels
printed and the total number of labels currently queued up for printing. Remember that if a label design is not specified in the open format, then captured label data will only be imported into the specified Smeadlink table, it
will not be printed.
2. If you want to minimize the Data Director Monitoring window, click the
Hide button in the lower left corner of the window.
The Data Director Monitoring window will now be minimized, but it will
continue to function just like it does when it is the active window. Hiding
the Data Director Monitoring window is helpful if you want to work on
something else in Smeadlink while Data Director is capturing and processing label data.
3. If the open format has an infinite time out, then you can click the Print
button on the Data Director Monitoring window to print all the labels in the
queue.
4. Once you are finished running the format, click the Stop button.
A popup window will now appear asking if you are sure you want to exit the
current format.
5. Click the Yes button on the popup window.
Using Smeadlink's Administrative Utilities I
259
15. Using Smeadlink's Administrative
Utilities I
Chapter contents
Introduction
Opening the Views Utility
Saving a View
Adjusting View Order
Deleting a View
Modifying the Properties of a View
Opening the Columns Utility
Creating a Column in a View
Deleting a Column from a View
Modifying the Properties of a Column in a View
260
Chapter 15
Introduction
The previous chapter showed you how to use the ColorBar Label Integrator
program to configure ColorBar label designs. You learned how to create
new jobs in the ColorBar Label Integrator program, and how to modify existing jobs. You also learned how to remove jobs that are no longer being
used.
The next two chapters will show you how to use the administrative utilities
in the Smeadlink. As you learned in chapter 1, there are four administrative
utilities in Smeadlink—the Views utility, the Columns utility, the Add-Ins
utility and the Report Generator utility. This chapter will show you how to
use the Views and Columns utilities, and the next chapter will show you how
to use the Add-Ins and Report Generator utilities.
This chapter is divided into two main parts, each part consisting of several
sections. The first part will show how to open the Views utility and use it to
work with Views, and the second part will show you how to open the Columns utility and use it to work with columns.
Note: For an introduction to all Smeadlink's administrative utilities, see
the section Smeadlink Administrative Utilities in chapter 1 of this manual.
Using Smeadlink's Administrative Utilities I
261
Opening the Views Utility
The following instructions will show you how to open the Views utility. Once
the Views utility is open, you will be able to use it to create, delete and modify
Views in Smeadlink. You will also be able to adjust the view order for the
open folder or subfolder, which determines what order the Views are displayed with on the View...Views submenu. After you learn how to open the
Views utility in this section, the next four sections in this chapter will show
you how to use the Views utility to work with Views in Smeadlink.
To open the Views utility:
1. Open the Tools menu from Smeadlink's main menu bar.
2. Click the View Settings command on the Tools menu.
The View Settings submenu will now appear. The Views utility consists of the
six lower commands on the View Settings submenu. The example below shows
what the Views utility looks like.
262
Chapter 15
Saving a View
The Views utility includes two commands for saving Views—Save View and
Save View As. The Save View command allows you to save an existing view
after you make changes to it, while the Save View As command allows you to
save the active view as it appear on your screen as a new view. This section
will show you how to use both save commands.
To save an existing view after making changes to it:
• Simply click the Save View command on the Views utility. The active
view will now be saved as it appears on the screen.
To save a new view:
1. Set up the active view as you want the new view to be saved.
2. Click the Save View As command on the Views utility.
The Save View As window will now appear. The example below shows what
the Save View As window looks like.
Save View As window
3. Type the desired name for the new view in the Save As box.
4. If you want the new view to share columns with the active view, check the
Share Columns With Current View box. When two Views share columns, any
changes made to the columns in one view will be made to the columns in the
other view.
5. Press Enter or click the OK button on the Save As window. The new view
will now be saved, and the Save As window will close.
Using Smeadlink's Administrative Utilities I
263
Adjusting the View Order
The view order determines how the Views for the open folder or subfolder are
displayed on the View...Views submenu. It also determines the default view
for the open folder or subfolder. The default view is subject to security settings, so if a user does not have access to the view that has been specified as
the default view, then they will see the next view in the list as their default
view. This section will show you how to adjust the view order for the open
Smeadlink folder or subfolder.
To adjust the view order for the open folder or subfolder:
1. Click the View Order command on the Views utility.
The View Order Editor window will now appear. All the Views for the open
folder or subfolder will be listed in the middle of this window. The Views will
be listed in the order they appear on the View...Views submenu (i.e. the first
view in the Editor window is the first view on the Views submenu, the second
view in the Editor window is the second view on the Views submenu, etc.).
In addition, the first view in the View Editor's list will be the default view for
the open folder or subfolder. As you learned above, if a user does now have
access to the view that has been specified as the default view, then they will
see the next view in the list as their default view. The example below shows
what the View Order Editor window looks like. The window in the example
lists three Views, starting with one called All Clients Sorted by Name.
View Order Editor window
264
Chapter 15
2. You can now adjust the position of each view in the list. To adjust a view's
position:
• Click the desired view. The view will turn blue after you click it to
indicate that it is selected.
• Click the up or down arrows at the right of the view list until the selected
view is in the desired position.
3. Once you have arranged the Views as you want them, press Enter or click
the OK button at the bottom of the View Order Editor window. The window
will now close.
Using Smeadlink's Administrative Utilities I
265
Deleting a View
Sometimes you may create a view that you will only need for a short period of
time, or the information in an existing view may not be needed any more. The
Views utility allows you to quickly and easily delete any existing view in
Smeadlink. Deleting unnecessary Views will keep your database as efficient
as possible. This section will show you how to delete a view from the open
folder or subfolder. You can use the information in this section to delete any
number of Views from the open folder or subfolder.
To delete a view from the open folder or subfolder:
1. Click the Delete View command on the Views utility. The Select View to
Delete window will now appear as shown below.
Select View to Delete window
2. Select the view that you want to delete. To select a view:
• Click the down arrow at the right of the Select a View box. A dropdown
will now appear listing the different Views in the open folder or subfolder.
• Click the desired view in the dropdown. The dropdown will now close,
and the view you selected will appear in the Select a View box.
3. Press Enter or click the Delete button at the bottom of the Select View to
Delete window.
266
Chapter 15
Modifying the Properties of a View
The properties of a view determine things like the name of the view, whether
rows can be added to the view and the SQL statement used to display the
rows in the view. This section will show you how to modify the properties of
the active view. You can use the information in this section to modify the
properties of any view in the open database.
To modify the properties of the active view:
1. Click the View Properties command on the Views utility. The View Properties window will now appear as shown below.
View Properties window
2. If you would like to change the name of the active view, type the desired
name in the Current View box.
3. If you want users to be able to add rows to the active view, make sure the
Allow Adds option is enabled.
4. If you want Smeadlink to display the exact number of rows in the view
each time it is opened, make sure the Exact Count option is enabled.
5. If you would like to modify the SQL statement of the active view, type the
desired changes in the View SQL box.
6. Click the Apply button to view the changes you have made. If the changes
are not to your liking, correct the appropriate settings.
7. Click the OK button at the bottom of the View Properties window to save
the changes you made. The View Properties window will now close.
Using Smeadlink's Administrative Utilities I
267
Opening the Columns Utility
The following instructions will show you how to open the Columns utility.
Once the Columns utility is open, you will be able to use it to create, delete
and modify columns in Smeadlink. After you learn how to open the Columns utility in this section, the next three sections in this chapter will show
you how to use the Columns utility to work with columns in Smeadlink.
To open the Columns utility:
1. Open the Tools menu from the Librarian's main menu bar.
2. Click the View Settings command on the Tools menu. The View Settings
submenu will now appear.
3. Click the Columns command on the View Settings submenu.
The Columns submenu will now appear. The Columns utility consists of the
first two commands and the last command on the Columns submenu. The
example below shows what the Columns utility looks like.
268
Chapter 15
Creating a Column in a View
This section will show you how to create a new column in the active view.
The column will be based on one of the fields in the view's table, so you will
either need to use an existing field or create a new one (if you want to create
a new field, see the section Adding a New Field to a Table in chapter 9). You
can use the information in this section to add any number of columns to the
active view.
To create a column in the active view:
1. Click the New Column command on the Columns utility. The New Column window will now appear as shown below.
2. Select the desired type for the new column. To select a type:
• Click the down arrow at the right of the Column Type box. A dropdown
will now appear listing the different available types.
• Click the desired type on the dropdown.
There are 16 column types that you can choose from. The different column
types are listed and explained in the following table.
Column Type
Description
Any Image Flag
Displays one of three abbreviations if a
row has an image attached to it. The abbreviation lets you know that an image
is attached, and it displays the type of
the image. The three abbreviations are
Scan (from Scanner program), PC Files
(from PC Files program) and ERM (from
Import Wizard program). This type option will not be available if the open view
is based on a table that cannot have attachments.
Using Smeadlink's Administrative Utilities I
269
Child Lookdown/ [CR] Separated/
Display Dups
Displays information from one column of any child rows attached to
the parent row. If there are multiple
child rows with entries in the column, the entries are separated by
carriage returns (i.e. a separate line
for each entry). Duplicate entries
are allowed. This type option is not
available in Views that do not have
child rows.
Child Lookdown/ [CR] Separated/
Skip Dups
Displays information from one column of any child rows attached to
the parent row. If there are multiple
child rows with entries in the column, the entries are separated by
carriage returns (i.e. a separate line
for each entry). If an entry occurs
multiple times, it is only listed once.
This type option is not available in
Views that do not have child rows.
Child Lookdown/ Comma Separated/
Display Dups
Displays information from one column of any child rows attached to
the parent row. If there are multiple
child rows with entries in the column, the entries are separated by
commas. Duplicate entries are allowed. This type option is not
available in Views that do not have
child rows.
Child Lookdown/ Comma Separated/
Skip Dups
Displays information from one column of any child rows attached to
the parent row. If there are multiple
child rows with entries in the column, the entries are separated by
commas. If the same entry occurs
multiple times, it is only listed once.
This type option is not available in
Views that do not have child rows.
270
Chapter 15
Children Count
Displays the number of child rows
in one table that are attached to
each parent row. This type option
is not available in Views that do
not have child rows.
Children Flag
Displays a flag if a row has one or
more child rows attached to it. The
flag will be two asterisks if there is
one child attached, and two plus
signs if there are two or more children attached. This type option is
not available in Views that do not
have child rows.
Direct Field
Displays all entries in one field of
the table that the open view is
based on. If the view is based on
multiple tables (i.e. if there is a
JOIN in the view's SQL statement),
then displays all entries in one field
of any of these tables.
ERM Flag
Displays a flag if a row has one or
more ERM documents attached to
it. The flag will be two asterisk if
there is one document attached,
and two plus signs if there are two
or more documents attached. This
type option is not available in Views
that do not have child rows
Fax Flag
Displays a flag if a row has one or
more fax documents attached to it.
The flag will be two asterisks if
there is one document attached,
and two plus signs if there are two
or more documents attached. This
type option is not available in Views
that do not have child rows
Using Smeadlink's Administrative Utilities I
271
Image Flag
Displays a flag if a row has one or
more image documents attached to
it. The flag will be two asterisks if
there is one document attached,
and two plus signs if there are two
or more documents attached. This
type option is not available in Views
that do not have child rows.
PC Files Flag
Displays a flag if a row has one or
more PC Files documents attached
to it. The flag will be two asterisks
if there is one document attached,
and two plus signs if there are two
or more documents attached. This
type option is not available in Views
that do not have child rows.
Row Number
Displays the number of each row
in the open view (i.e. displays a 1
for the first row in the view, 2 for
the second row, etc.).
Tracking Location
Displays the tracking location of
each object in the open view. Can
only display one type of location
(i.e. folders, boxes, shelves, etc.).
This type option is not available
in Views that do not contain
trackable objects.
Tracking Status
Displays one of three types of tracking status information for the objects in the open view. The three
types of information are due date,
whether or not the object is out and
transaction date and time. This
type option is not available in Views
that do not contain trackable objects.
272
Chapter 15
Parent Lookup
Displays information from one field
of any parent table for the open
view.
3. Now select the field that the new column will be based on. To select a
field:
• Click the down arrow at the right of the Field box. A dropdown will
now appear listing the different available fields. The fields listed in the
dropdown will differ depending on which column type you selected.
• Click the desired field on the dropdown. The dropdown will now close,
and the field you selected will appear in the Field box.
4. Press Enter or click the OK button on the New Column window. The new
column will now be saved, and the New Column window will close.
Using Smeadlink's Administrative Utilities I
273
Deleting a Column from a View
This section will show you how to delete a column from the active view. You
can use the information in this section to delete any number of columns from
the active view.
To delete a column from the active view:
1. Place your mouse pointer over the header of the column you want to
delete, and click the right mouse button.
The Column popup menu will now appear. The example below shows what
the Column popes menu looks like.
Column popup menu
2. Click the Delete command on the Column popes menu.
The selected column will now be deleted from the open view. You can restore
the deleted column to the active view by clicking the Reload View command
on the View Settings submenu.
274
Chapter 15
Modifying the Properties of a Column in a View
The properties of a column determine things like the name of the column,
when the column is visible and whether the cells in the column can be sorted.
This section will show you how to modify the properties of a column in the
active view. You can use the information in this section to modify the properties of any column in the view.
To modify the properties of a column in the active view:
1. Place your mouse pointer over the header of the column you want to
modify, and click the right mouse button.
The Column popup menu will now appear. The example below shows what
the Column popes menu looks like.
2. Click the Column Properties command on the Column popup menu. The
Properties window will now appear as shown below.
Properties window
Using Smeadlink's Administrative Utilities I
275
3. If you would like to modify the heading of the selected column, type the
desired heading in the Heading box.
4. If you would like to apply a mask to the data in the selected column, type
the desired mask in the Display Mask box.
For information about formatting masks in Smeadlink, see the section Modifying Existing Items in a Database in chapter 9. The mask formatting commands are explained in step 7 of that section.
5. If you would like to apply an input mask to the selected column, type the
desired input mask in the Input Mask box.
If you create an input mask, it will be applied whenever a new entry is added
to the selected column (i.e. when a new row is added to the open folder or
subfolder, or an existing entry in the column is deleted and replaced by a
new one). Again, for information about formatting masks in Smeadlink, see
the section Modifying Existing Items in a Database in chapter 9. The mask
formatting commands are explained in step 7 of that section.
6. If you have created an input mask for the column, type the desired prompt
character in the Mask Prompt box.
The mask prompt character will replace all placeholders in the input mask,
but literal characters will appear in the selected column exactly as they appear in the Input Mask box.
7. If the selected column is assigned an alias in the SQL statement of the
open view, and if you want the column to be sortable, then you will need to
enter an alternate field name for the column. The alternate field name needs
to be whatever calculation or concatenation is used in the SQL statement of
the open view to define the selected column. The alternate field name will be
used whenever the column is sorted, in the SORT BY portion of the SQL
statement.
276
Chapter 15
8. If you would like to modify the visual attributes of the selected column,
select the desired visual attribute option. The five visual attribute options
are listed and explained below:
• Always Visible. This option means that the selected column will always be visible.
• Visible on Level One Only. This option means that the column will
only be visible if the folder that contains the column is located immediately under a work group on the Database Map tree diagram.
• Visible on Level Two and Below. This option means that the column
will be visible in subfolders, but it will not be visible in regular folders.
• Not Visible. This option means that the column will not be visible at
all.
• Smart Column. This option means that if the column is visible in an
open folder, it will not be visible in any subfolders opened from that
folder.
9. If you would like to modify how the data is aligned in the selected column,
select the desired alignment option.
10. If you want the selected column to be sortable, filterable and editable,
enable the desired options.
11. If you want all the data in the selected column to be capitalized, enable
the Caps Lock option.
12. If you want any literal characters in the Input Mask box saved in the
database, enable the Include Mask in Data option.
If you enable the Include Mask in Data option you will not need a display
mask, because the literal characters in the input mask will be saved as data.
If you do not enable the Include Mask in Data option, then you will want to
create a display mask if you want the data to be displayed the same way it is
created.
Using Smeadlink's Administrative Utilities I
277
13. If you will be printing reports from the open view while the view is sorted
according to the selected column, then you can use the Page Break option to
divide the report up according to the entries in the selected column.
If you enable the Page Break option, Smeadlink will create a page break each
time it comes to a new entry in the selected column. The Page Break option is
only applicable to columns that contain duplicate entries, because in columns that contain unique entries it will create a page break for each entry in
the column.
14. If you enable the Page Break option, you can eliminate duplicate entries
in the report by enabling the Do not print Duplicates option. This option will
only print each entry in the selected column once in the report, instead of
repeating it for each row that contains the entry. Getting rid of the duplicate
entries makes the report much easier to read.
15. Once you have set all the options on the Properties window, press Enter
or click the OK button to save your changes and apply them to the selected
column.
Using Smeadlink's Administrative Utilities II
16. Using Smeadlink's Administrative
Utilities II
Chapter contents
Introduction
Creating an Add-In
Deleting an Add-In
Modifying an Add-In
Report Generator Concepts
Using the Column Print Properties Window
Using the Report Setup Window
Using the Report Styles Window
279
280
Chapter 16
Introduction
The previous chapter showed you how to use the first two administrative
utilities in Smeadlink—the Views utility and the Columns utility. You learned
how to use these two tools to work with the views and columns in the open
Smeadlink database.
This chapter will show you how to use the other two administrative utilities in
Smeadlink—the Add-Ins Manager and the Report Generator. The Add-Ins
Manager allows you to create and modify the add-ins in the open database
(recall from chapter 1 that an add-in is a shortcut from Smeadlink to an
external program, file or web page), and the Report Generator allows you to
create a formatted report for each view in the open database.
This chapter is divided into two main parts, each part consisting of several
sections. The first part explains how to use the Add-Ins Manager utility to
work with add-ins in the open Smeadlink database. The second part explains
the basic concepts for using the Report Generator, and then it explains in
detail how to use the Report Generator utility to work with formatted reports
for Smeadlink views.
Note: For an introduction to all Smeadlink's administrative utilities, see the
section Smeadlink Administrative Utilities in chapter 1 of this manual.
Using Smeadlink's Administrative Utilities II
281
Creating an Add-In
An add-in is a shortcut from Smeadlink to an external program, file or web
page. The capability to create and use add-ins was added to Smeadlink 3.1 to
make it easier to use Smeadlink with external programs such as Crystal Reports. This section will show you how to create an add-in for the open
Smeadlink database.
Add-ins are created in Smeadlink with a utility called the Add-Ins Manager.
You can open this utility from the start-up screen, the Scanner program or
the Tracking program if you have Manager access rights. Once you use the
Add-Ins Manager to create an add-in, the add-in will become visible in all
three of these programs, regardless of which program you used to create it.
The add-in will appear on the Add-Ins menu of each program, and your
Smeadlink operators will be able to use it to open the corresponding external program, file or web page. The Add-Ins menu has built-in security, so if
an operator does not have access to the program or file that an add-in points
to, then that add-in will not appear on that operator's Add-Ins menu.
Note: For information about using add-ins, see the section Opening an AddIn from a Smeadlink Program in chapter 2 of the Smeadlink User's Guide.
To create an add-in:
1. Open the Add-Ins Manager from Smeadlink, Scanner program or Tracking program. To open the Add-Ins Manager:
• Open the Add-Ins menu.
• Click the Add-Ins Manager command at the top of the Add-Ins menu.
The Customize Add-Ins Menu window will now appear as shown on the
following page. The window in the example contains four add-ins. The number of add-ins in your Customize Add-Ins Menu window will be determined
by the number of add-ins in your open Smeadlink database.
282
Chapter 16
Customize Add-Ins Menu window
2. Click the Add button on the Add-Ins Manager window.
The Add-Ins Menu Item Properties window will now appear. The example
below shows what this window looks like.
Add-Ins Menu Item Properties window
3. Type the desired name for the add-in in the Menu Item Description box.
The name that you enter in the Menu Item Description box is the name that
the add-in will be called on the Add-Ins menu. If you want to create a hot
key for the add-in, you can do so by typing an ampersand (&) before the
desired hot key character.
4. Type the desired path for the add-in in the Location box.
The path that you enter in the Location box needs to be the exact location of
the external program, file or web page you want the add-in to access. For
instance, if you are creating an add-in for the Crystal Reports program, you
would type the entire path to the Crystal Reports .exe file in the Location
box.
Using Smeadlink's Administrative Utilities II
283
If you do not know the exact location of the item you want the add-in to
open, click the Browse button at the bottom of the Add-Ins Menu Item Properties window. A standard Open window will then appear, and you can use
it to navigate around the files in your computer or network and pick the
desired file.
If you are creating for a program or file and the add-in will be used by multiple operators, then you may not know where the program or file will be
located on each operator's computer. Furthermore, a program may be located in one directory on one operator's computer, but it may be located in a
different directory on another operator's computer.
For situations like this, where you need to create an add-in for a program
that is either in an unknown location or in different locations on various
computers, you can simply type the name of the program or file in the Location box—you do not need to type the entire path to the program or file. The
only stipulation is that if you are creating an add-in for a program, the program needs to be registered on each operator's computer, and if you are
creating an add-in for a file, the file needs to be saved locally on each
operator's computer.
Note: If you have already typed in the entire path for a program or file, and
you want to remove all the components in the path except the name of the
program or file, you can do so automatically by clicking the Remove Path
button at the right of the Location box.
5. If you specified a program in the Location box, and if the program needs
any parameters each time it is opened, then type the appropriate parameters
in the Parameters box.
Parameters are only used by programs—they are never used by files. If a
program requires parameters, then the documentation that came with the
program will explain the type of parameters required, the order they need to
be in and the character or characters they need to be separated with.
As a convenience, the Add-Ins Menu Item Properties window contains three
predefined parameters: Todays Date, Todays Date/Time and User Name.
To enter any of these parameters in the Parameters box, click the Predefined
button at the right of the Parameters box, and then click the desired predefined parameter on the list that appears.
284
Chapter 16
6. Press Enter or click the OK button on the Add-Ins Menu Item Properties
window.
The window will now close, and new add-in will appear at the bottom of the
add-ins list in the Customize Add-Ins Menu window.
7. Select the desired menu position for the new add-in (i.e. first add-in on
the menu, second add-in, third add-in, etc.). To select the desired position:
• Click the up or down arrows at the right of the add-ins list until the new
add-in is in the desired menu position.
8. Click the Close button on the Customize Add-Ins Menu window.
The window will now close, and you will be finished creating the add-in.
The new add-in will now be visible to your Smeadlink operators in the startup screen, Scanner program and Tracking program, as long as they have
access rights to the item the add-in opens.
Using Smeadlink's Administrative Utilities II
285
Deleting an Add-In
This section will show you how to delete an add-in from the open Smeadlink
database. You can use the information in this section to delete any number
of add-ins from the open database.
To delete an existing add-in:
1. Open the Add-Ins Manager from the start-up screen, Scanner program or
Tracking program. To open the Add-Ins Manager:
• Open the Add-Ins menu.
• Click the Add-Ins Manager command at the top of the Add-Ins menu.
The Customize Add-Ins Menu window will now appear as shown below.
All the add-ins that have been created for the open database will be listed in
this window. The window in the example lists four add-ins, starting with
one called Auction Info.
Customize Add-Ins Menu window
2. Click the add-in that you want to delete.
3. Click the Remove button at the bottom of the Customize Add-Ins Menu
window.
A popup window will now appear asking if you want to delete the selected
add-in.
4. Press Enter or click the Yes button on the popup window to delete the addin.
5. Click the Close button at the bottom of the Customize Add-Ins Menu
window to close it.
286
Chapter 16
Modifying an Add-In
The Edit button on the Add-Ins Manager utility allows you to modify the
properties of any existing add-in in the open database. The properties of an
add-in determine the name of the add-in, the item that opens when the addin is selected and the parameters that are passed to the program or file when
it is opened. This section will show you how to modify an existing add-in. In
addition to the properties listed above, you will also learn how to adjust the
position of an add-in on the Add-Ins menu (i.e. whether it is the first add-in
on the menu, the second, the third, etc.). You can use the information in this
section to modify any number of add-ins in the open database.
To modify an existing add-in:
1. Open the Add-Ins Manager from the start-up screen, Scanner program or
Tracking program. To open the Add-Ins Manager:
• Open the Add-Ins menu.
• Click the Add-Ins Manager command at the top of the Add-Ins menu.
The Customize Add-Ins Menu window will now appear as shown below.
All the add-ins that have been created for the open database will be listed in
this window. The window in the example lists four add-ins, starting with
one called Auction Info.
Customize Add-Ins Menu window
2. Click the add-in that you want to modify.
3. Click the Edit button at the bottom of the Customize Add-Ins Menu window.
The Add-Ins Menu Item Properties window will now appear as shown on
the following page.
Using Smeadlink's Administrative Utilities II
287
Add-Ins Menu Item Properties window
4. If you want to modify the name of the add-in, delete the current name
from the Menu Item Description box and type in the new name.
The name that you type in the Menu Item Description box is the name that
the add-in will be called on the Add-Ins menu. If you want to create a hot
key for the add-in, you can do so by typing an ampersand (&) before the
desired hot key character.
5. If you want the add-in to open a different program, file or web page when
it is selected, or if the original item was moved and you need to update the
path, delete the current path in the Location box and type in the new path.
For more information about entering a path for an add-in, see step 4 in the
section Creating an Add-In earlier in this chapter.
6. If you want to modify the parameters of the add-in, delete the current
parameters from the Parameters box and type in the new parameters.
Parameters are only applicable to certain programs—they are never used
with files. The parameters are passed to the program each time it is started to
set certain options inside the program. The documentation that comes with
these programs will explain in detail what parameters are required by the
program, what order the parameters need to be in and what character should
be used to separate the parameters.
7. Press Enter or click the OK button on the Add-Ins Menu Item Properties
window.
8. If you want to change the position of the add-in on the Add-Ins menu:
• Click the up or down arrows at the right of the add-ins list until the new
add-in is in the desired menu position.
9. Click the Close button on the Customize Add-Ins Menu window.
288
Chapter 16
Report Generator Concepts
The Report Generator is a utility in Smeadlink that allows you to create a
formatted report for each view in the open database. Formatted reports differ
from basic reports printed using the Print...All Rows or Print...Selected Rows
commands, because they allow you to determine what data appears on the
report and how the data is displayed.
The Report Generator is made up of three separate components in Smeadlink:
the Column Print Properties window, the Report Setup window and the Report Styles window. The Column Print Properties window and the Report
Setup window are used to determine what data appears on formatted reports,
and the Report Styles window is then used to determine how the data will be
displayed (i.e. what color it will be, how large it will be, etc.).
This section explains the concepts you will need to know to get the most out
of the Report Generator. Specifically, it explains the capabilities of the Report Generator, the components included in the Report Generator and the
basic steps to creating a formatted report for a Smeadlink view. After you
learn about Report Generator concepts in this section, then the next three
sections in this chapter will explain in detail each of the main components in
the Report Generator.
Capabilities of the Report Generator
The basic capabilities of Smeadlink's Report Generator utility are listed below. For more detailed information about the Report Generator's capabilities, see Components in the Report Generator later in this section.
• some header and footer formatting
• font style, size and color adjustment
• margin adjustments
• print up to three levels
• print tracking history and contents
• print images (full size or continuous in specified margins)
Using Smeadlink's Administrative Utilities II
289
Components in the Report Generator
The Report Generator utility consists of three main components: the Column Print Properties window, the Report Setup window and the Report Styles
window. Each component is displayed below, followed by a brief explanation of it's role in the Report Generator and the different capabilities it provides.
Column Print Properties window
Column Print Properties window
The Column Print Properties window can be opened for any column in the
active view, and it allows you to set the print attributes for the column it was
opened from. For instance, you can use the Column Print Properties window
to determine if data from the column will be included in reports, and you can
use it to determine if a count will be included for the column, that counts
how many entries from the column were printed in the report.
The Column Print Properties window is divided into two sections. The first
section contains options that apply to both basic reports and formatted reports, and the second section contains options that only apply to formatted
reports. Some of the options in both sections work together with options on
the other Report Generator components. For instance, the Max Lines per
Row option works with the Max Lines and Fixed Lines options on the Report Setup window, to determine how many lines from entries in the column
will be printed on the report.
290
Chapter 16
Report Setup window
Report Setup window
The Report Setup window can be opened for any view in the open database,
and it allows you to set the print attributes for the view it was opened from.
For instance, you can use the Report Setup window to determine if users
will be able to print a formatted report for the open view, and you can use it
to determine if data from a subtable will be included in the formatted report.
The print attributes on the Report Setup window apply to formatted reports
only—they do not apply to basic reports printed with the Print...All Rows or
Print...Selected Rows commands.
The Report Setup window is divided into two sections, one on the left side
of the window and one on the right side. The left section contains options
that apply to row data, and the right section contains options that apply to
images. The image section will only be displayed on the Report Setup window if the view it was opened from contains rows with images attached to
them.
Using Smeadlink's Administrative Utilities II
291
Report Styles window
Report Styles window
The Report Styles window can be opened for any view in the open database,
and it allows you to work with the styles that have been created for the view
it was opened from. A style is similar to a rule in the Scanner program—it is
a group of settings that defines how the different items on the report will be
displayed. For instance, a style determines what text will be in the header
and footer fields on the report, and it also determines what color the different items on the report will be. Styles only apply to formatted reports.
The Report Styles window displays each style that has been created for the
open view, and it may also display a brief description of the style (if a description for it has been created). You can use the Report Styles window to
edit existing styles, delete existing styles or create new styles. You can also
use it to select which style will be used to print the formatted report for the
open view.
When you open the Report Styles window for any view in the database, the
window will display a style called Default, in addition to any other styles
that have been created for the view. As its name implies, the Default style
sets all the style options to their default settings. You can edit the Default
style you just like you edit any other style, but you cannot delete it. This is
because new styles are created in the Report Styles window by cloning existing styles, so there must always be at least one existing style.
292
Chapter 16
Steps to Creating a Formatted Report
There is no set way to creating a formatted report with the Report
Generator utility, but if you have not used it before or if you are not very
familiar with it, then it may be difficult to know which component to start
with and which options to set. The following steps explain the general
procedure used to create a formatted report.
These steps are only suggestions, but they will give you a basic
procedure to follow when creating a formatted report. Once you create
one or two reports and become familiar with the different components in
the Report Generator utility, then you will probably come up with your
own method that works best for you. Feel free to experiment, as the
Report Generator is by design a very flexible tool.
After you learn the general procedure for creating formatted reports in the
steps below, then the next three sections in this chapter will explain in
detail each of the three components in the Report Generator utility (the
Column Print Properties window, the Report Setup window and the Report
Styles window). The sections list each option on these windows, and
explain what each option does and how it is typically used.
To create a formatted report:
1. Open the view in the Librarian that you would like to create a formatted
report for. If you would like to create a nested report with two or three
levels (i.e. parent view to child view, or parent view to child view to child
view), then open the innermost view first.
2. Set the print properties for each column in the open view. To set the
print properties for the columns in the open view:
• Open the Column Print Properties window for the first column
in the view.
• Set the options on the Column Print Properties window to the
desired settings.
• Click the OK button on the Column Print Properties window to
save your settings.
• Repeat the above three steps for the remaining columns in the
view.
Using Smeadlink's Administrative Utilities II
293
For more information about the Column Print Properties window, see the
section Using the Column Print Properties Window later in this chapter.
The first part of that section explains how to open the Column Print
Properties window for a column in the open view, and the second section
explains each of the options on the window.
3. Open the Report Setup window for the open view and set the options
on it to the desired settings (remember to click the OK button on the
Report Setup window after settings its options, to save your settings).
As you learned earlier, the Report Setup window allows you to set the
print attributes for the view it was opened from. For instance, you can use
it to determine if users will be able to print a formatted report for the open
view, and you can use it to determine if data from a subtable will be
included in the formatted report. For more information about the Report
Setup window, see the section Using the Report Setup Window later in
this chapter. The first part of that section explains how to open the Report
Setup window for the open view, and the second section explains each of
the options on the window.
4. Open the Report Styles window for the open view and select the
desired style for the formatted report. As you learned earlier, the Report
Styles window allows you to work with the existing styles that have been
created for the open view and create new styles. A style is similar to a rule
in the Scanner program—it is a group of settings that defines how the
different items on the report will be displayed.
You can either select an existing style on the Report Styles window, or
you can create a new one. For more information about the Report Styles
window, see the section Using the Report Styles Window later in this
chapter. The first part of that section explains how to open the Report
Styles window for the open view, the second part explains how to work
with the existing styles in the Report Styles window and the third part
explains each of the options used to create a style. Once you select and or
create a style for the open view, then you will be done setting up the
formatted report.
5. If you are setting up a multilevel report, then open the parent view of
the view you just finished setting up, and repeat steps 2–4 of this section
on the parent view. Once you finish setting up the parent view, then you
will be finished setting up the report if it contains two levels. If it contains
three levels, then open the outermost view in the hierarchy now and
repeat steps 2–4 on it. You will now be finished setting up your report.
294
Chapter 16
Using the Column Print Properties Window
The Column Print Properties window is one of the components in Smeadlink's
Report Generator utility, which allows you to create a formatted report for
any view in the open database. Formatted reports differ from basic reports
printed using the Print...All Rows or Print...Selected Rows commands, because they allow you to determine what data appears on reports and how the
data is displayed.
This section will show you how to use the Column Print Properties window
to set the print properties for the columns in the open view. The first part
explains how to open the Column Print Properties window for a column in
the open view, and the second part explains each of the different options on
the Column Print Properties window. You will need to open the Column
Print Properties window separately for each column in the view, because the
settings on it only apply to the column it was opened for.
Note: For information about the procedure for creating a formatted report
with the Report Generator, see the section Report Generator Concepts earlier in this chapter. The Report Generator Concepts section explains the
capabilities of Smeadlink's Report Generator, the components in the Report Generator and the order that the components are used in to create
formatted reports.
Using Smeadlink's Administrative Utilities II
295
Opening the Column Print Properties Window
The following instructions will show you how to open the Column Print
Properties window for a column in the open view. If you later adjust any of
the settings on this window, they will only apply to the column it was opened
from.
To open the Column Print Properties window:
1. Right-click the header of the column you would like to open the Column
Print Properties window from. The Column popup menu will now appear as
shown below.
2. Click the Print Properties command on the Column popup menu.
The Column Print Properties window will now appear. The example below
shows what the Column Print Properties window looks like.
Column Print Properties window
296
Chapter 16
Options on the Column Print Properties Window
The rest of this section explains each of the options on the Column Print
Properties window. The options are explained in the order they appear on
the window, from top to bottom.
Note: If you would like to see how a changed setting on the Column Print
Properties window will affect the printed report, then open \Smeadlink's
File menu and click Print Preview...Formatted Report. The Print Preview
window will now appear, with a preview of what a formatted report for the
open view would like with the current settings on the Report Generator windows.
Print on Report
The Print on Report option determines if data from the selected column will
appear on reports printed from the open view (both basic reports printed
using the Print...All Rows or Print...Selected Rows commands, and formatted reports). If this option is enabled, then data from the column may appear
on reports printed from the open view (depending on the other Report Generator settings). If this option is disabled, then data from the column will not
appear on printed reports, regardless of any other settings.
Note: The default setting for the Print on Report option is enabled, so all the
columns in the open view will be included in reports unless you manually
disable Print on Report for each one.
Page Break
The Page Break option determines if a page break should be included in
printed reports after each unique entry in the selected column. This option is
often used when the selected column contains multiple duplicate entries, and
has been used to sort the open view. Each group of rows with the same entry
in the selected column can then be printed on a separate page (or pages) in
the report.
Note: The Page Break option can be enabled for multiple columns in the
open view. If you enable the Page Break option for multiple columns, then a
page break will be inserted in the report after the data in any one of the
columns changes.
Using Smeadlink's Administrative Utilities II
297
Do Not Print Duplicates
The Do Not Print Duplicates option determines if duplicate entries in the
selected column will be printed on reports (this option is only applicable if
the selected column contains multiple duplicate entries and has been used to
sort the open view). If this option is enabled, then for each group of duplicate entries in the column, only the first one will be printed. The following
entries will be left blank.
When a row has a duplicate entry that will not be printed, then the only cell
in the row that is affected by Do Not Print Duplicates is the cell with the
duplicate entry—the rest of the row is printed out normally on the report.
Max Lines per Row
The Max Lines per Row option determines the maximum number of lines
from cells in the selected column to print on reports. For instance, if you set
Max Lines per Row to 5, then reports printed from the open view would
contain at most five lines of data from each cell in the selected column. If a
cell contained more than five lines of data, then the extra data would not be
printed.
You can set a different Max Lines per Row value for each column in the
open view. If you do this, then the height of each row in the report will be
determined by the cell in the row with the most printed lines of data. The
remaining cells in the row will be padded with white space (or alternate
row-colored space), to give them the same height as the tallest cell.
Note: In addition to the Max Lines per Row option, there are also two options on the Report Style Settings window that affect how many lines from
cells in the view's columns will be printed on reports. These options only
apply when printing a formatted report for the open view, and they may
override the Max Lines per Row settings in the view, depending on how they
are set up. For more information, see Maxed Lines and Fixed Lines in the
section Using the Report Style Settings window—Options on the Report Style
Settings window later in this chapter.
Count
The Count option counts the number of cells from the selected column that
have data printed in the formatted report. It then displays this number at the
end of the report. If the selected column is a column in a child view that is
printed on a report from the parent view, then a count will also be displayed
at the bottom of each group of child rows, in addition to the count for total
children at the end of the report.
298
Chapter 16
Subtotal
The Subtotal option adds the entries in the selected column together, and
displays the total at the bottom of the report. Since this option requires numerical data, it is only available for columns that contain numbers.
Restart Page Numbers on Page Break
The Restart Page Numbers on Page Break option is used with the Page Break
option explained earlier. If the Page Break option is enabled, then you can
use the Restart Page Numbers on Page Break option to determine if you
want to restart page numbering for each group of duplicate rows in the report.
Use as Id in Header/Footer
The Use as Id in Header/Footer option allows you to put data from the selected column into the header or footer of the formatted report. When this
option is enabled, you will be able to select a token in any of the header or
footer text fields on the Report Style Settings window, that corresponds to
the selected column. When the report is then printed, the token will be replaced by data from each of the column's cells. The Use as Id in Header/
Footer option will only be available if the Page Break option is enabled,
because it cannot function with more than one unique entry from the selected column on each page.
The Use as Id in Header/Footer option is intended for printing full-page
images in a report. When printing full-page images, the Use as Id in Header/
Footer option provides the only way to identify in the report which row each
image is attached to. You simply enable the Use as Id in Header/Footer
option for the Id column in the view, and then select the token in one of the
footer fields on the Report Style Settings window. When the report is then
printed, the footer of each image will contain the Id number of the row it is
attached to.
Note: For more information about the Report Style Settings window, see the
section Using the Report Styles Window-Options on the Report Style Settings Window later in this chapter.
Using Smeadlink's Administrative Utilities II
299
Using the Report Setup Window
The Report Setup window is one of the components in Smeadlink's Report
Generator utility, which allows you to create a formatted report for any view
in the open database. Formatted reports differ from basic reports printed
using the Print...All Rows or Print...Selected Rows commands, because they
allow you to determine what data appears on reports and how the data is
displayed.
This section will show you how to use the Report Setup window to set the
print attributes for the open view. The first part explains how to open the
Report Setup window, and the second part explains each of the different
options on the Report Setup window.
Note: For information about the procedure for creating formatted reports
with the Report Generator, see the section Report Generator Concepts earlier in this chapter. The Report Generator Concepts section explains the
capabilities of Smeadlink's Report Generator, the components in the Report Generator and the order that the components are used in to create
reports.
Opening the Report Setup Window
The following instructions will show you how to open the Report Setup
window for the open view. If you later adjust any of the settings on this
window, the new settings will only apply to the view it was opened from.
To open the Report Setup window:
1. Open the Reports menu from Smeadlink's main menu bar.
2. Click the "NAME OF OPEN VIEW" Report Setup command on the Reports menu.
The Report Setup window will now appear. The example on the following
page shows what the Report Setup window looks like.
Note: If the open view does not contain any images, then the Report Setup
window will not contain the image options shown on the right side in the
example.
300
Chapter 16
Report Setup window
Using Smeadlink's Administrative Utilities II
301
Options on the Report Setup Window
The rest of this section explains each of the options on the Report Setup
window. The general options that are always displayed on the Report Setup
are explained first, in the order they appear on the window. The image options that are only displayed if the open view contains images are explained
following the general options.
Note: If you would like to see how a changed setting on the Report Setup
window will affect the printed report, then open Smeadlink's File menu and
click Print Preview...Formatted Report. The Print Preview window will now
appear, with a preview of what a formatted report for the open view would
like with the current settings on the Report Generator windows.
Show as Printable View
The Show as Printable View option determines whether or not users will be
able to print a formatted report for the open view. If this option is not enabled, then the Print...Formatted Report command will not be available on
the File menu, so no user will be able to print custom reports. If this option
is enabled, then the Print...Formatted Report command will be available on
the File menu, and any user will be able to print a formatted report for the
open view using the current Report Generator settings.
Print Grand Total Page Only
The Print Grand Total Page Only option is used in views that contain columns with either counts or subtotals. When Print Grand Total Page Only is
enabled, then only the last page of the formatted report will be printed (the
page with all the final counts and subtotals). Print Grand Total Page Only is
intended for people such as managers or administrators, who only want to
see the final counts and subtotals in a report.
Note: Counts and subtotals are set up individually for each column using
the Column Print Properties window. For more information about them, see
Count and Subtotal in the section Using the Column Print Properties Window—Options on the Column Print Properties window earlier in this chapter.
302
Chapter 16
Print Header
The Print Header option determines if a header will be printed on the formatted report. If Print Header is enabled, then the text, box and shadow of
the report's header will be printed on the pages of the report according to the
current settings on the Report Style Settings window. The header will be
printed on both pages with rows on them and pages with images on them. If
Print Header is disabled, then the header will print not print on any pages in
the report.
Note: For more information about report headers, see the section Using the
Report Styles Window—Options on the Report Styles Window later in this
chapter.
Print Footer
The Print Footer option determines if a footer will be printed on the open
view's custom report. If Print Footer is enabled, then both the text and line of
the report's footer will be printed on pages that include rows or images and
rows (pages that include full-page images use the image footer explained
later). If Print Footer is disabled, then the footer will not print on any pages
in the report.
Note: For more information about report footers, see the next section in this
chapter.
All Columns
The All Columns option determines what columns in the open view will be
included in the custom report. If this option is enabled, then all columns in
the open view will be included in the report. If this option is not enabled,
then the Frozen Columns Only option will be enabled and you will need to
freeze the columns you want included in the report.
Frozen Columns Only
The Frozen Columns Only option determines what columns in the open
view will be included in the custom report. If this option is enabled, then
only frozen columns in the open view will be included in the report. If this
option is disabled, then the All Columns option will be enabled and all the
columns in the open view will be included in custom reports.
Note: For more information about freezing columns, see the section Freezing Columns in a Layout in chapter 5 of the Smeadlink User's Guide.
Using Smeadlink's Administrative Utilities II
303
Select
The Select button allows you to select the style that will be used to print the
formatted report. The style does not affect what data will be printed on the
report, instead, it determines what the data will look like. For instance, the
style determines the font of the text on the report, and it also determines the
colors of the different items on the report.
To select a style for the formatted report:
• Click the Select button.
The Report Styles window will now appear as shown below. The styles
that have been created for the open view will be listed in the middle of
the Report Styles window. The window in the example contains two
styles called Default and Test Style.
Report Styles window
• Click the desired style in the Report Styles window. The style will now
appear highlighted.
• Click the Select button on the Report Styles window.
The Report Styles window will now close, and the style you selected
will appear in the Report Style box to the left of the Select button.
Note: For more information about the Report Styles window and report
styles, see the section Using the Report Styles Window later in this chapter.
304
Chapter 16
Sub Table
The Sub Table box determines if data from a subtable will be included in the
formatted report. If you select a subtable in the Sub Table box, then you will
also need to select one of the subtable's views in the Sub Table View box.
When the report is then printed, each row in the parent table's view will be
followed by all the rows in the subtable's view that are attached to it.
To select a subtable:
• Click the down arrow at the right of the Sub Table box to open the Sub
Table dropdown.
The Sub Table dropdown will display all the subtables that have been
created for the open view's table. If the table contains tracking information, you will also see an option called <<Tracking>> in the Sub
Table dropdown.
• Click the desired table to select it, or click <<Tracking>> if you want
to display tracking information in the report. The Sub Table dropdown
will now close, and the item you selected will appear in the Sub Table
box.
Sub Table View
The Sub Table View box will only function if the a table has been selected
in the Sub Table box. If no subtable has been selected, then the Sub Table
View dropdown will be blank when you open it. If a subtable has been
selected, then the Sub Table View dropdown will display all the views in the
selected subtable.
To select a subtable view:
• Click the down arrow at the right of the Sub Table View box to open
the Sub Table View dropdown.
The Sub Table View dropdown will display all the views for the selected subtable. If the <<Tracking>> option is selected in the Sub Table
box, then the Sub Table View dropdown will display all the tracking
contents types for the open view.
• Click the desired view to select it, or click the desired tracking type.
The Sub Table View dropdown will now close, and the item you selected will appear in the Sub Table View box.
Using Smeadlink's Administrative Utilities II
305
Left Indent
The Left Indent option determines how far tracking data or data from a
subtable will be indented on the left side of the formatted report. This option
is typically used with the Right Indent option to distinguish tracking data or
data from a subtable from data in the open view. If you set Left Indent to 0,
then tracking data or data from a subtable will not be indented at all, and it
will look just like data from the open view. If you sent Left Indent to a
positive number, then tracking data or data from a subtable will be indented
accordingly to distinguish it from the parent data.
Note: The Left Indent option is set in twips, where one twip equals 1/1440 of
an inch.
Right Indent
The Right Indent option determines how far tracking data or data from a
subtable will be indented on the right side of the formatted report. This option is typically used with the Left Indent option to distinguish tracking data
or data from a subtable from data in the open view. If you set Right Indent to
0, then tracking data or data from a subtable will not be indented at all on the
right side of the report, and it will look just like data from the open view. If
you sent Right Indent to a positive number, then tracking data or data from
a subtable will be indented accordingly to distinguish it from the parent
data.
Note: The Right Indent option is set in twips, where one twip equals 1/1440
of an inch.
Always, Never, At Top of Page Only
The Always, Never and At Top of Page Only options determine when to
print column headers for tracking data or data from a subtable on the formatted report. If you select Always, then headers will be printed before each
row or group of rows containing tracking data or data from a subfolder. If
you select Never, then headers will never be printed. Finally, if you select At
Top of Page Only, then headers will only be printed at the top of each page
in the report.
306
Chapter 16
Include Tracked Objects Ever Contained
The Include Tracked Objects Ever Contained option will only be available
if the <<Tracking>> option is selected in the Sub Table box, and if a contents type option is selected in the Sub Table View box. If you enable Include Tracked Objects Ever Contained, then the report will display all the
objects of the selected type that have ever been tracked to each row in the
open view. If you leave Include Tracked Objects Ever Contained disabled,
then the report will only display objects that are currently tracked to the
rows in the view.
Print Images
The Print Images option, along with the other image options, will only be
displayed on the Report Setup window if the open view contains images. If
Print Images is enabled, then any images attached to rows in the view will be
printed on the formatted report according to the settings of the other image
options. If Print Images is disabled, then the other image options will not be
available and no images will be printed on the report.
Print Images Full Page
The Print Images Full Page option will only be available if the Print Images
option is enabled. If you enable Print Images Full Page, then each image
attached to a row in the open view will be printed in the formatted report on
a full page. If you leave Print Images Full Page disabled, then images will be
printed according to the following algorithm:
• Scale the width to fit into the space between the left and right margins.
• Scale the height so it is proportional to the width.
• If the scaled image fits on the current page, then print it on the page.
• If the scaled image does not fit on the current page, then go to the top
of the next page and print it there.
Print First Page Only
The Print First Page Only option will only be available if the Print Images
option is enabled. If you enable Print First Page Only, then when a formatted report is printed for the open view, only the first image in the report will
be printed. If you leave Print First Page Only disabled, then the entire report
will be printed. This option is helpful if you want to check what a printed
image looks like with the current Report Generator settings.
Using Smeadlink's Administrative Utilities II
307
Print Redlining
The Print Redlining option will only be available if the Print Images option is
enabled. If you enable Print Redlining, then any redlining objects that have
been created for the images in the open view will be printed on the images in
the report. If you leave Print Redlining disabled, then the images will be
printed without any redlining objects on them.
Print Data Row
The Print Data Row option will only be available if the Print Images option
is enabled. If you enable Print Data Row, then when a formatted report is
printed for the open view, each row in the view will be printed on the report
before the image or images it is attached to. If you leave Print Data Row
disabled, then only the images in the view will be printed on the report, and
they will be printed in the order of the rows they are attached to.
Print Image Footer
The Print Image Footer option will only be available if the Print Images and
Print Images Full Page options are enabled. The purpose of the Print Image
Footer option is to make images printed out in a report look similar to images printed from the Image Viewer or Manual Indexing Viewer. When
images are printed from either viewer, they are printed full page with a footer
at the bottom. The footer is printed in 6 point Arial text, and it contains
information like the location of the image and the date and time it was printed.
The Print Image Footer option allows you to make images printed in a report
look like images printed from Smeadlink viewers. If you enable Print Image
Footer, then each image in the report will have a footer printed at the bottom
of its page. The footer will contain the same data as the standard footer, and
it will be laid out in the same way, but it will be forced into 6 point Arial text to
match the footers of images printed from the Image Viewer or Manual Indexing Viewer.
Left Margin and Right Margin
The Left Margin and Right Margin options will only be available if the Print
Images option is enabled and the Print Images Full Page option is disabled.
The left and right margins are used to determine how large images in the
open view will be printed on the report. First, the images are scaled horizontally to fit in the space between the left and right margins, and then the
images are scaled vertically to retain their original proportions. The left and
right margins are both measured from the edge of the page, and they are set
in twips (1 twip is equal to 1/1440 inch).
308
Chapter 16
Using the Report Styles Window
The Report Styles window is one of the components in Smeadlink's Report
Generator utility, which allows you to create a formatted report for any view
in the open database. Formatted reports differ from basic reports printed
using the Print...All Rows or Print...Selected Rows commands, because they
allow you to determine what data appears on the reports and how the data is
displayed.
This section will show you how to use the Report Styles window to work
with styles for the open view. The first part explains how to open the Report
Styles window, the second part explains how to modify existing styles or
create new ones and the last part explains each of the different options for
create a report style.
Note: For information about the procedure for creating formatted reports
with the Report Generator, see the section Report Generator Concepts earlier in this chapter. The Report Generator Concepts section explains the
capabilities of Smeadlink's Report Generator, the components in the Report Generator and the order that the components are used in to create
reports.
Using Smeadlink's Administrative Utilities II
309
Opening the Report Styles Window
The following instructions will show you how to open the Report Styles
window. Once the window is open, you can use it to clone a new style or
modify an existing one, and you can also use it to select which style will be
used to print the formatted report for the open view. You will learn how to use
the Report Styles window to work with styles later in this section.
To open the Report Styles window:
1. Open the Reports menu from Smeadlink's main menu bar.
2. Click the "NAME OF OPEN VIEW" Report Setup command on the Reports menu.
The Report Setup window will now appear as shown below.
Note: If the open view does not contain any images, then the Report Setup
window will not contain the image options shown in the example.
Report Setup window
310
Chapter 16
3. Click the Select button on the Report Setup window. The Report Styles
window will now appear as shown below.
The styles that have been created for the open view will be listed in the
middle of the Report Styles window. The name of each style will be listed
beneath the Style Name heading, and a brief description of each style will be
listed beneath the Description heading (if a description has been entered for
the style). The window in the example below contains two styles called
Default and Test Style.
As its name implies, the Default style is created automatically for each view
in the database, so it will always be listed when you open the Report Styles
window. You can use the Default style to create any number of new styles
for the open view (by cloning the Default style and then changing the desired settings), so the actual number of styles you see in the Report Styles
window will vary from view to view.
Report Styles window
Using Smeadlink's Administrative Utilities II
311
Working with Report Styles
The following instructions will show you how to use the Report Styles window to work with report styles. You will learn how to select the style that
will be used by the open view to print formatted reports, how to create a new
style and how to edit or remove an existing style.
Note: The following instructions assume that the Report Styles window is
already open. For information about opening the Report Styles window, see
the previous part in this section.
To select the style for printing formatted reports:
1. Click the desired style in the Report Styles window. The style will appear
highlighted after you click it, to indicate that it is selected.
2. Click the Select button at the bottom of the Report Styles window.
The Report Styles window will now close, and the style you selected will be
displayed in the Report Style box on the Report Setup window.
To create a new style:
1. Click the existing style that most closely matches the new style you want
to create.
The style will appear highlighted after you click it, to indicate that it is now
selected.
2. Click the Clone button at the bottom of the Report Styles window.
The Report Style Settings window will now appear as shown on the following page. This window contains all the options that define a report style. The
options on the Report Style Settings window will be set according to the
style you selected before clicking the Clone button, except the Name and
Description options will be blank.
312
Chapter 16
Report Style Settings window
3. Enter a name for the new style in the Report Style Name box.
The name you enter will be used along with the description to identify the
style in the Report Styles window.
4. Enter a description for the new style in the Description box.
The description you enter will be used along with the name to identify the
new style in the Report Styles window. If you think the name you entered
will be enough to identify the style, then you do not need to enter a description in the Description box.
5. Look over the remaining options on the Report Style Settings window,
and make sure they are all set to the desired settings.
For information about the different options on the Report Style Settings window, see Options on the Report Style Settings window later in this section.
Each option is listed there in the order it appears on the window, followed
by a detailed description of what the option does and how it can be set.
6. Once you have set the options on the Report Style Settings window to the
desired settings, then press ENTER or click the OK button.
The Report Style Settings window will now close, and the new style will
appear in the Report Styles window. The new style will be automatically
highlighted, in case you want to work any further with it (i.e. select it, edit it,
etc.).
Using Smeadlink's Administrative Utilities II
313
To edit an existing style:
1. Click the style you want to edit.
The style will appear highlighted after you click it, to indicate that it is now
selected.
2. Click the Edit button at the bottom of the Report Styles window.
The Report Style Settings window will now appear as shown below. This
window contains all the options that define a report style. The options on the
Report Style Settings window will be set according to the style you selected
to edit.
Report Style Settings window
5. You can now edit any of the options on the Report Style Settings window.
For information about the different options on the Report Style Settings window, see Options on the Report Style Settings window later in this section.
Each option is listed there in the order it appears on the window, followed
by a detailed description of what the option does and how it can be set.
6. Once you have set the options on the Report Style Settings window to the
desired settings, then press ENTER or click the OK button.
The Report Style Settings window will now close, and the edited style will
appear in the Report Styles window. The edited style will be automatically
highlighted, in case you want to work any further with it (i.e. select it, edit it
again, etc.).
314
Chapter 16
To remove an existing style:
1. Click the style you want to remove.
The style will appear highlighted after you click it, to indicate that it is now
selected.
2. Click the Remove button at the bottom of the Report Styles window.
Note: The Remove button will not be available if the Default style is selected. This is because the Default style is created automatically for each
view, and it cannot be removed.
A Smeadlink window will now appear as shown below asking if you want to
remove the selected style.
Smeadlink window
3. Click the Yes button on the Smeadlink window, or press ENTER.
The selected style will now be permanently removed. Once a style has been
removed in Smeadlink, there is no way to bring it back.
Using Smeadlink's Administrative Utilities II
315
Options on the Report Style Settings Window
The Report Style Settings window contains all the options that define a report style. It appears when you click a style on the Report Styles window
and then click the Clone or Edit buttons.
• If you clicked Clone, then when the Report Style Settings window
opens, all of its options except Name and Description will be set just
like they are on the style you selected before clicking Clone.
• If you clicked Edit, then when the Report Style Settings window opens,
all of its options will be set just like they are on the style you selected
before clicking Edit.
The rest of this section explains each of the options on the Report Style
Settings window. The options are explained in the order they appear on the
window, from top to bottom and left to right.
Note: If you would like to see how a changed setting on the Report Style
Settings window will affect the printed report, then open Smeadlink's File
menu and click Print Preview...Formatted Report. The Print Preview window will now appear, with a preview of what a formatted report for the open
view would like with the current settings on the Report Generator windows.
Report Style Name
The Name option determines the name of the selected style, which is used to
identify the style in the Report Styles window. If you are creating a new
style (i.e. if you opened the Report Style Settings window by clicking the
Clone button on the Report Style window), then you can enter whatever
name you wish in the Name box. If you are editing an existing style (i.e. if
you opened the Report Style Settings window by clicking the Edit button on
the Report Styles window), then you will only be able to view the current
name in the Name box—you will not be able to modify it. This is to reduce
overhead if the open view is a child view in a multilevel report.
Description
The Description option determines the description of the selected style, which
is used along with the style's name to identify it in the Report Styles window. The name of each style that has been created for the open view will be
listed on the Report Styles window under the Style Name heading, and the
description of each style will be listed under the Description heading. Unlike the name, the description is editable if you are creating a new style or if
you are editing an existing one. You can enter any combination of characters in the Description box to create a description for the selected style.
316
Chapter 16
Left, Center and Right Heading Line 1
The three Heading Line 1 options specify the text that will appear on the first
line of the formatted report's header. The Left Heading Line 1 option specifies
the text that will start at the left side of the line, the Center Heading Line 1
option specifies the text that will start in the middle and the Right Heading
Line 1 option specifies the text that will start at the right side. Each Heading
Line 1 box can contain approximately 50 characters, but if you enter too many
characters in each box or if you select a large font size for the text later on,
then the three text strings will overlap.
Center Heading Line 2
The Center Heading Line 2 option is used with the three Heading Line 1
options to specify the text that will appear on the formatted report's header.
The Center Heading Line 2 option specifies the text that will appear in the
middle of the second line on the header. The Center Heading Line 2 box can
contain approximately 50 characters, but if you enter too many characters in
the box or if you select a large font size for the text later on, then all your text
may not be able to fit in the space available.
Left, Center and Right Footer Line
The three Footer Line options specify the text that will appear on the formatted report's footer, immediately beneath the footer's rule. The Left Footer
Line option specifies the text that will start at the left side of the footer, the
Center Footer Line option specifies the text that will start in the middle and
the Right Footer Line option specifies the text that will start at the right side.
Each Footer Line box can contain approximately 50 characters, but if you
enter too many characters in each box or if you select a large font size for the
text later on, then the three text strings will overlap.
Orientation
The Orientation option determines what orientation will be used to print the
formatted report. If you set the Orientation option to the Printer Default
setting, then the report will be printed with the current settings for the selected printer. If you would like to make sure the report is only printed in
portrait mode or landscape mode, then select the Portrait or Landscape setting. If you set the Orientation option to Portrait or Landscape, then that
setting will override the printer's setting if the two conflict with each other.
Using Smeadlink's Administrative Utilities II
317
Header Box Height
The Header Box Height option specifies the height of the main box in the
formatted report's header. Header Box Height is measured in twips, where 1
twip equals 1/1440 of an inch. There is no limit in the Header Box Height
option, so you could make the header box take up the entire page if you
wanted.
Shadow Thickness
The Shadow Thickness option specifies the thickness of the header shadow
in the formatted report. The header shadow is the shadow on the right and
bottom sides of the report's header box. Shadow Thickness is measured in
twips, where 1 twip equals 1/1440 of an inch.
Min Column Width
The Min Column Width option specifies the minimum width for columns in
the formatted report. Min Column Width is measured in twips, where 1 twip
equals 1/1440 of an inch. If any of the columns included in the report are
narrower than the Min Column Width setting, then the columns will be printed
on the report with the Min Column Width setting, not their actual widths.
Blank Line Spacing
The Blank Line Spacing option determines the number of blank lines used
to separate items in the formatted report. Blank lines can be placed in various places in a report, such as between a parent row and a child row. The
Blank Line Spacing option is measured in lines, so if you set it to 1 then one
blank line would be used to separate items in the report, if you set it to 2 then
two blank lines would be used to separate items in the report, etc.
Column Spacing
The Column Spacing option determines the space between columns in the
formatted report. Column Spacing is measured in twips, where 1 twip equals
1/1440 of an inch.
Line Thickness
The Line Thickness option specifies the height of all line objects in the formatted report, including the line around the header box, the line beneath
each column header, the line above the footer text, etc. Line Thickness is
measured in twips, where 1 twip equals 1/1440 of an inch.
318
Chapter 16
Max Lines and Fixed Lines
The Max Lines and Fixed Lines options are used along with the Max Lines
per Row option on the Column Properties window, to determine how much
information from cells in the report's columns will be printed on the report.
• If the Max Lines per Row settings for the report's columns are all less
than the Max Lines setting, then the highest Max Lines per Row setting will be used to print the columns' cells on the report. For instance,
if the Max Lines setting is 10 and the highest Max Lines per Row
setting is 5, then up to five lines of data will be printed from each cell
on the report. Cells containing more than five lines of data will have
their data truncated after five lines.
• If the Max Lines setting is smaller than the highest Max Lines per Row
setting for the columns in the report, then the Max Lines setting will be
used to print the column's cells. For instance, if the Max Lines setting
is 3 and the highest Max Lines per Row setting is 5, then up to three
lines of data will be printed from each cell on the report. Cells containing more than three lines of data will have their data truncated after
three lines.
• If the Fixed Lines option is enabled, then the current Max Lines setting
will be used to print the cells in the report's columns, regardless of the
Max Lines per Row setting for each column. In addition, the row height
will not vary dynamically sized according to the data they contain.
Instead, they will all contain the same number of lines as the current
Max Lines setting.
For instance, if the highest Max Lines per Row setting is 15 and the
Max Lines setting is 99, then enabling Fixed Lines will print 99 lines
of data for each cell in the report. If a cell does not contain 99 lines of
data, then the remaining lines will be blank. Fixed Lines is helpful
when you want all the rows in a report to be the same size.
Alternate Row Shading
The Alternate Row Shading option determines whether alternate rows in the
formatted report will be shaded. If you enable the Alternate Row Shading
option, then every other row in the report will be shaded with the current
Row Shading color. If you leave Alternate Row Shading disabled, then all
the rows in the report will have a white background instead of a shaded one.
Using Smeadlink's Administrative Utilities II
319
Report Centered
The Report Centered option allows you to center rows on a page if the rows
do not take up the entire horizontal space available. If the Report Centered
option is not enabled, then printed rows on the formatted report will be leftjustified. So if the rows do not take up all the horizontal space available on
the page, then the data on the page will be weighted towards the left side.
If you enable the Report Centered option, then all the rows in the report will
be centered. In addition, if the open view is set up as a child view in another
view's formatted report, then the rows in the parent view will be moved as
far left of center as they need to be for the child rows to be centered on the
report.
Item
The Item box is used with the Choose button and the style buttons to specify
the font, style and size of the various text items in a formatted report. For
instance, you can use the Item box, Choose button and style buttons to change
the size of the text in the Header 1 line, or to make the text in the footer line
bold. The Item box's role in this procedure is to select the text item you want
to modify. Once a text item is selected in the Item box, then you can use the
Choose button and the style buttons to modify the font, style and size of the
selected item.
To select a text item in the Item box:
• Click the down arrow at the right of the box. A dropdown will now
appear listing the different text items on the formatted report.
• Click the desired text item on the dropdown to select it. The dropdown
will now close, and the selected text item will appear in the Item box.
Style Buttons (B, /, U)
The Style buttons are used with the Item box to specify what style attributes
will be used to print the text items on the formatted. For instance, you could
use the Style buttons and the Item box to make the column headers on the
report print in bold, or to make the row text on the report print in italics.
To specify the style attributes for one of the text items in the report:
• Select the desired item in the Items box, as explained above.
• Click the desired style button (or buttons). The item in the Items box
will now be printed with the selected style attributes on the report.
320
Chapter 16
Choose
The Choose button is used with the Item box to specify the font, style and
size of the text items on the formatted report. For instance, you could use the
Choose button and the Item box to change the column headers on the report
from Times New Roman to Arial, or to make them a point larger in size.
Note: If you just want to change the style of a text item (i.e. whether it is
bold, italic, or underlined), then it is easier to use the Item box with the Style
buttons explained on the previous page.
To specify the font, style and size for one of the text items on the report:
• Select the desired item in the Item box, as explained in the Item section
on the previous page.
• Click the Choose button. A standard Windows Font window will now
appear as shown below, that you can use to specify the font, style and
size of the selected item in the Item box.
Font window
• When you are done specifying the attributes of the selected text item,
click the OK button on the Font window, or press ENTER. The Font
window will now close, and the attributes you selected will be applied
to the selected text item when the formatted report is printed.
Using Smeadlink's Administrative Utilities II
321
Text, Line, Header Shadow, Header Box Fill, Row Shading
The Text, Line, Header Shadow, Header Box Fill and Row Shading boxes
allow you to specify the colors of the various items on the formatted report.
The items each box refers to are listed in the table below.
Color Box
Refers To
Text
All the text on the formatted report. This
includes header text, body text and
footer text.
Line
All the lines on the formatted report,
including the line forming the border
of the header box, the line beneath each
column header, the line above the footer
text, etc.
Header Shadow
The shadow on the right and bottom
sides of the header box.
Header Box Fill
The background color of the header
box.
Row Shading
The color of every other row in the report, starting with the first row, then the
third row, etc. (This box is only applicable if the Alternate Row Shading option is enabled.)
To specify a color for items on the formatted report:
• Double-click the box of the desired items (see the table above for information about the items each box refers to).
A standard Windows Color window will now appear as shown on the
following page.
322
Chapter 16
Color window
• Use the Color window to select the desired color for the box's items.
For information about using the Color window to create and select a
color, see your Windows documentation.
• Click the OK button on the Color window or press ENTER. The Color
window will now close, and the color you selected will appear in the
box you opened the window from.
Left, Right, Top and Bottom
The Left, Right, Top and Bottom boxes allow you to specify margins for the
formatted report. These margins are used to print the header, footer, content
and partial-page images, but they are not used to print full-page images (for
information about setting up margins for full-page images, see Left Margin
and Right Margin in the section Using the Report Setup Window-Options
on the Report Setup Window earlier in this chapter). The Left, Right, Top
and Bottom margins are set in twips, where 1 twip is equal to 1/1440 of an
inch.
Directly Modifying a Smeadlink Database
17. Directly Modifying a Smeadlink
Database
Chapter contents
Introduction
Opening a Table
Executing a Script File
Executing a Single SQL Statement
Compacting and Repairing a Database
Demonstration and Template Databases
323
324
Chapter 17
Introduction
The previous chapter showed you how to use the administrative utilities in
Smeadlink. You learned how to open each administrative utility, and you
learned how to perform the tasks that each utility is intended for.
This chapter will show you how to use Smeadlink database utilities. As you
learned in chapter 1, there are two database utilities in Smeadlink: the Database Toolkit and the Compact and Repair Database Utility. These utilities
give you direct access to your Smeadlink database. Unlike the other
Smeadlink administrative utilities, the Database Toolkit and the Compact
and Repair Database Utility are not intended for normal setup and maintenance of your Smeadlink system. Instead, they are intended mainly as troubleshooting tools that can be used to repair damaged or corrupted components
in a Smeadlink database.
Database Toolkit is a program that gives you direct access to all the tables in
a Smeadlink database. It also allows you to modify a database by executing
SQL statements. The SQL statements can be either single statements entered directly into the Database Toolkit program, or multiple statements contained in a script file. The Compact and Repair Database Utility is a program
that allows you to compact and repair Smeadlink databases. It also allows
you to upgrade a database to a more current version of Microsoft Access,
and it allows you to automatically backup a database.
This chapter is divided into two main parts. The first part explains how to
use the Database Toolkit program, and the second part explains how to use
the Compact and Repair Database Utility.
Directly Modifying a Smeadlink Database
325
Opening a Table
Database Toolkit allows you to directly access system-level Smeadlink tables.
Once you have opened a table, you can then either modify the table's contents, or you can simply read through it and verify that it contains the appropriate information. This section will show you how to open a table in the
Database Toolkit program.
To open a table in the Database Toolkit program:
1. Open the View menu from the main menu bar, and then click the Tables
command. The Database Toolkit will now be in Tables mode, and it should
look similar to the example shown below.
Database Toolkit in Tables mode
2. Double-click the row of the table you would like to open.
The selected table will now open, and you can edit it just like you edit folders and subfolders in Smeadlink. The example below shows what an open
table looks like in the Database Toolkit program.
An open table in the Database Toolkit program
326
Chapter 17
Executing a Script File
There are two ways to execute SQL statements in the Database Toolkit program—by executing a script file or by executing a single SQL statement
entered directly into Database Toolkit. A script file is a text file that contains
a number of SQL statements. When you execute a script file, Database Toolkit
goes through the SQL statements in the file and automatically executes them
in the order them appear in the file. This section will show you how to execute
a script file in the Database Toolkit.
To execute a script file:
1. Open the View menu from the main menu bar, and select the Scripts
command. The Database Toolkit will now be in Scripts mode, and it should
look similar to the example below.
Database Toolkit program in Scripts mode
2. Open the File menu and select the Open Script File command.
The Open Script File window will now appear. The example on the following page shows what the Open Script File window looks like.
Directly Modifying a Smeadlink Database
327
Open Script File window
3. Select the desired script file in the Open Script File window. Smeadlink
script files have an extension of .xql.
4. Once you have selected the desired script file, press Enter or click the OK
button on the Open Script File window.
The Open Script File window will now close. The name of the selected
script file will appear in the lower left corner of the Database Toolkit program, and the Execute button will become available on the toolbar. The example below shows what the Database Toolkit program will look like after
you select a script file.
Execute button
Name of selected script file
5. Click the Execute button on the button bar or select the Execute command on the Go menu.
The selected script file will now be executed. Any changes that the statement makes to the database are permanent—there is no way to undo an SQL
statement.
328
Chapter 17
Executing a Single SQL Statement
The previous section in this chapter showed you how to execute a script file
in the Database Toolkit. In addition to executing script files, though, you
can also execute single SQL statements that you enter directly into the Database Toolkit program. This section will show you how to execute a single
SQL statement.
To execute a single SQL statement:
1. Open the View menu from the main menu bar, and select the Scripts
command. The Database Toolkit will now be in Scripts mode, and it should
look similar to the example below.
Database Toolkit program in Scripts mode
2. Type the desired SQL statement into the SQL Statement box.
3. Press Enter to execute the statement.
Directly Modifying a Smeadlink Database
329
Compacting and Repairing a Database
As its name implies, the main purpose of the Compact and Repair Database
Utility is to compact and repair Smeadlink databases. In Smeadlink, compacting and repairing a database is one procedure—it is no longer two separate procedures like it was in earlier versions of Smeadlink. Compacting a
database will free up any unused space that the database was taking up, and
repairing a database will fix any index problems caused by adding and removing items to the database over time.
While it is compacting and repairing a database, the Compact and Repair
Database Utility can also automatically create a backup of the database, and
it can upgrade the database to a more current version of Microsoft Access.
This section will show you how to compact and repair a Smeadlink database.
To compact and repair a database:
1. Open the Compact and Repair Database Utility.
As you learned in chapter 1, the Compact and Repair Database Utility is a
stand-alone program. By default, it is installed in the same directory that the
other Smeadlink files are installed to. To run the Compact and Repair Database Utility, you can either create a shortcut to it or you can use the Run
utility on the Windows Start menu. The example below shows what the
Compact and Repair Database Utility looks like.
Compact and Repair Database Utility
330
Chapter 17
2. Select the database that you want to compact and repair. There are several
ways to select a database. Each procedure is listed below.
• Type the entire path to the database in the Database Path box.
OR
• Click the down arrow at the right of the Database Path box to display a
list of recently-opened Smeadlink databases.
• Click the desired database in the list. The database will now appear in
the Database Path box.
OR
• Click the Browse button below the Database Path box. A standard
Windows Open window will now appear.
• Use the window to navigate to the desired database.
• Double-click the database to select it. The Open window will now
close, and the database will appear in the Database Path box.
3. If you want a backup of the database to be created before it is compacted
and repaired, make sure the Create Backup option is enabled. To enable the
Create Backup option:
• Open the File menu from the main menu bar.
• Click the Create Backup command on the File menu.
A check mark will appear at the left of the Create Backup command once it
has been enabled.
4. If you want the database to be updated to a newer version of Access
during the compact and repair process, select the desired Access version. To
select a version:
• Open the File menu from the main menu bar.
• Click the Convert to command on the File menu. A submenu will now
appear listing the three different Access versions you can convert to.
The example on the following page shows what the Convert to submenu looks like.
Directly Modifying a Smeadlink Database
331
Convert to submenu
• Click the desired command on the Convert to submenu. A check mark
will now appear at the left of the command to indicate that it has been
enabled.
5. Now click the Compact and Repair button at the bottom of the Compact
and Repair Database Utility, or click the Compact/Repair command on the File
menu.
A window will now appear stating that the selected database will have to be
exported to a temporary file. If the Create Backup option is enabled, the
window will display the name of the database, and the name of the backup
copy of the database that will be created. The example below shows what
the window looks like.
Compact and Repair window
6. Press the Enter key, or click the Yes button on the Compact and Repair
window.
The selected database will now be compacted and repaired. If the Create
Backup option is enabled, a backup of the database will be created with the
name you saw on the Compact and Repair window (the same name as the
original database, but with a .bak extension instead of a .mdb extension). If
the Convert to option is enabled, the database will also be converted to the
selected version of Access.
332
Chapter 17
Demonstration and Template Databases
Smeadlink comes with a demonstration database and a blank template database. Your Smeadlink system was most likely built from one of these databases and will be ready to go when installed. Therefore, you will most likely
not need these databases. Should you need to build a database from the
beginning, these are where you would start.
The demonstration database is a good place to start and see an example of
how Smeadlink databases are laid out. These databases are installed by
Setup into the Data directory. Their name will very depending on what version of Smeadlink you purchased. Refer to your Quick Start or Getting Started
Guide for information on these databases.
The blank template database, or Starter database, is included on your CD in
the Extra's directly. This database contains a couple of generic workgroups
and one folder. The database has very little data in it and provides a clean
slate to start building your database on.
There are two versions of the Starter database on your Smeadlink CD. The
Microsoft Access version is called Starter.mdb. This database can be copied
and used immediately. Remember, when copying files from a CD in Microsoft
Windows, Windows will mark the target file Read-Only. You will need to
remove the Read-Only attribute before working with the database. (Refer to
your Microsoft documentation for assistance with this) The Microsoft SQL
Server version is called Starter.bak This file is a Microsoft SQL Server 7.0
backup file and can be restored to your SQL Server (Version 7.0 or Version
2000 - both with appropriate service packs) for use (contact your SQL Database Administrator to perform this task).
Directly Modifying a Smeadlink Database
(This page intentionally left blank.)
333
Appendix A: Smeadlink System Requirements
333
Appendix A: Smeadlink System
Requirements
Minimum Hardware
Pentium II 266 MHz or greater
128 MB RAM
4x CD-ROM (Unless connected to network)
40 MB free disk space
256 colors at 800x600dpi
Recommended Hardware
Pentium II 450 MHz or greater
128 MB RAM
8x CD-ROM (Unless connected to network)
40MB free disk space
256 colors at 800x600dpi
Operating System
Windows 98 SE
Windows NT 4.0 Workstation (Service Pack 6A)
Windows 2000 Professional (Service Pack 1)
Windows XP
Servers
Windows NT 4.0 Server (Service Pack 6A)
Windows 2000 Server Edition (Service Pack 1)
Database
Access 97
Access 98
Access 2000
Microsoft SQL Server 7.0 (SP2) or SQL Server 2000 (SP1)
Microsoft Office Connectivity (for PC Files)
Microsoft Office 2000
Microsoft Office XP
334
Appendix B: Smeadlink User Counting
Appendix B: Smeadlink User
Counting
When you purchased your Smeadlink system, you purchased a Server license, and you purchased "Seat" licenses. Seat licenses, or Seats, are the
number of seats, or users, who can use Smeadlink concurrently (at the same
time). Smeadlink counts user logins and tracks how many people are using
the system at one time. If the number of users trying to use Smeadlink
exceeds the number of Seats your organization owns, the last user(s) trying
to log in will get the following message:
The user(s) trying to login should click Cancel and try again later after another user exits Smeadlink. Should your users frequently get this message,
this indicates that your organization needs additional seats. To purchase
additional seats, contact your authorized reseller.
Should your user's machine or operating system experience an error, causing
Smeadlink to shutdown prematurely, the user's "count" may not be subtracted from the concurrent usage count. As a result, when the user tries to
login again, they may get this message. There are two ways to fix this situation.
One is an automatic method. If the user wait 30 minutes, Smeadlink will detect
that the count is not active and remove it from the count. This will allow the
user to log in normally again without any further action. If it is critical that the
user log back in immediately, they can press the Details button and be presented with the screen on the following page.
Appendix B: Smeadlink User Counting
335
If the Purge button is available, then clicking Purge will remove any inactive
counts, allowing the user to log in normally. If it is not, the user or system
administrator can highlight the count line and press the DELETE key. The
user will be warned that they are deleting a row and can click on OK. After
removing the count record, they can click the Close button and continue
normally.
Warning: deleting other active user count records will force Smeadlink to
shut down that active user, without warning, in the near future. The user
will lose all unsaved work and will have to restart Smeadlink. You should
only delete a count record if you are sure that the user in question truly had
a problem. The preferred and safe method is to wait approximately 30
minutes and allow Smeadlink to automatically recover.