Adding Developer Comments

You can add developer comments to an application, a page, or a group of pages using the Developer Comment, Bug, or To Do icon. This icon resembles a small balloon. This icon displays on the Developer Action bar.

Description of the illustration comment_ico.gif

You can use developer comments to communicate application changes, report issues, or record developer suggestions.

Topics:

• Adding Developer Comments to an Application or Page

• Viewing and Editing Developer Comments

• Deleting Developer Comments

• About the Developer Comments Report

• Viewing the Developer Comments Calendar

See Also:

"Adding Database Application Comments"

Adding Developer Comments to an Application or Page

The Developer Comment icon displays on any page in Application Builder that is related to a specific application or application page. You can add developer comments to an application, a page, or a group of pages.

To add a developer comment:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click the Developer Comment, Bug, or To Do icon.

4. Click the Comment icon.

   The Create Comment page displays in a separate window.

5. In Relevant Page(s), specify the pages to which the comment applies. To enter a comment that:

   • Applies to a specific page, enter the page number.

   • Applies to multiple pages, enter a comma-delimited list of pages. For example:

     1, 2, 3 
     

   • Does not apply to a page or group of pages, leave this field blank.

6. In Comment, enter up to 4000 characters of text.

7. Click Create or Create and Create Another.

Viewing and Editing Developer Comments

To edit a developer comment:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click the Developer Comment, Bug, or To Do icon.

4. Click the Comment icon.

   The Create Comment page displays in a separate window.

5. Click View Comments.

   The View Comments page appears. See "About the Navigation Bar on the View Comments Page".

6. To edit a comment, click the Edit icon.

   The Edit Comment page appears.

   1. In Relevant Page(s), specify the pages to which the comment applies. To enter a comment that:

      • Applies to a specific page, enter the page number.

      • Applies to multiple pages, enter a comma-delimited list of pages. For example:

        1, 2, 3 
        

      • Does not apply to a page or group of pages, leave this field blank.

   2. In Comment, enter up to 4000 characters of text.

7. Click Apply Changes.

Tip:

You can also view and edit Developer comments on the Shared Components page. Navigate to the Shared Components page and click Developer Comments on the Tasks list. See "Accessing the Shared Components Page".

About the Navigation Bar on the View Comments Page

A navigation bar appears at the top of the View Comments page and contains the following controls:

• Page. Search for a page number. Enter a page number and click Go. To view all pages, leave the field blank and click Go.

• Comment. Search for comments. Enter a case insensitive query for comment text and click Go. To view all comments, leave the field blank and click Go.

• Developer. Limit the display to a specific developer. Select a developer to display and click Go.

• Display. Determines how comments display. To increase or decrease the number of comments that appear, make a selection from the Display list and click Go.

Deleting Developer Comments

You can delete developer comments on the Edit Comment page or on the Manage Comments page.

Topics:

• Deleting a Specific Developer Comment

• Deleting Multiple Developer Comments

Deleting a Specific Developer Comment

To delete a developer comment:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click the Developer Comment, Bug, or To Do icon.

4. Click the Comment icon.

   The Create Comment page displays in a separate window.

5. Click View Comments.

6. Locate the comment to be deleted. See "About the Navigation Bar on the View Comments Page".

7. Click the Edit icon.

   The Edit Comment page appears.

8. Click Delete.

Deleting Multiple Developer Comments

To delete multiple developer comments:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click the Developer Comment, Bug, or To Do icon.

4. Click the Comment icon.

   The Create Comment page displays in a separate window.

5. Click Manage Comments.

6. Select one of the following actions:

   • Delete all comments

   • Delete comments created by a developer

   • Delete comments by date

7. Follow the on-screen instructions.

About the Developer Comments Report

You can also view, edit, and manage developer comments from the Developer Comments report.

Topics:

• Accessing the Developer Comments Report

• Editing or Deleting Comments from the Developer Comments Report

• Deleting a Comment from the Developer Comments Report

• Deleting Multiple Comments from the Developer Comments Report

Accessing the Developer Comments Report

To access the Developer Comments report:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click Shared Components

4. Under Tasks, click Developer Comments.

   The Developer Comments report appears.

A navigation bar appears at the top of the page and contains the following controls:

• Search icon - Resembles a magnifying glass. Click this icon to narrow your search to only specific columns. To search all columns, select All Columns.

• Text area - Enter case insensitive search criteria (wildcard characters are implied) and then click Go.

• Go button - Executes a search.

• Actions menu - Displays the Actions menu. Use this menu to customize an interactive report. See "About the Actions Menu".

Editing or Deleting Comments from the Developer Comments Report

To edit a comment from the Developer Comments report:

1. Navigate to the Developer Comments report. See "Deleting Multiple Developer Comments".

   The Developer Comments report appears.

2. Locate the comment to be edited.

3. Click the Edit icon.

   The Edit Comment page displays in a separate window.

   1. In Relevant Page(s), specify the pages to which the comment applies. To enter a comment that:

      • Applies to a specific page, enter the page number.

      • Applies to multiple pages, enter a comma-delimited list of pages, for example:

        1, 2, 3 
        

      • Does not apply to a page or group of pages, leave this field blank.

   2. In Comment, enter up to 4000 characters of text.

4. Click Apply Changes.

Deleting a Comment from the Developer Comments Report

To delete a comment from the Developer Comments report:

1. Navigate to the Developer Comments report. See "Accessing the Developer Comments Report".

   The Developer Comments report appears.

2. Locate the comment to be deleted.

3. Click the Edit icon.

   The Edit Comment page displays in a separate window.

4. Click Delete.

Deleting Multiple Comments from the Developer Comments Report

To delete multiple comments from the Developer Comments report:

1. Navigate to the Developer Comments report. See "Deleting Multiple Developer Comments".

   The Developer Comments report appears.

2. Locate the comment to be deleted.

3. Click the Edit icon.

   The Edit Comment page displays in a separate window.

4. Click Manage Comments.

5. Select one of the following actions:

   • Delete all comments

   • Delete comments created by a developer

   • Delete comments by date

6. Follow the on-screen instructions.

7. Click Apply Changes.

Viewing the Developer Comments Calendar

To access the Developer Comments Calendar:

1. On the Workspace home page, click the Application Builder icon.

2. Select an application.

3. Click Shared Components

4. Under Tasks, click Developer Comments Calendar.

   The Developer Comments Calendar page appears.

5. Use the Previous, Today and Next buttons to navigate.