Comment Clause for the Add Person Command

This clause provides general information about the person’s function and the required privileges. You can have only one Comment clause in any person definition.

There is no limit to the number of characters you can include in the comment. However, keep in mind that the comment is displayed when the mouse pointer stops over the person in the User chooser. Although you are not required to provide a comment, this information is helpful when a choice is requested.

There could be subtle differences in the access privileges required by different users. You can use the Comment clause as a reminder of why this person is defined a certain way. If a person is assigned the wrong group or role, that person might not be able to fully access the types of business object at the proper times in the object life cycle or might have inappropriate access to an object. Therefore, it is important to completely distinguish all persons.

For example you could have two quality control persons. One person performs testing of component assemblies and the other performs testing of the final machine. While they can belong to the same group (Quality Control) and there are similarities in their roles (Quality Testing), they are unique persons.

To distinguish between persons, you should include any descriptive comments meaningful to you to determine the person to contact when services are required.

For example, in the commands that follow, you can clearly identify the person you would call if you were interested in upgrading your personal computer.

add person sandy
   comment “Provides PCs sales support”;
add person amed
   comment “Provides Apple product sales support”;
add person miguel
   comment “Provides workstations and mainframes sales support”;

As you can see, each person provides sales support. However, the types of products they serve are different. These clauses enable another user to distinguish the persons. The clauses enable you to determine if a person needs access to business objects.