@SetProfileField (式言語)

プロフィール文書のフィールド値を設定するか、プロフィール文書を作成します。

構文

@SetProfileField( profilename ; fieldname ; value ; uniqueKey )

パラメータ

profilename

文字列。アクセスするフィールドが含まれているプロフィール文書の名前です。指定した名前のプロフィール文書がない場合は、新たに作成されます。

fieldname

文字列。アクセスするフィールドの名前です。

value

文字列、数値、日時、日時の範囲、または日時の範囲のリスト。フィールドに設定する値です。

uniqueKey

文字列。オプション。プロフィール文書を識別する一意のキーです。

戻り値

value

フィールドに設定した値が返されます。

使用法

この関数は、Web アプリケーション内でプロフィール文書を作成するときに使用します。EditProfile @コマンドは Web では機能しません。この関数の最初のパラメータで指定した名前の文書が存在しない場合は、その名前のプロフィール文書が作成されます。プロフィール文書のデータにアクセスするには、@GetProfileField を使用します。

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

  1. 次の例は、「Interest Profile」文書の [Profile Categories] フィールドの内容を現在のプラットフォームの名前に設定します。
    @SetProfileField("Interest Profile";
    "ProfileCategories"; @Platform) 
  2. 次の例は、現在のユーザーの「Interest Profile」文書の [Profile Categories] フィールドの内容を、現在のプラットフォームの名前に設定します。
    @SetProfileField("Interest Profile"; 
    "ProfileCategories"; @Platform; @UserName) 
  3. 次のコードを Web アプリケーションの [Set Profile Field] アクションボタンに追加すると、webProfile というプロフィール文書が新たに作成され、[fname] というフィールドが作成されます。この [fname] フィールドには、現在の文書の [fname] フィールドと同じ値が設定されます。
    @SetProfileField("webProfile";"fname";fname)

クロスリファレンス

LotusScript NotesUIWorkspace クラスの EditProfile メソッド