Historiser les fichier d'un champ PJ

Présentation générale

Il existe en standard VDoc, un traitement Modificateur de champ qui permet de copier un champ attachment dans un autre champ attachment mais ce traitement écrase tout le contenu du champ cible avec le contenu du champ source, si bien qu’au final les 2 champs contiennent exactement les mêmes fichiers joints.

Après installation de vdoc.kit, un nouveau traitement et de nouveaux services sont disponibles : ils permettent d’historiser les fichiers attachés du champ pièces jointes source dans un champ pièces jointes cible; il s’agit d’une copie mais à la différence du standard produit sans écraser le contenu du champ cible (les fichiers joints sont donc ajoutés à la cible).

Avertissement

/!\ ATTENTION : l’historisation des fichiers attachés peut-être lourde de conséquences. En effet en fonction de votre conception dans le Studio et de la taille ainsi que du nombre des pièces jointes => la volumétrie des fichiers historisés peut augmenter le contentStore au delà du raisonnable !

Utilisation lors de la conception dans le Studio

Diagramme : ajout sous forme de Traitement ou de Service

L’historisation des fichiers contenus dans un champ pièce jointe est disponible dans Studio > Diagramme, sous 2 formes :

  • Soit comme traitement (sur une flèche de transition entre 2 étapes) :

Historiser PJ -Traitement Historiser PJ -Traitement Historiser PJ -Traitement Historiser PJ -Traitement

  • Soit comme connecteur de Service (sur une action de workflow), déclenché sur l’évènement “Pendant le changement d’étape” :

Historiser PJ - Service Historiser PJ - Service Historiser PJ - Service Historiser PJ - Service

Ailleurs dans le Studio : ajout sous forme de service

L’historisation des fichiers contenus dans un champ pièce jointe est aussi disponible sous forme de service et peut donc être utilisée :

  • Sur un Champ depuis la liste des champs : connecteur service dans la version du processus, déclenché “Au changement de valeur du champ” (traitement backend)
  • Sur un Formulaire pour un champ : évènement déclenché “Au changement de valeur du champ” (traitement front-end).

Précisions sur le fonctionnement

  • En cas de présence d’un fichier portant déjà le même nom dans le champ pièce jointe cible, le traitement renomme automatiquement le nouveau fichier attaché (comme le fait le standard produit après upload d’un fichier “en doublon”) : ajout du suffixe “2” en fin de nom de fichier pour le 2e fichier puis du suffixe “3”, … comme illustré ci-dessous :

Fichiers renommés dans champ pièce jointe Fichiers renommés dans champ pièce jointe

  • La détection des modifications s’appuie sur le calcul d’un CRC du fichier (contenu + nom de fichier) afin de ne pas ajouter / alourdir inutilement le champ cible avec plusieurs fois la même pièce jointe de la source :
    • Cas limite d’utilisation : si un fichier est historisé puis supprimé dans la source puis à nouveau ajouté à l’identique (même nom, même contenu) et enfin à nouveau historisé => la date affichée dans le champ source sera plus récente que la date du même document dans le champ cible historique (dans ce cas et en raison du CRC aucune modification n’est détectée donc la version du document est conservée dans le champ cible historique, sans ajout d’un nouveau fichier … puisque pour le système (d’après le CRC) ce fichier est déjà présent dans le champ “historique”).

Articles complémentaires

  • Pour historiser plus finement des champs autres que les champs pièces jointes vous pouvez mettre en place l’addon Audit Trail.