Use this task to edit existing entries in the client registry when,
for example, problems in a certain client browser are discovered that require
different, browser-specific processing or if there are problems in the user
agent pattern detection.
Perform the following steps to edit a client:
- Select the client from the list in Manage Clients.
- Click Edit new client.
Enter
the properties of the new client in the following fields:
- User agent: This field is mandatory. Enter the
name of the client, which should match, as close as possible, the user agent
string that the client sends in its request header. You might need to enter
several string patterns for a single client. In addition, surround the name
with a period plus asterisk combination, for example:
.*useragent.*
This
wild card string is used and resolved according to the wild card resolution
rules of the Apache foundation. Keep the following in mind:- Some user agent strings contain locale information about the language
of the client browser. The portal uses the language definition in the HTTP
request header for its language selection. It usually is not necessary to
define user agent patterns that take respect on certain browser languages.
- Some client browsers include information about the operating system. In
most cases, the client detection should work independent on this.
- Some browsers allow the user to customize the user agent patterns.
- Markup: This field is mandatory. Indicate the type
of markup the client supports. The markup must already be defined to the portal
from Manage Markup.
Note: After deleting a markup, the
client still references the original markup name. However, if you edit the
client, the Manage Client portlet displays a warning message to indicate that
a deleted markup is referenced and a supported markup should be selected if
the deleted markup will not be recreated.
- Markup Version: Optional. Indicate more specific
information about the markup supported by the client. This markup version
is used to identify deviations of a standard markup. For example, WebSphere
Portal includes the markup version ie in the registry to correctly handle
HTML deviations of the MicroSoft Internet Explorer.
- Manufacturer: Optional. Enter the name of the company
that manufactured the client.
- Model: Optional. Indicate the model number or name
of the client.
- Version: Optional. Indicate any version associated
with the model.
- Capabilities: Enter specific capabilities of this
client. If the client is a Web browser, for example, you could list specific
capabilities in HTML that it supports, such as frames or Javascript. Click Add to
add it to the capabilities list. To delete a capability, select it from the
list and click Delete.
- Position: Indicate the order in which you want
this client entered in the client registry. The portal server matches the
user agent string in the client's request header to patterns in the client
registry. For example, if the user agent sends 'Microsoft Internet Explorer
5.5' and the portal server finds '*Internet Explorer 5*', then that registry
entry is used to determine markup sent to the client. For this reason, it
is recommended to place the most specific User Agent patterns to the top of
the list. The default user agent pattern (*), if included in the list, should
be placed in the last position.
- Click OK to save your changes or click Cancel to
exit without saving your changes.