Vous êtes ici :
Dépannage et migration
Lorsqu’une URL d’image B2C Commerce Dynamic Imaging Service échoue, expire ou semble incorrecte, vérifiez le fichier source, l’URL complète et les limites documentées dans la rubrique Dynamic Imaging Service. Cette rubrique vous aide également à migrer à partir d’autres noms d’hôte et de chaînes de requête Adobe Scene7 (Dynamic Media).
La taille du fichier, le délai d’expiration, le comportement du réseau de diffusion de contenu (CDN) et non-CDN, ainsi que les réponses 4xx ou 408 sont documentés sous Instructions relatives aux images et Mise en cache de l’imagerie dynamique dans Dynamic Imaging Service . Utilisez cette rubrique pour connaître les étapes de dépannage. Les limites numériques restent dans cette rubrique.
Images cassées ou manquantes
- Dans le navigateur, copiez l’URL
imgsrccomplète et ouvrez-la dans un nouvel onglet. Si une transformation est attendue et que vous ne voyez pas/dw/image/v2/dans le chemin d’accès, le modèle peut pointer vers le fichier statique ou un hôte qui n’utilise pas Dynamic Imaging Service. UtilisezURLUtilsetMediaFilecomme dans Créer des URL de transformation d’image . - Si l’état HTTP est 4xx sur la demande d’image, vérifiez à nouveau les règles des paramètres dans Structure d’URL de transformation d’image, validation et ordre des opérations, ainsi que dans le tableau Transformations prises en charge. Causes courantes : doublon
?dans la chaîne de requête,valeurs sw=oush=vides, un ensemble incomplet de paramètres de recadrage ou de superposition, des valeurs hors plage ou unOIMGqui ne respecte pas les règles de longueur, de codage ou d’hôte dans la rubrique principale. - S’il manque le fichier source pour un type d’affichage, mettez à jour le contenu dans Business Manager, pas seulement la requête de transformation.
Lenteur ou délais d’attente
- La première demande à froid peut être plus lente ; une fois que le cache du CDN est chaud, les chargements répétés doivent être plus rapides. Voir Mise en cache dynamique de l’imagerie .
- Les fichiers surdimensionnés et les transformations lourdes (par exemple, la mise à l’échelle d’un
GIFanimé de grande taille) peuvent atteindre le délai d’expiration des Directives relatives aux images (voir Taille et délai d’expiration du fichier) : réduisez la complexité de la source ou transformez d’abord le coût. - Dans les environnements hors production, la protection contre le pistage de Firefox peut bloquer certaines premières récupérations. Reportez-vous à la note du navigateur dans les Directives relatives aux images de ce fichier (avec la taille du fichier et le délai d’expiration).
Migration : hôtes hérités et autres CDN
Lorsque vous remplacez un nom d’hôte CDN d’infrastructure ou de fournisseur historique, ne modifiez pas manuellement un nouvel hôte Edge sans un modèle approuvé par votre programme. Régénérez les URL correctes à l’aide d’URLUtils et de MediaFile, ou à partir d’un assistant de communauté pour le domaine de votre boutique personnalisée, comme dans Enveloppe d’image de produit DIS communautaire facultative .
Un mappage approximatif (vérifiez chaque paramètre de la table principale) pour Adobe Scene7 ou des chaînes de requête Dynamic Media similaires :
| Style typique de Scene7 | Direction typique du DIS |
|---|---|
Largeur = 400
|
scaleWidth / sw=400 dans votre transformation ou requête. |
HEI = 400
|
scaleHeight / sh=400. |
fmt=jpeg ou fmt=png
|
Extension de fichier de sortie et, si nécessaire, format / sfrm comme dans la ligne Format du tableau Transformations prises en charge . |
qlt = 80
|
quality / q=80, ou omettre si vous conservez la valeur par défaut de 80. |
| Remplissage ou extension (selon le fournisseur) | Utilisez cx, cy, cw, ch puis sw / sh dans l’ordre fixe dans Structure d’URL de transformation d’image, validation et ordre des opérations . |
DAM et migration en bloc
Dans le cas d’un gestionnaire d’actifs numériques (DAM) tiers, exportez une image principale de grande taille, téléchargez-la vers la bibliothèque B2C Commerce et le type d’affichage appropriés pour votre flux, exécutez vos tâches d’importation et de réplication, puis redirigez la boutique vers la génération d’URL via URLUtils et MediaFile ou un assistant de la communauté si nécessaire, et arrêtez de créer des liens profonds avec l’ancien CDN du fournisseur après le basculement.
Lorsque vous ouvrez un dossier auprès du support Salesforce, incluez l’URL de reproduction complète (chemin d’accès et requête), le contexte du realm et du site, l’état HTTP attendu et observé ou les octets, ainsi que ce que vous avez déjà essayé dans cette rubrique.
