🍸 SCSupport Lite - Hướng dẫn sử dụng toàn tập

Chào mừng bạn đến với SCSupport Lite (tên hiển thị: LCC lowtech). Đây là một công cụ (extension) mạnh mẽ dành riêng cho Visual Studio Code, được thiết kế để giúp các lập trình viên làm việc với thư viện SC một cách nhanh chóng, chuẩn xác và tiện lợi nhất.

Phiên bản Lite đã được tối ưu hóa, loại bỏ các chức năng cũ/thừa để mang lại trải nghiệm nhanh và nhẹ nhất cho máy tính của bạn.

1. Bắt đầu nhanh (Khởi động)

Để truy cập mọi tính năng của extension, bạn chỉ cần sử dụng Command Palette (Bảng lệnh) của VS Code:

Bước 1: Bấm tổ hợp phím Ctrl + Shift + P (trên Windows) hoặc Cmd + Shift + P (trên Mac).
Bước 2: Gõ chữ Cocktail. Bạn sẽ thấy toàn bộ danh sách các chức năng của extension hiện ra.
Bước 3: Nhấn phím Mũi tên lên/xuống và ấn Enter để chọn tính năng bạn muốn dùng.

2. Cài đặt cấu hình Dự án (Config)

Để extension biết bạn đang làm việc trên dự án nào và cần kết nối tới Database nào, bạn phải thiết lập file cấu hình.

Cách thiết lập:

Mở Command Palette (Ctrl + Shift + P), gõ Cocktail và chọn lệnh -- Setting environment --.
Một danh sách hiện ra, bạn chọn mục Setting. Extension sẽ tự động mở file config.json lên cho bạn.
Chỉnh sửa nội dung file theo mẫu dưới đây và lưu lại (Ctrl + S).

Mẫu file config.json chi tiết:

{
    "common": {
        "OPEID": "CO",
        "Company": "UCD",
        "LocalHost": "" 
    },
    "KEY": {
        "Name": "Tên Dự Án (VD: Project Name)",
        "User": "VSN_RPS", // Tài khoản database
        "Pass": "P",       // Mật khẩu database
        "Host": "localhost:1521/FREEPDB1", // Địa chỉ database (host:port/SID)
        "NET": "T:/VISION/NET",            // Đường dẫn NET của thư viện
        "EndCoding": "JP", 
        "ClaudeFolder": "C:\\DuAn\\Claude",
        "ProjectFolder": [
            "C:\\DuAn\\VISION",
            "C:\\DuAn\\SoSanh_Data.xlsm",
            "C:\\DuAn\\TemplateUT.xlsm"
        ]
    }
}

Lưu ý: Bạn có thể copy một block như "KEY" ra thành nhiều block khác (ví dụ "OKA", "FSA") để lưu trữ nhiều dự án khác nhau.

Chuyển đổi dự án: Sau khi lưu cấu hình, lần tới khi bạn chạy lệnh -- Setting environment --, danh sách các dự án (KEY, OKA, FSA...) sẽ hiện ra. Bạn chỉ cần click chọn dự án mình muốn làm việc là xong!

3. Các tính năng hỗ trợ Code (Editor)

Extension cung cấp các phím tắt cực kì tiện dụng khi bạn đang gõ code:

Thêm Comment tự động:
- Alt + A: Chèn comment báo hiệu đoạn code thêm mới (ADD).
- Alt + U: Chèn comment báo hiệu đoạn code cập nhật (UPD).
- Alt + D: Chèn comment báo hiệu đoạn code xóa (DEL). (Lệnh sẽ tự động chèn thông tin user/ngày tháng theo đúng chuẩn của SC).
Đánh dấu dòng code (Pin/Bookmark): Để chuột tại dòng code quan trọng và bấm phím F9. Dòng đó sẽ được ghim lại bên Sidebar (sẽ giải thích ở phần dưới).
Chế độ Edit Mode (Ctrl + F7): Chuyển đổi nhanh file hiện tại sang chế độ có thể chỉnh sửa (Thường dùng với các file temporary).
Vẽ thước căn chỉnh (Ctrl + Alt + R): Vẽ thanh thước kẻ (Ruler) trên màn hình để bạn dễ dàng canh lề chữ.
Chuyển định dạng ngôn ngữ (F7): Dùng khi đang mở file config/text. Phím này giúp đổi nhanh định dạng đọc file từ plaintext sang định dạng ini để dễ nhìn code hơn.

4. Quản lý Không gian làm việc (Workspace)

Mở Program Workspace (Ctrl + F10): Đây là tính năng quan trọng nhất! Khi chạy lệnh này, một danh sách các Program (PG) trong hệ thống sẽ hiện ra. Click chọn 1 PG, extension sẽ tự động gom toàn bộ các file Unit liên quan đến PG đó và mở chúng trong một cửa sổ VS Code mới tinh gọn.
Tải lại Workspace (🔄️ Reload workspace): Chạy lệnh này từ Command Palette khi bạn vừa cấu hình xong hoặc thấy VS Code bị đơ. Hệ thống sẽ bật hộp thoại hỏi "Bạn có chắc chắn muốn reload workspace không?" -> Chọn Yes để làm mới lại toàn bộ không gian làm việc.
Biên dịch file SPP (🛠 Compile Package SPP): Mở file .SPP ra, click chuột phải và chọn lệnh này để tự động compile package.
Mở nhanh tài nguyên: Từ Command Palette (Cocktail), bạn có thể gọi các lệnh như SMR, Open Prglink.xml, Open CentralConfig, Open LocalConfig để ngay lập tức mở các file thiết lập trung tâm mà không cần tự mò tìm trong folder máy tính.

Bạn hãy nhìn sang mép bên trái cùng của VS Code, sẽ thấy có một Icon hình ly Cocktail (🍸). Click vào đó, bạn sẽ thấy 3 cửa sổ nhỏ rất hữu ích:

Bookmarks (Pined): Quản lý tất cả các dòng code bạn đã đánh dấu bằng phím F9.
- Bấm vào một mục để tự động "nhảy" đến đúng dòng code đó.
- Để xóa ghim: Chọn mục đó và ấn phím Delete, hoặc click chuột phải chọn ❌.
- Để xóa toàn bộ ghim: Bấm icon ❌ ở góc phải trên cùng của cửa sổ Bookmarks.
Function List (VB Outline): Khi bạn đang mở một file code .vb, cửa sổ này sẽ liệt kê toàn bộ tên các hàm (Function/Sub) có trong file đó. Click vào tên hàm để đi tới hàm đó ngay lập tức. Cực kỳ tiện khi file có hàng nghìn dòng code!
Log: Nơi hiển thị các báo cáo lỗi hoặc lịch sử chạy tool của extension.

6. Làm việc với Code Snippet

Code Snippet là gì? Snippet là những đoạn code mẫu. Thay vì phải gõ lại một đoạn code dài ngoằng, bạn chỉ cần gõ vài chữ viết tắt và ấn phím Tab, VS Code sẽ tự động bung ra toàn bộ đoạn code đó cho bạn.

Dành cho code VB, SQL: Extension đã nhúng sẵn rất nhiều snippet chuẩn theo thư viện SC.
Dành cho file .ini (Thiết kế chi tiết): Extension có khả năng tự động tạo bảng thông tin table, item theo chuẩn thiết kế.
Cập nhật Snippet: Data của các table/item có thể thay đổi theo thời gian. Mở Command Palette, gõ Cocktail, chọn Update Snippet. Extension sẽ kết nối ngầm vào database của bạn và cập nhật lại bộ snippet mới nhất!

Deverloped by CoLC

Supper Cocktail

LA CHAN CO