Crystal Reports にAzure DevOps を連携してAzure DevOps データを使った帳票を作成

Crystal Reports には、ODBC 標準向けのサポートが組み込まれています。CData ODBC Driver for AzureDevOps は、Crystal Reports でレポート作成ウィザードやその他のツールを使ってAzure DevOps へのアクセスを可能にします。この記事では、Azure DevOps の機能を持つシンプルな帳票を作成する方法を説明します。

Azure DevOps データに接続

下記の手順に従って、レポート作成ウィザードを使ってAzure DevOps 接続を作成します。

1. ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
   • AuthScheme
   • Organization
   • ProjectId
   • PersonalAccessToken

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。 You can connect to your Azure DevOps account by providing the Organization and PersonalAccessToken.

   Obtaining a Personal Access Token

   A PersonalAccessToken is necessary for account authentication.

   To generate one, log in to your Azure DevOps Organization account and navigate to Profile -> Personal Access Tokens -> New Token. The generated token will be displayed.

   If you wish to authenticate to Azure DevOps using OAuth refer to the online Help documentation for an authentication guide.

2. 新しい帳票で、［Create New Connection］>［ODBC］をクリックします。

3. ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

Azure DevOps データに連携する帳票をデザイン

ODBC 接続をAzure DevOps に追加したら、レポート作成ウィザードを使ってAzure DevOps を帳票に追加できます。

1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Builds テーブルのId およびBuildNumber カラムを使います。

2. チャートの種類を設定。 例えば、BuildNumber をId で表すシンプルなチャートを作成します。 ウィザードを完了すると、Crystal Reports はAzure DevOps に実行されるSQL クエリをビルドします。ドライバーは、リアル隊うAzure DevOps に対してクエリを実行します。

3. 必要に応じて、ほかのフィルタやレポートテンプレートを設定します。

4. データのインポートが終わったら、レポートフィールドをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total BuildNumber by Id を表すグラフを作成するには、Id を［On Change Of］メニューセレクションの下のボックスに追加してからBuildNumber を［Show Values］の下のボックスに追加します。

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。