Generate Peer Counselor Activity Report

Contents Show

The Generate Peer Counselor Activity Report screen is used to generate a Peer Counselor Activity Report CLN025 (Output).

For detailed information about the system output generated, see Peer Counselor Activity Report CLN025 (Output).

The Generate Peer Counselor Activity Report screen is available in the following application modules:

Clinic

Clinic

State Office

State Office

Generate Peer Counselor Activity Report screen

Screen Access

Screen Access

Interface Initialization

Upon initial display of the screen, the following occurs:

  • The title bar text is set to "Generate Peer Counselor Activity Report".

  • The Report By radio button group is visible and enabled. The Clinic radio button is initially selected as the default.

  • When the value of the INCLUDEGRANTEES business rule equals "Y" and the system output is defined as a grantee report, the Grantee radio button is visible and enabled in the Report By radio button group. Otherwise, the Grantee radio button is not visible.

  • When the value of the INCLUDEGRANTEES business rule equals "Y" and the system output is defined as a grantee report, the Grantee drop-down list box is visible, enabled, and blank. Otherwise, the Grantee drop-down list box is not visible.

  • The Agency drop-down list box is visible, enabled, and blank.

  • The Clinic(s) list box is visible, enabled, and blank. When an AgencyID is selected in the Agency drop-down list box, the list box contains options for all SERVICESITE.SERVICESITEID - SERVICESITE.SERVICESITENAME associated with the current AgencyID selection in the Agency drop-down list box. Options in the list box are sorted by SERVICESITE.SERVICESITEID in numeric order.

  • The Date Range group box is visible, enabled, and presented as follows:.

  • The From calendar control is visible, enabled, and blank.

  • The To calendar control in visible, enabled, and blank.

  • The Report Destination radio button group is visible and enabled as the default. The Display on Screen radio button is initially selected as the default.

  • The OK button is visible and enabled as the default.

  • The Cancel button is visible and enabled as the default.

Screen Elements

Unless otherwise stated below, all controls on the Generate Peer Counselor Activity Report screen are visible and enabled when:

If one or more special conditions exist that affect a control on the Generate Peer Counselor Activity Report screen, the condition(s) are documented for that specific control below.

Report By radio button group

  Select an option in the Report By radio button group.

This radio button group includes controls that allow you to filter the data displayed on the system output. The title text of the radio button group is set to "Report By". A selection is required in this radio button group. The following radio buttons are included in the group:

Clinic radio button

Select this radio button to limit the data included on the report by a specific clinic.

Agency radio button

Select this radio button to include data for all clinics within the agency currently selected in the Agency drop-down list box on the system output.

Grantee radio button

Select this radio button to limit the data included on the report by a specific grantee.

The name of this control is set by the value of a business rule. Depending on the value of the GRANTEENAME business rule, this control's label may display differently.

The control is visible and enabled when:

State radio button

Select this radio button to include data for all clinics in all agencies across the state on the system output.

Grantee drop-down list box

  Select the grantee the system output coves in the Grantee drop-down list box.

The drop-down list box includes all grantees in the Grantee table.

The name of this control is set by the value of a business rule. Depending on the value of the GRANTEENAME business rule, this control's label may display differently.

The control is visible and enabled when:

The control is disabled when:

Agency drop-down list box

  Select the agency the system output covers in the Agency drop-down list box.

The drop-down list box contains all agencies within the state. The options in the drop-down list box are formatted as follows: {Agency.AgencyID + Agency.AgencyName}. The options in the drop-down list box are sorted numerically in ascending order by AgencyID. A selection is required in this drop-down list box.

When an agency is selected in this drop-down list box, the Clinic(s) list box is refreshed and displays all clinics in the ServiceSite table that belong to the selected agency.

All clinics displayed in the Clinic(s) list box are sorted in numeric order by Clinic ID and no clinic is initially selected.

The control is enabled when:

Clinic(s) list box

  View items in the Clinic(s) list box.

Select one or more clinics to include in the system output in this list box. Single or multiple selections are allowed. The clinics displayed in the list box are displayed in numeric order by Clinic ID and no clinic is initially selected.

The list box contains all clinics that belong to the agency (or grantee, if available) currently selected.

The control is enabled when:

Date Range group box

  Complete the information in the Date Range group box.

This group box includes calendar controls that allow you to specify the date range for which to generate the system output. The title text of the group box is set to "Date Range". Complete the information in the following calendar controls to specify the date range the system output will cover:

From calendar control

Select or enter the starting date of the date range in this calendar control.

To calendar control

Select or enter the ending date of the date range in this calendar control.

The From date entered must be equal to or less than the To date entered. If not, a standard error message (E0047) displays when the screen is processed.

Report Destination radio button group

  Select an option in the Report Destination radio button group.

This radio button group includes controls that allow you to specify the destination of the generated system output. The title text of the radio button group is set to "Report Destination". A selection is required in this radio button group. The following radio buttons are included in the group:

Display on Screen radio button

Select the Display on Screen radio button to display the system output on your computer's monitor after it is generated. A report printer must currently be defined for your workstation.

Send to Printer radio button

Select the Send to Printer radio button to send the system output to the report printer currently defined for your workstation after it is generated. Printers are specified on the Default Printers screen.

Save as PDF radio button

Select the Save as PDF radio button to save the system output as a PDF file after it is generated.

Save Raw Data as Spreadsheet radio button

Select this radio button to save the raw data as an Excel file after it is generated.

OK button

  Click the OK button to generate the system output.

It is the default button for the screen.

It does not have a mnemonic. Its keyboard shortcut is the Enter key.

Depending on the selection in the Report Destination radio button group, one of the following occurs when the OK button is clicked:

The system output is generated and the Generate Reports screen displays when the button is clicked. Some reports can take a bit of time to generate. For these reports, a progress bar displays when the button is clicked.

Cancel button

Click the Cancel button to close the screen without generating the system output.

It does not have a mnemonic. Its keyboard shortcut is the Esc (escape) key.

The Generate Reports screen displays when the button is clicked.

Processing

If data can be validated and saved on the screen, the following processes occur when the screen is processed:

If no data can be validated and saved on the screen:

Data Map

The Data Map defines the values saved for all controls on the screen. If available, any additional notes or comments are displayed in the Notes column.

Control Label

Required

Notes

Report By radio button group

X

·

Grantee drop-down list box

X (when visible and enabled)

When the value of the INCLUDEGRANTEES business rule equals "Y" and the system output is defined as a grantee report, the Grantee drop-down list box is visible, enabled, and blank. Otherwise, the Grantee drop-down list box is not visible.

Agency drop-down list box

X (when enabled)

·

Clinic(s) list box

X (when enabled)

·

From calendar control

X

·

To calendar control

X

·

Report Destination radio button group

X

·

|

State Office