Kinetic Request CE Submission Search VERSION 1


Given a Request CE Space, Kapp, and optional Form, searches for submissions with a given query. The query parameter allows anything that can be passed into the query parameter in the /submissions endpoint of the Request CE API (including the limit= and q= parameters). Before being sent to the Request CE instance, the query is escaped by running the URI.escape() command on the inputted query string. After all the submissions that match the query have been returned, the handler formats it into one of three possible output formats: a JSON string, an XML string, or an XML list of submission ids.

If ID List is selected as the Return Type, the output looks like:

f4cd6acf-e552-11e5-9c32-97bbc6bf7f84bbc6bf7f-...

Note: The limit by default for submissions in 25, so if you want to retrieve more submissions than that add a limit=n (where n is an integer representing the new limit) to the query string


Parameters

NameDescription
Error HandlingDetermine what to return if an error is encountered.
Space SlugThe Space the submission is being retrieved from (defaults to info value if not provided).
Kapp SlugThe slug of the Kapp to search for submissions in.
Form SlugThe slug of the Form to search for submissions in.
QueryThe query that will be used to search the submissions. Ex: values[company]=Kinetic
Return TypeThe format that the results should be returned in.

Sample Configuration

NameDescription
Error HandlingError Message
Space Slug
Kapp Slugcatalog
Form Slugtest-form
Queryinclude=values&limit=100&q=values[Any Text] IN ("Testing","String")
Return TypeJSON

Results

NameSample Result
Handler Error MessageError message if an error was encountered and Error Handling is set to "Error Message".
CountThe number of submissions that have been returned.
ResultList of submissions that match the query --JSON,XML, or ID List

Changelog

Kinetic Request CE Submission Search V1.1 (2018-05-25)

* API Server Info Value changed to allow ${space} in the url for subdomain support (ie. https://${space}.localhost:8080/kinetic)

Kinetic Request CE Submission Search V1 (2017-11-08)

* Initial version. See README for details.