Each user in a  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 flow and use it depends on the Visibility property of the form. A form or flow 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/flows must be deployed to production for them to automatically appear in an application tab menu. If the visibility of a form is restricted to a specific role via the ACL feature, the form/flow will not appear on the space menu unless the logged in user has been assigned that role or they are the designer. 

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

Image Removed

Create a New Space

When you create a space,  creates a tab on the space for each of your applications — and also adds Task List and Login/logout tabs. The application tabs display a list all of the public and deployed forms/flows in that application; undeployed forms and flows are not included. For testing purposes, forms/flows with a visibiility setting of private are added to the space menu if the user is logged in as a designer. If the visibility of a form/flow is restricted to a specific role via the ACL feature, the form/flow 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 an application has no forms/flows,  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 Image Removed 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 16 characters but you can type spaces here.
4. Click Create.

Image Removed

The new space is added to the list. 

Image Removed

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

• Click Image Removed to create a new space.
• Click Image Removed to delete an existing space.
• Click Image Removed to edit a space.
• Click Image Removed to test a space. 
• Click Image Removedo to share a space. 

Edit a Space

Click Image Removed to display your space in 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 Image Removed Finish and Image Removed Cancel icons, and editing tools you can use for the three panels in the body of the space, the logo area, and the application and Task List tabs.

Image Removed 

Edit Space Properties

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

Image Removed

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 Image Removed to edit a panel, upload a graphic file to use as a logo, or to edit the application tabs.
• Click Image Removed to remove the logo.
• Click Image Removed to either hide or show the left and bottom panels. When hidden, the editor displays the panels grayed out.

When you edit a panel,  displays its contents. You can add your own content and format it using HTML tags. 

Image Removed

To replace the logo, browse for the graphic file you want. Click the Image Removed Finish icon when you're done.

Edit the Tab Menus

Click Image Removed to edit the application tabs. You can use the editor shown below to add, delete, or rearrange the tabs in your space, and add or remove forms or flows from the drop-down tab menus. The editor uses this format:

• Text that begins with a single asterisk is a tab name — * Human Resources is a tab name.
• Text that begins with two asterisks is a form or flow name — ** Expense Statement is a form or flow name.

Image Removed

To add a new tab, type its name and begin it with a single asterisk. Use two asterisks for a form or flow name. Notice that a form or flow name is followed by a URL that identifies it. For example, the full entry for the Human Resources > Expense Statement form in this example is:

** Expense Statement|http://192.168.1.68:8082/frevvo/web/tn/rap.com/user/Jack/app/_N4cF4ZuwEeCwk5wyBHqHrQ/flowtype/_g6-MkJu5EeCwk5wyBHqHrQ?_method=post&embed=true

To add a form or flow name to a tab, you'll need its URL. Follow these steps:

1. On the applications home page, click Image Removed !edit to edit the application that contains the form or flow you want to add.
2. Click the Image Removed button to open the Share Form panel for the form you want.
3. Click Raw form link to display the raw URL.
4. Copy the URL, then in the tab editor, type a | character after the form name. Paste the form's URL after it.
5. Click Finish to update the tab menus.

Image Removed

Forms/Flows displayed on the Space menu will only show the forms/flows which the logged in user is authorized to view. 

If you are using a tenant configured for a container security manager and you want to allow anonymous access to your forms/flows, you must add a public URL to your space menu.

Test a Space

Click Image Removed to test a space. The space is displayed as it will look to anyone you gave its URL to. If a user has the correct credentials, he can fill out and submit forms and flows. Close the window when you're done testing.

Image Removed

Share a Space

Click Image Removed to share a space.  displays your space's URL — this is the link you distribute to those who you want to view your space. Remember, whether or not someone can actually open a form or flow and use it depends on the /wiki/spaces/frevvo52/pages/683376679 property of the form.

Image Removed

You may use either an http or https Space URL. However if you use https to access the Space then all the forms/flows in the space must also have https URLs. And if you use http to access the Space then all the forms/flows must all have http URLs. Spaces do not support a mix of http and https.

Space Content

Spaces can contain any content the designer wants to add. The most common content is:

• Tabs for each application
• Menu items to access forms and workflows
• A Task List Tab - automatically provided when you create the space.
• A Login/Logout Tab - automatically provided when you create the space.
• Form/Flow Submissions.
• Home Link
• Anonymous signup form

Adding Form/Flow Submissions to the Space Menu

Spaces can also contain form submissions. Copy/Paste the Shared Item URL and append the URL paramenter ?embed=true&hidenav=true. Here is a tab menu item link for Shared Items:

Shared Items| http://your server:port/frevvo/web/tn/your tenant name/subject/{subject.id}/shared?embed=true&hidenav=true

This works best on the desktop as mobile browsers will not be able to open and view submissions. Remember, the logged in user must have permission to view/edit submissions for your forms/flow. The designer configures these permissions using the Access Control wizard.  

If a user is not authenticated to view the form/flow submissions, then the error message "Access Denied. Authentication Required." will display.   

Adding a Home link to the Space Menu

You can add a link to the Home page of your space as a menu item. Users click on this link to return to the home page of the space. For example, you can add the home link to the Important Items tab by following these steps:

1. Edit the space menu. 

2. Add the home link using the syntax shown - change the url to specify your server name, port, tenant id, user id and space id. The ending portion after your space id must be /home?embed=true   

   Code Block
   ** Home|http://your server:8082/frevvo/web/tn/your tenant/user/your user/space/your space id/home?embed=true

3. To add it as a tab, precede the word Home with one asterisk instead of 2. 

4. To add it as a selection under the Important Items tab, precede the url with 2 asterisks and place it in the menu under the * Important Items entry. 

   Code Block
   * Important Items ** Task List|http://localhost:8082/frevvo/web/tn/doctenant/subject/{subject.id}/tasks?embed=true ** Home|http://localhost:8082/frevvo/web/tn/doctenant/user/designer/space/mycompany/home?embed=true

5. Save your changes.  

Adding an Anonymous Signup form link to the Space Menu 

You can add the URL to an anonymous signup form for your tenant. Users can create a user account in your tenant using this published registration url. The  designer does not have to create the form, the url shown below accesses the Add User Anonymous Register form included with . When thsi form is submitted, the user receives an activation email which enables the account.  

You must check Anonymous Users in your tenant to take advantage of this feature. Also, there is an invisible control on this form which requires the tenant name. The form will not submit if this field is left blank. Append _data parameter to initialize the control with your tenant name: 

...

Each user in a  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 flow and use it depends on the Visibility property of the form. A form or flow 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/flows must be deployed to production for them to automatically appear in an application tab menu. If the visibility of a form is restricted to a specific role via the ACL feature, the form/flow will not appear on the space menu unless the logged in user has been assigned that role or they are the designer. 

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

Image Added

Create a New Space

When you create a space,  creates a tab on the space for each of your applications — and also adds Task List and Login/logout tabs. The application tabs display a list all of the public and deployed forms/flows in that application; undeployed forms and flows are not included. For testing purposes, forms/flows with a visibiility setting of private are added to the space menu if the user is logged in as a designer. If the visibility of a form/flow is restricted to a specific role via the ACL feature, the form/flow 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 an application has no forms/flows,  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 Image Added 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 16 characters but you can type spaces here.
4. Click Create.

Image Added

The new space is added to the list. 

Image Added

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

• Click Image Added to create a new space.
• Click Image Added to delete an existing space.
• Click Image Added to edit a space.
• Click Image Added to test a space. 
• Click Image Addedo to share a space. 

Edit a Space

Click Image Added to display your space in 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 Image Added Finish and Image Added Cancel icons, and editing tools you can use for the three panels in the body of the space, the logo area, and the application and Task List tabs.

Image Added 

Edit Space Properties

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

Image Added

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 Image Added to edit a panel, upload a graphic file to use as a logo, or to edit the application tabs.
• Click Image Added to remove the logo.
• Click Image Added to either hide or show the left and bottom panels. When hidden, the editor displays the panels grayed out.

When you edit a panel,  displays its contents. You can add your own content and format it using HTML tags. 

Image Added

To replace the logo, browse for the graphic file you want. Click the Image Added Finish icon when you're done.

Edit the Tab Menus

Click Image Added to edit the application tabs. You can use the editor shown below to add, delete, or rearrange the tabs in your space, and add or remove forms or flows from the drop-down tab menus. The editor uses this format:

• Text that begins with a single asterisk is a tab name — * Human Resources is a tab name.
• Text that begins with two asterisks is a form or flow name — ** Expense Statement is a form or flow name.

Image Added

To add a new tab, type its name and begin it with a single asterisk. Use two asterisks for a form or flow name. Notice that a form or flow name is followed by a URL that identifies it. For example, the full entry for the Human Resources > Expense Statement form in this example is:

** Expense Statement|http://192.168.1.68:8082/frevvo/web/tn/rap.com/user/Jack/app/_N4cF4ZuwEeCwk5wyBHqHrQ/flowtype/_g6-MkJu5EeCwk5wyBHqHrQ?_method=post&embed=true

To add a form or flow name to a tab, you'll need its URL. Follow these steps:

1. On the applications home page, click Image Added !edit to edit the application that contains the form or flow you want to add.
2. Click the Image Added button to open the Share Form panel for the form you want.
3. Click Raw form link to display the raw URL.
4. Copy the URL, then in the tab editor, type a | character after the form name. Paste the form's URL after it.
5. Click Finish to update the tab menus.

Image Added

Forms/Flows displayed on the Space menu will only show the forms/flows which the logged in user is authorized to view. 

If you are using a tenant configured for a container security manager and you want to allow anonymous access to your forms/flows, you must add a public URL to your space menu.

Test a Space

Click Image Added to test a space. The space is displayed as it will look to anyone you gave its URL to. If a user has the correct credentials, he can fill out and submit forms and flows. Close the window when you're done testing.

Image Added

Share a Space

Click Image Added to share a space.  displays your space's URL — this is the link you distribute to those who you want to view your space. Remember, whether or not someone can actually open a form or flow and use it depends on the /wiki/spaces/frevvo52/pages/683376679 property of the form.

Image Added

You may use either an http or https Space URL. However if you use https to access the Space then all the forms/flows in the space must also have https URLs. And if you use http to access the Space then all the forms/flows must all have http URLs. Spaces do not support a mix of http and https.

Space Content

Spaces can contain any content the designer wants to add. The most common content is:

• Tabs for each application
• Menu items to access forms and workflows
• A Task List Tab - automatically provided when you create the space.
• A Login/Logout Tab - automatically provided when you create the space.
• Form/Flow Submissions.
• Home Link
• Anonymous signup form

Adding Form/Flow Submissions to the Space Menu

Spaces can also contain form submissions. Copy/Paste the Shared Item URL and append the URL paramenter ?embed=true&hidenav=true. Here is a tab menu item link for Shared Items:

Shared Items| http://your server:port/frevvo/web/tn/your tenant name/subject/{subject.id}/shared?embed=true&hidenav=true

This works best on the desktop as mobile browsers will not be able to open and view submissions. Remember, the logged in user must have permission to view/edit submissions for your forms/flow. The designer configures these permissions using the Access Control wizard.  

If a user is not authenticated to view the form/flow submissions, then the error message "Access Denied. Authentication Required." will display.   

Adding a Home link to the Space Menu

You can add a link to the Home page of your space as a menu item. Users click on this link to return to the home page of the space. For example, you can add the home link to the Important Items tab by following these steps:

1. Edit the space menu. 
2. Click Image Added to edit the space menu. 

3. Add the home link using the syntax shown - change the url to specify your server name, port, tenant id, user id and space id. The ending portion after your space id must be /home?embed=true   

   Code Block
   ** Home|http://your server:8082/frevvo/web/tn/your tenant/user/your user/space/your space id/home?embed=true

4. To add it as a tab, precede the word Home with one asterisk instead of 2. 

5. To add it as a selection under the Important Items tab ( or a different tab), precede the url with 2 asterisks and place it in the menu under the * Important Items entry. 

   Code Block
   * Important Items ** Task List|http://localhost:8082/frevvo/web/tn/doctenant/subject/{subject.id}/tasks?embed=true ** Home|http://localhost:8082/frevvo/web/tn/doctenant/user/designer/space/mycompany/home?embed=true

6. Save your changes.  

Adding an Anonymous Signup form link to the Space Menu 

You can add the URL to an anonymous signup form for your tenant. Users can create a user account in your tenant using this published registration url. The  designer does not have to create the form, the url shown below accesses the Add User Anonymous Register form included with . When thsi form is submitted, the user receives an activation email which enables the account.  

You must check Anonymous Users in your tenant to take advantage of this feature. Also, there is an invisible control on this form which requires the tenant name. The form will not submit if this field is left blank. Append _data parameter to initialize the control with your tenant name: 

Cloud Customer:

If you are a  cloud customer, follow these steps to add the Anonymous Signup form to your space menu:

1. Edit the space menu. 
2. Click Image Added to edit the space menu. 
3. Add the url shown below under the menu Tab where you would like the form to be displayed - remember to provide your tenant name in the _data parameter. 

** Signup|https://app.frevvo.com/frevvo/web/tn/d/user/frevvo/app/_bDd4YX76EduXFsA4l9RQeQ/formtype/_NQascBXoEd-Cn_oBMDPlNQ?_method=post&embed=true&_data=(Tenant:"<your tenant name>")

     4. To add it as a tab, precede the word Home with one asterisk instead of 2. 

     5. To add it as a selection under the Important Items tab, precede the url with 2 asterisks and place it in the menu under the * Important Items entry. 

     6. Save your changes.

In-house Customer:

If you are a  in-house customer, follow these steps to add the Anonymous Signup form to your space menu:

1. Edit the space menu. 
2. Click Image Added to edit the space menu. 
3. Add the url shown below - remember to provide your  server and port information and your tenant name in the _data parameter. 

** Signup|http://<your frevvo server host:port>/frevvo/web/tn/d/user/admin/app/_bDd4YX76EduXFsA4l9RQeQ/formtype/_NQascBXoEd-Cn_oBMDPlNQ?_method=post&embed=true&_data=(Tenant:"<your tenant name>")

      4. To add it as a tab, precede the word Home with one asterisk instead of 2. 

      5. To add it as a selection under the Important Items tab, precede the url with 2 asterisks and place it in the menu under the * Important Items entry. 

     6. Save your changes. 

Locale Preference for Spaces

Space URLs, appended with a locale parameter,  take precedence over locales appended to individual forms/flows in the space. As expected, As expected, if no locale parameter for the space is found, the browser setting is used.

Spaces and Mobile Devices

You do not have to use Spaces to access your mobile forms but it is a convenient way to do so. Simply bookmark the space URL on your mobile device to access it. You can add icons to your forms and flows which will display on mobile devices when you access the space. Spaces can be a valuable tool for testing your forms/flow on the iPhone and iPad. Refer to the Employee On Boarding  /wiki/spaces/frevvo52/pages/683376752 for more information on Spaces and mobile forms design. 

...