Sommaire
Prérequis
Entités de documents
Le traitement d'héritage ne peut être utilisé qu'avec les entités de documents livrées en standard, à savoir :
- "QEDOS" : dossiers d'achats ;
- "QECSL" : consultations ;
- "QEDCS" : détails de consultations.
Occurrence "HERIDOC"du paramètre "AUTQEA"
- si la valeur testée 1 de cette occurrence vaut "A" (documents basés gérés de manière interactive), le traitement ne sélectionnera que le documents non basés. Si le paramétrage ne permet pas d'associer un document basé en interactif (dans le cas où le type de document par défaut en création de la consultation est non basé par exemple), ce document ne sera plus sélectionné et donc jamais associé par héritage ;
- si la valeur testée 1 de cette occurrence vaut "I", tous les documents sont sélectionnés et traités par ce traitement.
Sélection
Ce traitement peut être exécuté pour :
- un dossier ;
- une consultation ;
- un classeur ;
- une liste de dossiers ou de consultations.
Il sélectionne les dossiers et les consultations en cours de l'entité soumise.
Les consultations sélectionnées sont triées par établissement, classe de dossiers, numéro interne du dossier, type de consultations, numéro interne de la consultation.
Traitement d'une consultation
Les consultations sont traitées avant leur dossier.
La première action effectuée est le contrôle de la cohérence entre l'étape de la consultation traitée et l'étape du traitement.
En cas d'erreur, la consultation est rejetée et le traitement passe à la suivante.
Si ce contrôle est valide, le système sélectionne tous les documents associés à la classe de dossiers qui doivent être hérités sur la consultation.
Pour rappel, si la valeur testée 1 de l'occurrence "HERIDOC" du paramètre "AUTQEA" vaut "A", seuls les documents centralisés sont sélectionnés ; si elle vaut "I", tous les documents sont sélectionnés.
Chaque document ramené est associé à la consultation via l'appel d'un web service :
- si le document est centralisé, il est déplacé dans le répertoire cible référencé par le type de document défini par défaut en création, puis le lien est créé au niveau des documents associés ;
- si le document est basé, seul le lien au niveau des documents associés est créé.
Si jamais une erreur se produit, tous les documents hérités déjà associés à la consultation en cours de traitement sont supprimés, elle est rejetée et le traitement passe à la suivante.
Si tous les documents hérités de la classe de dossiers ont bien été associés à la consultation, le traitement sélectionne alors les documents du type de consultations qui doivent être hérités sur la consultation et effectue exactement les mêmes actions que précédemment.
Si au final tout s'est bien passé pour la consultation, le traitement traite les détails de la consultation s'il en existe.
Si tout s'est bien passé pour la consultation et ses détails, la consultation passe l'étape.
Traitement des détails de consultation
Si tout s'est bien passé pour la consultation, le système traite ses détails s'il y en a.
Le fonctionnement est exactement le même que pour les consultations : le traitement sélectionne tous les documents associés à la classe de dossiers qui doivent être hérités sur le détail de consultation.
Chaque document ramené est associé au détail via l'appel d'un web service.
Comme préalablement :
- si le document est centralisé, il est déplacé dans le répertoire cible référencé par le type de document défini par défaut en création, puis le lien est créé au niveau des documents associés ;
- si le document est basé, seul le lien au niveau des documents associés est créé.
Si jamais une erreur se produit, tous les documents hérités déjà associés sur le détail de consultation en cours de traitement sont supprimés .
Tous les documents hérités associés aux autres détails de la même consultation sont aussi supprimés.
Tous les documents hérités associés à la consultation sont également supprimés.
Cette dernière est rejetée et le traitement passe à la consultation suivante.
Si tous les documents hérités de la classe de dossiers ont bien été associés au détail, le traitement sélectionne alors les documents du type de consultations qui doivent être hérités sur les détails de consultation et effectue exactement les mêmes actions que précédemment.
Si tout s'est bien passé pour le détail de consultation, le traitement passe au suivant.
Une fois l'ensemble des détails de la consultation traité sans erreur, la consultation passe l'étape.
Traitement du dossier
Le dossier est traité seulement une fois que toutes ses consultations l'ont été.
Pour que l'héritage ait lieu, il faut qu'au moins une consultation ait été traitée en intégralité et ait passé l'étape.
Si ce n'est pas le cas, l'héritage pour le dossier n'a pas lieu : il sera effectué quand le traitement sera de nouveau exécuté sur les consultations en erreur.
Si au moins une consultation a été traité sans erreur, l'héritage du dossier est effectué : le traitement sélectionne tous les documents associés à la classe de dossiers qui doivent être hérités sur le dossier. Chaque document ramené est associé via l'appel du web service.
Comme dans les cas précédents :
- si le document est centralisé, il est déplacé dans le répertoire cible référencé par le type de document défini par défaut en création, puis le lien est créé au niveau des documents associés ;
- si le document est basé, seul le lien au niveau des documents associés est créé.
Remarque : les documents hérités pour un dossier ne peuvent provenir que de la classe de dossiers, pas du type de consultations.
Fonctionnement particulier en cas d'erreur :
La consultation étant l'élément principal d'un dossier d'achats, si elle a été traitée correctement en intégralité, le traitement ne fait pas marche arrière.
De ce fait, si un héritage se passe mal au niveau du dossier, l'erreur est bien évidement éditée dans le compte rendu mais les documents hérités déjà associés ne sont pas supprimés et le traitement tente d'associer ceux qui restent.
Le dossier peut être traité plusieurs fois :
Si le dossier d'achats possède plusieurs consultations qui ne passent pas l'étape d'héritage de documents au même moment, le dossier est traité à chaque fois : les anciens documents hérités sont effacés, et l'héritage est de nouveau effectué.