URL のオープン

GSU_CQXE_OpenURL グローバル フックは、Web ブラウザ ウィンドウを指定の URL で開きます。この機能は最初に、ユーザーがメッセージをカスタマイズできる確認ダイアログを開きます。ダイアログでユーザーが [OK] をクリックするとブラウザが開きます。ユーザーが [キャンセル] をクリックするとダイアログが閉じられ、レコード フォームに戻ります。

この機能は、ClearQuest Eclipse および ClearQuest web のクライアントで使用可能です。ユーザーが古いクライアントまたは ClearQuest for Windows クライアントから URL を開こうとすると、API は情報メッセージを返します。ユーザーにこのメッセージを表示するには、die 関数を呼び出します。

GSU_CQXE_OpenURL グローバル フック関数を使用して、URL を開くには、GlobalScriptUtility (GSU_CQXE) パッケージを適用して、スキーマをグローバル フック コードで更新する必要があります。
  1. ClearQuest Designer の中で、パッケージを適用するスキーマのバージョンを 右クリックし、[パッケージ] > [パッケージの適用] を選択します。パッケージ ウィザードが開きます。
  2. パッケージのリストで [GlobalScriptUtility] ノードを 展開して、[バージョン 1.0] を選択します。[次へ] をクリックします。
  3. パッケージを適用するレコード タイプを選択します。[終了] をクリックします。
これで、GlobalScriptUtility パッケージが、 選択したスキーマに適用されました。パッケージのインストールを確認するには、 スキーマの中で新規の GSU_CQXE グローバル スクリプトを探します。

パッケージの適用について 詳しくは、「パッケージの適用」を参照してください。

次の例は、URL を開くためにグローバル フックで使用できるレコード スクリプトです。この例では、[OpenIBM] ボタンをクリックするとダイアログが開き、ユーザーは、指定の URL でブラウザを開くかどうか聞かれます。ユーザーが [OK] をクリックすると、ブラウザ ウィンドウは www.ibm.com で開きます。ユーザーが [キャンセル] をクリックすると、ダイアログが閉じられます。

この例を使用するには、スキーマに次の変更を加えます。
  1. Perl または VBScript 例を使用して Open_Url という名前のレコード スクリプトを作成します。
  2. 障害レコード タイプの Defect_Base フォームに、OpenURL という名前のタブを新規に追加します。
  3. OpenURL タブで、OpenIBM という名前の新しい [ボタン] コントロールを追加し、それを Open_Url レコード スクリプトと関連付けます。

Perl 例

sub Defect_Open_Url {
    my($result);
    my($param) = @_;
    # record type name is Defect
    
    $url="http://www.ibm.com";
    $msg="Do you want to open a browser to this URL?";
    my $session = $entity->GetSession(); 
    GSU_CQXE_OpenURL($session,$url,$msg);
    return $result;
}

VBScript 例

Function Defect_Open_Url(param)
  ' param As Variant
  ' record type name is Defect
    REM add your hook code here
	Dim url
	Dim message
	set session = GetSession
	url = "http://www.ibm.com"
	message = "Do you want to open a browser to this URL?"
	Defect_Open_Url=GSU_CQXE_OpenURL(session,url,message)
End Function

フィードバック