ReclD または一意のキーでビジネス オブジェクトを取得する
変更、問題、インシデントなどのビジネス オブジェクトの詳細は、RecID または一意のキーによって取得できます。
ベース URL:
https://{tenant url}/api/odata/businessobject/{business object name}({'business object unique key'})
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
以下は、RecID または一意のキーによって変更ビジネス オブジェクトを取得する例です。
メールアドレス | https://{tenant url}/api/odata/businessobject/changes('02818A8426C9402E8DFE7C8D3132F783') |
|---|---|
方法 | 得る |
ヘッダー名 | 認証: JWT トークン/セッション キー/REST API キー |
ステータスコード | 200 |
レスポンスペイロード | { "@odata.context": "https://frs-dev-tenant.saasitdev.com/api/odata/change/$metadata#changes/$entity", "AcceptanceDueDate": "0001-01-01T00:00:00Z", "AcceptTimeout": "0001-01-01T00:00:00Z", "BackoutPlanAttached": false, "BallotCount": null, "BusinessFunction_Valid": "", "BusinessFunction": "", "Category_Valid": "E0234286776B43C39231635C7066F369", 「カテゴリ」:「ソフトウェア」、 "ChangeNumber": 10173, "ClosedBy": null, "ClosedCode_Valid": "", "ClosedCode": "", "ClosedDateTime": "0001-01-01T00:00:00Z", "CompletedBy": "", "CreatedBy": "Admin", "RecId": "008E3506AF3F4CC190BC95523645D968", "RiskLevel_Valid": "3548D4C1230B491DAB1D315AA93902B5", 「リスクレベル」: 「低」 "RiskCatalogLink_Category": "", "RiskCatalogLink_RecID": "", "RiskCatalogLink": null, "ReleaseLink_Category": "", "ReleaseLink_RecID": "", "リリースリンク": "", "CIへのトリガー変更": "0001-01-01T00:00:00Z", "RequesterLocation": "APAC - 中国", "依頼者電話番号": " 86 10 8520 0424", "MCVoteExpirationDateTime": "0001-01-01T00:00:00Z", "ECABVoteExpirationDateTime": "0001-01-01T00:00:00Z", "CABVoteExpirationDateTime": "2011-10-14T01:30:36+05:30", "提出期限日時": "2011-10-07T13:46:00 05:30", "CABReviewDate": "2011-10-14T01:30:36+05:30", 「リスク合計スコア」: null、 「読み取り専用」: false、 「オーナーフルネーム」: null、 "Cost": 182, 「合計消費時間」: 160, "IsUnRead": false } |
失敗した応答
シナリオ: 特定のビジネス オブジェクト インスタンスを ID で取得するために、指定されたキーの値が空または空白です。
例:
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ 「キー値は空にできません」 ] |
HTTP ステータス コード | 400 |
シナリオ: 特定のビジネス オブジェクトをその一意のキーで取得しようとしましたが、指定されたキーの値がランダム、無効、または削除されたビジネス オブジェクト フィールドの値です。
例:
https://{tenant url}/api/odata/businessobject/changes('1234')
https://{tenant url}/api/odata/businessobject/changes('random')
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエストペイロード |
メッセージ | [ 「無効な OData クエリ」 ] |
HTTP ステータス コード | 400 |
