Tài liệu phát triển CoE CLI (Đã lỗi thời)

Lưu ý

CLI CoE đã lỗi thời và sẽ bị xóa trong bản phát hành trong tương lai. Sử dụng Power Platform Trình hướng dẫn thiết lập dự án để thiết lập và quản lý ALM Accelerator for Power Platform dự án của bạn.

Hướng dẫn sử dụng là chìa khóa để hiểu cách thức hoạt động của CLI. Khi bạn thêm các lệnh mới, hãy xem những hướng dẫn sử dụng sau:

• Thêm trang Markdown
• Ghi lại dòng lệnh

Thêm trang Markdown

Thêm các trang mới vào trợ giúp để mô tả lệnh mới và giải thích cho người dùng cách sử dụng dự kiến.

Cân nhắc việc thêm những phần sau vào trang này:

1. Hình ảnh tĩnh tóm tắt hoạt động.
2. Ghi lại dòng lệnh để minh họa quy trình.

Sơ đồ

Đối với cây quyết định, sơ đồ được tạo thông qua Mermaid.

Sơ đồ ví dụ:

• Sự trưởng thành
• Cây quyết định AA4PP

Kiểu sơ đồ

Để định dạng sơ đồ sample.mmd:

1. Sử dụng kiểu nhóm phụ.

   graph
       subgraph journey[Journey]
         start(Start) --> finish(Finish Here)
       end
   
       style journey fill:transparent,stroke:green,stroke-width:2px
   

2. Áp dụng kiểu CSS cho một tệp trong cùng một thư mục. Ví dụ, tạo sample.css trong cùng thư mục với tệp .mmd.

   #L-start-finish path {
      stroke: red
   }
   

Ghi chú

1. Xem hình dạng nút để kiểm soát các biểu tượng hiển thị.

2. Tạo kiểu hình tròn bằng cách sử dụng phương pháp sau.

   graph TD
      subgraph Journey
         start(Start Here) ---> finish((End Here))
      end
   

   Để tô màu xanh lá cây cho hình tròn cuối, hãy sử dụng CSS thuộc tính^=bộ chọn giá trị. Bộ chọn này là bắt buộc vì mỗi mục sẽ có một ID duy nhất do Mermaid chỉ định.

   [id^=flowchart-finish] circle {
      stroke: green;
      fill: lightgreen
   }
   

3. Tô màu một đường thẳng. Mỗi dòng sẽ có định dạng L-start-finish cho path, tức là dòng, và lớp .path, tức là dòng xung quanh đầu mũi tên.

   #L-start-finsh path,
   #L-start-finsh .path
    {
      stroke: green;
   }
   

Cập nhật sơ đồ

Hình ảnh tĩnh cho mỗi sơ đồ được tạo ra như sau.

1. Chuyển đến thư mục coe-cli.

   cd coe-cli
   

2. Tạo tệp tĩnh.

   npm run diagrams
   

Thêm trang trợ giúp

Thêm các trang trợ giúp mới vào trợ giúp. Mỗi trang trợ giúp cung cấp thông tin chi tiết về lệnh và các tùy chọn. Có thể truy cập tệp trợ giúp Markdown bằng lệnh trợ giúp hiển thị tệp trợ giúp Markdown liên quan trong cửa sổ bảng điều khiển.

coe help alm

Lệnh này hiển thị nội dung của trợ giúp.

Ghi lại dòng lệnh

Để đưa vào bản ghi hình động ngắn về các lệnh minh họa kết quả mong đợi, hãy sử dụng quy trình sau.

1. Cài đặt termtosvg trong một thiết bị đầu cuối chạy Unix.

   pip3 install --user termtosvg
   

   Quá trình này hoạt động trên mọi nền tảng và có thể sử dụng bất kỳ tùy chọn nào sau đây:

   • Shell Unix gốc trên các bản phân phối macOS hoặc Linux.
   • Hình ảnh Docker với shell Unix.
   • Hệ thống con Windows dành cho Linux trên Windows.

2. Ghi phiên vào một tệp truyền.

   termtosvg record test.cast
   

   Tệp truyền được tạo là một tệp văn bản đơn giản có thể được chỉnh sửa bằng bất kỳ trình soạn thảo văn bản nào.

3. Xóa các đoạn tạm dừng bằng cách sử dụng term-trim.ps1.

   ./term-trim.ps1 -Input test.cast -Output test2.cast -Trim 1
   
   

4. Tạo tệp svg.

   termtosvg render test2.cast test.svg -t window_frame