DocumentationAEM 6.5Guide de l’utilisateur

Intégration d’Adobe Experience Manager Assets à Adobe InDesign Server integrating-aem-assets-with-indesign-server

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration

Adobe Experience Manager Assets utilise :

  • un proxy pour distribuer la charge de certaines tâches de traitement. Un proxy est une instance Experience Manager qui communique avec un programme de traitement du proxy afin d’accomplir une tâche spécifique, et avec d’autres instances Experience Manager pour diffuser les résultats.
  • Le programme de traitement du proxy définit et gère une tâche spécifique.
    Il peut couvrir une grande variété de tâches ; par exemple l’utilisation d’InDesign Server pour traiter les fichiers.

Pour charger intégralement des fichiers créés avec Adobe InDesign vers Experience Manager Assets, un proxy est utilisé. Cette méthode utilise un programme de traitement du proxy pour communiquer avec Adobe InDesign Server, qui exécute des scripts afin d’extraire des métadonnées et de générer divers rendus pour Experience Manager Assets. Le programme de traitement du proxy permet une communication bidirectionnelle entre InDesign Server et les instances Experience Manager dans une configuration cloud.

NOTE
Adobe InDesign est proposé sous la forme de deux offres distinctes. L’application de bureau Adobe InDesign utilisée pour concevoir des dispositions pour la distribution papier et numérique. Adobe InDesign Server vous permet de créer des documents de façon automatisée, et par programmation, sur la base de vos dispositions créées avec InDesign. Il fonctionne comme un service offrant une interface à son moteur ExtendScript. Les scripts sont écrits dans ExtendScript, qui est similaire à JavaScript. Pour plus d’informations sur les scripts InDesign, rendez-vous à l’adresse https://www.adobe.com/devnet/indesign/documentation.html#idscripting.

Fonctionnement de l’extraction how-the-extraction-works

Adobe InDesign Server peut être intégré à Experience Manager Assets, de telle sorte que les fichiers INDD créés avec InDesign puissent être chargés, que des rendus puissent être générés, et que tous les médias (des vidéos, par exemple) puissent être extraits et stockés sous la forme de ressources :

NOTE
Les versions précédentes d’Experience Manager permettaient seulement d’extraire le XMP et la miniature. Désormais, tous les médias peuvent être extraits.

  1. Chargez votre fichier INDD vers Experience Manager Assets.

  2. Un framework envoie des scripts de commande vers InDesign Server via un protocole SOAP (Simple Object Access Protocol).
    Ce script de commande permet d’effectuer les opérations suivantes :

    • Récupérer le fichier INDD.

    • Exécuter les commandes InDesign Server :

      • La structure, le texte et tous les fichiers multimédias sont extraits.
      • Des rendus PDF et JPG sont générés.
      • Des rendus HTML et IDML sont générés.

    • Republier les fichiers résultants dans Experience Manager Assets.

    note note
    NOTE
    IDML est un format XML qui effectue le rendu de tout le contenu du fichier InDesign. Il est stocké sous la forme d’un package compressé au format ZIP. Pour plus d’informations, consultez les Formats d’échange d’InDesigns INX et IDML.
    note caution
    CAUTION
    Si InDesign Server n’est pas installé ou configuré, vous pouvez tout de même charger un fichier INDD dans Experience Manager. Toutefois, les rendus générés sont limités au format PNG et JPEG. Vous ne pourrez pas générer les rendus HTML, .idml ou de page.

  3. Après l’extraction et la génération du rendu :

    • La structure est identique à cq:Page (type de rendu).
    • Le texte et les fichiers extraits sont stockés dans Experience Manager Assets.
    • Tous les rendus sont stockés dans Experience Manager Assets, dans la ressource même.

Intégration d’ InDesign Server à Experience Manager integrating-the-indesign-server-with-aem

Pour intégrer InDesign Server afin de l’utiliser avec Experience Manager Assets, après la configuration de votre proxy, vous devez :

  1. installer InDesign Server ;
  2. Si nécessaire, configurez le workflow Experience Manager Assets.
    Cette opération n’est nécessaire que si les valeurs par défaut ne sont pas adaptées à votre instance.
  3. Configurer un programme de traitement du proxy pour InDesign Server.

Installation d’InDesign Server installing-the-indesign-server

Pour installer et démarrer InDesign Server afin de l’utiliser avec Experience Manager :

  1. Téléchargez et installez InDesign Server.

  2. Si nécessaire, vous pouvez personnaliser la configuration de votre instance InDesign Server.

  3. À partir de la ligne de commande, démarrez le serveur :

    <*ids-installation-dir*>/InDesignServer.com -port 8080

    Cela démarre le serveur avec le module complémentaire SOAP en écoute sur le port 8080. Tous les messages de journal et les résultats sont écrits directement dans la fenêtre de commande.

    note note
    NOTE
    Si vous souhaitez enregistrer les messages de sortie vers un fichier, puis utiliser une redirection ; par exemple, sous Windows :
    <ids-installation-dir>/InDesignServer.com -port 8080 > ~/temp/INDD-logfile.txt 2>&1

Configurez le workflow Experience Manager Assets. configuring-the-aem-assets-workflow

Experience Manager Assets dispose d’un workflow Ressource de mise à jour de gestion des ressources numériques préconfiguré, qui comprend plusieurs étapes de workflow spécifiques à InDesign :

Ce workflow est configuré avec les valeurs par défaut qui peuvent être adaptées à votre configuration pour diverses instances d’auteur (il s’agit d’un workflow standard, aussi des informations supplémentaires sont disponibles sous Modifier un workflow). Si vous utilisez les valeurs par défaut (port SOAP compris), aucune configuration n’est nécessaire.

Après la configuration, le chargement de fichiers InDesign dans Experience Manager Assets (via les méthodes habituelles) déclenche le workflow pour le traitement de la ressource et la préparation des différents rendus. Testez votre configuration en chargeant un fichier INDD dans Experience Manager Assets afin de confirmer que vous voyez les différents rendus créés par IDS sous <*your_asset*>.indd/Renditions.

Extraction de médias media-extraction

Cette étape commande l’extraction de médias à partir du fichier INDD.

Pour la personnaliser, vous pouvez modifier l’onglet Arguments dans l’étape Extraction de médias.

Arguments d’extraction de médias et chemins de scripts

Arguments d’extraction de médias et chemins de scripts

  • Bibliothèque ExtendScript  : il s’agit d’une simple bibliothèque de méthodes HTTP GET/POST, requise par les autres scripts.

  • Développer les scripts  : vous pouvez indiquer ici différentes combinaisons de script. Si vous souhaitez que vos propres scripts soient exécutés sur InDesign Server, enregistrez-les sous /apps/settings/dam/indesign/scripts.

CAUTION
Ne modifiez pas la bibliothèque ExtendScript. Cette bibliothèque fournit la fonctionnalité HTTP requise pour communiquer avec Sling. Ce paramètre spécifie la bibliothèque à envoyer à InDesign Server pour qu’il l’utilise.

Le script ThumbnailExport.jsx exécuté par l’étape de workflow Extraction des médias génère un rendu miniature au format .jpg. Ce rendu est utilisé par l’étape du workflow Traiter les miniatures afin de générer les rendus statiques requis par Experience Manager.

Vous pouvez configurer l’étape du workflow Traiter les miniatures de manière à générer des rendus statiques de différentes tailles. Assurez-vous de ne pas supprimer les valeurs par défaut car elles sont requises par l’interface utilisateur d’Experience Manager Assets. Enfin, l’étape Supprimer le rendu d’aperçu d’image efface le rendu de miniature JPG, car il n’est plus nécessaire.

Extraction de page page-extraction

Cette opération crée une page Experience Manager à partir des éléments extraits. Un gestionnaire d’extraction est utilisé pour extraire les données d’un rendu (actuellement HTML ou IDML). Ces données sont ensuite utilisées pour créer une page avec PageBuilder.

Pour la personnaliser, vous pouvez modifier l’onglet Arguments dans l’étape Extraction de page.

chlimage_1-96

  • Gestionnaire d’extraction de page  : dans la liste déroulante, sélectionnez le gestionnaire que vous souhaitez utiliser. Un gestionnaire d’extraction fonctionne sur un rendu spécifique, sélectionné par un RenditionPicker associé (voir l’API ExtractionHandler). Dans une installation standard Experience Manager, les éléments suivants sont disponibles :

    • Gestionnaire d’extraction d’exportation IDML : fonctionne sur le rendu IDML généré lors de l’étape MediaExtract.

  • Nom de la page  : indique le nom que vous souhaitez attribuer à la page résultante. Si vous laissez le champ vide, le nom est « page » (ou une variante si « page » existe déjà).

  • Titre de la page  : indique le titre que vous souhaitez attribuer à la page résultante.

  • Racine de la page  : chemin d’accès à la racine de la page résultante. Si vous laissez le champ vide, le nœud contenant les rendus de la ressource sera utilisé.

  • Modèle de page  : modèle à utiliser lors de la génération de la page résultante.

  • Conception de page  : conception de page à utiliser lors de la génération de la page résultante.

Configuration du programme de traitement du proxy pour InDesign Server configuring-the-proxy-worker-for-indesign-server

NOTE
Le programme de travail réside sur l’instance proxy.

  1. Dans la console Outils, développez Configurations Cloud Services dans le volet de gauche. Développez ensuite Configuration de proxy Cloud.

  2. Double-cliquez sur IDS Worker pour ouvrir la configuration.

  3. Cliquez sur Modifier pour ouvrir la boîte de dialogue de configuration et définir les paramètres requis :

    proxy_idsworkerconfig

    • Pool IDS
      Points d’entrée SOAP à utiliser pour communiquer avec InDesign Server. Vous pouvez ajouter, supprimer ou trier les éléments au besoin.

  4. Cliquez sur OK pour enregistrer.

Si InDesign Server et Experience Manager sont exécutés sur des hôtes différents ou si ces deux applications ne fonctionnent pas sur les ports par défaut, configurez l’externaliseur de liens Day CQ afin de définir le nom d’hôte, le port et le chemin d’accès au contenu pour InDesign Server.

  1. Accédez à la console web https://[aem_server]:[port]/system/console/configMgr.

  2. Localisez la configuration Externalisateur de lien Day CQ. Cliquez sur Modifier pour ouvrir.

  3. Les paramètres de l’externaliseur de liens permettent de créer des URL absolues pour le déploiement d’Experience Manager et pour InDesign Server. Utilisez le champ Domaines pour spécifier le nom d’hôte de Adobe InDesign Server. Cliquez sur Enregistrer.

    Dans les URL absolues, utilisez localhost comme nom d’hôte de votre instance locale (d’auteur) et nom d’hôte ou adresse IP de l’instance de publication, comme illustré ci-dessous.

    Paramètre de l’externaliseur de lien

Activation du traitement parallèle des tâches InDesign Server enabling-parallel-job-processing-for-indesign-server

Vous pouvez désormais activer le traitement parallèle des tâches pour IDS. Déterminez le nombre maximal de tâches parallèles (x) et qu’InDesign Server peut traiter :

  • Sur une machine unique à processeur multi-cœurs, le nombre maximum de tâches parallèles (x) qu’InDesign Server peut traiter est égal au nombre de processeurs qui exécutent IDS, moins un.
  • Lorsque vous exécutez IDS sur plusieurs machines, vous devez comptabiliser le nombre total de processeurs disponibles (c’est-à-dire sur toutes les machines), puis soustraire le nombre total de machines.

Pour configurer le nombre de traitements IDS parallèles :

  1. Ouvrez l’onglet Configurations de la console Felix ; par exemple : https://[aem_server]:[port]/system/console/configMgr.

  2. Sélectionnez la file d’attente du traitement d’IDS sous Apache Sling Job Queue Configuration.

  3. Définissez :

    • Type - Parallel
    • Nombre max. de tâches parallèles - <*x*> (conformément au calcul ci-dessus)

  4. Enregistrez ces modifications.

  5. Pour activer la prise en charge multi-session pour Adobe CS6 et les versions ultérieures, cochez la case enable.multisession.name, sous la configuration com.day.cq.dam.ids.impl.IDSJobProcessor.name.

  6. Créez un groupe de programmes de traitement IDS x en ajoutant des points d’entrée SOAP à la configuration du programme de traitement IDS.

    S’il existe plusieurs machines exécutant InDesign Server, ajoutez les points d’entrée SOAP (nombre de processeurs par ordinateur -1) pour chaque ordinateur.

NOTE
Lorsque vous travaillez avec un groupe de programmes de traitement, vous pouvez activer la liste bloquée des programmes de traitement IDS.
Pour ce faire, cochez la case enable.retry.name sous la configuration com.day.cq.dam.ids.impl.IDSJobProcessor.name, ce qui déclenche de nouvelles tentatives pour les tâches IDS.
En outre, sous la configuration com.day.cq.dam.ids.impl.IDSPoolImpl.name, définissez une valeur positive pour le paramètre max.errors.to.blacklist, qui détermine le nombre de tentatives pour une tâche avant qu’un IDS ne soit exclu de la liste des gestionnaires de tâches.
Par défaut, le traitement IDS est revalidé après une durée en minutes configurable (retry.interval.to.whitelist.name). Si le programme de traitement est en ligne, il est retiré de la liste bloquée.

Activation de la prise en charge pour InDesign Server 10.0 ou une version ultérieure enabling-support-for-indesign-server-or-later

Pour InDesign Server 10.0 ou une version ultérieure, suivez les étapes suivantes pour activer la prise en charge multisession.

  1. Ouvrez Configuration Manager à partir de votre instance Experience Manager Assets https://[aem_server]:[port]/system/console/configMgr.
  2. Modifiez la configuration de com.day.cq.dam.ids.impl.IDSJobProcessor.name.
  3. Sélectionnez l’option ids.cc.enable, puis cliquez sur Enregistrer.
NOTE
Pour l’intégration de InDesign Server à Experience Manager Assets, utilisez un processeur multicœur, car la fonction de prise en charge de sessions nécessaire pour l’intégration n’est pas prise en charge sur les systèmes à un seul cœur.

Configuration des informations d’identification Experience Manager configure-aem-credentials

Vous pouvez modifier les informations d’identification administrateur par défaut (nom d’utilisateur et mot de passe) qui permettent d’accéder à InDesign Server depuis votre déploiement Experience Manager sans interrompre l’intégration à InDesign Server.

  1. Accédez à /etc/cloudservices/proxy.html.
  2. Dans la boîte de dialogue, indiquez le nouveau nom d’utilisateur ou d’utilisatrice et le nouveau mot de passe.
  3. Enregistrez les informations d’identification.
Related Articles
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2