Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Ce guide décrit toutes les procédures en charge de la mise à jour de WorkflowGen vers la version 9.2.4. Il est destiné aux administrateurs système qui seront chargés de mettre à jour.
Les procédures suivantes s’appliquent au pack de mise à jour WorkflowGen 9.2.4 disponible à l'adresse suivante : https://github.com/advantys/workflowgen-releases/releases.
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
Arrêtez le serveur IIS, ou au moins vos applications Web WorkflowGen si d’autres sites Web utilisent le même serveur IIS.
Arrêtez les services de synchronisation des répertoires et du moteur WorkflowGen dans le module Windows Services Management.
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.
Faites une sauvegarde standard de la base de données au moyen des outils DBMS.
Vérifiez si ces fichiers et dossiers obsolètes utilisés par les applications basées sur Node.js existent toujours dans votre dossier \wfgen et supprimez-les s'ils existent.
Supprimez les fichiers et dossiers suivants du dossier \wfgen\graphql :
\controllers
\models
Supprimez les fichiers d'assembly .dll obsolètes suivants des dossiers \wfgen\bin, \wfgen\ws\bin et \Program Files\Advantys\WorkflowGen\services\bin :
Advantys.Directories
Advantys.Directories.Web.UI.Administration
Advantys.Web.UI.Charting
Écrasez le répertoire d’applications Web avec le contenu de Update\Inetpub\wwwroot\wfgen. Le chemin recommandé par défaut est DISQUE:\Inetpub\wwwroot\wfgen.
Les utilisateurs du domaine et les comptes de services Windows spécifiés dans le pool d’applications IIS et le service du moteur WorkflowGen doivent avoir les droits de lecture et d’écriture sur le dossier \wfgen\app_data.
N’écrasez pas votre fichier DISQUE:\Inetpub\wwwroot\wfgen\web.configsi vous voulez conserver vos paramètres de configuration WorkflowGen et les informations de connexion de base de données existantes.
Supprimez le fichier DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\EAGetMail40.dll obsolète.
Écrasez le répertoire des services Windows WorkflowGen avec le contenu de Update\Program Files\Advantys\WorkflowGen. Le chemin recommandé par défaut est DISQUE:\Program Files\Advantys\WorkflowGen.
N’écrasez pas vos fichiers DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\*.config existants.
Copiez node.exe.config et trace.config (situés dans Update\Program Files\nodejs) dans DISQUE:\Program Files\nodejs.
S'il y a déjà un fichier node.exe.config dans le dossier DISQUE:\Program Files\nodejs, ne l'écrasez pas. Au lieu de cela, ajoutez ce qui suit au nœud <configuration> du fichier existant :
Cette section décrit les paramétrages de configuration à appliquer selon la version de WorkflowGen depuis laquelle vous faites la mise à jour.
Cette section a été divisée pour offrir une référence rapide aux clients effectuant une mise à jour à partir de la version 8.0.0 et ultérieures. Si vous effectuez une mise à jour depuis la version 7.22.15 ou une version antérieure, consultez la section et effectuez les modifications nécessaires au fichier de configuration Web en fonction de la version à partir de laquelle vous effectuez la mise à jour. Revenez ensuite à cette section et poursuivez avec le reste des modifications requises.
Pour passer de la version 9.0.1 bêta 2 à la version 9.2.4 vous devez appliquer les modifications indiquées dans les sections Mise à jour pour les versions 9.0.1 (v9 bêta 2) et antérieures, Mise à jour pour les versions 9.0.2 (v9 bêta 3) et antérieures, Mise à jour pour les versions 9.0.7 et antérieures et Mise à jour pour les version 9.1.0 et antérieures.
Pour passer de la version 9.2.0 bêta 1, de la version 9.2.1 bêta 2, de la version 9.2.2 bêta 3 ou de la version 9.2.3 bêta 4 à la version 9.2.4, il n'y a aucune modification à faire au fichier de configuration Web.
Vous devez supprimer l’attribut xmlns du fichier de configuration Web indépendamment de la version depuis laquelle vous mettez à jour (voir la section ).
Ajoutez les nouveaux paramètres suivants à <appSettings>:
Supprimez le paramètre obsolète suivant de <appSettings>:
Ajoutez les nouveaux paramètres suivants à <appSettings>:
Ajoutez le nouveau paramètre suivant à <appSettings> :
Mettez à jour la valeur du paramètre EngineServiceTimeoutSystemActionFrequency à 120000 comme suit :
Ajoutez les nouveaux paramètres suivants à <appSettings>:
Mettez à jour la valeur du paramètre suivant dans <appSettings> :
Supprimez les valeurs suivantes de <appSettings> pour la version 8.1.0 bêta uniquement:
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Mettez à jour le nœud bindingRedirect dans tous les fichiers de configuration affectés (énumérés ci-dessous) de <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" /> à <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" /> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Mettez à jour la valeur du paramètre suivant dans <appSettings> :
Supprimez les paramètres obsolètes de <appSettings>
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Renommez les paramètres suivants dans <appSettings>:
comme
Ajoutez le nouveau paramètre suivant à <appSettings>:
Si vous souhaitez activer la gestion par défaut des erreurs HTTP par WorkflowGen, remplacez le paramètre suivant dans <appSettings> :
par le suivant :
Cette étape est obligatoire lors de la mise à jour vers la version 9.2.2 (9.2 bêta 3) ou une version ultérieure, y compris si vous effectuez une mise à jour depuis la version 9.2.0 (9.2 bêta 1) ou 9.2.1 (9.2 bêta 2) et que vous avez mis à jour le fichier web.config racine lors de cette mise à jour.
Vous devez mettre à jour le fichier web.config racine de votre site avec les nouvelles règles de réécriture d’URL.
D'abord, vérifiez que l’outil est installé sur le serveur WorkflowGen.
Consultez les fichiers d’exemple fournis dans le pack d’installation :
Si le site WorkflowGen utilise le chemin /wfgen dans son URL (par exemple, https://votresite/wfgen), reportez-vous au fichier d'exemple Inetpub\wwwroot\web.config (dans le pack d’installation manuelle) ou au fichier d'exemple Inetpub\wwwroot\web.config.sample (dans le pack de mise à jour) pour les nouvelles règles.
Si le site WorkflowGen n’utilise PAS le chemin /wfgen dans son URL (par exemple, https://votresite), reportez-vous au fichier d'exemple Inetpub\wwwroot\web.config.without-wfgen
login.aspx (authentification personnalisée uniquement)À partir de WorkflowGen 9.2.0, si vous utilisez une authentification personnalisée avec une page de connexion créée à partir du modèle d'exemple fourni /wfgen/login.aspx, vous devez mettre à jour le fichier de la page de connexion. Pour ce faire :
Ouvrez le fichier /wfgen/login.aspx de votre site WorkflowGen (qui pourrait avoir été renommé).
Remplacez la ligne redirectToUrl = "/wfgen/show.aspx?QUERY=WELCOME"; par redirectToUrl = "/wfgen/dashboard";.
xmlnsÀ partir de la version 7 de WorkflowGen, vous devez supprimer l’attribut xmlns dans les fichiers de configuration suivants :
Pour ce faire, remplacez <configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0"> par <configuration>.
À partir de la version 8 de WorkflowGen, l'assembly WorkflowGen.My.Web.UI.WebControls.dll a été fusionné dans WorkflowGen.My.dll. Ce changement cassant affecte les formulaires Web créés dans l'éditeur de formulaires et les dossiers \bin des formulaires Web, vous devez donc effectuer l'une des opérations suivantes :
Exécutez le script \update\configuration\update-webforms-wfg-my-assembly.ps1 dans PowerShell dans le dossier \wfgen\wfapps\webforms\. Cela mettra automatiquement à jour vos formulaires Web ASPX et supprimera les fichiers et dossiers obsolètes.
Ce script requiert PowerShell version 7.0 ou ultérieure.
Il mettra à jour tous les fichiers .aspx situés dans le dossier \webforms, y compris ceux qui ne sont pas gérés par l'éditeur de formulaires. Si vous avez des formulaires Web personnalisés dans ce dossier qui utilisent une autre version de WorkflowGen.My.dll, vous devez ignorer les modifications apportées à ces fichiers .aspx. Vous pouvez le faire en déplaçant ces fichiers vers un dossier temporaire avant d'exécuter le script, puis en les copiant dans le dossier d'origine.
Supprimez les fichiers et dossiers suivants du dossier \wfgen\wfapps\webforms\bin\ :
WorkflowGen.My.Web.UI.WebControls.dll
WorkflowGen.My.Web.Handlers.dll
Ajoutez la ligne suivante à <system.webServer> dans les fichiers \wfgen\graphql\web.config et \wfgen\hooks\web.config\ :
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.
Cette section a été divisée pour offrir une référence rapide aux clients effectuant une mise à jour à partir de la version 8.0.0 et ultérieures. Si vous effectuez une mise à jour depuis la version 7.22.15 ou une version antérieure, consultez la section et exécutez les scripts de mise à jour de base de données en fonction de la version à partir de laquelle vous effectuez la mise à jour. Revenez ensuite à cette section et poursuivez avec le reste des modifications requises.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V8-0-2.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V8-0-3.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V8-1-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V8-2-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V9-0-1.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V9-0-2.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V9-0-3.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V9-1-0.sql dans vos outils SQL Server Management Studio.
Il n'y a aucun script de mise à jour de base de données à exécuter.
Le site Web et les applications Web de WorkflowGen doivent utiliser un groupe d’applications en .NET 4. Si cela n’a pas déjà été configuré, procédez comme suit :
Installez .NET Framework 4 sur le serveur, s’il n’est pas déjà installé.
Mettez à jour le groupe d’applications existant ou créez un nouveau groupe d’application avec .NET Framework 4 pour :
le site Web WorkflowGen
Pour utiliser les API GraphQL, webhooks entrants, OpenID Connect Auth et SCIM facultatives, vous devez d'abord installer les prérequis suivants :
✏️ Note : Cette bibliothèque est requise si vous rencontrez l'erreur
Dans IIS, convertissez /wfgen/graphql en application avec un pool d’applications en .NET 4 (mode pipeline intégré).
Configurez le mode d’authentification de l’application GraphQL :
Pour l’authentification de base : Activez l’authentification de base.
Dans certaines versions et/ou configurations de Windows Server, vous pourriez rencontrer l'erreur Le module spécifié est introuvable (The specified module could not be found) pour les bibliothèques edge et edge-js lors du lancement de npm install --production en ligne de commande, ou bien en accédant aux applications Web /wfgen/graphql, /wfgen/hooks ou /wfgen/scim (voir les logs dans chaque module, situés dans leurs sous-dossiers iisnode respectifs). Dans ce cas, nous suggérons d'installer la plus récente version de Visual C++ Redistributable afin de résoudre ce problème. Les derniers téléchargements pris en charge de Visual C++ sont disponibles à l'adresse .
Mettez à jour le fichier web.config de WorkflowGen avec les paramètres suivants utilisés par les webhooks entrants :
Dans IIS, convertissez /wfgen/hooks en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification anonyme.
Dans IIS, convertissez /wfgen/scim en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification Anonyme.
Dans IIS, convertissez /wfgen/auth en application avec un pool d’applications en .NET 4 (mode pipeline intégré), et ensuite configurez l’application webhook en mode d’authentification Anonyme.
Redémarrez votre serveur WorkflowGen.
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
\node_modules
\services
\utils
config.js
config.production.js
server.js
Supprimez les fichiers et dossiers suivants du dossier \wfgen\hooks :
\controllers
\models
\node_modules
\services
\test
\utils
config.js
config.production.js
server.js
upload.js
Supprimez les fichiers et dossiers suivants du dossier \wfgen\auth :
\controllers
\models
\node_modules
\static
\utils
config.js
config.production.js
server.js
Supprimez les fichiers et dossiers suivants du dossier \wfgen\scim :
\controllers
\models
\node_modules
\services
\utils
config.js
config.production.js
server.js
Advantys.Workflow.Applications.ExecSql
Advantys.Workflow.Applications.GetUsersFromDir
Advantys.Workflow.Applications.MergeForm
Advantys.Workflow.Applications.RestApiClient
Advantys.Workflow.Applications.SendMessage
Advantys.Workflow.Applications.XmlToDatabase
Advantys.Workflow.Applications.XmlTrans
Advantys.Workflow.Reports
Advantys.Workflow.Web.UI.Reports
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 7.x.x :
\wfgen
\wfgen\App_Themes
\wfgen\App_Data\Templates\Emails
\wfgen\App_Data\Templates\Forms
\wfgen\App_Data\Templates\Processes
\wfgen\web.config
\wfgen\ws\web.config
\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config
\Program Files\nodejs\node.exe.config
\de
\fr
\hu
\pl
Mettez à jour chacun de vos formulaires Web créés dans l'éditeur de formulaires, soit en les réenregistrant, soit en remplaçant manuellement la balise <%@ Register Assembly="WorkflowGen.My.Web.UI.WebControls" ... %>
par <%@ Register Assembly="WorkflowGen.My" ... %> dans chacun de vos fichiers .aspx.
\wfgen\wfgen\wfapps\webforms (créez cette application IIS si elle n’est pas déjà créée)
\wfgen\ws
Si votre groupe d’applications est configuré en mode Classic Managed Pipeline, assurez-vous de régler ASP.NET v4.0.30319 sur Allowed dans la liste de restrictions ISAPI et CGI de IIS.
Le module spécifié est introuvableThe specified module could not be foundedgeedge-js/wfgen/graphql/wfgen/hooks/wfgen/scimAprès l’activation des applications Web basées sur Node.js, les DLL de WorkflowGen seront utilisés par Node.js et ils seront donc verrouillés et ne pourront pas être modifiés. Si vous voulez les modifier, il sera nécessaire d’arrêter IIS.
Pour l’authentification applicative WorkflowGen :
Assurez-vous que l’authentification applicative WorkflowGen est déjà appliquée à l’application web /wfgen.
Appliquez l’authentification anonyme.
Ajoutez les paramètres suivantes utilisés par GraphQL au web.config :
<add key="GraphqlMaxPageSize" value="100" />
<add key="GraphqlMaxBatchSize" value="1000" />
<add key="GraphqlDefaultPageNumber" value="1" />
<add key="GraphqlDefaultPageSize" value="30" />
<add key="GraphqlGraphiqlEnabled" value="N" />
<add key="GraphqlLoadersCacheEnabled" value="Y" />
<add key="GraphqlDebugEnabled" value="N" />
<add key="GraphqlQueryTimeout" value="90000" />
<add key="GraphqlOperationTimeout" value="30000" />
<add key="GraphqlMaxOperationCount" value="10000" />
<add key="GraphqlMaxInputFileSize" value="10240" />
<add key="GraphqlMaxInputFileContentSize" value="0" />
<add key="GraphqlInputFileDownloadTimeout" value="100000" />
<add key="GraphqlInputFileAllowedFolders" value="" />
<add key="GraphqlInputFileAllowedHttpUrls" value="" /><runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
<system.diagnostics configSource="trace.config" /><add key="RemoteApprovalAuthClientId" value="" />
<add key="RemoteApprovalAuthClientSecret" value="" />
<add key="RemoteApprovalAuthScope" value="" />
<add key="RemoteApprovalAuthAccessTokenUri" value="" />EngineTraceMode<!-- AdobeSign -->
<add key="AdobeSignClientId" value="" />
<add key="AdobeSignClientSecret" value="" />
<add key="AdobeSignHostServer" value="" />
<add key="AdobeSignRefreshToken" value="" />
<add key="AdobeSignSendLogLevel" value="0" />
<add key="AdobeSignCheckLogLevel" value="0" /><add key="EngineNotificationNotifyDelegator" value="Y" />
<add key="EnginePushNotificationSendExpoApiUrl" value="https://exp.host/--/api/v2/push/send" />
<!-- Docaposte -->
<add key="DocaposteUsername" value="" />
<add key="DocapostePassword" value="" />
<add key="DocaposteHostServer" value="" />
<add key="DocaposteOfferCode" value="" />
<add key="DocaposteOrganizationalUnitCode" value="" />
<add key="DocaposteSendLogLevel" value="0" />
<add key="DocaposteCheckLogLevel" value="0" /><add key="EngineServiceMaxPausedSynchroActions" value="25" /><add key="EngineServiceTimeoutSystemActionFrequency" value="120000" /><add key="PortalReportAdvancedViewPaging" value="N" /><add key="PortalListPageSize" value="25" /><add key="PortalReportAdvancedViewPageSize" value="25" />
<add key="PortalReportAdvancedViewPageSizeOptions" value="10,25,50,100,250" /><add key="GraphqlApiKeyEnabled" value="N" />
<add key="GraphqlApiKey" value="" /><add key="PortalDisplayAssignedTeamAction" value="N" />
<add key="HooksAllowImpersonateUser" value="N" />
<add key="HooksApiKeyEnabled" value="N" />
<add key="HooksApiKey" value="" /><add key="ApplicationDefaultFullWidth" value="N" /><add key="PortalCommentsPopUpHeight" value="600" /><!-- Auth: Gardian -->
<add key="ApplicationSecurityAuthAcrValues" value="" />
<add key="AdobeSignRefreshUrl" value="/oauth/v2/refresh" />
<!-- Yousign -->
<add key="YousignApiKey" value="" />
<add key="YousignHostServer" value="" />
<add key="YousignSendLogLevel" value="0" />
<add key="YousignCheckLogLevel" value="0" /><add key="PortalDisplayRequestListWithActionsFollowUp" value="N" />
<!-- OpenAi -->
<add key="OpenAiApiKey" value="" />
<add key="OpenAiTranscriptionLogLevel" value="0" /><add key="OpenAiChatLogLevel" value="0" /><!-- OpenAI -->
OpenAiApiKey
OpenAiTranscriptionLogLevel
OpenAiChatLogLevel<!-- OpenAI -->
OpenAIApiKey
OpenAITranscriptionLogLevel
OpenAIChatLogLevel<!-- OpenAI -->
<add key="OpenAIChatApiUrl" value="" /><customErrors mode="Off"/><customErrors mode="On" defaultRedirect="default_error_page.htm">
<error statusCode="401" redirect="401.htm" />
<error statusCode="404" redirect="404.htm" />
<error statusCode="500" redirect="500.htm" />
</customErrors>\wfgen\web.config
\wfgen\ws\web.config
\wfgen\WfApps\WebForms\web.config
DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineServer.exe.config
DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config.\update-webforms-wfg-my-assembly.ps1 -Path "c:\inetpub\wwwroot\wfgen\wfapps\webforms" -Verbose<httpErrors existingResponse="PassThrough" errorMode="Detailed"></httpErrors><add key="HooksDebugEnabled" value="N" />
<add key="HooksOperationTimeout" value="30000" />
<add key="HooksMaxInputFileSize" value="10240" />
<add key="HooksMaxInputFileContentSize" value="0" />
<add key="HooksInputFileDownloadTimeout" value="100000" />
<add key="HooksInputFileAllowedFolders" value="" />
<add key="HooksInputFileAllowedHttpUrls" value="" /><location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location><location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location><location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>
</location>ChartServiceAvoidColorCollision
ChartServiceMaxSliceInPie
ReportsChartServiceUrl
ReportsChartTemplatePath
ReportsChartTemplateExtensionVous 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.
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 service du moteur, et déplacer le fichier de transaction XMLTODATABASE.
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.
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" />).
Assurez-vous de sauvegarder vos fichiers de licence et numéro de série antérieurs.
La fonctionnalité d’Approbation à distance (Remote Approval) est maintenant intégrée dans WorkflowGen et n’est plus un module distinct.
Pour des informations sur le paramétrage de l’Approbation à distance, consultez la section dans le .
Si vous avez l’ancien module d’Approbation à distance configuré, suivez les étapes suivantes.
Mettre à jour la structure et le contenu de la base de données.
Utilisez les URLs suivants avec le compte wfgen_admin :
Portail utilisateur : http://[votresite]/wfgen
Module d’administration : http://[votresite]/wfgen/admin
Désinstallez le module Approbation à distance (il est recommandé de sauvegarder tous les fichiers et dossiers antérieurs du module d’Approbation à distance) :
Arrêtez le service Approbation à distance depuis la liste de services Windows. Le service est généralement nommé WorkflowGen RemoteApproval ou WorkflowGen EmailListener.
Supprimez le dossier DISQUE:\Program Files (x86)\Advantys\WorkflowGen\RemApp\.
Supprimez les fichiers \wfgen\bin\RemoteApprovalConfig.dll et \wfgen\admin\RemoteApprovalConfig.aspx.
Supprimez le nœud menuItem dans \wfgen\App_Data\CustomMenus\admin.xml (vous pouvez supprimer entièrement le fichier s’il ne contient que ce nœud).
Cochez Activer dans l’onglet Approbation à distance dans le Panneau de configuration du Module d’administration.
Vérifiez vos paramétrages d’Approbation à distance, qui devraient rester inchangés car ils sont hérités de la mise à jour WorkflowGen.
L’Approbation à distance ne nécessite plus de compte spécifique WorkflowGen car la fonctionnalité utilise maintenant le service du moteur interne.
Il faut redémarrer le service du moteur WorkflowGen à chaque fois que vous modifiez l’intervalle de rafraîchissement.
Facultatif : Supprimez les paramètres suivants qui ne sont plus utilisés dans WorkflowGen du fichier web.config : RemoteApprovalWorkflowGenAppDomain RemoteApprovalEmailListenerServiceName RemoteApprovalWorkflowGenAppUsername RemoteApprovalWorkflowGenAppPassword
Facultatif : Testez l’Approbation à distance avec un processus existant pour lequel l’Approbation à distance a été configurée depuis l’ancien module. Vous pouvez aussi tester avec disponible sur le .
Depuis la version 6.0, les applications de workflow suivantes sont intégrées en tant qu’applications intégrées ou d’assembly. Les applications Web correspondantes peuvent alors être désactivées et supprimées 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
Pour créer une base de données WorkflowGen vide, vous devez utiliser le pack d’installation manuel complet disponible à l'adresse suivante : https://github.com/advantys/workflowgen-releases/releases.
Cette section décrit les paramétrages de configuration à appliquer selon la version de WorkflowGen depuis laquelle vous faites la mise à jour. Une fois ces modifications appliquées, retournez à la section dans la section principale de mise à jour et poursuivez avec les modifications indiquées.
Si vous effectuez une mise à jour depuis la version 6.5.0, vous devez appliquer les modifications de la section Mise à jour depuis les versions 6.5.0 et antérieures à la section Mise à jour depuis toutes les versions 7.x.x et antérieures.
Si vous effectuez une mise à jour depuis la version 7.22.15, vous devez appliquer les modification de la section Mise à jour depuis toutes les versions 7.x.x et antérieures uniquement.
Vous devez supprimer l’attribut xmlns du fichier de configuration Web indépendamment de la version depuis laquelle vous mettez à jour (voir la section ).
Vérifiez les paramètres suivants dans votre fichier \wfgen\web.config et ajoutez ceux qui n’y sont pas déjà :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Supprimez les paramètres obsolètes suivants dans <appSettings> :
Réglez les nœuds suivants dans <configuration> :
Réglez ou mettez à jour le nœud suivant dans <configuration>/<system.web> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Ajoutez ou modifiez le paramètre AdministrationFormDataProviderName comme suit :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> pour configurer le fichier log de l’application de workflow SENDHTTPPOST en remplaçant la valeur n avec 0 pour désactiver, 1 pour les logs simples ou 2 pour les logs de débogage.
Supprimez les paramètres obsolètes de <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Supprimez les paramètres obsolètes suivants de <appSettings> :
Ajoutez les nœuds suivants après les nœuds <location> existants dans \wfgen\web.config :
Supprimez le nœud ci-dessous de \wfgen\auth, \wfgen\hooks et \wfgen\scim , si présent :
Ajoutez le nouveau paramètre suivant à <appSettings> :
À partir de la version 7.15.5, les paramètres HTTP facultatifs BACKURL_SUBMIT et BACKURL_CANCEL utilisés dans les URL WorkflowGen personnalisées (par exemple, lors du ) supportent UNIQUEMENT les URL absolues (commençant par http:// ou https://), les URL relatives (commençant par /) ou les URL définies dans le paramètre de configuration PortalRedirectAllowedHttpUrls (par exemple, value='blank.htm, myPage.htm').
Modifiez la valeur par défaut de RestApiClientRequestTimeout de 3000 à 30000 millisecondes.
Faites les modifications suivantes au fichier web.config de chaque composant Node.js (situés dans \wfgen\graphql, \wfgen\hooks, \wfgen\scim et\wfgen\auth
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
Ajoutez targetFramework="4.6.1" au nœuds __httpRuntime des applications Web. Par exemple :
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Ajoutez le nouveau paramètre suivant à <appSettings> :
À partir de la version 7.22.0 de WorkflowGen, les valeurs de niveau de journalisation des applications de workflow GETUSERSFROMDIR, MERGEFORM, SENDHTTPPOST et RESTAPICLIENT existantes ont été modifiées à 0 pour aucune journalisation (par défaut), 2 pour les informations et 3 pour le débogage. Vous pouvez définir (ou redéfinir) les niveaux de journalisation en mettant à jour les valeurs des paramètres suivants en conséquence :
Supprimez les nœuds d'en-tête personnalisés Access-Control-Allow-* existants de location path="graphql" (comme indiqué ci-dessous), car ils sont obsolètes à partir de la version 7.22.1 :
Si vous souhaitez configurer le partage de ressources cross-origin (CORS) pour l'accès à l'API GraphQL par une application tierce, vous devez maintenant suivre les instructions de la section dans le (disponible en Anglais seulement).
Ajoutez les nouveaux paramètres suivants à <appSettings> :
Supprimez les paramètres suivants de <appSettings> :
Ajoutez le suivant au nœud <configuration> :
Un nouveau paramètre de configuration est requis pour la mise à jour depuis les versions 5.1.5 et antérieures. 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
Un nouveau paramètre de configuration est requis pour la mise à jour depuis les versions 5.1.5 et antérieures. 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" />
Si vous mettez à jour depuis la version 5.7.4 ou antérieure, copiez le fichier Transactions.xml de \wfgen\WfApps\WebServices\XmlToDatabase\App_Data dans \wfgen\App_Data\Files\XmlToDatabase.
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.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-2-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-3-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-4-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-5-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-5-1.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-5-2.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-5-5.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-6-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-6-2.sql dans SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-6-3.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-6-4.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-7-1.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V5-7-2.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-0-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-1-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-1-3.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-1-4.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-2-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-5-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V6-6-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-0-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-1-1.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-2-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-3-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-6-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-10-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-11-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-12-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-13-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-14-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-15-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-15-2.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-16-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-17-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V7-22-0.sql dans vos outils SQL Server Management Studio.
Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V8-0-0.sql dans vos outils SQL Server Management Studio.
Changez le chemin du gestionnaire iisnode de server.js en dist/server.js.
Changez la propriété url de la règle de réécriture de server.js en dist/server.js.
Les modifications devraient ressembler à ceci :
targetFramework="4.8" aux nœuds httpRuntime des trois applications Web :Ajoutez le suivant au nœud <configuration> dans \Inetpub\wwwroot\wfgen\ws\web.config :
Ajoutez le suivant au nœud <configuration> dans\Program Files\Advantys\WorkflowGen\Services\bin\WfgDirectoriesSyncService.exe.config :
Ajoutez le suivant au nœud <configuration> dans \Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config :
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime><system.diagnostics configSource="WfgDirectoriesSyncService.exe.trace.config" /> <system.diagnostics configSource="WfgWorkflowEngineService.exe.trace.config" />
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime><add key="EngineEnableSelfServiceDataAssignException" value="N" />
<add key="EngineNotificationDefaultReplyTo" value="" />
<add key="EngineNotificationMaxFileAttSize" value="10" />
<add key="EngineNotificationTextDetection" value="Y" />
<add key="EngineNotificationServerTimeout" value="3" />
<add key="ApplicationDistributedDatabaseSourceMode" value="0" />
<add key="ApplicationEnableDistributedDatabaseSource" value="N" />
<add key="ApplicationEnableArchiveSiteRedirectConfirmation" value="Y" />
<add key="ApplicationArchiveSiteUrl" value="" />
<add key="ApplicationShowAssociatedDataWithEmptyValue" value="Y" />
<add key="ApplicationSecurityEnableWebAppsSecureMode" value="N" /><add key="PortalEnableComments" value="Y" />
<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="PortalCommentsListSize" value="25" />
<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" />
<add key="PortalTextDetection" value="Y" />
<add key="PortalActivityCompleteInBackground" value="N" />
<add key="PortalEnableSearchResultAutoRedirect" value="Y" />
<add key="PortalCommonProcessDataNameList" value="" />
<add key="PortalReportEnableCustomColumns" value="Y" />
<add key="PortalReportAllowUserToCreateCustomColumns" 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="AdministrationRestrictManagerToModifyGlobalParticipant" value="N" />
<add key="AdministrationFormDesignUndoLimit" value="30" />
<add key="DirectorySynchronizationMaxUserDeletionCount" value="0" />
<add key="DirectorySynchronizationSyncGroupMembersUsedInParticipantOnly" value="N" /><add key="PortalFrameSetHeight" value="0,68,*,0" /><add key="PortalEnableCallingCard" value="Y" />
<add key="PortalReportAdvancedViewDefault" value="Y" />
<add key="PortalReportEnableCustomCharts" value="Y" />
<add key="PortalReportEnableQuickMassApproval" value="N" />
<add key="PortalReportAllowUserToCreateCustomCharts" value="Y" />
<add key="PortalDefaultWorkflowGraphicalMode" value="HTML5" />
<add key="ProcessesRuntimeWebServiceAllowedUsers" value="wfgen_admin" /><add key="EFormAspxPreviousFilesCleanUp" value="Y" /><add key="GetUsersFromDirMaxResultNb" value="100" /><add key="XmlToDatabaseTestMode" value="N" />
<add key="XmlToDatabaseEnableTrace" value="N" /><add key="XmlTransPreviousFilesCleanUp" value="Y" />
<add key="XmlTransEnableTrace" value="N" />PortalFollowUpRelevantDataListNumber
PortalPopupRelevantDataListNumber
PortalEnableRequestDataListPopUp<location path="." inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
</system.web>
</location>
<location path="wfapps/webforms" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
<pages clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</location>
<location path="ws" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" />
</system.web>
</location><pages validateRequest="false" enableSessionState="true"><add key="AdministrationDefaultWorkflowGraphicalMode" value="HTML5" />
<add key="EngineNotificationLogLevel" value="1" />
<add key="RemoteApprovalLogTraceLevel" value="3" />
<add key="RemoteApprovalMailServerSecurity" value="none" />
<add key="RemoteApprovalRefreshInterval" value="180000" />
<add key="RemoteApprovalMailServerType" value="POP" />
<add key="RemoteApprovalLifeSpan" value="0" />
<add key="RemoteApprovalMailServerPort" value="110" />
<add key="ApplicationSecurityPasswordManagementMode" value="V5" />
<add key="ApplicationSecurityMaxLoginAttempts" value="5" />
<add key="ApplicationSecurityMinimumPasswordLength" value="8" />
<add key="ApplicationSmtpPickupDirectory" value="DRIVE:\inetpub\mailroot\Pickup" /><add key="ApplicationSmtpServerTimeout" value="3000" />
<add key="ApplicationSmtpDeliveryMethod" value="SmtpServer" /><add key="AdministrationAssociatedActivitiesToSwimlane" value="Y" /><add key="AdministrationFormDataProviderName" value="System.Data.SqlClient,System.Data.OleDb,System.Data.Odbc,System.Data.OracleClient,Oracle.DataAccess.Client" /><add key="ApplicationWebFormsPath" value="" />
<add key="EngineNotificationDefaultSenderName" value="" />
<add key="PortalDashboardAutoRefreshInterval" value="0" />
<add key="PortalActivityOnCompleteRedirectToView" value="N" /><add key="SendMessageProvider" value="TWILIO" />
<add key="SendMessageAccountSID" value="" />
<add key="SendMessageAuthToken" value="" />
<add key="SendMessageFrom" value="" />
<add key="SendMessageApiUrl" value="https://api.twilio.com/2010-04-01/Accounts/" />
<add key="SendMessageEnableLogs" value="Y" /><add key="SendHttpPostLogLevel" value="n" />ApplicationImpersonificationUsername
ApplicationImpersonificationPassword
PortalDefaultWorkflowGraphicalMode
ApplicationEnableFlashDetection<add key="GraphqlQueryTimeout" value="90000" />
<add key="GraphqlOperationTimeout" value="30000" />
<add key="GraphqlMaxOperationCount" value="10000" />
<add key="GraphqlMaxInputFileSize" value="10240" />
<add key="GraphqlInputFileDownloadTimeout" value="100000" />
<add key="HooksMaxInputFileDownloadTimeout" value="100000" />
<add key="HooksOperationTimeout" value="30000" />
<add key="HooksMaxInputFileSize" value="10240" />
<add key="EngineServiceTempApiFilesLifespan" value="2" /><add key="AdministrationDefaultConditionLanguage" value="JS" /><add key="ApplicationSmtpEnableSsl" value="N" />
<add key="ApplicationSmtpPort" value="" />
<add key="ApplicationSmtpUsername" value="" />
<add key="ApplicationSmtpPassword" value="" /><add key="GraphqlMaxInputFileContentSize" value="0" />
<add key="HooksMaxInputFileContentSize" value="0" />
<add key="GraphqlInputFileAllowedFolders" value="" />
<add key="HooksInputFileAllowedFolders" value="" /><add key="ApplicationSecurityAuthSessionRefreshEnableIFrame" value="Y" /><add key="EngineServiceInactiveRequestLifespanUnit" value="d" />
<add key="EFormAspxAcceptEmptyInputTextParam" value="Y" />
<add key="SendHttpPostMaxResponseLength" value="4194304" />
<add key="RestApiClientLogLevel" value="0"/>
<add key="RestApiClientRequestTimeout" value="3000" />
<add key="RestApiClientMaxResponseLength" value="4194304" />
<add key="RestApiClientEnableFilesCleanUp" value="Y" />
<add key="GetUsersFromDirLogLevel" value="0" />
<add key="XmlTransEnableFilesCleanUp" value="Y" />
<add key="MergeFormEnableFilesCleanUp" value="Y" />
<add key="GraphqlInputFileAllowedHttpUrls" value="" />
<add key="HooksInputFileAllowedHttpUrls" value="" />XmlTransPreviousFilesCleanUp
MergeFormTempFilesLifeSpan<location path="auth" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location>
<location path="hooks" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location>
<location path="scim" inheritInChildApplications="false">
<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>
</location><modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules><add key="PortalRedirectAllowedHttpUrls" value="" /><add key="AdministrationMaxHelpTextSize" value="10000" />
<add key="ApplicationSecurityAuthAdditionalScopes" value="" /><add key="ReportsTopProcessesNumber" value="10" /><add key="ValidationSettings:UnobtrusiveValidationMode" value="None" /><location path="." inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.6.1" />
</system.web>
</location>
<location path="wfapps/webforms" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.6.1" />
<pages clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</location>
<location path="ws" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.6.1" />
</system.web>
</location><add key="ApplicationSecurityAuthResponseMode" value="" />
<add key="ApplicationSecurityAuthDecodeAccessToken" value="" /><add key="ExecSqlLogLevel" value="0" /><add key="GetUsersFromDirLogLevel" value="" />
<add key="MergeFormLogLevel" value="" />
<add key="SendHttpPostLogLevel" value="" />
<add key="RestApiClientLogLevel" value="" /><location path="graphql" inheritInChildApplications="false">
<system.webServer>
<httpProtocol>
<customHeaders>
<add name="Access-Control-Allow-Origin" value="*" />
<add name="Access-Control-Allow-Methods" value="GET, POST, OPTIONS, HEAD" />
<add name="Access-Control-Allow-Headers" value="Accept, Origin, Authorization, Content-Type, x-wfgen-impersonate-username, x-iisnode-auth_user" />
</customHeaders>
</httpProtocol>
</system.webServer>
</location><add key="AdministrationProcessQuickListSize" value="0" />
<add key="EngineServiceNotificationFrequency" value="60000" />
<add key="EngineServiceCancellationFrequency" value="120000" />
<add key="EngineServiceSynchroActionFrequency" value="15000" />
<add key="EngineServiceScheduledSystemActionFrequency" value="15000" />
<add key="EngineServiceTimeoutSystemActionFrequency" value="15000" />
<add key="EngineServiceCleanupFrequency" value="180000" />
<add key="EngineServiceMaxScheduledSystemActions" value="25" />
<add key="EngineServiceMaxTimeoutSystemActions" value="25" />
<add key="ApplicationSecurityAuthExposeAccessTokenInCookies" value="N" />
<add key="DocuSignUserGuid" value="" />
<add key="DocuSignAuthServer" value="" />
<add key="DocuSignClientId" value="" />
<add key="DocuSignHostServer" value="" />
<add key="DocuSignSendLogLevel" value="0" />
<add key="DocuSignCheckLogLevel" value="0" />
<add key="JsonToDataLogLevel" value="0" /><add key="DirectoryApplicationAssemblyQualifiedName" value="Advantys.Workflow.Directories.WorkflowDirectoryUserManager, Advantys.Workflow.Directories" />
<add key="DirectoryDeletionRulesAssemblyQualifiedName" value="Advantys.Workflow.Directories.WorkflowDirectoryDeletionRules, Advantys.Workflow.Directories" />
<add key="DirectoryMaxMapToUsers" value="100" />
<add key="DirectoryTruncateValue" value="50" /><runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
<dependentAssembly>
<assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
<bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
</dependentAssembly>
</assemblyBinding>
</runtime>
<system.diagnostics configSource="trace.config" /><add key="ServiceName" value="WorkflowGenDirSyncService" /><handlers>
<add name="iisnode" path="dist/server.js" verb="*" modules="iisnode"/>
</handlers>
<rewrite>
<rules>
<rule name="DynamicContent">
<conditions>
<add input="{{REQUEST_FILENAME}}" matchType="IsFile" negate="True"/>
</conditions>
<action type="Rewrite" url="dist/server.js"/>
</rule>
</rules>
</rewrite><location path="." inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
</system.web>
</location>
<location path="wfapps/webforms" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
<pages clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</location>
<location path="ws" inheritInChildApplications="false">
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="10240" targetFramework="4.8" />
</system.web>
</location>WorkflowGen 9.2.4 requiert la version 4.8 de .NET; il est donc nécessaire d'installer cette version avant la mise à jour.
web.config racineÀ partir de WorkflowGen 9.2.0, vous DEVEZ mettre à jour le fichier web.config racine de votre site avec les nouvelles règles de réécriture d’URL, en fonction de la configuration de l’URL de votre WorkflowGen. Pour savoir comment procéder, consultez la section .
BACKURL_SUBMIT et BACKURL_CANCEL dans les URL WorkflowGen personnaliséesÀ partir de la version 7.15.5, les paramètres HTTP facultatifs BACKURL_SUBMIT et BACKURL_CANCEL utilisés dans les URL WorkflowGen personnalisées (par exemple, lors du ) supportent UNIQUEMENT les URL absolues (commençant par http:// ou https://), les URL relatives (commençant par /) ou les URL définies dans le paramètre de configuration PortalRedirectAllowedHttpUrls (par exemple, value='blank.htm, myPage.htm').
À partir de la version 7.15.0 de WorkflowGen, les mots de passe du compte de serveur SMTP et du compte de serveur entrant de l'approbation à distance ne sont plus chiffrés dans le fichier web.config.
Avant de mettre à jour un serveur WorkflowGen existant, vous devez réinitialiser manuellement les mots de passe en texte clair pour les paramètres ApplicationSmtpPassword et RemoteApprovalIncomingServerPassword dans le fichier web.config. Vous pouvez également utiliser le script PowerShell convert-web-config-pwd.ps1 fourni dans \wfgen pour déchiffrer et convertir les mots de passe dans le fichier web.config.
Microsoft SQL Server 2008, 2012 et 2014 ne sont plus supportés. Malgré que ces versions seront toujours compatible avec WorkflowGen, il n’y aura plus de support pour des problèmes de performance ou des bogues provenant de l’utilisation de SQL Server 2008, 2012 ou 2014.
Pour les clients hébergeant actuellement WorkflowGen sur un serveur de base de données antérieur à MS SQL Server 2016, nous vous recommandons fortement de mettre à jour vers la dernière version de MS SQL Server pour obtenir les performances optimales.
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 vers les versions 2016 et ultérieures. Elle n'est pas nécessaire si votre base de données WorkflowGen fonctionne déjà avec MS SQL Server 2012 ou 2014.
Lancez le script de mise à jour Update\Databases\MsSQLServer\Update_WFG-V7-0_SQL_Triggers_2012.sql dans SQL Server Management Studio.
La base de données Oracle n'est plus supportée à partir de la version 7.16.0 de WorkflowGen.
Les modules Node.js incluent l'API GraphQL, les webhooks, SCIM et Auth. Pour des instructions sur la façon de les activer, voir la section .
Vous devez mettre à jour la version de Node.js à la version 18.20.6 LTS (voir ).
À partir de la version 7.10.0 de WorkflowGen, si vous utilisez les webhooks entrants ou GraphQL pour télécharger des fichiers lors de la création d’une demande ou de la réalisation d’une action, vous devez régler les paramètres de configuration GraphqlFileInputAllowedFolders, HooksFileInputAllowedFolders, GraphqlMaxInputFileContentSize et HooksMaxInputFileContentSize avec les valeurs appropriées (voir la section ).
GraphqlFileInputAllowedFolders et HooksFileInputAllowedFolders : Ces paramètres devraient contenir les chemins physiques des dossiers qui contiennent les fichiers utilisés dans les téléchargements.
GraphqlMaxInputFileContentSize et HooksMaxInputFileContentSize : Ces paramètres devraient contenir la taille de fichier maximale (en kilo-octets) lors du téléchargement de fichiers en utilisant la méthode de contenu de fichier.
✏️ Note : Nous recommandons de limiter la taille du contenu de fichier à de petits fichiers inférieurs à 1 mégaoctet.
Dans WorkflowGen version 8, les dépendances suivantes ont été mises à jour :
jQuery v1.7.2 ou 1.10.12 → 3.5.1
jQuery UI v1.8.20 ou 1.10.3 → 1.12.1
jQuery Colorbox v1.4.33 → 1.6.4
jQuery Validation v1.11.1 → 1.19.3
Certains fichiers .js, .css et .png ont été déplacés vers les dossiers \wfgen\js\common et \wfgen\App_Themes\Default\common, respectivement. Si vous utilisez les versions précédentes des fichiers listés ci-dessus dans vos formulaires, vous devez réenregistrer les formulaires afin d'utiliser les chemins et fichiers corrects.
Si vous utilisez des formulaires Web personnalisés configurés en .NET 2.0, vous pouvez continuer à les utiliser en .NET 2.0 ou les migrer en .NET 4.
Utilisez WorkflowGen.My.dll en version 2.x.
Utilisez un pool d’applications en .NET 2.0.
Désactivez Sécurité des applications Web dans la section Sécurité sur l’onglet Général du Panneau de configuration.
Utilisez WorkflowGen.My.dll en version 8.x.x ou ultérieure.
Utilisez un pool d’applications en .NET 4.
Réglez ou mettez à jour les nœuds suivants dans le fichier web.config du formulaire Web :
Les instructions ci-dessus s’appliquent uniquement à la configuration des formulaires Web afin de fonctionner correctement sans erreurs de configuration. Elles ne concernent pas des problèmes de migration ou de compatibilité potentiels qui pourraient survenir en raison de changements dans la dernière version de WorkflowGen.My. Vous devez pleinement tester à nouveau tous vos formulaires Web avant la production.
Après une mise à jour ou une migration vers WorkflowGen versions 8 et ultérieures, les formulaires Web personnalisés qui utilisent une version 8 ou 9 de WorkflowGen.My.dll
Les assemblys WorkflowGen.My et Workflow Web Controls ne portent plus des noms forts (« strong names ») afin de permettre une dépendance de version non-spécifique lorsque les assemblys sont référencés par d’autres applications telles que les applications de workflow SDK de type assembly dans WorkflowGen.
Cela simplifie la procédure de déploiement d’une application de workflow SDK de type assembly personnalisée dans les versions 6.2.0 et ultérieures de WorkflowGen et permet la mise à jour de WorkflowGen à une version plus récente sans nécessiter la régénération de l’assembly d’une application qui référençait une version antérieure de WorkflowGen.My.
Lors du déploiement d’une application de workflow SDK de type assembly personnalisée dans WorkflowGen il faut prendre en considération l’emplacement de l’assembly, la référence à WorkflowGen.My et la référence aux bibliothèques de logiciels tiers.
Il y a deux méthodes pour déployer un fichier d’assembly dans WorkflowGen.
Le fichier d’assembly doit être copié dans les trois dossiers \bin qui contiennent les fichiers exécutables de WorkflowGen : \wfgen\bin, \wfgen\ws\bin et DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin.
Le fichier d’assembly peut être copié dans un dossier personnalisé (par exemple DISQUE:\MesAppsWorkflow\Assembly.dll) pour ensuite utiliser ce chemin spécifique dans la définition de l’application de workflow.
Les versions 3.1.0 et antérieures de WorkflowGen.My portent des noms forts, donc votre assembly doit être généré par votre version de WorkflowGen cible et doit également utiliser cette version. Cela nécessite la recompilation de votre assembly à chaque fois que vous mettez à jour WorkflowGen à une version plus récente.
Vous pouvez utiliser l’une d’entre les trois solutions suivantes pour surmonter cette exigence :
Installez la version de WorkflowGen.My requise dans le Global Assembly Cache du système. Pour savoir comment faire, voir .
OU
Ajoutez un délégué pour gérer l’événement de résolution de l’assembly afin de charger la version de WorkflowGen.My courante. Pour savoir comment faire, voir l’article dans la base de connaissances de WorkflowGen.
OU
Depuis la version 3.2.0, WorkflowGen.My ne porte plus de nom fort afin de permettre une dépendance de version non-spécifique quand il est référencé par votre assembly. Vous pouvez tout simplement déployer votre fichier d’assembly dans les versions 6.2.0 et ultérieures de WorkflowGen en utilisant l’une des deux méthodes dans la section ci-dessus.
Si votre assembly utilise des bibliothèques de logiciels tiers, celles-ci doivent également être déployées dans les trois dossiers \bin qui contiennent les fichiers exécutables de WorkflowGen. Par ailleurs, les bibliothèques peuvent être installées dans le Global Assembly Cache du système si elles sont des assemblys avec nom fort.
WorkflowGen est compatible FIPS à partir de la version 7.10.0. Si vous voulez activer la conformité FIPS dans votre environnement Windows, il faut tout d'abord configurer le mode de gestion des mots de passe de la configuration et le mode de gestion des mots de passe des utilisateurs dans le module d'administration.
Dans la section Sécurité sur l'onglet Général du panneau de configuration, réglez Mode de gestion des mots de passe sur le mode AES (FIPS Compliant) et saisissez une clé de chiffrement comportant 32 caractères. Lorsque vous cliquez sur Enregistrer, les mots de passe de l'application seront automatiquement convertis en mode de chiffrement symétrique.
Dans la section Authentification sur l'onglet Général du panneau de configuration, réglez Mode de gestion des mots de passe en mode One-way Hashing (SHA256 FIPS Compliant).
Si vous utilisez l'authentification applicative en mode Version 5 (Legacy), les mots de passe des utilisateurs seront automatiquement convertis en mode One-way Hashing (SHA56 FIPS Compliant) la prochaine fois qu'ils se connectent à WorkflowGen.
Si vous utilisez l'authentification applicative en mode One-way Hashing (SHA256) :
Sélectionnez le mode d'authentification IIS.
WorkflowGen ne supporte plus Internet Explorer, Windows XP, Windows 7, Windows 8 et Windows Server 2003 ou 2008.
MS SQL Server 2005 n'est plus supporté depuis la version 6.2.0 de WorkflowGen, MS SQL Server 2008 n'est plus supporté depuis la version 7.10.0 de WorkflowGen, et MS SQL Server 2012 n'est plus supporté depuis la version 8.2.0 de WorkflowGen.
La base de données Oracle n'est plus supportée à partir de la version 7.16.0 de WorkflowGen.
Les applications suivantes sont obsolètes et ne sont plus fournies avec WorkflowGen depuis la version 6 :
EFORMPDF
DOCAPPROVAL
DOCUPLOAD
FDFTOXML
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.
Les applications suivantes sont distribuées avec WorkflowGen (licences Apache 2.0, BSD, MIT et autres licences compatibles) :
bluebird (voir )
busboy (voir )
body-parser (voir )
change-case (voir )
Réglez ou mettez à jour les nœuds suivants dans le fichier web.config du formulaire Web :
Si le mode d’authentification de votre formulaire Web est configuré avec l’authentification WorkflowGen de base, le nouveau mode de hachage des mots de passe (« One-way Hashing ») introduit dans la version 6.1 ne sera pas compatible avec votre formulaire Web. Il existe deux solutions :
Utilisez le mode de gestion des mots de passe Version 5 à la place. Assurez-vous que vous utilisez les fichiers Advantys.My.dll et Advantys.Security.dll de la version 5.x dans le dossier \bin de votre formulaire Web.
OU
Migrez votre formulaire Web en .NET 4. Assurez-vous que vous utilisez les fichiers Advantys.My.dll et Advantys.Security.dll de la version 8.x.x ou ultérieure dans le dossier \bin de votre formulaire Web. Pour des instructions sur la migration en .NET 4, voir la section suivante.
Si le mode d’authentification de votre formulaire Web est configuré avec l’authentification WorkflowGen de base, assurez-vous que vous utilisez les fichiers Advantys.My.dll et Advantys.Security.dll en version 8.x.x ou ultérieure dans le dossier \bin du formulaire web.
\binWorkflowGenMy.*.resxApp_GlobalResourcesSélectionnez le mode de gestion des mots de passe One-way Hashing (SHA256 FIPS Compliant), et cliquez sur Enregistrer.
Ressaisissez tous les mots de passe des utilisateurs.
Réinitialisez le mode d'authentification en mode applicatif.
PDFTODATABASE
chart.js (licence MIT)
cookie-parser (voir https://github.com/expressjs/cookie-parser/blob/master/LICENSE)
dataloader (voir https://github.com/facebook/dataloader/blob/master/LICENSE)
edge-js (voir https://github.com/agracio/edge-js/blob/master/LICENSE)
eml-format (voir https://github.com/papnkukn/eml-format/blob/master/LICENSE)
express (voir https://github.com/expressjs/express/blob/master/LICENSE)
express-graphql (voir https://github.com/graphql/express-graphql/blob/master/LICENSE)
file-uri-to-path (voir https://github.com/TooTallNate/file-uri-to-path/blob/master/LICENSE)
file-url (voir https://github.com/sindresorhus/file-url/blob/master/license)
format (voir https://sjs.mit-license.org)
graphiql (voir https://github.com/graphql/express-graphql/blob/master/LICENSE)
graphql-js (voir https://github.com/graphql/graphql-js/blob/master/LICENSE)
graphql-relay-js (voir https://github.com/graphql/graphql-relay-js/blob/master/LICENSE)
graphql-tools (voir https://github.com/apollographql/graphql-tools/blob/master/LICENSE)
graphql-upload (voir https://github.com/jaydenseric/graphql-upload/blob/master/LICENSE)
htmx.org (voir https://github.com/bigskysoftware/htmx/blob/master/LICENSE)
iisnode (voir https://github.com/Azure/iisnode/blob/master/LICENSE.txt)
jquery (voir https://jquery.com/license/)
jquery-colorbox (voir https://plugins.jquery.com/colorbox/)
jquery-ui (voir https://github.com/jquery/jquery-ui/blob/main/LICENSE.txt)
jquery-validation (voir https://github.com/jquery-validation/jquery-validation/blob/master/LICENSE.md)
jsonwebtoken (voir https://github.com/auth0/node-jsonwebtoken/blob/master/LICENSE)
jwks-rsa (voir https://github.com/auth0/node-jwks-rsa/blob/master/LICENSE)
lodash (voir https://github.com/lodash/lodash/blob/master/LICENSE)
lucide (voir https://github.com/lucide-icons/lucide/blob/main/LICENSE)
mocha (voir https://github.com/mochajs/mocha/blob/master/LICENSE)
mockery (voir https://github.com/mfncooper/mockery/blob/master/LICENSE)
Node.js (voir https://github.com/nodejs/node/blob/master/LICENSE)
parse5 (voir https://github.com/inikulin/parse5/blob/master/LICENSE)
proper-lockfile (voir https://github.com/moxystudio/node-proper-lockfile/blob/master/LICENSE)
pug (licence MIT)
request-promise-native (voir https://github.com/request/request-promise-native/blob/master/LICENSE)
rimraf (voir https://github.com/isaacs/rimraf/blob/master/LICENSE)
samlify (voir https://github.com/tngan/samlify/blob/master/LICENSE)
seriate (voir https://github.com/LeanKit-Labs/seriate/blob/master/LICENSE)
sinon (voir https://github.com/sinonjs/sinon/blob/master/LICENSE)
supertest (voir https://github.com/visionmedia/supertest/blob/master/LICENSE)
valid-url (voir https://github.com/ogt/valid-url/blob/master/LICENSE)
xml-js (voir https://github.com/nashwaan/xml-js/blob/master/LICENSE)
yargs (voir https://github.com/yargs/yargs/blob/master/LICENSE)
<configuration>
<system.web>
<pages validateRequest="false" enableSessionState="true" />
</system.web>
</configuration><configuration>
<system.web>
<httpRuntime requestValidationMode="2.0" targetFramework="4.8" />
<pages validateRequest="false" enableSessionState="true" clientIDMode="AutoID" controlRenderingCompatibilityVersion="3.5" />
</system.web>
</configuration>