Orchestration
...
Record Actions
Search Records
9 min
using the search records native action searches for actions based on the provided filter criteria you select after selecting an application from the inputs tab, a condition builder is available the function of this condition/filter builder is the same as search record data docid\ o2eb6qjesxw 0lsp4wqfm use the radio buttons at the bottom of the window to return the entire record or just specific fields if you want all records for the application you selected, do not create conditions when you select the include limit check box, the input number is the max records that will be returned in a search inputs 1\ application selection select an application choose the application from which you want to export records 2\ filter condition click field to choose the field you want to filter on only fields available in the selected application are shown choose how the filter is evaluated using the operator dropdown common operators include equals field value exactly matches the specified value contains field value contains the specified value not equals, starts with, ends with, and so on additional operators may be available depending on field type enter or select the value to compare against the chosen field and operator add multiple conditions to refine your filter use the all/any (and/or) selector at the top all (and) all conditions must be true for a record to be included any (or) at least one condition must be true for inclusion 3\ return type find entire records export all fields of the matching records return specific fields choose and export only selected fields 4\ limit and pagination include limit enable/disable the limit on the number of records exported number of records set the maximum number of records per export include page number enable/disable pagination page number specify which page of results to export examples search by tracking id this action performs a search within swimlane to retrieve a specific record by its tracking id, allowing users to locate records efficiently based on a unique identifier endpoint https //de1 swimlane app 443/api/account/{account id}/tenant/{tenant id}/app/{app id}/record/tracking/{tracking id} required parameters account id the unique identifier for the swimlane account tenant id the tenant associated with the account, representing the isolated environment within swimlane app id the application identifier where the record exists tracking id the unique tracking id of the record to retrieve example usage { "applicationname" "case management", "filters" \[ { "field" "tracking id", "operator" "equals", "value" "cm 23" } ], "returnfields" \["case status"], "filtertype" "and" } response example { "records" \[ { "case status" "new" } ], "count" 1, "offset" 0, "limit" 0, "iscountlimited" false } 		 screenshot this screenshot shows the search record setup in swimlane, where you define the application name, filters (including the tracking id), and the fields to return search (with http action) the search (with http action) method allows users to perform a search directly through the swimlane api using an http get request this approach can be used to retrieve records based on specific criteria by providing the tracking id and other filter parameters http get endpoint https //de1 swimlane app 443/api/account/{account id}/tenant/{tenant id}/app/{app id}/record/tracking/{tracking id} authentication an api key or bearer token is required to authenticate the request include it in the request header as shown below authorization bearer {api key}	 request example get /api/account/8b3a19ca eba1 424d b8cc 7c97d7cf0fd0/tenant/7617907a c3e4 47a9 9834 025e4794beab/app/ag6pvdkde0t7ycqaa/record/tracking/cm 23 host de1 swimlane app authorization bearer {api key}	 response example { "records" \[ { "case status" "new" } ], "count" 1, "offset" 0, "limit" 0, "iscountlimited" false } screenshot this screenshot illustrates the configuration of the http action for get record in swimlane, using a direct http request to search by tracking id