| The Admin-Defined Fields tool is part of a solution that enables you to define new fields for the GroupWise address book. Extending the schema of the GroupWise and eDirectory directories does this. You can also access this tool by clicking Map Additional Fields from the Address Book tab of the domain object's details window. This section explains the entire process to take in order to add a new Address Book field that can be viewed within the GroupWise client's address book. Tip When making changes to eDirectory, be prepared for a possible time lag that comes with creating new attributes.
In this scenario, the administrator wants to add a field called Employee Cost Center Number, which will be viewable in the GroupWise Address Book. Here are the steps required: Note This procedure was written using eDirectory 8.7.3.2 and ConsoleOne 1.3.6 with the GroupWise 7 Administration Snap-ins to ConsoleOne.
1. | Make sure you are logged into Novell eDirectory as a user with rights to extend the eDirectory tree.
| 2. | Load ConsoleOne.
| 3. | Highlight an eDirectory Organization or Organizational Unit, and select Tools, Schema Manager.
| 4. | Select the Attributes tab.
| 5. | Click the Create button, and click the Next button.
| 6. | Name the attribute. Click the Help button for helpful information about naming this field. In this example, the name of the attribute is www: emp cost center.
|
Note The assigned name cannot be more than 32 characters. That's part of the reason for a somewhat-cryptic name. Also, the www: portion of the attribute name is added so that World Wide Widgets eDirectory administrators know that this is a custom attribute added by an internal eDirectory administrator.
Figure 6.10 shows the attribute name. Click Next to define the syntax of the attribute. Figure 6.10. Naming a new attribute 
7. | In the Syntax window, select Case Ignore String in the drop-down list, and click the Next button.
| 8. | From the Set Flags screen, select Single Valued; keep all other check boxes unchecked (unless there is a special purpose for checking them). Click the Next button.
Warning You are about to modify the schema of your Novell eDirectory tree. Make sure that before you do so you have your syntax and naming correct. Schema reversals to Novell eDirectory are virtually impossible. | 9. | From the summary screen, review the selections and click the Finish button.
| 10. | Exit the Schema Manager.
| 11. | Go back into the Schema Manager by selecting Tools, Schema Manager.
| 12. | From the Classes column, select the object type of Person. Click the Info button. You should see a window similar to the one shown in Figure 6.11.
Figure 6.11. Adding an attribute to the person object 
| 13. | Click the Add Attribute button.
| 14. | From the Available Attributes column in the Add Optional Attribute window, scroll down to the attribute created earlier. In the sample scenario this is the www: emp cost center number attribute. With the attribute highlighted, select the arrow pointing to the right, which places the attribute in the Add These Attributes column. Figure 6.12 shows that the attribute www: emp cost center number has been added to the person object.
Figure 6.12. Selecting the attribute 
| 15. | Click the OK button and then close out of the Schema Manager utility.
| 16. | In ConsoleOne, go to the GroupWise view. Make sure that you are connected to the GroupWise primary domain.
| 17. | Select Tools, GroupWise System Operations, Admin Defined Fields.
| 18. | From the Administrator-Defined Fields window, highlight an unused admin-defined field, and then click the Edit button.
|
Warning You are about to permanently modify the contents of your GroupWise system. After you have created an admin-defined field, it is not reversible. The snap-ins seem to give you a sense that you can clear an admin-defined field, but in my own testing, this is not the case. After you have used an admin-defined field, you cannot get other information to populate to that admin-defined field. When creating a new admin-defined field, in order for things to be successful, you must use an admin-defined field that you have never used before. So if you have used Admin Defined 1 already, even if you have cleared it out, it is best to now use Admin Defined 2.
19. | From the Select eDirectory User Property window, select the attribute www: emp cost center number, and click the OK button. You should see the attribute mapped to an admin-defined field as shown in Figure 6.13. Click the OK button to dismiss the Administrator-Defined Fields utility.
Figure 6.13. Assigning an eDirectory attribute to an admin-defined field 
To add admin-defined fields to the address book of a post office, you must define the attribute to the domain that owns that post office. Therefore, the steps described going forward must be performed on every GroupWise domain.
| 20. | Highlight the domain containing post offices whose address book you want to display this new field in.
| 21. | Edit the domain by right-clicking it and selecting the Properties menu option.
| 22. | On the GroupWise tab from the Properties of the domain, select the address book property page.
| 23. | From the Available Fields column, select www: emp cost center number and click the arrow pointing to the left. This adds www: emp cost center number to the Address Book Fields column.
| 24. | With the www: emp cost center number attribute highlighted in the Address Book Fields column, click the Edit Label button.
| 25. | In the Address Book Label field, give the field a more intelligible name; this name is the name users will see within their GroupWise client. Then click the OK button. Figure 6.14 shows a fully configured Address Book field.
Figure 6.14. Configuring the address book to contain an admin-defined field 
| 26. | Assign the Employee Cost Center Number to a user. The instructions given here are instructions for how to populate the attributes for one user. If you had a mechanism for bulk loading the newly created eDirectory field, it could be used as well. You must, however, have eDirectory User Synchronization enabled to ensure that the GroupWise Domain MTA replicates to the GroupWise directory the information that was put into eDirectory. When populating the www: emp cost center number field for a user, you do so with the GroupWise snap-ins to ConsoleOne installed. The GroupWise Administration snap-ins know to grab the contents of the www: emp cost center number field and add it to the GroupWise Address Book as the field called Employee Cost Center Number. If you bulk load information into eDirectory, however, there's not necessarily a mechanism to determine that the information in eDirectory then gets populated over to the GroupWise directory (WDOMAIN.DB and WPHOST.DB files). With eDirectory User Synchronization enabled and configured, the GroupWise MTA will extract the values from the eDirectory field www: emp cost center number and push it into the GroupWise directory into the GroupWise Employee Cost Center Number field.
| 27. | Edit the properties for a user object that is on a post office configured to allow the new Employee Cost Center Number attribute to be displayed in the address book.
| 28. | Go to the Other tab on the user object.
| 29. | Select the word Attributes and then click the Add button.
| 30. | Find the attribute www: emp cost center number from the list of available attributes, and click the OK button.
| 31. | Populate the entry field below the new attribute, and click the Apply button.You can now log in to GroupWise as a member of the post office that allows for the addition of Address Book fields, and view the user. To do this, run the GroupWise 6.5 or 7 client and go into the address book. Select the user, and select View, Details. You should see something similar to what's shown in Figure 6.15.
Figure 6.15. Viewing details on a user with a custom attribute 
|
|
