# Analitik Tersuai

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

***

## Sorotan Utama

* Tanya soalan dalam bahasa mudah 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 mentakrif data yang ingin anda pulangkan sebagai laporan tersuai.
* Simpan pertanyaan yang anda gunakan dengan kerap dan buka semula pada bila-bila masa.
* Eksport keputusan ke Excel untuk analisis atau pelaporan tambahan.

## Kes Penggunaan

Standard <mark style="color:$primary;">`Laporan Inventori`</mark> ciri memberi anda paparan pantas tentang metrik utama seperti kuantiti stok purata dan pusing ganti inventori bagi tempoh yang dipilih. Oleh sebab laporan itu menggunakan formula dan medan yang dipratentukan, ia mungkin tidak merangkumi setiap jenis analisis yang pasukan anda perlukan.

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

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

***

## Cara Menggunakan Analitik Tersuai

### 1. Memulakan

Pergi ke <mark style="color:$primary;">`Laporan`</mark> > <mark style="color:$primary;">`Analitik Tersuai`</mark>. Ini 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 mudah (disyorkan untuk kebanyakan pengguna).
2. **Tulis SQL secara terus** menggunakan [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

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

#### Menggunakan Pembantu AI

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

Taip soalan anda dalam panel pembantu dan tekan enter. Pembantu menjana SQL, menerapkannya ke editor, dan menjalankannya. Keputusan akan dipaparkan di bawah pertanyaan.

Anda boleh mengedit SQL yang dijana sebelum menyimpan jika anda mahu melaras 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 paras stok keselamatan
* Apa yang tidak terjual dalam 90 hari terakhir?
* 10 SKU teratas mengikut unit terjual bulan ini
* PO terbuka yang melepasi tarikh ketibaan yang dijangka
* Tahap stok mengikut lokasi&#x20;

#### Membina Pertanyaan Boleh Guna Semula

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

Contohnya, bertanya *"jualan mengikut item untuk julat tarikh yang boleh saya ubah"* menjana pertanyaan dengan pembolehubah tarikh yang meminta input setiap kali pertanyaan dijalankan.

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

{% hint style="warning" %}
Pembantu AI berfungsi paling baik dengan **spesifik** **soalan**. \
Daripada *"tunjukkan saya jualan,"* 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 butang <mark style="color:$primary;">`Carta`</mark> 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 keputusan bergantung pada syarat yang anda tulis, semak output untuk mengesahkan bahawa ia sepadan dengan jangkaan anda.

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

Selepas pertanyaan anda berjaya dijalankan, anda boleh mengeksport keputusan 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 segerak (🔄) di bahagian bawah bar sisi.
{% endhint %}

***

## Pembolehubah Pertanyaan

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

Apabila anda menyimpan pertanyaan, ahli pasukan anda boleh memasukkan nilai mereka sendiri dalam medan pembolehubah dan menjalankan laporan itu pada bila-bila masa mereka perlukan.

#### 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 keputusan akan menunjukkan semua item dengan *“sweater”* dalam namanya.

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

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

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

***

## Contoh

Analitik Tersuai termasuk templat terbina dalam yang boleh anda jalankan serta-merta. 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>

***

**Ada lebih banyak soalan?** Lihat FAQ Analitik Tersuai kami:

{% content-ref url="/spaces/8A9ZEY4416TjPUs4LWRq/pages/0680b614d31c5a8273c27ea35232a5d440b9427f" %}
[Analitik tersuai](/docs/faq/ms/laporan/analitik-tersuai.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/ms/ciri-lain/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.