Berkenalan Dengan Makro :

Diekstrak dari "OpenOffice.org Macros Explained"

Daftar Isi

Gambaran Umum	ii

Hak cipta dan informasi merk dagang	ii

Komentar dan Saran	ii

Pemberitahuan	ii

Modifikasi dan update	ii

Bahasa makro OpenOffice.org	3

Menyimpan makro dalam library dokumen	4

Langkah 1. Membuat library	4

Langkah 2. Membuat modul	7

Langkah 3. Masukkan makro pertama Anda	9

Menyimpan makro dalam library aplikasi	13

Integrated Development Environment	14

Menggunakan breakpoint	18

Manajemen library	19

Bagaimana library disimpan	19

Librari aplikasi	20

Librari dokumen	21

Menggunakan Macro Organizer	22

Merename modul dan library	23

Menambahkan library	24

Kesimpulan	26

Gambaran Umum

Pada OpenOffice.org, makro dan dialog disimpan dalam dokumen dan library. Diikutsertakannya integrated development environment (IDE) adalah untuk membuat dan mendebug makro. Bab ini mengenalkan konsep dasar memulai IDE dan membuat makro dengan menampilkan langkah-langkah untuk menghasilkan makro sederhana, dimana menampilkan teks “Hello World” pada layar.

Hak cipta dan informasi merk dagang

Muatan dari Dokumentasi ini adalah tunduk pada Lisensi Dokumentasi Publik, Versi 1.0 ("License"); Anda hanya boleh menggunakan Dokumentasi jika Anda mematuhi dengan istilah Lisensi. Salinan dari Lisensi tersedia di:
http://www.openoffice.org/licenses/PDL.rtf.

Dokumen Asli adalah Berkenalan Dengan Makro : Diekstrak dari "OpenOffice.org Macros Explained". Penulis awal Dokumentasi Asli adalah Andrew Douglas Pitonyak © 2004. Hak cipta dilindungi. (Kontak penulis asli: andrew@pitonyak.org. Kontak penulis asli untuk melaporkan kesalahan dalam dokumentasi. Untuk pertanyaan mengenai bagaimana menggunakan perangkat lunak, daftar ke Users Mail List dan kirim pertanyaan Anda disana: http://support.openoffice.org/index.html.)

Semua merk dagang dalam pemandu ini kembali kepada pemilik yang sah.

Komentar dan Saran

Tolong langsung sampaikan beberapa komentar dan saran tentang dokumen ini ke:
authors@user-faq.openoffice.org.

Pemberitahuan

Bab ini dicetak ulang, dengan ijin dari penulis dan penerbit, dari Bab 1 buku Andrew Pitonyak OpenOffice.org Macros Explained, diterbitkan oleh Hentzenwerke, 2004. Informasi lebih tentang buku, termasuk isi tabel yang tersedia dari http://www.hentzenwerke.com/catalog/oome.htm.

Modifikasi dan update

Versi	Tanggal	Deskripsi Perubahan
1.0	17 Jan 2005	Edisi pertama diterbitkan pada format ini.
	28 Februari 2005	Edisi Indonesia pertama

Bahasa makro OpenOffice.org

Makro disimpan dalam kumpulan perintah atau tekanan tombol yang disimpan untuk digunakan belakangan. Contoh sederhana makro salah satunya adalah yang “mengetik” alamat Anda. Makro mendukung perintah yang mengijinkan berbagai macam fungsi mahir, seperti pengambil keputusan (sebagai contoh, jika rata-rata lebih kecil daripada nol, akan berwarna merah;jika tidak; berwana hitam), perulangan (jika rata-rata lebih besar daripada nol, dikurangi 10 darinya), dan ketika berinteraksi dengan seseorang (bertanya ke pengguna tentang angka). Beberapa perintah ini berdasarkan bahasa pemrograman BASIC. (BASIC adalah kependekan dari Beginner’s All-purpose Symbolic Instruction Code.) Ini sangat umum untuk menandai makro ke tekanan tombol atau ikon toolbar sehingga dapat dengan cepat dimulai.

Bahasa makro OpenOffice.org sangat fleksibel. Mengijinkan otomatisasi baik itu tugas mudah maupun rumit. Walaupun menulis makro dan belajar tentang pekerjaan bagian dalam OpenOffice.org dapat menjadi menyenangkan, ini tidak selalu menjadi pendekatan yang terbaik. Makro terutama bermanfaat manakala Anda harus mengerjakan tugas dengan langkah yang sama lagi dan lagi, atau ketika Anda hanya ingin untuk menekan tombol tunggal untuk melakukan sesuatu yang normalnya membutuhkan beberapa langkah. Sekali-kali Anda ingin menulis makro untuk melakukan sesuatu yang tidak dapat Anda lakukan di OpenOffice.org, tetapi pada kasus tersebut Anda sebaiknya menginvestigasi secara menyeluruh untuk memastikan OOo tidak dapat melakukan itu. Sebagai contoh, permintaan umum pada beberapa mailing list OpenOffice.org adalah untuk makro yang membuang paragraf kosong. Fungsionalitas ini disajikan dengan AutoFormat (pilih tab Tools > AutoCorrect/ AutoFormat > Options). Ini juga sangat mungkin untuk menggunakan regular expressions untuk mencari dan mengganti spasi kosong. Ada waktunya untuk makro dan ada waktu untuk solusi lainnya. Bab ini akan memulai persiapan Anda untuk waktu dimana makro adalah pilihan solusi.

Catatan	OpenOffice.org disingkat sebagai OOo. “OpenOffice.org Basic” kemudian disingkat sebagai “OOo Basic.”

Bahasa makro OpenOffice.org adalah berdasarkan bahasa pemrograman BASIC. OOo Basic menjalankan satu baris pada satu waktu. Bagaimanapun, Anda biasanya membutuhkan lebih dari satu baris untuk menyelesaikan semuanya, sehingga Anda biasanya menulis rutin—juga diketahui sebagai prosedur—yang mengandung beberapa baris, ketika semua berjalan, lakukan sesuatu yang umum. Sebagai contoh, Anda mungkin menulis rutin yang menghapus header dari berkas dan memasukkan header yang disukai. Pada OpenOffice.org, rutin yang secara logikal terhubung disimpan dalam modul. Sebagai contoh, modul mungkin saja mengandung rutin untuk menemukan kesalahan umum yang membutuhkan pengeditan. Secara logikal modul yang terhubung disimpan dalam library, dan library disimpan dalam kontainer library. Aplikasi OpenOffice.org dapat bertindak sebagai kontainer library , sebagaimana dokumen OOo. Pernyataan mudahnya bahwa aplikasi OpenOffice.org dan tiap dokumen OpenOffice.org dapat mengandung library, modul, dan makro.

Catatan	Jendela dialog yang muncul pada layar, biasanya membutuhkan masukan atau informasi yang sekarang. Dialog biasanya muncul setelah mesukan yang diminta dimasukkan. Dialog user-created disimpan dalam library dialog dengan langkah yang sama seperti makro disimpan dalam library makro. Tiap library dapat mengandung banyak sekali dialog. Kontainer library dapat menyimpan baik itu makro atau library dialog. Lihat Bab 17, “Dialogs and Controls” in OpenOffice.org Macros Explained untuk informasi lebih tentang dialog.

Menyimpan makro dalam library dokumen

Tiap dokumen OpenOffice.org adalah kontainer library yang mampu mengandung makro dan dialog. Manakala dokumen mengandung makro yang digunakan, pemilihan dokumen menyiratkan pada pemilihan makro. Ini adalah metode distribusi dan penyimpanan yang menyenangkan. Mengirim dokumen ke orang atau lokasi lain dan makro masih tersedia dan dapat digunakan.

Metode tradisional untuk pengenalan bahasa pemrograman adalah dengan menulis program yang biasanya menghasilkan keluaran pesan “Hello World.” Keseluruhan situs web ada dengan tujuan utama menunjukkan program “Hello World” dengan bahasa pemrograman yang berbeda kalau mungkin (sebagai contoh, lihat http://www2.latech.edu/~acm/HelloWorld.shtml). Memilih untuk tidak menghancurkan tradisi, makro pertama saya menampilkan variasi dari “Hello World.”

Langkah 1. Membuat library

Semua dokumen OOo, dengan tanpa melihat tipe dokumen, mungkin mengandung makro. Untuk menambah makro ke beberapa dokumen OOo, dokumen harus dibuka untuk pengeditan. Mulai dengan membuka dokumen teks baru, yang akan dinamai “Untitled1”—mengasumsikan bahwa tidak ada dokumen tidak berjudul lainnya yang terbuka. Ketika dokumen dibuat, OpenOffice.org membuat library kosong yang dinamai Standard. Librari Standard, bagaimanapun, akan terus kosong sampai modul baru dibuat secara manual. Gunakan dialog Macro untuk mengatur library dan modul: Tools > Macros > Macro (lihat Gambar 1).

Daftar “Macro from” menampilkan kontainer library yang tersedia; ini termasuk tiap membuka dokumen sebagaimana aplikasi kontainer library. Aplikaso kontainer library dinamai “soffice”, tetapi ini tidak ditampilkan dalam Gambar 1. Kontainer library dokumen didaftarkan dibawah kontainer “soffice” menggunakan nama penanda dokumen. Kebanyakan kontainer library telah memiliki library yang dinamai Standard. Klik ganda ikon kontainer library untuk mengubah tampilan dari library yang dikandung. Klik ganda library untuk mengubah tampilan modul yang dikandung.

Catatan	Sebelum versi 2.0, OOo menampilkan “My Macros” dan “OpenOffice.org Macros” pada daftar yang sama. Dialog baru lebih intuitif ketika memberikan padangan dan rasa yang sama. Dukungan untuk pengeditan dan menjalankan makro pada bahasa selain dari OOo Basic juga telah ditambahkan; lihat Tools > Macros > Organize Macros > JavaScript, sebagai contoh.

Gambar 1. Gunakan dialog Macro untuk membuat makro baru dan mengatur library.

Pada Gambar 1, library Standard pada dokumen tak berjudul adalah ditandai. Librari ini secara otomatis dibuat manakala dokumen baru dibuat. Dokumen yang sekarang tidak mengandung modul—ingat bahwa makro disimpan dalam modul. Walaupun Anda dapat mengklik tombol New untuk membuat modul baru, jangan! Tujuan bagian ini adalah untuk membuat library baru.

TIP	Jangan simpan makro Anda pada library Standard. Buat library baru dengan penjelasan nama dan simpan makro disana. Ketika library ditambah itu akan menulis ulang library yang telah ada dengan nama yang sama. Jika semua library Anda dinamai dengan Standard, OOo melarang Anda untuk menambah library Anda ke kontainer library.

Klik tombol Organizer untuk membuka dialog Macro Organizer (lihat Gambar 2). Sebagaimana dialog Macro, semua kontainer library didaftar. Dengan kata lain, tiap dokumen didaftar sebagai aplikasi kontainer library “soffice”. Pada Gambar 2, library Standard ditandai pada dokumen “Untitled1”; scroll bawah daftar untuk menemukan “Untitled1” jika diperlukan. Dialog Macro Organizer adalah dialog bertab, dan fokus tabnya adalah Modules. Ketika namanya menyiratkan, tab Modules berhadapan dengan modules. Ini adalah penjelasan dari item pada dialog ini:

Tombol New Module membuat modul baru pada library terpilih.

Tombol New Dialog membuat dialog baru pada library terpilih.

Tombol Delete menghapus modul terpilih sekarang; ini tidak tersedia kecuali modul dipilih.

Tombol Edit membuka modul terpilih sekarang untuk pengeditan dalam IDE; ini tidak tersedia kecuali modul dipilih.

Tombol Close menutup dialog Macro Organizer.

Gambar 2. Gunakan dialog Macro Organizer untuk mengatur modul.

Kegunaan bagian ini adalah untuk membuat library yang memiliki nama berarti yang terkandung dalam dokumen “Untitled1”. Klik tab Libraries untuk berhadapan dengan libraryes (lihat Gambar 3).

Gambar 3. Gunakan dialog Macro Organizer untuk mengatur library.

Manakala bagian dialog ini ditampilkan, aplikasi kontainer library (soffice) dipilih pada daftar Application/Document. Pilih dokumen “Untitled1” sehingga perubahan dibuat ke dokumen tidak berjudul. Tombol yang ditampilkan pada tab Libraries tab mempengaruhi library, bukan modul. Ini adalah deskripsinya:

Tombol New membuat library baru pada dokumen terpilih atau aplikasi.

Tombol Password mengijinkan Anda untuk memberikan atau mengubah password untuk library terpilih. Harap dicatat bahwa Anda tidak dapat memebri atau mengubah library default.

Tombol Delete menghapus modul terpilih sekarang; ini tidak tersedia sampai modul terpilih.

Tombol Append memberikan mekanisme untuk menyalin library dari kontainer library lainnya (dokumen atau aplikasi) ke kontainer library yang dipilih pada daftar bApplication/Document. Manajemen Librari akan didiskusikan belakangan pada bab ini.

Tombol Edit membuka library terpilih sekarang untuk mengedit dalam IDE.

Tombol Close menutup dialog Macro Organizer.

Klik tombol New untuk membuat library baru (lihat Gambar 4). Walaupun nama awalnya adalah “Library1,” lebih baik untuk memilih nama yang berarti seperti “MyFirstLibrary” atau “TestLibrary.” Klik OK untuk membuatnya.

Gambar 4. Pilih nama yang berarti untuk library.

Macro Organizer sekarang mengandung library yang baru dibuat pada daftar Library (lihat Gambar 5).

Gambar 5. Dokumen sekarang mengandung library yang dinamai TestLibrary.

Langkah 2. Membuat modul

Makro disimpan dalam modul, jadi langkah selanjutnya adalah membuat modul pada library yang baru dibuat. Asumsikan bahwa Macro Organizer (lihat Gambar 3) masih terbuka, pilih tab Modules (lihat Gambar 6).

Gambar 6. The TestLibrary contains one module named Module1.

TestLibrary yang baru dibuat ditampilkan pada Macro Organizer. Pilih TestLibrary atau beberapa modul yang mengandung library itu, dan kemudian klik tombol New Module untuk membuat modul baru (lihat Gambar 7). Nama dasarnya adalah Module1; pilih nama yang lebih menjelaskan untuk modul dan klik OK untuk membuatnya.

Gambar 7. Pilih nama modul yang berarti.

TIP	Gunakan nama modul yang jelas untuk menghindari kebingungan. Ini penting manakala bergerak diantara modul.

Kesalahan umum ditandai kontainer library salah baik dalam dialog Macro ataupun dialog Macro Organizer. Kesalahan umum adalah pada pemilihan library atau modul pada aplikasi kontainer (soffice) daripada dokumen yang spesifik. Temukan nama dokumen dalam daftar. Nama dokumen ditentukan oleh judu; sebagaimana diset pada dialog Properties dokumen. Gunakan File > Properties untuk membuka dialog Properties. Judul diset dari tab Description. Jika tidak ada judul diset, nama berkas digunakan dulu.

Catatan	Dua dokumen dengan judul yang sama pada dialog properti dokumen menggunakan nama yang sama pada dialog Macro, dialog Macro Organizer, dan judul jendela. Ini sangat membingungkan, jadi coba untuk menghindarinya.

Langkah 3. Masukkan makro pertama Anda

Jika dialog Macro Organizer masih terbuka, Anda dapat menghighlight modul yang baru saja dibuat dan klik tombol Edit. Ini akan membuka IDE Basic. Pilihan lainnya adalah menggunakan dialog Macro. Jika dialog Macro Organizer terbuka, klik tombol Close untuk membuka dialog Macro. Jika dialog Macro Organizer tidak terbuka, pilih Tools > Macros > Macro untuk membuka dialog Macro (lihat Gambar 8).

Gambar 8. Pilih makro spesifik.

Ini adalah penjelasan tombol untuk dialog Macro:

Tombol Run menjalankan makro terpilih. Makro dipilih pada daftar sebelah kanan., dan namanya juga muncul pada kotak masukan di kiri atas yang diberi label “Macro name.”

Tombol Close menutup dialog Macro.

Tombol Assign mengasosiasi makro dengan kejadian spesifik. Penadaan makro untuk even akan didiskusikan kemudian.

Tombol Edit membuka IDE dan mengedit makro terpilih.

Tombol Delete menghapus makro terpilih. Tombol ini hadir jika modul dipilih. Jika library atau dokumen dipilih pada daftar “Macro from”, tombol Delete berubah ke New. Tombol New membuat makro baru pada library terpilih.

Tombol Organizer membuka dialog Macro Organizer.

Tombol Help membuka bantuan sistem.

Kegunaan dari dialog Macro adalah untuk operasi pada makro individu. Pilih MyFirstModule dan klik tombol Edit untuk membuka Basic IDE; lihat Gambar 9). Pada subrutin kosong, Main, secara otomatis dibuat manakala modul dibuat. Tombol New pada dialog Macro membuat subrutin kosong kedua, Macro1. IDE ditampilkan pada Gambar 9 telah dibuka dengan mengklik library dan mengklik tombol New. Hapus subrutin ini dan ganti dengan kode pada Listing 1.

Gambar 9. Mengembangkan makro pada IDE.

Listing 1. Rutin “Hello World” dapat ditemukan pada berkas kode sumber bab sebagai SC01.sxw.

Sub main

HelloWorld2()

End Sub

Sub HelloWorld1

Print "Hello World One"

End Sub

Sub HelloWorld2

Print "Hello World Two"

End Sub

IDE mengandung toolbar Macro dan toolbar Function sebagaimana ditunjukkan pada Gambar 9. (Sebagian besar ikon pada toolbar Macro diidentifikasi pada Gambar 13.) Istirahatkan kursor mouse Anda pada ikon toolbar dalam beberapa detik untuk membaca teks yang muncul; ini memberikan petunjuk pada apa yang dilakukan ikon.

Klik ikon Compile untuk mengecek kesalahan sintak makro. Tidak ada pesan ditampilkan kecuali kesalahan ditemukan (lihat Gambar 10). Ikon Compile mengcompile hanya modul yang sekarang.

Gambar 10. Klik ikon Compile untuk menemukan kesalahan sintak seperti penAnda kutip ganda.

Ubah kode pada Listing 1 untuk mendemostrasikan kesalahan. Buang kutip ganda kedua dari pernyataan Print pada HelloWorld1 (lihat Gambar 10). Kemudian klik ikon Compile. Dialog menampilkan pesan kesalahan dari kesalahan pertama yang terjadi. Pesan kesalahan pada Gambar 10 mengindikasikan bahwa tanda kutip ganda dibutuhkan tetapi tidak ditemukan. Tanda kutip ganda pertama ditandai, dan panah merah menandai baris yang salah. Klik tombol OK untuk menutup dialog kesalahan, betulkan baris dengan menambahkan tanda kutip ganda di akhir, kemudian compile kode lagi.

Klik ikon Run untuk menjalankan rutin pertama pada modul yang sekarang. Ini penting untuk mengklik ikon Compile dahulu, karena mengklik ikon Run secara otomatis mencompile tiap modul pada library yang sekarang. Mengklik ikon Run hanya menjalankan subrutin pertama pada modul. Pada Listing 1, ikon Run menjalankan subrutin pertama, yang dinamai “main.” Subrutin utama memanggil subrutin HelloWorld2, menampilkan dialog yang ditunjukkan pada Gambar 11. Klik OK untuk menutup dialog, atau klik Cancel untuk menghentikan makro.

Gambar 11. Klik OK untuk menutup dialog.

Ikon Run selalu menjalankan makro pertama pada modul yang sekarang. Sebagai hasilnya, pendekatan yang berbeda diperlukan untuk menjalankan HelloWorld1. Untuk menjalankan HelloWorld1, amda dapat menggunakan metode berikut:

Letakkan HelloWorld1 pertama pada modul dan klik ikon Run.

Ubah subroutine utama untuk memanggil HelloWorld1 bukannya HelloWorld2.

Gunakan dialog Macro (ditampilkan pada Gambar 8) untuk menjalankan rutin pada modul.

Tambahkan tombol ke dokumen OpenOffice.org Anda yang memanggil HelloWorld1. Metode ini didiskusikan kemudian.

Menugaskan makro ke tombol. Untuk melakukan ini, klik Tools > Configure untuk membuka dialog Configuration, dan kemudian pilih tab Keyboard . Librari Makro berada di bagian bawah daftar Category. Anda juga dapat menemukan ini dengan mengklik Tools > Macros > Macro, memilih makro spesifik, dan kemudian mengklik tombol Assign untuk memanggil jendela Configuration. Berbagai macam tab pada dialog ini mengijinkan Anda untuk menugasi makro untuk mengeksekusi sebagaimana item menu, dari tombol keyboard, ikon toolbar, atau even sistem.

Tambahkan ikon ke toolbar yang memanggil HelloWorld1.

Untuk menggunakan dialog Macro untuk menjalankan beberapa subrutin pada modul, ikuti langkah-langkah berikut:

Pilih Tools > Macros > Macro untuk membuka dialog Macro (lihat Gambar 8).

Temukan dokumen yang mengandung modul pada daftar “Macro from”.

Klik ganda library untuk mengubah tampilan modul yang terkandung.

Pilih modul untuk menampilkan subrutin yang dikandung dan fungsi dalam daftar “Existing macros in: <selected module name>”.

Pilih subrutin atau fungsi yang diinginkan untuk dijalankan—sebagai contoh, HelloWorld1.

Klik tombol Run untuk menjalankan subrutin atau fungsi.

TIP	Manakala mengembangkan subrutin, pertama letakkan itu pada modul sehinggan Anda dapat dengan mudah menjalankannya dengan mengklik ikon Run. Solusi lainnya adalah dengan menggunakan subrutin pertama untuk memanggil lainnya, seperti ditampilkan pada Listing 1. Ini lebih cepat daripada menggunakan dialog Macro.

Kode yang digunakan pada bab ini tersedia pada dokumen teks OpenOffice.org dinamai SC01.sxw. Download dan buka dokumen ini. Manakala dokumen yang mengandung makro dibuka, OpenOffice.org memberikan peringatan (lihat Gambar 12). Peringatan ini membantu Anda menghindari kecelakaan menjalankan makro yang mengandung virus. Walaupun Anda masih dapat menjalankan makro secara manual menggunakan dialog Macro, tombol makro pada dokumen tidak berfungsi. Klik Run untuk secara penuh mengaktifkan tombol makro yang ditambahkan pada SC01.sxw.

TIP	Anda dapat mengkonfigurasi dokumen untuk menjalankan makro secara otomatis manakala dokumen dibuka. Ini adalah bagaimana virus makro menyebar dengan menggunakan dokumen. Jika Anda tidak ingin dokumen mengandung makro, Anda sebaiknya mengklik Do Not Run. Ini akan melarang makro untuk berjalan secara otomatis ketika dokumen dibuka.

Gambar 12. Anda baru saja membuka dokumen OpenOffice.org yang mengandung makro.

SC01.sxw mengandung tiga tombol: Main, Hello World 1, dan Hello World 2. Tiap tombol dikonfigurasi untuk menjalankan subrutin yang berhubungan ketika tombol diklik. Tombol tidak melakukan apapun jika Anda mengklik Do Not Run ketika dokumen dipanggil.

Ini tidak mungkin untuk menambah direktori ke daftar “secure paths.” Jika Anda yakin bahwa path mengandung dokumen dimana Anda dapat dengan aman meyakini bahwa tidak ada virus makro, Anda dapat mencek kotak, dan path akan ditambahkan ke daftar secure paths. Dimasa yang akan datang, semua dokumen yang dipanggil dari lokasi yang sama akan dipertimbangkan aman, dan makro akan selalu dijalankan.

Menyimpan makro dalam library aplikasi

Aplikasi OpenOffice.org sendiri merupakan kontainer library. Ini adalah tempat yang bagus untuk menyimpan kode dan dialog secara umum ke banyak dokumen. Kontrol versi sangat mudah jika makro disimpan dalam lokasi yang sama. Jika lima dokumen semua mengandung makro yang sama, tidak hanya mengotori tempat penyimpanan, tetapi jika makro berubah, Anda harus mengubah makro pada lima dokumen yang berbeda.

Untuk menyimpan makro dalam library aplikasi, gunakan metode yang sama seperti di dokumen. Aplikasi level kontainer dinamai “soffice”. Aplikasi OpenOffice.org mengandung beberapa library. Librari Standard mencakup modul yang dinamai Module1, dimana mengandung satu makro kosong yang tidak melakukan apapun. Gunakan dialog Macro Organizer pada Gambare 3 untuk menambah library baru.

Perhatian	Menguninstall OpenOffice.org mungkin menghapus library yang disimpan dalam level aplikasi, jadi sebaiknya Anda selalu membuat backup dari library Anda. Menginstalli kembali atau menginstall versi baru OpenOffice.org mungkin menulis ulang library level aplikasi. Backup library ini manakal Anda membackup dokumen Anda. Pada kebanyakan kasus, library yang Anda buat masih terdapat disana, tetapi berkas konfigurasi adalah baru dan tidak merefleksikan library baru. Oleh sebab itu, ini sangat mungkin untuk mengembalikan library Anda dari lokasi library stAndar. Untuk informasi lebih, lihat bagian “Manajemen library” belakangan pada bab ini.

Tiap library aplikasi disimpan dalam direktorinya sendiri. Untuk memastikan dimana OpenOffice.org menyimpan library apliaski, pilih Tools > Options. Pada dialog Options , perluas cabang OpenOffice.org pada diagram pohon dan pilih Paths. Masukan dasar menunjukkan lokasi library luar.

Sebelum menginstall versi baru OpenOffice.org, buat salinan semua library level aplikasi. Jika Anda menginstall OOo ke lokasi yang sama, itu akan menulis ulang berkas pengaturan yang menunjukkan kepada OOo dimana library level aplikasi berada. Librari biasanya masih disana tetapi OOo tidak tahu tentang itu. Untik mengembalikan library yang hilang, dengan tanpa melihat dimana mereka berada, gunakan tab Libraries pada Macro Organizer (lihat Gambar 3). Pastikan bahwa “soffice” dipilih pada daftar Application/Document, dan kemudian klik tombol Append. Layarilah direktori yang mengandung library dimana Anda ingin menambahkannya. Pilih berkas script.xlb dam klik Open. Lakukan ini untuk tiap library yang ingin Anda kembalikan. Metode ini dapat juga digunakan untuk menambah library yang disimpan dalam dokumen.

TIP	Jangan menggunakan library Standard jika Anda tidak berpikir untuk menambah library Anda di lokasi lainnya. Simpan semua modul Anda dalam library dengan nama yang berarti yang Anda buat. Librari Standard adalah spesial, dan Anda tidak dapat menghapus atau menulis ulangnya.

Untuk mempraktekkan penambahan makro ke library level aplikasi, buka Macro Organizer. Pastikan bahwa kontainer library “soffice” berada pada kontainer yang sekarang. Klik tombol New Module untuk menambah modul baru ke library level aplikasi. Untuk menambah library baru, pilih tab Libraries. Pastikan bahwa “soffice” dipilih pada dafta Application/Document , dan kemudian klik tombol New.

Librari disimpan dalam dokumen mungkin ditambahkan ke aplikasi kontainer library. Manakala library ditambahkan, itu akan menulis ulang library yang telah ada dengan nama yang sama. Adalah ide yang bagus untuk membuat nama library yang berarti untuk memegang makro. Ini untuk membatasi masalah penggerakan makro diantara kontainer library.

Integrated Development Environment

Integrated development environment (IDE) adalah set peralatan pemrograman digunakan untuk memfasilitasi pembuatan perangkat lunak. OpenOffice.org meliputi IDE yang sangat kapabel dengan peralatan yang menjalankan, mengedit, dan menemukan kesalahan pada makro Anda. Ini akan menghabiskan waktu untuk menjadi terbiasa dengan fiturnya. Gambar 13 menunjukkan IDE dengan caption ditambahkan untuk banyak sekali ikon dan area tampilan. Tampilan utama dimana kode makro didaftarkan adalah jendela editor. Banyak sekali fitur seperti Stop, Breakpoint, Single Step, dan Watch pane melayani debugger sederhana yang efektif untuk kode makro.

Bagian ini memberikan pandangan sekilas mengenai fungsi stAndar IDE. Jangan terkejut jika Anda tidah sepenuhnya faham bagaimana menggunakan itu semua pada saat ini. Anda akan menjadi sangat terbiasa dengan fungsi ini setelah Anda mencoba beberapa contoh. Set pertama kali fungsi digunakan untuk debugging, dan salah satunya dijelaskan hampir mendekati akhir dari bagian ini mendukung organisasi dan pengaturan objek dalam program makro, library, dan dokumen Anda. Berikut adalah penjelasan ikon.

Ikon Compile mengcompile dan melakukan pengecekan sintak hanya pada modul yang sekarang. Ikon Compile berguna jika Anda tidak ingin menjalankan makro tetapi Anda ingin memverifikasi bahwa sintak tersebut benar. Tidak ada pesan ditampilkan kecuali kesalahan ditemukan (lihat Gambar 10). Ketika kesalahan ditemukan, dialog muncul, yang mengindikasikan kesalahan. Panah pada kolom Breakpoint menandai baris dengan kesalahan, bagian kode yang menyebabkan kesalahan ditandai. Klik tombol OK untuk menutup dialog kesalahan.

Catatan	Proses pengcompilan terjemahan makro OOo ke bahasa mesin, dimana komputer dapat memahami dan menjalankannya.

Ikon Run mengcompile semua modul pada direktori yang sekarang dan kemudian menjalankan subrutin pertama atau fungsi pada modul yang sekarang. Ini berbeda dengan ikon Compile, yang hanya mengcompile modul yang sekarang.

Gambar 13. IDE yang terkandung pada OpenOffice.org sangat kapabel.

Ikon Stop menghentikan makro yang sedang berjalan. Ketika Anda mengklik ikon ini, Anda tidak dapat melanjutkan makro; Anda harus memulainya lagi, dari awal. Ikon Stop dimungkinkan jika makro sedang berjalan. Ketika dimungkinkan, ikon Stop menyerupai tanda berhenti lalu lintas.

Ikon Procedure Step menjalankan pernyataan yang sekarang. Jika makro belum berjalan, rutin pertama pada modul dimulai dan ditandai sebagai pernyataan yang sekarang. Pernyataan yang sekarang memiliki panah pada kolom Breakpoint, dan kursor digerakkan ke baris. Bagaimanapun jika makro sudah berjalan dan pernyataan yang bisa dijalankan selanjutnya ditandai sebagai yang sekarang. Ikon Procedure Step mencoba memanggil rutin lainnya sebagai pernyataan tunggal dan tidak melangkah kepadanya. Catat bahwa ikon memiliki panah yang membengkok disekitar tanda kurung yang menghadirkan pemanggilan subrutin atau fungsi.

Ikon Single Step menjalankan pernyataan yang sekarang. Kebiasaannya sama dengan ikon Procedure Step kecuali bahwa subrutin dan fungsi tidak disuguhkan dalam satu pernyataan. Tiap pernyataan pada rutin yang dipanggil dipertimbangkan oleh pernyataan. Subrutin dan fungsi masuk juga, penandaan subrutin yang dipanggil atau definisi fungsi sebagai pernyataan yang sekarang. Catat bahwa ikon mengandung panah yang menunjuk pada tanda kurung yang menghadirkan pemanggilan subrutin atau fungsi.

Ikon Step Back menjalankan makro ke bagian akhir dari rutin yang sekarang dan satu langkah berikutnya. Pengaruhnya adalah sama dengan perulangan mengklik ikon Procedure Step sampai akhir dokumen pada rutin yang sekarang (End Sub atau End Function) dan kemudian mengklik Procedure Step sekali lagi untuk menjalankan rutin. Pernyataan yang mengikuti panggilan ke pernyataan yang sekarang menjadi pernyataan yang sekarang. Jika Anda tidak sengaja mengklik Single Step dibanding Procedure Step, klik ikon Step Back sekali. Catat bahwa ikon mengandung panah yang meninggalkan tanda kurung yang menghadirkan pemanggilan subrutin atau fungsi.

Ikon Breakpoint menentukan breakpoint pada pernyataan yang mengandung kursor. Tanda berhenti merah menandai baris pada kolom Breakpoint. Klik ganda kolom Breakpoint untuk mengubah breakpoint pada pernyataan itu. Klik kanan breakpoint pada kolom Breakpoint untk mengaktifkan atau menonaktifkannya.

Ikon Manage Breakpoints memanggil dialog Manage Breakpoints (lihat Gambar 14).

Gambare 14. Manually edit and configure breakpoints.

Ikon Add Watch menganggap bahwa kata yang sekarang (kata yang mengandung ikon) adalah variabel dan menambah nama variabel ini ke Watch pane.

Ikon Object Catalog membuka jendela Objects (lihat Gambare 15), dimana Anda dapt membrowse semua kontainer library yang tersedia sekarang. Gunakan jendela ini untuk melihat library, modul, dan subrutin mana yang tersedia. Klik ganda subrutin untuk memanggilnya ke IDE. Kegunaannya adalah sama dengan Navigator di dokumen Writer OOo . Anda harus menyimpan berkas sebelum modulnya tersedia dalam Object Catalog.

TIP	Tinggalkan jendela Objects terbuka dan gunakan itu sebagai navigator tuntuk melompat secara mudah diantara modul, library, atau even subrutin dalam modul yang sama.

Gambar 15. Anda dapat membrowse library dan modul yang tersedia dalam jendela Objects.

Ikon Macros meload dialog Makro. Memilih Tools | Macros | Macro juga memanggil dialog Makro.

Ikon Modules memanggil dialog Macro Organizer. Ikon ini memiliki efek yang sama dengan mengklik tombol Organizer pada dialog Makro (liaht Gambar 2 dan Gambar 3).

Pilih atau tempatkan kursor langsung ke bagian kiri tanda kurung, dan kemudian klik ikon Find Parentheses untuk menemukan tanda kurung yang cocok. Manakala IDE cocok dengan tanda kurung, OOo akan memilih tanda kurung dan apapun yang mendekatinya.

Untuk membuka jendela Controls, klik ikon Controls ketika mengedit dialog. (Untuk informasi mengenai kontrol, lihat Bab 17, “Dialogs and Controls” pada OpenOffice.org Macros Explained )

Untuk membuat dialog untuk pengeditan, klik ikon Modules untuk memanggil dialog Macro Organizer. Klik tombol New Dialog untuk membuat dialog baru. Lihat Bab 17, “Dialogs and Controls,” pada OpenOffice.org Macros Explained untuk informasi lebih mengenai pembuatan dialog dalam makro.

Dua ikon terakhir, Insert Source Text danSave As Source, digunakan untuk memasukkan teks yang disimpan dalam berkas sumber luar ke modul yang sekarang, dan untuk menyimpan modul yang sekarang ke berkas teks luar. Ini adalah langkah yang brilian untuk membuat berkas teks yang dapat dengan mudah dikirim ke orang lainnya. Ini berbeda dengan ikon Disk, yang mana digunakan untuk menyimpan semua library atau dokumen yang mengandung modul.

Menggunakan breakpoint

Jika Anda menentukan breakpoint pada kode, makro akan berhenti berjalan pada titik itu. Anda kemudian dapat menginspeksi variabel, kembali menjalankan makro, atau satu langkah ke makro. Jika makro gagal dan Anda tidak tahu kenapa, satu langkah (menjalankan satu pernyataan pada saat itu) mengijinkan Anda untuk melihat makro beraksi. Jika makro gagal, Anda akan mengetahui bagaimana itu sampai sana. Jika sejumlah besar pernyataan berjalan sebelum masalah terjadi, itu tidak mungkin untuk menjalankan satu pernyataan pada waktu yang sama, jadi Anda dapat menset breakpoint pada atau mendekati garis yang menyebabkan masalah. Program akan berhenti berjalan pada titik itu dan Anda dapat berjalan satu langkah makro dan melihat kebiasaannya.

Ikon Breakpoint menset breakpoint pada pernyataan yang mengandung kursor. Penanda berhenti merah menandai garis pada kolom Breakpoint. Klik ganda pada kolom Breakpoint untuk mengubah breakpoint pada pernyataan itu. Klik kanan breakpoint pada kolom Beakpoint untuk mengaktifkan atau menonaktifkannya.

Ikon Manage Breakpoints meload dialog Manage Breakpoints (lihat Gambar 14). Semua breakpoints aktif pada dialog IDE yang sekarang muncul pada daftar paling bawah. Untuk menambah breakpoint, masukkan nomor garis pada bidang masukan pada bagian atas kemudian klik New. Untuk menghapus breakpoint, pilih breakpoint pada daftar dan klik tombol Delete. Bersihkan check box Active untuk menonaktifkan breakpoint yang ditandai tanpa menghapusnya. Input box Pass Count mengindikasikan jumlah berapa kali breakpoint harus dicapai sebelum itu mencapai aktif yang dipertimbangkan. Jika hitungan pass adalah empat (4), maka waktu keempat pernyataan itu mengandung breakpoint yang harus dijalankan, maka itu akan berhenti dabanding berjalan. Ini sangat penting manakala bagian makro tidak jatuh sampai itu dipanggil banyak waktu.

Terdapat dua hal yang menyebabkan breakpoint ditolak: hitungan pass tidak nol, dan secara eksplisit penanda breakpoint “not active” pada dialog Manage Breakpoints. Tiap breakpoint memiliki hitungan pass yang menurun sampai nol manakala itu dicapai. Jika hasil penurunan adalah nol, breakpoint menjadi aktif dan terus aktif karena hitungan pass berada dalam posisi nol terus. Hitungan pass tidak disimpan ke nilai aslinya ketika makro telah selesai atau mulai kembali.

Sangat mudah untuk memonitor nilai variabel dari IDE manakala rutin berjalan. Letakkan kursor selanjutnya atau beberapa kata pada jendela Edit dan klik ikon Add Watch untuk menambahkan kata ke Watch pane. Watch pane menampilkan nilai variabel yang sedang berada dalam lingkup. Teks “<Out of Scope>” ditampilkan untuk variabel yang tidak tersedia. Jalan lainnya untuk menambahkan variabel ke Watch pane adalah dengan mengetik nama ke jendela Watch dan tekan Enter. Untuk menghapus nama dari Watch pane, pilih dia dalam Watch pane atau ketik nama pada jendela Watch dan klik ikon Remove Watch. Klik nama pada Watch pane untuk meletakkan namanya pada jendela Watch.

Catatan	Variabel yang berada dalam lingkup sedang tidak tampak atau tampak pada saat ini. Sebagai contoh, jika variabel “j” didefinisikan didalam HelloWorld1, ini tidak tampak (dalam lingkup) didalam HelloWorld2. Ini didiskusikan selanjutnya.

Manajemen library

Bagian ini berhadapan dengan pembuatan, pentransferan dan penamaan kembali library dan modul. Manakala mempertimbangkan pengaturan library, ini sangat penting untuk pertama kali memahami beberapa dasar yang telah didiskusikan:

Kontainer library mengandung nol atau lebih library.

Tiap library mengandung nol atau lebih modul dan dialog.

Tiap modul mengandung nol atau lebih makro.

Aplikasi adalah kontainer library yang dinamai “soffice”. Librari disimpan dalam aplikasi yang tersedia secara luas untuk semua makro.

Tiap dokumen adalah kontainer library.

Librari yang dinamai Standard adalah spesial; itu selalu ada dan tidak dapat ditulis ulang. Saya merekomendasikan untuk tidak menggunakan library Standard.

Selalu berikan nama yang berarti untuk library dan modul yang Anda buat. Sebagai contoh, Library1 dan Module4 bukan nama yang berarti, walaupun AXONInvoiceForm1 mungkin lebih deskriptif dan membantu.

Bagaimana library disimpan

Librari OpenOffice.org disimpan dalam berkas XML yang dapat dengan mudah diedit dengan menggunakan editor teks. Dengan kata lain, ini sangat mudah bagi Anda untuk membongkar-bongkar dan merusak dokumen Anda. Walaupun mengedit secara manual library luar Anda umunya menyebabkan kesalahan, saya sedikitnya memiliki satu kejadian dimana ini diperlukan, karena Ooo tidak dapat meload modul yang mengandung kesalahan sintaks.

TIP	Mengedit secara manual berkas OOo sangat baik untuk pengguna mahir. Pengguna pemula sebaiknya membaca dengan cepat materi ini atau lewati ke bagian selanjutnya.

Librari aplikasi

Tiap aplikasi library disimpan dalam satu direktori, dan tiap modul dan dialog mengandung satu berkas. Dialog Options (Tools | Options | OpenOffice.org | Paths) mengandung masukan yang mengidentifikasi dimana library disimpan. Librari umum yang terkandung dalam OpenOffice.org disimpan dalam direktori dasar tershare dibawah direktori dimana OOo terinstall. Contoh:

C:\Program Files\OpenOffice.1.1.1\share\basic 'Instalasi Windows

/usr/local/OpenOffice.org1.1.1/share/basic 'Instalasi Linux

Librari yang Anda buat disimpan dalam direktori yang berbeda. Pada komputer Windows saya, saya memiliki instalasi single-user, dan pada komputer Linuxku saya memiliki instalasi jaringan banyak orang. Pilihan yang Anda ambil ketika menginstall OOo berdampak pada lokasi library pribadi Anda. Ini ada dua contoh:

C:\Program Files\OpenOffice.1.1.1\user\basic 'Berkas pengguna Windows

/home/andy/OpenOffice.org1.1.1/user/basic 'Berkas pengguna Linux

Daftar shared direktori menampilkan satu berkas untuk tiap library aplikasi yang terkandung dengan OOo. Direktori pengguna, bagaimanapun, lebih terasa penting (lihat Tabel 1).

Tabel 1. Berkas dan beberapa direktori pada direktori pengguna saya/dasar.

Masukan	Deskripsi
dialog.xlc	Berkas XML yang mengacu tiap berkas dialog yang diketahui pengguna dalam OpenOffice.org.
script.xlc	Berkas XML yang mengacu berkas tiap library yang diketahui pengguna dalam OpenOffice.org.
Standard	Direktori mengandung library Standard.
Pitonyak	Direktori mengandung library dengan kode yang telah saya buat.
PitonyakDialogs	Direktori mengandung library dengan beberapa kode dan dialog.

Note	Tabel 1 mengacu pada direktori Pitonyak dan PitonyakDialogs. Librari Pitonyak dan library PitonyakDialogs tidak berhubungan; nama mereka sama karena saya miskin kreatifitas dan merasa senang ketikan menamainya. Ini tidak benar bahwa library PitonyakDialogs mengandung dialog untuk library Pitonyak.

Berkas dialog.xlc dan script.xlc mengandung acuan ke semua dialog dan library yang diketahui oleh OOo. Librari yang tampak—seperti terlihat pada dialog Macro dan dialog Macro Organizer (lihat Gambar 16)—dibangun dari berkas dialog.xlc dan script.xlc. Jika dua berkas ini ditulis ulang, OOo akan tidak mengetahui tentang library pribadi Anda walaupun mereka ada.

Gambar 16. Dialog Makro dan dialog Macro Organizer menampilkan library yang tersedia dan modul.

Dialog Macro Organizer menunjukkan bahwa library PitonyakDialogs mengandung dua kode modul dan satu dialog. Table 2 mengandung daftar berkas pada direktori PitonyakDialogs. Catat bahwa tiap modul dan dialog pada library memiliki berkas bersesuaian.

Tabel 2. Berkas pada direktori library PitonyakDialogs.

Berkas	Deskripsi
dialog.xlb	Referensi dialog yang dikandung pada library ini.
script.xlb	Referensi modul yang dikandung pada library ini.
Module1.xba	Kode BASIC pada modul dinamai Module1.
SimpleObjectBrowserCode.xba	Kode BASIC pada mosul dinamai SimpleObjectBrowserCode.
SimpleObjectBrowser.xdl	Dialog pada modul dinamai SimpleObjectBrowser.

Berkas dialog.xlc dan script.xlc pada Table 1 mengacu berkas dialog.xlb dan script.xlb pada Tabel 2. Secara umum, tidak ada dari berkas ini yang harus dimodifikasi secara manual, tetapi dalam keadaan bahaya, mereka dapa dimodifikasi secara manual untuk membetulkan beberapa tipe kesalahan.

Librari dokumen

Dokumen OpenOffice.org, ketika disimpan ke disk, disimpan dalam standar format ZIP. Beberapa program yang dapat melihat dan mengekstrak berkas ZIP dapat digunakan untuk menginspeksi dokumen OOo —bagaimanapun, beberapa program akan mensyaratkan Anda untuk merubah ekstensi berkas diakhiri dengan ZIP.

Setelah mengunzip dokumen OOo, Anda akan menemukan berkas yang mengandung primary content, styles, dan settings. Dokumen yang terekstrak juga mengandung tiga direktori. Direktori META-INF mereferensikan semua berkas lainnya, gambar yang ditambahkan, kode library, dan dialog. Catat bahwa library itu mengandung kontainer level aplikasi “soffice” disimpan dalam konfigurasi yang benar-benar berbeda dari library yang dikandung suatu dokumen.

Sebagai percobaan, saya mengambil dokumen yang mengandung berbagai macam kontrtol yang memanggil library spesifik. Saya mengunzip dokumen dan kemudian menggunakan alat pencari-teks untuk menemukan semua acuan ke library spesifik yang dinamai CH03. Setelah secara manual mengubah kejadian teks “CH03” ke “CH04”, saya menzip kembali direktori ke berkas tunggal, dan OOo telah dapat membaca dan menggunakan berkas. Saya dengan sukses mengubah nama library yang dikandung dan tiap referensi ke kontrol dengan mengedit definisi XML.

TIP	Tujuan dari bagian ini adalah dalam keadaan genting, Anda dapat secara manual menginspeksi XML dokumen dan mungkin membetulkan masalah. Ini biasanya TIDAK merupakan langkah terbaik untuk mengubah nama dari library dokumen.

Menggunakan Macro Organizer

Macro Organizer (Tools > Macros > Macro > Organizer) dapat memuaskan sebagian besar keinginan pengguna dalam hubungannya dengan pengaturan modul dan library. Tab Modules dari dialog Macro Organizer (lihat Gambar 16) memberikan kemampuan untuk membuat dan menghapus modul. Dialog Macro Organizer juga memiliki tab Libraries (lihat Gambar 17) digunakan untuk membuat dan menghapus library. Tab Libraries mengandung kotak drop-down box pada bagian atas yang digunakan untuk memilih kontainer library. Dengan kata lain, Anda dapat memilih dokumen terbuka yang dipilih atau kontainer library aplikasi yang dinamai “soffice.”

Gambar 17. Gunakan Macro Organizer untuk membuat, menambah, dan menghapus library.

Catatan	Nama dokumen adalah nama berkas, kecuali judul dokumen diset pada dialog properti dokumen (File > Properties > Description). Jika properti Judul diset, ini digunakan sebagai judul jendela, dialog Makro, dan dialog Macro Organizer.

Merename modul dan library

Anda dapat mengubah nama modul atau library dari dialog Macro Organizer. Nama modul diubah dari tab Modules, dan nama library diubah dari tab Libraries. Ketika Anda mengubah nama library atau modul, itu tidak mengubah apapun yang yang mengacu pada makro yang dikandung. Sebagai contoh, jika saya menulis nomor telepon pada Palm Pilotku dan Anda mengubah nomor telepon, Palm Pilot saya tidak secara otomatis diperbarui. Jadi apa yang memungkinkan pemanggilan makro?

Ketika kontrol disisipkan pada dokumen atau dialog, mereka sering menggunakan makro sebagai handler kejadian.

Makro memanggil dialog yang mengandung library.

Makro mungkin dapat dipanggil dari program diluar OpenOffice.org.

Perhatian	Ketika Anda merubah nama modul atau library, acuan ke makro yang terkandung tidak diperbarui.

Merubah nama library atau modul merupakan hal bodoh untuk dilakukan; harap diingat bahwa sesuatu yang mereferensikan modul dan library tidak akan diperbaharui. Jika tidak ada yang mereferensi kode Anda, rasakan kebebasan untuk merename nama modul dan library. Anda dapat merename library dan modul dengan menggunakan Macro Organizer; prosedurnay adalah sama untuk keduanya:

Temukan library atau modul pada tab yang sesuai dari Macro Organizer (lihat Gambar 16 dan Gambar 17).

Pilih library atau modul.

Tunggu sebentar dan klik library atau modul. Kursor akan muncul untuk mengedit nama library atau modul. Saya telah menemukan ini cukup sensitif, dan terkadang saya harus menggunakan klik tunggal beberapa kali. Jangan kecelakaan dengan klik ganda, karena ini akan membuka isi library atau modul untuk pengeditan.

Ketik nama baru untuk library atau modul dan tekan tombol Enter.

Saya memiliki dokumen yang besar yang mengandung beberapa tombol. Tombol dipanggil makro pada library dan saya harus mengubah nama dari library. Sialnya, setelah saya mengubah nama library, tombol masih menunjukkan pada library asli, yang mana sudah tidak ada. Dengan perasaan berani, saya mengunzip dokumen ke direktori sementara (ingat bahwa dokumen OOo adalah benar-benar berkas zip yang mengandung beberapa berkas yang sebagian besar berupa dokumen). Saya kemudian menggunakan teks editor kesukaan saya untuk mengambil tiap berkas dan saya mengubah nama library lama menjadi nama library baru. Ketika saya telah selesai, saya menzip kembali semua berkas dan direktori ke berkas zip tunggal dan saya telah mengubah semua acuan dengan sukses.

Perhatian	Mengedit dokumen OOo secara manual dengan mengunzip semua berkas dan direktori yang terkandung dan kemudian mengunzipnya adalah suatu kesalahan proses. Jika Anda melakukannya salah, dokumen akan berhenti bekerja. Dengan kata lain, buat salinan dari berkas aslinya.

Menambahkan library

Tombol Append (lihat Gambar 17) pada dialog Macro Organizer membuka sialog Append Libraries, yang mana itu merupakan benar-benar dialog seleksi berkas. Dialog ini digunakan untuk memilih berkas yang mengandung library yang akan ditambahi catatan. Untuk menambah library yang terkandung dalam dokumen, mulai dari memilih dokumen. Tombol Open pada seleksi berkas dialog Append Libraries membuka pilihan library dialog Append Libraries (lihat Gambar 18). Gunakan pilihan library dialog Append Libraries untuk melihat library yang terkandung pada dokumen terpilih dan pilih library yang akan Anda buka.

Gambar 18. Gunakan dialog Append Libraries untuk memilih library yang akan ditambahkan.

Pilihan library dialog Append Libraries pada Gambar 18 mengijinkan Anda untuk memasukkan berapa banyak library sebanyak yang Anda suka. Librari yang sudah ada tidak ditulis ulang kecuali kotak “Replace existing libraryes” dicek. Check box “Insert as reference” hanya tersedia manakala library yang dimasukkan tidak terdapat dalam dokumen. Klik OK untuk menambahkan library tepilih.

TIP	Ini sangat tidak mungkin untuk menulis ulang library Standard. Saya merekomendasikan untuk tidak menggunakan librar Standard disebabkan Anda tidak dapat memasukkannya ke dokumen atau aplikasi lain.

Librari yang tidak termuat dalam dokumen disimpan dalam direktori tersendiri. Untuk memasukkan library yang tidak tersimpan dalam dokumen, buka pemilihan berkas dialog Append Libraries (lihat Gambar 19) dan pilih direktori yang mengandung berkas library. Tidaklah bermasalah dimanapun berkas library disimpan. Berkas mungkin di disket sebagai backup, atau mereka mungkin berasal dari direktori yang sama digunakan oleh OOo untuk library tingkat aplikasi. Ketika saya menginstall versi baru OpenOffice.org, saya memasukkan library dari instalasi OOo sebelumnya.

Ketika memasukkan library yang tidak terkandung pada dokumen, dua berkas ditunjukkan: dialog.xlb dan script.xlb (lihat Tabel 2 dan Gambar 19). Kedua berkas tersebut dibutuhkan dan secara otomatis dimasukkan dengan mengabaikan berkas mana yang Anda pilih. Dengan kata lain, Anda dapat memilih baik dialog.xlb atau script.xlb; keduanya akan dimasukkan.

Gambar 19. Tidak masalah berkas mana yang Anda pilih; keduanya dimasukkan.

TIP	Ketika saya menginstall versi baru OOo, saya menambahkan library pribadi saya dari versi terinstall sebelumnya. Saya juga menggerakkan library saya ke komputer lainnya dan menginstallnya disana.

Bab 16, “Library Management” pada OpenOffice.org Macros Explained mengandung informasi dan contoh manipulasi dan akses library serta modul menggunakan Basic OOo.

Kesimpulan

Makro disimpan dalam modul, modul disimpan dalam library, dan library disimpan dalam kontainer library. Aplikasinya adalah kontainer library. IDE digunakan untuk membuat dan mendebug makro dan dialog.

Anda baru saja menyelesaikan salah satu langkah tersulit dalam penulisan makro untuk OpenOffice.org: menulis makro pertama Anda! Anda sekarang siap untuk mengeksplorasi, mencoba contoh makro lainnya, dan membuat sedikit dari kepunyaan Anda.

Menambahkan library

Berkenalan Dengan Makro	26

Judul:	Berkenalan Dengan Makro : Diekstrak dari "OpenOffice.org Macros Explained"
Versi:	1.0
Edisi pertama:	Januari 2005
Edisi Inggris pertama: Edisi Indonesia pertama:	Januari 2005 Februari 2005

Gambaran Umum

Berkenalan Dengan Makro	xxvi

Berkenalan Dengan Makro

Jean Hollis Weber

2005-01-17T18:21:30

Willy Sudiarto Raharjo

Jean Hollis Weber