Avanteam Process Studio v23.3

Objet

Installation et contenu du pack v23.3.

Domaines d’application

La migration exige que les applications AVANTEAM soient en version .Net :

• v21.21
• v23.2

Procédure d'installation

Lancer AutoUpgradeTool.exe v2.1 en tant qu’administrateur et appliquer la mise à jour.

Correctifs

Outils d’administration

APS-4708 - Impossible de publier une vue avec la CLI

Une erreur était générée aléatoirement lors de l’utilisation de l’interface de ligne de commandes aps permettant de regénérer les vues. De plus, l’outil MigScheduleTable qui permettait de migrer les données des agents vers la nouvelle structure de données n’est plus livré car obsolète.

ImportDocs

APS-4646 - Raccourcis clavier dans ImportDocs

Depuis la version v23.0 et la mise en place du shim, les raccourcis claviers ne fonctionnaient plus pour l’outil ImportDocs : il n’était plus par exemple possible de réaliser de copier / coller. Un correctif a été apporté pour corriger l’anomalie.

Process Studio

APS-2666 – Décimales dans un tableau de détails

Soit le scénario suivant : un tableau de détails est réalisé et comporte en première ou dernière colonne une entrée dont la valeur peut être un chiffre décimal avec une précision supérieure à 0. Lors de la saisie des données dans ce tableau par l’utilisateur final, si la touche « Tab » (tabulation) est utilisée pour valider la ligne du tableau en cours d’édition, alors la valeur rentrée était tronquée et les décimales n’étaient pas prises en compte. Cette anomalie de comportement est maintenant gérée lors de la validation des entrées.

APS-4308 - Aucune chaîne de connexion n'a été définie

Dans l’écran de définition des liens, deux boutons « Exécuter la requête » permettent de valider et prévisualiser les résultats des requêtes SQL écrites. Néanmoins, l’appuie sur ce bouton ouvrait systématiquement une pop-up contenant le message « Aucune chaîne de connexion n’a été définie. ». Le lien vers la chaîne de connexion de l’application a été rétabli.

APS-4730 - Bordures du concepteur de formulaires

Depuis la version v21.9, le concepteur de formulaires ne présentait plus les bordures du tableau de mise en forme lorsqu’un élément était sélectionné. Les bordures sont de nouveau visibles, permettant à l’administrateur d’avoir à disposition une aide pour positionner les champs.

Interface web

APS-3812 – Anomalies délégations

Il a été remonté que les valeurs qui peuvent être rentrées afin d’indiquer la date de début et de fin d’une délégation ne sont pas validées. Ce faisant, si la valeur ne correspondait pas à une date, une exception était levée.

APS-4270 - Suppression dans le champ fichier

Dans le cas d’une application configurée avec une authentification Windows des comptes utilisateurs, si un champ de type « Fichier » était présent dans un formulaire, l’utilisateur voyait apparaître une mire d’authentification lorsqu’il souhaitait supprimer un des fichiers du champ à l’intérieur du formulaire. Cette anomalie résultait du « verbe » utilisé lors de la demande de suppression et se retrouvait aussi lorsqu’un utilisateur souhaitait supprimer un message sur le « mur » TeamConnect d’un document. Une réarchitecture permet maintenant de ne plus avoir de demande de réauthentification.

APS-4648 - Désactivation de l'auto inscription

Depuis la v23.0, lors de la mise en place de l’authentification par un IdP, si l’utilisateur était correctement authentifié par l’IdP mais n’était pas enregistré dans l’application, il lui était proposé de renseigner ses informations afin de s’enregistrer dans l’application. Cette fonctionnalité est désactivée pour forcer l’enregistrement des utilisateurs par un administrateur.

APS-4690 - Vue UserList en erreur sous Oracle

Depuis la version v23.1, l’écran affichant la liste des utilisateurs générait une erreur lorsque la solution était installée sur un environnement Oracle. Le problème présent dans la définition de la vue appelée a été corrigé.

APS-4691 - Fiche utilisateur en erreur sous Oracle

Depuis la version v23.2, la consultation d’une fiche utilisateur en mode web depuis un environnement Oracle présentait une erreur au moment de l’affichage. La référence à une colonne obsolète d’une table de la base de données a été supprimée afin de revenir à un état opérationnel.

APS-4692 - Colonne fichier en erreur sous Oracle

Depuis la version v23.0, une erreur est générée à la consultation d’un formulaire contenant un tableau de détails dont une des colonnes est de type Fichier. La correction de cette anomalie a résulté en la suppression de la colonne object_checksum de la table DocumentObjects qui est inutilisée et est à la source du problème.

APS-4693 - Picker pour la diffusion en erreur sous Oracle

Depuis la version v23.1, sur un environnement Oracle, l’interface de diffusion électronique ne chargeait pas la liste des utilisateurs. La régression avait été introduite par le changement de gestion des utilisateurs verrouillés et est maintenant corrigée.

APS-4737 - Utilisateur non verrouillé à cause du FullName

Depuis la version v23.0, une régression est apparue : un utilisateur dont le compte comportait des caractères spéciaux ou des espaces ne voyait pas son compte verrouillé après un nombre de tentatives de connexions infructueuses. Cette restriction sur les comptes utilisateurs est activée par défaut par Microsoft mais va à l’encontre des règles mises en place au sein de la solution. Les comptes sont maintenant verrouillés quel que soit les caractéristiques du compte utilisateur.

APS-4739 - Erreur à l’ouverture de ImportMetaData.aspx

La page de configuration des IdP pouvait être en erreur sur certains environnements. Après analyse, il a été détecté que Microsoft Visual C++ devait avoir été installé sur la machine pour le bon fonctionnement de la page. Un correctif est intégré pour supprimer cette dépendance.

Fonctionnalités

Installateur

APS-4596 - Installateur Oracle

Depuis la version v23.3 il devient possible de réaliser une installation de la solution Avanteam sur une base Oracle. Comme pour une base SQL Server, il est possible de laisser l’installateur gérer la création des bases de données, ou bien d’utiliser des bases déjà existantes. Cette dernière option est intéressante si l’utilisateur utilisé n’a pas les droits suffisants. Les chaînes de connexion de la solution une fois installée sont configurées pour utiliser le driver Oracle.

APS-4649 - Configurer le saml-config.json lors de l’install

Dorénavant l’installateur Avanteam rempli avec les informations de la solution le fichier de configuration SAML. Le protocole (http ou https), le hostname et le port configuré sont alors pris en compte dans le fichier de configuration.

APS-4694 - Suppression de la clé PDFTOOLS_DmlRenderingMode

La clé de paramétrage PDFTOOLS_DmlRenderingMode avait été introduite en v19.0 afin de palier une anomalie de la librairie utilisée pour la génération de rendu PDF des pièces jointes dans certains cas spécifiques. Il était alors demandé aux clients rencontrant l’anomalie identifiée (« Unexpected error : Le paramètre n’est pas valide ») de changer la valeur de cette clé. Le correctif a été livré par l’éditeur et intégré à notre solution ; la clé de configuration est maintenant obsolète et a disparu du fichier programs.ini.

Scheduler

APS-4641 - Logs du scheduler dans un fichier au nom approprié

Les entrées de log produites par le scheduler (tâches planifiées) se trouvaient jusqu’à présent écrites dans le même fichier que les logs provenant de l’utilisation du programme ImportDocs : ImportDocs.log. Les entrées de logs se retrouvent maintenant insérées dans leur propre fichier de logs : Scheduler.log. De plus, le lancement des tâches planifiées en console (en utilisant l’exécutable Avanteam.Windows.Service.Scheduler.exe) fera apparaître tous les logs produit dans la console. Cela permettra de faire un retour direct à l’administrateur ayant lancé la commande pour savoir si l’exécution de l’agent s’est bien déroulée.

Couleur des logs

Il est à noter que les entrées de logs dans la console auront des couleurs différentes suivant leur type :

• Gris foncé pour un message de debug
• Gris pour un message d’information
• Jaune pour un message d’avertissement
• Rouge pour un message d’erreur
• Rouge sur fond blanc pour une erreur fatale

SyncTool

APS-4660 - SyncTool de PStudio.Extensions

Depuis la version v23.0, un nouveau dossier est accessible, à destination des chefs de projets, afin d'y déposer leurs dll customs : PStudio.Extensions. Ce dossier apparait maintenant dans la liste des dossiers pouvant être synchronisés et permet de transférer son contenu dans l’environnement de destination.

Process Studio

APS-4662 - Propriétés des attributs du formulaire

Dans le concepteur de formulaires, à la sélection d’un champ du formulaire, il est dorénavant possible de visualiser la description de chaque attribut présent dans l’onglet « Paramètres ». Cette description aidera l’utilisateur à remplir ou à sélectionner une valeur adéquate.

APS-4664 - Hauteur des vues intégrées

Dans le concepteur de formulaires, l’attribut « Hauteur de la vue » dans les champs de type « Vue intégrée » a été supprimé car après analyse ce paramètre n’avait pas d’impact sur la représentation de la vue.

Interface web

APS-4269 – Message d’information en mode debug

Afin de s’assurer que l’application est correctement configurée pour un environnement de production, une nouvelle information est disponible lorsque l’utilisateur connecté a le rôle Admin. Si l’icône ci-dessous apparaît sur un environnement de production, cela indique que l’application peut présenter des ralentissements ou offrir des failles de sécurité. Un clic sur l’icône permet de connaître les paramètres à changer.

Les messages d’information suivants peuvent être affichés :

Message	Conséquence	Action
Le niveau de compilation est en debug dans l’application [NOM_DE_L_APPLICATION] : [FICHIER_DE_CONFIGURATION]	Le mode debug permet d’obtenir des informations supplémentaires en cas de crash de l’application. En revanche, ce mode ralenti l’exécution de l’application.	Vous devrez changer la valeur de l’attribut debug dans le fichier web.config indiqué au niveau du nœud configuration > system.web > compilation.
L'environnement est configuré en Development	La configuration d’un environnement en « Development » amenuise la sécurité et la performance de votre application.	Dans le fichier programs.ini situé dans le dossier ./PStudio.Configuration, modifiez la valeur de l’attribut APS_ENV.
Les pages d'erreurs sont désactivées	La désactivation des pages d’erreur affichera les pages d’erreur du Framework. Ces pages contiennent des informations qui permettront d’identifier l’origine d’un problème de la solution. Néanmoins, désactiver les pages d’erreur personnalisées de l’application exposera des informations techniques qui pourront être utilisées par un attaquant. Il est donc impératif d’activer cette option sur un environnement de production.	Dans le fichier programs.ini situé dans le dossier PStudio.Configuration, activez l’option en renseignant la valeur On à l’attribut CustomErrorsMode.

APS-4429 - Modèles bureautiques du champ Fichier

Le champ fichier continue de s’enrichir de fonctionnalités et il est dorénavant possible d’accéder aux modèles bureautiques. L’activation de cette fonctionnalité se paramètre dans Process Studio au niveau des champs Fichier ; il est possible d’activer au choix :

• La création d’un document vide à partir d’un modèle bureautique (option « Création »). L’utilisateur pourra générer un document à partir d’un modèle ; il pourra dans un second temps compléter le document.
• L’association d’un document existant à un modèle bureautique (option « Association »). Cela permet au moment d’ajouter une pièce jointe à un champ Fichier de spécifier un modèle bureautique qui doit lui être associé.

Pour l’utilisateur, suivant les options activées, un ou deux sous-menus additionnels seront disponibles en cliquant sur l’icône d’ajout :

• « Associer » si l’option « Association » est à True. Une fois le modèle bureautique sélectionné, l’utilisateur sera amené à choisir le fichier qu’il souhaite importer tout en l’associant au modèle bureautique sélectionné en amont.
• « Créer » si l’option « Création » est à True. A la sélection du modèle, un document similaire à celui attaché au modèle bureautique sera ajouté au champ Fichier.

Il est à noter que des options supplémentaires seront aussi disponibles dans les champs Fichier ayant l’une de ces options d’activées :

• Pour un fichier lié à un modèle bureautique, il sera possible de demander la synchronisation des signets avec les données du document.
• Pour un fichier qui n’est pas lié à un modèle bureautique, il sera possible d’en associer un après coup.

Actualisation des signets	Association d'une pièce jointe

APS-4650 - Configuration de l'attribut Id de l'IdP

Dans l’interface de configuration de l’IdP qui est mise à disposition, deux champs distincts sont maintenant disponibles pour spécifier les attributs permettant d’identifier les utilisateurs : un côté IdP, un côté Avanteam. Il n’est donc plus obligatoire d’avoir des attributs portant le même nom dans les deux outils.

APS-4695 - AdminTool ProtectSection obsolète

L’outil ProtectSection, présent dans AdminTools et qui servait à chiffrer les sections du fichier web.config gérant la machineKey et les connectionStrings a été supprimé car ces informations ne sont aujourd’hui plus traitées dans ce fichier.

APS-4700 - Portail de démo : Base Trial

Il était auparavant possible de créer une page statique à la racine du site web qui pouvait rediriger vers les différentes applications de la solution. Avec le changement d’architecture introduit par la v23, cette possibilité n’était plus possible. Il est maintenant possible de reproduire ce comportement en définissant une page index.html dans un dossier wwwroot à la racine du dossier du site web (./PStudio.Net.Web).

APS-4720 - Envoi de mail aux utilisateurs désactivés

Les utilisateurs dont le compte est désactivé ne recevront dorénavant plus de mails. Ce comportement s’applique aux cas suivants :

• Les mails de diffusion
• Les mails de notification par workflow
• Les mails de relance

Sécurité & technique

Technique

APS-4783 Envoi f&f d’email après recyclage de pool

Avec le changement d’architecture technique introduit par la v23, une anomalie a été introduite sur la diffusion des mails de type fire & forget. En effet, après un recyclage du pool, les envois de mails asynchrones (dont ceux du workflow) ne fonctionnaient plus tant qu'il n'y a pas eu un envoi de mail synchrone. La régression avait été introduite par le changement de gestion des dépendances et est maintenant corrigée.

Actions manuelles

Actions automatisées par l’AutoUpgradeTool

APS-4641 - Logs du scheduler dans un fichier au nom approprié

Dans le fichier de configuration des logs du scheduler Avanteam.Windows.Service.Scheduler.exe.nlog :

• Remplacer le nom du fichier de log de « ImportDocs.log » en « Scheduler.log »
• Ajouter une nouvelle target pour spécifier les règles de colorisation des logs console :

<targets>
  [...]
  <target name="ColoredConsole" xsi:type="ColoredConsole"
layout="${date}|${level}|${logger}|${message}|${exception:format=tostring}">
    <highlight-row condition="level == LogLevel.Debug" foregroundColor="DarkGray"
/>
    <highlight-row condition="level == LogLevel.Info" foregroundColor="Gray" />
    <highlight-row condition="level == LogLevel.Warn" foregroundColor="Yellow" />
    <highlight-row condition="level == LogLevel.Error" foregroundColor="Red" />
    <highlight-row condition="level == LogLevel.Fatal" foregroundColor="Red"
backgroundColor="White" />
  </target>
</targets>

• Ajouter une nouvelle rule pour les logs console :

<rules>
  [...]
  <logger name="*" writeTo="ColoredConsole"/>
</rules>

APS-4664 - Hauteur des vues embarquées

Dans les fichiers .ascx de définition des formulaires présents dans le dossier ./PStudio.Net.Web/Model/Forms/[NOM_DU_FORMULAIRE]/, supprimer l’attribut viewheight et sa valeur, présent à l’intérieur de la balise <aps:EmbeddedView>.

APS-4694 - Suppression de la clé PDFTOOLS_DmlRenderingMode

Supprimer la clé PDFTOOLS_DmlRenderingMode et sa valeur, présente dans le fichier de configuration programs.ini dans le dossier ./PStudio.Configuration.

APS-4695 - AdminTool ProtectSection obsolète

Supprimer les fichiers suivants :

• PStudio.Net.Web/[app]/AdminTools/ProtectSection.aspx
• PStudio.Net.Web/[app]/AdminTools/ProtectSection.aspx.cs

APS-4708 - Impossible de publier une vue avec la CLI

Supprimer le fichier ./PStudio.Administration/MigScheduleTable.exe.