Skip to main content

Lark Approval

info

Phần hướng dẫn tạo source data từ Lark Approval này sẽ bao gồm hai phần:

  1. Hướng dẫn thiết lập Source từ Lark Approval
  2. Hướng dẫn điền các trường thông tin khi setup Connection với Source là từ Lark Approval

Phần 1: Hướng dẫn thiết lập Source từ Lark Approval

note

Sau khi đã thao tác các bước nền là chọn source và vào được trang setup source chi tiết, bạn tiến hành thao tác điền các trường thông tin cần thiết như hướng dẫn dưới đây. Hướng dẫn các bước nền để tạo source trên Elton bạn có thể xem ở phần Getting Started - Mục Thiết lập Source.

(1) Tại giao diện setup data source của Lark Approval, bạn thao tác điền các thông tin định danh cho source chuẩn bị tạo:

  • Display name: Tên hiển thị của source. Elton khuyến khích bạn đặt tên có mối liên hệ với source Lark Approval mà bạn sắp sửa tạo.

  • Description: Mô tả của source nếu có

(2) Connection - APP Type:

  • Lựa chọn mặc định sẽ là Custom App. Đây là loại app của bạn tự tạo riêng trên Lark cho doanh nghiệp của mình và chỉ những thành viên trong workspace mới được vào app đó.

  • Bạn tiến hành điền App IDApp Secret trên Custom App của mình vào. Cách trích suất hai trường thông tin này, bạn có thể xem HDSD ở trong link này.

  • Lưu ý: Để Elton có thể kết nối được vào custom app của bạn, bạn cần thao tác làm thêm một bước đó là tiến hành add những guyền (permission) như trong file JSON được gắn dưới đây vào custom app của bạn (mục Permission & Scope -> Batch import/export scopes).

{
"scopes": {
"tenant": [
"approval:approval.list:readonly",
"approval:approval:readonly",
"approval:definition",
"approval:instance",
"bitable:app",
"bitable:app:readonly",
"sheets:spreadsheet:readonly"
],
"user": []
}
}

(3) Sau khi hoàn tất điền các thông tin của source, bạn nhấn Save => hệ thống sẽ đưa về trang thông tin chi tiết của source bạn vừa tạo.

Phần 2: Hướng dẫn điền các trường thông tin khi setup Connection với Source là từ Lark Approval

General info

1. Name: Tên của cài đặt connection bạn sắp tạo.

2. Description: Mô tả của cài đặt connection bạn sắp tạo

3. Sync Frequency: Chọn khoản thời gian định kỳ mà bạn muốn dữ liệu của connection sắp tạo được cập nhật. Ví dụ: Nếu bạn chọn option là Every 1 hour, thì cứ mỗi 1 tiếng hệ thống sẽ tự chạy và sync dữ liệu một lần.

Source config

Tại mục "Source Config" của màn hình setup chi tiết connection có source là Lark Sheets, các trường thông tin bạn cần điền sẽ có ý nghĩa như sau:

1. Approval item configuration

  • Bạn thao tác tìm và điền tên cũng như code của Approval Item mà bạn muốn tạo connection với. Bạn có thể thêm approval item nếu muốn.

2. First load - Load data since

  • Thể hiện mốc thời gian mà bạn mong muốn dữ liệu của bạn sẽ được tải lên từ lúc đó trở đi.

  • Ví dụ: Bạn chọn ngày load data là 15/10/2023 => Hệ thống sẽ sync toàn bộ dữ liệu của source FB Ads của bạn kể từ ngày 15/10/2023 đến hiện tại.

3. Incremental load - Date range to scan

  • Cách quét dữ liệu định kỳ của Elton đi theo hướng tịnh tiến (incremental) - có nghĩa là định kì hệ thống sẽ thực hiện quét dữ liệu cũ theo hướng tịnh tiến, theo một khoản thời gian được cài đặt trước, chứ không phải mỗi lần quét lại là sẽ quét lại toàn bộ dữ liệu phát sinh từ ngày đầu tiên.

  • Vì vậy, Incremental load - Date range to scan Là số ngày tính từ ngày chạy mà hệ thống sẽ scan trở về trước

  • Ví dụ: User chọn option là last 1 day thì hôm nay chạy sẽ tiến hành scan data kể từ ngày hôm qua. Nếu chọn last 7 days thì hôm nay sẽ dữ liêu của 7 ngày trước đó.

Add-on: Cách tính Billable Pipeline cho source

  • Khi sử dụng Elton, bạn sẽ được thông báo về cách mà hệ thống sẽ tính phí sử dụng dịch vụ. Cách tính hiện tại chủ yếu dựa trên số pipeline bạn tạo.

  • Tuỳ từng loại source mà cách tính số lượng pipeline giới hạn sẽ khác nhau. Để biết thêm chi tiết, bạn vui lòng tham khảo cách tính ở link ở đây.