XLSX Converter

​

Dokumentasi: Perintah convert:xlsx-matrix-tpl2blade

​

1. Gambaran Umum

1. Penggabungan Data (Data Merging): Mengambil templat XLSX dan file data JSON untuk menghasilkan dokumen akhir yang sudah terisi. Hasilnya bisa berupa file XLSX baru (cocok untuk membuat laporan) atau file HTML yang sudah memiliki gaya (dalam format literal atau format “lean” yang bersih).
2. Konversi Templat Blade: Secara cerdas mengubah struktur dan tata letak dari templat XLSX langsung menjadi file Laravel Blade (.blade.php) yang bersih dan mudah dibaca manusia. Ini memungkinkan Anda untuk merancang view yang dinamis dan kompleks secara visual di dalam spreadsheet.

​

2. Panduan Pengguna (Superuser Guide)

​

2.1. Tanda Tangan Perintah (Command Signature)

php artisan convert:xlsx-matrix-tpl2blade --template=<path> --out=<path> [options]

​

2.2. Membuat Templat XLSX

A. Aturan Sintaks Placeholder (Sangat Penting!)

B. Placeholder Sederhana

• Tujuan: Mengganti placeholder dengan nilai string atau angka sederhana dari file JSON.
• Contoh (mode xlsx): Sebuah sel dengan {{ docNo }} akan diganti dengan nilai dari key docNo.
• Contoh (mode blade): Sebuah sel dengan {{ $docNo }} akan diubah menjadi teks literal {{ $docNo }} di file Blade.

C. Daftar Sederhana (list)

• Sintaks: {{ list:key }}
• Tujuan: Mengganti satu sel menjadi daftar item vertikal dari sebuah array sederhana di file JSON.
• Contoh (mode xlsx): Jika ccTo adalah ["Jane", "Jake"], sebuah sel dengan {{ list:ccTo }} akan diperluas menjadi dua baris.
• Contoh (mode blade): Sebuah sel dengan {{ list:ccTo }} akan diubah menjadi perulangan @foreach Blade.

D. Daftar URL (urllist)

• Sintaks: {{ urllist:key }}
• Tujuan: Mengganti satu sel menjadi daftar hyperlink vertikal yang bisa diklik. Data JSON harus berupa array of objects, masing-masing dengan key label dan url.
• Contoh (mode blade): Sebuah sel dengan {{ urllist:attachments }} akan diubah menjadi perulangan @foreach yang menghasilkan tag <a>.

E. Daftar Matriks (Beberapa Daftar dalam Satu Baris)

• Aturan: Perintah ini dapat menangani beberapa direktif list atau urllist dalam satu baris yang sama. Ia akan secara otomatis memperluas baris sesuai tinggi daftar yang paling panjang.
• Contoh Templat: | | C | D | E | |---|---|---|---| | 10 | {{ list:ccTo }} | BCC | {{ list:bccTo }} |

F. Tabel Data (@tablehead & @tabledata)

• Tujuan: Untuk menghasilkan tabel multi-baris dan multi-kolom dari sebuah array of objects.
• Sintaks & Aturan:

1. Buat baris “header”. Di sel A, tulis @tablehead. Di sel sebelah kanannya, tulis judul kolom (misalnya, “Nama Produk”).
2. Buat baris “templat data”. Di sel A, tulis @tabledata:key, di mana key adalah nama array of objects di JSON Anda (misalnya, @tabledata:items).
3. Di sel sebelah kanannya, tulis key yang sesuai dari objek JSON Anda (misalnya, itemName).

G. Direktif Blade (Hanya untuk --format=blade atau html --lean)

• Tujuan: Untuk mengubah struktur spreadsheet menjadi templat Blade yang dinamis.
• Sintaks & Aturan:

1. Letakkan direktif kontrol Blade (misalnya, @if, @foreach, @endif) di sebuah sel, biasanya di kolom A.
2. Baris yang berisi direktif tersebut tidak boleh memiliki konten lain.

• Contoh (mode --lean): | | A | B | |---|---|---| | 16| @foreach($items as $item) | | | 17| {{ $item->name }} | {{ $item->status }} | | 18| @endforeach | |

​

2.3. Menghasilkan Output: Contoh

Format: xlsx (Penggabungan Data dengan Gaya Penuh)

php artisan convert:xlsx-matrix-tpl2blade \
  --template="s3:templates/memo.xlsx" \
  --data="s3:data/memo-data.json" \
  --out="s3:reports/memo-final.xlsx" \
  --format=xlsx

Format: html --lean (Direkomendasikan untuk HTML)

php artisan convert:xlsx-matrix-tpl2blade \
  --template="templates/memo-blade-syntax.xlsx" \
  --data="data.json" \
  --out="reports/clean-report.html" \
  --format=html \
  --lean

Format: blade (Konversi Templat)

php artisan convert:xlsx-matrix-tpl2blade \
  --template="templates/memo-blade-syntax.xlsx" \
  --out="resources/views/memos/show.blade.php" \
  --format=blade \
  --lean