パターン・プロファイラ

このトピックは、セクションまたはタブのない単純なページ、ダイアログまたはその他のUIに使用します。ページ上のすべてのフィールドおよびオプションを説明する必要があります。

ヘルプ出力に正しく生成されるようにこのトピックを構成するには、次の手順を実行します。

  1. Sect1要素を構成します。

    1. 状況依存トピックをSect1として作成します。

    2. 簡単な名詞句と見出し形式の文体を使用して、状況依存トピックにUIの名前を反映したタイトルを付けます。ページ・タイトルには総称名詞を含めます。たとえば、プリファレンス・ページ、プリファレンス・ダイアログ、編集ウィンドウ、リソース・カタログなどです。これが移行中のトピックの場合は、以前と同じタイトルを使用します。

    3. このトピックが目次に表示されないように、HelpTOC属性をTopicOnlyに設定します。

    4. UIの名前およびオプションで製品名が含まれるように、要素のサンプルOutputFileName属性を変更します。たとえば、製品がOracle XYZサーバーで、UIが「プリファレンス」ダイアログの場合、この属性の値をcs_pagename1.htmからcs_preferences.htmまたはxyz_cs_preferences.htmなどに変更します。

    5. ヘルプ・アイコン、ボタンまたはUIのtopicIDと一致するように、HelpTopicID属性を変更します。

      Sect1トピックのHelpTopicID属性の値として、エンジニアから提供されたtopicIDを使用します。ヘルプを別の形式から変換する場合は、既存のHelpTopicIDを使用します。または、自分でtopicIDをトピックに割り当ててから、その割り当てたtopicIDをエンジニアに提供することもできます。重要なのは、FrameMakerでトピックに割り当てるtopicIDが、開発によってUI、ヘルプ・アイコンまたはボタンに割り当てられているtopicIDと一致していることを確認することです。

  2. 次のガイドラインに従って、InformalTable要素を構成します。

    1. 表のSummary属性とTitle属性を適宜変更します。

    2. HelpPara要素を使用して、ドキュメント化する必要があるUI内のすべての要素またはオプションを「要素」列に入力します。「要素」列では、UI要素を太字にしないでください。

    3. 「要素」列のテキストをインデントすることで、UI内に表示される要素をグループ化するには、HelpPara要素のRole属性を編集します。左マージンからテキストをインデントするには、「Level1」を選択します。UIに表示されるオプションの構成を反映するように、必要に応じてLevel1Level2Level3およびLevel4を使用して最大4レベルまでインデントを設定できます。

    4. 「説明」列では、HelpPara要素ではなくPara要素を使用します。この列ではテキストをインデントしません。オプションまたは要素を詳しく説明します。説明しているUI要素以外のUI要素を参照する場合は、Bold強調表示を使用します。コード・スニペットまたはコード参照を指定する場合は、Code強調表示を適用します。

    5. 「説明」列に、ドキュメント・ライブラリの管理者ガイド、開発者ガイドおよびユーザー・ガイドにある概念説明のトピックに移動するための「詳細」インライン・リンクを追加し、これらのブックにある個々のタスク・トピックに移動するための「方法」インライン・リンクを追加します。他の情報用のインライン・リンクは追加しないでください。かわりに、以下で説明するように、これらのその他のリンクは「関連トピック」見出しの下に追加します。

    6. 「詳細」リンクおよび方法リンクをブックに挿入するには、Xulink要素を使用し、属性値にはolink:DOCID (例: olink:ASADM11113)を入力します。リンク設定の詳細は、オンライン・ヘルプの標準のTopicID値の適用およびブックへのリンクの追加に関する項を参照してください。

    7. 「要素」列と「説明」列の両方で、以下で説明するように、必要に応じてインライン・グラフィックを追加します。インライン・グラフィックは控えめに使用し、UIの概要を示すためや画面上のラベルのない要素を定義するために必要である場合にのみ使用します。状況依存オンライン・ヘルプでは、アイコンとボタンは必須ではありません。

    8. インライン・グラフィックの高さは22ピクセルに制限されています。高さが22ピクセルを超えるイメージを挿入すると、OHW/OHJヘルプJARでイメージが縮小されて歪んで表示されるため、そのようなイメージは挿入しないでください。イメージの幅のピクセルには具体的な制限はありませんが、導入文の段落では、列の半分よりも広い幅のイメージを挿入する方が見栄えがよくなります。

  3. インライン・グラフィックを挿入するには、次のガイドラインに従います。

    1. インライン・グラフィックを挿入する場所を選択します。

    2. 「要素」ウィンドウで、InlineGraphicを選択して「挿入」をクリックします。「新規要素の属性」ウィンドウが表示されます。

    3. AltText値を入力します。これは必須属性であり、テキストを入力しないとブックがエラーになります。「要素の挿入」をクリックします。「インポート」ダイアログが表示されます。

    4. グラフィック・フォルダからインポートするグラフィックを選択します。「インポート・グラフィックのスケーリング」ダイアログが表示されます。

    5. 72 dpiを選択します。「設定」をクリックします。グラフィックが挿入されます。

    6. スペースバーを使用して、1つのスペースを必要に応じてグラフィックの前または後ろに挿入し、イメージとテキストの間に1つのスペースがあるようにします。イメージとその前後のテキストの間には1スペースが必要です(語間のスペースと同じ)。行頭のイメージの前に余分なスペースを追加する必要はありません。

  4. RelatedTopics要素およびリンクを含めるには、次のガイドラインに従います。

    1. RelatedTopics要素はSect1要素内の最後の要素であり、必須です。これはテンプレートに含まれているため、挿入する必要はありません。

    2. RelatedTopics要素の下で使用できる唯一の子要素は、Para要素です。RelatedTopics要素の下には、テンプレートにすでに存在しているものに加えて複数のPara要素を追加できます。

    3. 言及した技術がインラインの「方法」リンクと「詳細」リンクで説明されていない場合は、それらに関するトピックを追加します。

    4. ドキュメント・ライブラリ内の章またはSect1への相互参照を追加します。

    5. ブックにリンクを挿入するには、Xulink要素を使用し、属性値にはolink:DOCID (例: olink:ASADM11113)を入力します。リンク設定の詳細は、オンライン・ヘルプの標準のTopicID値の適用およびブックへのリンクの追加に関する項を参照してください。

パターン・プロファイラは、任意の数の文字列属性でデータ値を分析し、文字タイプの順序に従ってパターンを割り当てます。たとえば、デフォルトのパターン・マップ参照リストを使用した場合、値「10 Lowestoft Lane」にはパターン「NN_aaaaaaaaa_aaaa」が割り当てられます。

注意:

デフォルトの*基本のトークン化マップは、かわりの*Unicodeの基本のトークン化マップや*Unicode文字パターン・マップと同様に、Latin-1エンコード・データで使用するように設計されています。これらのマップがデータの文字エンコーディングに適していない場合は、たとえばマルチバイトのUnicode (16進数)文字参照などを考慮に入れた新しいマップを作成して使用できます。

このプロファイラは次に、各属性で各パターンが出現した回数をカウントして、その結果を表示します。

パターン・プロファイラは、データのパターンを特定し、有効パターンと無効パターンの参照リストを作成するために使用します。この参照リストは、パターン・チェック・プロセッサを使用してデータを継続的に検証するために利用できます。

次の各表に、構成オプションを示します。

構成 説明

入力

データのパターンの分析対象にする文字列属性を指定します。

オプション

次のオプションを指定します。

  • 文字パターン・マップ: 各文字をパターン文字にマップします。参照データ(パターン生成カテゴリ)として指定します。デフォルト値は*「文字パターン・マップ」です。

デフォルトの標準パターン・マップでは、文字が次のようにマップされます。

文字の種類 パターンの表現

英字(a-zまたはA-Z)

a

数字(0-9)

N

句読点文字(セミコロン、カンマなど)

その文字のままで表されます。

制御文字(キャリッジ・リターンなど)

C

スペース

_

文字パターン・マップで認識されない文字は、各パターン内で疑問符(?)で表現されます。

必要に応じて、別の文字パターン・マップを使用して文字をマップできます。たとえば、「x」や「z」など出現頻度の低い文字は、出現頻度の高い文字とは異なる表現にできます。

構成 説明

出力

データ属性またはフラグ属性の出力を記述します。

データ属性

なし。

フラグ

次のフラグが出力されます。

  • [Attribute name].Pattern: 属性のパターンを示します。使用可能な値はパターン・マップ参照データで定義されたパターンです。

次の表に、このプロファイラによって分析される各属性ごとに生成される統計を示します。

統計 説明

パターン

各値に対して生成されたパターン。

長さ

生成された各パターンの長さ(つまり各値の文字数)。

カウント

パターンと一致した属性の値を含むレコードの数。

%

パターンと一致した属性の値を含むレコードのパーセンテージ。

この例では、パターン・プロファイラを使用して、顧客レコード表のすべての属性でパターンを分析します。各属性ごとに、次のタイプのビューが生成されます。

パターン 長さ カウント %

NN-NNNNN-aa

11

1681

84.0

N-NNNN-aa

10

310

15.5

aa-NNNNN-aa

11

4

0.2

NN-NNN-aa

9

2

<0.1

NN-N-aa

7

1

<0.1

NN-NNNNN-Na

11

1

<0.1

[Null]

10

1

<0.1

NN-NNNNN

9

1

<0.1

「カウント」列を基準にビューをソートすると、データ内で出現頻度が最も高いパターンと最も低いパターンをすばやく把握でき、有効パターンと無効パターンのリストを構築してパターン・チェックで使用できます。