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 ứng dụng trực tuyến trong môi trường tập lệnh, một số tập lệnh có thể lặp lại và dễ gặp lỗi bất cứ lúc nào.

dscc-gen là một công cụ cố định nhằm giải quyết những nội dung lặp lại công việc để bạn có thể tập trung vào giải quyết vấn đề của doanh nghiệp thay vì lỗi có thể tránh thông qua quy trình 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 được sử dụng với các quảng cáo hiện có.

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

Bạn cũng có thể sử dụng dscc-gen với các dự án hiện có. Đầu tiên, 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 về trình kết nối. Nếu bạn chưa thì hệ thống sẽ tạo một quy trình triển khai có tên là "Phát hành công khai". Không có mã hiện có sẽ được sửa đổi, nhưng bạn sẽ có quyền truy cập vào mọi việc mà 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 số thông tin cho trình kết nối mới. Người dùng lần đầu sẽ được yêu cầu xác thực clasp. clasp là một công cụ để tạo & sửa đổi 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 ra mọi việc nó 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 trên máy vào Apps Script.
npm run watch Chú ý những thay đổi cục bộ và đẩy chúng vào Ứng dụng Tập lệnh.
npm run prettier Định dạng mã theo tiêu chuẩn cộng đồng.
npm run try_latest Mở phiên triển khai bằng mã mới nhất của bạn trong Looker Studio.
npm run try_production Mở phiên bản triển khai chính thức trong Looker Studio.
npm run update_production Cập nhật việc triển khai sản xuất để sử dụng mã mới nhất.

Tôi nên dùng công cụ này như thế nào?

Việc sử dụng dscc-gen thường có dạ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 yêu thích Trình chỉnh sửa JavaScript.
  4. Chạy npm run tryLatest và kiểm tra để đảm bảo tính năng mới đang hoạt động như dự kiến.
  5. Chạy npm run updateProduction để cập nhật quá trình triển khai phát hành công khai nhằm tính năng mới của mình.
  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 của bạn

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

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