> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/id/dashboard-studio/creating-reports.md).

# Membuat laporan

Hasilkan laporan yang dapat diekspor dengan tabel data, diagram, dan peta lokasi terkoordinasi dari satu kueri SQL. Ekspor ke HTML, Excel, atau PDF

Laporan memberi Anda cara terstruktur untuk menganalisis data IoT Query melalui tiga tampilan yang terkoordinasi dari satu kueri SQL: tabel data berhalaman, bagan, dan peta interaktif. Gunakan laporan ketika Anda memerlukan keluaran yang tetap dan dapat diekspor, bukan kanvas dasbor yang fleksibel.

Laporan SQL kustom langsung menyesuaikan diri dengan pertanyaan bisnis apa pun dengan menyesuaikan kueri dan parameter:

* **Otomatisasi** menghemat waktu dengan menggunakan kembali kueri dan mengintegrasikannya dengan alat BI untuk pembaruan cepat.
* **Analisis mendalam** dimungkinkan dengan menggabungkan, mengagregasi, dan mensegmentasi data dari berbagai sumber.
* **Akurasi dan relevansi** dipastikan dengan bekerja langsung dengan informasi basis data mentah yang mutakhir.
* **Visualisasi interaktif** memungkinkan pengguna menjelajahi data secara dinamis dengan menyesuaikan sumbu, filter, dan metrik.

Tonton video ini untuk mengenal pembuatan laporan di antarmuka aplikasi Dashboard Studio:

{% embed url="<https://youtu.be/o2j96_0gp-w?si=yBE9SrsET6gZa-EN>" %}
Membuat laporan di Dashboard Studio langkah demi langkah
{% endembed %}

## Laporan vs. dasbor

Baik laporan maupun dasbor menjalankan kueri SQL terhadap basis data IoT Query Anda dan menampilkan hasil sebagai visualisasi. Perbedaan utamanya terletak pada cara kueri dan keluaran disusun:

|                  | Laporan                                    | Dasbor                              |
| ---------------- | ------------------------------------------ | ----------------------------------- |
| Kueri SQL        | Satu kueri mendukung semua tampilan        | Setiap petak memiliki kueri sendiri |
| Tata letak       | Tetap: tabel data, bagan, peta lokasi      | Kanvas seret dan lepas              |
| Ekspor           | HTML, Excel, PDF                           | Skema JSON, PDF                     |
| Kasus penggunaan | Analisis satu set data yang dapat diekspor | Pemantauan operasional multi-panel  |

Gunakan laporan ketika satu set data perlu dijelajahi sebagai tabel, divisualisasikan sebagai bagan, dan dipetakan secara bersamaan, atau ketika keluarannya perlu diekspor dan dibagikan di luar Dashboard Studio. Gunakan dasbor ketika Anda memerlukan beberapa visualisasi independen pada satu kanvas, misalnya: menggabungkan petak statistik ringkasan perjalanan, bagan konsumsi bahan bakar, dan tabel kunjungan zona dalam satu tampilan.

Untuk detail tentang pembuatan dasbor, lihat [Membuat dasbor](/docs/analytics/id/dashboard-studio/creating-dashboards.md).

## Cara membuat laporan

{% stepper %}
{% step %}

#### Langkah 1: Buka editor laporan

Di bilah sisi kiri, klik **Alat**, lalu pilih **Laporan baru**.

Dashboard Studio meminta Anda memilih bagian dari struktur menu bersama Anda. Pilih bagian yang sudah ada atau pilih Root untuk menempatkan laporan di tingkat teratas.
{% endstep %}

{% step %}

#### Langkah 2: Masukkan informasi dasar

Editor terbuka dengan dua bidang di bagian atas:

* **Judul** (wajib): nama yang ditampilkan di menu dan header ekspor.
* **Deskripsi** (opsional): konteks tambahan yang terlihat di editor.
  {% endstep %}

{% step %}

#### Langkah 3: Tulis kueri SQL

1. Klik tab **Kueri SQL** dan masukkan pernyataan SELECT pada tabel IoT Query Anda. Kueri tersebut menentukan ketiga komponen (tabel, bagan, dan peta), jadi sertakan setiap kolom yang ingin Anda gunakan di semua tampilan, misalnya:

{% code title="Contoh kueri laporan dasar" expandable="true" %}

```sql
SELECT
    t.device_id,
    o.Pelacak_label,
    -- Konversikan koordinat bilangan bulat berskala menjadi derajat desimal
    t.latitude::float / 10000000 AS latitude,
    t.longitude::float / 10000000 AS longitude,
    -- Konversi kecepatan bilangan bulat berskala ke km/h
    t.speed::float / 100 AS speed,
    t.device_time
FROM raw_telematics_data.tracking_data_core t
JOIN raw_business_data.objects o ON t.device_id = o.device_id
LIMIT 1000
```

{% endcode %}

{% hint style="info" icon="lightbulb-exclamation" %}

#### Beberapa tips untuk pembuatan kueri:

* Tambahkan klausa LIMIT saat mengonfigurasi laporan. Ini mengurangi waktu eksekusi kueri dan mempercepat pratinjau komponen. Hapus atau tingkatkan batas sebelum menyimpan jika Anda memerlukan seluruh set data tersedia untuk diunduh.
* Setelah menulis kueri, Anda dapat mengeklik **Detect Columns** untuk memeriksa kolom apa saja yang sebenarnya diambil dengan kueri ini. Ini membantu menyiapkan pemilih kolom di **Components** tab. Langkah ini opsional. Anda dapat mengonfigurasi komponen secara manual, tetapi menjalankannya terlebih dahulu menyederhanakan pemilihan sumbu dan bidang.
* Setiap kueri SQL yang digunakan di panel dasbor merupakan titik awal yang valid untuk laporan. Salin kueri dari panel dan sesuaikan agar sesuai dengan tujuan laporan. Misalnya, dengan menambahkan kolom yang diperlukan untuk peta lokasi, atau menghapus agregasi yang tidak berlaku untuk tampilan tabel.
* Buku Resep IoT Query berisi contoh kueri umum dan khusus industri yang siap digunakan sebagai dasar untuk laporan. Lihat [Buku resep SQL](/docs/analytics/id/example-queries.md) untuk daftar lengkapnya.
  {% endhint %}
  {% endstep %}

{% step %}

#### Langkah 4: Konfigurasikan komponen

Klik tab **Components** tab. Tiga komponen tersedia: **Tabel**, **Grafik**, dan **Peta**. Masing-masing memiliki sakelar untuk menyertakan atau mengecualikannya dari laporan. Anda dapat menghapus komponen apa pun yang tidak Anda perlukan.

{% tabs %}
{% tab title="Tabel data" %}
Tabel data menampilkan hasil kueri dalam baris per halaman.

* **Ukuran halaman**: mengatur berapa banyak baris yang muncul per halaman dalam tampilan interaktif. Ini tidak memengaruhi ekspor, yang selalu berisi seluruh hasil.
* **Tampilkan baris total**: menambahkan baris ringkasan di bagian bawah tabel saat diaktifkan.
  {% endtab %}

{% tab title="Grafik" %}
Tersedia dua jenis bagan:

* **Deret waktu (garis)**: cocok untuk data yang diplot sepanjang waktu.
* **Diagram batang**: cocok untuk perbandingan kategori (juga disebut diagram kolom).

Konfigurasikan sumbu:

* **Kolom sumbu X**: biasanya kolom waktu seperti `device_time`.
* **Kolom sumbu Y**: satu atau beberapa kolom numerik, seperti kecepatan atau `level bahan bakar`.
* **Kelompok berdasarkan**: secara opsional memisahkan deret berdasarkan kolom kategoris, seperti `label pelacak`, untuk menampilkan garis atau kelompok batang terpisah per perangkat.
  {% endtab %}

{% tab title="Peta lokasi" %}
Peta lokasi memplot titik data menggunakan koordinat GPS.

Dashboard Studio dapat mendeteksi otomatis kolom lintang dan bujur dari hasil kueri Anda. Saat **Deteksi otomatis kolom GPS** sakelar diaktifkan, kolom yang diperlukan untuk menentukan lokasi (biasanya `lintang` dan `bujur`) dipilih secara otomatis jika kueri Anda mengembalikannya.

Anda juga dapat menonaktifkan **deteksi otomatis** opsi dan memilih kolom yang diperlukan secara manual.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### Langkah 5: Simpan laporan

Klik Simpan. Laporan muncul di bagian menu yang Anda pilih pada langkah 1 dan dapat diakses oleh semua pengguna yang memiliki akses ke bagian tersebut.
{% endstep %}
{% endstepper %}

## Melihat laporan

Setelah Anda membuat laporan, laporan tersebut akan terbuka segera. Anda akan melihat semua komponen yang dikonfigurasi ditampilkan dengan data langsung dari basis data IoT Query Anda. Header laporan menampilkan stempel waktu pembaruan terakhir, jumlah baris total, dan waktu eksekusi kueri.

Halaman laporan juga menampilkan kueri SQL secara langsung, sehingga Anda dapat memperbaruinya kapan pun Anda perlu.

1. Perluas **Kueri SQL** bagian untuk melihat atau mengedit pernyataan secara langsung.
2. Terapkan perubahan:
   1. Klik **Simpan** untuk menyimpan perubahan tanpa menjalankannya. Anda perlu mengklik **Segarkan** untuk menjalankan ulang kueri dan memperbarui semua tampilan dengan data terkini.
   2. **Simpan & Jalankan** untuk segera menerapkan kueri yang diperbarui.

### Tabel data

Tabel **data** bagian ini menampilkan hasil kueri dengan header bagian yang menampilkan total jumlah baris yang dikembalikan oleh kueri. Tampilan interaktif hanya menampilkan jumlah baris terbatas, footer mengonfirmasi jumlah pastinya. Gunakan **Unduh** menu tarik-turun untuk mengekspor seluruh kumpulan hasil sebagai Excel (.xlsx) atau CSV (.csv), berapa pun jumlah baris yang ditampilkan tampilan interaktif.

Jika Anda memerlukan lokasi alih-alih koordinat mentah, centang **Geokode ke alamat** kotak di kanan atas dari **data** header. Saat diaktifkan, fitur ini mengubah kolom koordinat menjadi alamat jalan yang dapat dibaca.

{% hint style="warning" %}
Resolusi alamat memberi beban yang signifikan pada server. Gunakan opsi ini hanya dengan set data yang diagregasi atau difilter. Untuk data telematika mentah dengan puluhan ribu baris, pertahankan koordinat dalam bentuk numerik.
{% endhint %}

### Grafik

Bagian grafik ditampilkan di bawah tabel data. Bagian ini mewarisi pengaturan yang Anda terapkan di editor laporan, tetapi Anda juga dapat menyesuaikan konfigurasi sumbu secara langsung di tampilan:

* **Sumbu X**: pilih kolom untuk diplot pada sumbu horizontal.
* **Sumbu Y**: pilih kolom yang akan diplot pada sumbu vertikal.
* **Kelompok berdasarkan**: secara opsional memisahkan deret berdasarkan kolom kategoris, seperti `label pelacak`, untuk menampilkan garis atau kelompok batang terpisah per perangkat.

Grafik menampilkan judul yang dibuat otomatis yang menjelaskan pilihan sumbu dan pengelompokan saat ini, misalnya: `kecepatan menurut device_time (dikelompokkan berdasarkan object_label)`. Saat Anda mengubah pengaturan sumbu tanpa menyimpan, sebuah **Perubahan yang belum disimpan** indikator muncul di samping **Simpan pengaturan bagan** tombol. Klik tombol itu untuk menyimpan perubahan konfigurasi dalam laporan.

Ketika **Kelompok berdasarkan** membagi bagan menjadi kelompok-kelompok, bagan menampilkan 10 kelompok pertama. Untuk memilih kelompok lain, klik **Kelompok**, yang menunjukkan berapa banyak kelompok yang ditampilkan dari totalnya. Dalam daftar, klik suatu kelompok untuk menampilkannya atau menghapusnya dari bagan. Untuk menemukan kelompok, cari berdasarkan namanya.

Baris tanpa nilai pada **Kelompok berdasarkan** kolom tidak termasuk dalam kelompok mana pun, dan bagan mengabaikannya. **Pilih semua** dan **Kosongkan** berlaku pada kelompok yang sesuai dengan pencarian. **Pilih semua** tidak tersedia ketika akan menampilkan lebih dari 1.000 kelompok secara total. Daftar menampilkan hingga 100 kelompok yang tidak ditampilkan, jadi cari untuk menemukan yang lain. Untuk kembali ke 10 kelompok pertama, klik **Setel ulang ke default**. Dashboard Studio tidak menyimpan pilihan kelompok. Pilihan ini akan diatur ulang ketika Anda membuka laporan lagi atau memilih kolom lain. **Kelompok berdasarkan** kolom.

### Peta lokasi

Tabel **Peta lokasi** bagian menampilkan setiap baris kueri sebagai titik pada koordinat GPS-nya. Judul bagian menampilkan jumlah titik yang ditampilkan. Kolom GPS ditentukan saat pembuatan laporan (secara otomatis atau manual), dan tidak dapat diedit setelahnya. Jika kueri tidak mengembalikan kolom koordinat yang dikenali, bagian menampilkan "Tidak ada koordinat GPS yang terdeteksi dalam hasil kueri."

Untuk data telematika bertanda waktu, titik yang ditampilkan merepresentasikan lintasan lengkap sebuah objek selama periode kueri.

{% hint style="info" %}
Peta ini interaktif: zoom dan geser untuk memeriksa titik individual. Klik **Tampilkan semua** untuk memperkecil tampilan dan memuat semua titik yang ditampilkan ke dalam area peta yang terlihat.
{% endhint %}

## Mengekspor laporan

Dashboard Studio menyediakan dua tingkat ekspor.

### Ekspor tabel data

Gunakan **Unduh** menu tarik turun di dalam **data** bagian untuk mengekspor hanya data tabel. Ekspor selalu memuat seluruh set hasil yang dikembalikan oleh kueri, terlepas dari batas tampilan pada tampilan interaktif.

### Ekspor laporan lengkap

Gunakan tombol di header laporan untuk mengekspor semua komponen sekaligus.

| Tombol                | Keluaran                                                    |
| --------------------- | ----------------------------------------------------------- |
| Excel → Excel (.xlsx) | Lembar kerja dengan tabel data lengkap                      |
| Excel → CSV (.csv)    | Berkas nilai yang dipisahkan koma dengan tabel data lengkap |
| HTML                  | Berkas interaktif dengan tabel data, bagan, dan peta lokasi |
| PDF                   | Dokumen statis dengan tabel data, bagan, dan peta lokasi    |

Bagan dalam berkas HTML atau PDF menampilkan kelompok yang sama seperti bagan di layar. Ketika bagan hanya menampilkan sebagian kelompok, berkas tersebut menampilkan jumlah kelompok yang ditampilkan dan jumlah total kelompok.

{% hint style="info" %}
Berkas HTML yang diekspor mempertahankan interaktivitas: bagan mendukung tooltip saat diarahkan dan peta lokasi mendukung zoom dan geser.
{% endhint %}

## Mengedit dan menghapus laporan

Untuk mengedit laporan yang disimpan, Anda tidak lagi memerlukan dialog editor terpisah. Buka laporan dari menu dan ubah kueri SQL atau pengaturan komponen langsung di dalamnya. Satu-satunya pengecualian adalah kolom lokasi, yang ditentukan sekali saat pembuatan laporan.

Untuk menghapus laporan, klik **Alat** di bilah sisi kiri, lalu pilih **Menu edit**. Temukan laporan di pohon menu dan klik menu tiga titik di sebelah namanya, lalu konfirmasi penghapusan.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/analytics/id/dashboard-studio/creating-reports.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.