Cognos Analytics カスタムビジュアライゼーション 基本の操作

#カスタムビジュアライゼーション 基本の操作
カスタムビジュアライゼーションでの、Cognosが提供しているサンプルを用いての基本の操作を学びます。
今回は、サンプルのダウンロードから、サンプルの動作確認、サンプルをパッケージ化してのCognos Analyticsへのアップロード方法を学びます。

#サンプルのダウンロード
以下のURLにアクセスします。
https://github.com/IBM/ca_customvis

「code-samples/11.1.x」を選択し「Clone or download」でZIPダウンロードします。
<img width="960" alt="001.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/28ad9fca-c6a8-67f8-da4e-744ea02c6722.png">

ダウンロードしたzipファイルを任意のディレクトリに解凍します。
<img width="553" alt="002.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/b783f2b2-86a1-815d-2f30-8bd6ef97d543.png">

展開後のディレクトリは、以下のとおりです。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/f6bf713a-fdf2-6d87-818b-a169c4fb9dc3.png)

#サンプル・コードの動作確認
コマンドウィンドウを立ち上げ、解凍したサンプルのoverlaybarディレクトリに移動し、以下のコマンドにてカスタム視覚化のローカル・サーバーを開始します。

**customviz start**
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/6f0ef7db-b38d-7234-64c2-2bb3b6775a80.png)

ローカル・サーバーが開始されている状態でブラウザからCognosAnalyticsにログインしダッシュボードからカスタム視覚化の稼働確認を行います。

「新規」＞「ダッシュボード」を選択してダッシュボード編集画面を開きます。
データ・ソースの選択では「GOデータウエアハウス（クエリー）」を選択します。
「視覚化」＞「カスタム」＞「開発者ウィジェット」の下の「視覚化テスト」をキャンバスへドラッグ＆ドロップします。
<img width="743" alt="003.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/e9273429-e8ec-5ded-826a-1275470f0223.png">

以下のようにデータアイテムを選択してグラフが問題なく表示されることを確認します。
Bars　→「販売とマーケティング（クエリー）」 > 「販売」 > 「時間」 > 「年」
Base bar value →「販売とマーケティング（クエリー）」 > 「販売」 > 「販売の実状」 > 「収益」
Firsst overlay value →「販売とマーケティング（クエリー）」 > 「販売」 > 「販売の実状」 > 「総利益」
<img width="960" alt="004.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/1e48b17a-d490-212f-c08e-6ce94186e285.png">

＜参考＞
レポートの機能でも同様の動作確認を、「視覚化テスト」をキャンバスにドロップし「ページ・プレビュー」モードに切り替えて行う事ができます。
<img width="960" alt="005.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/28995da8-3eca-ae39-50b0-372a7d51fb7c.png">

#パッケージ化&アップロード
カスタム視覚化のローカルサーバーを、「Ctrl + C」→「Y」で停止します。
<img width="535" alt="006.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/df17a538-b934-bae6-b358-54f6e4be33bd.png">

以下のコマンドを実行しパッケージを作成します。

```html
customvis pack
```
<img width="722" alt="007.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/f43a7076-abe6-7605-fe49-b6779e1427f2.png">

「overlaybar.packed.zip」というZIPファイルが生成されています。
<img width="376" alt="008.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/914c6646-3115-f7f9-82c4-0a4ee28adbef.png">

Cognos Analyticsにアクセスし、「管理」→「カスタマイズ」→「カスタム・ビジュアル」と開き、赤枠の「カスタム・ビジュアルのアップロード」を選択します。
<img width="483" alt="009.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/846ef015-bd71-77f1-d086-01f181fa2a2e.png">

先程作成した「overlaybar.packed.zip」を指定します。
<img width="470" alt="010.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/01d6e282-8d2f-1e65-74e3-9b3abf0f78c6.png">

「Overlay bar」が追加された事を確認します。
<img width="538" alt="011.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/52a0e0e9-2359-1f0f-c26a-bc5fa1801c3d.png">

#ダッシュボードで使用
ダッシュボードを新規に作成し、「視覚化」アイコンから「カスタム」タブを選択し、「Overlay bar」をキャンバスにドロップします。
<img width="564" alt="012.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/3b1f30c9-9019-d8a7-cad4-7050fa89a55d.png">

任意のデータアイテムを配置すると、グラフが表示されます。
<img width="960" alt="013.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/90d3ea09-1c7b-ab56-2749-e4c48d4929d1.png">

#レポートで使用
レポートを新規に作成し、「ツールボックス」から「視覚化」をキャンバスにドロップします。
<img width="571" alt="014.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/96a551d4-b395-f078-38b7-9e96bea85db9.png">

「カスタム」から「Overlay bar」を選択します。
<img width="745" alt="015.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/fce82c78-191b-b1cf-7f6d-619346f75c35.png">

任意のデータアイテムを配置すると、グラフが表示されます。
<img width="873" alt="016.PNG" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/147246/d67c4b44-f93d-d9b2-02a9-2aa3ad401668.png">

#目次
**Cognos Analytics カスタムビジュアライゼーション機能の紹介**
https://qiita.com/shinyama/items/0adde0d1665a4e385faa