> 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

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

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

* **Otomatisasi** menghemat waktu dengan menggunakan kembali kueri dan berintegrasi 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 menggunakan informasi basis data mentah yang terbaru.
* **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 menggerakkan semua tampilan    | Setiap ubin memiliki kuerinya sendiri |
| Tata letak       | Tetap: tabel data, bagan, peta lokasi     | Kanvas seret dan lepas                |
| Ekspor           | HTML, Excel, PDF                          | Hanya skema JSON                      |
| Kasus penggunaan | Analisis satu dataset yang dapat diekspor | Pemantauan operasional multi-panel    |

Gunakan laporan saat satu dataset perlu dijelajahi sebagai tabel, divisualisasikan sebagai grafik, dan dipetakan secara bersamaan, atau saat keluaran perlu diekspor dan dibagikan di luar Dashboard Studio. Gunakan dasbor saat Anda memerlukan beberapa visualisasi independen pada satu kanvas, misalnya: menggabungkan ubin statistik ringkasan perjalanan, grafik 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 **Tools**, lalu pilih **New report**.

Dashboard Studio meminta Anda memilih bagian dari struktur menu bersama Anda. Pilih bagian yang sudah ada atau 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 untuk tabel IoT Query Anda. Kueri menentukan ketiga komponen (tabel, grafik, 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.object_label,
    -- Mengonversi koordinat bilangan bulat yang diskalakan menjadi derajat desimal
    t.latitude::float / 10000000 AS latitude,
    t.longitude::float / 10000000 AS longitude,
    -- Mengonversi kecepatan bilangan bulat yang diskalakan menjadi km/jam
    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 membangun kueri:

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

{% step %}

#### Langkah 4: Konfigurasikan komponen

Klik tab **Components** tab. Tersedia tiga komponen: **Tabel**, **Bagan**, 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 berhalaman.

* **Page Size**: menetapkan berapa banyak baris yang muncul per halaman dalam tampilan interaktif. Ini tidak memengaruhi ekspor, yang selalu berisi seluruh set hasil.
* **Show Totals Row**: menambahkan baris ringkasan di bagian bawah tabel saat diaktifkan.
  {% endtab %}

{% tab title="Bagan" %}
Dua jenis grafik tersedia:

* **Time series (line)**: cocok untuk data yang diplot berdasarkan waktu.
* **Diagram batang**: cocok untuk perbandingan kategoris (juga disebut sebagai grafik kolom).

Konfigurasikan sumbu:

* **Kolom sumbu X**: biasanya kolom waktu seperti `device_time`.
* **Kolom sumbu Y**: satu atau lebih kolom numerik, seperti speed atau `fuel_level`.
* **Kelompokkan berdasarkan**: opsional membagi deret berdasarkan kolom kategoris, seperti `object_label`, untuk menampilkan garis atau kelompok batang terpisah per perangkat.
  {% endtab %}

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

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

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

{% step %}

#### Langkah 5: Simpan laporan

Klik Save. Laporan akan 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 akan langsung terbuka. Anda akan melihat semua komponen yang dikonfigurasi dirender dengan data langsung dari basis data IoT Query Anda. Header laporan menampilkan cap waktu pembaruan terakhir, total jumlah baris, dan waktu eksekusi kueri.

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

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

### Tabel data

Buku Resep SQL **Data Table** bagian menampilkan hasil kueri dengan header bagian yang memperlihatkan total jumlah baris yang dikembalikan oleh kueri. Tampilan interaktif hanya menampilkan jumlah baris yang terbatas, footer mengonfirmasi jumlah pastinya. Gunakan dropdown **Download** di dalam bagian

Jika Anda memerlukan lokasi alih-alih koordinat mentah, centang kotak **Geocode to address** di kanan atas header **Data Table** . Saat diaktifkan, fitur ini mengubah kolom koordinat menjadi alamat jalan yang dapat dibaca.

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

### Bagan

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

* **Sumbu X**: pilih kolom yang akan diplot pada sumbu horizontal.
* **Sumbu Y**: pilih kolom yang akan diplot pada sumbu vertikal.
* **Kelompokkan berdasarkan**: opsional membagi deret berdasarkan kolom kategoris, seperti `object_label`, untuk menampilkan garis atau kelompok batang terpisah per perangkat.

Grafik menampilkan judul yang dibuat otomatis yang menjelaskan sumbu dan pemilihan pengelompokan saat ini, misalnya: `speed over device_time (grouped by object_label)`. Saat Anda mengubah pengaturan sumbu tanpa menyimpan, indikator **Unsaved changes** muncul di sebelah tombol **Save Chart Settings** . Klik tombol tersebut untuk menyimpan perubahan konfigurasi di laporan.

### Peta lokasi

Buku Resep SQL **Location Map** bagian menampilkan setiap baris kueri sebagai titik pada koordinat GPS-nya. Header bagian menunjukkan jumlah titik yang diplot. Kolom GPS ditentukan saat pembuatan laporan (secara otomatis atau manual), dan tidak dapat diedit setelahnya. Jika kueri tidak mengembalikan kolom koordinat yang dikenali, bagian tersebut menampilkan "No GPS coordinates detected in query results."

Untuk data telematika bertimestamp, titik yang diplot mewakili seluruh lintasan suatu objek selama periode yang dikueri.

{% hint style="info" %}
Peta bersifat interaktif: zoom dan geser untuk memeriksa titik-titik individual. Klik **Show all** untuk memperkecil tampilan dan menyesuaikan semua titik yang diplot di dalam area peta yang terlihat.
{% endhint %}

## Mengekspor laporan

Dashboard Studio menyediakan dua tingkat ekspor.

### Ekspor tabel data

Gunakan dropdown **Download** di dalam bagian **Data Table** untuk mengekspor hanya data tabel. Ekspor selalu berisi seluruh set hasil yang dikembalikan oleh kueri, terlepas dari batas tampilan dalam tampilan interaktif.

### Ekspor laporan penuh

Gunakan tombol di header laporan untuk mengekspor semua komponen sekaligus.

| Tombol                | Output                                                     |
| --------------------- | ---------------------------------------------------------- |
| Excel → Excel (.xlsx) | Spreadsheet dengan tabel data lengkap                      |
| Excel → CSV (.csv)    | File nilai dipisahkan koma dengan tabel data lengkap       |
| HTML                  | File interaktif dengan tabel data, grafik, dan peta lokasi |
| PDF                   | Dokumen statis dengan tabel data, grafik, dan peta lokasi  |

{% hint style="info" %}
File HTML yang diekspor mempertahankan interaktivitas: grafik 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 satu kali saat pembuatan laporan.

Untuk menghapus laporan, klik **Tools** di bilah sisi kiri, lalu pilih **Edit menu**. Temukan laporan di pohon menu dan klik menu tiga titik di samping namanya, lalu konfirmasikan 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.