009 User catalog

By specifying the script directories in the GuiXT profile, it is possible to activate different GuiXT scripts on different PCs. This procedure is sometimes not sufficient:
If the user has to work on different PCs the configuration of the GuiXT scripts should not depend on the PC but on the SAP-user name
Instead of having an individual configuration on each PC a central standard configuration is preferred
Both objectives can be reached by specifying a user catalog (command “UserCatalog” in guixt.ini). Please follow the steps below:

1 Divide the users of your SAP system into groups associated with different scripts. To do so, simply create a text file (name could be for example usercatalog.txt), in which the groups and the specific script directories are specified.
Example:

// User groups:
// make correspondence to 1-4 script directories

M1 \P5008\GuiXT\General \P5008\GuiXT\M1
M2 \P5008\GuiXT\General \P5008\GuiXT\M2
MX \P5008\GuiXT\General
TEST \P5008\Guixt\Test
XX none

// User:
// make correspondence to one user group

000/Adam M1
000/Rinaldini M2
000/Zeno M1
000/* MX // other users in client 000

800/Anton M1
800/Bertini M1
800/Cemicz M2
800/Smythe M1
800/Mueller M2
800/Zencke TEST

* XX / / other users, all clients

// Alternative:
// role or profile specific settings with
// Role=… or Profile=…
// (valid for all clients)

Role=SD_FACTORY_SALES M1
Role=SAP_FI* M2

// You can query the value of a user parameter, e.g. parameter ZZGXT = “SALES”, using
// the notation Parameter.PID=value
// Example:

Parameter.ZZGXT=SALES M1
Parameter.ZZGXT=FIN M2

Format details:

By using // you can add comments in your script; spaces are ignored.

In the first part of the user catalog, 5 user groups are named: M1, M2, MX, TEST, XX. You can associate up to 4 directories for each group. If the names of the directories contain spaces please put them between " …".

In addition to the script directories you may specify the parameters VBDirectory=, JSLibrary= and VBSLibrary= . They have the same meaning as in guixt.ini. Example:

M1 \P5008\GuiXT\General \P5008\GuiXT\M1 VBDirectory="\P5008\GuiXT\M1\VB files"

In the second part of the user catalog you can specify exactly one group for each client/user. At the end of each client you can specify the correspondence for all remaining users by using client/*. You can also specify a client independent association by specifying * at the end of the catalog.

Sorting the users by alphabetical order is not necessary but it probably gives a better overview.

The specification none means that no directory is active. In this case, even directories specified directly will not be active.

2 Specify the user catalog in your GuiXT profile.

For a centralized administration we recommend the use of a central .ini file, i.e.

On each individual PC you have the same standard guixt.ini file in the SAP GUI directory, in which you put the entry:

SwitchTo \P5003\guixt\guixt.ini

where P5003 is the central file server.

The file \P5003\guixt\guixt.ini contains the GuiXT options and the specification of a central user catalog.
Example:

IgnoreRegistry Yes
StartHidden Yes
Component GuiXT
Component InputAssistant
Key mycompany.C60.aghjll
Key mycompany.HR2.awertl
UserCatalog \P5003\guixt\UserCatalog.txt

Questions & answers about the user catalog:

Q: We are working with two productive systems C60 and HR2. Is it possible to specify a different user catalog for each system?
A: Yes, it is possible by using variable &database in the specification of UserCatalog, example:

UserCatalog \P5003\GuiXT&database\usercatalog.txt

In C60 the user catalog \P5003\GuiXT\C60\usercatalog.txt will be used, in HR2 the user catalog \P5003\GuiXT\HR2\usercatalog.txt.

Q: Which script directory will be used for the logon screen?
A: The user catalog will be read after the logon screen. For the logon screen itself, the given directories apply.

Q: What happens when the user cannot be found in the user catalog?
A: If an *-indication exists the corresponding user group will be associated. Otherwise the given directories will be used.

Q: When do modifications in the user catalog become active?
A: Modifications are not immediately active, but only at the next logon to SAP.

Q: Is it possible to put the user catalog on a webserver?
A: Yes, in this case just indicate the URL of the file, example:

UserCatalog http://www.mycompany.com/guixt/usercatalog.txt