---
title: ページネーションサーチ Web メソッドの使用
slug: neurons-for-itsm/admin-user-help/jpn/latest/ynRX-web
createdAt: 2026-10-29T01:28:25.883Z
---

この Web メソッドは、検索条件に基づいて 1 つ以上のビジネス オブジェクトを取得します。 これは Microsoft SQL スタイルのクエリです。 他の検索 Web メソッドと比較して、この汎用 Web メソッドを使用すると、任意の複雑なクエリを表現できます。

## リクエスト構文

```bash
FRSHEATIntegrationSearchResponse PaginationSearch(文字列セッションキー、文字列テナントID、ObjectQueryDefinitionクエリ、intスキップ)
```

## パラメータ

- **sessionKey**: **Connect** Web メソッドからのセッション キー。
- **tenantId**: セッション キーが認証されるテナント。
- **クエリ**: 検索条件を記述する構造。 これは、Microsoft SQL Select 要求の構造に従い、 **Top**、 **Where**、 **Join**、および **Order By** 句を含む、Select クエリで可能なほとんどのパラメーターを取得します。 **PaginationSearch&#x20;**&#x30E1;ソッドでは、 T**op&#x20;**&#x5024;がページ サイズ パラメータとして考慮されます。 T**op&#x20;**&#x304C;指定されていない場合、このメソッドはデフォルトで 100 件のレコードを返します。
- **skip** : 結果セットの先頭からスキップする必要があるレコードの数を示す整数値 (つまり、offset パラメータと同様)。

## 戻り値

**FRSHEATIntegrationSearchResponse** オブジェクトは次のように定義されます。

```bash
パブリッククラス FRSHEATIntegrationSearchResponse
    {
パブリック文字列ステータス { 取得; 設定; }
パブリック文字列例外理由 { 取得; 設定; }
パブリック リスト<List<WebServiceBusinessObject>> objList { get; set; }
    }
```

F**RSHEATIntegrationSearchResponse&#x20;**&#x30AF;ラスには次のフィールドがあります。

- **ステータス**: 操作が成功したかどうかを示すステータス値を提供します。 使用可能なステータス値の詳細な説明は、以下の表に記載されています。
- **exceptionReason**: **Connect** Web メソッドの実行時にシステムが例外をスローした場合の例外情報が含まれます。
- **objList**: ステータス フィールドの値が成功の場合、見つかった結果のリストが含まれます。 検索条件が複数のビジネス オブジェクトに一致した場合、外部リストには複数のビジネス オブジェクトが含まれます。 検索条件が結合を要求した場合、内部リストには結合されたビジネス オブジェクトが含まれます。 Microsoft SQL 応答とは異なり、結合された各オブジェクトのフィールドは個別のリストに保持されます。 それらは混ざり合っていません。 リクエストで **Top** 値を指定しない場合、 **objList** はデフォルトで結果リストから上位 100 件のレコードを返します。

以下の表に、使用可能なステータス値とその解釈方法を示します。

| <font color="#FFFFFF">**状態**</font> | <font color="#FFFFFF">**説明**</font>                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **成功**                              | ビジネス オブジェクトが正常に見つかりました。 o**bjList&#x20;**&#x30D5;ィールドからビジネス オブジェクト リストにアクセスすると、結果が W**ebServiceBusinessObjectsの**リストとして返されます。                                                                                                                                                                                                                                                                                                                                                     |
| **エラー**                             | ビジネス オブジェクトが見つかりません。 o**bjList&#x20;**&#x30D5;ィールドが null です。 対応する **exceptionReason** フィールドを調べて、Web メソッドが失敗した理由を特定します。<br />一般的なエラーの例を次に示します。<br />- 一般的なエラーは「 **テーブルが見つかりません**」です。これは、指定されたビジネス オブジェクトがテナント内に存在しない場合に発生します。<br />ビジネス オブジェクトの名前が正しく入力されていることを確認します。<br />- もう 1 つの一般的なエラーは、指定されたフィールドがビジネス オブジェクトに存在しないことです。 エラーメッセージは次のとおりです:<br />`ObjectTableMap: フィールド <FieldName> がテーブル <Business Object>に見つかりません`<br />フィールド名が正しく入力され、指定されたビジネス オブジェクトに対して定義されていることを確認します。 |
| **見つかりません**                         | 指定されたビジネス オブジェクトはテナント内に存在しますが、指定された **RecID** はオブジェクト内の既存のレコードのいずれとも一致しません。<br />これは例外的な条件ではないため、 **exceptionReason** フィールドには例外は保存されませんが、 **objList** フィールドは null になります。 目的のレコードの **RecID** がテナント内に存在することを確認します。                                                                                                                                                                                                                                                                  |

:::ExpandableHeading
## 例1

次の例では、優先度が 1 でステータスが *アクティブ*であるインシデント レコードを検索し、最初の 10 件のレコードをスキップして、一致する結果から対応するインシデント番号を取得します。

```bash
ObjectQueryDefinition query = new ObjectQueryDefinition();
```

```bash
クエリー.Select = 新しい SelectClass();
```

```bash
// IncidentからIncidentNumberフィールドの値のみを取得します。
```

```bash
// 検索を呼び出すとき
```

```bash
フィールドクラス[] インシデントフィールドオブジェクト = 新しいフィールドクラス[] {
```

```bash
新しいフィールドクラス()
```

```bash
{
```

```bash
名前 = "インシデント番号",
```

```bash
タイプ = "テキスト"
```

```bash
}
```

```bash
};
```

```bash
クエリー.Select.Fields = インシデントフィールドオブジェクト;
```

```bash
クエリ.From = 新しい FromClass();
```

```bash
query.From.Object = "インシデント";
```

```bash
query.Where = 新しいルールクラス[] {
```

```bash
new RuleClass()
```

```bash
{
```

```bash
結合 = "AND"、
```

```bash
条件 = "="、
```

```bash
フィールド = "優先度"、
```

```bash
値 = "1"
```

```bash
},
```

```bash
new RuleClass()
```

```bash
{
```

```bash
結合 = "AND"、
```

```bash
条件 = "="、
```

```bash
フィールド = "ステータス"、
```

```bash
値 = "アクティブ"
```

```bash
}
```

```bash
};
```

```bash
スキップ = 10;
```

```bash
FRSHEATIntegrationSearchResponse searchResponse = frSvc.PaginationSearch(authSessionKey, tenantId, query, skip);
```

```bash
if (searchResponse.status == "成功")
```

```bash
{
```

```bash
WebServiceBusinessObject[][] incidentList = searchResponse.objList;
```

```bash
foreach (WebServiceBusinessObject[]incidentOuterList inincidentList)
```

```bash
{
```

```bash
foreach (incidentOuterList 内の WebServiceBusinessObject インシデント)
```

```bash
{
```

```bash
// 選択基準の1つのフィールドだけを取得するので
```

```bash
// （つまり IncidentNumber）に対応します。
```

```bash
// 結果を取得するときのincident.FieldValues[0].Value
```

```bash
Console.WriteLine("インシデント {0} は選択基準に一致します",incident.FieldValues[0].Value);
```

```bash
}
```

```bash
}
```

```bash
}
```
:::

:::ExpandableHeading
## 例2

次の SOAP の例では、インシデント レコードを検索し、上位 10 件のレコードをスキップして、クエリで **Top** を指定しない場合は、次の 100 件のレコードを返します。

```bash
<?xml version="1.0"?>
```

```bash
<soap:Envelope
```

```bash
xmlns:saas="SaaS.Services"
```

```bash
xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
```

```bash
<soap:Header/>
```

```bash
<soap:Body>
```

```bash
<saas:PaginationSearch>
```

```bash
<!--Optional:-->
```

```bash
<saas:sessionKey>セッションキー</saas:sessionKey>
```

```bash
<!--Optional:-->
```

```bash
<saas:tenantId>テナントID</saas:tenantId>
```

```bash
<saas:ObjectQuery>
```

```bash
<!--Optional:-->
```

```bash
<saas:From Object="Incident#"></saas:From>
```

```bash
<!--Optional:-->
```

```bash
<saas:Select All="true"></saas:Select>
```

```bash
<saas:OrderBy>
```

```bash
<!--Zero or more repetitions:-->
```

```bash
<saas:Field Direction="asc" Name="IncidentNumber"/>
```

```bash
</saas:OrderBy>
```

```bash
</saas:ObjectQuery>
```

```bash
<saas:skip>10</saas:skip>
```

```bash
</saas:PaginationSearch>
```

```bash
</soap:Body>
```

```bash
</soap:Envelope>
```
:::

:::hint{type="info"}
- A**ppserver webconfig&#x20;**&#x30D7;ロパティを使用して、デフォルトの T**op&#x20;**&#x6700;大値を設定できます。
  `<add key="DefaultMaxNumberOfRecordsRestAPI" value="100" />`
- T**op&#x20;**&#x306E;値を 0`に`指定すると、 P**aginationSearch&#x20;**&#x30E1;ソッドはデフォルトで 100 件のレコードを返します。
:::
