Folder

A folder is a logical container that can be used to separate components into logical units.

Example XML code
<folder 
  name="myFolder">     
  <!-- Here comes content -->
</folder>

Attributes

A folder must have a name. It does not have other attributes.

name

The name of the component. Other components use this name to reference the component.

Children

A folder can have permission grants, and various mix components inside.

grant

Use the grant child element on the folder to specify the access rights to it.

<folder name="myFolder">
  <grant 
    to="foo@bar.com" 
    permission="rwx"/>
  <grant 
    to="*" 
    permission="r"/>
  ...
  <mix name="myMix">
    <grant 
      to="*@bar.com" 
      permission="rx"/>
    <grant 
      to="bar@bar.com" 
      permission="none"/>
    ...
  </mix>
  ...
</folder>

to

Specifies the user or user group, who you want to give access to.

Table 1. Attribute values
Value Description
* Matches any user.
*@* Matches any user known to SPARKL.
*@foo.com Matches any user in the domain @foo.com.
bar@foo.com Matches the signed-in user bar@foo.com.

permission

Specifies the type of access you want to give.

Table 2. Attribute values
Value Description
none The specified user or user group has no access rights.
Note: This is the default value a folder or mix folder has, if no other is specified.
x The specified user or user group has execute right.
w The specified user or user group has write right.
r The specified user or user group has read right.
wx The specified user or user group has write and execute rights.
rx The specified user or user group has read and execute rights.
rw The specified user or user group has read and write rights.
rwx The specified user or user group has read, write and execute rights.
Note: Every user has full access to everything within his own configuration tree.