Versions Compared

Old Version 16

changes.mady.by.user Former user

Saved on

compared with

New Version Current

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
width240px400px

 On This Page:

Table of Contents
maxLevel1

...

  • 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 the details here.
  • _extId -- A way to have multiple users connect to the same form instance. See details below.
  • _themeId or _themeID!userID!tenantId-- 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 the _formActionUrl section. 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 the _formActionMethod section.
  • _formActionTarget=(frame/parent/top) -- Overrides a form action target. Defaults to frame. See the _formActionTarget 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 belowRefer to Time Zones  for more information.
  • _device -- (tablet/phone/desktop) –used to show the specified device view in your browser. This parameter is very helpful when testing forms for mobile devices as you can see the phone or tablet view from your desktop.

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.
  • ifname --Select the custom id for the iframe that will be auto generated by the script (default is 'frevvo-form'), i.e. name of the iframe.
  • 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 the form is used on a desktop device. Defaults to false when the form is used on a mobile device such as the iPhone or iPad. 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.
  • scrolling -- Do you want scrolling?  Puts scrolling attribute on the iframe.  Defaults to auto.  See the html scrolling attribute for values.
  • 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.
  • _test -- Do you want to generate a debug console?  Defaults to false
     
Tip

Embedding the task list successfully into an HTML page requires setting its width. You must explicitly add %26tasks-width=XXXpx - where XXX equals the width that you want. Here is an example:

<script>  src="http://localhost:8080/frevvo/web/embed?resize=true&container=true&border=false&url=http://localhost:8080/frevvo/web/tn/{tn.id}/subject/{subject.id} /tasks%3fembed=true%26container=true%26resize=true%26tasks-width=1000px"

                                  type="text/javascript"></script>

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

...

  • Copy the the Link (Email/Web Page) share URL for one of your forms and append ?_extId=123 to the formtype URL. Open that URL in your browser and start filling in a form. Do NOT submit the form.
  • Next, open a 2nd browser tab or window and use just the formtype URL and it will be blank. A new form instance is created.
  • Open a 3rd browser tab or window and use the share URL again appended with ?_extId=123, and you'll get back to the 1st instance.  

_formActionUrl, _formActionMethod, _formActionTarget

The Form Action can be overridden by using these special (reserverd) URL parameters. The presence of _formActionUrl overrides any Form Action in the Form Designer by specifying which Url to go to when the form gets submitted.

_formActionMethod is optional and can be set to either "get" or "post". If unspecified it defaults to "get" causing the user to get forwarded to this web page when the form is submitted. If set to "post" it will also post the data to this Url.

_formActionTarget is optional and only taken into account when _formActionUrl is specified. It can be set to one of the values: frame, parent, top (lower case). It defaults to frame if not specified.

When the _formActionUrl parameter is set but no Url is given (i.e. ...&_formActionUrl =&embed=...) the top frame will be closed. It is as if you set Form Action to Close" in the Form Designer.

For example... the share Url with &_formActionUrl=http://www.google.com, will cause the form to display google.com when it's submitted, even if in the Form Designer you had set the Form Action to be "Display Message" or one of the other options.

_cancelUrl

The designer can override the standard message that displays when the user clicks on the Cancel button in a form and redirect them to a webpage of your choice by appending the _cancelUrl=(some Url) to the raw form link. For example, if you want to redirect users to http:www.google.com the raw form link should look like this:

Code Block
https://app.frevvo.com:443/frevvo/web/tn/mycompany/user/f_tom/app/_gaj78BYjEeWyUNZ2H44ezg/formtype/_22gHkKKLEeWnp4XR1Gz4eA?_method=post&embed=true&_cancelUrl=http://www.google.

...

com

The user must click "Yes" for the warning message "Are you sure?" and then will be directed to the specified Url.

Setting _cancelUrl= to blank closes the target window or tab if it was opened by javascript or <a target="new"…/>. Otherwise it will simply show a blank page.