Câu chuyện tôi xây dựng PS1 GUI Utility giúp vận hành ServiceNow nhẹ hơn
Bài viết tổng hợp bối cảnh, hướng thiết kế và hiệu quả của tiện ích PowerShell có GUI hỗ trợ xuất dữ liệu định kỳ và định nghĩa Database View trong ServiceNow.
Mở đầu
Khi tiếp tục vận hành và bảo trì ServiceNow, việc tạo Database View dễ phụ thuộc vào một số cá nhân vì công việc này đòi hỏi kiến thức nền tảng về cơ sở dữ liệu quan hệ (RDB). Ngoài ra, dù muốn khai thác dữ liệu qua GUI, khối lượng lớn có thể vượt giới hạn và khiến việc xuất dữ liệu không thực hiện được; các cột lấy ra thay đổi theo trạng thái của màn hình danh sách; còn tệp đính kèm nằm rải rác ở từng bản ghi nên thu thập rất mất công. Vì vậy, tôi đã tạo một tiện ích PowerShell có GUI hỗ trợ xuất dữ liệu thô và định nghĩa Database View.
Bài viết trình bày bối cảnh, định hướng triển khai, thiết kế và hiệu quả vận hành dựa trên phần triển khai trong kho mã công khai.
- Tên công cụ: PS1 SNOW Utilities
- Kho mã: https://github.com/arimagml-collab/PS1SOWUtilities
- Hình thức triển khai: PowerShell 5.1 + WinForms (chạy cục bộ trên Windows)
- Tài liệu tham khảo: README, script chính và ghi chú thiết kế (
docs/)
Bối cảnh 1: xuất dữ liệu thì được, nhưng vận hành vẫn nặng
UI tiêu chuẩn của ServiceNow có thể xuất dữ liệu. Tuy nhiên, trong vận hành thực tế, các vấn đề sau dần chồng chất.
- Muốn lần nào cũng xuất cùng một cấu trúc cột, nhưng thay đổi ở màn hình danh sách lại dễ ảnh hưởng đến kết quả.
- Khi cần trích xuất định kỳ với đầy đủ cột và cả tên nội bộ, công sức giải thích quy trình tăng lên đáng kể.
- Với dữ liệu lớn, bản thân việc xuất qua GUI trở nên nặng nề, còn quản lý lần chạy và chạy lại cũng khó hơn.
Kết quả là bên bảo trì phải dành thời gian hỗ trợ cách lấy dữ liệu thay vì cách sử dụng dữ liệu. Tôi đổi hướng bằng cách chuẩn bị cơ chế để từng bộ phận tự xuất một tập cột cố định thông qua API.
Bối cảnh 2: tạo Database View dễ bộc lộ khoảng cách kiến thức về RDB
Database View hữu ích, nhưng là một rào cản với người không phải kỹ sư hoặc ít kinh nghiệm về cơ sở dữ liệu quan hệ.
- Các thao tác với
sys_db_viewvàsys_db_view_tablenằm ở những ngữ cảnh khác nhau, khiến người dùng phải chuyển màn hình nhiều lần. - Khó xem danh sách tên nội bộ của các cột ngay trên cùng một màn hình.
- Trong môi trường không có quyền Admin, phải tìm tên nội bộ ở một môi trường khác rồi mang sang.
- Khi gõ tay mệnh đề Where và định nghĩa JOIN, dễ mắc lỗi chính tả hoặc tham chiếu nhầm.
Vì vậy, tôi cho rằng cần có hỗ trợ để xây dựng định nghĩa bằng GUI trong khi xem các lựa chọn có sẵn.
Công cụ tôi đã tạo: PS1 SNOW Utilities
PS1 SNOW Utilities là công cụ PowerShell tập hợp các tác vụ thường gặp khi vận hành ServiceNow vào một GUI. Các tab chính gồm những phần sau.
1. Tab Export
- Chọn bảng đích hoặc nhập thủ công
- Đặt bộ lọc: toàn bộ bản ghi hoặc khoảng thời gian của
sys_updated_on - Chọn định dạng đầu ra: CSV / JSON / Excel
- Chia thành nhiều tệp CSV khi xuất số lượng bản ghi lớn
- Chỉ định thư mục đầu ra và xem nhật ký thực thi
Mục tiêu vận hành là chuẩn hóa quy trình trích xuất, giảm khác biệt trong cách làm giữa những người phụ trách.
2. Tab Database View Editor
- Nhập tên nội bộ và nhãn của view
- Thiết lập bảng cơ sở và Prefix
- Thêm JOIN: cột bên trái và bên phải, Variable Prefix, tùy chọn LEFT JOIN
- Tải lại danh sách cột có thể chọn và chọn các cột cần hiển thị
- Tạo view và hiển thị liên kết đến kết quả
Có thể xây dựng định nghĩa trong khi xem các lựa chọn, nhờ đó giảm công sức chuyển qua lại giữa các màn hình ServiceNow để gõ tay mệnh đề Where và điều kiện JOIN.
3. Tab Attachment Harvester
- Thu thập hàng loạt tệp đính kèm liên quan theo khoảng thời gian cập nhật
- Thêm số thứ tự để tránh trùng tên tệp
- Ghi nhật ký quá trình lấy tệp
Tính năng này giúp thực hiện việc thu thập tệp đính kèm, vốn thường xuất hiện trong kiểm toán và điều tra, theo một quy trình có thể lặp lại.
4. Tab Truncate
- Xóa toàn bộ bản ghi trong bảng để phục vụ phát triển
- Nhập mã xác nhận, hiển thị thông tin đối tượng và thiết lập thử lại
Đây là thao tác nguy hiểm nên không khuyến nghị dùng trên production. Tính năng được thiết kế cho việc kiểm thử nạp lại dữ liệu trong môi trường kiểm thử.
5. Tab cài đặt
- Tên instance
- Phương thức xác thực: ID người dùng và mật khẩu / khóa API
- Ngôn ngữ: tiếng Nhật / tiếng Anh
- Giao diện: Dark / Light
- Thiết lập kết nối bằng tên miền riêng:
instanceDomain
Các giá trị nhập được lưu vào settings.json. Những giá trị nhạy cảm được mã hóa bằng Windows DPAPI (CurrentUser) trước khi lưu.
Những điểm chính trong thiết kế
Điều tôi chú trọng ở lần triển khai này là thiết kế giúp giảm gánh nặng bảo trì trong quá trình vận hành.
-
Tập trung xử lý giao tiếp vào các hàm dùng chung
Invoke-SnowRequestbao bọc các thao tác GET/POST/PATCH/DELETE và lấy tệp đính kèm, tránh để xác thực, xử lý ngoại lệ và ghi log bị phân tán. -
Tách việc dựng UI khỏi điều khiển hiển thị
Nhóm hàmBuild-*dựng các thành phần UI, cònApply-*LanguagevàSet-Themexử lý chuyển đổi hiển thị. -
Làm cho việc lưu cài đặt ổn định hơn
Load-Settings/Save-SettingscùngRequest-SaveSettingsgiúp hạn chế cả việc bỏ sót thay đổi chưa lưu lẫn lưu quá nhiều lần. -
Xác nhận nhiều lớp cho các thao tác nguy hiểm
Quy trình Truncate có bước nhập mã xác nhận và hiển thị đối tượng để giảm nguy cơ thao tác nhầm. -
Thiết kế để có thể truy vết qua nhật ký
Tab Logs vàConvertTo-LogCompactJsongiúp dễ xem lại kết quả thực thi về sau.
Một lựa chọn thực dụng khi triển khai
Trong môi trường công ty, việc phân phối bộ cài hoặc đưa vào một ứng dụng chạy thường trú có nhiều rào cản. Vì thế, lần này tôi ưu tiên dạng script PowerShell có thể chạy ngay cả khi được phân phối dưới dạng văn bản.
Lựa chọn này giúp giảm rào cản triển khai và rút ngắn thời gian từ lúc đưa công cụ vào đến khi bắt đầu sử dụng thực tế.
Hiệu quả sau khi đưa vào sử dụng
Sau khi triển khai, tôi xác nhận được 4 hiệu quả sau.
- Quy trình Export được cố định trên màn hình, giảm công sức giải thích cho từng yêu cầu trích xuất.
- Khi tạo Database View, số lần phải gõ tay mệnh đề Where trong UI ServiceNow đã giảm.
- Có thể thu thập hàng loạt tệp đính kèm theo khoảng thời gian, nên giảm được các thao tác lặp lại khi điều tra.
- Việc lưu cài đặt giúp giảm số lần phải nhập lại tên instance và thông tin xác thực.
Hiệu quả không hào nhoáng, nhưng giá trị thực tế nằm ở chỗ giảm được rõ rệt thời gian dành cho những việc mà người vận hành cứ phải lặp đi lặp lại.
Giới hạn và lưu ý
- Danh sách bảng được lấy từ
sys_db_object, nên tùy ACL mà có thể không lấy được. Có thể khắc phục bằng cách nhập thủ công. - Một số môi trường có giới hạn đối với việc tự động lưu mệnh đề Where hoặc định nghĩa JOIN, nên có thể phải bổ sung bằng tay ở phía ServiceNow.
- Công cụ này không liên quan đến công ty ServiceNow và không được công ty phê duyệt, bảo đảm hay hỗ trợ.
Tổng kết
Tôi tạo PS1 SNOW Utilities để giảm các vướng mắc thực tế khi trích xuất dữ liệu và định nghĩa Database View.
Về cảm nhận cá nhân, tôi đã biết từ trước rằng có thể tạo GUI bằng PowerShell, nhưng chưa từng nghĩ đến việc tự bắt tay làm. Trải nghiệm đi đến được sản phẩm như thế này nhờ AI tạo sinh hỗ trợ, chủ yếu bằng chỉ dẫn gần với cách làm no-code, khiến tôi cảm nhận rất rõ tốc độ phát triển của AI. Đồng thời, tôi nghĩ các công cụ low-code và no-code truyền thống khó tránh khỏi giai đoạn phải xác định lại lợi thế của mình và chịu áp lực trở nên lỗi thời.