AX 2012 Legacy Report

 

1. Method element yang relevan pada report AX 2012

Berikut method yang relevan untuk memahami alur report klasik. Ini bukan daftar lengkap seluruh method internal ReportRun, tetapi mencakup method penting untuk kasus Anda.

A. Method untuk alur data dan pencetakan

Method	Fungsi
run()	Memulai proses report. Implementasi standar mengatur prompt, mengambil data, lalu mengarahkan hasil ke output.
fetch()	Menjalankan query report dan mengirim record yang ditemukan melalui send(). Nilai balik menentukan apakah pemrosesan dilanjutkan.
send()	Mengirim record ke section Body yang sesuai. Ada beberapa overload, termasuk yang menerima record dan level section.
executeSection()	Mencetak section tertentu. Pada Body, method ini dipicu saat send() memproses record.
execute(int)	Menjalankan programmable section berdasarkan level yang diberikan.
print()	Mengarahkan report yang telah dihasilkan ke media output, seperti layar atau printer. Microsoft Learn
reset()	Mereset state agar instance ReportRun dapat digunakan untuk membuat report lain.
query()	Mengakses query yang digunakan report; berguna saat memeriksa sumber dan range data.

B. Method untuk halaman dan format

Method	Fungsi
newPage()	Meminta report memulai halaman baru.
newPage(boolean)	Varian dengan parameter Boolean untuk mengatur perilaku page break. Detail semantiknya perlu diverifikasi pada versi AX yang digunakan.
page() / page(int)	Mengakses atau mengatur informasi halaman; pastikan overload yang dipakai sesuai kebutuhan.
pagesTotal()	Mendapatkan informasi jumlah halaman report.
pageFormatting()	Menampilkan pengaturan properti printer.
packPageSettings()	Mengemas pengaturan halaman.
packPrinterSettings()	Mengemas pengaturan printer.
packPrintJobSettings()	Mengemas pengaturan pekerjaan cetak.

Daftar method ReportRun Microsoft mencantumkan method-method tersebut. Perlu diingat, dokumentasi API yang tersedia saat ini juga mencakup versi Dynamics yang lebih baru, sehingga detail implementasi internalnya tidak selalu identik dengan AX 2012.

C. Method untuk mengatur section

Method	Kegunaan
enableBody() / enableBody(int)	Mengaktifkan Body tertentu.
disableBody() / disableBody(int)	Menonaktifkan Body tertentu.
enableAllBodies()	Mengaktifkan seluruh Body.
enableSection(ReportSection)	Mengaktifkan section tertentu.
disableSection(ReportSection)	Menonaktifkan section tertentu.
enablePageFooter() / disablePageFooter()	Mengatur pencetakan page footer.
executeHeader()	Menjalankan section Header.
executeFooter()	Menjalankan section Footer.
executeBodyColumnHeadings()	Menjalankan heading kolom Body.
executeColumnHeadings(ReportSection)	Menjalankan heading kolom pada section tertentu.
header(...) / footer(...)	Mengatur pemrosesan Header atau Footer berdasarkan section dan level.
sectionsLeft(ReportSection)	Memeriksa informasi section yang tersisa dalam alur report.

Method di atas berguna ketika Anda ingin mengontrol section mana yang dicetak atau kapan bagian report dieksekusi.

D. Method untuk query dan informasi report

Method	Kegunaan
query() / query(Query)	Mengambil atau menetapkan objek query report.
queryRun() / queryRun(QueryRun)	Mengambil atau menetapkan objek QueryRun.
design() / design(Object)	Mengambil atau menetapkan design report.
report()	Mengakses informasi report yang sedang dijalankan.
reportUser() / reportUser(String)	Mengambil atau menetapkan informasi user report.
args()	Mengakses argumen yang diberikan saat objek dibuat.
hasGeneratedDesign()	Memeriksa apakah report memakai generated design.
name() / name(String)	Mengambil atau menetapkan nama objek.
init()	Inisialisasi objek report.
prompt()	Menampilkan dialog pengaturan sebelum report dijalankan.
getTarget() / setTarget(PrintMedium)	Mengakses atau menetapkan target output report.

Referensi method ReportRun mencantumkan kelompok method tersebut.

E. Method untuk printer dan pengaturan output

Ada banyak accessor untuk informasi printer, antara lain:

• printerPrinterName() — nama printer.

• printerDriverName() — nama driver.

• printerPortName() — port printer.

• printerServerName() — server printer.

• printerPaper() — informasi kertas.

• printerPageHeight() / printerPageWidth() — dimensi halaman printer.

• printerSettings() — pengaturan printer.

• printJobSettings() — pengaturan pekerjaan cetak.

• copies() / copies(int) — jumlah salinan.

• collate() / collate(boolean) — pengaturan pengurutan salinan.

• deviceName() / deviceName(String) — informasi perangkat output.

• getNumberOfPrinters() / getPrinter(int) — informasi printer yang tersedia.

Perlu diperhatikan bahwa sebagian besar accessor printer tersebut merupakan informasi atau pengaturan output, bukan pengendali iterasi record.

F. Method untuk subtotal, footer, dan informasi halaman

Method	Kegunaan
sum() / sumPos() / sumNeg()	Mengakses fungsi agregasi dan subtotal report.
sumControl() / sumControlPos() / sumControlNeg()	Mengakses agregasi berdasarkan control.
printSum()	Mengakses informasi pencetakan subtotal.
addPendingSums()	Memproses footer yang berkaitan dengan subtotal.
addRangeDescription()	Menambahkan deskripsi range report.
getRangeDescription()	Mengambil deskripsi range.
clearAllRangeDescriptions()	Menghapus deskripsi range.
caption()	Mengatur caption preview atau nama dokumen cetak.
title() / title(String)	Mengambil atau mengatur judul pekerjaan cetak.
progressInfo()	Membuat informasi progres pemrosesan report.
suppressReportIsEmptyMessage()	Mengatur pesan ketika report kosong.