Raw Printing

Diperkenalkan pada Versi 12

Mengirim serangkaian perintah ke printer langsung dalam bahasa aslinya disebut Pencetakan Mentah.

Banyak printer termal yang memerlukan perintah mentah ini agar dapat menjalankan fungsi seperti pencetakan kode batang, pencetakan struk, pencetakan label, dll. Pencetakan Mentah melewati driver printer dalam banyak kasus, sehingga printer ini sangat cepat dan andal. Pencetakan Mentah juga mampu melakukan beberapa fitur canggih seperti memotong kertas struk, mengeluarkan laci uang, dll.

1. Menyiapkan Pencetakan Mentah di Bizops

1.1 Menginstal aplikasi QZ Tray di komputer klien

Unduh dan instal aplikasi QZ Tray di komputer yang terhubung dengan printer termal Anda. Aplikasi ini dapat ditemukan di situs resminya . Saat ini, Windows, macOS, dan Linux didukung oleh QZ Tray. Selama instalasi, Anda akan diminta untuk menginstal Java jika belum diinstal, silakan instal Java untuk menyelesaikan instalasi.

Petunjuk lebih lanjut tentang pemasangan Aplikasi QZ Tray dapat ditemukan di sini .

1.2 Membuat Perintah Mentah Format Cetak

Untuk dapat mengirim perintah mentah ke printer, Anda perlu terlebih dahulu membuat format cetak dalam perintah mentah. Bahasa Templating Jinja digunakan dalam perintah mentah seperti dalam format cetak khusus HTML .

Untuk membuat format cetak baru untuk Raw Printing:

Buka daftar format cetak: Home > Settings > Printing > Print Format
Klik Baru.
Pilih DocType yang relevan.
Periksa opsi Custom format dan Raw Printing .
Isi kolom Raw Commands dengan perintah mentah yang ingin dikirim ke printer.
Klik Simpan. \

Saat ini, bahasa printer berbasis string apa pun dapat digunakan di Raw Commandslapangan dalam format cetak. Penulisan perintah mentah memerlukan pengetahuan tentang bahasa asli printer yang disediakan oleh produsen printer. Silakan lihat manual pengembang yang disediakan oleh produsen printer tentang cara menulis perintah asli mereka.

1.3 Mengaktifkan Pencetakan Mentah di Pengaturan Pencetakan

Untuk mengaktifkan Pencetakan Mentah:

Buka: Home > Settings > Printing > Print Settings > Raw Printing.
Centang opsi Aktifkan Raw Printing .
Menyimpan.

2. Metode untuk memanfaatkan pencetakan mentah di Bizops

Ada dua cara untuk mengirim perintah Raw Printing ke printer Anda.

2.1 Mengklik cetak pada halaman tampilan cetak

Untuk mencetak format cetak perintah mentah dari tampilan cetak Dokumen:

Pilih format cetak yang sesuai. Untuk format cetak dalam Perintah Raw, pesan "Tidak ada Pratinjau yang tersedia" ditampilkan sebagai ganti pratinjau cetak.
Klik tombol cetak.
Harap izinkan perintah koneksi dari QZ Tray untuk tindakan yang Anda mulai (Pintasan Keyboard: Alt + A).
Anda mungkin diminta untuk memilih "format cetak - pemetaan printer".
- Pemetaan ini digunakan untuk mengirim perintah cetak ke printer yang sesuai.
- Printer perlu diinstal pada komputer Anda untuk dapat memetakannya ke format cetak.

* Pemetaan ini disimpan secara lokal pada komputer yang sama dan harus diatur pada setiap mesin klien.
* Anda juga dapat mengeditnya dengan mengklik tombol **Printer Settings** .

5.

2.2 Memanggil fungsi Raw Print dari skrip klien

Sering kali diperlukan perintah cetak yang harus dikeluarkan pada peristiwa tertentu (seperti submit, save, amend, dll.). Anda dapat menulis skrip klien untuk melakukan ini bagi Anda.

Berikut ini adalah fungsi Raw Print yang relevan:

fungsi:frappe.ui.form.qz_connect
- Pembungkus koneksi untuk membuat koneksi dengan aplikasi QZ Tray.
- Mengembalikan janji yang terselesaikan setelah koneksi berhasil dibuat.
- Memungkinkan koneksi aktif dan tidak aktif untuk diselesaikan tanpa memandang apa pun. Oleh karena itu, koneksi dapat dipanggil setiap saat sebelum mengirim perintah.
- Contoh penggunaan:

``` frappe.ui.form.qzconnect() .then(function () { return qz.print(config, data); }) .then(frappe.ui.form.qzsuccess) .catch(err => { frappe.ui.form.qz_fail(err); });








Di sini, `qz`adalah objek global yang disediakan oleh `qz-tray.js`perpustakaan.






1. fungsi:`frappe.ui.form.qz_get_printer_list`
    * Memberikan Anda daftar printer yang tersedia untuk aplikasi QZ Tray
    * Mengembalikan janji yang diselesaikan ke daftar printer
2. Contoh penggunaan:




>

frappe.ui.form.qzgetprinter_list().then( // Required action on getting the printer list. // Note: Printer list is a array of strings. ); ```

fungsi:frappe.ui.form.qz_success
- Menampilkan peringatan "Cetak Terkirim ke printer!" kepada pengguna. Dapat dipanggil setelah perintah cetak berhasil.
fungsi:frappe.ui.form.qz_fail
- Menampilkan pesan kesalahan kepada pengguna. Harus dipanggil saat koneksi QZ Tray gagal.

Anda juga dapat langsung mengakses fungsi yang disediakan oleh qz-tray.jspustaka melalui qzobjek. Klik di sini untuk dokumentasi pustaka qz-tray.js . Catatan: qzObjek diinisialisasi hanya setelah memanggil frappe.ui.form.qz_connectuntuk pertama kalinya. Jika Anda memerlukan qzobjek sebelum itu, Anda dapat menggunakan frappe.ui.form.qz_init.