Controla una imagen con un sidecar JSON
Un JSON coincidente aporta copy, product_tags, enrutamiento singular o fan-out mediante stores, prevalece sobre los valores en conflicto de la hoja y viaja con las copias diferidas.
- Disponibilidad
- Disponible
- Última verificación
Qué hace
Un JSON coincidente aporta copy, product_tags, enrutamiento singular o fan-out mediante stores, prevalece sobre los valores en conflicto de la hoja y viaja con las copias diferidas.
Antes de comenzar
- Nombra el sidecar con la misma raíz que la obra, por ejemplo art.png y art.json.
- No incluyas credenciales en el archivo. Usa product_tags para etiquetas por imagen.
Qué cambia fuera de ArtDrop
La tienda y la línea se resuelven por separado con esta prioridad: sidecar, sello del drop al cargar, valor guardado del drop, tienda activa y tienda predeterminada. Una lista plural stores activa fan-out en el primer nivel que aporte una ruta.
Pasos
-
Haz coincidir la raíz de la obra
Coloca juntos la obra y el JSON con la misma raíz. El worker comprueba el JSON junto a la imagen y su ruta de metadatos.
-
Elige ruta singular o plural
Usa store y una line opcional para un destino. Usa stores como lista para fan-out explícito por imagen. El diagnóstico registra stores como no reconocido, pero la resolución de destinos lo ejecuta.
-
Conoce el límite del fallo
Una tienda desconocida en una lista JSON explícita stores hace fallar todo el drop. En cambio, las tiendas obsoletas del conjunto guardado Publish drops to se omiten mientras continúan las sanas, salvo que no quede ninguna.
-
Usa JSON para copias retrasadas
Las rutas por ritmo y programadas por tienda llevan la obra y el JSON coincidente. No llevan una hoja de lote.
Resultado esperado
La imagen usa su copy y ruta JSON al ejecutarse. El fan-out explícito resuelve todos los destinos indicados o falla antes de un resultado parcial.
Datos útiles
- Cada sidecar JSON se limita a 2 MiB al cargarlo.
- Los nombres singulares desconocidos de tienda o línea solo fallan en una configuración real de varias tiendas o líneas. Una configuración efectivamente de una tienda avisa y usa la ruta predeterminada.
- Una lista JSON stores anula niveles de ruta inferiores. Un destino explícito desconocido hace fallar todo el fan-out.
Solución de problemas
- ¿Se ignoró el sidecar? Haz coincidir la raíz exacta y valida que el objeto JSON se pueda analizar.
- ¿Un destino explícito está obsoleto? Corrígelo o quítalo antes de reintentar; el JSON explícito no omite un destino inválido.
Cómo deshacer o limpiar
Corrige o quita el sidecar antes de un drop futuro. No puede deshacer registros externos creados por una ejecución anterior.