Avanteam Process Studio v23.16

Objet

Installation et contenu du pack v23.16.

Domaines d’application

La migration exige que les applications Avanteam soient en version :

• 23.15

Procédure d'installation

Récupérer le paquet de mise à jour de la version depuis le serveur FTP Avanteam. Lancer AutoUpgradeTool.exe v2.4 en tant qu’administrateur et appliquer la mise à jour.

Correction

CLI

APS-5668 Harmoniser options de aps trash

Les options des commandes aps trash purge et aps trash restore ont été harmonisées afin de respecter les mêmes règles de nommage que le reste des options disponibles dans l'exécutable ligne de commandes de la solution.

• aps trash purge --help Avant

Description:
  Purge trash

Usage:
  aps trash purge [options]

Options:
  --app <app>                             Application profile name [default: <master application>]
  d, --purgeTimeInDays <purgeTimeInDays>  Purge time in days [default: 10]
  q, --olderQuantity <olderQuantity>      Quantity of older trashed documents to be purge [default: 10]
  c, --contentSource <Document>           Trash content source. Default is trashed documents. [default: Document]
  -n, --dry-run, --simulation             Don't actually change anything, simulation mode
  --debug                                 Debug mode. For developers only.
  -?, -h, --help                          Show help and usage information

Après

Description:
  Purge trash

Usage:
  aps trash purge [options]

Options:
  --app <app>                      Application profile name [default: <master application>]
  -o, --older-than-in-days <days>  Only delete items trashed more than N days ago [default: 10]
  -L, --limit <number>             Maximum number of items to delete (oldest first) [default: 10]
  -t, --item-type <type>        Type of item to purge from trash [default: Document]
  -n, --dry-run, --simulation      Don't actually change anything, simulation mode
  --debug                          Debug mode. For developers only.
  -?, -h, --help                   Show help and usage information

• aps trash restore --help Avant

Description:
  Restore trash document

Usage:
  aps trash restore [options]

Options:
  --app <app>                Application profile name [default: <master application>]
  --trashId <trashId>        Trash id of trash document.
  -n, --dry-run, --simulation Don't actually change anything, simulation mode
  --debug                    Debug mode. For developers only.
  -?, -h, --help             Show help and usage information

Après

Description:
  Restore item from trash

Usage:
  aps trash restore [options]

Options:
  --app <app>                      Application profile name [default: <master application>]
  --id <item-id>                   ID of the trashed item to restore
  -n, --dry-run, --simulation      Don't actually change anything, simulation mode
  --debug                          Debug mode. For developers only.
  -?, -h, --help                   Show help and usage information

SyncTool

APS-5735 SyncTool d’éléments de l’annuaire KO

Depuis la v23.15, SyncTool ne détectait plus les différences qui pouvaient exister entre deux bases de type annuaire. Si l'administrateur sélectionnait des éléments à synchroniser, les modifications n'étaient pas reportées sur la base cible.

APS-5428 Support de la DI dans l’import de documents

Depuis la v23.0, le ServiceLocator n'est pas correctement initialisé, provoquant une erreur lors de l'import d'enregistrements (via ImportDocs ou un agent d'import) lorsque ceux-ci sont configurés avec un démarrage du workflow.

Log

Le message d'erreur suivant était remonté dans les logs :

Unexpected exception in RunWorkflowOnDocument: Service Provider is not yet initialized

Process Studio

APS-5784 Formulaire de recherche KO

Sur un environnement utilisant des bases de données Oracle, la création de formulaires de recherche depuis un formulaire provoquait une erreur.

APS-5648 Maj des navigateurs d'un modèle d’extraction

Depuis la version v21.0, si un administrateur modifiait la liste des navigateurs pour lesquels un modèle d'extraction est disponible, sauvegardait les modifications, puis éditait cette propriété de nouveau, alors la dernière modification n'était pas prise en compte.

APS-5723 Erreur en changeant l’activation d’un compte

Depuis la version v23.15, lorsqu'un compte est bloqué après trois tentatives d'authentification infructueuses, un message d'erreur apparaissait dans l'écran Organisation lorsque l'administrateur souhaitait activer ou désactiver le compte.

Interface web

APS-5370 Actualisation de la prévisualisation GraphBuilder

Depuis la version v23.7, la prévisualisation de l’apparence des graphiques ne se mettait plus automatiquement à jour après une modification. Il était nécessaire d'enregistrer la configuration du graphe pour voir son visuel se mettre à jour dans l'interface de prévisualisation. Le comportement a été corrigé pour que l'administrateur puisse voir le rendu du graphe sans avoir à enregistrer de manière intermédiaire. De plus, les utilisateurs n'ont plus accès au panneau de paramétrage du rendu du graphe lorsqu'ils le consultent. En effet, cela conduisait à une incompréhension car l'utilisateur ne comprenait pas pourquoi ses modifications n'étaient pas prises en compte lorsqu'il consultait à nouveau le graphe. Il a été statué que l'aspect du graphe est décidé par l'administrateur et ne peut être modifié par chaque utilisateur.

La prévisualisation d'un graphe qui ne se met pas à jour

APS-5614 Pas deux pièces jointes avec même nom champ fichier

Dans un champ de type fichier, il est possible d'attacher plusieurs fois un fichier ayant le même nom. Lorsqu’un utilisateur ajoute un fichier portant le même nom qu’une pièce jointe déjà présente dans le champ, il y a désormais une fenêtre de confirmation d'action qui s'affiche au chargement du fichier. Cette fenêtre donne le choix à l'utilisateur :

• de remplacer par la nouvelle pièce jointe celle déjà existante.
• d'ajouter la nouvelle pièce jointe dont son nom est incrémenté d’un chiffre
• d'annuler l'action et de ne pas attacher la nouvelle pièce jointe

La fenêtre de confirmation d'action lorsqu'un fichier ayant le même nom a été chargé

APS-4687 Fermeture d'un document sans référence

Un enregistrement est sauvegardé dans l'application sans lui affecter de référence lorsque l'utilisateur le créé. Une référence lui est affectée lorsque l'utilisateur effectue une première sauvegarde. A l'inverse, si l'utilisateur ferme le formulaire de création de l'enregistrement, sans l'avoir enregistré, celui-ci est automatiquement supprimé puisqu'il est considéré comme un brouillon. Néanmoins, il s'avère que l'enregistrement se retrouvait supprimé si l'utilisateur ouvre cet enregistrement dans plusieurs onglets, édite l'enregistrement dans un onglet et l'enregistre, puis ferme l'enregistrement non édité qui était resté ouvert. Il est désormais vérifié qu'à la fermeture de l'onglet d'un enregistrement sans référence, alors celui-ci n'en a pas eu une d'affecté entre temps avant d'être supprimé.

APS-5734 Restauration de doc archivé KO

Depuis la v23.15, si un enregistrement était restauré depuis une base d'archivage de type actif par l'intermédiaire du bouton Restaurer, le document disparaissait de la base d'archivage mais n'apparaissait pas dans l'application.

Fonctionnalité

Process Studio

APS-5622 Bouton de sauvegarde Process Studio

Le bouton de sauvegarde était toujours disponible dans l'ensemble des écrans de Process Studio. Il est maintenant disponible uniquement sur les écrans permettant de sauvegarder les données en cours de saisie. De plus, il est possible de sauvegarder les données en utilisant ce bouton pour ces nouveaux écrans :

• l'édition des modèles d'extraction
• l'édition de scripts
• l'édition des actions
• l'édition des agents

APS-5629 Supervision des agents

Les messages de log des agents ont été :

• Complétés : des messages sur des comportements inhabituels ont été ajoutés pour pouvoir être remontés.
• Classifiés : les messages ont maintenant un niveau (voir tableau ci-après).
• Homogénéisés : l'ensemble des messages de logs sont maintenant traités de la même manière.

A chaque message de log généré par un agent, se trouve associé un niveau de log :

Niveau	Description
Trace	Message spécifiant les chemins (classes ou fonctions) appelés lors de l'exécution.
Debug	Message renvoyant des informations sur les valeurs d'exécution.
Info	Message à destination de l'administrateur pour lui transmettre des informations.
Warn	Message indiquant un comportement inhabituel lors de l'exécution.
Error	Message renvoyé lorsqu'une erreur est produite.
Fatal	Message d'erreur provoquant l'arrêt de l'exécution de l'agent.

Les messages de logs des agents pouvaient être traités de différentes manières suivant l'agent ou la classe traitant le log :

• écriture en base de données
• ajout d'un message dans le journal d'évènements Windows
• envoie du message dans la console du terminal
• écriture dans un fichier de logs

Dorénavant,

• L'ensemble des logs d'exécution des agents est stocké dans le fichier de log des agents (par défaut : ./PStudio.Services/[NOM_DE_L_APPLICATION]/Scheduler.log)
• L'ensemble des logs est aussi affiché en console lorsqu'un agent est lancé depuis un terminal ; un code couleur est affecté à chaque message de log suivant son niveau.
• Enfin, dans Process Studio, si la dernière exécution de l'agent a été en échec (i.e. un log dont le niveau est supérieur ou égal à Warn a été généré), alors une icône de warning apparaît dans la colonne "Action".
• De plus, deux nouvelles colonnes ont été ajoutées dans l'écran de la liste des agents :
  • Dernier échec : Dernière date à laquelle l'agent ne s'est pas exécuté correctement.
  • Message d'échec : Dernier message d'erreur remonté lors de l'exécution de l'agent.

Ainsi, un administrateur peut facilement identifier les agents qui n'ont pas été exécutés correctement lors de la dernière exécution (présence de l'icône dans la colonne "Action") ou lors d'une exécution précédente (présence d'une date et d'un message dans les colonnes "Dernier échec" et "Message d'échec"). Celui-ci aura de plus facilement accès au message d'erreur, mais pourra consulter l'ensemble des messages d'exécution stockés dans le fichier de log. Une fois le problème identifié et réglé, l'administrateur peut ensuite réinitialiser le statut d'échec de l'agent en le sélectionnant, puis en cliquant sur le bouton "Réinitialiser le statut d'échec" présent dans le menu ruban. Le statut, la dernière date d'échec et le message d'échec seront alors réinitialiser ce qui permettra à l'administrateur de pouvoir identifier facilement les prochaines remontées d'erreur.


Interface Web

APS-4321 Export des listes de valeurs

Dans l'AdminTools AdminValueList, un administrateur peut désormais exporter une liste de valeurs depuis l'application web. Cet export se fait au format Excel et se présente dans le même format de présentation que celui utilisé pour l'import de listes de valeurs. Une fois exportée, un administrateur peut modifier le fichier Excel et réimporter le fichier pour intégrer ses modifications.

Sur ce même écran, la liste de sélection du mode de tri de la liste de valeurs sélectionnée a été déplacée en dehors de l'encadré "Import liste de valeurs" pour ne pas prêter à confusion.

APS-5603 Aide sur les champs

Pour aider les utilisateurs à remplir leur formulaire, il existe désormais une aide sur les champs. Chaque champ peut être paramétré dans Process Studio par un administrateur de façon à apporter du contexte pour l'utilisateur. Lorsque l'utilisateur sera en édition sur un formulaire, et que le champ est éditable, il pourra voir apparaitre l'aide au survol de l'icone qui apparaît à côté du libellé.

L'aide sur un champ dans un formulaire en édition

Le paramétrage de l'aide se fait dans l'écran de conception de formulaires. Lorsqu'un champ de formulaire est sélectionné, cliquez sur l'onglet Paramètres du panneau de configuration et indiquez la valeur souhaitée dans la propriété Aide. C'est le fait de spécifier une valeur à cette propriété qui fera afficher l'icône d'aide dans le formulaire.

Le paramétrage dans Process Studio de l'aide sur les champs

Traduction

Si vous souhaitez localiser le message d'aide d'un champ, rendez-vous dans l'écran Traduction > Application. Dans l'arbre de traduction, déployer les nœuds Paramètres de l'application > Formulaires > [Nom de votre formulaire] > Champs > [Nom de votre champ] > Aide.

APS-2543 Éclater les ressources sélectionnées

Dans les modales de sélection de ressources, il est à présent possible d'éclater des rôles, des services ou des groupes de diffusion. Cela signifie qu'une fois que vous avez sélectionné une ressource d'un de ces types pour constituer votre liste de diffusion, vous aurez la possibilité d'extraire la liste des ressources qu'elle contient. Par exemple, l'appuie sur l'icône sur une ressource de type rôle remplacera le rôle par l'ensemble des utilisateurs ayant ce rôle, alors que la même action sur un service remplacera la ressource par tous les membres et managers appartenant directement au service, mais aussi tous les sous services.

Le nouveau bouton permettant à présent d'éclater les services ou groupes de diffusion dans la fenêtre de diffusion

Le message toast lorsqu'un groupe de diffusion est éclaté

Conséquences

Dès lors où l'entité est éclatée, celle-ci n'est plus mentionnée dans la liste de diffusion ; cela revient au fait d'avoir sélectionné directement l'ensemble des ressources qui lui sont attachées.

Conditions

L’utilisateur peut éclater un rôle, un service ou un groupe de diffusion dès lors que

• que le champ accepte des ressources de type utilisateur
• que la ressource sélectionnée a des ressources qui lui sont rattachées
• qu'il est possible de sélectionner plusieurs valeurs

Sécurité et technique

Sécurité

APS-5631 VLN_01 - File inclusion lead to info exposure

Dans l'outil d'administration CheckSendMail d'AdminTools, les pièces jointes ajoutées n'étaient pas correctement attachées au mail envoyé. De plus, le message d'erreur a été modifié pour ne pas divulguer d'informations sensibles.

APS-5658 VLN_03 - Multiple XSS - Sanitization SVG

Une faille XSS permettait l'interprétation de code malveillant qui pouvait être embarqué dans des images SVG utilisées dans l'écran de personnalisation de l'application.

APS-5659 VLN_03 - Multiple XSS - Bandeau de maintenance

Une faille XSS permettait l'interprétation de code au niveau du bandeau de maintenance.

APS-5676 VLN 3 : Path Traversal en lecture et en upload

Une faille de type path traversal a été corrigée dans l'écran de paramétrage de la navigation visuelle.

Technique

APS-5628 Performance du monitoring du scheduler

Une nouvelle structure de données a été mise en place afin de palier les problèmes de performance que pouvait poser le service de surveillance des agents.

Breaking Change

APS-5668 Harmoniser options de aps trash

• Les noms des options des commandes aps trash purge et aps trash restore ont évolués.
• En base de données, les tables Trash et TrashDocument ont été renommées en TrashedItems et TrashedItemDocument.

APS-5629 Supervision des agents

Le service de monitoring d'un agent a évolué :

• l'id du log correspond maintenant au nom de l'agent
• un seul log par agent est renvoyé (avant il pouvait y avoir plusieurs logs si ceux-ci avait moins de deux jours, tout en s'assurant qu'au moins un log reste par agent dans le cas où tous les logs de l'agent était plus vieux)
• il ne renvoie plus l'attribut Log qui n'était jamais rempli
• La fonction Log disponible dans AgentBase est obsolète et a été remplacée par LogTrace, LogDebug, LogInfo, LogWarn, LogError et LogFatal.