What is Piping?
Piping is a way to incorporate a user's responses into the text of your form. Responses are inserted using a special pipe code. You can retrieve this code by using the Insert Pipe dialog, or by checking the bottom right corner of the source item's settings page.
Pipe codes can be inserted into the following areas:
- Item question text and answer text
- Notification email messages
- Order Summary page
- Success Page
- Success Redirect URL
There is no limit to the number of pipes you can use.
Pipe codes use the format:
[pipe:x] or [pipe:x?default] or [pipe:x?]
Use "[pipe:x]" to pipe in the user's answer. If the user did not answer the source question, the pipe code will remain.
Use "[pipe:x?default]" to pipe in a default value if the user did not answer the source question.
Use "[pipe:x?]" to pipe in nothing (remove the pipe code) if the user did not answer the source question.
Special Pipe Codes
Use "[pipe:reference_#]" to pipe in the reference number for the user's form result.
Use "[pipe:repetition_#]" to pipe the number of times a repeating page has been repeated for the user.
Use "[pipe:total_score]" or "[pipe:max_score]" to pipe in scoring information for forms that use the Scoring feature.
Use "[pipe:order_total]" to pipe in the order total for Order Forms.
Use "[pipe:save_return_user]" to pipe in the logged in username for Save & Return forms.
Use "[pipe:save_return_email]" to pipe in the logged in email address for Save & Return forms.
One popular use of piping is to insert the user's name into an email Notification. Users are more likely to notice and read emails that contain their name because they are eye catching and sound more personalized. To do this, you will need a form with a Notification, and a question that asks the user for their name. Edit the Notification and enable the "Include Message" option. Then, click "Insert Pipe". On the Pipe Chooser, use the dropdown to select your "name" question, and then copy the pipe code that appears. Paste the code into the text in the field for the email subject or message. When the email is sent, the pipe code will be replaced with the text the user entered.
Piping is also useful in cases where you want to customize follow-up questions based answers to previous questions. For example, suppose you have the following question, with an id of 1, on the first page of your form:
What is your favorite search engine?
* MSN Search
* AOL Search
Suppose the user answered "Google". The clearest way to ask a follow-up question would be to use "Google" in the question text, such as, "How many times per day do you use Google". To do this, edit the follow-up question and use the "insert pipe" option. Select the item to pipe from and copy/paste the pipe code into the question text so that it reads:
How many times per day do you use [pipe:1]?
When the form is displayed, the pipe code will be replaced with the choice the user selected.
Answers piped from text field based items will be inserted exactly as entered by the user. Answers piped from multiple choice items will be separated with a comma if the user chose more than one answer. If the user chose an "other" answer for a multiple choice question, the answer will appear exactly as entered by the user.