Paramétrage > Destinations > Règles d'archivage 

Cette fonction permet de paramétrer les conditions dans lesquelles une fonction d'archivage peut stocker dans un coffre-fort un document produit par le progiciel. Chaque fiche saisie décrit un contexte d'archivage, caractérisé par un événement déclencheur (par exemple une édition) et des mots-clés qui pourront être utilisés comme critères de recherche ultérieur.

L'archivage peut également, lorsque l'attachement d'une pièce jointe n'en est pas l'événement déclencheur, provoquer en retour la création d'une pièce jointe qui pointera sur le document. Ainsi, depuis la gestion des pièces jointes, on pourra accéder à un document stocké dans le système de gestion électronique de documents (GED).

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

Deux onglets permettent de définir le contexte d'archivage : l'onglet Général décrit les conditions générales, l'onglet Paramètres décrit les données échangées avec le système de GED lors de l'archivage.

En-tête

Présentation

La clé définie ici identifie de façon unique le paramétrage. Elle n'est pas significative (ce sont les critères de déclenchement qui le sont pour l'exécution).

 

Champs

Les champs suivants sont présents dans cet onglet :

Code identifiant la fiche courante.

  • Intitulé (champ INTIT)

Sur des champs traduisibles tels que celui-ci, vous pouvez saisir un intitulé dans d'autres langues que la langue de connexion courante : cliquez sur Traductions en ligne, depuis l'icône Actions.
SEEREFERTTO Pour plus d'informations, reportez-vous à : Traduction en ligne d'intitulés.

  • Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

  • les autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

 

Onglet Général

Champs

Les champs suivants sont présents dans cet onglet :

Général

  • Module (champ MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

Le code activité permet d'éviter de copie les paramétrages inutiles à la création d'un dossier et de protéger les modifications du paramétrage standard d'un patch éventuel.

L'identifiant volume peut être utilisé pour le logiciel d'archivage. Il identifie un conteneur physique séparé (par exemple si on souhaite un archivage sur des volumes différents en fonction de la société). Il doit avoir été défini au niveau du logiciel de GED, mais peut rester vide s'il n'y a qu'un seul conteneur ou si la GED est capable d'adresser un conteneur par défaut.

Options

  • Affichage paramètres (champ INTERV)

Lorsqu'elle est cochée, cette case provoque l'ouverture d'une fenêtre permettant de visualiser et de modifier les paramètres transmis au logiciel de GED avant l'archivage. Ceci est possible uniquement si le traitement n'est pas batch.

  • Mise au point (champ DEBUG)

Indicateur permettant d'activer une aide à la mise au point. Lors de l'exécution de ce paramétrage et si cette option est active, le moteur d'archivage affiche dans une trace les messages éventuels d'erreur d'évaluation sur les conditions, le log et le message.

 

Evénement déclenchant

  • Type événement (champ TYPEVT)

Cette rubrique permet de définir l'événement déclencheur de l'archivage. Ce peut être :

  • L'ajout d'une pièce jointe dans une gestion d'objet (le code objet peut être donné si on souhaite restreindre cet archivage à un seul objet).
  • Le lancement d'une impression sur une destination de type Archivage (le code de l'état peut être donné pour restreindre cet archivage à un seul état; le code objet, s'il est donné, permet en outre de restreindre l'archivage aux seules impressions lancées depuis un objet donné via les fonctions d'impression).
  • L'export, via un modèle d'export. Là encore, le code du modèle peut être donné pour restreindre l'archivage à un seul modèle.
  • L'affichage d'une trace dans une fonction définie par la rubrique correspondante (en fait, le déclenchement de l'archivage se fera lors de l'appel de la fonction FERME_TRACE). Si le code fonction est vide, le déclenchement devient générique.
  • L'export Excel depuis un tableau à partir d'un écran lié à une fonction définie par la rubrique correspondante, si elle est renseignée (sinon, le déclenchement est générique). Attention, dans ce cas, ce n'est pas le fichier Excel qui est archivé, mais le fichier XML qui conduit à sa génération.
  • L'appel manuel suppose le lancement de l'archivage par un appel spécifique de sous-programme :
    Call EVENEMENT(6,GFONCTION,FICHIER,"") From  ARCHIVE
    A noter que le champ fonction peut être utilisé pour restreindre le déclenchement manuel à son déclenchement dans une fonction donnée.

Ce code permet :

  • Lorsque l'événement déclencheur est l'insertion d'une nouvelle pièce jointe (par le menu Fichier/Pièces jointes), de préciser sur quel objet le déclenchement se fait (s'il est vide, le déclenchement se fera sur tout code objet).
  • Lorsque l'événement déclencheur est une impression sur une destination de type "Archivage", de restreindre le déclenchement aux états lancés depuis une fonction d'impression à partir de l'objet correspondant.

Lorsque le déclenchement de l'archivage se fait par une impression sur une destination de type Archivage, ce champ permet de restreindre le déclenchement lors de l'édition d'un état donné. Si l'état n'est pas renseigné, ce paramétrage est appliqué pour tous les états.

Lorsque l'export est déclenché depuis un export de données, cette rubrique permet de restreindre le déclenchement à un export réalisé via un modèle d'export particulier. Le paramétrage devient générique et s'applique à tous les modèles si ce champ n'est pas saisi.

Cette rubrique permet de restreindre le déclenchement du paramétrage à une fonction donnée. Ceci s'applique pour les exports Excel.

Ce champ permet de particulariser un paramétrage pour une société, par exemple pour renseigner un identifiant volume dans lequel sont archivés les fichiers.

Lorsque l'événement déclencheur correspond à la fiche de paramétrage, la rubrique Champ société est évaluée. Si le résultat de l'évaluation correspond à la valeur présente dans cette rubrique, l'événement déclencheur est considéré comme réalisé, et l'archivage peut être lancé.

Si ce champ est vide, l'événement déclencheur sera considéré comme réalisé seulement le résultat de l'évaluation de la rubrique Champ sociétéest vide ou ne correspond à aucune autre fiche paramétrée (ce qui permet d'avoir un paramétrage par défaut pour toutes les sociétés non explicitement définies par une fiche).

  • Champ société (champ FLDCPY)

Cette formule permet de déterminer la société courante, afin de permettre de déterminer si un paramétrage défini pour un code société donné s'applique bien.

  • Champ site (champ FLDFCY)

Lorsque la société n'est pas facilement déterminable dans un contexte par une formule de calcul, on peut utiliser cette formule qui déterminera le site courant, pour en déduire la société courante.

Ainsi on pourra, par ce biais, déterminer si un paramétrage défini pour un code société donné s'applique bien.

Type de document utilisé pour créer la pièce jointe dans l'objet. Ce champ obligatoire, défini dans la table diverse 902, est avec l'identifiant du volume l'un des deux critères discriminants qui permettent de définir les paramètres complémentaires d'archivage (saisis sur la deuxième page de la définition de l'archivage).

  • Critère (champ FILTRE)

Ce critère logique est évalué au moment où l'événement déclencheur de l'archivage est détecté. Si le résultat de l'évaluation est faux, l'archivage n'est pas déclenché.

Liens

A l'issue de l'archivage, il est possible de créer une pièce jointe pointant sur le document archivé. Ce champ facultatif permet de définir le code objet concerné par la pièce jointe.

  • Clé de lien (champ OBJCLE)

Lorsqu'une pièce jointe est créée (c'est à dire lorsque un code objet est renseigné dans la rubrique précédente), la valeur de la clé primaire de l'objet doit être définie ici sous la forme d'une formule (plusieurs formules séparées par ";" si la clé est une clé multiple).

Pièce jointe

  • Mot-clé (champ MOTCLE)

Chaque champ de ce type est utilisé pour alimenter les rubriques mot-clé dans la pièce jointe, lorsqu'une pièce jointe est créée à l'issue de l'archivage du document.

Il s'agit ici d'une formule de calcul utilisant toutes les variables susceptibles d'être présentes dans le contexte (ceci dépend de l'événement déclencheur), et notamment les variables G_XXXX, où XXXX est le code d'un paramètre passé en argument dans l'onglet Variable.

  • Conteneur (champ IDTCNT)

Ce champ est utilisé pour alimenter la rubrique identifiant de document dans la pièce jointe, lorsqu'une pièce jointe est créée à l'issue de l'archivage du document. Cette référence est l'identifiant du conteneur où sera placé le document dans la GED. Le conteneur pouvant être un répertoire, une machine, une URL.

Il s'agit ici d'une formule de calcul utilisant toutes les variables susceptibles d'être présentes dans le contexte (ceci dépend de l'événement déclencheur), et notamment les variables G_XXXX, où XXXX est le code d'un paramètre passé en argument dans l'onglet Variable.

  • Identifiant d'archivage (champ IDTSTO)

Ce champ est utilisé pour alimenter la rubrique identifiant de document dans la pièce jointe, lorsqu'une pièce jointe est créée à l'issue de l'archivage du document. Ce numéro de document est l'identifiant unique d'un document dans un conteneur de la GED (sachant qu'il peut y avoir un numéro de version en identifiant complémentaire si un même document est soumis plusieurs fois).

Il s'agit ici d'une formule de calcul utilisant toutes les variables susceptibles d'être présentes dans le contexte (ceci dépend de l'événement déclencheur), et notamment les variables G_XXXX, où XXXX est le code d'un paramètre passé en argument dans l'onglet Variable.

  • Version (champ VERSION)

Ce champ est utilisé pour alimenter la rubrique numéro de version dans la pièce jointe, lorsqu'une pièce jointe est créée à l'issue de l'archivage du document. Ce numéro de version permet de différencier les différentes soumissions d'un même document.

Il s'agit ici d'une formule de calcul utilisant toutes les variables susceptibles d'être présentes dans le contexte (ceci dépend de l'événement déclencheur), et notamment les variables G_XXXX, où XXXX est le code d'un paramètre passé en argument dans l'onglet Variable.

  • Catégorie (champ CAT)

Ce champ contient une formule évaluée dont le résultat est utilisé dans pour alimenter la rubrique catégorie dans la pièce jointe, lorsqu'une pièce jointe est créée à l'issue de l'archivage du document. Il s'agit d'une valeur numérique définie par le menu local 96.

Il s'agit ici d'une formule de calcul utilisant toutes les variables susceptibles d'être présentes dans le contexte (ceci dépend de l'événement déclencheur), et notamment les variables G_XXXX, où XXXX est le code d'un paramètre passé en argument dans l'onglet Variable.

  • Nom document (champ NAM)

Nom de la pièce jointe qui apparaît dans la gestion des pièces jointes X3 à la place du nom du fichier complet.

Bloc numéro 6

  • Nom du fichier (champ FORFIC)

Cette rubrique permet de renseigner une formule pour générer un nom de fichier temporaire utilisé durant le processus d'archivage du document.

Ce chemin peut être absolu ou relatif.

Il est relatif s'il commence d'une des façons suivantes :

  • C:\chemin, où C: correspond à un volume situé sur le serveur,
  • #@C:\chemin, où C: correspond à un volume situé sur le poste client,
  • \\serveur, où serveur est le nom d'un serveur sur le réseau.

S'il n'est pas absolu, le répertoire à partir duquel le chemin est calculé est défini par le paramètre général ARCMAC; à défaut, on utilise la valeur du paramètre DIRPCE, et à défaut, le répertoire tmp du dossier courant.

Si le connecteur GED est utilisé sans qu'un moteur d'archivage ait été installé, le nommage des répertoires permet, de façon très simple, de réaliser une mini gestion de document en positionnant les fichiers dans des répertoires et avec des noms définis en fonction du contexte.


 

Onglet Paramètres

Présentation

Dans cet onglet, renseignez les paramètres complémentaires envoyés à la GED (ou renvoyés par la GED après archivage). La liste des paramètres est définie par la fonction Paramétrage d'archivage (GESARE) et dépend uniquement de l'identifiant volume et du type de documentation.

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau

  • Code paramètre (champ CODPAR)

Ce code paramètre identifie un des paramètres passé au logiciel de GED lors de la soumission. Il est donc envoyé, avec sa valeur, au logiciel de GED à chaque soumission de document.

Par ailleurs, le progiciel créé, dans le contexte de l'appel, une variable dont le nom correspond au code préfixé par G_.

Ainsi, par exemple, si le paramètre identifiant le document soumis s'appelle DOC_ID, une variable G_DOC_ID sera disponible dans le contexte appelant, ce qui permettra d'utiliser cette variable dans une formule définissant une référence au document à stocker dans le logiciel après la soumission.

  • Intitulé paramètre (champ INTPAR)

Permet de définir un intitulé associé à chaque fiche.

  • Type interne (champ TYPPAR)

Définit le type interne de la variable G_XXXX associée au paramètre XXXX. Ce champ peut prendre les valeurs Char, Integer, Date, Decimal, Libellé.

  • Type d'argument (champ ADRPAR)

Ce champ permet de savoir si le paramètre est uniquement envoyé à la GED (lorsqu'il vaut Par valeur), ou s'il est également susceptible d'être retourné par le logiciel de GED au programme appelant (lorsqu'il vaut Par adresse).

  • Valeur (champ FORPAR)

Ce champ permet de définir, par le biais d'une formule de calcul, la valeur affectée à la variable transmise au logiciel de GED lors du déclenchement de l'archivage. Les variables en ligne dépendent du contexte et peuvent inclure :

  • les champs inclus dans les écrans de la fonction lorsqu'une fonction ou un objet sont en ligne
  • la liste des paramètres de lancement lorsqu'il s'agit d'un état ou d'un modèle d'export
  • des variables globales (telles que GUSER par exemple).

 

Boutons spécifiques

Cliquez sur Validation pour créer et valider le traitement automatique appelé par la fonction d'archivage.

Messages d'erreur

Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre