# 建立元件規則

Availability-note[測試版](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-beta)

搶鮮版內容

在此情境中，您使用 Talend API 建立元件規則，以提升專案品質。

## 關於此任務

以下是關於 API 呼叫的一些詳細資訊：

```
Method: POST
endpoint: api/v1/projects/quality/rules/category/components
payload:
    {
    "name": "string",
    "description": "string",
    "severity": "Info",
    "category": "Component",
    "threshold": {
      "operator": "string",
      "value": 0,
      "type": "Percentage"
    },
    "components": [
      "string"
    ],
    "parameters": [
      "string"
    ],
    "inputs": [
      "string"
    ],
    "exists": true
  }
```

![選取 API 以取得所有規則。](https://help.qlik.com/Resources/Images/qlik-talend-cloud-migration-toolkit-user-guide/tcmp-api-rules.png)

## 程序

1. 呼叫 POST /api/v1/projects/quality/rules/category/component 端點以建立屬於 元件 類別的規則。 如果您想建立其他類別的規則，還有其他可用的端點。
2. 在 主體 區域中，輸入下列資訊：
   | 參數名稱 | 值 |
   | --- | --- |
   | 名稱 | 輸入規則名稱。 |
   | 描述 | 輸入規則的描述。 |
   | 嚴重度 | 輸入規則的嚴重度。嚴重性是根據規則對專案品質的影響來設定。您可以提供以下其中一種嚴重性類型：<br>資訊、<br>輕微、<br>主要、<br>嚴重。 |
   | 運算子 | 指定用於與閾值比較的比較運算子：&lt;=、\&gt;=、=、\&gt;= |
   | 值 | 輸入閾值的值。此值設定一個限制或邊界，在其之上或之下應觀察到某種情況。此欄位接受從 0 開始的數值。 |
   | 類型 | 輸入下列其中一種閾值類型：<br>百分比 或<br>數值。 |
   | 元件 | 輸入連接器或元件名稱。 |
   | 參數 | 作業中的每個元件或節點都可以有參數，例如 CODE、URL、URI。例如，tJava 元件有一個 程式碼 參數。<br><br>每個作業都可以有參數<br>(專案參數)，例如<br>隱式載入 或<br>多執行緒執行。<br><br>每個連線可以有參數，例如 PARTITIONER 或 NUM\_PARTITIONS。 |
   | 輸入 | 您可以新增正規表示式清單或任何文字來驗證規則。 |
   | 存在 | 判斷特定元件是否存在於作業中。這些值可以是 真 或 假。 |

   範例：
   ```
    {
       "name": "Java Logs",
       "description": "Identify Jobs that contain java logs",
       "severity": "Info",
       "category": "Component",
       "threshold": {
         "operator": "<=",
         "value": 0,
         "type": "Numeric"
       },
       "components": [
         "tJava", "tJavaFlex", "tJavaRow"
       ],
       "parameters": [
         "CODE", "CODE_START", "CODE_MAIN", "CODE_END"
       ],
       "inputs": [
         "System.out.print", "System.err.print"
       ],
       "exists": true
     }
   ```
3. 按一下 執行 以發出您的呼叫。

## 結果

規則已建立。