You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by fe...@apache.org on 2007/11/05 16:06:28 UTC
svn commit: r592032 [2/7] - in
/directory/sandbox/felixk/studio-schemaeditor-help: ./ META-INF/ src/
src/main/ src/main/docbook/ src/main/resources/
src/main/resources/about_files/ src/main/resources/html/
src/main/resources/html/css/ src/main/resource...
Added: directory/sandbox/felixk/studio-schemaeditor-help/src/main/docbook/0_index.xml
URL: http://svn.apache.org/viewvc/directory/sandbox/felixk/studio-schemaeditor-help/src/main/docbook/0_index.xml?rev=592032&view=auto
==============================================================================
--- directory/sandbox/felixk/studio-schemaeditor-help/src/main/docbook/0_index.xml (added)
+++ directory/sandbox/felixk/studio-schemaeditor-help/src/main/docbook/0_index.xml Mon Nov 5 07:06:22 2007
@@ -0,0 +1,1948 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "../../../target/docbook/docbook-xml/docbookx.dtd"[]>
+<!--
+ 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.
+-->
+<book>
+ <bookinfo>
+ <title>Apache Directory Studio</title>
+ <subtitle>Schema Editor User's Guide</subtitle>
+ <releaseinfo>Version 1.0.0</releaseinfo>
+ <copyright>
+ <year>2007</year>
+ <holder>Apache Software Foundation</holder>
+ </copyright>
+ <legalnotice>
+ <literallayout class="monospaced">
+ 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
+
+ <ulink url="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</ulink>
+
+ 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.
+ </literallayout>
+ </legalnotice>
+ </bookinfo>
+
+ <!-- GETTING STARTED CHAPTER -->
+ <chapter id="gettingstarted">
+ <title>Getting started</title>
+ <para>
+ This part of the guide provides you a sum up of the basic concepts of the Schema Editor Plugin.
+ </para>
+
+ <!-- DOWNLOAD AND INSTALLATION SECTION -->
+ <section id="gettingstarted_download_install">
+ <title>Download and installation</title>
+ <para>
+ Beside the integration in Apache Directory Studio the Apache Directory Studio Schema Editor can also be installed
+ as a plug-in into a regular Eclipse installation. This section describes this
+ alternative.
+ </para>
+ <para>
+ Using the Eclipse Install/Update Manager is the easiest way to
+ install the Apache Directory Studio Schemas Editor plug-in.
+ From workbench menu choose
+ <emphasis role="strong">
+ <menuchoice>
+ <guimenu>Help</guimenu>
+ <guisubmenu>Software Updates</guisubmenu>
+ <guimenuitem>Find and Install...</guimenuitem>
+ </menuchoice>
+ </emphasis>
+ .
+ </para>
+ <para>
+ In the opened wizard choose
+ <emphasis role="strong">Search for new features to install</emphasis>
+ and click <emphasis role="strong">Next</emphasis>.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_1.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Next please specify the Apache Directory Studio update site. Click the <emphasis role="strong">New Remote Site...</emphasis> button.
+ In the dialog input the following and press <emphasis role="strong">OK</emphasis>:
+ <itemizedlist>
+ <listitem>Name: Apache Directory Studio Update Site</listitem>
+ <listitem>URL: http://directory.apache.org/studio/update/1.x</listitem>
+ </itemizedlist>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_2.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Make sure the new update site is checked an press
+ <emphasis role="strong">Finish</emphasis>.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_3.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Now the install manager checks the update site and presents the search results. Select the
+ feature you want to install - of course the Apache Directory Studio Schema Editor - and click
+ <emphasis role="strong">Next</emphasis>.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_4.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Accept the license agreement, the Apache Directory Studio Schemas Editor is distributed under the
+ Apache License, Version 2.0.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_5.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ In the next dialog ensure that the Apache Directory Studio Schema Editor feature is selected and
+ click to <emphasis role="strong">Finish</emphasis>.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_6.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Now the install manager loads the necessary files. When download is finished
+ you have to verify the installation, please click to
+ <emphasis role="strong">Install</emphasis>.
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/install_7.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ After installation it is recommended to restart the Eclipse workbench.
+ </para>
+ </section>
+
+ <!-- VIEWS SECTION -->
+ <section id="gettingstarted_views">
+ <title>Views</title>
+
+ <!-- HIERARCHY VIEW SECTION -->
+ <section id="gettingstarted_views_hierarchy">
+ <title>Hierarchy view</title>
+ <para>The Hierarchy view shows the hierarchy of an element (attribute type or object class).</para>
+ <para>Here is what the Hierarchy view looks like:
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/views_hierarchy-view.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para><emphasis role="strong">Toolbar</emphasis></para>
+ <para>The toolbar of the Hierarchy view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hierarchy-supertype.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Show the Supertype Hierarchy</emphasis>: Shows the supertype hierarchy.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hierarchy-subtype.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Show the Subtype Hierarchy</emphasis>: Shows the subtype hierarchy.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_link-with-editor.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Link with Editor</emphasis>: Links the view with the editor.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Menu</emphasis></para>
+ <para>The menu of the Hierarchy view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hierarchy-supertype.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Show the Supertype Hierarchy</emphasis>: Shows the supertype hierarchy.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hierarchy-subtype.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Show the Subtype Hierarchy</emphasis>: Shows the subtype hierarchy.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_link-with-editor.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Link with Editor</emphasis>: Links the view with the editor.
+ </listitem>
+ <listitem>
+ <emphasis>Preferences</emphasis>: Displays the preferences dialog for the Hierarchy view.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Icons</emphasis></para>
+ <para>The following icons can appear in the Hierarchy view:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colname="Icon" colwidth="1* "/>
+ <colspec colname="Description" colwidth="3*" />
+ <thead>
+ <row>
+ <entry>Icon</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-operational.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (operational)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-user.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (user)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-abstract.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (abstract)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-auxiliary.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (auxiliary)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-structural.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (structural)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ <!-- PROBLEMS VIEW SECTION -->
+ <section id="gettingstarted_views_problems">
+ <title>Problems view</title>
+ <para>The Problems view displays errors and warnings associated with a resource.</para>
+ <para>Here is what the Problems view looks like:
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/views_problems-view.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para><emphasis role="strong">Icons</emphasis></para>
+ <para>The following icons can appear in the Problems view:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colname="Icon" colwidth="1* "/>
+ <colspec colname="Description" colwidth="3*" />
+ <thead>
+ <row>
+ <entry>Icon</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_error.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Error</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_warning.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Warning</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ <!-- PROJECTS VIEW SECTION -->
+ <section id="gettingstarted_views_projects">
+ <title>Projects view</title>
+ <para>The Projects view shows all the Schema projects of the workspace.</para>
+ <para>Here is what the Projects view looks like:
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/views_projects-view.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para><emphasis role="strong">Toolbar</emphasis></para>
+ <para>The toolbar of the Projects view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_project-new.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>New Schema Project</emphasis>: Opens the New Schema Project wizard.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Icons</emphasis></para>
+ <para>The following icons can appear in the Projects view:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colname="Icon" colwidth="1* "/>
+ <colspec colname="Description" colwidth="3*" />
+ <thead>
+ <row>
+ <entry>Icon</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_project-offline-closed.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Closed project</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_project-offline.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Open project</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ <!-- SCHEMA VIEW SECTION -->
+ <section id="gettingstarted_views_schema">
+ <title>Schema view</title>
+ <para>This Schema view shows all the schemas of the currently opened project.</para>
+ <para>Here is what the Schema view looks like:
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/views_schema-view.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para><emphasis role="strong">Toolbar</emphasis></para>
+ <para>The toolbar of the Schema view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_schema-new.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>New Schema</emphasis>: Opens the New Schema wizard.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-new.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>New Attribute Type</emphasis>: Opens the New Attribute Type wizard.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-new.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>New Object Class</emphasis>: Opens the Object Class wizard.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_collapse-all.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Collapse All</emphasis>: Collapse all the node of the tree.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_link-with-editor.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Link with Editor</emphasis>: Links the view with the editor.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Menu</emphasis></para>
+ <para>The menu of the Schema view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_sorting.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Sorting...</emphasis>: Opens the Sorting dialog for this view.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_link-with-editor.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Link with Editor</emphasis>: Links the view with the editor.
+ </listitem>
+ <listitem>
+ <emphasis>Preferences</emphasis>: Opens the Preferences dialog for this view.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Icons</emphasis></para>
+ <para>The following icons can appear in the Schema view:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colname="Icon" colwidth="1* "/>
+ <colspec colname="Description" colwidth="3*" />
+ <thead>
+ <row>
+ <entry>Icon</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-operational.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (operational)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-user.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (user)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-abstract.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (abstract)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-auxiliary.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (auxiliary)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-structural.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (structural)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hover-error.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Indicates an error on the resource</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_hover-warning.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Indicates a warning on the resource</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ <!-- SEARCH VIEW SECTION -->
+ <section id="gettingstarted_views_search">
+ <title>Search view</title>
+ <para>The Search view displays the results of a search.</para>
+ <para>Here is what the Search view looks like:
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/views_search-view.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para><emphasis role="strong">Toolbar</emphasis></para>
+ <para>The toolbar of the Search view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_show-search-field.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Show Search Field</emphasis>: Shows the search field in the Search view.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_run-current-search-again.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Run the Current Search Again</emphasis>: Runs the current search again.
+ </listitem>
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_show-search-history.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Search History</emphasis>: This command allows you to browse previously conducted searches and repeat a previous search. You can select a previous search from the drop-down menu or clear the search history.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Menu</emphasis></para>
+ <para>The menu of the Search view contains the following actions:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_sorting.gif" format="GIF" />
+ </imageobject> -
+ <emphasis>Sorting...</emphasis>: Opens the Sorting dialog for this view.
+ </listitem>
+ <listitem>
+ <emphasis>Preferences</emphasis>: Opens the Preferences dialog for this view.
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para><emphasis role="strong">Icons</emphasis></para>
+ <para>The following icons can appear in the Search view:</para>
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <colspec colname="Icon" colwidth="1* "/>
+ <colspec colname="Description" colwidth="3*" />
+ <thead>
+ <row>
+ <entry>Icon</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-operational.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (operational)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_attribute-type-user.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Attribute type (user)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-abstract.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (abstract)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-auxiliary.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (auxiliary)</entry>
+ </row>
+ <row>
+ <entry align="center">
+ <mediaobject>
+ <imageobject>
+ <imagedata contentdepth="1em" fileref="images/icons_object-class-structural.gif" format="GIF" />
+ </imageobject>
+ </mediaobject>
+ </entry>
+ <entry>Object class (structural)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ </section>
+
+ <!-- EDITORS VIEW SECTION -->
+ <section id="gettingstarted_editors">
+ <title>Editors</title>
+
+ <!-- ATTRIBUTE TYPE EDITOR SECTION -->
+ <section id="gettingstarted_editors_attribute_type">
+ <title>Attribute type editor</title>
+ <para>The attribute type editor is the one-stop shop where you can define all aspects of your attribute type.</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_attribute-type-editor-overview.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Overview</emphasis> page is where the user can edit the properties of the attribute type.</para>
+ <para>User can edit:</para>
+ <para>
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>the name</listitem>
+ <listitem>the OID</listitem>
+ <listitem>the description</listitem>
+ <listitem>the superior type</listitem>
+ <listitem>the usage</listitem>
+ <listitem>the syntax and syntax length</listitem>
+ <listitem>if the attribute type is obsolete</listitem>
+ <listitem>if the attribute type is single-value</listitem>
+ <listitem>if the attribute type is collective</listitem>
+ <listitem>if the attribute type is no-user-modification</listitem>
+ <listitem>all the matching rules (equality, ordering, substring)</listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_attribute-type-editor-source-code.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Source code</emphasis> page is where the user can see the result of his actions in the Overview page and what source code will be generated in the schema file.</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_attribute-type-editor-used-by.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Used By</emphasis> page is where the user can see in which object class(es) is used this attribute type (as mandatory or optional attribute type).</para>
+ </section>
+
+ <!-- OBJECT CLASS EDITOR SECTION -->
+ <section id="gettingstarted_editors_object_class">
+ <title>Object class editor</title>
+ <para>The object class editor is the one-stop shop where you can define all aspects of your object class.</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_object-class-editor-overview.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Overview</emphasis> page is where the user can edit the properties of the object class.</para>
+ <para>User can edit:</para>
+ <para>
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>the name</listitem>
+ <listitem>the OID</listitem>
+ <listitem>the description</listitem>
+ <listitem>the superior class</listitem>
+ <listitem>the class type</listitem>
+ <listitem>if the object class is obsolete</listitem>
+ <listitem>the mandatory attributes (add and remove)</listitem>
+ <listitem>the optional attributes (add and remove)</listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_object-class-editor-source-code.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Source code</emphasis> page is where the user can see the result of his actions in the Overview page and what source code will be generated in the schema file.</para>
+ </section>
+
+ <!-- SCHEMA EDITOR SECTION -->
+ <section id="gettingstarted_editors_schema">
+ <title>Schema editor</title>
+ <para>The schema editor displays all the attribute types and the object classes that contains a schema file.</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_schema-editor-overview.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Overview</emphasis> page is where the user can see all the attribute types and object classes of the schema.</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/editors_schema-editor-source-code.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>The <emphasis role="strong">Source Code</emphasis> page is where the user can see all the attribute types and object classes of the schema in their OpenLDAP code representation.</para>
+ </section>
+
+ </section>
+
+ </chapter>
+
+ <!-- TASKS CHAPTER -->
+ <chapter id="tasks">
+ <title>Tasks</title>
+
+ <!-- CREATING A NEW PROJECT SECTION -->
+ <section id="tasks_creating_new_project">
+ <title>Creating a new project</title>
+ <para>To create a new project, in the Projects view toolbar, click on the
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_project-new.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong">New Schema Project</emphasis> button.
+ </para>
+ <para>
+ The creation of a new Schema Project is a two-step process:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>Define the name of the project.</para>
+ </listitem>
+ <listitem>
+ <para>Select the 'core' schema files to import.</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <simplesect>
+ <title>Page 1</title>
+ <para>
+ The first page allows you to enter a project name.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-project-wizard_name.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Name</entry>
+ <entry>
+ The name of the project. In the
+ Projects view the project is
+ listed with this name. The name must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ <simplesect>
+ <title>Page 2</title>
+ <para>
+ The second page allows you to select the 'core' schema files to import.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-project-wizard-schemas.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ Check the 'core' schema files you want to import.
+ </para>
+ </simplesect>
+ </section>
+
+ <!-- IMPORTING PROJECTS SECTION -->
+ <section id="tasks_importing_projects">
+ <title>Importing projects</title>
+ <para>To import schema projects choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Projects view, choose <emphasis role="strong">Import >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_project-import.gif" format="GIF" />
+ </imageobject>
+ Schema Projects</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Import...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_project-import.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schema Projects</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_import-projects-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Select the directory from which import the schema project files and then check each schema project file you want to import.</para>
+ </section>
+
+ <!-- EXPORTING PROJECTS SECTION -->
+ <section id="tasks_exporting_projects">
+ <title>Exporting projects</title>
+ <para>To export schema projects choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Projects view, choose <emphasis role="strong">Export >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_project-export.gif" format="GIF" />
+ </imageobject>
+ Schema Projects</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Export...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_project-export.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schema Projects</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_export-projects-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Check each schema project you want to export and then select the directory where to export these schema project files.</para>
+ </section>
+
+ <!-- CREATING A NEW SCHEMA SECTION -->
+ <section id="tasks_creating_new_schema">
+ <title>Creating a new schema</title>
+ <para>To create a new schema, in the Schema view toolbar, click on the
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schema-new.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong">New Schema</emphasis> button (a project must be opened).
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-schema.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Give a name to the schema.</para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Name</entry>
+ <entry>
+ The name of the schema. In the
+ Schema view the project is
+ listed with this name. The name must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </section>
+
+ <!-- IMPORTING SCHEMAS SECTION -->
+ <section id="tasks_importing_schemas">
+ <title>Importing schemas</title>
+
+ <!-- IMPORTING SCHEMAS FROM XML FILES SECTION -->
+ <section id="tasks_importing_schemas_from_xml_files">
+ <title>Importing schemas from XML files</title>
+ <para>To import schemas from XML files choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">Import >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-import.gif" format="GIF" />
+ </imageobject>
+ Schemas from XML file(s)</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Import...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-import.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schemas from XML file(s)</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_import-schemas-xml-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Select the directory from which import the schema files and then check each schema file you want to import.</para>
+ </section>
+
+ <!-- IMPORTING SCHEMAS FROM OPENLDAP FILES SECTION -->
+ <section id="tasks_importing_schemas_from_openldap_files">
+ <title>Importing schemas from OpenLDAP files</title>
+ <para>To import schemas from OpenLDAP files choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">Import >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-import.gif" format="GIF" />
+ </imageobject>
+ Schemas from OpenLDAP file(s)</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Import...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-import.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schemas from OpenLDAP file(s)</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_import-schemas-openldap-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Select the directory from which import the schema files and then check each schema file you want to import.</para>
+ </section>
+
+ </section>
+
+ <!-- EXPORTING SCHEMAS SECTION -->
+ <section id="tasks_exporting_schemas">
+ <title>Exporting schemas</title>
+
+ <!-- EXPORTING SCHEMAS AS XML FILES SECTION -->
+ <section id="tasks_exporting_schemas_as_xml_files">
+ <title>Exporting schemas as XML files</title>
+ <para>To export schemas as XML files, choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">Export >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export.gif" format="GIF" />
+ </imageobject>
+ Schemas as XML file(s)</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Export...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schemas as XML file(s)</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_export_schemas-xml-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Check each schema you want to export and then select the directory where to export each schema as a separate file or a single destination file.</para>
+ </section>
+
+ <!-- EXPORTING SCHEMAS TO OPENLDAP FILES SECTION -->
+ <section id="tasks_exporting_schemas_as_openldap_files">
+ <title>Exporting schemas as OpenLDAP files</title>
+ <para>To export schemas as OpenLDAP files, choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">Export >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export.gif" format="GIF" />
+ </imageobject>
+ Schemas as OpenLDAP file(s)</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Export...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schemas as OpenLDAP file(s)</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_export-schemas-openldap-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Check each schema you want to export and then select the directory where to export each schema as a separate file.</para>
+ </section>
+
+ <!-- EXPORTING SCHEMAS FOR APACHE DS SECTION -->
+ <section id="tasks_exporting_schemas_for_apache_ds">
+ <title>Exporting schemas for Apache DS</title>
+ <para>To export schemas for Apache DS, choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">Export >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export-for-ads.gif" format="GIF" />
+ </imageobject>
+ Schemas for Apache DS</emphasis> from the context menu.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > Export...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_schemas-export-for-ads.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> Schemas for Apache DS</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>The following wizard appears:</para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_export-schemas-apacheds-wizard.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>Check each schema you want to export and then select the directory where to export each schema as a separate file or a single destination file.</para>
+ </section>
+
+ </section>
+
+ <!-- CREATING A NEW ATTRIBUTE TYPE SECTION -->
+ <section id="tasks_creating_new_attribute_type">
+ <title>Creating a new attribute type</title>
+ <para>To create a new attribute type, choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">New >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_attribute-type-new.gif" format="GIF" />
+ </imageobject>
+ New Attribute Type</emphasis> from the context menu.</listitem>
+ <listitem>In the Schema view, click the <emphasis role="strong">
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_attribute-type-new.gif" format="GIF" />
+ </imageobject>
+ New Attribute Type</emphasis> button in the toolbar.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > New...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_attribute-type-new.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> New Attribute Type</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ The creation of a new attribute type is a three-step process:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>Select the schema in which insert the new attribute type and specify its naming and description information (OID, aliases and description)</para>
+ </listitem>
+ <listitem>
+ <para>Specify the attribute type content such as superior and usage, as well as syntax and properties</para>
+ </listitem>
+ <listitem>
+ <para>Specify the equality, ordering and/or substring matching rules</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <simplesect>
+ <title>Page 1</title>
+ <para>
+ The first page allows you to select the schema in which insert the new attribute type and specify its naming and description information (OID, aliases and description).
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-attribute-type-wizard-general.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Schema</entry>
+ <entry>
+ The schema in which insert the new attribute type.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>OID</entry>
+ <entry>
+ The OID of the new attribute type. The OID must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Aliases</entry>
+ <entry>
+ The aliases (or names) of the new attribute type. Each alias (or name) must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Description</entry>
+ <entry>
+ The description of the new attribute type.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ <simplesect>
+ <title>Page 2</title>
+ <para>
+ The second page allows you to specify the attribute type content such as superior and usage, as well as syntax and properties.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-attribute-type-wizard-content.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Superior</entry>
+ <entry>
+ The superior attribute type of the new attribute type.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Usage</entry>
+ <entry>
+ The usage of the new attribute type.
+ </entry>
+ <entry>User Applications</entry>
+ </row>
+ <row>
+ <entry>Syntax</entry>
+ <entry>
+ The syntax of the new attribute type.
+ </entry>
+ <entry>(None)</entry>
+ </row>
+ <row>
+ <entry>Syntax Length</entry>
+ <entry>
+ The syntax length of the new attribute type.
+ </entry>
+ <entry>0</entry>
+ </row>
+ <row>
+ <entry>Obsolete</entry>
+ <entry>
+ Indicates the new attribute type is obsolete.
+ </entry>
+ <entry>Not checked</entry>
+ </row>
+ <row>
+ <entry>Single Value</entry>
+ <entry>
+ Indicates the new attribute type is single value.
+ </entry>
+ <entry>Not checked</entry>
+ </row>
+ <row>
+ <entry>Collective</entry>
+ <entry>
+ Indicates the new attribute type is collective.
+ </entry>
+ <entry>Not checked</entry>
+ </row>
+ <row>
+ <entry>No User Modification</entry>
+ <entry>
+ Indicates the new attribute type is no user modification.
+ </entry>
+ <entry>Not checked</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ <simplesect>
+ <title>Page 3</title>
+ <para>
+ The third page allows you to specify the equality, ordering and/or substring matching rules.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-attribute-type-wizard-matching-rules.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Equality</entry>
+ <entry>
+ The equality matching rule of the new attribute type.
+ </entry>
+ <entry>(None)</entry>
+ </row>
+ <row>
+ <entry>Ordering</entry>
+ <entry>
+ The ordering matching rule of the new attribute type.
+ </entry>
+ <entry>(None)</entry>
+ </row>
+ <row>
+ <entry>Substring</entry>
+ <entry>
+ The substring matching rule of the new attribute type.
+ </entry>
+ <entry>(None)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ </section>
+
+ <!-- CREATING A NEW OBJECT CLASS SECTION -->
+ <section id="tasks_creating_new_object_class">
+ <title>Creating a new object class</title>
+ <para>To create a new attribute type, choose one of the following options:
+ <itemizedlist spacing="normal" mark="bullet">
+ <listitem>In the Schema view, choose <emphasis role="strong">New >
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_object-class-new.gif" format="GIF" />
+ </imageobject>
+ New Object Class</emphasis> from the context menu.</listitem>
+ <listitem>In the Schema view, click the <emphasis role="strong">
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_object-class-new.gif" format="GIF" />
+ </imageobject>
+ New Object Class</emphasis> button in the toolbar.</listitem>
+ <listitem>In the Workbench menu bar select <emphasis role="strong">File > New...</emphasis> and choose
+ <imageobject>
+ <imagedata contentdepth="1em"
+ fileref="images/icons_object-class-new.gif" format="GIF" />
+ </imageobject>
+ <emphasis role="strong"> New Object Class</emphasis></listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ The creation of a new object class is a four-step process:
+ <orderedlist numeration="arabic">
+ <listitem>
+ <para>Select the schema in which insert the new object class and specify its naming and description information (OID, aliases and description)</para>
+ </listitem>
+ <listitem>
+ <para>Specify the object class content such as superiors, class type and properties</para>
+ </listitem>
+ <listitem>
+ <para>Specify the mandatory attribute types of the new object class</para>
+ </listitem>
+ <listitem>
+ <para>Specify the optional attribute types of the new object class</para>
+ </listitem>
+ </orderedlist>
+ </para>
+ <simplesect>
+ <title>Page 1</title>
+ <para>
+ The first page allows you to select the schema in which insert the new object class and specify its naming and description information (OID, aliases and description).
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-object-class-wizard-general.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Schema</entry>
+ <entry>
+ The schema in which insert the new object class.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>OID</entry>
+ <entry>
+ The OID of the new object class. The OID must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Aliases</entry>
+ <entry>
+ The aliases (or names) of the new object class. Each alias (or name) must be
+ unique.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Description</entry>
+ <entry>
+ The description of the new object class.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ <simplesect>
+ <title>Page 2</title>
+ <para>
+ The second page allows you to specify the object class content such as superiors, class type and properties.
+ </para>
+ <para>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata scale="50"
+ fileref="images/tasks_new-object-class-wizard-content.png" format="PNG" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </para>
+ <para>
+ <informaltable frame="all">
+ <tgroup cols="3">
+ <colspec colname="Option" colwidth="1*" />
+ <colspec colname="Description" colwidth="2*" />
+ <colspec colname="Default" colwidth="1*" />
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Superiors</entry>
+ <entry>
+ The superiors object classes of the new object class.
+ </entry>
+ <entry>empty</entry>
+ </row>
+ <row>
+ <entry>Class Type</entry>
+ <entry>
+ The class type of the new object class.
+ </entry>
+ <entry>Structural</entry>
+ </row>
+ <row>
+ <entry>Obsolete</entry>
+ <entry>
+ Indicates the new object class is obsolete.
+ </entry>
+ <entry>Not checked</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </simplesect>
+ <simplesect>
+ <title>Page 3</title>
[... 306 lines stripped ...]