Phát triển địa phương

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

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

Yêu cầu

Sử dụng dscc-gen

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

Cá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 YOUR_SCRIPT_ID bằng scriptId.):

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 trình kết nối của mình. Nếu bạn chưa có quá trình triển khai có tên là "Sản xuất", thì một chương trình triển khai sẽ được tạo cho bạn. Các mã hiện tại của bạn sẽ không bị sửa đổi, nhưng bạn sẽ có quyền truy cập vào mọi việc dscc-gen có thể làm.

Trình kết nối mới

Để tạo 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 vài thông tin chi tiết cho trình kết nối mới của mình. Những người dùng lần đầu sẽ được yêu cầu xác thực clasp. clasp là công cụ dùng để tạo và sửa đổi các dự án Apps Script từ dòng lệnh.

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

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

Lệnh Nội dung mô tả
npm run open Mở dự án của bạn trong Apps Script.
npm run push Chuyển các thay đổi cục bộ vào Apps Script.
npm run watch Theo dõi các thay đổi cục bộ và đẩy chúng vào Apps Script.
npm run prettier Định dạng mã theo tiêu chuẩn cộng đồng.
npm run try_latest Mở quá trình triển khai bằng mã mới nhất trong Looker Studio.
npm run try_production Mở Triển khai phiên bản chính thức trong Looker Studio.
npm run update_production Hãy cập nhật quá trình triển khai chính thức để sử dụng mã mới nhất của bạn.

Tôi nên sử dụng sản phẩm này như thế nào?

Việc sử dụng dscc-gen thường giống như sau:

  1. Xác định tính năng 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 đẩy sang Apps Script.
  3. Thay đổi mã bằng cách sử dụng trình chỉnh sửa JavaScript yêu thích.
  4. Chạy npm run tryLatest và kiểm tra để đảm bảo tính năng mới của bạn đang hoạt động như mong đợi.
  5. Hãy chạy npm run updateProduction để cập nhật quá trình triển khai chính thức và 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.

Nhận mã tập lệnh của bạn

Để có được scriptId, hãy chuyển đến dự án hiện tại, rồi 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