TransCelerate eTemplate Installation Instructions



00Last Updated 06 Nov 201900Last Updated 06 Nov 2019Contents TOC \o "1-3" \h \z \u Introduction PAGEREF _Toc23949987 \h 2Prerequisites PAGEREF _Toc23949988 \h 3Microsoft Office 2007 PAGEREF _Toc23949989 \h 3Microsoft Office 2010/2013/2016/2019 PAGEREF _Toc23949990 \h 3CTS eTemplates Installers and Resources PAGEREF _Toc23949991 \h 3Unblock the Downloaded File PAGEREF _Toc23949992 \h 4CTS Prerequisites Analyzer PAGEREF _Toc23949993 \h 5Analyze CTS Prerequisites PAGEREF _Toc23949994 \h 6Test SharePoint Connection PAGEREF _Toc23949995 \h 7Installing Technology Components PAGEREF _Toc23949996 \h 10Upgrade from a Previous Version of the Add-ins PAGEREF _Toc23949997 \h 10Installing the CTS Intelligent Content Management (ICM) Add-In PAGEREF _Toc23949998 \h 10Installing CTS Intelligent Library Management (ILM) Add-In PAGEREF _Toc23949999 \h 12Verifying the Installation PAGEREF _Toc23950000 \h 13Installing TransCelerate eTemplates PAGEREF _Toc23950001 \h 15Installing TransCelerate eTemplates for Microsoft Office 2007/2010 PAGEREF _Toc23950002 \h 15Installing TransCelerate eTemplates for Microsoft Office 2013/2016/2019 PAGEREF _Toc23950003 \h 15Verifying the eTemplates Installation PAGEREF _Toc23950004 \h 18Uninstalling Technology Components PAGEREF _Toc23950005 \h 21Uninstalling CTS Intelligent Content Management (ICM) Add-In PAGEREF _Toc23950006 \h 21Uninstalling CTS Intelligent Library Management (ILM) Add-In PAGEREF _Toc23950007 \h 22Removing the CptLibraries Folder PAGEREF _Toc23950008 \h 23Troubleshooting PAGEREF _Toc23950009 \h 24Unable to Download Zip Files PAGEREF _Toc23950010 \h 24"There was an error during installation" Due to Untrusted Certificate or Location PAGEREF _Toc23950011 \h 24Description PAGEREF _Toc23950012 \h 24HRESULT E_FAIL Error PAGEREF _Toc23950013 \h 25Description PAGEREF _Toc23950014 \h 26Resolution PAGEREF _Toc23950015 \h 26IntroductionThis document describes the installation and uninstallation procedures for the technology components of TransCelerate Clinical Templates Suite (CTS) eTemplates, which include the mon Protocol Template (eCPT)Clinical Study Report (eCSR)Statistical Analysis Plan (eSAP)There are two ways you can use the TransCelerate eTemplates.Use the base template, without technology enablement, and accompanying components. If you choose to use the Microsoft Word template without technology enablement, please use the .docx file provided on the TransCelerate web site. You do not need to follow any instructions in this document.Use the technology-enabled template with CTS add-ins for Microsoft Word. If you want to leverage the technology enablement, please use the .dotx version of the eTemplates and follow the instructions in this document to install the templates and the technology components. Please ensure that your computer meets the prerequisites (p PAGEREF _Ref23763532 \h 3) before you install the technology components and templates.If you’re not sure if you meet the prerequisites, please contact your IT Helpdesk for support.PrerequisitesYour computer must meet certain prerequisites for you to use the technology components that accompany the technology-enabled versions of the templates (eTemplates). The prerequisites vary, depending on your version of Microsoft Office, and some require administrative privileges to install. Please contact your IT Helpdesk if you need help.Note: The December 2019 release of the TranCelerate eTemplates is not compatible with any Apple Operating system. However, users have successfully used the eTemplates in a virtual windows environment on Apple operating systems. Work with your local IT support to use this option.Microsoft Office 2007Microsoft Word 2007 Service Pack 3 (SP3)Microsoft .NET Framework v4.0 or higherWindows Installer 4.5Visual Studio Tools for Office Runtime (VSTO 4.0)Note: Because Microsoft Word 2007 has a low, and declining use rate and Microsoft ended support for Word 2007 on October 10, 2017, we do not test new CTS releases with Word 2007.Microsoft Office 2010/2013/2016/2019Microsoft Word 2010 Service Pack 1 (SP1) or Office 2013/2016/2019Microsoft .NET Framework v4.0 or higherVisual Studio Tools for Office Runtime (VSTO 4.0)CTS eTemplates Installers and ResourcesBefore you can use the REF _Ref23824813 \h \* MERGEFORMAT CTS Prerequisites Analyzer (p PAGEREF _Ref23824816 \h 5) or begin REF _Ref23794342 \h \* MERGEFORMAT Installing Technology Components (p PAGEREF _Ref23794342 \h 10) you must download to your local computer and extract the contents of the .zip archive that contains the installers, templates, and other resources for the technology components. You can download the archive from the Clinical Template Suite (CTS) assets section on the TransCelerate web site.Note: If you have trouble downloading the .zip archive, see REF _Ref23842146 \h \* MERGEFORMAT Unable to Download Zip Files (p PAGEREF _Ref23842146 \h 24).Unblock the Downloaded FileAfter you download the file, and before you extract it, ensure that the file is not blocked.Right-click on the file and select Properties.If Unblock is present, as shown in the screen shot below, select Unblock.Select OK.Right-click on the downloaded file and select Extract all… to extract the contents of the file.The following are the extracted files and folders.Add-ins Primary – This folder contains the installers for the add-ins that you are most likely to use.CTS.SCM.ICM_7_0_0_48.zip – This archive file that contains the installer files for the CTS Intelligent Content Management (ICM) add-in (p PAGEREF _Ref23825913 \h 10).CTS.SCM.ILM_7_0_0_23.zip – This archive file that contains the installer files for the CTS Intelligent Library Management (ILM) add-in (p PAGEREF _Ref23825906 \h 12).Add-ins SP Security Remediation – This folder contains the installers for the SharePoint security remediation versions of the add-ins (p PAGEREF _Ref23827141 \h 25).CTS.SCM.ICM_7_0_1_48.zip – This archive file contains the installer files for the SharePoint security remediation version of the CTS Intelligent Content Management (ICM) add-in.CTS.SCM.ILM_7_0_1_23.zip – This archive file contains the installer files for the SharePoint security remediation version of the CTS Intelligent Library Management (ILM) add-in.CPT_CoreTEE_v007.dotx – This Microsoft Word template files is the eTemplate for the Clinical Protocol Template (eCPT).CSR_CoreTEE_v002.dotx – This Microsoft Word template files is the eTemplate for the Clinical Statistics Report (eCSR).CTS_SCM.PrerequisiteAnalyzer_V003.zip – This archive file contains the application and required files for the REF _Ref23827535 \h \* MERGEFORMAT CTS Prerequisites Analyzer (p PAGEREF _Ref23827539 \h 5).eTemplates-Installation-Instructions_V007.docx – This Microsoft Word document contains information and procedures required to install the technology components and eTemplates.SAP_CoreTEE_v002.dotx – This Microsoft Word template files is the eTemplate for the Statistical Analysis Plan (eSAP).CTS Prerequisites AnalyzerThe CTS Prerequisites Analyzer helps you identify which versions of programs you have installed on your computer. In addition, you can use the analyzer to confirm which version of the CTS add-ins (Primary or SP Security Remediation) you need to install to successfully connect to SharePoint so you can access centrally stored libraries and instructional text files. Most users can use the Primary version. Due to changing security policies across the technology industry, some users with updated security profiles may require the SP Security Remediation version.Before you use the REF _Ref23828043 \h \* MERGEFORMAT CTS Prerequisites Analyzer (p PAGEREF _Ref23828052 \h 5), download to your computer the archive file that contains the CTS eTemplates installers and resources (p PAGEREF _Ref23828137 \h 3) and extract the contents of the CTS_SCM.PrerequisiteAnalyzer_V003.zip file, which contains the following.CPT.SCM.PrerequisiteAnalyzer.Contracts.dllCPT.SCM.PrerequisitesAnalyzer.exeCPT.SCM.PrerequisitesAnalyzer.exe.configGlobal.Office.SharePoint.Library.dllMicrosoft.SharePoint.Client.dllMicrosoft.SharePoint.Client.Runtime.dllThe screen shot below shows the files in a folder in Windows 10.Analyze CTS PrerequisitesFollow the steps below to analyze your computer for the CTS prerequisites.Double-click the file CPT.SCM.PrerequisitesAnalyzer.exe to run the CTS Prerequisites Analyzer.In the CTS Prerequisites Analyzer window click Analyze.The Status column appears. If your computer meets all the prerequisites, then the Status column displays a green check mark in each row. If a prerequisite is not met, then the Status column displays a red X . Before you begin the installation process, you need to install the necessary updates.Test SharePoint ConnectionBelow are the steps to test your SharePoint connection.Select Test SharePoint Connection to open the Test SharePoint Connection dialog.In the Test SharePoint Connection dialog go to Source and select the appropriate SharePoint connection type. Most users can user SharePoint Online. The SharePoint option is for users who are accessing SharePoint on-premises (see the TransCelerate eTemplates Guidance for Use for further details).Go to URL and enter the address for the SharePoint site that contains the content libraries and instructional text that you want to use.Select Connect.Note: If a dialog appears asking you to sign-on or pick an account, use the credentials appropriate for the SharePoint site to which you are attempting to connect.If the connection was successful, the bottom-left corner of the displays Connected.Select Libraries.Go to Instructional Text and select the name of the SharePoint library that contains instructional text. If you can see the list of SharePoint document libraries, then you successfully connected and can access the centrally stored libraries and instructional text files.If the connection was not successful, the bottom-left corner of the window displays Error.If you see an error message that says “Sorry, the connection to SharePoint was not successful due to a certificate issue” then you must install the SP Security Remediation version of the add-ins. Select Close to close the Test SharePoint Connection window.Select Close to close the CTS Prerequisites Analyzer window.Installing Technology ComponentsThe technology components are in the form of Microsoft Word add-ins. You must install two add-ins to leverage the functionality in the CTS eTemplates. This section describes the procedure for installing each add-in.Upgrade from a Previous Version of the Add-insBefore you upgrade to the latest release of the CTS eTemplates, you must uninstall any previously installed add-ins and delete the local CptLibraries folder. See REF _Ref23744692 \h \* MERGEFORMAT Uninstalling Technology Components (p PAGEREF _Ref23744692 \h 21) for details about this step. After you complete the uninstall, continue with the steps below.Installing the CTS Intelligent Content Management (ICM) Add-InBefore you install the CTS Intelligent Content Management (ICM) add-in, download to your computer and extract the archive file that contains the CTS eTemplates installers and resources (p PAGEREF _Ref23828137 \h 3) and extract the contents of the CTS.SCM.ICM_7_0_0_48.zip file, in the Add-ins Primary folder.Note: If you are installing the SharePoint security remediation version of the add-ins, extract the contents of the CTS.SCM.ICM_7_0_1_48.zip file, in the Add-ins SP Security Remediation folder.The extracted files and folders include the following.Application Files – This folder contains files the installer uses to install the add-in.CPT.SCM.ICM.vsto – This file contains information about the add-in.setup.exe – This file is the installer for the add-in.Follow the steps below to install the Intelligent Content Management (ICM) add-in.Open setup.exe and, when prompted, select Install to install the addin.Wait while the Microsoft Office Customization Installer displays the progress.When the Microsoft Office Customization Installer displays the message “The Microsoft Office customization was successfully installed.”, select Close.If you see an error message, please refer to REF _Ref425425200 \h \* MERGEFORMAT Troubleshooting section (p PAGEREF _Ref425425200 \h 24) or contact your IT Helpdesk for further support.Installing CTS Intelligent Library Management (ILM) Add-InBefore you install the CTS Intelligent Library Management (ILM) add-in, download to your computer and extract the archive file that contains the CTS eTemplates installers and resources (p PAGEREF _Ref23828137 \h 3) and extract the contents of the CTS.SCM.ILM_7_0_0_23.zip file, in the Add-ins Primary folder.Note: If you are installing the SharePoint security remediation version of the add-ins, extract the contents of the CTS.SCM.ILM_7_0_1_23.zip file, in the Add-ins SP Security Remediation folder.The extracted files and folders include the following.Application Files – This folder contains files the installer uses to install the add-in.CPT.SCM.LibraryMgmt.vsto – This file contains information about the add-in.setup.exe – This file is the installer for the add-in.Follow the steps below to install the Intelligent Library Management (ILM) add-in.Open setup.exe and, when prompted, select Install to install the addin.Wait while the Microsoft Office Customization Installer displays the progress.When the Microsoft Office Customization Installer displays the message “The Microsoft Office customization was successfully installed.”, select Close.If you see an error message, please refer to REF _Ref425425200 \h \* MERGEFORMAT Troubleshooting section (p PAGEREF _Ref425425200 \h 24) or contact your IT Helpdesk for further support.Verifying the InstallationYou can verify the installation by following the instructions below.Open Microsoft Word.Verify that the CTS tab is visible in the ribbon.When you select the CTS ribbon you should see the following commands.If you do not see the CTS tab, please contact your IT Helpdesk for further support.Installing TransCelerate eTemplatesThe TransCelerate templates are delivered in both .docx and .dotx formats. The .dotx files are Microsoft Word document template files that contain technology enablement in the form of content controls and are accompanied enabled by the CTS add-ins for Word. Please follow the instructions below for your version of Microsoft Office.Note: If you intend to use the .docx version of the TransCelerate templates, please do not refer to the instructions in this document.Installing TransCelerate eTemplates for Microsoft Office 2007/2010Please use the instructions below to configure the TransCelerate eTemplates for use in Word 2007 or 2010.Open Windows Explorer.Select the location box, type %AppData% and press Enter. Open the Microsoft folder.Open the Templates folder.Create a new folder named TransCelerate eTemplates.Copy from the extracted archive file to the TransCelerate eTemplates folder the following templates.The CPT_CoreTEE_v007.dotx template CSR_CoreTEE_v002.dotxThe SAP_CoreTEE_voo2.dotx templateClose the Windows Explorer window.Installing TransCelerate eTemplates for Microsoft Office 2013/2016/2019Please use the instructions below to configure the TransCelerate eTemplates for use in Word 2013/2016/2019.Open Windows Explorer.Select the location box, type %AppData% and press Enter.Create a new folder named TransCelerate eTemplates.Copy from the extracted archive file to the TransCelerate eTemplates folder the following templates.CPT_CoreTEE_v007.dotxCSR_CoreTEE_v002.dotxSAP_CoreTEE_v002.dotxCopy the path to the TransCelerate eTemplates folder.Close the Windows Explorer window.Open Microsoft Word.Select the File tab.Select Options.Select the Save section.Paste the copied path from step REF _Ref23847811 \r \h 5 in Default personal templates location box.In the Save Files in this format section, select the option Word Document (*.docx).249218819425020024921886784790028687167847900Select OK.Verifying the eTemplates InstallationOpen Microsoft Word.Select File > New.If you are using Word 2013/2016/2019, go to step 5.If you are using Word 2010, select My templates.Select CTS eTemplates.You should see available each of the templates you copied in step REF _Ref23848911 \r \h Error! Reference source not found. in REF _Ref23848932 \h \* MERGEFORMAT Installing TransCelerate eTemplates for Microsoft Office 2007/2010 ( p PAGEREF _Ref23848937 \h 15).Select the CPT_CoreTEE_v007 template and open a new document from the template.If you are using Word 2010, go to step 7.If you are using Word 2013/2016/2019, follow the steps below.Select Personal.Select the CPT_CoreTEE_v007 template and then select OK to create a new document from the template.In the CTS panel, select the Unpack library package (refresh) command.Select the Open CTS libraries folder command to open in Windows Explorer the folder that contains your local copy of the libraries and instructional text.Verify that the new library documents and associated XML files are present.Uninstalling Technology ComponentsThe sections below describe how to uninstall the Intelligent Content Management (ICM) add-in, uninstall the Intelligent Library Management (ILM) add-in, and remove the CptLibraries folder from your computer.Uninstalling CTS Intelligent Content Management (ICM) Add-InMake sure to close all your Word Instances before following the below steps.Go to Control Panel > Programs and Features.Select CTS Intelligent Content Management. (Or CPT Intelligent Content Management if uninstalling a pre-2019 version)Select Uninstall.When prompted select OK to uninstall the add-in.Uninstalling CTS Intelligent Library Management (ILM) Add-InMake sure to close all your Word Instances before following the below steps.Go to Control Panel > Programs and Features.Select CTS Intelligent Library Management. (Or CPT Intelligent Library Management if uninstalling a pre-2019 version)Select Uninstall.When prompted select OK to uninstall the add-in.Removing the CptLibraries FolderTo ensure that the built-in libraries content is updated when you upgrade from one version of the add-ins to another, you must remove the CptLibraries folder after you uninstall the previous version of the add-ins (p PAGEREF _Ref23744692 \h 21) and before you install the latest version of the add-ins (p PAGEREF _Ref23794342 \h 10). Follow the steps below to remove the CptLibraries folder.Go to your Documents folder on your computer. This folder may be named My Documents. If you have your My Documents folder redirected to OneDrive, you may have two folders named Documents in your user folder. The screen shot below shows an example of the path to the CptLibraries folder.Right-click on the CptLibraries folder and then select Delete.TroubleshootingThis section contains information about known issues that you might encounter, including how to work around or fix them.Unable to Download Zip FilesIf your organization does not allow you to download .zip files, your web browser may not respond or download the file. If this happens, use the following steps to work around this issue.Locate and download from the Clinical Template Suite (CTS) assets section on the TransCelerate web site the alternate file, CTS_eTemplates_2019Dec.tiz.Rename the file from CTS_eTemplates_2019Dec.tiz to CTS_eTemplates_2019Dec.zip."There was an error during installation" Due to Untrusted Certificate or LocationThis issue occurs when the add-In installer displays the following error message during the installation.DescriptionThis issue could be caused by several reasons. The two most common causes and resolutions are listed below.Cause #1The installation files are blocked by your organization’s security policy because they were downloaded from an untrusted Internet source.ResolutionLocate the installation ZIP file and unblock it by going into properties tab (right-click menu).Cause #2The installation files are blocked by your organization’s security policy because they are located on a network drive. Re-running the setup.exe should work now.ResolutionCopy the installation ZIP file to a local disk folder (e.g., C:\ or C:\TEMP) and unzip. Re-running the setup.exe should work now.HRESULT E_FAIL ErrorThe template displays the following error message upon opening word.Error HRESULT E_FAIL has been returned from a call to a COM component. DescriptionThis issue is caused by settings in Microsoft Word that are set to save the document format to .doc instead of .docx. To work properly, the CTS add-ins require the .docx format.ResolutionThis setting can be found in Word options. Go to File>Options>Save and for Save files in this format: select Word Document (*.docx). Create a new CTS document again. ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download