ONYX - 9.0 - Utilisation

Concaténation de fichiers XPS

De MappingDoc
Révision datée du 1 avril 2019 à 14:17 par Admin (discussion | contributions) (Remarques)

Cette documentation décrit la fonction permettant de concaténer tous les fichiers XPS d’un répertoire en un ou plusieurs fichier XPS.

Description de l'interface

Onglet standard

Input directory : Répertoire racine où se trouvent les fichiers à concaténer, avec ou sans prise en charge des sous-répertoires en fonction de la valeur de Recursive mode.

Output file : Chemin + nom du ou des fichiers XPS générés

Maximum number of original files in one output file : Permet de créer des lots de fichiers XPS. Voir exemple ci-dessous.

Remove original files : Permet de supprimer les fichiers source

Recursive mode : Disabled, Normal, ou Advanced. Voir exemple ci-dessous.

Onglet filters

Les filtres permettent de prendre en compte uniquement certains fichiers XPS du répertoire d’entrée

Filter on the files name : basé sur le nom avec méta-caractère * (exemple : DOCXPS*)

Filter on date From (yyyy/mm/dd) : date de début de la sélection des fichiers XPS (date de création du fichier)

Filter on date To (yyyy/mm/dd) : date de fin de la sélection des fichiers XPS (date de création du fichier)

Onglet output action

Cet onglet permet d’envoyer le résultat de la concaténation vers un point d’entrée.

Entry name : La valeur de ce paramètre est le nom d’un point d’entrée défini dans Mapping. A chaque éxécution du concat folder, le ou les résultats de la concaténation seront envoyé au point d’entrée spécifié

Hold document : Ce paramètre définit l’état du job en arrivant dans la queue « Entry name » . Soit en « Prêt à imprimer » (non coché) ou soit en « Suspendu » (coché)

Keep document : Ce paramètre définit l’état du job une fois imprimé. Soit le job disparait (non coché), soit on le garde en état « sauvegardé » (coché)

Keep current userdata : Si coché, ce paramètre permet de garder les userdatas initialisées dans un workflow précédent pour qu’elles soient envoyées dans le job sur le point d’entrée « Entry point »

Add current parameter : Si coché, ce paramètre permet d’ajouter les userdatas initialisées dans le workflow actuel pour qu’elles soient envoyées dans le job sur le point d’entrée « Entry point »

Le titre (MAP_TITLE) des jobs envoyés est égal soit au nom du fichier XPS généré (spécifié dans le paramètre « Standard / Output file », soit au chemin entier (selon configuration dans le mapping.conf. Voir remarque N° 6)

Exemples

Les exemples ci-dessous sont basés sur la structure de répertoires suivante :

Variante 1 : Paramétrage de base

Prenons pour exemple la fonction suivante :

Dans chaque répertoire (TestConcatFolder, REPx et REPxSOUSx), il y a 3 fichiers XPS :

FichierXPS1.xps, FichierXPS2.xps, FichierXPS3.xps

  • Répertoire d’entrée :
C:\trash\TestConcatFolder
  • Nom du fichier de sortie :
C:\trash\TestConcatFolder_sortie\fichierXPS.xps
  • Mode récursif :

Il y a 3 modes de récursivité différents : - Disabled o 1 seul fichier XPS généré par la concaténation des fichiers XPS contenus dans le répertoire d’entrée « TestConcatFolder » uniquement

  • Normal

o 1 seul fichier XPS généré par la concaténation de tous les fichier XPS contenus dans le répertoire « TestConcatFolder » ainsi que les fichiers XPS des sous-répertoires o Les fichiers concaténés sont triés par ordre croissant en fonction de leurs noms suivant cet ordre : 0123456789ABCDEFGHI…  Ex : Prenons 2 fichiers XPS dans le répertoire TestConcatFolder : 0BONJOUR.xps et ABONJOUR.xps  La concaténation sera 0BONJOUR.xps et ensuite ABONJOUR.xps (car si on trie les noms de fichiers par ordre croissant, le 0 est avant le A, donc le fichier XPS dont le nom commence par « 0 » sera concaténé avant le fichier XPS dont le nom commence par « A »)

  • Advanced

o 1 fichier XPS est généré par répertoire ou sous-répertoire ayant pour nom NOMREPERTOIRE_NOMFICHIERXPS. Dans cet exemple, il y a 9 fichiers XPS (car 9 répertoires ou sous-répertoires) o Noms des 9 fichiers XPS créés dans le répertoire C:\trash\TestConcatFolder :  fichierXPS.xps  REP1_fichierXPS.xps  REP1SOUS1_fichierXPS.xps  REP2_fichierXPS.xps  REP2SOUS2_fichierXPS.xps  REP3_fichierXPS.xps  REP3SOUS3_fichierXPS.xps  REP4_fichierXPS.xps  REP4SOUS4_fichierXPS.xps

Chacun de ces fichiers comprend la concaténation des fichiers XPS situés dans leur répertoires respectifs.

Supprimer les fichiers d’origine :

La case n’est pas cochée donc les fichiers sont conservés.

Variante 2 : Lotissement

Cette fonctionnalité permet de créer des lots de fichiers concaténés.

Prenons pour exemple 3 fichiers différents situés dans le répertoire C:\trash\TestConcatFolder

FichierXPS1.xps, FichierXPS2.xps et FichierXPS3.xps

Nombre maximum de fichiers d’origine dans un fichier en sortie : « 2 »

Le résultat de cette concaténation est la création d’un fichier XPS contenant deux fichiers XPS différents et un autre fichier XPS concernant le troisième fichier.

  • FichierXPS_1 contenant la concaténation de fichierXPS1.xps et fichierXPS2.xps
  • FichierXPS_2 contenant la concaténation du fichierXPS3.xps

Variante 3 : Ajout des filtres

L’onglet Filters permet d’ajouter des filtres de sélection des fichiers en fonction de leur nom ou de la date.

Remarque : Il n’est pas possible de préciser plusieurs valeurs pour le même filtre.

Filtre sur le nom des fichiers

Cette fonctionnalité permet de sélectionner les fichiers XPS à concaténer en fonction de leur nom.

Exemple :

Valeur du filtre : DOC*

  • Cette valeur prend tous les fichiers XPS commençant par « DOC », « DOC1.xps » par exemple

Valeur du filtre : *DOC*

  • Cette valeur prend tous les fichiers XPS contenant « DOC » dans leur nom, « MYDOC1.xps » par exemple

Filtre sur la date de création des fichiers

Cette fonctionnalité permet de sélectionner les fichiers XPS à concaténer en fonction de leur date de création.

Exemple 1 :

  • Ce paramétrage prend en compte uniquement les fichiers XPS créés entre le 01 janvier et le 31 décembre 2018.

Remarque : Si une des deux dates n’est pas spécifiée, sa valeur implicite est * (infinie)

Exemple 2 :

  • Ce paramétrage prend en compte uniquement les fichiers XPS créés à partir du 22/10/2017 (inclus).

Exemple 3 :

  • Ce paramétrage prend en compte tous les fichiers XPS ayant une date de création antérieure ou égale au 24/10/2017.

Variante 4 : Envoi vers un point d'entrée

Après concaténation, les fichiers générés peuvent être envoyés vers un point d’entrée de M-Processing Server. Dans l’exemple ci-dessous, le ou les fichiers concaténés seront envoyés vers le point d’entrée Mapping MY_ENTRY_POINT et ces spool seront sauvegardés après traitement (Case « Keep document » coché)

Remarques

Remarque 1 – Fichier de type autre qu'XPS

Dans le cas où un fichier de type autre qu’XPS est présent dans le répertoire à concaténer, un message d’erreur apparait, sans toutefois mettre la queue en erreur :

USER	DB	11/04/2018-15:10:38	5956	Do Render...
USER	EE	11/04/2018-15:10:38	5956	No _rel/.rels, document C:\trash\TestConcatFolder\formation4.pdf is not an XPS file
USER	DB	11/04/2018-15:10:38	5956	Done.

Remarque 2 – Pas de fichier XPS

S’il n’y a aucun fichier XPS dans le répertoire, il n’y a pas de message d’erreur et aucun fichier XPS n’est créé.

Remarque 3 – Fichier XPS sans extension

S’il y a un fichier XPS sans extension (« doc1.xps » nommé « doc1 »), aucun fichier n’est créé car le concat folder se base sur l’extension des fichiers pour déterminer s’il s’agit d’un fichier XPS ou non.

Remarque 4 – Ordere de concaténation

Les fichiers XPS sont concaténés par ordre croissant en fonction de leur nom (0123456789ABCDE…). La même logique s’applique aux fichiers placés dans des sous-répertoires pour le mode de récursivité « Normal » ou « Advanced ».

Remarque 5 – Nom du fichier du sortie

Par défaut, lorsqu’un point d’entrée est défini dans l’onglet « Output action », le « Nom du fichier de sortie » est égal au nom du fichier sans le chemin ni l’extension (variable MAP_TITLE), ci-dessous « concatroot ».

Par contre, il est également possible d’obtenir le chemin complet et l’extension en mettant la variable d’environnement CONCATFOLDER_TITLE_FULLPATH à « ON », ci-dessous D:\MCO\00002414\concatroot.xps /code>


Remarque 6 – Pas de valeur d'index dans le nom du fichier

Il n’est pas prévu de générer un nom dynamique utilisant la valeur des index présents dans les fichiers à concaténer dans le nom du ou des fichiers de sortie :

USER	DB	19/04/2018-18:36:18	9676	Used parameters : directory=C:\trash\TestConcatFolder, outfilename=C:\trash\TestConcatFolder_Sortie\fichierXPS1_IND_PAGE.xps, recursivemode=Disabled
SYST	EE	19/04/2018-18:36:20	13292	Process 9676 stopped with return code 255
SYST	WW	19/04/2018-18:36:20	13292	Device devTEST_DUPLEX on error: default

Remarque 7 – Variable d'environnement dans le nom du fichier

Il est possible d’inclure des valeurs de variables d’environnement dans les noms des fichiers générés. Pour cela, il faut appeler le nom des variables avec [%...%], par exemple [%MAP_JOBNUM%] pour la variable MAP_JOBNUM (numéro du job).