You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Item fields are searchable metadata fields that describe items (files and folders) in Box. These fields expose built-in item properties such as name, type, owner, and timestamps with defined data types so you can filter, sort, and search Box content.
22
+
23
+
## Supported item fields
24
+
25
+
The following table lists the item fields you can use in metadata queries.
Where possible, it is recommended to only send requests for which the result set is less than 2,000 items. The result set is the entire collection of files and folders that match the metadata query exclusively based on evaluating the `from`, `query`, and `query_params` parameters — before the requesting user’s permissions and the `ancestor_folder` scope are considered.
When sending a metadata query request for which the result set exceeds 2,000 items, the API can only guarantee that it returns all matching results if both the following conditions are met:
When sending a metadata query request for which the result set exceeds 2,000 items and for which these conditions are not true, the API might return an error with a 4XX response code indicating that the query will need to be restricted to return fewer results.
Now consider that there are 4,000 files in your Box enterprise which have the `catalogImages` template applied and which are split evenly between the two folders, `Parts` and `Products`, which are children of the parent folder `Catalog` as shown below.
Remember that the result set is defined as a collection of items (files and folders) which match the metadata query exclusively based on evaluating the `from`, `query`, and `query_params` parameters — before the requesting user’s permissions and the `ancestor_folder` scope are considered.
|`IS NOT NULL`| テンプレートフィールドの値が`null`でない場合に一致となります。 |
93
+
|`~`| Performs term-level search on the field against the provided terms. |
94
+
|`HASANY`| Matches when the field value is equal to any of the arguments provided. The format requires each item in the list to be an explicitly defined `query_params` argument, for example, amount `HASANY (:arg1, :arg2, :arg3)`. |
95
+
|`HASALL`| Matches when the field value has a match for all the arguments provided. The format requires each item in the list to be an explicitly defined `query_params` argument, for example, amount `HASALL (:arg1, :arg2, :arg3)`. |
96
+
|`HASANCESTOR`| Matches when the field value is a descendant of any argument provided. The format requires each item in the list to be an explicitly defined `query_params` argument, for example, amount `HASANCESTOR (:arg1, :arg2, :arg3)`. Supported only for the taxonomy MD field. |
0 commit comments