Class and Attribute Descriptions

The table in this appendix lists each Novell^(R) eDirectory^TM class and attribute used by the DirXML Driver for GroupWise^(R). The Secondary Effects column in the following table contains information about how the attribute is used, special handling, conversions, and relationships of the attributes to other attributes.

eDirectory Class or Attribute	GroupWise Attribute	Channel (Subscriber or Publisher)	Description	Secondary Effects
NDS User
CN	None	Subscriber	Common Name of a User object.	When a GroupWise account is created or renamed, this value is used to name the GroupWise account and to set NGW: Object ID. For all other operations, this value is ignored.
Given Name	50091	Subscriber	User's first name	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Surname	50093	Subscriber Publisher	User's last name	Synchronizes from eDirectory to GroupWise on create and modify events. This attribute is only used on the publisher channel when creating a default user for resource reassignment. See the Important Note at the end of this table for additional information about this attribute.
Title	50096	Subscriber	User's title	Synchronizes from eDirectory to GroupWise create and modify events. See the Important Note at the end of this table for additional information about this attribute.
OU	50089	Subscriber	User's department	Synchronizes from eDirectory to GroupWise create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Telephone Number	50095	Subscriber	User's telephone number	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Facsimile Telephone Number	50145	Subscriber	User's facsimile telephone number	Only synchronizes the telephone number portion from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Description	50032	Subscriber	Provides additional information.	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
company	55022	Subscriber	User's company.	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Initials	55019	Subscriber	Middle initials, up to 8 characters.	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
Generational Qualifier	55020	Subscriber	Jr., III, and so forth, up to 8 characters.	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
personalTitle	55021	Subscriber	Dr., Mr., Ms., and so forth, up to 8 characters.	Synchronizes from eDirectory to GroupWise on create and modify events. See the Important Note at the end of this table for additional information about this attribute.
NGW: Object ID	50073	Publisher	GW mailbox name. The name must be unique within a post office. The name contains 1 to 256 characters, and can not contain the following characters: ()@.:",{}*.	This attribute takes its value from the CN attribute. The shim writes it via the Publisher channel to eDirectory. It is set when an account is created and modified when an account is renamed. Modifying this value might cause the following attributes to be modified: Email Address Internet Email Address NGW: GroupWise ID DirXML association key This attribute should not be modified except as the result of a rename.
NGW: Account ID	50116	Publisher	Optional field for accounting. It can contain a cost account used for posting charges to this user.	When an account is created, the shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. Normally the driver does not set this value. However, this attribute can be set through the Create rule or Create style sheet. See the Important Note at the end of this table for additional information about this attribute.
NGW: Gateway Access	59001	Publisher		When an account is created, the shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. Normally the driver does not set this value. However, this attribute can be set through the Create rule or style sheet. See the Important Note at the end of this table for additional information.
NGW: Mailbox Expiration Time	50138	Publisher		When an account is created, the shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. This attribute can be set through the Create rule or style sheet. For example, the default Output Transformation style sheet uses the eDirectory login expiration time to set this value.
Login Disabled	50058	Subscriber	A Boolean value that indicates whether eDirectory login (authentication) is allowed.	Synchronizes from eDirectory to GroupWise on create and modify events. The shim converts true to 1 and false to 0. Setting the GroupWise 50058 attributes to 1 disables the GroupWise account. See the Important Note at the end of this table for additional information.
Login Expiration Time	None	Subscriber	Date and time when authentication rights expire.	This eDirectory attribute has no corresponding GroupWise attribute. The value of this attribute is used to set the eDirectory attribute NGW: Mailbox Expiration Time and the GW attribute 50138, which are connected through the Schema Mapping rule.
NGW: File ID	50038	Publisher	This is three characters used to name system files for the user. The value must be unique within a post office. This value is set by GroupWise.	This attribute is set in GroupWise by GroupWise when an account is created. The shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. A move operation could cause this attribute to change. This attribute should not be modified in any style sheet.
NGW: GroupWise ID	None	Publisher Subscriber	Uniquely identifies object in GroupWise. This value is used for the DirXML association.	When an account is created or modified, the shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. A GroupWise move operation or a rename will cause this attribute to change. On any modify operation, the shim reads this value through the GroupWise API and, if it has changed, writes it to eDirectory through the publisher channel. The shim also changes the DirXML association value. This attribute only comes through the Subscriber channel when the GroupWise snap-ins change this value. The shim will then change the DirXML association key. This value, not the association key, is used to read the GroupWise object. If the association key does not match this attribute value, the association key is updated. This is because the GroupWise snap-ins can change this attribute and the GroupWise snap-ins do not update the association key. On all events, except delete, the shim queries eDirectory for this value. If the value does not exist, the event is discarded. If the shim cannot read the GroupWise object using this value, an error is returned to DirXML. This is a rare occurrence.
NGW: Visibility	50076	Publisher	Visibility is used to specify the databases into which an object should be replicated. Controls whether objects appear in the address book.	This attribute is set in GroupWise by GroupWise when an account is created. The shim queries GroupWise for this value and writes it via the Publisher channel to eDirectory. Normally the driver does not set this value. However, this attribute can be set through the Create rule or style sheet. To set, add code to the Create rule. Use "2" for global visibility, or "4" for no visibility. See the Important Note at the end of this table for additional information about this attribute.
Email Address	None	Publisher		This attribute is generated by GroupWise on create, rename, or move operations. The shim queries GroupWise for this value and writes it via the publisher channel to eDirectory.
Internet Email Address	None	Publisher		This attribute is generated by GroupWise on a create or rename operation, or when any attributes used to generate Internet Email Address are modified. The shim queries GroupWise for this value and writes it via the publisher channel to eDirectory.
NGW: Post Office	None	Publisher	DN of the Post Office object.	The driver writes this on create and move operations.
Any User attribute whose value can be represented as a string.	50106 to 50115, 55002 to 55011	Subscriber	Up to 20 eDirectory user attributes can be mapped to generic GroupWise attributes and displayed in the address book.	The eDirectory attribute names must be added to the subscriber filter. The eDirectory and GroupWise attribute names must be added to the Schema Mapping rule. 注: For these attributes to appear in the address book, GroupWise must be configured through ConsoleOne. See the Important Note at the end of this table for additional information about this attribute.
GroupWise Post Office
Member	None	Publisher		On a user create, the shim writes the eDirectory DN of the user to this attribute using the publisher channel. On a post office move, the shim deletes the user DN from the old PO and writes the user DN to the new post office.
GroupWise Resource
NGW: Owner	50081	Publisher	The user (NGW: Object ID) that owns the resource. An owner is identified by its Object Name.	The shim writes this value to GroupWise and to eDirectory via the Publisher channel. The value is provided by a style sheet or driver option. See the Important Note at the end of this table for additional information about this attribute.
GroupWise Distribution List
Member	None	Publisher		On eDirectory user create or modify operations, a set of Distribution Lists can be specified. The user can only be added as a Member. The shim fills in this attribute through the Publisher channel. On a modify event, a user can be removed from a specified Distribution List (member, BC or CC) or from all DLs (member, BC or CC). The shim will remove the user from the appropriate DL.
NGW: Blind Copy Member	None	Publisher		The driver cannot set this attribute. This attribute is only populated via the GroupWise snap-in.
NGW: Carbon Copy Member	None	Publisher		The driver cannot set this attribute. This attribute is only populated via the GroupWise snap-in.
	50319		Preferred internet eMail ID
	50013		Preferred internet address format	0 - Prefer Domain, Host, and User ID 1 - Prefer Host and User ID 2 - Prefer User ID 3 - Prefer lastname.firstname 4 - Prefer firstname.lastname 5 - Overriden no setting 6 - Prefer first initial and last name
	50320		Disallowed internet address formats	0 - None 1 - Full 2 - Host 3 - User ID 4 - Lastname.Firstname 5 - Firstname.Lastname 6 - First initial and last name
	50045		Internet domain name
	50157		Exclusive use of internet domain name
	59028		LDAP Authentication ID in typeful format

重要: When this GroupWise attribute is explicitly changed by a style sheet, the corresponding eDirectory attribute must also be updated by the style sheet. Otherwise, the eDirectory User and the GroupWise account are not properly synchronized.

For this attribute, eDirectory is considered the authoritative data source. When the attributes are not synchronized, it is possible that the old value in eDirectory could be used to incorrectly update the correct value in the GroupWise account. Updating the corresponding attribute in eDirectory can prevent this. In the example XSLT code segment below, when an eDirectory User is disabled, the GroupWise account is disabled and the visibility attribute is set to "4." This prevents the account from appearing in the address book. The visibility attribute (50076) is set in GroupWise, together with the disable. The visibility attribute (NGW: Visibility) is set in eDirectory using the channel write-back DirXML functionality.

<!-- User Disable, Remove Address Book Visibility 
  When a GroupWise Account is Disabled 
  remove the account from the address book visibility. 
  Keep eDirectory and GroupWise object synchronized by 
  updating the attributes in both systems. 
--> 
<xsl:template match="modify-attr[@attr-name='50058']"> 
     	<!-- When Login Disabled is true --> 
     <xsl:if test="add-value//value[.='true']"> 
          <!-- Update the visibility attribute in GroupWise --> 
          <!-- Copy the <modify> through to update GroupWise --> 
		          <xsl:copy> 
               			<!-- copy everything through --> 
               			<xsl:apply-templates select="@*|node()"/> 
		          </xsl:copy> 
          		<!-- Set the GroupWise visibility attribute (50076) to "4" 
          so the account does not show in the address book --> 
          		<modify-attr attr-name="50076"> 
               			<remove-all-values/> 
               			<add-value> 
                    <value type="int">4</value> 
			               </add-value> 
          </modify-attr> 
          <!-- Update the visibility attribute in eDirectory --> 
          		<!-- Send a command to modify "NGW: Visibility" in the eDirectory User object --> 
          		<xsl:variable name="command"> 
               			<modify class-name="User"> 
                    				<!-- dest-dn and dest-entry-id identify the User object in eDirectory --> 
                    <xsl:attribute name="dest-dn"> 
					                         <xsl:value-of select="../@src-dn"/> 
                    				</xsl:attribute> 
                    				<xsl:attribute name="dest-entry-id"> 
                         					<xsl:value-of select="../@src-entry-id"/> 
                    </xsl:attribute> 
                    				<!-- Set NGW: Visibility (50076) in eDirectory to "4" --> 
                    				<modify-attr attr-name="NGW: Visibility"> 
                              					<remove-all-values/> 
					                              <add-value> 
                              						     <value type="int">4</value> 
                              					</add-value> 
                         </modify-attr> 
                    </modify> 
          		</xsl:variable> 
		          <xsl:variable name="result" select="cmd:execute($srcCommandProcessor, $command)"/> 
	     </xsl:if> 
</xsl:template>