Intégration aux profils de traitement AEM

Pour que les agents d’Asset compute puissent générer des rendus personnalisés dans AEM en tant que Cloud Service, ils doivent être enregistrés dans AEM en tant que service d’auteur de Cloud Service via les profils de traitement. Le programme de travail sera appelé lors du chargement ou du retraitement de toutes les ressources soumises à ce profil de traitement et le rendu personnalisé sera généré et rendu disponible via les rendus de la ressource.

Définition d’un profil de traitement

Créez tout d’abord un profil de traitement qui appelle le programme de travail avec les paramètres configurables.

Profil de traitement

  1. Connectez-vous à AEM en tant que service d’auteur de Cloud Service en tant qu’ AEM administrateur. Comme il s’agit d’un tutoriel, nous vous recommandons d’utiliser un environnement de développement ou un environnement dans un environnement de test.
  2. Accédez à Outils > Ressources > Profils de traitement
  3. Appuyez sur le bouton Créer
  4. Nommez le profil de traitement WKND Asset Renditions
  5. Appuyez sur l’onglet Personnalisé, puis sur Ajouter nouveau.
  6. Définir le nouveau service
    • Nom du rendu: Circle
      • Rendu du nom de fichier qui sera utilisé pour identifier ce rendu dans AEM Assets
    • Extension : png
      • Extension du rendu qui sera généré. Définissez cette variable sur png, car il s’agit du format de sortie pris en charge par le service Web du programme de travail, qui produit un arrière-plan transparent derrière la découpe du cercle.
    • Point d’entrée : https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker
      • Il s’agit de l’URL du programme de travail obtenu via aio app get-url. Assurez-vous que l’URL pointe vers l’espace de travail correct en fonction de l’environnement AEM as a Cloud Service.
      • Assurez-vous que l’URL du programme de travail pointe vers l’espace de travail approprié. AEM as a Cloud Service Stage doit utiliser l’URL de l’espace de travail intermédiaire et AEM as a Cloud Service Production doit utiliser l’URL de l’espace de travail de production.
    • Paramètres de service
      • Appuyez sur Ajouter un paramètre.
        • Clé: size
        • Valeur : 1000
      • Appuyez sur Ajouter un paramètre.
        • Clé: contrast
        • Valeur : 0.25
      • Appuyez sur Ajouter un paramètre.
        • Clé: brightness
        • Valeur : 0.10
      • Ces paires clé/valeur qui sont transmises au programme de travail de l’Asset compute et disponibles via l’objet JavaScript rendition.instructions.
    • Types MIME
      • Inclut : image/jpeg, image/png, image/gif, image/bmp, image/tiff
        • Ces types MIME sont les seuls à être utilisés pour les modules npm du programme de travail. Cette liste limite les ressources qui seront traitées par le programme de travail personnalisé.
      • Exclut : Leave blank
        • Ne jamais traiter les ressources avec ces types MIME à l’aide de cette configuration de service. Dans ce cas, nous n'utilisons qu'une liste autorisée.
  7. Appuyez sur Enregistrer en haut à droite.

Application et appel d’un profil de traitement

  1. Sélectionnez le profil de traitement que vous venez de créer, WKND Asset Renditions

  2. Appuyez sur Appliquer le profil au(x) dossier(s) dans la barre d’actions supérieure.

  3. Sélectionnez un dossier auquel appliquer le profil de traitement, par exemple WKND et appuyez sur Appliquer.

  4. Accédez au dossier auquel le profil de traitement n’a pas été appliqué via AEM > Ressources > Fichiers et appuyez sur WKND.

  5. Téléchargez de nouvelles ressources d’images (sample-1.jpg, sample-2.jpg et sample-3.jpg) dans n’importe quel dossier sous lequel le profil de traitement est appliqué, et attendez que la ressource téléchargée soit traitée.

  6. Appuyez sur la ressource pour ouvrir ses détails.

    • Les rendus par défaut peuvent être générés et affichés plus rapidement dans AEM que dans les rendus personnalisés.
  7. Ouvrez la vue Rendus dans la barre latérale gauche.

  8. Appuyez sur la ressource nommée Circle.png et passez en revue le rendu généré.

    Rendu généré

Terminé!

Félicitations ! Vous avez terminé le tutoriel sur la manière d’étendre AEM en tant que microservices d’Asset compute Cloud Service ! Vous devriez maintenant pouvoir configurer, développer, tester, déboguer et déployer des objets Worker d’Asset compute personnalisés à utiliser par votre AEM en tant que service de création de Cloud Service.

Examinez le code source complet du projet sur Github.

Le projet d’Asset compute final est disponible sur Github à l’adresse :

Github contient l’état final du projet, entièrement renseigné avec les cas de travail et de test, mais ne contient aucune information d’identification, c’est-à-dire. .env, .config.json ou .aio.

Résolution des problèmes

Sur cette page