> 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/ff5e60b1c6b77fd5250c0ccec04dcf95c1103a80" 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** sesebuah laporan dengan sejarah versi terbina dalam.
* **Visualkan data anda** dengan carta atau eksportkannya ke Excel.

## Kes Penggunaan

Ciri standard <mark style="color:$primary;">`Laporan Inventori`</mark> ciri ini menyediakan gambaran pantas tentang metrik utama seperti purata kuantiti stok dan pusing ganti inventori untuk tempoh yang dipilih. Oleh sebab laporan ini menggunakan pemboleh ubah dan formula yang dipratentukan, ia mungkin tidak merangkumi setiap jenis laporan yang pasukan anda perlukan.

<mark style="color:$primary;">`Analitik Tersuai`</mark> memberi 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 memperoleh 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?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/962c957b64db1649124faed7790e9ce9/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

***

## 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 tanya Pembantu AI untuk data yang anda perlukan.

<figure><img src="/files/d5b8917b1a9afb03d70965398b02f5c42f9d6191" 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

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

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

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

{% hint style="success" %}
Seberapa khusus yang mungkin tentang **syarat** dan **lajur** yang anda mahu. Semakin banyak butiran yang anda berikan, semakin rapat laporan itu akan memenuhi keperluan anda.
{% endhint %}

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

<figure><img src="/files/386820afbd61645fbee2758d32bcc0a9bea77f51" alt=""><figcaption></figcaption></figure>

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

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

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

### 3. Gunakan Data Anda

Hasil 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 memvisualkannya sebagai graf — bar, garis, pai, bar bertindan, dan kawasan bertindan semuanya disokong.

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

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

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

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

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

{% hint style="warning" %}
Untuk medan dengan berbilang keadaan, seperti [status pesanan](/docs/documentation/ms/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 jangkaan. Pastikan anda mengesahkan output sebelum menggunakannya dalam kerja anda.
{% endhint %}

***

## Templat

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

<figure><img src="/files/ec4d7c16e9bf0b7f374b3ff01232c0b3ff93c665" 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 [DuckDB SQL](https://duckdb.org/docs/current/sql/introduction) sintaks untuk menyesuaikan laporan 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="/files/7932c1cd905b193ee008d2355be78ca1b30ad747" alt=""><figcaption></figcaption></figure>

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

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

Ini mencipta sebuah input **medan** **input** bernama item\_name. Masukkan kata kunci seperti *sweater*, dan hasilnya akan menunjukkan setiap item dengan "sweater" dalam namanya.

<figure><img src="/files/732800545c7e5e4d781abb8e7b91c8741831f45c" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Sentiasa semak hasil anda sebelum anda 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/analitik-tersuai.md)
{% endcontent-ref %}
