Most configuration properties that you may have to edit for the user directory are contained in the following two components:
ProfileUserDirectory Component
The following example shows the default values in the .properties file for the atg/userprofiling/ProfileUserDirectory
component (class atg.userdirectory.repository.RepositoryUserDirectoryImpl
).
$class=atg.userdirectory.repository.RepositoryUserDirectoryImpl #basics repositoryItemGroupRegistry=/atg/registry/RepositoryGroups repositoryUserDirectoryProperties=ProfileUserDirectoryProperties repository=/atg/userprofiling/ProfileAdapterRepository transactionManager=/atg/dynamo/transaction/TransactionManager # caches organizationCache=OrganizationCache organizationPathCache=OrganizationPathCache repositoryItemGroupRoleCache=RepositoryItemGroupRoleCache roleCache=RoleCache rolePathCache=RolePathCache folderCache=FolderCache folderPathCache=FolderPathCache userCache=UserCache #view names userViewName=user relativeRoleViewName=organizationalRole organizationViewName=organization roleViewName=role folderViewName=roleFolder #random rootRoleFolderPrimaryKey=root rootOrganizationPrimaryKey=root
The properties in the Basics section of the file are used as follows:
Property | Use |
---|---|
| Points to the ATG service that registers any repository item groups (content or profile groups) you have created. |
| Points to the component that keeps track of the names of properties in the user directory. See ProfileUserDirectoryProperties Component below. |
| Points to the profile repository that is accessed by the user directory. |
| Points to the Transaction Manager service. For more information, see Transaction Management in the ATG Platform Programming Guide. |
The properties in the Caches section of the file identify the cache component to use for caching repository items of each item descriptor type. For more information, see Caching and the User Directory.
The properties in the View Names section of the file are the names of the Repository Views that correspond to the user directory item descriptors in the userProfile.xml
file.
Property | Use |
---|---|
| Corresponds to the user item descriptor |
| Corresponds to the organizational role item descriptor |
| Corresponds to the organization item descriptor |
| Corresponds to the global role item descriptor |
| Corresponds to the role folder item descriptor |
The properties in the Random section of the file are used as follows:
Property | Use |
---|---|
| Identifies the root folder that appears for global roles in the Roles window of the Business Control Center and the ACC. The value is the root folder’s |
| Identifies the repository ID of the root organization in the Organizations window of the Business Control Center and the ACC. The value is the root organization’s Important: If you add organizations to your user directory programmatically, none of them will appear in the Business Control Center or the ACC unless you change this property to point to the |
ProfileUserDirectoryProperties Component
The atg/userprofiling/ProfileUserDirectoryProperties
component (class atg.userdirectory.repository.RepositoryUserDirectoryProperties
) performs a function for the user directory definition that is similar to the /atg/userprofiling/PropertyManager
component’s function for the user profile definition (see Modifying Standard Profile Properties). It maintains a list of the names of various user directory properties as defined in the userProfile.xml
file. If you rename any of these properties in the XML file, you must also edit the corresponding configured value in the ProfileUserDirectoryProperties
component.
The following sample shows the properties file for this component:
$class=atg.userdirectory.repository.RepositoryUserDirectoryProperties userLoginPropertyName^=/atg/userprofiling/PropertyManager.loginPropertyName userPasswordPropertyName^=/atg/userprofiling/PropertyManager.passwordPropertyName userFirstNamePropertyName^=/atg/userprofiling/ PropertyManager.firstNamePropertyName userLastNamePropertyName^=/atg/userprofiling/PropertyManager.lastNamePropertyName userEmailAddressPropertyName^=/atg/userprofiling/ PropertyManager.emailAddressPropertyName userRolesPropertyName^=/atg/userprofiling/PropertyManager.rolesPropertyName userParentOrganizationPropertyName^=/atg/userprofiling/ PropertyManager.organizationPropertyName userAncestorOrganizationsPropertyName^=/atg/userprofiling/ PropertyManager.ancestorOrganizationsPropertyName organizationNamePropertyName=name organizationDescriptionPropertyName=description organizationAncestorOrganizationsPropertyName=ancestorOrganizations organizationParentOrganizationPropertyName=parentOrganization organizationRolesPropertyName=roles organizationRelativeRolesPropertyName=relativeRoles organizationMembersPropertyName=members organizationChildOrganizationsPropertyName=childOrganizations roleTypePropertyName=type roleNamePropertyName=name roleVersionPropertyName=version roleDescriptionPropertyName=description organizationalRoleFunctionPropertyName=function organizationalRoleRelativeToPropertyName=relativeTo folderTypePropertyName=type folderNamePropertyName=name folderDescriptionPropertyName=description folderParentPropertyName=parent folderChildFoldersPropertyName=childFolders folderChildItemsPropertyName=childItems