[AEM_Assets]{class="badge positive" title="S’applique à AEM Assets)."}

Utilisation des microservices de ressources et des profils de traitement get-started-using-asset-microservices

Les microservices de ressources fournissent un traitement des ressources évolutif et résilient par le biais d’applications natives dans le cloud, également appelées workers, qui dimensionnent indépendamment les unités de traitement qui s’exécutent dans le cloud pour gérer les ressources à la demande. Parce que ces programmes de travail évoluent de manière élastique, la capacité de traitement augmente automatiquement lors d’une ingestion de gros volumes et se contracte en cas d’inactivité, ce qui améliore à la fois le débit et la fiabilité par rapport au traitement à capacité fixe.

Adobe gère directement ces services, assurant ainsi une gestion optimale des différents types de ressources et des différentes options de traitement. Cette approche gérée signifie que les administrateurs n’ont pas besoin de configurer, d’ajuster ou de gérer l’infrastructure de traitement sous-jacente, ce qui permet aux équipes de se concentrer sur la configuration des ressources plutôt que sur les frais généraux opérationnels.

Types et formats de fichiers pris en charge

Les microservices de ressources traitent un large éventail de types de fichiers, couvrant davantage de formats prêts à l’emploi que les versions précédentes d’Experience Manager. Cette prise en charge native étendue supprime la dépendance aux outils externes pour de nombreux workflows courants.

Par exemple, l’extraction miniatures des formats PSD (Photoshop Document) et PSB (Photoshop Big) est désormais prise en charge de manière native. Dans les versions précédentes, cela nécessitait des solutions tierces telles que ImageMagick. La gestion de ces formats directement dans la plateforme simplifie les pipelines, réduit la complexité de l’intégration et élimine la charge de maintenance des dépendances externes.

Configuration des profils de traitement

Le traitement des ressources est régi par la configuration définie dans la section Profils de traitement. Experience Manager est fourni avec une configuration par défaut de base et permet aux administrateurs d’ajouter une configuration de traitement des ressources plus spécifique en fonction de leurs besoins.

Vue de haut niveau du traitement des ressources

Les administrateurs sont chargés des tâches de configuration suivantes :

  • Créer de nouvelles configurations de workflow de post-traitement pour des besoins de traitement des ressources spécifiques.
  • Maintenir les configurations existantes pour que le comportement du traitement reste aligné sur les normes organisationnelles.
  • Modification configurations, y compris la personnalisation facultative des workflows de post-traitement.

Les développeurs peuvent étendre l’offre par défaut en personnalisant ces workflows. Comme le workflow de post-traitement est configurable, les développeurs ajoutent des étapes de traitement en plus des fonctionnalités standard, en adaptant le pipeline aux cas d’utilisation spécialisés.

Relation avec le workflow Ressource de mise à jour de la gestion des ressources numériques hérité

NOTE
Le traitement des ressources décrit ici remplace le modèle de workflow 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. La configuration du workflow de post-traitement peut remplacer les étapes restantes, le cas échéant, de sorte que le pipeline de traitement complet soit géré via le nouveau modèle.

Présentation des options de traitement des ressources get-started

Experience Manager (AEM) prend en charge trois niveaux progressifs de traitement des ressources : Configuration par défaut, Configuration personnalisée et Profil personnalisé. Ces options forment un modèle d’escalade à plusieurs niveaux, qui commence par des valeurs par défaut prêtes à l’emploi, s’étend aux personnalisations définies par l’administrateur et aboutit à un traitement entièrement programmable, natif dans le cloud, pour des besoins avancés. Le choix du niveau approprié dépend du niveau de contrôle dont votre entreprise a besoin sur les formats de rendu, les résolutions et la gestion des types de fichiers.

Option
Description
Cas d’utilisation couverts
Configuration par défaut
Cette configuration est prête à l’emploi et ne peut pas être modifiée. Il fournit une génération de rendu essentielle et prête à l’emploi, ce qui le rend adapté aux workflows de ressources standard sans configuration de l’administrateur.
  • Miniatures standard utilisées par l’interface utilisateur Assets (48 ​, 140 ​​et 319 pixels)
  • Aperçu grand format (rendu web — 1 280 pixels)
  • Extraction de métadonnées et de texte.
Configuration personnalisée
Configuré par les administrateurs via l’interface utilisateur. Il étend l’option par défaut pour fournir des commandes de génération de rendu supplémentaires, en activant différents formats et rendus au-delà des paramètres par défaut prêts à l’emploi.
  • Rendu FPO (pour placement uniquement)
  • Modifier le format et la résolution des images.
  • Appliquez de manière conditionnelle le traitement aux types de fichiers configurés.
Profil personnalisé
Configuré par les administrateurs via l’interface utilisateur pour exécuter du code personnalisé par le biais d’applications personnalisées qui appellent le service 🔗, le service Adobe traitant les ressources par programmation. Cela permet de prendre en charge des exigences plus complexes dans une méthode évolutive et native cloud, car le traitement s’exécute sur une infrastructure cloud gérée qui s’adapte à la demande plutôt que sur des ressources locales fixes.
Voir les Cas d’utilisation autorisés

Formats de fichiers pris en charge supported-file-formats

Les microservices de ressources prennent en charge un large éventail de formats de fichiers image, document, vidéo et audio. Dans ces formats pris en charge, les microservices de ressources offrent trois fonctionnalités principales :

  • Traiter les fichiers — Ingérez et transformez les ressources afin qu’elles soient prêtes à être utilisées en aval dans le workflow de gestion des ressources numériques.
  • Générer des rendus — Produisez d’autres versions d’une ressource, telles que des miniatures redimensionnées, des aperçus ou des copies converties au format. Les rendus garantissent qu’une seule ressource source peut être diffusée dans la taille, la résolution ou le format requis par chaque canal.
  • Extraire les métadonnées — Lisez les métadonnées techniques et incorporées (par exemple, les dimensions, le profil de couleurs ou les détails de création) directement à partir de chaque fichier. Les ressources peuvent ainsi être recherchées, découvertes et cataloguées de manière cohérente.

Les fonctionnalités spécifiques disponibles dépendent du type de fichier. Chaque format pris en charge est identifié par son type MIME (Multipurpose Internet Mail Extensions), l’identifiant normalisé qui indique au système comment un fichier doit être interprété et quelles opérations de traitement lui sont appliquées.

Pour obtenir la liste complète des types MIME pris en charge et des fonctionnalités disponibles pour chaque type, consultez Formats de fichiers pris en charge.

Configuration par défaut default-config

Experience Manager est fourni avec des valeurs par défaut préconfigurées qui rendent immédiatement disponibles les rendus par défaut requis par la plateforme. Les rendus sont les autres versions d’une ressource (telles que les aperçus, les miniatures et les dérivés optimisés pour le web) que Experience Manager générez à partir d’un chargement d’origine. La configuration par défaut garantit également que les opérations principales s’exécutent automatiquement, de sorte que :

  • Extraction des métadonnées capture les informations descriptives intégrées à chaque ressource chargée.
  • Extraction de texte extrait le contenu textuel lisible des types de fichiers pris en charge.
  • Les rendus par défaut sont générés afin que les ressources soient prêtes à être utilisées dans l’ensemble des Experience Manager.

Par conséquent, les utilisateurs peuvent commencer à charger ou à mettre à jour les ressources immédiatement. Le traitement de base est disponible par défaut sans configuration supplémentaire.

Le profil de traitement par défaut

Avec la configuration par défaut, Experience Manager applique uniquement le profil de traitement de base. Un profil de traitement définit l’ensemble des opérations (rendus, gestion des métadonnées et extraction de texte) qu’Experience Manager effectue sur les ressources ingérées. Ce profil de traitement par défaut n’est pas visible dans l’interface utilisateur et vous ne pouvez pas le modifier.

Ce profil de traitement par défaut s’exécute toujours pour traiter les ressources chargées, en veillant à ce que le traitement de base requis par Experience Manager soit effectué sur chaque ressource. Étant donné qu’elle s’exécute sans condition, aucune ressource n’entre dans le système sans recevoir les rendus et opérations d’extraction essentiels Experience Manager dépendent pour la recherche, la prévisualisation et la diffusion.

Configuration standard standard-config

Experience Manager permet de générer des rendus plus spécifiques pour les formats courants en fonction des besoins de l’utilisateur. Un administrateur ou une administratrice 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, ce qui garantit que chaque ressource est diffusée à une taille optimisée pour son appareil et son canal cibles. Regardez cette vidéo pour comprendre comment créer et appliquer des profils de traitement et comment accéder aux rendus créés.

  • Largeur et hauteur du rendu : la spécification de largeur et de hauteur du rendu définit les tailles maximales de l’image de sortie générée. Les microservices de ressources produisent le rendu le plus grand possible dont la largeur et la hauteur ne dépassent pas les valeurs spécifiées, respectivement. Les proportions sont conservées afin qu’elles restent identiques à celles de l’original, ce qui garantit que le rendu généré n’est pas déformé ou étiré par rapport à la ressource source. 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 : le type MIME (Multipurpose Internet Mail Extensions) détermine si un rendu est généré pour une ressource donnée. Lorsqu’une ressource avec un type MIME spécifique est traitée, le type MIME est d’abord vérifié par rapport à 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 (pour placement uniquement) : lors du placement de ressources volumineuses à partir de Experience Manager dans des documents Adobe InDesign, un professionnel de la création attend un temps considérable après avoir placé une ressource. Pendant ce temps, le professionnel de la création ne peut pas utiliser InDesign. Par conséquent, cela interrompt le flux créatif et a un impact négatif sur l’expérience utilisateur. Pour résoudre ce problème, Adobe permet de placer temporairement des rendus de petite taille dans des documents InDesign pour commencer, ce qui permet aux professionnels de la création de reprendre immédiatement le travail. Ces espaces réservés peuvent être remplacés ultérieurement par des ressources en pleine résolution, à la demande. Experience Manager fournit des rendus utilisés uniquement pour l’emplacement. Ces rendus FPO (For Placement Only) ont une petite taille de fichier, mais conservent les mêmes proportions que l’original, de sorte que les mises en page créées à partir de ces rendus restent précises lorsque des ressources en pleine résolution sont permutées.

Le profil de traitement peut inclure un rendu FPO (pour placement uniquement). Voir 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 d’Adobe Asset Link.

Création d’un profil standard create-standard-profile

  1. Les administrateurs accèdent à Outils > Ressources > Profils de traitement. Cliquez sur Créer.

  2. Attribuez un nom explicite qui permet aux administrateurs d’identifier de manière unique le profil lors de son application à un dossier, car c’est le nom du profil qui détermine la manière dont le profil est sélectionné lors de l’affectation du dossier.

  3. Pour générer des rendus FPO (pour l’emplacement uniquement) (versions d’espace réservé basse résolution d’une image utilisée pour la disposition, les aperçus et la référence avant que les ressources haute résolution finales ne soient disponibles), ouvrez l’onglet Image et activez Créer le rendu FPO. Saisissez une valeur Qualité comprise entre 1 et 100, où une valeur plus élevée produit un rendu FPO de qualité supérieure.

  4. Pour générer des rendus supplémentaires (des versions alternatives de l’image d’origine dérivées à des tailles, des formats ou des niveaux de qualité différents), cliquez sur Ajouter nouveau et fournissez les informations suivantes :

    • Nom de fichier de chaque rendu, utilisé pour identifier la sortie générée.
    • Format de fichier de chaque rendu, sélectionné parmi PNG, JPEG, GIF ou WebP.
    • Largeur et hauteur en pixels de chaque rendu. Si les valeurs de largeur et de hauteur ne sont pas spécifiées, la taille en pixels complète de l’image d’origine est utilisée, ce qui garantit que le rendu conserve les dimensions natives de l’image source.
    • Qualité en pourcentage de chaque rendu JPEG et WebP, contrôle le niveau de compression et la taille de fichier résultante pour ces formats.
    • Les types MIME inclus et exclus (Multipurpose Internet Mail Extensions) qui définissent l’applicabilité d’un profil en spécifiant les types de ressources auxquels les règles de rendu s’appliquent et ceux qui sont omis.

    processing-profiles-adding

  5. Cliquez sur Enregistrer pour stocker le profil et le rendre disponible pour l’affectation à des dossiers.

Profil et cas d’utilisation personnalisés custom-config

Le Asset Compute Service prend en charge un large éventail de cas d’utilisation, y compris le traitement par défaut et le traitement de formats spécifiques à Adobe tels que les fichiers Photoshop. Le service permet également de mettre en œuvre un traitement personnalisé ou spécifique à une organisation, adapté aux besoins uniques. La personnalisation qui nécessitait auparavant le workflow Ressource de mise à jour de la gestion des ressources numériques (DAM) est désormais gérée automatiquement ou via la configuration Profils de traitement. Lorsque ces options de traitement ne répondent pas aux besoins spécifiques de l’entreprise, Adobe recommande de développer et de déployer le Asset Compute Service afin d’étendre les fonctionnalités par défaut. Pour obtenir aperçu, voir Comprendre l’extensibilité et savoir quand l’utiliser.

NOTE
Adobe recommande de n’utiliser une application personnalisée que si les besoins de l’entreprise ne peuvent pas être satisfaits à l’aide des configurations par défaut ou du profil standard.

Le Asset Compute Service transforme des images, des vidéos, des documents et d’autres formats de fichiers en plusieurs rendus, y compris miniatures, texte et métadonnées extraits, et archives. Cela permet aux entreprises de générer automatiquement les ressources dérivées dont elles ont besoin pour les workflows de diffusion, de recherche et en aval.

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 appelle ces applications personnalisées directement à partir de l’interface utilisateur à l’aide des profils personnalisés configurés par l’administration. Par conséquent, le traitement personnalisé devient disponible pour les utilisateurs finaux sans intervention manuelle. Le Asset Compute Service prend en charge les cas d’utilisation suivants pour appeler des services externes :

  • Utilisez l’API ImageCutout de Adobe Photoshop pour supprimer les arrière-plans ou isoler des objets, et enregistrez le résultat en tant que rendu pour réutilisation.
  • Appelez des systèmes tiers pour apporter des modifications, par exemple un système Product Information Management (PIM) afin que le traitement des ressources reste synchronisé avec les données métier externes.
  • Utilisez l’API pour générer divers rendus en fonction d’un modèle de Photoshop, ce qui permet d’obtenir une sortie cohérente et alignée sur la marque à grande échelle.​Photoshop
  • Utilisez l’API 🔗 pour optimiser les ressources ingérées et les enregistrer en tant que rendus, améliorant ainsi automatiquement la qualité visuelle lors de l’ingestion.
NOTE
Vous ne pouvez pas modifier les métadonnées standard à l’aide des applications personnalisées. Vous ne pouvez que modifier des métadonnées personnalisées.

Création d’un profil personnalisé create-custom-profile

Un profil de traitement personnalisé dans Adobe Experience Manager permet aux administrateurs d’acheminer les ressources vers une application App Builder découplée qui génère un ou plusieurs rendus personnalisés. Pour en créer un, procédez comme suit :

  1. Les administrateurs accèdent à Outils > Assets > Profils de traitement > Créer.

  2. Sur la page Profil de traitement , cliquez sur l’onglet Personnalisé, puis sur Ajouter.

  3. Dans le champ de texte Nom , saisissez le nom de fichier souhaité du rendu, puis fournissez les informations suivantes.

  4. Près du coin supérieur droit de la page, cliquez sur Enregistrer.

Les applications personnalisées sont des applications découplées Project App Builder, ce qui signifie qu’elles s’exécutent sans interface utilisateur et automatiquement dans le cadre du pipeline de traitement des ressources. Une application personnalisée reçoit tous les fichiers qui lui sont fournis lorsqu’elle est associée à un profil de traitement. L’application doit filtrer les fichiers, car elle traite chaque ressource qui lui est transmise ; le filtrage garantit que seuls les formats de fichiers appropriés sont transformés et que les entrées non prises en charge ou indésirables sont ignorées.

CAUTION
L’application App Builder et le compte Experience Manager doivent appartenir à la même organisation. S’ils appartiennent à des organisations différentes, l’intégration échoue et le traitement personnalisé ne s’exécute pas. Cette correspondance d’organisation est requise pour que la connexion au point d’entrée soit autorisée.

Exemple de profil personnalisé custom-profile-example

Un profil de traitement personnalisé applique du texte personnalisé aux images de la campagne à l’aide de l’API Photoshopd’Adobe afin de modifier automatiquement ces images. Cet exemple illustre un cas d’utilisation courant : ajout de superpositions de texte de marque ou spécifiques à une campagne aux ressources lors de leur ingestion dans des Experience Manager.

Comment le profil personnalisé transmet les paramètres à l’API Photoshop

L’intégration Asset Compute Service permet aux Experience Manager de transmettre ces paramètres à l’application personnalisée par le biais du champ Paramètres de service. L’application personnalisée appelle ensuite l’API Photoshopet transmet valeurs à l’API . Ainsi, la logique d’imagerie s’exécute de manière cohérente à chaque fois qu’une ressource est traitée, plutôt que d’avoir à la modifier manuellement.

Grâce au champ Paramètres de service, vous pouvez transmettre les paramètres suivants pour ajouter du texte personnalisé aux images de campagne :

  • Nom de la police : indique la police appliquée au texte superposé.
  • Couleur du texte : définit la couleur du texte appliqué.
  • Épaisseur du texte — Définit l’épaisseur du texte.
  • Taille du texte — Détermine les dimensions du texte rendu.

custom-processing-profile

Image : utilisez le champ Paramètres de service pour transmettre des informations supplémentaires aux paramètres prédéfinis intégrés à l’application personnalisée. Dans cet exemple, comme le profil est appliqué lors de l’ingestion, le chargement d’une image de campagne déclenche automatiquement la mise à jour et les images sont rendues avec Jumanji texte dans la police Arial-BoldMT.

Utilisation de profils de traitement pour traiter des ressources use-profiles

Créez et appliquez des profils de traitement personnalisés supplémentaires à des dossiers spécifiques. Ce workflow Experience Manager permet 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é, Experience Manager utilise les deux profils pour traiter les ressources chargées. Cela permet de s’assurer que le traitement par défaut standard est toujours appliqué lorsque vos rendus personnalisés sont ajoutés.

Méthodes d’application de profils de traitement à des dossiers

Appliquez des profils de traitement aux dossiers à l’aide de l’une des trois 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 Assets et exécuter l’action Propriétés pour ouvrir l’écran des propriétés du dossier. Dans l’onglet Traitement des ressources, l’utilisateur peut 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.

    Application d’un profil de traitement à un dossier à partir de l’onglet Propriétés de l’élément

  • Les utilisateurs peuvent sélectionner des dossiers ou des ressources spécifiques dans Assets’interface utilisateur pour appliquer un profil de traitement, puis sélectionner l’option icône de retraitement des ressources Retraiter Assets dans les options disponibles dans la partie supérieure.

TIP
Un seul profil de traitement peut être appliqué à un dossier. Pour générer davantage de rendus, ajoutez d’autres définitions de rendu au profil de traitement existant.

Une fois qu’un profil de traitement est appliqué à un dossier, toutes les nouvelles ressources chargées (ou mises à jour) dans ce dossier ou dans l’un de ses sous-dossiers sont automatiquement traitées à l’aide du profil de traitement configuré supplémentaire. Par conséquent, le traitement au niveau du dossier se propage à l’ensemble de l’arborescence de dossiers. Ce dernier s’ajoute au profil par défaut standard.

NOTE
Un profil de traitement appliqué à un dossier fonctionne pour l’ensemble de l’arborescence, mais peut être remplacé par un autre qui est appliqué à un sous-dossier. Lorsque des ressources sont chargées dans un dossier, Experience Manager vérifie les propriétés du dossier conteneur pour un profil de traitement. Si aucun dossier parent n’est appliqué, un dossier parent dans la hiérarchie est vérifié pour appliquer un profil de traitement.

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 dans le profil de traitement, pour lesquels le type de la ressource spécifique correspond aux règles d’inclusion de type MIME, sont visibles et accessibles.

rendus supplémentaires

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

Workflows de post-traitement ajoutez un traitement des ressources entièrement personnalisé en plus du traitement configurable effectué par les microservices de ressources. Utilisez-les chaque fois qu’un traitement supplémentaire des ressources, impossible est nécessaire à l’aide des profils de traitement uniquement. En ajoutant ces workflows à la configuration, les administrateurs étendent la Experience Manager au-delà de ses fonctionnalités de traitement standard pour répondre à des besoins spécifiques.

Une fois le traitement des microservices terminé, Experience Manager automatiquement exécute des workflows de post-traitement ou workflows Auto-start, s’ils sont configurés. Étant donné que Experience Manager déclenche automatiquement ces workflows à la fin du traitement des microservices, il n’est pas nécessaire d’ajouter manuellement les lanceurs de workflow. Voici quelques exemples courants :

  • Étapes de workflow personnalisées pour traiter les ressources.
  • intégrations qui ajoutent des métadonnées ou des propriétés aux ressources à partir de systèmes externes, par exemple des informations sur les produits ou les processus.
  • Traitement supplémentaire effectué par des services externes.

Pour ajouter une configuration de workflow de post-traitement à Experience Manager, procédez comme suit :

  1. Créez un ou 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 réguliers.
  2. Ajoutez les étapes de workflow requises à 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é. Experience Manager exécute ces étapes sur les ressources en fonction de la configuration du modèle de workflow. Par exemple, pour que le balisage intelligent se produise automatiquement au chargement des ressources, ajoutez l’étape de balisage intelligent à votre modèle de workflow de post-traitement personnalisé.
  3. Ajoutez l’étape Processus de mise à jour des ressources de gestion des ressources numériques terminé à la fin. Cette étape est essentielle : elle indique à l’Experience Manager quand se termine le traitement afin que la ressource puisse être marquée comme traitée, c’est-à-dire que Nouveau s’affiche sur la ressource. Sans cette étape finale, Experience Manager ne pouvez pas déterminer de manière fiable que le traitement est terminé.
  4. Créez une configuration pour le service d’exécution de workflow personnalisé. Cette configuration permet aux administrateurs de définir l’exécution d’un modèle de workflow de post-traitement par un chemin d’accès (emplacement du dossier) ou par 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 dans Adobe Experience Manager create-post-processing-workflow-models

Les modèles de workflow de post-traitement sont des modèles de workflow standard Adobe Experience Manager (AEM) utilisés pour traiter les ressources numériques dans le référentiel Gestion des ressources numériques (DAM). Créez des modèles distincts lorsqu’un traitement différent est requis pour des emplacements de référentiel ou des types de ressources distincts, car la personnalisation d’un modèle pour chaque scénario garantit que les ressources sont gérées en fonction de leurs besoins spécifiques.

Création du workflow : assemblez chaque workflow de post-traitement à partir des étapes de traitement qui correspondent à vos besoins. Vous pouvez combiner les éléments suivants :

  • Étapes prises en charge (prêtes à l’emploi) fournies avec Experience Manager
  • Étapes de workflow personnalisées conçues pour répondre à des besoins de traitement spécifiques

Exigence clé — l’étape finale : la dernière étape de chaque workflow de post-traitement doit être DAM Update Asset Workflow Completed Process. Cette étape signale la fin de la Experience Manager. Par conséquent, Experience Manager reconnaît quand le traitement des ressources s’est terminé et peut faire passer la ressource hors de son état en cours. En omettant cette dernière étape, la plateforme ne peut pas détecter que le traitement est terminé, ce qui peut laisser les ressources bloquées dans un statut de workflow non résolu.

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 appliquer des transformations supplémentaires, un enrichissement ou des opérations personnalisées aux ressources. Pour configurer le post-traitement à l’aide de modèles de workflow, utilisez l’une des méthodes suivantes :

Application d’un modèle de workflow à un dossier apply-workflow-model-to-folder

Pour les cas d’utilisation standard de post-traitement, appliquez un workflow directement à un dossier. Il s’agit de l’approche la plus simple et la plus courante. Pour appliquer un modèle de workflow dans le dossier Propriétés, procédez comme suit :

  1. Créer un modèle de processus.

  2. Sélectionnez un dossier, cliquez sur Propriétés dans la barre d’outils, puis cliquez sur l’onglet Traitement Assets.

  3. Sous Workflow de démarrage automatique, sélectionnez le workflow requis, fournissez le titre du workflow, puis enregistrez les modifications.

    Application d’un workflow de post-traitement à un dossier dans ses propriétés

Configuration du service d’exécution de workflow personnalisé configure-custom-workflow-runner-service

Configurez le service d’exécution de workflow personnalisé pour les configurations avancées qui ne peuvent pas être réalisées facilement en appliquant un workflow à un dossier. Par exemple, un workflow qui utilise une expression régulière pour cibler de manière sélective des chemins d’accès à des ressources spécifiques. Ce service est utile car il vous permet de mapper différents modèles de workflow à différents emplacements de référentiel ou modèles de dénomination, ce que la configuration au niveau du dossier ne peut pas réaliser à elle seule. Le gestionnaire de workflow personnalisé (com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl) de gestion des ressources numériques (DAM) Adobe CQ est un service OSGi (Open Service Gateway Initiative). 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 d’accès /var. Par exemple : /content/dam/my-brand:/var/workflow/models/my-workflow.
  • Workflows de post-traitement par expression (postProcWorkflowsByExpression) : plusieurs modèles de workflow peuvent être répertoriés en fonction de différentes expressions régulières. Séparez les expressions et les modèles par deux points. Pointez directement l’expression régulière sur le nœud de ressource, et non sur 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, désactivez l’exécution en créant et en appliquant un modèle de workflow « vide » dans la sélection Workflow de démarrage automatique. Cela évite tout traitement inutile du workflow sur les dossiers qui n’en ont pas besoin.

Création du modèle de workflow de démarrage automatique désactivé
  1. Accédez à Outils > Workflows > Modèles.

  2. Cliquez sur Créer > Créer un modèle dans la barre d’actions supérieure.

  3. 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
  4. Cliquez sur Terminé pour créer le modèle de workflow.

  5. Sélectionnez et modifiez le modèle de workflow créé.

  6. Dans l’éditeur de modèles de workflow, cliquez sur Étape 1 dans la définition de modèle et supprimez-la.

  7. Dans le panneau latéral, cliquez sur Étapes.

  8. Faites glisser l’étape Workflow de mise à jour de ressource de gestion des ressources numériques terminé dans la définition du modèle.

  9. Cliquez sur Informations sur la page (en regard du bouton bascule Panneau latéral), puis sur Ouvrir les propriétés.

  10. Sous l’onglet De base , cliquez sur Workflow transitoire. Un workflow transitoire ne conserve pas son historique d’exécution dans le référentiel, ce qui réduit la surcharge et améliore les performances de traitement.

  11. Dans la barre d’actions supérieure, cliquez sur Enregistrer et fermer.

  12. Dans la barre d’actions supérieure, cliquez sur Synchroniser.

  13. Fermez l’éditeur de modèle de workflow.

Application du modèle de workflow de démarrage automatique désactivé

Suivez les étapes décrites dans la section appliquer un modèle de workflow à un dossier et définissez le workflow de démarrage automatique désactivé comme workflow de démarrage automatique pour les dossiers qui ne nécessitent pas de post-traitement des ressources.

Bonnes pratiques et restrictions best-practices-limitations-tips

Bonnes pratiques

  • 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. Les rendus ne peuvent pas être supprimés en bloc par la suite. Comme les rendus inutilisés ne peuvent pas être supprimés collectivement, les rendus indésirables peuvent s’accumuler et consommer une grande quantité d’espace de stockage après une utilisation prolongée d’Adobe Experience Manager (AEM). Pour les ressources individuelles, vous pouvez supprimer manuellement les rendus à l’aide de l’interface utilisateur. Pour plusieurs ressources, vous pouvez personnaliser les Experience Manager pour supprimer des rendus spécifiques ou supprimer les ressources et les charger à nouveau.

Limites actuelles

  • 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.
  • 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 peut échouer pour les fichiers qui dépassent ce seuil.
  • Il est recommandé de limiter le nombre de rendus appliqués à une ressource à moins de 40, car le dépassement de cette limite entraîne la troncation des requêtes.

Voir également

recommendation-more-help
experience-manager-cloud-service-help-main-toc