@GetDocField (式言語)

指定された一意の文書 ID から、その文書の特定のフィールドにある内容を返します。対象となる文書は、現在のデータベース内に存在していなければなりません。

構文

@GetDocField( documentUNID ; fieldName )

パラメータ

documentUNID

文字列。一意の文書 ID を指定します。現在の文書の一意の ID (UNID) を指定するには、@DocumentUniqueID を使用します。親文書の一意の ID を指定するには、$Ref をパラメータとして使用します。$Ref は返答文書上の特殊なフィールドの名前で、このフィールドに親の一意の ID が保存されています。

fieldName

文字列。文書のフィールド名を引用符で囲んで指定します。フィールド名を変数に保存する場合は、引用符は省略します。

戻り値

fieldValue

文字列または文字列リスト、数値または数値リスト、日時または日時の範囲。指定した文書のフィールドの内容が返されます。UNID またはフィールド名が無効のときは、Null が返されます。

使用法

この関数は、列式や選択式では使用できません。

例

主要トピックと返答文書が保存されているディスカッションデータベースがあるものとします。個々の返答に親文書の件名を保存するために、[OriginalSubject] というフィールドを使用します。メイントピックの件名が変更されたら [OriginalSubject] フィールドが変更されるように、次の式を記述します。[$Ref] は返答文書の特別なフィールドで、親文書のユニーク ID が格納されています。
```
@If(@IsNewDoc; Subject; @GetDocField($Ref; "Subject"))
```
次の式では、指定された親文書に基づいて子文書の内容を更新する定期エージェントが実行されます。
```
FIELD Project:=@GetDocField($Ref; "Project");
@All
```
次の式では、定期エージェントが実行され、ある文書の内容に基づいて別の文書の内容が更新されます。2 つの文書が親子関係にある必要はありません。例えば、2 つとも親文書でも、2 つとも子文書でも構いません。
```
FIELD Body:=@GetDocField("BB791838F30B20ED852567BA0064DDAF"; "Body");
@All
```

クロスリファレンス

LotusScript® NotesUIDocument クラスの FieldGetText メソッド

LotusScript NotesDocument クラスの GetItemValue メソッド

Java™ Document クラスの getItemValue メソッド