- ỨNG DỤNG
- Viin Giao diện Cohort 19.0
| Số dòng Code | 1399 |
| Tên kỹ thuật | viin_web_cohort |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/viin_web_cohort?force_show=1 |
| Đọc mô tả cho | v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Các mở rộng | Cohort View Test |
Nhìn rõ ai ở lại - theo từng nhóm khách
Biến bất kỳ mô hình Odoo nào có ngày bắt đầu và ngày kết thúc thành một phân tích giữ chân và rời bỏ. Chỉ cần khai báo một view, không cần lập trình thêm, không phải xuất ra bảng tính.
Các màn hình trong ảnh chụp thuộc module ví dụ đi kèm dùng để minh họa view này - bản thân viin_web_cohort không đi kèm menu, action hay mô hình nghiệp vụ nào.
Tính năng chính
Chạy trên bất kỳ mô hình nào bạn đang có
Chỉ cần trỏ vào một trường ngày bắt đầu và một trường ngày kết thúc trên bất kỳ loại bản ghi nào, bảng phân tích giữ chân hoặc rời bỏ theo 16 kỳ tự dựng - không cần thiết kế báo cáo riêng, không phải xuất ra bảng tính.
Một lần khai báo view, dùng ở mọi nơi
Chỉ cần thêm một view cohort vào action của bất kỳ màn hình nào. Odoo kiểm tra khai báo ngay khi lưu view, nên một thiết lập thiếu hoặc gõ sai được phát hiện ngay lập tức - không phải để người dùng phát hiện sau.
Gắn được vào bất kỳ window action nào
Liệt kê bảng cohort cùng với các view danh sách, form, kanban mà người dùng của bạn đã quen dùng, để phân tích giữ chân nằm ngay cạnh dữ liệu mà nó lý giải.
Bảng tương tác, không phải báo cáo tĩnh
Chuyển đổi ngay trên màn hình giữa các thước đo, chu kỳ thời gian và cách đọc (giữ chân hay rời bỏ), di chuột vào một ô để xem con số chính xác, và bấm vào để xem các bản ghi đứng sau bất kỳ tỷ lệ nào.
Xuất dữ liệu chỉ với một cú bấm
Gửi đúng bảng đang hiển thị trên màn hình - gồm cả tỷ lệ phần trăm và dòng trung bình - ra một file bảng tính đã định dạng sẵn, dùng cho báo cáo hội đồng quản trị hay bản cập nhật gửi nhà đầu tư.
Chạy trên chính mô hình bạn đang có
Phân tích cohort ở đây không phải một ứng dụng mới phải nhập liệu lại - nó là một loại view. Chỉ cần trỏ vào một trường ngày bắt đầu và một trường ngày kết thúc trên bất kỳ mô hình nào, bảng phân tích tự dựng từ dữ liệu bạn vốn đã lưu. Ứng dụng này không mang theo mô hình nghiệp vụ, menu hay action nào của riêng nó.
Giữ chân hay rời bỏ, theo đúng chu kỳ của doanh nghiệp bạn
Cùng một dữ liệu, đọc theo hướng giữ chân hoặc rời bỏ - hai cách đọc bù nhau. Nhóm theo ngày, tuần, tháng hay năm và chuyển qua lại ngay trên màn hình, không cần rời báo cáo hay sửa view.
Mọi con số đều tra ngược được
Bấm vào một ô, báo cáo mở ra đúng những bản ghi đứng sau con số đó, và vẫn giữ nguyên bộ lọc tìm kiếm bạn đang áp dụng. Một con số mở ra được là một con số bảo vệ được trước cuộc họp.
Đo đúng thứ cần đo
Cohort không nhất thiết là đếm đầu người. Bạn có thể đo số bản ghi, số lượng phân biệt của một bản ghi liên kết (chẳng hạn số khách hàng), hoặc tổng hợp bất kỳ trường số nào - doanh thu, số lượng, số giờ - theo đúng cách tổng hợp của chính trường đó. Bộ chọn Measures chuyển đổi ngay tại chỗ.
Mang cả bảng đi cùng
Xuất bảng cohort, gồm cả dòng trung bình, ra xlsx chỉ với một cú bấm - cho bộ tài liệu họp hội đồng, bản cập nhật gửi nhà đầu tư, hay một đồng nghiệp quen làm việc trên bảng tính.
Khai báo là chạy, không phải cấu hình
Thêm viin_cohort vào view_mode của một action rồi khai báo
phần tử <viin_cohort> với string, start_date
và stop_date. Tùy chọn thêm mode, timeline,
interval và measure. Hợp đồng của arch được cưỡng chế ngay
khi lưu view: thiếu một thuộc tính bắt buộc, thừa một thuộc tính không thuộc danh sách,
hoặc đặt giá trị không hợp lệ cho mode, timeline,
interval đều bị từ chối kèm thông báo chỉ rõ chỗ sai - nên một lỗi gõ
nhầm không thể âm thầm cho ra kết quả phân tích sai.
- Phiên bản Odoo: 19.0 — Ấn bản hỗ trợ: Odoo Community Edition, Viindoo
- Phụ thuộc: chỉ module
web - Giấy phép: OPL-1
Câu hỏi thường gặp
Tôi dùng được trên những mô hình nào?
Bất kỳ mô hình nào có một trường ngày bắt đầu và một trường ngày kết thúc. Loại view này được thêm vào chính nền tảng, nên nó có mặt ở mọi nơi - bạn quyết định khai báo nó ở đâu.
Cài xong tôi có sẵn một màn hình cohort chưa?
Chưa, và đó là chủ đích. Ứng dụng này đóng góp loại view; bạn khai báo nơi áp dụng. Một ứng dụng kiểm thử riêng có sẵn ví dụ hoàn chỉnh để bạn đọc tham khảo.
Chế độ retention và churn khác nhau thế nào?
Là hai cách đọc cùng một dữ liệu và bù nhau đủ 100%. Retention cho biết tỷ lệ của nhóm còn hoạt động ở mỗi kỳ; churn cho biết tỷ lệ đã rời đi.
Tôi xem được các bản ghi đứng sau một tỷ lệ không?
Được. Mỗi ô mở ra đúng những bản ghi mà nó đã đếm, và phần mở ra vẫn tôn trọng bộ lọc tìm kiếm bạn đang áp dụng cho báo cáo.
Nếu tôi gõ sai một thuộc tính trong view thì sao?
View bị từ chối ngay khi lưu, kèm thông báo nêu rõ thuộc tính, giá trị bạn đã nhập và những giá trị được chấp nhận. Ba thuộc tính bắt buộc cũng được kiểm tra theo cách đó.
Đừng đoán xem mức giữ chân có đang cải thiện hay không
Thêm một view cohort vào mô hình bạn quan tâm và đọc câu trả lời ngay trên bảng.
Dùng thử trên bản demoViin Giao diện Cohort
viin_web_cohort không thêm menu, nút bấm hay màn hình nghiệp vụ nào của riêng nó. Module này bổ sung một kiểu màn hình backend mới có tên Cohort (tên kỹ thuật viin_cohort), được các module khác dùng để hiển thị bảng giữ chân (retention) hoặc rời bỏ (churn) trên một model của chính module đó. Tài liệu này dành cho người cấu hình hoặc mở rộng module Odoo - chuyên viên nghiệp vụ hoặc kỹ sư triển khai Odoo - muốn thêm một màn hình Cohort vào một model, hiểu từng điều khiển trên màn hình đó dùng để làm gì, và đọc đúng bảng kết quả.
Nếu bạn đang tìm một màn hình Cohort cụ thể (phân tích Cơ hội kinh doanh, báo cáo rời bỏ thuê bao, v.v.), màn hình đó thuộc về ứng dụng cung cấp nó, không thuộc module này. Sau khi ứng dụng đó được cài đặt, hãy mở menu riêng của ứng dụng để tìm màn hình.
Cài đặt
viin_web_cohort chỉ phụ thuộc vào module Web cơ bản, vốn đã có sẵn trong mọi cơ sở dữ liệu Odoo. Trên thực tế, bạn không bao giờ cài đặt riêng viin_web_cohort:
- Module bị ẩn khỏi danh sách Ứng dụng (Apps).
- Module được cài đặt tự động ngay khi bạn cài một ứng dụng có sẵn màn hình Cohort - ví dụ ứng dụng CRM với phân tích Cơ hội kinh doanh, hoặc các báo cáo trong ứng dụng Bán hàng, Kho, và Thuê bao.
Để xác nhận module đã được cài đặt, bật chế độ nhà phát triển, mở Cài đặt ‣ Kỹ thuật ‣ Ứng dụng ‣ Modules, rồi tìm viin_web_cohort.
Cấu hình
Việc thêm một màn hình Cohort vào một model do kỹ sư triển khai thực hiện bằng cách chỉnh sửa view của model đó, không phải do người dùng cuối thao tác trên giao diện. Phần này mô tả các quy tắc mà view đó phải tuân theo.
Phần tử view Cohort
Một màn hình Cohort được khai báo dưới dạng view có nội dung là một phần tử <viin_cohort> duy nhất - phần tử này không bao giờ chứa phần tử con. Ví dụ dưới đây, lấy từ chính dữ liệu kiểm thử của module, thêm một màn hình Cohort vào một model đơn hàng bán mẫu:
<record id="sale_order_test_view_viin_cohort" model="ir.ui.view"> <field name="name">sale.order.test.view.viin.cohort</field> <field name="model">sale.order.test</field> <field name="arch" type="xml"> <viin_cohort string="Sale Order Test Cohort Analysis" start_date="date_start" stop_date="date_end" interval="month" mode="retention" measure="partner_id"/> </field> </record>
Việc lưu view sẽ báo lỗi ngay nếu thiếu một thuộc tính bắt buộc, nếu dùng một thuộc tính không nằm trong danh sách cho phép, hoặc nếu mode, timeline, hay interval mang giá trị nằm ngoài các tập giá trị liệt kê bên dưới.
Thuộc tính bắt buộc:
- string - tiêu đề hiển thị phía trên bảng.
- start_date - trường ngày dùng để xếp một bản ghi vào hàng của kỳ bắt đầu (ví dụ ngày tạo đơn hàng hoặc ngày tạo cơ hội).
- stop_date - trường ngày đánh dấu thời điểm bản ghi rời khỏi nhóm cohort (ví dụ ngày đóng đơn hoặc ngày mất cơ hội).
Thuộc tính tùy chọn - có thể bỏ trống, và mỗi thuộc tính đều có giá trị mặc định được ghi rõ. Thứ bị từ chối là giá trị nằm ngoài tập cho phép, không phải việc thiếu thuộc tính:
- mode (mặc định retention) - retention hiển thị tỷ lệ còn lại của nhóm ban đầu ở mỗi kỳ sau; churn hiển thị ngược lại, tỷ lệ đã rời khỏi nhóm.
- timeline (mặc định forward) - forward đọc các kỳ tính từ kỳ bắt đầu trở về sau; backward đọc ngược lại, tính lùi về đến hiện tại.
- interval (mặc định month) - độ rộng của mỗi kỳ: day (ngày), week (tuần), month (tháng), hoặc year (năm).
- measure - giá trị được đếm hoặc tổng hợp trong mỗi ô. Bỏ trống để đếm số bản ghi thông thường. Có thể đặt thành bất kỳ trường có thể tổng hợp nào trên model (dùng lại phép tổng hợp riêng của trường đó - tổng, trung bình, v.v.); nếu trỏ đến một trường quan hệ (đối tác, người phụ trách), ô sẽ đếm số bản ghi liên quan khác nhau. Khác với ba thuộc tính trên, measure là tên một trường chứ không phải một tập giá trị đóng.
Thêm view vào một hành động menu
Sau khi đã có view, liệt kê viin_cohort trong các kiểu view của hành động cửa sổ mở nó, cùng với list và form như thường lệ:
<record id="sale_order_test_action" model="ir.actions.act_window"> <field name="name">Sale Order Test Cohort Analysis</field> <field name="res_model">sale.order.test</field> <field name="view_mode">viin_cohort,list,form</field> </record>
Sử dụng
Các ảnh chụp màn hình bên dưới được lấy từ chính màn hình demo của module test_viin_web_cohort (Cohort Test ‣ Sale Order Test Cohort Analysis, mở từ menu trang chủ), chỉ dùng để minh họa hình dạng một màn hình Cohort sau khi có module khai báo nó. Cài riêng viin_web_cohort sẽ không thêm menu này. Do giao diện chụp minh họa đang ở tiếng Anh, tên nút và tiêu đề cột trên ảnh vẫn giữ nguyên tiếng Anh; phần mô tả bên dưới mỗi ảnh dịch ý nghĩa sang tiếng Việt.
Đọc bảng dữ liệu
Mỗi hàng là một kỳ bắt đầu (nhóm theo trường start_date, theo độ rộng kỳ hiện tại). Hai cột đầu hiển thị kỳ đó và tổng giá trị đo lường của kỳ đó. Mỗi cột tiếp theo là một mốc lệch so với kỳ bắt đầu (+0, +1, +2, v.v.) và hiển thị tỷ lệ phần trăm của tổng ban đầu vẫn còn được giữ lại - hoặc, ở chế độ churn, tỷ lệ đã rời đi - tính đến kỳ đó. Mỗi ô được tô màu nhấn với độ mờ tương ứng với phần trăm của nó, vì vậy ô càng đậm màu thì phần trăm càng cao. Hàng Average (Trung bình) ở cuối lấy trung bình từng cột trên toàn bộ các hàng phía trên.
Chọn giá trị đo lường
Nhấn Measures (Đo lường) để chọn giá trị mỗi ô sẽ đếm. Danh sách luôn có Count (đếm số bản ghi thông thường) cùng với mọi trường có thể tổng hợp hoặc trường quan hệ mà thuộc tính measure của view có thể trỏ tới trên model đó.
Đổi khoảng thời gian
Các nút Day (Ngày), Week (Tuần), Month (Tháng), Year (Năm) nhóm lại cả hàng và cột theo độ rộng kỳ tương ứng. Lựa chọn này được ghi nhớ khi bạn rời khỏi rồi quay lại màn hình.
Xem chi tiết một ô
Nhấn vào bất kỳ ô phần trăm nào, hoặc vào nhãn kỳ bắt đầu của một hàng, để mở danh sách các bản ghi tương ứng với hàng và cột đó; từ danh sách này bạn có thể mở từng bản ghi riêng lẻ.
Xuất ra Excel
Nhấn nút tải xuống bên cạnh bộ chọn khoảng thời gian để tải bảng đúng như đang hiển thị (mọi hàng, mọi phần trăm, và hàng Average) dưới dạng tệp .xls được đặt tên theo tiêu đề của màn hình.
Xử lý sự cố
"<viin_cohort> requires the '...' attribute" - view đang thiếu một trong ba thuộc tính string, start_date, hoặc stop_date. Thêm thuộc tính còn thiếu rồi lưu lại view.
"Invalid attributes (...) in viin_cohort view" - view đang dùng một thuộc tính mà phần tử này không chấp nhận, thường do gõ sai tên. Chỉ string, start_date, stop_date, mode, timeline, interval, và measure được phép dùng.
"Invalid mode/interval/timeline (...) ..." - màn hình được tải với mode, timeline, hoặc interval để trống hoặc mang giá trị nằm ngoài tập giá trị cho phép - phần lớn do view bỏ sót hẳn thuộc tính đó. Hãy đặt thuộc tính này thành một trong các giá trị đã liệt kê ở mục Cấu hình phía trên.
Màn hình hiển thị "No data available" (Không có dữ liệu) - hoặc không có bản ghi nào khớp bộ lọc hiện tại, hoặc giá trị đo lường đang chọn không có gì để tổng hợp trên các bản ghi đó. Hãy bỏ bộ lọc hoặc chọn giá trị đo lường khác.
Một ô hiển thị dấu gạch ngang thay vì phần trăm - kỳ đó vẫn còn ở tương lai so với hiện tại, nên chưa có gì để báo cáo.
Câu hỏi thường gặp
Có thể thêm màn hình Cohort vào bất kỳ model nào không? Có, miễn là model có hai trường ngày có thể dùng làm ngày bắt đầu và ngày kết thúc.
Người dùng cuối có thể tự cấu hình màn hình Cohort trên giao diện không? Không. Các trường được dùng và các giá trị được phép đều cố định trong định nghĩa của view; người dùng cuối chỉ chọn giá trị đo lường và khoảng thời gian khi đang xem màn hình.
Vì sao ứng dụng của tôi không có màn hình Cohort dù đã cài ``viin_web_cohort``? Vì viin_web_cohort chỉ cung cấp kiểu màn hình. Một ứng dụng cụ thể phải tự khai báo view <viin_cohort> của riêng nó và thêm view đó vào một trong các hành động menu của mình thì màn hình Cohort mới xuất hiện.
Tệp xuất ra có bao gồm các bản ghi chi tiết khi xem một ô không? Không. Tệp .xls xuất ra phản ánh đúng những gì đang hiển thị trên màn hình - các hàng cohort, các phần trăm, và hàng Average - không bao gồm từng bản ghi riêng lẻ đứng sau một ô.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.