Escolar Documentos
Profissional Documentos
Cultura Documentos
Registering your CS Product Please complete the registration card at right. Registering your product makes you eligible to receive update and upgrade information, technical support, and a free subscription to ChemBioNews.Com, a publication for Scientists with Computers. www.cambridgesoft.com Visit our homepage for more information about CS products and services. Technical Support Warranty technical support available. For details please see:
www.cambridgesoft.com/ services/contact/
www.cambridgesoft.com/register/
USER INFORMATION
Name Title Firm Street City Country Tel Email Serial No. Purchase Date Fax State Zip
QUESTIONNAIRE
(OPTIONAL)
t Inventory t Other
1. Product you are registering (check one): t ChemOfce t ChemDraw t Chem3D t BioOffice t Chem &Bio Office Enterprise t The Merck Index t BioDraw t BioAssay
t ChemACX
t E-Notebook
2. System running CS software (check one): t Microsoft Windows t Apple Macintosh 3. Please check one that best describes you: t Commercial t Academic t Student 4. Your discipline: t Analytical Chem. t Physical Chem. t Proteomics t Inorganic Chem. t Organic Chem. t Genomics t Govt/Non Profit t Biochemistry t Pharmacology t Information
US 1 617 588-9300 FAX 1 617 5889390 WWW EU 00 800 875 20000 FAX +44 1223 464990 EMAIL MAIL 100 CambridgePark Drive Cambridge, MA 02140 USA
www.cambridgesoft.com info@cambridgesoft.com
Product Registration CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, MA 021409802 USA
Users Guide
: IS IT OK TO COPY MY COLLEAGUES SOFTWARE? NO, its not okay to copy your colleagues software. Software is protected by federal copyright law, which says that you can't make such additional copies without the permission of the copyright holder. By protecting the investment of computer software companies in software development, the copyright law serves the cause of promoting broad public availability of new, creative, and innovative products. These companies devote large portions of their earnings to the creation of new software products and they deserve a fair return on their investment. The creative teams who develop the softwareprogrammers, writers, graphic artists and othersalso deserve fair compensation for their efforts. Without the protection given by our copyright laws, they would be unable to produce the valuable programs that have become so important to our daily lives: educational software that teaches us much needed skills; business software that allows us to save time, effort and money; and entertainment and personal productivity software that enhances leisure time. Q: That makes sense, but what do I get out of purchasing my own software? A: When you purchase authorized copies of software programs, you receive user guides and tutorials, quick reference cards, the opportunity to purchase upgrades, and technical support from the software publishers. For most software programs, you can read about user benefits in the registration brochure or upgrade flyer in the product box. Q: What exactly does the law say about copying software? A: The law says that anyone who purchases a copy of software has the right to load that copy onto a single computer and to make another copy for archival purposes only or, in limited circumstances, for purposes only of maintenance or repair. It is illegal to use that software on more than one computer or to make or distribute copies of that software for any other purpose unless specific permission has been obtained from the copyright owner. If you pirate software, you may face not only a civil suit for damages and other relief, but criminal liability as well, including fines and jail terms of up to one year
Q: So I'm never allowed to copy software for any other reason? A: Thats correct. Other than copying the software you purchase onto a single computer and making another copy for archival purposes only or purposes only of maintenance or repair, the copyright law prohibits you from making additional copies of the software for any other reason unless you obtain the permission of the software company. Q: At my company, we pass disks around all the time. We all assume that this must be okay since it was the company that purchased the software in the first place. A: Many employees dont realize that corporations are bound by the copyright laws, just like everyone else. Such conduct exposes the company (and possibly the persons involved) to liability for copyright infringement. Consequently, more and more corporations concerned about their liability have written policies against such softlifting. Employees may face disciplinary action if they make extra copies of the companys software for use at home or on additional computers within the office. A good rule to remember is that there must be one authorized copy of a software product for every computer upon which it is run Q: Can I take a piece of software owned by my company and install it on my personal computer at home if instructed by my supervisor? A: A good rule of thumb to follow is one software package per computer, unless the terms of the license agreement allow for multiple use of the program. But some software publishers licenses allow for remote or home use of their software. If you travel or telecommute, you may be permitted to copy your software onto a second machine for use when you are not at your office computer. Check the license carefully to see if you are allowed to do this. Q: What should I do if become aware of a company that is not compliant with the copyright law or its software licenses? A: Cases of retail, corporate and Internet piracy or noncompliance with software licenses can be reported on the Internet at http://www.siia.net/piracy/report.asp or by calling the Anti-Piracy Hotline: (800) 388-7478.
Q: Do the same rules apply to bulletin boards and user groups? I always thought that the reason they got together was to share software. A: Yes. Bulletin boards and user groups are bound by the copyright law just as individuals and corporations. However, to the extent they offer shareware or public domain software, this is a perfectly acceptable practice. Similarly, some software companies offer bulletin boards and user groups special demonstration versions of their products, which in some instances may be copied. In any event, it is the responsibility of the bulletin board operator or user group to respect copyright law and to ensure that it is not used as a vehicle for unauthorized copying or distribution. Q: I'll bet most of the people who copy software don't even know that they're breaking the law. A: Because the software industry is relatively new, and because copying software is so easy, many people are either unaware of the laws governing software use or choose to ignore them. It is the responsibility of each and every software user to understand and adhere to copyright law. Ignorance of the law is no excuse. If you are part of an organization, see what you an do to initiate a policy statement that everyone respects. Also, suggest that your management consider conducting a software audit. Finally, as an individual, help spread the word that users should be software legal. Q: What are the penalties for copyright infringement? A: The Copyright Act allows a copyright owner to recover monetary damages measured either by: (1) its actual damages plus any additional profits of the infringer attributable to the infringement, or (2) statutory damages, of up to $150,000 for each copyrighted work infringed. The copyright owner also has the right to permanently enjoin an infringer from engaging in further infringing activities and may be awarded costs and attorneys fees. The law also permits destruction or other reasonable disposition of all infringing copies and devices by which infringing copies have been made or used in violation of the copyright owners exclusive rights. In cases of willful infringement, criminal penalties may also be assessed against the infringer.
SIIA also offers a number of other materials designed to help you comply with the Federal Copyright Law. These materials include: "It's Just Not Worth the Risk" video. This 12minute video, available $10, has helped over 20,000 organizations dramatize to their employees the implications and consequences of software piracy. Dont Copy that Floppy video This 9 minute rap video, available for $10, is designed to educate students on the ethical use of software.
Other education materials including, Software Use and the Law, a brochure detailing the copyright law and how software should be used by educational institutions, corporations and individuals; and several posters to help emphasize the message that unauthorized copying of software is illegal. To order any of these materials, please send your request to: SIIA Anti-Piracy Materials Software & Information Industry Association 1090 Vermont Ave, Sixth Floor, Washington, D.C. 20005 (202) 289-7442 We urge you to make as many copies as you would like in order to help us spread the word that unauthorized copying of software is illegal.
M an ua ls
Dr aw in g
Ch em
Bi Ch oD St em an ra & da w Bi rd o
&
Fin de r
Ch em
&
Ch Bi em o EN O & ot ffi eb Bi o ce oo 3D k
&
Ch
Contents
About the Manual . . . . . . . . . . . . . . . . . . . . 1
Manual Organization . . . . . . . . . . . . . . . . . . . . . . . 1 Helpful CambridgeSoft Links . . . . . . . . . . . . . . . . 1 Moving a Protocol or Project . . . . . . . . . . . . . .20 Duplicating a Protocol . . . . . . . . . . . . . . . . . . . .20 Viewing a Protocols Properties (Renaming) . . .20 Protocol Data and Definitions . . . . . . . . . . . . . .21 Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Protocol Data . . . . . . . . . . . . . . . . . . . . . . . . . .23 Protocol Definitions . . . . . . . . . . . . . . . . . . . . .26 Designing a New Protocol . . . . . . . . . . . . . . . . . .29 Defining Tables and Fields . . . . . . . . . . . . . . . .30 Expose Table in BioSAR Browser . . . . . . . . . . .34 Assigning a Calculation to a Field . . . . . . . . . . .34 Summary Tables . . . . . . . . . . . . . . . . . . . . . . . .42 Defining Security . . . . . . . . . . . . . . . . . . . . . . . .43 Importing and Viewing Data . . . . . . . . . . . . . . . .43 File Import Templates . . . . . . . . . . . . . . . . . . . .43 Importing Data . . . . . . . . . . . . . . . . . . . . . . . . .47 Searching for and Viewing Data in Tables . . . . .48 Validating Protocol Data . . . . . . . . . . . . . . . . . .48 Data Manipulation and Curve Fitting . . . . . . . . .49 Plotting Data using a Graph Template . . . . . . . .50 Fitting Data to a Curve . . . . . . . . . . . . . . . . . . .51 Viewing the Plotted Data . . . . . . . . . . . . . . . . . .52 Invalidating Data Points . . . . . . . . . . . . . . . . . .52 Graphing Options . . . . . . . . . . . . . . . . . . . . . . .53 Compound Lists . . . . . . . . . . . . . . . . . . . . . . . . . . .54 Manipulating Compound Lists . . . . . . . . . . . . . .55 Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55 Editing the settings tables . . . . . . . . . . . . . . . . . .55 Adding an entry . . . . . . . . . . . . . . . . . . . . . . . . .55 Deleting an entry . . . . . . . . . . . . . . . . . . . . . . . .55 Canceling/Discarding Changes . . . . . . . . . . . . .56 Plate Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 Defining a Plate Format . . . . . . . . . . . . . . . . . .56 Well Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . .56 Protocol Picklist . . . . . . . . . . . . . . . . . . . . . . . . . .57 Adding a Picklist to the Picklist Table . . . . . . . .57 Adding Picklist Options . . . . . . . . . . . . . . . . . . .57 Using a Picklist . . . . . . . . . . . . . . . . . . . . . . . . .57 Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58 Managing Users . . . . . . . . . . . . . . . . . . . . . . . . . .58 Managing Groups . . . . . . . . . . . . . . . . . . . . . . . . .59 Creating New Groups . . . . . . . . . . . . . . . . . . . .59 Adding a User to a Group . . . . . . . . . . . . . . . . .59
Contents
Delete a Profile . . . . . . . . . . . . . . . . . . . . . . . . . 84 Ordering Fields and Changing Label Sizes in Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Manage Users and Roles. . . . . . . . . . . . . . . . . . . . 85
Administrator
Inventory Desktop/Workgroup . . . . . . . . . 91
Whats New in CS Inventory 10? . . . . . . . . . . . . 91 Login and Logout . . . . . . . . . . . . . . . . . . . . . . . . 91
The User Interface. . . . . . . . . . . . . . . . . . . . . . . . . 91 Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Managing Locations . . . . . . . . . . . . . . . . . . . . . . 93 Creating a New Location . . . . . . . . . . . . . . . . . 93 Editing a Location . . . . . . . . . . . . . . . . . . . . . . 94 Moving a Location . . . . . . . . . . . . . . . . . . . . . . 94 Deleting a Location . . . . . . . . . . . . . . . . . . . . . 94 Refreshing the Location Tree . . . . . . . . . . . . . . 94 Managing Substances . . . . . . . . . . . . . . . . . . . . . 95 Creating a New Substance . . . . . . . . . . . . . . . . 95 Material Safety Data Sheets . . . . . . . . . . . . . . . . 96 Using ACX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Mixtures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 Conflict Resolution . . . . . . . . . . . . . . . . . . . . . . 97 Editing a Substance . . . . . . . . . . . . . . . . . . . . . 98 Managing Containers. . . . . . . . . . . . . . . . . . . . . . 98 Editing a Container . . . . . . . . . . . . . . . . . . . . . . 99 Moving a Container . . . . . . . . . . . . . . . . . . . . . 99 Check-in/out, Changing Quantities, and Other Shortcuts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99 Multi Select . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 Managing EHS Data . . . . . . . . . . . . . . . . . . . . . 100 Searching Inventory. . . . . . . . . . . . . . . . . . . . . . . 101 Searching for Containers . . . . . . . . . . . . . . . . . . 101 Advanced Search . . . . . . . . . . . . . . . . . . . . . . 102 Substructure Search . . . . . . . . . . . . . . . . . . . . 102 Searching for Substances. . . . . . . . . . . . . . . . . . 103 Printing Labels and Reports . . . . . . . . . . . . . . . . 104 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 Inventory Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Managing Users and Roles . . . . . . . . . . . . . . . . 108 Managing Roles . . . . . . . . . . . . . . . . . . . . . . . 108 Managing Users . . . . . . . . . . . . . . . . . . . . . . . 109
Contents
CambridgeSoft
Managing the Container list display . . . . . . . . . 111 Backup/Restore Database . . . . . . . . . . . . . . . . 111 Audit Trail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Printing an Audit Report . . . . . . . . . . . . . . . . 113
Change Password . . . . . . . . . . . . . . . . . . . . . .153 Manage Users . . . . . . . . . . . . . . . . . . . . . . . . .153 Manager Roles . . . . . . . . . . . . . . . . . . . . . . . . .153 Manage Container Requests . . . . . . . . . . . . . . .153 Manage Sample Requests . . . . . . . . . . . . . . . . .154 Manage Orders . . . . . . . . . . . . . . . . . . . . . . . .157 Receive an Order . . . . . . . . . . . . . . . . . . . . . . .158 Manage Approvals . . . . . . . . . . . . . . . . . . . . . .158 Manage Tables . . . . . . . . . . . . . . . . . . . . . . . . .159 Analyze Audit Trail . . . . . . . . . . . . . . . . . . . . .159 Create Plates from Excel . . . . . . . . . . . . . . . . .161 Create Plates from Text File . . . . . . . . . . . . . .161 Custom Reports . . . . . . . . . . . . . . . . . . . . . . .161
Searching and Viewing Records in the Temporary Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167 Registering Records in the Temporary Table . .168
Editing Records in the Temporary Table . . . . .168 Deleting Records in the Temporary Table . . . .168 Registering a Record. . . . . . . . . . . . . . . . . . . . . .169 Adding Identifier Information to Records . . . .170 Adding Analytics Data to a Record . . . . . . . . . .171 Query and Reporting . . . . . . . . . . . . . . . . . . . . . .171 Searching for Registered Compounds . . . . . . . .171 Analytics Spreadsheets . . . . . . . . . . . . . . . . . . . .172 Administration . . . . . . . . . . . . . . . . . . . . . . . . . . .173 Managing Tables . . . . . . . . . . . . . . . . . . . . . . . . .173 Defining Projects . . . . . . . . . . . . . . . . . . . . . . .173 Defining Sequences . . . . . . . . . . . . . . . . . . . . .174 Defining Structure Comments . . . . . . . . . . . . .175 Defining Registration Enterprise People . . . . .176 Defining Salts . . . . . . . . . . . . . . . . . . . . . . . . .177 Defining Solvates . . . . . . . . . . . . . . . . . . . . . . .178 Managing Users and Roles . . . . . . . . . . . . . . . . .179 Defining New Experiments . . . . . . . . . . . . . . . .179 Managing Analytics Data . . . . . . . . . . . . . . . . . .179 Defining Result Type . . . . . . . . . . . . . . . . . . . .180 Defining Experiment Type . . . . . . . . . . . . . . .180 Defining Parameter Type . . . . . . . . . . . . . . . . .181 Managing Workgroups . . . . . . . . . . . . . . . . . . . .182
Contents
Importing SDFiles . . . . . . . . . . . . . . . . . . . . . . . .182 Steps to Import a SDFile . . . . . . . . . . . . . . . . . .182 Choosing Input and Output Databases. . . . . . .182
Matching Fields in the Input and Output Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183 View Matches and Import . . . . . . . . . . . . . . . . .184
Optional Features . . . . . . . . . . . . . . . . . . . . . . . . .185 Row Level Security (RLS) . . . . . . . . . . . . . . . . .185 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185 The User Interface . . . . . . . . . . . . . . . . . . . . . .185 How are Projects linked to People . . . . . . . . . .185 The Unspecified Project . . . . . . . . . . . . . . . . .185 Duplicate Checking . . . . . . . . . . . . . . . . . . . . .186 Activating RLS . . . . . . . . . . . . . . . . . . . . . . . .186 Salt and Solvate Recognition . . . . . . . . . . . . . . .186 Customizable Fields . . . . . . . . . . . . . . . . . . . . . .186 Choosing Preferences. . . . . . . . . . . . . . . . . . . . . .187 Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187 Logging Off. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
Viewing Results in Form View . . . . . . . . . . . . 203 Browsing Other Records . . . . . . . . . . . . . . . . 204 Viewing All Records . . . . . . . . . . . . . . . . . . . . 204 Marking and Unmarking Records . . . . . . . . . . 205 Manipulating Queries . . . . . . . . . . . . . . . . . . . . 205 Restoring Queries . . . . . . . . . . . . . . . . . . . . . . 205 Saving Queries . . . . . . . . . . . . . . . . . . . . . . . . 206 Managing Queries . . . . . . . . . . . . . . . . . . . . . . 207 Manipulating Hit Lists. . . . . . . . . . . . . . . . . . . . 208 Restoring Hit Lists . . . . . . . . . . . . . . . . . . . . . 208 Saving Hit Lists . . . . . . . . . . . . . . . . . . . . . . . 208 Managing Hit Lists . . . . . . . . . . . . . . . . . . . . . 209 Refining Search Results . . . . . . . . . . . . . . . . . . . 210 Refining Over Current Records Found . . . . . . 210 Undoing a Refined Search . . . . . . . . . . . . . . . 210 Exporting Search Results . . . . . . . . . . . . . . . . . 210 Histories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211 Setting Your Display and Search Preferences . . 211 Server Information. . . . . . . . . . . . . . . . . . . . . . . . 213 Logging Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Administrator
Accessing a ChemOffice Enterprise Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194 The Query Input Form User Interface . . . . . . .195
The Navigation Toolbar . . . . . . . . . . . . . . . . .195 Search Input Form . . . . . . . . . . . . . . . . . . . . .197 Performing a Simple Search . . . . . . . . . . . . . . . .197 Searching by Different Query Methods . . . . . .198 Searching With Text . . . . . . . . . . . . . . . . . . . .198 Searching With Structures . . . . . . . . . . . . . . . .199 Searching With Molecular Formulas . . . . . . . .201 Searching With Numerical Ranges . . . . . . . . . .202 Combination Searching . . . . . . . . . . . . . . . . . .202 Search Results . . . . . . . . . . . . . . . . . . . . . . . . . . . .203 Viewing Search Results . . . . . . . . . . . . . . . . . . .203 Viewing Results in List View . . . . . . . . . . . . . .203
Contents
CambridgeSoft
Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . 232 Checking for the Presence of the Cartridge . . . 232 Checking the Version of the Cartridge . . . . . . . 232 Checking for fields indexed by the cartridge . . 232 What to do if Creating an Index Fails . . . . . . . 233 What to do if a Client Program Fails . . . . . . . . 233 Setup Problems . . . . . . . . . . . . . . . . . . . . . . . . . 234 ORA-28575 unable to open RPC connection to external procedure agent . . . . . . . . . . . . . . . . . . . . . . 234 ORA-06520 PL/SQL: Error loading external library. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Using ADO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236 Example of passing large queries . . . . . . . . . . . 237 Custom Screening . . . . . . . . . . . . . . . . . . . . . . . . 237 Optimizing client programs for version 9 . . . . . 238 Bulk Loading . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Data Structures . . . . . . . . . . . . . . . . . . . . . . . . . . 240 Schema Overview . . . . . . . . . . . . . . . . . . . . . . . 240 Tables Related to an Index . . . . . . . . . . . . . . . . 240 The sch_ix Table . . . . . . . . . . . . . . . . . . . . . . 240 The sch_ix_NR Table . . . . . . . . . . . . . . . . . . . 241 The sch_ix_NC Table . . . . . . . . . . . . . . . . . . . 242 The sch_ix_NX Table . . . . . . . . . . . . . . . . . . 242 The sch_ix_SR, sch_ix_SC, sch_ix_SX Tables 242 The sch_ix_FR, sch_ix_FC, sch_ix_FX Tables 242 The sch_ix_KR, sch_ix_KC, sch_ix_KX Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242 The sch_ix_E Table . . . . . . . . . . . . . . . . . . . . 242 The sch_ix_3 Table . . . . . . . . . . . . . . . . . . . . 242 The sch_ix_O Table . . . . . . . . . . . . . . . . . . . . 242 Administrative Tables . . . . . . . . . . . . . . . . . . . . 243 ALL_CSC_INDEXES Table . . . . . . . . . . . . . 243 CUSTOM_SCREENS Table . . . . . . . . . . . . . 243 GLOBALS Table . . . . . . . . . . . . . . . . . . . . . . 243 Data stored outside of Oracle. . . . . . . . . . . . . . 244 The CsCartridgeData file . . . . . . . . . . . . . . . . 245 Program files . . . . . . . . . . . . . . . . . . . . . . . . . 245
Subscriptions and ChemOffice Enterprise Based Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 CD Based Databases . . . . . . . . . . . . . . . . . . . . . 248
Contents
Using ChemACX with ChemOffice Enterprise .277 Opening ChemACX . . . . . . . . . . . . . . . . . . . . . .278 Searching ChemACX Catalogs . . . . . . . . . . . . .278 Searching Without the Plug-in . . . . . . . . . . . . .279 Creating and Editing A List of Favorite Vendors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279 Viewing Search Results . . . . . . . . . . . . . . . . . . .279 Viewing Search Results in List View . . . . . . . .280 Viewing Search Results in Details View . . . . . .281 Accessing MSDX Data . . . . . . . . . . . . . . . . . .282 Using the Shopping Cart . . . . . . . . . . . . . . . . . .283 Viewing Your Shopping Cart . . . . . . . . . . . . . .283 Removing Items from Your Shopping Cart . . .283 Ordering The Chemicals in the ChemACX Shopping Cart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283 Registering and Creating Inventory Containers 284 Registering Products in Registration Enterprise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284 Creating Inventory Containers in Inventory for Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285 Saving Hitlists and Exporting SD Files . . . . . . .286 Logging Off . . . . . . . . . . . . . . . . . . . . . . . . . . . .286 Using the ChemACX Ultra DVD-ROM . . . . . . .286 What If My Favorite Supplier Isnt Listed Here?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287
Using ChemSynth on CD-ROM. . . . . . . . . . . . . 301 Using ChemSynth Online or with ChemOffice Enterprise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301 Searching ChemSynth . . . . . . . . . . . . . . . . . . . . 301
Administrator
Contents
CambridgeSoft
Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Recalculate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Save Compound List . . . . . . . . . . . . . . . . . . . . . 321 Select All . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321 Show Coloring . . . . . . . . . . . . . . . . . . . . . . . . . . 322 Show Only Valid Data. . . . . . . . . . . . . . . . . . . . 322
Browsing a Database . . . . . . . . . . . . . . . . . . . . . .328 The Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . .328 The Data Table . . . . . . . . . . . . . . . . . . . . . . . . . .329 Closing a Form . . . . . . . . . . . . . . . . . . . . . . . . . .330 Performing a Text Search. . . . . . . . . . . . . . . . . . .331 Searching by Formula . . . . . . . . . . . . . . . . . . . . .331 Searching by name . . . . . . . . . . . . . . . . . . . . . . .332 Searching by Molecular Weight . . . . . . . . . . . . .332 Performing a Structure Search . . . . . . . . . . . . . .332 Using the ChemDraw ActiveX Control . . . . . .332 Searching for the Structure in ChemFinder . . .334 Performing a Combined Search . . . . . . . . . . . . .336
Appendix C: BioAssay Plate Block Data Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323 Appendix D: Oracle Cartridge Dependencies by Operating System . . . . . . . . . . . . . . . 325 Appendix E: Scientific Databases First Search Tutorial . . . . . . . . . . . . . . . . . . . 327
Opening a Form in ChemFinder . . . . . . . . . . . 327 Switching Between Open Documents . . . . . . . 327
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . .i
Contents
Administrator
Contents CambridgeSoft
Active X control http://sdk.cambridgesoft.com/ Purchasing CambridgeSoft products and chemicals ChemOffice Enterprise updated help files http://store.cambridgesoft.com/
Manual Organization
The ChemOffice Enterprise Workgroup & Databases Manual is divided into 7 sections:
Enterprise and Workgroup Solutions Section I: Knowledge Management Section II: Biological Informatics Section III: Chemical Informatics Section IV: ChemOffice Enterprise Scientific Databases
Administrator
2About the Manual CambridgeSoft
ChemOffice Workgroup Solutions are designed for organizations who want to organize and search over their inventory, purchase reagents, as well as manipulate and store chemical and biological data. ChemOffice Workgroup is compatible with SQL Server and is accessed through a client side application. Workgroup Offerings include:
E-Notebook Workgroup BioAssay Workgroup Inventory Workgroup
Installation
Installation instructions and requirements are contained in the Read Me document for each application. Software Requirements and installation instructions differ between applications.
Chem & Bio Office Enterprise, Workgroup & Databases 2006 ChemOffice Enterprise and Workgroup Solutions 3 Enterprise and Workgroup Solutions
Administrator
4ChemOffice Enterprise and Workgroup Solutions CambridgeSoft Installation
Research organizations thrive when information is easily captured, well organized, and available to those who need it. E-Notebook Enterprise streamlines daily record keeping with rigorous security and efficient archiving, and facilitates searches by text and structure. DocManager Enterprise organizes procedures and reports for archiving and chemically-intelligent data mining. Discovery LIMS tracks laboratory requests, and 21CFR11 Compliance implements an organizations regulatory compliance processes.
Administrator
6 CambridgeSoft
E-Notebook Enterprise 7
Administrator
8E-Notebook Enterprise CambridgeSoft
chemical documents in .doc, .txt, .ppt, .xls, and .pdf formats for your entire organization, over the web. Search .doc, .txt, .ppt, .xls, and .pdf* documents in the repository. A Boolean search can be performed over the web by chemical structure or text. * PDF documents can not be searched by structure. Furthermore, full text searching is only available for PDF documents on systems with: Oracle 9i OR Oracle 8i and PDF documents are version 4 and below Add, or submit, documents to the system over the web. The document submitted is securely stored in a database, indexed by both structure and text for DocManager Enterprise users to search and view. Remove documents that are no longer shared. Manage users as the system administrator.
Hostname is the name of the server that the DocManager Enterprise application is installed on. To obtain this name, please contact your system administrator. The Log In window appears in your browser. 2. Enter a valid username and password. 3. Click Login. The Global login page appears. DocManager Enterprise is in the bottom right.
Enterprise
.
Logging In
To log in to DocManager Enterprise: 1. Enter http://hostname into your web browser.
Submitting Documents
Documents can be submitted through the DocManager Enterprise web interface. To submit a document: 1. From the Main Menu, click Submit Documents. The Submit Document page appears.
Administrator
Batch Submission
2. In the Document box, use the Browse button to
find the document you would like to submit. If you would like to view the document from within your web browser, click Add Document Details. The document will appear in the browser window. If you would like to submit the document, click Submit Now The submit documents page appears with a message that the document was submitted successfully.
The Batch Submission tool allows application administrators to schedule the submission of documents in a specified directory. Because batch submission often decreases the performance of the server, it is recommended that administrators schedule the submission during a low use period.
NOTE: Only one scheduled batch submission is recognized at once. In other words, if a new batch submission is scheduled, it will overwrite the previous submission schedule.
To schedule a batch submission: 1. Click Batch Submission from the DocManager Enterprise homepage. or click Batch Submission from the Global Login page
10DocManager Enterprise
documents to be submitted. 3. Select a checkbox pertaining to a time of day when the submission should take place. 4. Uncheck the Index automatically checkbox if you want to shut off indexing while uploading the documents.
NOTE: Turning full-text index off will significantly improve the loading performance. If you turn it off, you must turn it back on after the loading finishes, otherwise the documents will not be text searchable.
5. Click OK.
Recent Activities
The Recent Activities tool allows administrators to view and sort recent document submissions. To view recent activities performed by the user: 1. Click Recent Activities. The Recent activities page appears.
For more information about search features, such as Retrieve All and New Query, see the ChemOffice Enterprise Users Guide.
Performing a Search
To search documents for specific information: 1. From the Main Menu page, click Search Documents. The Search Documents page appears.
Administrator
The search results form displays all documents retrieved as a result of a search in table format. The table includes two columns: Document information and Download Options.
To view one of the files in the Results form
text textbox allows full text searching. Form more information about full text searching, please see DocManager Enterprise Free Text Searching on page 311. For more information about drawing structures, please see Drawing Chemical Structures in the ChemDraw Users Manual. 3. Click Search.
inside your web browser, click on the title of the appropriate document. To save a file to disk in order to view later, click on the download button to the right of the documents information.
12DocManager Enterprise
Finding structural determinants of biological activity requires processing masses of biological assay data. Scientists use BioAssay and BioSAR Enterprise to set up biological models and visualize information, to generate spreadsheets correlating structure and activity, as well as to search by chemical structure.
13
Administrator
14 CambridgeSoft
Chapter 3: BioAssay
Overview
BioAssay helps research biologists store, analyze, and report on biological protocol data. It is optimized for high-throughput screening data, but it can also be effectively used for low-throughput and in vivo studies. The system allows the user to define protocols as sets of tables holding raw data, summary data and aggregate data. In addition to storing data, the system also allows for curve fitting and data manipulation. The Login window appears.
valid BioAssay username and password. For more information about valid usernames and passwords, please see your system administrator. 3. Select a connection type:
Direct Connection - BioAssay clients connect directly to Oracle via Oracle client software. Best for high-speed LANs.
Logging in to BioAssay
To start the BioAssay client application: 1. Go to START > Programs > BioAssay > BioAssay OR Double-click the desktop icon
.
Oracle Service The Oracle service where the bioassayhts schema is installed Schema - The name of the BioAssay schema by default bioassayhts
BioAssay 15 Overview
HTTP server to communicate with Oracle. Fastest on lower-speed WANs, or on machines where Oracle client software is unavailable
Server - the name of the server where the BioAssay server is installed
If a valid username and password are entered for the appropriate server, BioAssay opens with the Start Page visible:
Options available from the BioAssay application could differ from user to user depending on permissions. If you do not see something you feel you should have access to, please see your system administrator.
Terminology
HTS -High Throughput Screening - testing
depth screening of fewer compounds. Protocol - In BioAssay, a collection of database fields and calculations that hold data about a given biological experiment. Plate - A means of holding multiple samples in an easily transportable unit. Plate Format - The layout of the wells on a plate. Well Format - The type of contents in a well compound, control, empty, etc. Aggregate - A calculation that summarizes multiple results in one number, e.g. Average, Maximum, Minimum, Standard Deviation, Curve Fits. Grouping - Used in conjunction with aggregate calculations to summarize data. Primary Protocol Tables - The collection of tables that are automatically filled and calculated. Summary Tables - Summary tables provide alternate ways of summarizing primary data. File Import Template - A template which indicates how to take data from a file or files and place it into a HTS protocol Graph Template - Information that tells HTS how to place data in a 2-D graph. Browse Table - A table allowing the user to interact with data and perform Quality Control tasks. Search Table - A table allowing the user to search all protocol data. % Inhibition - A basic measure of potency normalizing raw data to a positive and negative control. IC50,EC50, LD50 - Measures of compound potency - the concentration in a protocol at which a compound is effective at the 50% level.
Administrator
16BioAssay
CambridgeSoft Terminology
confidence in data. Generally, data that has less confidence assigned is less visible. Curve Fitting - Using an algorithm to determine the line that best fits a set of points. The parameters of this equation can then be used in further calculations. Direct Connection - BioAssay clients connect directly to Oracle via Oracle client software. Best for high-speed LANs. Proxy Connection - BioAssay clients use a HTTP server to communicate with Oracle. Fastest on lower-speed WANs, or on machines where Oracle client software is unavailable. Picklist - A defined list of items a user may pick from in a protocol.
Filter, and Edit, depending upon the table displayed. The Actions button in the Content Frame makes data specific tasks available to the user.
Navigation
The user interface for BioAssay is split into two major frames: The Navigator and the Content Frame.
2. Click with the mouse and hold it down while
dragging the mouse. The column will resize as you drag the mouse. Release the mouse when the column is the appropriate size.
In some cases (e.g. protocol data tables) the columns can also be moved within the table. To move a column within a table:
1. Move the mouse over the column header to be
The Navigator (found in the left frame) acts much like a tree in Microsoft Explorer. Protocols and plates are organized into folders in the tree. Expand folders in the tree to find what you are looking for. The Content Frame displays the contents of the open folder in the Data Browser. The content frame can be used in 3 different modes: Browse,
moved and click. 2. Hold the mouse button down and drag the column to its new location.
NOTE: A column line appears when you have
BioAssay 17 Navigation
Administrator
Sorting Data
Data in any table can be sorted by any of the columns in the table. If you sort the data, the data will be sorted accordingly the next time the table is opened. To sort the data by a particular column, click on the column header.
Sorted by Barcode Sorted by GroupID
Criteria can be entered using drop down lists, if applicable, ranges for numerical columns, or the appropriate characters for text columns. 3. Click Apply. The data is sorted accordingly.
Tips
Searching in BioAssay is similar to searching in other ChemOffice Enterprise products: 1. Access the search form. 2. Enter search criteria. 3. Search results, made up of records matching the entered criteria, are returned. Numeric search criteria can be entered as a range using > (greater then), < (less then), and - (between one value and the next). The following table shows some examples of range searching:
Entered search criteria Really means...
To invert the sort, that is filter the data in descending order instead of ascending order, click the column header a second time.
Filtering Data
When the Filter button is available in the toolbar of the Content Frame, the table is available in Filter Mode. In Filter Mode, you are able to filter the data by any criterion in the table. When data is filtered, only the data matching the entered criteria is displayed. To filter the data in a table:
1. Click Filter.
3-11
Between 3 and 11 (not including 3 or 11) Greater then 100 (not including 100)
>100
18BioAssay
CambridgeSoft Navigation
Really means...
Table View
<200
Form View
Getting Help
The BioAssay Users Guide, provided in a Windows Help File (a compiled HTML format), is available from the Content Frame by clicking Help.
Printing
Any table in BioAssay can be printed. To print a table:
1. Click Print.
Protocols
The BioAssay application makes it possible for users to store and analyze assay data. The interface to the data is similar to that of Microsoft Access. Fields contained in tables are defined as simple text, a piece of numerical data, a calculation, or an attachment such as a picture or document. After the table structure is defined, data can be imported into data tables from files through the use of a user defined file import template.
The Print Dialog appears. 2. Select your printing options and click OK.
BioAssay 19 Protocols
Administrator
Right-clicking on the projects and/or folders in
the Navigator exposes a menu which allows users to create new projects/folders/protocols, rename the project/folder, or remove a project/folder. Right-clicking on a protocol in the Navigator exposes a menu which allows users to create new, or remove a protocol as well as: Move the Protocol Duplicate a Protocol View Protocol Properties (Renaming) The unclassified folder cannot be deleted because: When a project is deleted, the contained Protocols are moved to the Unclassified folder When a duplicate protocol is created, that duplicated protocol is placed, by default, in the Unclassified folder.
Duplicating a Protocol
To duplicate a protocol:
1. Right-click on the protocol to duplicate. 2. Select Duplicate Protocol.
A copy of the selected protocol is added to the Unclassified project. Users can rename and/or move the protocol as desired.
20BioAssay
CambridgeSoft Protocols
This tool allows users to create plates for use within BioAssay. Plate templates are used to create plates. To create a plate:
1. Select Create Plates from a Template.
The plates dialog appears. 2. Select the template to use when creating your plates in the Plate Templates box. 3. Click Add. 4. Change the name of the plates to be added if desired.
NOTE: By default, the plates are given the same name as the templates they originate from. To change the names, edit the name in the second column of the middle table.
5. Enter other data that pertains to the batch of
This tool is directly linked to Inventory Enterprise. It creates and edits plate templates according to input parameters. Plates can be created from these templates.
Tasks
The tasks tab gives users access to tools related to the selected protocol.
Import a Data File
This task allows users to import data into the protocol. See Importing Data on page 47 for more information.
The Manage Plate Template tool allows a user to map a compound ID to well formats specified in a given plate format. In other words, if a plate template contains well formats Compound 1, Compound 2, Compound 3, and Compound 4, you can map a particular compound ID (e.g. AB110293) to each well format (e.g. Compound 1). For more information about creating Compound Lists, seeCompound Lists on page 54.
BioAssay 21 Protocols
NOTE: This link is only visible when the opened protocol is a plated based protocol, not linked to Inventory.
The Create Plates dialog appears. 2. Click the Manage Templates button. The Manage Plate Templates dialog appears.
Replace Current List - replace the current list with the new list Append to Current List - add the select list to the end of the current list. d. Click OK. By adding compound IDs manually a. Enter a compound ID in the Available Compounds textbox. b. Click Add.
Administrator
Compound List to the plate view, and the blocks of similarly-formatted wells will be highlighted. Drop a compound, and it will be assigned to those wells.
5. Select a plate format in the Based on: listbox. 6. Add compound IDs to the Available
Compounds list: By importing a Compound List a. Click Open Compound List. b. Highlight a compound list to use.
8. Click Save.
This tool allows users to create plates for use within BioAssay.
22BioAssay
CambridgeSoft Protocols
Plate templates are used to create plates. To create or edit a plate template, click the Manage Templates button in the Create Plates dialog. For more information, see Manage Plate Template on page 21. To create a plate:
1. Select Create Plates from a Template.
NOTE: This link is only visible when the opened protocol is a plated based protocol, not linked to Inventory.
6. Click OK.
Protocol Data
Stored data for a protocol is accessed by clicking on the Data tab in the data viewer. This opens the Data Source Search Dialog.
plates in the Plate Templates box. 3. Click Add. 4. Change the name of the plates to be added if desired.
NOTE: By default, the plates are given the same
Primary Data tables are identified throughout the application with the blue data table icon. Summary tables are denoted by a similar green icon. The tables are defined under Protocol Definitions. To view your data, perform a search, or click Retrieve All. For more information about searching protocol data, see Searching Data on page 23.
Searching Data
The Protocol Search Dialog gives you the ability to search over protocol data according to your enter criteria. To search over the data:
BioAssay 23 Protocols
button under the Data tab if the Data tab is already open. The Search Dialog Appears. 2. Select the table to search over by highlighting a table under Select Data Source. 3. Enter you search criteria.
NOTE: The search fields vary depending on the data
displayed lower. If the number of tables displayed exceeds 4, a button allows you to bring the hidden tables back into view. Changing the selection to a table higher in the hierarchy cascades the change through the child tables. Thus, to see data for plate 2 instead of plate 1, we click plate 1s row in the Plates table, and that information is loaded into the Wells table.
Administrator
table selected.
4. Click Search.
The data is arranged in tables, as defined by the Protocol Definition. Double-clicking a row in a table exposes the data related to that row in the next table in the hierarchy. For example, your protocol may contain 2 tables, a plates and a wells table. Clicking on a row in the plates table exposes the well data associated with the selected plate.
NOTE: Data is only editable, and most actions are only available, from the main grid (by default the most detailed table open (found at the bottom of the data viewer)). To bring a table from the top into the main grid, double click on its title bar. Related Plate Data
If a plate tab appears in the data view, a plate view is available for the open table.
Tables are arranged in the data viewer by the hierarchy defined in the assay definition. That is, tables which are higher in the hierarchy are found at the top of the data browser and nested tables are
24BioAssay
CambridgeSoft Protocols
NOTE: In order to view the data for more than one row at once, hold down the CTRL or Shift keys when selecting rows. This will select multiple rows and display the results for the data on one plot.
If a graph tab appears in the data view, a graph view is available for the open table.
Lookup Structure
If a protocol contains compound IDs which correspond to Registration IDs in Registration Enterprise, those compound records can be opened in the Registration Enterprise interface by selecting Lookup Structure in BioAssay.
BioAssay 25 Protocols
For more information about defining tables for a protocol, please see Defining Tables and Fields on page 30. When a Protocol Definition folder is opened, the protocol structure is displayed in the right frame. The tree in the protocol definition frame groups information in five ways:
Primary Tables Calculation Tables Summary Tables Additional Tables File Import Templates Graph Templates
Administrator
If a protocol is linked to Inventory Enterprise, users are able to view well details stored in the inventory schema by selecting View Wells in Inventory Actions menu option. To view well details:
1. Highlight the wells of interest in BioAssay by
holding the SHIFT or CTRL keys down during row selection. 2. Right-click or click Action and select View Wells in Inventory.
NOTE: The user logged in must have the appropriate privileges to browse Inventory data in order to view well details.
Primary Tables
Protocol Definitions
The Protocol Definition is accessed by clicking on the Definition tab in the data viewer. This is where the protocol's structure and calculations are defined. The protocol tables must be defined before importing data.
Tables are arranged in levels. A table situated lower in the tree contains rows which hold aggregate data of one row in a higher table. For example, a plate based assay has at least two tables: Plates and Wells. The Plates table is higher on the tree than the Wells table. This makes sense because each plate contains several wells. The Plates table defines plate attributes such as the barcode while the Wells table holds data associated with a particular well, such as the well ID.
26BioAssay
CambridgeSoft Protocols
Each field falls under the appropriate table in the tree. Clicking on a table name or field name prompts the application to display details about the table or field under the appropriate tab to the right of the tree.
Child Tables always contain at least one field which is identical to a field with the same name in the Parent table. This field is the grouping field. This field allows the user to indicate to the application which data in the wells table belongs to the corresponding row in the parent table (e.g. Plate ID).
Calculation Tables
Calculation tables in BioAssay are used to calculate data for a protocol, in ways that may not fit into the standard hierarchy. For example, the primary data hierarchy may be Plates->Wells, but you would like to run some calculations over the same compound that is plated on multiple plates. Parent Tables Every primary table in an assay, except the table at the top of the hierarchy, has a parent. The parent table is the table found in the next highest level in the protocol tree. For example, in the image above, the Summary Table is a parent of the WELLS table. Because the Summary table is at the very top of the hierarchy, the Summary table does not have a parent. In this example, and in any parent table example, the parent table holds information summarizing the data in tables below it. For example, the Summary table contains a Compound ID field because all of the data in the WELLS table have a common Compound ID. Child Tables Every table in a protocol, except the table at the bottom of the hierarchy, has a child. Child tables are named as such because their data is summarized in some way by its parent. For example, the WELLS table in the above image is a child of the Summary table. There are many wells which are summarized (with various statistics) in the Summary table.
Summary Tables
Calculation tables contain one or more grouping fields in addition to calculation fields. The grouping fields indicate which data should be used in a calculation. For example, if the compound ID is used as the grouping field, calculations are made for each compound ID. Without the grouping field, calculations would be based on all valid data recorded for the protocol.
Summary tables in BioAssay are used to summarize data for a single protocol. Calculations in the standard data tables are usually based on grouped data. That is, data for an individual plate or run. Taking averages and standard deviations of data in more then one plate or run helps to visualize the overall picture.
BioAssay 27 Protocols
Summary tables contain one or more grouping fields in addition to calculation fields. The grouping fields indicate which data should be used in a calculation. For example, if the compound ID is used as the grouping field, calculations are made for each compound ID. Without the grouping field, calculations would be based on all valid data recorded for the assay.
For more information about using the File Import Template wizard, please see File Import Templates on page 43. For more information about importing data, using a defined File Import Template, please seeImporting Data on page 47.
Administrator
Graph Templates
Additional Tables
Additional tables are tables which contain data related, but not linked, to the rest of the data in the protocol. These tables can contain any number of fields. These tables allow the user to enter additional data which is mapped to the protocol but does not belong in any other fields.
File Import Templates
Graph templates are used to plot data. After a graph template is made, you can plot data by clicking on the appropriate Graph tab in Data View. Please see Related Graphical Data on page 25 for more information. Graph templates include information related to both the data and the display of that data. For more information about creating Graph Templates, please see Creating a Graph Template on page 49.
BioAssay includes a wizard which aides in designing templates called File Import Templates. These templates define how data should be imported into tables. The advantage of creating a template is to indicate the format of a data file once, and not have to enter the same information when using a file with the same format again. File Import Templates tell the system the format of the file (i.e. what kind of delimiter is used, if there are header lines in the file) as well as where to put the data, once it is imported, in the assay data tables of the assay. There must be at least one File Import Template defined for any file being imported.
Protocol Security
Protocol security in BioAssay is mostly centered around permissions to view, change data related to, and change definitions for protocols. The user who creates a protocol is automatically given the
28BioAssay
CambridgeSoft Protocols
appropriate permissions for the protocol, but all other users must be explicitly added to the protocol security list. There are three levels of protocol security for users:
Security Description
edit, add new, and delete protocol data validate data already in protocol data tables edit, add new, and delete table definitions, file import templates, graph templates and protocol security
3. Enter a name for your protocol and click OK.
For information about granting users permissions to a particular protocol, please see Defining Security on page 43.
Plate Based?
InventoryLinked?
Blank
Simple 2-Tier
BioAssay 29 Protocols
Plate Based?
InventoryLinked?
Initial Screen
Administrator
Confirmation Screen multi-dose, multiple- Y number-percompound protocol IC50 Initial Screen (Inventory Linked) IC50 protocol one-dose, singlenumber-percompound protocol Y Y
N Y
Confirmation Screen multi-dose, multiple- Y (Inventory Linked) number-percompound protocol IC50 (Inventory Linked)
5. Click OK.
IC50 protocol
The protocol is inserted in the Navigator under the select project. The protocol definition must be defined, and at least one file import template must be added before you can import data.
Any number of tables can be defined. If a table's data depends on the data in another table, the dependent table must be higher in the structure than the other table. The table structure will be defined most efficiently by, defining the lowest level table first, and working up to the highest level table. There are protocol templates that will help you to get your protocol started. Please see Designing a New Protocol on page 29 for more information.
NOTE: After importing data, the user will be limited to
30BioAssay
CambridgeSoft Protocols
If you have used a template, or if you have started with a duplicate protocol, your table may already exist. To start defining tables:
1. Open the protocol and click on the Definition
Then...
tab.
Rename the table or edit the table comments Add a parent table
Click on the table and edit the fields in the far right frame. Right-click on the table name and select Create parent table Right-click on the table name and select Create child table Right-click on the table name and select Remove table
Remove a table
If you have used a template, or if you have started with a duplicate protocol, some fields may already exist.
NOTE: Templates do not define calculations, they only
insert a field with type calculation. After tables are created, the table fields must be defined before data can populate them. Depending upon the template chosen, the contents of the frame will differ. To start defining fields:
1. Open the protocol and click on the Definitions
BioAssay 31 Protocols
Depending upon the template chosen, the contents of the frame will differ. 2. Do one of the following: To add a new field: a. Right-click the name of the table you would like to add a field to. b. Select New Field.
Then...
Administrator
Move a field from a Right-click on the higher table to a lower appropriate field table name and select Move Down To... Move a field from a Right-click on the lower table to a higher appropriate field table name and select Move Up To... Move a field up within a table Right-click on the appropriate field name and select Move Up Right-click on the appropriate field name and select Move Down
Field Types
b. Edit the appropriate data in the right frame. 3. Click Save Changes, if necessary.:
The field options available to be defined vary according to the field type chosen. When defining a field, after entering a name and comment, select a field type. Enter the appropriate information.
Field Type Field Options Display in Scientific notation? (yes if selected) Number of decimal places
Then...
Remove a field
Number (Real)
Number (Integer)
32BioAssay
CambridgeSoft Protocols
Field Type
Field Options
Field Type
Field Options
Text Date Elapsed Time (hh:mm:ss format) Yes/No Picklist Value Calculation (Numeric Output) Calculation (Text Output)
None None
Display in Scientific notation? (yes if selected) Units of Time
None
None
Which Picklist? Display in Scientific notation? (yes if selected) Defined calculation Defined calculation
(searching speeds improve when a field is indexed) Importing data into an indexed field is slightly slower than importing data into a field which is not indexed. Examples of fields to index: Compound ID Protocol data fields which are often search over To index a field:
1. Open the field definition (click on the field in
Plate Identifier None Plate Format Well Format Concentration None None
Display in Scientific notation? (yes if selected)
related to the row selected in the previous table. Groups data for calculations - only data with the same value in the key field are used to determine calculations.
NOTE: Every table must contain at least one key field.
BioAssay 33 Protocols
application will then be able to link your new view to other tables in Oracle and make the view available to users for reporting. To Expose the table in BioSAR Enterprise:
1. Click Expose Table In BioSAR Browser.
Administrator
If a field is required, a value must be given to the field before a data import is complete. To make a field required:
1. Open the field definition (click on the field in
Any data table field can be made read-only by unselecting the Allow Editing checkbox in the field definition. By default, Allow Editing is selected. If this checkbox is unchecked, users will not be able the manually edit this field in the data table in Edit Mode.
(valid data only, and/or all data) by selecting the appropriate checkbox. 3. Select the Link to base table indicated on right checkbox if the protocol table can be linked to another schema in BioSAR Enterprise. The application will try to pick a field which is most likely to be linked. This field can be changed by selecting a different field from the Field listbox.
Show Field
Users defining a field in a protocol have the option of hiding that field in the data table display. This may be useful for fields necessary for certain calculations, but not relevant to the user browsing the data. By default, all fields are visible. To hide a field from the data table display, unselect the Show Field checkbox in the field definition.
This wizard helps to define the calculation, and the data used to compute the calculation.
34BioAssay
CambridgeSoft Protocols
Three types of calculations are available: Aggregate - calculations made on a rows aggregate data found in a lower table Mathematical - calculations dependent upon a user defined equation Curve Fit - calculations made to fit a set of data to a particular curve Conditional - calculations that fill a field based on a set of user-defined conditions For more information about defining calculations and assigning values, please click on the type of calculation in the above list. 2. Highlight the calculation to be used, and click Next. While defining a calculation, you must select the fields that you want to use for variables in the calculation. The fields listed depend on the type of calculation you are creating and the field type of field.
Except for Conditional calculations, only fields
aggregate data
Minimum - returns the minimum value in the
aggregate data When a user clicks Edit Calculation, the calculation wizard appears. Click on the Aggregate Tab to define an aggregate calculation. To insert a aggregate calculation:
1. Highlight which calculation you would like
with a field type of Number (Real), Number (Integer), or Calculation will be options. For Aggregate Calculations Only fields in tables below the current table are displayed For Mathematical, Conditional, and Curve Fit Calculations Only fields in the current table or tables higher then the current table are displayed
Aggregate Calculations
Aggregate calculations are calculations performed on a data set resulting in one figure that is representative of the whole group. Therefore, aggregate calculations must be included in a table higher than the location of the aggregate data.
for the calculation is located, from the Table listbox. 4. Select the field where the data that will be used for the calculation is located, from the Values listbox. 5. Click Next.
BioAssay 35 Protocols
Mathematical Calculations
Mathematical calculations are any calculations performed using a defined equation. Therefore, calculations must be made on data in the same table as the table where the calculation is inserted or any table higher than that table. There are some already defined calculations which can be used including:
% Inhibition - returns the % inhibition (100 *
Administrator
6. If you would like to only use data points if
certain conditions are met, add a condition: a. Click on Add. b. Select a field where the data must fulfill the condition. c. Select a mathematical equality symbol. d. Finish the condition by entering the value that the data must fulfill. 7. Click Next.
The Finished screen appears.
((Value - LowControlAverage) / (HighControlAverage - LowControlAverage))) Log(x) - returns the log (base 10) of a value 10^x - returns the inverse log of a value Addition Subtraction Multiplication Division Percentage Half Life - (Time * ln(2)) / (ln(100 / PctRemaining)) Z' Factor - 1 - ((3*SDPosCtl + 3*SDNegCtl) / abs(AvgPosCtl - AvgNegCtl)) When a user clicks Edit Calculation, the calculation wizard appears. Click on the Aggregate Tab to define an aggregate calculation.
36BioAssay
CambridgeSoft Protocols
To use a default calculation: 1. Click on the Mathematical Tab. 2. Highlight which calculation you would like inserted into the cell. 3. Click Next. The Calculation Parameters screen appears.
The Edit Custom Function window, a window allowing the definition of a new equation, appears.
4. The equation used to compute the chosen
value is displayed. Select, in the table at the bottom of the window, what values should be used for the variables in the equation. This involves first selecting a Table, and then a field in that table from listboxes. 5. Repeat step 4 for all of the variables listed in the table. 6. Click Next.
BioAssay 37 Protocols
5. 6. 7.
listbox. Enter an equation for the calculation in the Equation textarea. General information about defining an equation is provided in the help section of this window. Supported operators are found under the Operators Tab and predefined functions are listed under the Functions Tab. Click OK. Highlight the function, just defined, and click Next. Continue with step 4 in Use a Default Mathematical Calculation on page 37.
have been defined for those graphs. If the list does not contain any values, go back to the Graph Templates section and set up the graphs and curve fits that you wish to perform first.
1. Select the curve parameter to be used for the
Administrator
calculation in the listbox (these options will be limited to curve parameters which make sense with the highlighted curve fit calculation).
NOTE: If no predicted values were defined in the Curve Fit calculation definition, there will be no options in the listbox (when Predicted value is selected).
2. Click Next.
Curve Fit calculations are calculations obtained from fitting data to a curve equation. Therefore, calculations must be made on data in the same table as the table where the calculation is inserted or any table higher than that table. When a user clicks Edit Calculation, the calculation wizard appears. Click on the Curve Fit Tab to access the Curve Fit calculations.
The list will contain the curve fits that are applicable for the given table, based on the graph templates that have been set up and the curve equations that
for the calculation is located, from the Table listbox. 4. Select the field where the data that will be used for the x-values in the curve is located, from the X-Values listbox. 5. Select the field where the data that will be used for the y-values in the curve is located, from the Y-Values listbox. 6. Click Next.
38BioAssay
CambridgeSoft Protocols
The Curve Fit Template window, a window allowing the definition of a new curve fit calculation, appears.
certain conditions are met, add a condition: a. Click on Add. b. Select a field where the data must fulfill the condition. c. Select a mathematical equality symbol. d. Finish the condition by entering the value that the data must fulfill.
8. Click Next.
For more information about creating new models, please see Defining a New Model on page 40.
2. Enter a name for the calculation in the
Template textbox.
3. Highlight the Model to be used. 4. Enter Parameter information under the
Parameters Tab.
column, for each parameter. b. Enter a numerical value, or select a value from the drop-down menu in the Value column.
BioAssay 39 Protocols
Advanced Tab.
Models are, in general, equations used to calculate curve fit parameters. New models can be defined under the User-Defined Tab in the Curvefit Template dialog box. To define a new model:
1. Click New under the User-Defined Tab in the
Administrator
variables under the Predicted Tab For more information about creating new models, please see Defining a New Model on page 40.
Curvefit Template dialog box. The User-Defined Model dialog box appears.
value.
b. Enter a name for the result. c. Select which value is given (X or Y).
textbox. 3. Enter an equation in the Equation textbox. Equation definition tips and conventions can be found in the lower half of the window. 4. Click Validate Equation to make sure the equation entered is written in the correct syntax. 5. Click OK. The new model is listed under the UserDefined Tab.
Editing a Curve Fit Calculation
predicted.
d. Enter a value for the variable. e. Click OK. 7. Click OK.
40BioAssay
CambridgeSoft Protocols
The CurveFit Template window, populated with the definition of the selected calculation, appears.
Advanced Tab.
For more information about creating new models, please see Defining a New Model on page 40.
3. Edit the name for the calculation in the Name
value.
textbox, if necessary. 4. Highlight the Model to be used, if it is not selected correctly. 5. Edit Parameter information under the Parameters Tab.
b. Enter a name for the result. c. Select which value is given (X or Y). Note:
The value not provided is the value which is predicted. d. Enter a value for the variable. e. Click OK. 8. Click OK.
Conditional Calculations
Conditional calculations allow the user to fill a field based on the contents of other fields in the protocol. Conditional calculations are the only calculations that may output a text value or a numeric value. In order for a conditional calculation to hold a text value, it must be defined as a Calculation (Text Output) in the Field Type section of the field definition.
BioAssay 41 Protocols
When a user clicks Edit Calculation, the calculation wizard appears. Click on the Conditional Tab to define a conditional calculation.
when none of the conditions are met (the default value). 3. Add as many conditions and output values as you need by clicking the Add button and filling in the table. In the example above, the field will contain "In Range" if the value the Successful Curves field is between 1 and 5, and will contain the appropriate out of range message if it is high or low. 4. Click Next, and Finish.
Administrator
To insert a conditional calculation:
1. Click Next.
Summary Tables
Summary tables are treated like primary tables in BioAssay, but they only contain a grouping field and calculation fields. They are used to group data by a different parameter to allow for additional analysis (calculations). Summary Tables include:
One grouping field As many calculation fields as desired
42BioAssay
CambridgeSoft Protocols
Defining Security
Users, other then the creator, must be given the appropriate permissions to access and edit protocols. To give a user or group permissions to a protocol:
1. Open the appropriate protocol's protocol
definition. 2. Click on the Security Tab. 3. Check the box that says Lock valid data if you want to disallow editing of data that has been validated. 4. Click the Edit Protocol Security button. The Protocol Security window opens.
(depending on who you would like to add to the security). 6. Choose the appropriate action: To add a user or group to the protocol's security: a. Highlight the user or group in the list. b. Click Add. c. Select the checkboxes corresponding to the permissions you would like to give the user or group. For more information about your options, please see Protocol Security. To remove a user or group from the protocol's security: a. Highlight the user or group in the table (on the right).
in the tree.
3. Select New Template.
The File Import Template Wizard appears. 4. Enter the a name and description for your file import template in the Select Data File window. 5. Click Next. The File Format Information screen appears. 6. Select a file delimiter. Commas Tabs Spaces Tecan (used for importing files created with certain Tecan instruments)
BioAssay 43 Protocols
which appears to the right) 7. Select the type of file you are importing:
File Type
Description
Even though all the results above apply to compound AB-00001, the compound name is not repeated for clarity. When you import, you should choose Fill field with last non-empty value encountered. The data in BioAssay will then look like this:
Administrator
Columnar (ExcelType)
a series of columns; each column contains the values for one variable.
Plate Block raw data is arranged in a block; the block is arranged to coincide with plate arrangement See BioAssay Plate Block Data Files on page 323 for more information.
8. Complete the details related to your file type.
Columnar:
All results are properly associated with the correct compound id. Your data may include legitimate empty spaces, where a result is not available, for instance:
Indicate if your data file has header lines (lines not containing actual data). If there are header lines, enter how many in the textbox. Indicate how you want to treat empty values in your data. You can either leave those fields blank, or fill them with the last non-blank value encountered in the file. For example, your Excel data may look like this:
Result 34.5
67.8
Compound ID AB-00001
In this case, you should choose Leave field blank. Plate Block: Check the boxes to indicate which sections are present in your plate block file. Enter the number of rows in each category. For more information about the parts of a plate block file, see BioAssay Plate Block Data Files on page 323. 9. Click Next.
44BioAssay
CambridgeSoft Protocols
If you have selected a plate block file, the Well Options screen appears. (If you have selected a Columnar file, go on to step 10). Here you can select how many values appear for each well in your file. The options are detailed below:
Option Description
Option
Description
A kinetic protocol where multiple values are measured for each well at different timepoints, and the data goes into the same field.
A single A standard protocol which value for each measures a single value for well. each well. There may be data for multiple plates in a single file, but each well has just one number associated with it. Multiple values for each well separate data blocks, separate fields. Multiple values for each well separate data blocks, same field. Multiple values for each well columnar format, separate fields. A protocol where multiple values are measured for each well. In the most common case, a reader reads at 2 different wavelengths and outputs a data block for each wavelength. A kinetic protocol where multiple values are measured for each well at different timepoints. All the values will go in the same field, but there are many for each well. A protocol where multiple values are measured for each well, and the data is arranged in a columnar format similar to an Excel file.
10.Click Next
The Map Fields screen appears. 11. Assign values to the fields in the selected table by: a. Selecting what type of value to populate the field with: Choices depend on the type of file you have chosen and the type of file being imported.
Data Source File Type Description
Leave Blank
No data is imported into this field Data is found in a column in a data file enter the column number to the right Data is part of the filename -
BioAssay 45 Protocols
Data Source
File Type
Description
Data Source
File Type
Description
Administrator
Use Default
A default value should be entered for this field enter the default value to the right During import, the user will be prompted for the value of this field For attachment fields only. The file itself will be uploaded to the database, into the field.
Prompt Me
For platelinked assays only. The field will be filled with the corresponding data from the plate inventory field. Select which field will be used as the data source to the right. Data is the data found in the plate block Data is in a particular cell in the File Header Block - enter the cell to the right Data is in a particular cell in the Block Header Cell enter the cell to the right
Upload File
Plate Block
Plate Block
Plate Block
46BioAssay
CambridgeSoft Protocols
Data Source
File Type
Description
Data is in a particular feel in the File Block Footer Cell - enter the cell to the right Data is in a particular feel in the Block Column Cell enter the cell to the right Uses time on user's machine when file is imported Uses username of user who imports file
The new File Import Template is defined and ready for use.
Importing Data
If the protocol tables and a File Import Template compatible with the data file being imported have been defined, data can be imported through the use of the File Import Wizard. To import data:
1. Open the protocol (select the protocol in the
Navigator). 2. Click on the Tasks Tab. 3. Click Import a Data File. The File Import Wizard appears.
right most column, if applicable: for Use Default - a default value for Data in File Column - enter the column number for Block Header Cell - enter the cell (as entered in an application like Excel) in the plate block header lines.
9.
The second window appears. Use the browse button to browse to the data files you would like to import. Click Next. Enter the appropriate information, if the wizard asks. This window will differ depending on the File Import Template being used. Click Next.
BioAssay 47 Protocols
See Protocol Data on page 23 for more information about searching and browsing protocol data.
Administrator
10.Select the checkbox if you would like to view
the data in the data tables before importing. 11. Click Finish. The appropriate table is populated with data. If any fields in the protocol tables are calculations, those calculations are made.
be validated. 2. Highlight the data to be validated. 3. Select Change Validity under the Actions Menu. The validation dialog appers.
the highlighted data. Primary Data tables are identified throughout the application with the blue data table icon. Summary tables are denoted by a similar green icon. The tables are defined under Protocol Definitions. To view your data, perform a search, or click Retrieve All.
Validity Option Icon Description Used in Calculations?
Not I Validated
48BioAssay
CambridgeSoft Protocols
Validity Option
Graph templates are used to plot data in a protocol. These templates define properties such as:
Which data is to be plotted Physical properties of the graph - e.g. error
Valid
data is found Yes to be valid data is found No to be invalid data must be Yes reviewed before making a validation decision
Invalid
Request Review
bars, gridlines, graph type, data point markers Where the graph template can be accessed from What curve equations will be fit to the data by default To create a new graph template, browse to the definition of your protocol and right-click the Summary Table for the Graph Template and select is New Graph Template. A new template is listed. To begin defining a template:
1. Click the graph template name in the Protocol
- apply the same validity decision to records summarized by the highlighted record Override current invalid records - change invalid records summarized by the highlighted data to the new validation 6. Click OK.
Definition tree. The graph template details open in the right frame.
Template Name - a name for the template Comment - additional comments for the
template.
BioAssay 49 Protocols
where the graph images will be stored. For instance, if you are preparing a graph of activity vs. concentration for each compound, you would select the Compounds table as the Summary Table, and the Data Table would contain the activity at each concentration. Data Table - The table the plotted data is taken from. This will typically be the direct child table of the Summary Table. X-Axis - The field from which the application should populate the X-Axis. Y-Axis - The field from which the application should populate the Y-Axis.
3. Click Conditions to limit the points that are
If image fields are not found for your graph template, they will be created in the Summary Table. You will see 2 new fields appear, one named as <Graph Template Name> and one as <Graph Template Name> (Small). These fields are where graph images will be stored when calculations are run.
Administrator
4. 5. 6. 7.
included in your graph. For instance, you may wish to include only points where the Y-axis value is above 0. Click Graph Storage to define how to store images of the graphs in your data table. You can store the full image, or strip the titles and legends from the stored image. These stored images are recreated when the data is recalculated. Click Curve Fits to change the list of curve equations that are fit to the data by default when calculations are done. The set of curves that you define here will be available for use when you set up Curve Fit calculations. You can use the default equations, or create your own. See Define a New Curve Fit Calculation on page 39 for more information. Click Display Options to define the graph display options. The Display Options dialog appears. Please see Graphing Options on page 53 for more information. Click Save Changes.
When defining a graph template, the user must indicate which table is the summary table for the graph. Image fields are added to this table, and when calculations are performed, a small and a large image of the graph are stored in these fields. By default, the graphs are shown as blue links that say (Graph), and they may be opened by double clicking or shown in place by right-clicking and choosing Show Pictures.
Interactive Graphs
When defining a graph template, the user must indicate where the data for the graph template should come from. If a graph template is defined to be available from a table, a button for that graph will appear in the Display Bar:
Clicking this button switches to a plotting window with the specified data plotted according to the graph template.
50BioAssay
CambridgeSoft Protocols
After fitting the data to a curve, the Data Tab will display equation parameter values, and fit statistics.
Curve Fit Templates
For more information about how to define a new curve fit equation, please see Define a New Curve Fit Calculation on page 39. If the correct curve is already defined, do the following to fit plotted data to a curve:
1. After plotting data, click Curve. 2. Highlight the name of the curve in the
Curve Fit Templates are listed in the Available Curves box found in the Add or Remove Curve window. To access this window, click Curve from any plot. For more information about using a template that is already listed, please see Fitting Data to a Curve on page 51.
Creating a New Template
Available Curves box. 3. Click Graph Selected Curve. The name of the curve appears in the Graphed Curve box. 4. Repeat this process until all of the curves you wanted plotted are listed in the Graphed Curve box. 5. Click OK. All curves listed in the Graphed Curve box are added to the plot, fitting the equation as close as possible to the data points.
2. 3.
4.
5. 6.
click New. The Curvefit Template window opens. Enter a name for the template in the Name textbox. Highlight the Model to be used. For more information about creating new models, please see Defining a New Model on page 40. Enter Parameter information under the Parameters Tab. a. Select Variable or Constant, in the Type column, for each parameter. b. Enter a numerical value, or select a value from the drop-down menu in the Value column. Enter additional information under the Advanced Tab. Click OK. The name or your new template will be listed in the Available Curves box.
The graph characteristics, such as the type of scaling on the axes and how far the fitted curve is extended from the data, are defined in the Graph Options dialog box.
Editing a Template
The edit template interface behaves just like the new template interface. If you would like to edit a template:
BioAssay 51 Protocols
Data Statistics
click Edit. The Curvefit Template window opens with the current template settings populating the fields in the window. See Creating a New Template on page 51 for more details.
Various statistics defining the data are found under the Data Statistics Tab. Statistics for both the X and Y values are recorded.
Administrator
The Equation Tab displays the equation that the data is fit to under Parameterized Equation. The x and y variables define the x and y coordinates for the fit curve. The values for other parameters in the equation are assigned to fit the data the best. The final values are recorded in the Parameter Values table.
Fit Statistics
The Fit Statistics Tab records statistics defining how well the Equation, found under the Equation Tab, fits the data found under the Values Tab. The information found under this tab will give the user information to determine if the data has a meaningful fit to the curve.
Values
The Values Tab displays the actual data point values to which the equation found under the Equation Tab is fit.
52BioAssay
CambridgeSoft Protocols
When viewing a plot (for more information please see Plotting Data using a Graph Template on page 50), you can exclude and include data points. By default, active data points appear in blue, inactive data points in red. All data points are active by default. To exclude an active datapoint from the fit or include an inactive data point in the fit:
1. Find the point in the plot and right-click. 2. Select the appropriate options (Exclude from
Selecting a checkbox next to a Show option will show that option. Unchecking the box will hide the item.
Graphing Options
There are three tabs in the Graph Options dialog:
General - define general plotting
Scaling
characteristics such as error bars, grid lines, and graph extensions Title - give the plot and its axes titles Plots - define display characteristics such as data point markers and the plot type To access the Graph options dialog: Click Options from a plotting window OR Click Graph Options from a Graph Template definition.
Graph Options General Tab
By default, the graph window will fit itself to the data being plotted. This means that the maximum and minimum numbers shown on the scales may change from graph to graph. To prevent this, you can lock either or both axes to a maximum and minimum value.
Graph Extension
Most of the options under the general tab will remove and add particular parts of the plot such as the legend, the axes labels, or the data itself.
The graph extension listbox determines how much the fitted curve should extend from the data points. The default is 10%. This means the fitted curve will extend 10% more from the data points at the two ends of the curve. Making this value larger will extend the curve farther, as seen in the following images:
BioAssay 53 Protocols
Administrator
Graph Extension = 40%
Graph Options Plots Tab
The graph options Plots Tab allows you to control the display characteristics of the graph. From this
Error Bars
Error bars can be added to any plot. To add error bars to a plot:
1. Click Options. 2. Select an error bar option (found in the right
column of the Graph Options dialog box). Only one error bar option can be chosen at one time. Error bars can be calculated from individual data or aggregated data. 3. Click OK.
Graph Options Title Tab
The graph options Title Tab allows you to label the graph and its axes. To make a label:
1. Enter text in the appropriate textbox. 2. Click Font to select a font, style, and size.
Compound Lists
Compound Lists are lists of compounds for use in plate templates. To create a new list:
54BioAssay
field, select the rows containing the Compound IDs to be saved. 2. Right-click and select Save Compound List. Lists appear in the Navigator under the Lists folder.
NOTE: If the list contains the same compound ID more than once, that compound ID will only be saved once.
appropriate option: Merge a List - produce a new list which is the result of both lists together. Intersect a List - produce a list of only the Compound IDs which are included in both the original list and the selected list. Subtract a List - produce a list of only the Compound IDs which appear in one of the lists (are not common to both lists) 2. Select a list to perform the operation on. 3. Click OK. The new list appears.
Adding an entry
To add an entry to a settings table: 1. While in Edit Mode, click Add. An empty column is inserted. 2. Enter information in the appropriate columns of the new row. 3. Click Save.
Deleting an entry
To delete an entry in a settings table: 1. While in Edit Mode, click in the row to be deleted. 2. Click Delete. 3. Click Save.
Settings
Plate settings are defined through the lists found under the Settings heading in BioAssay. These lists define what options are available when defining a plate.
BioAssay 55 Settings
Canceling/Discarding Changes
If you have made changes to a settings table, but have not saved those changes, changes can be canceled. To cancel changes: 1. While in Edit Mode (after making changes, but before saving), click Cancel. A dialog box appears asking if you want to discard changes.
format (by double-clicking on the appropriate row). The plate opens with the number of wells defined in the Physical Plate Format. The default is all wells contain the default well format Compound. The default well format options are:
Compound - a compound can be inserted in
Administrator
2. Click Yes.
Plate Formats
Plate Formats are defined as a format indicating the layout in a plate of the general contents of each well. For this reason, the Plate Format setting needs a Physical Plate Type defined in order to have a general idea of the layout and capacity of the wells in the plate first. There are two steps in defining a plate format.
the well Empty - the well remains empty Positive Control - this well is reserved for a positive control Negative Control - this well is reserved for a negative control More well formats can be defined by the user. For more information about editing the entries in the Plate Formats table, please see Editing the settings tables on page 55. To define the general contents of the plate's wells:
1. Enter edit mode (by clicking Edit). 2. Highlight the appropriate wells. 3. Click on the arrow in the well to display your
options for the well format for a particular well. 4. Select a contents option. The well label is updated.
Well Formats
Well Formats define the general contents of a well. The well format is used when defining Plate Formats. The default Well Formats are:
Compound - a compound can be inserted in
After entering values for the above attributes, it is necessary to define the general contents of each well. This is accomplished by opening the Plate
the well Empty - the well remain empty Positive Control - this well is reserved for a positive control Negative Control - this well is reserved for a negative control
56BioAssay
CambridgeSoft Settings
It is important to note that the only well that the system recognizes as a well in which a compound from a database can be inserted, is a well with the Compound Well Format. For more information about editing the entries in the Well Formats table, please see Editing the settings tables on page 55.
Protocol Picklist
Items listed in the Protocol Picklist table are items that can be used to limit the entries that may be made in a field to a controlled list. For example, a default picklist category is Scientist. There are four picklist options defined.
A table defining the entries in the picklist appears. 9. Click Edit. 10.Click Add. 11. Enter an entry for the picklist. 12.Click Save. 13.Repeat steps 10-12 until all of the entries you choose to define have been entered.
3.
3. 4. 5. 6. 7. 8.
Settings>Protocol Picklist Click on Protocol Picklist. The Protocol Picklist table appears in the right frame. Click Edit. Click Add. An empty row is inserted. Enter a name for the new picklist in the empty row. Click Save. Click Browse. Double-click on the row with the name of the new picklist.
6. 7. 8.
Settings>Protocol Picklist Click on Protocol Picklist. The Protocol Picklist table appears in the right frame. Double-click on the row containing the name of the picklist. A table defining the entries in the picklist appears. Click Edit. Do one of the following: Click Add. Double click on the entry you would like to edit. Enter the desired information. Click Save. Repeat steps 5-7 until all of the entries you choose to define have been entered.
Using a Picklist
To use a picklist in a protocol's table:
1. Define a table (or choose a defined table). 2. Open the table by double clicking on its row in
BioAssay 57 Settings
BioAssay uses the ChemOffice Enterprises global security to add and edit the properties of users. To access the Manage Users interface:
1. Open a browser and go to the ChemOffice
Administrator
Security
BioAssay applies two levels of security. The first level controls access to certain parts of the software, such as plate setup, editing inventory, and user management. The second level is more granular, managing users' abilities to view and edit protocol data on a protocol by protocol basis.
Enterprise homepage (http://<servername>, where <servername> is your server's name). 2. Click Global Login. 3. Enter a username and password and click OK.
4. From the Global Login homepage, click
Managing Users
A list of ChemOffice Enterprise users (including but not limited to BioAssay users) can be found under Settings > Users.
users.
2. Click Refresh. 3. Click Add User (to add a new user) or
highlight a user name and click Update User (to edit an existing user). A page allowing you to enter user details appears. 4. Enter user details as desired. Fields highlighted in red are required.
58BioAssay
CambridgeSoft Security
then one role at once, hold down the CTRL key while highlighting. 6. Click OK.
Managing Groups
A list of BioAssay groups can be found under Settings > Groups.
Each group contains a number of users. Applying a role to a group applies that role to all users in the group.
user to, and click Actions. Select View Group. A list of the users in the group appears. Click Edit. Click Add A new row appears. Enter the appropriate information. Click Save.
BioAssay 59 Security
Administrator
60BioAssay CambridgeSoft Security
View
View refers to a database view that exists in a schema in the Oracle instance. Views are created by assigning the results of a query to a new table in the database. For example, a view could be made from the person and order table mentioned above (under Table). This view could include the last name and first name of the person as well as order date. Now, the view can be accessed much like a table eliminating the need for longer, more complicated SQL statements to access the information. In most respects, a view is dealt with in the same way a table is dealt with in the BioSAR application.
Terminology
Schema
A schema details the structure of a particular database which can be accessed from the BioSAR Enterprise application. Each schema is made up of several tables. Each table contains a number of fields. In addition to describing the contents of each table, the schema also defines any relationships between tables and fields in that schema. These relationships are automatically generated for you when you enable a schema for use in BioSAR. Relationships that cross schemas can also be applied. For example, if a registration id number in the REGDB schema is the same id number included in the CHMINVDB2 schema, these two fields can be linked within the application.
Formgroup
Each from created with the Manage Your Forms function actually contains 3 forms: a search form, a list view form, and a details view form. The 3 forms are linked. A formgroup refers to the group of 3 forms. When creating formgroups, users are able to give other users access. If users, other than the creator is given access to a formgroup, the formgroup is considered public.
Table
Table refers to a database table that exists in a schema in the Oracle instance. Tables define entities in the schema.
Schema Management
BioSAR Enterprise's Schema Management allows administrators to control what is visible to the users. That is, Schema Management gives administrators the tools to control what schemas, tables, views, and fields can be used in forms. Schema Management can be accessed by:
Clicking on Schema Management from the
in. The ChemOffice Enterprise Global Login page appears. 4. Select the part of the application you wish to access:
From this page, administrators can control all aspects of schema configurations for the application. Any schema can be viewed from BioSAR Enterprise. For more information, please see the BioSAR Enterprise Admin Guide.
BioSAR Enterprise opens. The forms displayed depend on the option selected. Use the toolbar to navigate through the software.
Refreshing Tables
Users with the appropriate privileges may see a button called Refresh All Tables or Refresh Table in Schema Management. Clicking on this button will wipe out any links set up between schemas and there is no undo operations. Please be sure you are aware of the consequences before refreshing a table.
62BioSAR Enterprise
Add/Remove Schemas
The administrator decides which schemas are available to the users of the system. If a schema is not visible, none of the tables or views can be seen or used by the users of the system. Any schema which exists on the Oracle instance of the server can be included in the BioSAR Enterprise application.
Remove a Schema
To remove a schema from the list of available schemas:
1. From the main menu, click on Schema
Add a Schema
To add a schema to the list of available schemas: 1. From the main menu, click on Schema Management. 2. Click on Add/Remove Schema. A table containing all of the schemas which exist on the Oracle instance appears.
Management. 2. Click Add/Remove Schema. A table containing all of the schemas which exist on the Oracle instance appears.
column to the right of the names of schemas you would like to remove. 4. Click Save Changes to save your changes before returning to the previous page.
3. Select the checkbox in the Exposed column to
the right of the names of schemas you would like to make visible.
Administrator
by clicking on the arrowhead next to the schema name in the tree control.
The display name for the schema is the name a user will see to identify the schema. The default display name is the name of the schema, but it is sometimes more convenient to enter a more descriptive name for the schema. If you would like to change the display name:
Enter the new name in the textbox next to
Display Name.
Schema Password
The password for the schema is assigned when the schema is created. For information about schema passwords for CambridgeSoft schemas, please contact esupport@cambridgesoft.com. If you would like to change the password (in BioSAR Enterprise only, it still must be the actual schema password):
Enter the password for the schema in the
64BioSAR Enterprise
edit by clicking on the arrowhead next to the schema name in the tree control. 2. Click Edit Exposed Tables. 3. Select the checkbox in the Visible column next to any tables you would like to see visible when users are creating forms. 4. Click Save Changes.
users
The display name for each field The description for each field
2. Expand the schema which contains the table by
A lookup table for each field A parent column for each field The Index Type The Content Type
clicking on the arrowhead next to the schema name in the tree control.
After making changes to the table, be sure to click Save Changes to save your changes.
expand (if not yet expanded). 4. Click on the name of the table.
Table Fields
Specify the Visible Fields in a Table
If you would like to make a field available to users, select the checkbox in the Visible? column, to the left of the field name. If the checkbox is not selected, users will not be able to use it in any forms.
Administrator
The display name for a field is the name a user uses to identify the field. The default display name is the name of the field in the database. to change the display name for the field:
Enter the new name in the textbox in the
Display Name
The display name for a field is the name a user will see to identify the field. The default display name is the name of the field, but it is sometimes more convenient to enter a more descriptive name for the field. If you would like to change the display name:
Enter the new description in the textbox in the
Description column.
66BioSAR Enterprise
4. Select the Linking Column and Display Name. 5. Click Save Changes.
Linking Column The linking column is the column in the lookup table with the same value as the field whose lookup table is being defined.
Specify a Lookup Table for a Field
A lookup table for a field defines where a field's display value can be found. Many times a lookup table is defined for an ID field so that instead of displaying the ID to the user when the information is viewed, a value more useful to the user is displayed. During installation, lookup tables are automatically recorded for ChemOffice Enterprise schemas. To define a lookup table for a field,
1. Click on the link in the Lookup Table column
For example, there is a field called EXPERIMENT_TYPE_ID in the EXPERIMENTS table in the REGDB schema. this ID, to a user, doesn't give much information, but the EXPERIEMTNTYPE table in the REGDB schema defines the relationship between the ID and an experiment's name. For this reason, the linking column for regdb.experiments.experiment_type_id is regdb.experimenttype.experiment_type_id. Display Column The display column is the value that should be used in place of the actual field value in forms. In our example above, we have linked two tables together. The EXPERIEMENTS table contains a field called EXPERIMENT_TYPE_NAME (in addition to the EXPERIMENT_TYPE_ID). This field contains a name for each ID. Therefore, experimenttype.experiment_type_name is the Display Column for regdb.experiments.experiment_type_id.
Specify a Parent Column for a Field
to the right of the field name. The Lookup Table page appears.
from the Lookup Schema listbox. The Lookup Table listbox is populated. 3. Select the lookup table from the Lookup Table listbox. The Linking Column and Display Column listboxes are populated.
A parent column defines a table which is related to many tables in the same way. As opposed to a lookup table Specify a Lookup Table for a Field on page 67, which has a one to one relationship with its related table, a parent table has a one to many relationship. During installation, parent columns are automatically recorded for ChemOffice Enterprise schemas.
column to the right of the field name. The Parent Column page appears.
The index type for a field is for a field containing a LOB that is indexed. Currently the only supported index type is the Oracle Cartridge. Most other fields containing LOBs (such as GIFs, JPEGs, etc.) are not indexed and should be assigned the index type "no index".
Specify a Content Type for a Field
Administrator
The content type for a field is the HTTP MIME_TYPE for a particular LOB. The current options are:
Type of LOB in field
2. Select the schema where the lookup table exists
Content Type
from the Parent Schema listbox. The Parent Table listbox is populated. 3. Select the parent table from the Parent Table listbox. The Parent Column listbox is populated. 4. Select the Parent Column. 5. Click Save Changes. For example, the REG_NUMBERS table is a parent of the BATCHES table because one compound can contain many batches. For each REGDB.REG_NUMBERS.REG_ID, there are one or more matching records in BATCHES. BATCHES.REG_INTERNAL_ID contains the same value as REGDB.REG_NUMBERS.REG_ID. So, if we would select the following when defining the Parent Column for REGDB.BATCHES.REG_INTERNAL_ID:
Parent Schema - REGDB Parent Table - REG_NUMBERS
ichemical/x-cdx IMAGE/gif
68BioSAR Enterprise
The Base Table listbox is populated. 3. Select the base table from the Base Table listbox. 4. Click Save Changes. You are returned to the Edit Form page and the name of the table chosen will be listed under Base Table.
After selecting a base or child table, it is necessary to indicate which fields should be visible to the form user, and when. To do this:
1. Click Edit in the Fields column.
Administrator
for each view, from the Format drop down menu. For more information about the field formats, see the table below.
NOTE: Some fields have only one way of being
2. Three columns are shown to the right of field
names and descriptions in the table, representing different views, entitled Query - visible in the query form used to search List - visible in the results list form (multiple records viewed at one time) Detail - visible when one record is viewed alone Select the checkboxes in the appropriate columns to indicate the field should be visible in that view. 3. Click Save Changes.
How Fields are Displayed in Forms
each view. 4. Select the Show checkbox if you would like that field to be visible to users in the specified view. 5. Click Save Changes.
Display Type Description Option in which View
Structure
A structure window appears A CDX file is displayed (can be edited with ChemDraw toolbar).
Search
ChemDraw PlugIn
List, Detail
70BioSAR Enterprise
Display Type
Description
Display Type
Description
Graphic
A graphic is List, displayed. INDetail LINE means the graphic appears in the current window, NEW WINDOW means a link to the graphic will be displayed and clicking on the link will open the graphic in a new window. A GIF (showing List, an image of the Detail structure) is displayed. Cannot be edited. A textbox. A larger area allowing multiple lines of text to be entered. Search Search
Search
1. Browse to a list
values delimited by commas, tabs, or linefeeds. These values can be pasted from Excel, or a text file.
Static GIF
DatePicker
Validated as a text Search field, includes a calendar icon allowing easier input of dates. Validated as a date. Search
TextBox TextArea
Date
A user can also decide the order in which fields are shown in a form. To do this:
1. Click the appropriate view name in the Field
Administrator
A page listing all child tables, compatible with the chosen base table, appears. 2. Select the checkbox next to any table you would like visible on the form. 3. Click Save Changes. You are returned to the New Form page and the names of the tables chosen are listed under Child Tables.
checkbox.
Fields are selected in the same way as for the base table. Please see Selecting Fields in a Table on page 70 for more information. 5. Indicate the order you would like the tables to be displayed in the form by clicking on the arrows in the Table Order column. 6. Click Save Changes.
To add users or roles for the form, highlight the appropriate listing in the listbox below All Users and Roles and click Add. This will move the listing into the Permitted Users and Roles listbox to the right. To remove a listing from the Permitted Users and Roles listbox, highlight the appropriate listing in the listbox below Permitted Users and Roles and click Remove.
72BioSAR Enterprise
If roles or users are chosen, even if an individual user is missing a role (for example, one to view a specific table in the form), this role is granted to the user for the use of the form automatically.
Editing a Form
After a form has been created, the information can be edited at anytime as long as you are logged in as the user who made the form in the first place, or you are assigned the appropriate privileges to edit other users forms. To edit a form:
1. From the Manage Your Forms page, select
the form from the listbox. 2. Click Edit. A page allowing the definition of a form appears.
Public Category for a public project group). 2. Browse to the project using the tree control. 3. Select the project to add the form to by clicking on the project name. To change the project assignment to a different project:
1. Click Move to the right of the project name. 2. Browse to a project using the tree control. 3. Select the project to add the form to by clicking 3. Enter/Select the appropriate information.
There are four parts of a form's setup: Edit the name and description for the form (cannot be changed from this page). Select users and roles entitling access. Select a Base Table for the form and define which fields will be visible to the user. Select Child Tables for the form and define which fields will be visible to the user. 4. Click Save Changes.
Renaming a Form
The name and description of a form are used to identify the form when it is restored to search.
Administrator
form from the listbox. 2. Click Rename. A page allowing you to rename the form appears.
form from the listbox. 2. Click Delete. The following warning appears:
3. Click the appropriate link. 3. Edit the name and description in the textboxes. 4. Click Save Changes.
Duplicating a Form
Duplicating a form is often useful if there is a form, that already exists, which has many of the properties that you would like in a new form. For example, if you are creating a new form with the same base table and field properties of an old form, duplicating a form can save time in defining the new form. To duplicate a form:
1. From the Form Management page, select the
form to be duplicated from the listbox. 2. Click Duplicate. The form is duplicated and can now be accessed from the listbox. The name of the new form is the name of the old form preceded by "Copy of".
74BioSAR Enterprise
Searching
There are three different ways to retrieve search results from the main menu under the heading Search Using:
Using a Form Group Opening a
The form you see will depend on the form group chosen and will most likely not have all of the same fields as the above form. 3. Enter the desired information in the form. 4. Select a Sort by field, from the Search Sort By drop down menu, if desired. 5. Select one of the following radiobuttson: Show All Child Data - show all child data for matching records (if one set of child data matches the entered criteria, but another set for the same base record doesnt, this option allows you to view all data) Show Only Child Data Matching Entered Criteria - show only the child data which matches the entered criteria 6. Click Search. Your search results are displayed. For tips in using ChemOffice Enterprise search forms, please see Performing Searches in the ChemOffice Enterprise Chapter.
Form/Searching Using a Form on page 74. Retrieving a Saved Query Search Using a Saved Query on page 75. Retrieving a Query in the History Searching Using the History on page 76. After performing a search, search results are always displayed in the same format. For more information about viewing search results, please see Viewing Search Results on page 76.
Administrator
query you wish to restore. If you select Saved, a dialog box opens.
2. Select the appropriate search from the listbox. 3. Add more information, if desired, and click
associated with that form. 4. Click Restore. 5. Add more information, if desired, and click Search. For tips in using ChemOffice Enterprise search forms, please see Performing Searches in the ChemOffice Enterprise User's Guide.
Search. For tips in using ChemOffice Enterprise search forms, please see Performing Searches in the ChemOffice Enterprise User's Guide.
entered and <time> is the time at which the query was entered
76BioSAR Enterprise
CambridgeSoft Searching
To show all retrieved information for a particular record, click on Show Details. What information is displayed at the different view levels is defined when creating a new formCreate a New Form on page 69. For more information about manipulating search results, please see Search Results in the ChemOffice Enterprise User's Guide. After clicking on Show Details, the Results Form View appears. Here, it is possible to view your results in different formats. The information displayed in each of the formats is the same and the screen differs only in its layout. The view options are: Frame View Tab View Report View
indicated integration with Excel should be available see Edit Integration Options on page 72 for more information about integrating with Excel To create view your data in a spreadsheet: Click Display in Excel. Your data appears in a spreadsheet in a new window.
spaced horizontally.
Columns Across - arranges fields in columns
Sorting Results
Search results can be sorted by clicking on the table header of one of the columns.
spaced vertically. Click Toggle Layout to switch between the two views.
Columns Down
You are returned to the open form, reflecting the changes made.
Columns Across
Report View
Frame View is the default search results details view. This view shows data in two frames, the base table in the left frame and the child tables in the right frame.
In the Report View, all data is displayed on one page, in one frame. Base table data is displayed at the top, and child table data appears below.
Administrator
Tab View
In Tab View, each table's or view's data is separated into tabs. Click on the tab to access the appropriate information.
Generating Reports
BioSAR Enterprise allows users to generate reports for any publicly defined formgroup. After performing a search using a public formgroup, a Generate Report link is found at the top of the page. To generate a report:
1. Perform a search See Searching on page 75.
using a public form group See Manage Your Forms on page 68. 2. Select Generate Report from the Reports menu. The Report window appears.
78BioSAR Enterprise
CambridgeSoft Searching
Report Setting
Description
Options
Table Layout Tables can be placed across (arranged horizontally next to each other) or down (arranged vertically).
3. Select the appropriate options for your report.
Report Setting
Description
Options
Data View
The data view is the cross-section of data you would like to see. When creating your forms, you defined a List and Details view. Usually the Details view has more information about each record in the list view. Select the data you would like the create the report for.
List Details
Profiles define the display settings for a report. This includes font size, color, and style as well as the inclusion or exclusion of logos. Use the links to the right of the listbox to view, edit, or delete the selected profile before creating the report.
Report Setting
Description
Options
Report Setting
Description
Options
Administrator
Page Reports can be Orientation forced to be created to fit a portrait of landscape format. If Auto is selected, the appropriate size (in the attempt to display as much information as possible) is chosen and implemented. Page Size The page size is implemented when the report is created to fit on the page you are using.
If you would like a page break to be inserted after each record, use this setting by selecting Yes. Select the format you would like the report displayed in
No Yes
Report Format
Letter (8.5 x 11 in.) Legal (8.5 x 14 in.) A3 (297 x 197 mm) A4 (210 x 297 mm) B4 (250 x 354mm) B5 (182 x 257mm) Tabloid ( 11 x17in.)
NOTE: If structures are not appearing in your reports, the schema may not be configured correctly. Please see your system administrator.
listbox. The Profile window appears. The defaults are the values in the default profile.
80BioSAR Enterprise
CambridgeSoft Searching
Set the Select the color in the color of the appropriate listboxes header, footer, or detail in the report Adjust the font type, style, size, weight, or color of a particular part of your report Select the appropriate options from the listboxes to the right of the appropriate text block name.
Enter a name for your profile in the Profile Name textbox. This name is used as an identifier and is listed in the profile listbox in the Report window.
write a brief Enter a description in the description Description textbox. of the profile. Make the profile public Select Yes in the Public listbox. Note: Making a profile public makes it available to other user's use when generating reports. Only the owner of a profile can edit or delete a profile.
Insert Enter text into the header line header lines textboxes. to the top of the report Include a logo
3. Click OK.
Select the logo to include from the Logo listbox, or click Add to add a new logo.
Adding Logos
Logos can be used at the top of reports. To add a logo to the list of options:
Administrator
the textbox.
Edit a Profile
Profiles can only be edited by the user who created them, even if the profile is public. To edit an existing profile:
1. Select the profile to be edited from the listbox. 2. Click Edit.
Enter a name for your profile in the Profile Name textbox. This name is used as an identifier and is listed in the profile listbox in the Report window.
The Profile window appears with the selected profile's values populating the fields.
write a brief Enter a description in the description Description textbox. of the profile. Make the profile public Select Yes in the Public listbox. Note: Making a profile public makes it available to other user's use when generating reports. Only the owner of a profile can edit or delete a profile.
82BioSAR Enterprise
CambridgeSoft Searching
View a Profile
BioSAR Enterprise allows users to generate reports for any publicly defined formgroup. After performing a search using a public formgroup, a Generate Report link is found at the top of the page. To view an existing profile:
1. Select the profile to be viewed from the listbox. 2. Click View.
Set the Select the color in the color of the appropriate listboxes header, footer, or detail in the report Adjust the font type, style, size, weight, or color of a particular part of your report Select the appropriate options from the listboxes to the right of the appropriate text block name.
Insert Enter text into the header line header lines textboxes. to the top of the report Include a logo
4. Click OK.
NOTE: Profiles can be edited, only by the creator of the profile. Select Duplicate to create a new profile using another profile's settings.
Duplicate a Profile
User can create a duplicate of an existing Profiles, even if the profile is public. To create a duplicate of an existing profile:
1. Select the profile to be duplicated from the
Select the logo to include from the Logo listbox, or click Add to add a new logo.
listbox. 2. Click Duplicate. The Profile window appears with the selected profile's values populating the fields.
Administrator
3. Change the appropriate settings:
Set the Select the color in the color of the appropriate listboxes header, footer, or detail in the report Adjust the font type, style, size, weight, or color of a particular part of your report Select the appropriate options from the listboxes to the right of the appropriate text block name.
Enter a name for your profile in the Profile Name textbox. This name is used as an identifier and is listed in the profile listbox in the Report window.
write a brief Enter a description in the description Description textbox. of the profile. Make the profile public Select Yes in the Public listbox. Note: Making a profile public makes it available to other user's use when generating reports. Only the owner of a profile can edit or delete a profile.
Insert Enter text into the header line header lines textboxes. to the top of the report Include a logo
4. Click OK.
Select the logo to include from the Logo listbox, or click Add to add a new logo.
Delete a Profile
Profiles can only be deleted by the user who created them, even if the profile is public. The default profile can not be deleted.
84BioSAR Enterprise
CambridgeSoft Searching
to adjust. 4. Click Edit. 5. Select the link for the appropriate table under Field Options. 6. Scroll to the appropriate field and set the width to the width you would like to see in your report.
7. Click Save Changes and return to your form. 8. Generate the report again.
to adjust. Click Edit. Click on the link in the Field Order column. Use the Arrow buttons to move fields up and down. Click Save Changes.
Administrator
86BioSAR Enterprise CambridgeSoft Manage Users and Roles
Managing the huge data streams of new lab technology is a key challenge. Registration Enterprise organizes information about new compounds according to an organizations business rules, while Inventory Enterprise works with Registration Enterprise and ChemACX for complete management of chemical inventories. CombiChem Enterprise and Formulations & Mixtures are also important parts of research data management.
87
Administrator
88 CambridgeSoft
Chapter 5: Inventory
Desktop / Workgroup
Inventory is an application designed to manage the chemical and reagent tracking needs of laboratories and research centers. The system manages data associated with both commercially procured and internally produced chemical substances from their procurement or initial production through their depletion and disposal. To meet the needs of institutions of all sizes, Inventory comes in two Desktop editions (Pro and Ultra), a Workgroup edition, and a web - based Enterprise edition. Inventory Workgroup is a thick-client SQLServerbased product. Suitable for larger organizations that dont have the ability (or dont want) to maintain an Oracle server, it requires, but does not include, a SQLServer license.
MSDE is optimized for 5 concurrent users. The word optimized is important here. With up to 5 concurrent users, MSDE will perform just like all other SQL Server editions. When more users are connected, and all query the server, MSDE will throttle the speed. If the clients are connected, but are not active, nothing will happen. MSDE will slow down only when more than 5 queries arrive at the server at the same time.
CS Inventory Desktop/Workgroup
Inventory Pro is an all-inclusive desktop product. It includes Microsoft SQL-Server Desktop Engine (MSDE), the redistributable database engine for SQLServer 2000. No additional licensing is required. Suitable for single-user installations, the inventory database can accept up to five simultaneous queries with no degradation of performance. The connection to the database is not live except when you actually process a query, so the only practical limit to the number of computers connected to an Inventory MSDE database is the probability of more than five users attempting simultaneous queries. Inventory Ultra is the same MSDE-based product, but includes the DVD version of ChemACX, CambridgeSofts catalog of chemical products and suppliers.
Inventory Enterprise
Inventory Enterprise is an Oracle-based, ChemOffice WebServer product. The rich feature set is designed for large organizations, it has a number of features not included in the Pro/Ultra/Workgroup versions. For more information about the Enterprise version of the product, see Inventory Enterprise on page 115.
Terminology
The three primary entities in an Inventory system are Locations, Substances, and Containers.
Location
An Inventory Location represents a physical location where one or more Containers may be stored. Locations can be nested within other locations to produce a hierarchy. The location hierarchy is
Inventory Terminology
89
represented as folders n a tree control analogous to that found in the Windows file explorer. The following is an example of a typical location tree:
Highly advanced duplicate checking is incorporated into the system. Only a single Substance may be associated with each Inventory Container. Aside from structure and name, substances can be identified via unique registry numbers such as CAS or ACX ID. Custom fields may also be defined. For information on defining mixtures as substances, see Mixtures on page 97.
Administrator
Container
An Inventory Container represents a physical container capable of storing chemical substances. While a Container may physically contain a complex mixture of chemical substances, Inventory is ideally suited for the assignment of a single (primary) chemical substance to each Container. Additional text fields are available to track other chemical contents such as the solvent. Typical container types include: bottle, vial, tube, cylinder, box, etc...
Substance
An Inventory Substance represents a single pure chemical entity which can be expressed as a two dimensional chemical structure drawing. The system maintains its own internal chemical structure database containing unique substances that can be associated with Inventory Containers.
90Inventory Terminology
CambridgeSoft
Inventory Desktop/Workgroup
Whats New in CS Inventory 10?
CS Inventory 10 new features include the following:
Role Based Security Audit Trail Managing EHS Data Duplicate Container Check-In/Check-Out Containers Change Quantity Change Status Multi Select Backup/Restore Database Logout
To facilitate administrators testing of new roles, CS Inventory now has a Logout feature. This allows an administrator to log out and log back in with a different username quickly and easily. The Logout command is on the File menu.
Desktop / Workgroup
These areas support browsing the inventory; that is, viewing locations, the containers present in them, and details of the substances in the containers.
Location Tree Menu Bar Container List
Enter your username and password to enter the database. Usernames are assigned Roles and Roles are defined by Privileges, which are specific tasks that a user with that role can perform. See Managing Roles on page 108 for more details.
Substance Details
The Location Tree shows all of the locations in the inventory. It is a collapsible hierarchical tree structure, like the Windows Explorer folders list.
91
The Container List displays the containers in the selected location. Use the scroll bar to view all of the containers in a location. The Substance Detail section is a tabbed frame that shows the details for the selected container. Five of the tabs are identical in all versions:
Summary Substance Supplier Quantities Comments
Format, and Description. In addition, the Enterprise version allows for defining reaction plate types. Required fields are indicated with color. The Edit Location form is the same as New Location, but without a Parent Location field. (You edit the parent location by using the Move Location command.) The Location forms are accessed from the Manage menu.
Administrator
Containers
New and Edit Container are tabbed forms with
The remaining tabs access features that are unique to the version or the way it is set up. For example, the Custom tab will only appear if you have defined custom fields.
many optional fields defining the container and the substance in it. The top-most tab contains the required fields.
Container forms are accessed from the Manage
Forms
In addition to the main Inventory GUI, there are a number of forms for creating and editing substances, containers, and locations, and for searching substances and containers. These are accessed from menus.
menu. The Search Container form is accessed from the Search menu. See Searching for Containers on page 101 for more information.
Substances
New substances are usually created along with new containers. For this reason, there is a link to the New Substance form on the New Container form. You can also create new substances from the Manage menu, but inserting them into containers then becomes a separate process. There are two options for inserting a substance into a container:
Locations
The New Location form has the same basic fields in all versions: Parent Location, Location, Location Name, Location Type, Location Owner, Grid
CambridgeSoft
create a new substance, or import from an existing database, such as ACX or the existing inventory database.
other data associated with any of these special locations, but may not delete them. Privileges associated with managing locations:
Desktop / Workgroup
Create
New Substance links
Delete Move
Edit
Location Tree
The location tree control allows navigation of the Location hierarchy. Click on the +/- symbols to expand/contract location folders. Click on the location name to display its contents in the container list frame. Right-click on a location to display a context menu of Location commands.
Additional fields
Managing Locations
A location is defined as any place that a container, plate, or another location can be stored. This includes a laboratory, a refrigerator, or even a particular shelf. Different facilities can decide how best to organize locations. Inventory comes with five special locations: Root, Disposed, Missing, On Order, and Trash Can. You may edit the names and
To add a new location: 1. Click the New Location command on the Manage menu. The Create New Location form appears.
NOTE: Plate types are not currently supported in the
level up from your new folder). If you pointed to the parent folder before opening the dialog box, the correct location will be entered automatically. You may use the Browse button for one-click entry of the correct location.
93
3. Enter the remaining information. Location Name is the only required field. Inventory will fill in the Location barcode field automatically
unless you enter your own value. (In either case, it will assign an internal location ID number.) 4. When you have finished entering data, click OK. The new location appears in the tree under the parent, in alphabetical order.
Editing a Location
After a location is created, its properties may change. For example, when a particular laboratory was initially set up, a number of containers were placed on a shelf. As the laboratory grew, it was necessary to move the containers to a cabinet. The simplest way to reflect this change in Inventory is to change the location type. Rather than create a new location, you can edit the existing location. To change the properties of a location: 1. Browse to the location to be edited in the Location Tree. Click the Edit Location menu command.The Edit Location form appears. 2. Make sure the information listed in the window that opens is for the correct location. 3. Enter the desired new information in the window. 4. Click OK.
To move a location: 1. Browse to the location to be moved in the Location Tree. 2. Click the Move Location menu command. The Move Location form appears. 3. Make sure the information listed in the window that opens is for the correct location. 4. Enter the new parent location in the Destination Location text box. 5. Click OK. The location and all of its sublocations and containers is moved to the new parent location.
Administrator
Deleting a Location
If a location needs to be removed from the inventory system, you should use the delete location tool. If the location is merely being moved, see Moving a Location on page 94. To delete a location: 1. Browse to the location to be deleted in the Location Tree. 2. Click the Delete Location menu command. The Delete Location form appears.
NOTE: As a safety precaution, a location can only be deleted if it is empty. You can override this precaution by selecting the Recursively delete related locations and containers checkbox. Use this checkbox with caution. You cannot undo the deletion of a location.
Moving a Location
After a location is created, it may be necessary to move the location to somewhere else in the tree. For example, a refrigerator may have been located in a lab on the first floor, but is being moved to a lab on the third floor. Of course all of the containers inside the refrigerator are moved along with it. It is easy to move a location along with all of its contents in the Inventory system.
CambridgeSoft
when you choose to refresh, that branch of the tree is not contracted: the location will remain open for you to work with. To refresh the Location Tree:
Click the Refresh menu command.
ACX for the substance, then add it to the inventory database. To create a new substance: 1. Click New Substance on the Manage menu or create a new container, then click the New Substance link on the New Container Substance Tab.
Desktop / Workgroup
Managing Substances
Substance records store the chemical structure, formula, and molecular weight information of the compounds in your inventory. Each record is identified with a substance ID number, and may also contain a CAS number and/or ACX number for cross-reference purposes. If you have administrator privileges, you can also add up to five custom fields that connecting users can subsequently populate when defining a new substance. Privileges associated with managing substances are:
Create Edit delete MSDS Delete Create MSDS
Each substance has only one record in the database. If you create a new substance that matches an existing one in any field (except supplier) a conflict resolution window appears, showing you which fields match (see Conflict Resolution on page 97). To avoid unnecessary conflicts, it is a good idea to perform a search before creating a new substance.
required field.
NOTE: Custom fields may also be designated as
required.
3. To add a structure, click in the Structure field.
The structure field box is outlined in blue, and the ChemDraw toolbar appears. 4. When you have finished filling in the fields, click OK.
95
To create a new substance from the ACX database: 1. Search the ACX databasedo one of the following: Click Substances on the Search menu Click the Select Substance link on a New Container form. 2. On the search form, select the ChemACX radio button in the Databases section. 3. Select the search type (if you are doing a structure search).
TIP: The default Substructure is generally used for
automatically. If a conflict is found in the database with any field entry, the Conflict Resolution page appears. See Conflict Resolution on page 97.
Administrator
either a name or formula or structure is used. 5. Click the Search button. In a few seconds, you will see the results in the Search Results form. Click the entry to see the detailed form shown in . 6. If you want to add a supplier from the ChemACX list, click the Show Suppliers link. The supplier list for that substance appears.
add link
insert
show suppliers link 7. Click the Insert button to add the substance to
the inventory database. When you create a new substance record, Inventory searches the database for duplicates, and gives you an opportunity to resolve any conflicts. Only if there are no conflicts will the substance be added
enter: a CAS number a CAS number plus supplier a CAS number plus supplier and catalog number a supplier and catalog number. 3. Browse to the file containing the MSDS data. 4. If you want to create a link to the file, select the Add link check box. If you do not select the Add link checkbox, the file will be copied into the database. While this is the safest way to make sure that the MSDS will be available, it also adds considerably to the size of the database. You may also enter a link to a web page or intranet page by using the link option.
CambridgeSoft
Once you have added one or more data sheets to the CAS number, you may view them by clicking the MSDS link on the container details window. The ability to define MSDS by CAS number, supplier, and catalog number allows you to view different data sheets from different containers of the same substance when this is appropriate. If you want to search in ChemACX for data sheets, point to Preferences on the File menu, point to MSDS, and select the Search ACX option.
NOTE: You must have the ACX database installed to do
fieldincluding reactions (with arrows) and labels. While this may not be particularly useful, and might cause problems when searching, it does give you the flexibility to draw multiple structures and define them as a single substance. Note that the Molecular Weight and Chemical Formula (which are generated automatically) will be for the total of all structures in the field.
Desktop / Workgroup
Conflict Resolution
Conflict Resolution flags and corrects duplicates in the system. When creating a new substance in Inventory, Conflict Resolution runs automatically. You may also search for duplicates at any time. If a conflict is found, a page like this one appears. The conflicting field(s) are highlighted in red.
this.
Using ACX
If you have installed and linked the ACX database, you may search in it for compounds.
Mixtures
Normally, a Substance is defined as a pure chemical compound. However, Inventory, with some customization, may be used to define mixtures. Depending on the approach that makes the most sense for your users, you could choose to use either the custom substance fields or the custom container fields. For example, to define solvent mixtures commonly used in reversed phase chromatography, each of which contain various percentages of methanol, acetonitrile and tetrahydrofuran, use the custom substance fields (of which there are five available). The Substance name would identify the mixture (e.g. Name = HPLC Mixture 10% Methanol), and the custom compound fields would identify the exact composition (e.g. Mixture Component 1 = 10% methanol, Mixture Component 2 = 6% acetonitrile, Mixture Component 3 = 4% THF). This is not, however, the only way to handle mixtures. Anything you can draw with the ChemDraw toolbar can be stored in a structure
Cl
Name conflict
Cl
Structure conflict
In the example above, the existing substance and the new substance share the same Substance name and structure. From here, the user has up to three options:
Select an existing substance (thus cancelling the
new substance). Edit the conflicting substance or the existing substance so there is no longer a conflict. Create a duplicate substance and resolve the conflict later.
97
To select one of the existing substances rather then adding a new substance, click Select. You will be returned to the Create New Container form with the substance inserted.
Conflict Resolution - Edit
for more information. If there are no duplicate fields, Inventory saves the changes to the database.
Managing Containers
Containers are the main focus of Inventory. You track your use of chemicals, ordering, reordering, and disposal by tracking the containers. Privileges associated with managing containers are defined in
Create Edit Checkin Change status Print container label Delete Move Checkout Change quantity
Administrator
To edit the duplicate substance or an existing substance: 1. Click Edit for the appropriate substance. The substance record appears. 2. Edit the appropriate fields. 3. Click OK.
Conflict Resolution - Create Duplicate
To create the duplicate, click Create Duplicate. You will be returned to continue creating a new container with the substance inserted. Creating a duplicate is not recommended. You must have appropriate permissions to delete duplicate substances.
Editing a Substance
To edit a substance: 1. Choose Substances... from the Search menu. The Substances search form appears. 2. Fill in the desired field(s) and click Search. A hit list of matching substances appears. 3. Select a substance. The substance details appear in the lower pane. 4. Click Edit. The Create/Edit Substance form appears. 5. Make the desired changes, and click Update. If a duplicate for any required field is found in the system, the conflict resolution page appears. See Conflict Resolution on page 97
you to enter supplies such as glassware or disposables into the inventory. If you dont enter a substance, you will get a warning when you try to create the new container. You may safely click OK and ignore the warning. If you dont want to see the warning, create a dummy Substance (such as a letter or word) for nonchemical supplies.
3. Click OK.
CambridgeSoft
Editing a Container
To edit a container: 1. Select a container to edit. 2. Click the Edit Container on the Manage menu. The Edit Container form appears. This form is identical to the Create Container form. 3. Enter new values and click OK.
From the File menu, point to Preferences and click Default Checkout Location. If you do not set a checkout location preference, the default will be Root. Since Root cannot hold containers, only locations, you will need to change the Destination Location every time you check out a container. Failure to do this will result in an error message, reminding you to change the location. To check out a container: 1. Select a container. 2. Click Check Out Container on the Manage menu.
TIP: You can also right-click on the container and use
Desktop / Workgroup
Moving a Container
To move a container to another location: 1. Select a container to move. 2. Click the Move Container on the Manage menu. 3. Enter the destination location in the Move Container form and click OK.
TIP: Right-click on a container icon to get a context menu
the context menu. The Checkout Container dialog box appears. 3. Review the default settings, change as required, then click OK.
NOTE: The default status is in use, the default
of Container commands. You can also drag-and-drop containers to move them from location to location.You may select multiple containers to move simultaneously. See Multi Select on page 100 for details.
user is the one checking the container out. The container is removed to the selected location, and its status is reset. Checking a container back in follows a similar process. The defaults on the Check In Container dialog box are to set the status to Available and to return the container to the location from which it was checked out. The default Current User does not revert to the previous user.
Deleting Containers
To delete a container, drag or move it to the Trash Can. To remove containers completely from the database, click the Empty Trash Can command on the Manage menu.
Duplicate Container
A new command on the Manage menu allows you to duplicate an existing container. The duplicate contains an exact copy of all fields, except the Quantity Remaining field, which defaults to the container size, and the Container ID and Barcode
Check-In/Check-Out Containers
Containers can be checked in and out of locations. If you routinely work at a specific location, you can set a default Destination Location.
99
fields, which gets new values. The command is useful when restocking chemicals from the same supplier.
Move Delete
available on the context menu displayed when you right-click in the Container Grid.
Change Quantity
If all you want to do is change the amount of material left in a container, CS Inventory gives you a simple way to do that. 1. Select a container. 2. Click Change Quantity on the Manage menu. A dialog box appears where you can enter either the amount remaining or the amount used. When you click OK, the quantity field in the container is updated.
To enable multi-select: 1. Check Multi-select Containers from the View menu. A row of checkboxes appears in the Container Grid. 2. Select the containers, then right-click in the Container Grid. From the context menu select Move Selected Containers or Delete Selected Containers. If you selected Move..., a browse window opens to help you navigate to the new location.
Administrator
Change Status
To change the Status of a selected container, click the Change Container Status command on the Manage menu and select a status from the dropdown list on the dialog box. There are 23 predefined statuses, including order statuses (backordered, requested, etc.). The list may be edited from the Edit submenu of the Data menu. Status is displayed in the Container Details, and can also be changed from the Edit Container dialog box. You may search by status by selecting Container Status on the Advanced Search tab of the container search dialog box.
editing forms. EHS data has two levels: Substance and Container. You begin by creating substance-level data. You may then modify it at the container level to allow for differences due to different suppliers or product IDs. To create EHS data: 1. Use the Search>Substances menu, or on the main page, browse to a container of a substance for which you want to create EHS data.
Multi Select
The Multi Select menu command places a checkbox next to each Container ID in the container list. This allows you to select more than one container and perform one action on all of those containers at once. The actions available to Multi Select are:
CambridgeSoft
form.
supplier information will appear at the top of the form if you have entered it. If you have not entered supplier information, your modifications apply to the container you are modifying. To edit the EHS queries: 1. Select Edit EHS Report SQL from the SQL menu. 2. Select the report to edit from the drop down menu at the top of the form. 3. Click the Edit button. A duplicate window opens with an editable copy of the SQL. (The first window is only for viewing.) 4. Make your changes and click the Update button.
Desktop / Workgroup
EHS tab Add EHS link 3. Click the Add Substance EH&S link.
The EHS form appears. 4. Enter the EHS data. Note that the only required fields are automatically filled in.
TIP: The names of the three EHS groups can be
modified on the EHS tab of the Custom Fields preferences. You can also add up to ten Custom Fields. To modify EHS data in a container: Click the Edit EH&S link on the EHS tab of the container details form. The EHS tab of the Container form has a Help link that brings up a document explaining the EHS categories. The default glossary is a Word document with UN Numbers, NFPA categories, and ACGIH carcinogens. You can edit this document, or replace it. To replace the EHS glossary: 1. Point to Update on the Data menu and click EHS Glossary Doc. 2. Enter a path or Browse to a file. 3. If you do not select the link checkbox, the file will be added to the inventory database. 4. Click the Add button. Enter data in the EHS data form. If you have entered data for the supplier and catalog number, the edited EHS data will apply to every container from that supplier with that catalog number. The
Searching Inventory
Searching is the easiest way to find particular substances or containers in Inventory. The system allows for combined chemical and text searches of all attributes associated with a container or substance. Several search forms are available to accommodate the search preferences of different users. For example, the Substructure Search form, for searches based on chemical structure, substance name, CAS number and other attributes, is particularly well suited for use by chemists. Similarly, the Advanced Search form, which exposes fields such as container and location barcode, is particularly well suited for use by stock room or receiving room personnel.
This displays a tabbed search form for all search types. Click on the tab indicating the type of search you would like to perform, and enter your search parameters.
101
Simple Search
The Simple Search option allows you to use any combination of basic criteria, such as CAS Registry number, Container Barcode, Location Barcode, Catalog Number, Substance Name, Substance Synonym, Container Name, Container Comments, and/or Location ID. How to search: 1. Enter the search criteria. 2. Select the Search Sublocations checkbox if you want to search all sublocations of the chosen location. 3. Click Search.
NOTE: Inventory always does substring searches on text queries. Thus, entering benz in Substance Name will return Benzene, Benzyne, Bromobenzene, and so forth.
Advanced Search
The Advanced Search option adds a number of categories to the basic Simple Search, such as Purity, Concentration, Grade, Container Size, Container Status, Unit of Measure, Quantity Remaining, and so forth. This search concentrates more on container properties as opposed to substance properties. How to search: 1. Enter the search criteria. Custom fields, if defined, will appear on this search form. Any additional fields have been defined for your site. Please see you system administrator for more details. 2. Select the Search Sublocations checkbox if you want to search all sublocations of the chosen location. 3. Click Search. A list of containers matching your search parameters is returned. Clicking on one of the containers will allow you to view, the location of the container (left frame), container information (upper right frame), and the contents of the container (lower right frame). See Managing Containers on page 98 for more information.
Administrator
A list of containers matching your search parameters is returned. Clicking one of the containers will allow you to view the location of the container (left frame), container information (upper right frame), and the contents of the container (lower right frame).
Substructure Search
The Substructure search option includes most of the criteria in the Advanced Search, in addition to Substance Name, Molecular Formula, MolWeight Range, and of course, Substructure.
location contents information
To draw a structure, double-click in the structure box. Use the ChemDraw toolbar to draw your substructure. For more information about using the ChemDraw toolbar, see Drawing Chemical Structures in the ChemDraw User's Manual.
CambridgeSoft
You may include generic atom types, such as X for any halogen, or R for an unspecified organic group, in your query structure. In fact, you can include any query specifications (except those specific to reactions) available in ChemDraw. For more information, see Drawing Query Structures in the ChemDraw User's Manual. You have a choice of how Inventory will match the structure you draw to the structures in the Inventory database. Select the correct type from the Search Type drop-down menu.
Substructure
nature, fuzzy. For this reason, similarity searches are useful if you have a general idea of the types of compounds you are looking for, but dont have a precise conception of the target compound.
Search Preferences
Desktop / Workgroup
You can set a number of defaults that affect how Inventory performs structure searches.
Click Preferences in the File menu (or on the
Search form.)
The Search Preferences form appears. How to search: 1. Enter the search criteria. 2. Select the Search Sublocations checkbox if you want to search all sublocations of the chosen location. 3. Click Search. A list of containers matching your search criteria is returned. For information about Searching for substances and their properties, see Searching for Substances on page 103.
Substructure searches find structures that contain the query, plus any additional attachments at the open positions. Use this search type to find classes of compounds.
Exact
Exact searches find structures that completely match the query. You may get more than one hit if there are stereo-isomers in the inventory and you did not specify a particular one to be matched, or if you included a generic atom type.
Identity
The Identity search type is intended for use in compound registration, when you must know if a perfectly identical copy of your query compound is already present in the database. It is similar to an exact search, except that generic atom and bond types in the query must match corresponding atom and bond types in the target exactly. Moreover, stereochemistry must match precisely between query and target.
Similarity
A Similarity search finds structures that have structural features that generally correspond to those in the query. Similarity searches are, by their
103
Entering search criteria and performing the search are exactly the same as with a Container search. See Substructure Search on page 102 for details. 1. Enter search criteria and click Search. If you are searching for duplicate substances, select the checkbox at the top of the form. Inventory will search for duplicates according to the fields you enter. For more information on resolving duplicates, see Conflict Resolution on page 97. A hit list appears. 2. Select a substance from the hit list. A details frame opens in the lower pane. 3. Click Edit to edit the substance details. For more information, see Editing a Substance on page 98. 4. When you have finished editing, click OK.
NOTE: Right-click on a substance icon to delete a
SQL queries. Once a user with SQL privileges defines a custom SQL query, it can be used by other users.
Help
Administrator
dialog box, you can set the default format for Help to either PDF or MSWord doc. Privileges associated with managing printing are defined in
Print report Print container label
Labels
The standard Inventory installation includes the following sample templates:
eight barcode label four standard label four EHS-data label.
You may also design your own labels. To print labels with a standard template: 1. Select a location. 2. Choose Labels... from the Report menu. The Inventory Report dialog box appears, with Label selected as the Report Type. 3. Click the Print/Preview/Export... button. The Generating Labels window appears.
CambridgeSoft
button.
TIP: If you click Open without selecting a file, you will activate the template Wizard to help you design a new template.
Print label
Desktop / Workgroup
The Print Options dialog box appears. The Inventory Report dialog box appears, with Label selected as the Report Type. 3. Proceed as with multiple labels. The only difference is that the data for a single label only has been passed to the print utility. To create a new label template: 1. Select a location. 2. Choose Labels... from the Report menu.
NOTE: If there are no containers in the location you
5. Use the Direct to... drop down menu to select
Direct to
Start position
Preview mode, or to send the output to a file instead of printing. 6. When you have selected your options, click Start. Labels are printed for all of the containers in the selected location.
TIP: Note the Start Position option. It allows you
Report dialog box. 4. Enter a new file name in the File Name text box of the Generating Labels window. The List & Label Project Wizard appears to walk you through the new label creation process. To change the label style: 1. Select a location. 2. Choose Labels... from the Report menu. 3. Click the Design... button on the Inventory Report dialog box. 4. Select an existing label template and click the Open button. The List & Label design page appears. 5. Select Page Setup from the Project menu. 6. Select the Templates tab.
utilize partially used label sheets by adjusting the start position. To print a label for a single container: 1. Select a container, either by browsing or searching.
105
ERO, Herlitz, Herma, and Leitz standard labels, and double-click to select it, then click OK. 8. Adjust the label components to fit the new label size as necessary, then close and save your changes to the label file.
NOTE: You may want to test for the positioning of the printed labels by printing a a sample page and adjusting the dimensions in the designer as necessary.
3. Use one of the sample queries provided (for example, GenericEHSQuery1), or a custom 4. 5. 6. 7.
EHS Labels
You can produce EHS labels for one or more containers. 1. Select a location or a container. 2. From the Report menu, point to EHS and select the appropriate label option.
query created in-house Click the Print/Preview/Export button. A dialog opens to select the report template. Select the file GenericEHSQuery.lbl, or create your own custom template. Click the Open button. The Print Options dialog box appears. Select your print options and click the Start button.
TIP: You can preview the labels by selecting Preview
Administrator
in the Direct to... text window. If you are printing a large number of labels, Preview may take several seconds to produce results.
Reports
Inventory can print reports in two basic styles: with structures and without. When you choose Location Report (include structures), Inventory creates graphic files (*.emf) from the structural data to import to the print utility. This can be a time-
CambridgeSoft
consuming process, especially for a large inventory. You should consider the time factor when deciding which report command to use.
NOTE: The names of all of the available report templates
appear when you select either report type. If you select a template with structures, but are using the command that does not save images of the structures, the Structure column of the report will be blank. Printing reports is similar to printing labels: select a location, select the style of report to print from the Report menu, and step through the dialog boxes. As with printing labels, you can design your own template rather than selecting one of the existing ones.
TIP: The Print Preview option in the Print Options dialog
3.
4. 5.
6. 7.
box allows you to print, save to file, or send an email of the report in PDF, text, or graphic format.
the appropriate report option. You can get a report broken down by location and sub-location if you wish. The Report dialog appears Use the default SampleTotalQuantities_List query (or SampleTotalQuantities_Base Units_List) query, or create your own custom query. Click the Print/Preview/Export button. A dialog opens to select the report template. Select the file SampleEHSTotalQtys.lst (or SampleEHSTotalQtys_BaseUnits.lst), or create your own custom template. Click the Open button. The Print Options dialog box appears. Select your print options and click the Start button.
Desktop / Workgroup
CS Inventory 10 includes more sample report forms, including EHS report templates. When selecting a report template based on a user-defined SQL query (whether for design or printing) such as the EHS templates, you must choose one that matches the defined query. If the fields in the report template do not match the fields in the selected SQL query, you will get an error message.
EHS Reports
EHS reports are produced in a similar manner to EHS labels.
NOTE: You must select a query that matches the report
Inventory Tasks
The following tasks may be performed by users who have been assigned the privilege. If you do not have access to something you need access to, please see your system administrator:
Search (Browse) View Audit Trail
you wish to produce. If you do not, you will get an error message. A typical report for total quantities of EHS materials would be done as follows: 1. Select a location (Root, if you want the report to be for the entire database.)
107
The Inv_Admin role cannot be deleted, though it can be modified. Other Roles and Users may be added, modified, or deleted only by the database owner, invadmin. Users can change only their own passwords.
NOTE: There is a difference between the role Inv_Admin and the user with the name invadmin. User invadmin is the database owner, and has security permissions in MSDE. Users with the Inv_Admin role can make changes in the Inventory database, but cannot administer Users and Roles.
Administrator
status
Checkin container Create location Edit location Create substance Edit substance Create MSDS Print labels Edit SQL report
quantity
Checkout container Delete location Move location Delete substance Edit EHS data Delete MSDS Print reports
Managing Roles
To create or edit a Role: 1. Click Manage Roles on the Security menu. 2. Click the appropriate button at the bottom of the Manage Roles dialog box. explains the options.
Button
Function
records
Backup the database
fields
Update Role Edits the selected role. Users Adds users to the selected role. Used to populate new roles or change user assignments to existing roles.
CambridgeSoft
Button
Function
Manage Roles dialog box. 3. Select users and Add or Remove them from the Role with the buttons.
Desktop / Workgroup
Roles
Assigns all of the privileges of one or more roles to the selected role in a single step. This nesting capability gives you a consistent way of assigning hierarchies of privileges. Deletes the selected role.
Managing Users
To create, modify, or delete a user account: 1. Click Manage Users on the Security menu.
NOTE: These options only appear when you log in as
Delete
When you add or edit a Role, you work with the same dialog box. The only difference is that you have to type in a Role Name when adding a new Role. When editing, the name is grayed out, and cannot be changed. Check the privileges that will define the Role.
NOTE: The INV_BROWSE_ALL privilege is, by
the Manage Users dialog box. You must select a User before clicking Update User.
default, assigned to all roles. It cannot be unchecked. To nest roles within other roles: 1. Click Manage Roles on the Security menu. 2. Select a Role, and click the Roles button on the Manage Roles dialog box. 3. Select a Role and Add or Remove it with the buttons. The Role named in the Role Name text box now includes all of the privileges of those Roles that appear in the Current Roles window.
NOTE: If you inspect the privileges list for that Role, you will not see additional boxes checked. The checked privileges are only those that have been assigned directly.
When adding or modifying users, the Edit User dialog box appears. When modifying a user, the Username and Password text boxes are grayed out and cannot be changed.
TIP: Normally, users maintain their own passwords.
Thus, the Password text box is blocked from editing to prevent accidental changes. You can, however, override this by checking the Change Password checkbox.
3. Enter appropriate data in the text boxes. User Name and Last Name are the only required
fields. Blank passwords are acceptable. There is no specific requirement for a User Name or Last Name, but the text boxes cannot be left blank. Any alphanumeric or symbol may
109
be used. A User Name, once created, cannot be modified. To change a User Name, you must delete the user and create a new name.
NOTE: Deleting a User Name in Inventory does not
Suppliers
The default Supplier list has over 300 entries. To make it easier to find the correct supplier from the list, an administrator can not only add new suppliers, but can abbreviate the displayed list. To abbreviate the supplier list: 1. Point to Abbreviate on the Data menu and click Supplier List. 2. Deselect suppliers that will not be used in the Show column.
NOTE: The deselected suppliers are not removed from the database. They are merely not displayed. They can be restored at any time by reselecting them on the list.
3. Click the Save Changes button when you have
Administrator
Managing Tables
Some fields in Inventory forms are entered from drop-down menus rather than by typing in text. Inventory stores these pre-set field entries in tables that can be edited by an administrator. If, for example, you want to specify a type of Container that is not on the container type menu, the new type can be added. You can also delete items from the tables, provided they are not being referenced by any records in the Inventory database. To edit a table: 1. Select the table to edit from the Data menu. 2. Fill in the attributes in the form that appears, and click OK. Inventory stores the changes to the table. To edit or delete a table entry: 1. In the Data menu, point to Edit and select the table to edit. The table is displayed. 2. Do one of the following: a. Edit the text as required. b. Select the entire row you wish to delete, and press the Delete key. 3. Click Save. Inventory stores the changes to the table.
Custom Fields
If you have Inventory administrative privileges, that is, if you are logged in as invadmin, you can add custom fields to compound, container, and EHS records. Compounds can have up to five custom fields. Containers can have up to ten custom fields and five custom dates. You may also add up to ten custom fields for EHS data. Custom fields and dates can be designated as required fields. Custom compound fields can be marked for duplicate checking. To add custom fields: 1. From the File menu, point to Preferences and select Custom Fields. The Custom Fields dialog box appears. 2. The Custom Fields form has three tabs: one for compounds, one for containers, and one for EHS data. Click the appropriate tab, and enter the name of the new field(s).
CambridgeSoft
The fields will appear on the blank forms when you open them.
NOTE: The custom fields appear directly on the Compound form. For containers, they appear on the tab labeled Custom, and when applicable, on the tab labeled Substance. When browsing containers, the first custom field defined is displayed on the Summary tab.
Desktop / Workgroup
Custom Field
Field Name
Field_1 etc. Date_1 etc. ALT_ID_1 etc.
Record Locking
Administrators can turn record locking on or off. When record locking is turned on (the default), a record (that is, a container or a substance thats being edited) can only be accessed by one user at a time. An administrator can unlock records to allow immediate concurrent access. When records are locked, a second user attempting to edit an open record will receive a notification message that the record is currently open, and cannot be accessed. If a user leaves a record open, but inactive, for more than 10 minutes, the lock times-out, and other users can access the record. When the original user returns to the record, a message is displayed warning the user to resave any changes.
Backup/Restore Database
CS Inventory 10 includes a backup/restore utility for your database. The utility requires you to quit the application in order to run. To backup or restore a database: 1. Click Backup/Restore DB on the Data menu. A message appears telling you that you must quit the Inventory application to continue. 2. Click Yes to continue. The application quits and a Backup dialog box appears. 3. Click the Connect button to connect the utility to SQLServer. A message appears at the bottom of the dialog box, recommending that you back up both the CS Inventory (CHEMINVDB2) and CSSecurity databases. 4. Type in the path, or browse to the location of the backup Inventory database file. The default location is...\All Users\Application Data\CambridgeSoft\Backup\ CHEMINVDB2.bak. 5. Browse to the location of the backup MstFiles folder. The default location is in the ...\CambridgeSoft\Backup\ folder.
select Container Grid Display. The Grid Display form appears. You can change the Field Name, Column Order, and Column Width. You can also select which fields will be displayed. Clicking the name of a column in the grid form sorts the entries by that column. This is to facilitate rapid editing; it does not affect the display.
111
the CSSecurity DB backup file. The default location is in the...\CambridgeSoft\Backup\ folder. 7. If you check the Append timestamp checkbox, you will create a new backup DB file with the date and time in the file name. If you deselect the checkbox, Backup will append data to the existing backup database file, if there is one. 8. Click Backup. After a brief delay, a message appears advising you of a successful backup. To restore a backed up database: 1. Repeat steps 1-3 of the backup procedure. 2. Click the Restore tab of the dialog box. 3. Type in the path, or browse to the previously created backup file. When you click the browse button, you will open the previous backup folder. You must select the correct file to restore. 4. Browse to the location of the backup MstFiles folder. 5. Browse to the folder to receive the restored MstFiles. 6. Type in the path, or browse to the backup CSSecurity DB file. 7. Click the Restore button to restore the database.
Administrator
Audit trail
Output area
Filter settings
The filter settings both limit the data that appears in the report, and determine how it is presented. Each setting has a blank position that signifies no filtering on that parameter.
Audit Trail
CS Inventory logs all changes relating to Locations, Containers, and Substances. You can view this log and print out reports, filtering the data according to your needs. Output can be directed to a printer or to a file. Output file formats include PDF, Excel, text, HTML, and RTF. You must be assigned the View Audit Trail privilege in order to do this.
Use Filter...
Table
CambridgeSoft
Results per Page and Use Filter... if you want to... Order Results By
Desktop / Workgroup
view changes by date. Select filter dates from a calendar display or type in the text box. view changes by a specific user. view the changes for a specific container. view the changes for a location. view the changes for a specific substance. view a specific type of change: Insert, Update, or Delete
Current User
Print buttons
Structure code
View link
Compound ID
A new template, AuditTrailReport, has been added to the default report templates listed when you click the Design or Print buttons. When you are reviewing changes to Structures, the Audit report displays only a structure code. The View link in the last column on the right allows you to display the structures. See annotations in and
Action
Note that when you create a new Container, Substance, or Location, you insert data for every field. Every edit or move is logged as an update to the field(s) that have changed. When you delete a Location or Substance, or empty the Trash Can, each field in the item affected is deleted. When you have selected the filters you want to apply to the data, click the Filter button to view the results. You can reset the filters, or change them individually, to view a different data set. The filters also give you two controls over the output format:
For more information on designing and printing reports, see Printing Labels and Reports on page 104.
113
Administrator
114Inventory Desktop/Workgroup Inventory Tasks CambridgeSoft
Inventory Enterprise
Inventory Enterprise is a ChemOffice Enterprise based application designed to manage the reagent tracking needs of chemical and pharmaceutical research centers. The system manages data associated with both commercially procured and internally produced chemical substances from their procurement or initial production through their depletion and disposal. Inventory Enterprise is an Oracle-based, ChemOffice Enterprise product. Designed for large organizations, it has a number of features. This chapter introduces the terminology and the User Interface, describes the set-up and management of an inventory database, and discusses the search forms used to locate substances and containers in the inventory. The three primary entities in the system are Locations, Substances, Containers, and described below: Click the Browse link under Inventory Enterprise to view the Inventory database.
NOTE: Administrative tasks relating to login, such as adding users and changing passwords, are covered in other sections. For Enterprise versions, Manage Users and Roles on page 192.
.......................................... Enterprise
Logging in
All versions of Inventory use a password based login. Logging in to Inventory Enterprise brings you to the ChemOffice Enterprise homepage.
How to search
1. Enter the desired information to search for. 2. Select the Search Sublocations checkbox if
you want to search all sublocations of the chosen location. 3. Select the Exclude Special Locations checkbox if you want to exclude special locations. 4. Click Search in the toolbar.
Inventory Enterprise
115
A list of containers matching your search parameters is returned. Clicking on one of the containers will allow you to view, the location of the container (left frame), container information (upper right frame), and the contents of the container (lower right frame).
A list of containers matching your search parameters is returned. Clicking on one of the containers will allow you to view, the location of the container (left frame), container information (upper right frame), and the contents of the container (lower right frame).
Administrator
Advanced Search
The advanced search option allows searching through the use of CAS number, ACX number, Reg Number, Purity, Concentration, Density, Grade, Size, Container Cost, Location ID, Container ID (barcode), Container ID (internal), Container Name, Container Type, Container Status, Unit of Measure, Qty Remain, Qty Available, Location Barcode, Compound Type, Catalog number, Supplier, Lot Number, Expiration Date, Ordered By, Date Ordered, Date Received, PO Number, Owner ID and Current User ID.
Substructure Search
The substructure search option allows searching through the use of all of the attributes in the Advanced Search in addition to Substance Name, Molecular Formula, MolWeight Range, and of course, Substructure. To allow you to draw your substructure, a ChemDraw Plugin will open along with this search tab. For more information about using the ChemDraw Plugin, see Drawing Chemical Structures in the ChemDraw User's Guide. Additionally, the structure drawn can be searched for assuming it to be a Substructure, Full Structure, Exact Structure, or with Tanimoto Similarity. Select the correct type under Search Type.
How to search
1. Enter the desired information to search for. 2. Select the Search Sublocations checkbox if
How to search
1. Enter the desired information to search for. 2. Select the Search Sublocations checkbox if
you want to search all sublocations of the chosen location. 3. Select the Exclude Special Locations checkbox if you want to exclude special locations. 4. Click Search in the toolbar.
you want to search all sublocations of the chosen location. 3. Select the Exclude Special Locations checkbox if you want to exclude special locations.
116Inventory Enterprise
CambridgeSoft
How to search:
1. Select the checkboxes next to the applications
structure checkbox if you want results grouped by chemical structure. 5. Click Search in the toolbar. A list of substances matching your search parameters is returned. Clicking on the details button of one of the substances will allow you to view, all of the inventory containers that contain that substance. For information about Searching for substances and their properties, Searching for a Substance on page 120. Deselecting the "Group results by chemical structure search box" will lead directly to a list of containers matching the search criteria (bypassing the substance grouping).
Global Search
The Global Search form allows users to search over the Registration Enterprise, ChemACX, or both, simultaneously with an Inventory Enterprise search. When results are returned, Inventory, Registration, and ACX results remain separate, but the application indicates if the retrieved substance is found in any inventory containers. The global search option allows searching through the use of Substance Name, CAS number, ACX number, Catalog number, Molecular Formula, MolWeight Range, Registry Number, Registry Sequence, Reg Alternate IDs, and Substructure.
you would like to search over. 2. Enter the desired information to search for. For more information about entering search criteria, see Searching ChemOffice Enterprise Applications on page 194. Additional fields may appear on this search form. Any additional fields have been defined for your site. Please see you system administrator for more details. 3. Click Search in the toolbar. A list of substances matching your search parameters is returned. 4. Click on the radio button next to the appropriate application to see results retrieved from that application. For more information, please see Viewing Results for a Global Search.
Viewing Results from a Global Search
.......................................... Enterprise
Search results from a global search are split into three lists, one for each application. To access results from an application, select the radiobutton next to the application's name. Results are initially listed by substance. To view the results by container, click the Details button for a substance. The Details button is only active if there is an associated container.
Plate Search
The plate search option allows searching through the use of Substructure, Substance Name, CAS Number, ACX Number, Reg Number, Molecular Formula, MolWeight Range, Purity, Concentration, Solvent, Location ID, Plate Barcode, Plate Map, Plate ID (internal), Plate Name, Plate Type, Plate Status, Unit of Measure, Qty Remaining, Qty Initial, Molar Amount, Supplier Name, Supplier Shipment Code, Supplier Shipment Number, Supplier Shipment Date, Date Created, Plate Format, Library, Group Name, and Freeze/Thaw Cycles.
Inventory Enterprise
117
add a new substance to the database. This option is available after entering the substance management area and clicking on Add Mode.
Administrator
you want to search all sublocations of the chosen location. 3. Select the Exclude Special Locations checkbox if you want to exclude special locations. 4. Click Search in the toolbar. A list of plates matching your search parameters is returned. Clicking on one of the plates will allow you to view, the location of the plate (left frame), plate information (upper right frame), and the contents of the plate (lower right frame).
This form is also available from the New Container Substance Tab, Substance Tab on page 129. Following screenshot appears.
Substance Management
The substance management area of Inventory Enterprise is available in the uppermost toolbar of the homepage and search page. This area allows users to search for substances by substructure, registration numbers, and other physical properties. Although similar to the types of searches found on the homepage, this area concentrates on the searchable aspects of substances and returns a table of substances as opposed to containers. If you have the appropriate privileges, in addition to allowing you to search for substances previously entered, this area also gives you the opportunity to How to create a new substance:
1. Enter information about the new substance.
NOTE: More fields may appear in your form. These forms are customized for your site. Please see your system administrator for more details.
2. Click Add Record in the toolbar.
If a conflict is recognized in the system (i.e. the same structure or Substance Name), the Conflict Resolution page appears. Otherwise, the substance is added to the system.
118Inventory Enterprise
CambridgeSoft
3. Click OK.
The New Substance Conflict Resolution is used to flag and correct duplicates in the system. After creating a new substance in Inventory Enterprise, the Conflict Resolution page appears if there is a conflict in any unique fields. Unique fields are defined by the system administrator, but by default are substructure, Substance name, CAS number and ACX number. This only checks conflicts within Inventory Enterprise, not with Registration Enterprise and ChemACX. If a conflict is found, a page like this one appears:
To select one of the existing substances rather then adding a new substance, click Select in the grey header bar above the substance you would like to select. You will be returned to continue creating a new container with the substance inserted. Conflict Resolution - Edit To edit the duplicate substance or an existing substance:
1. Click Edit in the grey header bar above the
.......................................... Enterprise
The conflicting field is highlighted in red. In the example above, the existing substance and the conflicting substance (which is being added) share the same substructure. From here, the user has three options: Conflict Resolution - Select The option to select an existing substance and abort the new substance creation, is only available if the user is currently creating a new container. This option is not available from the Substance Management area of the application.
3. Click OK.
Conflict Resolution - Create Duplicate The option to create a duplicate by adding the new substance regardless of the conflict, is only available if the user is currently creating a new container. This option is not available from the Substance Management area of the application. To create the duplicate, click Create Duplicate in the grey header bar above the conflicting substance. You will be returned to continue creating a new container with the substance inserted.
Inventory Enterprise
119
Creating a duplicate is not recommended, but is an option. To later search for all duplicates in the system, select System Duplicates from the Compound Type listbox in the Advanced Search form.
Creating Inventory Substances from Registration Enterprise and ChemACX
How to search:
1. Enter the desired information to search for. 2. Click Search in the toolbar.
Administrator
Inventory substances can be created from both the Registration Enterprise and ChemACX. If this option is not available from your instance of the Registration Enterprise or ChemACX, please see your system administrator.
A list of substances matching your search parameters is returned. Clicking on the details button of one of the substances will allow you to view, all of the entered properties of the given substance. New Container Substance Tab Form If accessed through the New Container Substance Tab, the following bar appears at the top of the form
The bar allows the user to search over all three applications simultaneously. For more information about global searches, Global Search on page 117. After the search is performed, select the Details button for the correct substance, and click OK to insert the substance in your new container. Perform another type of search.See Searching Inventory Enterprise on page 115..
button for the substance. A page appears displaying all retrieved details for the appropriate record.
120Inventory Enterprise
CambridgeSoft
the search form. 2. Perform a search for the appropriate substance. 3. While in list view, click the Details button for the substance. 4. Click on the View History link. The View History window opens.
.......................................... Enterprise
NOTE: If a duplicate for any required field is found in the system, the conflict resolution page appears. Please see Substance Conflict Resolution, page 119 for more information.
Delete a Substance
To delete a substance:
1. Perform a search and click on the Details
button for the substance. 2. Click Delete Record. A page appears asking for confirmation.
This area allows you to view an audit report of substances. User can filter the details according to Filter Criteria. User can view Audit details in two ways, Standard & Aggregate. Application displays Standard report by default: To view Aggregate report:
1. Click Aggregate.
3. Click OK.
View History
The view history area of Inventory Enterprise is available as part of substance management.
Inventory Enterprise
121
User can view the audit details group by fields. User can also select radio button to view group by date. 2. Enter details in appropriate fields. 3. Click Filter.
Administrator
Synonym Management
The synonym management area of Inventory Enterprise is available as part of substance management. To access this section, please take the following steps:
1. From the Substance Management area, access
To edit a synonym:
1. Click Edit next to the synonym to be edited. 2. Edit the name of the synonym. 3. Click OK.
the search form. 2. Perform a search for the appropriate substance. 3. While in list view, click the Details button for the substance. 4. Click on the Manage Synonyms link. The Synonym Management window opens.
To delete a synonym:
1. Click Delete next to the appropriate synonym. 2. If you do want to delete this synonym from the
Link Management
The manage link area of Inventory Enterprise is available as part of substance management. To access this section, please take the following steps:
1. From the Substance Management area, access
This area allows you to add new synonyms for a substance edit the synonyms which are already listed, or delete a synonym from the list. After accessing the Synonym Management window, to add a new synonym:
1. Click New.
the search form. 2. Perform a search for the appropriate substance. 3. While in list view, click the Details button for the substance. 4. Click on the Manage Link. The Manage Links window opens.
This area allows adding a link to the substance. 5. Click New to add link.
122Inventory Enterprise
CambridgeSoft
.......................................... Enterprise
Enter a URL in the URL list box. NOTE: You must enter http:// for the URL if applicable. Enter Text that you would like the link to be
Container Details Frame
Location Management
A location is defined as any "place" that a container can be stored. This includes a shelf, a refrigerator, or even a particular laboratory. Different facilities can decide how best to organize locations. For more information about locations, please see Location Tree Frame on page 124..
To delete a link:
1. Click Delete next to the appropriate link. 2. If you do want to delete this link from the list,
click OK.
Container Management
The container management area of Inventory Enterprise is available in the uppermost toolbar of the homepage. This area is split into 4 frames, shown below: Current Location Frame (top), Location Tree Frame (left), Container List Frame (top right), Container Contents Frame (bottom right).
The following controls and functions are available within the current location frame:
123
Returns to Search Mode screen. The last search form selected by the user will be automatically preselected.
Search Results
Returns to last hit list viewed while on Search Mode. If no search has been performed the link brings up the search default search form.
Help
Type, Unit of Measure, Container Size, and Initial Amount. The container name and barcode fields will default to an auto generated container id value. Other container attributes can be completed by populating additional tabs on this dialog. In particular, a chemical structure can be assigned to the container by following the New Substance or Select Substance links from the Substance tab.
Order Container
Administrator
Allows the user to enter an order for a container not currently in the Inventory Enterprise.
Tasks
Allows setting of the following Location attributes: location name, location type, location barcode and location description.
Move Location
Allows moving a location to a different node on the location tree. Enter a location id value or use the browse link to select the destination locations. All containers and sub locations will follow with the moved location.
Delete Location
The location tree control allows navigation of the Location hierarchy. Click on the +/- symbols to expand/contract location folders. Click on the location name to display its contents on the container list frame. The refresh link at the top right of the page repopulates the tree from the latest available location data and returns it to its fully contracted position.
New Search/Search Results
Deletes the currently selected location. A location must be empty before it can be deleted.
New Container
Creates a new container in the currently selected location. There are five required parameters to create a new container: Location ID, Container
Searching is the easiest way to find particular substances or containers in Inventory Enterprise. The system allows for combined chemical and text searches of all attributes associated with a Container. Several search forms are available to accommodate
CambridgeSoft
the search preferences of different users. For example, the Substructure Search form which allows searches based on chemical structure, substance name, CAS number and other attributes is particularly well suited for use by chemists. Similarly, the Advanced Search form which exposes fields such as container and location barcode is particularly well suited for use by stock room or receiving room personnel. The Global Search form allows the user to search over the Inventory Enterprise, Registration Enterprise, and ChemACX databases simultaneously if all three applications are installed on the server. Four distinct search forms are available from the homepage of the Inventory Enterprise through the use of tabs. Click on the tab indicating the type of search you would like to perform, and enter your search parameters.
Multi Scan
.......................................... Enterprise
Remove link.
New Location
Containers are located in different places throughout a facility. The types of locations necessary in your Inventory Enterprise is highly dependent upon your setup. In order to create a new location:
1. From the homepage, click Manage
Containers. 2. Use the location tree to select where the new location should be created. 3. Click New Location in the Current Location Frame. The New Location window opens.
The Multi Scan feature allows user to scan more than one container in the same list. User can perform few operations such as Check In, Check Out, Move Container, Retire Container, Delete Container and Clear List, on the scanned container(s). In order to scan new container:
1. From the Current Location Frame, click Multi
that opens.
5. Click Add Address link.
125
that opens is for the correct location. Enter the desired new information in the window. 5. Click Add Address link. The Add Address window opens.
Administrator
6. Enter the desired information about address in
the window.
7. Click OK.
Edit Location
After a location is created, its properties may change. For example, the user may need to rename the location or add an address for the location. In order to change the properties of a particular location:
1. From the homepage, click Manage
Containers.
2. Browse to the location to be edited in the
Location Tree Frame. 3. Click Edit Location in the Current Location Frame. The Edit Location window opens.
After a location is created, it may be necessary to move the location to somewhere else in the tree. For example, a refrigerator may have been located in a lab on the first floor, but is being moved to a lab on the third floor. Of course all of the containers inside the fridge are moved along with it. It is easy to move a location along with all of it's contents in the Inventory Enterprise. In order to move a location:
1. From the homepage, click Manage
Containers.
2. Browse to the location to be moved in the
Frame. 4. Make sure the information listed in the window that opens is for the correct location. Enter the new destination for the location to be moved. 5. Click OK.
CambridgeSoft
Delete Location
If a location needs to be removed from the inventory, you should use the delete location tool. If the location is merely being moved, Move Location on page 126. In order to delete a location:
1. From the homepage, click Manage
Containers. 2. Click New Container in the Current Location Frame. A window with multiple tabs labeled Required, Substance, Supplier, Contents, Optional, Owner, Comments, and Other (name may vary) opens. How to create a new container:
1. Enter information about the new container. 2. Click OK in the toolbar.
.......................................... Enterprise
Order Container
Containers. 2. Click Delete Location in the Current Location Frame. The Delete Location window opens.
Users can enter an order for a container that has not yet been created as part of the inventory by clicking on the Order Container link. If the container is already in the inventory and you would like to reorder the same container, please see Reorder Container. The following window opens when the Order Container link is clicked:
Location Tree Frame. 4. A location can only be deleted if it is empty, so make sure there are no containers in the location to be deleted.
NOTE: You can not undo the deleting of a location.
5. Click OK.
New Container
The "New Container" form is available in the Container Management area of Inventory Enterprise.
The Substance, Contents, Owner, and Comments Tabs appear and react just as the tabs with the same name in the New Container window react. The Required Tab in the Order Container window is also very similar to the New Container window. The Order Container Required Tab does not include all of the fields in that of the New Container
127
Window. Additionally, there are two location IDs: one for the delivery location and one for the on order location. To order a container:
1. Click Order Container from the Current
Default Location
Administrator
Location Frame The Order Container window appears. 2. Enter the required information and any other information which is desired. 3. Click OK.
Tasks
browse to the location to be saved as the default in the Location Tree Frame. 2. Open that location by clicking on the folder icon next to the location name. The default location window opens.
The following tasks are available to users with the correct administrative privileges. If you do not have privilege to access something you need to access, please see your system administrator.
Search, see page 124 New Location, see page 125 Edit Location, see page 126 Move Location, see page 126 Reconcile Location, see page 133 Plate Settings, see page 150 Create Plate from Excel, see page 161 Create Plates from Text File, see page 161 Custom Reports, see page 161 Change Password, see page 153 Manage Users, see page 192 Manage Roles, see page 192 Manage Container Requests, see page 153 Manage Sample Requests, see page 154 Analyze Audit Trail, see page 159 Manage Approvals, see page 158 Manage Tables, see page 159
3. Click OK.
Frame. A window with multiple tabs labeled Required, Substance, Supplier, Contents, Optional, Owner, Comments, and Other (name may vary) opens. How to create a new container:
1. Enter information about the new container. 2. Click OK in the toolbar.
Required Tab
The Required Tab of the New Container window includes all of the information required to create a new container. Truly required fields are noted as such with a red field name.
CambridgeSoft
Contents Tab
The Contents Tab of the New Container window includes information pertaining to the contents of the container. Because different batches of a substance can have slightly different properties, it is important to keep track of such information.
.......................................... Enterprise
Substance Tab
The Substance Tab of the New Container window holds information about the substance in the container. When the tab is first opened, the tab is empty except for two links, New Substance and Select Substance. In order to insert a substance into the record, click on New Substance, if you would like to insert a substance that is not registered yet, or Select Substance, if you would like to insert a substance that is already in the database. If New Substance was selected, a new window opens that allows you to input information about the substance. If Select Substance was selected, a new window opens that allows you to search for a substance. Do the following to search:
1. Enter the desired information. 2. Click Search. 3. A list of substances is returned. Click on the
Optional Tab
The Optional Tab of the New Container window includes information that does not fit under any other heading, but may be important to include.
Owner Tab
The Owner Tab of the New Container window includes information about the owner and current user of the container. The current user must be an actuveuser of the Inventory Enterprise system.
Supplier Tab
The Supplier Tab of the New Container window includes information pertaining to the supplier of the contents of the container.
129
Comments Tab
The Comments Tab of the New Container window allows the inclusion of comments about the container, or the contents of the container. This tab makes a space available to enter information not covered anywhere else.
be reproduced as a printable report. For more information about these search forms, Searching Inventory Enterprise on page 115. If you know location of the container you are looking for, you can use the location tree to navigate through all inventory locations to find the container. The Location Tree is displayed in the Container Management area. For more information about the Location Tree and how to navigate it, see Location Management.
Administrator
The Other Tab of the Container window gives users access to optional customizable fields. This tab is fully customizable and will vary from site to site. To learn more about customizable fields, please see your system administrator.
Both the container list frame found in the upper right hand frame of the Container Management area, and the report displayed after container based search results show a list of containers with some summary information. Containers are sorted in descending order by Container ID, but can be resorted by clicking any of the column headers. The small triangle next to the column name indicates the sorting order. Sorting affects containers regardless of whether they are displayed on the current page. Each container ID is preceded by a small flask. If the container information is open, the flask tips to the side. Click on one of the containers in the list to see the container details on the frame below.
CambridgeSoft
.......................................... Enterprise
All container attributes are displayed within the Container Details Frame. Given the large number of attributes associated with a container, they are subdivided into tabs which group the attributes into more manageable subsets. The first tab includes a summary of the most essential container attributes including container name, container id, barcode, location etc.... Other notable tabs include the substance tab, which summarizes the substance attributes and the supplier tab which brings together data related to the purchase of a chemical substance such supplier name, catalog number, lot number, container cost and purchase order number.
Details Frame.
Large Icons
The Large Icons link displays the container flasks in the Container List Frame as large icons, similar to the Large Icons folder viewing option in Windows.
Small Icons
The Small Icons link displays the container flasks in the Container List Frame as small icons, similar to the Small Icons folder viewing option in Windows.
The Multi Select Link changes the container list frame to details view and places a checkbox next to each Container ID. This allows users to select more than one containers and performs one action on all of those containers at once. For example, if you would like to move 3 containers to a new location:
1. Click Multi Select.
Details
The Details link displays the container flasks in the Container List Frame as a list of details, similar to the Details folder viewing option in Windows.
The containers are listed in Details view with checkboxes next to each container ID.
131
Column Chooser
The Column Chooser window allows the user to customize the appearance of result lists. It allows control over the selection, order, and width of columns to be displayed on screen as well as the number of containers displayed per page.
The Update Contents link opens a window which aids users in keeping the list of inventory containers in a particular location up to date. This tool is a casual way for users to confirm the existence of a particular container. If a particular container is not confirmed, no action is taken on that container. For a tool to correct any discrepancies in a location's contents, please use the Rectify Contents tool. Update contents accomplishes the following:
confirm that containers are still where the
Administrator
By clicking the Set Widths button, another window opens that allows the user to enter specific widths for each column.
system thought them to be. move containers unexpectedly found at that location to specific location. allow for unknown containers to be created at specific location. To update the contents of a location:
1. Open the appropriate location and click
Update Contents in the Container List Frame. The Update Contents window opens.
Custom column settings are saved by the user's browser and remembered even after the browser has been closed. The settings available via the Column Chooser affect only the screen report. The appearance of printed reports is controlled by report templates managed by the application administrator. Multiple report templates can be associated with the screen report. Please contact the administrator if you need additional report templates produced.
Update Contents
selecting the checkboxes, select the container ID for each container that is being verified. 3. Click OK.
At times, containers are moved and this is not updated in the inventory. Update Containers helps users to easily update the system confirming that a container is actually where the system thinks it is.
CambridgeSoft
Rectify Contents
At times, containers are moved and this is not updated in the inventory. Rectify Containers help users to easily update the system confirming that a container is actually where the system thinks it is. The Rectify Contents link opens a window which aids users in keeping the list of inventory containers in a particular location up to date. This tool is a formal way to correct inventory discrepancies. That is, if a particular container is not confirmed, that container is moved to the Missing Location in Inventory Enterprise. Rectify Contents is meant to be used on a quarterly or biannual basis during official inventory reconciliation efforts. For a less formal tool which only verifies the existence of a container in a location, please use the Update Contents tool. Rectify contents accomplishes the following:
confirm that containers are still where the
.......................................... Enterprise
selecting the checkboxes, select the container ID for each container that is being verified.
NOTE: Any container IDs entered that are not currently
system thought them to be. move containers unexpectedly found at that location to specific location.
allow for unknown containers to be created at
specific location. move any containers that are not explicitly found to a missing location. To rectify the contents of a location:
1. Open the appropriate location and click
Select the checkbox next to any containers you would like moved to this location. 3. Click OK. The following message is displayed if there are containers listed which have not been verified:
Rectify Contents in the Container List Frame. The Rectify Contents window opens.
Reports can be printed from three places in Inventory Enterprise: the container list frame, the container view frame, and the search results window. All three of these reports are generated in
133
the same way, but can display different information. Reports are driven by report templates on the server. Typically, the system administrator creates report templates with the appropriate layout and content to be printed. Please contact the administrator if you need additional reports created to satisfy your need. You can choose different templates and formats from the list boxes at the top of the report. Once a report is created on the server it can be printed from the browser by using the print icon a the button of the report viewer. Because reports are printed according to previously created report templates, information in a report is not necessarily the same information displayed in the window or frame that you choose to print. For example, the Print Report link in the container list frame will generate a report about the containers listed in that frame, but the report template may not include the container's cost, while the container list frame displays the container cost.
Administrator
The Change Qty function allows the modification of the quantity of material remaining in the container. Quantities are measured in the predefined unit of measure associated with the container.
Change Status
The Change Status function allows user to change the status of the container. The status of container depends upon current situation, these situations may be Available, Empty, Missing, etc. All status options are configurational.
Container labels are printed via report writer as well. A label is considered a special kind of report which can include any of the attributes associated with a single container. The report writer is also able to encode any of the container attributes into a scan barcode.
Check Out
The Check Out function is typically used when a user removes a container from a central storage location for subsequent use at a different location. The act of checking involves a change in container location plus a change in the current user responsible for the container.
CambridgeSoft
Check In
After you click the Copy Container link a Create Container dialog opens with all the data from the copied container already filled in the appropriate fields. Proceed by editing any fields that should differ from the copied container and the click OK. For more information about the fields, see Creating a New Container.
Certify Container
.......................................... Enterprise
The Check In function performs the reverse of the Check Out process. It is typically performed when a user returns a chemical container to its central storage location. The system remembers the location and user under which the container was created and uses them as the default values during the check in process.
Copy Container
The Copy Container function allows you to create one or more containers using a preexisting container as a starting template. Typically, attributes such as lot number, container cost, and expiration date, may need to be modified before the new container(s) are created.
This value is used to calculate the recertification date (expiration date) for the container. The recertification date is set to the number of months entered from the current date. 5. Click OK.
135
Reorder Container
Users can reorder any container in the inventory, if the container is not already on order. If the container that you would like to order is not currently in the inventory, please see Order Container on page 127. To reorder a container:
1. Click Reorder Container.
Administrator
The Reorder Container window appears. After the Edit Container window opens, proceed by editing any fields necessary and click OK. For more information about the fields, see Creating a New Container on page 128. The Move Container function moves the currently selected container to a new location. The destination location ID can be directly entered or scanned into the text box in the dialog, or the browse link can be used to select a location from the tree.
2. Enter the required information and any other
The Edit Container function allows editing of all container attributes. You may switch between the various tabs to access all container attributes. Changes to the container are only committed to the database once the Update Container button is clicked.
Delete Container
The Delete Container function deletes the currently selected container and moves it to the trash can. The only way items can be removed from the trash can is by using the Empty Trash function. Please see your system administrator for more information.
CambridgeSoft
Retire Container
The Retire Container function retires the currently selected container. When a container is retired, it is not deleted, but is no longer in use.
.......................................... Enterprise
Split Container
The Split Container function splits contents of the current container into new containers, adding the specified number of new containers. The parent container will be removed (the container is now empty). Quantities in the new containers are updated automatically. When splitting a container, all of the contents must be used so the sum of the quantities of the new containers must equal the quantity of the original container. To split a container:
1. Click Split Container.
The Merge Containers function merges two containers (which have the same parent ID) into one container. If a container has no parent ID, this function is not available. To merge two containers (with the same parent ID):
1. Open the first container in Details view.
2. Click Merge Containers. 2. Enter a value for each field. For more
the container has a Parent ID. The Merge Containers window appears.
137
3. Click OK.
The request has been made, and a Requests Tab is added to the container in the Container Details Frame.
Create Samples
Administrator
selected container. Only the containers with the same parent ID are listed.
Request Containers
The Create Samples function samples the current container and creates additional containers from that container with a specified quantity. The parent container will remain intact with any remaining quantity. Quantities in the new containers and the parent container are updated automatically. To create samples of a container:
1. Click Create Samples.
The Request Container link is only available from containers in stock room locations. A request can not be made if a previous request is still open. To request a container:
1. Click Request Container in the Container
The quantity remaining field is automatically populated and a quantity field for each new container appears.
The window is automatically populated with information about the container that is currently open. 2. Select a delivery location, User ID, Amount Required, and Date Required. Please Note, field names shown in red are required.
CambridgeSoft
History
The Container History link uses the Audit Report, page 159 window to display a container's history. Clicking on the History link will bring up the audit window and filters information to show any activity involving the current container.
example, the Print Report link in the container list frame will generate a report about the containers listed in that frame, but the report template may not include the container's cost, while the container list frame displays the container cost.
.......................................... Enterprise
For more information regarding the Audit Reports, please see Analyze Audit Trail.
Print Label/Report
Reports can be printed from three places in Inventory Enterprise: the container list frame, the container view frame, and the search results window. All three of these reports are generated in the same way, but can display different information. Reports are driven by report templates on the server. Typically, the system administrator creates report templates with the appropriate layout and content to be printed. Please contact the administrator if you need additional reports created to satisfy your need. You can choose different templates and formats from the list boxes at the top of the report. Once a report is created on the server it can be printed from the browser by using the print icon a the button of the report viewer. Because reports are printed according to previously created report templates, information in a report is not necessarily the same information displayed in the window or frame that you choose to print. For
Container labels are printed via report writer as well. A label is considered a special kind of report which can include any of the attributes associated with a single container. The report writer is also able to encode any of the container attributes into a scan barcode.
Link Management
A window allowing the addition of a link appears with current container information already populating the fields.
139
Substance Tab
The Substance Tab of the View Container frame provides information about the compound found in the container. It is possible to add synonyms for the substance from this tab by clicking on Synonyms.
Administrator
Enter URL in the URL listbox. NOTE: You must enter http:// for the URL if applicable. Enter Text that you would like the link to be
Supplier Tab
The Supplier Tab of the View Container frame provides information about the supplier of the container and/or its contents.
To delete a link:
1. Click Delete next to the appropriate link. 2. If you do want to delete this link from the list,
Click OK.
Viewing the Contents of a Container
Summary Tab Quantities Tab
The Summary Tab of the View Container frame provides a summary of important details about the container and its contents.
The Quantities Tab of the View Container frame provides information about the amount of stock necessary for the facility.
Comments Tab
The Comments Tab of the Container View frame allows you to enter comments about the container, the batch inside the container, the location, etc. This is a good place to record any information that does not fit in any other fields.
CambridgeSoft
The EH&S tab is customizable by the system administrator, so the fields found under this tab vary. For more information about the fields in the EH&S Tab, please see your system administrator.
Requests Tab
.......................................... Enterprise
Reservations Tab
The Requests Tab of the Container View frame displays the current requests on the container. If there is no active requests, the tab is not visible. A user can also edit and/or delete the current request if permissions allow it.
The Reservations Tab of the View Container frame provides information about any reservations made for the container's contents. This tab also provides the ability to enter a new reservation as well as edit or delete an existing reservation.
Plate Inventory
Other Tab
The Other Tab of the Container window gives users access to optional customizable fields. This table is fully customizable and will vary from site to site. To learn more about customizable fields, please see your system administrator.
EH&S Tab
Plates are held in locations, much like containers. For this reason, plates are browsed in the same way that any other container is browsed.
The EH&S Tab of the View Container frame provides Environmental Health and Safety Data for the container. EH&S information is linked to records on two levels:
Substance level - requires a valid CAS number
in the record.
Container level - requires a valid CAS number,
Supplier Name, and catalog number in the record. Container level EH&S information can not be added unless substance level information exists.
Plates are indicated as such in the Container List Frame with a plate icon. When a plate is opened, the Plate Contents Frame is displayed in the bottom right frame. Plates and Containers can exist in the same location.
141
Administrator
All plate attributes are displayed within the Details Frame Summary Tab. It lists all attributes for the plate, common to all wells, including plate ID, Barcode, Plate Type, Plate Name, Plate Format, etc.... The Plate Viewer Tab allows you to view the contents of the plate in a grid. Click on one of the wells to view the details for that well.
After performing the search, users are given a list of matching plates:
The Create Daughter Plates function allows a user to create any number of daughter plates from a parent as long as the parent plate contains enough contents to fulfill the request. That is, if you would like to create 6 daughter plates taking 10 ml of a substance from the source plate which only contains 10 ml, you will be denied. To create daughter plates:
1. Search for or browse to the source plate. 2. Open the plate in the Details Frame. 3. Click Create Daughter Plates.
CambridgeSoft
.......................................... Enterprise
4. Click Next.
new plates.
7. Select the Dry Source Plates after Reformat 5. Select Yes if a solvent will be added to the plate
during daughtering and click Next. if Yes: The following screen appears
checkbox if your source plates should return to their original state after the reformatting action is complete. 8. Click OK.
Create Plate Map
The Create Plate Map function allows a user to create a plate map based on the selected plate. Plate maps are virtual representations of plates that store the plate type, physical plate type, etc. of the plate, but most importantly the substance information for each well. Plate maps can only be stored in special plate map locations. New plates can be created from a plate map.
a. Enter information about the solvent added. b. Click Next.
create a plate map from. 2. Open the plate in the Details Frame. 3. Click Create Plate Map. The Create Plate Map dialog appears.
143
Administrator
4. Enter the location for the new plate map. 5. Click OK.
Plate Maps are stored in special plate map locations. To create a plate map location:
1. Click New Location. 2. Enter the appropriate information. 3. Select Plate Map from the Location Type
applied to all of the wells in the plate. To edit a plate: 1. Search for or browse to the plate you wish to edit. 2. Open the plate in the Details Frame. 3. Click Edit Plate. 4. Make the appropriate edits to the given plate and well attributes. 5. Click OK.
Edit Well
listbox. 4. Click OK. This new location is now ready to store plate maps created.
Edit Plate
The Edit Plate function allows editing of plate and well attributes. Plates are initially created in BioAssay so any attributes which can not be changed are greyed out (e.g. plate format).
The contents of an individual well can be edited by clicking Edit Well (from the Plate Well View dialog). This gives users the option of editing the attributes of one well at a time. If you would like to edit all wells uniformly, please see Edit Plate To edit your well attributes:
1. Click Edit Well.
CambridgeSoft
5. Click OK.
The plate is copied and a new plate is created in the specified location.
.......................................... Enterprise
Move Plate
The Move Plate function allows a user to move a plate from one location to another. To move a plate: 1. Search for or browse to the plate you wish to move. 2. Open the plate in the Details Frame. 3. Click Move Plate. The Move Plate dialog appears.
2. Enter the required information. 3. Enter any additional information. 4. Click OK.
Copy Plate
The Copy Plate function allows a user to make a copy of an existing plate. To copy a plate:
1. Search for or browse to the plate you wish to
copy. 2. Open the plate in the Details Frame. 3. Click Copy Plate. The Copy Plate dialog appears.
selected plate to. 5. Click OK. The plate is moved to the new location.
Dilute Plate
The Dilute Plate function allows a user to dilute an existing plate. To dilute a plate:
1. Search for or browse to the plate you wish to
dilute. 2. Open the plate in the Details Frame. 3. Click Dilute Plate. The Dilute Plate dialog appears:
145
Delete Plate
The Delete Plate function allows deleting of plate and well attributes. To delete a plate:
1. Search for or browse to the plate you wish to
Administrator
delete. 2. Open the plate in the Details Frame. 3. Click Delete Plate. The Delete Plate dialog appears.
The Retire Plate function allows retiring of a plate. Retiring is different than deleting because when a plate is retired the data is preserved, and the plate is placed in the Disposed location (unless specified otherwise), while when it is deleted, the data is lost permanently. To retire a plate:
1. Search for or browse to the plate you wish to
4.
retire. 2. Open the plate in the Details Frame. 3. Click Retire Plate. The Retire Plate dialog appears.
4. Make any necessary changes. 5. Click OK to confirm you would like to retire
The Plate Viewer Tab of the View Plate Frame displays a plate, in grid format, where each cell represents a well in the plate. Click on a well to view its contents.
the plate.
CambridgeSoft
.......................................... Enterprise
Administration
Inventory provides an interface to some frequently used administrative tasks. This interface is not available to all users. If you feel you need access to this interface, please see your system administrator.
NOTE: If an error message appears saying no plate locations or plate formats are defined, you will have to configure at least one location in Inventory Enterprise to hold plates, and/or create at least one valid plate format. Consult the documentation for Inventory Enterprise.
5. Browse to the ChemFinder database you want
Inventory Loader
Inventory Loader is an application to load information from ChemFinder databases into the Inventory Enterprise and Registration Enterprise databases. ChemFinder databases may be created from many sources, most commonly SDFiles. SDFiles are the common currency of chemical information exchange today. Inventory Loader may be run from any machine with access to the ChemOffice Enterprise application server. To start loading compounds into Inventory Loader: 1. Start the Inventory Loader application. An introduction screen appears.
NOTE: You must start the Inventory Enterprise
to load. 6. Select whether you wish to load compounds into plates, or just load compounds.
NOTE: If an error message appears saying "Cannot open database", you may need to upgrade the database to the current ChemFinder version. To do this, simply open the database within ChemFinder and follow the prompts.
2. If more than one table is defined in the
ChemFinder db then you will have see a drop down list of table names. Select the table that holds the data to be mapped. Typically, the table name is "MolTable". A table appears. The tables left column displays the fields in Inventory Enterprise.
147
The tables second column lets you choose to either enter a default value, or to pick a field from your ChemFinder database to insert into that field. If you choose Use Default, you can enter that default value in the 3rd column. The default is to leave the field blank. 3. Enter information for one or more fields. The following is an explanation of the fields::
Field Name Field Description
Field Name
Field Description
Administrator
Barcode
Well the address of the well on the Coordinate plate, e.g. A02 or H12 Row the row of the well on the plate, either in letter or number format. the column of the well on the plate, in number format. the CambridgeSoft registration number of the compound. You will generally leave this blank unless you are importing data from the Registration System into Inventory Enterprise. the CambridgeSoft registration batch number of the compound. You will generally leave this blank unless you are importing data from the Registration System into Inventory Enterprise.
the barcode of the plate. This is the barcode that will be used in Inventory Enterprise. If you leave this blank, Inventory Enterprise will assign new barcodes to the plates according to a scheme which you set up in a later screen.
Compound an identifier for the Name compound. CAS Number the CAS number for the compound. Many screening libraries do not include CAS numbers.
Column
Reg Number
ChemACX the CambridgeSoft ID ChemACX id for the compound. Many screening libraries do not include ChemACX numbers. Supplier Supplier Barcode the supplier of the plate. the barcode assigned by the supplier to the plate. If you will be re-barcoding the plates upon import, you may assign the original supplier barcode to this field for tracking purposes.
Batch Number
CambridgeSoft
Field Name
Field Description
Some notes on filling in this grid: a. Either Well Coordinate or Row AND Column may be mapped to ChemFinder fields. It is not necessary to map both, and you dont have to do either, but if you map Row, you must map Column. If you map Well Coordinate, you shouldnt map Row or Column. b. If your plates have identifiers, you should map that identifier to either Barcode, Supplier Barcode, or (if the plate identifier is numeric) to Supplier Plate Number. If you dont, you will receive a warning, and the compounds will probably not be plated according to your expectations. c. If you map only Supplier Barcode, Supplier Plate Number, or Barcode, and you do NOT map Well Coordinate or Row AND Column, the compounds will probably not be plated correctly. d. If you do not map ANY of: Supplier Barcode, Supplier Plate Number, or Barcode, Well Coordinate or Row AND Column, then the compounds will be put into plates in the order that they are encountered in the file. This is probably a rare scenario. 4. Click Next.
the plates. 6. Choose the plate format you wish to use. The plate format describes the size of the plate (96, 384 well), as well as the layout of the plates where compounds are located, which wells are empty. 7. Choose the plate type you wish to create. The Plate Types list is an arbitrary list of types. The number of compounds being imported and the number of plates to be created appears at the bottom of this screen. This is a good place to check if the results are what you expected. 8. Click Next. 9. Choose the library to assign the plates to. This is an arbitrary list of classifications. 10.Enter how you want Inventory Enterprise to barcode your plates.
NOTE: If you have mapped a ChemFinder field to Barcode in a previous screen, the Barcode section of this screen will be grayed out, indicating that the barcodes from your file will be used.
11. Assign a starting group number for your plates
.......................................... Enterprise
if desired. This is rarely used. 12.Click Next. 13.If you want to register these compounds into the Registration System, check the box. Inventory Loader will validate your login against the registration system. If it succeeds, a grid containing the options for registering the compounds appears. You can choose what project, prefix and sequence to register the compounds with, as well as other options. For more documentation on what these choices mean, consult the Registration System documentation. a. If you want to assign fields to be filled in for the compound when it is registered, click Registration Options
149
one you used to assign inventory fields. Here you can choose default values or SDFile fields to assign to registration system fields. NOTE: Please note that the fields here are named as they are in the database, not as they are in the Registration System interface. The mapping between display name and database name may be found in C:\inetpub\wwwroot\chemoffice\chem_r eg\config\cfserver.ini 14.Click Next. 15.If you would like to save a log of the plates that were created in XML format, check the box and specify a path. This is usually not necessary unless you are experiencing problems. 16.Click Next. 17.Click Finish and the plates are imported. Each plate may take a while, as compounds are duplicate-checked and indexed for searching.
New Location
For more details please New Location on page 125.
Administrator
Edit Location
For more details please Edit Location on page 126.
Move Location
For more details please Move Location on page 126.
Delete Location
For more details please Delete Location on page 127.
Plate Settings
The plate settings Admin Task allows you to create, edit, delete and copy plate settings for use when creating and reformatting plates. The settings include:
Grid Formats Physical Plate Types Plate Formats Plate Types Well Formats Create Reformatting Plates Plate Import Templates
mapped to ChemFinder fields appears. See Loading Compounds into Plates on page 147. 2. Click Next. 3. Click Finish.
Inventory Tasks
The following tasks are available to users with the correct administrative privileges. If you do not have access to something you need access to, please see your system administrator: Tasks on page 128..
Search
For more detail please Searching Inventory Enterprise on page 115.
CambridgeSoft
Create New
Grid Formats
The grid format allows you to create a grid of plate. This plate settings allows user to create a grid of choices, user can enter following details in the interface.
.......................................... Enterprise
Edit
the appropriate listbox. Click the Edit link to the right of the plate setting you would like to edit. Enter the desired information. Fields highlighted in Red are required. Click OK.
Delete
Physical plate type allows you to create a plate type. This plate settings allows user to create a physical plate of different well capacities, user can enter following details in the interface.
the appropriate listbox. 2. Click the Copy link to the right of the plate setting you would like to copy.
NOTE: Fields highlighted in Red are required.
3. Click OK.
Plate Formats
Plate format assigns a new attribute to an existing physical plate. User can enter following details in the interface.
151
Administrator
Plate Types
It allows you to create/edit plate types. By default system provides following types:
Assay Plate Master Plate Replicate Plate Source Plate Working Plate NOTE: These default plate types are editable.
This feature allows you to select the positioning of plates in the well of the target plate. You can create reformat map of only those plates which has same plate formats and plate types. User can select either Stamped or Dithered from the Reformat Map Type drop down list. If Stamped selected following screen appears:
It allows you to create/edit well format. By default system provides following formats:
Compound Empty Negative Control Positive Control NOTE: These default well formats are editable.
CambridgeSoft
This feature allows user to create an import template of any choices. As import template created, user can select this template to import the text file. For more information about the contents and format of the listed import templates. Upon clicking New link following page appears:
.......................................... Enterprise
textbox. 3. Enter the new password again in the Confirm New Password textbox. 4. Click OK. Enter the details to create import template and click Next button.
Manage Users
For more details please Manage Users and Roles on page 192.
Manager Roles
For more details please Manage Users and Roles on page 192.
Change Password
Users always have the option to change their password.
153
Administrator
To close a request:
1. Select the checkbox in the Delivered? column
frame. 2. All closed requests are listed. These requests can be filtered using the top frame. 3. If you would like to Undo the Delivered action and return a request to the open list, click Undo. 4. Click OK.
The links at the top of the Manage Sample Requests window allows you to easily view the type of requests you want to see. The actions which can be taken on a request is determined by the state that request is in.
New Sample Requests
New sample requests are requests which have been submitted by a user but not yet approved for disbursement by the appropriate personnel. The following actions can be taken on a request with the status New:
Review a Request:
A Review link found to the left of each request listed in the Sample Requests dialog allows users to review details and edit them if necessary.
CambridgeSoft
Accept a Request
Accepting a request changes the status of that request to approved. This indicates the request will be fulfilled. To accept a request:
1. Select the Accept checkbox to the right of the
.......................................... Enterprise
appropriate request. 2. Click OK. The request details will now appear under the Approved Requests. Decline a Request
2. Change the number of samples, if desired, and
click Next.
Declining a request changes the status of that request to declined. This indicates the request will not be fulfilled as requested. To decline a request:
1. Select the Decline checkbox to the right of the
appropriate request. 2. Click OK. A dialog to enter a reason for decline appears.
selected. Editing the address for that location will be a global change for all requests being delivered to that location.
4. Click OK.
Declined Requests.
155
Approved sample requests are requests which have been submitted and approved, but not yet fulfilled. Users can fulfill these requests by clicking on the Create Samples link to the left of the request.
6. The preview screen displays a summary of the
Administrator
action to be taken. If the preview is correct, click OK. 7. The samples are created and the request status is changed to Filled.
Declined Sample Requests
To fulfill a request:
1. Click Create Samples to the left of the
Declined sample requests are requests which have been submitted by a user but have been declined. These requests are, in a sense, closed but were never fulfilled. Users can view the reason for decline from the Manage Sample Requests dialog by clicking on the Reason link to the left of the request.
Filled sample requests are requests which have been submitted and approved and the samples have been created. Users can create orders and ship those orders from this interface.
should be placed in the Sample Location ID field. 4. Enter the size of the new containers. 5. Click Next. The preview screen appears.
CambridgeSoft
The orders column lists all orders, which contains containers linked to the request.
Closed Sample Requests
.......................................... Enterprise
Closed sample requests are requests which have been approved by a user but have been closed. These requests are, in a sense, closed but were fulfilled by the user. User can only view closed request but not able to do any further operations on these requests. Click the Edit link to edit the order or click Create Order to create a new order. To ship an order:
1. Select the Ship checkbox to the right of the
Cancelled sample request are request which have been submitted by a user but have been cancelled. These request are, in a sense, closed but were never fulfilled. User can only view the details of the sample.
The Create Order link is accessed from the Filled Sample Requests screen or from the Manage Orders screen. To Create an Order:
1. Click Create Order.
Manage Orders
The Manage Orders screen allows you to view all of the orders in the system. Orders have 3 states: New, Shipped, and Closed. Toggle between the list of new and shipped orders using the new and shipped links at the top of the dialog.
2. Scan in the containers in the order. 3. Enter the delivery location. 4. Click Save Order.
157
Receive an Order
Receiving an order will move the containers in the order to their destination location and update the container status. To receive an order:
1. Scan in one of the containers in the order.
A list of all of the containers in the order appears. 2. Continue to scan in all of the container in the order. 3. After all of the containers are scanned in, click Receive Containers.
appropriate container. The Manage Documents dialog appears. 2. Click the link for the document you would like to view. The document appears in a web browser for your review.
Approving a Container
Administrator
Approving a container changes the container's status to the designated approved status, making the container available to be used. To approve a container:
1. Select the Approve checkbox to the right of
Manage Approvals
The Manage Approvals tool lists all container which have been certified using the Certify Container function, but have not yet been approved. The listed containers can be filtered in the upper frame. Results from the filter are displayed in the bottom frame. By default, the window opens with no filtering (displays all containers to be approved).
the appropriate container. 2. Click OK. The status of the container is updated (removing the container from the Manage Approvals interface) and the approval date is stored in the database.
Rejecting a Container
If the paperwork or test results are not satisfactory, the certification of the container can be rejected. Rejecting a container sets the container status to the default container status and clears the certification date. To reject a container:
1. Select the Reject checkbox to the right of the
appropriate container. 2. Click OK. 3. The status of the container is updated (removing the container from the Manage Approvals interface) and the certification date is cleared.
CambridgeSoft
Manage Tables
The Manage Tables interface allows administrators to add, edit, and delete the contents of any table in Inventory Enterprise. This is especially helpful to add/change the choices in pick lists throughout the Inventory Enterprise forms.
4. Click OK.
.......................................... Enterprise
deleted from the Select Table listbox. The table appears. 2. Click the Delete link to the right of the row to be deleted. 3. Enter the desired information. 4. Click OK. The row is deleted from the table.
The Analyze Audit Trail tool allows users to filter and view actions taken on containers, locations, compounds, or links.
Standard Audit Report
Table listbox. The table appears. 2. Click the New Row link. 3. Enter the desired information. 4. Click OK. The row is added to the table.
Edit
The Standard Audit Report allows users to filter by Table, User, RID, LocationID, ContianerID, Date, Action, or CompoundID. To filter and display the report:
1. Click Analyze Audit Trail and make sure the
edited from the Select Table listbox. The table appears. 2. Click the Edit link to the right of the row to be edited. 3. Enter the desired information.
159
User the user who performed the action RID the action ID number (entered as a
range) LocationID the location ID ContainerID the container ID From Date actions made after this date To Date actions made before this date Action type of SQL action (Update | Delete | Insert) CompoundID the compound ID 3. Click Filter.
Administrator
3.
The Aggregate Audit Report allows users to filter by Table, User, Date, or Action. This report does not give every step in the audit trail, like the Standard Report, but instead provides a summary of actions.
5.
Locations | Compounds | Links) User the user who performed the action From Date actions made after this date To Date actions made before this date Action type of SQL action (Update | Delete | Insert) Select Fields to display and group by selecting the checkboxes next to Table Name, Modified By, an Action. Indicate how date dependant data should be grouped by selecting the appropriate radio button next to Hour, Day, Month or Year. Click Filter. The results are displayed in the lower frame.
CambridgeSoft
.......................................... Enterprise
Target plates are assumed to be created from the contents of existing plates in the inventory. Source Plates are new plates created with new contents not previously found in the inventory. You cannot insert structures into plates when selecting this option.
provided. 4. Browse to the text file being imported. 5. Enter additional information about the new plates. 6. Click OK. The plates are created in the indicated location
Custom Reports
System administrators have the option to create custom reports for Inventory Enterprise. These reports pull information from the Inventory Enterprise database and display it in a useful form.
161
dialog). 2. Select the name of the report you would like to run form the Report Layout listbox. 3. Select a report format from the Report Format listbox. 4. Click Go.
Administrator
CambridgeSoft
From the Main Menu you can start using Registration Enterprise.
NOTE: Your Administrator may set different privileges for different users, so your Main Menu may not look like the previous illustration.
Administrator
NOTE: Hostname is the name of the ChemOffice Enterprise machine. Contact your server administrator to obtain the correct hostname.
2. Type your Username and Password, and then click Log In.
The Main Menu is split into 4 major areas: Add to Temporary, Registration, Query & Reporting, and Administration, some of which will be available to you, the user.
Add to Temporary
The temporary table holds all newly created records. New records can be added to the temporary table, or temporary database, as a Compound or a Batch of compounds. Salts at the Compound or Batch levels can also be added.
The Global Login page appears. 3. Click Main Menu link on Global Login page. The Registration Enterprise main menu appears.
Adding a Compound
A compound is one of the types of records that can be added to the temporary table. A compound record includes information about the compounds physical properties as well as information about the chemist who is recording the information. To add a Compound record to Registration Enterprise: 1. From the Main Menu, click Add Compound. The New Compound Submission Form appears
164Registration Enterprise
The dialog box appears that confirms you have added a record to the temporary table. 4. Click OK. The New Compound Submission Form reappears.
Adding a Batch/Lot
It is possible to add a Batch record to the temporary table that contains information about a batch of a compound. The compound is assigned a suffix to its registration number that identifies it as part of a Batch. Batches of the same compound often become available if for example, you prepare a compound, then later repeat the preparation to make more of the compound; or the organization purchases a compound from two different suppliers. Batch information is important because different batches may contain different impurities or behave differently in tests. In order to add a new batch record, you must have available the Registry Number of the compound. The registry number is assigned to a record when the record is registered and is included in the record when viewed in the permanent database.
NOTE: More fields may appear in your form. These forms are customized for your site. Please see your system administrator for more details.
Administrator
Common compound information for all the Batches is retained, as shown in the upper gray area of the screenshot above. 3. Enter the appropriate information into the fields in the form.
166Registration Enterprise
A dialog box appears that confirms you have added a record to the temporary table. 5. Click OK. The Batch Registration Number page reappears.
Registration
Compounds are placed in the temporary table after they are initially submitted. This allows the records to be reviewed for accuracy and completeness before being inserted into the permanent database of registered compounds and assigned a registration number. When the time comes for a record to be registered, the Registration section of the main menu is the place to make that happen. Unlike other fields, after a record is registered, it is possible to add certain identifier and analytics data to a record.
If you want to
choose the attributes of the records you want to review. b. Click Search.
A list of records appears reflecting the search. 3. After locating the correct record in the search results, click the Review/Register button located to the left of the record summary. The Compound Commit Form appears.
Scrolling through the form allows you to view all of the details entered for the chosen record. The Compound Commit Form includes a number of new operations displayed at the top of the page in the form of buttons. The operations include: Register, Edit, and Delete Record.
For more information about finding a record, see Searching and Viewing Records in the Temporary Table on page 167. 2. Click Review/ Register next to the appropriate record. The Compound Commit form appears. 3. Click Edit, if it is available. The Registered Compounds Results Form changes to allow editing. 4. Make the necessary changes to the record and then click Update Record. The Registered Compounds Results Form returns to view-record mode.
Administrator
temporary table. For more information about finding a record, see Searching and Viewing Records in the Temporary Table on page 167. 3. Click Review/ Register. The Compound Commit form appears. 4. Click Delete Record . A dialog box appears before the record is deleted to reconfirm the action.
168Registration Enterprise
CambridgeSoft Registration
5. Click OK.
Registering a Record
After a record in the temporary table is reviewed, it can be registered. Registering a record moves it from the temporary table to the permanent tables, and assigns the record a unique registry number. Anyone using Registration Enterprise can see all records in the permanent database, unless Row Level Security is enabled. If the record is for a compound a registry number is assigned and the information recorded is assumed to be the first batch of the compound. If the record is for a new batch of an existing compound, the registry number is simply the registry number assigned previously to the compound followed by batch. It is possible to change the format of assigned registry numbers and batch numbers. For more information about this, please see Defining Sequences on page 174. Before registering a record it is important to make sure the record contains all of the information you want included and the information is correct. In addition to the initial information entered, you can also include Identifiers and Analytics data to a permanent record. For more information, see Adding Identifier Information to Records on page 170 andManaging Analytics Data on page 179 respectively. To add records to the permanent database:
record to be reviewed, or you would like to view a list of all compounds currently in the temporary table: click Review/Register. If you would like to search for specific records: click Search Temporary. For more information about searching the temporary table see Searching and Viewing Records in the Temporary Table on page 167. A list of records appears reflecting your choices. 2. Take the appropriate action:
If you want to register Then
1. Click Register
compounds individually
1. Go to the
The Register Compounds Results Form changes to show that you successfully registered compounds. The Registration Numbers and Batch numbers appear for each record. For more information about editing a record before registering it, see Editing Records in the Temporary Table on page 168.
Administrator
This form displays a summary about the compound selected, and on the bottom allows the addition of chemical names, synonyms, and CAS numbers. 3. Take the appropriate action:
If you want to add Then in the
Chemical Name
A dialog box appears that confirms you added an identifier to the record. 5. Click OK. The Add Records Input Form reappears.
170Registration Enterprise
CambridgeSoft Registration
3. From the Experiment Type menu, choose an experiment type, and then click Add Data.
4. Add parameters and results data to the record and click Commit Data.
Making your search as specific as possible is often helpful, especially when the number of records in the database is large. Most often, the more specific a search is, the lower the number of records returned will be. If you are having trouble finding the correct record, it may be that your search is too specific. Try broadening your search in order to return more records. For more information about the different kinds of queries you can create, see Searching ChemOffice Enterprise Applications on page 194.
Administrator
2. Enter the desired information in the appropriate boxes and click Search.
172Registration Enterprise
Analytics Spreadsheets
It is possible to see records grouped by experiment in a spreadsheet, or list, format. To view records by experiment:
1. From the Main Menu, choose Show Spreadsheet.
Managing Tables
The following parts of the Registration Enterprise tables can be changed, or managed:
Projects Sequence Structure Comments People Salts Solvates
Then
Defining Projects
A project name can be included as part of a compounds record. The Projects table defines the Projects that appear when a user of the system creates a compound record.
Administration
All of the contents of menus, identities of users and passwords, and definitions of types of data can be manipulated from within Registration Enterprise. The administration section allows for the maintenance of Registration Enterprise and its users. This section is often not available to regular users.
A table that defines the Projects opens. To add a new project to the Projects table: 1. From the Projects table, click new. A page appears allowing the definition of a new project.
Defining Sequences
A prefix and a starting number for compound registration numbers can be specified when a record is created. The Sequences table defines the compound registration numbers for each record. This information appears in the Prefix menu when records for compounds are created. To open the Sequence tables:
From the Manage Table page, click Sequence.
Administrator
If you want to
Then
in the Project Name box, type a name for the project. if this project should be an option, from the Active menu, choose True. if this project should not be an option, from the Active menu, choose False.
A table that defines the Sequence appears. To add a new registration number prefix and starting number to the Sequence table:
1. From the Sequence table, click new.
decide if this new project name should appear in the project menu while a user creates a record
If you want to
Then
The Projects table appears with the new project. To edit a project in the Projects table:
1. From the Projects table, click the ID number
that corresponds to the project to be edited. A window allowing redefinition of the project appears.
2. Follow step 2 from the previous section. 3. Click Update Record.
174Registration Enterprise
CambridgeSoft Administration
If you want to
Then
This information appears in the Structure Comment menu when you create records for compounds. To open the Structure Comments tables:
From the Manage Table page, click Structure
Comments.
specify the number with which to start compound registration numbering decide if this prefix should appear in the prefix menu while a user creates a record
if this prefix should be an option, from the Active menu, choose True. if this prefix should not be an option, from the Active menu, choose False.
A window allowing the definition of a new structure comment appears. 2. Take the appropriate action:
If you want to Then
The Sequence table appears with the new information. To edit a sequence in the Sequence table:
1. From the Sequence table, click the ID number
in the Structure Comment box, type a name for the structure comment.
that corresponds to the sequence you want to edit. A window allowing redefinition of a sequence appears. 2. Follow step 2 from the previous section. 3. Click Update Record. The Sequence table is updated.
decide if this structure comment should appear in the structure comment menu while a user creates a record
if this structure comment should be an option, from the Active menu, choose True. if this structure comment should not be an option, from the Active menu, choose False.
NOTE: The no comment structure comment overrides the need to populate the structure field if the structure field is a required field.
The Structure Comments table appears with the new structure comment. To edit a structure comment in the Structure Comments table:
1. From the Structure Comments table, click the ID number that corresponds to the structure
If you want to
Then
Administrator
comment you want to edit. A window allowing the redefinition of a new structure comment appears. 2. Follow step 2 from the previous section. 3. Click Update Record. The Structure Comments table is updated.
include the first in the First Name name of the person box, type a name. include the middle in the Middle name of the person Name box, type a name. include the last in the Last Name name of the person box, type a name. include a work site for the person from the Site menu, select a work site location. in the Telephone box, type a phone number.
A table that defines the People appears. To add a new person to the People table:
1. From the People table, click new.
176Registration Enterprise
CambridgeSoft Administration
If you want to
Then
include the E-mail address of the person decide if this person should appear in the person menu while a user creates a record
in the E-mail box, type an E-mail address. if this person should be an option, from the Active menu, choose True. if this person should not be an option, from the Active menu, choose False.
A table that defines the Salts appears. To add a new salt to the Salts table:
1. From the Salts table, click new.
If you want to
Then
in the Salt Name box, type a name for the salt. in the Salt MW box, type a weight for the salt.
corresponds to the person you want to edit. A window allowing the redefinition of a people appears. 2. Follow step 2 from the previous section. 3. Click Update Record. The People table is updated.
NOTE: The default in the People Table is to display the login name as the last name for the person. This can be changed by adding the person, and then editing the user information later.
Defining Salts
A salt can be included when a compound record is created. The Salts table defines the Salts that appear when a record is created.
If you want to
Then
include the molecular formula of the salt decide if this salt should appear in the salt menu while a user creates a record
in the Salt MF box, type a formula for the salt. if this salt should be an option, from the Active menu, choose True. if this salt should not be an option, from the Active menu, choose False.
Administrator
If you want to
Then
The Salts table appears with the new salt. To edit a salt in the Salts table:
1. From the Salts table, click the ID number that
corresponds to the salt to be edited. A window allowing the redefinition of a new salt appears.
2. Follow step 2 from the previous section. 3. Click Update Record.
include the molecular weight of the solvate include the molecular formula of the solvate decide if this solvates should appear in the solvate menu while a user creates a record
in the Solvate MW box, type a weight for the solvate. in the Solvate MF box, type a formula for the solvate. if this solvate should be an option, from the Active menu, choose True. if this solvate should not be an option, from the Active menu, choose False.
Defining Solvates
A solvate can be included when a compound record is created. The Solvate table defines the Solvates that appear when a record is created. To open the Solvates tables:
From the Manage Table page, click Solvates.
178Registration Enterprise
CambridgeSoft Administration
The Solvate table appears with the new solvate. To edit a solvate in the Solvate table:
1. From the Solvate table, click the ID number that
If you want to
Then
corresponds to the solvate to be edited. A window allowing the redefinition of a new solvate appears. 2. Follow step 2 from the previous section. 3. Click Update Record. The Solvate table is updated.
in the Name box, type a name for the experiment. in the Description box, type a description for the experiment. in the Created box, type a date.
include information describing the experiment include the date you create this experiment include the date you change this experiment include a version identifier for this experiment
3. Click Add Record.
A table that defines the experiments appears. To add a new experiment to the Experiments table:
1. From the Experiments table, click new.
The Experiments table appears with the new experiment. To edit an experiment in the Experiments table see Defining Experiment Type on page 180.
To access the Managing Analytics Data table. From the Main Menu, click Manage Analytics.
The Result Types table is updated. To edit a result type in the Result Types table:
1. From the Result Types table, click the ID
Administrator
number that corresponds to the result type you want to edit. A window allowing the redefinition of a result appears.
A table that defines the Result Types appears. To add a new result type to the Result Types table:
1. From the Result Types table, click new.
If you want to
Then
A table that defines the Experiment Types appears. To add a new experiment to the Experiments table: on page 179: To edit a new result type to the Experiment Types table
1. From the Experiment Types table, click the ID
in the Name box, type a name for the result type. in the Description box, type a description for the result type. in the Units box, type a description for the units of the result type.
number that corresponds to the experiment type you want to edit. A window allowing the redefinition of an experiment appears.
180Registration Enterprise
CambridgeSoft Administration
If you want to
Then
in the Name box, type a name for the parameter type. in the Description box, type a description for the parameter type. in the Units box, type a description for the units of the parameter type.
delete result and parameter types. For more information about adding result and parameter types, see Defining Result Type on page 180 or Defining Parameter Type on page 181 respectively. 3. Click Update Record. The Experiments table is updated.
The Parameter Types table appears with the new parameter type. To edit a parameter type in the Parameter Types table:
1. From the Parameter Types table, click the ID
A table that defines the Parameter Types appears. To add a new parameter type to the Parameter Types table:
1. From the Parameter Types table, click new.
number that corresponds to the parameter type you want to edit. A window allowing the redefinition of a parameter appears.
Managing Workgroups
To open the Workgroups tables:
From the Main Menu, click Managing
Workgroups.
Administrator
A table that defines the Workgroups appears. For more information about adding workgroups, see Defining Registration Enterprise People on page 176.
Importing SDFiles
SDFiles are Structure Data Files used by ChemOffice Enterprise to manage structure information and data information in one file. If data is already stored in SDFiles, and you would like that data imported into Registration Enterprise, without tediously entering it by hand, you can import the appropriate .sdf files by importing the data into ChemFinder and then into Registration Enterprise. These files become records in the temporary table or the permanent database in Registration Enterprise, depending on the options chosen inside ChemLoader. When an .sdf file is imported into Registration Enterprise, the following steps must be taken:
1. Import an .sdf file into a ChemFinder database.
2. Choose Input and Output Databases 3. Match Fields in the input and output databases
For more information, see the ChemFinder Manual. 2. Open ChemLoader on a server machine. 3. Import the files. ChemOffice Enterprise must be installed somewhere on the server machine being used in order to access ChemFinder. For more information about ChemFinder, see the ChemFinder Manual. ChemOffice is installed by default with the ChemOffice Enterprise.
chosen. 4. View the matches. 5. Import the matches into Registration Enterprise.
182Registration Enterprise
5. Enter a username and password. 6. Indicate where the data should be imported to
by selecting the appropriate radiobutton: Add data to temporary table only OR Add data to permanent table. 7. Click OK. The server name appears in the Output Database box found at the top of the ChemLoader window. All of the information, such as tables and fields, associated with the server appear in the appropriate sections.
The database name appears in the Input Database box found at the top of the ChemLoader window. All of the information, such as tables and fields, associated with the input database appear in the appropriate sections. 3. Click the Browse button to the right of the words Output Database. The Select Server dialog box appears.
under input database and one under output database) 2. Highlight the fields to be matched in the input and output tables (one under input database and one under output database). 3. Click Match Fields. The fields in the separate databases become linked, shown by a line between them.
If you want to
Then
imported records.
select a compound from the Compound pulldown menu. select a notebook from the Notebook pulldown menu. select a salt from the Salt pull-down menu. select a batch from the Batch pulldown menu. select a batch from the scientist pulldown menu.
Administrator
If you want to
Then
include records from the input database that start at a specific place in the database include records from the input database that end at a specific place in the database record the importing process in a log file include a sequence in the imported files include a project name in the imported files
include a salt name in the imported files include a batch name in the imported files include a scientist name in the imported files
2. Click Matches > View.
enter a logfile location in the Log File textbox. select a sequence from the Sequence pull-down menu. select a project from the Project pull-down menu.
3. Click OK. 4. To import the records into Registration Enterprise click Import.
184Registration Enterprise
When the import is complete the import dialog box closes and the records have been imported to the appropriate place in Registration Enterprise. No additional steps have to be taken to use the records normally inside the Registration Enterprise. To abort the import:
In the Dialog dialog box, click Cancel.
On the other hand, Roles do not distinguish which rows a user has access to within a given table. In a system without Row Level Security (RLS) activated, User A sees all compounds in the registry, as does User B. With the implementation of RLS, the rows (records) of data are linked to projects and projects are linked to people. Thus, User A is assigned to a particular project, and will only be able to see compounds that are linked to that project.
The import stops. No additional records are added to Registration Enterprise, but records already imported remain.
Optional Features
There are a number of features available to Registration Enterprise users that are not, by default, in activated. Please see your system administrator for more information about activating any features described in this section.
project_id. In this case, the administrator assigned to the unspecified project can check the temporary table for these types of records, and assign a relevant project to each record.
Activating RLS
For details regarding the activation of the RLS feature, please see the Registration Enterprise Admin Guide or your system administrator.
Administrator
Duplicate Checking
If RLS is enabled, Registration Enterprise inspects both the compound and the project when deciding if a duplicate exists. If the compound being added is a duplicate in the entire system, but not a duplicate within a project, an end user would see no duplicate window appear and the compound is registered as usual. However since the same compound is a system duplicate the record is placed in the Duplicates Table. If a compound is a duplicate within a project, the Duplicate Window appears.
Viewing System Duplicates
A new button is displayed on the homepage called View Duplicates if a user has the correct privileges. Clicking this button retrieves and displays all of the duplicate records using the standard ChemOffice Enterprise List/Display View. The Detail button yields - in red - the duplicate registration number. Currently when duplicates are added they are added twice. That is, if compound A is being registered and Compound B is found to be a duplicate in the system, then the entries in the Duplicates Table will be:
Compound A -> Compound B Compound B -> Compound A
with salt and solvate information in the compound level record, and allow the equivalents to be changed at the batch level. Populate the batch level record with salt and solvate information in the compound level record, and allow all fields to be changed at the batch level. The salt and solvate information is kept completely separate in compound and batch level records. To adjust this default, please see your system administrator.
Customizable Fields
The Registration Enterprise has a number of fields which are by default hidden, but are available to be configured if none of the default Registration fields contain necessary information. The following customizable fields exist:
4 text fields 4 integer fields 4 real number fields 4 date fields
Therefore, when duplicates are checked users see both sides of the picture: A is a duplicate of B and conversely B is a duplicate of A.
Deleting a Duplicate
186Registration Enterprise
The name, datatype, and display type can be adjusted for any of the above mentioned fields. If you feel it is necessary to include an additional field to records, please see your system administrator. Complete details describing the field options available are available in the Registration Enterprise Admin Guide and the ChemOffice Enterprise Admin Guide.
To print records: 1. Click Print. The Print dialog box appears. 2. Check the settings and then click OK. A Registration Enterprise record is printed.
Logging Off
You can end your Registration Enterprise at anytime by logging off. To log off:
Click Log Off.
Choosing Preferences
For more information, see the ChemOffice Enterprise Users Guide.
Printing
You can print records from Registration Enterprise.
The Registration Enterprise Log In dialog page appears. You can log back in and continue using Registration Enterprise, or browse to a different site.
Administrator
188Registration Enterprise CambridgeSoft Logging Off
ChemOffice Enterprise
Sharing information within a company has become easier with the use of the internet, and companywide intranets. CambridgeSofts ChemOffice Enterprise makes it possible for pharmaceutical companies, and laboratories to use this technology to store, manipulate and share chemical structure data, inventory information, and assay data by delivering customized information directly to each users desktop.
CS Oracle Cartridge
The CambridgeSoft Oracle Cartridge introduces a new way of dealing with chemical structure and reaction data in an Oracle database, improving portability and consistency in applications. Since the CS Cartridge is accessed through Oracle, this opens the door for programmers interested in manipulating chemical structure data directly from their code without learning a new language. Using the CS Cartridge is as easy as using a few simple SQL commands. The CambridgeSoft Oracle Cartridge supports CDX, CDXML, MolFile, RXN, and SMILES formats making it flexible enough to be included with both new and legacy data, without the need for conversion.
Chem & Bio Office Enterprise, Workgroup & Databases 2006 ChemOffice Enterprise
189
Administrator
190 CambridgeSoft CS Oracle Cartridge
Logging In
To login to the ChemOffice Enterprise suite of products:
1. Access the following URL: http://servername
where server name is the name of the server where ChemOffice Enterprise 2005 is installed. Contact your server administrator for this name. 2. Access the ChemOffice Enterprise homepage and click on the Global Login link. A login box appears.
Administrator
NOTE: The links visible on this page depend on the
permissions of the user who is logged in. This page includes links to all of the applications the logged in user has access to. 4. Click on a link to enter a particular application. To make changes to the users in the system:
1. Select the application in which the user exists
users.
2. Click Refresh. 3. Click Add User (to add a new user) or
Users
To access the Manage Users interface:
From the Global Login homepage, click
highlight a user name and click Update User (to edit an existing user). A page allowing you to enter user details appears.
Manage Users.
192ChemOffice Enterprise
roles.
2. Click Refresh. 3. Click Add Role (to add a new role) or highlight
a role name and click Update Role (to edit an existing role). A page allowing you to enter role details appears.
4. Enter user details as desired. Fields highlighted
than one role at once, hold down the CTRL key while highlighting. 6. Click OK.
Roles
To access the Manage Roles interface:
From the Global Login homepage, click
in red are required. 5. Select the roles for the role. To select more than one role at once, hold down the CTRL key while highlighting. 6. Click OK.
Administrator
where servername is the name of the server where ChemOffice Enterprise 2005 is installed. Contact your server administrator for this name. 2. Click the ChemOffice Enterprise application link you want to search. For this example, click Sample. The Query Input Form appears.
194ChemOffice Enterprise
Feature
Description
History Menu Queries - Allows users to retrieve a query which was executed in the current session (does not require having saved the query). Hit lists - Allows users to retrieve a hit list which was created in the current session (does not require having saved the hit list). Queries Menu Restore - Displays the last query entered in the Query Input Form, or one of the saved queries. Save - Saves the current query. Manage - Allows users to manipulate (restore, edit, and delete) saved queries and queries in the current history.
Total Records The number next to this image indicates the total number of records in the database being searched. File Menu Preferences - Accesses the Preferences dialog box, where you can set search preferences for the session you are currently in. For more information, see Setting Your Display and Search Preferences on page 211. Print - Prints the current window (equivalent to using the browser's print button). Export Hits - Exports hits to a SD or RD File.
Feature
Description
Feature
Description
Hit Lists Menu Restore - Displays the last hit list created, or one of the saved hit lists. Save - Saves the current hit list. Manage - Allows users to manipulate (restore, edit, and delete) saved hit lists and hit lists in the current history. Marked Hits Menu Show Marked - Displays all marked records. Clear Marked - Clears the marked hits. Help Menu Contents - Accesses the online Help. About - Provides information about the version of the ChemOffice Enterprise software and the database being searched. Log Off Menu Ends the current session and clears any resources used by the user.
Search Button Starts a search. Clear Form Deletes all information in the input form. Add Mode Switches to Add Mode which gives users the ability to add records to the database. Retrieve All Performs a search that retrieves all records in the database.
Administrator
196ChemOffice Enterprise
Search Field
Action
Synonym
Enter a synonym for a molecular name. Enter a molecular weight or a range of molecular weights. For more information, see Searching With Numerical Ranges on page 202. Enter a molecular formula. For more information, see Searching With Molecular Formulas on page 201.
Molecular Weight
Action
pull-
down menu.
Select the type of structure search for your query: Substructure, Full Structure, Exact Structure, and Tanimoto Similarity. For more information about structure types, see Searching With Structures on page 199. Draw a structure. For more information about drawing structures, see the ChemDraw Users Guide. Enter a molecular name or a portion of a molecular name.
Formula
Molecule Name
Administrator
ChemOffice Enterprise finds 30 records that match your query. These results can also be called hits. For more information about:
This subject See
types) Each of the above methods include distinct features which, when used correctly, can help to manipulate a search. In addition, search preferences can be modified to allow valence modifications. For more information on setting preferences, see Setting Your Display and Search Preferences on page 211.
using results for other Search Results on searches. page 203. searching with other types of queries. Searching by Different Query Methods on page 198.
results. Use equals (=) to narrow search results. A regular text field is not a free text search so do not use AND, OR, or NOT for queries.
198ChemOffice Enterprise
of search is indicated by the choice made in the structure pull-down menu found above the structure box. Drawing a structure in the box provided is facilitated by the ChemDraw toolbar. The ChemDraw toolbar makes particular pieces of a structure available with one mouse click. For more information about using the ChemDraw toolbar, please see Drawing Chemical Structures in the ChemDraw Manual. If the ChemDraw toolbar is not visible when you are ready to start drawing: 1. Right click anywhere inside the structure box. 2. Go to View>Main Tools. The ChemDraw Toolbar appears
Records that start with ben, with any combination of characters following. Matches include benzene and benzofuran, but not bromobenzene. Records that include ben anywhere within the field. Other characters can be found before or after ben. Matches include benzene, benzofuran, and bromobenzene. Records that include Benzene with no other characters in the fields entry. Records that have ben as the first three letters of the entry, followed by any number of characters, followed by chl and any number of characters to end the entry. A match would include Benzyl chloride but not Benzene.
*ben
=Benzene
Ben*chl
The following is a list of types of structure searching found in the Structure pull-down menu:
Substructure - A substructure search is a default structure search type. Substructure searching finds structures that contain the query and any additional attachments at the open
position. You can attach different features, such as atom lists and variable bond types, to a structure using ChemDraw plug-in, to perform a narrower or border search.
Administrator
4. Click Search.
Seven records are found because the pyrrole moiety is found in seven structure in the database.
Full Structure - Full structure searching retrieves structure as drawn, with no additional attachments. Isotopes are recognized as hits.
4. Click Search.
Exact Structure - Exact structure searching retrieves only structures as drawn (taking stereochemistry into account). Isotopes are not recognized as hits.
Structure.
200ChemOffice Enterprise
Structure.
idea of the types of compounds you are looking for, but do not know the precise target compound. Similarity searching matches general structural features and not specific atoms and bonds, so highlighting specific areas would be inappropriate To perform a similarity search. 1. On the result form, click New Query. 2. Draw s structure. 3. From the Search Type list, select Tanimoto Similarity. 4. Click Search. The application uses a Tanimoto calculation to determine if compounds are similar. How similar the results should be can be specified in the Preferences dialog box. For more information on setting preferences, see Setting Your Display and Search Preferences on page 211.
5. Click Search.
Tanimoto Searching - The Tanimoto Similarity option finds structures that have structural features that generally correspond to those in the query. Similarity searches are usually indistinct. In a full structure similarity search, the results are guaranteed to include all those you would obtain from a substructure search with the same query and usually some additional hits. Similarity searches are useful if you have a general
upper or lower case. Use element counts that are single integers or ranges (two integers separated by a hyphen). If a count is omitted, it is assumed to be 1. Note that formula searches are completely non-structural. The formula CH3CH2OH matches dimethyl ether and ethyl alcohol because both compounds have the same molecular formula: C2H6O.
determines the precision of the search. A hit is any value that rounds off to the query. For example, the following searches really mean:
Molecular Weight Results
Administrator
C6H6*
Entries with 6 carbons and 6 hydrogens, plus any number of other elements in the formula field. Matches include C6H6, C6H6N2O. 2 carbons and 6 hydrogens. 3 carbons and 6 hydrogens. 6 carbons plus any number of other elements. 6 carbons and between one and three nitrogens, plus any number of other elements. Matches include C6H7N and C6H5NO2.
78.15 78 89.590.5 90.0591.05 90100 >=90 and <=100 >90 and <100
78.145 to 78.155. 77.5 to 78.5. 89.5 to 90.5. 90.05 to 91.05. 90 to 100. 90 to 100. 90 through 100, exclusive.
C6 N1-3*
Combination Searching
Combining the types of searches described above allows the user to really take advantage of the searching power of the ChemOffice Enterprise. The ChemOffice Enterprise searching applications implicitly support combination searching as a Boolean AND search, but does not support OR and NOT searches. To perform a simple combination query: 1. From the Sample Application Query Input Form, enter *ene in the Molecule Name box. 2. Enter 100-200 in the Molecular Weight box. 3. In the Structure box, draw a chlorobenzene. 4. From the Search Type list, choose Substructure. 5. Click Search.
between the values at either end of the range. Ranges may also be indicated using inequality operators (<, >) together with the AND operator.
202ChemOffice Enterprise
The Results List View window appears. The ChemOffice Enterprise finds 1 record that matches your query.
Notice that if the molecular weight range (for example) was not included, more results would have been returned.
The record you want to see appears in the Results List View window, along with the other search results.
Search Results
Performing a search within an application results in a list of items matching your query. All result forms in the ChemOffice Enterprise applications have similar formats, but vary according to what you are searching for, and what is returned. This section describes the results obtained when searching the Sample Database. In order to follow along, login to the Sample Database and perform the search described in Performing a Simple Search.
The appearance of search results can be changed in the Display Preferences. For more information about Preferences, see Setting Your Display and Search Preferences on page 211.
The record you want to see appears in the Results Form View window.
The following buttons are available at the top of the results form to allow the user to view additional records:
If you want to see Then click
Administrator
Next Record
the last record of all Last Record the records returned from the search.
the group of records Previous Record you saw most recently. the first record of all First Record the records returned from the search. a specific record.
Record Number
Type a number in the box, within the given range. Click OK.
204ChemOffice Enterprise
hits retrieved for your application, please see your system administrator. The default number of maximum hits for Sample is 100. To retrieve the first 100 records of a database: 1. From the Query Input Form, click Retrieve All. The Results List View appears, showing records 15 of 100 hits. To see the next 100 records:
In a Results Form View window, click Get More
Hits.
The Show Last List button appears on the left side of the window, below the Clear Marked button. To see the most recent Results List View:
From the Results List View, click Show Last List.
The most recent Results List View appears. To remove a record from the marked records list:
From the Results Form View or the Results List
View, click Unmark Record.
The Results List View changes, showing records 101105 of 200 hits.
The Unmark Record button changes to the Mark Record button for the records you unmarked. To remove all of the marked records from the marked records list:
From the Results Form View or the Results List
View, click Clear Records.
The Unmark Record button changes to the Mark Record button. No records remain marked.
Manipulating Queries
The Queries menu gives users access to tools, which allow you to restore, save, and manage queries which have been performed. This is especially useful to users interested in using a particular query more than once without going through the process of entering the parameters each time.
Restoring Queries
Restore Query allows the user to restore previously entered search criteria to an input form. There are two options when restoring a query:
Restore the last query entered Restore a saved query
3. Click Restore.
Administrator
4. Edit your criteria and click Search. 2. Edit your criteria and click Search.
Saving Queries
Users can save a query to be recalled at a later time. This is often useful when you expect to run the same search more than once.
Menu.
206ChemOffice Enterprise
To Save a Query:
1. After performing a search, select Save from
2. Enter a name and description for the query. 3. Select the Make Public checkbox if you would
Restoring Queries For information about restoring queries, please see Restoring Queries on page 205.
like other users to be able to access the query. 4. Click OK. Your query is saved. For information about retrieving this query, please see Restoring Queries on page 205.
Managing Queries
The Manage Queries dialog box allows users to restore, edit, and delete queries in the current history and saved queries. Saved queries are user specific. To start managing your queries, select Manage from the Queries menu.
Edit Query allows the user to enter new identifier information for the query, such as a new name and description, or make the query public. Making a query public makes your query accessible by any other user of the system. To edit a query:
1. Select the appropriate query from the listbox. 2. Click Edit.
Administrator
3. Enter the appropriate information and click
Menu. The hit list is displayed in list form. To Restore a Saved Hit List:
1. Select Restore > Saved from the Hit Lists
Menu.
OK. The query information has been edited and you are returned to the Manage Query window.
Delete Queries
Only saved queries can be deleted. History queries remain in the query list until the history is cleared. To change when the history is cleared, please see your system administrator. To delete a query:
1. Select the appropriate saved query from the 2. Select the appropriate hit list from the listbox. 3. Click Restore.
the Hit Lists Menu. 2. Enter a name and description for the hit list. 3. Click OK. Your hit list is saved. For information about retrieving this hit lists, please see Restoring Hit Lists on page 208.
208ChemOffice Enterprise
Restore Option
Result
A hit list is displayed which contains all of the hits in the current list, not including any hits also found in the saved list.
Union with A hit list is displayed which Current contains all of the hits in the List saved list as well as those in the current list.
To restore a hit list:
1. Select the appropriate hit list from the listbox. 2. Select the appropriate radio button (to indicate
When restoring a hit list from the Manage Hit Lists dialog box, saved hit lists can be merged in specified ways to generate a new hit list. The options when restoring a hit list are:
Restore Option Result
how you would like the list restored). 3. Click Restore. The hit list is displayed in list view.
Editing a Hit List
Edit Hit List allows the user to enter new identifier information for the hit list, such as a new name and description, or make the hit list public. Making a hit list public makes your hit list accessible by any other user of the system. To edit a hit list: Edit Hit List allows the user to enter new identifier information for the hit list, such as a new name and description. To edit a hit list:
1. Select the appropriate hit list from the listbox. 2. Click Edit.
A hit list is displayed which contains only the hits found in both the saved list and the current list.
The edit hit list window appears: 3. Enter the appropriate information and click OK.
Only saved hit lists can be deleted. Hit lists in the history remain in the hit list until the history is cleared. To change when the history is cleared, please see your system administrator. To delete a hit list:
1. Select the appropriate saved hit list from the
Administrator
listbox. 2. Click Delete. The hit list is deleted from the list.
query. For example, if you want to refine the search to only compounds that have a hydroxyl attached: a. Draw methanol. b. From the Search Type list, choose Substructure. 2. Click Apply. Results from the example refined search (above), contain all of the compounds in the dataset which include the hydroxyl group. Records in the database which were not hit in the original search will likewise, not be part of the refined search.
210ChemOffice Enterprise
To export search results: 1. After marking his, from a Results View, click Export Hits. The Export Hits dialog box appears.
application is configured. Please see your system administrator for more information about when the history is cleared. Use the History menu to restore a query or hit list in your history:
1. Select Queries or Hit Lists from the History
4. 5.
6.
the file. Select a type of SD file: flat - in the event of multiple results for one field: a record is created for each result. nested - multiple results for one field all appears in one cell. Click OK. Click to Download. The Save As dialog box appears, containing a numerical name for the sdf file, based on the date and time. Select a download location and click Save.
Histories
The application history can be used to retrieve queries and hit lists which had been executed earlier, but were not necessarily saved. The history is cleared periodically, according to how the
The new preferences are applied to your next search. To set search preferences: 1. Click Preferences. The Preferences dialog box appears.
2. Take the appropriate action:
Administrator
2. Take the appropriate action:
match the charges or Click Hit any radicals to the charge on heteroatom in your heteroatom. query structure. match the charges or Click Hit any radicals to the carbon charge on carbon. in your query structure. require that the Click Reaction Query reaction centers in Hit Reaction Center. the query overlap the reaction centers in the target
If you want to
Action
see search results one From Results record at a time. Display, click Form. see search results several records at a time. From Results Display, click List.
specify the number From the Number of records you see in Displayed in List List View. View, type a number in the Number box.
3. Click Apply.
212ChemOffice Enterprise
Select the appropriate checkbox next to Permit Extraneous Fragments in Full Structure or Reaction searches. If Permit Extraneous Fragments (for structure or reaction searching) is selected, the search wil allow hits to contain molecular fragments in addition to that which was hit by the query.
match the cis/trans double bond geometry to your query structure. make thick bonds represent relative stereochemistry require absolute relative stereochemistry
3. Click Apply.
Click Thick Bonds Represent Relative Stereochemistry Click Absolute Relative Chemistry
Server Information
You can retrieve information about the server software currently in use and the database being searched from the application window. To get Server information:
Click the About button in the ChemOffice
From the Similarity search box, type a number between 0 and 100. A lower value requires the target to be less similar than your query structure.
match the tetrahedral Click Match chirality to your tetrahedral stereo. query structure.
Logging Off
When you first access a ChemOffice Enterprise application, you start a user session with the server. Although the server times out after a period specified by your administrator, you can log off when you are finished with the session.
To log off:
Click Log Off.
You are logged off and the server resources that you use are released.
Administrator
214ChemOffice Enterprise CambridgeSoft Logging Off
Installation
Please take the following steps to install the Oracle Cartridge (for the first time):
1. Double-click the SetupCartridge.exe
Installation
Minimum Requirements
Oracle 8i or 9i ChemOffice 7.0 or later
Before Installation
Before attempting to install the Oracle Cartridge, please take the following steps:
The file init.ora must contain the following
line: COMPATIBLE=8.1.0 or higher. Users planning to index their tables with the cartridge must have the following privileges granted: CREATE TABLE CREATE ANY INDEXTYPE
platform, then hit OK. The installation program checks if Oracle is configured correctly to be able to run the extproc agent. Without the correct configuration, the cartridge can not be used. See See Setup Problems on page 234. During the installation the installer executes a sql script, and copies files to the server.
In Windows installations the installer must run
on the server.
ftp service. If the server does not run an ftp service, or using it is not allowed for security reasons, the Unix system access must be left empty. In this case the files to be copied to the ${ORACLE_HOME}/lib/CsCartridge are copied to the users temporary directory. By default, that directory is: Documents and settings\user_name\Local Settings\Temp and it is the DBAs responsibility to copy them to the target directory. The install program can work in four distinct modes: Full install. If a previous installation exists, it is completely replaced with the new installation. All stored procedures and support files are replaced. Any existing index created by a previous installation of the cartridge becomes orphaned. The indexes still exist, but they are unusable. All of those indexes have to be dropped and re-created with all the overhead involved. Partial install. In this case no stored procedure or no object in the Oracle database is affected, only the shared library containing the external functions and procedures are replaced. All previously created indexes are still valid, they can be used without any further action. Partial install is useful if a new minor build of the cartridge is available, and there was no change in the data model. Partial install should be chosen only after consulting with CambridgeSoft to ensure that the data model in the old version and the new version are the same. Minimal install. This is not a real installation, the install program only creates an SQL script, which if executed using an appropriate tool, like SQL plus, results in the same database objects as a normal install. This option should
not be used generally. Sites with higher than usual security requirements may opt for first creating the SQL script, review it end execute it manually. No install. This is after installation test if the installation was manual.
Administrator
Un-installation
To uninstall the Oracle Cartridge, please do the following:
1. Remove the directory as follows:
On Windows:
${ORACLE_HOME}/bin/CsCartridge On UNIX: ${ORACLE_HOME}/lib/CsCartridge 2. Execute the DROP USER CsCartridge command while connected to Oracle as a system administrator. If the name of the instance is not CsCartridge, then the appropriate instance name must be used.
Re-installation
Re-installing the Oracle Cartridge can be accomplished by following the same steps as See Installation on page 215. The "Partial install" option also can be chosen with re-installation. This option should be chosen only if it is known, that the data model used by the cartridge did not change from the installed version. Partial install is fast, existing indexes do not have to be re-built, but it is recommended to consult with CambridgeSoft's support if partial install is planned. If a full installation was performed over an existing installation, then all the existing cartridge indexes have to be recreated. Those indexes still exist, but orphaned, without any data supporting them. They have to be first dropped, then re-created with the appropriate CREATE INDEX command. The installer program helps with this project. In the case of a re-installation the installer program pops up
CambridgeSoft Installation
dialogs with every existing cartridge index, and prompts the user if re-creating the index is desired. The user has to enter the password for the schema of the table, and may change the CREATE INDEX sql statement. To enable this feature the "Recreate existing indexes" check box must be checked.
CREATE TABLE CREATE LIBRARY CREATE PROCEDURE CREATE OPERATOR CREATE INDEXTYPE CREATE TYPE SELECT ANY TABLE UNLIMITED QUOTA ON the
Multiple Installations
The CambridgeSoft Oracle cartridge is installed under normal circumstances into the CsCartridge schema, and the data files are stored into the $ORACLE_HOME/binCsCartridge (windows) or $ORACLE_HOME/lib/CsCartridge (unix) directory. It is possible to change this default setting by changing the name of the instance field in the install program. This can ensure, that two separate instances exist at the same time. Most likely this can be desired, when different versions of the cartridge are planned to be compared against each other. Normally this feature should not be invoked, and it takes highly skilled supervision to maintain two cartridge instances. Most likely client programs do not ask the end user to choose a cartridge instance, but resort to the default CsCartridge name. This is the name we use throughout this documentation. But ad-hoc sql easily can be used against two installs, and client programs can consider various cartridge installations. So if the "cartridge instance name" is CsCartridge2, then everywhere CsCartridge2 must be used instead of CsCartridge, when the cartridge is used.
T_CsCartridge tablespace The CsCartridge user in turn grants EXECUTE privileges to PUBLIC on all the functions, operators, and types designed to be accessible from external accounts. It also grants all privileges on tables it creates in its schema to the response of a user request to index a table.
DDL Considerations
DDL (Data Definition Language) statements include statements used to create and manipulate data. Examples include (but are not limited to) CREATE, and DROP. Chemical structures must be stored in either BLOB (binary large object) or CLOB (character large object) data type fields. BLOB fields must contain CDX documents. CDX documents are created by the ChemDraw application, and by the ChemDraw ActiveX control. CLOB fields can contain encoded CDX documents, CDXML documents, SMILES strings or MolFiles. A SMILES string is a way to describe a chemical structure in a line of text. MolFiles are ASCII files containing atom and bond property
Security
The CsCartridge.sql script creates a new user with the name of CsCartridge and password also set to CsCartridge. The following system privileges are granted to CsCartridge:
GRANT CREATE SESSION TO
CsCartridge
information. When MolFiles are used as input, carriage return/linefeed characters must be replaced by a single back-slash (\) character.
NOTE: For more information about CDX and MolFile formats, please see "Exporting and Importing Using File Formats" in the ChemDraw Users Guide. For additional help in creating SMILES strings, please see "SMILES and SMIRKS Strings" in the ChemDraw Users Guide.
The ChemDraw ActiveX control as well as a number of other applications, can save documents in any of the above formats.
where:
ix - is an arbitrary name. This name should be
short, because the cartridge concatenates it with the user name to create different tables, and the length of table names is restricted to 20 characters. tab - is the name of the table containing a field designated to store chemical structure information. fld - is the name of the field designed to store chemical structure information. param - is a string containing keyword=value pairs delimited by commas The PARAMETERS clause is optional. The individual parameter settings must be separated by commas. The supported keywords are as follows:
TABLESPACE=tablespace_name
If present, then the tables created by the cartridge will not be created in the default T_CsCartridge tablespace, but rather in the tablespace_name tablespace provided by the user. The creator of the tablespace must have already allocated a reasonable quota to the CsCartridge user on that tablespace. SKIP_POPULATING=[YES|NO] If present, the indexes will be created normally, but data stored in the table will not be used to populate the tables created by the cartridge. The user has to do it manually. This option should be used only for troubleshooting. That is, use this option only if an earlier attempt to create an index failed for some reason. The cartridge tables can then be populated by one or more UPDATE statements following the pattern below: UPDATE tab SET fld = fld; One table can contain any number of fields designed to store chemical structure information, and some or all of them can be indexed by the cartridge. If indexing of the structure field is not desired, use the following: DROP INDEX ix This will disable the cartridge, and remove all data, created in conjunction with the working of the cartridge, from the database. REACTION_SEARCH=[YES|NO] Substructure search screens are generated differently if this option is set to YES. Reaction searches are expected to be somewhat faster. RAISE_ERROR=[YES|NO] This option specifies if the cartridge should raise an error if a document is passed to it, which can not be interpreted as any of the supported data formats. If it is set to NO, no
Administrator
exception will be raised, and an entry will be stored into the CsCartridge.schema_index_E table. NORMAL=[YES|NO|INDEX] If present, this option instructs the cartridge whether to create and maintain screen tables for regular substructure search. The default is INDEX. SIMILAR=[YES|NO|INDEX] If present, this option instructs the cartridge whether to create and maintain screen tables for similarity search. The default is NO. FULLEXACT=[YES|NO|INDEX] If present this option instructs the cartridge whether to create and maintain screen tables for full structure search allowing tautomer matches as well. The default is NO. SKELETAL=[YES|NO|INDEX] If present, this option instructs the cartridge whether to create and maintain screen tables for substructure search, which honors tautomer matches as well. The default is NO. THREE_D=[YES|NO|DISTANCE|ANGLE ] If present, this option instruct the cartridge to maintain tables for 3d searching. The default is NO. REACTION_SCREENING=[YES|NO] If present, this option instructs the cartridge whether to create and maintain screen tables which can be used for performing better similarity searches, and increase the speed of the substructure search for reaction searches. The default is NO. THREE_D_RESOLUTION=[HIGH|LOW] If present, this option instructs the cartridge what level the screening should be carried out. Default is HIGH. DEFAULT_CUSTOM_SCREENS=[YES|NO]
If present, this option instructs the cartridge whether to use the structures from the default custom screens table. The default is NO. UNIQUE=[YES|NO|STEREO|RELATIVE TETSTEREO] If present, this option instructs the cartridge if duplicate structures are banned. If UNIQUE is YES, then structures must differ from each other except for stereochemistry. If UNIQUE is STEREO then a strict canonical code is used to check the identity of chemical structures. If the UNIQUE option is set to RELATIVETETSTEREO, then stereochemistry is considered, and bold bonds are treated as wedges. The default is NO. Version 9 of the CambridgeSoft Oracle cartridge distinguishes four different kinds of screens. NORMAL, SIMILAR, FULLEXACT and SKELETAL. NORMAL is used for regular substructure search screening. SIMILAR may be used for similarity search. The FULLEXACT screens are used for tautomer full structure search, and the SKELETAL screens are used for tautomer aware substructure search. If one of those screens should be present for a search, but are not, then the cartridge does not make any screening. Results will be generated as expected, but the program will be slower in lack of screening. Three different values can be assigned to these parameters: NO, YES or INDEX. If 'NO' is chosen, then a particular kind of screening will not be available. If 'YES' is chosen, then screening bitvectors will be stored and used for that particular screen. In this case the database will be screened when substructure search is requested resulting in faster turnaround. If 'INDEX' is chosen, then an inverted screen table will be maintained by the cartridge making the screening phase even faster. Choosing this option results in fastest turnaround for substructure searches, the trade-off is slower maintenance, and the occasional need for synchronization and analyzing the index. 'INDEX' is the default for
normal screens, and 'NO' is the default for the remaining screens. 'INDEX' is recommended for large tables which do not change frequently and high substructure search speed is expected. The settings chosen at the time the index was created can not be modified later by using the ALTER INDEX command. Three dimensional data is stored only if the THREE_D option is set to YES when the index is created. This setting can not be changed later by the ALTER INDEX command. If the THREE_D option is set to DISTANCE, then the cartridge stores and maintains only atomatom distances information, if it is set to ANGLE, then only angles defined by three atoms or a centroid are stored. Setting the THREE_D_RESOLUTION to LOW is also one way of making the three dimensional screening process faster, and to reduce the size of a three D enabled database. It will decrease the quality of the screening. Only the first significant digits of the distances and angles will be stored. The REACTION_SCREENING options directs the cartridge to maintain screens for both the reactants and the products of a reaction in addition the regular screens. This information is used, when similarity search is to be restricted to either the reactants or to the products. Similarity search when both reactants and products are specified are not considered valid, and result in "invalid query structure" error raised. A structure on the left side of a reaction arrow is considered reactant, and on the right side of a reaction arrow is considered a product. No other action is required to do reactant/product similarity searches. The screens maintained by the cartridge when REACTION_SCREENING is enabled are also used for substructure searching. This usage is mostly transparent to the user, because the only difference is, that substructure searches for reactions are faster. Though it must be noted, that
substructure search will be faster only when synchronization is recent, and not many records are in the temporary tables.
Example
CREATE TABLE moltable(mol CLOB); CREATE INDEX mx ON moltable(mol) INDEXTYPE IS CsCartridge.MoleculeIndexType;
Administrator
It is important to remember, when creating an index in a different schema than the logged-on user, both the index name and the table name must be qualified by the schema name. Otherwise, the cartridge will not connect its tables to the original table. For example:
CREATE INDEX mx ON USER1.moltable(mol)...
NOTE: Creating an index may be time consuming if the table already contains lots of records when the index is created.
that updating the database is also reasonably fast, the cartridge does not update its inverted tables, when a client program updates an indexed table. Instead, it just simply stores a remainder into a temporary table about the update. The changes accumulated in the inverted tables are not merged into the main inverted tables until the DBA explicitly requests by executing an
ALTER INDEX ix PARAMETERS('SYNCHRONIZE');
AnalyzeIndexTables. That procedure has two parameters, the name of the user's schema, and the name of the index. An example of the usage of the AnalyzeIndexTables command follows: CALL CsCartridge.AnalyzeIndexTables('myschema ', 'myindex');
command. Whether or not this synchronization was executed is transparent to the user. The only visible effect of not executing the synchronization is a lower speed for substructure search. Most likely there will be no effect on search speed until a few tens of thousands record accumulation in the temporary tables. Even when the synchronization is executed, the inverted tables are not updated fully. Some statistics, which influence the execution of a substructure search are still not updated. Those statistics are recalculated to match the contents of the inverted tables, when an
ANALYZE INDEX ix COMPUTE STATISTICS;
The ANALYZE command can also be used to verify the integrity of the cartridge index. Normally, this command should just return without any message. If it throws an exception, then the domain index is in an unusable condition, and the index may need complete rebuild. The command to execute is
ANALYZE INDEX ix VALIDATE STRUCTURE;
Oracle Corporation does not recommend using the ANALYZE command most of the cases directly from version 9i. Below is a a quote from the SQL reference of Oracle 9i: Oracle Corporation strongly recommends that you use the DBMS_STATS package rather than ANALYZE to collect optimizer statistics. That package lets you collect statistics in parallel, collect global statistics for partitioned objects, and fine tune your statistics collection in other ways. Further, the cost-based optimizer, which depends upon statistics, will eventually use only statistics that have been collected by DBMS_STATS. See Oracle9i Supplied PL/SQL Packages and Types Reference for more information on this package. However, you must use the ANALYZE statement (rather than DBMS_STATS) for statistics collection not related to the cost-based optimizer, such as:
To use the VALIDATE or LIST CHAINED ROWS clauses To collect information on freelist blocks
command is executed. The execution of this command is also time consuming. This command has to be executed just rarely, only when a large portion of a database is replaced. It should be executed, when the database is close to its expected full size. Or every time if the size of the indexed table doubles. The execution of those two commands is the responsibility of the DBA. Right now, there is no mechanism implemented to execute the commands automatically. The lack of the execution of those commands in a timely fashion may result in diminished performance. Executing the ANALYZE INDEX command does not analyze the tables maintained by the cartridge. This is usually is not necessary, only if the tables and/or columns maintained by the cartridge are directly referenced. This must be done explicitly by the DBA by calling the provided procedure
Unique index
When the index is created it is possible to control if duplicate structures are allowed. Due to the ambiguities of defining the identity of a chemical
structure many options are available. Those options can later be changed according to the needs of an application for the duration of a transaction. For that purpose, the ChangeOption stored SQL procedure can be used. Of course it can be used for other purposes as well, but that was the main reason for the implementation. The syntax of the ChangeOption procedure is ChangeOption(schema_name, index_name, identifier_name, value); All parameters are strings enclosed in single quotes. To allow duplicates on a given index call the ChangeOption procedure like
CALL CsCartridge.ChangeOption('my_schema', 'my_index', 'UNIQUE', 'NO');
Administrator
where:
tab - is the name of the table to be retrieved fld - is the name of the field indexed by the
If you want to make these settings permanent, execute a commit command. Otherwise, the settings will effect only the current transaction.
DML Considerations
DML (Data Manipulation Language) statements include statements used to manipulate data. Examples include (but are not limited to) SELECT, INSERT, DELETE, and UPDATE. Data maintenance related to the cartridge is for the most part automatic, and no extra work is required. Every time a record is inserted into a table containing an indexed field, the cartridge is automatically invoked by the Oracle server. The cartridge is also invoked if a record is deleted, or if an indexed field storing a chemical structure is updated.
cartridge query4000 - is the first 4000 characters of the query string. The query string can be an encoded CDX document, a SMILES string, or a MolFile. For more information about these formats, please see See DDL Considerations on page 217.. The Oracle server limits the size of string literals to 4000 characters. query8000 - is the second 4000 characters of the query string. Queries exceeding the 8000 character limits will fail. Since CDX documents can be very large, this limitation may become important. However even in this case, an 8000 byte limit should not impose too much of a restriction. options - is a string containing keyword=value pairs separated by commas. The interpreted keywords are: ABSOLUTEHITSREL=[YES | NO] Default is NO COMPLETE=<number> - to limit the number of hits tested against atom by atom matching DOUBLEBONDSTEREO=[YES|NO] double bond stereo matching. Default is YES. FRAGMENTSOVERLAP=[YES|NO] fragments can overlap. Default is NO. FULL=[YES|NO] - to specify full structure search. Default is substructure search
HITANYCHARGECARBON=[YES|NO]
hit any charged carbon. Default is YES. HITANYCHARGEHETERO=[YES|NO] hit any charged hetero atom option. Default is YES. IDENTITY=[YES | NO] - Default is NO MASSMAX=<number>- to prescribe maximum molecular mass to matching records MASSMIN=<number> - to prescribe minimum molecular mass to matching records PERMITEXTRANEOUSFRAGMENTS=[ YES |NO] - permit extraneous fragments. Default is NO. PERMITEXTRANEOUSFRAGMENTSIFR XN=[YES |NO] - permit extraneous fragments. Default is NO. REACTIONCENTER=[YES|NO] - to specify if reaction search can match only reaction centers. Default is YES. RELATIVETETSTEREO=[YES | NO] Default is NO SIMILAR=[YES|NO] - similarity search. Default is NO. SIMTHRESHOLD=<number> - to set the similarity percentage when SIMILAR=YES is set as well. Otherwise disregarded. Default value (used if it is omitted) is 90 percent. TAUTOMER=[YES|NO] - Default is NO TETRAHEDRALSTEREO=[YES|NO|SA ME|EITHER|ANY] - tetrahedral stereo matching. Default is YES. USE_THREADS=[YES|NO] - Default value is read from the Globals table SELECTIVITY=<number>-to communicate with the Oracle query optimizer. See Query Optimization on page 225.
the Oracle query optimizer. See Query Optimization on page 225. FUNCTIONCOST=<number>-to communicate with the Oracle query optimizer. See Query Optimization on page 225. There is no restriction for SELECT statements when used with the cartridge. Tables can be joined by other tables, and the WHERE clause can be formed by using all the options of Oracle. The COMPLETE option can be used by client programs, which expect huge databases and substructure searches resulting in large hit lists. The cartridge will apply the atom by atom matching only until the value specified in the COMPLETE option is satisfied. After this value is satisfied, everything which passes the screening process will be returned to the client program as a hit. It is the responsibility of the client program to call the CsCartridge.ContainsCDX.MolContains function to apply the atom-by-atom matching test. This function has the same syntax as the MoleculeContains operator. A major advantage of approaching this issue in this way is that the hit list will be returned at least ten times faster. The disadvantage is that atom-byatom matching must be invoked for every item in the hit list before the first number of records indicated by the COMPLETE option. Therefore, the number of hits will not be accurate. The use of this option is recommended, when the result is presented to the user in segments and the user is not expected to browse through a huge list. The USE_THREADS option directs the cartridge whether to apply multithreading when performing a search. The value is used in conjunction with the value stored into the Globals table. If the value in the Globals table is NO, then the option is
disregarded. It has effect only if the value in the Globals table is YES. Multi threading may make the program faster, and can improve user perception.
Simple Example
SELECT mol FROM moltable WHERE CsCartridge.MoleculeContains(mol, 'c1ccccc1', '', 'MASSMIN=200, MASSMAX=500')=1; selects all records from the table moltable where the mol field contains benzene as a substructure (c1ccccc1), and the molecular mass is between 200 and 500.
Unfortunately the above approach does not work on all platforms. According to test results, on some systems, where the server computer and client computer's character set is different, the ORA01460 unimplemented or unreasonable conversion requested exception is raised by the server. The cause of this error is an Oracle bug: #2233987. This bug is manifest on platforms where the server character set is not known by the client. Oracle 9i server may have a DB character set, which is not know to an Oracle 8i client. According to our research and consulting with Oracle Technical Support the workaround of this problem is to limit the size of strings passed in the XArray to 666 characters. That is very likely a good solution, however there may be configurations which are saddled with other similar problems. When both the client and the server run Oracle 9i, this problem has not been observed yet. To bypass the possibility of this problem:
The client program may pass the text of a
Administrator
SELECT statement to the MoleculeContains operator as its second parameter in the first form of MoleculeContains. The third parameter should be left blank. The first element of the SELECT statement's select list must be a CLOB field, and the execution of the SELECT statement should result in one output record. This data will be used by the cartridge as the query structure. The application program has to store the query structure before using the MoleculeContains operator. The CsCartridge user must have access to the table or tables referenced in its parameter. The programmer can use the Queries table in the CsCartridge schema to store query structures. The Queries table has three fields: ID - a numerical identifier
explanation to the query, and the QUERY field itself. Also available is the QuerySequence SEQUENCE to ensure unique identification. A simple example to illustrate the programming required for the usage of this feature: INSERT INTO CsCartridge.Queries(id, note, query) VALUES(1234, 'benzene query', 'c1ccccc1'); SELECT mol FROM moltable WHERE CsCartridge.MoleculeContains(mol, 'SELECT query FROM CsCartridge.Queries WHERE id = 1234', '', '')=1; The SELECT statement passed as a string is executed as if the connected user was CsCartridge. References to tables outside the CsCartridge schema must contain table names qualified by their schema.
The INDEX hint can be used to instruct the optimizer to prefer using a particular index. The syntax of the INDEX hint is SELECT /*+ INDEX(table_name index_name) */ ..... Table_name and index_name are names of the preferred table and index, respectively. Using the INDEX hint is recommended when it is in doubt which implementation will be used by the optimizer, and IDENTITY=YES option is used, because identity search can be performed only by using the index.
Query Optimization
The cartridge implements user defined statistics, which are used by the Oracle query optimizer. These statistics are used by Oracle to decide whether to use the index scan implementation of the MoleculeContains operator or the functional implementation. Table scan means, that the cartridge is the first piece of software selecting a subset of rows from a table. The remaining conditions of a WHERE clause are evaluated later. If the WHERE clause contains a condition, which is more selective than the cartridge; which results in a smaller subset, then the execution of the query is probably slower than it should be. Such bad decisions can result in queries executed thousand times slower than they should be. There are two statistics implemented in the cartridge at this moment. Selectivity and Cost. Selectivity is set to 0, which communicates to Oracle, that the functional implementation is not selective at all. Cost is the CPU cost associated with an index scan. If the query options contain an IDENTITY=YES setting, then the cost returned to Oracle is set to 0, otherwise it is set to 1. According to experience, this results in Oracle preferring index scan when IDENTITY=YES, and use an other highly selective primary key if IDENTITY=NO. This approach is rudimentary, and will be refined later.
However, if the calculation performed by the cartridge does not result most of the time in the desired results, then it is possible to override the values calculated by the cartridge. The SELECTIVITY=number, and the COST=number, options can be used to control Oracle's optimizer. This approach is more flexible, than using optimizer hints, because it just communicates information to Oracle used to make decisions, which are compared to similar information provided by other indexes and access methods. It's very important to know, that Oracle calls the user defined statistical functions once for a certain argument list. In other words, if the same values are passed to the MoleculeContains operator in the structure and option fields, the cartridge statistical functions will be called only once. So, if the second parameter a for the MoleculeContains operator contains a SQL statement, which in turn contains the real query, the optimizer will not invoke the statistical functions, and will act on false presumptions. So, that method of passing a query should not be used if the outcome of the optimizer is important.
'FULL=YES' or 'FULL=NO' The FormulaContains operator will select records from the database, where the counts of the specified atoms are in the prescribed limits. If the options field specified full match, then no other kinds of atoms are allowed in the formula. For example:
SELECT mol FROM moltable WHERE CsCartridge.FormulaContains(mol, 'C510Br2-4', '')=1;
Administrator
MolWeight Query
The cartridge allows quick search by molecular weight by the MolWeightContains operator. This operator can be used in the WHERE clause of a SELECT statement as follows:
SELECT ... FROM tab WHERE CsCartridge.MolWeightContains(fld, massMin, massMax, options)=1
where
tab - is the name of the table to be retrieved fld - is the name of the field indexed by the
Formula Query
A subset of a table can be selected by setting constraints on the formula of a structure by using the FormulaContains operator. This operator can be used in a SELECT statement as follows: SELECT ... FROM tab WHERE CsCartridge.FormulaContains(fld, formula, options)=1 where:
tab - is the name of the table to be retrieved fld - is the name of the field indexed by the
cartridge massMin - is a numeric value setting the minimal molecular mass retrieved massMax - is a numeric value setting the maximal molecular mass retrieved options - in this version the options field is not used For Example:
SELECT mol FROM moltable WHERE CsCartridge.MolWeightContains(mol, 70.0, 70.1, '')=1;
cartridge formula - is a list of atom symbols followed by a number and optionally another number introduced by a minus sign.
Support Functions
The cartridge supports the retrieval of chemical structure information in different formats beyond the default CDX format. At the present SMILES, RXN and Molfile formats are allowed.
Conversion functions are available, grouped together into the ConvertCDX package. The functions are:
CDXTo3dInfo(fld) CDXToB64(fld, i) CDXToCanonical(fld) CDXToCanonical(fld, option) CDXToCDXML(fld) CDXToCDXML(fld, i) CDXToFormula(fld, option) CDXToMolFile(fld) CDXToMolFile(fld, i) CDXToMolWeight(fld) CDXToMolWeight(fld, option) CDXToName(fld, option) CDXToRxnFile(fld) CDXToRxnFile(fld, i) CDXToScreen(fld, srcSelection,
storing chemical structure information in any form supported by the cartridge, but not necessarily maintained by the cartridge. i - is an index (starting at 1) referring to which 4000 character long chunk of the resulting text is being pointed to. This is necessary, because Oracle limits the size of string results in 4000 characters. option - is a field that is either empty or: SORTABLE
for the CDXToFormula function to generate formula strings where the elements are two characters wide, and the numbers are three characters wide with leading zeros. The field does not have to be indexed; only the content must match the supported content kinds of the cartridge. They can appear in a SELECT list, but there is no restriction on their usage or HTML for the CDXToName function to generate HTML tags for names, where the name needs subscripts, superscripts and styling. NORMAL or STEREO for the CDXToCanonical function. With the STEREO option the canonical code will consider stereochemistry when generating the canonical code, with NORMAL option or an empty option string stereochemistry is disregarded. MASSNATIVE or MASSMONOISOTOPIC or empty for the CDXToMolWeight(fld, option) function. With the MASSMONOISOTOPIC passed as option string, the exact mass is returned. The most abundant isotope's mass is used instead of the weighted average of the isotopes of the atoms of the molecules. The CDXToScreen function needs a parameter selecting the source, allowable values are 'NORMAL', 'SIMILAR', 'FULLEXACT', 'SKELETAL', and a parameter selecting the form of the output. Values are 'LIST', 'BITSRING'. If the requested screen does not exist, or input is incorrect empty string will be returned. Those conversion functions, which take i as the second parameters must be called with the actual value increased by one as long as the result is not an empty string. The index value 1 asks for the first 4000 bytes of the result, the index value 2 points to
the second 4000 bytes of the result, and so on. The 4000 byte chunks of the results must be concatenated to really get the desired output. This by no way an effective way of retrieving those converted formats, that hopefully will be improved in later versions of the cartridge. In version 9 of the cartridge there are two forms of the CDXToMolFile, CDXToRxnFile, CDXToSmiles and CDXToCDXML functions. The new function implementations have only one parameter, the name of the field, and can return longer than 4000 byte long strings. The only drawback, that they can be used only if the server is an Oracle 9 server. Using the new implementations result in an error message when using against an Oracle 8 server. Also should be noted, that this functions return CLOBs instead of VARCHAR2 data, and the temporary CLOBs created by the cartridge linger in the server memory until the session is over. It advised, that the client session terminates as soon as possible after using these functions. Examples:
SELECT CsCartridge.ConvertCDX.CDXToMolFil e(mol) from .....
MoleculeContainsBLOBFunction operates on
BLOB fields. The remaining three parameters are the same as for the MoleculeContains operator. Example:
SELECT mol FROM tab WHERE CsCartridge.MoleculeContainsFunction(mol , 'c1ccccc1','','')=1;
Administrator
The cartridge also provides an opportunity to check data integrity by retrieving a md5 checksum for any CLOB or BLOB field. That feature can be invoked in a select statement with the following format:
SELECT CsCartridge.CheckSum.Calculate(fld ) FROM ...
The functional implementations of the MoleculeContains operator can also be used to perform atom-by-atom matching on fields. It can be used if the field is not indexed, and the result set will be the same, but the execution will be slow. This is because Oracle will sequentially read in the whole table, and select those records which pass the atomby-atom matching. There are two functions:
MoleculeContainsFunction operates on CLOB
A more advanced way of retrieving the molecular weight or the formula is using the MolWeight, Formula and Canonical operators. They can be used as normal functions, but they are implemented in a way to take advantage of the data calculated by the cartridge when records are stored. If the field name parameter passed to these operators refers to a field indexed by the cartridge, instead of processing the input data, the operators use data stored by the cartridge, thus improving the processing speed. However, these operators can not be used for search effectively, because they could never trigger index scan. If these operators are used in a WHERE clause, an ORA-29902: error in executing ODCIIndexStart() routine exception is thrown. The Canonical operator can not have a second parameter. In version 9 of the cartridge only the stereochemically unaware canonical code can be returned by using this operator. Usage example:
SELECT CsCartridge.MolWeight(mol), CsCartridge.Formula(mol, ''), CsCartridge.Canonical(mol) FROM moltable;
fields
Distributing databases
The CDXToMST function can be used to speed up index creation on tables already populated by a large number of records. The CDXToMST function returns a BLOB, which is an augmented CDX document. The new CDX document contains the original one and transparently to ChemDraw and other programs processing CDX documents, and it contains data calculated by the cartridge, yet not stored in the index structures. If a database is to be distributed as an Oracle dump file, then the following preparation is recommended: 1. UPDATE structures SET cdx = CsCartridge.ConvertCDX.CDXToMST(cdx, ''); COMMIT; 2. create a dump file of the structures table. Be sure, that it does not have a cartridge index. 3. In the installer program import the dump file using the imp program, and then create the domain index on the cdx column. The cartridge will use the data created in step 1 instead of processing the cdx document again. This cuts the time used to create an index by about 20 percent.
act accordingly. For a full list of the tables and fields maintained by the cartridge See Data Structures on page 240. The AUX package of the cartridge can be used to avoid compatibility problems with later versions. The AUX package contains trivial functions, which return the names of the tables and fields to be used to access the tables in the cartridge schema. With this extra care, future incompatibility can be avoided. The functions in that package will be explained later in the chapter. Generally, using these functions is more complicated than using operators returning the same value. The only reason stored data should be used directly, when the data is used to join two tables together. In this case execution of the SELECT statement may be much faster. The best way to use data stored by the cartridge is to create synonyms for the tables stored in the CsCartridge schema.
CREATE SYNONYM MyWeight FOR CsCartridge.sch_ix_W; for accessing molecular weight CREATE SYNONYM MyCode FOR CsCartridge.sch_ix_A; for accessing formula and canonical code
This way, the fields of MyMol and MyCode tables can be used simply as if they were defined in the user's schema. Both of these tables have a field called RID. It contains the ROWID of the original table. The original table and the table maintained by the cartridge can be joined by an inner join by an original_table.ROWID = MyCode.rid condition in the WHERE clause. When the tables are joined, the data fields maintained can be used. Among them are:
MyMol.MolWeight which stores the molecular
structure
MyCode.CText contains the canonical code of
the structure
These fields are indexed, so using them in the WHERE clause of a SELECT statement may yield enormous speed improvement compared to nonindexed fields. Example:
CREATE TABLE mx(id, NUMBER, m CLOB); CREATE INDEX mxix ON mx(m) INDEXTYPE IS CsCartridge.MoleculeIndexType; CREATE SYNONYM MxWeight FOR CsCartridge.schemaname_mxix_W; -- replace schemaname with the name of your schema CREATE SYNONYM MxCode FOR CsCartridge.schemaname_mxix_A; -- replace schemaname with the name of your schema SELECT mx.id, MxWeight.MolWeight FROM mx, MxWeight WHERE mx.rowid = MxWeight.rid; - to list the identifiers and molweights for the table SELECT mx.id, MxCode.CText FROM mx, MxCode WHERE mx.rowid = MxCode.rid; -- to list the identifiers and canonical codes for the table SELECT mx.id, MxCode.Formula FROM mx, MxCode WHERE mx.rowid = MxCode.rod; -- to list the identifiers and formula for the table
CNFldName XXTabName(SchemaName VARCHAR2, IndexName VARCHAR2) returns the name of the table the data is stored in XXRidName returns the name of the field which stores the rowid of the original record XXFldName returns the name of the field which stores the data desired
Administrator
The MW functions must be used for MolWeight, the FM functions for formula, and the CN functions for canonical code. The following VB example code follows to illustrate how to retrieve the rowids of two different tables joined by their canonical codes. This SELECT statement will retrieve only those records that are chemically identical in both tables. Here the table names do not appear, the index names are used instead, to specify the tables.
Dim CNTab1, CNTab2, CNRidName, CNFldName As String Set c = New ADODB.Connection Dim r As ADODB.Recordset c.Open ConnectionString:="Provider=OraOLEDB.Ora cle.1;Persist Security Info=False;Data Source=" + "myserver", UserId:="myschema", Password:="mypassword" sql = "SELECT CsCartridge.Aux.CNTabName('myschema', 'my1index') FROM DUAL" Set r = c.Execute(sql) If Not r.EOF Then CNTab1 = r.Fields(0) sql = "SELECT CsCartridge.Aux.CNTabName('myschema', 'my2index') FROM DUAL" Set r = c.Execute(sql) If Not r.EOF Then CNTab2 = r.Fields(0) sql = "SELECT CsCartridge.Aux.CNRidName FROM DUAL" Set r = c.Execute(sql) If Not r.EOF Then CNRidName = r.Fields(0) sql = "SELECT CsCartridge.Aux.CNFldName FROM DUAL" Set r = c.Execute(sql) If Not r.EOF Then CNFldName = r.Fields(0)
If two tables are to be joined by chemical identity, then there is no better way to join them than the CText field maintained by the cartridge. The CText field is an index field, join by that this field saves one table scan. The functions of the AUX package:
MWTabName(SchemaName VARCHAR2, IndexName VARCHAR2) MWRidName MWFldName FMTabName(SchemaName VARCHAR2, IndexName VARCHAR2) FMRidName FMFldName CNTabName(SchemaName VARCHAR2, IndexName VARCHAR2) CNRidName
sql = "SELECT " + CNTab1 + "." + CNRidName + ", " + CNTab2 + "." + CNRidName + " FROM " + _ CNTab1 + ", " + CNTab2 + " WHERE " + CNTab1 + "." + CNFldName + " = " + CNTab2 + "." + CNFldName Set r = c.Execute(sql)
then:
SELECT eln_structures.key from eln_structures, CsCartridge.CS_NOTEBOOK_SX_E where eln_structures.rowid = CsCartridge.CS_NOTEBOOK_SX_E .rid
Error Handling
The cartridge can not communicate with the user. It can communicate erroneous situations only through either raising an exception or storing information related to the erroneous situation in a table. If the cartridge raises an exception, then the client program is terminated. The default action of the cartridge is to continue the program and store information about the failed chemical data in the database. This behavior can be changed by executing the following SQL statement:
UPDATE CsCartridge.<user-schemaname>_<user-index-name>_O SET Raise_on_error = 'YES'
will retrieve the identifying fields of those records, which are not indexed because of an error.
Performance
The MoleculeContains operator is implemented both as an index scan, and as a function. The query optimizer decides which implementation to use. If the WHERE condition contains more selective elements then the MoleculeContains operator, like a reference to a unique key, then Oracle will retrieve the only matching record, and then apply the function implementation, which will perform an atom-by-atom matching. When the index scan is executed, the cartridge creates a complicated query accessing different tables. The performance of that query can be dramatically improved by occasionally executing an ANALYZE INDEX statement on the INDEX created by the cartridge:
ANALYZE INDEX mx COMPUTE STATISTICS;
If the Cartridge does not raise an exception, then the CsCartridge.<user-schemaname>_<user_index_name>_E table will contain the rowid-s of those records containing invalid chemical data in their indexed fields. The rid field of this table contains the rowid of the indexed record, and the text field may contain additional information. A SQL statement, which joins this table with the indexed table lists the erroneous records. For example, if the following is true:
cs_notebook is the user's schema eln_structures is the indexed table name sx is the name of the index used by the
Executing this statement will calculate statistics on the tables created and maintained by the cartridge, and these statistics are used by the Oracle query optimizer. This command should be executed periodically depending on the frequency of the update of the table. Remark: In Oracle9 and higher the DBMS_STATS.GATHER_INDEX_STATS procedure is recommended instead of the ANALYZE command. It's syntax is
CALL DBMS_STATS.GATHER_INDEX_STATS('owner_nam e', 'index_name');
In order to ensure, that the optimizer is using the right algorithm to access the table the
Troubleshooting
If there is a serious problem with the cartridge, it is sometimes appropriate to rerun the CsCartridge.sql script, which will re-install the cartridge software. After running the script every indexed table the cartridge indexed should be dropped, and recreated again. In addition, update every record in the table by executing the following SQL statement:
UPDATE tab SET fld=fld; COMMIT;
OR select CsCartridge.VERSION FROM dual; The version number stored in the CsCartridge.Globals table refers to the version of the install script, which installed objects into the CsCartridge schema. The version number returned by the VERSION function is the version of the CsCartridge.(dll/so/sl) shared library. The two can be different. The shared library should always be as old or newer than the install script. The version number returned by this function is stored in the initialized data segment of the shared library. It can be displayed on a UNIX system by the string CsCartridge.so | grep CsCartridge command.
Administrator
This is necessary for only those tables where the index was created without the PARAMETERS('CsCartridge') clause. If the problem persists, then the problem should be reported to CambridgeSoft.
All of the fields are defined as VARCHAR2(30) columns. Every index created by the cartridge has an entry in this table. The content of this table can be retrieved by the public. By retrieving the content, the client program knows if a column is supposed to contain chemical structures. For Example: SELECT * FROM cscartridge.all_csc_indexes WHERE owner = 'me' and table_name = 'my_table' and column_name = 'my_column'
CambridgeSoft Troubleshooting
will attempt to continue processing the input data. If this process fails repeatedly, it is recommended to call support at CambridgeSoft. It may also be worth trying the following alternative:
DROP INDEX ixname FORCE; -- to remove the index even if it is in LOADING/FAILED/UNUSABLE state CREATE INDEX ixname ON tab(fld) INDEXTYPE IS CsCartridge.MoleculeIndexType PARAMETERS('SKIP_POPULATING=YES'); UPDATE tab SET fld=fld; COMMIT;
If the UPDATE fails, then the CsCartridge.schema_name_ixname_O.current_rowid points to the record which failed. The failed record should be deleted or corrected. After accomplishing this, the UPDATE and COMMIT commands must be executed again.
and/or the
ALTER INDEX index_name PARAMETERS('MONITORING=YES');
command(s). If tracing is on, then the cartridge keeps a log of all the executed SQL statements in a trace file. The name of the trace file is trace.txt, and it is located in a directory which name is a concatenation of the schema name and the index name connected with
an underscore. This directory in turn is in the system temporary directory. The system temporary directory is usually C:\WINNT\TEMP on windows systems, and the /tmp directory on UNIX systems. The contents of this file can greatly simplify the bug fixing process. If monitoring is on, then the cartridge maintains a call stack. More precisely a part of the real call stack with selected items from the parameter lists a function or method is called with. This file is stored in a directory called 'CsCartridge_PIDS', and this directory is in the system temporary directory. The file name is a number, which reflects the actual PID of the process, and the extension of the file is .txt. That monitor file is not really updated, when control is passed to a function, but when an SQL statement is executed. But nonetheless it might help to resolve the problem with or without CambridgeSoft's support personnel. Both the trace file and the monitor file are readable ASCII text files. The contents of the monitor file can be displayed by the SELECT CsCartridge.MONITOR from DUAL; statement. The most detailed output of a DML process can be acquired by setting the global LOGGING on by the UPDATE CsCartridge.Globals SET value = 'YES' WHERE id = 'LOGGING'; This setting affects every domain index maintained by the CambridgeSoft Oracle Cartridge. If set, then the CsCartridgeTrace.txt file in the C:\WINNT\TEMP directory will contain a very detailed log of functions called by the cartridge. This ascii text file also may be valuable when an error is to be tracked. If the execution of a SQL statement fails, or other serious problem arises the cartridge records information into the trace file even if TRACING was set to NO.
Setup Problems
ORA-28575 unable to open RPC connection to external procedure agent
When using the cartridge for the first time some users may experience the above error message. This message is the consequence of some mistake in the ORACLE server's setup. It is issued by the Oracle server, when it tries to load the extproc program, an agent which in turn loads the CsCartridge.dll (Windows) or the CsCartridge.so (Unix) program into memory. Oracle uses the extproc program (called external procedure agent) to load external binaries into memory because, the binary executables written by independent developers are not trustworthy enough to be loaded into Oracle's main address space. The executables can crash, thus shutting down the whole service. Loading into the address space of the extproc agent, is optimal because even if it crashes, it just crashes the client program which triggered its use, leaving the server intact. To find the extproc program in the Oracle installation, Oracle uses two configuration files:
listener.ora tnsnames.ora
Administrator
If those files are missing, or are not set up correctly, or if the extproc program is missing, then Oracle can not load the extproc program, and issues the ORA-28575 error message. The listener.ora and the tnsnames.ora files are located in the $ORACLE_HOME/network/admin directory. The listener.ora file is used, whenever the listener service is restarted. On Windows computers it is started usually when the computer starts up, and can be stopped/started using the "services" list from the Control Panel. On Unix computers they are controlled by the $ORACLE_HOME/bin/lsnrctl command.
CambridgeSoft Troubleshooting
listener.ora
The listener.ora file must have the following lines LISTENER = (DESCRIPTION_LIST = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC)) ) ) ) SID_LIST_LISTENER =(SID_LIST = (SID_DESC = (SID_NAME = PLSExtProc) (ORACLE_HOME = C:\oracle\ora81) (PROGRAM = extproc) ) ) where the value of the KEY symbol may be different than EXTPROC, but must be the same as the value of the KEY symbol in the tnsnames.ora file. The same is true for the value of the SID_NAME symbol, but that it is always PLSExtProc. If this text file is changed, then the listener service must be restarted. Oracle 8 and 9 do not seem to use the ORACLE_HOME entry. Instead, Oracle uses the ORACLE_HOME entry in the Windows registry, and the ORACLE_HOME environment variable on UNIX systems. So, when the listener is started, then the ORACLE_HOME must point to the directory, where the Oracle server is installed. That usually reads, like /mount-directory/app/oracle/product/version If in doubt: Execute the statements in the same environment, where the listener is started:
ORACLE_HOME = /mountdirectory/app/oracle/product/versi on export ORACLE_HOME Start the listener with the command $ORACLE_HOME/bin/lsnrctl Check status, and stop/start it according to its status.
tsnames.ora
The tnsnames.ora file must have lines as follows: EXTPROC_CONNECTION_DATA.CAMS OFT.CO M = (DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC)) ) (CONNECT_DATA = (SID = PLSExtProc) (PRESENTATION = RO) ) ) The value of KEY must be the same as the value of KEY in the listener.ora file, and the value of SID must be the same as the value of SID_NAME in the listener.ora file.
Dependencies
The CsCartridge library depends on every platform on the existence of OCI library. (extension may be .dll, .so, .sl) In addition to the OCI library. (extension may be .dll, .so, .sl), please see See Oracle Cartridge Dependencies by Operating System on page 325. for a list of required files on the specified Operating Systems. In addition to the file requirements, the environment must be set up so that the system can find them. These issues are explained in detail in the system manuals of the actual platform. The AIX version of the cartridge is dependent on libraries from IBM's Visual Age C++ development system. The libC.a library is part of the Visual Age C++ development system. libclntsh.a must be
converted into a simple shared library as explained in the pre-installation activities for AIX. The remaining libraries are regular system libraries.
Using ADO
Microsoft's ADO is a convenient way to write client programs utilizing the cartridge. To create an Oracle service on any client computer, the Oracle client tools must be installed, and the Net8 assistant program must be used to create a service by entering the following information:
Net Service Name: any valid string would do
Administrator
(this string must be used in ADO) Protocol: TCP/IP Host Name: a computer running the Oracle server Port Number: 1521 (Oracle 8i) Service Name: the service name on the server.
DIM c as ADODB.Connection set c = new ADODB.Connection ServiceName = "" Rem the name of Oracle service UserName = "" Rem user name Password = "" Rem password s = "Provider=OraOLEDB.Oracle.1;Persist Security_ Info=False;Data Source=" + ServiceName + ";" s = s + "User ID=" + UserName + ";" s = s + "Password=" + Password c.Open s Dim r as ADODB.Recordset Set r = c.Execute("SELECT * FROM moltable WHERE_ CsCartridge.MoleculeContains(mol, 'c1ccccc1','', '')=1"); Rem process the recordset c.Close
NOTE: When using Microsoft ADO data controls to access the cartridge, the CursorLocation property must be set to adUseServer. Otherwise data updates will fail, if the structure field is larger, then 4000 bytes.
CambridgeSoft Dependencies
Custom Screening
Custom screening is a tool for a database administrator to affect the processing of a SELECT statement. The database administrator can define
any structure to screen the database when processing a substructure search. If a screen structure is a substructure of a query structure, then the processing of that particular query will be faster. There is no recommendation on how to choose
custom screens. Choosing them should be based on the particulars of the database and expected interest of the users. Custom screening can be defined by calling the MolScreen procedure.
CALL CsCartridge.MolScreen('schema_name ', 'table_name', 'field_name', 'index_name', 'smiles_or_encoded_cdx', 'second_part');
Administrator
where
schema_name is the schema the table is owned
by table_name is the name of the table to be custom indexed field_name is the name of the field containing chemical information field_name is the name of the index used to index the chemical information smiles_or_encoded_cdx is the substructure depicted by a smiles string or an encoded CDX document. second_part is the second 4000 bytes of an encoded CDX document. All of the names must be enclosed by single quotes. The strings are not processed by Oracle, but rather the MolScreen procedure. Optionally an ALTER INDEX ... PARAMETERS('SYNCHRONIZE') statement also may be executed. For example: CALL CsCartridge.MolScreen('MySchema', 'molecule', 'mol', 'mx', 'Oc1ccccc1', ''); COMMIT; ALTER INDEX mx PARAMETERS('SYNCHRONIZE'); This will improve the speed of the substructuresearch of phenol derivatives.
This strategy was the simplest and best possible strategy when version 2 of the cartridge was used. When using version 9 a better user experience can be achieved with somewhat more sophisticated programming. It should be noted, that in version 2 the execution of the adoConnection.Execute statement was slow because the result set was generated during the execution of that statement, and the MoveNext statements were almost instantaneous. In version 9, the execution of the adoConnection.Execute statement is fast, and most of the calculations are postponed until the MoveNext statements are executed. With the programming schema above the user can not communicate with the program until the whole recordset is deposited into the presentation layer. A much better user experience can be created if the client program just executes as many MoveNext statements as many records are presented in one page and data to be presented on the next page is retrieved only when the user hits the Page Down
button, or clicks on the scroll bar pr any appropriate user control. The result is presented much faster than with the simple scheme above. An even better user experience can be achieved if the data retrieval and the presentation is executed in a different thread. Then while the user can manipulate the part
of the recordset already transmitted to the client computer, and the data processing still goes on in a background thread. The program should look like this
dim rs as recordset set rs = adoConnection.Execute "SELECT ..." if not rs.eof Rem display the data in the recordset and store it into a buffer end if docontinue = true while docontinue rem wait for user action requesting next or previous record or finishing process if pagedown then rem if record is already in the buffer, then display, otherwise rs.MoveNext first end if if pageup then rem show previous record already in the buffer end if if home then rem show the first record end if if end then rem display a message, that this will be slow while not rs.eof do rem store data into buffer rs.MoveNext wend rem show the last record end if if cancel then docontinue = false end if wend
Bulk Loading
Previous versions of the Oracle cartridge allowed suspending and resuming the building of the index tables by the cartridge to speed up large inserting large amount of data into an indexed table. From version 9, the cartridge will be always in "suspended" mode. This means, that new data stored into an indexed field will not be immediately
fully processed, but will be stored, made available for searching, and marked for later processing. This processing will take place, when the
ALTER INDEX index_name PARAMETERS('SYNCHRONIZE')
statement is executed. Substructure search will be reasonably fast as long as the number of partially processed records does not exceed about 50000. After that synchronizing is recommended.
Executing the statement above is time consuming, but inserting, or updating records in a table will be much faster then in earlier versions of the cartridge. Version 9 also recognizes the
PARAMETERS('SUSPEND') and PARAMETERS('RESUME') clause in an ALTER INDEX
Schema Overview
All the information the cartridge maintains is stored in the CsCartridge schema. For every index created by the cartridge, 8 tables are created in that schema. The names of these tables are generated from the name of the schema the indexed table resides in, and from the name of the index. Table names are maximized at 20 characters, so the cartridge must require, that the name of the schema and the index together can not be longer, than 16 characters.
Administrator
statement. The interpretation, though, is different. The setting affects only the current session. When in suspended mode, no insert is executed, but held up in a buffer memory. When the
PARAMETERS('RESUME')
call is made, then all the upheld data is stored into the cartridge table in one single round-trip to the server, thus improving speed. Using this feature can be reasonable in applications, where data maintenance is not interactive and is performed in waves of batches.
Data Structures
Whenever a new record is stored in a table, is deleted from a table, or an indexed field is modified, by the Oracle Cartridge, Oracle makes a call to the cartridge passing the rowid of the affected record and the value of the indexed field. The cartridge processes this data, and stores the results in tables in the CsCartridge schema to improve search speed. The major steps of this process are:
attempt to interpret the passed binary or
for substructure search sch_ix_XY - where X refers to the screen type, and Y to the kind of data, stores screening dayta sch_ix_E - stores error messages for a longer process sch_ix_O - stores options set by the end user sch_ix_T3 - stores temporary 3d screening data until synchronization
character stream as a ChemDraw document extract the chemically meaningful part of the ChemDraw document into a ccMolecule and molstorage structure creating screens used in substructure search for the ccMolecule serializing the molstorage structure for storage storing the generated information
original table. This is returned to ORACLE as a result of a search MOLSTGLENGTH the size of the stored molstorage information. MOLSTG1 The first 2000 bytes of the serialized molstorage if it is shorter than 4001 bytes, otherwise empty MOLSTG2 The second 2000 bytes of the serialized molstorage if it is shorter than 4001 bytes, otherwise empty
from the CDX document if it is longer than 4000 bytes, otherwise empty CTEXT The canonical code of the structure in the CDX document FORMULA The chemical formula of the structure MOLWEIGHT The molecular weight of the structure NC number of carbon atoms in the structure NN number of nitrogene atoms in the structure NO number of oxygene atoms in the structure NHAL number of halogenes in the structure NOTH number of other elements in the structure ISNEW either 'Y' for records not synchronized yet, or NULL for synchronized records. SCREENS_NORMAL a binary representation of the regular screens used for substructure search SCREENS_SIMILAR screening bitvector better suited for similarity searches SCREENS_FULLEXACT screening bitvector used when full structure search is executed considering tautomers as well SCREENS_SKELETAL screening bitvector used when substructure search is executed considering tautomers. MOLSTG_REACTANTS The serialized molstorage of reactants if the CDX document is a reaction SCREENS_REACTANTS screens of reactants if the CDX document is a reaction MOLSTG_PRODUCTS The serialized molstorage of products if the CDX document is a reaction SCREENS_PRODUCTS screens of products if the CDX document is a reaction
The RID field stores the rowid of the record indexed by the cartridge. The value for RID is passed to the cartridge by ORACLE. The MOLSTG field contains all the chemically valuable information from the CDX document stored in a row referred to by the RID field. This field is used when the cartridge has to do atom by atom matching during substructure search. It's a highly compressed format for better retrieval speed. The CTEXT field is the canonical code of the chemical structure, and used for identity search. Identity search is much faster than full structure search. The FORMULA, NC, NN, NO, NHAL and NOTH fields are used for formula search. the MOLWEIGHT field is used for molecular weight searches. Any one of the SCREENS_NORMAL, SCREENS_SIMILAR, SCREENS_FULLEXACT and SREENS_SKELETAL columns may be missing if during index creation the particular feature was not requested. When a program executes a SQL statement referring to the MoleculeContains operator, the cartridge generates its own screening statement retrieving the molstg information from the sch_ix table. The subset of records are selected by using the screenbits of the query and one of the screens from the sch_ix table. The sch_ix_NR or other inverted screen table also may be used if exist to increase speed of the retrieval of screening data. The generated SQL statements can be found in the CsCartridgeHistory.txt file located in the system temporary directory.
This table is partitioned by the bit column. It has 256 partitions related to each of the screen bits generated by the screening algorithms.
sch_ix_O table, the cartridge might not throw an exception, but instead continues operation and stores the reason of the error into the TEXT field.
Administrator
This table has 64K rows for each possible combination of BIT1 and BIT2 values.
symbols RIDSVAL nested table containing the rowids and distance or angle information of the indexed records. This table contains information used for fast 3d screening. The ATOMPAIR field contains two element symbols in a string for distances, and three element symbols for angles. The RIDSVAL nested table contains all the rowids and values for the particular ATOMPAIRs. For a two element ATOMPAIR the values are the distances in Angstroms, and for three element ATOMPAIRs, the angle value in radians is stored in the value field.
predefined keywords VALUE this field contains the corresponding value. In most cases the accepted values are YES and NO. The list of accepted keywords follows:
RAISE_ERROR to control if the cartridge
This table is supposed to be empty. If an error is detected by the cartridge it usually throws an exception. Depending on the content of the
should raise an error when encountering an illegal input, or store the information in the _E table CACHE_RESULTS controls whether the cartridge saves results of substructure searches. If the same query is repeated, then the cartridge can return the existing hit list much faster. This cache is emptied fully if the table changes, so it is mostly recommended for readonly databases.
whether reactions should be evaluated when screens are generated. NORMAL to direct the cartridge whether maintain normal screens SIMILAR to direct the cartridge whether to maintain screens for similarity search. FULLEXACT to direct the cartridge whether to maintain screens for full structure search considering tautomers. SKELETAL to direct the cartridge to maintain screens for substructure search considering tautomers. THREE_D to direct the cartridge to maintain screens for 3d screening. For the NORMAL, SIMILAR, FULLEXACT, SKELETAL keywords the acceptable values are NO, YES and INDEX. In the case of NO no screens of that particular kind are stored at all. In the case of yes a bitmap field is stored for the screen, and in the case of INDEX an inverted table is maintained for that kind of screen. SYNCHRONIZATION controls if the index is synchronized all the time or if it needs occasional manual synchronization. THREE_D_RESOLUTION can be NO or YES, and LOW or HIGH. If it is low, then less data is stored. REACTION_SCREENING controls if the cartridge keeps screening information for the starting reactants and the final products of a reaction separately from the main screen. It can be useful in a reaction database, when queries are regularly restricted to reactants and/or products. There is one record in the sch_ix_O table for every keyword. It is not recommended to edit this table any way manually. The contents of the table should be changed using the ALTER INDEX command.
Administrative Tables
ALL_CSC_INDEXES Table
The ALL_CSC_INDEXES table lists all the indexes created by the cartridge.
OWNER name of the owner's schema INDEX_NAME name of the index TABLE_NAME name of the table COLUMN_NAME name of the indexed
CUSTOM_SCREENS Table
The CUSTOM_SCREENS table contains the list of custom screens applied to every new created index. After installation, this table contains the SMILES string for benzene and cyclohexane. The administrator can add new items to this list, or remove the ones there.
SMILES the smiles string of the custom
screen.
GLOBALS Table
The GLOBALS table contains information globally representative to the cartridge.
ID identifier of an entry VALUE value of an entry Currently the following identifiers are stored in
the GLOBALS table: ID VALUE VERSION current version number LIBRARY_DIRECTORY the directory the CsCartridge shared library is stored USE_THREADS YES or NO (default YES) The cartridge generates threads in an attempt to improve the speed of substructure search. On some platforms that resulted in worse
performance. The administrator can control the behavior of the cartridge by the USE_THREADS parameter. STORE_INPUT_DATA YES or NO (default NO) If the STORE_INPUT_DATA parameter is set to yes, then the cartridge stores the data being processed into a file. The file's name is CsCartridgeData, and it is stored normally in the C:\WINNT\TEMP directory on Windows systems, and into the /tmp directory on UNIX systems. TRACING YES or NO or string (default NO) If the TRACING parameter is set to YES, then the cartridge keeps a log in the CsCartridgeTrace.txt file, which is located in the C:\WINNT\TEMP directory on Windows systems, and into the /tmp directory on UNIX systems. These files can be used for troubleshooting. The value of this parameter must be changed directly by an UPDATE CsCartridge.Globals SET value = 'YES' WHERE id = 'TRACING'; statement. The value of the string depends on the version and build number of the cartridge. The string is a concatenation of different trace selector. The tracing settings select certain features for tracing. The most commonly used is likely the 'Statement::Execute' trace selector selecting trace for every SQL statement executed. Other selectors: Statement::LobWrite DMLClass::ProcessInsert::data DMLClass::ProcessDelete CStack::push If TRACING=YES is set, the program execution slows down dramatically. MONITORING YES or NO (default YES)
monitoring is set, then program execution can be monitored by the MonitorCartridge.exe program, which is a stand-alone program running on Windows platforms, which shows the "call stack" of execution. QUIT_INDEX_CREATE number (default 10) The number of attempts the cartridge makes when creating an index and a crash is detected. Normally a cartridge creation ends in an error message and no data structures stored if there were more than number crashes. A "crash" may happen if a document can not interpreted any way at all. The cartridge catches and registers those exceptions, and continues building the cartridge tables. Those exceptional documents are rare, that's why the small default number. This default number is also a protection against an error if an index is to be built on a column, which does not contain any meaningful chemical structures. SYNCHRONIZE_BUFFER number (default 1000) this number instructs the cartridge about the number of rows processed in one step during synchronization. This number has profound effect on the speed of synchronization. Though it can not be increased without concerns to Oracle's inherent limitations, which may vary from installation to installation. With 1000 records processed in one step, the cartridge uses about 45MB of memory. With 200 records it uses only 11MB.
Administrator
CS ChemFinder Custom Elements.txt CS Isotopes Table.txt StructureToName.dat These files are located in the $ORACLE_HOME/bin/instance_name directory on Windows computers and in the $ORACLE_HOME/lib/instance_name for UNIX computers, where instance_name is "CsCartridge", or the name entered at the instance name field on the installer dialog.
Program files
The cartridge consists of the following files: CsCartridge.dll (Windows), CsCartridge.sl (HPUX), CsCartridge.so (all other UNIX systems)
Administrator
246CS Oracle Cartridge CambridgeSoft Data Structures
Scientific Databases
CambridgeSoft offers a library of chemical information databases, containing compounds and chemical reactions. Users may search over the databases with tools provided in the ChemOffice software suite. The Scientific Databases bring a wealth of chemical information to your desktop. Searching through these databases by chemical names, structures, physical data, suppliers, safety data, and literature references becomes as easy as clicking a mouse. All of the databases are available to the user on CD, for individual use. Section VI: Sourcing and Safety Data Chapter 16: ChemACX Chapter 17: ChemMSDX Chapter 18: Sigma-Aldrich MSDS Chapter 19: EH&S Enterprise Section VII: Reaction and Synthesis Data Chapter 20: ChemRXN Chapter 21: ChemSynth Chapter 22: ChemReact
Available Formats
Subscriptions and ChemOffice Enterprise Based Databases
The following databases are available as a ChemOffice Enterprise application and/or webbased subscription as well as on CD: The Merck Index Ashgate Drugs Traditional Chinese Medicines ChemACX ChemINDEX NCI AIDS MediChem ChemReact ChemSynth The databases available through a subscription or the ChemOffice Enterprise applications use the same technology as other WebServer applications.
ChemFinder.Com Gateway
The ChemFinder.Com Gateway allows users to search all of CambridgeSoft's Scientific Databases in one easy step. Searchable fields include Structure, Sub-structure, Chemical Name and CAS Number. The search results will contain the number of search results, which databases the results are found in, and present hyperlinks to the appropriate database record for review.
Database Offerings
Section V: Reference Data Chapter 9: The Merck Index Chapter 10: MediChem Chapter 11: Traditional Chinese Medicines Chapter 12: Ashgate Drugs Chapter 13: ChemINDEX Chapter 14: NCI Chapter 15: AIDS
For more information about general ChemOffice Enterprise application concepts, please see ChemOffice Enterprise on page 191.
CD Based Databases
The following chemical databases, available on CD, are described in this section:
The Merck Index Ashgate Drugs Traditional Chinese Medicines ChemACX ChemSCX ChemMSDX ChemINDEX ChemRXN NCI AIDS ChemReact68 ChemSynth The chemical Databases work with ChemOffice, an integrated suite of software tools for chemists with personal computers. The ChemOffice applications, ChemFinder, ChemDraw, and Chem3D, help ChemInfo deliver information. ChemOffice includes the following: ChemFinderThe primary application used by ChemInfo. It provides the engine for searching the data the forms and tables for viewing it. Relational databases are supported by ChemFinder. ChemDrawThe chemical drawing standard allows structures to be drawn and edited in ChemFinder. It can represent individual structures or chemical reactions, complete with atom-to-atom mapping and absolute or relative stereochemistry, for detailed structure-based queries.
Chem3DA molecular modeling and computations application offers molecular mechanical and quantum mechanical computational capability. Featuring an intuitive graphical user interface, it displays molecules as three-dimensional models that you can rotate and translate to reveal details of a structure not evident in two dimensions.
Administrator
Installation
The databases do not have to be installed; they can be accessed directly from the CDs. If the databases are accessed from a CD, they are Read-only. If you have sufficient hard disk space, you can copy the databases from the CDs. This not only makes searching faster but allows you to edit the databases, except ChemACX, ChemSCX, The Merck Index, Ashgate Drugs, and Traditional Chinese Medicines.
your CD drive.
2. Start ChemFinder. 3. From the File menu, select Open and select a
form for one of the databases. Alternatively, you can explore the CD-ROM with the Windows Explorer and open ChemFinder by double-clicking one of the ChemFinder form icons.
248Scientific Databases
Help Additional sources of help for using ChemInfo include the following: Quick Reference Card ChemFinder and ChemDraw online help ToolTips Status Bar CambridgeSoft Technical Support Online Help Access to online help is provided from the ChemFinder and ChemDraw help menus. To learn about using the online Help: From the Help menu, choose How to Use Help.
To access online Help: From the Help menu, choose Contents. ToolTips ChemFinder and ChemDraw provide ToolTips as an additional form of online Help. Rest your pointer on a tool to display a message box with a brief description of the tool.
Status Bar The bottom left corner of the ChemFinder and ChemDraw Status Bars display a slightly more detailed description of the tool icons.
Administrator
250Scientific Databases CambridgeSoft Available Formats
251
Administrator
252 CambridgeSoft
How Is It Useful?
For more than 100 years, the printed edition of The Merck Index has been the premier reference for validated data about many compounds of general interest. The subjects covered include human and veterinary drugs, biologicals and natural products, agricultural chemicals, industrial and laboratory chemicals, and environmentally significant compounds. The electronic version includes all of the information in the printed edition, and enhances it by allowing direct and rapid searching over all data fields. Where the printed edition offers indexes of names and CAS Registry Numbers, the electronic version allows the user to enter them as search terms, and takes you directly to the relevant monographs without having to flip through a bulky printed volume. Physical properties as well as many
Number of Monographs
Included in 13th Edition: 10,250 Added since 13th Edition: 230
Compound Searching
The Compound Searching section allows searching for compounds by physical properties, compound attributes, and structure. The Merck Indexs compound searching form acts much like the other search forms found in ChemOffice Enterprise applications. For more information about searching, please see Searching ChemOffice Enterprise Applications on page 194. To access the Compound Searching section: Click on the Compound Search Tab found at the top of the page. The Compound Search Form appears
Administrator
To search for compounds: The Introduction and System Requirements tabs deliver important information about The Merck Index, compatibilities, and how to navigate the site. Each of the other tabs allow the user to access three major sections of The Merck Index: Compounds, Organic Name Reactions, and Additional Tables.
1. Enter the desired information into the fields
provided in the Compound Searching Form. To search without using the structure search, click on the Click Here for Non-Plugin Searching link.
2. Click
Search.
are meant to be informative, but not comprehensive. The descriptions are composed of the following:
name(s) associated with the reaction the original and/or primary contributor(s)
To view the contents of a particular record in the list, click Show Details. The complete contents of the chosen record is displayed.
commonalities. Useful abbreviations can be found on the mainpage of this section. To access the Organic Name Reactions section: Click on the Organic Name Reactions Tab found at the top of the page. The Organic Name Reactions homepage appears.
The left frame of the homepage contains 2 tabs: Browse and Search. The Browse Tab lists all reaction names included in the Merck Index. To view the contents of a record, scroll to the appropriate reaction and click on the link.
Click on the Additional Tables Tab found at the top of the page. The Additional Tables homepage appears.
Administrator
The Search Tab allows the user to enter a free text search for the appropriate reaction. To search for a reaction:
3. Enter keywords into the text box available. 4. Click
The Reaction details appear in the right frame. For tips about entering a free text search, click on the Tips for Searching link found below the free text search textbox under the Search Tab.
To view a particular table, click on the link provided. All tables are available in PDF format and therefore require the Adobe Acrobat Reader to view. If you do not have the Adobe Acrobat Reader installed, click on the link provided to obtain a free copy.
Logging Off
You can end your session with The Merck Index at anytime by logging off. To log off:
Click
Log Off.
Additional Tables
The Additional Tables section lists multiple tables available to view by the user in PDF format. To access the Additional Tables section:
About Medichem
Availability: Internet Subscription Number of compounds: >650,000
Types of assays included in MediChem are ADME (A), binding to a target (B), binding to a mutant target (B/M), functional assays using either a cell based or in vivo animal model (F), toxicity (T), and others (O). Data records are also identified by target platforms, such as Kinase, G-Protein-coupled Receptor (GPCR), Protease, Ion Channel, Nuclear
Hormone Receptor (NHR), and more. These database fields are easily populated via drop down selections for easy querying. Other database fields include compound name, molecular formula (range search enabled), molecular weight (range search enabled), protein name, company name, journal reference fields (title, author, article title, journal, year, volume, etc.), PubMed ID, activity type and more. On the result pages, PubMed IDs are hyperlinked to the online PubMed record.
Administrator
258MediChem
About TCM
Availability:
CD-ROM Internet Subscription Intranet with ChemOffice Enterprise SD-File
which means that there 175 natural sources that contain a chemical compound with the substructure that was searched.
Administrator
The view of the search results are selected by the user by choosing the radio button next to the in the view results section of the screen. Selecting the Natural Sources radio button will display the results in Natural Sources Space. Search results from either view may be expanded. For example, selecting Show Details for the sixth record from the "Chemistry Space" result list will display the monograph for that record.
260Traditional Chinese Medicines CambridgeSoft Using TCM with ChemOffice Enterprise
The monograph contains chemical information about the compound, including when available, CAS numbers, synonyms, and physical properties. Also in the monograph is a list of all the natural sources containing the compound (in this case there is only one), along with the uses, effects and indications, English, Latin and Chinese names, and bio-activity when available. The bottom part of the monograph contains the references. All of the "Chemistry Space" monographs are cross referenced with the "Natural Sources Space" monographs. Clicking on the View Details hyperlink found after the natural sources section of the monograph will bring up the "Natural Sources Space" monograph for that particular source. This view repeats the information found about found in the "Chemistry Space" monograph, and then includes a list of all active chemical compounds that have been isolated from the source.
Each of the chemical compounds are cross referenced back to the "Chemistry Space" monographs, and can be accessed by clicking on the associated View Details hyperlink.
Administrator
262Traditional Chinese Medicines CambridgeSoft Using TCM with ChemOffice Enterprise
number The European Inventory of Existing commercial Chemical Substances (EINECS) number Each field is fully searchable. Thus an entry may be located on the basis of structure or substructure, synonyms, biological activity, physical properties or manufacturer. A key component of this reference is the extensive coverage of synonyms. The electronic version adds almost 70,000 synonyms and trade names that did not fit into print version bring the total number to nearly 100,000. This reference will be invaluable to research chemists, biologists, and physicians and to anyone interested in drugs who, starting with a single synonym for a drug, will be able to quickly find a thumbnail sketch of the essential information concerning that agent.
Number
EINECS Number Chemical name Molecular formula Synonyms, including tradenames Medical application Manufacturer Physical Properties
Administrator
Data that can be searched includes chemical structures, synonyms, Chemical Abstracts Service (CAS) Registry Number; the European Inventory of Existing Commercial Chemical Substances (EINECS) Number; The Merck Index (Thirteenth Edition) Number; the physical properties of each compound; and the known biological activity and indicated applications. Search results are displayed in Monograph view and can be browsed using ChemFinders record navigation tools.
264Ashgate Drugs
The Introduction and System Requirements tabs deliver important information about Ashgate Drugs, compatibilities, and how to navigate the site. The Compound Searching and Browse tabs bring the Ashgate Drugs data to the user.
Compound Searching
The Compound Searching section allows searching for compounds by physical properties, compound attributes, and structure. The Ashgate Drugs compound searching form acts much like the other search forms found in ChemOffice Enterprise applications. To access the Compound Searching section:
Click on the Compound Search Tab found at the top of the page. The Compound Search Form appears
provided in the Compound Searching Form. for more information about a particular field. To search without using the structure search, click on the Click Here for Non-Plugin Searching link.
2. Click
Browse
The Browse Tab lists therapeutic categories in alphabetical order. Click on a link to view the record for compounds with the listed therapeutic category.
To view the contents of a particular record in the list, click Show Details.
Chem & Bio Office Enterprise, Workgroup & Databases 2006 Ashgate Drugs265 Using Ashgate Drugs Online or with ChemOffice Enterprise
Administrator
266Ashgate Drugs CambridgeSoft Using Ashgate Drugs Online or with ChemOffice Enterprise
How Is It Useful?
This class of databases serves as an extensive chemical reference for finding general information about commonly used compounds, such as structure, name, molecular weight, CAS Registry Number, synonyms, and physical data (melting point, boiling point, vapor pressure, etc.). ChemINDEX Net contains active hyperlinks to WWW sites with further information about the compounds.
About ChemIndex
Availability:
DVD-ROM as part of ChemINDEX Ultra Internet Subscription Intranet with ChemOffice Enterprise SD-File
Each data field on this form is labeled. Melting points and boiling points are presented as three fields:
If only a single value is available, it is placed in
the first field. If a range is available, the low and high limits of the range are placed in the first two fields.
decomposes. Synonyms and hyperlinks are displayed in the subforms on the right side of the form. You must have an internet connection to use the hyperlink features. If you are connected to the internet, the GO button at the upper right connects to CambridgeSofts WWW server for this database. Click the button or one of the hyperlinks, and ChemInfo attempts to start your systems default web browser and direct it to the appropriate URL.
To view any of the buckyballs or building blocks as a 3-dimensional model using Chem3D:
Right-click the structure and select View Model.
Administrator
BuckyBase
The subfolder BUCKYBSE within ChemINDEX contains two databases. BUCKBALL is a file of 132 buckminsterfullerenes, and BUILDING is a file of 99 building blocks which can be joined together to make new or existing buckminsterfullerenes. Directories: buckybse, balls, building Filenames: Buckball.cfw, Building.cfw Number of compounds: 132 buckyballs; 99 building blocks Key Fields:
Structure Formula Molecular Weight Name
ChemFinder.Com
The webserver at www.chemfinder.com, is one of the most heavily used public-access chemical information site on the Internet. ChemINDEX is the ChemFinder database of small molecule information presented at this site. Many of the individual compound records also contain lists of hyperlinks (URLs) to other sites containing additional information about the compound. To go to a site, click its link. The default web browser on your system will be activated and directed to the target URL.
268ChemINDEX
CambridgeSoft BuckyBase
Chem & Bio Office Enterprise, Workgroup & Databases 2006 ChemINDEX269 Using ChemINDEX With ChemOffice Enterprise or Online
Administrator
270ChemINDEX CambridgeSoft Using ChemINDEX With ChemOffice Enterprise or Online
Using NCI on CD
Availability: Part of ChemIndex
CD-ROM Internet Subscription Intranet on ChemOffice Enterprise
searchable by: Chemical Structure Molecular Formula Molecular Weight NSC Number CAS Number Synonym
for more information) A box appears under the Basic Chemical Information tab if data is available.
Administrator
272NCI
Using AIDS on CD
The AIDS database is available through the NCI search forms. Please see NCI on page 271 for more information. If AIDS information is available for the substance retrieved, a box appears under the Basic Chemical Information tab.
Administrator
274AIDS CambridgeSoft Using AIDS on CD
275
Administrator
276 CambridgeSoft
How Is It Useful?
ChemACX is your guide to commercially available chemicals worldwide. Whether you are planning a bench synthesis, scale-up, or a commercial process, you can search these databases to determine the availability and sources for the chemicals you need. You can search ChemACX by any of the following:
Chemical structure Chemical substructure Compound name Molecular formula CAS Registry Number Molecular weight range Combinations of the above criteria
ChemACX Database
Availability:
DVD-ROM as part of ChemACX Ultra Internet Subscription Intranet with ChemOffice Enterprise SD-File
Number of Catalogs: 405 Number of Unique Chemical Entities: >350, 000 Number of Chemical Products: > 1 Million Key Fields:
Structure Formula ACX Number Product Name Molecular Weight CAS Registry Number Synonym Product ID Catalog Number
For information about searching, see the ChemFinder section in the purple ChemOffice manual.
Opening ChemACX
To open ChemACX: Type http://servername into your web browser.
NOTE: Servername is the name of the ChemOffice
Searches for chemicals in ChemACX can include a combination of any of the following fields:
Substance Name (text search) CAS Registry Number ACX Number Mol. Formula (formula search) MW Range (molecular weight search) Catalog Number
Administrator
Enterprise machine. For more information about your server, please contact your system administrator. The main ChemOffice Enterprise window appears. Click ChemACX. The ChemACX Query Input Form appears.
vendors in ChemACX, select Search all vendors. If you would like to search over a previously generated list of favorite vendors, select Search your favorite vendors.
4. Click Search.
The Search Results page appears. The following illustration shows part of the results from a substructure search for cyclohexane.
278ChemACX
Vendors
It is possible for the user to search for substances under a shorter list of preferred vendors. This shorted list helps to limit search results to include products from only your favorite vendors. To create or edit a list of favorite vendors available to search under:
1. From the ChemACX Query input form, click Edit Favorite Vendors List.
Then
2. Select the checkbox next to any vendor that
by chemical name
in the text box, enter a chemical name. in the text box, enter a CAS number.
should be included in the favorite list. To remove a vendor, deselect the checkbox.
3. Click Save as Preferred List.
by CAS number
A list of favorite vendors is saved and the Vendor Selector box closes.
with the full query click Advanced page, including Query with Plugin. structures and other criteria
3. Click Search.
giving only summary information for each result. You are able to register and lookup MSDX data from this view.
information in the selected record. You are able to register and lookup MSDX data from this view as well as add items to your shopping cart from this view. To view a record's entry:
1. Search for a chemical on ChemACX. For more
Administrator
information about searching in ChemACX, see Searching ChemACX Catalogs on page 278. 2. To view vendors for a specific record, click Details. The detailed view appears
The order is added to your Shopping Cart. 7. To view the full catalog listing, click Catalog Details, and a new window will appear displaying catalog information. 8. In the list, select the checkbox next to Add to Cart and enter a quantity. The order is added to your Shopping Cart.
Favorite Vendors, or Other Vendors. 4. Highlighting a vendor name in the list found in the tabs will display a catalog listing to the right. To compare more then one vendor, hold down CTRL when highlighting vendor names. 5. Clicking Catalog View or Compact View will toggle between the two viewing options. Select whichever view you are most comfortable with.
280ChemACX
To view results in list view, perform a search. Use the browsing buttons to browse through the pages of result.
Records in details view are displayed with both structure and vendor information. To find the vendor catalog you are looking for:
1. Select one of the tabs: Online Vendors, Your
Enterprise. Access the MSDX data for the compound. Browse Vendor information.
Note: To compare more then one vendor, hold down CTRL when highlighting vendor names. 3. Select the appropriate viewing option by clicking on one of the following buttons: Catalog View
Administrator
Details, and a new window will appear displaying catalog information. Compact View
282ChemACX
result of selecting one of the options, the datasheet appears in PDF format.
Remove all.
your shopping cart. 3. In the list, select the checkbox next to Add to Cart and enter a quantity.
Export to
Send Hits to Inventory button (on the shopping cart page) are visible. Otherwise, these tools will not be available. For more information about configuring your system to link to Registration Enterprise and/or Inventory, please see your system administrator.
Administrator
are options configured by your system administrator. See your system administrator for more details. The Requisitioner Information Form appears.
provided. 3. Click Export to Excel (or Export to Word). Your shopping Cart information is saved to an Excel workbook or Word Document with one sheet for each vendor.
textbox. Select a name from the Chemical Name listbox. The names listed are all names associated with the record in ChemACX. 3. Click OK.
284ChemACX
3. Click OK.
information you have entered or test the commit process before actually committing the data. To test the data before committing, click Test.
To Send the contents of your Shopping Cart to Inventory and make containers for them:
1. Click Send Hits to Inventory.
If you start your search with the Index form and find some matching compounds:
A list of synonyms in the Synonyms subform
appears. A list of suppliers in the Products subform appears. Search MSDX by clicking the MSDX button. To view product information: On the Index form, click a product name. The Product form appears.
Administrator
Logging Off
You can end your session with ChemACX at anytime by logging off. To log off:
Click
Log Off.
286ChemACX
Administrator
288ChemACX CambridgeSoft What If My Favorite Supplier Isnt Listed Here?
How is it Useful?
ChemMSDX provides rapid access to comprehensive health and safety information to aid in the safe handling, storage, and transportation of materials, and provides precautionary and emergency medical information. Availability:
DVD-ROM as part of ChemACX Ultra Internet Subscription as part of
ChemACX.com Intranet with ChemACX on ChemOffice Enterprise Number of Compounds: > 21,000
Selecting View MSDS will cause the MSDS record will appear in a new browser window in PDF format.
Administrator
If multiple MSDS records are available, users are able to choose which record they wish to view.
290ChemMSDX CambridgeSoft Using ChemMSDX from ChemOffice Enterprise
Administrator
292Sigma-Aldrich MSDS Collection CambridgeSoft About the Sigma-Aldrich MSDS Collection
Key Benefits:
Never again worry about getting a citation
How Is It Useful?
Environmental, Heath and Safety (EH&S) groups are critical to research institutions because they help to ensure compliance with laws, regulations and an organization's own safety policies. As part of the basic function, these groups often play a key role in the procurement, inventory, transport, storage, and disposal of chemicals throughout the organization. EH&S Enterprise is a fully developed and proven system to provide clients with information that allows all departments, from the receiving clerk to the company's waste disposal contractor, to properly segregate chemicals for delivery, storage, handling and disposal. Chemical structure and substructure searching provides intuitive access for chemists. Non-chemists can correctly segregate chemicals using the chemical segregation module. The backbone of EH&S Enterprise is a data system which has been fully developed by a certified industrial hygienist with over 24 years of experience. The data is integrated into the application using CambridgeSoft ChemOffice Enterprise technology.
from OSHA for failure to correctly segregate reactive chemicals Integrated Department of Transportation and IATA regulatory information Deliver in-depth right-to-know information to all employees with a few keystrokes. HMIS/NFPA hazard warning Is the compound a carcinogen or sensitizer? Material Safety Data Sheets A complete DEA regulated compound database Purchases can be pre-approved Comply with shipping and storage requirements OSHA and EPA threshold planning lists Ensure quantities purchased will not exceed the threshold planning quantity No more process safety management reports Integration with Inventory Enterprise and Workgroup Integration with ChemACX Enterprise and Workgroup Integration with the Sigma-Aldrich MSDS collection
Administrator
294EH&S Enterprise CambridgeSoft Key Benefits:
295
Administrator
296 CambridgeSoft
How Is It Useful?
ChemRXN provides ready access to information useful in planning a chemical synthesis. A reaction query can search for all reactions that:
Yield a particular product Use a particular catalyst or solvent Consume a particular reactant Have been published by a certain author
For example, you can search for reactions which produce benzofurans in greater than 90% yield.
ChemPrep has a principal form or main screen, Chemprep.cfw, and three associated forms:
Reaction.cfw Solvent.cfw Catalyst.cfw
ChemPrep
ChemPrep is a carefully prepared chemical reaction database from the Institute for Scientific Information (ISI). ISI is one of the largest and most reputable providers of scientific information, and has a number of scientific databases available including exhaustive reaction and molecular literature databases. Directory: ChemPrep Filenames: Chemprep.cfw, Catalyst.cfw, Reaction.cfw, Solvent.cfw
Reaction.cfw shows the reaction diagram in a larger window. It is useful in case the reaction is complicated or has large molecules or many components. Reaction.cfw is called from the main screen by clicking the zoom Reaction button. The view Solvents and view Catalysts buttons provide larger views of the solvent (form Solvent.cfw) and catalyst (form Catalyst.cfw) molecules which appear in the scrolling lists on the right of the main screen. Each of these associated forms has a button to return to the main screen.
The reactions in ChemPrep were selected by ISI from their larger reaction databases and were provided with full literature references. The reaction centers and atomic transformation matrices were computed with ChemFinder.
Molecular Weight (components) PageNumber Journal Yield Reaction Text Pressure Reflux Literature text Author Type Title Language Volume
Administrator
ChemSelect
ChemSelect is a collection of the most commonly cited reactions from the literature, selected by InfoChem GmbH of Germany. The ChemSelect data is taken from the VINITI project of the former Soviet Union, in which over 2 million chemical reactions were compiled. The 13,037 reactions of ChemSelect were obtained using a defined statistical methodology which selects the most representative reactions from the database. All reactions contain full literature citations. Directory: ChemSelect Filenames: ChemSelect.cfw, Catalyst.cfw, Reaction.cfw, Solvent.cfw Number of reactions: 13,037 Key Fields:
Structure (reaction) Reaction Formula Year
The associated forms show the data in a larger window. To access Reaction.cfw:
From the main screen, click Zoom Reaction.
InfoChem is a major provider of scientific information, and has also created selections called ChemReact41 (41,000 reactions), ChemSynth (100,000 reactions), and ChemReact (400,000 reactions). These will also be available as ChemFinder databases. For further information, contact CambridgeSoft or InfoChem GmbH.
298ChemRXN
CambridgeSoft ChemSelect
Selection Criteria
For inclusion in ChemSelect, each reaction must typify at least five different reactions. Two reactions are considered to be of the same type if the reaction centers and the groups around the reaction centers
are identical. Each reaction in ChemSelect has been cited in at least five different journal articles, has a yield of at least 50%, and has been published in a generally available journal.
ChemRXN299 ChemSelect
Administrator
300ChemRXN CambridgeSoft ChemSelect
About ChemSynth
Availability:
CD-ROM (ChemFinder database only - no
software is included) Internet Subscription Intranet on ChemOffice Enterprise Number of Record: 178,842 Reactions Key Fields:
Reaction Structure Yield Reaction Conditions Catalyst Structure Solvent Structure Author Title Journal Reference
Data that can be searched includes chemical structures and reactions. You can search for particular templates for starting materials or products by placing an arrow to the left (product) or right (reactant) of the structure you wish to search. Other searchable fields include yield, reference information and comments.
searching form acts much like the other search forms found in ChemOffice Enterprise applications.
3. Click
Search.
Administrator
To search for compounds anywhere in the reaction
1. Enter the structure into the ChemDraw
provided in the Search Form. 2. Place an arrow to the left of the structure 3. Click Search. The example shows a search for a structure as a product. When the search is complete, A list of search results appears.
Search.
provided in the Search Form. 2. Click Search. To search a structure only as a reactant
1. Enter the structure into ChemDraw box
To view the contents of a particular record in the Show Details. The complete list, click contents of the chosen record is displayed.
provided in the Search Form. 2. Place an arrow to the right of the structure
302ChemSynth
ChemSynth303
Administrator
304ChemSynth CambridgeSoft
About ChemReact
Availability:
ChemReact68 CD-ROM (ChemFinder
database only - no software is included) Internet Subscription Intranet on ChemOffice Enterprise Number of Record:
ChemReact500: 445,717 Reactions ChemReact68: 67,926 Reactions
Key Fields:
Reaction Structure Yield Reaction Conditions Catalyst Structure Solvent Structure Author Title Journal Reference
Data that can be searched includes chemical structures and reactions. You can search for particular templates for starting materials or products by placing an arrow to the left (product) or right (reactant) of the structure you wish to search. Other searchable fields include yield, reference information and comments.
provided in the Search Form. 2. Place an arrow to the right of the structure 3. Click Search. To search a structure only as a product
1. Enter the structure into ChemDraw box
Administrator
provided in the Search Form. 2. Place an arrow to the left of the structure 3. Click Search. When the search is complete, A list of search results appears.
Search.
To view the contents of a particular record in the Show Details. The complete list, click contents of the chosen record is displayed.
306ChemReact
ChemReact307
Administrator
308ChemReact CambridgeSoft
Appendices
This section contains appendices in the following order:
Appendix A: DocManager Enterprise Free Text Searching - Describes the use of key words and symbols in Free Text Searching Appendix B: BioAssay Actions Menu Commands - Describes the actions available form the Actions button within BioAssay. Appendix C: BioAssay Plate Block Data Files - Indicates how to indicate to BioAssays FIle Import Template Wizard how your plate block data file is formatted. Appendix D: Oracle Cartridge Dependencies by Operating System lists the libraries necessary for the Oracle Cartridge Appendix E: Scientific Databases First Search Tutorial - A tutorial for using the CD based Scientific Databases with ChemFinder.
309
Administrator
310 CambridgeSoft
thymidine synthesis
the words thymidine synthesis in that order, with no words between in a documents text. the word cyclohexane in a documents text.
cyclohexane
Wildcard Searching
If a prefix or a suffix for a word is either unknown or variable, wildcard characters become useful in a free text search to return all words with the same word root. Wildcard characters can be used in a basic text search when searching for all documents that contain a part of a word. This kind of search typically returns more matches to search criteria than the exact phrase search.
Administrator
synth*
any word with synth as the first 5 letters in a documents text. Matches include synthesis, synthetic, and syntheses. any word with ethane as the last 6 letters in a documents text. Matches include ethane, and methane.
ABOUT
The ABOUT operator, when used in an advanced text search, or query, retrieves documents that contain information related to a word or phrase. The ABOUT operator is used, by entering the word ABOUT in all capital letters followed by the word or phrase on which to search in parentheses. ABOUT searches are always case-sensitive. The text string inside the parentheses is interpreted with respect to case. For example, the following searches really mean:
Searching for Returns documents with
*ethane
ABOUT (carbon)
any word with words related to carbon in the documents text. Matches include coal and diamond. any word with words related to carbon biproducts from syntheses at 25 degrees Celcius in the documents text. Matches include coal and diamond
The ABOUT operator becomes very powerful when coupled with other operators, such as AND or NOT.
any word with words related to carbon as well as the word diamond in the documents text. any word with words related to carbon but excluding the word diamond in the documents text.
carbon AND diamond both the words carbon, and diamond, found anywhere within a documents text. carbon & diamond both the words carbon, and diamond, found anywhere within a documents text. all the words carbon, diamond, and graphite, found anywhere within a documents text. both the phrases thymidine synthesis, and carbon dioxide, found anywhere within a documents text.
NOTE: For advanced Oracle users: The word or phrase specified in an ABOUT query does not have to exactly match the themes stored in the index. Oracle automatically normalizes the word or phrase before performing lookup in the Text index.
AND (&)
The AND operator used in an advanced text search or query, finds documents that contain more than one word or phrase. The AND operator is used to search for documents that contain at least one occurrence of each of the query terms. The AND operator, is used by entering the first term, then the word AND in all capital letters (or entering the ampersand (& symbol)), followed by another word or phrase on which to perform a search.
EQUIValence (=)
The EQUIValence operator used in an advanced text search, or query, will allow the user to find documents that contain information about words that can be used in place of each other, alone or in a phrase. The EQUIValence operator is used to specify an acceptable substitution for a word in a query. The EQUIValence operator is used by, entering EQUIV in all capital letters (or enter the equal sign (=)), followed by the phrase on which the search is to be performed.
Administrator
the words graphite or diamond found anywhere within a documents text. the words graphite or diamond found anywhere within a documents text. the words carbon dioxide, carbon monoxide, or both terms found anywhere within a documents text.
?boron
any word spelled similarly to boron found anywhere within a documents text. Matches include baron. any words spelled similarly to read found anywhere within a documents text. Matches include read, lead, and real. any words spelled similarly to chemist found anywhere within a documents text. Matches include chemists and chemistry
graphite = diamond
?read
carbon dioxide=monoxide
?chemist
NOTE: The EQUIValent operator has higher precedence than all other operators except the expansion operators (fuzzy, soundex, stem).
Fuzzy (?)
The fuzzy operator used in an advanced text search, or query, will find documents that contain words similar to the word used in a search. For example, the fuzzy operator can be used to expand queries to include words that are spelled similarly to the specified term. This type of expansion is helpful for finding more accurate results when there are frequent misspellings, or alternate spellings in the documents in the database. The fuzzy operator is used by, entering a question mark (?), followed by the word on which to perform a search.
MINUS (-)
The MINUS operator can be used in an advanced text search, or query, to find documents that contain two phrases, with the first phrase taking precedence. The MINUS operator is used to search for documents that contain two query terms, but documents containing the second term are ranked lower than documents without the second term. The MINUS operator is useful for lowering the score of documents that contain a certain term, without eliminating those documents. The MINUS operator is used, by entering the first term, then MINUS in all capital letters (or enter the minus sign or hyphen (-)), followed by another term on which to perform a search.
The NEAR operator is used by, entering the first term, followed by NEAR in all capital letters (or enter a semicolon (;)), followed by the second term on which the search is to be performed. Use the NEAR operator to return documents based on the proximity of two or more query terms.
NOTE: NEAR cannot be used in ABOUT queries.
carbon - diamond
the words carbon and diamond in them, but documents with diamond are listed last. the words carbon and diamond in them, but documents with diamond are listed last. the words diamond and carbon in them, but documents with carbon are listed last.
diamond - carbon
the words carbon and diamond in them, but only when they appear less than 100 words apart and in no specific order.
NEAR (;)
The NEAR operator is used in an advanced text search, or query, to find documents that contain two phrases that are close together. The maximum distance between the two terms can be specified.
apart or less, unless specified otherwise. Use whole numbers between 1 and 100. Search terms are found in any order, specified otherwise. Use TRUE or FALSE.
The NEAR operator can be used with other operators, such as AND, OR, and EQUIValence. For example, the following searches really mean:
by, entering the term to be found, followed by the word NOT in all capital letters (or enter a tilde (~)), followed by the term to be excluded in the search. Use the NOT operator to search for documents that contain one query term and not another. For example, the following searches really mean:
Searching for Returns documents with
Administrator
Searching for
NEAR ((carbon, the words carbon and diamond), 20, FALSE) diamond in them, less than 20 words apart, in no specific order. NEAR ((carbon, the words carbon and diamond), 20, TRUE) diamond in them, less than 20 words apart, in this specific order. NEAR ((carbon, diamond), 10) AND benzene the words carbon, diamond, and benzene in them, but only when carbon and diamond appear less than 10 words apart and in no specific order. the words carbon, diamond, and graphite in them, but only when carbon and diamond or carbon and graphite appear less than 10 words apart and in no specific order.
carbon NOT diamond the word carbon, but not the word diamond anywhere in the documents text. carbon ~ diamond the word carbon, but not the word diamond anywhere in the documents text. the word carbon, but not the word diamond or graphite anywhere in the documents text.
operators.
OR (|)
The OR operator can be used in an advanced text search, or query, to find documents that contain information about any words in the query, but not necessarily all words in the query. The OR operator is used by, entering the first term, followed by the word OR in all capital letters (or enter the pipe (|)), followed by another term on which the search is to be performed.
NOT (~)
The NOT operator can be used in an advanced text search, or query, to find documents that contain a word or phrase, but only when it appears without a second word or phrase. The NOT operator is used
Use the OR operator to search for documents that contain at least one occurrence of any of the query terms. For example, the following searches really mean:
Searching for Returns documents with
The soundex operator is used by, entering an exclamation point (!), followed by the word on which to perform a search. Use the soundex (!) operator to expand queries to include words that have similar sounds; that is, words that sound like other words. This function allows comparison of words that are spelled differently, but sound alike in English. For example, the following searches really mean:
Searching for Returns documents with
carbon OR diamond
the words carbon, diamond, or both anywhere in the documents text. the words carbon, diamond, or both anywhere in the documents text. the words carbon, diamond, graphite, or any combination of the terms anywhere in the documents text. the words thymidine synthesis, carbon dioxide, or both terms anywhere in the documents text.
carbon | diamond
!carben
any words that sound like the word carben in a documents text. Matches include carbon and carboxcylic. any words that sound like the word read in a documents text. Matches include read and lead.
!read
Stem ($)
The stem operator is used in an advanced text search, or query, to find documents that contain words similar to the word used in a search. When the stem operator is used, enter a dollar sign ($), followed by the word on which to perform a search. Use the stem operator to search for terms that have the same linguistic root as the query term. Stem expands a query to include all terms with the same stem or root word as the search term.
Soundex (!)
The soundex operator is used in an advanced text search, or query, to find documents that contain words that sound like the word used in a search.
Administrator
$commit
any words with the root commit found in the documents text. Matches include commits, committing, committee, and committed. any words with the root chemist found in the documents text. Matches include chemist, chemistry, and chemists in them.
$chemist
Viewing Commands
View Details
The View Details action can be accessed from any Protocol Data table, except from a table found at the bottom of the hierarchy. The View Details action brings about the same result as doubleclicking on a row in the table: the data table holding aggregate data for the current table, is opened. This result makes sense because the data that makes up a particular row in one table is formed by the data calculated in the next lowest table.
View Picklist
The View Picklist action is available from the table containing assay picklist definitions. This action will open a table defining the options available in the chosen picklist. To view a picklist's table:
1. Select the row defining the picklist to be
viewed.
2. Select View Picklist from the Actions menu.
Other Commands
Autofit
The AutoFit action is available from any grid view. If AutoFit is turned on, the grid will automatically resize to fit in the current window. If the window is then resized, the grid will resize accordingly.
AutoFit On
data. 2. Highlight the rows holding the data. 3. Select Change Validity from the Actions Menu. The Change Validity window appears.
Administrator
AutoFit Off
Validity Option
Change Validity
The Change Validity action is available from any Data table. By default, all data is assumed to be Not Validated unless otherwise specified. Data which is Not Validated is noted by an N in the leftmost column of the data table. After adjusting the validity of data, it is possible to view only valid data in the tables. It is also possible, in the Security tab of the protocol definition, to specify that Valid data may not be edited or recalculated. Calculations are based on data which is marked with any validity except Invalid.
Not I Validated
no validation Yes decision has been made data is found Yes to be valid data is found No to be invalid
Valid
Invalid
Validity Option
4. Click OK.
Copy
The Copy action is only used in Edit mode. The action will copy any highlighted information.
Request Review
Cut
The Cut action is only used in Edit mode. The action will cut any highlighted information.
Import Data
If you are validating data in a summary table, you can also choose to cascade the validity change to the summary data. Select this box if you would like to apply the new validity to the summarized data. The Import Data Action is available from any Protocol Data table. This action will bring up the File Import Wizard. The wizard assists in importing data through the use of a defined File Import Template.
Coloring Options
The coloring options are used to implement heat maps. The Coloring Options Dialog box will allow the user to select a parameter to base a heat map on, and select what values for that parameter will appear in which colors. To set coloring options:
1. Select Coloring Options from the Actions
Paste
The Paste action is only available in Edit Mode. This action pastes whatever is on the clipboard to the selected area.
Recalculate
The Recalculate action will run all calculations defined in the chosen table again. This is useful if the user changes a key piece of data and is interested to see how the calculations will be effected by the change.
Select All
2. Select a parameter to base the heat map on
from the Color based on listbox. 3. Enter maximum and minimum values along with colors that correspond to each.
The Select All action will select all of the rows in a table. This is often helpful when applying a different action to all of the rows in a table.
Show Coloring
This action shows the heat map coloring. When this action is selected, each cell in the grid will be filled with a color representing a value defined in the coloring options. This is available from all views.
Administrator
Administrator
324BioAssay Plate Block Data Files CambridgeSoft
Chem & Bio Office Enterprise, Workgroup & Databases 2006Oracle Cartridge Dependencies by Operating System325
Administrator
326Oracle Cartridge Dependencies by Operating System CambridgeSoft
ChemFinder launches and an empty form appears. To open a database (e.g. CS_demo): 3. Select Open from the File menu or click the Open tool. The open dialog box appears 4. Navigate to \ChemFinder\samples and highlight CS_demo.cfw.
The CS_demo database opens in ChemFinder with the first record displayed.
There are several ways to make another open form the active window:
Select the form from the Window menu. Click any exposed area of the window you want
Administrator
to be active. Press CTRL+Tab to switch among the currently open form windows.
Browsing a Database
One option in viewing a ChemFinder database is to browse through the database one record at a time, just as you would turn the pages in a book. The Record Toolbar contains intuitive tools for browsing through the database. Try it!
First record Go to record Last Record
In addition to browsing through the records, you can also go directly to a specific record by using the Go To Record command found in the Record menu. 1. Select Go To Record from the Record menu, Go To Record Tool. or click the The record Number dialog box appears.
Previous record
Next record
By default, the toolbar is docked. If you wish, however, you can grab it with the mouse and drag it anywhere on the screen that is convenient.
2. In the Record Number dialog, enter the record
Alternatively, you can select the corresponding commands from the Record menu, instead of using the toolbar.
number (within the current list) you want to display. 3. Click OK. The specified record is displayed.
When a form is first opened, the current list size will equal the total database record count. If you do a search (see : Scientific Databases First Search Tutorial) to find a subset of the entries in the database, the current list size will change to indicate the number of hits in the search.
A list window, containing the fields and records in the form, appears.
To the left of these counters are three other indicators that show the general status of the database. The first will display the word READ when you are using. The second indicator will display the word ADD when you are entering a new record. The third will display QRY when you are entering a query.
NOTE: The ADD indicator is not applicable to CD-
To resize the column widths in the Data Table: 4. Place the cursor on the dividers in the top header. The cursor changes. 5. Click and drag to adjust the column width.
To resize the row heights in the Data Table: 6. Place the cursor on the dividers in the left header. The cursor changes. 7. Click and drag to adjust the row height.
The form selected in step 2 appears in the upper half of the ChemFinder window, and the data table is in the lower half.
Administrator
By default, the fields in the data table are displayed in the order they were created. To reorder the columns in the Data Table: 8. Click one of the column headers to select the column. 9. Drag that header to a new position.
Another convenient method of viewing data is by displaying a form and data table simultaneously in Tile layout. 10.If you havent done so, open a Data Table view in a separate window. 11. Click on the Form view to activate it.
NOTE: If the Data Table view window is active (i.e. its title bar is highlighted), some menu options are not available. To access these options, first click on the Form view window.
Closing a Form
To close the form you have opened, select Close from the File menu.
the query C6N1-2, without the quotation marks, in the Formula box.
This entry specifies a molecular formula having 6 carbon atoms and 1 or 2 nitrogen atoms.
3. Click the Find tool or the Search button.
ChemFinder begins searching. The progress of the search is indicated by counters in the status bar at the bottom of the window. When the search is complete, the number of hits is displayed in the Current List Size window of the Status Bar, and the form displays the first hit. NOTE: If a search returns no hits, an alert appears. After the alert is cleared, the screen is left in query mode with the last query shown to allow you to modify it and try again.
display the hits and verify that the formulas are correct.
Searching by name
For our next example, well perform a text search to find all compounds with molecular names starting with benz. To perform this text search:
1. Click in your form to activate it. 2. Click the Enter Query button to clear the
Administrator
query form.
3. Click in the Product Name data box, and enter
display the hits and verify the molecular names are correct. NOTE: Notice that this search returned benzene but not bromobenzene. The query entered is an anchored substring and thus will only return strings starting with the indicated substring. For more information regarding how to specify text queries, see Text Searching in ChemFinder Help (press the F1 key).
form.
A blue outline appears around the structure box, and the ChemDraw ActiveX control appears. NOTE: If the ActiveX control does not appear, or if you should accidentally close it, right-click in the structure box and select View > Show Main Tools.
at an angle of about 30 degrees (a message in the lower left corner of the document window shows the angle) and release the mouse button when you have extended the bond to its fixed length.
2. point
3. drag
NOTE: Right-click in the structure box and select the Object menu. Fixed Lengths and Fixed Angles should be checked, as shown below. If either is not checked, select it in the menu to place a check beside it.
when a bond tool is selected) anywhere in the empty Structure/Substructure window and hold down the mouse button.
4. point
5. click
Administrator
10.point
11. double-click
To close the textbox, click in an empty area of the window, press Enter, or click the ActiveX control to select another tool.
structure drawing. Now that you have drawn acetone in the structure box, you are ready to perform a search.
8. point 9. drag
Next, add labels to the structure. Atom labels can be added in several ways. One way is illustrated below.
10.Point to the atom shown below.
NOTE: See the Tutorials in the ChemDraw Users Guide for more information on drawing in ChemDraw.
menu items are toggles; each time they are selected them, the check mark is removed if it was there already, or added if it wasnt previously visible. So, before you commence the search:
1. Enable Substructure from the Search menu. 2. Disable Similarity form the Search menu.
You can also conveniently view the database in tabular form. Select Data Table from the View menu. Open a Data Table in a separate window. The Data Table appears and displays all records in the current list in tabular form.
NOTE: See Similarity Searching in ChemFinder Help (press the F1 key) for more information. The Search menu should now look like this:
Click a record in the Data Table to display its records in your form window. It is possible to sort records on any field. To sort on the ItemNumber field: Double-click on the ItemNumber table header in the Data Table. To search for structures containing propane: Select Find from the Search menu, or click the Find tool. In the case of a substructure search, the matched portion of each molecule is highlighted in red. All hits are structures that contain a acetone substructure. Now, you can browse through these hits. Use the Record menu or the Record toolbar to browse the hitlist (see Browsing a Chemical Database on page 327). After a short pause, the table is sorted by number. Close the Data Table by selecting Close from the File menu. You can return to the full database at any time. To retrieve all the records in your database: Select Retrieve All from the Search menu or click the Retrieve All tool. NOTE: After a search, you do not need to retrieve all your records before conducting another search; you can perform another search at any time. Each search will search over all records in the database.
Administrator
b. Click in the Structure/Substructure box. 4. Click in the query form somewhere outside the Structure/Substructure box to complete the
structure.
5. Click the Mol Weight databox and type >400
databox.
3. Draw benzene in the window by doing the
following:
Index
A
About button definition 195 server information 213 About, ChemOffice WebServer 2001 191 Administration 147 Audit report, aggregate 160 Audit report, printing 113 Audit report, standard 159 Audit trail, analyzing 112, 159 Audit trail, viewing 112 Avery labels, selecting 105 viewing search results 283 ChemACX-SC 263 Chemical Registration adding a batch 165 adding a compound 164 defining password 179 deleting a record 168 editing a record 168 identifiers 170, 171 importing sdfiles 182 Log in 164 Log off 187 MatchDatabase 182 new experiments 179 notebooks 174 opening 163 Overview 163 parameter type 181 people 176 printing records 187 projects 173 registering records 169 result type 180 reviewing a record 167 salts 177 searching records 171 sites 177 structure comments 174 temporary table 164 vewing experiment spreadsheets 172 Chemical registration defining passwords 147 Chemical synthesis database 257, 259, 273, 291, 293, 297 Chemicals database 263, 277
B
Backup see Database 111 Browsing search records 204 Buckminsterfullerenes 268 BuckyBase 268
C
CAS registry number 267 Changing password for Documentation Manager 12 Changing passwords 108 Changing quantities in containers 100 Changing quantities, and other shortcuts 99 Changing, results views 203 Check-in/Check-out 99 ChemACX 263, 277 opening 278 ordering chemicals 283 removing from shopping cart 283 saving search results 279 searching 278 using 277, 287
ChemIndex 267 ChemInfo 248 ChemMSDX 289 ChemOffice 249 ChemPrep 297, 298 ChemRXN 257, 259, 273, 293, 297, 301 ChemSelect 298 Clear Form button 196 Clearing marked records 205 Client requirements 191 Combination searching 202 Commonly cited reactions 298 Conflict resolution 97 create duplicate 98 edit 98 select 98 Container grid 111 Containers 92 definition 90 editing 92 new 92 Creating a plate map location 144 daughter plates by target plate 143 new containers 98 new locations 93 new substances 95 new user accounts 159 plate maps 143, 144 Custom fields 110
containers 99 favorite vendors list 279 locations 94 substances 98 EHS data 100 EHS help file 101 Element counts 201 Environmental, Health, and Safety see EHS data 100 Exiting web applications 213 Exporting search results 210
Administrator
F
Form view, results 203 Form, see Query Input Form Forms 92 Formula searching 201
H
Hits, exporting 210
I
Importing sdfiles into Chemical Registration 182 Index form ChemACX 286 Input form, see Query Input Form Installation 3, 249 Installation requirements 191 Inventory GUI 91 Inventory terminology 89 Inventory, non-chemical 98
D
Database, backup and restore 111 Deleting locations 94 plates 146 Display preferences settings 195 Documentation Manager overview 7, 9 password 12 submitting documents 10 Drag-and-drop of containers 99 Duplicating a container 99
L
Labels, EHS 106 Labels, printing 104 List View, results 203 Location definition 89 Location tree 93 Location, creating 93 Locations 92 editing 92 new 92 Locking records 111 Log off button 196 web applications 213
E
Editing
ii Index
CambridgeSoft
Logging in 115
Q
Query see also Searching combination 202 different methods 198 formula 201 molecular weight 202 structure 199 text 198 Query Input form accessing 278, 311 components 195 opening 278, 311 using 195 Quitting web applications 213
M
Macintosh system requirements 191 Managing containers 98 locations 93 substances 95 the container list display 111 users and roles 108, 147 Marking records 205 MatchDatabase 182 Molecular weight searching 202 Moving locations 94 plates 145 Moving containers 99 Moving containers, with drag-and-drop 99 MSDS database 289 Multi-select 100
R
RAM 3 Record locking 111 Records clearing marked 205 marking 205 unmarking 205 viewing all 204 marked 205 Refining search results over current records 210 Refreshing the location tree 94 Removing ChemACX shopping cart 283 Reports EHS 107 matching fields 107 printing 106 Reports, printing 104 Requirements RAM 3 system 3 Requirements, installation 191 Restore see Database 111 Results changing views 203 exporting 210 form view 203
N
National Cancer Institute database 271
O
Online help 249 Opening ChemACX 278 server information 213 Ordering chemicals through ChemACX 283 Overview Chemical Registration 163 Documentation Manager 7, 9
P
Passwords, defining 108 Plates retiring 146 Preferences button 195 display 211 search 212 Printing 104 labels 104 reports 106 template Wizard 105 Product form ChemACX 286
Index
Index
iii
list view 203 Roles, assigning users to 109 Roles, managing 108 Roles, nesting 109
S
Safety data see EHS data 100 Saving ChemACX search results 279 to Shopping cart 279 sdf file 210 Search button 196 Search Type list 197 Searches simple 102 Searching 101 advanced techniques 102 ChemACX 278 combination search 202 for containers 101 for substances 103 formula search 201 molecular weight search 202 preferences 103 query methods 198 similarity 201 structure search 199 text search 198 using query input form 195 viewing all records 204 more records 204 results 203 Selecting multiple containers 100 Server information 213 Settings display preferences 211 search preferences 212 Shopping cart removing entries 283 saving to 279 viewing 283 Similarity searching 201 SQL queries, editing 101 Status, of containers 100
Structure searches exact 103 identity 103 similarity 103 substructure 103 Structure searching 199 Submitting documents 10 Substance definition 90 Substances 92 new, form 93 select, form 93 Substructure Search see Structure searches Supplier form ChemACX 287 Supplier Information Form 279 Supplier list, abbreviating 110 Suppliers, adding from ACX link 96 Suppliers, adding to ChemACX 287 Synthesis database 257, 259, 273, 291, 293, 297 System requirements 3, 191
Administrator
T
Table view, search results 203 Tables, managing 110 Text Searching 198 ToolTips 1, 249
U
Unmarking records 205 Users, assigning to roles 109 Users, managing 109 Using ChemACX 277, 287 query input form 195 Shopping cart 279
V
Version information 213 Viewing all search records 204 ChemACX shopping cart 283 marked records 205 more search records 204 search results 203 Views, changing 203
iv Index
CambridgeSoft
W
Web application logging off 213
Index
Index
Administrator
vi Index CambridgeSoft
CambridgeSoft Solutions
D ESKTOP S OFTWARE E NTERPRISE S OLUTIONS C HEMICAL I NFORMATICS B IOLOGICAL I NFORMATICS K NOWLEDGE M ANAGEMENT S CIENTIFIC D ATABASES
CAMBRIDGESOFT
ChemOffice Desktop to
KNOWLEDGE MANAGEMENT CHEMICAL INFORMATICS Desktop
E-Notebook Enterprise
CombiChem Enterprise
Inventory Enterprise
Registration Enterprise
21CFR11 Compliance
GxP Validation
WebServer
DESKTOP TO ENTERPRISE
Chem & Bio Office ChemOffice Workgroup ChemOffice Enterprise
Just as Chem & Bio Office supports the daily work of the individual scientist, ChemOffice Enterprise, with Oracle Cartridge, and ChemOffice Workgroup, based on SQL Server, help organizations from small workgroups to large enterprises collaborate and share information more effectively.
KNOWLEDGE MANAGEMENT
E-Notebook Enterprise Reaction Explorer CombiChem Enterprise E-Signatures 21CFR11 Compliance
Research organizations thrive when information is easily captured, well organized, and readily available. E-Notebook Enterprise streamlines record keeping with rigorous security and efficient archiving, and facilitates text and structure searching. Reaction Explorer can display the ancestors and descendants of a particular batch in seconds, while CombiChem Enterprise provides the power of combinatorial chemistry. E-Signatures provides intellectual property protection and 21CFR11 Compliance implements an organizations regulatory compliance process.
CHEMICAL INFORMATICS
Inventory Enterprise GxP Validation Registration Enterprise DocManager Enterprise Oracle Cartridge
Managing huge data streams is a key challenge. Registration Enterprise organizes information about new compounds according to an organization's business rules, while Inventory Enterprise provides complete management of chemical and biological inventories, including GxP validation. DocManager Enterprise is an important part of collaborative research data management. Oracle Cartridge adds chemically intelligent searching to Oracle, integrating with ChemOffice Enterprise applications.
SOLUTIONS
Enterprise Solutions
BIOLOGICAL INFORMATICS SCIENTIFIC DATABASES
DocManager Enterprise
ChemACX Database
BioSAR Enterprise
Sigma-Aldrich MSDS
Scientific Databases
BIOLOGICAL INFORMATICS
BioAssay Enterprise BioViz BioSAR Enterprise BioDraw
Finding structural determinants of biological activity requires processing masses of biological assay data. Scientists use BioAssay Enterprise and BioSAR Enterprise to set up biological models and visualize information, to generate spreadsheets correlating structure and activity, and to search by structure. The BioViz application allows you to create graphical representations of data.
DESKTOP SOFTWARE
ChemDraw & Chem3D ChemFinder & ChemInfo BioAssay & BioViz BioDraw Inventory & E-Notebook
Success begins at the desktop, where scientists use ChemDraw, ChemOffice, and BioOffice to pursue ideas and communicate with the natural language of chemical structures, biological pathways, and models. Scientists organize information and manage data with E-Notebook and Inventory. Chem3D provides modeling, ChemFinder aids searching, while BioOffice adds BioAssay, BioViz and BioDraw. Integrated with Microsoft Office to speed research tasks.
SCIENTIFIC DATABASES
The Merck Index Scientific Databases ChemACX Database Sigma-Aldrich MSDS Development Training & Support
Good research depends on reference information, starting with the structuresearchable ChemACX Database of commercially available chemicals and SigmaAldrich MSDS. The Merck Index and other scientific databases provide necessary background about chemicals, their properties, and reactions.
PROFESSIONAL SERVICES
CambridgeSoft's scientific staff has the industry experience, and chemical and biological knowledge to maximize the effectiveness of your information systems.
Av ai la bl e
ETh Ch C N Ch In Bi e Bi em Che hem Ch ot ve em oO Bio M oA em Che eb m Bi O Dr Dr er nt m ffi O oV AC ffi oo Dr ck or aw ssa aw ffi ce ce aw 3D iz X k y y ce In Su Ul Ul Ul Ul Ul Ul Ul Ul Ul Ul de ite Pr Pr tra tra tra tra tra tra tra tra tra tra x o o s
Win/Mac Win/Mac Win/Mac Win/Mac Win Win Win Win Win Win Win Win Win Win Win Win Win Win Win Win/Mac Win/Mac Win/Mac Win/Mac Win/Mac Win/Mac Win/Mac Win/Mac Win Win Win Win Win Win/Mac Win Win Win
*ChemDraw ActiveX/Plugin Pro *Chem3D Ultra Software Applications & Features Databases *Chem3D ActiveX Pro *Chem3D & E-Notebook Pro Chem3D & E-Notebook Std ChemFinder Pro ChemFinder Std *BioDraw Pro (Pathworks) *BioAssay Pro *Inventory Pro *E-Notebook Ultra BioViz/Chem & Bio Finder CombiChem/Excel ChemFinder/Oracle ChemFinder/Office ChemDraw/Excel Struct<=>Name ChemNMR & ClogP Stoichiometry Grid TLC PLate Tool Mass Fragmentation Tool Structure Clean Up Polymer Draw LabArt & BioArt Tinker/Chem3D MOPAC Client GAMESS Client Gaussian Client Jaguar Client The Merck Index *ChemACX Ultra (1 Year) *ChemINDEX Ultra ChemRXN, NCI & AIDS *Available Separately
ChemOffice is a powerful suite of software, consisting of ChemDraw, Chem3D, ChemFinder and ChemACX for chemists, BioOffice, BioAssay, BioViz, and BioDraw for biologists, and Inventory, E-Notebook and The Merck Index for scientists. ChemOffice and BioOffice are available for Microsoft Windows. ChemDraw includes Struct <=> Name, ChemDraw/Excel and ChemNMR. Create stereochemically correct structures from chemical names, and get accurate IUPAC names for structures. Estimate NMR spectra from a ChemDraw structure with direct atom to spectral correlation. The ChemDraw ActiveX/ Plugin adds chemical intelligence to your browser for querying databases and displaying information. Chem3D provides visualization and display of molecular surfaces, orbitals, electrostatic potentials, charge densities and spin densities. Chem3D utilizes MOPAC, Gaussian, GAMESS and extended Hckel to compute molecular properties. ChemProp computes Connolly surface areas, molecular volumes and properties, including Tinker, ClogP, molar refractivity, critical temperature & pressure. ChemFinder is a chemically intelligent database manager and search engine. ChemDraw/Excel creates searchable spreadsheets. ChemFinder/Word searches documents, spreadsheets, and files for chemical structures and references. ChemFinder includes CombiChem/Excel for combinatorial library generation in chemical spreadsheets. ChemFinder/Oracle provides enterprise solution integration. BioOffice is the ultimate suite for management, analysis and visualization of biological data using BioAssay and BioViz. Use BioDraw for drawing pathways. Includes Chem3D, Inventory and E-Notebook. BioDraw, formerly called Pathworks, makes drawing and annotating your biological pathways straight-forward and quick, adding a level of uniformity and detail which is unmatched. BioAssay manages both high and low throughput biological screening data. Designed for complex lead optimization experiments, the software supports the quick set-up of biological models. BioViz offers automated calculations, curve fitting, and customized structure activity reports, including a user friendly interface for importing, viewing, validating & plotting biological assay data. Inventory manages your reagent and biological tracking needs. Using MSDE as the desktop database, you organize, store and search over your inventory. Inventory integrates with the ChemACX database of available chemicals and ChemMSDX safety data providing chemical sourcing and purchasing. E-Notebook is the efficient, accurate way to write lab notebooks. It stores MS Office documents, ChemDraw structures and reaction drawings, and related data in a notebook searchable by text or chemical structure. Organize pages by project, experiment, or in your own style. Use CombiChem/Excel to build libraries. Databases include The Merck Index and ChemINDEX, including the NCI and AIDS databases. The ChemACX Database contains nearly 400 catalogs from leading suppliers and ChemMSDX Database contains over 20,000 material safety data sheets for commonly used laboratory chemicals.
computational chemistry made easy desktop to enterprise searching ultimate suite for biologists draw pathways screening data visualize data handle reagent tracking efficient notebook keeping access info with ease
ENTERPRISE &
Since the companys founding, CambridgeSofts desktop software, starting with its industry-leading ChemDraw, has been the cornerstone application for scientists who draw and annotate molecules, reactions, and pathways. The suite of applications has developed and CambridgeSoft now provides solutions in virtually all areas of discovery. Researchers can record and share their experimental information using E-Notebook, while protecting intellectual property with digital signatures and 21CFR11 compliance. They can design both single experiments or design combinatorial libraries of compounds. They find and purchase reagents in ChemACX database, store
and use them from Inventory, record newly made compounds within a proprietary Registration system, record the results from biological testing in BioAssay, analyze the results with BioViz, and generate reports linking activity and structure with BioSAR. Virtually every aspect of discoveryfrom synthesis planning, library enumeration, reagent selection, primary and secondary screening, in vivo testing, through to analysis of results and reporting is covered by this integrated application suite.
Development - Converting Leads into Testing
Building on productivity software, CambridgeSoft created enterprise applications to meet the needs of an
En ter
W W W or or or kg kg kg pr ro ro ro ise up up up Ul Std Pr Std tra o
ChemOffice
Includes
En
ter
pr Ul ise tra
En
ter
pr is Pr e o
E-Notebook Enterprise or Workgroup BioAssay Enterprise or Workgroup BioSAR Enterprise BioViz Desktop Registration Enterprise Inventory Enterprise or Workgroup ChemACX Database ChemINDEX Database Oracle Cartridge SQL Server Compatible ChemFinder Ultra
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800 EMAIL WWW info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
WORKGROUP
The handling of materials, including chain of custody requirements, material documentation, material workflow, such as availability states and recertification dates, are tracked and handling by the system. The systems meet these requirements and provide the basis to manage materials and records during clinical trials. Clinicians can design and record results from protocols, and all of these web based software systems provide the access required by clinicians who are removed from the sponsoring company.
ChemOffice Enterprise is a comprehensive
A suitable drug candidate is one that has the desired activity to provide disease therapy while still meeting drug safety requirements, can be manufactured in a cost effective and reproducible fashion under 21CFR11 and GMP guidelines, and is stable under normal formulation and storage conditions. With a drug candidate in hand, the final challenge is to determine safety and efficacy, beyond the laboratory, in a patient population. Manufacturing requires the hand off of data and batch process records from the pilot plant studies using Inventory, E-Notebook, and Registration systems under Good Laboratory and Manufacturing Processes (GxP).
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800
knowledge management and informatics solution, covering electronic notebooks, biological screening, chemical registration and more over your intranet. Enterprise Ultra includes E-Notebook for record keeping, BioAssay for low and high throughput screening with integrated plate inventory, BioSAR for SAR reports, Registration system, Inventory for reagents and ChemACX database of available chemicals. Technologies include ChemDraw ActiveX and Oracle Cartridge.
ChemOffice Workgroup is a comprehensive
knowledge management and informatics solution, covering electronic notebooks, biological screening and more over your intranet. Workgroup Ultra includes E-Notebook for record keeping, BioAssay for low and high-throughput screening, BioViz for visualization, Inventory for reagents and ChemACX database of available chemicals. Technologies include SQL Server for affordability and ease of administration.
EMAIL WWW
info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
KNOWLEDGE
E-Notebook offers custom organization of notebook pages at personal or enterprise levels Quick access to important data by searching on keywords, dates, chemical structures and more Reaction Explorer can display the ancestors and descendants of a batch in seconds
E-Notebook Ultra E-Notebook Ultra is the efficient, accurate way to write lab notebooks entries as you work. It stores Microsoft Office documents, ChemDraw structures and reaction drawings, and related data in an electronic notebook you can search by text or chemical structure. Organize pages by project, experiment or your own style with the MSDE database. CombiChem/Excel builds combinatorial libraries. Reaction Explorer Reaction Explorer is a powerful application that assembles a vast amount of information into a lucid synthesis map. The map provides reaction information, as well as quick access to experiments. Reaction Explorer displays two types of relationships between compounds: relationships grouped by batch and those grouped by compound. Both types of displays are configurable, allowing scientists to create a look and feel that they are comfortable with.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
MANAGEMENT
E-Notebook also provides the capability to scale reactions by virtually any parameter from reagent amount to vessel size. Individual reactions may be scaled as well as total syntheses. Batch procedures created with E-Notebook can be used to produce automatically batch record worksheets.
Display Ancestors
Authenticate Work
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
KNOWLEDGE
associated metadata. Managers, patent attorneys, and scientists can retrieve records based on searches over the metadata. E-Signatures also manages the signature workflow for electronic records and documents in process. Digital signatures are captured at the time of record creation, which can later serve to prove the authenticity of the stored electronic records. Reviewers, witnesses, and other individuals can countersign records for various business purposes, including witness records necessary to meet the needs of 37 CFR and similar regulations worldwide. 21CFR11 Compliance Large and growing enterprises are facing a challenge to their core missions of developing and producing new products including food, therapeutic pharmaceuticals, medical devices, cosmetics or other health
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
MANAGEMENT
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
CHEMICAL
Inventory, Registration,
Chem and Bio Inventory and Registration
Chem & Bio Inventory Inventory is an application designed to manage the chemical and reagent tracking needs of laboratories and research centers. The system manages data associated with both commercially procured and internally produced chemical substances from procurement or initial production through depletion and disposal. To meet the needs of institutions of all sizes, Inventory comes in an Enterprise edition, a Workgroup edition and two Desktop editions. Inventory Enterprise is an Oracle-based, ChemOffice Enterprise product. Designed for large organizations, it comprises a number of features not included in the desktop or workgroup versions. Inventory Enterprise conveniently manages plate information. In addition to storing, moving, and deleting plates, the application allows users to create daughter plates and reformat plates. Inventory Enterprise can be tightly integrated with Registration Enterprise and ChemACX Database. Inventory Workgroup is a thick-client SQL Serverbased product. This version is suitable for larger organizations that do not have the interest or desire to maintain an Oracle server. Inventory Ultra is the same MSDE based product, while also including the ChemACX Database, CambridgeSofts collection of nearly 400 catalogs from suppliers of chemical reagents.
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800 EMAIL WWW info@cambridgesoft.com www.cambridgesoft.com
Inventory offers plate handling for highthroughput experimentation Inventory is GxP Compliant with validated audit trails Registration has flexible business rules for registration, salt handling, and batch fields with chemical intelligence that includes advanced stereochemistry
Inventory Pro is an all-inclusive desktop product. It includes Microsoft SQL Server Desktop Edition (MSDE ), the re-distributable database for SQL Server. No additional licensing is required. Registration Enterprise Registration Enterprise includes a robust data model for pure compounds, batches, salt management, automatic duplicate checking and unique ID assignments. Compounds may be entered individually or through the use of a batch loader. The data model resides entirely in Oracle and uses Oracles security and transaction framework. Registration is easily adapted to any workflow. New compound chemical and non-chemical data is entered into a temporary storage area through a web form. When the compound is registered, it is compared for uniqueness via a configurable, stereoselective duplicate check, and assigned a registry
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S
systems are designed for registration of single molecules, with little thought for the world of formulations and mixtures. CambridgeSoft has developed a system specifically designed for this registration need called Formulations & Mixtures.
Index Documents
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
CHEMICAL
Inventory, Registration,
Chem and Bio Inventory and Registration
DocManager Enterprise Web browser based, DocManager Enterprise extends the capability of standard search engines to include full free text searching and chemically intelligent structure searching of electronic documents including Text, Microsoft Word, Excel, PowerPoint, and Adobe PDF. The DocManager Enterprise interface allows users to easily submit documents through a series of simple to navigate web forms. When a new document is submitted, DocManager builds a free-text index of the document, and extracts chemical information into a chemically-aware, substructure searchable database. Chemical information can originate from either ChemDraw or ISIS Draw. DocManager Enterprise includes a batch loading utility for administration level users to load multiple documents at one time. The system can be configured to submit a batch of documents as one event, or as a reoccurring submission to be executed daily. The administrator simply specifies a time for the submission to take place and the location of the files. DocManager Enterprise utilizes the searching intelligence of the ChemOffice Enterprise suite. In addition to standard textual and numerical searching, DocManager searches the submitted documents for chemical structure or reaction.
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800 EMAIL WWW info@cambridgesoft.com www.cambridgesoft.com
DocManager parses Word, Excel and PowerPoint documents, including free text DocManager has a web based interface and a file drop folder for quick submissions Oracle Cartridge is compatible with Linux, Solaris, AIX and Windows and includes structure searching, property predictions and nomenclature
Oracle Cartridge The CambridgeSoft Oracle Cartridge is used by all ChemOffice Enterprise applications for storing, searching over, and analyzing chemical data. It can also be used in the development of your custom Oracle applications. Chemical structure information is difficult to manipulate without utilizing special software. Oracle data cartridges define new, recognized datatypes. CambridgeSofts Oracle Cartridge utilizes this technology making it possible to manipulate chemical structure and reaction data from within Oracle, improving portability and consistency in applications. Since the Oracle Cartridge is accessed through Oracle, this allows the programmer to interact with chemical structure data directly in Oracle. The CambridgeSoft Oracle Cartridge supports CDX , CDXML , MolFile, RXN , and SMILES formats making it flexible enough to be included with both new and legacy data, without the need for conversion.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
BIOLOGICAL
BioAssay, BioViz,
BioAssay effectively manages data from complex biological assays involved with lead optimization BioViz provides a flexible reporting and plotting engine for your scientific data BioViz integrates with BioSAR for one step indepth data analysis from a BioSAR report
BioAssay Workgroup, intended for single site deployment, uses SQL Server as a database, instead of Oracle. This solution offers affordability and ease of maintenance, but still remains a robust solution suitable for a smaller groups needs. Organize and share your biological screening data with minimal administrative costs. BioAssay Ultra is designed to deliver much of the functionality of our enterprise level applications, without a widespread roll out. MSDE database compatible, BioAssay Ultra, coupled with BioViz, offers a user friendly interface for importing, viewing, validating, and plotting your biological assay data from your desktop.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
BIOLOGICAL
BioAssay, BioViz,
working closely with users. The result is a SAR application that is as intuitive as it is powerful. Security within BioSAR Enterprise is highly granular. Different roles exist for administrators, publishers, and browsers. Administrators may add assays to the data catalog engine, publishers may create reports and publish them, and browsers may use data query and analysis. Most data mining tools provide a mechanism to store queries, but the interface for creating queries is too complex. With BioSAR, each set of assays is a complete report with a query form, a view form, and a table view, combining the convenience of a ChemFinder or ISIS application with the power and flexibility of a data catalog-driven mining program.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
I N F O R M AT I C S
info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP
ChemDraw, Chem3D,
ChemDraws improved Struct<=>Name feature produces names for more types of compounds Live ChemDraw window embedded in Chem3D application allows simultaneous 2D and 3D editing Chem3D brings workstation-quality molecular graphics and rigorous computational methods to your desktop
ChemDraw/Excel allows the user to create chemically knowledgeable spreadsheets within the familiar Microsoft Excel environment. You can build and manipulate chemical structures within Excel, compute chemical properties and perform database searches. ChemNMR can be used to accurately estimate 13C and 1H (proton) chemical shifts. The molecule and the spectrum appear in a new window. The chemical shifts are displayed on the molecule and the spectrum is linked to the structure so that clicking on a peak in the spectrum highlights the related fragment on the molecule.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E
It can also be used to predict a number of chemical and physical properties. Chem3D contains an interface to the MOPAC package. Gaussian is a collection of semi-empirical and ab initio molecular orbital (MO) computational methods which can be used to predict energies, molecular structures, molecular properties, as well as molecular spectra. Chem3D enables the user to transparently create input and analyze output resulting from Gaussian.
Molecular Modeling
Estimate Spectra
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP
ChemDraw, Chem3D,
ChemFinder offers improved searching and hitlist management, along with new property generation ChemFinder is tightly integrated with CambridgeSofts Oracle Cartridge Search ChemACX and other CambridgeSoft databases for important chemical information
The Merck Index is an encyclopedia of chemicals, drugs and biologicals, with over 10,000 monographs covering names, synonyms, physical properties, preparations, patents, literature references, therapeutic uses and more. ChemACX Database includes 500,000 chemical products from nearly 400 supplier catalogs, searchable with a single query by structure, substructure, name, synonym, partial name, and other text and numeric criteria. ChemSCX is a compilation of searchable catalogs from leading screening compound suppliers. ChemMSDX Database provides material safety data sheets for 7,000 pure compounds. ChemINDEX Database includes 100,000 chemicals, public NCI compounds, AIDS data, and more.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP
the standard presentation and word processing software on the market. Common pathway elements such as membranes, enzymes, receptors, DNA and reaction arrows are built into the BioDraw toolbar and including them in your document is as easy as including a rectangle. Click on the toolbar shortcut and drop the element into your document. Resize and move elements by clicking and dragging and create an accurate and concise drawing in minutes. BioDraw allows the import of images in GIF , PNG or JPEG format. ChemDraw users are also able to include ChemDraw structures in drawings without difficulty. Keeping data organized is of utmost importance in any lab. The BioDraw application reflects that importance by allowing you to store annotations for each
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E
Notebook Pages
Data Visualization
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
DESKTOP
able. The application includes a number of specially designed inventory search forms. Search results are returned in list form and can be exported into a document (PDF , RTF , HTML ) using the report engine. The Inventory interface allows for printing labels as well as generating elaborate reports. Inventory uses a report application that incorporates wizards that allow for the quick creation of simple report and label templates that can be shared across an organization. Inventory Pro Inventory Pro contains the same features as Inventory Ultra without the ChemACX Database. E-Notebook Ultra E-Notebook Ultra is the efficient, accurate way to write lab notebooks entries as you work. It stores
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
S O F T WA R E
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SCIENTIFIC
The Merck Index offers encyclopedic reference for over 10,000 chemicals, drugs and biological agents Traditional Chinese Medicines provides chemical information and their biological effects of complex compounds isolated from natural sources All electronic databases are updated, contain information unavailable in print, and are searchable by structure, as well as text and numeric range
of the compounds, effects and indications of the medicines, English, Latin, and Chinese names for the natural sources, and over 2,000 references. This information is also available as an SD file to facilitate in silico research. ChemINDEX The ability to quickly look up data such as chemical properties, biological assay results and toxicological information is no longer a luxury item, but instead a requirement. Scientists have used the award-winning ChemFinder.Com database since 1995. Now, the data on ChemFinder.Com is integrated into ChemOffice as ChemINDEX. ChemINDEX contains data on over 75,000 compounds including structures, names and synonyms, physical properties, and Internet links.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
D ATA B A S E S
ChemReact68 ChemReact68, from InfoChem GmbH, is a database of sample reactions comprising essential information on 68,000 reactions. These reactions have been selected because they have greater than 50% yield and have appeared in more than five example reactions. The database consists of reaction information and literature references.
Scientific Databases
REFERENCE DATA
The Merck Index Traditional Chinese Medicines ChemINDEX Database NCI, AIDS & Cancer Drugs: Synonyms & Properties Medicinal Chemistry
SOURCING & SAFETY DATA
11,000 monographs 10,000 substances 75,000 substances 270,000 substances 8,000 drugs 540,000 substances 380 catalogs 23,000 MSDSs 130,000 MSDSs 28,000 reactions 178,000 reactions 68,000 reactions
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
PROFESSIONAL
Development, Deployment,
Custom Development and System Deployment
With custom development, CambridgeSoft works collaboratively with your team to create a system that meets your needs while executing our quality driven software development process. We deliver what you need, on time and within budget, without surprises.
In order to provide our customers with a total solution for scientific informatics, CambridgeSoft offers the following services to assist our clients in maximizing the productivity of their research and discovery organizations. Informatics Planning
Strategic and Operational Planning
A formal analysis is conducted to provide a roadmap for successful technology utilization. This process includes: An analysis of the current state of the science technology environment, including architecture and operational processes A view of the strategic goals and the barriers to achievement The delivery of a phased technology transition plan
Requirements Analysis & Proof of Concept
Is your project set up for success? Is it well defined into measurable deliverables? Are the roles of project members clearly defined? CambridgeSofts Project Readiness Assessment has one goal in mind to create or assess current plans and make recommendations to ensure that results are achieved.
21CFR11 Compliance
CambridgeSoft consultants can create or refine requirements to produce an environment that will ensure success. With years of experience meeting the needs of the scientific community, CambridgeSoft understands the user. The prototyping process allows definition and testing of the functional and technical feasibility of potential technology solutions. The process provides a baseline for the future development and deployment of a tailored solution. Users gain valuable first hand knowledge in experiencing how the system can help achieve individual and workgroup goals.
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800
Successfully implemented, a traceable and usable system is essential to any organization involved in the creation and management of data in a regulated environment. As an integral part in creating 21CFR11 and GxP validated applications, CambridgeSoft offers services to: Audit the software and process Create conforming systems design specifications Generate test plans and validation matrices Insure systems compliance with functional guidelines
EMAIL WWW
info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SERVICES
When developing a new system, the process of converting existing data and creating interfaces with other data systems is an essential part of the process. CambridgeSofts professional services staff is equipped to seamlessly incorporate existing data into the development of a new enterprise system. Organizations will be able to capitalize on historical scientific data while setting the platform for future success.
Custom Development
CambridgeSoft will install and configure applications to meet the needs of your user community. For unique environments, we build custom installers that allow us to productively deploy software across an enterprise.
DEVELOPMENT Data Integration DEPLOYMENT Installation & Configuration Systems Optimization Pre-Release Programs Software Evaluations Training Services MANAGEMENT Managed Informatics
You have discovered a unique application need in your organization, but cannot find a solution that will meet your functionality or cost requirements. With custom development, CambridgeSoft works collaboratively with your team to create a system that meets your needs, while executing our quality driven software development process. We deliver what you need, on time and within budget, without surprises.
Systems Integration
PLANNING Strategic/Op Planning Requirements Analysis Proof of Concept Project Readiness 21CFR11 Compliance
The ability to integrate core applications with other systems in the technology environment is a competency required to deliver the functionality of a new application.
Product Tailoring
Systems Integration
Technical Support
Your organization can see the benefit from implementing a CambridgeSoft application,
All specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP
Product Tailoring
EMAIL WWW
info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
PROFESSIONAL
Development, Deployment,
Custom Development and System Deployment
Managed Informatics allows your organization to focus on science, allowing CambridgeSoft to plan, implement and manage your technology environment. Systems Optimization
CambridgeSofts systems deployment team will work with you to make sure that your computing environment has been optimized for high performance. Your systems, networks, applications and databases are assessed and designed to deliver maximum achievement.
Beta and Pre-Release Programs
CambridgeSoft is committed to maximizing your productivity through the use of our products, as well as exposing you to the newest technologies. Our beta and pre-release programs provide you with that knowledge, allowing CambridgeSoft to improve applications with your customer feedback.
Pilot Software Evaluations
sional services staff supporting your systems environment On-site formal classroom training Webinars for multi-location instruction Off-site at CambridgeSoft facilities Systems Management
Managed Informatics
It often makes sense to pilot an application before a major commitment for an enterprise wide implementation is made. CambridgeSoft will work closely with you to plan the evaluation, deploy the application, and gather critical feedback regarding systems design, APIs and technology specifications.
Training
Effective user, administrator and help desk training is often an afterthought in many systems deployments. However, the productivity returns generated by an investment in systems training can provide dramatic returns. CambridgeSoft offers training in the following ways: On-site real time training through our profesAll specifications subject to change without notice.
US EU 1 800 3157300 00 800 875 20000 INTL 1 617 5889300 UK +44 1223 464900 FAX JP 1 617 5889390 0120 731 800
There is no longer a need to worry about licensing fees, maintenance contracts, systems administration work or database support. Informatics Outsourcing provides the people, processes and technology to develop a unique level of service for your organization. For a monthly fee, CambridgeSoft will deliver the informatics applications and the technology staff required to maximize productivity. This service allows your organization to focus on science, while CambridgeSoft plans, implements and manages your technology environment.
Ultra Services
The Ultra Services program is CambridgeSofts personalized, premium service for supporting our
EMAIL WWW
info@cambridgesoft.com www.cambridgesoft.com
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
SERVICES
To complete our Management Services offerings, Technical Support and Remote DBA Services, for Oracle and SQL Server, are also available.
MAIL CambridgeSoft Corporation 100 CambridgePark Drive Cambridge, Massachusetts 02140 USA ChemOffice, ChemDraw, Chem3D, ChemFinder & ChemInfo are trademarks of CambridgeSoft Corporation 2005
Desktop
E-Notebook Enterprise
CombiChem Enterprise
Inventory Enterprise
Registration Enterprise
DocManager Enterprise
ChemACX Database
21CFR11 Compliance
GxP Validation
Enterprise
BioSAR Enterprise
Sigma-Aldrich MSDS
Scientific Databases
www.cambridgesoft.com
00 800 875 20000 0120 731 800
info@cambridgesoft.com
+44 1223 464900 +49 69 2222 2280 +33 1 70 71 98 80
www.cambridgesoft.com/services/mail
USER INFORMATION (Please Print Legibly)
Name Title Firm Street City Country Tel Email Fax State Zip
support@cambridgesoft.com 1 617 5889360 CambridgeSoft, 100 CambridgePark Dr. Cambridge, MA 02140 USA
SYSTEM CONFIGURATION
SOFTWARE
Application Name Please cut here or photocopy page. Version Number Serial Number
SYSTEM
Windows (version) MacOs (version) Web Browser(s) (version)
US 1 617 588-9300 FAX 1 617 5889390 WWW EU 00 800 875 20000 FAX +44 1223 464990 EMAIL MAIL 100 CambridgePark Drive Cambridge, MA 02140 USA
www.cambridgesoft.com info@cambridgesoft.com
ChemBioOfce.Com
CS BioAssay
for Windows
SCREEN ELEMENTS
Quick Reference
Protocols Protocol Folders Project Protocol Compound Lists Plate settings; Define Picklists
LOGGING IN
Server Name where BioAssay database is located Login information Database file
Filter or reload the data Plate and multi plate tabview the plates in this table in the plate viewer
Make this window the active window Graph tab-select a graph template to plot the data in the table
DEFINITIONS TAB
Tables and fields which define the data tables in your protocol Details about the highlighted entity Templates which define how data is imported into the data tables from a file
ChemBioOfce.Com
CS ChemInfo
for Windows
Main Tool Bar
Quick Reference
Status Bar
Table View
TOOLBARS
New Save Copy Undo Print Layout Mode Switch Views First Record Go To Last Record Record Undo Changes Delete Record
Open
Cut
Paste
Redo
About ChemFinder
Layout Tool
Previous Record
Next Record
Commit Changes
Omit Record
Find Current Save Current Hit List Restore Previous List Molecule
Find List Restore Saved Over Current List Retrieve All Records Hit List Display Previous Record
CHEMINFO DATABASES
ChemINDEX contains compound reference databases including structures, physical constants and synonyms. ChemRXN contains reaction reference databases indexed from the literature. ChemACX contains available chemicals data from the worlds leading chemical catalogs. ChemMSDX contains a collection of materials safety datasheets. NCI contains the National Cancer Institute database of potential screening compounds. AIDS contains a library of potential HIV screening compounds provided by the National Cancer Institute.
To Perform a Combined Search 1. Enter information in more than one eld. The search is assumed to be a Boolean AND search. 2. Use raw SQL to perform and OR or NOT Boolean search. To Browse 1. Use Record Tools toolbar or Record menu to navigate forward or backward by one record at a time or to go to the beginning or end of the database. To View Records as a Table 1. From the View menu, choose Data Table. 2. Sort elds by clicking on a column heading. To View a Structure as a 3D Model in Chem3D 1. Right-click over a structure databox. 2. From the Context menu, choose View Model. 3. Use the tools in Chem3D to manipulate the model.
Clear active form for entering search query. Execute search query. Stop current search. Display previous search query. Select current molecule as the structure in a search query. Restrict structural query to an exact match. Save current query results to a le. Retrieve stored list of query results for current database. Restore hit list before last search. Specify preferences for how searches are performed and results are displayed. Search current hit list. Restore all records in the opened database back into the active form. Search for the current structure according to the restrictions chosen below. Restrict structural query to a substructure match.
C H E M D R AW S C R E E N E L E M E N T S
Application Control-menu Menu bar Title bar Magnification Control Minimize button Maximize button Close box Tool bar Scroll box Tools palette Rotation handle Vertical scroll bar Resize handle Drawing area Document window Selection rectangle Resize handle Text box Application window
Status bar
Scroll arrow
TOOLS PALETTE
Lasso Structure Perspective Solid Multiple Dashed Marquee Mass Fragmentation Eraser Text Pen Arrows Orbitals Drawing Elements Brackets Chemical Symbols Query Tools TLC Plate Templates Cyclobutane Cyclohexane Cyclooctane Cyclohexane Chair (2) Benzene
Bond Tools
Hashed Hashed Wedged Bold Bold Wedged Hollow Wedged Wavy Table Acyclic Chain Cyclopropane
Ring Tools
Heres how
Drag to draw the bond. Click an atom or drag from an atom. Double-click an atom (triple-click to repeat last label). Click an atom (double-click to repeat last label). Point at an atom and press a HotKey (e.g., c). Drag over a single bond using a bond tool. Drag over a double bond using a bond tool. Click center of a multiple bond. Click center of double bond using any bond tool. Click center of double bond using different bond tool. SHIFT+drag an atom using a bond or selection tool. Click center of bond using different bond tool. Double-click center of bond you want forward. Click or drag using a Ring tool. Click or drag from an atom using a Ring tool. Click a bond using a Ring tool. SHIFT+drag starting point of object (e.g., arrowhead). Choose from the Arrows palette and drag tail to head. Select All. Choose Map Reaction Atoms (Structure menu). Click Reaction Atom-Atom Map tool. Drag atom to atom. Select All. Choose Clear Mapping (Structure menu). Use Wedged and Hashed bond tools. Select atoms. Choose Atom Properties (Structure menu.) Select bonds. Choose Atom Properties (Structure menu.) Draw reaction arrow in front of query structure. Draw reaction arrow following query structure. Draw arrows before and after query structure.
Use inequality operators < and >. Put an equals sign = in front of value. Use Boolean operators OR and AND. Select subform, choose Enter Query, search as usual. Begin query with backslash \ and use SQL syntax.
ChemACX for chemists, BioAssay, BioViz and BioDraw for biologists, and Inventory, E-Notebook and The Merck Index.
Knowledge Management with E-Notebook, including Reaction Explorer, CombiChem, E-Signatures for intellectual property
protection and 21CFR11 Compliance, streamlines daily record-keeping with rigorous security and efficient archiving.
Chemical Informatics, including Registration, organizes new compound information. Inventory provides complete management of
chemical and biological inventories including GxP Validation. DocManager indexes chemical structures in documents.
BioIogical Informatics scientists use BioAssay, BioViz, BioSAR and BioDraw to set up biological models and visualize
information, generate spreadsheets correlating structure and activity, search by structure, and draw and annotate pathways.
Scientific Databases include the ChemACX Database of commercially available chemicals and Sigma-Aldrich MSDS.
The Merck Index and other scientific databases provide information about chemicals, their properties, and reactions.
Professional Services includes custom development, system deployment, educational training, and technical support for
pharmaceutical, biotechnology, and chemical customers, including government and academia, by experienced staff.
Web America Europe Japan
MAE 09156 0512
www.cambridgesoft.com
1 800 3157300 00 800 875 20000 0120 731 800
info@cambridgesoft.com
+44 1223 464900 +49 69 2222 2280 +33 1 70 71 98 80