Xerox FreeFlow Web Services Mode d'emploi

Version 8.0
Octobre 2009
708P89700
Services JMF FreeFlow®
Guide de l'utilisateur
Xerox Corporation
Global Knowledge and Language Services
800 Phillips Road - Bldg. 218-01A
Webster, NY 14580 États-Unis
© 2000-2009 Xerox Corporation. Tous droits réservés. Xerox® et le symbole de sphère de connectivité, FreeFlow®,
FreeFlow Makeready, FreeFlow Output Manager et FreeFlow Process Manager sont des marques de Xerox Corporation
aux États-Unis et dans d'autres pays.
Les marques d'autres sociétés sont reconnues comme suit :
Adaptec®, le logo Adaptec, SCSlSelect® et EZ-SCSI® sont des marques d'Adaptec, Inc.
Adobe PDFL - Adobe PDF Library Copyright © 1987-2008 Adobe Systems Incorporated.
Adobe®, le logo Adobe logo, Acrobat®, le logo Acrobat logo, Acrobat Reader®, Distiller®, Adobe PDF JobReady™,
PostScript® et le logo PostScript sont des marques ou des marques déposées d'Adobe Systems Incorporated aux ÉtatsUnis et dans d'autres pays. Toutes les mentions du terme « PostScript » dans ce texte font référence au langage
PostScript défini par Adobe Systems Incorporated, sauf indication contraire. Le terme « PostScript » est également utilisé
en tant que marque de l'implémentation par Adobe Systems de l'interpréteur PostScript et d'autres produits Adobe.
Copyright 1987 - 2008 Adobe Systems Incorporated et ses concédants de licence. Tous droits réservés.
Autologic® est une marque déposée d'Autologic Information International, Inc.
Compaq® et QVision® sont des marques déposées auprès de l'Office des brevets et des marques des États-Unis
d'Amérique pour Compaq Computer Corporation.
DEC, DEC RAID et Redundant Array of Independent Disks sont des marques déposées de Digital Equipment Corporation.
Dundas - Ce logiciel contient des données protégées par droit d'auteur, (c) 1997-2000 DUNDAS SOFTWARE LTD. Tous
droits réservés.
Imaging Technology sous licence Accusoft Corporation.
ImageGear © 1996-2005 par AccuSoft Corporation. Tous droits réservés.
Intel® et Pentium® sont des marques déposées d'Intel Corporation.
Novell® et NetWare® sont des marques déposées de Novell, Inc. aux États-Unis et dans d'autres pays.
Oracle® est une marque déposée d'Oracle Corporation Redwood City, Californie.
ScanFix® Image Optimizer et ImagXpress sont des marques déposées ou des marques de Pegasus Imaging Corp.
Copyright© 1997-2008 Pegasus Imaging Corp. Tous droits réservés.
SonyTM et Storage by SonyTM sont des marques de Sony.
PANTONE ™ et toutes les autres marques Pantone Inc. sont la propriété de Pantone Inc.
Preps™ est une marque déposée de Creo Inc. Tous droits réservés.
Quark® et QuarkXpress® sont des marques déposées de Quark, Inc.
StorageViewTM est une marque de CMD Technology, Inc.
TIFF® est une marque déposée d'Aldus Corporation.
Windows®, Windows XP®, Windows Server® 2003 et Internet Explorer sont des marques de Microsoft Corporation ;
Microsoft® et MS-DOS® sont des marques déposées de Microsoft Corporation.
Copyright partiel © 2001 artofcode LLC.
Ce logiciel est basé en partie sur le travail du groupe indépendant JPEG.
Copyright partiel © 2001 URW++. Tous droits réservés.
Ce produit inclut des logiciels développés par Apache Software Foundation.
Copyright © 1999-2003 The Apache Software Foundation. Tous droits réservés.
Ce logiciel est basé en partie sur les travaux de Graeme W. Gill.
© Press-sense Ltd. 2002-2007. Tous droits réservés.
Inclut les bibliothèques PDF Adobe® et la technologie Adobe Normalizer.
Le format Graphics Interchange Format© est la propriété de CompuServe Incorporated. GIFSM est une marque de
service de CompuServe Incorporated.
Des portions de ce produit contiennent la mise en œuvre de l'algorithme LZW sous licence de brevet américain
4,558,302.
Certaines parties de ce logiciel sont protégées par copyright © 2004-2006 Enterprise Distributed Technologies Ltd. Tous
droits réservés.
Certaines parties de ce logiciel sont protégées par les lois de reproduction ©1995-2003, The Cryptix Foundation Limited.
Tous droits réservés.
Certaines parties de ce logiciel constituent une implémentation SSLv3/TLS écrite par Eric Rescorla et dont la licence est
détenue par Claymore Systems, Inc. Tous droits réservés.
Certaines parties de ce logiciel sont protégées par les lois de reproduction © 2002, Lee David Painter et collaborateurs.
Contributions de Brett Smith, Richard Pernavas, Erwin Bolwidt.
Des parties de ce logiciel sont sous copyright © 1995-2005, Jean-Loup Gailly et Mark Adler.
Les autres noms de produits et services sont des marques de leurs sociétés respectives. Ils sont mentionnés dans cette
publication en reconnaissance des droits de ces sociétés mais ne constituent ni une recommandation de ces produits et
services, ni une quelconque affiliation avec ces sociétés.
Bien que toutes les mesures de précaution aient été prises lors de la préparation de ce document, aucune responsabilité
concernant une quelconque inexactitude ou omission ne sera acceptée de la part de Xerox Corporation.
Imprimé aux États-Unis.
Les noms de société et d'individus et les données utilisés dans les exemples sont fictifs, sauf indication contraire.
Le présent document est régulièrement modifié. Les modifications, les mises à jour techniques et les corrections
typographiques seront apportées dans les versions ultérieures.
Table des matières
1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Glossaire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Objectif du document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Généralités . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
2
Installation, désinstallation, mise à niveau et configuration. . 2-1
Configuration requise pour le poste de travail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Configuration matérielle minimale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Configuration logicielle minimale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Configuration des groupes et des utilisateurs . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Désinstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Mise à niveau. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Sauvegarde et restauration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Installation des correctifs et des mises à jour. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Paramètres de configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Modification du paramètre de durée de conservation des travaux . . . . . . . 2-8
Paramètres de serveur proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
Paramètres de nouvelle tentative/délai ReturnQueueEntry . . . . . . . . . . . . . . 2-8
Configuration des paramètres de pare-feu Windows . . . . . . . . . . . . . . . . . . . . 2-9
Configuration des clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Configuration d'Adobe Acrobat 7, 8 et 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Configuration de FreeFlow Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Ajout et configuration d'imprimantes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
Arrêt et redémarrage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
3
Requêtes et commandes JMF prises en charge . . . . . . . . . . . . . . 3-1
SubmitQueueEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Canaux permanents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Signaux d'état. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
ReturnQueueEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
KnownDevices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
AbortQueueEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
SuspendQueueEntry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
ResumeQueueEntry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Status Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Status Queue Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Guide de l'utilisateur
i
Table des matières
4
Services JMF FreeFlow
Commande CLI prises en charge . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
update-devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
shutdown-system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
list-devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
list-jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
get-job-attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Affichage de la version du logiciel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
4-1
4-1
4-2
4-2
4-3
4-3
Résolution des problèmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Activation de la connexion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
Connexion d'imprimante . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
6
Restrictions : . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
Création de bons de travail JDF dans Adobe Acrobat Professional . . . . . . . . . . . 6-1
7
Informations complémentaires sur Web Services. . . . . . . . . . . . 7-1
FreeFlow Web Services et impression de production Xerox. . . . . . . . . . . . . . . . . . . 7-1
Signaux d'état JMF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
ii
Guide de l'utilisateur
Introduction
1
Glossaire
Cette section fournit une liste des termes importants utilisés dans le présent document :
•
MIS : acronyme de « Management Information Systems » (systèmes d'informations de
gestion). Il s'agit de la partie fonctionnelle d'un flux de travail qui gère tous les processus et
les communications entre les composants système et le centre de contrôle du système.
•
Périphérique : composant d'un flux de travail JDF qui interprète les commandes JDF et
exécute les instructions.
•
Contrôleur : composant d'un flux de travail basé sur JDF, chargé de la préparation des
périphériques, du routage JDF et de la communication des informations d'état.
•
Canal permanent : connexion dédiée qui permet aux services JMF d'envoyer des signaux
aux systèmes MIS.
•
JDF (Job Definition Format) : format de base de données XML qui définit un travail
d'impression en terme des produits à créer ainsi que des processus requis pour les créer.
Le format JDF fournit un contenant pour définir un travail.
•
JMF (Job Messaging Format) : format de données XML basé sur le format JDF. Il s'agit
d'un protocole qui active les composants d'un flux de travail JDF pour la communication.
JMF fournit une série de commandes et d'objets de recherche, tels que la soumission de
travail JDF, la gestion des files, la description des fonctionnalités des périphériques et la
notification d'événements.
Objectif du document
Le Guide de l'utilisateur des services JMF est un document général qui couvre les points suivants :
•
Installation du logiciel
•
Configuration des différents clients pris en charge, dont :
–
Adobe Acrobat
–
FreeFlow Web Services
•
Liste des requêtes et commandes prises en charge
•
Commandes de l'interface de ligne de commande prises en charge
Pour plus d'informations sur l'utilisation des clients pris en charge, reportez-vous à la
documentation client.
Guide de l'utilisateur
1-1
Introduction
Services JMF FreeFlow
Généralités
Les services JMF de FreeFlow comprennent une implémentation de la version 1.2 de la
spécification JDF. Le niveau de prise en charge est décrit dans le document intitulé FreeFlow
JDF Support Specification, version 8.0. Il est conforme à un sous-jeu de systèmes MIS ICS
niveau 2 et à un sous-jeu de systèmes MIS ICS niveau 3. Les services JMF de FreeFlow sont
fournis via http pour des interactions non sécurisées uniquement.
Les services JMF de FreeFlow prennent en charge les clients JMF tels que Adobe Acrobat 7 et 8
Professional et FreeFlow Web Services. La configuration de ces clients est décrite dans la
section 2.3.
Les services JMF de FreeFlow soumettent des travaux directement aux imprimantes et sont
donc considérés comme un périphérique car ils fonctionnent comme un proxy pour
l'imprimante qui exécute les nœuds JDF.
Les services JMF de FreeFlow prennent en charge les tâches suivantes :
•
Accepter les messages de commande SubmitQueueEntry
•
Accepter les messages de recherche d'état avec une souscription aux mises à jour de l'état
des imprimantes et des travaux
•
Envoyer des messages de signal d'état à un ou plusieurs abonnés utilisant des ports
différents ou des adresses IP complètement distinctes
•
Renvoyer l'instance de fichier JDF modifiée au client une fois le travail terminé ou
abandonné via le message de commande ReturnQueueEntry
•
Accepter les messages de requête KnownDevices
•
Accepter les messages de commande AbortQueueEntry
•
Accepter les messages de commande StopPersistentChannel
•
Accepter les messages Status Queue Query
1-2
Guide de l'utilisateur
Installation,
désinstallation, mise
à niveau et
configuration
2
Cette section explique comment installer les services JMF de FreeFlow.
Configuration requise pour le poste de
travail
Pour exécuter ces applications logicielles, le poste de travail utilisé doit remplir les conditions
matérielles et logicielles suivantes :
Configuration matérielle minimale
•
•
Pour les systèmes clients Windows XP et Windows Vista, au moins 2 Go de mémoire RAM
doivent être installés sur l'ordinateur en configuration autonome. L'ordinateur doit
disposer d'au moins 80 Go d'espace sur le disque dur, selon la taille des travaux envoyés à
partir du client. Le minimum requis est un processeur P4 cadencé à 2.2GHz, mais selon le
système d'exploitation utilisé, un processeur plus rapide peut être requis.
Si le service JMF réside sur le même hôte que FreeFlow Web Services, les conditions
matérielles requises sont identiques à celles de l'application FreeFlow Web Services.
Configuration logicielle minimale
•
•
•
•
Windows Server 2003 avec SP2 ou Windows Server 2003 R2 avec SP2
Windows Server 2008 avec SP2
Windows XP avec SP3
Windows Vista avec SP2
Guide de l'utilisateur
2-1
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Installation
Les services JMF de FreeFlow sont conçus pour être exécutés sur un hôte unique et ne doivent
pas résider sur le même hôte que d'autres applications FreeFlow, à l'exception de Print
Manager et Web Services.
Remarque
Lors d'une installation avec Web Services, la méthode conseillée consiste à installer les
services JMF sur le même système que l'application Web Services.
FreeFlow Output Manager et FreeFlow Process Manager étant dotés d'un service JMF Service
incorporé, il est inutile d'installer la version autonome des services JMF. L'utilisateur connecté
doit disposer de droits d'administrateur pour installer le programme sur une plate-forme
Windows. Les informations suivantes sont nécessaires pour l'installation :
•
Répertoire racine pour l'installation. Il s'agit par défaut de « C:\Program
Files\Xerox\FreeFlow Print Manager JMF Service ».
Procédez comme suit pour installer le produit :
1.
Si le programme d'installation ne démarre pas automatiquement, cliquez deux fois sur le
fichier install.exe.
2.
Sélectionnez une langue dans le menu déroulant. Cliquez sur <OK>.
3.
Cliquez sur <Suivant> dans l'écran d'introduction.
4.
Dans l'écran du contrat de licence de logiciel, sélectionnez « J'accepte... » pour accepter les
termes du contrat de licence utilisateur final. Cliquez sur <Suivant>.
5.
Dans l'écran de sélection des applications, sélectionnez Services JMF FreeFlow et
Enregistrement des imprimantes. Cliquez sur <Suivant>.
6.
Dans l'écran de sélection du dossier d'installation, acceptez le répertoire d'installation par
défaut ou spécifiez un emplacement différent. Cliquez sur <Suivant>.
7.
Dans l'écran de sélection du dossier des raccourcis, sélectionnez une option de raccourci.
Cliquez sur <Suivant>.
8.
Vérifiez les options d'installation dans l'écran Récapitulatif avant installation. Cliquez sur
<Installer>.
9.
Cliquez sur <Terminé> pour terminer l'installation du logiciel et redémarrer le système.
Une fois le système redémarré, les raccourcis suivants sont disponibles dans le menu Démarrer
sous « Xerox FreeFlow->Services JMF » :
•
Services
•
Ligne de commande
Le raccourci Services permet d'arrêter et de démarrer les services JMF de FreeFlow. La ligne de
commande permet d'invoquer les commandes correspondantes des services JMF de FreeFlow.
Si le pare-feu Windows est activé, il est possible que l'utilisateur doive configurer le pare-feu de
façon à permettre la communication avec les services JMF de FreeFlow. Aller à Configuration
des paramètres de pare-feu Windows à la page 9.
S'il est nécessaire de configurer la durée de conservation des travaux, les paramètres de serveur
proxy ou les paramètres de nouvelle tentative/délai ReturnQueueEntry, reportez-vous à la
rubrique Paramètres de configuration à la page 8.
2-2
Guide de l'utilisateur
Services JMF FreeFlow
Installation, désinstallation, mise à niveau et configuration
Configuration des groupes et des utilisateurs
Afin de pouvoir utiliser les services JMF de FreeFlow, il est nécessaire d'ajouter des utilisateurs
au groupe « Xerox FreeFlow JMF Service Administrators » (Administrateurs des services JMF
Xerox FreeFlow) et au groupe « Xerox FreeFlow Common Printer Administrators »
(Administrateurs des imprimantes communes Xerox FreeFlow).
Ajout d'utilisateurs au groupe « Xerox FreeFlow Common Printer
Administrators » (Administrateurs des imprimantes communes Xerox
FreeFlow)
Le groupe « Xerox FreeFlow Common Printer Administrators » (Administrateurs des imprimantes
communes Xerox FreeFlow) contrôle les utilisateurs autorisés à ajouter une imprimante au
système. Seuls les utilisateurs membres de ce groupe peuvent ajouter ou modifier une
imprimante dans l'application Enregistrement des imprimantes.
Procédez comme suit pour configurer le groupe d'utilisateurs :
1.
Cliquez avec le bouton droit de la souris sur l'icône Poste de travail et sélectionnez Gérer.
2.
Ouvrez le dossier Utilisateurs et groupes locaux. Ouvrez ensuite le dossier Groupes.
3.
Sélectionnez le groupe « Xerox FreeFlow Common Printer Administrators » (Administrateurs
des imprimantes communes Xerox FreeFlow).
4.
Ajoutez des utilisateurs au groupe. Si nécessaire, créez tout d'abord les utilisateurs
spécifiques qui doivent avoir accès à l'application.
5.
Fermez la fenêtre Gestion de l'ordinateur et connectez-vous en tant que l'un des utilisateurs
ajoutés au groupe.
6.
Sélectionnez Démarrer->Programmes->Xerox FreeFlow Software->Gestion de l'impression>Enregistrement des imprimantes.
7.
Dans la boîte de dialogue des applications installées, vérifiez que la case des services JMF
FreeFlow est cochée. Cliquez sur <OK>.
8.
Sélectionnez une ou plusieurs imprimantes de production. Si nécessaire, les utilisateurs sont
invités à se reporter à l'aide en ligne de l'application Enregistrement des imprimantes pour
plus d'informations sur l'ajout d'une imprimante.
Guide de l'utilisateur
2-3
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Ajout d'utilisateurs au groupe « Xerox FreeFlow JMF Service Administrators
» (Administrateurs des services JMF Xerox FreeFlow)
Les services JMF de FreeFlow reposent sur les mécanismes de sécurité sous-jacents du système
d'exploitation pour l'authentification. Tous les utilisateurs authentifiés doivent avoir un compte
sur l'hôte qui exécute les services JMF de FreeFlow.
Les autorisations sont mises en œuvre via l'interface de ligne de commande (CLI), qui doit
résider sur l'hôte exécutant les services JMF de FreeFlow. Cette interface utilise les informations
d'identification associées à l'utilisateur connecté pour l'autorisation. Seul un niveau d'accès est
pris en charge, le niveau « Xerox FreeFlow JMF Service Administrators » (Administrateurs des
services JMF Xerox FreeFlow). Avant d'exécuter toute commande dans l'interface de ligne de
commande, ce groupe doit être créé et l'utilisateur doit y être associé.
Procédez comme suit pour configurer le groupe d'utilisateurs :
1.
Cliquez avec le bouton droit de la souris sur l'icône Poste de travail et sélectionnez Gérer.
2.
Ouvrez le dossier Utilisateurs et groupes locaux. Ouvrez ensuite le dossier Groupes.
3.
Sélectionnez le groupe « Xerox FreeFlow JMF Service Administrators » (Administrateurs des
services JMF Xerox FreeFlow).
4.
Ajoutez des utilisateurs au groupe. Si nécessaire, créez tout d'abord les utilisateurs
spécifiques qui doivent avoir accès à l'application.
5.
Fermez la fenêtre Gestion de l'ordinateur et connectez-vous en tant que l'un des utilisateurs
ajoutés au groupe « Xerox FreeFlow JMF Service Administrators » (Administrateurs du
Service JMF Xerox FreeFlow).
Désinstallation
Avant de désinstaller les services JMF de FreeFlow, il convient de désinstaller le service
d'autorisation FreeFlow. La désinstallation du service d'autorisation FreeFlow s'effectue à partir
de la boîte de dialogue Ajout/Suppression de programmes de Windows (Démarrer>Paramètres->Panneau de configuration). Cliquez sur « Ajouter ou supprimer des programmes »
dans le menu.
Une fois le service JMF de FreeFlow désinstallé, les fichiers générés depuis l'installation, tels que
les travaux, imprimantes et données en attente, ne sont pas supprimés.
La désinstallation des services JMF de FreeFlow s'effectue à partir de la boîte de dialogue
Ajout/Suppression de programmes de Windows (Démarrer->Paramètres->Panneau de
configuration). Cliquez sur « Ajouter ou supprimer des programmes » dans le menu.
L'application Enregistrement des imprimantes FreeFlow peut également être désinstallée.
La désinstallation de l'outil Enregistrement des imprimantes s'effectue à partir de la boîte de
dialogue Ajout/Suppression de programmes de Windows (Démarrer->Paramètres->Panneau de
configuration). Cliquez sur « Ajouter ou supprimer des programmes » dans le menu.
2-4
Guide de l'utilisateur
Services JMF FreeFlow
Installation, désinstallation, mise à niveau et configuration
Mise à niveau
Il est possible de mettre à niveau les services JMF de FreeFlow de la version 7.0 à la version 8.0.
La procédure requiert la sauvegarde du répertoire « persistence » et la désinstallation des
services JMF, du service d'autorisation et de l'utilitaire Enregistrement des imprimantes.
Pour sauvegarder les services JMF, accédez à l'emplacement d'installation de la version 7.0 :
C:\Program Files\Xerox\FreeFlow Print Manager JMF Service. Copiez le répertoire suivant à
l'emplacement de sauvegarde :
•
persistence
Désinstallez les services JMF, le service d'autorisation et l'utilitaire Enregistrement des
imprimantes. Reportez-vous à la rubrique Désinstallation à la page 4 pour plus d'informations.
Installez les services JMF FreeFlow en suivant la procédure décrite dans la rubrique Installation
à la page 2. Procédez à toutes les sous-opérations de configuration de manière à ce que les
utilisateurs et les groupes d'utilisateurs soient correctement configurés.
S'il est nécessaire de configurer la durée de conservation des travaux, les paramètres de serveur
proxy ou les paramètres de nouvelle tentative/délai ReturnQueueEntry et si le fichier n'a pas été
modifié, reportez-vous à la rubrique Paramètres de configuration à la page 8.
Sauvegarde et restauration
Les commandes de sauvegarde et restauration vous permettent de sauvegarder les services
JMF FreeFlow pour pouvoir les restaurer ultérieurement en cas d'erreur irréparable ou les utiliser
à des fins de migration d'un système vers un autre. Lors de la sauvegarde, les imprimantes
créées à l'aide de l'utilitaire Enregistrement des imprimantes et des informations de
configuration des services JMF sont sauvegardées. Les fonctions de restauration et de
sauvegarde sont accessibles de deux façons :
Accès aux fonctions de sauvegarde et de restauration via les raccourcis de programme
•
Démarrer->Programmes->Xerox FreeFlow->FreeFlow Services JMF >Sauvegarde
Une boîte de dialogue invite l'utilisateur à spécifier un nom de fichier de sauvegarde.
•
Démarrer->Programmes->Xerox FreeFlow->FreeFlow Services JMF >Restauration
Une boîte de dialogue invite l'utilisateur à spécifier un nom de fichier de restauration.
Remarque : lors de l'exécution d'une sauvegarde ou d'une restauration sous Windows Vista
ou Windows 2008 Server, vous devez paramétrer l'invite de commande sur « Exécuter en
tant qu'administrateur ». Pour ce faire, cliquez avec le bouton droit sur la commande et
sélectionnez « Exécuter en tant qu'administrateur »
Il est possible d'accéder aux fonctions de sauvegarde et de restauration à l'aide de l'interface
de ligne de commande. Il suffit de taper les commandes dans la fenêtre d'invite de commande
Windows. La commande de sauvegarde peut également être utilisée en conjonction avec la
fonction de tâches planifiées de Windows afin de réaliser des sauvegardes automatiques.
Pour exécuter une sauvegarde ou une restauration sous Windows Vista ou Windows 2008
Server, vous devez paramétrer l'invite de commande sur « Exécuter en tant qu'administrateur ».
Pour ce faire, sélectionnez « Invite de commande » dans le menu Démarrer (par ex. Démarrer>Tous les programmes->Xerox FreeFlow->Services JMF->Invite de commande), cliquez avec le
bouton droit sur Invite de commande et sélectionnez « Exécuter en tant qu'administrateur
système ».
Guide de l'utilisateur
2-5
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Accès aux fonctions de sauvegarde et de restauration à partir de la ligne de commande
•
Entrez la commande jmfsvc_backup, suivie du chemin complet du fichier de sauvegarde à
créer
Exemple : jmfsvc_backup “C:\backups\jmfsvc_sauvegarde.zip”
Remarque
Il n'est pas obligatoire de spécifier le chemin du fichier de sauvegarde dans la commande.
Si le chemin du fichier est omis, le fichier de sauvegarde est créé dans le sous-dossier
Backups du dossier d'installation des services JMF FreeFlow (par ex. C:\Program
Files\xerox\FreeFlow Print Manager JMF Service\Backups). Le nom du fichier de
sauvegarde est au format
« ffbackup_JMFService_AAAAMMJJ_x.zip” où AAAA représente l'année, MM le mois, JJ le
jour et x le numéro de la sauvegarde pour le jour donné.
•
Entrez la commande jmfsvc_backup, suivie du chemin complet du fichier de sauvegarde à
restaurer.
Exemple : jmfsvc_restore “C:\backups\jmfsvc_restauration.zip”
Migration
Il est possible de déplacer les services JMF FreeFlow d'un système vers un autre. Il est
également possible de les déplacer vers un système d'exploitation après la mise à niveau de
celui-ci, après y avoir installé les services JMF FreeFlow. Cette opération fait appel aux
commandes de sauvegarde et de restauration décrites à la section Sauvegarde et restauration.
Migration (Système A vers système B)
La procédure suivante permet de déplacer les services JMF FreeFlow du système actuel
(Système A) vers un autre système (Système B).
1.
Commencez par effectuer une sauvegarde des services JMF FreeFlow 8.0 sur le système A
selon la procédure de sauvegarde décrite à la section précédente. Copiez le fichier zip de
sauvegarde sur un support distant (dossier distant ou CD-ROM, par exemple).
2.
Copiez le fichier zip de sauvegarde à un emplacement donné sur le système B.
3.
Installez les services JMF FreeFlow 8.0 sur le système B.
4.
Lancez la restauration des services JMF FreeFlow 8.0 à partir de l'emplacement du système
B où vous aviez copié le fichier zip de sauvegarde.
Migration (Mise à niveau du système d'exploitation sur le même système)
La procédure suivante permet de mettre à niveau le système d'exploitation Windows (par ex.
Windows Server 2003 vers Windows Server 2008) sur le système où sont installés des services
JMF FreeFlow.
1.
Effectuez une sauvegarde des services JMF FreeFlow 8.0 selon la procédure de sauvegarde
décrite à la section précédente. Copiez le fichier zip de sauvegarde sur un support distant
(dossier distant ou CD-ROM, par exemple).
2.
Effectuez la mise à niveau du système d'exploitation. Cette opération efface le contenu du
disque dur.
3.
Installez les services JMF FreeFlow 8.0
4.
Lancez la restauration à partir de l'emplacement du système B où vous aviez copié le fichier
zip de sauvegarde.
2-6
Guide de l'utilisateur
Services JMF FreeFlow
Installation, désinstallation, mise à niveau et configuration
Installation des correctifs et des mises à
jour
De temps à autre, l'installation d'un correctif peut s'avérer nécessaire pour le logiciel des
services JMF FreeFlow. Cette section décrit les procédures d'installation de correctifs.
Pour installer le correctif des services JMF FreeFlow, il est nécessaire d'être connecté en tant
qu'utilisateur disposant de droits d'administrateur Windows.
1.
Cliquez deux fois sur le fichier exécutable (.exe) pour lancer l'installation. Le disque
s'exécute automatiquement. Si vous disposez d'un CD de correctif, insérez-le dans le
lecteur.
2.
Dans l'écran de démarrage, sélectionnez la langue requise dans le menu déroulant et
cliquez sur <OK>.
3.
Dans l'écran d'introduction des services JMF Xerox FreeFlow, cliquez sur <Suivant>.
4.
Dans l'écran récapitulatif qui s'affiche avant l'installation, cliquez sur <Installer>.
L'installation du correctif des services JMF FreeFlow commence.
5.
Une fois l'installation terminée, assurez-vous que la case <Oui, redémarrer mon système>
est sélectionnée.
6.
Cliquez sur <Terminé>. Le système redémarre.
Guide de l'utilisateur
2-7
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Paramètres de configuration
Les services JMF de FreeFlow comportent des paramètres qu'il est possible de changer en
modifiant manuellement un fichier de configuration. Il est également nécessaire de suivre
certaines étapes pour permettre la communication avec le pare-feu Windows.
Modification du paramètre de durée de conservation des travaux
Les services JMF conservent généralement les travaux terminés et abandonnés pendant un jour.
Il est possible de changer cette durée de conservation en modifiant le fichier
« Jdfjmfgateway.properties ». Procédez comme suit :
1.
Accédez à un éditeur de texte du système (Bloc-notes, par exemple).
2.
Ouvrez le fichier « Jdfjmfgateway.properties » dans l'éditeur de texte. Le fichier se situe
dans le répertoire suivant : C:\Program Files\Xerox\FreeFlow Print Manager JMF
Service\config.
3.
Recherchez l'entrée « RETENTION_PERIOD=86400 » dans le fichier. Modifiez le paramètre
numérique en spécifiant la durée de conservation souhaitée. La valeur correspond à la
durée totale en secondes pendant laquelle les travaux seront conservés.
4.
Enregistrez et fermez le fichier.
Paramètres de serveur proxy
Si un serveur proxy est requis pour la récupération de fichiers à l'aide d'une référence de fichier
http par les services JMF, les paramètres de serveur proxy doivent être configurés.
1.
Accédez à un éditeur de texte du système (Bloc-notes, par exemple).
2.
Ouvrez le fichier « Jdfjmfgateway.properties » dans l'éditeur de texte. Le fichier se situe
dans le répertoire suivant : C:\Program Files\Xerox\FreeFlow Print Manager JMF
Service\config.
3.
Recherchez l'entrée « proxyHost= » dans le fichier. Entrez l'adresse IP ou le nom de serveur
pour l'hôte proxy après le signe égal.
4.
Recherchez l'entrée « proxyPort= » dans le fichier. Entrez le numéro de port pour l'hôte
proxy après le signe égal.
5.
Enregistrez et fermez le fichier.
Paramètres de nouvelle tentative/délai ReturnQueueEntry
S'il est nécessaire de modifier le nombre de tentatives ou le délai entre les tentatives pour le
message ReturnQueueEntry, les paramètres suivants doivent être configurés.
1.
Accédez à un éditeur de texte du système (Bloc-notes, par exemple).
2.
Ouvrez le fichier « Jdfjmfgateway.properties » dans l'éditeur de texte. Le fichier se situe
dans le répertoire suivant : C:\Program Files\Xerox\FreeFlow Print Manager JMF
Service\config.
3.
Recherchez l'entrée « RQERetries = ». Entrez le nombre de tentatives souhaité après le signe
égal.
4.
Recherchez l'entrée « RQERetryDelay = ». Entrez le nombre de secondes correspondant au
délai souhaité entre chaque tentative après le signe égal.
5.
Enregistrez et fermez le fichier.
2-8
Guide de l'utilisateur
Services JMF FreeFlow
Installation, désinstallation, mise à niveau et configuration
Configuration des paramètres de pare-feu Windows
Si les services JMF FreeFlow sont installés sur un PC sur lequel le pare-feu Windows est activé, il
est nécessaire de configurer ce dernier de façon à permettre les communications vers le port des
services JMF FreeFlow.
Procédez comme suit pour configurer les paramètres de pare-feu :
1.
Ouvrez le Panneau de configuration, puis cliquez deux fois sur Centre de sécurité (ou Parefeu selon la version de système d'exploitation).
2.
Sélectionnez le lien Pare-feu Windows (ou « Autoriser un programme via le Pare-feu
Windows »).
3.
Sélectionnez l'onglet Exceptions.
4.
Sélectionnez le bouton <Ajouter un port>.
5.
Dans le champ Nom, saisissez « FreeFlow JMF Service ».
6.
Dans le champ Numéro du port, saisissez « 7781 ». 7781 est un numéro de port par défaut
qui peut être modifié. Remplacez 7781 par la valeur de l'entrée « ServerPort », dans le
fichier de configuration « jdfjmfgateway.properties ».
7.
Sélectionnez <OK> pour fermer la boîte de dialogue Ajouter un port. Cliquez sur <OK> pour
fermer la boîte de dialogue.
Configuration des clients
Les sections suivantes expliquent comment configurer les applications clientes prises en charge
par les services JMF. Suivez ces procédures uniquement pour les clients utilisés pour accéder
aux services JMF FreeFlow. Il est possible d'utiliser les services JMF FreeFlow simultanément
avec plusieurs clients.
Configuration d'Adobe Acrobat 7, 8 et 9
Pour configurer Adobe Acrobat pour la soumission de travaux JDF aux services JMF de FreeFlow,
configurez l'imprimante dans Acrobat en procédant comme suit :
1.
Accédez à l'outil Définitions de travaux JDF à partir de la fenêtre Adobe Acrobat
Professional :
–
Pour Acrobat 7 : Outils->Impression éloignée->Définitions de travail JDF
–
Pour Acrobat 8 et 9 : Options avancées->Impression->Définitions de travaux JDF
2.
Sélectionnez « Gestionnaire du site de production ».
3.
Sélectionnez « Ajouter ». Une boîte de dialogue « Site de production » s'affiche.
4.
Dans la zone des options de soumission, sélectionnez « Convertir en lot MIME et envoyer à
un dispositif JMF ».
5.
Entrez l'URL au format http://<adresse IP ou nom d'hôte des services JMF de FFPM>:7781/
[id périphérique]
Remarque
Si l'adresse réseau des services JMF FreeFlow prend en charge le format IPv4 et/ou IPv6,
entrez l'adresse IP au format IPv4 lors de la saisie de l'URL. Les versions 7 et 8 d'Adobe
Acrobat ne prennent pas en charge les adresses littérales IPv6.
Guide de l'utilisateur
2-9
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Remarque
L'[id périphérique] correspond au nom de l'imprimante spécifié dans l'utilitaire
Enregistrement des imprimantes pour l'imprimante à laquelle les services JMF donnent
accès.
Configuration de FreeFlow Web Services
Remarque
Après l'installation de Web Services et des services JMF, deux instances de l'utilitaire
Enregistrement des imprimantes seront disponibles, l'une depuis Web Services et l'autre
depuis les services JMF. En fonction du produit qui aura été installé le premier, la seconde
instance installée devra pointer vers l'autre pour le bon fonctionnement de l'intégration.
Remarque
Pour de plus amples informations sur l'intégration de Web Services avec les services JMF,
reportez-vous au FreeFlow Web Services Integration Guide (référence : DWS57V7.0E-02).
Pour configurer FreeFlow Web Services pour la soumission de travaux aux services JMF de
FreeFlow, procédez comme suit :
1.
Connectez-vous à FreeFlow Web Services en tant que Print Provider (fournisseur
d'impression).
2.
Effectuez l'une des opérations suivantes :
–
Pour Web Services 7.0 : Ouvrez l'onglet [Paramètres d'impression], puis l'onglet
[Production].
3.
Accédez à l'onglet [Output Devices] (périphériques de sortie).
4.
Cliquez sur le bouton [Add] (ajouter) pour ajouter un nouveau périphérique.
5.
Dans la boîte de dialogue [Add Device] (ajout de périphérique), entrez le nom du
périphérique.
6.
Sélectionnez [Digital] (numérique) dans la section Device Group (groupe de périphériques).
7.
Sélectionnez [FreeFlow - Services JMF] dans la zone Machine Type (type de machine) et
cliquez sur [OK].
8.
Dans la section Output Devices (périphériques de sortie) située dans la partie gauche de
l'écran, sélectionnez le périphérique créé à l'étape 7.
9.
Une fois le périphérique choisi, sélectionnez l'onglet [Output Channels] (canaux de sortie)
sur le côté droit de l'écran.
10. Configurez le port sur 7781.
11. Sélectionnez l'une des options suivantes :
–
Pour Web Services 7.0, sélectionnez l'une des deux options selon que le type de travail
JDF est Configuration ou Quadrichromie :
a.
Sélectionnez [Intent_1.2_General] pour produire une sortie JDF pour les travaux JDF de
type Configuration.
b.
Sélectionnez [Proc_DigitalPrinting_1.2_General] pour produire une sortie JDF pour les
travaux JDF de type Quadrichromie.
12. Définissez l'adresse IP correspondant à l'ordinateur sur lequel sont installés les services JMF
de FreeFlow et cliquez sur [OK]. Un message s'affiche pour confirmer que les modifications
ont été enregistrées.
2-10
Guide de l'utilisateur
Services JMF FreeFlow
Installation, désinstallation, mise à niveau et configuration
Remarque
Si l'adresse réseau des services JMF FreeFlow prend en charge le format IPv4 et/ou IPv6,
entrez l'adresse IP au format IPv4 lors de la saisie de l'URL. FreeFlow Web Services ne prend
pas en charge les adresses littérales IPv6.
13. Cliquez sur le lien [Device supports multi-queue system] (périphérique prenant en charge
les systèmes à files multiples). Cliquez sur [Available Printers] (imprimantes disponibles)
pour afficher la liste des imprimantes disponibles dans les services JMF FreeFlow.
Sélectionnez un dossier et cliquez sur <OK>. Dans la fenêtre suivante, sélectionnez une
imprimante par défaut et cliquez sur <enregistrer> pour enregistrer la configuration.
Les travaux peuvent maintenant être soumis au périphérique et à la file configurés ci-dessus.
La soumission de travaux à partir de FreeFlow Web Services s'effectue en deux étapes :
1.
Se connecter en tant que Print Buyer (client d'impression) et passer une commande pour le
travail à soumettre aux services JMF de FreeFlow.
2.
Se connecter en tant que Print Provider (fournisseur d'impression) et approuver le travail à
soumettre aux services JMF de FreeFlow.
Reportez-vous à la documentation de FreeFlow Web Services pour des instructions sur ces
opérations.
Ajout et configuration d'imprimantes
Les services JMF ne gèrent pas leur propre liste d'imprimantes de production configurées.
Il convient d'utiliser l'application Enregistrement des imprimantes de FreeFlow pour ajouter et
configurer des imprimantes. Une fois que les imprimantes de production requises ont été
ajoutées, accédez à l'invite de commande et utilisez la commande suivante dans l'interface de
ligne de commande des services JMF de FreeFlow pour enregistrer ces imprimantes dans les
services JMF :
•
Invoquez la commande xomupddev pour récupérer la liste des imprimantes mises à jour à
partir de l'application Enregistrement des imprimantes.
Pour plus d'informations sur l'utilisation de l'application Enregistrement des imprimantes
FreeFlow, consultez l'aide en ligne de cette application.
Guide de l'utilisateur
2-11
Installation, désinstallation, mise à niveau et configuration
Services JMF FreeFlow
Arrêt et redémarrage
Pour arrêter les services JMF de FreeFlow :
•
À l'aide des services Windows, sélectionnez le service intitulé « FreeFlow JMF Service » et
invoquer la commande stop. La fenêtre des services Windows est accessible à partir de
« Démarrer->Tous les programmes->Xerox FreeFlow Software->FreeFlow Services JMF>Services ».
•
Il est également possible d'arrêter les services JMF de FreeFlow en entrant la commande
« xomshutd » dans une fenêtre de ligne de commande. La fenêtre de ligne de commande
est accessible à partir de « Démarrer->Tous les programmes->Xerox FreeFlow Software>FreeFlow Services JMF->Ligne de commande ».
Pour redémarrer les services JMF de FreeFlow :
•
2-12
À l'aide des services Windows, sélectionnez le service intitulé « FreeFlow JMF Service » et
invoquer la commande start. La fenêtre des services Windows est accessible à partir de «
Démarrer->Tous les programmes->Xerox FreeFlow Software->FreeFlow Services JMF>Services ».
Guide de l'utilisateur
Requêtes et
commandes JMF
prises en charge
3
SubmitQueueEntry
Le message SubmitQueueEntry permet de soumettre un travail JDF à une imprimante.
Les services JMF de FreeFlow ne permettent pas de valider le travail JDF par rapport aux
fonctionnalités de l'imprimante. Si ce dernier contient des attributs que l'imprimante ne peut
pas respecter, l'imprimante tentera d'imprimer le travail du mieux possible. Si le travail ne peut
pas être imprimé, il sera abandonné et un signal JMF sera envoyé aux systèmes MIS.
Les types de nœuds suivants sont pris en charge :
•
Impression numérique combinée
•
Intention de produit - décrit l'intention du client pour le produit final. Les services JMF de
FreeFlow gèrent les intentions de produit pouvant être imprimées sur une imprimante
numérique.
L'ID de périphérique requis pour la soumission est identifié dans l'URL des services JMF de
FreeFlow, http://<hôte>:7781/[ID périphérique] ou dans l'ID de périphérique (jmf/@deviceID)
du message JMF. Si les deux sont spécifiés, c'est ce dernier qui est prioritaire. Si l'ID de
périphérique n'est pas valide, si le périphérique n'accepte pas de travaux ou si la connexion au
périphérique ne peut pas être établie, la requête est rejetée et un code d'erreur est renvoyé.
Si la soumission contient un nœud d'intention de produit, les services JMF de FreeFlow le
convertiront en nœud d'impression numérique combinée. Les intentions pré-presse ou postpresse, s'il y en a, sont ignorées.
Seul un fichier PDL est autorisé par travail JDF. Si le bon de travail inclut plusieurs composants,
ils doivent tous référencer le même fichier PDL.
L'instance de fichier JDF peut contenir un fichier référencé. Les références de fichier prises en
charge sont les suivantes :
file://host/path
où « host » est le nom de domaine entier du système sur lequel réside le fichier. Cet élément
peut contenir la chaîne « localhost » ou être vide. « path » est le chemin du répertoire contenant
le fichier référencé.
cid:content-id
Guide de l'utilisateur
3-1
Requêtes et commandes JMF prises en charge
Services JMF FreeFlow
L'élément « content-id » identifie un fichier reçu avec le message MIME multiparties.
http://host:port/path
où « host » est le nom de domaine entier du système sur lequel réside le fichier. Host peut
contenir la chaîne « localhost » ou être vide. Port contient le numéro de port du serveur http.
« Path » est le chemin du répertoire contenant le fichier référencé.
Une fois la soumission acceptée et si le travail ne peut pas être imprimé pour quelque raison
que ce soit, il est abandonné et un signal JMF est envoyé au système MIS.
Canaux permanents
Les services JMF de FreeFlow envoient des signaux d'état au système MIS via un canal
permanent. Le système MIS établit un canal permanent en envoyant un message de requête
d'état avec un élément de souscription. La souscription identifie une URL qui sera enregistrée
pour ce contrôleur. Une fois le canal permanent établi, il reste ouvert (même en cas de
redémarrages système) jusqu'à réception d'un message StopPersistentChannel.
Le message StopPersistentChannel permet d'annuler l'enregistrement d'un contrôleur à
l'écoute d'un canal permanent. Aucun message n'est envoyé au contrôleur une fois que cette
commande a été exécutée.
Signaux d'état
Les services JMF de FreeFlow envoient un signal d'état JMF aux souscripteurs dans les cas
suivants :
•
Travail transmis à l'imprimante
•
Travail sur l'imprimante, mais en attente de ressources (supports, finition)
•
Impression du travail en cours
•
Impression du travail interrompue car en attente de ressources (supports, finition)
•
Perte de la connexion à l'imprimante
•
Travail terminé
•
Travail abandonné
3-2
Guide de l'utilisateur
Services JMF FreeFlow Guide de l'utilisateur
ReturnQueueEntry
La commande ReturnQueueEntry permet de renvoyer un fichier jdf ayant été soumis à l'aide d'une
commande SubmitQueueEntry. Cette commande est envoyée par les services JMF de FreeFlow lorsque le
travail est terminé ou abandonné. Les éléments Audits et JDF/@Status du JDF en cours de traitement
sont définis comme « Terminé » et le JDF est envoyé à l'URL spécifiée par la commande
SubmitQueueEntry/@ReturnJMF.
Les services JMF tenteront d'envoyer une commande ReturnQueueEntry à plusieurs reprises, jusqu'à ce
que la soumission soit correctement reçue par le client. Le client est ainsi provisoirement désactivé avant
la reprise des activités. Les tentatives d'envoi seront effectuées selon des intervalles préconfigurés, le
retour à un fonctionnement normal étant susceptible de prendre quelque temps au client (lors d'un
redémarrage, par exemple). Les délais entre les tentatives et le nombre de tentatives sont configurables.
KnownDevices
La requête KnownDevices permet de demander des informations sur les périphériques. Pour chaque
périphérique, l'état et l'ID du périphérique sont renvoyés.
AbortQueueEntry
Si le travail n'a pas été transmis à l'imprimante, il est annulé et un état de réussite est renvoyé. Si le
travail a déjà été transmis à l'imprimante mais n'a pas encore été imprimé, un état de réussite est
renvoyé et une requête d'annulation est transmise à l'imprimante.
Si la soumission d'origine contient une commande returnJMF (SubmitQueueEntry/@ReturnJMF), le JDF
mis à jour est envoyé à la destination spécifiée.
SuspendQueueEntry
Si le travail n'a pas été transmis à l'imprimante, il est suspendu et un état de réussite est renvoyé. Si le
travail a déjà été transmis à l'imprimante, un code d'erreur est renvoyé.
ResumeQueueEntry
Si le travail n'a pas été transmis à l'imprimante, il est libéré pour l'impression et un état de réussite est
renvoyé. Si le travail a déjà été transmis à l'imprimante, un code d'erreur est renvoyé.
3
Requêtes et commandes JMF prises en charge
Services JMF FreeFlow
Status Query
Il est possible de demander au contrôleur d'envoyer une liste de tous les travaux dans la file,
avec leur état et leurs attributs. Les informations relatives à un travail spécifique peuvent être
renvoyées si QueueEntryID/Job ID est spécifié dans la requête.
Status Queue Query
Il est possible de demander au contrôleur d'envoyer une liste des travaux dans la file, filtrés par
état, avec leur état et leurs attributs. Le filtre est spécifié dans la requête. Si aucun travail ne
présente l'état correspondant au filtre spécifié, la liste des travaux est vide. Si le filtre n'est pas
valide, une liste de tous les travaux, avec leur état et leurs attributs, est renvoyée.
3-4
Guide de l'utilisateur
Commande CLI
prises en charge
4
update-devices
Cette commande permet de fusionner les imprimantes enregistrées dans l'outil Enregistrement
des imprimantes de FreeFlow et les imprimantes utilisées par les services JMF de FreeFlow. Il en
résulte une liste d'imprimantes gérées par les services JMF de FreeFlow basée sur les
imprimantes enregistrées dans l'outil Enregistrement des imprimantes de FreeFlow.
Les imprimantes ayant été ajoutées à l'aide de l'outil Enregistrement des imprimantes de
FreeFlow seront enregistrées dans les services JMF de FreeFlow. Les imprimantes ayant été
supprimées à l'aide de l'outil Enregistrement des imprimantes de FreeFlow seront supprimées
des services JMF de FreeFlow si elles ne comportent aucun travail en cours.
Si une imprimante est supprimée dans l'outil Enregistrement des imprimantes de FreeFlow et si
la commande xomupddev est invoquée alors que des travaux non terminés ont été envoyés à
cette imprimante « supprimée », l'imprimante reste affichée dans les services JMF de FreeFlow
jusqu'à ce que tous les travaux soient terminés.
Nom de commande :
xomupddev
Exemple :
xomupddev
Après la saisie de cette commande, l'utilisateur revient à l'invite de commande.
shutdown-system
Cette commande arrête immédiatement les services JMF de FreeFlow.
Nom de commande :
xomshutd
Exemple :
xomshutd
Après la saisie de cette commande, l'utilisateur revient à l'invite de commande.
Guide de l'utilisateur
4-1
Commande CLI prises en charge
Services JMF FreeFlow
list-devices
Cette commande renvoie une liste des périphériques enregistrés dans le système.
Nom de commande :
xomlisdev
Renvoie :
La liste des imprimantes enregistrées dans le système.
Si aucun nom d'imprimante n'est renvoyé, aucune imprimante n'est enregistrée dans
l'outil Enregistrement des imprimantes ou la commande xomupddev n'a pas été exécutée.
Exemple :
xomlisdev
list-jobs
Cette commande répertorie tous les travaux soumis sur une imprimante spécifique. Le nom de
l'imprimante correspond à une imprimante renvoyée à partir de la commande list-devices.
Nom de commande :
xomlisjob
Opérande :
nom_imprimante : Le nom de l'imprimante sur
laquelle les travaux ont été soumis.
Renvoie :
Liste des travaux affichés sur la console au format :
imprimante1:123,imprimante1:124, … imprimante1:nnn
Exemple :
xomlisjob imprimante1
4-2
Guide de l'utilisateur
Services JMF FreeFlow
Commande CLI prises en charge
get-job-attributes
Cette commande renvoie les attributs d'un travail.
Nom de commande :
xomgetjob
Opérande :
imprimante:ID_travail : Le nom de l'imprimante,
« : » et l'ID du travail
Options :
-a : Renvoie tous les attributs qui existent pour
le travail.
Renvoie :
Liste des attributs du travail au format « nom_imprimante:ID_travail:nom-attribut=valeur »
sur la console.
Le message suivant s'affiche si les conditions suivantes sont réunies :
Le travail ID_travail n'a pas été trouvé dans la
file spécifiée.
si le travail spécifié n'existe pas.
Exemple :
xomgetjob –a imprimante1:123
Affichage de la version du logiciel
Il est possible d'afficher la version de logiciel des services JMF FreeFlow JMF en ajoutant
l'option –v à n'importe quelle commande dans l'interface de ligne de commande.
Exemple : xomlisdev –v
L'information suivante sera affichée : 8.0.0.0_827[23442.20090608]
Guide de l'utilisateur
4-3
Commande CLI prises en charge
4-4
Services JMF FreeFlow
Guide de l'utilisateur
Résolution des
problèmes
5
Cette section décrit les procédures permettant de résoudre les problèmes les plus couramment
rencontrés avec les services JMF de FreeFlow.
Activation de la connexion
Il est possible de configurer le système de manière à ce que ce dernier enregistre les erreurs
dans un journal en fonction du niveau défini par l'utilisateur. Par exemple, si l'attribut système
est défini sur SEVERE, seules les erreurs les plus graves figureront dans le journal. Si l'attribut est
défini sur FINEST, toutes les données, même celles d'ordre informatif, seront enregistrées.
Les attributs de connexion disponibles sont les suivants :
•
SEVERE
•
WARNING
•
INFO
•
CONFIG
•
FINE
•
FINEST
Procédez comme suit pour activer la connexion :
1.
Accédez à un éditeur de texte du système (Bloc-notes, par exemple).
2.
Ouvrez le fichier « Jdfjmfgateway.properties » dans l'éditeur de texte. Le fichier se situe
dans le répertoire suivant : C:\Program Files\Xerox\FreeFlow Print Manager JMF
Service\config.
3.
Recherchez l'entrée « com.xerox.gateways.jdfjmf.level » dans le fichier.
4.
Ajoutez un signe égal et l'attribut de connexion après l'entrée.
(« com.xerox.gateways.jdfjmf.level=FINEST », par exemple).
5.
Recherchez l'entrée « JMFDEBUG » et remplacez « false » par « true ».
6.
Enregistrez et fermez le fichier.
Il est nécessaire de redémarrer les services JMF de FreeFlow pour que les modifications soient
prises en compte.
Les fichiers journaux seront enregistrés aux emplacements suivants :
•
C:\Program Files\Xerox\FreeFlow Print Manager JMF Service\logs
•
C:\Program Files\Xerox\FreeFlow Print Manager JMF Service\temp
Guide de l'utilisateur
5-1
Résolution des problèmes
Services JMF FreeFlow
Connexion d'imprimante
Si les services JMF renvoient un code d'erreur 2, vérifier la connexion de l'imprimante. Entrez la
commande suivante :
xomgetdev –x printer-state <nom de l'imprimante>
Si la commande renvoie la valeur « printer-state=Unknown », le serveur JMF ne peut pas
communiquer avec l'imprimante. Pour résoudre ce problème :
•
Vérifier que les informations relatives à l'imprimante (c'est-à-dire son adresse réseau)
entrées dans l'outil Enregistrement des imprimantes sont correctes.
•
Vérifier que la communication est établie entre les services JMF et l'imprimante (test ping
réseau, par exemple).
•
Vérifier que l'imprimante fonctionne.
5-2
Guide de l'utilisateur
Restrictions :
6
Cette section décrit les restrictions dont les utilisateurs des services JMF FreeFlow doivent tenir
compte.
Création de bons de travail JDF dans
Adobe Acrobat Professional
Pour créer un bon de travail JDF dans Adobe Acrobat Professional en vue d'une soumission vers
FreeFlow Process Manager, il est nécessaire de spécifier le nombre de pages du document, ou
les pages dans le cadre d'une série de pages, pour que le bon de travail puisse être utilisé
correctement.
Pour spécifier le nombre de pages, procédez comme suit :
1.
Sélectionnez Démarrer->Programmes->Adobe Acrobat Professional.
2.
Dans Adobe Acrobat Professional, sélectionnez Options avancées->Impression->Définitions
de travaux JDF.
3.
Sélectionnez <Créer>.
4.
Dans la boîte de dialogue Créer une définition de travail, sélectionnez « 1.2 » dans la zone
de liste déroulante « Version JDF », accédez à la sélection voulue et sélectionnez
<Enregistrer>. Le chemin du fichier s'affiche dans la zone de saisie Nom du fichier.
5.
Sélectionnez <Créer et Modifier>.
6.
Dans la boîte de dialogue Modifier la définition de travail JDF, sélectionnez <Ajouter une
section>.
7.
Entrez la valeur appropriée pour le nombre de pages.
8.
Sélectionnez <OK>.
9.
Sélectionnez <Fermer>.
10. Quittez Adobe Acrobat Professional.
Guide de l'utilisateur
6-1
Restrictions :
Services JMF FreeFlow
Pour spécifier une série de pages, procédez comme suit :
1.
Sélectionnez Démarrer->Programmes->Adobe Acrobat Professional.
2.
Dans Adobe Acrobat Professional, sélectionnez Options avancées->Impression->Définitions
de travaux JDF.
3.
Sélectionnez <Créer>.
4.
Dans la boîte de dialogue Créer une définition de travail, naviguez jusqu'à l'emplacement
souhaité puis sélectionnez <Enregistrer>. Le chemin du fichier s'affiche dans la zone de
saisie Nom du fichier.
5.
Sélectionnez <Créer et Modifier>.
6.
Dans la boîte de dialogue Modifier la définition de travail JDF, sélectionnez <Ajouter une
section>.
7.
Sélectionnez <Ajouter un fichier>.
8.
Dans la section des pages des documents à utiliser, sélectionnez la case d'option
d'<étendue de pages>.
9.
Entrez les valeurs d'étendue de pages souhaitées dans les zones de texte.
10. Sélectionnez <OK>.
11. Sélectionnez <Fermer>.
12. Quittez Adobe Acrobat Professional.
6-2
Guide de l'utilisateur
Informations
complémentaires sur
Web Services
7
L'objectif de ce chapitre est de fournir des informations complémentaires importantes
concernant les services JMF FreeFlow et les signaux d'état JMF pris en charge dans le cadre
d'une utilisation avec FreeFlow Web Services.
Pour de plus amples informations sur l'utilisation des services JMF avec Web Services, reportezvous au FreeFlow Web Services Integration Guide.
FreeFlow Web Services et impression de
production Xerox
FreeFlow Web Services fait partie de la technologie d'impression de production Xerox, qui
permet au fournisseur de services d'impression d'exploiter pleinement, au niveau production, la
programmation des bons de travail et le choix de DFE (Digital Front Ends) FreeFlow pour les
imprimantes de production Xerox. Dans Web Services, il existe plusieurs méthodes pour
communiquer avec les imprimantes de production Xerox ou les autres modules FreeFlow.
Certaines d'entre elles font appel à une nouvelle norme, connue sous le nom de Job Definition
Format (JDF), et au protocole Job Messaging Format (JMF). Toutes les imprimantes de
production Xerox ne prennent pas en charge JDF/JMF de façon native. Il est ainsi possible
d'utiliser un autre module FreeFlow (services JMF FreeFlow, par exemple) pour soumettre le
travail de Web Services à l'imprimante.
Avec JDF/JMF, un périphérique de sortie Web Services est créé afin d'acheminer le travail vers
les services JMF FreeFlow. L'acheminement du travail est généralement traité avec la fixation
des prix d'un modèle ou d'un type de travail.
JDF étant une toute nouvelle norme, tous les attributs de bon de travail Web Services ne sont
pas pris en charge par le chemin JDF à l'heure actuelle. Seuls la sélection des supports papier et
le comptage du nombre de copies sont pris en charge pour le moment. Les services JMF de
FreeFlow ne permettent pas de valider le travail JDF par rapport aux fonctionnalités de
l'imprimante. Si ce dernier contient des attributs que l'imprimante ne peut pas respecter,
l'imprimante tentera d'imprimer le travail du mieux possible. Si le travail ne peut pas être
imprimé, il sera abandonné et un signal d'état JMF sera envoyé à Web Services.
Avec le développement de la technologie, d'autres attributs JDF devraient bientôt être pris en
charge.
Guide de l'utilisateur
7-1
Informations complémentaires sur Web Services
Services JMF FreeFlow
Signaux d'état JMF
Pour des informations sur les icônes d'état des travaux, consultez la documentation
accompagnant FreeFlow Web Services.
7-2
Guide de l'utilisateur