関連するビジネスオブジェクトを取得する
ビジネス オブジェクトにリンクされているすべての関連ビジネス オブジェクトを取得できます。
ベース URL:
https://{tenant url}/api/odata/businessobject/{business object name}('{business object unique key}')/{relationship name}
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
インシデントにリンクされた関連ビジネス オブジェクトを取得する例を次に示します。
メールアドレス | https://{tenant url}/api/odata/businessobject/incidents ('0A8C17C5DF534513AACCBB543C60B1D5')/IncidentContainsJournal |
|---|---|
方法 | 得る |
ヘッダー名 | 認証: JTW トークン/セッション キー/REST API キー |
ステータスコード | 200 |
レスポンスペイロード | { "@odata.context": "{tenant url}/api/odata/$metadata #Collection(MetaData.journal)", "価値": [ { "Category_Valid": "079449CD8C0040E7B580AD0DFFAC76FB", 「カテゴリ」:「送信メール」、 "CreatedBy": "ATaylor", "CreatedDateTime": "2019-02-01T04:55:28Z", "JournalType": "Email", "最終更新者": "ATaylor", "LastModDateTime": "2019-02-01T04:55:28Z", "Owner_Valid": null, 「所有者」: null、 "OwnerTeam_Valid": null, 「オーナーチーム」: null、 "オーナータイプ": "", "ParentLink_Category": "Incident", "ParentLink_RecID": "0A8C17C5DF534513AACCBB543C60B1D5", 「親リンク」: null、 "RecId": "06E745A9F96F412CB92DB567911D8F4F", 「件名」:「インシデント "TypeAlias": null、 "PublishToWeb": false, "AttachmentName": null, "AttachmentExtension": null, "AttachmentData": "", 「読み取り専用」: false、 "IsNewRecord": false, "IsUnRead": false, "親所有者": "RThomas", 「未読遷移」: false } ] } |
失敗した応答
シナリオ: URL が無効なときに関連するビジネス オブジェクトを取得しようとしています。
無効な URL の例:
https://{tenant url}/api/odata/businessobject/incident('0A8C17C5DF534513AACCBB543C60B1D5')/IncidentContainsJournal
ヘッダー名:
認証: セッションキー
コード | ISM_4004 |
|---|---|
説明 | 要求の形式が正しくありません |
メッセージ | [ 「タイプ 'Microsoft.OData.Edm.IEdmModel' のサービスがありません 登録されました。 ] |
HTTP ステータス コード | 404 |
シナリオ: リンクされたメイン ビジネス オブジェクトの RecID が無効なときに、関連するビジネス オブジェクトを取得しようとしています。
例:
https://{tenant url}/api/odata/businessobject/incidents('1234')/IncidentContainsJournal
ヘッダー名:
認証: セッションキー
コード | ISM_4000 |
|---|---|
説明 | 無効なリクエスト |
メッセージ | [ 「リンクされたリソースが存在しません。」 ] |
HTTP ステータス コード | 400 |
