ドラフトエンティティ

作業項目 (エピック、フィーチャー、ユーザーストーリー、および不具合) のドラフトを作成できるかどうか。

APIを介して作業項目をPOSTするときに、ドラフトを使用して検証ルールをバイパスします。これにより、APIを使用した統合により、たとえば必須フィールドを検証することなく、作業項目をすばやく作成できます。

例: パートナーは、ALM Octaneに不具合を送信するためのモバイルアプリを構築しています。モバイルアプリは、name、description、severity、およびattachmentsのフィールドのみを含む単純なダイアログを表示します。アプリのユーザーは、このダイアログを使用して不具合をすばやく送信し、後で不具合の詳細を入力できます。ただし、ALM Octaneに、重大度が致命的のときに他のフィールドを必須にするルールがある場合、モバイルアプリをすばやく簡単な方法として使用することはできません。不具合を作成するため。解決策は、モバイルアプリによる最初の不具合提出にドラフトを使用し、後でモバイルアプリを使用しないときに詳細を編集することです。

ドラフトフィーチャーをサポートしているエンティティを確認するには、エンティティのメタデータを取得します。詳細については、Draftsを参照してください。

標準設定では、ドラフト作業項目を作成するときに、作業項目はドラフトとして自動的に作成されます。

  • is_draftフィールドをfalseに設定することにより、ルール検証を使用して (POST) 作業項目を作成できます。

  • is_draftフィールドをtrueに設定するか、is_draftフィールドを省略することにより、ルール検証なしで (POST) ドラフト作業項目を作成できます。

  • ドラフトエンティティを変更 (PUTting) するときに、ルールの検証をバイパスすることはできません。この段階で、必須フィールドを指定する必要があります。

例: 
POST .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/defects
{
  "data": [{
      "subtype": "defect",
      "name": "Takes too long to load shopping cart."
       "parent": {
            "type": "work_item",
            "id": "1001"
        },
      "is_draft": false
 }]
}