これは、レポートに vote(投票)して、その票数により重要度を押し上げるというアクションの方法です。

表示されるレポート内の次に示される部分を参照してください。

Hide image

"Total Votes:" は、現在 Vote されているポイント数です。

"[Vote for This Report]" のリンクをクリックすると、次のような画面が表示され、レポートに対して Voteが行うことができます。

Hide image

この画面の上部には今までに Vote した QC がリストされています。

下部には Vote 対象のQCが表示されています。

Voteの手順ですが、まず、"Your Vote:" のテキストボックスに、Vote するポイントを入力します。

持ちポイントは通常 10 ポイントあります。1ポイントずつ Vote するのであれば QC 10件に対して Vote できます。「これは重要だ！」と思ったのなら、一つの QC に集中して 10 ポイントを注ぎ込む事もできます。

Vote するポイントが足りない場合には既存の Vote から "[Remove This Vote]" を実行して、他に投票した Vote のポイントを取り消すしかありません。

その際、まず対象となるのが、Closedになっている QCレポートです。

すでに Closed になっている QC に対していつまでも Vote ポイントを付けていても無駄なので、 特殊な事情がない限り、Closed-QC に対する Vote は取り消すべきです。

余談ですが、Rating は Web ブラウザから操作できない事もあってあまり重要視されていないように思えます。そして Rating そのものも、重要度に対するものではなく、このレポートを理解し易かったか？という観点のレイティングと思います。

報告されているレポートに質問や補足を行いたい場合、そのレポートにコメントを付けることができます。該当する QC レポートを表示し、その下部にある Comments欄

Hide image

の中にある "[Add Comment to This Report]" のリンクを押してコメントを追加します。

コメントの追加を行うときには、注意が必要です。

QualityCentral のサイトは UTF-8 で記述されていますが、コメントに日本語は記述できません。

QualityCentral のサイトは世界中の人が見るパブリックなサイトなので、使用される言語は英語となります。ただ、サンプルコードを書くときに定数として日本語を使いたい場合があります。そのような場合は、コントロール文字列で置き換えるか、サンプルファイル側に記述してレポートにファイルを添付し、その旨をコメントに記述するという方法をとる必要があります。

一般的に、コメントを書くタイミングとしては、QC レポートにに賛同する時、自分が投稿した QCレポートが Closedとなったが、その Closedの理由に納得がいかない時、他の人のレポートにアドバイスを行いたいときなどが考えられます。

また、Webブラウザ上で、翻訳しながらコメントを書いているとタイムアウトとなり、途中まで書いたコメントがクリアされてしまう事があるので、テキストエディタ等で推敲してからコピー＆ペーストして投稿するといいと思います。

ここでは、Delphi 2009に付属している Windowsクライアントを使用しています。

1. Delphi のメニューから [ツール(T) | QualityCentral (Q)]を選択するか、或いは、製品をインストールしたディレクトリの \QualityCentral ディレクトリ内の"qualitycentral.exe" を直接起動します。

注意: 古いバージョンの Delphi等に付属している Windowsクライアントを起動した場合、参照するドメインが現行のドメイン(codegear.com)と異なるため、「Server is currently unavailable or you can not connected to the internet. Can not proceed」のようなメッセージが出力され起動に失敗します。この場合、Windowsクライアントと同じディレクトリ内に作成された QualityCentral.iniファイル内の「qc.borland.com」と記載されている部分を「qc.codegear.com」に修正してください。( http://dn.codegear.com/article/38267 )

2. 初回起動時にプロキシサーバーの設定を促すダイアログが表示されます。

Hide image


プロキシサーバーを設定する必要がなければ、そのままOKボタンを押して下さい。

3. QualityCentralへのログインダイアログが表示されます。
   
   Hide image
   
   
   デベロッパーネットワークに登録しているアカウントのメールアドレスとパスワードを入力し、”DN Authentication”にチェックをつけ、OK ボタンを押して下さい。"Save Password" にチェックを入れておくと、次回からはパスワード入力を求められなくなります。
4. QualityCentral Windows Clientが起動します。もし、何かしらの製品のフィールドテストに参加しているのなら、"QualityCentral Windows Client" のメニューから [View | Options...] を選択して環境設定を行います。
5. Optionダイアログの "Beta Registering" タブを選択して、フィールドテスターとして登録している情報を入力し、Apply ボタンを押します。この設定により、フィールドテスター用のレポートの投稿・閲覧が可能になります。
   
   Hide image
   
   
   

1. QualityCentral Windows Clientでレポートを投稿する場合、まず、ツールバーの " (Insert)" ボタンを押します。
   
   Hide image
   
2. 画面上に Reportedの文字が表示され、レポートする際の必須項目の部分が以下のように赤く表示されます。

Hide image


赤く表示された必須項目は、以下の通りです。

• Project
  製品の種類です。レポートを行う製品を一覧の中から選択します。
• Platforms
  製品のプラットフォームです。通常は"All platforms"で構いません。
• Veresion
  製品のバージョンです。Projectで製品を選択すると、その製品のバージョンの一覧が表示されますので、その中より該当する製品のバージョンを選択します。
• Area
  レポートする内容が製品のどの部分に該当するかを指定する箇所です。Projectで製品を選択すると、その製品での Area区分が表示されますので、その中より該当する Areaを選択します。たとえば Delphiの場合、IDEについてなら"IDE"、関数等なら"RTL"、VCLは"VCL"、ヘルプなら"Documentation"を選択します。
• Type
  投稿するレポートの種類を以下より選択します
  A:クラッシュ / データロス
  B:基本的な問題
  C:軽微な問題 / デザイン上の問題
  D:ヘルプ等のドキュメントの問題
  E:問題提起/追加要求
  F:新規の機能追加要求
  I:問題
  S:仕様に関する問題
• Serverity
  問題の程度を以下より選択します。
  0:致命的な問題
  1:深刻な問題
  2:普通に遭遇する不具合
  3:たまに遭遇する不具合
  4:極端なケース(例えば特定の条件が重なり合って発生する場合など)
• Build No
  製品の詳細なバージョンです。製品情報ダイアログ(またはバージョン情報ダイアログ)等に表示されている"11.0.2902.10471"のようなビルド番号を含む番号を指定します。

3. 青い文字で表示されている Descriptionには、短い説明(タイトル)とレポートする内容を英語で記述します。
   
   Hide image
   
4. 不具合に関するレポートを投稿する場合は、必ず右側の Stepsに、その現象を確実に再現させるための手順を記述します。なお、Steps の記述がないと投稿の際に警告が出る事があります。ヘルプの誤記のような、再現手順を提示する必要がない場合以外は Steps を必ず記述して下さい。
   
   Hide image
   
   
   
5. 以上でレポートの投稿に必要な項目の記載は終了です。ツールバーの " (Post)" ボタンを押して投稿を確定させます。レポートの投稿が確定されると、Reportedの文字の左側に,採番された QC番号が表示されます。
   
   Hide image
   
   
   なお、途中で、投稿をキャンセルするには" (Cancel)"ボタンを押します。

レポートで不具合を報告する場合、現象を再現させるサンプルプログラムや、スクリーンショットがあると、より正確な報告となります。レポートにファイルを添付する際には、添付するファイル群を予め zipで１つの zipファイルとして圧縮しておきます。圧縮した zipファイルは次の手順でレポートに追加することができます。なお、ファイルの添付は投稿が確定したレポートに対してのみ行えます。投稿が確定していないレポートにはファイルを添付することができません。

1. QC へレポートを投稿した直後に、右側の "Attachment" タブを開きます。
2. メニューから [Reports | Add Attachment...] または、リストの上で右クリックし、コンテキストメニューから "Add Attachment..." を選択します。
3. ZIP形式で圧縮した添付ファイル を選択します。

QualityCentral Windows Clientでは、QCへのレポートの投稿以外に、

• QCの検索
• QCに投稿したレポートの編集
• QCに投稿したレポートの削除

を行うことができます。

まずは、QCに投稿したレポートの検索手順について説明します。

1. ツールバーの " (Query)" ボタンを押します。
   
   Hide image
   
2. 表示された以下の項目に検索に必要な事項を入力します。次のようなパターンがよく使用されます。
   ・"Report Number" に QC番号のみを直接入力し、その QC番号のレポートを直接検索
   ・"Project / Platforms / Version" と "Keyword" を埋めて、キーワード検索
   
   Hide image
   

3. 検索に必要な項目の指定を行った後、ツールバーの" (稲妻マーク)"のボタンを押します。該当するレポートがあった場合は画面上に表示されます。ヒットする項目がなかった場合は、検索条件を変えて再検索してみましょう。
   
   Hide image
   
4. 検索条件に該当する QC レポートが複数存在した場合には、ツールバーの " (ナビゲーション)" ボタンで、検索されたQCレポートを順に閲覧することができます。
   
   Hide image
   
   
   また、ツールバーの" (一覧切り替え)"ボタンをクリックして該当したQCレポート一覧リストの表示/非表示を操作することができます。
   
   Hide image
   
   
   また、レポート一覧リスト上のレポートをマウスでクリックすると、そのレポートがカレントレコードとして表示されます。
   
   Hide image
   

Quarity Central Winsows Clientを使用して、自分が QCに投稿したレポートを編集することができます。(他の人が投稿したレポートを編集することはできません。他の人のレポートに対してはコメントの付加だけが許されます。)

1. 任意の方法で編集する QCレポートを検索します。
2. 編集するレポートが表示されている状態で、ツールバーの " (Edit)" ボタンを押します。
   
   
3. レポート内容を編集します。
4. 編集が終了したら、ツールバーの " (Post)" ボタンを押して編集内容を確定させます。
   
   Hide image
   
   
   なお、途中で、編集をキャンセルするには" (Cancel)"ボタンを押します。

Quarity Central Winsows Clientを使用して、自分が QCに投稿したレポートを削除することができます。(他の人が投稿したレポートを削除することはできません。他の人のレポートに対してはコメントの付加だけが許されます。)

1. 任意の方法で削除したい QCレポートを検索します。
2. 削除したいレポートが表示されている状態で、ツールバーの " (Delete)" ボタンを押します。この時、削除されたレポートの Statusの表示は、「投稿したレポートが取り下げられた」ことを意味する “Withdrawn”に変わります。
   
   

問題を報告する際、Stepsには必ず

• 再現手順
• 期待される動作
• 実際の動作

を簡潔に記述します。

以下は、記述のテンプレートの一例です。

ここに問題を再現させるための手順やコードを記述します

EXP:
  ここに期待される動作を記述します

ACT:
  ここに実際の動作を記述します

また、Descriptionの詳細部分か、Stepsの最後に、"この問題の影響範囲" や"問題を解決する事で得られるメリット" 等を追記しておくといいでしょう。

QCへレポートを投稿した後、ディスカッション・フォーラム の該当グループ(英語)へQC のコピーを投稿し、 日本のディスカッション・フォーラム に Vote を呼び掛けるために告知するといいと思います。

以下は、QCへレポートを投稿した後、ディスカッション・フォーラムへ投稿する際の "QCのコピーのテンプレート" の一例です。

まずは、タイトル(Subject)。

[バージョン] QCでの短いDescription

"バージョン" には "D2009" 等を入れます(FT等、同一の製品を対象としている場合にはビルド番号を入れます)。

次は本文です。

Report No: QC番号            Status: Reported
QCでの短いDescription
http://qc.codegear.com/wc/qcmain.aspx?d=QC番号
QCWIN:Defect_No=QC番号

3箇所ある "QC番号" には、すべて同一の QC 番号を入れます。最後の行は、リンクをクリックした際に QCクライアントへ飛ばすための指定です。

冒頭には "Hello" 程度の挨拶と、簡単な説明文を付け加えておくとよいでしょう。"QCレポートの重大度をアピールする" のも、もちろんかまいません。

以下は、このテンプレートを使用して作成した QC#66693 のサンプルです。

[D2009] Help-topic of a part of error-code doesn't exist.

Hello,
I'm reported QC#66693.

Report No: 66693            Status: Reported
[Help] Help-topic of a part of error-code doesn't exist.
http://qc.codegear.com/wc/qcmain.aspx?d=66693
QCWIN:Defect_No=66693

QCへ投稿するレポートにファイルを添付する際には、以前の項でも触れましたが、必ずZIP 形式で圧縮して添付します。

添付ファイルに含まれる、実働するソースコードに日本語を記述する必要がある場合には、ファイル形式を UTF-8 にすべきです。ただし、基本的に日本語を書いてはいけません。何故なら、日本語を表示する事のできるフォントをレポートを参照する相手が持っているとは限らないからです。通常、英語版の Windows には "MSゴシック / 明朝/ MS UIゴシック" がインストールされていませんし、Vista であってもメイリオがインストールされているとは限らないからです。もし、やむ得なく日本語を記述したファイルを添付するのであれば、QCレポートの本文に、日本語を記述したファイルが含まれていることを明示したほうがいいでしょう。

日本語固有の問題をソースコードで示す場合、Delphi 2009 であれば、いくらか話は簡単です。以下のコードをご覧ください。

type
  SJISString = type AnsiString(932); // Shift-JIS(CP932)
var
  SJIS: SJISString;
begin
  SJIS := #$82#$A0 + // Japanese Hiragana 'a'
          #$82#$A2 + // Japanese Hiragana 'i'
          #$82#$A4;  // Japanese Hiragana 'u'
  ...

end;

上記のようなコードは、コードページを強制しているので、どのような環境においても、記載されたコードを正しく実行できます。

ただし、ShowMessage 等で、結果を日本語表示させる場合には、前述の通り"相手が日本語フォントを表示できない可能性がある"ので、スクリーンショットも併せて zipファイルに圧縮して添付しましょう。

スクリーンショット等で添付する 画像は JPEG形式が好まれるようですが、BMP / GIF / PNG 形式などでもかまいません。

Windows 等の用語を記述したい時、「英語でこの機能の表記は？」と思う事があります。そのような時は "マイクロソフト ランゲージ ポータル - 用語検索" で日本語の用語で検索すると、英語の対訳を得る事ができます。

Delphi の IDE等に使用されている UI用語については、実際の製品で確認するか、日本語のディスカッションフォーラムで他の人に聞くなどするしかありません。このような場合、VMWare等のバーチャルマシン環境に英語版とヘルプの英語版をインストールするというのもひとつの解決方法になります。

大抵の事は、英語版のヘルプがあれば事足りるのですが、 HTMLHelp2 の仕様により、ひとつのマシン上で 日本語版 / 英語版 を同時に閲覧する事はできません。しかし、以下の手順で同居させ、切り替える事は可能です。

1. はじめに、英語版のヘルプをインストールします
2. ヘルプのインストール終了後、ドキュメントのフォルダ"$(BDS)\Help\Doc" (Delphi 2009の場合、デフォルトで C:\Program Files\CodeGear\RAD Studio\6.0\Help\Doc )を別の場所(例えば、\Doc_en)にバックアップコピーします
3. 英語版のヘルプをアンインストールします
4. 次に、日本語版 のヘルプをインストールします
5. ヘルプのインストール終了後、先ほどと同様にドキュメントのフォルダを別の場所(例えば \Doc_ja)にバックアップコピーします

　コピーした２つのヘルプの切り替え方は以下の通りとなります。

1. バックアップした 英語版 / 日本語版 ヘルプのフォルダを、正規のドキュメントのフォルダ"$(BDS)\Help\Doc" にリネーム(或いはコピー)します
2. ドキュメントのフォルダ($(BDS)\Help\Doc)内にある "install_and_view.cmd" を実行します

　この手順でヘルプを切り替える事ができますが、英語版を後にインストールしてしまうと"Document Explorer"が英語版になってしまう可能性があります。