Campagne : paramètres supplémentaires registerDevice manquants dans appSubscriptionRcp
Dans Adobe Campaign Classic v8 FFDA, une personnalisation courante consiste à ajouter des attributs d’abonnement supplémentaires et à les renseigner via l’API mobile registerDevice. Cela peut échouer si l’extension de nms:appSubscriptionRcp repose sur autoStg=« true » dans une famille de schémas qui possède déjà un schéma d’évaluation prêt à l’emploi. Dans ce cas, les paramètres supplémentaires peuvent ne pas être stockés correctement et, dans certains cas, le schéma d’évaluation peut être régénéré dans un état non fonctionnel.
Description description
Une implémentation personnalisée ajoute de nouveaux champs à nms:appSubscriptionRcp et transmet les valeurs via l’appel mobile registerDevice à l’aide de additionalParameters.
Les symptômes peuvent inclure :
- La requête registerDevice contient les paramètres supplémentaires, mais les valeurs ne sont pas conservées.
- Les insertions ou mises à jour de la table d’évaluation n’incluent pas les colonnes personnalisées attendues.
- Après avoir activé autoStg=« true » dans l’extension appSubscriptionRcp et mis à jour la structure de la base de données, l’enregistrement de l’appareil commence à échouer.
- Des erreurs similaires à celles-ci peuvent apparaître :
XSV-350023 Impossible d’enregistrer le document de type ‘nms:appSubscriptionRcpStg’
QUE-370007 Impossible de trouver les valeurs de clé pour l’élément ‘Application abonnée (staging)’
Élément ‘mobileApp’ inconnu
Résolution resolution
Cause
autoStg=« true » n’est pas un mécanisme à usage général pour étendre les schémas d’usine qui utilisent déjà un schéma d’évaluation existant.
Elle fonctionne pour les cas d’utilisation pris en charge où un schéma personnalisé et son modèle d’évaluation sont créés à partir de zéro. Ce n’est pas l’approche appropriée pour étendre nms:appSubscriptionRcp car ce schéma dépend déjà du schéma d’évaluation prêt à l’emploi nms:appSubscriptionRcpStg. L’activation de autoStg=« true » dans ce cas peut déclencher la régénération automatique du schéma d’évaluation de manière à ne pas conserver la structure, les liens et les clés prêts à l’emploi attendus.
Résolution
Procédez comme suit :
N’activez pas autoStg=« true » sur l’extension appSubscriptionRcp lorsque vous utilisez le schéma d’abonnement prêt à l’emploi dans ACC v8 FFDA.
Étendez explicitement les deux schémas :
- le schéma d’abonnement principal ;
- schéma de staging utilisé pour la persistance de l’enregistrement de l’appareil
Mappez les paramètres d’abonnement aux champs qui existent dans le chemin d’évaluation utilisé par registerDevice.
Validez le flux de bout en bout en confirmant que :
- la payload de la requête contient additionalParameters
- le schéma d’évaluation inclut les champs personnalisés attendus
- les valeurs sont conservées après enregistrement de l’appareil
Si autoStg=« true » était déjà appliqué :
Supprimez autoStg=« true » de l’extension appSubscriptionRcp.
Rétablissez nms:appSubscriptionRcpStg sa définition d’usine.
Réappliquez les champs personnalisés requis par le biais d’une extension explicite du schéma d’évaluation au lieu d’utiliser la génération automatique.
Rechargez les caches et redémarrez les services appropriés si nécessaire afin que la définition de schéma corrigée soit récupérée de manière cohérente.
Testez à nouveau registerDevice.