> 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

Tanya Pembantu AI untuk data inventori yang anda perlukan dan bina laporan tersuai melebihi laporan standard. Visualisasikan sebagai carta, simpan untuk dijalankan semula, atau eksport ke Excel.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F8f2NEkEhdQsg9pez8Au6%2F03_Custom%20Analytics.png?alt=media&amp;token=85ad84c6-bc6f-40c3-a3e6-80facea29784" alt="Custom Analytics"><figcaption></figcaption></figure>

***

## Sorotan Utama

* **Tanya Pembantu AI** untuk data inventori yang anda perlukan menggunakan bahasa mudah.
* **Bina laporan tersuai** dengan menggabungkan syarat seperti item, atribut, harga, julat tarikh, rakan kongsi dan banyak lagi.
* **Simpan laporan yang kerap digunakan** supaya anda boleh mengaksesnya semula pada bila-bila masa.
* **Pulihkan versi terdahulu** sesuatu laporan dengan sejarah versi terbina dalam.
* **Visualisasikan data anda** dengan carta atau eksportkannya ke Excel.

## Kes Penggunaan

Standard <mark style="color:$primary;">`Laporan Inventori`</mark> ciri ini menyediakan paparan pantas metrik utama seperti kuantiti stok purata dan pusing ganti inventori untuk tempoh yang dipilih. Oleh sebab laporan ini menggunakan pembolehubah dan formula yang dipratetapkan, ia mungkin tidak merangkumi setiap jenis laporan yang diperlukan oleh pasukan anda.

<mark style="color:$primary;">`Analitik Tersuai`</mark> memberikan anda lebih fleksibiliti untuk bekerja dengan data inventori anda. Hanya tanya **Pembantu AI** untuk data yang anda perlukan, termasuk syarat dan lajur yang anda mahu, dan dapatkan laporan tersuai dalam beberapa saat. Ia amat berguna apabila:

* Anda tidak dapat mendapatkan data yang anda perlukan daripada laporan inventori standard
* Anda mahu memecahkan data mengikut syarat terperinci seperti item, pembekal, pelanggan atau ahli pasukan
* Anda perlu membandingkan data merentas tempoh masa yang berbeza, seperti bulanan, suku tahunan atau tahun ke tahun
* Anda memerlukan data khusus untuk menyokong pelaporan atau membuat keputusan

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/962c957b64db1649124faed7790e9ce9/iframe?poster=https%3A%2F%2Fcustomer-0jrbilsa8yt3k758.cloudflarestream.com%2F962c957b64db1649124faed7790e9ce9%2Fthumbnails%2Fthumbnail.jpg%3Fheight%3D1080%26time%3D12s&letterboxColor=transparent>" %}

***

## Cara Menggunakan Analitik Tersuai

### 1. Buka Pembantu AI

Pergi ke <mark style="color:$primary;">`Laporan`</mark> > <mark style="color:$primary;">`Analitik Tersuai`</mark>.

Jika ini kali pertama anda,  **AI** **Pembantu** akan dibuka secara automatik. Jika tidak, klik <mark style="color:$primary;">`+ Laporan Baharu`</mark> untuk memulakan laporan baharu dan meminta Pembantu AI untuk data yang anda perlukan.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2F1tkEUK9CKUExy7wD4Rz4%2Fcustom-analytics-new%20report.jpg?alt=media&amp;token=ee042537-ca08-4d8f-92ff-d8c6a9d50c27" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Kedua-dua **pentadbir** dan **ahli** boleh mencipta dan melihat laporan tersuai. Anda boleh mengehadkan akses dengan menyediakan [Peranan Tersuai](/docs/documentation/ms/konsep/members.md#custom-roles-and-permissions).
{% endhint %}

### 2. Minta Data Anda

Tanya  <mark style="color:$primary;">`Pembantu AI`</mark> untuk data yang anda perlukan dalam bahasa mudah.

Contohnya, masukkan: *"Tunjukkan paras stok minggu lepas mengikut kategori"* dan pembantu akan mencipta laporan berdasarkan permintaan anda.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FuApVLbVKfrsPKoqH127E%2Fcustom-analytics-ai%20assistant-question-1.jpg?alt=media&amp;token=17e162da-c125-480c-a8b7-70152de0a414" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Jadilah serinci mungkin tentang **syarat** dan **lajur** yang anda mahu. Semakin banyak butiran yang anda berikan, semakin tepat laporan itu akan menepati keperluan anda.
{% endhint %}

> "Tunjukkan saya data jualan minggu lepas."\
> "Tunjukkan jumlah unit terjual dan hasil jualan mengikut item untuk bulan lepas, 10 teratas mengikut hasil."

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fl9jVsT9QdncYhqTCscK8%2Fcustom-analytics-ai%20assistant-question.jpg?alt=media&amp;token=32beddae-ad86-45a4-ab08-9d30a68afb84" alt=""><figcaption></figcaption></figure>

Jika anda menjalankan laporan yang sama berulang kali dengan nilai carian yang berbeza, minta Pembantu AI menambah **input** **medan**. Setelah ditambah, anda boleh memasukkan nilai baharu setiap kali tanpa perlu mencipta laporan itu semula.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FY5rotdlFmesjUGZHW9BB%2Fcustom-analytics-input%20field.jpg?alt=media&amp;token=1e6b3b9f-7732-440a-8cb0-6445bc91c88e" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Gunakan **input** **medan** untuk nilai yang sering berubah, seperti nama item, tarikh atau pembekal.
{% endhint %}

### 3. Gunakan Data Anda

Keputusan dipaparkan dalam jadual. Klik <mark style="color:$primary;">`Eksport ke Excel`</mark> untuk memuat turun, atau klik <mark style="color:$primary;">`Tambah Carta`</mark> untuk memvisualisasikannya sebagai graf — bar, garis, pai, bar bertindan dan kawasan bertindan semuanya disokong.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FGKTCDKf2LivE5oKusPyt%2Fcustom-analytics-results.jpg?alt=media&amp;token=62a657eb-3fd7-4bf7-8a14-3e24d741e771" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FiwGxjrQuzuWlQyRiPorT%2Fcustom-analytics-chart-settings.jpg?alt=media&amp;token=db3b4037-bf14-4681-a3d3-4ea794f1e8e7" alt=""><figcaption></figcaption></figure>

Keputusan disimpan secara automatik ke <mark style="color:$primary;">`Laporan Saya`</mark>, supaya anda boleh membukanya dan menjalankannya semula pada bila-bila masa. Jika anda membuat perubahan yang tidak disengajakan, anda boleh mengembalikan laporan kepada versi terdahulu — klik <mark style="color:$primary;">`...`</mark> (lagi) > <mark style="color:$primary;">`sejarah versi`</mark>.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FYOGLUDtJo9FQPI1RlO2f%2Fcustom%20analytics-my%20reports-sync-version%20history.jpg?alt=media&amp;token=bb621083-03b6-4c1d-9a55-9c1477173c59" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Data anda disegerakkan secara automatik **sekali sehari**. Untuk melihat data terkini, klik **butang segerak** (🔄) di bahagian bawah kiri sebelum menjalankan laporan anda.
{% endhint %}

{% hint style="warning" %}
Untuk medan dengan berbilang keadaan, seperti [status pesanan](/docs/documentation/ms/ciri-ciri-utama/purchase-and-sales.md#purchase-order-status), tafsiran AI mungkin berbeza daripada yang anda maksudkan. Data yang dipadam juga mungkin dikendalikan secara berbeza daripada yang dijangka. Pastikan anda mengesahkan output sebelum menggunakannya dalam kerja anda.
{% endhint %}

***

## Templat

Analitik Tersuai termasuk templat terbina dalam yang boleh anda jalankan terus. Cuba templat untuk melihat hasilnya. Jika anda mendapati satu yang berguna, klik <mark style="color:$primary;">`Simpan ke Laporan Saya`</mark> dan laraskannya mengikut keperluan anda.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FD55hFLgh6bZtpuqsZOSJ%2Fcustom-analytics-templates.jpg?alt=media&amp;token=f368d8d7-3a59-41d4-8490-982fdd80853b" alt=""><figcaption></figcaption></figure>

#### Contoh

* Jumlah Inventori Harian
* Ringkasan Transaksi Mingguan
* Trend Pembelian & Jualan Bulanan
* Tarikh Kehabisan Stok Terakhir mengikut Item
* Penilaian Inventori FIFO
* Inventori Tersedia

***

## Penyuntingan SQL

Jika anda selesa dengan SQL, anda boleh menyunting pertanyaan secara terus menggunakan [SQL DuckDB](https://duckdb.org/docs/current/sql/introduction) sintaks untuk menyesuaikan laporan dengan tepat seperti yang anda mahu.

Pilih laporan, klik <mark style="color:$primary;">`...`</mark> butang di penjuru kanan atas, dan pilih <mark style="color:$primary;">`Sunting SQL`</mark>.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FuRvm3pRez0cVPJVabxNv%2Fcustom-analytics-edit-SQL.jpg?alt=media&amp;token=11916f5f-552f-4423-8365-8974ebd1351d" alt=""><figcaption></figcaption></figure>

Anda juga boleh menambah medan input dengan memasukkan <mark style="color:$primary;">`{{variable_name}}`</mark> dalam pertanyaan anda. Contohnya:

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

Ini mencipta satu **input** **medan** yang dinamakan item\_name. Masukkan kata kunci seperti *sweater*, dan hasil akan menunjukkan setiap item yang mempunyai "sweater" dalam namanya.

<figure><img src="https://4224534249-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2FVdQgFGRBpnXK42JGTr9r%2Fcustom%20analtyics-edit%20SQL.jpg?alt=media&amp;token=7d92eaeb-c29e-486c-8381-75c35d5dd826" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Sentiasa semak hasil anda sebelum bergantung padanya.
{% endhint %}

***

## Soalan Lazim

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

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