DocumentationExperience Cloud KCS

AEM Sites : avertissement org.apache.sling.commons.json.JSONObject obsolète lors de l’utilisation de PageInfoProvider pour des colonnes personnalisées

Dernière mise à jour : 1 août 2026

Cet article explique la cause et l’impact actuel des avertissements d’API obsolètes liés à org.apache.sling.commons.json.JSONObject lors de la personnalisation des colonnes de la vue Liste d’AEM Sites à l’aide de PageInfoProvider.

Description description

Environnement

Adobe Experience Manager (AEM) as a Cloud Service (toutes les versions)

Problème/Symptômes

Lors de l’implémentation de colonnes personnalisées dans la vue Liste de la console AEM Sites à l’aide de l’interface PageInfoProvider, l’avertissement suivant s’affiche dans les journaux :

2023-02-23 18:47:55.095 [ region-deprecated-api]  com.xx.aem:xx-unified-site.core:0.0.2-SNAPSHOT: Usage of deprecated package found : org.apache.sling.commons.json : Usage of this deprecated API is not supported in AEM as a Cloud Service. Deprecated since 2022-12-31 For removal : 2027-12-31 (com.xx.aem:xx-unified-site.all:0.0.2-SNAPSHOT)
  • L’avertissement est déclenché, car le contrat d’API PageInfoProvider requiert le renvoi d’une org.apache.sling.commons.json.JSONObject.
  • Le package org.apache.sling.commons.json est obsolète et sa suppression est prévue après le 31 décembre 2027.
  • Ces avertissements sont fournis à titre d’information et ne bloquent actuellement pas les pipelines Cloud Manager lorsque l’utilisation est limitée aux implémentations PageInfoProvider.

Cause

L’interface PageInfoProvider nécessite actuellement de renvoyer un org.apache.sling.commons.json.JSONObject, ce qui force l’utilisation d’un package obsolète. Ceci est considéré comme une dette technique et sera traité dans une prochaine mise à jour de l’API AEM Sites.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Consultez les avertissements du journal pour confirmer qu’ils sont liés à l’utilisation de PageInfoProvider et à la dépendance org.apache.sling.commons.json.JSONObject.

  2. Sachez qu’actuellement ces avertissements sont à titre d’information uniquement et ne bloquent pas les déploiements ni n’affectent les fonctionnalités des colonnes personnalisées dans la console Sites.

  3. Consultez les notes de mise à jour et la documentation de Adobe Experience Manager pour obtenir des mises à jour concernant l’obsolescence et la suppression prévue des org.apache.sling.commons.json.

  4. Prévoyez de refactoriser les implémentations de colonnes personnalisées à l’avenir :

    • L’ingénierie Adobe travaille à l’obsolescence de l’interface PageInfoProvider actuelle.
    • Une nouvelle interface qui ne nécessite pas de org.apache.sling.commons.json sera introduite et documentée dans une version ultérieure.

  5. Aucune action immédiate n’est requise, sauf si l’API obsolète est utilisée en dehors du contexte PageInfoProvider ou si les prochaines versions introduisent des modifications avec rupture.

recommendation-more-help
experience-cloud-kcs-help-kbarticles