Procédures facultatives

Modules Node.js

Les modules Node.js incluent l'API GraphQL, les « webhooks », SCIM et Auth. Pour les utiliser, vous devez d’abord installer les prérequis suivants :

Pour activer WorkflowGen 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 : Activer 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, et 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="Y" />

    <add key="GraphqlLoadersCacheEnabled" value="Y" />

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

Pour activer les webhooks entrants :

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

    Note : 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 ».

    Authentification applicative WorkflowGen :

    <system.webServer>
    <modules>
    <remove name="ApplicationSecurityAuthenticationModule" />
    </modules>
    </system.webServer>

    Authentification personnalisée :

    <system.webServer>
    <modules>
    <remove name="MyCustomAuthModule" />
    </modules>
    </system.webServer>
  2. Mettez à jour le fichier `web.config` de WorkflowGen avec le paramètre suivant utilisé par les webhooks entrants :

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

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.

Note : 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.

Pour l'authentification applicative WorkflowGen :

<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>

Pour l'authentification personnalisée :

<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>

Pour activer 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.

Note : 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.

Pour l'authentification applicative WorkflowGen :

<system.webServer>
<modules>
<remove name="ApplicationSecurityAuthenticationModule" />
</modules>
</system.webServer>

Pour l'authentification personnalisée :

<system.webServer>
<modules>
<remove name="MyCustomAuthModule" />
</modules>
</system.webServer>

Note : Après l’activation des modules 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.

Approbation à distance

La fonctionnalité d’Approbation à distance (Remote Approval) est maintenant intégrée dans WorkflowGen, et n’est plus un module distinct.

Pour des information sur le paramétrage de l’Approbation à distance, voir la documentation WorkflowGen.

Si vous avez l’ancien module d’Approbation à distance configuré, suivez les étapes suivantes.

  1. Désinstallez le module Approbation à distance (il est recommandé de sauvegarder tous les fichiers et dossiers antérieurs du module d’Approbation à distance) :

    1. Arrêtez le service Approbation à distance depuis la liste de services Windows. Le service est généralement nommé WorkflowGen RemoteApproval ou WorkflowGen EmailListener.

    2. Supprimez le dossier DISQUE:\Program Files (x86)\Advantys\WorkflowGen\RemApp\.

    3. Supprimez les fichiers \wfgen\bin\RemoteApprovalConfig.dll et \wfgen\admin\RemoteApprovalConfig.aspx.

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

  3. Cochez Activer depuis l’onglet Approbation à distance dans le Panneau de configuration du Module d’administration.

    Notes :

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

  4. Facultatif : Supprimez les paramètres suivants qui ne sont plus utilisés dans WorkflowGen du fichier « web.config » :

    RemoteApprovalWorkflowGenAppDomain

    RemoteApprovalEmailListenerServiceName

    RemoteApprovalWorkflowGenAppUsername

    RemoteApprovalWorkflowGenAppPassword

  5. 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 l’exemple de processus Approbation à distance disponible sur le forum et base de connaissances WorkflowGen.

Configuration du site Web racine de WorkflowGen pour une redirection automatique vers l'application Web wfgen

Si vous souhaitez que votre site Web racine WorkflowGen (p.ex. https://serveur) se redirige automatiquement vers l'application Web (p.ex. https://serveur/wfgen), suivez la procédure ci-dessous.

Note : À partir de WorkflowGen 7.15.0, la configuration PowerShell est livrée avec cette configuration préinstallée sur votre serveur WorkflowGen. Cette procédure est applicable uniquement lors de la mise à jour d'un serveur WorkflowGen précédent existant.

  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. DRIVE:\inetpub\wwwroot\web.config).

  3. Définissez le nœud de la règle de redirection comme suit (configuration / system.webServer / <rewrite> / <rules> / <rule>) :

    <?xml version="1.0" encoding="UTF-8"?>
    <configuration>
    <system.webServer>
    <rewrite>
    <rules>
    <rule name="Root to wfgen" stopProcessing="true">
    <match url="^$" />
    <action type="Redirect" url="/wfgen/" />
    </rule>
    </rules>
    </rewrite>
    </system.webServer>
    </configuration>

Désactiver et supprimer les applications de workflow dans IIS

Depuis la version 6.0, les applications de workflow suivantes sont intégrées en tant qu’applications intégrées ou d’assemblage. Les applications Web correspondantes peuvent alors être désactivées et supprimé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

Créer une base de données WorkflowGen vide

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.