Tích hợp với Google Drive¶
Yêu cầu
Để làm theo hướng dẫn này, bạn cần cài Phần mềm quản trị doanh nghiệp Viindoo
The Viindoo system integrates with Google Drive to make your management, storage, and sharing of documents more convenient and user-friendly.
Xác thực quyền truy cập với Google console¶
Bước 1: Bạn cần cấp quyền truy cập vào hệ thống Viindoo cho Google bằng cách truy cập Google console
Điều hướng tới biểu tượng 3 dấu chấm nằm tại phía trên bên trái của giao diện. Sau đó, bạn bấm nút NEW PROJECT để tạo một dự án mới. Bạn cung cấp tên cho dự án của bạn và bấm nút CREATE.
Một thông báo sẽ xuất hiện ở phía góc bên phải của màn hình trong Google Console. Bạn bấm nút SELECT PROJECT để truy cập vào dự án bạn đã tạo.
Điều hướng tới API & Services > API Library. Bạn nhập từ khóa drive vào trong thanh tìm kiếm. Sau đó, bạn lựa chọn Google Drive API từ các kết quả tìm được. Truy cập vào ứng dụng đó và bấm nút ENABLE.
Bấm nút CREATE CREDENTIALS, lựa chọn tính năng Application data và sau đó bấm nút DONE.
Bước 2: Cấu hình Consent Screen
Điều hướng tới Credentials > CREATE CREDENTIALS > OAuth client ID > CONFIGURE CONSENT SCREEN. Lựa chọn tính năng External và bấm nút CREATE.
Thiết lập thông tin OAuth consent screen. Bạn cần nhập các thông tin nhứ dưới đây:
App name: Nhập tên của ứng dụng.
User support email & Developer contact information: Nhập địa chỉ email hỗ trợ bởi tổ chức Google Console
Bấm nút SAVE AND CONTINUE và sau đó thêm các phạm vi cho dự án. Bạn nhập từ khóa drive và thêm tất cả các API liên quan tới từ khóa này như hiển thị dưới đây.
Bấm nút SAVE AND CONTINUE để hoàn tất quá trình.
Bước 3 Tạo OAuth client ID
Lựa chọn Web application trong trường thông tin Application type.
Nhập tên cho ứng dụng
Authorized JavaScript origins: Nhập tên miền hệ thống Viindoo của bạn. Ví dụ: https://documentation-17-duy.viindoo.cloud
Authorized redirect URIs: Nhập tên miền hệ thống Viindoo của bạn và thêm phần /google_drive/authentication. Ví dụ: https://documentation-17-duy.viindoo.cloud/google_drive/authentication.
Bấm nút CREATE
Sau đó, một cửa sổ nhỏ sẽ xuất hiện và hiện thị thông tin Client ID và Client Secret.
Bước 4: Công khai app tại giao diện OAuth consent
Bấm nút PUBLISH APP để công khai ứng dụng cho tới khi hiển thị ra nút PREPARE FOR VERIFICATION
Cấu hình¶
Đầu tiên, bạn cần kiểm tra trạng thái của ứng dụng để đảm bảo rằng ứng dụng của bạn đã được cài đặt trong phần mềm Viindoo. Bạn truy cập vào Ứng dụng, xóa bộ lọc mặc định và tìm kiếm từ khóa google. Nếu ứng dụng Google Drive chưa được cài đặt, bạn sẽ nhìn thấy nút Kích hoạt.
Sau đó, bạn truy cập Cài đặt > Tích hợp, kích hoạt tính năng Google Drive, nhập Client ID và Client Secret. Sau đó, bạn bấm nút Lưu. Sau khi thao tác như trên, bạn bấm nút Làm mới token để thiết lập một token cho hệ thống của bạn.
Sử dụng tính năng tích hợp Google Drive trong Viindoo¶
Sau khi kết nối thành công, hệ thống cung cấp tính năng liên kết với các tài liệu được lưu trữ trên drive của bạn với từng đối tượng trên hệ thống. Với tính năng này, nhà quản lý có thể đính kèm các mẫu tài liệu theo quy chuẩn của công ty trên nhiều giao diện của hệ thống giúp nhân viên thuận tiện trong quá trình tra cứu và sử dụng.
Nếu bạn thiết lập thành công, hệ thống sẽ hiển thị một trường thông tin Làm mới bộ mã thông báo. Sau đó, bạn truy cập vào Mẫu Goolge Drive để cấu hình các mẫu.
Tên mẫu: Đặt tên cho mẫu sử dụng.
Có hiệu lực: Khi bật thì mẫu sẽ có hiệu lực để sử dụng.
Mô hình: Đối tượng trong hệ thống cần liên kết tới mẫu này.
Bộ lọc: Bộ lọc tùy chỉnh cho mẫu.
URL mẫu: URL của tài liệu trên Google Drive cần liên kết đến. Lưu ý: bạn cần tạo tệp mẫu trên Google Drive trước để lấy đường dẫn URL.
Mẫu tên Google Drive: Thiết lập quy tắc tự động đặt tên cho tài liệu trên Google Drive, trong đó kết hợp chữ và trường thông tin.
Ghi chú
Trên Google Drive, bạn có thể tuỳ chọn loại định dạng cho tài liệu mẫu: tài liệu, bảng tính, trang trình bày, biểu mẫu, v.v.. Bạn cần đảm bảo đường dẫn URL của tài liệu mẫu liên kết với Google Drive phải chính xác.
Giải định rằng bạn tạo một mẫu cho model Liên hệ. Khi bạn truy cập vào bất kì liên hệ nào, bạn có thể sử dụng mẫu Google Drive đó như hiển thị dưới đây.
Thêm vào đó, các mẫu bạn đã tạo ra sẽ được lưu lại trong giao diện bạn tạo. Vì vậy, bạn có thể xem lại chúng bất cứ khi nào bạn muốn.
Bạn có thể làm tương tự cho các đối tượng khác trong hệ thống như: Liên hệ, CRM, Bán hàng, Mua hàng, v.v..