Configuration Guide › Configuring Additional Options › Use Image Files in Entity Records

Use Image Files in Entity Records

You can associate an image file with each user, role, or resource entity in the CA GovernanceMinder database. This file is displayed in information and certification screens of the CA GovernanceMinder Portal. Each image file is matched to an entity based on the value of an attribute field.

Follow these steps:

1. Plan implementation of image directories. Consider the following points:
   • You can reference existing image directories, or can create new directories locally on the CA GovernanceMinder server. Image directories that reside on other hosts in your network environment must be accessible to the CA GovernanceMinder server.
   • To select the image that corresponds to a specific user, role, or resource, use one or more user, role, or resource attributes. You can use existing attributes, or can create attributes for image mapping.
2. (Optional) If you use a new user, role, or resource entity attributes for image mapping, define them in the CA GovernanceMinder Portal or CA GovernanceMinder Client Tools.
3. In the CA GovernanceMinder Portal, click Administration, Settings, Properties Settings and edit the following properties:

   user.image.url

   Defines a URL template that lets CA GovernanceMinder retrieve an image for a specific user record. Typically this template combines the pathname of the image directory with wildcards for user attributes. In the following example, the /users directory on the CA GovernanceMinder server stores user images, and the userID attribute identifies individual images.

   http://gm_host:port/users/$(userID).jpg
   

   Note: gm_host and port are the CA GovernanceMinder server network address and communications port, and $(userID) is a placeholder for the actual value of the userID attribute.

   When CA GovernanceMinder displays the user record with userID value of 2384, it retrieves the file 2384.jpg from the target pathname.

   role.image.url

   Defines a URL template that lets CA GovernanceMinder retrieve an image for a specific role. Typically this template combines the pathname of the image directory with wildcards for role attributes. In the following example, the /roles directory on the CA GovernanceMinder server stores role images, and the userID attribute identifies individual images.

   http://gm_host:port/users/$(Owner).jpg
   

   Note: gm_host and port are the network address and communications port of the CA GovernanceMinder server, and $(Owner) is a placeholder for the actual value of the Owner attribute.

   When CA GovernanceMinder displays the role with Owner value of 2384, it retrieves the file 2384.jpg from the target pathname.

   resource.image.url

   Defines a URL template that lets CA GovernanceMinder retrieve an image for a specific resource record. Typically this template combines the pathname of the image directory with wildcards for resource attributes. In the following example, the /resources directory on the CA GovernanceMinder server stores resource images, and the ResName3 attribute identifies individual images.

   http://gm_host:port/users/$(ResName3).jpg
   

   Note: gm_host and port are the network address and communications port of the CA GovernanceMinder server, and $(ResName3) is a placeholder for the actual value of the ResName3 attribute.

   When CA GovernanceMinder displays the resource record with ResName3 value of Unix_admins, it retrieves the file Unix_admins.jpg from the target pathname.

   Note: If you store the image files on the same server as the CA GovernanceMinder server, place the files in the following location:

   RCM_ROOT\Server\eurekify-jboss\server\eurekify\deploy\eurekify.war\images\
   

   Example: File location

   The following example shows you where to place an image file for the user.image.url property:

   http://gm_host:port/$(userID).jpg
   

4. (Optional) Create image directories corresponding to the pathnames you specified in the system parameters. Copy and rename image files to populate the directories.
5. (Optional) Replace the default images that CA GovernanceMinder displays when a user, role, or resource entity does not have a unique image file.

   For a CA GovernanceMinder server on Windows/JBoss, replace the images that are located under the following directory:

   gm_install\Server\eurekify-jboss\server\eurekify\deploy\eurekify.war\img
   

   Note: gm_install is the CA GovernanceMinder installation directory.

   Name the new image files as follows. Overwrite or rename existing files.

   • Default user image: User_Silhouette.gif
   • Default role image: UserGroup_48.png
   • Default resource image: Resource_48.png