| <!-- |
| 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. |
| --> |
| <section id="tools_newentry_wizard">
|
| <title>New Entry wizard</title>
|
| <para>This wizard helps you to create a new entry.</para> |
| |
| <para> |
| To start the wizard choose one of the following options: |
| <itemizedlist> |
| <listitem> |
| <para> |
| In the LDAP Browser view select an entry or search |
| result or bookmark. Then choose |
| <inlinemediaobject> |
| <imageobject> |
| <imagedata contentdepth="1em" fileref="icons/entry_add.gif" |
| format="GIF" /> |
| </imageobject> |
| </inlinemediaobject> |
| <emphasis role="strong">New Entry...</emphasis> |
| from context menu. |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| In the Workbench window's toolbar, activate the |
| drop-down menu on the New Wizard button and select |
| <emphasis role="strong">LDAP Entry</emphasis> |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| In the Workbench menu bar select |
| <emphasis role="strong"> |
| File > New > LDAP Entry |
| </emphasis> |
| . |
| </para> |
| </listitem> |
| </itemizedlist> |
| </para> |
| |
| <para> |
| The creation of a new LDAP entry is a four-step process: |
| <orderedlist numeration="arabic"> |
| <listitem> |
| <para> |
| <link linkend="tools_newentry_wizard_1"> |
| Select entry creation method. |
| </link> |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| <link linkend="tools_newentry_wizard_2"> |
| Specify object classes of the new entry. |
| </link> |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| <link linkend="tools_newentry_wizard_3"> |
| Specifiy the distinguished name of the new |
| entry. |
| </link> |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| <link linkend="tools_newentry_wizard_4"> |
| Enter attributes and values of the new entry. |
| </link> |
| </para> |
| </listitem> |
| </orderedlist> |
| </para> |
| |
| <simplesect id="tools_newentry_wizard_1"> |
| <title>Page 1</title> |
| <para>First you have to select the entry creation method.</para> |
| <para> |
| <screenshot> |
| <mediaobject> |
| <imageobject> |
| <imagedata scale="50" |
| fileref="images/tools_newentry_wizard_1.png" format="PNG" /> |
| </imageobject> |
| </mediaobject> |
| </screenshot> |
| </para> |
| <para> |
| With the option |
| <emphasis role="strong">Create entry from scratch</emphasis> |
| you could create a the new entry from scratch. All object |
| classes and attributes have to be specified in the wizard. |
| </para> |
| <para> |
| The option |
| <emphasis role="strong"> |
| Use existing entry as template |
| </emphasis> |
| allows you to use an existing entry with its object classes |
| and attributes as template. The entry used as template could |
| be specified in the input field: |
| <itemizedlist> |
| <listitem> |
| <para> |
| By default the DN of entry that was selected |
| when the wizard has been started is used as |
| template entry. |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| You could manually edit the DN of the templayte |
| entry. |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| You could choose a previously used DN from |
| drop-down list. |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| By clicking |
| <emphasis role="strong">Browse....</emphasis> |
| you could open a dialog to select the DN of the |
| template entry. |
| </para> |
| </listitem> |
| </itemizedlist> |
| </para> |
| </simplesect> |
| |
| <simplesect id="tools_newentry_wizard_2"> |
| <title>Page 2</title> |
| <para> |
| On the second page you have to choose the object classes of |
| the new entry. |
| </para> |
| <para> |
| <screenshot> |
| <mediaobject> |
| <imageobject> |
| <imagedata scale="50" |
| fileref="images/tools_newentry_wizard_2.png" format="PNG" /> |
| </imageobject> |
| </mediaobject> |
| </screenshot> |
| </para> |
| <para> |
| The list |
| <emphasis role="strong">Available object classes</emphasis> |
| on the left side lists the object classes provided from |
| schema of the current connection. The list |
| <emphasis role="strong">Selected object classes</emphasis> |
| lists the object classes of the new entry. To add object |
| classed to the "selected" list select some in the |
| "available" list and click the |
| <emphasis role="strong">Add</emphasis> |
| button. You could also double-click an object class in the |
| "available" list. To remove object classed from the |
| "selected" list select some in the "selected" list and click |
| the |
| <emphasis role="strong">Remove</emphasis> |
| button. You could also double-click an object class in the |
| "selected" list. |
| </para> |
| </simplesect> |
| |
| <simplesect id="tools_newentry_wizard_3"> |
| <title>Page 3</title> |
| <para> |
| On the third page you have to define the distinguished name |
| of the new entry. |
| </para> |
| <para> |
| <screenshot> |
| <mediaobject> |
| <imageobject> |
| <imagedata scale="50" |
| fileref="images/tools_newentry_wizard_3.png" format="PNG" /> |
| </imageobject> |
| </mediaobject> |
| </screenshot> |
| </para> |
| <para> |
| The parent of the new entry could be specified in the input |
| field: |
| <itemizedlist> |
| <listitem> |
| <para> |
| If you choosed the "from scratch" method the DN |
| of entry that was selected when the wizard has |
| been started is used by default. If you choosed |
| the "template" method the parent of the template |
| entry is used by default. |
| </para> |
| </listitem> |
| <listitem> |
| <para>You could manually edit the parent DN.</para> |
| </listitem> |
| <listitem> |
| <para> |
| You could choose a previously used DN from |
| drop-down list. |
| </para> |
| </listitem> |
| <listitem> |
| <para> |
| By clicking |
| <emphasis role="strong">Browse....</emphasis> |
| you could open a dialog to select the parent DN. |
| </para> |
| </listitem> |
| </itemizedlist> |
| </para> |
| <para> |
| To specify the RDN select an attribute from the drop-down |
| list and enter the value. If you choosed the "template" |
| method the RDN is preset with the RDN of the template entry. |
| The wizard also support multivalued RDNs. With the |
| <emphasis role="strong">+</emphasis> |
| and |
| <emphasis role="strong">-</emphasis> |
| buttons you can add and remove name-value pairs. |
| </para> |
| <para>The DN preview field shows a preview of the DN.</para> |
| <para> |
| When clicking to |
| <emphasis role="strong">Next</emphasis> |
| the wizard checks if an entry with the specified DN already |
| exists. In that case you have to change the DN of the new |
| entry. |
| </para> |
| </simplesect> |
| |
| <simplesect id="tools_newentry_wizard_4"> |
| <title>Page 4</title> |
| <para> |
| On the fourth page you have to define the attributes of the |
| new entry. |
| </para> |
| <para> |
| <screenshot> |
| <mediaobject> |
| <imageobject> |
| <imagedata scale="50" |
| fileref="images/tools_newentry_wizard_4.png" format="PNG" /> |
| </imageobject> |
| </mediaobject> |
| </screenshot> |
| </para> |
| <para> |
| The layout and features are similar to the Entry editor. You |
| could add, edit or delete attributes and values. |
| </para> |
| <para> |
| If you have choosed the "template" method all attributes of |
| the template entry are already filled in the new entry. |
| Otherwise only the selected object classes and the RDN |
| attribute are filled. |
| </para> |
| <para> |
| As soon as all MUST attributes are filled the |
| <emphasis role="strong">Finish</emphasis> |
| button is activated. When clicking the button the new entry |
| will be created in directory. |
| </para> |
| </simplesect> |
| |
| </section> |