WorkflowGen 6.0 Guide de mise à jour Date de mise à jour : le 10 juin 2015 Copyright Advantys 2015 www.workflowgen.com
Table des matières Présentation 3 Préparation 4 Aperçu 4 Demander des nouveaux fichiers de licence et numéro de série 4 Applications de workflow obsolètes 5 Avant de migrer la base de données WorkflowGen à MS SQL Server 2012 ou supérieur 5 Mise à jour WorkflowGen 6.0 6 Aperçu 6 Contenu du pack de mise à jour 6 Serveur IIS 6 Services Windows WorkflowGen 6 Sauvegarde 6 Répertoires d applications et de données 6 Base de données 7 Mettre à jour les fichiers d applications Web WorkflowGen 7 Mettre à jour les fichiers de services Windows WorkflowGen 7 Mettre à jour le fichier de configuration Web 8 Mettre à jour le fichier de configuration de synchronisation des annuaires 11 Mettre à jour le fichier de configuration du service du moteur WorkflowGen 11 Déplacer le fichier de transactions XmlToDatabase 11 Mettre à jour la base de données WorkflowGen 11 MS SQL Server 12 Oracle 13 Configuration de IIS 14 Mettre à jour ou créer le groupe d applications en.net 4 14 Redémarrer le serveur IIS et les services Windows 15 Nouvel emplacement des fichiers temporaires et journaux des applications de workflow 15 Mode Edge dans Internet Explorer 15 Procédures facultatives 16 Désactiver et supprimer les applications de workflow dans IIS 16 Créer une base de données WorkflowGen vide 16 MS SQL Server 16 Oracle 16 Tests 17 Vider la mémoire cache du navigateur 17 Adresses des applications Web 17
Guide de mise à jour WorkflowGen 6.0 3 Présentation Ce guide décrit toutes les procédures en charge de cette mise à jour. Elle est destinée aux administrateurs système qui seront chargés de mettre à jour.
Guide de mise à jour WorkflowGen 6.0 4 Préparation Aperçu Vous devez être administrateur du serveur Web. Vous devez connaître : Le chemin (destination) sur le serveur Web où sera installée l'application Web WorkflowGen. Le chemin (destination) sur le serveur Web où seront installés les services Windows de WorkflowGen. L'URL du serveur Web où sera installé WorkflowGen. Base de données MS SQL Server : Le nom du serveur MS SQL. Les justificatifs d'identité du compte AS. Le chemin vers les fichiers de données du serveur SQL sur l'ordinateur où réside le serveur SQL. Base de données Oracle : Un nom de source de données Oracle existante. Les justificatifs d'identité du compte utilisateur de la base de données qui possède une permission de création sur l'instance Oracle spécifiée. Vous devrez effectuer les actions suivantes : Mettre à jour les fichiers des applications Web. Mettre à jour les fichiers des services Windows. Mettre à jour le fichier de configuration Web. Mettre à jour les fichiers de synchronisation des répertoires et du sevice du moteur, et déplacer le fichier de transaction XmlToDatabase. Mettre à jour la structure et le contenu de la base de données. Demander des nouveaux fichiers de licence et numéro de série Si vous effectuez une mise à jour depuis la version 5 de WorkflowGen, vous devez demander une nouvelle licence (essai, illimité ou par utilisateur) et un nouveau numéro de série pour chacun de vos serveurs WorkflowGen.
Guide de mise à jour WorkflowGen 6.0 5 Le nouveau fichier de licence doit être copié dans le répertoire \wfgen\bin. Réglez le nouveau numéro de série dans le fichier «\wfgen\web.config» (ex. : <add key="applicationserialnumber" value="wfg-ent-xxxxx-xxxxx-xxxx-xxxx" />). Note : Assurez-vous de sauvegarder vos fichiers de licence et numéro de série antérieurs. Applications de workflow obsolètes Les applications suivantes sont obsolètes et ne sont plus fournies avec WorkflowGen depuis la version 6 : eformpdf DocApproval DocUpload FdfToXml PdfToDatabase Toutefois, si vous avez toujours des processus qui utilisent ces applications, vous pouvez les garder déclarées sur le site Web WorkflowGen comme dans la version 5. Avant de migrer la base de données WorkflowGen à MS SQL Server 2012 ou supérieur Important : Cette mise à jour de compatibilité de la base de données est obligatoire avant de migrer la base de données WorkflowGen de MS SQL Server 2005/2008 R2 à MS SQL Server 2012 et supérieur. Lancez le script de mise à jour Update-6-0\Databases\MsSQLServer\Update_WFG-V6-0_SQL_Triggers_ 2012.sql dans SQL Server Management Studio.
Guide de mise à jour WorkflowGen 6.0 6 Mise à jour WorkflowGen 6.0 Aperçu Les procédures suivantes s appliquent au pack de mise à jour WorkflowGen 6.0. Pour de plus amples renseignements sur la façon d obtenir le pack de mise à jour WorkflowGen le plus récent, contactez votre fournisseur WorkflowGen. Contenu du pack de mise à jour Le pack de mise à jour est un fichier compressé qui contient les répertoires suivants : Inetpub : Fichiers d applications Web de WorkflowGen Program Files : Fichiers de services Windows de WorkflowGen Databases : Fichiers de création et mise à jour de la base de données WorkflowGen Serveur IIS Arrêtez le serveur IIS, ou au moins vos applications Web WorkflowGen si d autres sites Web utilisent le même serveur IIS. Services Windows WorkflowGen Arrêtez les services de synchronisation des répertoire et du moteur WorkflowGen dans le module Windows Services Management. Sauvegarde Répertoires d applications et de données Sauvegardez les répertoires suivants : DISQUE:\Inetpub\wwwroot\wfgen DISQUE:\Program Files\Advantys\WorkflowGen Si le chemin de stockage de fichiers n est pas celui par défaut de DISQUE:\Inetpub\wwwroot\wfgen\App_ Data, vous devrez sauvegarder le répertoire correspondant.
Guide de mise à jour WorkflowGen 6.0 7 Base de données Faites une sauvegarde standard de la base données au moyen des outils DBMS. Mettre à jour les fichiers d applications Web WorkflowGen Écrasez le répertoire d applications Web avec le contenu de Update-6-0\Inetpub\wwwroot\wfgen. Le chemin recommandé par défaut est DISQUE:\Inetpub\wwwroot\wfgen. Avis importants sur l écrasement des fichiers N écrasez pas votre fichier «DISQUE:\Inetpub\wwwroot\wfgen\web.config» si vous voulez conserver vos paramètres de configuration WorkflowGen et les informations de connexion de base de données existantes. Il se peut que les fichiers par défaut CSS aient été mis à jour dans cette version et pourraient alors écraser des paramétrages personnalisés dans votre installation existante : \wfgen\app_themes\default\portal\css\default.css \wfgen\app_themes\default\admin\css\default.css Si vous avez fait des changements aux fichiers défauts dans les répertoires suivants (ex. : fichiers.aspx,.css,.resx), sauvegardez les fichiers existants avant la mise à jour, puis réappliquez ces changements aux fichiers correspondants de la version 6.x : \wfgen \wfgen\app_themes \wfgen\app_data\templates\emails \wfgen\app_data\templates\forms \wfgen\app_data\templates\processes Mettre à jour les fichiers de services Windows WorkflowGen Copiez et écrasez le répertoire de services Windows WorkflowGen avec le contenu de Update-6-0\Program Files\Advantys\WorkflowGen. Le chemin recommandé par défaut est DISQUE:\Program Files\Advantys\WorkflowGen. Important : N écrasez pas vos fichiers «DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\ *.config» existants.
Guide de mise à jour WorkflowGen 6.0 8 Mettre à jour le fichier de configuration Web Cette section décrit les paramétrages de configuration à appliquer selon la version de WorkflowGen depuis laquelle vous faites la mise à jour. Par exemple : Pour passer de la version 5.7.1 et antérieure à la version 6, vous devez appliquer les modifications indiquées dans les deux sections Mise à jour pour les versions 5.7.1 et antérieures et Mise à jour pour les versions 5.7.3 et antérieures. Pour passer de la version 5.7.2 ou 5.7.3 à la version 6, vous devez appliquer uniquement les modifications indiquées dans la section Mise à jour pour les versions 5.7.3 et antérieures. Mise à jour pour les versions 5.7.1 et antérieures Vérifiez les paramètres suivants dans votre fichier «\wfgen\web.config» et ajoutez ceux qui n y sont pas déjà : <add key="engineenableselfservicedataassignexception" value="n" /> <add key="applicationdistributeddatabasesourcemode" value="0" /> <add key="applicationenabledistributeddatabasesource" value="n" /> <add key="portalcommentsrefreshfrequency" value="30000" /> <add key="portalcommentspopupwidth" value="376" /> <add key="portalcommentspopupheight" value="545" /> <add key="portalcommentssortby" value="date_post" /> <add key="portalcommentssortorder" value="asc" /> <add key="portalcommentsexpandview" value="n" /> <add key="portalenablecomments" value="y" /> <add key="portalcommentslistsize" value="25" /> <add key="applicationarchivesiteurl" value="" /> <add key="applicationenablearchivesiteredirectconfirmation" value="y" /> <add key="enginenotificationdefaultreplyto" value="" /> <add key="enginenotificationmaxfileattsize" value="10" /> <add key="portaldisplaycodenames" value="n" /> <add key="portalmaxlistsize" value="1000" /> <add key="portalquickviewenabled" value="y" /> <add key="portalquickviewdataname" value="form_archive" /> <add key="portalquickviewdisplayonmouseevent" value="click" />
Guide de mise à jour WorkflowGen 6.0 9 <add key="enginenotificationtextdetection" value="y" /> <add key="portaltextdetection" value="y" /> <add key="reportstextdetection" value="y" /> <add key="administrationformdataprovidername" value="system.data.sqlclient, System.Data.OleDb, System.Data.Odbc, System.Data.OracleClient" /> <add key="administrationenabledeletionrulescheck" value="y" /> <add key="directorysynchronizationmaxuserdeletioncount" value="0" /> <add key="administrationrestrictmanagertomodifyglobalparticipant" value="n" /> <add key="directorysynchronizationsyncgroupmembersusedinparticipantonly" value="n" /> <add key="portalactivitycompleteinbackground" value="n" /> <add key="portalenablesearchresultautoredirect" value="y" /> <add key="applicationshowassociateddatawithemptyvalue" value="y" /> <add key="portalcommonprocessdatanamelist" value="" /> <add key="administrationformdesignundolimit" value="30" /> <add key="portalreportenablecustomcolumns" value="y" /> <add key="portalreportallowusertocreatecustomcolumns" value="y" /> <add key="applicationsecurityenablewebappssecuremode" value="n" /> Note : WorkflowGen.My et WorkflowGen.My.Web.UI.WebControls (WorkflowFileUpload) version 3.0 ou ultérieure sont requis dans tous vos formulaires Web Visual Studio si la fonctionnalité de sécurité est activée. Pour plus de renseignements, référez-vous au site http://community.workflowgen.com/kb/setup-web-apps-security-workflow-parameters-securemode.html (en anglais). Mise à jour pour les versions 5.7.3 et antérieures Ajoutez les nouveaux paramètres suivants à <appsettings> : <add key="portalframesetheight" value="0,68,*,0" /> Note : Le premier chiffre dans cette valeur est la hauteur de la bannière. Si votre site Web est configuré pour afficher une bannière, entrez sa hauteur en pixels ici. Les autres valeurs par défaut ne devraient pas être changées. <add key="portalenablecallingcard" value="y" /> <add key="portalreportadvancedviewdefault" value="y" /> <add key="portalreportenablecustomcharts" value="y" /> <add key="portalreportallowusertocreatecustomcharts" value="y" />
Guide de mise à jour WorkflowGen 6.0 10 <add key="portalreportenablequickmassapproval" value="n" /> <add key="portaldefaultworkflowgraphicalmode" value="html5" /> <add key="processesruntimewebserviceallowedusers" value="wfgen_admin" /> Note : Vous pouvez copier ce paramètre de votre «\wfgen\ws\web.config» existant à «\wfgen\web.config». <add key="eformaspxpreviousfilescleanup" value="y" /> Note : Vous pouvez copier ce paramètre de votre «\wfgen\wfapps\webapps\eformaspx\web.config» existant à «\wfgen\web.config». <add key="getusersfromdirmaxresultnb" value="100" /> Note : Vous pouvez copier ce paramètre de votre «\wfgen\wfapps\webservices\getusersfromdir\web.config» existant à «\wfgen\web.config». <add key="xmltodatabasetestmode" value="n" /> <add key="xmltodatabaseenabletrace" value="n" /> Note : Vous pouvez copier ces paramètres de votre «\wfgen\wfapps\webservices\xmltodatabase\web.config» existant à «\wfgen\web.config». <add key="xmltranspreviousfilescleanup" value="y" /> <add key="xmltransenabletrace" value="n" /> Note : Vous pouvez copier ces paramètres de votre «\wfgen\wfapps\webservices\xmltrans\web.config» existant à «\wfgen\web.config». Supprimez les paramètres obsolètes suivants dans <appsettings> : PortalFollowUpRelevantDataListNumber PortalPopupRelevantDataListNumber PortalEnableRequestDataListPopUp Réglez les nœuds suivants dans <configuration> : <location path="." inheritinchildapplications="false"> <system.web> <httpruntime requestvalidationmode="2.0" /> </system.web> </location> <location path="wfapps/webforms" inheritinchildapplications="false"> <system.web> <httpruntime requestvalidationmode="2.0" /> <pages clientidmode="autoid" controlrenderingcompatibilityversion="3.5" /> </system.web> </location> <location path="ws" inheritinchildapplications="false"> <system.web> <httpruntime requestvalidationmode="2.0" /> </system.web>
Guide de mise à jour WorkflowGen 6.0 11 </location> Mettre à jour le fichier de configuration de synchronisation des annuaires Dans la version 6.0 de WorkflowGen, vous devez supprimer l attribut xmlns="http://schemas.microsoft.com/.netconfiguration/v2.0" dans les fichiers de configuration. Un nouveau paramètre de configuration est requis pour la mise à jour depuis la version 5.1.5 et antérieure. Ce paramètre vous permet de donner un nom unique au service de synchronisation des répertoires WorkflowGen si vous avez plusieurs instances de WorkflowGen installées sur un serveur. DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config <add key="servicename" value="workflowgendirsyncservice" /> Mettre à jour le fichier de configuration du service du moteur WorkflowGen Pour la version 6.0 de WorkflowGen, vous devez supprimer l attribut xmlns="http://schemas.microsoft.com/.netconfiguration/v2.0" dans les fichiers de configuration. Un nouveau paramètre de configuration est requis pour la mise à jour depuis la version 5.1.5 et antérieure. Ce paramètre vous permet de donner un nom unique au service de synchronisation des répertoires WorkflowGen si vous avez plusieurs instances de WorkflowGen installées sur un serveur. DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\ WfgWorkflowEngineService.exe.config <add key="servicename" value="workflowgenengineservice" /> Déplacer le fichier de transactions XmlToDatabase Copiez le fichier «Transactions.xml» de \wfgen\wfapps\webservices\xmltodatabase\app_data dans \wfgen\app_data\files\xmltodatabase. Mettre à jour la base de données WorkflowGen Exécutez les scripts SQL ci-dessous dans l ordre, en commençant par la version de WorkflowGen depuis laquelle vous faites la mise à jour. Par exemple, si vous mettez à jour depuis la version 5.5.0, exécutez les scripts en commençant par Depuis la version 5.5.0 et antérieure jusqu à Depuis la version 5.7.2 et antérieure.
Guide de mise à jour WorkflowGen 6.0 12 MS SQL Server Depuis la version 5.1.9 et antérieure V5-2-0.sql dans vos outils SQL Server Management Studio. Depuis la version 5.2.x et antérieure V5-3-0.sql dans vos outils SQL Server Management Studio. Depuis les versions 5.3.x, 5.4.0 (alpha, beta 1 and beta 2) et antérieure V5-4-0.sql dans vos outils SQL Server Management Studio. Depuis la version 5.4.x et antérieure V5-5-0.sql dans vos outils SQL Server Management Studio. Depuis la version 5.5.0 et antérieure V5-5-1.sql dans vos outils SQL Server Management Studio. Depuis la version 5.5.1 et antérieure V5-5-2.sql dans vos outils SQL Server Management Studio. Depuis la version 5.5.1 et antérieure V5-5-5.sql dans vos outils SQL Server Management Studio. Depuis la version 5.5.5 et antérieure V5-6-0.sql dans vos outils SQL Server Management Studio. Depuis la version 5.6.1 et antérieure V5-6-2.sql dans SQL Server Management Studio. Depuis la version 5.6.2 et antérieure V5-6-3.sql dans vos outils SQL Server Management Studio.
Guide de mise à jour WorkflowGen 6.0 13 Depuis la version 5.6.3 et antérieure V5-6-4.sql dans vos outils SQL Server Management Studio. Depuis la version 5.7.0 et antérieure V5-7-1.sql dans vos outils SQL Server Management Studio. Depuis la version 5.7.1 et antérieure V5-7-2.sql dans vos outils SQL Server Management Studio. Depuis la version 5.7.2 et antérieure V6-0.sql dans vos outils SQL Server Management Studio. Oracle Depuis la version 5.1.9 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-2- 0.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.2.x et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-3- 0.sql dans vos outils Oracle SQL Scripts. Depuis les versions 5.3.x, 5.4.0 (alpha, beta 1 et beta 2) et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-4- 0.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.4.x officielle et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-5- 0.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.5.0 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-5- 1.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.5.4 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-5- 5.sql dans vos outils Oracle SQL Scripts.
Guide de mise à jour WorkflowGen 6.0 14 Depuis la version 5.5.5 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-6- 0.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.6.1 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-6- 2.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.6.2 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-6- 3.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.6.3 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-6- 4.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.6.4 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-7- 0.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.7.0 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-7- 1.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.7.1 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V5-7- 2.sql dans vos outils Oracle SQL Scripts. Depuis la version 5.7.2 et antérieure Exécuter le script de mise à jour de base de données Update-6-0\Databases\Oracle\Update_WFG-V6-0.sql dans vos outils Oracle SQL Scripts. Configuration de IIS Mettre à jour ou créer le groupe d applications en.net 4 Depuis la version 6.0, le site Web et les applications Web de WorkflowGen doivent utiliser un groupe d applications en.net 4. 1. Installez.NET Framework 4 sur le serveur, s il n est pas déjà installé. 2. Mettez à jour le groupe d applications existant ou créez un nouveau groupe d application avec.net Framework 4 pour :
Guide de mise à jour WorkflowGen 6.0 15 le site Web WorkflowGen \wfgen \wfgen\wfapps\webforms (créez cette application IIS si elle n est pas déjà créée) \wfgen\ws 3. Si votre groupe d applications est configuré en mode Classic Managed Pipeline, assurez-vous de régler ASP.NET v4.0.30319 à «Allowed» dans la liste de restrictions ISAPI et CGI de IIS. Redémarrer le serveur IIS et les services Windows Redémarrez vos applications Web et services Windows WorkflowGen. Nouvel emplacement des fichiers temporaires et journaux des applications de workflow Les applications de workflow suivantes stockent leurs fichiers dans les nouveaux emplacements suivants : eformaspx : \wfgen\app_data\files\eformaspx XmlToDatabase : \wfgen\app_data\logfiles\xmltodatabase XmlTrans : \wfgen\app_data\files\xmltrans and \wfgen\app_data\logfiles\xmltrans Mode Edge dans Internet Explorer Le mode de document Edge est requis pour afficher le site Web WorkflowGen dans Internet Explorer version 8 et supérieure. La balise méta <meta http-equiv="x-ua-compatible" content="ie=edge"> est incluse dans \wfgen\default.aspx et \wfgen\admin\default.aspx qui configura Internet Explorer pour rendre WorkflowGen en mode de document Edge. Pour plus de renseignements, référez-vous à https://msdn.microsoft.com/enus/library/jj676915%28v=vs.85%29.aspx (en anglais seulement). Note : Les utilisateurs d Internet Explorer devront ajouter le site Web WorkflowGen soit à la zone de sécurité Intranet local ou à la zone de sécurité Site de confiance. Pour plus de renseignements, référez-vous à https://support.microsoft.com/en-us/kb/174360/fr.
Guide de mise à jour WorkflowGen 6.0 16 Procédures facultatives Désactiver et supprimer les applications de workflow dans IIS Depuis la version 6.0, les applications de workflow suivantes sont intégrées en tant qu applications intégrées ou d assemblage. Les applications Web correspondantes peuvent alors être désactivées et supprimés dans IIS et les répertoires de système de fichiers car elles ne sont plus utilisées. eformaspx : \wfgen\wfapps\webapps\eformaspx GetUsersFromDir : \wfgen\wfapps\webservices\getusersfromdir RaiseException : \wfgen\wfapps\webservices\raiseexception XmlToDatabase : \wfgen\wfapps\webservices\xmltodatabase XmlTrans : \wfgen\wfapps\webservices\xmltrans Créer une base de données WorkflowGen vide MS SQL Server Exécutez le script de création de base de données Update-6-0\Databases\MsSQLServer\ CreateWFGSQLDatabase.vbs et suivez les instructions affichées à l écran. Oracle 1. Exécutez le script de création de base de données Update-6-0\Databases\Oracle\ CreateWFGOracleDatabase.vbs et suivez les instructions affichées sur l écran. Note : Une instance de base de données Oracle ne sera pas créée durant l installation. Vous devez donc la créer préalablement à l installation. 2. Mettez à jour la chaîne de connexion de base de données dans le fichier de configuration d applications Web WorkflowGen (DRIVE:\Inetpub\wwwroot\wfgen\web.config) si nécessaire.
Guide de mise à jour WorkflowGen 6.0 17 Tests Vider la mémoire cache du navigateur Il est très important de vider la mémoire cache du navigateur avant de vous connecter au site Web WorkflowGen version 6.0 pour la première fois. Ceci supprimera les fichiers CSS, JavaScript et images antérieurs de la version 5. Adresses des applications Web Utilisez les URLs suivants avec le compte «wfgen_admin» : Portail utilisateur : http://[votresite]/wfgen Module d administration : http://[votresite]/wfgen/admin