Mise à jour WorkflowGen 9.2.1

Aperçu

Les procédures suivantes s’appliquent au pack de mise à jour WorkflowGen 9.2.1 bêta 2 disponible à l'adresse suivante : https://github.com/advantys/workflowgen-releases/releases.

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épertoires 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.

Base de données

Faites une sauvegarde standard de la base de données au moyen des outils DBMS.

Mettre à jour les fichiers des applications Web WorkflowGen

Supprimer les fichiers et dossiers obsolètes des applications Node.js

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.

  1. Supprimez les fichiers et dossiers suivants du dossier \wfgen\graphql :

    • \controllers

    • \models

    • \node_modules

    • \services

    • \utils

    • config.js

    • config.production.js

    • server.js

  2. 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

  3. Supprimez les fichiers et dossiers suivants du dossier \wfgen\auth :

    • \controllers

    • \models

    • \node_modules

    • \static

    • \utils

    • config.js

    • config.production.js

    • server.js

  4. Supprimez les fichiers et dossiers suivants du dossier \wfgen\scim :

    • \controllers

    • \models

    • \node_modules

    • \services

    • \utils

    • config.js

    • config.production.js

    • server.js

Supprimer les fichiers d'assembly obsolètes

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

  • 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

Copier le contenu du pack de mise à jour

É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.

  • 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

Mettre à jour les fichiers des services Windows WorkflowGen

Supprimer le fichier DLL obsolète

Supprimez le fichier DISQUE:\Program Files\Advantys\WorkflowGen\Services\bin\EAGetMail40.dll obsolète.

Écraser le répertoire des services Windows WorkflowGen

É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.

Mettre à jour les fichiers de programme Node.js

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 :

<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" />

Mettre à jour les fichiers de configuration

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 Mise à jour héritée de WorkflowGen 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.

📌 Exemples

  • Pour passer de la version 9.0.1 bêta 2 à la version 9.2.1 bêta 2 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 à la version 9.2.1 bêta 2, 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 Supprimer l’attribut xmlns).

Mise à jour pour les versions 8.0.0 et antérieures

  1. Ajoutez les nouveaux paramètres suivants à <appSettings>:

    <add key="RemoteApprovalAuthClientId" value="" />
<add key="RemoteApprovalAuthClientSecret" value="" />
<add key="RemoteApprovalAuthScope" value="" />
<add key="RemoteApprovalAuthAccessTokenUri" value="" />

  2. Supprimez le paramètre obsolète suivant de <appSettings>:

    EngineTraceMode

Mise à jour pour les versions 8.0.1 et antérieures

Ajoutez les nouveaux paramètres suivants à <appSettings>:

<!-- 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" />

Mise à jour pour les versions 8.0.2 et antérieures

<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" />

Mise à jour pour les versions 8.0.7 et antérieures

  1. Ajoutez le nouveau paramètre suivant à <appSettings> :

    <add key="EngineServiceMaxPausedSynchroActions" value="25" />

  2. Mettez à jour la valeur du paramètre EngineServiceTimeoutSystemActionFrequency à 120000 comme suit :

    <add key="EngineServiceTimeoutSystemActionFrequency" value="120000" />

Mise à jour pour les versions 8.0.10 et antérieures

Ajoutez les nouveaux paramètres suivants à <appSettings>:

<add key="PortalReportAdvancedViewPaging" value="N" />

Mise à jour pour les versions 8.1.0 bêta et antérieures

  1. Mettez à jour la valeur du paramètre suivant dans <appSettings> :

    <add key="PortalListPageSize" value="25" />

  2. Supprimez les valeurs suivantes de <appSettings> pour la version 8.1.0 bêta uniquement:

    <add key="PortalReportAdvancedViewPageSize" value="25" />
<add key="PortalReportAdvancedViewPageSizeOptions" value="10,25,50,100,250" />

Mise à jour pour les versions 8.1.2 et antérieures

Ajoutez les nouveaux paramètres suivants à <appSettings> :

<add key="GraphqlApiKeyEnabled" value="N" />
<add key="GraphqlApiKey" value="" />

Mise à jour pour les versions 8.1.3 et antérieures

  1. Ajoutez les nouveaux paramètres suivants à <appSettings> :

    <add key="PortalDisplayAssignedTeamAction" value="N" />
<add key="HooksAllowImpersonateUser" value="N" />
<add key="HooksApiKeyEnabled" value="N" />
<add key="HooksApiKey" value="" />

  2. 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" /> :

    • \wfgen\web.config

    • \wfgen\ws\web.config

    • \Program Files\Advantys\WorkflowGen\Services\bin\WfgWorkflowEngineService.exe.config

    • \Program Files\nodejs\node.exe.config

Mise à jour pour les versions 8.2.4 et antérieures

  1. Ajoutez le nouveau paramètre suivant à <appSettings> :

    <add key="ApplicationDefaultFullWidth" value="N" />

  2. Mettez à jour la valeur du paramètre suivant dans <appSettings> :

    <add key="PortalCommentsPopUpHeight" value="600" />

  3. Supprimez les paramètres obsolètes de <appSettings> :

    ChartServiceAvoidColorCollision
ChartServiceMaxSliceInPie
ReportsChartServiceUrl
ReportsChartTemplatePath
ReportsChartTemplateExtension

Mise à jour pour les versions 8.2.4 et antérieures OU la version 9.0.0 bêta (v9 bêta 1)

Ajoutez les nouveaux paramètres suivants à <appSettings> :

<!-- 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" />

Mise à jour pour les versions 9.0.1 (v9 bêta 2) et antérieures

Ajoutez les nouveaux paramètres suivants à <appSettings> : 

<add key="PortalDisplayRequestListWithActionsFollowUp" value="N" />

<!-- OpenAi -->
<add key="OpenAiApiKey" value="" />
<add key="OpenAiTranscriptionLogLevel" value="0" />

Mise à jour pour les versions 9.0.2 (v9 bêta 3) et antérieures

Ajoutez le nouveau paramètre suivant à <appSettings> : 

<add key="OpenAiChatLogLevel" value="0" />

Mise à jour pour les versions 9.0.7 et antérieures

  1. Renommez les paramètres suivants dans <appSettings>:

    <!-- OpenAI -->
OpenAiApiKey
OpenAiTranscriptionLogLevel
OpenAiChatLogLevel

    comme

    <!-- OpenAI -->
OpenAIApiKey
OpenAITranscriptionLogLevel
OpenAIChatLogLevel

  2. Ajoutez le noiuveau paramètre suivant à <appSettings>:

    <!-- OpenAI -->
<add key="OpenAIChatApiUrl" value="" />

Mise à jour pour les version 9.1.0 et antérieures

Si vous souhaitez activer la gestion par défaut des erreurs HTTP par WorkflowGen, remplacez le paramètre suivant dans <appSettings> :

<customErrors mode="Off"/>

par le suivant :

<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>

Mettre à jour le fichier de configuration Web racine

Cette étape est obligatoire lors de la mise à jour vers la version 9.2.1 bêta 2, y compris si vous effectuez une mise à jour depuis la version 9.2.0 bêta 1 et que vous aviez déjà mis à jour le fichier racine web.config.

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 URL Rewrite 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 pour les nouvelles règles.

Mettre à jour le fichier d'exemple 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 :

  1. Ouvrez le fichier /wfgen/login.aspx de votre site WorkflowGen (qui pourrait avoir été renommé).

  2. Remplacez la ligne redirectToUrl = "/wfgen/show.aspx?QUERY=WELCOME"; par redirectToUrl = "/wfgen/dashboard";.

Supprimer l’attribut xmlns

À partir de la version 7 de WorkflowGen, vous devez supprimer l’attribut xmlns dans les fichiers de configuration suivants :

\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

Pour ce faire, remplacez <configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0"> par <configuration>.

Mettre à jour le fichier de configuration Web racine

Configurer le site Web racine de WorkflowGen pour une redirection automatique vers l'application Web wfgen

À partir de la version 7.21.0, vous devez configurer votre site Web racine WorkflowGen (p.ex, https://serveur) pour se rediriger automatiquement vers l'application Web https://serveur/wfgen. Pour ce faire, suivez la procédure ci-dessous :

  1. Assurez-vous que l'outil URL Rewrite est déjà installé sur votre serveur WorkflowGen.

  2. Créez ou mettez à jour le fichier web.config dans le dossier racine de votre site Web (p.ex. DISQUE:\inetpub\wwwroot\web.config).

    ⚠️ Attention : Il ne s'agit pas du même fichier web.config que le fichier web.config principal de WorkflowGen (situé dans DISQUE:\inetpub\wwwroot\wfgen\web.config).

  3. Définissez le nœud de la règle de réécriture comme indiqué ci-dessous (configuration / system.webServer / <rewrite> / <rules> / <rule>) :

    <?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Rewrite to wfgen" stopProcessing="true">
                    <match url="(^$|^wfgen$|^wfgen/$)" />
                    <action type="Rewrite" url="/wfgen/show.aspx?QUERY=CONTEXT&amp;REQUEST_QUERY=WELCOME&amp;NO_REDIR=Y" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>

Mettre à jour les formulaires Web créés dans l'éditeur de formulaires pour les versions 8 et ultérieures

À 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 :

Utilisez le script PowerShell fourni

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.

Exemple d'utilisation

.\update-webforms-wfg-my-assembly.ps1 -Path "c:\inetpub\wwwroot\wfgen\wfapps\webforms" -Verbose

Procédure manuelle

  1. Supprimez les fichiers et dossiers suivants du dossier \wfgen\wfapps\webforms\bin\ :

    • WorkflowGen.My.Web.UI.WebControls.dll

    • WorkflowGen.My.Web.Handlers.dll

    • \de

    • \fr

    • \hu

    • \pl

  2. 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.

Mettre à jour les fichiers de configuration de GraphQL et des webhooks

Ajoutez la ligne suivante à <system.webServer> dans les fichiers \wfgen\graphql\web.config et \wfgen\hooks\web.config\ :

<httpErrors existingResponse="PassThrough" errorMode="Detailed"></httpErrors>

Mettre à jour le fichier de configuration de synchronisation des annuaires

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

<add key="ServiceName" value="WorkflowGenDirSyncService" />

Mettre à jour le fichier de configuration du service du moteur WorkflowGen

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" />

Déplacer le fichier de transactions XMLTODATABASE

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.

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.

La base de données Oracle n'est plus supportée à partir de la version 7.16.0 de WorkflowGen.

MS SQL Server

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 Mise à jour héritée de WorkflowGen 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.

Depuis les versions 8.0.1 et antérieures

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.

Depuis les versions 8.0.2 et antérieures

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.

Depuis les versions 8.0.x et antérieures

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.

Depuis les versions 8.1.3 et antérieures

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.

Depuis les versions 8.2.4 et antérieures ou la version 9.0.0 bêta (v9 bêta 1)

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.

Depuis les versions 9.0.1 bêta (v9 bêta 2) et antérieures

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.

Depuis les versions 9.0.2 bêta (v9 bêta 3) et antérieures

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.

Depuis les versions 9.0.7 et antérieures

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.

Depuis les versions 9.1.0 et 9.2.0 bêta 1

Il n'y a aucun script de mise à jour de base de données à exécuter.

Configuration de IIS

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.

Mettre à jour ou créer le groupe d’applications en .NET 4

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 :

  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 :

    • 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 sur Allowed dans la liste de restrictions ISAPI et CGI de IIS.

Applications Web basées sur Node.js

Pour utiliser les API GraphQL, webhooks entrants, OpenID Connect Auth et SCIM facultatives, vous devez d'abord installer les prérequis suivants :

  • Node.js v18.20.4

  • iisnode

  • IIS URL Rewrite

  • Visual C ++ Redistributable ✏️ Note : Cette bibliothèque est requise si vous rencontrez l'erreur Le module spécifié est introuvable (The specified module could not be found) concernant les bibliothèques edge et edge-js lors de l'accès aux applications Web /wfgen/graphql, /wfgen/hooks ou /wfgen/scim.

  • Supprimez le dossier node_modules de chaque application basée sur Node.js (situé sous \wfgen\auth, \wfgen\graphql, \wfgen\hooks et \wfgen\scim) avant de copier les fichiers du pack de mise à niveau.

  • Aprè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 activer GraphQL :

  1. Dans IIS, convertissez /wfgen/graphql en application avec un pool d’applications en .NET 4 (mode pipeline intégré).

  2. Configurez le mode d’authentification de l’application GraphQL :

    • Pour l’authentification de base : Activez l’authentification de base.

    • 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.

  3. 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="" />

Résolution des problèmes

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 https://support.microsoft.com/fr-fr/help/2977003/the-latest-supported-visual-c-downloads.

Pour activer les webhooks entrants :

  1. Mettez à jour le fichier web.config de WorkflowGen avec les paramètres suivants utilisés par les webhooks entrants :

    <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="" />

  2. 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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /hooks/web.config comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="hooks" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée :

<location path="hooks" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>

Pour activer SCIM :

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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /scim/web.config comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="scim" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée :

<location path="scim" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>

Pour activer OpenID Connect Auth :

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.

Si votre WorkflowGen est configuré avec l’authentification applicative WorkflowGen ou une authentification personnalisée, vous devez supprimer le module d’authentification du fichier /auth/web.config comme suit :

Pour l'authentification applicative WorkflowGen :

<location path="auth" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="ApplicationSecurityAuthenticationModule" />
        </modules>
    </system.webServer>
</location>

Pour l'authentification personnalisée :

<location path="auth" inheritInChildApplications="false">
    <system.webServer>
        <modules>
            <remove name="MyCustomAuthModule" />
        </modules>
    </system.webServer>
</location>

Redémarrer le serveur WorkflowGen

Redémarrez votre serveur 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

Dernière mise à jour