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 passwordHasher=/atg/dynamo/security/SaltedDigetsPasswordHasher 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 repositoryItemGroupFolderName=repositoryItemGroupFolder rootRoleFolderPrimaryKey=root rootOrganizationPrimaryKey=root profileRealmManager=/atg/multisite/ProfileRealmManager
The properties in the Basics section of the file are used as follows:
Property | Use |
---|---|
| Points to the Oracle Commerce Platform 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 salted digest password hasher described in the Password Hashing section. |
| Points to the Transaction Manager service. For more information, see Transaction Management in the 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 folder for repository item groups. |
| 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 |
| Identifies the component that keeps track of profile realms in multisite environments. |
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 userSecondaryOrganizationsPropertyName^=/atg/userprofiling/ PropertyManager.secondaryOrganizationsPropertyName userAccessRightsPropertyName^=/atg/userprofiling/ PropertyManager.accessRightsPropertyName 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