Spécifications de ONYX Xpress

== Introduction ==

ONYX Xpress est une solution destinée à être embarquée dans un applicatif métier. 

Les fonctionnalités de base permettent de convertir un flux d’entrée et de le diriger vers une imprimante. 

ONYX Xpress permet également de maquetter des documents ou flux d’entrée, puis de les imprimer. 

A chaque niveau correspond une limitation faite sur la possibilité d’obtenir une clé de licence selon le type d’installation :  

La licence est soit affectée à une device, peu importe le nombre d'installations du logiciel, soit limitée à une installation de serveur, peu importe le nombre d’imprimantes déclarées. 

Cet article présente les spécifications fonctionnelles de ONYX Xpress.

== Prérequis ==

Les prérequis nécessaires à l’installation de ONYX Xpress sont détaillés dans le guide d’installation ONYX Xpress. 

Les systèmes d'exploitation compatibles sont : 
* Windows Server 2012, 2016 et 2019
* Red Hat Enterprise Linux (RHEL) 7

L’utilisation de Javascript doit être autorisée et activée.

==Formats d’impression supportés== 

Les langages d'impression supportés en entrée sont : XML Draw, Texte paginé, AFPDS, PCL 5, PDF, PostScript, XPS, Image (BMP, JPG, PNG, TIFF), ESCP, IGP, IPL, TEC, ZPL. 

Il est important de noter que certains langages d'impression peuvent être couverts partiellement à l'égard de leur norme complète.

==Clés de licence== 

Les clés de licence sont gérées à partir d'une interface Web sécurisée de type Extranet.

Une seule clé est nécessaire pour activer les fonctionnalités de M-Xpress ainsi que les options disponibles.

En revanche, aucune clé n'est nécessaire pour installer ou utiliser M-Designer.

==Installation== 

L’installation de M-Xpress est prévue pour être la plus simple possible. Seuls le répertoire des programmes et celui des données peuvent être modifiés. 

Voir : [[Installation de M-Xpress]]

Une fois le logiciel installé, il faudra lancer le processus de configuration, accessible par un navigateur Web. La configuration permettra de gérer les imprimantes, la configuration du logiciel et la mise en marche ou l’arrêt du logiciel.

==Spooler== 

M-Xpress est capable de recevoir des flux et les diriger vers la bonne file d’attente d’impression. Une interface de monitoring du spooler décrit, pour chaque file d’attente, les travaux « en cours » ou « en erreur ».

==Détection des données à imprimer== 

A la réception des fichiers, les identifiants de l’imprimante sont vérifiés de façon régulière. 

Deux méthodes sont possibles pour envoyer des fichiers à imprimer.  

===Dépôt de fichiers===

La première méthode implique que chaque imprimante configurée dans le spooler soit liée à un répertoire (paramétrable). Ce répertoire est scanné régulièrement et les fichiers présents sont envoyés au processus d’impression.

===Protocole LPR=== 

Autrement, il sera aussi possible d’envoyer un fichier par le protocole d’impression LPR (Line Printer Remote), en utilisant l’adresse IP du poste où est installé M-Xpress et le nom de l’imprimante (définie lors de l’ajout de l’imprimante) comme nom de file d’attente.

==Conversion== 

A la réception d’une commande de conversion, le fichier reçu sera converti dans le langage d’impression correspondant à l’imprimante de destination. 

Pour réaliser la conversion, M-Xpress sera capable de repérer le format du fichier d’entrée par détection automatique. 

Si un langage d’entrée a plusieurs configurations possibles, alors il faudra définir autant de files d’attente que de types de profil à traiter. 

Avant l’envoi du fichier converti à l’impression, un processus de validation est lancé.

==Envoi et impression== 

A la réception d’une commande d’impression, plusieurs paramètres doivent être reconnus pour valider le processus. 

L’impression du fichier envoyé ne pourra être assurée qu’après avoir détecté le format du fichier d’entrée. Si le format est non reconnu alors le format appliqué sera le format texte par défaut. 

Si le processus de validation ne présente pas d’erreur, le fichier résultant de la conversion sera envoyé à l’imprimante. La communication avec l’imprimante pourra se faire de trois façons : 

===Communication LPR=== 

Le fichier est envoyé via le protocole LPR à l’imprimante dont l’adresse IP est définie lors de l’ajout de l’imprimante.

===Communication USB=== 

Le fichier est envoyé à l’imprimante par communication USB grâce à l’identification du port défini lors de l’ajout de l’imprimante. 

Dans le cas d'une imprimante Toshiba DB4, le mode de transfert (brut ou contrôlé) devra être identifié avant l'impression du fichier. 

Le changement de port est géré automatiquement avec mise à jour des paramètres renseignés dans le fichier de configuration des files d’attentes.

==Traitement de flux XML==

Le REST Service accepte en entrée tous les formats d'entrée listés ci-dessus.

La communication par REST Service permet par exemple de :
*Réceptionner un flux XML encapsulé dans une enveloppe JSON
*Restituer un document PDF créé à partir de ce flux

==Maquettage==

M-Xpress comprend la possibilité d’appliquer une maquette au flux entrant.    

La conception de maquettes de documents nécessite l’utilisation du logiciel M-Designer, celui-ci devant être installé sur un poste Windows.

==Ajout et configuration d’une imprimante== 

L’ajout d’une imprimante se fait par la page Web de configuration, il y a deux options possibles : 

Lors de l’ajout de la première imprimante, une clé de licence est demandée. Cette clé est liée au poste sur lequel est installé le logiciel M-Designer. Une fois cette clé renseignée, il sera possible d’ajouter un nombre illimité d’imprimantes. Par contre, pour ajouter une imprimante, il faudra préciser son modèle.  

Il faut déclarer chaque imprimante et préciser ses caractéristiques manuellement. Il est aussi demandé de donner un nom unique à l’imprimante. 

Pour permettre la communication avec l’imprimante, il est demandé de renseigner son adresse IP ou de sélectionner son driver selon la communication choisie.

==Utilisation de maquettes M-Designer== 

Le logiciel M-Designer doit être configuré pour s’adresser au serveur où se trouve le logiciel M-Xpress. 

Après avoir créé une maquette, il faut la générer avec M-Designer. Cette action aura pour effet d’envoyer la maquette au logiciel M-Xpress. Pour ensuite pouvoir exploiter la maquette, il faudra l’importer depuis l’interface de configuration avec la possibilité d’écraser, si besoin, une maquette du même nom déjà existante. 

Une fois la maquette importée, celle-ci peut alors être utilisée. Chaque type de maquette défini par son nom est traitée par une device qui lui est attribuée et qui déclenche l’exécution de la maquette. Cette liaison est définie au niveau de la configuration de l'imprimante.

==Interface Web== 

L’utilisateur a accès à une interface Web lui permettant de gérer et de configurer certains paramètres. Cette interface est accessible en multilingue.

===Page d'accueil===

Depuis la page d’accueil de l’interface, l’utilisateur peut : 

*Démarrer le service de spooler
*Consulter l’état du spooler « en cours » ou « en erreur »
*Accéder à des informations génériques sur les traitements effectués

===Gestion des imprimantes et des files d'attente=== 

Depuis cette interface, l’utilisateur peut : 

*Afficher les caractéristiques détaillées
*Modifier des informations 
*Ajouter/modifier une file d'attente à laquelle il est possible d'associer une imprimante, une maquette, un répertoire scanné 
*Ajouter une imprimante : il faut nommer l’imprimante et spécifier les informations de connexion selon le mode choisi par l’utilisateur
*Créer / modifier le fichier de configuration des files d’attente

===Configuration des conversions===  

Depuis cette interface, l’utilisateur peut : 

* Paramétrer certains langages en entrée manuellement par le fichier de configuration des conversions. La détection des langages en entrée est automatique mais il est possible d’utiliser certains profils paramétrés par l’utilisateur 
* Créer le fichier de configuration à partir du formulaire de saisie pré-rempli selon le modèle d’imprimante 
* Traiter les données 
* Demander / afficher les informations de conversion

===Gestion des logs===

Depuis cette interface, l’utilisateur peut : 

* Consulter des logs avec filtres
* Exporter des logs en format texte ajustés selon les filtres actifs

===Gestion des paramètres généraux===

Depuis cette interface, l’utilisateur peut : 

* Configurer le niveau de logs 
* Modifier les paramètres généraux dans le fichier de configuration

===Gestion des licences===

Depuis cette interface, l’utilisateur peut : 

* Afficher l'identifiant de la machine 
* Ajouter la clé de licence Serveur

===Configuration de transformations précablées===

Depuis cette interface, l’utilisateur peut : 

* Ajouter et configurer le REST Service