If you want to display a form in an iFrame, integrate it directly into the content of a page, or retrieve it from a server-side application, there are three ways to do it. For all methods, the first thing you will need is the full URL to the page where the user fills out the form. To get this URL, go to the first page of the form in question and copy the FULL URL from your browser's address field.

Next, there are four possible ways to embed the forms:

1. JavaScript
 
You can place a JavaScript tag on any HTML page and the form will be displayed within that page. The format for the tag is:

<script language="JavaScript" src="[FULL URL TO FORM]"></script>

where [FULL URL TO FORM] is the full URL to the form with the string "&_wjs=1" appended to the end of the URL.

Notes:

  1. This will not create a full HTML page. It is assumed that this content will be displayed within an HTML page that has its own tags (i.e. HTML, BODY, HEAD, etc.).
  2. If you need to include the nTreePoint stylesheet in the page that is hosting the embedded form, the URL is "styles.asp" in the nTreePoint domain/folder.

2. iFrame
 
In this case, you want your form to appear in a full HTML page, but without the rest of the nTreePoint framework around it. To do this, you take the full URL to your form and append "&_emp=1" to the end of it.
3. Form Without Framework
 
This method will give you the full Content Area exactly as it would be sent to a normal browser, but without the rest of the nTreePoint framework around it. This is suitable for instances when the contents will be retrieved using a server-side program and embedded into the output of another dynamically generated page.

To do this, you take the full URL to your form and append "&_nof=1" to the end of it.

Notes:

  1. This will not create a full HTML page. It is assumed that this content will be displayed within an HTML page that has its own tags (i.e. HTML, BODY, HEAD, etc.).
  2. If you need to include the nTreePoint stylesheet in the page that is hosting the embedded form, the URL is "styles.asp" in the nTreePoint domain/folder.

4. Remote Template Integration
 
This method is different in concept from the other three. The form is not being embedded into an external site; instead, the form is being displayed in nTreePoint from the nTreePoint server, but a remote template is retrieved and wrapped around the form. This allows all functionality to remain in nTreePoint, including the ability to have the same template wrapped around each page of a multi-page form, as well as when the form is shown to the user after submission in the case or errors.

To use remote template integration, a new Web Form must be created to manage the URLs to the templates as well as the placeholders within those templates that nTreePoint will find and replace with the form. Follow these steps when creating the form:

  1. Create a new form, giving it whichever name you want.
  2. Add a single-line text question with a short name of URL. The "Type" of the question should be URL. This is the URL nTreePoint will use to retrieve the template.
  3. Add a single-line text question with a short name of Replace. This will be the text that nTreePoint looks for after retrieving the template to replace with the body of the form.

After you have added one or more entries to this new form, you can now use them as templates for other Web Forms. First of all, find the form around which you want to wrap the template, and click the link to add a new response. This is the URL that you'll want to use. Next, we need to append the information for our template. Go to the form where you're storing template information and view the entries in listing format. Next, click the "View" link in the row of the template you'll want to use. Once you're looking at the details for the entry, you'll need to get the form id and the response id. Look at the URL in your browser's address box. The number that appears after "fid=" is the form id; the number that appears after "rid=" is the response id.

Take this information and append it in the following format to the end of the URL that takes users to your form:

&_wrf=[form id]&_wrr=[response id]

where [form id] and [response id] are the values you just grabbed for the template you want to use.

The new URL that you have created can now be used to link users to your form with the template wrapped around it.

Notes:

  1. To hide the page heading at the top of the form, add "&hph=1" to the end of the URL.
  2. To hide the required question icon and label, add "&hri=1" to the end of the URL.
  3. To customize the width of the form and error messages, add "&fwi=[width]" to the end of the URL where [width] can be pixels or a %. Note that if you enter "0" for the width, the width attribute will be removed from the table surrounding the form, and the form will automatically adjust its layout depending on the container.
  4. To customize the target that the form is posted to, add "&tar=[target]" to the end of the URL where [target] is the name of the target. For example, if you are embedding the form within an iFrame and you set the target to "_self", the form will remain within the iFrame when it is processed.
  5. Only forms that have been enabled for Public Write in the Form Settings can be embedded.
  6. Once a user submits the form from the host page, the user will be taken into nTreePoint Web Forms. If you want to avoid this, make sure the form is only a single page, then provide the Final URL in the Form Settings. In the case of forms using remote template integration, this is not an issue as nTreePoint will continue to use the template on each page of the form.
  7. If you want to show the form from nTreePoint (i.e. not embedding the form in another page) but only want to show the main Content Area and not the other parts of the interface, you can add "&_emp=1" to the end of the querystring of the URL for adding a response to the form. This will show only the form in the browser window but still maintain the styles, colors, etc. You can also include this on the querystring for embedded forms so when the user submits the form for the first time, he/she will be taken to page in nTreePoint without the full interface surrounding the form.