# Analitik Kustom

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-d61c3469b2516c1c74f1c382fa03a7c10db659b6%2FCustom%20Analytics.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %} <mark style="color:biru;">**`Analitik Kustom`**</mark> saat ini berada dalam **beta**.\
Ini akan menjadi fitur berbayar setelah rilis resmi.
{% endhint %}

***

## Sorotan Utama

* Gunakan SQL untuk menanyakan data BoxHero Anda.
* Gabungkan kondisi (mis. item, atribut, harga, rentang tanggal, mitra) untuk menentukan data yang ingin Anda tampilkan sebagai laporan kustom.
* Simpan kueri yang sering Anda gunakan dan buka lagi kapan saja.
* Ekspor hasil ke Excel untuk analisis atau pelaporan tambahan.

## Kapan Menggunakan Analitik Kustom

Fitur standar <mark style="color:biru;">**`Laporan Inventaris`**</mark> memberi Anda tampilan cepat atas 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:biru;">**`Analitik Kustom`**</mark> memberi Anda lebih banyak kontrol atas cara Anda mengeksplorasi data. Ini sangat berguna ketika:

* Anda tidak dapat menemukan data yang Anda butuhkan di fitur standar [Laporan Inventaris](https://www.boxhero.io/docs/documentation/id/fitur-lainnya/analytics)
* Anda ingin memfilter atau mengelompokkan data berdasarkan item, pemasok, pelanggan, anggota tim, atau kondisi rinci lainnya
* Anda membutuhkan analisis berbasis waktu seperti bulanan, kuartalan, atau tahun ke tahun
* Anda ingin menyimpan laporan yang Anda andalkan dan menggunakannya lagi
* Anda membutuhkan data yang fleksibel untuk mendukung pelaporan atau pengambilan keputusan

***

## Cara Menggunakan Analitik Kustom

### 1. Memulai

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

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-6960754566997f8dfd56a04778905774d0b8c7d2%2Fcustom-analytics-welcome.png?alt=media" alt=""><figcaption></figcaption></figure>

### 2. Tulis Kueri

Kueri menggunakan [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction). Anda dapat mengunduh file <mark style="color:biru;">**`Prompt AI`**</mark> untuk melihat semua tabel dan kolom yang tersedia.

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-565c3ed88b69c6de48e7fade26e3212a3f034b19%2Fcustom-analytics-new-query.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Jika Anda menggunakan **alat AI** seperti ChatGPT atau Gemini, melampirkan file "*Prompt AI"* membantu menghasilkan SQL yang akurat.
{% endhint %}

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

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

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-cfc1d5c123f1352a5b6093f60ecedf6bc75136ae%2Fcustom-analytics-execute-sql-query.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Simpan Kueri

Jika Anda berencana menggunakan kueri lagi, pilih <mark style="color:biru;">**`Simpan`**</mark> di pojok kanan atas.

Kueri yang disimpan muncul di bilah sisi kiri, tempat Anda dapat membukanya dan menjalankannya kapan saja.

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-fbbe3777b87c3433ebdf88f73707514a4661997c%2Fcustom-analytics-monthly-revenue-spend.png?alt=media" 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, sebuah bidang input akan dibuat secara otomatis saat kueri dijalankan. Nilai yang dimasukkan di bidang tersebut akan diterapkan ke variabel dalam kueri SQL Anda.

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

#### Contoh

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

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

2. Saat Anda menjalankan kueri, sebuah bidang input bernama **item\_name** akan muncul.

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-0e37f6dcdc52cfcb1415c0e175422f65a0f0f922%2Fcustom-analytics-query-variables.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-6b0e5a3a5d226e5f678354e11ede42ce36f514eb%2Fcustom-analytics-query-variables-keyword.png?alt=media" 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="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-b428ef1d1d046a131901affe11e06926f0910343%2Fcustom-analytics-saved-query-variables.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Kasus Penggunaan

Analitik Kustom menyertakan templat bawaan yang dapat Anda jalankan segera. 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 Keluar Terakhir per Item

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-5bfafcad6d5c7a69353ac530532be7fd32f542b5%2Fcustom-analytics-saved-template-example.png?alt=media" alt=""><figcaption></figcaption></figure>

***

## Pertanyaan yang Sering Diajukan (FAQ)

### Apakah saya dapat menggabungkan data dari beberapa tim?

Tidak. Data dipisahkan berdasarkan tim, dan Anda hanya dapat menganalisis data dari tim yang sedang Anda masuki.

### Apakah saya dapat membatasi anggota agar tidak menggunakan Analitik Kustom?

Admin dan anggota dapat membuat dan melihat kueri. Anggota dengan izin khusus *tidak* memiliki akses ke fitur ini.

Jika Anda perlu membatasi akses untuk seorang anggota, tetapkan kepada mereka [izin khusus](https://www.boxhero.io/docs/documentation/id/pengaturan/members#custom-roles-and-permissions) dengan **semua izin dipilih**. Analitik Kustom *tidak* disertakan dalam opsi izin khusus, jadi bahkan dengan semua izin dipilih, anggota tersebut tidak akan memiliki akses.

<figure><img src="https://4009878440-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlRf1QqJGoevCQqGbfI80%2Fuploads%2Fgit-blob-ed545f8a01d471bb0d774157ef6209e756574a4c%2Fcustom-analytics-member-permissions.png?alt=media" alt=""><figcaption></figcaption></figure>
