Campaign: parametri aggiuntivi registerDevice mancanti da appSubscriptionRcp
In Adobe Campaign Classic v8 FFDA, una personalizzazione comune consiste nell’aggiungere attributi di abbonamento aggiuntivi e popolarli tramite l’API registerDevice per dispositivi mobili. Ciò può non riuscire se l’estensione di nms:appSubscriptionRcp si basa su autoStg=“true” in una famiglia di schemi che dispone già di uno schema di staging predefinito. In tal caso, i parametri aggiuntivi potrebbero non essere memorizzati correttamente e, in alcune situazioni, lo schema di staging può essere rigenerato in uno stato non funzionante.
Descrizione description
Un’implementazione personalizzata aggiunge nuovi campi a nms:appSubscriptionRcp e trasmette valori tramite la chiamata registerDevice mobile utilizzando additionalParameters.
I sintomi possono includere:
- La richiesta registerDevice contiene i parametri aggiuntivi, ma i valori non vengono mantenuti.
- Gli inserimenti o gli aggiornamenti relativi alla tabella di gestione temporanea non includono le colonne personalizzate previste.
- Dopo aver abilitato autoStg=“true” nell’estensione appSubscriptionRcp e aver aggiornato la struttura del database, la registrazione del dispositivo inizia a non riuscire.
- Possono essere visualizzati errori simili ai seguenti:
XSV-350023 Impossibile salvare un documento di tipo ‘nms:appSubscriptionRcpStg’
QUE-370007 Impossibile trovare i valori chiave per l’elemento ‘Applicazione sottoscrittore (gestione temporanea)’
Elemento ‘mobileApp’ sconosciuto
Risoluzione resolution
Causa
autoStg=“true” non è un meccanismo generico per l’estensione di schemi preconfigurati che utilizzano già uno schema di staging esistente.
Funziona per i casi d’uso supportati in cui uno schema personalizzato e il relativo modello di staging sono creati da zero. Non è l’approccio corretto per l’estensione di nms:appSubscriptionRcp, perché tale schema dipende già dallo schema di staging predefinito nms:appSubscriptionRcpStg. L’abilitazione di autoStg=“true” in questo caso può attivare la rigenerazione automatica dello schema di staging in modo da non mantenere la struttura preconfigurata, i collegamenti e le chiavi previsti.
Risoluzione
Utilizza il seguente approccio:
Non abilitare autoStg=“true” nell’estensione appSubscriptionRcp quando utilizzi lo schema di abbonamento predefinito nell’FFDA di ACC v8.
Estendi esplicitamente entrambi gli schemi:
- lo schema di abbonamento principale
- lo schema di staging utilizzato per la persistenza della registrazione del dispositivo
Mappa i parametri della sottoscrizione ai campi presenti nel percorso di staging utilizzato da registerDevice.
Convalidare il flusso end-to-end confermando che:
- il payload della richiesta contiene additionalParameters
- lo schema di staging include i campi personalizzati previsti
- i valori vengono mantenuti dopo la registrazione del dispositivo
Se autoStg=“true” è già stato applicato:
Rimuovi autoStg=“true” dall’estensione appSubscriptionRcp.
Ripristina nms:appSubscriptionRcpStg alla relativa definizione predefinita.
Riapplica i campi personalizzati richiesti tramite un’estensione esplicita dello schema di staging invece di utilizzare la generazione automatica.
Ricarica le cache e, se necessario, riavvia i servizi pertinenti in modo che la definizione dello schema corretta venga selezionata in modo coerente.
Ripetere il test di registerDevice.