Intégrer aux profils de traitement AEM
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.
-
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.
-
Accédez à Outils > Ressources > Profils de traitement.
-
Appuyez sur le bouton Créer.
-
Nommez le profil de traitement,
WKND Asset Renditions
. -
Appuyez sur l’onglet Personnalisé et appuyez sur Ajouter nouveau.
-
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.
- Extension du rendu généré. Définissez sur
-
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.
- Il s’agit de l’URL du programme de travail obtenue via
-
Paramètres de service
-
Appuyez sur Ajouter un paramètre.
- Clé :
size
- Valeur :
1000
- Clé :
-
Appuyez sur Ajouter un paramètre.
- Clé :
contrast
- Valeur :
0.25
- Clé :
-
Appuyez sur Ajouter un paramètre.
- Clé :
brightness
- Valeur :
0.10
- Clé :
-
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.
- Inclut :
-
-
Appuyz sur Enregistrer en haut à droite.
Appliquer et appeler un profil de traitement
-
Sélectionnez le profil de traitement nouvellement créé,
WKND Asset Renditions
. -
Appuyez sur Appliquer le profil au(x) dossier(s) dans la barre d’actions supérieure
-
Sélectionnez un dossier auquel appliquer le profil de traitement, par exemple
WKND
, et appuyez sur Appliquer. -
Accédez au dossier auquel le profil de traitement n’a pas été appliqué via AEM > Ressources > Fichiers et appuyez sur
WKND
. -
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.
-
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.
-
Ouvrez la vue Rendus depuis la barre latérale gauche.
-
Appuyez sur la ressource nommée
Circle.png
et consultez le 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
.