> 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/id/fitur-lainnya/custom-analytics.md).

# Analitik Kustom

<figure><img src="/files/57a076cbea03a8487b65595992d6ea7a3c1db804" alt=""><figcaption></figcaption></figure>

***

## Sorotan Utama

* Ajukan pertanyaan dalam bahasa sederhana dan **Asisten AI** menulis SQL untuk Anda.
* Gunakan SQL untuk melakukan kueri pada data BoxHero Anda.
* Gabungkan kondisi (mis. item, atribut, harga, rentang tanggal, mitra) untuk menentukan data yang ingin Anda tampilkan sebagai laporan khusus.
* Simpan kueri yang sering Anda gunakan dan buka lagi kapan saja.
* Ekspor hasil ke Excel untuk analisis atau pelaporan tambahan.

## Kasus Penggunaan

Fitur standar <mark style="color:$primary;">`Laporan Inventaris`</mark> memberikan Anda gambaran cepat tentang metrik utama seperti rata-rata jumlah stok dan perputaran inventaris untuk periode yang dipilih. Karena laporan tersebut menggunakan rumus dan bidang yang telah ditentukan sebelumnya, laporan itu mungkin tidak mencakup setiap jenis analisis yang dibutuhkan tim Anda.

<mark style="color:$primary;">`Analitik Kustom`</mark> memberi Anda lebih banyak kendali atas cara Anda menjelajahi data Anda. Ini sangat berguna saat:

* Anda tidak dapat menemukan data yang Anda butuhkan di [Laporan Inventaris](/docs/documentation/id/fitur-lainnya/analytics.md)
* Anda ingin memfilter atau mengelompokkan data berdasarkan item, pemasok, pelanggan, anggota tim, atau kondisi detail lainnya
* Anda memerlukan analisis berbasis waktu seperti bulanan, triwulanan, atau per tahun
* Anda ingin menyimpan laporan yang Anda andalkan dan menggunakannya lagi
* Anda memerlukan data fleksibel untuk mendukung pelaporan atau pengambilan keputusan

***

## Cara Menggunakan Analitik Kustom

### 1. Memulai

Buka <mark style="color:$primary;">`Laporan`</mark> > <mark style="color:$primary;">`Analitik Kustom`</mark>. Ini membuka ruang kerja baru tempat Anda dapat membuat dan mengelola kueri SQL Anda. Lalu, pilih <mark style="color:$primary;">`+ Baru`</mark> untuk membuat kueri baru.

<figure><img src="/files/438897edb811b436eaf05573a5a760005002f9aa" alt=""><figcaption></figcaption></figure>

### 2. Menulis Kueri

Anda memiliki dua cara untuk menulis kueri:

1. **Gunakan Asisten AI** untuk menghasilkan SQL dari pertanyaan berbahasa sederhana (disarankan untuk sebagian besar pengguna).
2. **Tulis SQL secara langsung** menggunakan [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/31ed04dcb1ae47e1e182dd671dde8c9296891d42" alt=""><figcaption></figcaption></figure>

#### Menggunakan Asisten AI

Seorang <mark style="color:$primary;">`Asisten AI`</mark> mengubah pertanyaan berbahasa sederhana menjadi kueri SQL yang berfungsi. Anda tidak perlu tahu SQL untuk menggunakannya.&#x20;

Ketik pertanyaan Anda di panel asisten dan tekan enter. Asisten menghasilkan SQL, menerapkannya ke editor, dan menjalankannya. Hasil muncul di bawah kueri.

Anda dapat mengedit SQL yang dihasilkan sebelum menyimpannya jika Anda ingin menyesuaikan sesuatu.

{% 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 Pertanyaan**

* Item di bawah level stok aman
* Apa yang tidak terjual dalam 90 hari terakhir?
* 10 SKU teratas berdasarkan unit yang terjual bulan ini
* PO terbuka yang melewati tanggal kedatangan yang diharapkan
* Level stok berdasarkan lokasi&#x20;

#### Membuat Kueri yang Dapat Digunakan Kembali

Anda dapat meminta asisten untuk menyertakan filter yang dapat disesuaikan dalam kueri, seperti rentang tanggal atau nama mitra. Asisten menggunakan Variabel Kueri sehingga Anda dapat mengubah input nanti tanpa menulis ulang SQL.

Misalnya, meminta *"penjualan berdasarkan item untuk rentang tanggal yang bisa saya ubah"* menghasilkan kueri dengan variabel tanggal yang meminta input setiap kali kueri dijalankan.

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

{% hint style="warning" %}
Asisten AI bekerja paling baik dengan **pertanyaan** **yang spesifik**. \
Alih-alih *"tunjukkan penjualan kepada saya,"* coba *"10 item teratas berdasarkan pendapatan 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 tombol <mark style="color:$primary;">`Tombol Grafik`</mark> untuk memvisualisasikan data — grafik batang, garis, pai, batang bertumpuk, area bertumpuk didukung.
{% endhint %}

### 3. Menyimpan Kueri

Pilih <mark style="color:$primary;">`Jalankan`</mark> untuk menguji kueri Anda. Karena hasil bergantung pada kondisi yang Anda tulis, tinjau output untuk memastikan sesuai dengan yang Anda harapkan.

Jika Anda berencana menggunakan kembali kueri, pilih <mark style="color:$primary;">`Simpan`</mark> di sudut kanan atas. Kueri yang disimpan muncul di bilah sisi kiri, tempat Anda dapat membukanya dan menjalankannya kapan saja.

Setelah kueri Anda berhasil dijalankan, Anda dapat mengekspor hasilnya dengan <mark style="color:$primary;">`Ekspor ke Excel`</mark>.

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

{% hint style="info" %}
Data Anda disinkronkan secara otomatis **sekali sehari**.\
Untuk menyinkronkan segera, klik ikon sinkronisasi (🔄) di bagian bawah bilah sisi.
{% endhint %}

***

## Variabel Kueri

Jika Anda menyertakan `{{variable_name}}` dalam kueri Anda, kolom input akan dibuat secara otomatis saat kueri dijalankan. Nilai yang dimasukkan di kolom tersebut akan diterapkan ke variabel dalam kueri SQL Anda.

Saat Anda menyimpan kueri, anggota tim Anda dapat memasukkan nilai mereka sendiri di kolom variabel dan menjalankan laporan kapan pun mereka membutuhkannya.

#### Contoh

1. Untuk mencari item yang mengandung kata kunci tertentu, masukkan kueri berikut:

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

2. Saat Anda menjalankan kueri, kolom input bernama **item\_name** muncul.

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

3. Masukkan kata kunci seperti *`sweater`* dan hasilnya akan menampilkan semua item dengan *“sweater”* di namanya.

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

4. Simpan kueri jika Anda berencana menggunakannya lagi. Anda dapat memilih dan memuat kueri yang disimpan kapan saja dari menu sebelah kiri.

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

***

## Contoh

Analitik Kustom menyertakan templat bawaan yang dapat Anda jalankan langsung. Tinjau templat untuk memahami cara kerjanya, lalu sesuaikan atau buat kueri baru berdasarkan kebutuhan Anda.

#### Templat

* Laporan Stok Masuk/Keluar Mingguan
* Tren Pembelian dan Penjualan Bulanan
* Tanggal Pengiriman Keluar Terakhir per Item

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

***

## Pertanyaan yang Sering Diajukan

**Masih punya pertanyaan?** Lihat FAQ Analitik Kustom kami:

{% content-ref url="/spaces/m7VPubBRHE2g7Mw02zq7/pages/ec3520561ab46270c512662551732c7c4733b113" %}
[Analitik khusus](/docs/faq/id/pelaporan/analitik-khusus.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/id/fitur-lainnya/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.