The Schema Management interface consists of three main components as shown below in Figure 1. Click on a colored area for a description of the respective view.

The three major window areas are as follows:

• Project View: Shows the different projects and schemas on a tree view.

• Editor View: Shows the schema, attribute and object class editors, organized in tabs.

• Log View: Shows the application log.

These views can be minimized or maximized with the two icons in the upper right corner of each view.

The Project View is the main entry point of the graphical interface. It provides contextual menus for creating and deleting schemas within a project, and creating and deleting object classes and attributes within a schema.

The Project View displays the information about the projects and schemas in an hierarchical way. Projects are the main containers for schemas. Therefore, schemas can only exist in the context of a project. All data within a schema (that is, objects and attributes) are visible to all schemas in the project. This means that attributes defined in one schema can be used in other schemas as well.

For more information about the projects, see Managing Projects.

Editors provide the actual graphical interface for modifying specific data. As a general rule, data is not actually modified until saved.

The view contains three different editors:

• The Schema Editor (see Schema Editor).

• The Attribute Editor (see Attribute Editor)

• The Object Class Editor (see Object Class Editor).

All editors are shown in a new tab in the Editor View when they are opened.

The Log View (shown in Figure 8 below) provides information about the progress of the operations performed in the Schema Management GUI. The Log View shows messages only with severity equal or above the defined log level (see Running the Application for more information).

The Log View displays the following information about every event:

• "Level": The related severity level of the event (DEBUG, INFO, WARNING, ERROR or FATAL).

• "Message": The description of the event.

• "Date": The date and time of logging the event.

The icons in the upper right side of the Log View window allow performing the following actions (from left to right):

• Save ( ): Saves the log messages to a file. A file browser opens to browse the location of the log file. This option saves only the messages listed in the Log View window.

• Clear ( ): Clears all messages in the list. After executing this action, the deleted messages are not included in the log file created with the Save option.

• Change log properties ( ): Allows to change the number of messages stored in the Log View. The minimum and maximum values are 1 and 1.000.000, respectively.

• Minimize ( ): Minimizes the Log View window.

• Maximize ( ): Maximizes the Log View window.

Use the Search textbox at the top of the log message list to search for specific messages in the log list. When something is typed in the textbox, the messages containing the typed text are listed.

Log messages can also be hidden: to do so, right-click on the header of the columns, and uncheck the log levels, messages, or dates to hide.

To create a new project, right-click on the Project View, and select the New > Project command from the shortcut menu. Alternatively, select the same command from the application menu. After that, a wizard window is shown as seen in Figure 9 below.

The wizard allows to specify the project name and location. By default, the new project is stored in a folder named workspace, located in the launching directory of the Schema Management GUI. After clicking the Finish button, a new folder is created in the specified location, and the project is shown in the Project View as an open project. Only one project can be opened at a time, so other projects and the editors open for them will be closed.

Perform one of the following steps to delete an existing project:

• Right-click on it in the Project View, and select the Delete command from the shortcut menu.

• Select the project to delete in the Project View, then select the Edit > Delete command from the application menu.

• Select the project to delete in the Project View, then click on the Delete button of the toolbar.

If any of the above steps is performed, a pop-up window appears as shown in Figure 10, asking to confirm the operation.

To create a new schema, open the project where the schema will be created.

Perform one of the below procedures to create a new empty schema:

• Right-click on the Project View, and select the New > Schema option from the shortcut menu.

• Click on the File > New > Schema option from the application menu.

• Click on the New Schema button on the toolbar.

Once one of the above actions is performed, the New Schema Wizard is launched, as shown on Figure 11.

Perform one of the below procedures to import an existing schema:

• Right-click on the Project View, and select the Import Schema option from the shortcut menu.

• Select the File > Import Schema option from the application menu.

Once one of the above actions is performed, the Schema Import Wizard is launched, as shown on Figure 12.

The wizard allows to select a schema file from the file system and to change the name of the selected schema in the project. The wizard also shows the name of the project that will contain the new schema.

In a schema file, comments are lines starting with a number sign (#). Comment lines can be modified in the Overview Tab of the Schema Editor. The Schema Management Tool can only manage comments that are located on the top of schema files, before any non-comment line is found (either blank lines, or lines containing actual schema definition information), as shown in Figure 13.

The schema shown in Figure 13 is loaded into the Schema Editor as shown in Figure 14:

Due to the comment removal logic described at the beginning of this section, the comments at line 5, 10, 11 and 12 in Figure 13 are lost after the file is loaded into the Schema Editor. This is because these comments are preceded by empty non-commented lines, and actual schema definition information.

When the comments of a schema are modified, an asterisk appears at the beginning of the schema name as shown in Figure 15. The asterisk indicates that the schema contains unsaved changes.

To rename a schema, perform one of the below procedures:

• Right-click on the specific schema in the Project View, then select the Rename option from the shortcut menu.

• Select the specific schema in the Project View, and select the Edit > Rename option from the application menu.

Once one of the above actions is performed, the pop-up window shown in Figure 16 appears, asking for the new schema name.

Perform one of the below procedures to delete an existing schema:

• Right-clicking on the selected schema in the Project View, then select the Delete option from the shortcut menu.

• Select the schema in the Project View, then select the Edit > Delete option from the application menu.

• Select the schema in the Project View, then click on the Delete button of the toolbar.

Once one of the above actions is performed, the schema file is deleted from the system. In case the schema to delete contains any attributes and object classes used in other schemas of the project, inconsistencies can occur: the GUI indicates this with a pop-up window shown in Figure 17. The window lists all attributes and object classes that are used in other schemas of the same project, and that depend on the data in the schema to be deleted.

Perform one of the below procedures to create a new attribute in a schema:

• Right-click on a schema in the Project View, then select the New > Attribute option from the shortcut menu.

• Select a schema in the Project View by clicking on it, then click on the button on the toolbar (as shown in Figure 18).

• Select a schema in the Project View by clicking on it, then select the File > New > Attribute command from the application menu.

• Click on the button located on the top of the Attribute list in the Schema Editor (as shown in Figure 19).

Once one of the above actions is performed, the New Attribute Wizard opens, where the new attribute can be created in two steps. In Step 1 (shown in Figure 20), the basic information of the attribute must be added. This includes the following:

• Attribute name: Name of the attribute. Mandatory field. If the selected name is incorrect or used by another element of the project, the window will display an error.

• OID: OID of the attribute. Mandatory field. If the selected name is incorrect or used by another element of the project, the window will display an error.

• Schema: The name of the schema that will contain the new attribute. The schema name is not editable in this window.

• Description: Describes the schema.

• Supertype: An attribute within the project which is set as the supertype of the current attribute.

• Syntax: The syntax of the attribute.

• Syntax lenght: The allowed length of the syntax.

• Properties: The properties of the attribute. The available attributes are Obsolete, Collective, Single-valued, or Modifiable by user.

Step 2 of the wizard (shown in Figure 21) is used to introduce the matching rules of the new attribute.

Once all the information of the new attribute is filled in, click on the Finish button. After that an Attribute Editor window opens (see Attribute Editor), showing the properties of the new attribute. The new attribute is also added to the Project View. When a new attribute is created, the schema file is automatically updated: therefore, it is not necessary to save the schema after creating an attribute.

The properties of an attribute can be modified through the corresponding sections of the Overview Tab in the Attribute Editor (see Figure 4). The properties available for modification are as follows:

• Attribute name: The name of the attribute. The name can be modified or a new one can be added (separated from the other by comma), as OpenLDAP allows attributes to have more than one name. However, each name must be unique within the project: if a selected name is already in use, the window will display an error.

• OID: The OID of the attribute, in the format of dot-separated numbers. The OID of the attribute must be unique within the project.

• Schema: The name of the schema. The schema name cannot be modified in this window, but it is possible to move the selected attribute to another schema within the project. For more information, see Moving an Attribute.

• Description: Describes the schema. The existing text can be modified.

• Supertype: The drop-down list can be used to select an attribute within the project to be set as the supertype of the attribute.

• Syntax: The syntax of the attribute. For value modification use the drop-down list or write a valid OID directly into the textbox. In case the OID is not valid, the window displays an error. If a new OID is introduced, it must be unique within the project.

• Syntax lenght: The allowed length of the syntax can be modified by either typing a new number or by increasing/decreasing the current value with the arrows on the right.

• Properties: Used to modify attribute properties (Obsolete, Collective, Single-valued, or Modifiable by user). Change the properties by checking or unchecking the available options.

The window can also be used to modify the Matching Rules (Equality / Ordering / Substring) by selecting the desired rule from the drop down list, or by directly writing a valid OID to the textbox on the right. If the typed OID is not valid, the window will display an error. If a new OID is introduced, it must be unique within the project.

Use the Move option to move an attribute from its current schema to another schema within the project. When clicking on the option, a pop-up window appears (shown in Figure 22), allowing to select the new schema where the attribute will be moved to.

Perform one of the below procedures to delete an attribute in a schema:

• Right-click on the selected attribute in the Project View, then select the Delete option from the shortcut menu.

• Select the affected attribute in the Project View by clicking on it, then select the Edit > Delete command from the application menu.

• Select the affected attribute in the Project View by clicking on it, then click on the Delete button of the toolbar.

• Select the desired attribute in the Attribute List of the Schema Editor, then click on the button.

If the attribute to delete is used in other schemas of the project, the project can end up in an inconsistent state. To avoid this situation, a warning pop-up window appears listing the attributes and object classes used in others schemas of the same project.

Once one of the above actions is performed, the attribute is deleted. In case the attribute to delete is used in other schemas of the project, inconsistencies can occur: the GUI indicates this with a pop-up window shown in Figure 23. The window lists all attributes and object classes that are used in other schemas of the same project, and that depend on the attribute to be deleted.

Perform one of the below procedures to create a new object class:

• Right-click on a schema in the Project View, then select the New > Object Class command from the shortcut menu.

• Select a schema in the Project View by clicking on it, then click on the button on the toolbar (see Figure 24).

• Select a schema in the Project View by clicking on it, then select the File > New > Object Class command from the application menu.

• Click on the button located on top of the object class list in the Schema Editor (see Figure 25).

Once one of the above actions is performed, the New Object Class Wizard opens, where the new object class can be created in two steps. In Step 1 (shown in Figure 26) the basic information of the object class must be added. This includes the following:

• Object class name: The name of the object class. If the selected name is incorrect or already in use by another element of the project, an error will appear.

• OID: The OID of the object class. If the selected OID is incorrect or already in use by another element of the project, an error will appear.

• Schema: The schema that includes the object class. This field is not editable, it just shows the name of the corresponding schema.

• Description: The textual description of the object class.

• Superior classes: The object class or list of object classes which are superior to the current object class. Use the Add button to add new superior object classes to the list, or remove existing superior object classes with the Remove button.

• Class type: The type of the object class. Use the drop-down list to select the desired class type of the object class.

In Step 2 of the wizard, mandatory and optional attributes can be defined. Use the Add buttons to open the list of possible attributes, and add them to the list of mandatory and optional attributes.

Once all the information of the new object class is added, click on the Finish button. This opens the Object Class Editor showing the new object class (see Object Class Editor for more information). The new object class is also included in the Project View. When a new object class is created, the schema file is automatically updated, so it is not necessary to save the schema after creating an object class.

The properties of an object class can be modified through the corresponding sections of the Overview Tab in the Object Class Editor (see Figure 6). The properties available for modification are as follows:

• Name: The name of the object class. The name can be modified or a new one can be added (separated with comma), as OpenLDAP allows object classes to have more than one name. Each name must be unique within the project: if an existing name is defined, an error appears.

• OID: The OID of the object class. The OID must be unique and must consist of dot-separated numbers. Use the textbox to modify the OID.

• Schema: The name of the schema to which the object class belongs. The schema name cannot be modified in this window.

• Description: The description of the object class. Use the textbox to change the textual description of the object class.

• Superior classes: The object class or list of object classes which are superior to the current object class. Use the Add button to add new superior object classes to the list, or remove existing superior object classes with the Remove button.

• Class type: The type of the object class. Use the drop-down list to select the desired class type of the object class.

The window can also be used to configure the mandatory and optional attributes of the object class in separate textboxes as follows:

• Mandatory attributes: This part of the window lists the mandatory attributes configured for the object class. To add new mandatory attributes, click on the Add button to the right of the textbox. This brings up the list of attributes within the project. To add any of them to the object class, double-click on them. A confirmation message is then shown on the top of the list each time a new mandatory attribute is successfully added. OpenLDAP allows to set the same attribute one or several times as mandatory attribute.

  To delete a mandatory attribute, select it on the Mandatory attributes list, then click on the Remove button.

• Optional attributes: This part of the window lists the optional attributes configured for the object class. To add new optional attributes, click on the Add button to the right of the textbox. This brings up the list of attributes within the project. To add any of them to the object class, double-click on them. A confirmation message is then shown on the top of the list each time a new optional attribute is successfully added. OpenLDAP allows to set the same attribute one or several times as optional attribute.

  To delete an optional attribute, select it on the Optional attributes list, then click on the Remove button.

An object class can be moved from its current schema to another schema within the project with the Move option. When clicking on the Move button, a pop-up window appears (shown in Figure 28), allowing to select the new schema where the object class will be moved to.

Perform one of the below procedures to delete an object class from a schema:

• Right-click on the specific object class in the Project View, then select the Delete command from the shortcut menu.

• Click on the specific object class in the Project View, then select the Edit > Delete command from the application menu.

• Click on the specific object class in the Project View, then click on the Delete button of the toolbar.

• Select the specific object class in the object class list of the Schema Editor, then click on the button.

Once one of the above actions is performed, the object class is deleted. In case the attribute to delete is used in other schemas of the project, inconsistencies can occur. To avoid this situation a warning pop-up window appears listing all the object classes used in other schemas of the same project.