Phát triển cục bộ

Mặc dù bạn có thể hoàn thành tất cả các tác vụ liên quan đến trình kết nối bằng môi trường Apps Script trực tuyến, nhưng một số tác vụ có thể trở nên lặp đi lặp lại và dễ xảy ra lỗi theo thời gian.

dscc-gen là một công cụ có ý kiến riêng nhằm giải quyết những tác vụ lặp đi lặp lại này để bạn có thể tập trung vào việc giải quyết vấn đề kinh doanh thay vì các lỗi có thể tránh được thông qua tự động hoá.

Yêu cầu

Sử dụng dscc-gen

dscc-gen có thể tạo dự án trình kết nối cộng đồng mới hoặc được dùng với các dự án hiện có.

Trình kết nối hiện có

Bạn cũng có thể dùng dscc-gen với các dự án hiện có. Trước tiên, hãy sao chép scriptId, sau đó chạy lệnh sau (thay thế YOUR_SCRIPT_ID bằng scriptId của bạn):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Bạn sẽ được nhắc cung cấp một số thông tin chi tiết cho giắc cắm. Nếu bạn chưa có một bản triển khai nào có tên là "Production", thì một bản triển khai sẽ được tạo cho bạn. Không có đoạn mã hiện có nào của bạn bị sửa đổi, nhưng bạn sẽ có quyền truy cập vào mọi thứ mà dscc-gen có thể làm.

Đầu nối mới

Để tạo một trình kết nối cộng đồng mới bằng dscc-gen, hãy chạy lệnh sau:

npx @google/dscc-gen connector

Bạn sẽ được nhắc cung cấp một số thông tin chi tiết cho trình kết nối mới. Người dùng lần đầu tiên sẽ được yêu cầu xác thực clasp. clasp là một công cụ để tạo và sửa đổi các dự án Apps Script từ dòng lệnh.

Sau khi bạn hoàn tất các lời nhắc, dscc-gen sẽ tạo một dự án Apps Script mới và in ra mọi thứ mà dự án này có thể làm.

dscc-gen có thể làm những gì?

Lệnh Mô tả
npm run open Mở dự án của bạn trong Apps Script.
npm run push Đẩy các thay đổi cục bộ lên Apps Script.
npm run watch Theo dõi các thay đổi cục bộ và chuyển các thay đổi đó sang Apps Script.
npm run prettier Định dạng mã theo tiêu chuẩn cộng đồng.
npm run try_latest Mở bản triển khai bằng mã mới nhất trong Data Studio.
npm run try_production Mở chế độ triển khai Sản xuất trong Data Studio.
npm run update_production Cập nhật quá trình triển khai phát hành công khai để sử dụng mã mới nhất.

Tôi nên sử dụng tính năng này như thế nào?

Khi sử dụng dscc-gen, bạn thường làm như sau:

  1. Xác định một tính năng mà bạn muốn thêm vào trình kết nối.
  2. Chạy npm run watch để các thay đổi cục bộ sẽ được chuyển đến Apps Script.
  3. Thực hiện các thay đổi về mã bằng trình JavaScript JavaScript yêu thích.
  4. Chạy npm run tryLatest và kiểm tra để đảm bảo tính năng mới hoạt động như mong đợi.
  5. Chạy npm run updateProduction để cập nhật việc triển khai sản xuất nhằm có tính năng mới.
  6. Chạy npm run tryProduction và kiểm tra kỹ để đảm bảo tính năng mới hoạt động.

Lấy mã tập lệnh

Để lấy scriptId, hãy chuyển đến dự án hiện có của bạn, sau đó sao chép phần URL sau /d/ và trước /edit. Ví dụ: URL sau:

  • URL gốc: https://script.google.com/a/google.com/d/example-script-id/edit
  • Mã tập lệnh: example-script-id