Cần hỗ trợ khi dùng HST Office? Tham gia nhóm Facebook

Hướng dẫn cho HST Office phiên bản 1.0.2

Các trang hướng dẫn

Khác

Dành cho nhà phát triển

HST Office chạy được macro Basic và Python, mã VBA thông dụng, và có thể được điều khiển tự động từ chương trình khác qua UNO hoặc chạy nền để chuyển đổi hàng loạt.

Lệnh trên thanh công cụ

Các lệnh cho nhà phát triển nằm ở thẻ Phần mở rộng, nhóm Nhà phát triển: Macro VBA, Chạy macro, Chỉnh sửa macro, Quản lý macro, Bảo mật macro, Chế độ thiết kế và các lệnh điều khiển biểu mẫu. Trong HST Sheets, nhóm này có thể hiện thành nút Nhà phát triển ▾.

Thẻ Phần mở rộng của HST Writer: nhóm Nhà phát triển có Macro VBA, Chạy macro, Ghi macro, Chỉnh sửa macro, Quản lý macro, Bảo mật macro, Chế độ thiết kế.
Nhóm Nhà phát triển trong HST Writer (đã bật ghi macro).

Macro Basic

  • Chỉnh sửa macro mở trình soạn Basic. Macro dùng chung cho mọi tài liệu nằm ở Macro và hộp thoại cá nhân → Standard; macro chỉ thuộc một tài liệu nằm dưới tên tài liệu đó.
  • Khung Đối tượng bên trái trình soạn có mục UNO APIs để tra cứu các dịch vụ, giao diện và hằng số của API.
  • Chạy macro: Chạy macro → chọn thư viện, mô-đun ở cột Thư viện → chọn macro ở cột Tên Macro → Chạy.
Sub ChenNgay
    Dim oText As Object
    oText = ThisComponent.getText()
    oText.insertString(oText.getEnd(), "Ngày lập: " & Format(Date, "dd/mm/yyyy"), False)
End Sub
Trình soạn HST Office Basic: macro ChenNgay trong Macro và hộp thoại cá nhân, Standard, Module1; khung Đối tượng có mục UNO APIs.
Trình soạn Basic.

Ghi macro

  1. Bật một lần: Tệp tin → Tùy chọn → HST Office → Nâng cao, chọn Bật ghi macro (có thể bị giới hạn), bấm OK. Nút Ghi macro xuất hiện trong nhóm Nhà phát triển.
  2. Bấm Ghi macro, thao tác trên tài liệu, rồi bấm Dừng thu trên thanh nhỏ vừa hiện.
  3. Gõ tên macro, chọn mô-đun (ví dụ Standard → Module1) và bấm Lưu.
Trang Nâng cao trong Tùy chọn, mục Tính năng tùy chọn: Bật các tính năng thử nghiệm và Bật ghi macro (có thể bị giới hạn).
Tùy chọn bật ghi macro.

Macro ghi được gọi các lệnh giao diện qua DispatchHelper. Không phải thao tác nào cũng ghi được; khi cần, sửa lại mã trong trình soạn.

Macro Python

Đặt tệp .py vào thư mục Scripts/python trong hồ sơ người dùng HST Office (thư mục user của hồ sơ). Mỗi hàm được liệt kê trong g_exportedScripts hiện trong Chạy macro → Macro của tôi → tên tệp. HST Office có sẵn trình thông dịch Python, không cần cài thêm.

# Scripts/python/xin_chao.py
def ChenLoiChao(*args):
    doc = XSCRIPTCONTEXT.getDocument()
    text = doc.getText()
    text.insertString(text.getEnd(), "Xin chào từ macro Python.", False)

g_exportedScripts = (ChenLoiChao,)
Hộp Bộ chọn macro: Macro của tôi gồm Standard và xin_chao; cột Tên Macro có ChenLoiChao; nút Chạy.
Chạy macro Python ChenLoiChao.

Mã VBA

HST Sheets và HST Writer chạy được phần lớn mã VBA thông dụng; một số đối tượng còn hạn chế. Trong HST Slides và HST PDF, chỉ phím tắt mở được trình soạn macro (Alt+F11) và hộp Macro (Alt+F8), không có mục Macro VBA trong menu HST; macro ở đây chỉ được giữ trong tệp .odp, .odg. Xem Macro VBA để biết cách mở trình soạn, bảng tương thích và cách lưu tệp giữ macro.

Bảo mật macro

Mức bảo mật đặt ở Tệp tin → Tùy chọn → HST Office → Bảo mật → Bảo mật Macro. Mặc định là Vừa: hỏi trước khi chạy macro từ nguồn chưa tin cậy. Thẻ Các nguồn tin cậy dùng để thêm thư mục hoặc chứng thư tin cậy.

Hộp thoại Bảo mật Macro, thẻ Cấp bảo mật: Rất cao, Cao, Vừa (đang chọn), Thấp (không khuyến khích).
Không nên chọn Thấp.
Lưu ý: Macro và mã VBA có thể đọc, sửa tệp và chạy chương trình trên máy. Chỉ bật macro trong tệp từ người gửi bạn tin cậy.

Chạy nền: chuyển đổi tệp hàng loạt

Lệnh soffice nằm trong thư mục program của thư mục cài đặt HST Office. Trên Linux có thể gọi bằng lệnh hst-office.

hst-office --headless --convert-to pdf --outdir ./pdf bao-cao.docx
hst-office --headless --convert-to odt *.docx

Khi HST Office đang mở trên máy, thêm tham số -env:UserInstallation= trỏ tới một thư mục hồ sơ riêng (viết dạng URL bắt đầu bằng file:) để lệnh chạy nền không lẫn với cửa sổ đang mở.

Điều khiển tự động qua UNO

  1. Khởi động HST Office ở chế độ lắng nghe:
    hst-office --headless --accept="socket,host=127.0.0.1,port=2002;urp;"
  2. Chạy chương trình Python bằng trình thông dịch đi kèm (program/python trong thư mục cài đặt) để có sẵn mô-đun uno:
    import uno
    from com.sun.star.beans import PropertyValue
    local = uno.getComponentContext()
    resolver = local.ServiceManager.createInstanceWithContext(
        "com.sun.star.bridge.UnoUrlResolver", local)
    ctx = resolver.resolve(
        "uno:socket,host=127.0.0.1,port=2002;urp;StarOffice.ComponentContext")
    desktop = ctx.ServiceManager.createInstanceWithContext(
        "com.sun.star.frame.Desktop", ctx)
    hidden = PropertyValue()
    hidden.Name, hidden.Value = "Hidden", True
    doc = desktop.loadComponentFromURL("private:factory/swriter", "_blank", 0, (hidden,))
    doc.Text.setString("Văn bản tạo tự động qua UNO.")
    pdf = PropertyValue()
    pdf.Name, pdf.Value = "FilterName", "writer_pdf_Export"
    doc.storeToURL(uno.systemPathToFileUrl("/tmp/tu-dong.pdf"), (pdf,))
    doc.close(True)
    desktop.terminate()
Chỉ nghe trên máy mình: giữ host=127.0.0.1. Cổng UNO không có mật khẩu; mở cho máy khác là cho phép người khác điều khiển HST Office trên máy bạn.

Tài liệu API

HST Office dùng API UNO của lõi bộ văn phòng mã nguồn mở phiên bản 26.8. Trong máy, tra cứu nhanh ở mục UNO APIs của trình soạn Basic. Tài liệu tham khảo đầy đủ (SDK, IDL) của phiên bản lõi 26.8 dùng được cho HST Office; các dịch vụ riêng của HST không thuộc API công khai.