文書構造内のエラーを検索して修正

構造図を使用してエラーを検索する

構造図を使用し、Adobe FrameMaker で文書構造内のエラーを検索して修正する方法について説明します。

文書のエレメント定義の内容ルールと属性記述に一致しないエレメントがある場合は、構造図でエラーを識別します。

不明エレメント: エレメント定義で必要とされる子エレメントの所在が不明の場合、垂直線上の子エレメントが存在するべき場所に、小さな赤い正方形が表示されます。

Figure 1. 必要な子エレメントがありません
無効な位置にあるエレメント: あるエレメントが内容ルールで許可されていない位置にある場合、垂直線はこのエレメントから親エレメントの最後まで破線で表示されます。

Figure 2. 「Para」エレメントはこの位置では無効です
未定義のエレメント: 文書内で定義されていないエレメントの場合、ブロックが赤く表示されます。このエラーは、他の文書からエレメントをペーストしたときに発生することがあります。
無効な属性: 属性の値が無効な場合や、文書内で定義されていない属性の場合、属性名の左に赤い x 印が表示され、値が赤で表示されます。

Figure 3. DraftVersion 属性が無効です
必要な値が所在不明の属性: 属性に値が含まれない場合は、属性名の右側に「値なし」と表示されます。属性が値を必要とする場合は「値なし」が赤色で表示され、その左側に赤色の穴が表示されます。

Figure 4. XRefLabel 属性に必要な値が見つかりません。

文書の検証

Adobe FrameMaker で文書を検証する方法と、文書構造内のエラーを修正する方法について選択します。

概要

文書を検証するとき、文書のエレメント定義に記述されている属性ルールや内容ルールに一致しないエレメントが検索されます。エラーが検出されると、エレメントが選択され、エラーの説明が表示されます。

文書全体、現在のフローまたは現在のエレメントを検証できます。現在のエレメントを検証する場合、子エレメントのディセンダントはチェックされません。例えば、以下の <Section> エレメントを検証した場合、FrameMaker は <Head> エレメント、2 つの <Para> エレメント、および <List> エレメントは有効ですが、 <List Item> エレメントを <リスト>を選択します。

Figure 5. Section エレメントの子エレメントのみを検証します

文書にコンディショナルテキストがある場合は、表示されているバージョンだけが検証されます。

すべての構成ファイルを含むブック全体、ブックファイルのみ、ブックファイルの現在のエレメントのみを検証できます。

文書の検証方法

文書を検証するには、次の操作を行います。

構造図 > 検証を選択します。エレメント検証ダイアログが表示されます。

Figure 6. エレメント検証ダイアログ
「文書 / ブック全体で」、「ブックエレメントのみ」、「現在のフローに対して」または「現在のエレメント」を選択して検証範囲を指定します。
所在不明のエレメントや属性値を検索対象から除外するには、「所在不明のエレメントを無視」または「所在不明の属性値を無視」を選択します。

これらの設定を選択すると、FrameMaker は必要な子エレメントや属性値が不明な部分は検索しません。まだ文書が完成していない場合に、これらを選択してください。
「検証の開始」をクリックします。

現在のエレメントの先頭からチェックが開始されます。現在のエレメントだけを検証する場合は、挿入ポイントがあるエレメントまたは選択されているエレメントがチェックされます。複数のエレメントが選択されている場合は、その中の最初のエレメントがチェックされます。
FrameMaker がエラーを検出した場合、「検証の開始」を再度クリックすると検証を続行します。

エレメント検証ダイアログボックスの上部には、エレメントの名前と問題に関する短いメッセージが表示されます。

エラーを修正または無視するか、「特殊ケースとして使用」をクリックできます。特殊ケースとして処理すると、次に文書を検証するとき、このエラーは検出されません。
エラーが検出されなくなるまで、手順 5 までの操作を繰り返します。

文書の最後に到達すると、最初に戻って検証を続行します。フローの最後に到達すると、次のフローがチェックされます。

Note: ブックを検証する際、FrameMaker はブック内のファイルに無効な内容が含まれているかを検証しますが、詳細を確認するためには、ファイルを開いて検証する必要があります。

EDD のエレメントの検証には、if-then 節の属性の検証も含まれています。例えば、属性に使用できる値が A、B または C で、コンテキストルールで If [attrval = “D”] が指定されているとします。これは、エレメント定義の取り込み時に、エラーとしてフラグされ、無効な構造として報告されます。

同様に、エレメントのテキスト書式ルールまたは接頭辞および接尾辞ルールがコンテキスト仕様で属性名を使用する場合、属性の名前とケースはエレメント定義の属性定義と同じである必要があります。

属性値が以前と同じ値に変更される場合、この操作は変更としてフラグされません。この変更により、値の不必要なチェックが削減されパフォーマンスが向上します。

すべての特殊ケースを解除する

構造 > 検証を選択します。
「特殊ケースを解除」をクリックします。ダイアログボックスで選択した範囲（文書、フローまたはエレメント）の特殊ケースが解除されます。

検証時のエラーメッセージ

Adobe FrameMaker で構造化文書を検証するときにエラーメッセージを検証する方法について説明します。

次のエラーメッセージは、Adobe FrameMaker のエレメント検証ダイアログの上部に表示されます。

現在のフローは構造化されていません

現在のフローにはエレメントがありません。

エレメントが定義されていません

エレメントが文書内に定義されていません。別の文書からエレメントをコピーした可能性があります。

エレメントの前に <エレメントがありません>

このエレメントの前の、少なくとも 1 つの必要なエレメントの所在が不明です。

最後に内容がさらに必要です

現在のエレメントの最後に、少なくとも 1 つの子エレメントが必要です。

現在のエレメントがありません

挿入ポイントまたは選択範囲がありません。

このメッセージは、範囲を「現在のエレメント」に設定しているときに表示されます。

現在のフローがありません

挿入ポイントまたは選択範囲がありません。

このメッセージは、範囲を「現在のフロー」に設定しているときに表示されます。

最上位エレメントではありません

このエレメントを文書の最上位に置くことはできません。

<TEXT> はこのエレメントでは許可されていません

エレメントにテキストが含まれていますが、テキストは使用できません。

<TEXT> はこの位置では有効ではありません

エレメントにはテキストが使用できますが、この位置では無効です。

@属性 は未定義の ID 値を参照します

属性は ID 参照ですが、文書内（ブックを検証しているときはブック内）に存在しない固有 ID 値を指します。

@属性 がこのエレメントに対して未定義です

このエレメントの定義には、この @属性を選択します。

このエレメントは（タイプ）である必要があります

このエレメントのタイプが正しくありません。タイプは「グラフィック」、「マーカー」、「相互参照」、「数式」または「システム変数」のいずれかです。例えば、「Cross-Reference」エレメントが、相互参照ではなくテキストで構成されている可能性があります。

値は @属性の型でなくてはなりません

属性値はこの属性には使用できない型です。

@属性 の値は n から n の範囲内でなければなりません

属性の数値は指定範囲外にあります。

@属性 の値は許可された選択ではありません

属性の値は、有効な選択のドロップダウンリストの値と一致する必要があります。

属性「名前」の値は固有である必要があります

「固有 ID」の値は文書またはブック内のすべてのエレメントに対して一意である必要があります。

属性「名前」に値が必要です

属性に必要な値がありません。

<エレメント> はこのエレメントでは除外されています

親またはそのアンセスターの除外ルールであるため、この <エレメント> は許可されません。

<エレメント> はこのエレメントでは許可されていません

<エレメント> は親エレメントのどの場所でも許可されていません。

<エレメント> はこの位置では有効ではありません

<エレメント> は親エレメントで許可されていますが、現在の場所では許可されていません。

エレメントのエラーを修正

Adobe FrameMaker で XML 検証エラーメッセージを修正する方法について説明します。

エレメントと属性のエラーを識別後、エレメントカタログと構造図をガイドとして使用し、エラーを修正します。

無効な場所にあるエレメントを修正するには、有効な場所にエレメントを移動するか、現在の場所で有効なエレメントに変更します。

無効なエレメントは構造図を選択します。検証する場合は、FrameMaker によってエレメントが選択されます。

エレメントが選択されると、エレメントカタログはその場所で有効なエレメントを表示します。

Figure 7. li（リストアイテム）はこの場所で有効です
無効な内容が含まれているエレメント（無効な内容というテキストスニペットが表示される）を修正するには、その内容を許可するエレメントに変更します。
所在不明の子エレメントがある構造を修正するには、必要なエレメントを挿入します。

所在不明のエレメントの位置をクリックします。または、検証中の場合、自動的に挿入ポイントが表示されます。挿入ポイントが所在不明のエレメントの場所にあるときは、エレメントカタログはその場所で有効なエレメントを示します。

Figure 8. 場所の入力に有効なエレメントを示しているエレメントカタログ
無効な属性値を修正するには、その属性に対して有効な値に変更します。
未定義の属性を削除するには、未定義の属性が含まれるエレメントを選択し、属性ダイアログボックスを開いて属性を選択し、「属性を削除」をクリックします。次に表示されるダイアログボックスで、現在のエレメントまたはこの属性を持つすべてのエレメントから属性を削除します。
無効な ID を持つ相互参照を解決するには、相互参照を選択して挿入 > 相互参照を選択し、有効な ID を持つソースに変更します。