Groups XML file (groups.xml)

The groups.xml group file where groups are defined is available by default. It needs to be introduced to the permission service configuration file service.ini by using the NAME.path parameter and can be edited in FirstSpirit ServerMonitoring (see Configuring a service").

It is recommended that you create a file using a script to reduce the probability of errors.

The following is the default configuration of the groups.xml file:

<?xml version="1.0" encoding="ISO-8859-1" ?>
          <GROUPS name="GroupsFile" version="1">
                      <GROUP id="2" name="Anonyme Besucher"/>
                      <GROUP id="3" name="Registrierte Mitglieder"/>
                      <GROUP id="4" name="Kunden"/>
</GROUPS>

The name of the group definition can be assigned in the name attribute for the root element of the GROUPS group definition. In addition, the optional version attribute can be specified to record the respective group definition version number.

Within GROUPS any number of differently nested GROUP elements can be specified, where there is one group for each GROUP element. Each GROUP element requires the name attribute (name of group). The optional id attribute (group ID) can also be specified. This ID is required in order to be able to assign permissions to a group in an input component. If a group does not have an ID, it will be displayed in the input component without a node where permissions are set.

The following is an example of configuration without the id attribute for the “Customers” group:

<?xml version="1.0" encoding="ISO-8859-1" ?>
                      <GROUPS name="GroupsFile" version="1">
                      <GROUP id="2" name="Anonyme Besucher"/>
                      <GROUP id="3" name="Registrierte Mitglieder"/>
                      <GROUP name="Kunden"/>
</GROUPS>

Display in SiteArchitect:

The selectable parameter is used to specify whether a group in the input component is to be selectable or not. The values 1 (selectable) or 0 (not selectable) are passed. If no ID was assigned using the id parameter, then entering selectable="1" is not permitted.

In the case of GROUPS and GROUP elements, the timestamp (creation time stamp) attribute can also be specified.