DocumentazioneExperience Cloud KCS

AEMaaCS: l’API di pubblicazione del frammento di contenuto non riesce a causa di un frammento non valido

Ultimo aggiornamento: 19 ottobre 2026

✨ Il contenuto è generato tramite IA e potrebbe non essere accurato. Termini di IA generativi

Questo articolo spiega come risolvere gli errori durante la pubblicazione di un frammento di contenuto utilizzando l’API AEM as a Cloud Service /adobe/sites/cf/fragments/publish, in cui il frammento viene rimosso dalla struttura di pubblicazione a causa di errori di convalida.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS), tutte le versioni.

Sintomi

Quando si tenta di pubblicare un frammento di contenuto utilizzando l’API /adobe/sites/cf/fragments/publish, il frammento non viene inviato agli ambienti di anteprima o pubblicazione. Nel registro degli errori viene visualizzato il seguente avviso:

Frammento ’

Il frammento non viene pubblicato e il rendering di tutte le pagine di contenuto che lo dipendono potrebbe non riuscire, con conseguente impatto sulla preparazione al rilascio. Questo problema è specifico per i frammenti che fanno riferimento ad altri frammenti o risorse. L’errore non specifica quale campo o regola non ha superato la convalida. Altri frammenti potrebbero essere pubblicati correttamente o generare errori con messaggi diversi, ad esempio “riferimenti non validi”.

Causa

La convalida del frammento rispetto al relativo modello per frammenti di contenuto non è riuscita a causa di uno o più problemi a livello di campo, ad esempio il superamento dei limiti di caratteri, valori di enumerazione non validi, campi obbligatori mancanti o modelli di riferimento non consentiti. Il flusso di lavoro di pubblicazione rimuove i frammenti non validi dalla struttura di pubblicazione per evitare la distribuzione incoerente dei contenuti.

Risoluzione resolution

Per risolvere il problema, segui la procedura riportata di seguito.

  1. Eseguire una richiesta GET a /adobe/sites/cf/fragments/<fragment-uuid> nell’ambiente di authoring.

  2. Esaminare la sezione validationStatus nella risposta per i dettagli sui campi per i quali la convalida non è riuscita.

  3. In alternativa, apri il frammento nell’editor dei frammenti di contenuto e verifica la presenza di errori di convalida sia nell’elemento principale che in tutte le varianti.

  4. Risolvere i campi contrassegnati, ad esempio:

    • Campi di testo a riga singola che superano i 255 caratteri (limite predefinito se non impostato nel modello).

    • Campi a discesa (enumerazione) con valori non consentiti dal modello corrente.

    • Campi obbligatori lasciati vuoti in qualsiasi variante.

    • Campi contenenti più elementi di quelli consentiti dal modello.

    • Percorsi di risorse o immagini non esistenti.

    • Frammenti a cui si fa riferimento i cui modelli non sono consentiti per il modello campo.

    • Dati del campo non più definiti nel modello corrente (ad esempio, dopo una modifica del modello).

    ​5. Salva il frammento dopo aver apportato le correzioni.
    ​6. Ripubblica il frammento utilizzando l’API /adobe/sites/cf/fragments/publish o l’interfaccia utente di AEM.
    ​7. Verifica che il frammento sia ora disponibile nell’ambiente di anteprima/pubblicazione e che il contenuto dipendente venga riprodotto come previsto.

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