Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
As forms are used, the values entered into form fields are cached on the  Server until the form is submitted or until the user's session times out. Each time you navigate a browser to a form URL, for example the URL you can copy/paste into a browser from the Email/Web Page share choice, you will see a blank form. That is, the form fields will be blank if you left them blank when you were designing the form in the Form Designer, or will have any default values you entered into the Form Designer. Also the form fields may contain values from your back-end systems if you used the Advanced Document URI feature or from a business rule triggered by either the form.load or form.activate conditions.

If you close your browser window/tab and again open the form via the share URL, you will again get a blank form.

Column
width300px

On this page:

Table of Contents
maxLevel3

...

Code Block
OLD SPACE URL: http(s)://<server>:<port>/frevvo/web/tn/mycompany/user/designer/space/mycompany 
NEW SPACE URL: http(s)://<server:port>/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/space/mycompany

ExcerptThe opaque URL  can be used to determine the  designer account where a form/flow is located. This "lookup" feature resolves the uuid to a user's id and can be very helpful when troubleshooting. The "lookup" feature is only available to tenant admins, users with the designer/publisher role or the designer/owner of the form/flow

The "lookup" feature works with:

  • Type URLs - URLs that include formtype or flowtype in the path - Form/flow Share URLs
  • URLs that include the form or flow id in the path
  • Instance URLs - browse the Share URL and hit enter

In all cases, follow these steps:

  1. Browse the opaque Share or instance URL
  2. Remove everything in the URL after the formtype, flowtype, form or flow id path segments
  3. Append /lookup to the end of the URL
Example 1:

A user receives an email that includes an opaque URL to a form/flow as shown below. The user reports an issue with the form/flow and requests that the designer investigate. The designer must locate the account where the form/flow is located.

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

Paste the opaque URL into your browser. Remove popupform from the URL and replace it with lookup after the slash.

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

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.

The following information about the form/flow display in the browser:

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

A designer must make changes to a form/flow in their company space at the request of a co-worker. The requesting employee logs into the company space, selects the form/flow from the menu and copies the form/flow 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/flow name that opaque url maps to and uses the lookup feature to find the form/flow 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/flow link. Remove everything after the formtype, flowtype, value in the opaque Raw Form/flow 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 application and form/flow 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 application Purchase Order Completed.

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

Anonymous Access to Public Forms/Flows in Container Managed Tenants  

...

Private vs public appear to be a binary choice. Either no one has access unless you're logged into the  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  API can generate form Urls that are only valid for the current browser session. The form Url generated in this way (not via the Share choices) cannot be passed to anyone outside of the session as it will not work.

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

...

Data loss is possible if users filling in a lot of data in a long forms/flows close the browser ot tab without saving or submitting. Users are now If the Unsaved Changes Warning feature is configured, users will be warned of this situation before the data loss. This applies to use-mode forms and flows only, not edit mode. The warning only shows if there have been changes made to the form/flow. If there are no changes, then no warning is displayed. If the form/flow is Saved or the Save on Navigate feature is configured for a flow, then changes are saved and the warning is not produced on any attempt to close the browser.

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 off on the Unsaved Changes Warning feature with the frevvo.unsaved.warning property.

The warning behavior message is browser specific. The messages for Firefox, Chrome and Microsoft Edge are shown below:

...

The Unsaved Data Warning will appear when performing a task from the Task List. For example,if you change some data and then click the Inbox icon

Turn on/off the Unsaved Changes feature for a form or flow instance

To turn off the unsaved warning feature for a particular form/flow 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 off 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/flow overrides the value set in this configuration property. 


 

...