OverviewWhat Is ConvertedWhat Is Not Converted
This topic serves as an introduction to the project conversion process from TrueUpdate 1.0 to TrueUpdate 3.0. It will describe what the project converter can and cannot convert. It will also explain some of the reasons behind the decisions made and what to do once your TrueUpdate 1.0 project has been converted to TrueUpdate 3.0.
TrueUpdate was rebuilt from the ground up to be infinitely more powerful and flexible than its previous version. As such, it required an entirely new "scripting engine" to process actions and a new screen structure. The importer converts as much information from TrueUpdate 1.0 to TrueUpdate 3.0 as possible, however some conversions are impossible due to the large paradigm shift from TrueUpdate 1.0 to 3.0.
Given the changes to the scripting engine and overall framework in v3.0, you'll need to decide whether or not to automatically convert your v1.0 projects to v3.0 projects. The converter is not a one-to-one conversion; instead it converts your TrueUpdate 1.0 project into doing things the TrueUpdate 3.0 way. While the converter will attempt to make the best decisions possible when converting your project, it is no substitute for a seasoned developer. Whenever possible, it is recommended that you manually convert your TrueUpdate 1.0 projects over to TrueUpdate 3.0 to ensure that your design is converted properly.
For the most part everything in your TrueUpdate 1.0 project will be converted over to 3.0 properly, with a few exceptions listed in the What Is Not Converted topic. That being said, it is important to read this document to know the limitations of the conversion process and to test your converted project fully before distributing.
This guide will look at the conversion process from the TrueUpdate 1.0 standpoint. To start a conversion, simply go to File > Open, select the version 1.0 file type from the files of type dropdown, and select either a v1.0 client configuration project file (.tup) or a server file project (.uif). Once one of the two project files has been selected, a dialog will be shown allowing you to browse for the remaining project file, and configure the converted project's path and filename. The conversion tool will then take over and do its best to create a v3.0 compatible project from your v1.0 project files.
You'll definitely want to read the rest of the topic, including the What Is Converted and What is Not Converted sections. That'll give you an exact rundown of what to expect from the automated conversion process. Then you'll want to become more familiar with all of the goodies you'll find in v3.0. They'll make your updates cooler and more professional!
The first section to read in the help file should be the Key Features of TrueUpdate section. This will help point out all of the exciting features available in TrueUpdate. There is also the What's New in TrueUpdate? topic that covers what new features have been added. The next section to take a look at is the topic, The TrueUpdate Interface. This will provide a brief tour of the design environment so you are familiar with the terms used throughout the rest of the documentation.
If you are still not sure how things work in TrueUpdate, the User’s Guide is an indispensable tool. It is a topical task based manual describing the features and use of the product. It was written in such a way that you can simply jump to the sections that you need to learn at that moment. The User's Guide can be accessed from the Help program menu.
If you think that you have a good handle on what "the TrueUpdate 3.0" way entails, but are looking for some specific real world examples, visit www.indigorose.com for available support resources and policies. This area provides various articles answering some of the most common questions we have been asked about TrueUpdate. TrueUpdate also contains a "Samples" folder in the main TrueUpdate program directory providing sample projects that you can look at and work off of.
At this point you should know almost everything there is to know about TrueUpdate, however your actions will look different after being converted to TrueUpdate 3.0 script. For this reason, you should read over the Scripting Guide located in the Help file. This guide will provide you with tips, tricks, and professional-level techniques you should use when writing or modifying your TrueUpdate scripts.