Skip to main content

FV Kinesis Support

All the topics, resources needed for FV Kinesis.

 
FocusVision Knowledge Base

Piping Datapoints

Piping is the presentation of a prior answer by a respondent in a subsequent section.

1:  Radio Questions

You can pipe answers from all questions types except multiple response questions (e.g. checkbox, ranking, card sort) using the format ~QLABEL~ or ~[QLABEL]~. The first method will return an error if there is no response for the question. The second method will return blank if there is no response for the question and is preferred if it is possible that the question being piped from is bypassed. In the example:

Q1. Which of the following deli meats is your favorite? 

Bologna 
Chicken 
Turkey 
Pastrami 
Roast Beef 
Salami
Other

The piping to another question would be ~Q1~ which might read as follows:

Q2. Why is ~Q1~ your favorite deli meat?

If the respondent selects "Other", the other field response text and not the choice text will be piped in when using the above syntax.

If you are on version 5.7+ and use the Img option in the Choice Editor, you can pipe the image instead of the text using the following syntax: ~QLABEL:image~

Piping can only be used to display a response that has been stored or submitted before the previous pagebreak.

2:  Checkboxes

Piping from a checkbox question will return all answers checked. If you are just wanting to return a single option, whether it was checked or not, you will need to pipe the option directly. For example, to pipe choice 5 at Q1:

~q1_5~

If you are on version 5.7+ and use the Img option in the Choice Editor, you can pipe the image instead of the text using the following syntax: ~QLABEL:image~. In this case, the piped in checkbox responses will be printed as a series of images: <img 1>, <img 2>,... and <img n>.

3:  Ranking questions

Piping from a ranking question will return all answers ranked. If you are just wanting to return a single option, whether it was ranked or not, you will need to pipe the option directly. For example, to pipe the first ranked choice at Q1:

~q1_1~

To pipe the second ranked choice at Q1:s

~q1_2~

4:  Info Page Piping

You can pipe a URL parameter into info pages using ~IN_PARAM~ or ~[IN_PARAM]~, where PARAM is the name of the parameter to be piped in. For example if you have "&firstname=John" in your URL you can now have the welcome page display "Hello John!" by using ~IN_firstname~ or ~[IN_firstname]~.

5:  Exit Link Piping

To pipe a datapoint into an Exit Link URL, you will use [QLABEL], with QLABEL representing the name of the datapoint you're piping.

6:  Inline or Conditional Piping

VIEW DEMO

Inline piping in Kinesis is a way to display conditional text. Inline piping works based on if/else logic. In the past hidden datapoints would need to be created to pipe any conditional text onto the page. With inline piping the displayed text is not getting stored within the survey.

~CONDITION ? "Text if condition true" : "Text if condition false"~

The "CONDITION" is the entire logic the text is conditioned upon. It uses the condition syntax followed by other features in Kinesis. The ? defines the end of the condition and the start of the first text string. The first text string is what will display if the condition is true and the second text string is what displays if it returns false. This text must be contained in double quotes. The : is used to separate the two text strings and one space is required between all elements in the piping. You must define text for if the condition is true and if it is false. Use empty quotations to display nothing.

Examples:

~$Q1==1 ? "Dogs" : "Cats"~
~array_sum($Q1)>1 ? "Dogs" : "Dog"~
~rand(1,2)==1 ? "Random text" : "Other random text"~
~$Qphone==1 ? "Optional Text" : ""~

If piping a response from another question into your inline piping, simply use the standard piping method within the quotations. For example,

~$Qcheck==1 ? "~Q1~" : "~Q2~"~
  • Was this article helpful?