ArcGIS Runtime SDK for iOS
100.15
|
Defines a query on a portal.
To query a portal for items or groups, the AGSPortal's findItemsWithQueryParameters:
and findGroupsWithQueryParameters:
methods must use the query parameters specified by the AGSPortalQueryParameters class. You can choose any of pre-defined query strings, supplied by this class, or you can create a custom query string as per the specification in the Portal API. The default number of results returned is 10. Adjust this limit to return more results and use with the startIndex
property, if you wish to paginate the results.
Instance Methods | |
(instancetype) | - initWithQuery: |
(instancetype) | - initWithQuery:limit: |
(nullable id) | - toJSON: |
Properties | |
AGSEnvelope * | boundingBox |
NSArray< NSString * > * | categories |
NSInteger | limit |
NSString * | query |
BOOL | searchPublic |
NSString * | sortField |
AGSPortalQuerySortOrder | sortOrder |
NSInteger | startIndex |
NSDictionary< NSString *, id > * | unknownJSON |
NSDictionary< NSString *, id > * | unsupportedJSON |
|
staticrequiredinherited |
Initializes and returns an object from its JSON representation.
JSONObject | NSDictionary or NSArray containing the JSON. |
error | encountered during the operation, if any. |
- (instancetype) initWithQuery: | (NSString *) | query |
Initializes a AGSPortalQueryParameters with a query string.
query | The query string. |
- (instancetype) initWithQuery: | (NSString *) | query | |
limit: | (NSInteger) | limit | |
Initializes a AGSPortalQueryParameters with a query string and the limit on results.
query | The query string. |
limit | The number of results to be returned. |
+ (AGSPortalQueryParameters*) queryParametersForGroupsWithOwner: | (nullable NSString *) | username | |
title: | (nullable NSString *) | title | |
Returns query parameters that will find groups with a specified owner and title. Either property can be nil, but not simultaneously.
username | The username of the owner. |
title | The title of the group. |
+ (AGSPortalQueryParameters*) queryParametersForItemsInGroup: | (NSString *) | groupID |
Returns query parameters that will find all items belonging to a specified group.
groupID | The id of the group. |
+ (AGSPortalQueryParameters*) queryParametersForItemsOfType: | (AGSPortalItemType) | type | |
inGroup: | (nullable NSString *) | groupID | |
Returns query parameters that will find items with a specified type that belong to a specified group.
type | The type of the portal item. |
groupID | The id of the group. Can be nil. |
+ (AGSPortalQueryParameters*) queryParametersForItemsOfType: | (AGSPortalItemType) | type | |
inGroup: | (nullable NSString *) | groupID | |
withSearchString: | (nullable NSString *) | searchString | |
Returns query parameters that will find items with a specified type that belong to a specified group.
type | The type of the portal item. |
groupID | The id of the group. Can be nil. |
searchString | The string used for broader search on the items; such as on tags, title etc. Can be nil. |
+ (AGSPortalQueryParameters*) queryParametersForItemsOfType: | (AGSPortalItemType) | type | |
owner: | (NSString *) | username | |
searchString: | (nullable NSString *) | searchString | |
Returns query parameters that will find items with a specified type that belong to a specified owner.
type | The type of the portal item. |
username | The username of the owner. |
searchString | The string used for broader search on the items; such as on tags, title etc. Can be nil. |
+ (AGSPortalQueryParameters*) queryParametersForItemsOfType: | (AGSPortalItemType) | type | |
withSearchString: | (nullable NSString *) | searchString | |
Returns query parameters that will find items with a specified type that satisfy the specified criteria.
type | The type of the portal item. |
searchString | The string used for broader search on the items; such as on tags, title etc. Can be nil. |
+ (AGSPortalQueryParameters *) queryParametersForItemsOfTypes: | (NSArray< NSValue * > *) | types | |
owner: | (nullable NSString *) | owner | |
groupID: | (nullable NSString *) | groupID | |
searchString: | (nullable NSString *) | searchString | |
Creates an AGSPortalQueryParameters
that will find items with any one of a number of given types Optionally restricts the search to items belonging to a specified owner. An optional search string can be used to restrict the search even further.
types | the item types to search for |
owner | the username of the owner of the items, or nil to search for items with any owner |
groupID | The id of the group. Can be nil . |
searchString | a string specifying other criteria for the search, or nil if there are none |
+ (AGSPortalQueryParameters*) queryParametersForItemsWithOwner: | (NSString *) | username | |
searchString: | (nullable NSString *) | searchString | |
Returns query parameters that will find items with a specified owner.
username | The username of the owner. |
searchString | The string used for broader search on the items; such as on tags, title etc. Can be nil. |
+ (AGSPortalQueryParameters*) queryParametersForItemWithID: | (NSString *) | itemID |
Returns a query parameters that will find an item with a specified id.
itemID | The id of the item. |
+ (AGSPortalQueryParameters*) queryParametersWithQuery: | (NSString *) | query |
A method to get an initialized, autoreleased query parameters object with a query string.
query | The query string. |
+ (AGSPortalQueryParameters*) queryParametersWithQuery: | (NSString *) | query | |
limit: | (NSInteger) | limit | |
A method to get an initialized, autoreleased query parameters object with a query string and the limit.
query | The query string. |
limit | The number of results to be returned. |
|
requiredinherited |
Returns JSON representation for this object.
error | encountered during the operation, if any. |
NSDictionary
or NSArray
containing the JSON. Reimplemented in AGSPortalItem.
|
readwritenonatomicstrong |
The bounding box for a spatial search, which is an overlaps/intersects function of the query bounding box and the extent of the document. Documents that have no extent (e.g., mxds, 3dds, lyr) will not be found when doing a bounding box search.
|
readwritenonatomiccopy |
An array of content category specifications to use when searching for items.
Each entry is a string containing a comma-separated list of up to eight content categories. The exact full path of each category is required and an OR relationship is applied between the categories within a particular string.
There can be up to eight strings with an AND relationship being applied between the different strings.
For example, to search for items belonging to either the Water or Forest categories, both within the US, specify two strings as follows: "/Categories/Water,/Categories/Forest" and "/Region/US".
This property is ignored if the receiver is used to search for groups using findGroupsWithQueryParameters:completion: (AGSPortal)
.
|
readwritenonatomicassign |
The number of results to be returned (default = 10). This, along with the startIndex
, can help you paginate the search results.
|
readwritenonatomiccopy |
The query string specified for the search.
|
readwritenonatomicassign |
Indicates whether public items outside the organization may be included in the search results Default behavior is they are included.
|
readwritenonatomiccopy |
The field on which sorting should be done.
|
readwritenonatomicassign |
The order of sorting.
|
readwritenonatomicassign |
The index from which the results should be returned. The index number is 1-based. You should use this for paginating the search results.
|
readrequirednonatomiccopyinherited |
A dictionary of values that was in the source JSON but was unparsed by API.
NSDictionary
containing the unknown JSON.
|
readnonatomiccopyinherited |
A dictionary of values that are supported by the REST API, but not exposed through the SDK API.
NSDictionary
containing the unsupported JSON.