USER MANUAL Migration Instructions for MS Dynamics CRM e-con 2012 3-9-2009 To-Increase BV
Document Information Title Migration Instructions for MS Dynamics CRM Subject e-con 2012 Version Status Solution Product Category User Manual Author Marijn van Poelje Copyright To-Increase e-con Solutions. All rights reserved. The information in this document is subject to change without notice. No part of this document may be reproduced, stored or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of To-Increase e-con Solutions B.V. To-Increase e-con Solutions B.V. assumes no liability for any damages incurred, directly or indirectly, from any errors, omissions or discrepancies between the software and the information contained in this document Document Information 1
Table of Contents Document Information... 1 Table of Contents... 2 1. Introduction... 3 2. Prerequisites... 4 2.1 Licenses... 4 2.2 Installation... 4 3. Migration instructions... 5 3.1 Introduction... 5 3.2 Before installation... 5 3.2.1 Uninstall of the CRM&More e-con integration... 5 3.2.2 Remove double domains... 5 3.3 Installation... 5 3.4 After installation... 5 3.4.1 e-con Settings... 5 3.4.2 CRM Settings... 5 3.4.3 Build all models... 6 3.4.4 Model compatibility issues... 6 Process Task... 6 3.4.5 Model compatibility issues only when running Silverlight... 7 Table of Contents 2
1. Introduction This document describes the prerequisites and steps required when migrating from e-con 4.x for MS Dynamics CRM to e-con 2012 for MS Dynamics CRM. The first section describes the prerequisites and the second section describes the migration steps in detail. Introduction 3
2. Prerequisites This chapter describes the prerequisites for the migration to e-con 2012 for MS Dynamics CRM. 2.1 Licenses Before installing and migrating to e-con 2012 the e-con license needs to be updated to run this version. To update your license send an e-mail to salessupportecon@to-increase.com with the request for updating the e-con license to version e-con 2012. Include the actual e-con license as well. The e-con license can be exported from the e-con studio. Open the e-con studio, select tools export license and select the location for saving the license. Attach this file to the e-mail. There are not any costs involved. 2.2 Installation e-con 2012 can run side by side with other e-con versions at a server. Therefore it s not needed to uninstall any version of e-con prior to installing e-con 2012. This also implies a test environment can run on e-con 2012 while the live environment is still running on your current version of e-con. More information about installing the e-con 2012 server and studio software can be found in the e- Con 2012 Installation manual. The e-con 2012 - MS Dynamics CRM Integration - Installation and User Manual describes the installation and setup of the Dynamics CRM integration in detail. Prerequisites 4
3. Migration instructions 3.1 Introduction This chapter describes migration steps needed prior to installing e-con 2012 as well as steps to take after installation including eventually required model changes. 3.2 Before installation Steps needed prior to installing e-con 2012 are described in this section. 3.2.1 Uninstall of the CRM&More e-con integration Prior to installing the e-con 2012 CRM integration the current CRM&More e-con integration needs to be installed. Just go to control panel uninstall a program, select the CRM&More e-con integration program and click on uninstall. 3.2.2 Remove double domains In e-con 2012 the caching of the Studio Domains is improved. As a result it s no longer allowed to have and use domains with same Id s. Prior to upgrade to e-con 2012 remove these duplicate domains within the e-con studio. 3.3 Installation Follow the instructions as described in the installation manuals, e-con 2012 Installation manual and e-con 2012 - MS Dynamics CRM Integration - Installation and User Manual. Also update the e- Con CRM integration by importing the e-con CRM integration solution AND the econsolutions_integration_2_0_1_2 solution into Microsoft Dynamics CRM. 3.4 After installation 3.4.1 e-con Settings Make sure all environment specific settings, as they exists in the e-con 4.2 environment, are added in the new e-con 2012 environment Add ;nativesvc=sqlservice.svc the the SQL Connection String. (Data.SQL.ConnectionString) 3.4.2 CRM Settings Change the e-con settings in CRM to match the e-con 2012 requirements. Change the e-con Version setting to 2012 Migration instructions 5
When you want to run the e-con Silverlight User Interface you also need to change the e-con URL and select a theme. For running Silverlight last part of the url must be changed from econenginehtml.aspx to econslpage.html. Example URL s: Running IIS: http://win-qdsrqn459rl:81/crm2011/econenginehtml.aspx Running Silverlight: http://win-qdsrqn459rl:81/crm2011/econslpage.html# Silverlight also allows you to select a theme for the User Interface. Most logic choice is to select the crm theme here. 3.4.3 Build all models After installation all models needs to be build in order to update the model dlls and also to create the model client dlls required by Silverlight. 3.4.4 Model compatibility issues Process Task For consistency reasons the process task is no longer performing an exit after processing the configuration. Instead a new task is available the econ.ui.tasks.processandexittask which is processing and exiting e-con. Only when the econ.ui.tasks.processtask is used in your model, typically when custom buttons are used instead of the standard buttons, the econ.ui.tasks.processtask must be replaced with the econ.ui.tasks.processandexittask. Migration instructions 6
3.4.5 Model compatibility issues only when running Silverlight Format of pictures The Silverlight e-con 2012 user interface only supports pictures of the formats png and jpg. When other formats of pictures are used in the e-con models, these pictures need to be converted to the png or jpg format. Also make sure the correct format is specified in the models itself, either in the structure or rules. Model help Model help is currently not implemented for the Silverlight client. The functionality will become available for e-con 2012 Silverlight early 2012. Till then simply deactivate the help reference in your model. Visualization Real-time visualization, using the functions of the econ.visualization.functions and outputting SVG format picture is not supported for the Silverlight client. This functionality or equal functionality will become available in e-con 2012 R2. Print of documents In e-con 4.2 very often the econprintreport.aspx page is used to generate and open document. Example: PRINT@default = "econprintreport.aspx?key=" & EngineKey() & "&report=" & "OfferteDeur-" & Language &".xml" & "&reportversion=" & "1" & "&content=" & "application/msword" This aspx page is not supported in Silverlight. Instead the print task must be used. Example: local string File = Replace(OutputFolder; "\\"; "/") + "/" + EngineKey() + ".doc"; Buttons.Print@default = "task:econ.ui.tasks.printtask:'quotedocument','1.0.0','" & File & "','en- US',true task:econ.ui.tasks.startfile:'" & File & "'" Function GetHTMLImages Obviously this function is not supported for the Silverlight client. Similar function for capturing pictures presented in the Silverlight client User Interface is currently not available. Migration instructions 7