---
title: 検索でビジネスオブジェクトを取得
slug: neurons-for-itsm/admin-user-help/jpn/latest/dhBlrIshIOXAbLrBaWnOs
createdAt: 2026-10-29T01:28:25.364Z
---

定義された検索キーワードに基づいてビジネス オブジェクト レコードを取得します。 たとえば、boardroom を含むインシデントを取得するように定義できます。

**ベース URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$search=\{search keyword}

:::hint{type="info"}
ビジネス オブジェクト名の末尾に「s」が付いていることを確認します。
:::

:::ExpandableHeading
## 検索によるビジネス オブジェクトの取得 - 例

以下は、boardroom を含むインシデントを取得する例です。

| メールアドレス                                 | https\://\{tenant url}/api/odata/businessobject/incidents?$search=Boardroom                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <font color="#ffffff">方法</font>         | 得る                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ヘッダー名                                   | 認証: JTW トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <font color="#ffffff">ステータスコード</font>   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <font color="#ffffff">レスポンスペイロード</font> | クリックするとレスポンスペイロードが表示されます<br />\{<br />"@odata.context": "\{tenant url}/api/odata/$metadata#incidents",<br />"@odata.count": 2,<br />"価値"： \[<br />\{<br />"ActualCategory\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",<br />"ActualCategory": "Missing Item",<br />"Category\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",<br />「カテゴリー」：「不足しているアイテム」<br />"CauseCode\_Valid": "E2489F3F7DA34B898CCD9569CA5541F2",<br />"CauseCode": "Other",<br />"ClosedBy": "JClerk",<br />"CreatedBy": "JClerk",<br />"Email": "KDavidson\@saasitdemo.com",<br />"RecId": "003B58C0B4554E4BAA30DFD88876582A",<br />「件名」：「会議室のプロジェクターのリモート コントロールが見つかりません」<br />「詳細」：「ルーフに取り付けられており、リモコンなしではオン/オフを切り替えることができないため、これが問題です」<br />"Urgency\_Valid": "44021B6CC6E44E598868C4B3306053AE",<br />「緊急度」：「中」、<br />"ログインID": "KDavidson",<br />},<br />\{<br />"ActualCategory\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",<br />"ActualCategory": "Missing Item",<br />"Category\_Valid": "14348C1FFA044D8AB1E93005B4A0A287",<br />「カテゴリー」：「不足しているアイテム」<br />"CauseCode\_Valid": "",<br />"CauseCode": "",<br />"ClosedBy": null,<br />"CreatedBy": "SDavis",<br />"RecId": "FAC9B02CB80041768D99EACE6A5DAD43",<br />「件名」：「会議室のプロジェクターのリモート コントロールが見つかりません」<br />「詳細」：「ルーフに取り付けられており、リモコンなしではオン/オフを切り替えることができないため、これが問題です」<br />"Urgency\_Valid": "44021B6CC6E44E598868C4B3306053AE",<br />「緊急度」：「中」、<br />"ログインID": "KDavidson",<br />}, |
:::

## 応答に失敗しました

:::ExpandableHeading
## 記録なし

シナリオ: レコードがない検索キーワードを使用してインシデントを取得しようとしています。

`https://{tenant url}/api/odata/businessobject/incidents?$search=xxx`

ヘッダー名:

**認証: セッションキー**

| コード                                             | ISM\_4000           |
| ----------------------------------------------- | ------------------- |
| 説明                                              | 要求の形式が正しくありません      |
| メッセージ                                           | 「そのようなエントリは存在しません」。 |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **400**             |


:::
