Attributes for User Mapping 

 

In systems.xml there is a range of attributes that you can define for the user mapping function (see User Mapping). This function requires information about which logon credentials are used by the component system. If you do not specify anything, this defaults to user ID and password.

You should not define any credentials for an SAP System that has been defined as a SAP reference system for user data. See Defining an SAP Reference System for User Data.

For each credential that you wish to appear as an entry field for a system in the user mapping function, you must enter an attribute in the system attributes of that system. A typical example would be user ID. Each credential attribute must have the prefix 'credentials'. In addition, you must specify certain properties for each credential attribute. These are described in the table below using 'user' as an example of a credential attribute. Note that the attributes 'user' and 'mappedpassword' are fixed. For all other attributes, you can choose any name.

Attribute

Attribute Value

UserMappingType
  • 'admin' - user mapping for this system can only be performed by the portal administrator
  • 'user' - user mapping for this system can only be performed by the user
  • 'admin, user' - user mapping for this system can be performed by both the portal administrator and the user

Note: if this attribute is not included in the systems.xml, the system does not appear in the user mapping function

credentials.user.Type
  • 'text' - the entry field in the user mapping function allows the user to enter free text
  • 'password' - the entry field in the user mapping function displays asterixes or similar symbols to hide the text that is entered
  • 'choice' - the entry field is a dropdown list box

credentials.user.Prompt

The field name to be displayed in front of the entry field on the user interface. This can either be a text, or, if the user interface is to be translateable, a text key that is defined in a resource file.

credentials.user.Index

The position at which the field is to appear on the user interface. For example, if the index is '1', this field will appear first.

credentials.user.Alias

(Optional) An alias for a logon parameter.

This may be required in certain cases as the names for user and password are fixed (user and mappedpassword). If the portal connects to a system where the logon parameters have a different name (for example systemabc_user and systemabc_pw), you can define these names as aliases.

The attributes for a system could be as follows:

 

<Attributes>
    <pcd:Attribute name="MessageServer" value="server.company.com"/>
    <pcd:Attribute name="Group" value="PUBLIC"/>
    <pcd:Attribute name="Client" value="050"/>
    <pcd:Attribute name="SystemType" value="SAP_R3"/>
    <pcd:Attribute name="credentials.client.Type" value="text"/>
    <pcd:Attribute name="credentials.client.Prompt" value="Client"/>
    <pcd:Attribute name="credentials.client.Index" value="1"/>
    <pcd:Attribute name="credentials.client.Alias" value="jco.client.client"/>
    <pcd:Attribute name="credentials.user.Type" value="text"/>
    <pcd:Attribute name="credentials.user.Prompt" value="User"/>
    <pcd:Attribute name="credentials.user.Index" value="2"/>
    <pcd:Attribute name="credentials.user.Alias" value="jco.client.user"/>
    <pcd:Attribute name="credentials.mappedpassword.Type" value="password"/>
    <pcd:Attribute name="credentials.mappedpassword.Prompt" value="Password"/>
    <pcd:Attribute name="credentials.mappedpassword.Index" value="3"/>
    <pcd:Attribute name="credentials.mappedpassword.Alias" value="jco.client.passwd"/>
    <pcd:Attribute name="credentials.lang.Type" value="text"/>
    <pcd:Attribute name="credentials.lang.Prompt" value="Language"/>
    <pcd:Attribute name="credentials.lang.Index" value="4"/>
    <pcd:Attribute name="credentials.lang.Alias" value="jco.client.lang"/>
</Attributes>

 

The user mapping function would then appear as follows: