Inserting Comments

When Change Control history is enabled, you can insert comments about an open definition at any time. To help ensure that you insert new comments with each modification, you can instruct PeopleSoft Application Designer to prompt you for a comment every time you save a definition, every time you lock or unlock a definition, or both.

This section discusses how to:

  • Insert a comment for an unopened definition in the current project.

  • Insert a comment for an open definition.

  • Enable a prompt for comments when saving a definition.

Inserting a Comment for an Unopened Definition in the Current Project

To insert a comment for an unopened definition in the current project:

  1. In the project workspace, select the Development tab at the base of the workspace window to activate the development view.

  2. Select the definition for which you want to insert comments.

    You cannot insert comments for more than one definition at a time.

  3. Right-click the selected definition and select Insert Comment.

    The Insert Comment dialog box appears.

  4. Enter the necessary information:

    Field or Control Description

    Project

    Displays the name of the current project by default, but you can delete or replace this value.

    Incident ID

    Enter the incident identification to which your development corresponds.

    Comments

    Enter information about why and how you are modifying the definition.

    If you click OK, the information is inserted into the definition history and the dialog box closes. If you click Apply, your comments are inserted, but the dialog box remains open. You can then enter comments for another history entry. When you click OK or Apply, the new comments are inserted as a new history entry; they do not replace the previous entry.

Inserting a Comment for an Open Definition

To insert a comment for an open definition:

  1. Use the list in the Window menu to navigate to the definition.

  2. Select Tools, and then Change Control, and then Insert Comment.

  3. Enter the name of the project and incident ID.

  4. Enter your comments.

  5. Click OK or Apply.

Enabling a Prompt for Comments When Saving a Definition

To be prompted for comments when saving a definition:

  1. Select Tools, and then Options, and then Change Control.

    The Change Control page appears.

  2. Select Prompt for comments when definition is saved.

    Whenever you save a definition, the system prompts you to insert history comments.

    Note:

    This setting affects the behavior on your workstation only. One possible drawback to using this setting is that a definition might be saved many times as part of a single change, and you will be prompted for comments at every save.