> 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 Buat laporan yang dapat diekspor dengan tabel data, bagan, dan peta lokasi yang terkoordinasi dari satu kueri SQL. Ekspor ke HTML, Excel, atau PDF 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 ketika Anda memerlukan output tetap yang dapat diekspor, bukan kanvas dasbor bebas. Laporan SQL kustom beradaptasi secara instan 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 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="" %} 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 merender hasil sebagai visualisasi. Perbedaan utamanya terletak pada bagaimana kueri dan output disusun: | | Laporan | Dasbor | | ---------------- | ------------------------------------------- | -------------------------------------- | | Kueri SQL | Satu kueri memberi daya pada semua tampilan | Setiap petak memiliki kuerinya sendiri | | Tata letak | Tetap: tabel data, grafik, peta lokasi | Kanvas seret dan letakkan | | 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 ditelaah sebagai tabel, divisualisasikan sebagai grafik, dan dipetakan secara bersamaan, atau ketika output 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, 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 **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 level 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 **Kueri SQL** tab dan masukkan pernyataan SELECT ke tabel IoT Query Anda. Kueri ini mendefinisikan 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.pelacak_label, -- Ubah koordinat bilangan bulat berskala menjadi derajat desimal t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Ubah kecepatan bilangan bulat berskala 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 batas sebelum menyimpan jika Anda memerlukan seluruh dataset tersedia untuk diunduh. * Setelah menulis kueri, Anda dapat mengeklik **Detect Columns** untuk memeriksa kolom mana yang benar-benar 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 dalam panel dasbor adalah 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 milik 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 lengkap. {% endhint %} {% endstep %} {% step %} #### Langkah 4: Konfigurasi komponen Klik **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 berhalaman. * **Ukuran halaman**: mengatur berapa banyak baris yang muncul per halaman dalam tampilan interaktif. Ini tidak memengaruhi ekspor, yang selalu berisi seluruh kumpulan hasil. * **Tampilkan baris total**: menambahkan baris ringkasan di bagian bawah tabel saat diaktifkan. {% endtab %} {% tab title="Grafik" %} Tersedia dua jenis diagram: * **Deret waktu (garis)**: cocok untuk data yang diplot dari waktu ke waktu. * **Diagram batang**: cocok untuk perbandingan kategoris (juga disebut sebagai 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 pisahkan seri berdasarkan kolom kategorikal, seperti `label Pelacak`, untuk menampilkan garis atau grup batang terpisah untuk setiap 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`) akan dipilih otomatis jika kueri Anda mengembalikannya. Anda juga dapat menonaktifkan **Deteksi otomatis** opsi dan pilih kolom yang diperlukan secara manual. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Langkah 5: Simpan laporan Klik Simpan. 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 stempel 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. Luaskan bagian **Kueri SQL** untuk melihat atau mengedit pernyataan secara langsung. 2. Terapkan perubahan: 1. Klik **Simpan** untuk menyimpan perubahan tanpa menjalankannya. Anda perlu mengeklik **Refresh** untuk menjalankan ulang kueri dan memperbarui semua tampilan dengan data terkini. 2. **Simpan & Jalankan** untuk segera menerapkan kueri yang diperbarui. ### Tabel data Dasbor **Tabel data** bagian ini menampilkan hasil kueri dengan header bagian yang menampilkan total jumlah baris yang dikembalikan oleh kueri. Tampilan interaktif hanya menampilkan sejumlah baris terbatas, bagian bawah mengonfirmasi jumlah pastinya. Gunakan **Unduh** menu tarik-turun untuk mengekspor seluruh set 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 pojok kanan atas **Tabel data** header. Saat diaktifkan, ini mengubah kolom koordinat menjadi alamat jalan yang dapat dibaca. {% hint style="warning" %} Penyelesaian alamat membebani server secara signifikan. Gunakan opsi ini hanya dengan set data yang diagregasi atau difilter. Untuk data telemetri mentah dengan puluhan ribu baris, pertahankan koordinat dalam bentuk numerik. {% endhint %} ### Grafik Bagian Bagan ditampilkan 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. * **Kelompok berdasarkan**: secara opsional pisahkan seri berdasarkan kolom kategorikal, seperti `label Pelacak`, untuk menampilkan garis atau grup batang terpisah untuk setiap perangkat. Bagan menampilkan judul yang dibuat otomatis yang mendeskripsikan sumbu dan pengelompokan saat ini, misalnya: `kecepatan terhadap device_time (dikelompokkan berdasarkan label objek)`. Saat Anda mengubah pengaturan sumbu tanpa menyimpan, **Perubahan belum disimpan** muncul di samping **Simpan pengaturan bagan** tombol. Klik tombol tersebut untuk menyimpan perubahan konfigurasi dalam laporan. ### Peta lokasi Dasbor **Peta lokasi** bagian menampilkan setiap baris kueri sebagai titik pada koordinat GPS-nya. Header bagian menunjukkan jumlah titik yang diplot. Kolom GPS ditetapkan saat pembuatan laporan (secara otomatis atau manual), tidak mungkin mengeditnya sesudahnya. Jika kueri tidak mengembalikan kolom koordinat yang dikenali, bagian menampilkan “Tidak ada koordinat GPS yang terdeteksi dalam hasil kueri.” Untuk data telematika berstempel waktu, titik yang diplot mewakili seluruh lintasan pelacak selama periode yang diminta. {% hint style="info" %} Peta bersifat interaktif: perbesar dan geser untuk memeriksa titik individual. Klik **Tampilkan semua** untuk memperkecil tampilan dan menyesuaikan semua titik yang diplot agar pas di area peta yang terlihat. {% endhint %} ## Mengekspor laporan Dashboard Studio menyediakan dua tingkat ekspor. ### Ekspor tabel data Gunakan **Unduh** menu tarik-turun di dalam **Tabel data** bagian untuk mengekspor hanya data tabel. Ekspor selalu berisi set hasil lengkap yang dikembalikan oleh kueri, terlepas dari batas tampilan dalam 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, grafik, dan peta lokasi | | PDF | Dokumen statis dengan tabel data, grafik, dan peta lokasi | {% hint style="info" %} Berkas HTML yang diekspor mempertahankan interaktivitas: grafik mendukung keterangan saat diarahkan dan peta lokasi mendukung perbesar 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; kolom tersebut didefinisikan sekali saat laporan dibuat. Untuk menghapus laporan, klik **Alat** di bilah sisi kiri, lalu pilih **Menu edit**. Temukan laporan di pohon menu dan klik menu tiga titik di samping 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 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://navixy.com/docs/analytics/id/dashboard-studio/creating-reports.md?ask=&goal= ``` `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.