次の方法でフィールドの内容を省略します。

• 文字列本体の最も重要度が高い単語を選択する
• 一般的な単語を省略する
• 単語から母音を削除する
• メールヘッダーや空白など不必要な文字列または文字を削除する

この関数は、シングルバイト文字セットでのみ使用できます。

構文

@Abstract( [ keywords ] ; size ; beginText ; bodyFields )

パラメータ

[ keywords ]

文字列を省略してソートする方法を指定するキーワードをいくつでも指定できます (「キーワード」参照)。キーワードは指定した順序で実行されます。各キーワードは角カッコで囲み、複数指定するときは 次のようにコロンで区切ります。[DROPVOWELS]:[NOTRIMWHITE]:[ABBREV].

数値。要約文字列の最大サイズを指定します。必ず 64,994 バイト以下で指定します。要約文字列に使用できるバイト数は、size から 1 を引いたバイト数です。1 バイトは内部使用のために予約されています。

文字列。返される文字列の先頭に挿入されるコメントで、10 文字以下で指定します。beginText のサイズは要約文字列の合計の size に数えられますが、内容は @Abstract コマンドの処理対象ではありません。コメントが必要ないときは空の文字列 ("") を指定します。

文字列または文字列リスト。要約対象の文字列を含むフィールドで、いくつでも指定できます。テキストフィールド、リッチテキストフィールド、キーワードフィールドを指定します。各フィールド内の文字列は指定した順序で空白を使用して結び付けられます。指定した名前のフィールドが見つからないときは、代わりに文字列リテラルが使用されます。各フィールド名は引用符で囲み、フィールド名が複数あるときは、各フィールド名をコロンで次のように区切ります。"Sales":"Figures"。

戻り値

abstractedText

文字列。各本文フィールドに含まれている文字列で、commands で指定したとおりに省略されソートされています。

以下のキーワードを @Abstract で使用できます。

[TEXTONLY]

文字列からメールヘッダーと分離記号のチャンクを削除します。

文字列内の各単語の重要度を計算します。単語の重要度は、文字列に現れる頻度で決まります。重要語ファイル (「ファイル」参照) に含まれている単語は、その重要度が増します。非重要語ファイル (「ファイル」参照) に含まれている単語は、重要度がありません。

文字列を現在の状態で保存します。保存された文字列を復元するには、[RESTORE] キーワードを使用します。

現在の文字列を破棄し、直前に保存された文字列を復元します。保存されている文字列を復元できるのは一度だけです。これまでに保存されている文字列がなければ、このキーワードは無効です。

現在の文字列を調べ、指定されているサイズに収まる長さまで短くなったかどうかを判定します。短くなっていれば、その時点での変更が反映された現在の文字列を返して処理を中止します。残りのコマンドは無視されます。短くなっていなければ、次のキーワードの処理に進みます。

文字列を重要度に従ってソートします。文字列は 3 種類のチャンクに分割されます。文字列、メールヘッダー、分離記号です。
• 文字列チャンクは通常、文です。段落の最初、最後、中間にあります。
• メールヘッダーチャンクは、メールヘッダーファイル (「ファイル」参照) の内容に従って作成されます。
• 分離記号チャンクは、文字や数字以外の文字列で構成されています。
チャンクの重要度は、そのチャンク内の単語の重要度、チャンク内の単語数、チャンクの種類と位置で決まります。[SORTCHUNKS] を使用するときは、必ず [COUNTWORDS] も使用します。

文字列を省略します。@Abstract は、省略辞書を使用して文字列内の単語を省略語で置換します (「ファイル」参照)。次のコマンドを使用して、短縮処理を他の方法で制御できます。これらのコマンドは、[ABBREV] キーワードの前以外の場所では無効です。

[USEDICT]

省略辞書を使用するよう指定します。これはデフォルトです。

[NODICT]

省略辞書を使用しないよう指定します。

[KEEPVOWELS]

単語の母音を残します。これはデフォルトです。

[DROPVOWELS]

単語から母音を削除します。母音で始まる単語の最初の母音は削除されません。[DROPVOWELS] を使用するとき、次のサブコマンドの 1 つを使用できます (省略可能)。


[DROPFIRSTVOWEL]

単語の先頭の母音を削除します。

[KEEPFIRSTVOWEL]

単語の先頭にある母音は残します。これはデフォルトです。


[TRIMWHITE]

文字列から余分な空白を削除します。これはデフォルトです。

[NOTRIMWHITE]

文字列の余分な空白を残します。

[TRIMPUNCT]

分離記号を囲む余分な空白を削除します。

[NOTRIMPUNCT]

分離記号を囲む余分な空白を残します。

[NOSTOPLIST]

非重要語リスト (notestop.txt) を無効にします。

[NOSIGLIST]

重要語リスト (notesigl.txt) を無効にします。

@Abstract で使用できる組み込みのプログラムには、[Rule1]、[Rule2]、[Rule3] の 3 種類があります。

[RULE1] は、次のコマンドで構成されていて、この順序で実行されます。

[TEXTONLY]:[TRYFIT]

メールヘッダーチャンクと分離記号チャンクをすべて削除します。文字列が指定サイズに収まれば関数の処理は終了します。そうでなければ、処理を続行します。

分離記号を囲む空白を削除します。

文字列を現在の状態で保存します。

文字列を省略します。文字列が指定サイズに収まれば関数の処理は終了します。そうでなければ、処理を続行します。

文字列を省略する前の状態に復元します。

文字列を現在の状態で保存します。

文字列を母音を削除して省略します。文字列が指定サイズに収まれば関数の処理は終了します。そうでなければ、処理を続行します。

文字列を省略する前の状態に復元します。

単語を数えてチャンクをソートします。文字列を省略して返します。

[RULE2] では、次のコマンドが発行されます。

[TRIMPUNCT]:[ABBREV]

[RULE3] では、次のコマンドが発行されます。

[TEXTONLY]:[TRYFIT]:

メールヘッダーチャンクと分離記号チャンクをすべて削除します。文字列が指定サイズに収まれば関数は終了します。そうでなければ、処理を続行します。

分離記号を囲む空白を削除します。

文字列を現在の状態で保存します。

文字列を省略します。文字列が指定サイズに収まれば関数は終了します。そうでなければ、処理を続行します。

文字列を省略する前の状態に復元します。

文字列を母音を削除して省略します。

文字列を現在の状態で保存します。

文字列が指定サイズに収まれば関数は終了します。そうでなければ、処理を続行します。

文字列を省略する前の状態に復元します。

単語を数えてチャンクをソートします。文字列を省略して返します。

ファイル

@Abstract では、次のファイルが使用されます。@Abstract の使い方に応じて、これらのテキストファイルをすべてまたは一部作成します。まったく作成しないこともあります。ファイルを作成する場合は、次に示す通りに名前を付けて、ソフトウェアを起動する前に Notes/Data ファイルパスに置く必要があります。

省略辞書 (noteabbr.txt)

ファイルの各行には 2 つの単語が必要です。最初の単語は元の単語、2 つ目の単語はその省略語です。省略語は、元の単語よりも短くなければなりません。たとえば、

telephone ph

number no

大文字への変換は次のように行われます。

• 大文字で省略するよう指定されているときは、常に大文字で表示されます。
• 元の単語が小文字で表示されているときは、省略辞書の指定どおりに表示されます。
• 元の単語に大文字のみが使用されているか、大文字と小文字が混在しているときは、省略語は大文字で表示されます。
• 省略語の最初の文字が小文字のときは、元の単語の最初の文字に合うよう必要に応じて大文字に変換されます。
• 省略語の残りの文字は、元の単語の 2 つ目の文字に合うよう必要に応じて大文字に変換されます。

このファイルには、「urgent」や「immediately」などの重要な単語を自由形式でリストします。@Abstract が文字列の重要度を計算するときは、重要語リストに含まれている単語の重要度が高くなります。たとえば、

client

boss

chocolate

このファイルには、「the」、「and」、「of」などの常に重要ではない単語を自由形式でリストします。@Abstract が文字列の重要度を計算するとき、このファイルに含まれている単語はすべて無視されます。たとえば、

the

および

of

このファイルには、「Subject」、「From」、「To」などメールヘッダーを表す単語を自由形式でリストします。チャンクがメールヘッダーと見なされるには、チャンクがこのファイルで指定されている単語のいずれかで始まり、そのすぐ後ろにコロンと空白がなければなりません。メールヘッダーが重要と見なされるようにするには、その単語の後ろにアスタリスクを付けます。たとえば、

Subject*

From

LotusScript NotesItem クラスの Abstract メソッド

Java Item クラスの abstractText メソッド

LotusScript NotesRichTextItem クラスの GetFormattedText メソッド

Java RichTextItem クラスの getFormattedText メソッド

例
関連項目

リッチテキストフィールド
@AbstractSimple

用語集