Skip to main content

findin Query Parameter

Used in conjunction with the find parameter, findin specifies the attributes to check for the find substring. The findin parameter is optional. If omitted, a base set of attributes will be searched. This free text search is relatively expensive for VersionOne, so when the exact contents of a field should be matched, use the where parameter instead.

rest-1 URL Syntax​

In rest-1.v1/Data and rest-1.oauth.v1/Data, the findin parameter is a URL query parameter. The findin parameter can be a single attribute or a set of comma separated attributes. The following shows how the findin is expressed in the query:

<Server Base URI>/rest.v1/Data/Story?sel=Name,Number&find=Ticket&findin=Name

The following shows how the findinparameter is used to search within multiple attributes:

<Server BaseURI>/rest.v1/Data/Story?sel=Name,Number&find=Ticket&findin=Name,Description

query.v1 Syntax​

In query.v1 and query.legacy.v1, the findin parameter is expressed as an array of attribute definitions.

YAML​

            from: Story
            select:
            - Name
            - Number
            find: Ticket
            findin:
            - Name

JSON​

            {
            "from": "Story",
            "select":
            [
            "Name",
            "Number"
            ],
            "find": "Ticket",
            "findin":
            [
            "Name"
            ]
            }