Chia quy trình Broma trong đội nhóm: Kho chung và kiểm soát phiên bản
Tại sao cần tập trung hóa quy trình
- Nhất quán – mọi thành viên cùng làm việc từ cùng một nền tảng, giảm lỗi do bước cũ hoặc phân nhánh.
- Hợp tác – thành viên có thể đánh giá, bình luận và cải tiến workflow của nhau mà không ghi đề.
- Kiểm tra được – lưu trữ tập trung giúp dễ dàng ai đã thay đổi, khi nào và vì sao.
- Sao lưu và phục hồi – một kho lưu trữ acting như sao lưu; có thể quay lại phiên bản trước khi workflow bị lỗi.
- Chia sẻ kiến thức – nhân viên mới có thể nhập workflow đã được kiểm chứng thay vì xây dựng từ đầu.
Thiết lập cấu trúc thư mục chung
- Chọn vị trí chung – sử dụng mạng LAN (\TeamShare\Broma), thư mục cloud (Google Drive, OneDrive) hoặc NAS. Đảm bảo tất cả thành viên có quyền ghi.
- Tạo thư mục cha –
BromaWorkflows/chứa tất cả dự án. - Thư mục con theo dự án –
BromaWorkflows/PriceMonitoring/,BromaWorkflows/SupplierData/, v.v. - Thư mục môi trường – trong mỗi dự án, giữ
dev/,staging/,prod/để cô lập cấu hình khác nhau. - Tập metadata – thêm
README.mdhoặcproject.jsonmô tả mục đích, tác giả, lần cập nhật cuối, ghi chú sử dụng.
Cấu trúc mẫu:
BromaWorkflows/ PriceMonitoring/ dev/ price_check_2023_v1.json staging/ price_check_2023_v2.json prod/ price_check_2023_v3.json shared/ template.json docs/ README.md SupplierData/ ...
Sử dụng hồ sơ trình duyệt cho từng môi trường
Workflow thường phụ thuộc vào cookie, đăng nhập hoặc proxy khác nhau giữa các môi trường. Hệ thống profile của Broma giúp tách biệt rõ ràng:
- Tạo profile – trong Settings → Profiles → New. Đặt tên
prod_login,dev_marketer, v.v. - Gán profile vào workflow qua trường Profile trong Workflow Settings.
- Lưu file profile cùng workflow JSON. Ví dụ:
BromaWorkflows/PriceMonitoring/prod/profile_prod.json.
Vì profile là file riêng, bạn có thể version control nó như bất kỳ artifact nào khác, đảm bảo workflow prod luôn dùng đúng trạng thái xác thực.
Xuất và nhập quy trình
Broma cung cấp cơ chế xuất/nhập đơn giản:
- Xuất – trong Workflow Editor, chọn File → Export. Chọn
Save as JSON. File sẽ được lưu vào thư mục hiện tại (có thể thay đổi trong Settings). - Nhập – chọn File → Import, browse đến file JSON chung, Broma sẽ recreate workflow, giữ nguyên steps, selectors, variables.
Mẹo: Sau khi nhập, luôn chạy Validate (trong Tools) để kiểm tra selectors còn đúng.
Lập lịch và ghi log
Builtin scheduler cho phép queue workflow tự động theo khoảng thời gian (hàng giờ, hàng ngày, cron). Cho đội nhóm:
- Tạo schedule – Broma → Scheduler → New Schedule.
- Gán workflow và chọn environment profile (dev/staging/prod).
- Bật run logs – Broma ghi mỗi lần chạy: thời gian bắt đầu, trạng thái, lỗi (nếu có) vào file log cùng thư mục với workflow JSON (ví dụ
price_check_2023_v3.json.log).
Có thể enable email alerts để thông báo khi lỗi, đảm bảo người phụ trách được thông báo mà không cần kiểm tra thủ công.
Kiểm soát phiên bản với Git
Mặc dù hệ thống file đã có dạng versioning, thêm Git mang lại diff, branching, pull request.
Khởi tạo repo –
git init BromaWorkflows.Tạo .gitignore – loại bỏ file tạm, log, dữ liệu nhạy cảm. Ví dụ:
*.log *.tmp secrets/
Stage workflow files –
git add BromaWorkflows/PriceMonitoring/prod/*.json.Commit –
git commit -m "Update price check v3 for new UI selectors".Tạo branch –
git checkout -b feature/price_alert_2024.Push và mở pull request – để reviewers duyệt trước khi merge.
Ví dụ terminal:
bash
Clone repo
cd /home/dev git clone https://teamshare.com/BromaWorkflows.git
Tạo branch mới
git checkout -b fix/price_scrape_2024
Chỉnh sửa workflow (VS Code)
code BromaWorkflows/PriceMonitoring/prod/price_check_2023_v3.json
Stage và commit
git add BromaWorkflows/PriceMonitoring/prod/price_check_2023_v3.json git commit -m "Fix selector for new price element"
Push branch
git push origin fix/price_scrape_2024
Mở pull request trên web UI
Best Practices cho đội nhóm
- Luôn kiểm tra
git statustrước khi thay đổi. - Dùng commit messages mô tả, tham chiếu ticket.
- Tag releases (ví dụ
v1.2.0) khi một bộ workflow sẵn sàng cho production. - Giữ workflow JSON nhỏ – tách complex workflows thành sub-flows reusable.
- Document assumptions trong
README.mdmỗi dự án (ví dụ "Flow expects page in English locale"). - Test imported workflows trong sandbox trước khi push main.
- Rotate profiles định kỳ; lưu credentials ngoài repo (Windows Credential Manager) và reference qua environment variables.
Troubleshooting shared workflow issues
| Symptom | Likely Cause | Quick Fix |
|---|---|---|
| Workflow fails after import with “Selector not found” | Selector outdated or page HTML changed | Mở workflow, cập nhật selector bằng Broma’s “Inspect” tool, re‑export. |
| Scheduler stops running silently | Log file size exceeded or permission error on shared drive | Dọn old logs, verify write permissions, re‑enable schedule. |
| Git merge conflicts on same workflow | Two teammates edited simultaneously | Resolve manually, keep version addressing latest UI change. |
| Profile not loading credentials | Profile file corrupted or wrong folder | Re‑create profile in Broma, re‑assign, re‑export. |
Nếu vẫn lỗi, kiểm tra Broma console output và so sánh workflow JSON với Git diff.
Kết luận
Chia sẻ workflow Broma trong đội nhóm không cần phải hỗn loạn. Bằng cách thiết lập cấu trúc thư mục rõ ràng, tận dụng profile system, và tích hợp Git version control, bạn tạo ra một quy trình automation lặp lại, kiểm tra được, và hợp tác. Kết hợp với scheduled runs và logging đầy đủ, đội nhóm có thể duy trì một bộ browser automations tin cậy, phát triển an toàn cùng với nhu cầu kinh doanh. Thực hiện các bước trên, điều chỉnh cấu trúc thư mục cho phù hợp với tổ chức, và bạn sẽ thấy workflow reuse trở thành lợi thế cạnh tranh thay vì gánh nặng logistics.
