文書内のフィールドに値を割り当てます (一時変数に割り当てる場合は @Set を使用します)。これは FIELD キーワードと似ていますが、@SetField の場合は別の @関数に埋め込むことができます。フィールドが存在しない場合はフィールドが作成され、指定した値が設定されます。

構文

@SetField( fieldName ; value )

パラメータ

fieldName

値を割り当てるフィールドの名前を引用符で囲んで指定します。

文字列、数値、日時、日時の範囲、または日時の範囲のリスト。fieldName に渡す値を指定します。

この関数は、エージェント、ホットスポットボタン、アクション、ツールバーボタンで使用すると最も効果的です。列式、選択式、非表示切り替え式、ウィンドウタイトル式、フォーム式では使用できません。

Release 6 では、@SetField で値を割り当てる前にフィールドを宣言する必要がなくなりました。R5 以前のクライアントでは、次のように式の先頭でフィールドを宣言します。

FIELD Fieldname:=Fieldname;

指定する値はどのようなものでもよく、フォーム上で定義されたフィールドの種類と一致している必要はありません。この関数によって、既存のフィールド上のフラグがリセットされたり、新しく保存されたフィールドにフラグが設定されたりすることはありません。たとえば、文字列の値を割り当てることによって、[Readers] フィールドがプレーンテキストになることはありません。また、新しく保存したフィールドを [Readers] フィールドにすることはできません。LotusScript および Java のクラスでは、NotesItem および Item を使用してこの操作を行うことができます。

クロスリファレンス

LotusScript NotesUIDocument クラスの FieldSetText メソッド

LotusScript NotesDocument クラスの ReplaceItemValue メソッド

Java Document クラスの replaceItemValue メソッド

例
関連項目

@Set
LotusScript のクラスで現在の文書にアクセスする
現在の文書に式言語でアクセスする
@SetEnvironment

用語集