Utilisation des microservices de ressources et des profils de traitement get-started-using-asset-microservices
Les microservices de ressources permettent un traitement évolutif et résilient des ressources à l’aide d’applications natives au cloud (également appelées programmes de travail). Adobe gère les services pour une gestion optimale des différents types de ressources et des options de traitement.
Les microservices de ressources vous permettent de traiter un large éventail de types de fichiers, dans des formats prêts à l’emploi plus nombreux que les versions précédentes d’Experience Manager. Par exemple, l’extraction de miniatures des formats PSD et PSB est désormais possible, mais elle nécessitait auparavant des solutions tierces telles qu’ImageMagick.
Le traitement des ressources dépend de la configuration des profils de traitement. Experience Manager fournit une configuration par défaut de base et permet aux administrateurs d’ajouter une configuration de traitement des ressources plus spécifique. Les administrateurs créent, gèrent et modifient les configurations des workflows de post-traitement, y compris la personnalisation facultative. La personnalisation des workflows permet aux développeurs d’étendre l’offre par défaut.
DAM Update Asset
existant dans les versions précédentes d’Experience Manager. Le traitement des microservices de ressources remplace la plupart des étapes standard de génération de rendu et liées aux métadonnées, et la configuration du workflow de post-traitement peut remplacer les étapes restantes, le cas échéant.Présentation des options de traitement des ressources get-started
Experience Manager autorise les niveaux de traitement suivants.
- Miniatures standard utilisées par l’interface utilisateur d’Assets (48, 140 et 319 pixels)
- Aperçu grand format (rendu web : 1 280 pixels).
- Extraction des métadonnées et du texte
- Rendu FPO (For Placement Only).
- Change le format de fichier et la résolution des images.
- S’applique de manière conditionnelle aux types de fichiers configurés.
Formats de fichiers pris en charge supported-file-formats
Les microservices de ressources prennent en charge un large éventail de formats de fichiers pour traiter et générer des rendus ou extraire des métadonnées. Voir Formats de fichiers pris en charge pour obtenir la liste complète des types MIME et les fonctionnalités prises en charge pour chaque type.
Configuration par défaut default-config
Certains paramètres par défaut sont préconfigurés pour garantir que les rendus par défaut requis dans Experience Manager sont disponibles. La configuration par défaut garantit également que les opérations d’extraction de métadonnées et de texte sont disponibles. Les utilisateurs peuvent commencer à charger ou à mettre à jour immédiatement les ressources, et le traitement de base est disponible par défaut.
Avec la configuration par défaut, seul le profil de traitement le plus élémentaire est configuré. Un tel profil de traitement n’est pas visible dans l’interface utilisateur et vous ne pouvez pas le modifier. Il s’exécute toujours pour traiter les ressources chargées. Ce profil de traitement par défaut permet de s’assurer que l’intégralité du traitement de base requis par Experience Manager est terminé sur toutes les ressources.
Configuration standard standard-config
Experience Manager permet de générer des rendus plus spécifiques pour des formats courants en fonction des besoins de l’utilisateur. Un administrateur peut créer des profils de traitement supplémentaires pour faciliter la création de ce rendu. Les utilisateurs affectent alors un ou plusieurs des profils disponibles à des dossiers spécifiques afin qu’un traitement supplémentaire soit réalisé. Par exemple, le traitement supplémentaire peut générer des rendus pour le web, les appareils mobiles et les tablettes. La vidéo suivante explique comment créer et appliquer des Profils de traitement et comment accéder aux rendus qui ont été créés.
-
Largeur et hauteur du rendu : la spécification de hauteur et de largeur du rendu fournit des tailles maximales de l’image de sortie générée. Les microservices de ressources tentent de générer le rendu le plus grand possible, avec une largeur et une hauteur ne dépassant pas les valeurs spécifiées. Les proportions sont conservées, c’est-à-dire qu’elles sont identiques à l’original. Une valeur vide signifie que le traitement des ressources utilise, par défaut, la taille en pixels de l’original.
-
Règles d’inclusion de type MIME : lors du traitement d’une ressource avec un type MIME spécifique, ce dernier est d’abord comparé à la valeur des types MIME exclus pour la spécification de rendu. En cas de correspondance avec cette liste, ce rendu spécifique n’est pas généré pour la ressource (liste bloquée). Dans le cas contraire, le type MIME est comparé au type MIME inclus et, si une correspondance est trouvée, le rendu est généré (liste autorisée).
-
Rendu FPO spécial : lorsque vous placez des ressources de grande taille d’Experience Manager dans des documents Adobe InDesign, un professionnel de la création attend un certain temps après avoir placé une ressource. Pendant ce temps, l’utilisateur ne peut pas utiliser InDesign. Cela interrompt le flux créatif et a un impact négatif sur l’expérience utilisateur. Adobe permet de placer temporairement dans des documents InDesign des rendus de petite taille, qui peuvent être remplacés ultérieurement par des ressources pleine résolution On-demand. Experience Manager fournit des rendus utilisés uniquement pour le placement. Ces rendus FPO ont une taille de fichier réduite, mais présentent les mêmes proportions.
Le profil de traitement peut inclure un rendu FPO (For Placement Only). Consultez la Adobe Asset Link documentation pour savoir si vous devez l’activer pour votre profil de traitement. Pour plus d’informations, consultez la documentation complète sur Adobe Asset Link.
Création d’un profil standard create-standard-profile
-
Les administrateurs accèdent à Outils > Ressources > Profils de traitement. Cliquez sur Créer.
-
Fournissez un nom qui vous aide à identifier de manière unique le profil lors de l’application à un dossier.
-
Pour générer des rendus FPO, dans l’onglet Image, activez Créer le rendu FPO. Saisissez une valeur Qualité de 1 à 100.
-
Pour générer d’autres rendus, cliquez sur Ajouter nouveau et fournissez les informations suivantes :
- Nom de fichier de chaque rendu.
- Format de fichier (PNG, JPEG, GIF ou WebP) de chaque rendu.
- Largeur et hauteur en pixels de chaque rendu. Si ces valeurs ne sont pas spécifiées, la taille totale en pixels de l’image d’origine est utilisée.
- Qualité en pourcentage de chaque rendu JPEG et WebP.
- Types MIME inclus et exclus pour définir l’applicabilité d’un profil.
-
Cliquez sur Enregistrer.
Profil et cas d’utilisation personnalisés custom-config
Asset Compute Service prend en charge divers cas d’utilisation, notamment le traitement par défaut et le traitement de formats spécifiques à l’Adobe, tels que les fichiers Photoshop. Il permet également d’implémenter un traitement personnalisé ou spécifique à l’organisation. La personnalisation du workflow Ressource de mise à jour de gestion des actifs numériques requise par le passé est gérée automatiquement ou au moyen de la configuration Profils de traitement . Si ces options de traitement ne répondent pas aux besoins de votre entreprise, Adobe recommande de développer et d’utiliser le Asset Compute Service pour étendre les fonctionnalités par défaut. Pour obtenir aperçu, voir Comprendre l’extensibilité et savoir quand l’utiliser.
Le profil personnalisé peut transformer des formats d’image, de vidéo, de document et autres formats de fichier en différents rendus, y compris des miniatures, du texte et des métadonnées extraits et des archives.
Les développeurs peuvent utiliser Asset Compute Service pour créer des applications personnalisées qui répondent aux cas d’utilisation pris en charge. Experience Manager peut appeler ces applications personnalisées à partir de l’interface utilisateur en utilisant des profils personnalisés configurés par les administrateurs. Asset Compute Service prend en charge les cas d’utilisation suivants d’appel de services externes :
- Utilisez l’ API ImageCutout de Adobe Photoshop et enregistrez le résultat sous forme de rendu.
- Appelez des systèmes tiers pour apporter des modifications, par exemple un système PIM.
- Utilisez l’API Photoshop pour générer une variété de rendus basés sur le modèle Photoshop.
- Utilisez l’ API Adobe Lightroom pour optimiser les ressources ingérées et les enregistrer en tant que rendus.
Création d’un profil personnalisé create-custom-profile
-
Les administrateurs accèdent à Outils > Assets > Profils de traitement > Créer.
-
Sur la page Profil de traitement, cliquez sur l’onglet Personnalisé, puis sur Ajouter nouveau.
-
Dans le champ de texte Nom , saisissez le nom de fichier souhaité pour le rendu, puis fournissez les informations suivantes.
- Nom de fichier de chaque rendu et extension de fichier prise en charge.
- URL de point d’entrée d’une application personnalisée App Builder. L’application doit provenir de la même organisation que le compte Experience Manager.
- Paramètres Ajouter un service pour transmettre des informations ou des paramètres supplémentaires à l’application personnalisée.
- Types MIME inclus et exclus pour limiter le traitement à quelques formats de fichiers spécifiques.
-
Près du coin supérieur droit de la page, cliquez sur Enregistrer.
Les applications personnalisées sont des applications Project App Builder découplées. Votre application personnalisée récupère tous les fichiers fournis s’ils sont configurés avec un profil de traitement. L’application doit filtrer les fichiers.
Exemple de profil personnalisé custom-profile-example
Pour illustrer l’utilisation d’un profil personnalisé, considérons un exemple d’utilisation dans lequel il s’agit d’appliquer du texte personnalisé à des images de campagne. Vous pouvez créer un profil de traitement qui exploite l’API Photoshop pour modifier les images.
L’intégration d’Asset Compute Service permet à Experience Manager de transmettre ces paramètres à l’application personnalisée à l’aide du champ Paramètres de service. L’application personnalisée appelle ensuite l’API Photoshop et transmet ces valeurs à l’API. Par exemple, vous pouvez transmettre le nom de la police ainsi que la couleur, l’épaisseur et la taille du texte pour ajouter le texte personnalisé aux images de campagne.
Figure : Utilisez le champ Paramètres de service pour transmettre des informations supplémentaires aux paramètres prédéfinis générés dans l’application personnalisée. Dans cet exemple, lorsque des images de campagne sont chargées, elles sont mises à jour avec le texte Jumanji
dans la police Arial-BoldMT
.
Utilisation de profils de traitement pour traiter des ressources use-profiles
Créez et appliquez d’autres profils de traitement personnalisés à des dossiers spécifiques. Ce workflow permet à l’Experience Manager de traiter les ressources chargées ou mises à jour dans ces dossiers. Le profil de traitement standard intégré par défaut est toujours exécuté, mais il n’est pas visible dans l’interface utilisateur. Si vous ajoutez un profil personnalisé, les deux profils sont utilisés pour traiter les ressources chargées.
Appliquez des profils de traitement aux dossiers en utilisant l’une des méthodes suivantes :
-
Les administrateurs peuvent sélectionner une définition de profil de traitement dans Outils > Assets > Profils de traitement et utiliser l’action Appliquer le profil aux dossiers. Il ouvre un navigateur de contenu qui vous permet d’accéder à des dossiers spécifiques et de les sélectionner, puis de confirmer l’application du profil.
-
Les utilisateurs peuvent sélectionner un dossier dans l’interface utilisateur d’Assets et utiliser l’action Propriétés pour ouvrir l’écran des propriétés du dossier. Dans l’onglet Traitement des ressources, ils peuvent sélectionner le profil de traitement approprié pour ce dossier dans la liste Profil de traitement. Pour enregistrer les modifications, cliquez sur Enregistrer et fermer.
-
Les utilisateurs peuvent sélectionner des dossiers ou des ressources spécifiques dans l’interface utilisateur d’Assets pour appliquer un profil de traitement, puis sélectionner l’option
Une fois qu’un profil de traitement a été appliqué à un dossier, toutes les nouvelles ressources chargées (ou mises à jour) dans ce dossier ou dans l’un de ses sous-dossiers sont traitées à l’aide du profil de traitement supplémentaire configuré. Ce dernier s’ajoute au profil par défaut standard.
Pour vérifier que les ressources sont traitées, prévisualisez les rendus générés dans la vue Rendus dans le rail de gauche. Ouvrez l’aperçu de la ressource et ouvrez le rail de gauche pour accéder à la vue Rendus. Les rendus spécifiques situés dans le profil de traitement, pour lesquels le type de la ressource correspond aux règles d’inclusion du type MIME, doivent être visibles et accessibles.
Figure : Exemple de deux rendus supplémentaires générés par un profil de traitement appliqué au dossier parent.
Workflows de post-traitement post-processing-workflows
Dans le cas où un traitement supplémentaire des ressources est nécessaire et ne peut pas être réalisé à l’aide des profils de traitement, des workflows de post-traitement supplémentaires peuvent être ajoutés à la configuration. Le post-traitement permet d’ajouter un traitement entièrement personnalisé en plus du traitement configurable à l’aide des microservices de ressources.
Une fois le traitement des microservices terminé, Experience Manager exécute automatiquement les workflows de post-traitement ou les workflows de démarrage automatique, s’ils sont configurés. Il n’est pas nécessaire d’ajouter manuellement des lanceurs de workflows pour les déclencher. Voici quelques exemples :
- Étapes du workflow personnalisé de traitement des ressources.
- Intégrations pour ajouter des métadonnées ou des propriétés à des ressources provenant de systèmes externes (par exemple, des informations sur des produits ou des processus).
- Le traitement supplémentaire est effectué par des services externes.
Pour ajouter une configuration de workflow de post-traitement à Experience Manager, procédez comme suit :
- Création d’un ou de plusieurs modèles de workflow. Ces modèles personnalisés sont appelés modèles de workflow de post-traitement dans cette documentation. Il s’agit de modèles de workflow Experience Manager standard.
- Ajoutez les étapes de workflow spécifiques à ces modèles. Passez en revue les étapes du workflow par défaut et ajoutez toutes les étapes par défaut requises au workflow personnalisé. Les étapes sont exécutées sur les ressources en fonction d’une configuration de modèle de workflow. Par exemple, si vous souhaitez que le balisage intelligent soit appliqué automatiquement lors du chargement des ressources, ajoutez l’étape à votre modèle personnalisé de workflow de post-traitement.
- Ajoutez l’étape Processus terminé du workflow Ressource de mise à jour de gestion des actifs numériques à la fin. En ajoutant cette étape, vous êtes certain que Experience Manager sait à quel moment le traitement se termine et la ressource peut être marquée comme traitée ; en d’autres termes, Nouvelle s’affiche sur la ressource.
- Créez une configuration pour le service d’exécution de workflow personnalisé qui vous permet de configurer l’exécution d’un modèle de workflow de post-traitement en fonction d’un chemin d’accès (emplacement du dossier) ou d’une expression régulière.
Pour plus d’informations sur les étapes de workflow standard pouvant être utilisées dans le workflow de post-traitement, voir Étapes du workflow de post-traitement (en anglais) dans la documentation de référence du développeur.
Création de modèles de workflow de post-traitement create-post-processing-workflow-models
Les modèles de workflow de post-traitement sont des modèles de workflow Experience Managerstandard. Créez des modèles différents si un autre traitement doit être exécuté pour différents emplacements de référentiel ou types de ressource.
Les étapes de traitement sont ajoutées si nécessaire. Vous pouvez utiliser à la fois les étapes prises en charge disponibles et les étapes de workflow implémentées sur mesure.
Assurez-vous que la dernière étape de chaque workflow de post-traitement est DAM Update Asset Workflow Completed Process
. La dernière étape garantit que l’Experience Manager reconnaît le moment où le traitement des ressources est terminé.
Configuration de l’exécution du workflow de post-traitement configure-post-processing-workflow-execution
Une fois que les microservices de ressources ont terminé le traitement des ressources chargées, vous pouvez définir un workflow de post-traitement pour traiter les ressources plus efficacement. Pour configurer le post-traitement à l’aide de modèles de workflow, vous pouvez effectuer l’une des opérations suivantes :
Application d’un modèle de workflow à un dossier apply-workflow-model-to-folder
Pour les cas d’utilisation standard de post-traitement, pensez à utiliser la méthode pour appliquer un workflow à un dossier. Pour appliquer un modèle de workflow dans le dossier Propriétés, procédez comme suit :
-
Créer un modèle de processus.
-
Sélectionnez un dossier, cliquez sur Propriétés dans la barre d’outils, puis cliquez sur l’onglet Traitement Assets .
-
Sous Workflow de démarrage automatique, sélectionnez le workflow requis, fournissez le titre du workflow, puis enregistrez les modifications.
Configuration du service d’exécution de processus personnalisé configure-custom-workflow-runner-service
Vous pouvez configurer le service d’exécution de workflow personnalisé pour les configurations avancées qui ne peuvent pas être satisfaites facilement en appliquant un workflow à un dossier. Par exemple, un workflow qui utilise une expression régulière. Le gestionnaire de workflow personnalisé DAM Adobe CQ (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl
) est un service OSGi. Il propose les deux options de configuration suivantes :
- Workflows de post-traitement par chemin d’accès (
postProcWorkflowsByPath
) : plusieurs modèles de workflow peuvent être répertoriés en fonction de différents chemins de référentiel. Chemins et modèles séparés à l’aide d’un deux-points. Les chemins de référentiel simples sont pris en charge. Mappez-les à un modèle de workflow dans le chemin/var
. Par exemple :/content/dam/my-brand:/var/workflow/models/my-workflow
. - Workflows de post-traitement par expression (
postProcWorkflowsByExpression
) : plusieurs modèles de workflows peuvent être répertoriés en fonction de différentes expressions régulières. Expressions et modèles distincts à l’aide d’un deux-points. Pointez l’expression régulière pour qu’elle pointe directement vers le noeud de ressource, et non vers l’un des rendus ou fichiers. Par exemple :/content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow
.
Pour savoir comment déployer une configuration OSGi, voir déploiement vers Experience Manager.
Désactivation de l’exécution du workflow de post-traitement
Lorsque le post-traitement n’est pas nécessaire, créez et utilisez un modèle de workflow « vide » dans la sélection du Processus de démarrage automatique.
Création du modèle de workflow de démarrage automatique désactivé
-
Accédez à Outils > Workflows > Modèles.
-
Cliquez sur Créer > Créer un modèle dans la barre d’actions supérieure.
-
Attribuez un titre et un nom au nouveau modèle de processus, par exemple :
- Titre : désactiver le workflow de démarrage automatique
- Nom : disable-auto-start-workflow
-
Cliquez sur Terminé pour créer le modèle de workflow.
-
Sélectionner et modifier le modèle de processus créé
-
Dans l’éditeur de modèles de workflow, cliquez sur Étape 1 de la définition de modèle et supprimez-la.
-
Dans le panneau latéral, cliquez sur Steps.
-
Faites glisser l’étape Processus de mise à jour de ressource DAM terminé dans la définition de modèle.
-
Cliquez sur Informations sur la page (en regard du bouton bascule Panneau latéral), puis sur Ouvrir les propriétés.
-
Sous l’onglet De base, cliquez sur Processus transitoire.
-
Dans la barre d’actions supérieure, cliquez sur Enregistrer et fermer.
-
Dans la barre d’actions supérieure, cliquez sur Synchroniser.
-
Fermez l’éditeur de modèles de workflow.
Application du modèle de workflow de démarrage automatique désactivé
Suivez les étapes décrites dans la section Application d’un modèle de processus à un dossier et définissez le workflow Désactiver le démarrage automatique comme workflow de démarrage automatique pour les dossiers qui ne nécessitent pas le post-traitement des ressources.
Bonnes pratiques et restrictions best-practices-limitations-tips
- Pour la conception des workflows, prenez en compte vos besoins pour tous les types de rendus. Si vous ne prévoyez pas la nécessité d’un rendu futur, supprimez son étape de création dans le workflow. Il est impossible par la suite de supprimer les rendus en masse. Les rendus superflus peuvent occuper beaucoup d’espace de stockage du fait d’une utilisation prolongée d’Experience Manager. Pour les ressources individuelles, vous pouvez supprimer manuellement les rendus à l’aide de l’interface utilisateur. Pour plusieurs ressources, vous pouvez personnaliser Experience Manager pour supprimer des rendus spécifiques ou supprimer les ressources et les charger à nouveau.
- Actuellement, la prise en charge se limite à la génération de rendus. La génération de nouvelles ressources n’est pas prise en charge.
- Actuellement, la taille de fichier maximale pour l’extraction des métadonnées est d’environ 15 Go. Lors du chargement de ressources très volumineuses, l’opération d’extraction des métadonnées échoue parfois.
Voir également
- Traduire les ressources
- API HTTP Assets
- Formats de fichiers pris en charge par Assets
- Rechercher des ressources
- Ressources connectées
- Rapports de ressources
- Schémas de métadonnées
- Télécharger des ressources
- Gestion des métadonnées
- Facettes de recherche
- Gérer les collections
- Import des métadonnées en bloc
- Publier des ressources sur AEM et Dynamic Media