Integrity 10.4 Integrations User Guide - Norcraft …

1 Integrity user GuideJune, 2013 Integrity user GuideCopyright 2013 PTC Inc. and/or Its Subsidiary Companies. All Rights and training guides and related documentation from PTC Inc. and its subsidiary companies (collectively "PTC") are subject to the copyright laws of the United States and other countries and are provided under a license agreement that restricts copying, disclosure, and use of such documentation. PTC hereby grants to the licensed software user the right to make copies in printed form of this documentation if provided on software media, but only for internal/personal use and in accordance with the license agreement under which the applicable software is licensed. Any copy made shall include the PTC copyright notice and any other proprietary notice provided by PTC. Training materials may not be copied without the express written consent of PTC. This documentation may not be disclosed, transferred, modified, or reduced to any form, including electronic media, or transmitted or made publicly available by any means without the prior written consent of PTC and no authorization is granted to make copies for such described herein is furnished for general information only, is subject to change without notice, and should not be construed as a warranty or commitment by PTC.

2 PTC assumes no responsibility or liability for any errors or inaccuracies that may appear in this software described in this document is provided under written license agreement, contains valuable trade secrets and proprietary information, and is protected by the copyright laws of the United States and other countries. It may not be copied or distributed in any form or medium, disclosed to third parties, or used in any manner not provided for in the software licenses agreement except with written prior approval from USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVIL DAMAGES AND CRIMINAL PROSECUTION. PTC regards software piracy as the crime it is, and we view offenders accordingly. We do not tolerate the piracy of PTC software products, and we pursue (both civilly and criminally) those who do so using all legal means available, including public and private surveillance resources. As part of these efforts, PTC uses data monitoring and scouring technologies to obtain and transmit data on users of illegal copies of our software.

3 This data collection is not performed on users of legally licensed software from PTC and its authorized distributors. If you are using an illegal copy of our software and do not consent to the collection and transmission of such data (including to the United States), cease using the illegal version, and contact PTC to obtain a legally licensed Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright notice, of your PTC STATES GOVERNMENT RESTRICTED RIGHTS LEGENDThis document and the software described herein are Commercial Computer Documentation and Software, pursuant to FAR (a)-(b) (OCT 95) or DFARS (a) and (a) (JUN 95), and are provided to the US Government under a limited commercial license only. For procurements predating the above clauses, use, duplication, or disclosure by the Government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software Clause at DFARS (OCT 88) or Commercial Computer Software-Restricted Rights at FAR (c)(1)-(2) (JUN 87), as applicable.

4 01282013 PTC Inc., 140 Kendrick Street, Needham, MA 02494 USA ITable of Contents1 Introduction ..1 About This Guide .. 2 Roles .. 2 Assumptions .. 2 Integrity Integrations .. 3 Before You Begin .. 3 Configuring Integrations .. 3 Before Using an integration .. 5 Where To Go From Here .. 6 PART I: CODEGEAR2 CodeGear Delphi Architect ..8 Key Considerations.. 9 Configuring the CodeGear Delphi integration .. 9 Using the CodeGear Delphi integration .. 9 Delphi Architect Commit Browser .. 10 Creating an Integrity Project .. 11 Creating a Sandbox .. 11 Adding a Member to an Integrity Project .. 12 Checking Out Members .. 12 Checking In Members.. 123 CodeGear JBuilder ..14 PART II: IBM4 IBM Rational Eclipse Platform ..17 Overview .. 18 Supported Versions .. 18 Before You Start.. 18 Configuring the IBM Rational Eclipse integration .. 19 Enabling Access to Java API Libraries (Linux Only) .. 19 Enabling the integration .. 19 Setting Preferences.. 21 Deactivating the integration .

5 23 Using the integration .. 23 Online and Offline Mode .. 24 Setting Up an Integrated Workspace .. 25 Working in an Integrated Workspace.. 30 Integrity Commands .. 36 Refactoring .. 40 Comparing Revisions .. 41 Team Synchronizing .. 42 Best Practices .. 46 Limitations .. 475 IBM Rational Rose..49 Configuring the Rational Rose integration .. 50 Using the Rational Rose integration .. 50 IICreating an Integrity Project .. 51 Creating a Sandbox .. 51 Adding Members to an Integrity Project .. 51 Checking Out Members .. 52 Checking In Members.. 52 PART III: MICROSOFT6 Microsoft Visual Studio (SDK) ..54 Before You Start.. 55 Setting Up and Configuring the integration .. 56 Installing the Visual Studio integration .. 56 Enabling the Integrity Plug-In in Microsoft Visual Studio .. 57 Toggling the Integrity Toolbar.. 57 Setting Preferences.. 58 Working With Keywords .. 58 Configuring the Location of VS Solutions and Projectsin the Integrity Repository .. 59 Online and Offline Mode.

6 60 Working With Active Change Packages .. 61 Integrity Glyphs in Visual Studio .. 62 Managing Work In Progress .. 63 Managing Assigned Work .. 66 Placing Visual Studio Solutions Under Integrity Source Control .. 67 Sharing a Visual Studio Solution .. 67 Importing a Visual Studio Solution.. 70 Adding a Visual Studio Project to a Shared Solution .. 70 Dropping a Visual Studio Project From a Shared Solution.. 71 Importing a Visual Studio Project .. 72 Migrating a Visual Studio Solution from the MKS SCC VS integration .. 73 Ignoring Visual Studio Entities From Integrity Source Control .. 74 Branching a Visual Studio Solution.. 75 Resynchronizing a Visual Studio Solution.. 76 Reverting a Visual Studio Solution .. 76 Checkpointing a Visual Studio Solution.. 77 Viewing a Sandbox for a Visual Studio Solution .. 77 Working With Visual Studio Files .. 77 Adding Members to an Integrity Project .. 78 Dropping Members From an Integrity Project .. 78 Checking Out Members.

7 79 Checking In Members .. 79 Renaming Members.. 79 Moving Members .. 79 Advanced Integrity Commands .. 80 Best Practices .. 81 Limitations .. 83 Troubleshooting .. 847 Microsoft Visual Studio .NET ..86 Implementing the integration .. 87 Assumptions .. 87 Required Permissions .. 87 Implementing the New Project Structure.. 87 IIIS etting Up Projects to Reuse Code .. 88 Setting Preferences .. 90 Parallel Development Considerations .. 91 Optimistic Locking .. 91 Development Paths .. 92 Building Projects .. 93 Command Functionality .. 94 Adding a Solution to Integrity .. 96 Adding a New Project to Source Control .. 98 Joining Development of a Solution .. 98 Adding Members to an Integrity Project .. 99 Checking Out Members .. 100 Checking In Members .. 100 Troubleshooting .. 1018 Microsoft Visual Basic ..102 Using the Microsoft Visual Basic integration .. 103 Creating an Integrity Project .. 104 Creating a Sandbox .. 104 Adding Members to an Integrity Project.

8 104 Checking Out Members .. 105 Checking In Members.. 1059 Microsoft Visual C++..106 Configuring the Visual C++ integration .. 107 Using the Microsoft Visual C++ integration .. 107 Creating an Integrity Project .. 108 Creating a Sandbox .. 108 Adding Members to an Integrity Project .. 108 Checking Out Members .. 108 Checking In Members.. 10910 Microsoft Project ..110 Overview .. 111 Before You Start.. 111 Integrity Server Requirements .. 112 Client Requirements .. 112 integration Components .. 112 Assumptions .. 113 Key Considerations .. 113 Pre-installation Administration .. 114 Configuring the Integrity Server .. 114 Configuring Integrity .. 115 Setting Permissions .. 116 Modifying the integration XML Mapping Template .. 116 Installing the Microsoft Project integration .. 117 Repairing or Removing the integration .. 119 Microsoft Project Configuration .. 119 Integrity Custom Project Properties .. 119 Integrity Custom Project Fields .. 120 Enabling SSL Communication.

9 121 Using Microsoft Project Server and Enterprise Resources.. 121 Logging Configuration .. 122 Using the Microsoft Project integration .. 123 IVSpecifying Task Types.. 124 Setting Task Relationships .. 125 Synchronizing Resources .. 126 Synchronizing All Tasks .. 126 Synchronizing Tasks By Query .. 126 Synchronizing Linked Tasks .. 127 Synchronizing Selected Tasks .. 127 Detecting Conflicts.. 12811 Microsoft Word ..130 Assumptions .. 131 Overview of the integration .. 131 System Requirements .. 133 Configuring the Integrity Server.. 133 Installing and Uninstalling the integration .. 134 Customizing the Word integration .. 135 Customizing the DSD .. 136 Importing the DSD.. 138 Importing a Local DSD .. 139 Understanding the Static TXT File .. 139 Understanding the XML Mapping File .. 140 Understanding the Process Items XLST File .. 141 Exporting Word Documents to Integrity .. 141 Troubleshooting .. 14312 Microsoft Excel ..144 Overview .. 145 Before You Start.

10 145 Integrity Server Requirements .. 145 Client Requirements .. 146 integration Components .. 146 Assumptions .. 146 Key Considerations .. 146 Setting the Integrity Server Connection Policy.. 147 Installing the Microsoft Excel integration .. 147 Repairing or Removing the integration .. 148 Customizing the Microsoft Excel integration .. 149 XML Mapping Template.. 149 Integrity Custom Properties .. 151 Enabling SSL Communication .. 151 Logging .. 152 Using the Microsoft Excel integration .. 152 Importing the XML Mapping Template .. 153 Creating a New List .. 154 Retrieving Items From Integrity .. 154 Synchronizing Data .. 155 Synchronizing Using Queries .. 156 Working With Requirement Documents .. 157 Detecting Conflicts.. 159 Working With Special Fields .. 159 VPART IV: OTHER13 Sybase PowerBuilder ..163 Configuring the PowerBuilder integration .. 164 Using the PowerBuilder integration .. 164 Creating an Integrity Project .. 166 Creating a Sandbox .. 166 Adding Members to an Integrity Project.