様々なパラメータを Rational® ClearCase® に提供して、トリガ タイプの操作方法を指定することができます。ICCTriggerTypeBuilder インターフェイスにより、クライアント コードに 1 つ以上のパラメータを設定して、Create メソッドを使用して新規トリガ タイプを作成するか、Replace メソッドを使用して既存のトリガ タイプを置換することができます。
トリガ タイプの起動順序を取得および設定します。これは操作の前 (pre-op) か後 (post-op) になります。
このトリガ タイプのアクションの配列と値のペア (タイプに 1 つか 2 つの値が付加されたもの) を取得します
読み取り専用プロパティ
Property ActionsArray As Variant
_variant_t GetActionsArray();
CCTriggerActionType 値を含むバリアントの配列。配列指標を使用して、RemoveAction のアクションを指定し、削除します。
文字列の実行アクションを追加します
メソッド
Sub AddExecAction(Action As String)
HRESULT AddExecAction(_bstr_t Action);
Linux または UNIX システムで実行する文字列の実行アクションを追加します
メソッド
Sub AddExecUNIXAction(Action As String)
HRESULT AddExecUNIXAction(_bstr_t Action);
Windows システムで実行する文字列の実行アクションを追加します
メソッド
Sub AddExecWinAction(Action As String)
HRESULT AddExecWinAction(_bstr_t Action);
属性の作成アクションを追加します
メソッド
Sub AddMkattrAction(pAttributeType As CCAttributeType, Value As Variant)
HRESULT AddMkattrAction( ICCAttributeType* pAttributeType, const _variant_t& Value);
ハイパーリンクの「接続元」の作成アクションを追加します
メソッド
Sub AddMkhlinkFromAction(pHyperlinkType As CCHyperlinkType, FromPath As String)
HRESULT AddMkhlinkFromAction( ICCHyperlinkType* pHyperlinkType, _bstr_t FromPath);
ハイパーリンクの「接続先」の作成アクションを追加します
メソッド
Sub AddMkhlinkToAction(pHyperlinkType As CCHyperlinkType, ToPath As String)
HRESULT AddMkhlinkToAction( ICCHyperlinkType* pHyperlinkType, _bstr_t ToPath);
ラベルの作成アクションを追加します
メソッド
Sub AddMklabelAction(pLabelType As CCLabelType)
HRESULT AddMklabelAction(ICCLabelType* pLabelType);
新規トリガ タイプを作成します
メソッド
Function Create([ Comment As String ="" ]) As CCTriggerType
ICCTriggerTypePtr Create(_bstr_t Comment);
トリガ タイプ ビルダーを使用してトリガ タイプを作成する前に、1 つ以上の操作と、1 つ以上のアクションが必要であり、名前が設定されていなければなりません。さらに、タイプ トリガには 1 つ以上の制限が必要です。
トリガの起動時にデバッグの印刷が起きるかどうかを取得および設定します
読み取り書き込みプロパティ
Property DebugPrinting As Boolean
VARIANT_BOOL GetDebugPrinting(); void PutDebugPrinting(VARIANT_BOOL NewDebugPrinting);
DebugPrinting はデバッグ目的としてのみ使用されます。デバッグ出力は stdout に入れられます。出力を参照するには、コマンド行からトリガをテストする必要があります。デバッグが完了したなら、トリガの起動時に混乱が生じないよう、デバッグ出力を無効にしておいてください。
次のメンバー: ICCTriggerTypeBuilder インターフェイス
このトリガ タイプを起動しないユーザーを取得および設定します
読み取り書き込みプロパティ
Property ExemptUsersStringArray As Variant
_variant_t GetExemptUsersStringArray(); void PutExemptUsersStringArray(const _variant_t& NewExemptUsersStringArray);
文字列値を含むバリアントの配列は、このトリガ タイプのトリガの起動から除外されているユーザーの名前を表わします。
このトリガ タイプを起動する操作の種類を追加します
メソッド
Sub FireOn(OperationKind As CCTriggerOperationKind)
HRESULT FireOn(CCTriggerOperationKind OperationKind);
トリガ タイプの起動順序を取得および設定します。これは操作の前 (pre-op) か後 (post-op) になります。
読み取り書き込みプロパティ
Property Firing As CCTriggerFiring
CCTriggerFiring GetFiring(); void PutFiring(CCTriggerFiring NewFiring);
このタイプのトリガ タイプのタイプ包含リストに項目を追加します
メソッド
Sub IncludeOn(InclusionType As Variant)
HRESULT IncludeOn(const _variant_t& InclusionType);
このタイプ トリガ タイプの包含リストを取得します
読み取り専用プロパティ
Property InclusionsArray As Variant
_variant_t GetInclusionArray();
包含オブジェクト リストを表すバリアントの配列。これには、CCTriggerTypeAll 値、オブジェクト ポインタ、または文字列値があります。特定の種類のすべてのメタデータ タイプ (例えば、すべての属性タイプ) については CCTriggerTypesAll 値が、特定のメタデータ タイプ (例えば、特定の CCAttributeType) についてはオブジェクト ポインタが、または特定のエレメント タイプ (例えば、"text_file") の名前については文字列値が戻されます。
このトリガ タイプのトリガの種類を取得および設定します
読み取り書き込みプロパティ
Property KindOfTrigger As CCKindOfTrigger
CCKindOfTrigger GetKindOfTrigger(); void PutKindOfTrigger(CCKindOfTrigger NewKind);
このトリガ タイプの名前を取得および設定します
読み取り書き込みプロパティ
Property Name As String
_bstr_t GetName(); void PutName(_bstr_t NewName);
ICCTriggerTypeBuilder インターフェイスを使用して、トリガの名前を変更することはできません。いったんトリガ タイプ ビルダーの名前を設定すると、そのビルダーを使用してのみ、新規トリガ タイプを作成することができ、既存のものを置換しないようにすることができます。
次のメンバー: ICCTriggerTypeBuilder インターフェイス
このトリガ タイプのアクションの数を取得します
読み取り専用プロパティ
Property NumberOfActions As Long
long GetNumberOfActions();
このトリガ タイプを起動しないユーザーの数を取得します
読み取り専用プロパティ
Property NumberOfExemptUsers As Long
long GetNumberOfExemptUsers();
含まれているこのタイプ トリガ タイプの数を取得します
読み取り専用プロパティ
Property NumberOfInclusions As Long
long GetNumberOfInclusions();
このトリガ タイプを起動する操作の種類の数を取得します
読み取り専用プロパティ
Property NumberOfOperationKinds As Long
long GetNumberOfOperationKinds();
このエレメント トリガ タイプの制限の数を取得します
読み取り専用プロパティ
Property NumberOfRestrictions As Long
long GetNumberOfRestrictions();
このトリガ タイプを起動する操作の種類の配列を取得します
読み取り専用プロパティ
Property OperationKindsArray As Variant
_variant_t GetOperationKindsArray();
CCTriggerOperationKind 値を含むバリアントの配列。
トリガの起動アクションから番号付きのアクションを削除します
メソッド
Sub RemoveAction(Index As Long)
HRESULT RemoveAction(long Index);
このタイプのトリガ タイプのタイプ包含リストから項目を削除します
メソッド
Sub RemoveInclusion(InclusionType As Variant)
HRESULT RemoveInclusion(const _variant_t& InclusionType);
この種類の操作で起動しないトリガ タイプを設定します
メソッド
Sub RemoveOperationKind(OperationKind As CCTriggerOperationKind)
HRESULT RemoveOperationKind(CCTriggerOperationKind OperationKind);
このエレメント トリガ タイプのタイプ制限リストから項目を削除します
メソッド
Sub RemoveRestriction(RestrictionType As Variant)
HRESULT RemoveRestriction(const _variant_t& RestrictionType);
このトリガ タイプ ビルダーによって表されるトリガ タイプを再定義します
メソッド
Function Replace([ Comment As String = "" ]) As CCTriggerType
ICCTriggerTypePtr Replace(_bstr_t Comment);
トリガ タイプは、置換される前に存在している必要があります。
ICCTriggerTypeBuilder インターフェイスを使用して、トリガの名前を変更することはできません。いったんトリガ タイプ ビルダーの名前を設定すると、そのビルダーを使用してのみ、新規トリガ タイプを作成することができ、既存のものを置換しないようにすることができます。
このエレメント トリガ タイプのタイプ制限リストに項目を追加します
メソッド
Sub RestrictBy(RestrictionType As Variant)
HRESULT RestrictBy(const _variant_t& RestrictionType);
このエレメント トリガ タイプの制限リストを取得します
読み取り専用プロパティ
Property RestrictionsArray As Variant
_variant_t GetRestrictionsArray();
オブジェクト ポインタまたは文字列値を含む、制限リストを表すバリアントの配列。特定のメタデータ タイプ (例えば、特定の CCAttributeType) についてはオブジェクト ポインタが戻され、または特定のエレメント タイプ (例えば、"text_file") の名前については文字列値が戻されます。