DokumentationExperience Cloud KCS

AEMaaCS: Die Veröffentlichungs-API für Inhaltsfragmente schlägt aufgrund eines ungültigen Fragments fehl

Letzte Aktualisierung: 19. Oktober 2026

✨ Dieser Inhalt wird von KI generiert und könnte ungenau sein. Generative KI-Begriffe

In diesem Artikel wird beschrieben, wie Sie Fehler bei der Veröffentlichung eines Inhaltsfragments mithilfe der API AEM as a Cloud Service /adobe/sites/cf/fragments/publish beheben können, bei der das Fragment aufgrund von Validierungsfehlern aus der Veröffentlichungsstruktur entfernt wird.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS), alle Versionen.

Symptome

Beim Versuch, ein Inhaltsfragment mit der API /adobe/sites/cf/fragments/publish zu veröffentlichen, kann das Fragment nicht in die Vorschau- oder Veröffentlichungsumgebungen gepusht werden. Die folgende Warnung wird im Fehlerprotokoll angezeigt:

Fragment ’

Das Fragment wird nicht veröffentlicht, und die davon abhängigen Inhaltsseiten können möglicherweise nicht gerendert werden, was sich auf die Veröffentlichungsbereitschaft auswirkt. Dieses Problem betrifft nur Fragmente, die auf andere Fragmente oder Assets verweisen. Der Fehler gibt nicht an, welches Feld oder welche Regel bei der Validierung fehlgeschlagen ist. Andere Fragmente können erfolgreich veröffentlicht werden oder mit anderen Meldungen wie „ungültige Verweise“ fehlschlagen.

Ursache

Die Validierung des Fragments in Bezug auf sein Inhaltsfragmentmodell ist aufgrund eines oder mehrerer Probleme auf Feldebene fehlgeschlagen, z. B. das Überschreiten von Zeichenbeschränkungen, ungültige Auflistungswerte, fehlende erforderliche Felder oder nicht zulässige referenzierte Modelle. Der Veröffentlichungs-Workflow entfernt ungültige Fragmente aus der Veröffentlichungsstruktur, um eine inkonsistente Inhaltsbereitstellung zu verhindern.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben.

  1. Führen Sie eine GET-Anfrage aus, um in der Autorenumgebung zu /adobe/sites/cf/fragments/<fragment-uuid>.

  2. Im Abschnitt validationStatus der Antwort finden Sie Details darüber, welche Felder bei der Validierung fehlgeschlagen sind.

  3. Alternativ können Sie das Fragment im Inhaltsfragment-Editor öffnen und sowohl die primäre als auch alle Varianten auf Validierungsfehler überprüfen.

  4. Adressiert alle markierten Felder, z. B.:

    • Einzeilige Textfelder mit mehr als 255 Zeichen (Standardlimit, wenn nicht im Modell festgelegt).

    • Dropdown (Auflistung)-Felder mit Werten, die vom aktuellen Modell nicht zugelassen sind.

    • Erforderliche Felder in jeder Variante leer gelassen.

    • Felder mit mehr Elementen als im Modell zulässig.

  • Asset- oder Bildpfade, die nicht vorhanden sind.

    • Referenzierte Fragmente, deren Modelle für das Feld nicht zulässig sind.

  • Felddaten, die im aktuellen Modell nicht mehr definiert sind (z. B. nach einer Modelländerung).

    ​5. Speichern Sie das Fragment, nachdem Sie Korrekturen vorgenommen haben.
    ​6. Veröffentlichen Sie das Fragment erneut mithilfe der API /adobe/sites/cf/fragments/publish oder der AEM-Benutzeroberfläche.
    ​7. Vergewissern Sie sich, dass das Fragment jetzt in der Vorschau-/Veröffentlichungsumgebung verfügbar ist und dass der abhängige Inhalt wie erwartet gerendert wird.

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