# カスタム分析
{% hint style="warning" %} **`カスタム分析`** 現在 **ベータ版**です。\
正式リリース後は有料機能になります。
{% endhint %}
***
## 主な特長
* SQLを使用してBoxHeroデータをクエリできます。
* 条件（例：商品、属性、価格、日付範囲、取引先）を組み合わせて、カスタムレポートとして返したいデータを定義できます。
* よく使うクエリを保存して、いつでも再度開くことができます。
* 追加の分析やレポート作成のために、結果をExcelにエクスポートできます。
## カスタム分析を使う場面
標準の **`在庫レポート`** 機能では、選択した期間の平均在庫数量や在庫回転率などの主要指標をすばやく確認できます。これらのレポートは定義済みの数式と項目を使用するため、チームに必要なあらゆる種類の分析を網羅できない場合があります。
**`カスタム分析`** では、データの探索方法をより細かく制御できます。特に次のような場合に役立ちます：
* 標準の中に必要なデータが見つからない [在庫レポート](https://www.boxhero.io/docs/documentation/ja/sonono/analytics)
* 商品、仕入先、顧客、チームメンバー、またはその他の詳細な条件でデータを絞り込んだりグループ化したりしたい
* 月次、四半期、前年比などの時系列分析が必要である
* 頼りにしているレポートを保存して再利用したい
* レポート作成や意思決定を支えるための柔軟なデータが必要である
***
## カスタム分析の使い方
### 1. はじめに
次へ移動します **`レポート`** > **`カスタム分析`**。これにより、SQLクエリを作成および管理できる新しいワークスペースが開きます。次に、 **`+ 新規`** を選択して新しいクエリを作成します。
### 2. クエリを作成する
クエリでは [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction)を使用します。 **`AI Prompt`** ファイルをダウンロードして、利用可能なすべてのテーブルと列を確認できます。
{% hint style="success" %}
もし **AIツール** （ChatGPTやGeminiなど）を使用している場合は、「*AI Prompt」* ファイルを添付すると、正確なSQLを生成しやすくなります。
{% endhint %}
選択します **`実行`** してクエリをテストします。結果は記述した条件によって異なるため、出力を確認して期待どおりかどうかを確かめてください。
クエリが正常に実行されたら、次の方法で結果をエクスポートできます： **`Excelにエクスポート`**.
### 3. クエリを保存する
クエリを再利用する予定がある場合は、 **`保存`** を右上隅で選択します。
保存されたクエリは左側のサイドバーに表示され、いつでも開いて実行できます。
{% hint style="info" %}
データは自動的に同期されます **1日1回**。\
すぐに同期するには、サイドバーの下部にある同期アイコン（🔄）をクリックしてください。
{% endhint %}
***
## クエリ変数
もし `{{variable_name}}` をクエリに含めると、クエリ実行時に入力フィールドが自動的に生成されます。そのフィールドに入力された値が、SQLクエリ内の変数に適用されます。
クエリを保存すると、チームメンバーは変数フィールドにそれぞれの値を入力して、必要なときにいつでもレポートを実行できます。
#### 例
1. 特定のキーワードを含む商品を検索するには、次のクエリを入力します：
```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```
2. クエリを実行すると、 **item\_name** という名前の入力フィールドが表示されます。
3. 次のようなキーワードを入力します： *`セーター`* すると結果には、名前に *「sweater」* を含むすべての商品が表示されます。
4. 再度使用する予定がある場合は、クエリを保存してください。保存したクエリは左側のメニューからいつでも選択して読み込めます。
***
## 使用例
カスタム分析には、すぐに実行できる組み込みテンプレートが含まれています。テンプレートを確認して動作を理解し、その後調整するか、ニーズに応じて新しいクエリを作成してください。
#### テンプレート
* 週間在庫入出庫レポート
* 月次仕入・売上推移
* 商品別最終出庫日
***
## よくある質問（FAQ）
### 複数のチームのデータを組み合わせることはできますか？
いいえ。データはチームごとに分かれており、現在ログインしているチームのデータのみ分析できます。
### メンバーによるカスタム分析の利用を制限できますか？
管理者とメンバーはクエリを作成して閲覧できます。カスタム権限を持つメンバーは *できません* この機能にアクセスすることが。
メンバーのアクセスを制限する必要がある場合は、そのメンバーに [カスタム権限](https://www.boxhero.io/docs/documentation/ja/she-ding/members#custom-roles-and-permissions) を割り当ててください。 **すべての権限が選択された**。カスタム分析は *含まれていません* カスタム権限のオプションには含まれていないため、すべての権限を選択しても、そのメンバーはアクセスできません。
