Folders

Within Folders you can organize your contents, therefore it is possible to create folders on different levels of the explorer tree. You can create folders...

... to namespaces.
... to other folders.

Adding a Folder

Since you can create folders within namespaces and in other folders, the option Add Folder is available from the context menu of both elements:

Enter a name for the folder in the pop-up window Create New Folder. Click Save:

Restrictions on Element Names

The only restriction for folder names is that they must not be empty. To all other elements in the Explorer, the following name restrictions apply:

Element names...

... must not be empty.
... must not contain spaces.
... must not start with numbers.
... must not end with a period (.).
... must not contain any special characters.
In addition, there are some system-relevant strings that cannot be used, e.g. CON, AUX, NUL etc.

If the name you enter violates these restrictions, the field in the editor turns red and cannot be saved.

The new folder is created and displayed in the tree:

The Folder Context Menu

Right click a folder to open its context menu:

The context menu displays all options available for a folder:

Adding a Service

Add a service to manage the necessary settings for your microservice. A service can only be created in folders. To add a service to a folder, right click on the folder and select option Add > Service from the context menu:

Enter a name for the service in the pop-up window Create New Service. Click Save:

If you want to deploy the service to a container later, please note that on container deployment the service name is automatically changed according to certain rules.

Naming of Services for Container Deployment

Example:
Service Name: Janes_First_Service
Container Name: janes-first-service

The two services in this example would get the same container name...
... so they would overwrite each other.

Restrictions on Element Names

The only restriction for folder names is that they must not be empty.
To all other elements in the Explorer, the following name restrictions apply:

Element names...

... must not be empty.
... must not contain spaces.
... must not start with numbers.
... must not end with a period (.).
... must not contain one of the following characters: <, >, :, ", /, \, |, ?, *
Furthermore, the following strings must not be used as element names: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9.

Your input is validated. You can only save a valid element name:

The new service is created and displayed in the tree:

To open a service, click on the service name in the explorer tree.

The service tab will open.
The service details will be displayed on the right side of the tree.

To access the service, click on the the explorer tab icon or on the service details area to close the explorer tab. Refer to Service Panel for further information.

Cutting and Pasting

If you want to use an element at a different position in the tree, select the context menu option Cut:

Open the context menu of the element in which you want to insert the cut element and select Paste:

Option Paste is only enabled if the elements to be inserted fit into the tree hierarchy. Pasting elements is only possible in the same namespace.

The element is now displayed on its new place in the tree:

Exporting and Importing

You can export and import folders from and to the Explorer tree. For detailed information see page Exporting and Importing Explorer Contents.

Managing the Folder Permissions

You can set access restrictions on several levels:

On a namespace:
Namespace permission can be set in the User Management. These permissions have the highest priority. If a namespace with e.g. read-only permissions is assigned to the user in the User Management, You cannot override this permission in the Designer. For further information refer to the Administration Guide.
On a folder:
Folder permissions affect all sub-elements of the folder, but you can assign permissions to a service within the folder independently.
On a service:
Service permissions only affect the corresponding service.

Select Permissions from the context menu if you want to manage the access to a folder:

In the pop-up window Permission Administration you can invite single colleagues or whole groups to access the element. By default, the creator of the element and everyone sharing the current namespace has write permissions:

To limit access to the element you can remove the group Everyone completely, or give it read-only permission.
If you want to restore permissions for Everyone,

select option Invite Group,
search for group Everyone and add it again.

If you want to add other users, first select one of the options:

Invite Group: Allow whole user groups to access your element. Available groups are all distribution lists that have been created as a Role in the user management.
Invite People: Add single users to your element and grant them read or write permission.

Refer to Managing Roles in the Administration Guide for detailed information about roles.

Enter the name or email address of the group or person to the search field. Matching results are shown in a list. Select the entry you want to use:

Use option Add Person to add the selected user or group:

Once the user or group has been added, you can specify whether the user or the group should have read or write permission. Save your changes:

Sharing a Folder

You can also share the link for a folder. Select Share from the context menu to copy the link of the folder to the clipboard:

The action is confirmed by a toast message:

You are now able to paste the URL, for example to an email:

Renaming the Folder

If you want to change the name of a folder, select Rename:

Enter the new name in the pop-up window Edit Folder. Click Save:

The new name is displayed in the tree:

Deleting a Folder

To remove a folder from the tree, open its context menu and select Delete:

Confirm the security prompt in the pop-up window with Yes to delete the folder from the tree:

Please note that all contents of the folder are also deleted.

Related Pages: