Versions Compared

Key

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

...

  • Embedded Form – This option enables you to embed a form that will be displayed in your website. Simply copy and paste the code into your web page where you want the form to appear.
    Frevvoproduct
    takes care of the rest. This option will render the form on your Web page in its entirety, without requiring users to click scroll bars when using the form.  You cannot control the height nor the width that the form will use on your web page when embedded in this fashion. The length used by the form automatically resizes as repeats are added and sections expanded/collapsed or made visible/invisible. Refer to the Embedded Form/Workflows on Mobile Devices topic for the details regarding mobile devices.
  • Embedded Form Link – This option should be used to embed your form into a Portlet container. 
  • Full Page/Pop Up – This lets users access the form in its own pop-up window so users can complete the form and return to your Web page when they are done. It is intended for desktop only.
  • Link (Email/Web Page) – This lets you add a link to your form on your Web page or simply email the link to the people whom you want to submit your form. 
  • Just the iframe – This is similar to the Embedded Form option but requires you to specify your form’s width and height. In fact the script tag is the same except it has different form Url parameters. For instance Just the iframe option does not contain center=true, so the form will not be centered nor have a border. Using this option, the user may see scroll bars when they use your form if you do not specify a height long enough to contain the form when it is fully expanded. (Remember that your form can "grow" from its initial height if users select repeat items, expand sections that are initially collapsed, and so on.) The height and width are form properties but the height property generally is blank since the form sizes dynamically when you design it. There are a number of freeware tools (for example, MeasureIt) that you can use to measure your form’s height.
  • Raw Form Link – This lets you email a link to the form just as the Link (Email/Web Page) option does, but it is intended for filling out a form collaboratively and requires coordination between the parties filling out the form. The first person can fill out a portion of the form but must make sure '''not''' to submit it. He or she then can copy the URL (which will have been updated to collect the entered data) and mail this updated URL to the next collaborator. When this person accesses the URL, the form will be displayed with the values entered by the previous collaborator. The other difference between this option and the Link (Email/Web Page) option is that this option does not include an iframe border decoration.

...

  1. URLs that do not include a user's id
  2. Backward compatibility for URLs that contain a user's id - they will  continue to work.
  3. A reverse lookup function of the opaque URL that can be used to locate a form/workflow in a user's account for troubleshooting purposes. This capability is only be available to administrators, tenant administrators and users with the designers or publishers roles in the same tenant.

...

Code Block
Tenant: mycompany
User: designer
Project: HR
Form: Invoice
Example 2:


Excerpt

A designer must make changes to a form/workflow in their company space at the request of a co-worker. The requesting employee logs into the company space, selects the form/workflow from the menu and copies the form/workflow instance URL from the browser.  An opaque URL such as the one shown below is emailed to the designer. The designer can't remember what user, app, form/workflow name that opaque url maps to and uses the lookup feature to find the form/workflow they need to fix/enhance.

Code Block
https://staging-app-72.frevvo.com/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/space/mycompany?mi=12&_formTz=America%2FNew_York&locale=en_US,eng_US,eng,en

Paste the opaque URL into your browser. Remove everything after the uuid. Replace it with lookup after the slash. Press the Enter key. Login to the tenant (determined by the tenant name after the /tn in the URL) as an admin, designer or publisher user if presented with the login screen.

Code Block
https://staging-app-72.frevvo.com/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/lookup

The uuid is converted to the user id of the designer who owns the space.

Code Block
https://staging-app-72.frevvo.com/frevvo/web/tn/mycompany/user/designer

Login to the tenant as the specified user and edit the space menu to get the raw form/workflow link. Remove everything after the formtype, flowtype, value in the opaque Raw Form/Workflow link. In the example shown, you would remove all characters starting with the question mark (question).

Code Block
https://staging-app-72.frevvo.com:443/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/app/_ngEekDxNEeWSMvnDVXXIRg/flowtype/_DxUxwZ8eEeScQa8_3O7FuQ?_method=post&embed=true

Add /lookup to get the project and form/workflow name.

Code Block
https://staging-app-72.frevvo.com:443/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/app/_ngEekDxNEeWSMvnDVXXIRg/flowtype/_DxUxwZ8eEeScQa8_3O7FuQ/lookup

The workflow named Example 3 - PO for Sales Review is located in the tenant mycompany, in the designer user account, in the project Purchase Order Completed.

Code Block
User: designer
Application: Purchase Order Completed
Workflow: Example 3 - PO for Sales Review
Note

In versions prior to v9.1 Projects were known as "Applications." The /lookup parameter will still return "Application" as a result populated with the Project name.


Anonymous Access to Public Forms/Workflows in Container Managed Tenants

If you are using a tenant configured for a container security manager and you want to allow anonymous access to your forms/workflows, you must manually add "public" to the link to make forms/workflows accessible to users who are not logged in.  You must do this if you are using any of the URL types in the Share dialog for forms and workflows, using a 

Frevvoproduct
 Space or embedding forms/workflows in your website. The public URL allows the tenant to be secured while public forms can be accessed anonymously, ex: a job application on an external website.   

...

 You will not see the public url listed in the Share light box.  

If you are using a tenant configured for a container security manager and you want to allow anonymous access to your forms/workflows from your website, you must create a public URL.

Browser Session Security

When you create a new form, by default it is marked as Designers/Owner Only. At this time has Access Control marked as Anyone (no login required), meaning anyone that is given the form's URL via any of the form's share choices, has access to use and submit the form. You may change it to Designer/Owner Only, so that the only person who can use the form via any of the form's share choices, is the person logged into this 

Frevvoproduct
account. Once you are ready to let others use your form you can again mark the form as Anyone (no login required). Now anyone that is given the form's URL via any of the form's share choices, has access to use and submit the form.

Designer/Owner Only vs Anyone (No login required) appear to be a binary choice. Either no one has access unless you're logged into the 

Frevvoproduct
account or everyone has access without the need to login. Another way to make the form accessible is to leave the form locked and share it via browser session restricted access. The 
Frevvoproduct
API can generate form URLs that are only valid for the current browser session. The form/workflow URL generated in this way (not via the Share choices) cannot be passed to anyone outside of the session as it will not work

Embedding Forms in Your Website

Frevvoproduct
 can easily be added into your existing web site. The option above in the Share section explains the code you need to copy into your web page and the different ways that the forms can be added to your site.

Image Removed

Embedding Multiple Forms in a Single Web Page

If your web server and 

Frevvoproduct
form server are in the same domain (in-house likely scenario), you are able to embed as many 
Frevvoproduct
forms into each of your .html web pages as you wish. In order to do this you must give each form a unique id. So if you copy the Share code into the web page a 2nd time, you must edit id to make them different from the 1st copy/paste. Id can be any string as long as it is unique.

...

languagejs

...

 

It is important to note that while a logged in user is completing a form, the data from their session URL is visible to any session from the same user@tenant. For example, the user may copy and paste the session URL into a new browser tab where they are still logged in, which would load with the form data. 

Embedding Forms in Your Website

Frevvoproduct
 can easily be added into your existing web site. The option above in the Share section explains the code you need to copy into your web page and the different ways that the forms can be added to your site.

Image Added

Embedding Multiple Forms in a Single Web Page

If your web server and 

Frevvoproduct
form server are in the same domain (in-house likely scenario), you are able to embed as many 
Frevvoproduct
forms into each of your .html web pages as you wish. In order to do this you must give each form a unique id. So if you copy the Share code into the web page a 2nd time, you must edit id to make them different from the 1st copy/paste. Id can be any string as long as it is unique.

Code Block
languagejs
<script xmlns="http://www.w3.org/1999/xhtml"
 src="http://localhost:8082/frevvo/web/tn/mycompany/u/a700f434-969e-432a-9779-655f9fc30259/app/_QDidgGGwEeeZjNWktbplXA/formtype/_ZL1mkIhDEeeRWfMSX8Dr0Q/embed?id=form1&container=false&resize=true"
 type="text/javascript">
</script>

<script xmlns="http://www.w3.org/1999/xhtml"
src="http://localhost:8082/frevvo/web/tn/mycompany/u/a700f434-969e-432a-9779-655f9fc30259/app/_QDidgGGwEeeZjNWktbplXA/formtype/_ZL1mkIhDEeeRWfMSX8Dr0Q/embed?id=form2&container=false&resize=true"
type="text/javascript">
</script>

...

Code Block
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
 <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1">
</head>
<body>

<div><p>Here is a div with some text. How long is this text? It should wrap around to the next line since it is a long enough line</p></div>

<script xmlns xmlns="http://www.w3.org/1999/xhtml"
                    src="http://<server>:<port>/frevvo/web/www.w3.org/1999/xhtmltn/frevvo.com/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/app/_bDd4YX76EduXFsA4l9RQeQ/formtype/_RwO0sMxjEeKp6swhthjzZQ/embed?container=false&amp;center=false&amp;resize=true&amp;border=false"
                    srctype="http://<server>:<port>/frevvo/web/tn/frevvo.com/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/app/_bDd4YX76EduXFsA4l9RQeQ/formtype/_RwO0sMxjEeKp6swhthjzZQ/embed?container=false&amp;center=false&amp;resize=true&amp;border=false"
                    type="text/javascript">
</script>
</body>
</html>text/javascript">
</script>
</body>
</html>

Another option is to leave the form in the frame. If no URL parameter is specified, the form will automatically resize based on the device it is viewed on. If the web designer wants the form to always be full-width, they can specify _device=desktop in the share embed URL. The web site designer might have a mobile web site where tablet and phone users would access the forms where the share URL would leave off the  "_device=" parameter. www.frevvo.com is an example of forms embedded into a website that look great on all devices.

Unsaved Changes Warning Message

...

The unsaved changes warning feature is not supported on iOS Safari and only partially supported on Chrome Android. You may notice some inconsistencies with workflows. Refer to the Unsaved Changes topic for the details.

This feature is not configured in the frevvo Cloud. In-house customers can turn on the Unsaved Changes Warning feature with the frevvo.unsaved.warning property.

...

To turn off the unsaved warning feature for a particular form/workflow instance, add the  _unsavedWarning=true/false URL parameter to the Share URL. Remember to add the ? at the end of the URL if this is the first URL parameter you are adding and the & at the end of the URL if there are other URL parameters already appended to the URL.

...

In-house customers can turn on the Unsaved Data feature by adding the the frevvo.unsaved.warning property to the frevvo-config.properties file. Appending the _unsavedWarning URL parameter to a form/workflow overrides the value set in this configuration property.

 


Add to Anti-Banner

...

 

...