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.

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  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.

The new space is added to the list. 

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

• Click  to create a new space.
• Click  to delete an existing space.
• Click  to edit a space.
• Click  to test a space. 
• Click o to share a space. 

Edit a Space

Click  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  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 application and Task List tabs.

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.

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 application 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.

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

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

Edit the Tab Menus

Click  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.

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  !edit to edit the application that contains the form or flow you want to add.
2. Click the  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.

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  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.

Share a Space

Click  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.

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. For example, you can add the home link to the Important Items tab. Users click on this link to return to the home page of the space. Follow these steps to ad

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 must be /home?embed=true   

   ** 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 title with one asterisk. 

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

   * 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.  

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. 

Of course, you can still embed your forms and flows in your own internet.