studio schema editor apache directorydirectory.apache.org/.../apache_directory_studio... · beside...

45
Apache Directory Studio Schema Editor User's Guide

Upload: others

Post on 14-Mar-2020

11 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Apache DirectoryStudio Schema Editor

User's Guide

Page 2: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Apache Directory Studio Schema Editor: User's GuideVersion 1.5.2.v20091211Copyright © 2006 - 2009 Apache Software Foundation

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Page 3: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor
Page 4: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

iv

Table of ContentsI. Getting started ................................................................................................................ 1

1. Download and installation ........................................................................................ 12. Views ................................................................................................................... 4

2.1. Hierarchy view ............................................................................................ 42.2. Problems view ............................................................................................. 52.3. Projects view ............................................................................................... 52.4. Schema view ............................................................................................... 62.5. Search view ................................................................................................. 8

3. Editors .................................................................................................................. 93.1. Attribute type editor ...................................................................................... 93.2. Object class editor ...................................................................................... 113.3. Schema editor ............................................................................................ 12

II. Tasks .......................................................................................................................... 151. Creating a new project ........................................................................................... 152. Importing projects ................................................................................................. 163. Exporting projects ................................................................................................. 174. Creating a new schema .......................................................................................... 185. Importing schemas ................................................................................................ 18

5.1. Importing schemas from XML files ................................................................ 185.2. Importing schemas from OpenLDAP files ....................................................... 195.3. Importing core schemas files ......................................................................... 205.4. Merge schemas ........................................................................................... 20

6. Exporting schemas ................................................................................................ 226.1. Exporting schemas as XML files ................................................................... 226.2. Exporting schemas as OpenLDAP files ........................................................... 226.3. Exporting schemas for Apache DS ................................................................. 23

7. Creating a new attribute type ................................................................................... 248. Creating a new object class ..................................................................................... 27

III. Reference ................................................................................................................... 311. Preferences ........................................................................................................... 31

1.1. Hierarchy View preferences .......................................................................... 311.2. Schema View preferences ............................................................................. 311.3. Search View preferences .............................................................................. 32

IV. What's new ................................................................................................................ 34V. Release notes ............................................................................................................... 38

Page 5: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

1

Chapter I. Getting startedThis part of the guide provides you a sum up of the basic concepts of the Schema Editor Plugin.

1. Download and installationBeside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor can alsobe installed as a plug-in into a regular Eclipse installation. This section describes this alternative.

Using the Eclipse Install/Update Manager is the easiest way to install the Apache Directory Studio SchemasEditor plug-in. From workbench menu choose Help # Software Updates # Find and Install... .

In the opened wizard choose Search for new features to install and click Next .

Next please specify the Apache Directory Studio update site. Click the New Remote Site... button. In thedialog input the following and press OK :

• Name: Apache Directory Studio Update Site

• URL: http://directory.apache.org/studio/update/1.x

Make sure the new update site is checked an press Finish .

Page 6: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

2

Now the install manager checks the update site and presents the search results. Select the feature you wantto install - of course the Apache Directory Studio Schema Editor - and click Next .

Accept the license agreement, the Apache Directory Studio Schemas Editor is distributed under the ApacheLicense, Version 2.0.

Page 7: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

3

In the next dialog ensure that the Apache Directory Studio Schema Editor feature is selected and clickto Finish .

Now the install manager loads the necessary files. When download is finished you have to verify theinstallation, please click to Install .

Page 8: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

4

After installation it is recommended to restart the Eclipse workbench.

2. Views

2.1. Hierarchy viewThe Hierarchy view shows the hierarchy of an element (attribute type or object class).

Here is what the Hierarchy view looks like:

Toolbar

The toolbar of the Hierarchy view contains the following actions:

• - Show the Type Hierarchy : Shows the type hierarchy.

• - Show the Supertype Hierarchy : Shows the supertype hierarchy.

• - Show the Subtype Hierarchy : Shows the subtype hierarchy.

• - Link with Editor : Links the view with the editor.

Menu

Page 9: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

5

The menu of the Hierarchy view contains the following actions:

• - Show the Type Hierarchy : Shows the type hierarchy.

• - Show the Supertype Hierarchy : Shows the supertype hierarchy.

• - Show the Subtype Hierarchy : Shows the subtype hierarchy.

• - Link with Editor : Links the view with the editor.

• Preferences : Displays the preferences dialog for the Hierarchy view.

Icons

The following icons can appear in the Hierarchy view:

Icon Description

Attribute type (operational)

Attribute type (user)

Object class (abstract)

Object class (auxiliary)

Object class (structural)

Attribute type (current selection)

Object class (current selection)

2.2. Problems viewThe Problems view displays errors and warnings associated with a resource.

Here is what the Problems view looks like:

Icons

The following icons can appear in the Problems view:

Icon Description

Error

Warning

2.3. Projects viewThe Projects view shows all the Schema projects of the workspace.

Page 10: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

6

Here is what the Projects view looks like:

Toolbar

The toolbar of the Projects view contains the following actions:

• - New Schema Project : Opens the New Schema Project wizard.

Icons

The following icons can appear in the Projects view:

Icon Description

Closed offline project

Opened offline project

Closed online project

Opened online project

2.4. Schema viewThis Schema view shows all the schemas of the currently opened project.

The Schema view has two types of presentation:

• Flat (Default)

• Hierarchical

Here is what the Schema view looks like in flat presentation:

Here is what the Schema view looks like in hierarchical presentation:

Page 11: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

7

Toolbar

The toolbar of the Schema view contains the following actions:

• - New Schema : Opens the New Schema wizard.

• - New Attribute Type : Opens the New Attribute Type wizard.

• - New Object Class : Opens the Object Class wizard.

• - Collapse All : Collapse all the node of the tree.

• - Link with Editor : Links the view with the editor.

Menu

The menu of the Schema view contains the following actions:

• - Sorting... : Opens the Sorting dialog for this view.

• Schema Presentation

• Flat : Displays the Schema in flat presentation.

• Hierarchical : Displays the Schema in hierarchical presentation.

• - Link with Editor : Links the view with the editor.

• Preferences : Opens the Preferences dialog for this view.

Icons

The following icons can appear in the Schema view:

Icon Description

Attribute type (operational)

Attribute type (user)

Page 12: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

8

Icon Description

Object class (abstract)

Object class (auxiliary)

Object class (structural)

Indicates an error on the resource

Indicates a warning on the resource

2.5. Search viewThe Search view displays the results of a search.

Here is what the Search view looks like:

Toolbar

The toolbar of the Search view contains the following actions:

• - Show Search Field : Shows the search field in the Search view.

• - Run the Current Search Again : Runs the current search again.

• - Search History : This command allows you to browse previously conducted searches and repeat aprevious search. You can select a previous search from the drop-down menu or clear the search history.

Menu

The menu of the Search view contains the following actions:

• - Sorting... : Opens the Sorting dialog for this view.

• Preferences : Opens the Preferences dialog for this view.

Icons

The following icons can appear in the Search view:

Icon Description

Attribute type (operational)

Attribute type (user)

Object class (abstract)

Object class (auxiliary)

Object class (structural)

Page 13: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

9

3. Editors3.1. Attribute type editor

The attribute type editor is the one-stop shop where you can define all aspects of your attribute type.

The Overview page is where the user can edit the properties of the attribute type.

User can edit:

• the name

• the OID

• the description

• the superior type

• the usage

• the syntax and syntax length

• if the attribute type is obsolete

• if the attribute type is single-value

• if the attribute type is collective

• if the attribute type is no-user-modification

• all the matching rules (equality, ordering, substring)

Page 14: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

10

The Source code page is where the user can see the result of his actions in the Overview page and whatsource code will be generated in the schema file.

Page 15: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

11

The Used By page is where the user can see in which object class(es) is used this attribute type (asmandatory or optional attribute type).

3.2. Object class editor

The object class editor is the one-stop shop where you can define all aspects of your object class.

The Overview page is where the user can edit the properties of the object class.

User can edit:

• the name

• the OID

• the description

• the superior class

• the class type

• if the object class is obsolete

• the mandatory attributes (add and remove)

• the optional attributes (add and remove)

Page 16: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

12

The Source code page is where the user can see the result of his actions in the Overview page and whatsource code will be generated in the schema file.

3.3. Schema editor

The schema editor displays all the attribute types and the object classes that contains a schema file.

Page 17: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

13

The Overview page is where the user can see all the attribute types and object classes of the schema.

Page 18: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Getting started

14

The Source Code page is where the user can see all the attribute types and object classes of the schemain their OpenLDAP code representation.

Page 19: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

15

Chapter II. Tasks

1. Creating a new projectTo create a new project, in the Projects view toolbar, click on the New Schema Project button, or usethe Strg-R shortcut.

The creation of a new Schema Project is a two-step process:

1. Define the name an the type of the project.

2. Select the 'core' schema files to import or select the directory server from which the schema shouldbe imported.

Page 1

The first page allows you to enter a project name and select the type of project.

Option Description Default

Name The name of the project. In the Projects view theproject is listed with this name. The name must beunique.

empty

Type The type of the project. Choose between OfflineSchema and Online Schema from a DirectoryServer.

Offline Schema

Page 2 (offline)

The second page allows you to select the 'core' schema files to import.

Page 20: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

16

Specify the type of server you want to work with and check the 'core' schema files you want to import.

Page 2 (online)The second page allows you to select the connection to the directory server from which the schema shouldbe loaded.

2. Importing projectsTo import schema projects choose one of the following options:

• In the Projects view, choose Import > Schema Projects from the context menu.

• In the Workbench menu bar select File > Import... and choose Schema Projects

Page 21: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

17

The following wizard appears:

Select the directory from which import the schema project files and then check each schema project fileyou want to import.

3. Exporting projectsTo export schema projects choose one of the following options:

• In the Projects view, choose Export > Schema Projects from the context menu.

• In the Workbench menu bar select File > Export... and choose Schema Projects

The following wizard appears:

Page 22: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

18

Check each schema project you want to export and then select the directory where to export these schemaproject files.

4. Creating a new schemaTo create a new schema, in the Schema view toolbar, click on the New Schema button (a project mustbe opened), or use the Strg-E shorcut.

The following wizard appears:

Give a name to the schema.

Option Description Default

Name The name of the schema. In the Schema view theproject is listed with this name. The name must beunique.

empty

5. Importing schemas

5.1. Importing schemas from XML files

To import schemas from XML files choose one of the following options:

• In the Schema view, choose Import > Schemas from XML file(s) from the context menu.

• In the Workbench menu bar select File > Import... and choose Schemas from XML file(s)

The following wizard appears:

Page 23: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

19

Select the directory from which import the schema files and then check each schema file you want toimport.

5.2. Importing schemas from OpenLDAP filesTo import schemas from OpenLDAP files choose one of the following options:

• In the Schema view, choose Import > Schemas from OpenLDAP file(s) from the context menu.

• In the Workbench menu bar select File > Import... and choose Schemas from OpenLDAP file(s)

The following wizard appears:

Select the directory from which import the schema files and then check each schema file you want toimport.

Page 24: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

20

5.3. Importing core schemas files

To import core schemas files choose one of the following options:

• In the Schema view, choose Import > Core schemas file(s) from the context menu.

• In the Workbench menu bar select File > Import... and choose Core schemas file(s)

The following wizard appears:

Check each schema file you want to import and click on the Finish button.

5.4. Merge schemas

You could merge schemas, object classes and attribute types from one schema project to another using theMerge Schemas wizard. To start the wizard choose Import > Merge Schemas from other Projectsfrom the context menu of the Schema view.

The following wizard appears:

Page 25: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

21

Check each schema, object class and/or attribute type from to merge to the current schema project andclick on the Next button.

The second wizard page appears:

Select merge options.

Option Description Default

Replace unknown syntax If checked, unknown syntaxes arereplaced by Directory String syntax, andappropriate matching rules (caseIgnoreMatch,caseIgnoreSubstringsMatch) are set.

checked

Merge dependencies If checked, dependent schema elements (superclasses, super attribute types, may and mustattributes) are also merged.

checked

Merge inheritedattributes

If checked, must and may attributes that are notdefined in the class hierarchy in the target schemaare added to the merged object class.

checked

Page 26: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

22

6. Exporting schemas

6.1. Exporting schemas as XML files

To export schemas as XML files, choose one of the following options:

• In the Schema view, choose Export > Schemas as XML file(s) from the context menu.

• In the Workbench menu bar select File > Export... and choose Schemas as XML file(s)

The following wizard appears:

Check each schema you want to export and then select the directory where to export each schema as aseparate file or a single destination file.

6.2. Exporting schemas as OpenLDAP files

To export schemas as OpenLDAP files, choose one of the following options:

• In the Schema view, choose Export > Schemas as OpenLDAP file(s) from the context menu.

• In the Workbench menu bar select File > Export... and choose Schemas as OpenLDAP file(s)

The following wizard appears:

Page 27: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

23

Check each schema you want to export and then select the directory where to export each schema as aseparate file.

6.3. Exporting schemas for Apache DS

To export schemas for Apache DS, choose one of the following options:

• In the Schema view, choose Export > Schemas for Apache DS from the context menu.

• In the Workbench menu bar select File > Export... and choose Schemas for Apache DS

The following wizard appears:

Page 28: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

24

Check each schema you want to export and then select the directory where to export each schema as aseparate file or a single destination file.

7. Creating a new attribute typeTo create a new attribute type, choose one of the following options:

• In the Schema view, choose New > New Attribute Type from the context menu.

• In the Schema view, click the New Attribute Type button in the toolbar.

• In the Workbench menu bar select File > New... and choose New Attribute Type

• You can also use the Strg-T shortcut.

The creation of a new attribute type is a three-step process:

1. Select the schema in which insert the new attribute type and specify its naming and descriptioninformation (OID, aliases and description)

2. Specify the attribute type content such as superior and usage, as well as syntax and properties

3. Specify the equality, ordering and/or substring matching rules

Page 1

The first page allows you to select the schema in which insert the new attribute type and specify its namingand description information (OID, aliases and description).

Page 29: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

25

Option Description Default

Schema The schema in which insert the new attribute type. empty

OID The OID of the new attribute type. The OID mustbe unique.

empty

Aliases The aliases (or names) of the new attribute type.Each alias (or name) must be unique.

empty

Description The description of the new attribute type. empty

Page 2

The second page allows you to specify the attribute type content such as superior and usage, as well assyntax and properties.

Page 30: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

26

Option Description Default

Superior The superior attribute type of the new attribute type. empty

Usage The usage of the new attribute type. User Applications

Syntax The syntax of the new attribute type. (None)

Syntax Length The syntax length of the new attribute type. 0

Obsolete Indicates the new attribute type is obsolete. Not checked

Single Value Indicates the new attribute type is single value. Not checked

Collective Indicates the new attribute type is collective. Not checked

No User Modification Indicates the new attribute type is no usermodification.

Not checked

Page 3

The third page allows you to specify the equality, ordering and/or substring matching rules.

Page 31: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

27

Option Description Default

Equality The equality matching rule of the new attribute type. (None)

Ordering The ordering matching rule of the new attributetype.

(None)

Substring The substring matching rule of the new attributetype.

(None)

8. Creating a new object classTo create a new attribute type, choose one of the following options:

• In the Schema view, choose New > New Object Class from the context menu.

• In the Schema view, click the New Object Class button in the toolbar.

• In the Workbench menu bar select File > New... and choose New Object Class

• You can also use the Strg-B shortcut.

The creation of a new object class is a four-step process:

1. Select the schema in which insert the new object class and specify its naming and descriptioninformation (OID, aliases and description)

2. Specify the object class content such as superiors, class type and properties

3. Specify the mandatory attribute types of the new object class

Page 32: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

28

4. Specify the optional attribute types of the new object class

Page 1

The first page allows you to select the schema in which insert the new object class and specify its namingand description information (OID, aliases and description).

Option Description Default

Schema The schema in which insert the new object class. empty

OID The OID of the new object class. The OID must beunique.

empty

Aliases The aliases (or names) of the new object class. Eachalias (or name) must be unique.

empty

Description The description of the new object class. empty

Page 2

The second page allows you to specify the object class content such as superiors, class type and properties.

Page 33: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

29

Option Description Default

Superiors The superiors object classes of the new object class. empty

Class Type The class type of the new object class. Structural

Obsolete Indicates the new object class is obsolete. Not checked

Page 3The third page allows you to specify the mandatory attribute types of the new object class.

Option Description Default

empty

Page 34: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Tasks

30

Option Description Default

Mandatory AttributeTypes

The mandatory attribute types of the new objectclass.

Page 4The forth page allows you to specify the optional attribute types of the new object class.

Option Description Default

Optional Attribute Types The optional attribute types of the new object class. empty

Page 35: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

31

Chapter III. Reference

1. Preferences

1.1. Hierarchy View preferences

In the Hierarchy View preferences page you can configure general settings for the Hierarchy view .

Option Description Default

Label Choose one of First Name , All Aliases orOID to be used as label for attribute types or objectclasses. If the checkbox is checked long labels withmore than the specified number of characters areabbreviated.

All Aliases with limit of50 characters

Secondary label Choose one of First Name , All Aliases orOID to be used as secondary label for attributetypes or object classes. If the checkbox is checkedlong labels with more than the specified number ofcharacters are abbreviated.

OID with no limit ofcharacters

1.2. Schema View preferences

In the Schema View preferences page you can configure general settings for the Schema view .

Page 36: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Reference

32

Option Description Default

Label Choose one of First Name , All Aliases orOID to be used as label for attribute types or objectclasses. If the checkbox is checked long labels withmore than the specified number of characters areabbreviated.

All Aliases with limit of50 characters

Secondary label Choose one of First Name , All Aliases orOID to be used as secondary label for attributetypes or object classes. If the checkbox is checkedlong labels with more than the specified number ofcharacters are abbreviated.

OID with no limit ofcharacters

Schema label If the checkbox is checked the name of the schemaof the element will be added to the label.

Checked

1.3. Search View preferences

In the Search View preferences page you can configure general settings for the Search view .

Page 37: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Reference

33

Option Description Default

Label Choose one of First Name , All Aliases orOID to be used as label for attribute types or objectclasses. If the checkbox is checked long labels withmore than the specified number of characters areabbreviated.

All Aliases with limit of50 characters

Secondary label Choose one of First Name , All Aliases orOID to be used as secondary label for attributetypes or object classes. If the checkbox is checkedlong labels with more than the specified number ofcharacters are abbreviated.

OID with no limit ofcharacters

Schema label If the checkbox is checked the name of the schemaof the element will be added to the label.

Checked

Page 38: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

34

Chapter IV. What's newWhat's new in 1.5.0

Online Schema

Schema projects can be created from an existing schema from a directory server.

Merge Schemas

Schemas, object classes and attribute types can be merged between schema projects.

A number of bug fixes

Besides these key new features, the Schema Editor plugin has received a number of bug fixes. A detailedreport is provided in the Release Notes section.

Page 39: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

What's new

35

What's new in 1.4.0Internationalization

Apache Directory Studio is now fully internationalized. Out of the box English, French and Germantranslations are provided.

What's new in 1.2.0Improvements in reading schema files

Apache Directory Studio 1.2.0 brings a better support for schema files. The schema file parser has beenrelaxed to allow non compliant schema files to be read correctly.

What's new in 1.1.0New Hierarchical presentation in Schema view

The Schema view has been improved by the addition of a new Hierarchical presentation which displaysthe attribute types and object classes hierarchically.

Key bindings

Page 40: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

What's new

36

The Schema Editor plugin now supports key bindings to launch several actions (e.g. "Open in TypeHierarchy").

Bundled OpenLDAP 'core' schemas

The Schema Editor plugin now bundles the 'core' schemas of Open LDAP. When creating a new project, or importing 'core' schemas , the schemas from Open LDAP can be selected.

Improved Hierarchy view

The Hierarchy view has been improved by the addition of the "Type Hierarchy" mode which displays atthe same time both the element's Supertype and Subtype hierarchies.

A number of bug fixes

Page 41: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

What's new

37

Besides these key new features, the Schema Editor plugin has received a number of bug fixes. A detailedreport is provided in the Release Notes section.

Page 42: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

38

Chapter V. Release notes

Apache Directory Studio 1.5.2 - (2009,December 11th)

Nothing new.

Apache Directory Studio 1.5.1 - (2009,November 30th)

Nothing new.

Apache Directory Studio 1.5.0 - (2009,November 2nd)

Bug

• [DIRSTUDIO-568] - When editing an AT or OC, using the scroll wheel may trigger a combo change

• [DIRSTUDIO-565] - Inconsistent handling of the 'modified schemas' flag

• [DIRSTUDIO-506] - Export Schemas for ApacheDS: object classes must be sorted by hierarchy

• [DIRSTUDIO-497] - LdapSchema plugin 'Save' is erratic

• [DIRSTUDIO-473] - Import OpenLDAP core schema

• [DIRSTUDIO-443] - The warning and error overlay for OCs and ATs sometimes (often) lacks forgetssome items

• [DIRSTUDIO-441] - New ObjectClass and AttributeType wizards always show a warning indicatingthat the item does not have any name

• [DIRSTUDIO-429] - Meaningless error message on importing schema

• [DIRSTUDIO-331] - Instant error when importing schema in a new schema-project

• [DIRSTUDIO-282] - Save failed: null , when adding an attribute to a class, if attribute is also open in gui

Improvement

• [DIRSTUDIO-535] - Use SWT.SEARCH and SWT.CANCEL style bits on search text field for a nativesearch field on Mac OS X

• [DIRSTUDIO-534] - Re-order the preference pages for better understanding

• [DIRSTUDIO-521] - Replace the XSLT transformation by the use of the Dom4J OutputFormat classfor XML pretty print

Page 43: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Release notes

39

• [DIRSTUDIO-509] - Load schema from the directory server

• [DIRSTUDIO-444] - Allow the user to enter the names of an item inline (using ',' as separator) in theOC and AT Editors

New Feature

• [DIRSTUDIO-510] - Add functionality to copy/merge schema elements between schema projects

Task

• [DIRSTUDIO-573] - Update bundled Apache DS Schema files to version 1.5.5

Apache Directory Studio 1.4.0 - (2009, April 7th)Bug

• [DIRSTUDIO-466] - Incorrect error message when importing a bad XML schema file

• [DIRSTUDIO-442] - Typo in a warning of the New ObjectClass wizard ('attribute type' instead of 'objectclass')

Improvement

• [DIRSTUDIO-426] - Overwritten hashCode() method should not use super.hashCode()

New Feature

• [DIRSTUDIO-397] - Request for multi-language GUI

Apache Directory Studio 1.3.0 - (2008,November 24th)

Improvement

• [DIRSTUDIO-384] - Improve New Attribute Type, New Object Class and New Schema Wizards whenno schema project is opened

Task

• [DIRSTUDIO-375] - Move each plugin IDs in a plugin.properties file

Apache Directory Studio 1.2.0 - (2008, august18th)

Bug

• [DIRSTUDIO-342] - Relax the parser for the *.schema files

• [DIRSTUDIO-266] - OpenLDAP schema files parser fails when DESC contains an empty string ''

Page 44: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Release notes

40

Apache Directory Studio 1.1.0 - (2008, march31st)

Bug

• [DIRSTUDIO-286] - Update Site is not working, missing dependencies in ldifeditor, ldapbrower andschemaeditor feature

• [DIRSTUDIO-243] - Modified value of Equality Matching Rule in the AttributeTypeEditor is not saved

• [DIRSTUDIO-239] - No error message when importing a bad schema

• [DIRSTUDIO-226] - Attribute Type Description is not imported when reading an OpenLDAP schemafile

• [DIRSTUDIO-224] - Can't Open Schema View with JDK 6.0

• [DIRSTUDIO-214] - IllegalArgumentException raised when selecting an AT with no alias as superiorin the NewAttributeTypeWizard

• [DIRSTUDIO-213] - NullPointerException raised when selecting an OC with no alias as a superior inthe NewObjectClassWizard

• [DIRSTUDIO-201] - Project Name mess up if it contains non-ascii chars

• [DIRSTUDIO-198] - Search string is not working properly with metacharacters (*, +...)

• [DIRSTUDIO-196] - Error dialog displayed after Problems View is closed

• [DIRSTUDIO-48] - Errors when help is open

Improvement

• [DIRSTUDIO-275] - Import/Export wizards should display an error if no Schema Project is open

• [DIRSTUDIO-254] - schema import does not provide error reporting when parsing schema file

• [DIRSTUDIO-251] - Replace the Text Widget for the OID in the new AT and OC wizards by a Drop-Down Combo with history of the last used OIDs

• [DIRSTUDIO-240] - Memorize the last import's path

• [DIRSTUDIO-238] - Automatically add an alias when the 'ok' button is selected

• [DIRSTUDIO-237] - It would be good to be able to import 'core' schemas into an existing project

• [DIRSTUDIO-227] - Add the ability to select OpenLDAP schema files as core schemas when creatinga project

• [DIRSTUDIO-216] - Improve Type Hierarchy View

• [DIRSTUDIO-206] - Add help contexts to the help plugin of the Schema Editor

• [DIRSTUDIO-200] - Add an OC and AT hierarchical global view

• [DIRSTUDIO-199] - Add scopes for OC and AT in search

Page 45: Studio Schema Editor Apache Directorydirectory.apache.org/.../Apache_Directory_Studio... · Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor

Release notes

41

• [DIRSTUDIO-195] - Add key bindings to the Schema Editor

New Feature

• [DIRSTUDIO-194] - Add a SchemaConnector for Apache Directory Server

• [DIRSTUDIO-193] - Add the abitilty to import/export the Schema from/to a directory Server

• [DIRSTUDIO-192] - Add an extension point in the Schema Editor for SchemaConnectors

Task

• [DIRSTUDIO-225] - Update documentation for Schema Editor Plugin

Apache Directory Studio 1.0.1 - (2007,september 10)

Bug

• [DIRSTUDIO-180] - Connection wizard and properties tabs are out of order

Task

• [DIRSTUDIO-181] - Update the documentation of the Schema Editor Plugin

Apache Directory Studio 1.0.0 - (2007,september 3rd)

Initial release.