最大/最小プロファイラ
このトピックは、セクションまたはタブのない単純なページ、ダイアログまたはその他のUIに使用します。ページ上のすべてのフィールドおよびオプションを説明する必要があります。
ヘルプ出力に正しく生成されるようにこのトピックを構成するには、次の手順を実行します。
-
Sect1要素を構成します。-
状況依存トピックを
Sect1として作成します。 -
簡単な名詞句と見出し形式の文体を使用して、状況依存トピックにUIの名前を反映したタイトルを付けます。ページ・タイトルには総称名詞を含めます。たとえば、プリファレンス・ページ、プリファレンス・ダイアログ、編集ウィンドウ、リソース・カタログなどです。これが移行中のトピックの場合は、以前と同じタイトルを使用します。
-
このトピックが目次に表示されないように、
HelpTOC属性をTopicOnlyに設定します。 -
UIの名前およびオプションで製品名が含まれるように、要素のサンプル
OutputFileName属性を変更します。たとえば、製品がOracle XYZサーバーで、UIが「プリファレンス」ダイアログの場合、この属性の値をcs_pagename1.htmからcs_preferences.htmまたはxyz_cs_preferences.htmなどに変更します。 -
ヘルプ・アイコン、ボタンまたはUIのtopicIDと一致するように、
HelpTopicID属性を変更します。Sect1トピックのHelpTopicID属性の値として、エンジニアから提供されたtopicIDを使用します。ヘルプを別の形式から変換する場合は、既存のHelpTopicIDを使用します。または、自分でtopicIDをトピックに割り当ててから、その割り当てたtopicIDをエンジニアに提供することもできます。重要なのは、FrameMakerでトピックに割り当てるtopicIDが、開発によってUI、ヘルプ・アイコンまたはボタンに割り当てられているtopicIDと一致していることを確認することです。
-
-
次のガイドラインに従って、
InformalTable要素を構成します。-
表の
Summary属性とTitle属性を適宜変更します。 -
HelpPara要素を使用して、ドキュメント化する必要があるUI内のすべての要素またはオプションを「要素」列に入力します。「要素」列では、UI要素を太字にしないでください。 -
「要素」列のテキストをインデントすることで、UI内に表示される要素をグループ化するには、
HelpPara要素のRole属性を編集します。左マージンからテキストをインデントするには、「Level1」を選択します。UIに表示されるオプションの構成を反映するように、必要に応じてLevel1、Level2、Level3およびLevel4を使用して最大4レベルまでインデントを設定できます。 -
「説明」列では、
HelpPara要素ではなくPara要素を使用します。この列ではテキストをインデントしません。オプションまたは要素を詳しく説明します。説明しているUI要素以外のUI要素を参照する場合は、Bold強調表示を使用します。コード・スニペットまたはコード参照を指定する場合は、Code強調表示を適用します。 -
「説明」列に、ドキュメント・ライブラリの管理者ガイド、開発者ガイドおよびユーザー・ガイドにある概念説明のトピックに移動するための「詳細」インライン・リンクを追加し、これらのブックにある個々のタスク・トピックに移動するための「方法」インライン・リンクを追加します。他の情報用のインライン・リンクは追加しないでください。かわりに、以下で説明するように、これらのその他のリンクは「関連トピック」見出しの下に追加します。
-
「詳細」リンクおよび方法リンクをブックに挿入するには、Xulink要素を使用し、属性値にはolink:DOCID (例: olink:ASADM11113)を入力します。リンク設定の詳細は、オンライン・ヘルプの標準のTopicID値の適用およびブックへのリンクの追加に関する項を参照してください。
-
「要素」列と「説明」列の両方で、以下で説明するように、必要に応じてインライン・グラフィックを追加します。インライン・グラフィックは控えめに使用し、UIの概要を示すためや画面上のラベルのない要素を定義するために必要である場合にのみ使用します。状況依存オンライン・ヘルプでは、アイコンとボタンは必須ではありません。
-
インライン・グラフィックの高さは22ピクセルに制限されています。高さが22ピクセルを超えるイメージを挿入すると、OHW/OHJヘルプJARでイメージが縮小されて歪んで表示されるため、そのようなイメージは挿入しないでください。イメージの幅のピクセルには具体的な制限はありませんが、導入文の段落では、列の半分よりも広い幅のイメージを挿入する方が見栄えがよくなります。
-
-
インライン・グラフィックを挿入するには、次のガイドラインに従います。
-
インライン・グラフィックを挿入する場所を選択します。
-
「要素」ウィンドウで、InlineGraphicを選択して「挿入」をクリックします。「新規要素の属性」ウィンドウが表示されます。
-
AltText値を入力します。これは必須属性であり、テキストを入力しないとブックがエラーになります。「要素の挿入」をクリックします。「インポート」ダイアログが表示されます。
-
グラフィック・フォルダからインポートするグラフィックを選択します。「インポート・グラフィックのスケーリング」ダイアログが表示されます。
-
72 dpiを選択します。「設定」をクリックします。グラフィックが挿入されます。
-
[Space]キーを使用して、必要に応じてグラフィックの前後にスペースを1つ挿入し、イメージとテキストの間にスペースが1つ入るようにします。イメージとその前後のテキストの間には、(単語間のスペースと同様に)スペースが1つ必要です。行頭のイメージの前に余分なスペースを追加する必要はありません。
-
-
RelatedTopics要素およびリンクを含めるには、次のガイドラインに従います。-
RelatedTopics要素はSect1要素内の最後の要素であり、必須です。これはテンプレートに含まれているため、挿入する必要はありません。
-
RelatedTopics要素の下で使用できる唯一の子要素は、Para要素です。RelatedTopics要素の下には、テンプレートにすでに存在しているものに加えて複数のPara要素を追加できます。
-
言及した技術がインラインの「方法」リンクと「詳細」リンクで説明されていない場合は、それらに関するトピックを追加します。
-
ドキュメント・ライブラリ内の章またはSect1への相互参照を追加します。
-
ブックにリンクを挿入するには、Xulink要素を使用し、属性値にはolink:DOCID (例: olink:ASADM11113)を入力します。リンク設定の詳細は、オンライン・ヘルプの標準のTopicID値の適用およびブックへのリンクの追加に関する項を参照してください。
-
最大/最小プロファイラは、各属性のデータの極値を調べて、次の値を返します。
-
最短値
-
最長値
-
最低値
-
最高値
最大/最小プロファイラは、最初にデータの概要を把握するために使用します。最大/最小プロファイラを使用すると、データがその長さや有効値の制限に準拠しているかどうかについて概要をすばやく把握できます。これにより、たとえば想定より大きい/小さい数値、想定より早い/遅い日付値、「#」などの無効な文字のみで構成されたテキスト値、「aaa」や「zzz」のような不正データなどの外れ値(明らかに範囲外の値)を検出できます。
次の表に、構成オプションを示します。
| 構成 | 説明 |
|---|---|
|
入力 |
データの最大値および最小値検出の対象にする属性を指定します。 |
|
オプション |
なし。 |
|
出力 |
データ属性またはフラグ属性の出力を記述します。 |
|
データ属性 |
なし。 |
|
フラグ |
次のフラグが出力されます。
|
最大/最小プロファイラでは、有益な統計を生成するためにレコードのバッチが必要です。したがって、処理が完了するまで結果が生成されないため、これはリアルタイム・レスポンスが必要なプロセスには適していません。
リアルタイム・データ・ソースからのトランザクションのバッチに対して実行した場合、リーダー・プロセッサで構成されたコミット・ポイント(トランザクションまたは制限時間)に到達すると処理が終了します。
次の表に、このプロファイラによって各属性ごとに生成される統計を示します。
| 統計 | 説明 |
|---|---|
|
最小長 |
属性の最短値の文字数。 |
|
最大長 |
属性の最長値の文字数。 |
|
最小値 |
属性の最低値。 数値属性の場合は、最小の数値です。 日付属性の場合は、最早日付です。 テキスト属性の場合は、アルファベット順の最初の値です。 この分析ではNull値は無視されますが、その他のタイプの非データ(たとえばスペースのみで構成された値)は無視されません。 |
|
最大値 |
属性の最高値。 数値属性の場合は、最大の数値です。 日付属性の場合は、最新日付です。 テキスト属性の場合は、アルファベット順の最後の値です。 この分析ではNull値は無視されますが、その他のタイプの非データ(たとえばスペースのみで構成された値)は無視されません。 |
「追加情報」ボタンをクリックすると、前述の統計とともに、最短値、最長値、最小値および最大値を含むレコードの数とパーセンテージが表示されます。
例
この例では、顧客レコード表のすべての属性に対して最大/最小プロファイラを実行しています。
表1-122 最大/最小プロファイラ
| 入力フィールド | 合計数 | 最小長 | 最大長 | 最小値 | 最大値 |
|---|---|---|---|---|---|
|
CU_NO |
2010 |
2 |
6 |
10 |
875825 |
|
CU_ACCOUNT |
2010 |
7 |
12 |
00-0-XX |
OO-24282-LR |
|
TITLE |
2010 |
1 |
12 |
1 |
The Reverend |
|
NAME |
2010 |
4 |
29 |
# ADAMS |
aaaaaaaaa |
|
GENDER |
2010 |
1 |
1 |
1 |
M |
|
BUSINESS |
2010 |
2 |
41 |
Stoke Newington Town Hall |
e-sites.co.uk |
|
ADDRESS1 |
2010 |
1 |
50 |
(Brassfounders) LD, Coursington Road |
kjhkg |
|
ADDRESS2 |
2010 |
1 |
31 |
WARRINGTON |
jhgfhj |
|
ADDRESS3 |
2010 |
1 |
22 |
Aberdeen |
jhvgj |
|
POSTCODE |
2010 |
1 |
8 |
1P1 3HS |
gjhgj |
|
AREA_CODE |
2010 |
1 |
4 |
0 |
2920 |
|
TEL_NO |
2010 |
1 |
7 |
1 |
4227051 |
|
電子メール |
2010 |
1 |
50 |
5 |
zoe.peckham@btopenworld.com |
|
ACC_MGR |
2010 |
2 |
3 |
22 |
WH |
|
DT_PURCHASED |
2010 |
5 |
10 |
01/01/1995 |
Brian |
|
DT_ACC_OPEN |
2010 |
5 |
10 |
01/01/1995 |
Brian |
|
DT_LAST_PAYMENT |
2010 |
19 |
19 |
01-Jan-1970 00:00:00 |
21-Mar-2004 00:00:00 |
|
DT_LAST_PO_RAISED |
2010 |
19 |
19 |
01-Jan-1970 00:00:00 |
14-Feb-2004 00:00:00 |
|
BALANCE |
2010 |
1 |
10 |
-999999 |
410.5 |