> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/ms/ciri-lain/custom-analytics.md).

# Analitik Tersuai

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

***

## Sorotan Utama

* Tanya soalan dalam bahasa biasa dan **Pembantu AI** menulis SQL untuk anda.
* Gunakan SQL untuk membuat pertanyaan pada data BoxHero anda.
* Gabungkan syarat (cth. item, atribut, harga, julat tarikh, rakan kongsi) untuk menentukan data yang anda mahu pulangkan sebagai laporan tersuai.
* Simpan pertanyaan yang kerap anda gunakan dan bukanya semula pada bila-bila masa.
* Eksport hasil ke Excel untuk analisis atau pelaporan tambahan.

## Kes Penggunaan

Ciri standard <mark style="color:$primary;">`Laporan Inventori`</mark> memberikan anda paparan pantas metrik utama seperti kuantiti stok purata dan pusing ganti inventori untuk tempoh yang dipilih. Oleh sebab laporan tersebut menggunakan formula dan medan yang telah ditetapkan, ia mungkin tidak merangkumi setiap jenis analisis yang diperlukan pasukan anda.

<mark style="color:$primary;">`Analitik Tersuai`</mark> memberikan anda lebih kawalan ke atas cara anda meneroka data anda. Ia amat berguna apabila:

* Anda tidak dapat mencari data yang anda perlukan dalam ciri standard [Laporan Inventori](/docs/documentation/ms/ciri-lain/analytics.md)
* Anda mahu menapis atau mengumpulkan data mengikut item, pembekal, pelanggan, ahli pasukan atau syarat terperinci yang lain
* Anda memerlukan analisis berasaskan masa seperti bulanan, suku tahunan atau tahun ke tahun
* Anda mahu menyimpan laporan yang anda andalkan dan menggunakannya semula
* Anda memerlukan data yang fleksibel untuk menyokong pelaporan atau pembuatan keputusan

***

## Cara Menggunakan Analitik Tersuai

### 1. Bermula

Pergi ke <mark style="color:$primary;">`Laporan`</mark> > <mark style="color:$primary;">`Analitik Tersuai`</mark>. Ini akan membuka ruang kerja baharu tempat anda boleh mencipta dan mengurus pertanyaan SQL anda. Kemudian, pilih <mark style="color:$primary;">`+ Baharu`</mark> untuk mencipta pertanyaan baharu.

<figure><img src="/files/74b8e4953e4db3803055416646a779450ae0a8eb" alt=""><figcaption></figcaption></figure>

### 2. Tulis Pertanyaan

Anda mempunyai dua cara untuk menulis pertanyaan:

1. **Gunakan Pembantu AI** untuk menjana SQL daripada soalan dalam bahasa biasa (disyorkan untuk kebanyakan pengguna).
2. **Tulis SQL secara langsung** menggunakan [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/333e517801a1ebb85f0ebad11856ecca3e767e5e" alt=""><figcaption></figcaption></figure>

#### Menggunakan Pembantu AI

Yang <mark style="color:$primary;">`Pembantu AI`</mark> menukar soalan dalam bahasa biasa menjadi pertanyaan SQL yang berfungsi. Anda tidak perlu tahu SQL untuk menggunakannya.&#x20;

Taip soalan anda dalam panel pembantu dan tekan Enter. Pembantu akan menjana SQL, memasukkannya ke dalam editor, dan menjalankannya. Hasil dipaparkan di bawah pertanyaan.

Anda boleh mengedit SQL yang dijana sebelum menyimpan jika anda mahu melaraskan apa-apa.

{% 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>" %}

**Contoh Soalan**

* Item di bawah tahap stok keselamatan
* Apakah yang tidak terjual dalam 90 hari yang lalu?
* 10 SKU teratas mengikut unit terjual bulan ini
* PO yang masih terbuka melepasi tarikh ketibaan yang dijangka
* Tahap stok mengikut lokasi&#x20;

#### Membina Pertanyaan yang Boleh Digunakan Semula

Anda boleh meminta pembantu untuk memasukkan penapis yang boleh dilaraskan dalam pertanyaan, seperti julat tarikh atau nama rakan kongsi. Pembantu menggunakan Pemboleh Ubah Pertanyaan supaya anda boleh menukar input kemudian tanpa menulis semula SQL.

Sebagai contoh, meminta *"jualan mengikut item untuk julat tarikh yang boleh saya ubah"* menjana pertanyaan dengan pemboleh ubah tarikh yang meminta input setiap kali pertanyaan dijalankan.

<figure><img src="/files/1c58dc71f95632c519fc7761f76b739687fae089" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Pembantu AI paling sesuai untuk **soalan yang** **khusus**. \
Daripada *"tunjukkan jualan kepada saya,"* cuba *"10 item teratas mengikut hasil bulan ini."*
{% 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" %}
Klik <mark style="color:$primary;">`Carta`</mark> butang untuk memvisualkan data — bar, garis, pai, bar bertindan, kawasan bertindan disokong.
{% endhint %}

### 3. Simpan Pertanyaan

Pilih <mark style="color:$primary;">`Jalankan`</mark> untuk menguji pertanyaan anda. Memandangkan hasil bergantung pada syarat yang anda tulis, semak output untuk mengesahkan bahawa ia sepadan dengan jangkaan anda.

Jika anda bercadang untuk menggunakan semula pertanyaan, pilih <mark style="color:$primary;">`Simpan`</mark> di penjuru kanan atas. Pertanyaan yang disimpan akan muncul di bar sisi kiri, tempat anda boleh membukanya dan menjalankannya pada bila-bila masa.

Selepas pertanyaan anda berjaya dijalankan, anda boleh mengeksport hasil dengan <mark style="color:$primary;">`Eksport ke Excel`</mark>.

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

{% hint style="info" %}
Data anda disegerakkan secara automatik **sekali sehari**.\
Untuk menyegerakkan dengan segera, klik ikon penyegerakan (🔄) di bahagian bawah bar sisi.
{% endhint %}

***

## Pemboleh Ubah Pertanyaan

Jika anda menyertakan `{{variable_name}}` dalam pertanyaan anda, medan input akan dijana secara automatik apabila pertanyaan dijalankan. Nilai yang dimasukkan dalam medan itu akan digunakan pada pemboleh ubah dalam pertanyaan SQL anda.

Apabila anda menyimpan pertanyaan, ahli pasukan anda boleh memasukkan nilai mereka sendiri dalam medan pemboleh ubah dan menjalankan laporan apabila mereka memerlukannya.

#### Contoh

1. Untuk mencari item yang mengandungi kata kunci tertentu, masukkan pertanyaan berikut:

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

2. Apabila anda menjalankan pertanyaan, medan input bernama **item\_name** akan muncul.

<figure><img src="/files/6529ffdc9f8bc76c55a6320350db122c1c455142" alt=""><figcaption></figcaption></figure>

3. Masukkan kata kunci seperti *`sweater`* dan hasil akan memaparkan semua item dengan *“sweater”* dalam nama mereka.

<figure><img src="/files/74d69e211a763c30e4df7b0d5b178265a08af2aa" alt=""><figcaption></figcaption></figure>

4. Simpan pertanyaan itu jika anda bercadang untuk menggunakannya lagi. Anda boleh memilih dan memuatkan pertanyaan yang disimpan pada bila-bila masa daripada menu sebelah kiri.

<figure><img src="/files/5696d04a59bcaa4e59d2c3512be261786ef6082a" alt=""><figcaption></figcaption></figure>

***

## Contoh

Analitik Tersuai termasuk templat terbina dalam yang boleh anda jalankan dengan segera. Semak templat untuk memahami cara ia berfungsi, kemudian laraskannya atau cipta pertanyaan baharu berdasarkan keperluan anda.

#### Templat

* Laporan Masuk/Keluar Stok Mingguan
* Trend Pembelian dan Jualan Bulanan
* Tarikh Keluar Terakhir mengikut Item

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

***

## Soalan Lazim

**Masih ada soalan?** Lihat Soalan Lazim Analitik Tersuai kami:

{% content-ref url="/spaces/8A9ZEY4416TjPUs4LWRq/pages/0680b614d31c5a8273c27ea35232a5d440b9427f" %}
[Analitik tersuai](/docs/faq/ms/pelaporan/analitik-tersuai.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/ms/ciri-lain/custom-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.