Configuring User Photo Support

Use

Enterprise workspaces enable you to leverage your organization's existing user photo repository and display the same user photos in enterprise workspaces screens. You can use this capability in the Member Explorer module and Member List module to display each member's photo, and in the Workspace Directory to display workspace and mobile homepage owners' photos, whether your organization's photo repository is located on a Web server or an LDAP server. The Member List and Workspace Directory implementations are visible to users only when accessing enterprise workspaces on a mobile device.

You can use this feature even if not all users have a photo in the repository, as the UI developers can display a standard avatar image for those users. By default, the out-of-the-box implementations listed above handle missing photos in this way.

To enable this feature, you need to configure User Photo Support properties. The configuration steps that you need to follow differ according to where your photo repository is located:

Option 1: Enables access to user photos that are stored on a Web server and accessed with a URL that is formed using standard user properties (such as e-mail or a unique name).
Option 2: Enables access to user photos that are referenced by URLs that are stored in your organization's LDAP server as a user attribute. This means that in the LDAP server, each user has a property that contains the URL of their photo.
Option 3: Enables access to user photos that are stored in your organization's LDAP server as a user binary attribute. This means that in the LDAP server, each user has a property that contains their photo.

Note

You can also develop your own mechanism for retrieving user photos from a repository by implementing and registering a custom user photo service. For more information, see Integrating User Photos.

Prerequisites

You are assigned the Workspaces System Administration role.

Procedure

Option 1: User Photos Stored on a Web Server

In the portal, navigate to Workspace Administration Configuration .
Choose the Features tab.

Under User Photo Support, configure the following properties:

User Photo Implementation: Specify prt_service:tc~spaces~imagestorage.URLPattern as the implementation type that you want to use for retrieving user photos at runtime (make sure that you type it exactly as it appears here).

Note
This is the default implementation type. You can also enter it in the User Photo Implementation field by choosing Restore Default Settings for the property.

URL Pattern: Specify the pattern of the URL to be used when retrieving the photo of each user. Valid placeholders are:

Placeholder	Description	Example
`FirstName`	The user's first name	John
`LastName`	The user's last name	Smith
`Email`	The user's full e-mail address	john.smith@example.com
`EmailPrefix`	The user's email address, up to, but not including, the @ symbol	john.smith
`UniqueName`	The value that is returned for the user using `IUser.getUniqueName()`	smithj

Example

If you specify the value http://photos.example.com/{EmailPrefix}.png, it will be replaced at runtime by http://photos.example.com/john.smith.png.

Save your changes.

Option 2: User Photo URLs Stored on an LDAP Server

In the portal, navigate to Workspace Administration Configuration .
Choose the Features tab.
Under User Photo Support, in the User Photo Implementation field, specify prt_service:tc~spaces~imagestorage.LDAPURL as the implementation type that you want to use for retrieving user photos at runtime (make sure that you type it exactly as it appears here).
Save your changes.
Start User Management Configuration, and download the data source configuration file from the AS Java. For more information, see the Help Portal links below.
Modify the attributes in the data source configuration file in any XML editor, as follows:
- In the section /dataSources/dataSource/responsibleFor/principal/nameSpaces/nameSpace/attributes/attribute, add the following:
  
  <attribute name="com.sap.workspaces.photoURL"/>
- In the section /dataSources/dataSource/attributeMapping/principals/principal/nameSpaces/nameSpace/attributes/attribute, add the following:
  
  <attribute name="com.sap.workspaces.photoURL">
  
  <physicalAttribute name="photoURL"/>
  
  </attribute>
  
  where photoURL is the LDAP attribute name that contains the URL of the user photo.
For more information about attribute mapping, see the Help Portal links below.
Upload the modified data source configuration file to the AS Java and restart the AS Java. For more information, see the Help Portal links below.

Option 3: User Photos Stored on an LDAP Server

In the portal, navigate to Workspace Administration Configuration .
Choose the Features tab.
Under User Photo Support, in the User Photo Implementation field, specify prt_service:tc~spaces~imagestorage.LDAPPhoto as the implementation type that you want to use for retrieving user photos at runtime (make sure that you type it exactly as it appears here).
Save your changes.
Start User Management Configuration, and download the data source configuration file from the AS Java. For more information, see the Help Portal links below.
Modify the attributes in the data source configuration file in any XML editor, as follows:
- In the section /dataSources/dataSource/responsibleFor/principal/nameSpaces/nameSpace/attributes/attribute, add the following:
  
  <attribute name="com.sap.workspaces.photo"/>
- In the section /dataSources/dataSource/attributeMapping/principals/principal/nameSpaces/nameSpace/attributes/attribute, add the following:
  
  <attribute name="com.sap.workspaces.photo">
  
  <physicalAttribute name="photo"/>
  
  </attribute>
  
  where photo is the LDAP binary attribute name that contains the user photo.
For more information about attribute mapping, see the Help Portal links below.
Upload the modified data source configuration file to the AS Java and restart the AS Java. For more information, see the Help Portal links below.

More Information

For more information about downloading and uploading a data source configuration file, see the following on the SAP Help Portal:

In SAP NetWeaver 7.0x, navigate to http://help.sap.com/nw70 and choose Application Help SAP Library .

In SAP Library, choose SAP NetWeaver SAP NetWeaver by Key Capability Security Identity Management User Management of the Application Server Java Configuring User Management UME Data Sources LDAP Directory as Data Source Customizing a UME Data Source Configuration Accessing Data Source Configuration Files Online .
In SAP NetWeaver 7.30, navigate to http://help.sap.com/nw73 and choose Application Help SAP Library .

In SAP Library, choose SAP NetWeaver Library: Function-Oriented View Security Identity Management User Management of the Application Server Java Configuring User Management UME Data Sources LDAP Directory as Data Source Customizing a UME Data Source Configuration Accessing Data Source Configuration Files Online .

For more information about attribute mapping, see the following on the SAP Help Portal:

In SAP NetWeaver 7.0x, navigate to http://help.sap.com/nw70 and choose Application Help SAP Library .

In SAP Library, choose SAP NetWeaver SAP NetWeaver by Key Capability Security Identity Management User Management of the Application Server Java Configuring User Management UME Data Sources LDAP Directory as Data Source Customizing a UME Data Source Configuration Structure of a Data Source Configuration File <attributeMapping> .
In SAP NetWeaver 7.30, navigate to http://help.sap.com/nw73 and choose Application Help SAP Library .

In SAP Library, choose SAP NetWeaver Library: Function-Oriented View Security Identity Management User Management of the Application Server Java Configuring User Management UME Data Sources LDAP Directory as Data Source Customizing a UME Data Source Configuration Structure of a Data Source Configuration File <attributeMapping> .