bbc Launch Pad Juillet 2011 Version 10.0

Transcription

1 bbc Configuration d Adobe Digital Enterprise Platform Document Services - Launch Pad 10.0 Guide de l administrateur et du développeur Launch Pad Juillet 2011 Version 10.0

2 Mentions juridiques Pour plus d informations, voir

3 iii Sommaire A propos de ce document Introduction Déploiement de Launch Pad Activation ou désactivation de composants Ajout de composants Création du fichier SWF Génération du code de Launch Pad Déploiement du composant Test du composant dans Launch Pad

4 1 A propos de ce document Adobe Digital Enterprise Platform Document Services - Launch Pad 10.0 est une application cliente Adobe AIR qui vous permet d accéder aux services du serveur Document Server de votre entreprise à partir de votre ordinateur. Ces services vous sont accessibles à l aide des composants disponibles dans Launch Pad. Ce document est destiné aux administrateurs et aux développeurs chargés de la gestion de l accès à Document Services à l aide des composants Launch Pad. Conventions utilisées dans ce document Nom Valeur par défaut Description [racine de déploiement] Windows : C:\Adobe\adep\ Linux et UNIX : /opt/adobe/adep/ Répertoire d installation utilisé pour tous les modules Document Server. Il contient des sous-répertoires pour Configuration Manager et comprend également les sous-répertoires associés à des produits tiers. [racine de Launch Pad] [racine de déploiement]/sdk/misc/launchpad Dossier dans lequel les fichiers source de Launch Pad sont enregistrés. Informations complémentaires Les ressources indiquées dans le tableau ci-dessous peuvent vous aider à mieux comprendre Adobe Digital Enterprise Platform Document Services. Pour plus d informations sur Launch Pad Document Services Des ressources et documents supplémentaires concernant Document Services Adobe Flash Builder D autres services et produits s intégrant à Document Services Les mises à jour des correctifs, les explications techniques et les informations complémentaires sur cette version du produit Voir Aide Launchpad Document Services Documentation sur Document Services Documentation sur Flash Support technique de Document Services

5 2 Introduction Adobe Digital Enterprise Platform Document Services - Launch Pad 10.0 offre un accès aux services du serveur Document Server de votre entreprise depuis votre ordinateur. Les composants suivants sont inclus avec le SDK et figurent dans Launch Pad à condition que les services correspondants soient activés : Conversion au format PDF Exportation de PDF Création de lot PDF Protection de document par des droits Les administrateurs peuvent également installer et activer des composants supplémentaires pour les utilisateurs finaux reposant sur d autres applications Document Services. Remarque : le service auquel vous souhaitez accéder via un composant doit être installé sur le serveur Document Server. En effet, si le composant n est pas installé, il n apparaît pas dans Launch Pad. Grâce à l association des fonctions Remoting de Flex à l architecture orientée services de Document Server, Launch Pad est capable de s autoconfigurer à chaque redémarrage. Chaque fois que vous démarrez Launch Pad, celui-ci interroge le serveur Document Server afin de pouvoir afficher les modifications apportées aux composants existants ainsi que les nouveaux composants. Les utilisateurs de tout type peuvent tirer parti des avantages de Launch Pad : Les utilisateurs finaux peuvent accéder aux services à la demande, tels que le service Generate PDF du serveur Document Server sans que les performances de leur ordinateur en soient affectées. Les fichiers sont alors créés selon les normes professionnelles, plutôt qu à partir de paramètres sélectionnés. Les administrateurs peuvent fournir des services directement sur l ordinateur de l utilisateur final sans nécessiter de gestion bureautique ou d intervention de l utilisateur final. Les administrateurs déploient leurs éléments Launch Pad, qui apparaissent ensuite sur le bureau. Les développeurs disposent d une plateforme permettant la création de valeurs pour utilisateur final via une interface de programmation avec architecture orientée services.

6 3 Déploiement de Launch Pad Une fois l installation de Document Server terminée, vous pouvez installer et déployer Launch Pad. Les fichiers suivants sont utilisés pour le déploiement de Launch Pad : adobe-launchpad-dsc.jar. Contient le composant Document Server nommé LaunchPadService. adobe-launchpad-assets.lca et adobe-livecycle-launchpad.lca. Fichiers d archive Document Server (LCA) contenant les définitions de processus pour les composants bureautiques. Installation de LaunchPadService : 1 Dans Workbench, naviguez jusqu à la vue Components. 2 Vérifiez si la liste de composants indique que LaunchPadService est en cours d exécution. Si tel est le cas, arrêtez-le et désinstallez-le. 3 Cliquez avec le bouton droit sur la vue Components et installez le fichier adobe-launchpad-dsc.jar du dossier deploy.

7 LAUNCH PAD Déploiement de Launch Pad Configuration d Adobe Digital Enterprise Platform Document Services - Launch Pad Cliquez avec le bouton droit sur LaunchPadService et sélectionnez Start Component. LaunchpadService est maintenant en cours d exécution. LaunchpadService est l application conteneur qui interagit avec l application cliente Adobe AIR. LaunchpadService est chargé d identifier les composants d interface utilisateur disponibles et de les fournir à l application Adobe AIR. Pour importer les fichiers d archives Document Server : 1 Dans Console d administration, cliquez sur Services > Applications et services > Gestion des applications. Importez deux archives : adobe.-launchpad-assets.lca et adobe-livecycle-launchpad.lca. Le fichier d archive d éléments Launch Pad contient les icônes et les modules de l application SWF qui sont téléchargés vers Launch Pad. Le fichier d archive de services Launch Pad contient les processus de Document Server exécutés lorsque Launch Pad appelle le serveur Document Server. 2 Cliquez sur Importer. 3 Sélectionnez adobe-livecycle-launchpad.lca et cliquez ensuite sur Aperçu. Le fichier adobe-livecycle-launchpad.lca déploie les processus responsables de l ensemble des activités de Launch Pad. 4 Pour déployer les éléments au moment de l exécution, sélectionnez Déployer les éléments à l exécution à la fin de l importation.

8 LAUNCH PAD Déploiement de Launch Pad Configuration d Adobe Digital Enterprise Platform Document Services - Launch Pad Pour afficher une liste des éléments contenus dans le fichier, cliquez sur Afficher les éléments. 6 Cliquez sur Importer. Le fichier d archive est alors déployé. 7 Répétez les étapes 4 à 6 en sélectionnant cette fois le fichier adobe-launchpad-assets.lca. Le fichier adobe-launchpad-assets.lca est responsable du déploiement des éléments suivants du client Adobe AIR : Les icônes des composants Le code du fichier SWF exécuté avec l application Adobe AIR qui définit l expérience de l utilisateur La version de l application Adobe AIR utilisée sur l ordinateur de l utilisateur final Le fichier de configuration qui relie tous les éléments Launch Pad peut maintenant être exécuté et les composants sont placés sur l ordinateur client.

9 6 Activation ou désactivation de composants Vous contrôlez vous-même quels composants Document Server sont disponibles dans Launch Pad en modifiant une copie du fichier de configuration de Launch Pad (launchpad-config.xml). Ce fichier de configuration est déployé avec Launch Pad. Vous pouvez placer une copie du fichier de configuration dans la vue Applications de Launch Pad dans Workbench. Afin de pouvoir étendre le nombre de composants Launch Pad déployés sur l ordinateur, ajoutez une nouvelle arborescence aux éléments de l application. L arborescence est :.../ext/config/. Créez cette arborescence et copiez le fichier launchpad-config.xml à l intérieur. Modifiez ensuite la copie du fichier de configuration (voir «Déploiement de Launch Pad», page 3). Remarque : le fichier /ext/config/launchpad-config.xml est prioritaire sur le fichier /launchpad-config.xml. Si un composant se trouve désactivé dans le fichier /ext/config/launchpad-config.xml alors qu il est activé dans le fichier /launchpad-config.xml, il n apparaît alors pas dans Launch Pad. Nous vous recommandons de modifier uniquement le fichier ext/launchpad-config.xml. Pour désactiver un composant : î Modifiez le fichier /ext/config/launchpad-config.xml en remplaçant la valeur true de la balise activée par false. Pour activer un composant : î Modifiez le fichier /ext/config/launchpad-config.xml en remplaçant la valeur false de la balise activée par true.

10 7 Ajout de composants Outre les composants par défaut, vous avez la possibilité de créer et d activer des composants pour d autres services Document Server. Avant de commencer la création d un composant pour Launch Pad, vous devez avoir accès aux éléments suivants : Launch Pad. Inclut la bibliothèque adobe-launchpad-module.swc pour le développement de composants. Adobe Flash Builder 4.0 ou version ultérieure. Inclut les outils pour créer un fichier SWF pour le composant. Workbench. Utilisé pour créer des processus et déployer le composant. Document Server. Fournit la base et les services sous-jacents. Launch Pad doit être connecté à Document Server. Chacun des composants est dépendant de la disponibilité du service Document Server associé. Les étapes suivantes permettent d ajouter un composant : Création du fichier SWF exécuté avec le client Déploiement du composant Test de l accessibilité du composant dans Launch Pad Création du fichier SWF La première étape consiste à créer le fichier SWF. 1 Copiez le fichier de bibliothèque Launch Pad (adobe-launchpad-module.swc) du répertoire [racine d ADEP]/sdk/client-libs/common dans le dossier /library du projet. La bibliothèque contient la classe com.adobe.launchpad.clienthubcomponent. Les composants que vous développez doivent être une sous-classe de la classe com.adobe.launchpad.clienthubcomponent qui possède les propriétés suivantes : serverprotocol servername serverport username password Les composants utilisent ces propriétés de manière à interagir entre eux ou à charger les services sur le serveur Document Server. 2 Copiez les fichiers suivants à partir de [racine de Launch Pad]/pdfg/src/com/adobe/launchpad/ui/common/effect/ vers le projet sous un package : AppearEffect.mxml DisappearEffect.mxml ClarifyEffect.mxml Veillez à modifier la ligne de déclaration du package de ces fichiers en conséquence. 3 Dans le principal fichier MXML du projet, remplacez l élément racine du projet WindowedApplication/Application par Launchpadcomponent. Le code initial du fichier MXML est similaire au code suivant : <ch:launchpadmodule xmlns:mx=" layout="absolute" xmlns:ch="com.adobe.launchpad.*" creationcomplete="initdata(this)" xmlns:effect="com.adobe.launchpad.ui.common.effect.*" xmlns:common="com.adobe.launchpad.ui.common.*" hideeffect=" {disappear}" showeffect="{appear}"/>

11 LAUNCH PAD Ajout de composants Configuration d Adobe Digital Enterprise Platform Document Services - Launch Pad <effect:appeareffect id="appear"/> <effect:disappeareffect id="disappear"/> <effect:clarifyeffect id="clarify"/> Ce code permet l affichage de l effet de glissement vers le nouveau composant lorsqu un composant est affiché ou masqué dans Launch Pad. 4 Mettez à jour ChannelSet dans le nouveau composant afin de communiquer avec le serveur Document Server : remote_object>.channelset = this.lcchannelset as ChannelSet; 5 Compilez le composant à l aide du compilateur Adobe Flash. 6 Utilisez la pour incorporer dans le fichier SWF des images utilisées dans le composant. Le nouveau composant peut maintenant être déployé sur le serveur Document Server. Génération du code de Launch Pad Suivez les étapes suivantes pour générer le code de Launch Pad : 1 Définissez la variable d environnement FLEX_HOME sur le répertoire racine du SDK Flex. 2 Définissez la variable d environnement LiveCycle_ES_SDK sur [racine de déploiement]/sdk. 3 Définissez la variable d environnement ANT_HOME de manière à ce qu elle pointe vers un répertoire racine Ant (1.7 ou version ultérieure). Ajoutez également %ANT_HOME%/bin à la variable PATH système. 4 Téléchargez le fichier ant-contrib.jar à partir de et copiez-le dans le répertoire [ANT_HOME]/lib. 5 Définissez la variable d environnement JAVA_HOME sur le répertoire racine Java. Ajoutez également %JAVA_HOME%/bin à la variable PATH système. 6 Copiez le fichier jdom.jar (jdom-b7.zip) de vers le répertoire [racine de déploiement]/sdk/clientlibs/thirdparty. 7 Extrayez le fichier [racine de Launch Pad] /lc-launchpad-src.zip et suivez les instructions pour mettre en commentaires les lignes de code ou annuler leur mise en commentaires dans l ensemble des fichiers build.xml des répertoires extraits. Conseil : utilisez le mot-clé «comment» pour rechercher des instructions. 8 Mettez à jour la valeur de flex.sdk.dir dans le fichier build.properties de manière à ce qu il pointe vers l emplacement de SDK Flex Exécutez la commande ant à partir du répertoire [racine de Launch Pad] pour générer le code. Déploiement du composant Les applications sont gérées au sein de Workbench via la vue Applications de Workbench. Launch Pad est composé de deux applications : l application système et l application Launch Pad Assets qui contient les éléments et les informations de configuration pour Launch Pad. 1 Pour ouvrir l application Launch Pad Assets à partir de Workbench, cliquez sur File > GetApplications. 2 Ouvrez Launch Pad Assets (system) et sélectionnez ensuite Launch Pad Assets (system)/1.0. L arborescence apparaît dans la vue Applications. 3 Dans Workbench, déployez le fichier SWF vers le dossier de fichiers SWF de l application Assets à partir de la vue Applications. 4 Dans Workbench, ajoutez au dossier Launchpadcomponent/icons l icône (32 X 32 pixels) qui apparaît dans le client. 5 Créez un dossier /ext/config dans le dossier Launchpadcomponent.

12 LAUNCH PAD Ajout de composants Configuration d Adobe Digital Enterprise Platform Document Services - Launch Pad Copiez le fichier launchpad-config.xml vers ce dossier. 7 Modifiez le fichier launchpad-config.xml et créez une balise de composant. La balise de composant prend en charge les balises suivantes : id. Identifie le composant. S il existe plus d un composant présentant le même ID dans le fichier configuration, seule la dernière occurrence est activée dans Launch Pad. name. Nom du composant. Ce texte sert d info-bulle et de titre de l application lors de l activation du composant. component-url. URL du fichier SWF du composant dans le référentiel. description. Brève description du composant. icon-url. URL de l icône du composant (PNG) dans le référentiel. enabled. Spécifie si le composant est activé. Valeur par défaut : true. order. Spécifie l ordre d affichage du composant dans Launch Pad. Les composants sont triés par ordre alphabétique dans Launch Pad. services. Liste séparée par des virgules des services utilisés par le composant. Si un service est spécifié dans cette liste, le composant est envoyé à Launch Pad. Le service doit être installé sur le serveur Document Server. role. Liste séparée par des virgules des rôles requis pour le téléchargement et l exécution du composant. Si un rôle est spécifié, le composant apparaît uniquement si l utilisateur actuel possède ces rôles. Exemple de balise de composant <updates> <enabled>true</enabled> <current-app-version> </current-app-version> <force-update>false</force-update> <app-url>/applications/launchpadassets/1.0/launchpad.air</app-url> </updates> <modules> <module> <id>idofthenewcomponent</id> <name>new component</name> <module-url>/applications/launchpadassets/1.0/swf/newcomponent.swf</component-url> <description>new component</description> <icon-url>/applications/launchpadassets/1.0/icons/newcomponent.png</icon-url> <enabled>true</enabled> <order>1</order> <services>assemblerservice</services> <supported-operating-system>all</supported-operating-system> </module> </modules> Test du composant dans Launch Pad Il vous faut tester l accessibilité du composant dans Launch Pad. 1 Démarrez Launch Pad. Le nouveau composant apparaît dans la liste des composants. 2 Cliquez sur le composant et vérifiez que le service démarre correctement.