Sejak memasang "dark" theme, saya cenderung menjadi malas menulis. Untuk sementara, dark theme saya disable dulu yaa. Terima kasih (^_^) (bandithijo, 2024/09/15) ●

بسم الله الرحمن الرحيم

Prerequisite

Ruby 2.6.6 Rails 5.2.4 PostgreSQL 12.3

Sekenario Masalah

Saya punya data yang ingin di-eksport ke dalam bentuk spreadsheet dengan format .xlsx.

Pemecahan Masalah

Kita dapat menggunakan bantuan gem axlsx & axlsx_rails. Namun, gem ini sudah tidak dimaintain lagi.

Nah, kita akan menggunakan versi yang dimaintain oleh komunitas bernama cxlsx & cxlsx_rails.

Instalasi

Pasang gem yang dibutuhkan di Gemfile.

FILEGemfile
1
2
3
4
5
6
7

source 'https://rubygems.org'
git_source(:github) { |repo| "https://github.com/#{repo}.git" }

...
...
gem 'caxlsx',                             '~> 3.0', '>= 3.0.1'
gem 'caxlsx_rails',                       '~> 0.6.2'

Kemudian install.

$ bundle install

Implementasi

Kita akan membuat tombol 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.

FILEapp/controllers/cases_controller.rb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

class CasesController < ApplicationController

  def index
    @cases = Case.all

    respond_to do |format|
      format.html
      format.xlsx {
        response.headers['Content-Disposition'] = \
        "attachment; \
         filename=COVID-19_INDO_PERHARI_#{@cases.last.fetched_at}.xlsx"
      }
    end
  end
end

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

View Template

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

FILEapp/views/cases/index.html.erb
1
2
3
4
5
6

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

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

Selanjutnya, kita akan buat view template untuk file .xlsx yang akan di download.

Buat file view template app/views/cases/index.xlsx.axlsx.

FILEapp/views/cases/index.xlsx.axlsx
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

wb = xlsx_package.workbook

wb.add_worksheet(name: "Cases") do |sheet|
  # Blok ini untuk head dari baris (baris head paling atas)
  sheet.add_row %w(id fetched_at positif_covid meninggal_covid
                   sembuh_covid jumlah_odp jumlah_pdp)

  # Blok ini untuk data, urutkan sesuai baris head di atas
  @cases.each do |kasus|
    sheet.add_row [kasus.id, kasus.fetched_at.strftime("%F"),
                   kasus.positif_covid, kasus.meninggal_covid,
                   kasus.sembuh_covid, kasus.jumlah_odp,
                   kasus.jumlah_pdp]
  end
end

Perhatikan pada baris ke-7 dan ke-12, basicnya .add_row() ini menampung value berupa Array.

Pada baris ke-7, adalah salah satu bentuk lain cara pemanggilan Array di Ruby.

Selesai!

Pesan Penulis

Catatan ini bukan merupakan tutorial, saya hanya ingin memberikan gambaran betapa mudahnya mengeksport data ke dalam format .xlsx dari Rails menggunakan cxlsx dan cxlsx_rails.

Maka dari itu, apabila teman-teman ingin mendapatkan penjelasan yang lebih baik, silahkan mengunjungin dokumentasi dari cxlsx_rails. Tentunya akan lebih up to date dari yang saya tulis di sini.

Saya juga memanfaatkan gem ini untuk mengeksport data ke spreadsheet 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. github.com/randym/axlsx
    Diakses tanggal: 2020/07/09

  2. github.com/caxlsx/caxlsx_rails
    Diakses tanggal: 2020/07/09

  3. github.com/caxlsx/caxlsx
    Diakses tanggal: 2020/07/09

  4. github.com/caxlsx/caxlsx_rails
    Diakses tanggal: 2020/07/09

  5. %Q, %q, %W, %w, %x, %r, %s
    Diakses tanggal: 2020/07/09


Lisensi

logo_cc-by-nc-sa
Tulisan ini dilisensikan dengan :
Atribusi-NonKomersial-BerbagiSerupa 4.0 Internasional (CC BY-NC-SA 4.0)

Penulis

bandithijo

My journey kicks off from reading textbooks as a former Medical Student to digging bugs as a Software Engineer – a delightful rollercoaster of career twists. Embracing failure with the grace of a Cat avoiding water, I've seamlessly transitioned from Stethoscope to Keyboard. Armed with ability for learning and adapting faster than a Heart Beat, I'm on a mission to turn Code into a Product.

- Rizqi Nur Assyaufi

1287153a5a9f6db9efda51d44b9e10e6744965e1