Suchen und Korrigieren von Fehlern in der Dokumentstruktur

Fehlersuche in der Strukturansicht

Erfahren Sie, wie Sie die Strukturansicht verwenden, um mit Adobe FrameMaker Fehler in der Dokumentstruktur zu finden und zu korrigieren.

Wenn ein Element nicht den Inhaltsregeln und Attributbeschreibungen der Elementdefinitionen des Dokuments entspricht, wird dieser Fehler in der Strukturansicht für Sie angezeigt.

Fehlende Elemente: Wenn in einem Element ein oder mehrere untergeordnete Elemente fehlen, die laut Elementdefinition erforderlich sind, erscheint an der Stelle, an der sich das untergeordnete Element befinden sollte, ein rotes Quadrat auf der vertikalen Linie.

Figure 1. Mindestens ein erforderliches untergeordnetes Element fehlt.
Elemente an einer ungültigen Position: Wenn ein Element laut Inhaltsregeln an der aktuellen Position nicht zulässig ist, wird die daneben liegende vertikale Linie bis zum Ende des übergeordneten Elements gestrichelt dargestellt.

Figure 2. Das Element „Para“ ist an dieser Position ungültig.
Nicht definierte Elemente: Wenn ein Element für das Dokument nicht definiert ist, ist das Elementrechteck rot. Dies kann auftreten, wenn Sie das Element aus einem anderen Dokument eingefügt haben.
Ungültige Attribute: Wenn ein Attribut einen ungültigen Wert hat oder nicht für das Dokument definiert ist, wird links neben dem Attributnamen ein rotes x angezeigt und der entsprechende Wert ist rot.

Figure 3. Das Attribut „EntwurfVersion“ ist ungültig
Fehlende erforderliche Attributwerte: Wenn ein Attribut keinen Wert besitzt, wird rechts neben dem Attributnamen Kein Wert angezeigt. Wenn für das Attribut ein Wert erforderlich ist, ist Kein Wert rot, und links daneben wird ein rotes Quadrat angezeigt.

Figure 4. Dem Attribut „XrefLabel“ fehlt ein erforderlicher Wert.

Dokument prüfen

Erfahren Sie, wie Sie mit Adobe FrameMaker ein Dokument prüfen und Fehler in der Dokumentstruktur korrigieren.

Einführung

Wenn FrameMaker ein Dokument prüft, wird nach Elementen gesucht, die nicht den Inhalts- und Attributregeln der Elementdefinitionen des Dokuments entsprechen. Wenn FrameMaker einen Fehler findet, wird das Element ausgewählt und der Fehler wird beschrieben.

Sie können das gesamte Dokument, den aktuellen Textfluss oder das aktuelle Element prüfen. Wenn Sie das aktuelle Element prüfen, überprüft FrameMaker nicht die nachfolgenden Elemente der untergeordneten Elemente des Elements. Beispiel: Wenn Sie das nachstehende Element <Abschnitt> prüfen, stellt FrameMaker sicher, dass das Element <Überschrift>, die zwei Elemente <Absatz> und das Element <Liste> gültig sind, prüft aber nicht die <Listenelement>-Elemente in der <Liste>.

Figure 5. Nur die untergeordneten Elemente des Abschnitts werden geprüft

Geprüfte untergeordnete Elemente eines Abschnitts in der Strukturansicht

Wenn das Dokument bedingten Text enthält, werden nur die angezeigten Versionen geprüft.

Sie können auch ein ganzes Buch mit allen dazugehörigen Dateien oder nur die Buchdatei oder nur das aktuelle Element in der Buchdatei überprüfen.

So prüfen Sie ein Dokument

Gehen Sie wie folgt vor, um ein Dokument zu prüfen:

Wählen Sie Struktur > Prüfen. Das Dialogfeld Element prüfen wird angezeigt:

Figure 6. Dialogfeld „Elementprüfung“
Wählen Sie Gesamtes Dokument/Gesamtes Buch, Nur Buchelemente, Aktueller Textfluss oder Aktuelles Element, um den Bereich für die Prüfung festzulegen.
Um fehlende Elemente oder Attributwerte von der Suche auszuschließen, aktivieren Sie die Option Fehlende Elemente ignorieren oder Fehlende Attributwerte ignorieren.

Wenn Sie diese Einstellungen wählen, überprüft FrameMaker nicht die Stellen, an denen erforderliche untergeordnete Elemente oder erforderliche Attributwerte fehlen. Sie können diese Einstellungen wählen, wenn Sie noch nicht versuchen, ein vollständiges Dokument aufzubauen.
Klicken Sie auf Prüfung beginnen.

FrameMaker beginnt die Überprüfung am Anfang des aktuellen Elements. Wenn Sie nur das aktuelle Element prüfen, wird das Element mit Einfügemarke bzw. das ausgewählte Element überprüft. Wenn mehrere Elemente ausgewählt sind, wird das erste Element der Auswahl überprüft.
Wenn FrameMaker einen Fehler findet, klicken Sie erneut auf Prüfung beginnen, sobald Sie mit der Überprüfung fortfahren können.

Im oberen Teil des Dialogfelds Elementprüfung werden der Name des Elements und eine kurze Beschreibung des Problems angezeigt.

Sie können den Fehler korrigieren, ignorieren oder auf Als Spezialfall zulassen klicken. Wenn Sie den Fehler als Sonderfall markieren, identifiziert FrameMaker den Fehler bei der nächsten Prüfung nicht.
Wiederholen Sie Schritt 5, bis FrameMaker keine Fehler mehr findet.

Wenn FrameMaker das Ende des Dokuments erreicht, wird die Prüfung am Anfang des Dokuments fortgesetzt. Wenn FrameMaker das Ende eines Textflusses erreicht, wird die Prüfung beim nächsten Textfluss fortgesetzt.

Hinweis: Wenn FrameMaker beim Prüfen eines Buchs feststellt, dass eine Datei im Buch über ungültigen Inhalt verfügt, wird Ihnen dies mitgeteilt. Eine detailliertere Evaluierung ist jedoch nur durch Öffnen und Prüfen der Datei möglich.

Beim Prüfen der Elemente in einem EDD werden die Attribute in if-then-Klauseln geprüft. Beispiel: Die möglichen Werte eines Attributs sind A oder B oder C und eine Kontextregel lautet If [attrval = "D"]. Dies wird als Fehler gekennzeichnet und als ungültige Struktur gemeldet, wenn die Elementdefinitionen importiert werden.

Ebenso, wenn bei den Textformatierungsregeln oder Präfix/Suffix-Regeln eines Elements Attributnamen in Bezugsdefinitionen verwendet werden, müssen der Attributname sowie Groß-/Kleinschreibung mit der Attributdefinition in der Definition des Elements übereinstimmen.

Wenn ein Attributwert auf den gleichen vorherigen Wert geändert wird, wird die Aktion nicht als Änderung gekennzeichnet. Dadurch verbessert sich die Leistung, da eine unnötige Wertüberprüfung entfällt.

Aufheben aller Sonderfälle

Wählen Sie Struktur > Prüfen.
Klicken Sie auf Spezialfälle löschen. FrameMaker löscht die Sonderfälle im Dokument, Textfluss oder Element, je nachdem, welcher Bereich im Dialogfeld gewählt wurde.

Fehlermeldungen bei Prüfungen

Erfahren Sie mehr über Fehlermeldungen beim Überprüfen eines strukturierten Dokuments mit Adobe FrameMaker.

Die folgenden Fehlermeldungen können oben im Dialogfeld Elementprüfung in Adobe FrameMaker angezeigt werden.

Aktueller Textfluss ist unstrukturiert

Der aktuelle Textfluss enthält keine Elemente.

Element ist nicht definiert

Das Element ist in dem Dokument nicht definiert. Möglicherweise haben Sie das Element aus einem anderen Dokument kopiert.

Fehlendes Element vor <Element>

Vor dem angegebenen Element fehlt mindestens ein erforderliches Element.

Am Ende wird mehr Inhalt benötigt

Mindestens ein zusätzliches untergeordnetes Element wird am Ende des aktuellen Elements benötigt.

Kein aktuelles Element

Es ist keine Einfügemarke oder Auswahl vorhanden.

Diese Meldung wird angezeigt, wenn für die Bereichsangabe „Aktuelles Element“ gewählt wurde.

Kein aktueller Textfluss

Es ist keine Einfügemarke oder Auswahl vorhanden.

Diese Meldung wird angezeigt, wenn für die Bereichsangabe „Aktueller Textfluss“ gewählt wurde.

Nicht Element der obersten Ebene

Das Element ist auf der höchsten Ebene im Dokument nicht zulässig.

<TEXT> in diesem Element nicht erlaubt

Das Element enthält Text, obwohl Text nicht zulässig ist.

<TEXT> ungültig an dieser Stelle

Das Element darf zwar Text enthalten, jedoch nicht an dieser Stelle.

Das @Attribut verweist auf einen nicht definierten ID-Wert

Das Attribut ist eine ID-Referenz und bezieht sich auf einen einmaligen ID-Wert, der im Dokument (oder im Buch, falls Sie ein Buch überprüfen) nicht vorhanden ist.

Das @Attribut ist für dieses Element nicht definiert

Die Definition dieses Elements enthält dieses @Attribut nicht.

Dieses Element sollte ein Typ sein

Das Element hat einen falschen Typ (wobei Typ eine Grafik, Marke, Gleichung, Systemvariable oder ein Querverweis sein kann). Beispielsweise kann ein Querverweiselement anstelle eines Querverweises Text enthalten.

Der Wert muss einen Typ für das @Attribut sein

Der Attributwert hat nicht den richtigen Typ für das Attribut.

Der Wert für das @Attribut muss zwischen n und n liegen

Der numerische Wert des Attributs liegt außerhalb des festgelegten Bereichs.

Der Wert für das @Attribut gehört nicht zu den zugelassenen Auswahlmöglichkeiten

Der Wert des Attributs muss einem der Werte in der Dropdown-Liste für gültige Auswahlmöglichkeiten entsprechen.

Wert für Attribut Name muss einmalig sein

Ein einmaliger ID-Wert darf in allen Elementen eines Dokuments oder Buchs nur einmal auftreten.

Für Attribut Name benötigter Wert

Das Attribut verfügt nicht über einen erforderlichen Wert.

<Element> ist in diesem Element ausgeschlossen

Das Element <> ist aufgrund einer Ausschlussregel für das übergeordnete Element oder eines seiner vorausgehenden Elemente nicht zulässig.

<Element> ist in diesem Element nicht erlaubt

Das Element <> ist an keiner Position im übergeordneten Element zulässig.

<Element> ist an dieser Position nicht gültig

Das Element <> ist im übergeordneten Element zulässig, jedoch nicht an der aktuellen Position.

Korrigieren von Fehlern in Elementen

Erfahren Sie, wie Sie mit Adobe FrameMaker Fehlermeldungen bei XML-Prüfungen beheben.

Nachdem Sie Fehler in Elementen und Attributen identifiziert haben, verwenden Sie den Katalog Elemente und die Strukturansicht als Hilfsmittel für deren Korrektur:

Zum Korrigieren eines Element an einer ungültigen Position verschieben Sie das Element an eine gültige Position oder wandeln Sie es in ein an der aktuellen Position gültiges Element um.

Sie können ein ungültiges Element in der Strukturansicht wählen. Bei der Überprüfung wählt FrameMaker das Element für Sie aus.

Wenn ein Element ausgewählt ist, zeigt der Katalog Elemente, welche Elemente an dieser Position gültig sind.

Figure 7. li (List Item) ist an dieser Position gültig
Zum Korrigieren eines Elements mit ungültigem Inhalt (mit dem Textausschnitt INHALT UNGÜLTIG) ändern Sie den Elementtyp in einen Typ, der diesen Inhalt zulässt.
Zum Korrigieren einer Struktur, in der ein untergeordnetes Element fehlt, fügen Sie das erforderliche Element ein.

Sie können auf die Stelle klicken, an der ein Element fehlt. Wenn Sie eine Prüfung durchführen, platziert FrameMaker an dieser Stelle für Sie die Einfügemarke. Wenn sich die Einfügemarke an der Position des fehlenden Elements befindet, zeigt der Katalog Elemente, welche Elemente an dieser Position gültig sind.

Figure 8. Elementekatalog mit einem gültigen Element zur Eingabe an einer Position
Zum Korrigieren eines ungültigen Attributwerts ändern Sie den Attributwert in einen für das Attribut gültigen Wert.
Um ein nicht definiertes Attribut zu entfernen, wählen Sie das Element mit dem nicht definierten Attribut aus, öffnen das Dialogfeld Attribute, wählen das Attribut aus und klicken auf Attribut löschen. Entfernen Sie im nächsten Dialogfeld das Attribut für das aktuelle Element oder für alle Elemente, die dieses Attribut aufweisen.
Zum Beheben eines Querverweises mit einer ungültigen ID wählen Sie den Querverweis aus, wählen Einfügen > Querverweis und wechseln zu einer Quelle, die eine gültige ID enthält.