Link オブジェクト

Link オブジェクトは、不具合と別のエンティティ間の関連付けを表します。

LinkFactory オブジェクトから Link オブジェクトを取得します。

公開メソッド

このオブジェクトは次のメソッドをサポートします。

メソッド 説明

LockObject

オブジェクトをロックします。オブジェクトがサーバ上で変更されている場合は True を返します。

詳細については、LockObjectを参照してください。

Post

変更されたすべての値をデータベースに送信します。

詳細については、 Postを参照してください。

Refresh

保存された値を読み取り、メモリ内の値を上書きします。

詳細については、 Refreshを参照してください。

Undo

未送信のフィールド値の変更を元に戻します。

詳細については、 Undoを参照してください。

UnLockObject

オブジェクトのロックを解除します。

詳細については、UnLockObjectを参照してください。

公開プロパティ

このオブジェクトは次のプロパティをサポートします。

プロパティ R/W 説明

AutoPost

R/W ブール値

true の場合、フィールド値が変更されるとデータベースがすぐに更新されます。

AutoUnlock

R/W ブール値

Refresh または Post 後にアイテムを他のユーザが自動的に変更できるようにするかどうかを示します。

Comment

R/W 文字列

リンクの要約コメント。

CreatedBy

R/W 文字列

リンクを作成したユーザ。

CreationDate

R/W 日付

リンクの作成日。

Field

R/W 任意

指定されたフィールドの値。

構文:Link.Field[fieldName]

ここで、fieldName はプロジェクト・データベース内のフィールドの名前です。すべて大文字を使用してください。

FieldMultiValue

R/W オブジェクト

指定されたフィールドの MultiValue オブジェクト。MultiValue オブジェクトを参照してください。

構文:Link.FieldMultiValue[fieldName]

ここで、fieldName はプロジェクト・データベース内のフィールドの名前です。すべて大文字を使用してください。

ID

R 数値

項目 ID。

IsLocked

R ブール値

オブジェクトが編集用にロックされているかどうかを確認します。

IsLocked は LockObject メソッドによって設定され、UnlockObject メソッドによってリセットされます。

オブジェクトに AutoUnlock プロパティがあり、そのプロパティが True に設定されている場合、IsLocked も Post または Refresh 操作によってリセットされます。

LinkedByEntity

R オブジェクト

リンクを開始したエンティティ・オブジェクト。

  • 不具合以外のエンティティから不具合へのリンクの場合、LinkedByEntity にはリンクを作成したエンティティが表示されます。

    たとえば、テストと不具合間のリンクは、テスト・インスタンスまたはステップによって作成されている可能性があります。テストと不具合の間のリンクを作成したオブジェクトは、LinkedByEntity になります。

  • 2 つの不具合間のリンクの場合、このプロパティは意味を持ちません。

LinkType

R/W 文字列

リンクのタイプ。

Modified

R ブール値

最後の Refresh または Post 操作以降に項目が変更されたかどうかを確認します。true の場合、サーバ側のフィールド・プロパティが最新ではありません。

SourceEntity

R オブジェクト

リンクのソース・エンティティ・オブジェクト。

SourceEntity と TargetEntity は、関連付けの固定属性ではありません。これらは、Link オブジェクトが取得されるファクトリの視点が反映されます。SourceEntity と TargetEntity は、特定の関連付けの同じ 2 つのオブジェクトです。ただし、リンク・オブジェクトに応じて、どれがソースでどれがターゲットかが変わる場合があります。

たとえば、テストと不具合の関連をテスト側から見た場合、つまり、Test.BugLinkFactory から Link オブジェクトを取得する場合、SourceEntity はテストであり、TargetEntity は不具合です。同じ関連付けを表す Link オブジェクトが Bug.LinkFactory から取得された場合、SourceEntity は不具合であり、TargetEntity はテストです。

TargetEntity

R/W オブジェクト

リンクのターゲット・エンティティ・オブジェクト。

SourceEntityを参照してください。

TypeName

R 文字列

フィールドのタイプ。

Virtual

R ブール値

これが仮想項目、つまり対応するデータベース・レコードを持たない項目であるかどうかを確認します。

先頭に戻る