Kinetic Request CE Submission Retrieve Version 2

This handler retrieves a submission by either id or query. If retrieving by query, the handler queries the given space/kapp/form in the form of q={inputted_query}. The query that is used to return back a submission should be a query unique enough to bring back one record, although if it is not unique the handler will not currently fail and will instead just return the first submission returned. If searching by id, only the id needs to be inputted to return that submission.

Parameters

Name Description
Error Handling Determine what to return if an error is encountered.
Space Slug The Space the submission is being retrieved from (defaults to info value if not provided).
Retrieve By How to retrieve the submission. Id or Query.
Kapp Slug Slug of the kapp to query
Form Slug Slug of the form to query
Query A query that will retrieve a single submission
Submission Id The id of the submission being retrieved.

Sample Configuration

Name Description
Error Handling Error Message
Space Slug
Retrieve By Query
Kapp Slug test-kapp
Form Slug test-form
Query values[Unique Field]="unique value"
Submission Id

Results

Name Description
Handler Error Message Error message if an error was encountered and Error Handling is set to "Error Message".
ID ID of the submission that was entered.
Label Label of the submission.
Handle Handle of the submission (last 6 of ID)
Origin Originating ID. This is typically the ID of a different submission.
Parent Parent ID.
Submitted At Submitted Date/Time
Submitted By User that submitted the submission
Type
Updated At Closed Date/Time
Updated By User ID for Last Updated
Closed At Closed Date/Time
Core State Status: Draft, Submitted, or Closed
Created At Created Date/Time
Created By User ID that created the submission
Form Description Description on the submission's form
Form Name Name of the submission's form
Form Notes Notes on the submission's form
Form Slug Slug of the submission's form
Form Status Status of the submission's form
Kapp Name Name of the submission's kapp
Kapp Slug Slug of the submission's kapp
Current Page The Current Page of the submission
Values JSON JSON Result of submission's Values

Changelog

Kinetic Request CE Submission Retrieve V2.3 (2018-06-11)

  • Added support for submission searching at the Kapp level without a Form Slug.

  • Updated handler to return a submissions values as well as a JSON map

(ie. searching by kapp fields)

Kinetic Request CE Submission Retrieve V2.2 (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 Retrieve V2 (2017-11-19)

  • Added the ability to retrieve by query while also keeping the search by id option

Kinetic Request CE Submission Retrieve V1.1 (2017-01-30)

  • Change the origin/parent to return a JSON string.

Kinetic Request CE Submission Retrieve V1 (2016-04-25)

  • Initial version. See README for details.

  • Added Kapp Name and Kapp Slug to results


Related Handlers

Kinetic Request CE Attachment Copy
This handler is used to copy an attachment from one submission to another.
Kinetic Request CE Attachment Temp Link Retrieve
Retrieves file attachment information for a submitted attachment field in Kinetic Request CE. This information also contains the URL for each attachment so the file can be downloaded from the file store.
Kinetic Request CE Attribute Definition Create
Creates an Attribute Definition in Kinetic Request CE.
Kinetic Request CE Attributes Set
Updates one or more Attributes in Kinetic Request CE for the specified object.
Kinetic Request CE Bridge Model Create
Creates a Bridge Model in Kinetic Request CE.
Kinetic Request CE Cascading Attribute Value Retrieve
Returns the matched value of the "Property to Return" parameter for the given scope. If the Context is Submission, this handler will search for a matching submission value, if none found, it will search the form, then kapp, then space for a match.
Kinetic Request CE Datastore Submission Activity Create
Creates a submission activity record in Kinetic Request CE.
Kinetic Request CE Datastore Submission Activity Update
Updates a submission activity record in Kinetic Request CE.
Kinetic Request CE Datastore Submission Delete
Deletes a Datastore Submission record in Kinetic Request CE for the specified space.
Kinetic Request CE Datastore Submission Search
Searches a Datastore Form for submissions and returns any matching submission objects in the specified return format.
Kinetic Request CE Form Create
Creates a form record in Kinetic Request CE for the specified space. If the form exists, nothing happens
Kinetic Request CE Form Type Create
Creates a Form Type in Kinetic Request CE.
Kinetic Request CE Form Update
Updates a form in Kinetic Request CE for the specified space, kapp and form.
Kinetic Request CE Kapp Retrieve
Retrieves a Kapp record in Kinetic Request CE.
Kinetic Request CE Password Change
Changes the password for a User record for the specified space in Kinetic Request CE.
Kinetic Request CE Space Delete
Deletes a Space in Kinetic Request CE.
Kinetic Request CE Space Update
Retrieves a Space record in Kinetic Request CE.
Kinetic Request CE Submission Activity Retrieve
Retrieves a submission activity record in Kinetic Request CE.
Kinetic Request CE Submission Clone
Clones a Submission record in Kinetic Request CE for the specified space and orig submission.
Kinetic Request CE Submission Delete
Deletes a Submission record in Kinetic Request CE for the specified space.
Kinetic Request CE Submission Reset
Reset a Submission record in Kinetic Request CE for the specified space.
Kinetic Request CE Submission Retrieve Children
Returns a submissions children as an ID List, JSON, or XML
Kinetic Request CE Submission Search
Searches a kapp or form for submissions and returns any matching submission objects in the specified return format.
Kinetic Request CE Submission Update
Updates a Submission record in Kinetic Request CE for the specified space.
Kinetic Request CE Team Create
Creates a team record in Kinetic Request CE for the specified space.
Kinetic Request CE Team Membership Create
Adds the given user to the given team.
Kinetic Request CE Team Membership Delete
Removes the given user from the given team.
Kinetic Request CE Team Retrieve
Retrieves a team in Kinetic Request CE in the specified space.
Kinetic Request CE Team Update
Updates a Team record in Kinetic Request CE for the specified space.
Kinetic Request CE User Create
Creates a User record in Kinetic Request CE for the specified space.
Kinetic Request CE User Retrieve
Retrieves a User record in Kinetic Request CE for the specified space.
Kinetic Request CE User Update
Updates a User record in Kinetic Request CE for the specified space.