Khu chợ

Khu chợ là trang "dấu hiệu" trong bảng điều khiển: mẫu và mô-đun được xuất bản bởi cộng đồng và bởi nền tảng tất cả sống ở đây. Bạn có thể tải về những mục khác đã xuất bản trong mẫu hoặc thư viện module riêng của bạn, và xuất bản các workflow hoàn tất của riêng bạn và in chúng theo phiên bản riêng. Một mẫu được tải về được ngay lập tức chuyển vào workflow của riêng bạn; một mô- đun được tải về có thể được tham chiếu trực tiếp bởi một bước phụ công việc.

Duyệt và phân loại

Danh sách này có thể được lọc theo kiểu (sotlate / module), phân loại, thẻ, và tìm kiếm bằng tên, mô tả và thẻ. Trên đỉnh núi có ba cái xem : thảy đều được tôi tải lên và nhờ tôi mà tải về . Mỗi lá bài cho thấy tác giả, số phiên bản mới nhất, và số lần tải về; những thứ được vận chuyển với nền tảng mang một dấu hiệu "chính thức".

• Các tùy chọn thả phân loại đến từ các loại thực tế của mục được liệt kê hiện thời, không phải danh sách cố định; loại và thẻ được hiển thị trong ngôn ngữ giao diện của bạn.
• Thị trường chỉ cho thấy những thứ được liệt kê và nhìn thấy đối với bạn. Một nhà xuất bản có thể đặt một mục ra công cộng, có thể nhìn thấy chỉ thành viên nhóm, hoặc chỉ cho người dùng xác định; các mục bạn không thể thấy không xuất hiện trong danh sách của bạn.
• Một món đồ bạn đã tải về đã được đánh dấu là « Nạp lại » ngay trên thẻ; khi có phiên bản mới, cái nút sẽ thay đổi thành « Cập nhật »

Xuất bản mẫu hay mô- đun

Mục xuất bản là trong biên tập. Chỉ có người chủ sở hữu công việc mới có thể xuất bản nó ra thị trường, thậm chí không một quảng cáo viên nào có thể xuất bản phiên bản đầu tiên của bạn.

• Loại: một luồng công việc với một hợp đồng mô-đun có thể được xuất bản như là một "module," nếu không chỉ là một "towlate." Để xuất bản như một mô-đun, đầu tiên là "Phật phân thành mô-đun" trong biên tập và lưu bản hợp đồng.
• Bạn cần phải điền vào một tựa đề (đã yêu cầu, lên tới 200 ký tự), mô tả (lên đến 5000 ký tự), loại, thẻ (lên đến 20), biểu tượng, số phiên bản và ghi chú.
• Số phiên bản phải theo định dạng semver, chẳng hạn như 1. 0 hoặc 1. 0-beta.
• Có ba cấp khả năng nhìn thấy: mọi người dùng đều có thể nhìn thấy, chỉ thành viên của nhóm mà tôi thuộc (trong đội ID), và chỉ người dùng có thể nhìn thấy được (được nhập vào ID người dùng). Khi chọn đội tầm nhìn, bạn phải là một thành viên của mỗi đội.
• Giá: chỉ xuất bản miễn phí (0 USD) được hỗ trợ ngày hôm nay; xuất bản lương vẫn chưa sẵn sàng.
• Định nghĩa luồng công việc hàng loạt bị bao phủ vào lúc 2MB; bất cứ thứ gì lớn hơn bị từ chối.

curl -X POST https://braidrun.com/api/marketplace/items \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceWorkflowId": "<workflow-id>",
    "type": "TEMPLATE",
    "title": "竞品价格日报",
    "description": "每天拉取竞品价格并生成对比表",
    "category": "数据分析",
    "tags": ["监控", "报表"],
    "version": "1.0.0",
    "changelog": "首个版本",
    "visibility": "PUBLIC",
    "priceUsdCents": 0
  }'

Quản lý phiên bản

Cùng luồng công việc này không thể được xuất bản hai lần như một món đồ mới — người biên tập nhận ra rằng "workflow này đã được xuất bản" và chuyển hộp thoại thành "Upload phiên bản mới."

• Chỉ có tác giả gốc của món đồ mới có thể xuất bản một phiên bản mới; một nền tảng quản trị có thể xuất bản đại diện cho họ, nhưng tác giả của nó không thay đổi. Đối với các mục được xây dựng trong hệ thống, chỉ các quản trị có thể xuất bản các phiên bản mới.
• Số phiên bản mới phải là giá trị semver hợp lệ và không thấp hơn phiên bản mới nhất hiện thời. Cùng một số phiên bản không thể tải lên 2 lần.
• Phiên bản mới cũng đi vào phần ôn lại đang chờ; trong khi ôn lại, mục này vẫn còn nằm trong danh sách, và những người dùng khác vẫn còn tải về phiên bản mới nhất được liệt kê.
• Người dùng tải về các mục này sẽ thấy một thông tin cập nhật trên thẻ thị trường và trong phần "Đã tải xuống bởi tôi".
• Trang chi tiết của mục liệt kê lịch sử phiên bản đầy đủ và các ghi chú phát hành cho mỗi phiên bản.

Cài đặt:

Nhấn vào « Tải xuống » để lưu mục vào mẫu hay thư viện mô- đun. Nếu mẫu hoặc mô- đun chỉ tới các mô- đun khác (các bước phụ thuộc làm việc từvia), nền tảng giải quyết biểu đồ phụ thuộc đầy đủ trước khi tải về và đánh dấu trạng thái của mỗi quan hệ phụ thuộc:

Sau khi xác nhận « Tải xuống với quan hệ phụ thuộc », cài đặt theo thứ tự phụ thuộc: các mô- đun có cấp thấp nhất trước, từng lớp lên, và cuối cùng mục bạn nhấn vào. Trong khi tải về, dòng tác vụ d rằng tham chiếu làm việc phụ trong bản sao của bạn sẽ tự động được ghi lại ID của bản sao tương ứng trong thư viện của bạn — do đó, sau khi cài đặt bạn không cần phải sửa chữa bất kỳ tham chiếu nào bằng tay: mẫu có thể được thực hiện ngay lập tức và chạy trực tiếp, và các mô- đun có thể được tham chiếu trực tiếp.

# 下载最新版，连同依赖一起（返回本次创建的全部下载记录）
curl -X POST "https://braidrun.com/api/marketplace/items/<item-id>/download?withDependencies=true" \
  -H "Authorization: Bearer <token>"

# 下载指定历史版本（只下载该条目本身，不做依赖级联）
curl -X POST "https://braidrun.com/api/marketplace/items/<item-id>/download?version=1.2.0" \
  -H "Authorization: Bearer <token>"

• Giải quyết quan hệ phụ thuộc chỉ khi tải về phiên bản mới nhất; tải về một phiên bản lịch sử đặc trưng chỉ tải về mục đó.
• Các tài liệu tham khảo hình tròn (A tham khảo B và B tham khảo A) được phát hiện và xử lý một cách chính xác, mà không khoá lại cài đặt.
• Việc tải về bản thân không đi ngược lại với chỉ tiêu công việc của bạn, mà chỉ tính sau này.

Sau khi tải về:

Đang tải về chỉ các mục trong thư viện của bạn, và bản sao bị khoá theo mặc định. Có hai con đường để thực sự bắt đầu sử dụng nó:

• Biểu mẫu: trong thư viện mẫu, hãy nhắp vào mục đã tải về để thực hiện một luồng công việc có thể sửa đổi, có tên « Tên tập tin (được tạo từ mẫu) » theo mặc định. Bước này đi ngược với chỉ tiêu công việc.
• Module: Một khi tải về, nó có thể được tham chiếu bằng tên từ workflow của bạn thông qua một bước chảy phụ; bạn cũng có thể lập tức sửa đổi bản sao trong thư viện mô- đun và sửa đổi nó.

Một luồng công việc được sắp xếp ngay lập tức là độc lập với mục thị trường: một phiên bản mới từ tác giả sẽ không thay đổi thể hiện của bạn, và không cài đặt một món đồ từ "Gỡ xuống bởi tôi" không ảnh hưởng đến workflow bạn đã ngay lập tức.

Điểm kết thúc chung

Các trang liên quan

• Ngay từ mẫu
• Thư viện mô- đun có sẵn
• Dùng lại và thu nhỏ