等しい属性プロファイラ

このトピックは、セクションまたはタブのない単純なページ、ダイアログまたはその他の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に表示されるオプションの構成を反映するように、必要に応じてLevel1、Level2、Level3および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. [Space]キーを使用して、必要に応じてグラフィックの前後にスペースを1つ挿入し、イメージとテキストの間にスペースが1つ入るようにします。イメージとその前後のテキストの間には、(単語間のスペースと同様に)スペースが1つ必要です。行頭のイメージの前に余分なスペースを追加する必要はありません。

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

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

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

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

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

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

等しい属性プロファイラは、複数の属性があるレコードで、値が等しい頻度が高い属性のペアを検索します。たとえば、 FirstName属性とGivenName属性の両方が格納されている場合、これらの値は通常は同じです。しきい値オプションを使用して、各属性の値が同一であるケースのパーセンテージに基づき、属性のペアに関連があるかどうかを判断します。

等しい属性プロファイラは、冗長である可能性がある属性、または、通常は値が等しいが異なる場合もある属性のペアを見つけるために使用します。等しい属性プロファイラは、関連する2つの属性で、その2つの値が相互に関連している必要があるが実際には関連していない誤ったデータを検索する場合にも役立ちます。

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

構成	説明
入力	等価属性の関連性の調査対象にする属性を指定します。
オプション	指定できるオプションを記述します。
等しい属性のしきい値	2つの属性に関連があるとみなされて結果に表示されるために必要な、2つの属性の値の同一率を制御します。パーセントで指定します。デフォルトは80%です。指定できる値は、50%以上、100%以下です。
nullを等しいものとして処理しますか。	Null値のペアを等しいとみなすかどうか、つまり、前述の等しい属性のしきい値を評価する際に対象とするかどうかを制御します。「はい」または「いいえ」で指定します。デフォルトは「はい」です。
出力	データ属性またはフラグ属性の出力を記述します。
データ属性	なし。
フラグ	なし。

等しい属性プロファイラでは、統計を生成するためにレコードのバッチが必要です。つまり、属性のペアに意味のある関係があることを検出するには、完了まで実行される必要があります。したがって、データ・セット全体が処理されるまで結果が生成されないため、このプロセッサはリアルタイム・レスポンスが必要なプロセスには適していません。

リアルタイム・データ・ソースからのトランザクションのバッチに対して実行した場合、リーダー・プロセッサで構成されたコミット・ポイント(トランザクションまたは制限時間)に到達すると処理が終了します。

等しい属性プロファイラでは、値が等しい場合のパーセンテージが高い属性のペアについてサマリー・ビューが表示されます。次の表に、関連する(等しい)属性の各ペアに関する統計を示します。

統計	説明
等しい	関連する両方の属性の値が同じであるレコードの数。
Nullペア	関連する両方の属性の値がnullであるレコードの数。 注意: 「nullを等しいものとして処理しますか。」オプションを選択した場合は、nullのペアが「等しい」統計に含まれるため、この統計はゼロになります。
等しくない	関連する属性の値が同じでないレコードの数。

「追加データ」ボタンをクリックすると、前述の統計が、分析対象レコードに対するパーセンテージとして表示されます。

属性のペアが完全に一致したレコードの数をドリルダウンすると、一致した各値の出現頻度の明細が表示されます。再度ドリルダウンすると、当該のレコードが表示されます。

あるいは、属性のペアが等しくないレコードの数をドリルダウンすると、当該のレコードが直接表示されます。属性の間に関係が存在する必要がある場合、それらのレコードでは関係が壊れています。

例

この例では、デフォルト構成を使用して顧客表を分析し、相互に等しい頻度が高い属性があるかどうかを調べます。等しい属性プロファイラは、DT_PURCHASED属性とDT_ACC_OPEN属性が通常は等しいことを検出しています。

フィールド1	フィールド2	等しい	Nullペア	等しくない
DT_PURCHASED	DT_ACC_OPEN	1983	16	11

2つのフィールドが等しいレコードの数をドリルダウンすると、値が等しいすべてのペアを表示できます。

DT_ACC_OPEN	DT_PURCHASED	カウント
03/02/1997	03/02/1997	5
30/11/1993	30/11/1993	4
09/08/1996	09/08/1996	4
10/09/1993	10/09/1993	4
07/12/1992	07/12/1992	4
07/08/1996	07/08/1996	4
25/05/1993	25/05/1993	4
24/02/1994	24/02/1994	4
21/11/1996	21/11/1996	4
17/12/1996	17/12/1996	4
13/11/1992	13/11/1992	4
27/08/1992	27/08/1992	4
05/10/1992	05/10/1992	4
27/09/1992	27/09/1992	3