Page Contents
fields フィルタは、結果に含める、または結果から除外するプロパティ(フィールド)を指定します。
REST API
filter[fields][propertyName]=<true|false>&filter[fields][propertyName]=<true|false>...
RESTに複数のフィールドを含めるには、複数のフィルタを使用することに注意してください。
また、REST検索で文字列化したJSON形式を使用することもできます。
Node API
警告:
AngularJS クライアント のモデルのメソッドは、上記Node APIとは異なるシグネチャを持っています。
詳細は、AngularJS SDK APIを参照してください。
{ fields: {propertyName: <true|false>, propertyName: <true|false>, ... } }
ここで、
- propertyName は含める、または除外するプロパティ(フィールド)の名前と同じです。
<true|false>
は、true
またはfalse
の真偽値リテラルを表します。プロパティを結果に含めるにはtrue
を、結果から除外するにはfalse
を使います。
既定では、検索は結果内のすべてのモデルプロパティを返します。ただし、値が true
のfieldsフィルタを1つでも指定すると、既定では、特にフィルタに含まれているフィールド のみ が検索されます。
例
id
・make
・model
プロパティのみを返します。
REST
?filter[fields][id]=true&filter[fields][make]=true&filter[fields][model]=true
{ fields: {id: true, make: true, model: true} }
戻り値:
[{
"id": "1",
"make": "Nissan",
"model": "Titan"
}, {
"id": "2",
"make": "Nissan",
"model": "Avalon"
},
...
]
vin
プロパティを除外します。
REST
?filter[fields][vin]=false
{ fields: {vin: false} }