CTMS Fundamentals - Duke Clinical Research Institute
Transcription
CTMS Fundamentals - Duke Clinical Research Institute
July 2014 CTMS Fundamentals User Reference Guide IT Training Trademarks Acrobat and Adobe are registered trademarks of Adobe Systems Incorporated. Cognos is a registered trademark of Cognos, Incorporated. Google is a trademark of Google Incorporated. Microsoft is a registered trademark of Microsoft Corporation. Siebel is a registered trademark of Siebel Systems, Incorporated. All other product names and services used throughout this document are trademarks or registered trademarks of their respective companies. The product names and services are used throughout this document in editorial fashion only and for the benefit of such companies. No such use, or the use of any trade name, is intended to convey endorsement or other affiliation with the document. Copyright Notice Copyright © 2014 by Information Technology Training & Documentation at Duke Clinical Research Institute. All rights reserved. Printed in the United States of America. This publication, or any part thereof, may not be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, storage in an information retrieval system, or otherwise, without the prior written permission of Duke Clinical Research Institute. Version Revision Level 19 published July 2014 CTMS Fundamentals ║ iii Contents Reference Guide Conventions.............................................. v What You Need to Know Before Using This Reference Guide....................v Visual Aids Used in This Reference Guide...................................................v Overview................................................................................. 7 Protocol Setup Process..................................................................................8 Getting Help..................................................................................................9 CTMS Learning Center..........................................................................9 CTMS Support........................................................................................9 Terminology..................................................................................................9 Logging in to the CTMS.............................................................................10 Technical Setup.....................................................................................10 Logging In............................................................................................10 User Access.................................................................................................13 User Preferences.........................................................................................14 Completing Your Profile.......................................................................14 Customizing the Layout of the Tabs.....................................................15 Saving Changes in the CTMS.....................................................................16 Logging Out of the CTMS..........................................................................16 Accessing the CTMS via Citrix and Accessing the CTMS Training Environment................................................................................................17 Navigating Within the CTMS................................................ 19 CTMS Home Tab........................................................................................19 Other CTMS Pages.....................................................................................21 Screen Tabs.................................................................................................23 Site Map......................................................................................................25 Navigation Tips...........................................................................................26 Rev. 9 - July 2014 iv ║ CTMS Fundamentals Query Basics........................................................................ 29 Running a Query.........................................................................................29 Using the Query Assistant...........................................................................30 Searching for Multiple Criteria in One Field..............................................32 Refine a Query............................................................................................32 Saving a Query............................................................................................33 Delete a Saved Query..................................................................................34 Query Tips...................................................................................................34 Query Operators..........................................................................................35 Operator Scenarios and Examples........................................................35 Running Reports and Exporting Data................................ 37 Standard CTMS Reports.............................................................................37 Running a Report........................................................................................37 Printing or Saving Report in PDF Format............................................39 Printing or Saving Report in Excel Format..........................................40 Emailing Report in HTML Format.......................................................41 Exporting Data to Microsoft Excel.............................................................43 Appendix A: Technical Setup.............................................. 45 Enabling CTMS Pop-up Windows..............................................................46 Option 1: Enabling Pop-up Windows Ahead of Time..........................46 Option 2: Enabling Pop-up Windows When Notified..........................47 Updating the Trusted Sites..........................................................................48 Disabling “Reuse Windows” Setting (IE6 and Earlier)..............................49 Option 1: Disabling Reuse Windows Ahead of Time...........................50 Option 2: Disabling Reuse Windows When Notified...........................50 Hiding an Internet Search Toolbar..............................................................51 Updating the Siebel Java Plug-in................................................................52 Appendix B: CTMS Access Form........................................ 55 Rev. 9 - July 2014 CTMS Fundamentals ║ v Reference Guide Conventions What You Need to Know Before Using This Reference Guide To gain maximum benefit from the material presented in this reference guide and the associated training course, you should have a working knowledge of personal computers (PCs), Microsoft Windows, and the DCRI network. If you need training in any of these areas, send an email message to IT Training (at [email protected]) requesting assistance. Visual Aids Used in This Reference Guide This reference guide uses the following visual aids to indicate notes, tips, and warnings. Note: The note icon indicates a clarification or supplemental information. Content that is too extensive for a note appears inside a shaded box instead. Read a note or a shaded box if you want to learn more about a particular step or procedure. Tip: The tip icon indicates a helpful hint or keyboard shortcut. Read a tip if you want to learn a quicker or easier way to perform a particular step or procedure. Warning: The warning icon indicates that performing a particular step or procedure under the stated conditions causes a significant problem or concern. Always read warnings. Rev. 9 - July 2014 vi ║ CTMS Fundamentals Rev. 9 - July 2014 CTMS Fundamentals ║ 7 Overview D CRI’s Clinical Trial Management System (CTMS) serves as a central data repository for storing and managing trial management and site information. The application, Siebel eClinical (Oracle), has been customized to accommodate DCRI-specific needs, and enables you to: ♦♦ Maintain contact information for each site in the protocol, including the roles of site personnel. ♦♦ Track each site’s progress through the course of the protocol. ♦♦ Track the status of all essential documents that each site must submit to participate in the protocol, thereby ensuring that each site complies with FDA regulations and sponsor requirements. ♦♦ Log correspondence with sites as the protocol progresses. ♦♦ Run reports on information collected in the CTMS. ♦♦ Track site visits and generate Trip Reports that are submitted to sponsors, capturing detailed monitoring activities. ♦♦ Review and/or maintain enrollment data for each site. To gain access to the CTMS: ♦♦ You must attend the appropriate CTMS classes: –– CTMS Fundamentals (required for all CTMS users) –– CTMS Site Management or CTMS Site Monitoring, or both (depending on your role) ♦♦ Your supervisor (i.e., your Lead) must submit a CTMS Access Form (see “Appendix B: CTMS Access Form” on page 55). Rev. 9 - July 2014 Notes 8 ║ CTMS Fundamentals Notes Protocol Setup Process All projects requiring DCRI site management or site monitoring services must be tracked in the CTMS. Before a new protocol is entered into the CTMS, a Protocol Setup meeting occurs, including the PL (Project Lead), Lead CRA (Clinical Research Associate), or other project designee, and a DCRI CTMS Business Support representative. In the meeting, members complete a Protocol Setup Requirements Form. Once the requirements have been finalized, the DCRI CTMS Business Support group configures, tests, and releases the protocol into the CTMS. Other protocol setup considerations include: ♦♦ Data Entry Guideline (DEG)—Protocol-specific outline of how data should be entered into the CTMS. ♦♦ Activity Plan(s)—Pre-defined, protocol specific list(s) of activities (e.g., milestones, documents, training events) that will be required for all sites. Activity Plans are defined by the PL or Lead CRA and are entered into the CTMS by a CTMS Administrator. A sample Activity Plan is provided prior to the Protocol Setup meeting. ♦♦ Site Management options—Examples include whether contracts will be tracked, whether protocol deviations will be tracked at the site level (if not using the CTMS Trip Report feature), and/or design of custom queries for the protocol team. ♦♦ Site Monitoring options—Examples include the addition of protocolspecific checklist items, design of custom Confirmation and Follow-Up letters, and/or whether the protocol requires blinding/unblinding of monitoring visits. ♦♦ System integrations—The CTMS can be programmed to communicate with other DCRI systems as needed per protocol. ♦♦ Non-DCRI personnel system access—Limited and/or read-only access to CTMS data can be provided to external users. ♦♦ Reporting—Custom reports can be designed to meet your protocol’s needs. Additional costs may be incurred. Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 9 Getting Help Notes It is a good idea to always check first with your protocol team members to resolve any CTMS-related questions or issues, as they may have knowledgeable answers that are specific to your protocol. CTMS Learning Center Information and resources are available on the CTMS Learning Center. Go to dcri.org, click Education/Training, and then click CTMS Learning Center. The direct URL is https://dcri.org/education-training/ctms-learning-center. Here you will find: ♦♦ CTMS training documentation and web-based training solutions ♦♦ Important CTMS forms and instructions ♦♦ CTMS Super User support details ♦♦ Templates and other helpful resources CTMS Support All CTMS requests for support should be directed to the DCRI Service Desk by phone (919.668.8916) or by email ([email protected]) Monday through Friday, 7 a.m. to 6 p.m., US Eastern time. For help outside normal operating hours, leave a voice message that includes your name, where and how you can be contacted, and a brief description of your problem. Your request will be forwarded to a CTMS support representative. For further general assistance, or to submit comments on IT Training’s CTMS classes, training modules, or documentation, email IT Training at [email protected]. Terminology Term Definition Account Facility, IRB, Other Contact Trial-related personnel Program Therapeutic Area Protocol Trial Site or Protocol Site Unique combination of Protocol + Account + PI Subject Patient Rev. 9 - July 2014 Overview 10 ║ CTMS Fundamentals Notes Logging in to the CTMS The same login procedures apply whether you are logging in to the CTMS from within the DCRI network or remotely. To access the CTMS remotely, you simply need to have an Internet connection. It is not necessary for you to be logged in to the DCRI network. Technical Setup Depending on your web browser settings, you might need to change one or more options to properly use the CTMS. Please refer to “Appendix A: Technical Setup” on page 45. Warning: If you are using IE 9 or higher, you must turn on Compatibility Mode in order to function properly. See step 3 below for details. Logging In 1 In the Internet Explorer address bar, enter http://ctms.dcri.duke.edu and then press Enter. 2 The CTMS login page appears. 3 IMPORTANT! Check to make sure Compatibility Mode is turned on. a Click the Compatibility View icon to the right of the URL. The icon will turn blue. b Close the browser window. NOTE: If the “Delete browsing history on exit” option is checked in your Internet Options, please uncheck it. c Launch IE again, and then navigate back to ctms.dcri.duke.edu. 4 In the User ID field, enter your current DCRI network ID. Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 11 5 In the Password field, enter your current DCRI network password. 6 Either click the arrow fields, or press Enter. Notes to the right of the User ID and Password Warning: When creating a new DCRI network password, do not use special characters (i.e., “&”), as they could interfere with CTMS functionality. 7 If the Security Alert window appears, click Yes. 8 If the Siebel Browser Check window appears (shown below), proceed to step 8. If the CTMS Home page appears (shown on next page), you are finished with this procedure. 9 If the Siebel Browser Check window appears, do the following: a Clear the Reuse windows for launching shortcuts checkbox. b Click the Please do not warn me again about recommended settings checkbox. c Click AutoFix. Rev. 9 - July 2014 Overview 12 ║ CTMS Fundamentals Notes d Click Run. e The following message appears. f Click Yes. The CTMS Home tab appears. You are finished with this procedure. Note: When you change your DCRI network password, your CTMS password is automatically synchronized. However, you might have to wait 5-15 minutes before you can use your new password in the CTMS. If you need to access the CTMS before your new password is active, use your old password. Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 13 User Access Notes CTMS users are assigned roles that define their job responsibilities and the corresponding data they can access. The following roles are defined in the CTMS: ♦♦ Assistant Director ♦♦ Clinical Data Integration ♦♦ Clinical Trial Assistant (CTA) ♦♦ Clinical Trial Manager ♦♦ CRA Non-Traveling ♦♦ CRA Traveling ♦♦ Lead CRA ♦♦ Project Lead Assistant ♦♦ Project Leader ♦♦ Project Office ♦♦ Site Start Up Specialist System administrators define these roles and determine what users can access. Therefore, the tabs you see after you log in to the CTMS might differ from the tabs other users in your trial team see. For information on requesting access to the CTMS, see “Appendix B: CTMS Access Form” on page 55. Rev. 9 - July 2014 Overview 14 ║ CTMS Fundamentals Notes User Preferences Go to the User Preferences screen to complete your profile, such as your phone number and email address, that will show on the site Internal Personnel view tab, and to change the order in which tabs appear on your CTMS screens. Changes that you make will affect your account only. Completing Your Profile 1 Click the User Preferences tab. Note: If you don’t see the User Preferences tab, click the Site Map button in the application toolbar. Then click the User Preferences blue hyperlink. The User Profile window opens. Note: If necessary, click the Profile hyperlink. 2 Complete the fields and then click Save. Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 15 Customizing the Layout of the Tabs Notes 1 Click the User Preferences tab. 2 Click Tab Layout. The screen Tab Layout screen appears. Do one of the following: To change the order screen tabs appear at the top of your CTMS window: a In the Order field, click the screen tab you want to appear first. Then enter 1. b Click the screen tab you want to appear second. Then enter 2. c Continue changing the numbers in the Order column until each screen tab has the appropriate order number. d Log out of the CTMS and then log back in to see your changes. OR To change the order view tabs appear on a particular screen tab: a Select a screen tab by clicking to the left of the tab name. b Scroll down to the View Tab Layout area to view the current view tab layout for the selected screen tab. c In the Order field, click the view tab you want to appear first. Then enter 1. d In the Order field click the view tab you want to appear second. Then enter 2. e Continue changing the numbers in the Order column until each view tab has the appropriate order number. f Log out of the CTMS and then log back in to see your changes. Rev. 9 - July 2014 Overview 16 ║ CTMS Fundamentals Notes Saving Changes in the CTMS To save any changes while working in the CTMS, do one of the following: ♦♦ Press Ctrl+S. ♦♦ Press Enter. ♦♦ Click in another field or area of the screen. This is referred to as “stepping off” the record. ♦♦ Press Tab until you have completed the row. Logging Out of the CTMS Do not close the browser window to log out of the CTMS, as this will leave the application running in the background and could pose a security risk. Instead, do one of the following: ♦♦ From the application-level menu bar, select File>Log Out. OR ♦♦ Press Ctrl+Shift+X. Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 17 Accessing the CTMS via Citrix and Accessing the CTMS Training Environment Notes If needed, you can access the CTMS by logging into the DCRI network remotely. Here you can also access the CTMS Training environment. 1 Go to Citrix (http://idcri.dcri.duke.edu) or FirePass (http://idcri2. dcri.duke.edu) and log into the DHE domain using your DCRI network ID and password. 2 In Citrix, click the Internet Browsers folder, and then open Internet Explorer OR In FirePass, click iDCRI Citrix Access, click the Internet Browsers folder, and then open Internet Explorer. 3 To access the CTMS, go to http://ctms.dcri.duke.edu. Log in with your DCRI user ID and password. OR To access the CTMS Training environment, go to http://ctms-trn. dcri.duke.edu. Log in with the user ID focus01 and password _______________________. Rev. 9 - July 2014 Overview 18 ║ CTMS Fundamentals Notes Overview Rev. 9 - July 2014 CTMS Fundamentals ║ 19 Navigating Within the CTMS S ince the CTMS is browser-based, getting from one screen to another is intuitive, especially after you become familiar with its basic navigation features. CTMS Home Tab When you first open the CTMS, the Home tab appears. The following picture shows features of the Home tab. The table below the picture describes these features. Application toolbar Query and search tools Browser toolbar Application menu bar Screen tabs Information panels Collapse and Hide tools Feature Description Browser toolbar Use Internet Explorer’s Back, History, and Favorites buttons to navigate within the CTMS application. Application menu bar Access the CTMS menus to perform actions within the application. Application toolbar Access shortcuts to Site Map and Reports. Screen tabs Click a tab at the top of the window to go to a specific screen. The tab for the active screen is highlighted (Home in the screen shot above). Rev. 9 - July 2014 Notes 20 ║ CTMS Fundamentals Notes Feature Description Query and search tools Select a predefined option from the drop-down list to run a query. Click the first magnifying glass to create a new query. Click the second magnifying glass to run the query again. For a text search, click the binoculars . Information panels My Alerts—Broadcast messages from CTMS Support. Helpful Links—Links to reference guides and other literature. 6 Months of My Outstanding Trip Reports— Trip Reports from the last 6 months with the status of Not Started, In Progress, or Submitted. This panel is only populated for users performing site monitoring activities. My Open Follow-ups—All open follow-up activities assigned to you. This panel is only populated for users performing site monitoring activities. Collapse and Hide tools Click the Collapse button to collapse a panel. To open the panel again, click the Expand button . Click the Hide button to remove the panel from the Home tab. To bring the panel back, click Edit Layout, click the Show button for the panel, and then click Done. Navigating Within the CTMS Rev. 9 - July 2014 CTMS Fundamentals ║ 21 Other CTMS Pages Notes The following picture shows the major navigation features of a CTMS page. The table that follows the picture describes these features and how to use them. Screen tabs Screen link Show More button Screen toolbar Screen View tabs View Drop-down for additional views Feature Description Screen tabs To go to a specific screen, click a tab in the top row of tabs. Screen information appears in a list, with each row representing one record. The tab for the active screen is highlighted. Screen links bar Click a hyperlink beneath the screen tabs to display specific information on the active screen. The links bar changes based on which screen is active. The hyperlink in bold type indicates what is currently displayed. Screen toolbar Click a shortcut button beneath the screen links bar to perform a task on the active screen. The toolbar changes based on which screen is active. Rev. 9 - July 2014 Navigating Within the CTMS 22 ║ CTMS Fundamentals Notes Navigating Within the CTMS Feature Description View tabs Click a tab on the bottom row of tabs to go to a specific view. The tab for the active view is highlighted. Drop-down for additional views Click the drop-down arrow to see additional views that are available for the current screen. Show More button Click the Show More button to display more records (rows) in the current screen or view. Rev. 9 - July 2014 CTMS Fundamentals ║ 23 Screen Tabs Notes The table below defines some commonly accessed screen tabs. If you do not see a screen tab, use the Site Map to locate it (see “Site Map” on page 25). Your role determines which screen tabs that you see when you log on to the CTMS (see “User Access” on page 13). Screen Tab Name Description Home Customizable window that gives snapshot views of items you can access. Click the Edit Layout button to change the views and layout on the Home tab. Protocols “Rolled-up” data, such as all site contacts for the protocols you can access. Regions “Rolled-up” data, such as total number of planned sites and total number of enrolled subjects per region, for defined regions you can access. Accounts Organizations or entities, such as sponsors, hospitals, clinics, vendors, partners, committees, labs, institutional review boards (IRB), or clinical research organizations (CRO). Contacts People related to the clinical research process. Typically, contacts are principal investigators, study coordinators, and other personnel who work at sites, such as sponsors and partners. Subjects Subjects (patients) in the CTMS. Depending on your trial, the subject list might be imported automatically into the CTMS, or you may have to add subjects manually. If necessary, you can also indicate which subjects are to be monitored. Rev. 9 - July 2014 Navigating Within the CTMS 24 ║ CTMS Fundamentals Notes Navigating Within the CTMS Screen Tab Name Description Site Management Sites for all protocols you can access. For each site, the view tabs at the bottom of the window enable you to work with site-specific details, such as site contacts and accounts, statuses and milestones, documents and training, and site visits. Site Visits Site visits for all protocols to which you have access. Provides “rolled-up” details, for example, showing all site visits across protocols. Also provides an alternative to the Site Management screen tab for locating site visit information. User Preferences User-specific profile details and view settings, enabling you to customize your CTMS window. For example, you can adjust the order screen tabs appear on the window. For more information on the User Preferences screen tab, see “User Preferences” on page 14. Rev. 9 - July 2014 CTMS Fundamentals ║ 25 Site Map Notes The CTMS Site Map is a textual index of the application’s screens and views. You can use the site map to navigate through the CTMS application. Site map button Screen links View and Subview links ►► To use the Site Map: 1 Click the Site Map button in the application toolbar. The Site Map window appears. 2 Click a blue hyperlink for the screen, view, or subview that you want to display. Rev. 9 - July 2014 Navigating Within the CTMS 26 ║ CTMS Fundamentals Notes Navigation Tips Some of the tips below represent changes that you can make to a CTMS view. The view maintains your changes after you log out and back in to the CTMS. Changes that you make do not affect other CTMS users’ views, only yours. Scroll bars. At times, you can see several scroll bars in one window —scroll bars for the active screen in the upper half of the window, scroll bars for the active view in the lower half of the window, and scroll bars for the entire window. (If you significantly reduce the size of the browser window, you can even see scroll bars for the Application Toolbar.) These bars enable you to read information and reach controls anywhere on the CTMS screen. Application toolbar scroll bar Window scroll bar Active screen/view scroll bar Window scroll bar Active screen/view scroll bar Column sorting. At any time, you can click a column heading to sort the window by that column. Changes that you make do not affect other CTMS users’ views. Advanced sorting. To sort by more than one column, select Menu>Advanced Sort. Select sort options for up to three columns and then click OK. Navigating Within the CTMS Rev. 9 - July 2014 CTMS Fundamentals ║ 27 Freezing columns in place. Double-click a column heading to freeze that column and all columns to the left of it. When you scroll to the right, those columns stay in place. To un-freeze the column(s), double-click the column heading. Notes Double-clicked Frozen columns Unfrozen columns Sizing columns. Point to the line between two column headings until your mouse pointer becomes a two-sided arrow . Click and drag to resize the column width. These adjustments will stay even after you log out and back in. Moving, hiding, and showing columns. You can move, hide, or show columns for any screen. These adjustments will stay even after you log out and back in. –– Drag columns to the right or left to rearrange them. –– On the screen links bar, select Menu>Columns Displayed to hide or show columns. Browser Back button. You can use your browser’s Back button at any time to return to a previous screen or view. Escape (Esc) key. When you begin to add new data, you must either complete all required fields or press the Esc key to get out of edit mode (no changes will be saved). ♦♦ You will see a message like the following if you try to go to another location while you are still in edit mode. ♦♦ Click OK, and then either complete all required fields or press Esc. Rev. 9 - July 2014 Navigating Within the CTMS 28 ║ CTMS Fundamentals Notes Type-ahead feature. To save time when entering data in a drop-down list field, enter the first few letters of an item in the list. When you press Tab, the CTMS will either automatically fill in the field (if there is only one match in the list) or will open the list with the first matching item highlighted. Bread crumbs. At the top of the CTMS window, a hyperlink displays your current location. You can click the links to go to a previously-viewed screen or view. Bread crumbs Refreshing the view. If you have changed a value in a field and the change is not displayed, refresh your view by clicking the Execute Query button at the top right of the CTMS window. Navigating Within the CTMS Rev. 9 - July 2014 CTMS Fundamentals ║ 29 Query Basics Q ueries enable you to search for and list only those records that meet certain criteria. For example, in the Site Management screen, you can run a query to show only sites located in a particular state. Running a Query 1 Go to the screen where you want to run the query. 2 Click the Query button. Query button A blank row appears. Blank row Go button 3 Click in the field(s) under the column heading(s), and enter the criteria for which you are searching. For example, enter a region name in the Region field. You can enter criteria in multiple fields. Tip: Use an asterisk (*) to represent missing characters when entering your search criteria. For example, to search for all last names that begin with Ma, enter Ma* in the Last Name field. See “Query Operators” on page 35 for more operators. Rev. 9 - July 2014 Notes 30 ║ CTMS Fundamentals Notes 4 Click Go. The query returns a list of records matching your criteria. Tip: If you ran a query and want to return to the entire list for that screen tab, click the screen tab again to view the default list of items. You can also run a blank query by selecting Query and then Go. Using the Query Assistant Some query windows also offer a Query Assistant button that provides help with creating a query. 1 Click Query. A blank row appears, along with the Query Assistant button. Blank row Query Assistant button 2 Click Query Assistant. The Query Assistant window appears. Query Basics Rev. 9 - July 2014 CTMS Fundamentals ║ 31 3 Create a query of up to four criteria items, using the drop-down lists to select query fields and conditions. Notes Example: To search for a list of sites located in NC, SC, and VA, follow these steps: a Click the first drop-down list to select Prov/State. b Click the second drop-down list to select Starts With. c Enter NC in the first blank text field. d Repeat steps a–c, entering SC and VA in the next two text fields. e From the Perform Query using drop-down list, select OR. 4 Click Go. The query returns a list of records matching your criteria. Rev. 9 - July 2014 Query Basics 32 ║ CTMS Fundamentals Notes Searching for Multiple Criteria in One Field Since the Query Assistant is limited to four search items at a time, use the following procedure to search for more items in the same field. 1 Click Query. 2 In the blank row, click in the field you want to query. For example, to create a state query, click in the Prov/State field. 3 Enter the criteria items in quotes (single or double), separated by an operator, such as OR. For example, you enter 'NC' OR 'SC' OR 'VA' OR 'GA' OR 'FL' to search for more than four states. 4 Click Go. 5 The query returns a list of records matching your criteria. For more information about query operators, see “Query Operators” on page 35. Refine a Query Each time you run a query, by default the CTMS searches the entire database. Use the refine query tool to further define an existing query result list. 1 After running a query, select Query>Refine Query. 2 Enter search criteria. 3 Click Run. The query searches only in the existing query result list and returns a list of records matching your criteria. Note: Refining a query does not save the new criteria to the original query. You must save the refined query with a new name and, if necessary, delete the original query. Query Basics Rev. 9 - July 2014 CTMS Fundamentals ║ 33 Saving a Query Notes Commonly used queries can be saved so that they are available from the Queries drop-down list at any time. Saved queries are specific to the screen tab that you are viewing and to your account only. If you would like others to be able to use your saved query, submit a CTMSR form to “publish” your saved query. For more information about the CTMSR form, see “Appendix B: CTMS Request Form” in IT Training’s CTMS Site Management Topics user reference guide. 1 After you run a query, select Query> Save Query As from the Application menu. The Save Query As window appears. 2 Enter a name for the query in the Query Name field. 3 Click OK. The query is saved and can be accessed, in alphabetical order, from the Queries drop-down list in the upper right corner of the window. Warning: Entering an asterisk (*) and a space before the query name could result in that query appearing first in the list, therefore replacing the default * My Sites query. This means that it will automatically run each time you return to the screen. Rev. 9 - July 2014 Query Basics 34 ║ CTMS Fundamentals Notes Delete a Saved Query 1 Select Query>Delete Saved Query. The Delete Record window appears. 2 Select the query that you want to delete. 3 Click OK. Query Tips ♦♦ Look for protocol-specific queries. Some protocol teams define queries that are most useful to the members of that team. Look for protocolspecific queries in the Queries drop-down list in the top right corner of the window for each screen tab. ♦♦ Use “*My Current” queries to locate current statuses. In the Queries drop-down list, queries starting with “*My Current” will return lists with that status as the current status. Otherwise, querying on the Status field will return records that have ever included that status. ♦♦ Use query operators to define your query. Common database operators can be used to define your query (see “Query Operators” on page 35). Query Basics Rev. 9 - July 2014 CTMS Fundamentals ║ 35 Query Operators Notes Query operators can further define your query by enabling you to expand or restrict the search results. The table below defines some of the most common operators that you can use when running a query in the CTMS. Operator Guidelines * (asterisk) Use before and/or after an entry to represent missing characters. OR Use to find various entries in a single field. AND Use to find multiple components in a single field. < > = Use to compare numbers in a field. TODAY Use in conjunction with <, >, and = operators to find entries in relation to the current date. IS NULL Use to find blank entries in a field. IS NOT NULL Use to find non-blank entries in a field. Operator Scenarios and Examples Note: Although the CTMS assumes an asterisk at the end of most entries and assumes that entries used with operators are values, it is good practice to use an asterisk and / or quotes when running a query. ♦♦ To find all records where the PI’s last name contains “mi” (such as Miller, Mills, and Smith), in the PI Last Name field (on the Site Management screen tab), enter *mi*. ♦♦ To search for a list of sites in North Carolina, South Carolina, and Virginia, in the Prov/State field (on the Site Management screen tab), enter 'NC' OR 'SC' OR 'VA'. ♦♦ To search for a list of sites in the USA-Southeast and USA-Southwest regions, in the Region field (on the Site Management screen tab) enter 'USA' AND 'south'. ♦♦ To search for a list of sites that have enrolled more than ten subjects, in the # Enrolled field (on the Site Management screen tab), enter >10. Rev. 9 - July 2014 Query Basics 36 ║ CTMS Fundamentals Notes ♦♦ To search for a list of sites for which the Regulatory Complete milestone date has not been recorded, in the Reg Complete field (on the Site Management screen tab), enter 'is null'. ♦♦ To find a list of site visits for January, 2009, in the Planned Visit Start Date field (on the Site Visits view tab), enter: > = 1/1/2009 AND < = 1/31/2009 ♦♦ To find upcoming site visits (visits scheduled to occur after today), in the Planned Visit Start Date field (on the Site Visits view tab), enter: > TODAY ( ) Notice the open/close parentheses at the end. ♦♦ You can find visits scheduled to occur after tomorrow by entering: > TODAY( ) + 1 This will increment one day for each day in the future after today. Query Basics Rev. 9 - July 2014 CTMS Fundamentals ║ 37 Running Reports and Exporting Data T he CTMS reporting tool enables you to generate standard CTMS reports that can be filtered for specific protocols, regions, and sites. At any time, you can also export a list of records to Excel for reporting purposes (see “Printing or Saving Report in Excel Format” on page 40). Standard CTMS Reports CTMS reports are generated using the Cognos application and are accessed via a CTMS viewer. Therefore, reports can be generated without leaving the CTMS application. To see samples of CTMS standard reports, go to the CTMS Support intranet website (Groups > Office – CTMS and EPM Support), and then click CTMS Standard Reports, located under the CTMS heading. Note: You can obtain a hard-copy list of all CTMS standard reports. Simply send an email request to [email protected]. Running a Report 1 Click the Reports screen tab. A list of CTMS standard reports appears. 2 Click a blue hyperlink for the report that you want to run. Rev. 9 - July 2014 Notes 38 ║ CTMS Fundamentals Notes 3 If a security message appears, click Yes. 4 When one or more filter windows appear, select the appropriate options from each filter window. You can also click Select all to select all choices in a list or Deselect all to clear your selection and start over. Tip: At any time, you can click the Back button at the bottom of the window to return to the previous step. Click Cancel to return to the list of reports. Filters Report description Report generation buttons 5 Click Next. 6 After making your filter selections, click Finish. Note: It is not necessary to select options from every filter. You can click Finish after choosing on option from your first filter. Running Reports and Viewing Metrics Rev. 9 - July 2014 CTMS Fundamentals ║ 39 Notes Most reports appear in HTML format in the CTMS window. Example of Report in HTML Format Printing or Saving Report in PDF Format After running a report (see “Running a Report” on page 37), you can view the report in PDF format to print, save, or email. 1 Click the View button window. in the top right corner of the report 2 Select View in PDF Format. 3 If the follwing window appears, click Open next to the report you want to see. Rev. 9 - July 2014 Running Reports and Viewing Metrics 40 ║ CTMS Fundamentals The report opens in a new tab within the browser, with the following controls available at the bottom of the window. Notes Do one of the following: ♦♦ To print the report, click the first button in the Acrobat toolbar. ♦♦ To save the report, click the second button toolbar. in the Acrobat Tip: To email the PDF, view the report in PDF format, click Keep this version > Email Report, and then follow the steps in “Emailing Report in HTML Format” on page 41. Printing or Saving Report in Excel Format After running a report (see “Running a Report” on page 37), you can view the report in Excel format to print or save. 1 Click the View button in the top right corner of the report window. 2 Select View in Excel Options > View in Excel 2007 Format. Note: For reports formatted to group data, such as the Site Status and Milestones report, select View in CSV Format. 4 A message appears asking if you want to close the tab. Click No. Running Reports and Viewing Metrics Rev. 9 - July 2014 CTMS Fundamentals ║ 41 5 The following message appears at the bottom of the window. Click Open. Notes The report opens in Excel 2010 in Protected View mode. This mode is automatically applied because the file is not originally in 2010 (*.xlsx) format. 6 To edit the file, click Enable Editing at the top of the Excel window. 7 Do one of the following: ♦♦ To print the report, select File>Print. ♦♦ To save the report, select File>Save as, and then select Excel 97-2003 Workbook or Excel Workbook from the Save as type drop-down list. ♦♦ When you close the report, you are returned to a blank tab. Close the blank tab to return to the CTMS tab. Emailing Report in HTML Format After running a report (see “Running a Report” on page 37), follow these steps to email an HTML copy. Warning: When you send a message from the CTMS, there is no record of this sent message in your email account. Also, the recipient receives the message from “[email protected]” instead of your name. For these reasons, we recommend you send an email from the CTMS to your own email account—then forward it to other recipients from your email account to save a copy to your Sent view for your records. Rev. 9 - July 2014 Running Reports and Viewing Metrics 42 ║ CTMS Fundamentals Notes 1 Click the Keep this version blue hyperlink in the top right corner of the report window. A drop-down list appears. 2 Select Email Report. An email window opens in the CTMS. 3 If your email address does not appear in the To field, add it. 4 (optional) Edit text in the Subject field and enter text in the Body area. 5 Important: clear the Include a link to the report checkbox and select the Attach the report checkbox. 6 Click OK. An HTML version of the report now appears in an email message to your email account. Forward the report to recipients using Outlook or Lotus Notes and save a copy to your Sent view for your records. Tip: To email the report as a PDF, follow the steps in “Printing or Saving Report in Excel Format” on page 40, and then click Keep this version > Email Report. Running Reports and Viewing Metrics Rev. 9 - July 2014 CTMS Fundamentals ║ 43 Exporting Data to Microsoft Excel Notes Any list of data in the CTMS can be exported to Excel for further formatting, editing, printing, or saving. You can only export data from a list (not from a form view). Tip: To limit the number of records that are exported to Excel, select specific rows by holding the Ctrl or Shift key while clicking on the rows that you want to export. The Ctrl key enables you to select non-consecutive rows, while the Shift key enables you to select a group of consecutive rows. 1 From the blue screen links bar, select Menu>Export. The Export window opens. Rev. 9 - July 2014 Running Reports and Viewing Metrics 44 ║ CTMS Fundamentals Notes 2 Leave all default options selected, and then click Next. The File Download window appears. 3 Click Open. The file opens in Excel. Example exported into Excel, for editing or saving to another location 4 Upon saving the file, click No if the following message appears. Running Reports and Viewing Metrics Rev. 9 - July 2014 CTMS Fundamentals ║ 45 Appendix A: Technical Setup Before you log in to the CTMS for the first time, verify or adjust the following settings in your Internet Explorer browser. These settings are required for proper functioning of the CTMS application. ♦♦ Enabling pop-up windows in Internet Explorer for the CTMS application (page 46). ♦♦ Updating the Trusted sites list in Internet Explorer (page 48). ♦♦ Disabling the Reuse Windows feature. (page 49). ♦♦ Hiding an Internet search toolbar, such as the Google toolbar (page 51). ♦♦ Updating the Siebel Java plug-in (page 52). Note: Field names and screen shots in this section pertain to Windows Internet Explorer 7. If you are using a non-DCRI computer and have a different IE release, adjust the settings as needed for the IE version in use. . Rev. 9 - July 2014 Notes 46 ║ CTMS Fundamentals Notes Enabling CTMS Pop-up Windows Most of the CTMS functionality is based on pop-up technology. A browser that blocks pop-ups for the CTMS site dramatically affects your ability to use the CTMS. For example, you will not be able to use the spell-check feature and other lookup tools. The following pages contain two procedures to support CTMS pop-up windows. Do one of the following: ♦♦ Before you open CTMS. See “Option 1: Enabling Pop-up Windows Ahead of Time” below. ♦♦ When you first log in to CTMS. See “Option 2: Enabling Pop-up Windows When Notified” on page 47. Option 1: Enabling Pop-up Windows Ahead of Time 1 In Windows Internet Explorer, select Tools>Internet Options. The Internet Options window opens. 2 Click the Privacy tab. 3 Verify that the Turn on Pop-up Blocker checkbox is selected. 4 Click the Settings button. The Pop-up Blocker Settings window appears. 5 Look in the Allowed Sites box. If *.dcri.duke.edu is not currently in the list, then enter that address into the Address of web site to allow field, and then click Add. Appendix A: Technical Setup Rev. 9 - July 2014 CTMS Fundamentals ║ 47 6 Click Close. Notes The Pop-up Blocker Settings window closes. 7 Click OK. The Internet Options window closes. Option 2: Enabling Pop-up Windows When Notified 1 Log in to the CTMS (see “Logging in to the CTMS” on page 10). If your pop-up blocker is turned on, a message appears. 2 Right-click the pop-up blocker message and then select Always Allow Pop-ups from This Site. The following message appears. 3 Click Yes. The CTMS Home screen appears. Rev. 9 - July 2014 Appendix A: Technical Setup 48 ║ CTMS Fundamentals Notes Updating the Trusted Sites When logging into the CTMS, you might receive a message telling you that the “following site contains secure and non-secure items.” Updating your Trusted Sites browser setting (steps 1-9, below) will eliminate this message from appearing. Follow steps 10-15 to assure that reports you generate from a non-DCRI location will generate properly. 1 From within Internet Explorer, select Tools>Internet Options. The Internet Options window opens. 2 Click the Security tab. 3 Click the Trusted sites icon. 4 Click Sites. The Trusted sites window appears. 5 In the Add this web site to the zone field, enter: https://ctms.dcri.duke.edu 6 Click Add. 7 In the same field, enter https://ctmsreports.dcri.duke.edu. 8 Click Add. The sites are added to the Websites list. 9 Click Close. The Internet Options window reappears. Appendix A: Technical Setup Rev. 9 - July 2014 CTMS Fundamentals ║ 49 10 Click Custom Level. Notes 11 Scroll to the Downloads area. 12 Select Enabled for the following options: ♦♦ Automatic prompting for file downloads ♦♦ File download ♦♦ Font download 13 Click OK. The Internet Options window reappears. 14 Click OK. The Internet Options window closes. Disabling “Reuse Windows” Setting (IE6 and Earlier) In release 7, Internet Explorer introduced the tabbing feature to open new webpages within the same IE window. If you use a version of Internet Explorer that is at release 6 or earlier (or decide to turn off the tabbing feature), then disable the reuse windows feature. If enabled, the reuse windows feature opens new webpages in an existing IE window, which can disrupt your CTMS sessions. Instead, disable the reuse windows feature so that you will not be interrupted during a CTMS session. You can disable the reuse windows feature either: ♦♦ Before you open CTMS. See the first procedure below. OR ♦♦ When CTMS notifies you the feature is currently enabled. See the second procedure below. Rev. 9 - July 2014 Appendix A: Technical Setup 50 ║ CTMS Fundamentals Notes Option 1: Disabling Reuse Windows Ahead of Time 1 Select Tools>Internet Options. The Internet Options window opens. 2 Click the Advanced tab. 3 Scroll down the list and clear the Reuse windows for launching shortcuts checkbox. 4 Click OK. The Internet Options window closes. Advanced tab, Internet Explorer 6 Option 2: Disabling Reuse Windows When Notified 1 Log in to the CTMS (see “Logging in to the CTMS” on page 10). If your reuse windows feature is enabled, the following message appears. 2 Clear the Reuse windows for launching shortcuts checkbox. 3 Select the Please do not warn me again about recommended settings checkbox. 4 Click AutoFix. Appendix A: Technical Setup Rev. 9 - July 2014 CTMS Fundamentals ║ 51 5 Click Run. Notes The following message appears. 6 Click Yes. The message closes and you proceed into the CTMS Home screen. Hiding an Internet Search Toolbar If you have added an Internet search toolbar—such as the Google or Ask search engine toolbar—to Internet Explorer, you must hide it so that it will not interfere with the functionality of the CTMS. 1 Right-click anywhere in your browser’s toolbar area. A context menu opens, listing the available components for this browser. A checkmark indicates a component that is currently in use. 2 Click the name of a search toobar (in the example to the right, the Google search engine). The menu and the associated toolbar closes. Note: The toolbar is only hidden: you can re-enable it—when you will not be accessing the CTMS—by repeating this procedure (clicking the search toolbar’s name reactivates it). Rev. 9 - July 2014 Appendix A: Technical Setup 52 ║ CTMS Fundamentals Notes Updating the Siebel Java Plug-in You might be prompted to update your Siebel Java plug-in the first time that you log in to the CTMS. Your windows might look different than the pictures shown in this example. 1 Log in to the CTMS (see “Logging in to the CTMS” on page 10). If you need to update your Siebel Java plug-in, the following message appears. 2 Important: Select the Always trust content from Siebel Systems, Inc. checkbox. 3 Click Yes. The following window appears. 4 Click Sun Java Runtime to select it. Appendix A: Technical Setup Rev. 9 - July 2014 CTMS Fundamentals ║ 53 5 Select the Please do not warn me again about recommended settings checkbox. Notes 6 Click Run. The following message appears, recognizing that you have made a change to the default settings. 7 Click Yes. Your Java application is updated and you view the CTMS Home screen. Rev. 9 - July 2014 Appendix A: Technical Setup 54 ║ CTMS Fundamentals Notes Appendix A: Technical Setup Rev. 9 - July 2014 CTMS Fundamentals ║ 55 Appendix B: CTMS Access Form Use the CTMS Access Form to request access to the CTMS for in-house and remote employees. The form must be completed by the Project Leader, Senior Lead CRA, or Lead CRA, and then submitted by email to the DCRI Service Desk ([email protected]). You will be notified when access has been granted. To access this form on the CTMS Learning Center, do one of the following: By links 1 Go to dcri.org > Education/Training > CTMS Learning Center 2 Click CTMS Access Form under Forms and Instructions. By address 1 In the address bar, enter the URL: https://dcri.org/education-training/ctms-learningcenter 2 Press Enter. 3 Click CTMS Access Form under Forms and Instructions. Rev. 9 - July 2014 Notes 56 ║ CTMS Fundamentals Appendix B: CTMS Access Form Rev. 9 - July 2014