ADOBE INDESIGN CS6 INTRODUCTION A ADOBE INDESIGN CS6 SERVER DEVELOPMENT

Transcription

1 ADOBE INDESIGN CS6 INTRODUCTION A ADOBE INDESIGN CS6 SERVER DEVELOPMENT

2 2012 Adobe Systems Incorporated. All rights reserved. Introduction à Adobe InDesign CS6 Server Development S il accompagne un logiciel dont l utilisation est soumise à un contrat d utilisateur final, ce manuel, de même que le logiciel dont il traite, est fourni sous licence et ne peut être utilisé ou copié que conformément aux termes de cette licence. Sauf autorisation spécifiée dans la licence, aucune partie de ce manuel ne peut être reproduite, enregistrée ou transmise sous quelque forme ou par quelque moyen que ce soit, électronique, mécanique ou autre, sans l autorisation écrite préalable d Adobe Systems Incorporated. Nous attirons votre attention sur le fait que les informations contenues dans ce manuel sont protégées par le droit d auteur, même si le manuel n est pas distribué avec un logiciel accompagné d un contrat de licence pour l utilisateur final. Les informations contenues dans ce manuel sont fournies à titre purement indicatif. Elles peuvent être modifiées sans préavis et ne constituent pas un engagement de la part d Adobe Systems Incorporated. Adobe Systems Incorporated décline toute responsabilité vis-à-vis des erreurs ou imprécisions qui pourraient être relevées dans ce manuel. Nous attirons votre attention sur le fait que les illustrations ou images que vous pouvez être amené à utiliser dans vos projets peuvent être protégées par le droit d auteur. Leur exploitation sans autorisation constituerait alors une violation du droit d auteur. Veillez à obtenir toutes les autorisations nécessaires de la part du titulaire du droit d auteur. Les noms de société figurant dans les modèles ne sont utilisés qu à titre d exemple et ne font référence à aucune organisation réelle. Adobe, the Adobe logo, InCopy, and InDesign are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. Mac OS is a trademark of Apple Computer, Incorporated, registered in the United States and other countries. All other trademarks are the property of their respective owners. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software and Documentation are Commercial Items, as that term is defined at 48 C.F.R. 2,101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R. 12,212 or 48 C.F.R. 227,7202, as applicable. Consistent with 48 C.F.R. 12,212 or 48 C.F.R. 227, through 227,7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA , USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, , and The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

3 Sommaire 1 Introduction à Adobe InDesign Server A propos d Adobe InDesign Server Prise en main Terminologie Feuille de route Documentation Création de scripts C COM Service Windows Démon launchd Performances et évolutivité Installation et exécution d InDesign Server Installation d InDesign Server Configuration système requise Exécution du programme d installation Ensemble de fonctions CJC Pare-feu Installation du service Windows InDesign Server (sous Windows uniquement) Installation du kit SDK d InDesign Server Exécution d InDesign Server Arguments de ligne de commande d InDesign Server Lancement d InDesign Server à partir de la ligne de commande Lancement d InDesign Server pour une utilisation avec la technologie SOAP Lancement d InDesign Server pour une utilisation avec la technologie CORBA Lancement à partir d un autre programme ou d un autre script Exécution de plusieurs instances d InDesign Server Fermeture d InDesign Server Configuration du service Windows InDesign Server Configuration d un démon launchd InDesign Server pour Mac OS Communication avec InDesign Server Communication avec InDesign Server basée sur la technologie SOAP Utilisation de sampleclient pour exécuter un script InDesign Server Communication avec InDesign Server par le biais d un module externe Communication avec InDesign Server basée sur la technologie COM (Windows uniquement) Visual Basic C#

4 4 Communication avec InDesign Server basée sur la technologie LBQ Gestion des messages d erreur Accès aux erreurs et messages Redirection des erreurs et messages Forum aux questions Puis-je spécifier un port SOAP et un fichier IOR lors du lancement du serveur? Existe-t-il un index de toutes les classes et méthodes figurant dans le modèle DOM de création de scripts d InDesign Server? Puis-je interagir avec InDesign Server si je n utilise pas SOAP? Comment renvoyer une valeur de mon script à mon application SOAP client? Etapes suivantes Scripts et modules externes d InDesign Server JavaScript SOAP

5 1 Introduction à Adobe InDesign Server Le présent document fournit une vue d ensemble d Adobe InDesign Server. Il explique comment installer et exécuter InDesign Server dans un environnement simple et décrit comment communiquer avec InDesign Server à partir de composants externes. A propos d Adobe InDesign Server Prise en main Terminologie InDesign Server est utilisé par les intégrateurs système et les développeurs tiers pour créer des solutions de publication serveur. InDesign Server peut être considéré comme une version d InDesign sans interface utilisateur. InDesign Server utilise les mêmes bases de code que la version de bureau d InDesign, mais il a été adapté pour être utilisé comme serveur. Ses fonctionnalités incluent la prise en charge de plusieurs instances, la collecte et l enregistrement des erreurs, ainsi que la communication à l aide de la technologie SOAP. A l instar de la version pour ordinateur de bureau, InDesign Server offre un environnement de développement perfectionné. Outre la prise en charge des standards ouverts tels que XML, InDesign Server se caractérise également par sa prise en charge performante des scripts et son évolutivité. En effet, les API fournies dans le kit SDK (Software Developer s Kit) du module externe InDesign et le kit SDK de script d InDesign Server permettent d étendre facilement les fonctionnalités de ce produit. Ces API peuvent être utilisées pour la création de modules externes C++, de scripts JavaScript, de scripts AppleScript et de scripts VBScript. Consultez la documentation intitulée Getting Started with the Adobe InDesign Server SDK (Prise en main du kit SDK d Adobe InDesign Server) pour obtenir plus d informations et savoir par où commencer, ce que contient le répertoire d installation du kit SDK d InDesign Server et comment utiliser les exemples fournis dans le kit. Vous trouverez ci-dessous une définition des termes utilisés dans ce document. Ant : Another Neat Tool, un outil de construction Java. Client : émetteur d une demande de services depuis un serveur situé dans un système informatique distribué. COM : Component Object Model, technologie facilitant l interopérabilité des applications et des composants. IDS : InDesign Server. <IDS> : dossier dans lequel vous avez installé InDesign Server. <IDS SDK> : dossier dans lequel vous avez installé le kit SDK d InDesign Server. Kit SDK d InDesign Server : ensemble de technologies permettant de travailler avec InDesign Server, comme la technologie SOAP. Ce kit SDK comprend toute la documentation relative à InDesign Server. DOM de création de scripts InDesign : Document Object Model, modèle objet de documents pour la création de scripts. Cela fait référence aux objets et à leur hiérarchie dans InDesign, tels qu ils sont accessibles via les scripts. Kit SDK de script d InDesign : API permettant d accéder au DOM de création de scripts InDesign. 5

6 CHAPITRE 1 : Introduction à Adobe InDesign Server Feuille de route 6 Fichier IOR : Interoperable Object Reference, fichier de référence d objet interopérable. Ce fichier est utilisé par CORBA et ses clients pour identifier un objet dans le modèle d objet CORBA. IPv6 : Internet Protocol version 6, le successeur de l IPv4. L IPv6 est pris en charge par InDesign CS4 Server et les versions ultérieures. Mise en file d attente des travaux : mécanisme qui place les travaux envoyés dans une file d attente, les exécute de manière asynchrone et permet de vérifier ultérieurement l état d un travail. Equilibrage des charges : distribution des travaux sur plusieurs instances et serveurs en fonction des disponibilités. <langue> : dans un chemin, langue de version d InDesign Server ; par exemple, français. LBQ : Load Balancing and Queuing, module complémentaire qui permet de mettre les travaux en file d attente et d équilibrer les charges de plusieurs instances d InDesign Server. Serveur : fournisseur de services dans un système informatique distribué. Fenêtre d invite de commande : fenêtre de ligne de commande. Sous Windows, utilisez Invite de commandes (situé dans le dossier Accessoires du menu Démarrer). Sous Mac OS, utilisez l utilitaire Terminal (situé sous /Applications/Utilitaires). <SDK de script> : répertoire dans lequel vous avez installé le kit SDK de script d InDesign. <SDK> : dossier dans lequel vous avez installé le kit SDK du module externe InDesign. SOAP : Simple Object Access Protocol, protocole de communication basé sur le langage XML permettant l échange de messages entre les programmes et les plates-formes. InDesign Server prend en charge plusieurs versions de SOAP : les versions standard 1.1 et 1.2 de SOAP (RPC et doc/lit) ainsi que le format WSDL 1.1. <version> : dans un chemin, numéro de version d InDesign Server ; par exemple, pour CS6, il s agit de la version 8.0. WSDL : Web Service Description Language, ou langage de description de services Web, format reposant sur le langage XML qui permet de décrire comment accéder à un service Web et d indiquer les opérations restant à effectuer. Feuille de route Cette section fournit une vue d ensemble des différentes utilisations et extensions possibles d InDesign Server et indique comment obtenir plus de détails sur les sujets abordés. L autre partie de ce document fournit des informations supplémentaires. Documentation Le kit SDK du module externe InDesign et le kit SDK de script d InDesign renferment des documents et exemples de code, qui vous aideront dans l extension d InDesign Server. Vous pouvez télécharger ces deux kits SDK sur le site Adobe.com. La documentation citée dans ce document est incluse dans les kits SDK. Création de scripts A l instar d InDesign, InDesign Server prend en charge l écriture de scripts JavaScript, AppleScript et VBScript.

7 CHAPITRE 1 : Introduction à Adobe InDesign Server Feuille de route 7 Ecriture d un script Les documents suivants vous guideront lors de l écriture de scripts InDesign Server : Didacticiel de scripts d Adobe InDesign Guide des scripts d Adobe InDesign Guide des scripts d Adobe InDesign Server Vous pouvez également accéder au document intitulé InDesign Object Model Viewer (Afficheur de modèles d objet d InDesign) à partir du menu d aide d Adobe ExtendScript Toolkit. Exécution d un script InDesign Server propose une méthode SOAP, appelée RunScript, qui permet d envoyer un script à InDesign Server. Votre version d InDesign Server comprend un exemple d application SOAP client, appelé SampleClient, que vous pouvez utiliser pour exécuter un script. Voir la section «Utilisation de sampleclient pour exécuter un script InDesign Server», page 20. SampleClient a été écrit à l aide de C++ et son code source est fourni dans le SDK des produits InDesign. Le kit SDK d InDesign Server contient d autres exemples de projets client fondés sur plusieurs langages, dont C#, PHP, VB.NET et Flex. C++ Ecriture d un module externe C++ InDesign Server repose sur le langage C++ et prend en charge les modules externes C++ développés à l aide de l API C++ d InDesign. Pour plus de détails, voir la section «Communication avec InDesign Server par le biais d un module externe», page 23, ainsi que les documents intitulés Adobe InDesign Plug-In Programming Guide (Guide de programmation des modules externes Adobe InDesign) et «InDesign Server Plug-in Techniques» (Techniques de création de modules externes pour InDesign Server) dans Getting Started with Adobe InDesign Plug-In Development (Prise en main du développement de modules externes Adobe InDesign). Accès au module externe à l aide des scripts Pour que votre module externe soit accessible à partir d un script, il doit prendre en charge les scripts. Pour plus de détails, voir le chapitre «Scriptable Plug-in Fundamentals» (Principes fondamentaux du module externe pour scripts) de la documentation intitulée Adobe InDesign Plug-In Programming Guide (Guide de programmation des modules externes Adobe InDesign). COM InDesign Server publie une bibliothèque de types à utiliser pour créer des composants COM qui interagissent avec InDesign Server. Les composants COM peuvent être créés dans plusieurs langages. Pour plus de détails sur l utilisation de Visual Basic et de C#, voir la section «Communication avec InDesign Server basée sur la technologie COM (Windows uniquement)», page 24.

8 CHAPITRE 1 : Introduction à Adobe InDesign Server Feuille de route 8 Service Windows Vous pouvez utiliser un service Windows pour gérer InDesign Server. Pour avoir recours à ce service, commencez par installer InDesignServerService comme décrit à la section «Installation du service Windows InDesign Server (sous Windows uniquement)», page 10. Utilisez ensuite le composant logiciel enfichable Microsoft Management Console d InDesign Server pour configurer InDesignServerService. Démon launchd Utilisez un démon launchd pour gérer InDesign Server sous Mac OS. Pour plus de détails sur la configuration d un démon, voir la section «Configuration d un démon launchd InDesign Server pour Mac OS», page 17. Performances et évolutivité La documentation et les outils relatifs aux performances et à l évolutivité d InDesign Server sont disponibles dans le kit SDK d InDesign Server. Consultez la documentation intitulée Getting Started with the Adobe InDesign Server SDK (Prise en main du kit SDK d Adobe InDesign Server).

9 2 Installation et exécution d InDesign Server Ce chapitre explique comment installer, exécuter et configurer Adobe InDesign Server. Installation d InDesign Server Avant d installer InDesign Server, assurez-vous que votre système est conforme à la configuration requise. Exécutez ensuite le programme d installation obtenu via le système ESD (Electronic Software Download, distribution électronique de logiciels). Une fois l installation terminée, exécutez InDesign Server à partir de la ligne de commande comme décrit à la section «Exécution d InDesign Server», page 10. Veuillez noter que la sérialisation d InDesign Server intervient sur la ligne de commande au premier lancement, à l aide de l argument -serialnumber. Configuration système requise Pour plus de détails sur la configuration système requise pour l exécution d InDesign Server, voir le fichier Lisez-moi de l application. Pour exécuter le service Windows InDesign Server, vous devez disposer de Microsoft.NET Framework version 2.0 ou ultérieure. Exécution du programme d installation Après avoir téléchargé et décompressé le fichier ESD (Electronic Software Download, distribution électronique de logiciels) pour InDesign Server, cliquez deux fois sur l icône du programme d installation pour l exécuter. Suivez les instructions affichées à l écran. Pendant l installation, vous pouvez spécifier le dossier dans lequel installer InDesign Server ou utiliser l emplacement par défaut. Sous Windows, InDesign Server CS6 est disponible en version 64 bits uniquement. Sous Mac, InDesign Server CS6 est disponible en version 32 bits uniquement. Ensemble de fonctions CJC Pour la composition, InDesign Server utilise l ensemble de fonctions activé Romain (anglais) ou Japonais (CJC). Sous Windows, des paramètres de registre permettent de spécifier l ensemble de fonctions. Mac OS inclut, quant à lui, deux applications : l une activant l ensemble de fonctions Romain et l autre activant l ensemble de fonctions CJC. Lors de l installation d InDesign Server sur une version anglaise de Windows, l ensemble de fonctions par défaut est défini sur Romain. Lors de l installation sur une version chinoise de Windows (par exemple), l ensemble de fonctions par défaut est défini sur CJC. Lors de l installation sur une version anglaise de Windows, si vous choisissez le chinois comme langue d installation, l ensemble de fonctions par défaut est défini sur CJC. Vous pouvez changer l ensemble de fonctions par défaut en exécutant regedit et en modifiant les clés suivantes (modifiez le numéro de version, le cas échéant) : Application 64 bits sous Windows 64 bits : HKEY_LOCAL_MACHINE\SOFTWARE\Adobe\InDesign Server\<version> Définissez la clé Feature Set Locale Setting sur 400 pour Romain ou sur 401 pour CJC. Le paramètre est appliqué au lancement d InDesign Server. 9

10 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 10 Pare-feu Vous devez configurer de manière appropriée tout pare-feu existant entre un ordinateur (un serveur) exécutant InDesign Server et les clients du serveur, afin que ces derniers puissent établir une connexion avec le serveur. Pour plus de détails, voir la documentation de votre pare-feu ou contacter votre administrateur réseau. Installation du service Windows InDesign Server (sous Windows uniquement) Le service Windows InDesign Server surveille des instances données d InDesign Server et les relance si elles sont interrompues ou si l ordinateur est redémarré. Il redirige les messages d InDesign Server vers le journal d événements Windows et autorise la visualisation locale ou à distance de ces messages. Ce service autorise également la configuration des instances d InDesign Server avec un nom et un mot de passe utilisateur différents des nom et mot de passe de l utilisateur actuel. Vous pouvez installer ce service Windows à l aide du programme d installation d InDesign Server ou à partir d une ligne de commande. Dans le premier cas, il vous suffit d exécuter le programme d installation d InDesign Server et de sélectionner l option d installation des fichiers du service Windows pour InDesign Server. Dans le second cas, définissez le dossier dans lequel vous avez installé InDesign Server comme répertoire actif, puis exécutez la commande suivante : InDesignServerService /install Pour désinstaller le service Windows InDesign Server à l aide de la ligne de commande, définissez le dossier contenant InDesign Server comme répertoire actif, puis exécutez la commande suivante : InDesignServerService /install /u Le second composant du service Windows InDesign Server est le composant logiciel enfichable Microsoft Management Console. Si vous avez installé le service à l aide du programme d installation d InDesign Server, le composant logiciel enfichable a également été installé. Si vous avez utilisé la ligne de commande pour installer le service, vous devez également installer le composant logiciel enfichable, comme décrit dans cette section. Pour installer le snap-in sur un ordinateur 64 bits, exécutez la commande suivante : regsvr64 InDesignServerMMC64.dll Pour désinstaller le composant logiciel enfichable Microsoft Management Console d InDesign Server, utilisez la même procédure, en ajoutant un argument de ligne de commande supplémentaire : regsvr64 InDesignServerMMC64.dll /u Pour plus de détails sur la configuration du composant logiciel enfichable, voir la section «Configuration du service Windows InDesign Server», page 16. Installation du kit SDK d InDesign Server Le kit SDK d InDesign Server contient des exemples, des scripts, ainsi que la documentation d InDesign Server. Vous pouvez télécharger le kit SDK d InDesign Server depuis le site Adobe.com. Si vous le souhaitez, vous pouvez déplacer le dossier du kit SDK après l avoir configuré. Exécution d InDesign Server Vous pouvez lancer InDesign Server à partir d une ligne de commande ou d un autre programme ou script. Chaque méthode autorise des arguments de ligne de commande qui contrôlent l exécution et la configuration d InDesign Server.

11 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 11 Arguments de ligne de commande d InDesign Server Les arguments de ligne de commande d InDesign Server vous permettent de configurer divers aspects d InDesign Server. La syntaxe de la ligne de commande suit le schéma ci-dessous ; chaque argument est décrit dans le tableau suivant : InDesignServer [arguments] Argument -configuration name Description Facultatif. Cet argument spécifie le nom de configuration de cette instance d InDesign Server. Utilisé par InDesign Server lors de la création du dossier de configuration dans lequel sont stockées les données privées, le cache et les fichiers de configuration, name doit désigner un nom de dossier valide du système actif. Par défaut, le nom de ce dossier est «configuration_noport» ou «configuration_n», n correspondant au numéro de port (si l option -port est spécifiée). Le dossier de configuration est créé aux emplacements suivants : Sous Windows : C:\Documents and Settings\<nom d utilisateur>\application Data\Adobe\InDesign Server\<version>\<langue>\ Sous Windows Vista et Windows Server 2008 : C:\Users\<nom d utilisateur>\appdata\roaming\adobe\ InDesign Server\<version>\<langue>\ Sous Windows avec Service Windows : C:\Documents and Settings\All Users\Application Data\ Adobe\InDesign Server\<version>\<langue>\ Sous Windows Vista et Windows Server 2008 avec Service Windows : C:\ProgramData\Adobe\InDesign Server\<version>\<langue>\ Sous Mac OS : -[no]console /Users/<nom d utilisateur>/library/preferences/adobe InDesign Server/<version>/<langue>/ Facultatif. Sous Windows uniquement. Cet argument crée une nouvelle fenêtre de console (une interface de commande) et redirige stderr et stdout vers cette fenêtre. Si -noconsole est spécifié, stdout et stderr sont acheminés jusqu au terminal (ou la fenêtre) qui a lancé InDesign Server. Cet argument se révèle utile lorsque vous utilisez le débogueur de Microsoft Visual Studio pour déboguer un module externe InDesign Server en cours de développement. En effet, les données écrites dans stderr et stdout sont supprimées par défaut par le débogueur. Cet argument peut également se révéler utile lorsque vous lancez InDesign Server depuis une autre application, comme un serveur d applications. Il n est disponible qu avec InDesignServer.exe et non avec InDesignServer.com. L option par défaut est -noconsole.

12 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 12 Argument -[no]errorlist -help -iorfile filepath -LogToApplicationEventLog -maxerrors number -pluginpath path[,path] -port number -[no]previews -[no]seh Description Facultatif. Cet argument détermine si InDesign Server doit stocker les erreurs de script d appels SOAP dans la mémoire. La liste d erreurs n est pas effacée automatiquement ; si cette liste contient trop d erreurs, les nouvelles erreurs seront perdues. L option par défaut est -noerrorlist. Facultatif. Affiche une courte description de tous les arguments. Cet argument est indispensable si vous utilisez la technologie CORBA, requise par le module complémentaire LBQ d InDesign ; sinon, il est facultatif. Indique à InDesign Server où créer le fichier contenant la référence IOR de l objet Application. La référence IOR de ce fichier permet à un client de créer une référence à l objet Application d InDesign Server. Vous pouvez le considérer comme un cookie que votre code client utilise pour accéder à l objet Application d InDesign Server. Chaque instance du serveur requiert un fichier IOR unique. De nombreux clients accèdent à un serveur donné à l aide du fichier IOR de ce serveur. L affichage du message «[serveur] Writing IOR to...» (Ecriture du fichier IOR en cours sur...) confirme l écriture de la référence IOR dans le fichier spécifié. Facultatif. Sous Windows, cet argument dirige les sorties de la console d InDesign Server vers le journal d événements d applications de Windows. Vous pouvez les visualiser dans l Observateur d événements d applications par défaut accessible depuis le Panneau de configuration de l outil Gestion de l ordinateur. Sous Macintosh, cet argument est conseillé si vous utilisez InDesign Server en tant que démon launchd. Vous pouvez visualiser les sorties dans la console standard de Mac OS. Facultatif. L argument number spécifie le nombre maximum d erreurs de script des appels SOAP qu InDesign Server doit stocker en mémoire. Le nombre par défaut est Cet argument est indispensable si vous utilisez la technologie CORBA, requise par le module complémentaire LBQ d InDesign ; sinon, il est facultatif. Il commande au serveur de charger tous les modules externes dans les dossiers et sous-dossiers correspondants spécifiés. Lorsque vous indiquez le sous-répertoire server/corba installé, le module externe de prise en charge de la technologie Corba d InDesign Server est chargé et activé. path est un chemin relatif basé sur le dossier d installation d InDesign Server (par exemple, l indication «Server/Corba» fait référence au dossier C:\Program Files\Adobe\Adobe InDesign CS6.0 Server\Server\Corba). N utilisez jamais un chemin absolu. L affichage du message «[serveur] ApplicationIOR :...» confirme le bon chargement du module externe de prise en charge de la technologie Corba. Cet argument est indispensable si vous utilisez le protocole SOAP ; sinon, il est facultatif. Il s agit du numéro de port du socket utilisé par InDesign Server pour traiter les requêtes SOAP envoyées par les applications clientes. S il n est pas spécifié, le système ne peut utiliser aucun port et ne peut donc traiter aucune requête SOAP. Chaque instance d InDesign Server exécutée sur un même système doit disposer d un port unique pour activer la technologie SOAP. Le numéro de port doit être une valeur entière positive. Facultatif. Cet argument précise si une prévisualisation est nécessaire ou non lors de l importation d images. L option par défaut est -nopreviews. Facultatif. Sous Windows uniquement. Cet argument spécifie l utilisation ou non d un SEH (structured exception handling). L option par défaut est -seh.

13 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 13 Argument -[no]sendcrashlogs -serialnumber number Description Sous Mac OS uniquement. Cet argument envoie automatiquement des journaux d incidents à Adobe. L option par défaut est -nosendcrashlogs. Cet argument entre le numéro de série de l application. Il ne doit être utilisé qu une seule fois pour déverrouiller l application. Lancement d InDesign Server à partir de la ligne de commande 1. Ouvrez une nouvelle fenêtre d invite de commande sur le système sur lequel InDesign Server est installé. Sous Windows, utilisez Invite de commandes ; sous Mac OS, utilisez l utilitaire Terminal. 2. Définissez le dossier dans lequel InDesign Server est installé comme répertoire actif. Sous Windows, le dossier contient l application InDesignServer.com. Sous Mac OS, le dossier contient le package d applications InDesignServer.app. Par exemple : Sous Windows 64 bits : cd "C:\Program Files\Adobe\Adobe InDesign CS6 Server x64\" Sous Mac OS : cd '/Applications/Adobe InDesign CS6 Server/' 3. Exécutez la commande ci-dessous. (Sous Windows, InDesignServer.com est exécuté par défaut. L application configure les chemins et exécute InDesignServer.exe.) InDesignServer 4. InDesign Server affiche les messages de lancement dans la fenêtre d invite de commande. Une fois InDesign Server prêt à être utilisé, le message «[serveur] Server Running» (Serveur en cours d exécution) s affiche à l écran. Pendant l exécution, les messages, de même que les erreurs, sont affichés dans la fenêtre d invite de commande. Cette fenêtre peut donc servir au suivi d InDesign Server. Lancement d InDesign Server pour une utilisation avec la technologie SOAP Si votre flux de travail implique l utilisation de scripts pour pouvoir fonctionner en interaction avec InDesign Server, ce flux envoie très vraisemblablement des scripts à InDesign Server par l intermédiaire de la technologie SOAP. Pour communiquer avec InDesign Server par l intermédiaire de cette technologie, vous devez utiliser l argument -port au lancement d InDesign Server. Dans l exemple de ligne de commande suivant, le numéro de port «12345» peut être remplacé par celui de votre choix. InDesignServer -port Au lancement, InDesign Server doit afficher le message suivant : "[soap] Servicing SOAP requests on port " Il indique qu InDesign Server est prêt à accepter les requêtes SOAP. Lancement d InDesign Server pour une utilisation avec la technologie CORBA Si votre flux de travail implique l utilisation du module LBQ pour pouvoir fonctionner en interaction avec InDesign Server, vous devez lancer InDesign Server pour une utilisation avec la technologie CORBA. Le module complémentaire LBQ d InDesign Server fait appel au module externe de prise en charge de la technologie CORBA pour toute communication avec InDesign Server. L utilisation d un fichier texte, dans lequel une chaîne représente une référence IOR d identification unique d un objet dans CORBA, facilite la communication entre l API et InDesign Server.

14 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 14 Une fois l instance d InDesign Server initialisée, la référence IOR est écrite pour l objet Application associé dans le fichier texte spécifié. En utilisant la référence IOR contenue dans le fichier IOR, un client peut instancier un objet de proxy pour l objet Application d InDesign Server. Pour lancer InDesign Server en vue d une utilisation avec la technologie CORBA, ajoutez les arguments -iorfile et -pluginpath à la ligne de commande. Le chemin spécifié par -pluginpath dépend du chemin de l application InDesign Server. Au lancement, InDesign Server crée le fichier texte spécifié et écrit la référence IOR pour l objet Application associé dans le fichier. Vous devez pour cela disposer d un droit d accès en écriture au chemin de fichier. Dans l exemple de ligne de commande suivant, remplacez c:\ior.txt (Windows) ou ~/ior.txt (Mac OS) par le chemin de fichier de votre choix. Sous Windows : InDesignServer -iorfile c:\ior.txt -pluginpath Server\Corba Sous Mac OS : InDesignServer -iorfile ~/ior.txt -pluginpath Server/Corba Au lancement, InDesign Server doit afficher les messages suivants : "[server] ApplicationIOR:..." "[server] Writing IOR to..." Ils indiquent qu InDesign Server est prêt à accepter les commandes CORBA et que vous pouvez accéder à la référence IOR de l objet Application d InDesign Server à partir du fichier spécifié. Lancement à partir d un autre programme ou d un autre script Vous pouvez lancer InDesign Server en tant que processus à partir d un autre programme ou d un autre script. Sous Windows, InDesign Server est généralement exécuté à l aide de l application InDesignServer.com et non d InDesignServer.exe. La version avec l extension.com diffère de la version avec l extension.exe en ce sens qu elle configure les chemins requis vers le dossier omniorb indispensable à l implémentation CORBA d InDesign Server. La version avec l extension.exe ne configure pas ces chemins. Vous risquez donc de devoir ajouter le dossier omniorb à la variable d environnement PATH pour pouvoir lancer cette application. Exécution de plusieurs instances d InDesign Server Si votre site traite un volume important de requêtes InDesign Server, vous pouvez augmenter votre débit en exécutant plusieurs instances d InDesign Server sur un même système. En règle générale, le nombre maximum d instances d InDesign Server exécutable sur un même ordinateur correspond au nombre de cœurs de processeur de l ordinateur plus un. Pour plus de détails, voir la documentation intitulée «InDesign Server Scalability and Performance» (Evolutivité et performances d Adobe InDesign Server) dans Adobe InDesign Server Solutions (Solutions Adobe InDesign Server). Pour exécuter plusieurs instances, vous devez attribuer à chacune un nom de configuration unique. Pour ce faire, utilisez l argument -configuration et indiquez un nom unique pour chaque instance. Lorsque vous exécutez InDesign Server à partir d une ligne de commande, vous devez utiliser une fenêtre distincte pour chaque instance. 1. A partir d une fenêtre d invite de commande, lancez la première instance en exécutant la commande suivante : InDesignServer -configuration myids1 2. Ouvrez une nouvelle fenêtre d invite de commande et exécutez la commande suivante pour la seconde instance : InDesignServer -configuration myids2

15 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 15 Exécution de plusieurs instances pour une utilisation avec la technologie SOAP Si plusieurs de vos applications communiquent avec InDesign Server grâce à la technologie SOAP, vous devez affecter à chaque instance d InDesign Server un numéro de port différent. Dans les exemples ci-dessous, il n est pas nécessaire de spécifier l argument -configuration. En effet, InDesign Server crée un nom de configuration à partir du port spécifié (comme décrit à la section «Arguments de ligne de commande d InDesign Server», page 11). Dans les exemples suivants, les noms de configuration «configuration_18383» et «configuration_18555» sont créés. Vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -port Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -port Vous pouvez choisir d attribuer ou non à chaque instance un nom de configuration unique. Cependant, l utilisation de SOAP requiert absolument un numéro de port unique. Par exemple : InDesignServer -configuration myids3 -port Exécution de plusieurs instances pour une utilisation avec la technologie CORBA Si vous utilisez le module complémentaire LBQ d InDesign Server, vous devez attribuer à chaque instance d InDesign Server un fichier texte IOR et un nom de configuration distincts. Dans les exemples suivants, des fichiers texte IOR et des noms de configuration uniques sont créés pour chaque instance. Sous Windows, vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids1 -iorfile c:\ids\ior_1.txt -pluginpath Server/Corba Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids2 -iorfile c:\ids\ior_2.txt -pluginpath Server/Corba Sous Mac OS, vous pouvez exécuter la première instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids1 -iorfile /IDS/ior_1.txt -pluginpath Server/Corba Vous pouvez ensuite exécuter une seconde instance à l aide de la ligne de commande suivante : InDesignServer -configuration myids2 -iorfile /IDS/ior_2.txt -pluginpath Server/Corba Fermeture d InDesign Server Il existe plusieurs façons de quitter InDesign Server : Appuyez sur Ctrl+C dans la fenêtre Invite de commandes (utilitaire Terminal sous Mac OS) où InDesign Server a été lancé.

16 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 16 Envoyez un script à InDesign Server lui commandant de s arrêter à l aide de l événement de fermeture de l application. Par exemple, le script JavaScript suivant commande à InDesign Server de s arrêter sans enregistrer les documents ouverts : app.quit(saveoptions.no); Si l instance d InDesign Server a été lancée à partir du service Windows InDesign Server, vous pouvez interrompre le service et mettre ainsi fin à toutes les instances d InDesign Server lancées par le service. Configuration du service Windows InDesign Server Pour lancer, arrêter et configurer le service Windows InDesign Server, sélectionnez la catégorie Services de la console de gestion standard de Microsoft. Pour lancer cette console, cliquez avec le bouton droit de la souris sur Poste de travail > Gérer ou cliquez sur le menu Démarrer et sélectionnez Outils d administration > Gestion de l ordinateur. Dans la fenêtre de gestion de l ordinateur, sélectionnez Services et applications, puis Services. Dans la liste de services, cliquez deux fois sur InDesignServerService ou InDesignServerService x64. La boîte de dialogue Propriétés s affiche alors à l écran. Elle vous permet de lancer, d arrêter ou d interrompre momentanément le service, de modifier l ouverture de session ou le mode de démarrage du service. Dans l onglet Connexion, Microsoft recommande l utilisation du paramètre le moins privilégié permettant au service d accomplir ses tâches. Dans ce cas, ces tâches incluent la lecture et l écriture dans le dossier Documents and Settings ainsi qu à l emplacement des documents utilisés par le serveur, l ouverture d un port et la lecture des paramètres de registre. L option Compte système local est plus privilégiée que LocalService ; vous devez donc d abord essayer de définir l option Ce compte sur LocalService (par exemple, NT AUTHORITY\LocalService). Dans l onglet Récupération, il est conseillé de laisser les paramètres définis sur Ne rien faire. Le service est ainsi relancé en cas de défaillance. Si le service fonctionne correctement, les instances d InDesign Server associées à des ports/configurations spécifiés ont déjà été lancées. En cas de défaillance du service, et si les instances d InDesign Server continuent de fonctionner, la nouvelle instance du service n en sera pas informée et tentera de lancer de nouvelles instances d InDesign Server ; le lancement échouera, les ports/configurations étant déjà utilisés. Ces paramètres n affectent pas le traitement des instances d InDesign Server par le service en cas de défaillance ; cette tâche est configurée par l intermédiaire des paramètres de registre MaximumFailureCount, MaximumFailureIntervalInMinutes et TrackFailures dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS55ServerWinService. Des entrées pour ces trois paramètres de registre sont créées pour chaque nouvelle instance que vous ajoutez au service. Le programme d installation n ajoute aucune instance automatiquement. Lorsque vous ajoutez une instance au service, vous voyez ces entrées de registre. Composant logiciel enfichable Management Console d InDesign Server Le second composant du service Windows est le composant logiciel enfichable Management Console d InDesign Server Pour ajouter le composant à une console de gestion, cliquez deux fois sur le ficher InDesignServerService.msc de votre installation InDesign Server. Vous pouvez également l ajouter manuellement en exécutant l application Windows mmc.exe et en sélectionnant Fichier > Ajouter/Supprimer un composant logiciel enfichable. Une liste de tous les composants logiciels enfichables MMC disponibles s affiche alors. Si ce n est pas le cas, cliquez sur Ajouter. Sélectionnez InDesignServerService dans la liste pour l ajouter à la console active. Fermez la boîte de dialogue Ajouter/Supprimer un composant logiciel enfichable. Pour ajouter une instance InDesign Server à la console, cliquez avec le bouton droit de la souris sur InDesignServerService dans le volet gauche de la console et sélectionnez Nouveau > Nouvelle instance InDesign Server. La nouvelle instance hérite des paramètres d échec de la dernière instance. Un numéro de port lui est attribué, correspondant au numéro de port le plus élevé des instances InDesignServerService existantes plus un. La ligne de commande par défaut est vide. Pour modifier la configuration d une instance (numéro de port ou ligne de commande), cliquez deux fois sur l instance dans le volet droit. La ligne de commande doit suivre le schéma indiqué à la section «Lancement d InDesign Server à partir de la ligne de commande», page 13, à l exception de l argument -port qui est défini par l entrée de port et qui ne doit donc pas être utilisé.

17 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 17 Pour que plusieurs instances d InDesign Server puissent coexister sur un même ordinateur, chacune doit être associée à un port ou à un nom de configuration unique ; vous devez pour cela modifier les paramètres du service relatifs au port et à la ligne de commande. Bien que d ordinaire seuls le port et les paramètres de ligne de commande aient besoin d être modifiés, d autres paramètres peuvent être modifiés à partir des paramètres de registre de l instance du service. Ces paramètres sont les suivants : MaximumFailureCount : nombre de tentatives de redémarrage d une instance en cas d échec. MaximumFailureIntervalInMinutes : temps alloué à MaximumFailureCount, en minutes. InDesign Server doit échouer plus de MaximumFailureCount fois en MaximumFailureIntervalInMinutes pour que le service interrompe les tentatives de redémarrage. TrackFailures : il s agit d une valeur booléenne. Si cette valeur est égale à 1 (valeur par défaut), le service tente de relancer InDesign Server ; si elle est égale à 0, le service ne fait rien. Pour modifier les paramètres, exécutez regedit et passez en revue les clés dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InDesignCS55ServerWinService. Un ensemble de clés (par exemple, 065c361a-0cbe-4917-bf b ) doit être associé à chaque instance configurée à l aide d InDesignServerService.msc ou du composant logiciel enfichable Console Management. Configuration d un démon launchd InDesign Server pour Mac OS InDesign Server peut être lancé en tâche de fond (démon) sous Mac OS, sans devoir être contrôlé directement par l utilisateur final. L exécution d InDesign Server en tant que démon vous permet de configurer le lancement de l application au démarrage du système d exploitation et de définir des options de redémarrage en cas de défaillance. Pour configurer le démon, créez un fichier de configuration de liste de propriétés (plist) contenant les paramètres souhaités et installez-le dans le dossier LaunchAgents ou LaunchDaemons, selon votre choix. Fichier de configuration launchd Pour créer un fichier de configuration launchd, saisissez le contenu XML dans un éditeur de texte, comme spécifié ci-dessous. Enregistrez le fichier en utilisant le nom du démon comme nom de fichier et.plist comme extension (par exemple, com.adobe.ids.launchd plist). Vous pouvez également modifier un fichier plist dans l utilitaire XCode Property List Editor, situé sous Développeur/Applications/Utilitaires. Le tableau suivant présente les paramètres requis pour un démon launchd InDesign Server. Pour obtenir la liste complète des options launchd, voir la page du manuel sur launchd. Option Label OnDemand Description Identifiant unique de votre démon (par exemple, com.adobe.ids.launchd.12345). Ce paramètre doit être défini sur false pour qu InDesign Server redémarre après une fermeture ou une défaillance.

18 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 18 Option ProgramArguments RunAtLoad Description Série de chaînes représentant les arguments utilisés au lancement de l application. Le chemin complet vers l application constitue le premier élément de la série. Les arguments utilisés au lancement d InDesign Server à partir de la ligne de commande constituent le reste des éléments. Pour recevoir les sorties de la console à partir d InDesign Server, vous devez utiliser l argument -LogToApplicationEventLog. Ce paramètre est défini sur true. InDesign Server est lancé une fois le démon chargé, au démarrage du système ou manuellement à l aide de launchctl. L exemple suivant représente le contenu XML d un fichier de configuration plist qui exécute InDesign Server avec le port SOAP : <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" " <plist version="1.0"> <dict> <key>label</key> <string>com.adobe.ids.launchd.12345</string> <key>ondemand</key> <false/> <key>programarguments</key> <array> <string>/applications/adobe InDesign CS5.5 Server/InDesignServer</string> <string>-port</string> <string>12345</string> <string>-logtoapplicationeventlog</string> </array> <key>runatload</key> <true/> </dict> </plist> Installation du fichier de configuration Pour installer un fichier de configuration launchd, il vous suffit de le copier dans le dossier approprié de l ordinateur où InDesign Server sera exécuté. Vous pouvez disposer de plusieurs fichiers de configuration de démon, un pour chaque instance d InDesign Server à exécuter. Pour une installation type d InDesign Server, exécutez Mac OS X Server sans comptes utilisateur. Dans ce cas, copiez le fichier de configuration à l emplacement suivant : /Library/LauchDaemons Pour exécuter InDesign Server à l aide d un compte utilisateur, copiez le fichier plist dans le dossier LaunchAgents, lui même placé dans le dossier système ou utilisateur Bibliothèque (vous devrez peut-être créer le dossier utilisateur LaunchAgents) : /Library/LaunchAgents /Users/<nom d utilisateur>/library/launchagents

19 CHAPITRE 2 : Installation et exécution d InDesign Server Exécution d InDesign Server 19 Chargement du démon Une fois le fichier plist copié dans le dossier de lancement, redémarrez le système pour qu il charge le démon automatiquement. Une fois le démon chargé, InDesign Server est lancé à l aide des paramètres spécifiés dans le fichier plist. Pour confirmer le chargement du démon, utilisez la commande suivante dans la fenêtre de l utilitaire Terminal : launchctl list Si l identifiant apparaît, cela signifie que le démon a été chargé correctement. Pour confirmer qu InDesign Server est en cours d exécution, vous pouvez utiliser le Moniteur d activité, qui affiche tous les processus actifs. Vous pouvez charger manuellement le démon à l aide de la commande launchctl : launchctl load /Library/LaunchDaemons/com.adobe.ids.launchd plist Déchargement du démon Vous pouvez décharger le démon manuellement à l aide de launchctl ; cette action n entraîne cependant pas la fermeture de l instance d InDesign Server : launchctl unload /Library/LaunchDaemons/com.adobe.ids.launchd plist Pour quitter l instance d InDesign Server, envoyez à InDesign Server un script lui commandant de s arrêter ou utilisez le Moniteur d activité pour fermer le processus.

20 3 Communication avec InDesign Server Ce chapitre décrit les différentes façons de communiquer avec InDesign Server : «Communication avec InDesign Server basée sur la technologie SOAP», page 20 «Communication avec InDesign Server par le biais d un module externe», page 23 «Communication avec InDesign Server basée sur la technologie COM (Windows uniquement)», page 24 «Communication avec InDesign Server basée sur la technologie LBQ», page 25 Ce chapitre explique également les éléments suivants : «Gestion des messages d erreur», page 26 «Forum aux questions», page 27 Communication avec InDesign Server basée sur la technologie SOAP InDesign Server prend en charge RunScript, une commande SOAP qui vous permet d exécuter un script InDesign Server. Vous pouvez écrire votre script en JavaScript, en VBScript (Windows uniquement) ou en AppleScript (Mac OS uniquement). Lorsque vous appelez la commande RunScript, celle-ci transfère votre fichier de script dans InDesign Server, qui exécute ensuite le script de manière interne. La commande RunScript est définie par le WSDL d InDesign Server. Vous pouvez l utiliser avec des outils SOAP standard pour générer automatiquement des paquets de messages. Il existe deux façons d afficher le WSDL : Ouvrez le fichier IDSP.wsdl dans le kit SDK d InDesign Server. Accédez au WSDL en utilisant le protocole HTTP après avoir lancé InDesign Server à l aide de l argument -port (par exemple, Pour plus de détails sur l écriture d une application SOAP client fonctionnant en interaction avec InDesign Server, voir la documentation intitulée «Working with Adobe InDesign Server SOAP» (Utilisation de la technologie SOAP d Adobe InDesign Server) dans Adobe InDesign Server Solutions (Solutions Adobe InDesign Server) ou l un des exemples sampleclient du kit SDK. Utilisation de sampleclient pour exécuter un script InDesign Server InDesign Server comprend un exemple d application SOAP client, sampleclient. Il s agit d une application de ligne de commande qui envoie un script à InDesign Server par l intermédiaire de RunScript, la commande SOAP d InDesign Server. Le script peut être écrit dans les langages JavaScript, AppleScript ou VBScript. Pour SampleClient, l extension AppleScript est.applescript et l extension VBScript,.vbs. Toute autre extension est associée à JavaScript. Le kit SDK des produits InDesign contient les composants nécessaires à l élaboration de sampleclient : Le code source se trouve dans <IDS SDK>/samples/sampleclient-cplusplus-soap/. 20