Lotus Domino Designer 8 ヘルプ

式言語

@Abstract
例

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

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

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

構文@Abstract( [ keywords ] ; size ; beginText ; bodyFields )
パラメータ[ keywords ]

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

size

数値。要約文字列の最大サイズを指定します。必ず 64,994 バイト以下で指定します。要約文字列に使えるバイト数は、

size

から 1 を引いたバイト数です。1 バイトは内部使用のために予約されています。

beginText

文字列。返される文字列の先頭に挿入されるコメントで、10 文字以下で指定します。

beginText

のサイズは要約文字列の合計の

size

に数えられますが、内容は @Abstract コマンドの処理対象ではありません。コメントが必要ないときは空の文字列 ("") を指定します。

bodyFields

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

注意リッチテキストフィールドは、保存されるまでは文書の一部ではありません。@Abstract で現在の文書に対する追加や変更も処理したいときは、必ず文書を保存してから再計算します。@Abstract では、ビュー列のリッチテキストをテキストに変換できません。

戻り値abstractedText

文字列。各本文フィールドに含まれている文字列で、

commands

で指定したとおりに省略されソートされています。

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

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

[COUNTWORDS]

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

[SAVE]

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

[RESTORE]

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

[TRYFIT]

現在の文字列を調べて、指定されている

size

に収まる長さまで短くなったかどうかを判定します。短くなっていれば、現在の文字列を返して処理を中止します。残りのコマンドは無視します。短くなっていなければ、次のキーワードの処理に進みます。

[SORTCHUNKS]

文字列を重要度に従ってソートします。文字列は 3 種類のチャンクに分割されます。文字列、メールヘッダー、分離記号です。

文字列チャンクは通常、文です。段落の最初、最後、中間にあります。
メールヘッダーチャンクは、メールヘッダーファイル (「ファイル」参照) の内容に従って作成されます。
分離記号チャンクは、文字や数字以外の文字列で構成されています。

チャンクの重要度は、そのチャンク内の単語の重要度、チャンク内の単語数、チャンクの種類と位置で決まります。[SORTCHUNKS] を使うときは、必ず [COUNTWORDS] も使います。

[ABBREV]

文字列を省略します。@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]

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

[TRIMPUNCT]:

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

[SAVE]:

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

[ABBREV]:[TRYFIT]:

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

[RESTORE]:

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

[SAVE]:

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

[DROPVOWELS]:[ABBREV]:[TRYFIT]:

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

[RESTORE]:

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

[COUNTWORDS]:[SORTCHUNKS]:[ABBREV]

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

メールヘッダーと分離記号を削除して文字列が希望サイズに収まったら、文字列はその状態で返されます。最初の省略処理によって文字列が希望サイズに収まったときは、返される文字列の先頭にはマイナス記号 (-) が付きます。2 番目の省略処理で文字列が希望サイズに収まったときは、返される文字列の先頭にはプラス記号 (+) が付きます。単語を数えてチャンクをソートしたときは、文字列の先頭にはアスタリスク記号 (*) が付き、文の間は並び替えを示す記号 (|) で区切られます。

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

[TRIMPUNCT]:[ABBREV]

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

[TEXTONLY]:[TRYFIT]:

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

[TRIMPUNCT]:

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

[SAVE]:

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

[ABBREV]:[TRYFIT]:

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

[RESTORE]:

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

[DROPVOWELS]:

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

[SAVE]:

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

[ABBREV]:[TRYFIT]:

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

[RESTORE]:

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

[COUNTWORDS]:[SORTCHUNKS]:[ABBREV]

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

単語を数えてチャンクをソートしたときは、返される文字列の先頭にはアスタリスク記号 (*) が付き、文の間は並び替えを示す記号 (|) で区切られます。

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

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

telephone ph

number no

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

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

省略語が小文字に変換されることはありませんが、大文字に変換されることはあります。

指定した省略語	元の単語	結果の省略語	説明
Phone	telephone	Phone	元の単語が小文字なので、省略語の大文字と小文字は指定した通りとなります。
Phone	TElephone	PHONE	省略語の大文字と小文字は元の単語の大文字と小文字に基づいて変換されます。
Phone	Telephone	Phone	省略語の大文字と小文字は元の単語の大文字と小文字に基づいて変換されます。
PHONE	Telephone	PHONE	省略語は大文字で指定されているので、常に大文字となります。
Phone	tElephone	PHONE	省略語の最初の文字は大文字だったのでそのままになります。省略語の残りの文字は元の単語の 2 つ目の文字に合わせて大文字に変換されます。

重要語 (notesigl.txt)

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

client

boss

chocolate

非重要語 (notestop.txt)

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

the

および

メールヘッダー (notehead.txt)

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

Subject*

From

クロスリファレンスLotusScript NotesItem クラスの Abstract メソッド
Java Item クラスの abstractText メソッド

LotusScript NotesRichTextItem クラスの GetFormattedText メソッド

Java RichTextItem クラスの getFormattedText メソッド

"Displaying contents of rich text fields in a view" on Tips from the Lotus Developer Domain

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

用語集

フィードバック ヘルプ または プロダクトユーザビリティ?

ヘルプの使い方

すべてのヘルプ項目

用語集