レガシーステータス検索クエリに加えられた変更の理解

レガシーシステムでは、ステータス検索クエリは、クエリに含まれるすべてのグループに対して使用可能なすべてのシステムステータスをコピーします。レガシー応答には、クエリの各グループで使用できるすべてのシステムステータスとグループレベルのステータスが含まれます。

例えば、このクエリは次のとおりです(現在の推奨ベストプラクティスには従いません)。

例:

/attask/api/<VERSION>/CSTEM/search?groupID=602d27640000bb3b779f770d5fb95d6d&enumClass=STATUS_TASK

レガシーシステムでは次の応答が返されます。この応答には、すべてのオブジェクトステータスが含まれます。

{
    "data": [
        {
            "color": "1C68FF",
            "equatesWith": "NEW",
            "groupID": "602d27640000bb3b779f770d5fb95d6d",
            "label": "New",
            "objCode": "CSTEM",
            "value": "NEW"
        },
        {
            "color": "39FF39",
            "equatesWith": "INP",
            "groupID": "602d27640000bb3b779f770d5fb95d6d",
            "label": "In Progress",
            "objCode": "CSTEM",
            "value": "INP"
        },
        {
            "color": "FF3939",
            "equatesWith": "CPL",
            "groupID": "602d27640000bb3b779f770d5fb95d6d",
            "label": "Complete",
            "objCode": "CSTEM",
            "value": "CPL"
        },
        {
            "color": "8BC34A",
            "equatesWith": "NEW",
            "groupID": "602d27640000bb3b779f770d5fb95d6d",
            "label": "Custom_1",
            "objCode": "CSTEM",
            "value": "JET"
        },
        {
            "color": "8BC34A",
            "equatesWith": "NEW",
            "groupID": "602d27640000bb3b779f770d5fb95d6d",
            "label": "Custom_2",
            "objCode": "CSTEM",
            "value": "OGC"
        }
    ]
}

ただし、ステータスの保存および使用方法に対する更新に従って、ステータスはグループに対してコピーされず、システムレベルで各グループに継承されます。結果として、検索 API クエリは、特定のグループに直接関連付けられているステータスのみを読み取るので、応答にはシステムロック済みのステータスとロック解除済みのステータスが含まれますが、問題のステータスが追加された後に作成されたグループのみが対象です。

レガシーシステムが更新された後に、更新されたベストプラクティスの方法を使用してステータス検索クエリを実行しないと、不完全なグループステータスのリストが応答で返されます。

レガシーシステムが更新された後に、この古いリクエスト構造が返す例を次に示します。

例:

/attask/api/<VERSION>/CSTEM/search?groupID=602d27640000bb3b779f770d5fb95d6d&enumClass=STATUS_TASK

この応答には、グループ固有のステータスのみが含まれ、システムレベルで宣言されたステータスは除外されます。

{
  "data": [
    {
      "color": "8BC34A",
      "equatesWith": "NEW",
      "groupID": "602d286d000004fc8f53942de697a868",
      "label": "Custom_2",
      "objCode": "CSTEM",
      "value": "MMI"
    }
  ]
}
recommendation-more-help