---
title: 選択によるビジネスオブジェクトの取得
slug: neurons-for-itsm/admin-user-help/jpn/latest/SbQISo6xgsxiCMN5UzRaD
createdAt: 2026-10-29T01:28:25.354Z
---

この REST API を使用するには、次の 3 つの方法があります。

- ビジネス オブジェクトの要求されたフィールドのみを取得できます。
- 定義されたフィルター値に基づいてビジネス オブジェクト レコードを取得できます。
- 定義されたフィルター値に基づいて、ビジネス オブジェクトの要求されたフィールドのみを取得できます。

**ベース URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$select=\{names fields to be displayed}

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

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

以下は、インシデントを取得し、取得したレコードのフィールド **RecID** と **Category&#x20;**&#x306E;みを表示する例です。

| メールアドレス    | https\://\{tenant url}/api/odata/businessobject/incidents?$select=RecId, Category                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 方法         | 得る                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ヘッダー名      | 認証: JTW トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ステータスコード   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| レスポンスペイロード | \{"@odata.context":"https\://tenant/api/odata/$metadata#incidents(RecId,Category)","@odata.count":551,"value":\[\{"RecId":"003B58C0B4554E4BAA30DFD88876582A","Category":"Missing Item"},\{"RecId":"019A1ED9C77C4210B7054F47D214C004","Category":"Account Lockout"},\{"RecId":"030F0DA291EC46C9953817F0E22F188E","Category":"Printer Failure"},\{"RecId":"03C219DBC4EC49E6A5A320DE542AD591","Category":"Account Lockout"},\{"RecId":"03C7E9B0A56F4914B10028702DD52C7C","Category":"Facility Safety"},\{"RecId":"03D27D44FAFC4CD6A0D8F5AACEF5A142","Category":"Voicemail Issue"}, \{"RecId":"0464AABB3FCF4EBC993D4CDC7C3EE8F4","Category":"Desktop Software"},\{"RecId":"04B5870A4A334412B9F63993868764F5","Category":"Service Desk"},\{"RecId":"0507D465E1934E07B9A769F131DDCF27","Category":"Account Lockout"},\{"RecId":"055EB9F659E947E2A54E07BF44CAF93E","Category":"Hardware"},\{"RecId":"05B5CD2DFAE54D86A04C74DBF616C1DE","Category":"Facility Security"},\{"RecId":"06EB5086E87E4DDBBA000A37C346DFDE","Category":"Connectivity"},\{"RecId":"078A9AD7490743F3A0D23A2F85F5288F","Category":"Corrupt Mailbox"},\{"RecId":"08141BB084E6407B9401BE43934D111C","Category":"Facility Safety"},\{"RecId":"089ADDF649DC4ED1A8D2B8C067D2EA92","Category":"Client Failure"},\{"RecId":"08A5CFCDD82E4E888E1151BF1819AFE8","Category":"Account Lockout"},\{"RecId":"093FFFA7DFE5496B8C30897DFCED0C70","Category":"Connection Failure"},\{"RecId":"0AAD920C8D3F443488B956DDD95B6E58","Category":"Account Lockout"},\{"RecId":"0C3F818FA1E14F02BE1990D340927BCA","Category":"Account Lockout"},\{"RecId":"0CDC422D1780489ABEA9012D55F0CDA8","Category":"Facility Safety"},\{"RecId":"0E275CE8B1AE42E18DE82C7E8B5C0920","Category":"Missing Item"},\{"RecId":"0E576BE9D5ED43B1B6B8EBD4BFA7B90F","Category":"Account Lockout"},\{"RecId":"0E83898E5BC44236AE7B59E175BCFFE5","Category":"Account Lockout"},\{"RecId":"0ED27E8F176347908A21ADCCDB7898C5","Category":"Connectivity"},\{"RecId":"0F8940C97B8D4831BFA5B89DBC2038F2","Category":"Network Folder Failure"}]}, |
:::

:::ExpandableHeading
## フィルターによるビジネス オブジェクトの取得 - 例

定義されたフィルター値に基づいてビジネス オブジェクト レコードを取得します。 たとえば、アクティブなインシデントだけを取得できます。

**ベース URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$filter=\{filter field} eq \{field value}

例：

| メールアドレス    | https\://\{tenant URL}/api/odata/businessobject/incidents?$filter=Status eq 'Active'                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 方法         | 得る                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ヘッダー名      | 認証: JTW トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ステータスコード   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| レスポンスペイロード | \{"@odata.context":"https\://tenant/api/odata/$metadata#incidents","@odata.count":51,"value":\[\{"ActualCategory\_Valid":"FB7670462FF94B77AE72445E943F6A3C","ActualCategory":"Desktop Software","Category\_Valid":"FB7670462FF94B77AE72445E943F6A3C","Category":"Desktop Software","CauseCode\_Valid":"","CauseCode":"","ClosedBy"\:null,"ClosedDateTime"\:null,"ClosedDuration"\:null,"CreatedBy":"RThomas","CreatedDateTime":"2011-11-18T20:42:38Z","Email":"PEmerson\@saasitdemo.com","FirstCallResolution"\:false,"Impact\_Valid":"1AFFC174C7EA4AB79CCA6B15EB67006D","Impact":"Medium","IncidentNumber":10409,"IsNotification"\:true,"IsVIP"\:false,"IsWorkAround"\:false,"LastModBy":"RThomas","LastModDateTime":"2012-01-28T18🔞28Z","Phone":"+44 (0)1635 516700\r\n\r\n","Priority\_Valid":"29CD5D78E16F4D82916C3E933A600096","Priority":"3","ProfileFullName":"Pam J Emerson","ProfileLink\_Category":"Employee","ProfileLink\_RecID":"ACDA6CB0265D4C64A7F103AAF2906B2B","ProfileLink":"ACDA6CB0265D4C64A7F103AAF2906B2B","RecId":"0464AABB3FCF4EBC993D4CDC7C3EE8F4","Resolution":"","Service\_Valid":"164A2AB6ED554D80B3BE0B06C29DCC1A","Service":"Desktop Service","SLA":"Desktop Service (Gold) for Sales and Marketing","SLALink\_Category"\:null,"SLALink\_RecID":"99CE40FD528A46D78578E47E28F046F6","SLALink":"99CE40FD528A46D78578E47E28F046F6","Source\_Valid":"EF789CE160E742F99623DBB4D29C045C","Source":"Phone","Status\_Valid":"EAB221009EE34AB4BC1D14A42ED099AA","Status":"Active","Subject":"Cannot open Powerpoint presentation in Office 2010","Symptom":"Word document is password protected. アクセス方法","UrgencyValid":"44021B6CC6E44E598868C4B3306053AE","Urgency":"<br />等<br />等 |
:::

:::ExpandableHeading
## フィルターと選択によるビジネス オブジェクトの取得 - 例

定義されたフィルター値に基づいてビジネス オブジェクト レコードを取得し、要求されたフィールドのみを表示します。 たとえば、すべての **アクティブ&#x20;**&#x30A4;ンシデントの **ステータス&#x20;**&#x30D5;ィールドのみを取得できます。

**ベース URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}?$filter=\{filter field} eq \{field value}&}?$select=\{names fields to be displayed}

例：

| メールアドレス    | https\://\{tenant URL}/api/odata/businessobject/incidents?$filter=Status eq 'Active'&$select=Status                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 方法         | 得る                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ヘッダー名      | 認証: JTW トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ステータスコード   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| レスポンスペイロード | \{"@odata.context":"https\://tenant/api/odata/$metadata#incidents(Status)","@odata.count":51,"value":\[\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"},\{"Status":"Active"}]} |
:::

## 失敗した応答

:::ExpandableHeading
## 空の選択値

シナリオ: 選択値を定義せずにインシデントを取得しようとしています。

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

ヘッダー名:

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

| コード            | ISM\_5000                                          |
| -------------- | -------------------------------------------------- |
| 説明             | 無効なリクエスト                                           |
| メッセージ          | \[<br />「選択値は空にできません。 有効な値を入力してもう一度お試しください。<br />] |
| HTTP ステータス コード | 500                                                |
:::

:::ExpandableHeading
## 無効な選択値

シナリオ: 無効な選択値でインシデントを取得しようとしています。

`https://{tenant url}/api/odata/businessobject/incidents?$filter=Status eq 'New'`

ヘッダー名:

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

| コード            | ISM\_4000                                             |
| -------------- | ----------------------------------------------------- |
| 説明             | 無効なリクエスト                                              |
| メッセージ          | \[<br />「フィルター値が無効です。 有効なフィルター値を指定して再試行してください。<br />] |
| HTTP ステータス コード | 400                                                   |
:::
