Saya Membuat PS1 GUI Utility untuk Memudahkan Operasional ServiceNow
Artikel ini merangkum latar belakang, desain, dan dampak utility PowerShell berbasis GUI yang membantu ekspor data rutin serta definisi Database View di ServiceNow.
Pendahuluan
Dalam operasional dan pemeliharaan ServiceNow, pembuatan Database View cenderung bergantung pada orang tertentu karena memerlukan pengetahuan dasar tentang basis data relasional (RDB). Selain itu, saat ingin memanfaatkan data melalui GUI, volume data yang besar dapat melampaui batas sehingga ekspor tidak bisa dilakukan, kolom yang diambil dapat berubah mengikuti kondisi tampilan daftar, dan lampiran tersebar di tiap record sehingga pengumpulannya merepotkan. Karena itu, saya membuat utility PowerShell dengan GUI untuk membantu ekspor data mentah dan penyusunan definisi Database View.
Artikel ini merangkum latar belakang, arah implementasi, desain, dan dampaknya pada operasional berdasarkan implementasi dalam repositori publik.
- Nama alat: PS1 SNOW Utilities
- Repositori: https://github.com/arimagml-collab/PS1SOWUtilities
- Bentuk implementasi: PowerShell 5.1 + WinForms (dijalankan secara lokal di Windows)
- Referensi: README, skrip utama, dan catatan desain (
docs/)
Latar belakang 1: ekspor data bisa dilakukan, tetapi operasionalnya berat
UI standar ServiceNow dapat mengekspor data. Namun, dalam operasional nyata, masalah berikut terus bertambah.
- Susunan kolom yang sama diinginkan setiap kali ekspor, tetapi perubahan tampilan daftar mudah memengaruhi hasilnya.
- Ketika diperlukan pengambilan rutin yang mencakup semua kolom beserta nama internalnya, beban menjelaskan prosedur meningkat tajam.
- Untuk data berjumlah besar, ekspor melalui GUI sendiri menjadi berat, sementara pengelolaan eksekusi dan pengulangannya semakin sulit.
Akibatnya, tim pemeliharaan menghabiskan waktu untuk membantu cara mengambil data, bukan cara memanfaatkannya. Saya mengubah pendekatan dengan menyiapkan mekanisme agar setiap departemen dapat mengekspor sendiri kumpulan kolom yang tetap melalui API.
Latar belakang 2: pembuatan Database View memperlihatkan kesenjangan pengetahuan RDB
Database View berguna, tetapi cukup sulit bagi pengguna nonteknis atau yang minim pengalaman dengan basis data relasional.
- Operasi pada
sys_db_viewdansys_db_view_tableberada dalam konteks terpisah sehingga memerlukan banyak perpindahan layar. - Daftar nama internal kolom sulit diperiksa sekaligus pada layar yang sama.
- Di lingkungan tanpa izin Admin, nama internal harus dicari di lingkungan lain lalu dibawa kembali.
- Pengetikan manual klausa Where dan definisi JOIN rawan salah eja dan salah referensi.
Karena itu, saya menilai perlu ada bantuan untuk menyusun definisi melalui GUI sambil melihat pilihan yang tersedia.
Yang saya buat: PS1 SNOW Utilities
PS1 SNOW Utilities adalah alat PowerShell yang menyatukan tugas-tugas yang sering muncul dalam operasional ServiceNow ke dalam satu GUI. Susunan tab utamanya sebagai berikut.
1. Tab Export
- Memilih tabel target atau memasukkannya secara manual
- Menentukan filter: semua record atau rentang
sys_updated_on - Memilih format keluaran: CSV / JSON / Excel
- Ekspor ke beberapa CSV terpisah untuk jumlah record yang besar
- Menentukan folder keluaran dan memeriksa log eksekusi
Tujuan operasionalnya adalah menstandarkan prosedur ekstraksi agar perbedaan langkah antarpetugas berkurang.
2. Tab Database View Editor
- Memasukkan nama internal dan label view
- Mengatur tabel dasar dan Prefix
- Menambahkan JOIN: kolom kiri dan kanan, Variable Prefix, serta pilihan LEFT JOIN
- Memuat ulang pilihan kolom dan memilih kolom yang ditampilkan
- Membuat view dan menampilkan tautan hasilnya
Definisi dapat disusun sambil melihat pilihan yang tersedia. Ini mengurangi beban berpindah-pindah layar ServiceNow untuk mengetik klausa Where dan kondisi JOIN secara manual.
3. Tab Attachment Harvester
- Mengumpulkan lampiran terkait sekaligus berdasarkan rentang waktu pembaruan
- Menambahkan nomor berurutan untuk menghindari benturan nama file
- Mencatat log proses pengambilan
Fungsi ini memudahkan pengumpulan lampiran yang sering diperlukan untuk audit atau investigasi melalui prosedur yang dapat diulang.
4. Tab Truncate
- Menghapus seluruh record tabel untuk kebutuhan pengembangan
- Memasukkan kode konfirmasi, menampilkan informasi target, dan mengatur percobaan ulang
Karena ini operasi berbahaya, penggunaannya di produksi tidak disarankan. Fitur ini ditujukan untuk pengujian pengisian ulang data di lingkungan validasi.
5. Tab pengaturan
- Nama instance
- Metode autentikasi: ID pengguna dan kata sandi / kunci API
- Bahasa: Jepang / Inggris
- Tema: Dark / Light
- Pengaturan koneksi domain khusus:
instanceDomain
Nilai masukan disimpan dalam settings.json. Nilai sensitif disimpan setelah dienkripsi dengan Windows DPAPI (CurrentUser).
Pokok-pokok desain
Dalam implementasi ini, yang saya utamakan adalah desain yang mengurangi beban pemeliharaan selama operasional.
-
Memusatkan proses komunikasi dalam fungsi bersama
Invoke-SnowRequestmembungkus GET/POST/PATCH/DELETE dan pengambilan lampiran agar autentikasi, penanganan exception, dan penulisan log tidak tersebar. -
Memisahkan pembuatan UI dari pengendalian tampilan
Kelompok fungsiBuild-*membangun elemen UI, sedangkanApply-*LanguagedanSet-Thememenangani perubahan tampilan. -
Menstabilkan penyimpanan pengaturan
Load-Settings/Save-SettingsdanRequest-SaveSettingsdigunakan untuk mengurangi pengaturan yang lupa disimpan maupun penyimpanan yang berlebihan. -
Memberikan beberapa lapis konfirmasi untuk operasi berbahaya
Proses Truncate menyertakan kode konfirmasi dan tampilan target untuk mengurangi risiko salah operasi. -
Mendesain implementasi agar mudah ditelusuri melalui log
Tab Logs danConvertTo-LogCompactJsonmemudahkan penelusuran hasil eksekusi setelah proses selesai.
Pilihan praktis dalam implementasi
Di lingkungan perusahaan, distribusi installer atau pemasangan aplikasi yang terus berjalan sering menghadapi hambatan besar. Karena itu, kali ini saya mengutamakan bentuk skrip PowerShell yang tetap bisa dijalankan meskipun didistribusikan sebagai teks.
Pilihan ini menurunkan hambatan penerapan sekaligus mempersingkat waktu hingga alat mulai digunakan di lapangan.
Dampak setelah penerapan
Setelah diterapkan, saya dapat melihat 4 dampak berikut.
- Prosedur Export ditetapkan melalui layar, sehingga beban menjelaskan setiap permintaan ekstraksi berkurang.
- Saat membuat Database View, kebutuhan mengetik klausa Where secara manual di UI ServiceNow berkurang.
- Lampiran dapat dikumpulkan sekaligus dengan filter rentang waktu, sehingga pekerjaan berulang saat investigasi menjadi lebih singkat.
- Penyimpanan pengaturan mengurangi frekuensi memasukkan ulang nama instance dan informasi autentikasi.
Dampaknya memang tidak mencolok, tetapi nilai praktisnya terletak pada berkurangnya waktu untuk pekerjaan yang terus diulang oleh petugas operasional.
Batasan dan hal yang perlu diperhatikan
- Daftar tabel diperoleh dari
sys_db_object, sehingga ACL tertentu dapat menghalangi pengambilannya. Masukan manual menjadi jalan keluarnya. - Pada sebagian lingkungan, penyimpanan otomatis klausa Where atau definisi JOIN dibatasi, sehingga perlu dilengkapi secara manual di ServiceNow.
- Alat ini tidak berafiliasi dengan ServiceNow dan tidak mendapat persetujuan, jaminan, maupun dukungan dari perusahaan tersebut.
Ringkasan
PS1 SNOW Utilities ini saya buat untuk mengurangi hambatan praktis dalam ekstraksi data dan penyusunan definisi Database View.
Secara pribadi, saya sudah tahu bahwa GUI dapat dibuat dengan PowerShell, tetapi belum terpikir untuk mulai mengerjakannya sendiri. Pengalaman mewujudkannya sejauh ini dengan bantuan AI generatif, melalui instruksi yang hampir menyerupai pendekatan no-code, membuat saya benar-benar merasakan cepatnya perkembangan AI. Pada saat yang sama, saya merasa alat low-code dan no-code konvensional akan sulit menghindari fase ketika keunggulannya harus didefinisikan ulang dan tekanan untuk menjadi usang semakin kuat.