Prerequisite

ruby 2.6.6 rails 5.2.4 postgresql 12.3

Sekenario Masalah

Saya punya data yang ingin di-eksport ke dalam bentuk CSV (Comma-Separated Value).

Pemecahan Masalah

Ruby menyediakan class CSV yang dapat kita gunakan untuk melakukan baca & tulis.dari Strings atau IO objects.

Implementasi

Kita akan membuat tombol untuk men-download file CSV pada view template dan akan di-respon oleh controller.

Controller

Saya akan mengawali dengan membuat response ke controller apabila tombol pada view template di tekan.

1class CasesController < ApplicationController
2
3  def index
4    @cases = Case.all
5
6    respond_to do |format|
7      format.html
8      format.csv {
9        send_data @cases.to_csv,
10        filename: "COVID-19_INDO_PERHARI_#{@cases.last.fetched_at}.csv"
11      }
12    end
13  end
14end

Perhatikan bari ke-11, nantinya, kita akan membuat method .to_csv() pada model.

Apabila ingin merubah nama file, dapat merubah pada bagian filename:... di baris ke-12 tersebut.

Model

Pada model, kita akan menggunakan CSV class yang sudah disediakan oleh Ruby untuk membuat atau menulis file CSV. Kita akan menggunakan method .generate().

Buka model dari object yang akan kita tulis ke CSV.

1class Case < ApplicationRecord
2  ...
3  ...
4
5  def self.to_csv
6    attributes = %w(id fetched_at positif_covid meninggal_covid
7                    sembuh_covid jumlah_odp jumlah_pdp)
8
9    CSV.generate(headers: true, col_sep: ";") do |csv|
10      csv << attributes
11
12      all.find_each do |kasus|
13        csv << attributes.map{ |attr| kasus.send(attr) }
14      end
15    end
16  end
17end

Perhatikan pada baris ke-8 attributes = ..., ini bernilai Array yang mewakili masing-masing field. Ini juga akan dijadikan sebagai header dari file CSV.

Baris ke-24 col_sep: ";', adalah pendifinisian untuk delimiter atau batas yang digunakan untuk memisahkan antara data. Defaultnya menggunakan “,”.

View Template

Selanjutnya, kita buat link atau button yang akan di respon oleh controller.

1<%= link_to cases_path(format: "csv"), class: "button is-fullwidth-mobile" do %>
2  <span class="icon">
3    <%= image_tag 'file-download-solid.svg', width: '12' %>
4  </span>
5  <span class="has-text-weight-normal">Export as SpreadSheet</span>
6<% end %>

Bagian yang harus diperhatikan adalah baris ke-3, ..._path(format: "csv").

Selesai!

Pesan Penulis

Catatan ini bukan merupakan tutorial, saya hanya ingin memberikan gambaran betapa mudahnya mengeksport data ke dalam format .csv dari Rails menggunakan CSV class yang sudah disediakan oleh Ruby.

Maka dari itu, apabila teman-teman ingin mendapatkan penjelasan yang lebih baik, silahkan mengunjungin dokumentasi dari CSV class yang ada di ruby-doc.org. Tentunya akan lebih up to date dari yang saya tulis di sini.

Saya juga memanfaatkan gem ini untuk mengeksport data ke csv seperti yang saya lakukan di bandithijo.github.io/covid19.

Saya rasa hanya ini yang dapat saya tuliskan saat ini.

Mudah-mudahan dapat bermanfaat untuk teman-teman.

Terima kasih.

(^_^)

Referensi

1. dev.to/victorhazbun/export-records-to-csv-files-with-rails-2778
   Diakses tanggal: 2020/07/09

2. ruby-doc.org/stdlib-2.6.1/libdoc/csv/rdoc/CSV.html
   Diakses tanggal: 2020/07/09

3. github.com/ruby/csv
   Diakses tanggal: 2020/07/09