AEM Assets : intégrer l’assainissement du nom de fichier au workflow de chargement standard
Cet article décrit comment intégrer l’assainissement des noms de fichier dans le workflow de chargement d’Assets Adobe Experience Manager (AEM) standard pour gérer des fonctionnalités telles que l’actualisation automatique de la liste des ressources, l’attribution du chargeur et la détection des doublons.
Description description
Lorsque l’assainissement personnalisé du nom de fichier est implémenté lors des chargements de ressources dans AEM Assets à l’aide d’une extension de chargement personnalisée qui contourne l’interface utilisateur de chargement standard, plusieurs problèmes peuvent se produire. Il s’agit notamment de la nécessité d’actualiser manuellement la liste des ressources pour afficher les nouveaux chargements, une attribution de chargeur incorrecte et les boîtes de dialogue de détection des noms de fichier en double manquantes. Ces comportements sont liés au workflow de chargement AEM Assets standard et peuvent ne pas fonctionner comme prévu s’ils sont contournés.
Environnement
Adobe Experience Manager as a Cloud Service (toutes versions)
Symptômes
- Les ressources chargées n’apparaissent pas automatiquement dans l’interface utilisateur d’Assets. Un rechargement manuel de page est requis.
- Le champ « chargé par » indique un utilisateur système plutôt que l’utilisateur réel.
- Les boîtes de dialogue de détection des noms de fichier en double ne sont pas déclenchées pour les ressources portant le même nom dans le même dossier.
- Des différences de performances de chargement sont observées entre les flux de chargement personnalisés et standard.
Cause
Les extensions de chargement personnalisées qui contournent l’interface utilisateur de chargement AEM Assets standard ne déclenchent pas de comportements d’interface utilisateur intégrés tels que l’actualisation automatique, l’attribution du chargeur et les boîtes de dialogue de détection de doublons. Ces fonctionnalités sont intégrées au workflow de chargement standard.
Résolution resolution
Suivez les étapes ci-dessous pour résoudre le problème.
-
Utiliser l’interface utilisateur de chargement d’AEM Assets standard pour les chargements de ressources.
-
Intégrez votre logique d’assainissement de nom de fichier dans le workflow de chargement standard en ajoutant une validation côté client ou côté serveur avant le lancement du chargement. Par exemple :
- Ajoutez une étape de validation du nom de fichier dans votre composant d’interface utilisateur personnalisé qui appelle la boîte de dialogue de chargement standard uniquement si le nom de fichier est conforme à vos règles d’assainissement.
- Vous pouvez également implémenter une vérification côté serveur avant l’appel API
initiateUploadpour appliquer des règles de nom de fichier ou de duplication plus strictes.
-
Assurez-vous que les chargements sont effectués sous la session ou le jeton d’authentification de l’utilisateur réel ou utilisatrice réel afin de conserver une attribution de chargeur correcte. Si les chargements doivent être effectués à l’aide d’un utilisateur système, pensez à stocker l’identité de l’utilisateur ou de l’utilisatrice réel(e) dans un champ de métadonnées dédié, tel que
uploadedBy. -
Utilisez l’interface utilisateur standard pour gérer la détection des doublons. L’interface utilisateur de chargement standard invite les utilisateurs à utiliser une boîte de dialogue de conflit si une ressource portant le même nom existe dans le dossier cible. Notez que la détection de doublons binaires à l’aide de
dam:sha1est asynchrone et rend compte à la boîte de réception ; elle ne bloque pas les chargements. -
Après avoir intégré votre logique d’assainissement, vérifiez les points suivants :
- Les ressources chargées s’affichent automatiquement dans l’interface utilisateur d’Assets sans actualisation manuelle.
- Le bon utilisateur s’affiche dans le champ « chargé par ».
- Les boîtes de dialogue de nom de fichier en double sont déclenchées comme prévu.