# カスタム分析

<figure><img src="/files/caf0c307a57c849a7c7e42bce8d2f4f6eddf576c" alt=""><figcaption></figcaption></figure>

***

## 主なポイント

* 平易な言葉で質問すると、 **AIアシスタント** がSQLを作成してくれます。
* SQLを使ってBoxHeroのデータを検索できます。
* 条件（例: 商品、属性、価格、日付範囲、取引先）を組み合わせて、カスタムレポートとして取得したいデータを定義できます。
* よく使うクエリを保存して、いつでも再度開けます。
* 結果をExcelにエクスポートして、追加の分析やレポート作成に活用できます。

## 活用例

標準の <mark style="color:$primary;">`在庫レポート`</mark> 機能では、選択した期間の平均在庫数量や在庫回転率などの主要指標をすばやく確認できます。ただし、これらのレポートは事前定義された式とフィールドを使用しているため、チームに必要なあらゆる分析に対応できるとは限りません。

<mark style="color:$primary;">`カスタム分析`</mark> は、データの探索方法をより細かく制御できます。特に次のような場合に便利です:

* 標準のレポートで必要なデータが見つからない [在庫レポート](/docs/documentation/ja/sonono/analytics.md)
* 商品、仕入先、顧客、担当者、その他の詳細条件でデータを絞り込んだりグループ化したい
* 月次、四半期、前年差など、時間軸ベースの分析が必要
* 繰り返し使うレポートを保存して再利用したい
* レポート作成や意思決定を支える柔軟なデータが必要

***

## カスタム分析の使い方

### 1. はじめに

へ移動します。 <mark style="color:$primary;">`レポート`</mark> > <mark style="color:$primary;">`カスタム分析`</mark>。これにより、新しいワークスペースが開き、SQLクエリを作成・管理できます。次に、 <mark style="color:$primary;">`+ 新規`</mark> を選択して新しいクエリを作成します。

<figure><img src="/files/c4bcb9de73144558cd12ad256784d8e6ba75abf8" alt=""><figcaption></figcaption></figure>

### 2. クエリを書く

クエリの書き方は2通りあります:

1. **AIアシスタントを使う** と、平易な言葉の質問からSQLを生成できます（ほとんどのユーザーにおすすめ）。
2. **SQLを直接書く** を使って [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/8434f93138e4ef4ff9d2e7df8bf2065ff584b1da" alt=""><figcaption></figcaption></figure>

#### AIアシスタントの使い方

この <mark style="color:$primary;">`AIアシスタント`</mark> は、平易な言葉の質問を実行可能なSQLクエリに変換します。SQLの知識がなくても使えます。&#x20;

アシスタントパネルに質問を入力してEnterを押してください。アシスタントがSQLを生成し、エディタに適用して実行します。結果はクエリの下に表示されます。

保存する前に、必要に応じて生成されたSQLを編集して調整できます。

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**質問の例**

* 安全在庫を下回っている商品
* 直近90日間で売れていないものは？
* 今月の販売数量上位10SKU
* 予定到着日を過ぎた未受領の発注書
* ロケーション別の在庫数&#x20;

#### 再利用可能なクエリの作成

日付範囲や取引先名など、調整可能なフィルターをクエリに含めるようアシスタントに依頼できます。アシスタントはクエリ変数を使うため、SQLを書き直さなくても後から入力値を変更できます。

たとえば、 *「変更可能な日付範囲での商品別売上」* と依頼すると、クエリ実行のたびに入力を促す日付変数付きのクエリが生成されます。

<figure><img src="/files/dfd8f21592f2c82dc44b5d4a0961533b5db38c0f" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
AIアシスタントは、 **具体的な** **質問に対して最も効果的です。**。 \
「 *売上を見せて」* の代わりに、 *「今月の売上高上位10商品」*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
を試してください。 <mark style="color:$primary;">`Chart`</mark> ボタンをクリックすると、データを可視化できます — 棒グラフ、折れ線グラフ、円グラフ、積み上げ棒グラフ、積み上げ面グラフに対応しています。
{% endhint %}

### 3. クエリを保存する

を選択して <mark style="color:$primary;">`実行`</mark> クエリをテストします。結果は記述した条件に左右されるため、出力を確認して期待どおりかどうかを見てください。

クエリを再利用する予定がある場合は、 <mark style="color:$primary;">`保存`</mark> を右上で選択してください。保存したクエリは左側のサイドバーに表示され、いつでも開いて実行できます。

クエリの実行に成功したら、結果を <mark style="color:$primary;">`Excelにエクスポート`</mark>.

<figure><img src="/files/1572e1ba07c0218a0cb720d40595a48d88daa2d1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
データは自動的に同期されます **1日1回**。\
すぐに同期するには、サイドバー下部の同期アイコン（🔄）をクリックしてください。
{% endhint %}

***

## クエリ変数

クエリに `{{variable_name}}` を含めると、クエリ実行時に入力欄が自動的に生成されます。その欄に入力した値が、SQLクエリ内の変数に適用されます。

クエリを保存すると、チームメンバーは変数欄にそれぞれの値を入力して、必要なときにいつでもレポートを実行できます。

#### 例

1. 特定のキーワードを含む商品を検索するには、次のクエリを入力します:

```sql
select sku, name 
from items 
where name ilike '%' || {{item_name}} || '%';
```

2. クエリを実行すると、 **item\_name** という名前の入力欄が表示されます。

<figure><img src="/files/eea3abb723aae3249a4649f8b69e647770dfbbee" alt=""><figcaption></figcaption></figure>

3. 次のようなキーワードを入力してください: *`sweater`* すると、結果には名前に *「sweater」* を含むすべての商品が表示されます。

<figure><img src="/files/c2c6586396d3fca53d630652ea95e581382f70b4" alt=""><figcaption></figcaption></figure>

4. もう一度使う予定がある場合は、クエリを保存してください。左側のメニューから、保存済みクエリをいつでも選択して読み込めます。

<figure><img src="/files/fa8bea37491566c8264cf2ac3ad44c95b0dc0fbd" alt=""><figcaption></figcaption></figure>

***

## 例

カスタム分析には、すぐに実行できる組み込みテンプレートがあります。テンプレートを確認して仕組みを理解し、必要に応じて調整するか、要件に合わせて新しいクエリを作成してください。

#### テンプレート

* 週次入出庫レポート
* 月次の購買・売上トレンド
* 商品別の最終出庫日

<figure><img src="/files/0ad37a16ac011ebfa71a13a74561ab3d8989ee93" alt=""><figcaption></figcaption></figure>

***

**ほかに質問がありますか？** カスタム分析FAQをご覧ください:

{% content-ref url="/spaces/Zvjcst6XueuNcyPRjnhb/pages/05a52af5a85de69a431f3cb5366fd57c105703b6" %}
[カスタム分析](/docs/faq/ja/repto/kasutamu.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.boxhero.io/docs/documentation/ja/sonono/custom-analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.