Intégrer aux profils de traitement AEM

Dernière mise à jour : 2024-01-29
  • Créé pour :
  • Intermediate
    Experienced
    Developer

Pour que les programmes de travail Asset Compute puissent générer des rendus personnalisés dans AEM as a Cloud Service, ils doivent être enregistrés dans le service de création d’AEM as a Cloud Service via les profils de traitement. Pour toutes les ressources soumises à ce profil de traitement, le programme de travail sera appelé lors du chargement ou du retraitement et le rendu personnalisé sera généré et mis à disposition via les rendus de la ressource.

Créer un profil de traitement

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

Profil de traitement.

  1. Connectez-vous au service de création d’AEM as a Cloud Service en tant qu’Administrateur ou administratrice AEM. Comme il s’agit d’un tutoriel, nous vous recommandons d’utiliser un environnement de développement ou un environnement dans une sandbox.
  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é et appuyez sur Ajouter nouveau.
  6. Définir le nouveau service
    • Nom du rendu : Circle
      • Nom de fichier de rendu utilisé pour identifier ce rendu dans AEM Assets
    • Extension : png
      • Extension du rendu généré. Définissez 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 de 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 obtenue via aio app get-url. Assurez-vous que l’URL pointe vers le bon espace de travail en fonction de l’environnement AEM as a Cloud Service.
      • Assurez-vous que l’URL du programme de travail pointe versle bon espace de travail. L’instance d’évaluation d’AEM as a Cloud Service doit utiliser l’URL de l’espace de travail d’évaluation et l’instance de production d’AEM as a Cloud Service 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 sont transmises au programme de travail 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 ceux qui sont traités par le programme de travail personnalisé.
      • Exclut : Leave blank
        • N’utilisez jamais cette configuration de service pour traiter les ressources avec ces types MIME. Dans ce cas, nous utilisons uniquement une liste autorisée.
  7. Appuyz sur Enregistrer en haut à droite.

Appliquer et appeler un profil de traitement

  1. Sélectionnez le profil de traitement nouvellement créé, 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. Chargez certaines nouvelles ressources d’images (sample-1.jpg, sample-2.jpg et sample-3.jpg) dans n’importe quel dossier situé sous le dossier auquel est appliqué le profil de traitement, et attendez que la ressource 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 depuis la barre latérale gauche.

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

    Rendu généré.

Terminé.

Félicitations. Vous avez terminé le tutoriel sur la manière d’étendre les microservices d’Asset Compute d’AEM as a Cloud Service. Vous pouvez maintenant configurer, développer, tester, déboguer et déployer des programmes de travail d’Asset Compute personnalisés à utiliser par votre service de création d’AEM as a Cloud Service.

Examinez le code source complet du projet sur GitHub.

Le projet Asset Compute final est disponible sur GitHub à l’adresse :

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

Résolution des problèmes

Sur cette page