Versions Compared

Old Version 3

changes.mady.by.user Former user

Saved on

compared with

New Version 4

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

You can change the behavior of your forms by adding Url parameters to the form Urls found in the various share choices. These Url parameters are each described in detail below. Here are the parameters that work for each share choice. You can think of the code you get via the Share Form page as a starting point. Then you can change the behavior to whatever you need by adding, subtracting and modifying the Url parameters in the share code.

Forms created via the API createInstance method are form instances. They are an actual form to be used by a specific user in memory on the Server. Please see Data API for a list of the parameters that can be used with form instance Urls.  

Column
width240px

 On This Page:

Table of Contents
maxLevel1

 

Raw form link

  • edit=(true/false) -- The form will open in the Form Designer when edit=true and in use mode otherwise. The default is false.
  • print=(true/false) -- This form will be displayed in print view as if a user had clicked the print icon on the form.
  • dispose=(true/false) -- The form instance is deleted after the form is rendered in print view.
  • _readonly=(true/false) -- The form will open but you will not be able to enter values into the form when _readonly=true. The default is false.
  • _data -- A way to pass default values into form fields via the form Url.  See details below.
  • _extId -- A way to have multiple users connect to the same form instance. See details below.
  • _themeId -- Dynamically select a theme which takes precedence over the theme selected at either the Application or in the Form. See details here.
  • _formActionUrl -- Overrides the form's action set in the Form Designer. See _formActionUrl section below. If this parameter is used but equals nothing it will close the window when the form is submitted.
  • _formActionMethod=(get/post) -- Overrides the form action's method. Defaults to get. See _formActionMethod section below.
  • _formActionTarget=(frame/parent/top) -- Overrides a form action target. Defaults to frame. See _formActionTarget section below.
  • _locale=<locale code> --- This parameter enables you to translate your form into multiple languages. If not set the form displays with the language used in the form designer. If set to one of the locale codes the form displays translated to that language.
  • apikey --
  • _formTz – This parameter overrides the timezone of the browser/form. See the Time,Date/TimeControls section below.

Embedded form link -- "Just the iframe" and "Embedded Form"

  • All Raw form link parameters
  • id -- Use this when embedding multiple forms in the same web page. Each form needs a unique id. Not required for pages with only one form.
  • width=(num) -- Sets the initial iframe width. Defaults to 600. Only effective when resize=false.
  • height=(num) -- Sets the initial iframe height. Defaults to 600. Only effective when resize=false.
  • resize=(true/false) -- Automatically resizes the space (height, width) used by the form when resize=true. Defaults to true. When resize=false the form will remain in the width & height you set and the browser will add horizontal and vertical scrollbars if/when needed.
  • container=(true/false) -- Adds a border around the form and centers the form when container=true. Defaults to false.
  • center=(true/false) -- This parameter applies to the container so is only effective when container=true. Defaults to true. Set to false to left/top justify the form on the page.
  • border=(true/false) -- This parameter applies to the container so is only effective when container=true. Defaults to true. Set to false to remove the border.
  • onInit -- A javascript function in scope that will be called before the form is instantiated.
  • onSubmit -- A javascript function in scope that will be called after the form is submitted.

Popup form links – "Full Page Popup" and "Link (Email/Web page)"

_extId

If you open a new form via, for example, the Link (Email/Web Page) share URL, you will always open a new form. As you use the form and enter values into the form, the values are immediately cached on the Form Server as you tab to the next form field. If you close the browser tab/window containing the form prior to submitting the form, the Form Server still retains this form instance. By using the special (reserverd) URL parameter called _extId, it is possible to reconnect to an in-memory form instance. To utilize this feature, try this example:

...