---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 返される結果データの構成

# 返される結果データの構成 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

Mobile SDK内では、REST エンドポイントを介して ServiceNow インスタンスからデータを操作するときに、返される結果で返されるデータを構成できます。
[FetchConfiguration](https://servicenow-prod.fluidtopics.net/PfnYOhpdQCRiXGASneYU2A#FetchConfigiOSStructure "FetchConfiguration 構造体は、ServiceNow インスタンスからレコードをフェッチするための構成を定義する機能を提供します。") 構造体を使用して、どのデータを返すかを設定します。この構造により、以下を構成できます。

* テーブルから返される特定のレコード。
* レコードから返される特定のフィールド。
* 返されるレコードの数。
{#mobsdk-ios-config_results_returned__ul_f5t_p2c_3qb}  
注:  
通常、返されるフィールドを決定するため、特定のモデルタイプのすべての CRUD 操作に同じ FetchConfiguration を使用します。少なくともモデルの必要なプロパティと一致する必要があります。一致しないと、JSON デコードは失敗します。

## 返す特定のレコードの構成 {#mobsdk-ios-config_results_returned__specific_records}

FetchConfiguration 呼び出し内の[フィルター](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#FilteriOSStructure "フィルター構造では、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成できます。")構造を使用すると、ServiceNow インスタンスからフェッチされ、REST エンドポイントからの戻り結果に返されるレコードをフィルター処理してソートできます。このフィルターは、REST API エンドポイントの sysparm_query パラメーターで渡されます。詳細については、「 [テーブル API」](https://servicenow-prod.fluidtopics.net/PGmiQS3PYaFpQEwlEzsYfg#c_TableAPI "テーブル API には、既存のテーブルで作成、読み取り、更新、および削除 (CRUD) 操作を実行できるエンドポイントが用意されています。")を参照してください。  
フィルター構造は、目的のフィルタリング機能に応じて、次の 4 つの方法で初期化できます。

1. [エンコードクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)でフィルタリング エン[コードされたクエリ](https://www.servicenow.com/docs/access?context=c_EncodedQueryStrings&version=australia&pubname=australia-platform-user-interface&ft:locale=en-US)。このタイプのフィルターを使用すると、指定されたテーブル内のレコードに適用されるエンコードされたクエリを渡すことができます。  
   たとえば、次の呼び出しは、アクティブで、簡単な説明フィールドに「broken」という単語が含まれているレコードのみを返します。

       Filter(query: "active=true^short_descriptionLIKEbroken"

   このタイプのフィルタリングを使用するには、[フィルター:init(query: String, queryCategory: String? = nil)](https://servicenow-prod.fluidtopics.net/Y11sjNmmftd5yve~jvgx2g#filter-init_S_S "指定されたエンコードクエリを使用してフィルターを作成します。") 関数を使用してフィルター構造を初期化します。
2. 基準でフィルタリングします。このフィルターを使用すると、OR で結合された 1 つ以上のフィルター基準に基づいてフィルターを適用できます。  
   たとえば、マネージャーには PTO である Abel Tuter という従業員がいます。誰にもアサインされていない、または Abel Tuter にアサインされていないアクティブなインシデントがあるかどうかを把握して、アサイン/再アサインできるようにしたいと考えています。また、エスカレーションが高いか期限切れになっているすべてのインシデントを同じリストで確認し、それらにも対処できるようにしたいと考えています。このデータを取得するために必要なフィルターの作成方法を次に示します。

       let activeIncidents = Condition.boolean(field: "active", .is(true))

       let assignedToEmpty = Condition.string(field: "assigned_to", .isEmpty) 

       let assignedToAbel = Condition.string(field: "assigned_to", .is("Abel Tuter")) 

       let assignedToAbelOrEmpty = CompoundCondition.or([assignedToEmpty, assignedToAbel]) 

       let needToReassign = Criteria(conditions: [activeIncidents, assignedToAbelOrEmpty])

       let highEscelations = Condition.string(field: "escalation", .is("2"))

       let overdueEscelations = Condition.string(field: "escalation", .is("3"))

       let highORoverdueEscelations = CompoundCondition.or([highEscelations, overdueEscelations]) 

       let needToHandleEscalation = Criteria(condition: highOrOverdueEscelations) 

       let myPrioritiesForTodayFilter = Filter(criteria: [needToReassign, needToHandleEscalation])

   このタイプのフィルタリングを使用するには、[フィルター:init(criteria criteriaList: \[Criteria\], sortBy: \[Sort\]? = nil, queryCategory: String? = nil)](Y11sjNmmftd5yve~jvgx2g#filter-init_A_A_S "OR で結合された 1 つ以上のフィルター基準に基づいてフィルターを作成します。") 関数を使用してフィルター構造を初期化します。
3. キーワードと条件でフィルタリングします。このフィルターを使用すると、AND で結合された特定のキーワードと条件に基づいてレコードをフィルタリングできます。たとえば、次のフィルターは、「iOS13 または iOS 14」というキーワードを含み、testField でソートされた指定された条件を満たすすべてのレコードを対象とします。

       testKeywordsAndConditionsAndSort() {
         let keywords = "iOS 13 | iOS 14"
         let conditionA = Condition.boolean(field: testField, .is(true))
         let conditionB = Condition.boolean(field: testField2, .is(false))
         let sortA = Sort.asc(testField)
         let filter = Filter(keywords: keywords, conditions: [conditionA, conditionB], sortBy: [sortA])
         
         XCTAssertEqual(filter.query, "123TEXTQUERY321=\(keywords)^\(conditionA.query)^\(conditionB.query)^EQ^\(sortA.query)")
       }

   このタイプのフィルタリングを使用するには、[フィルター:init(キーワード: String?= nil, conditions: \[Condition\], sortBy: \[Sort\]?= nil)](Y11sjNmmftd5yve~jvgx2g#filter-init_S_S_S "AND で結合された特定のキーワードと条件に基づいてフィルターを作成します。") 関数を使用してフィルター構造を初期化します。
4. 条件でフィルタリングします。このフィルターを使用すると、指定されたすべての条件を満たす (AND が一緒に) レコードをフィルタリングできます。たとえば、次のフィルターは、\[アクティブ\] フィールドが「true」で、SLA 期限フィールドの日付値が「今日」または本日より後の任意の日付であるすべてのレコードを対象とします。

       // Where the record is active
       let condition1 = Condition.boolean(field: "active", .is(true))

       // AND the date value of the SLA due field is on "today" or any date after today.
       let condition2 = Condition.dateTime(field: "sla_due", .atOrAfter(0, .daysAgoStart))

       let filter = Filter(conditions: [condition1, condition2])

   このタイプのフィルタリングを使用するには、[フィルター - init(conditions: \[QueryProviding\], sorts: \[Sort\]? = nil)](Y11sjNmmftd5yve~jvgx2g#filter-init_A_S "指定されたすべての条件に基づいてフィルターを作成します (ANDを一緒に使用)") 関数を使用してフィルター構造を初期化します。
{#mobsdk-ios-config_results_returned__ul_agc_qgc_3qb}

## 返す特定のフィールドの構成 {#mobsdk-ios-config_results_returned__section_ldz_cth_3qb}

FetchConfiguration メソッド呼び出し内の[FieldReadConfiguration 構造 : iOS](https://servicenow-prod.fluidtopics.net/sGHPF4yadrTvE83TDWpZgw#FieldReadConfigurationiOSStruct "FieldReadConfiguration 構造を使用すると、ServiceNowインスタンステーブルからフェッチするフィールドと形式を構成できます。")を使用すると、返される結果で返すフィールドを構成できます。さらに、返されるフィールドの形式/内容を次のように設定できます。

* 表示値
* 実際の値
* 参照リンクを除外
{#mobsdk-ios-config_results_returned__ul_ybh_ng3_3qb}  
注:  
コード可能モデルに一致するようにフィールドを構成すると、 ServiceNow インスタンスによって返されるペイロードが減り、データ転送が削減されてネットワーク効率が向上する場合があります。