Spaces

This documentation is for frevvo v10.1. Not for you? Earlier documentation is available too.

Spaces

A frevvo space is a web site that organizes and displays projects, forms, workflows, tasks, etc. A space has a tab for each project, and each tab has a drop-down list of the deployed forms/workflows in that project. Forms/workflows with a visibility of public in tenant or private appear when the user logs into frevvo. When you click on a form or workflow name, the space opens the form in the page. A space also has a home panel and two optional panels at the left and at the bottom of its page. You can edit the content of any of these panels; you can also choose not to include the optional panels. You can apply a style to a space as you do to forms/workflows. The selected style will be propagated to forms, workflows and the Task List.

Spaces can be used to simplify accessing forms/workflows/Task List from your iPhone or iPad. You can add thumbnail icons to your forms and workflows and the space will display on mobile devices.



Each designer user in a frevvo tenant can create, edit, and delete his or her own spaces. You can share the URL to a space with others inside or outside your organization.

If you share a space, you are essentially creating a website — anyone who has the URL can view the space. Whether or not someone can actually open a form or workflow and use it depends on the Visibility property of the form. A form or workflow must be Public for anyone to use it. An outside user will be blocked if he attempts to open a non-public form, and may even lose his session credentials with the space. Forms/workflows must be deployed to production for them to automatically appear in an project tab menu. If the visibility of a form is restricted to a specific role via the ACL feature, the form/workflow will not appear on the space menu unless the logged in user has been assigned that role or they are the designer. 

  A form action display message formatted using html tags will not work like they do in your own customer web site. XHTML in the display message is currently unsupported in frevvo spaces.

Notice the First and Last Names of the logged in user appear in the upper right corner.

Create a New Space

When you create a space, frevvo creates a tab on the space for each of your projects and also adds Task List, My Account, Shared Items, Home and Login/Logout tabs. Refer to the Space Content topic. The project tabs display a list all of all currently deployed forms/workflows in that project; undeployed forms and workflows are not included. For testing purposes, forms/workflows with a visibility setting of private are added to the space menu if the user is logged in as a designer. A form/workflow with a visibility set to "Authenticated Users (login required)" cannot be accessed unless the user logs in to the frevvo tenant. If the visibility of a form/workflow is restricted to a specific role via the ACL feature, the form/workflow and it's associated tab will not appear on the space menu unless the logged in user has been assigned that role or they are the designer. If a project has no forms/workflows, frevvo doesn't create a tab for it. 

You create a new space from the spaces home page.

  1. Log in as the designer, and then click on Spaces.

  2. Click

    Add to create a new space, enter a Space ID. The Space ID must be unique, start with a letter, cannot contain spaces or special characters and cannot exceed 16 characters. Non-ascii characters are not supported in a space id.

  3. Enter a Space Name - this name will display in the top right section of the space. The Space Name should not exceed 50 characters but you can type spaces here.

  4. Click Create.



  5. frevvo will bring you directly to the Space Designer where you can begin editing your space. The new space is also added to the list on the Spaces home page. 

The spaces home page lists any spaces that you've already created. On this page, you can:

  • Click 

     Add to create a new space.

  •  Sort the space list alphabetically (A-Z or Z-A)

  • Use the 

     Action menu:

  •  Edit edit a space. You can also go directly to the space editor by clicking the name of the space.

  •  Test a space.

  •  Share a space. 

  •  Delete an existing space.


The space will not automatically pick up changes such as newly deployed forms/workflows.

If you add or remove projects or add or remove forms or workflows from projects, and you want to update the space that contains them, a quick way to do that is to delete the old space and create a new one. You can use the same name as the original space. The new space will contain all your current projects and all deployed forms and workflows. Customization made to the space, such as adding your logo or HTML, will have to be redone. If you do not want to redo your customization, EdittheTabMenus manually.

Relative URLs

Menu items are created using URLs relative to the project root, i.e. /frevvo/web/… The use of Relative URLs can help avoid issues that might be cause by hardcoded hosts, protocols (http vs https) and ports and improves portability. It is the recommended best practice to use Relative URLs when adding a tab and forms/workflows to the menu.

When you create a new space, you will see:

Relative URls
* Important Items ** Task List|/frevvo/web/tn/mycompany/subject/(subject.id)/tasks?embed=true ** My Account|/frevvo/web/tn/mycompany/subject/(subject.id)/profile?embed=true&edit=true ** Shared Items|/frevvo/web/tn/mycompany/subject/(subject.id)/shared?embed=true&hidenav=true *HR ** Expense Report|/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/space/v73space/home?embed=true

instead of

Hardcoded URLs
Important Items ** Task List|https://app.frevvo.com:443/frevvo/web/tn/mycompany/subject/{subject.id}/tasks?embed=true ** My Account|https://app.frevvo.com:443/frevvo/web/tn/mycompany/subject/{subject.id}/profile?embed=true&edit=true ** Shared Items|https://app.frevvo.com:443/frevvo/web/tn/mycompany/subject/{subject.id}/shared?embed=true&hidenav=true * HR ** Expense Report|https://app.frevvo.com:443/frevvo/web/tn/mycompany/u/8aa27da6-4bef-427c-92e3-6ad8d58e506a/space/mycompany/home?embed=true

You may also notice that Share links for the Important items now show parenthesis instead of curly braces. You will see the parentheses in any newly created space. Tomcat 8.5 doesn't allow curly braces in URLs since they are not valid URL chars and deemed a security vulnerability. frevvo currently supports parenthesis as well as curly braces, however, support for curly braces {} will be dropped in a future release. Use parenthesis () moving forward.

Edit a Space

Click 

 Edit (or click on the name of the space) to display the space editor. The editor displays your space as it will appear if you share it with others. The editor also includes a Properties panel at the left of the space, a toolbar at the top with
Finish and 
 Cancel icons, and editing tools you can use for the three panels in the body of the space, the logo area, and the project and Task List tabs.

Edit Space Properties

Use the Properties panel to edit the space Name, choose a different Width, or apply a style to the space. If you change any of the properties, frevvo refreshes the space so you can see your changes.

When calculating the width of your space, consider the width of your forms plus the added space needed to fully display your forms when performing a task from the Task List. Showing/Hiding the left panel may also be a factor.

Show/Hide the Login/Logout Link

It is possible to hide the login/logout link in a space. You may want to do this if your users are accessing a frevvo space through your own portal using your own authentication system and the login/logout function is handled external to frevvo.

The Login link checkbox is checked by default so when you create a new space the login link is visible. To hide it, uncheck the Login link checkbox. 

The Login link will be checked when migrating Spaces from previous versions of frevvo.

The Login/logout link is not relevant for tenants configured to use SSO. Spaces in tenants using the SAML or Azure SAML Security managers do not display the login/logout link.

Edit the Panels and Logo

You can edit all three panels in your space, and you can show or hide the left panel and bottom panel. You can also remove or replace the logo. The logo filename can contain up to 50 characters.

  • Click

    to edit a panel, upload a graphic file to use as a logo, or to edit the project tabs.

  • Click 

    to remove the logo.

  • Click

    to either hide or show the left and bottom panels. When hidden, the editor displays the panels grayed out.