Mise à jour

Aperçu

Les procédures suivantes s’appliquent au pack de mise à jour WorkflowGen 10.0.1 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>
        <dependentAssembly>
            <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
        </dependentAssembly>
        <dependentAssembly>
            <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-6.0.0.10" newVersion="6.0.0.10" />
        </dependentAssembly>
        <dependentAssembly>
            <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
        </dependentAssembly>
        <dependentAssembly>
            <assemblyIdentity name="System.ClientModel" publicKeyToken="92742159e12e44c8"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-1.2.1.0" newVersion="1.2.1.0" />
        </dependentAssembly>
        <dependentAssembly>
            <assemblyIdentity name="System.Diagnostics.DiagnosticSource" publicKeyToken="cc7b13ffcd2ddd51"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-6.0.0.1" newVersion="6.0.0.1" />
        </dependentAssembly>
        <dependentAssembly>
            <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51"
            culture="neutral" />
            <bindingRedirect oldVersion="0.0.0.0-4.0.1.2" newVersion="4.0.1.2" />
        </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 aux fichiers de configuration 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.5 à la version 10.0.10 (v10 Preview 1) vous devez appliquer les modifications indiquées dans les sections Mise à jour pour les versions 9.0.7 et antérieures, Mise à jour pour les versions 9.1.0 et antérieures, Mise à jour pour les versions 9.2.5 et antérieures et Mise à jour pour les versions 10.0.0 et antérieures.

• Pour passer de la version 10.0.0 (v10 Preview 1) à la version 10.0.1 (v10 Preview 2), vous devez appliquer les modifications indiquées dans la section Mise à jour pour les versions 10.0.0 (v10 Preview 1) et antéireures 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 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 versions 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>

Mise à jour pour les versions 9.2.5 et antérieures

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

   <add key="EngineServiceDataIndexingFrequency" value="10000" />
   
   <!-- Chunks and Embeddings -->
   <add key="GenerateChunksBatchSize" value="200" />
   <add key="GenerateChunksSize" value="1000" />
   <add key="GenerateChunksOverlap" value="200" />
   <add key="GenerateChunksMaxCount" value="100" />
   <add key="GenerateChunksLanguageCode" value="0" />
   <add key="GenerateEmbeddingsApiProvider" value="openai" />
   <add key="GenerateEmbeddingsApiEndpoint" value="https://api.openai.com/v1/embeddings" />
   <add key="GenerateEmbeddingsApiKey" value="" />
   <add key="GenerateEmbeddingsApiModel" value="text-embedding-3-small" />
   <add key="GenerateEmbeddingsApiDimensions" value="384" />
   <add key="GenerateEmbeddingsApiCallDelay" value="100" />
   <add key="GenerateEmbeddingsApiMaxRetries" value="10" />

   ⚠️ Important : Le code de langue par défaut pour la recherche en texte intégral (GenerateChunksLanguageCode dans le fichier web.config et l’index de la table de base de données WFDATASET_CHUNK) est défini sur 0 (Neutre). Nous recommandons de le définir sur le code de langue approprié correspondant à la langue principale de vos données de requête et des valeurs de fichier pour de meilleurs résultats de recherche. Par exemple, utilisez 1033pour l'anglais ou 1036 pour le français :

   <add key="GenerateChunksLanguageCode" value="1036" />

   Vous devez également définir le même code de langue dans le script de création de base de données (Create_WFG_SQL_Indexes.sql) ou dans le script de mise à jour (Update_WFG-V10-0-0.sql) avant de l'exécuter :

   CREATE FULLTEXT INDEX ON WFDATASET_CHUNK
   (
       CHUNK LANGUAGE 1036 -- Français
   )
   KEY INDEX PK_CHUNK
   ON WFDATASET_CATALOG

   Pour obtenir la liste complète des codes de langue supportés, exécutez la requête SQL suivante dans SQL Server Management Studio (SSMS) :

   select * from sys.fulltext_languages;

   📌 Exemple de configuration lors de l'utilisation de l'API OpenAI Embeddings :

   <add key="GenerateEmbeddingsApiProvider" value="openai" />
   <add key="GenerateEmbeddingsApiEndpoint" value="https://api.openai.com/v1/embeddings" />
   <add key="GenerateEmbeddingsApiKey" value="VOTRE_CLÉ_API_OPENAI" />
   <add key="GenerateEmbeddingsApiModel" value="text-embedding-3-small" />

   📌 Exemple de configuration lors de l'utilisation de l'API Azure OpenAI Embeddings :

   <add key="GenerateEmbeddingsApiProvider" value="azure-openai" />
   <add key="GenerateEmbeddingsApiEndpoint" value="https://custom-domain.openai.azure.com" />
   <add key="GenerateEmbeddingsApiKey" value="VOTRE_CLÉ_API_AZURE_OPENAI" />
   <add key="GenerateEmbeddingsApiModel" value="text-embedding-3-small" />

   📌 Exemple de configuration lors de l'utilisation d'un serveur local LM Studio avec un modèle d'embedding de texte personnalisé :

   <add key="GenerateEmbeddingsApiProvider" value="lm-studio" />
   <add key="GenerateEmbeddingsApiEndpoint" value="http://localhost:1234/v1/embeddings" />
   <add key="GenerateEmbeddingsApiKey" value="VOTRE_CLÉ_API_LM_STUDIO" />
   <add key="GenerateEmbeddingsApiModel" value="text-embedding-all-minilm-l6-v2-embedding" />

2. Ajoutez le nouvel élément dependentAssembly à la section <runtime> :

   <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>
           <dependentAssembly>
               <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.10" newVersion="6.0.0.10" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.ClientModel" publicKeyToken="92742159e12e44c8"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-1.2.1.0" newVersion="1.2.1.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Diagnostics.DiagnosticSource" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.1" newVersion="6.0.0.1" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.1.2" newVersion="4.0.1.2" />
           </dependentAssembly>
       </assemblyBinding>
   </runtime>

3. Dans le fichier Program Files/Advantys/WorkflowGen/Services/bin/WfgWorkflowEngineService.exe.config, ajoutez le nouvel élément dependentAssembly à la section <runtime> :

   <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>
           <dependentAssembly>
               <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.10" newVersion="6.0.0.10" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.ClientModel" publicKeyToken="92742159e12e44c8"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-1.2.1.0" newVersion="1.2.1.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Diagnostics.DiagnosticSource" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.1" newVersion="6.0.0.1" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.1.2" newVersion="4.0.1.2" />
           </dependentAssembly>
       </assemblyBinding>
   </runtime>

4. Dans le fichier \wfgen\ws\web.config , ajoutez le nouvel élément dependentAssembly à la section <runtime> :

   <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>
           <dependentAssembly>
               <assemblyIdentity name="System.Runtime.CompilerServices.Unsafe" publicKeyToken="b03f5f7f11d50a3a"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.0" newVersion="6.0.0.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Text.Json" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.10" newVersion="6.0.0.10" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Buffers" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.3.0" newVersion="4.0.3.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.ClientModel" publicKeyToken="92742159e12e44c8"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-1.2.1.0" newVersion="1.2.1.0" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Diagnostics.DiagnosticSource" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-6.0.0.1" newVersion="6.0.0.1" />
           </dependentAssembly>
           <dependentAssembly>
               <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51"
               culture="neutral" />
               <bindingRedirect oldVersion="0.0.0.0-4.0.1.2" newVersion="4.0.1.2" />
           </dependentAssembly>
       </assemblyBinding>
   </runtime>

Mise à jour pour les versions 10.0.0 (v10 Preview 1) et antérieures

Ajoutez les paramètres suivants à <appSettings> :

<add key="GenerateEmbeddingsApiAuthMethod" value="bearer" />
<add key="GenerateEmbeddingsApiAuthHeader" value="Authorization" />
<add key="GenerateEmbeddingsApiRetriesDelay" value="5000" />

📌 Exemple de configuration pour l'API Azure OpenAI Embeddings qui utilise la méthode et l'en-tête api-key :

<add key="GenerateEmbeddingsApiAuthMethod" value="api-key" />
<add key="GenerateEmbeddingsApiAuthHeader" value="api-key" />

📌 Exemple de configuration pour l'API OpenAI ou d''un serveur local LM Studio qui utilise la méthode bearer et l'en-tête Authorization :

<add key="GenerateEmbeddingsApiAuthMethod" value="bearer" />
<add key="GenerateEmbeddingsApiAuthHeader" value="Authorization" />

Mettre à jour le fichier de configuration Web racine

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 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 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.2.5 et antérieures

Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V10-0-0.sql dans vos outils SQL Server Management Studio.

⚠️ Important : Si vous avez modifié le code de langue dans le paramètre GenerateChunksLanguageCode du fichier web.config (par défaut 0 pour Neutre) pour la recherche en texte intégral, vous devez mettre à jour manuellement le code de langue dans le script Update_WFG-V10-0-0.sql. Si vous créez une nouvelle base de données WorkflowGen, mettez à jour le script Create_WFG_SQL_Indexes.sql à la place. Le code de langue doit correspondre à la nouvelle valeur de GenerateChunksLanguageCode. Par exemple, utilisez 1033 pour l'anglais ou 1036 pour le français.

CREATE FULLTEXT INDEX ON WFDATASET_CHUNK
(
    CHUNK LANGUAGE 1036 -- Français
)
KEY INDEX PK_CHUNK
ON WFDATASET_CATALOG

Pour récupérer la liste complète des codes de langue pris en charge, exécutez la requête SQL suivante dans SQL Server Management Studio (SSMS) :

select * from sys.fulltext_languages;

Depuis les versions 10.0.0 (v10 Preview 1) et antérieures

Exécutez le script de mise à jour de base de données Update\Databases\MsSQLServer\Update_WFG-V10-0-1.sql dans vos outils SQL Server Management Studio.

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