Create and Maintain Approvals

This section describes how to use the Client Reporting’s Maintain Approvals function to create and maintain approvals. Approvals are tasks that help you automate the periodic production of client reports. You can create approvals at the entity, client, or batch level.

Approvals are stored in the CR_APPROVAL, CR_APPROVAL_DETAIL, CR_APPROVAL_EMAIL and CR_APPROVAL_LIST tables in the Rules database.

Maintain Approvals Window

To work with the Maintain Approvals window:

  1. From any Eagle window, click the Eagle Navigator button to access the Eagle Navigator.

  2. Enter Reporting in the Start Search text box.

  3. Click the Reporting Center link to access the Reporting Center component.
    You see the Client Reporting workspace.

  4. Open the Client Reporting folder, and double-click the Administrative folder to see the Client Reporting options.

  5. Double-click Maintain Approvals.
    You see the Maintain Approvals window.

Maintain Approvals Window

The Maintain Approvals window displays a number of options for creating and maintaining approvals. Click a link or right-click on an approval and select an option from the popup menu. Right clicking on a column header displays a popup menu with options for sorting columns in ascending/descending order and grouping columns.

The following table describes the options on the Maintain Approvals window.

Option

Description

Sort Options

To group columns, right-click a column header and select Show in Groups. To determine which columns are available for grouping, right-click a column header and select Sort Multiple Columns. The Sort Multiple Columns dialog box shows which columns are available for grouping. You can also use it to sort multiple groups.

Current Filters

Displays the Filters Maintain Approvals dialog box, which allows you to filter the Maintain Approvals window by approval type, stage, and update date. You can also select the following options:

  • Show All Approvals. Displays approvals that are accessible to you through your business group.

  • Show Only My Approvals. Displays approvals you own.

  • Show Approvals Assigned to Me. Displays approvals assigned to you.

Maintain Approvals Menu

Displays a list of the other Client Reporting functions you can access from this window, such as Batch Status, Batch Status and Control, Custom Distributions, Maintain Batches, Approval Status, and Maintain Views.

Configure Link

Displays the Configure dialog box, which allows you to filter approvals by type, stage, expiration, and update date. You can also display only your approvals, those assigned to you, and control the number of items displayed per page.

Quick Links Menu

The Quick Links menu contains the following options:

  • Clients. Displays the Clients dialog box, where you can create, edit, and view clients.

  • Date Rules. Displays a popup where you can find, create, view, edit, copy, and delete date rules for a specified time frame.

  • Field Attributes. Displays a popup where you can perform actions on field attributes, such as find, create, view, edit, copy, and delete. Actions depend on the set of field attributes you are accessing.

  • Application Server Log. Displays the PACE Application Server Log dialog box. On this dialog box, you can view, save, and email log files with information about Client Reporting processes.

  • Refresh Cache. Displays the Refresh Cached Data dialog box, which allows you to refresh the inventory of fields and reference codes for the local client and refresh table joins for the remote server.

Search Menu

You can perform a text search or use the Search menu. To perform a text search, enter the text or string in the Search field, located to the right of the Search menu and click Enter. Client Reporting searches through the information on the Maintain Approvals window for a match. If a match is found, the row is highlighted. To use the Search menu, click the arrow next to the Search link. The Search menu displays the following options:

  • Search for client approvals. An advanced level search that finds client approvals that meet the specified criteria.

  • Search for entity approvals. An advanced level search that finds entity approvals that meet the specified criteria.

  • Search for batch approvals. An advanced level search that finds batch approvals that meet the specified criteria.

  • Search for clients. A general level search that finds clients that meet the specified criteria.

  • Search for entities. A general level search that finds entities that meet the specified criteria.

  • Show Search Window. Displays the standard Windows Find dialog box.

Create New Approval Link

Displays the Create New Approval dialog box. On this dialog box, you define an approval at the entity, client, batch, and dynamic batch levels and assign approvals.

Edit Approval Link

Displays the Edit Approval dialog box. On this dialog box, you modify information for the selected approval. For example, you can add or remove the entities, clients, or batches in an existing approval, create or edit an approval due date, create or edit an approval notification list, and add or remove one or more users and groups assigned to an approval.

View Approval Link

Displays the View Approval dialog box. On this dialog box, you view information for the selected approval.

Copy Approval Link

Displays the Copy Approval dialog box. On this dialog box, you copy the selected approval.

Enter the new name and click OK. The new approval is displayed on the Maintain Approvals window.

Delete Approval Links

To delete an approval, select an approval and click Delete Approval. Or, right-click, and select Delete Approval from the popup menu. The following confirmation message appears.

Click Yes to delete the specified approvals.

Print Link

Click Print Link to display the Print dialog box and print the list of approvals.

Refresh Link

Click Refresh Link to refresh data on the Maintain Approvals window.

Create Approvals

Approvals are tasks that help you automate the periodic production of client statements. You can create approvals at the entity, client, batch, and dynamic batch levels. To create an approval, you first define the approval and then assign the approval to one or more users or business groups, as described in the following procedures.

Create Batch Level Approvals

To create a batch level approval, you define the approval by associating it with one or more batches. Then, you assign the approval to one or more users or business groups. When the batch is submitted, either manually or through the Scheduler, a pending Approval record is created. Once the Approval is marked as Approved, the Batch is ready to run.

To create an approval at the batch level:

  1. Click the Create New Approval link on the Maintain Approvals window.
    You see the Create New Approval dialog box.

    Create New Approval Dialog Box
  2. Complete the options on the Create New Approval dialog box.

  3. Click the batches and click the Add link.

  4. Click Next.
    The Approval Users tab appears. On this tab, you assign the approval to one or more users or groups. Both users and business groups can edit a given approval. Also, you can assign users from two separate business groups to the same approval and each user can edit the approval.

    Create New Approval Dialog Box - Approval Users Tab
  5. Complete the options on the Approval Users tab.

  6. Click Finish.
    You have created a batch level approval.

Create Entity or Client Level Approvals

To create an entity or client level approval, you define the approval by associating it with one or more entities or clients. Then, you can assign the approval to one or more users or business groups. An approval created at the entity or client level applies to that entity or client, regardless of the number of batches to which the entity or client belongs.

Define an Approval

To define an approval at the entity or client level:

  1. Click the Create New Approval link on the Maintain Approvals window.
    You see the Create New Approval dialog box.

  2. Enter the name of the approval in the Name field, and any comment about the approval in the Approval field.

  3. Click the Entities/Clients button.

  4. Select Entities or Clients from the drop down list.
    You see the Create New Approvals dialog box - Entities/Client Level. A list of entities or clients appear, depending on your selection.

  5. Select the entities or clients.

    Create New Approval Dialog Box - Entities Client Level
  6. Click Next.
    The Approval Users tab appears. On this tab, you assign the approval to one or more users or groups. Both users and business groups can edit an assigned approval. Additionally, users from two separate business groups can be assigned to the same approval and each user can edit the approval.

    Create New Approval Dialog Box - Approval Users Tab
  7. Click the Users or Groups button.
    You see a list of users or business groups to whom you can assign the approval.

  8. Select the users or business groups and click the Add link.

  9. Complete the options on the Approval Users tab.

  10. Click Finish.

If you select the Groups button, you can view the users in the Business Group. Select a business group, right-click, and select Show Business Group Users from the popup menu. A dialog box that displays the Users contained in the selected Business Group appears.

You have created an entity or client level approval.

Create Criteria Based Approvals

Criteria based approvals are approvals that include rules for automatically determining which entities or clients are included in a batch. This makes it easier to manage new entities and clients as they are added to the system.

To create a criteria based approval:

  1. Click the Create New Approval link on the Maintain Approvals window.
    You see the Create New Approval dialog box.

  2. Click Custom Entities Filter (to create a criteria based approval at the entity level) or Custom Clients Filter (to create a criteria based approval at the client leve)l.

  3. Click the Define Custom Filter link.
    You see the Custom Filter dialog box.
    If you selected the Custom Clients Filter button, the Custom Filter dialog box displays field attributes created against the CLIENT table in the Field section of the dialog box.
    If you selected the Custom Entities Filter button, it displays the field attributes created against the ENTITY table in the Field section. Double click a field to select the field. If a field is configured with a reference code, the code values are displayed in the Value section of the dialog box.

  4. Use the fields and code values with arguments and operators in the key pad to define the criteria based approval. Use “C” to clear a selection and “AC” to clear all your selections. Click OK when you are done defining criteria based approval.

  5. Data that meets the filter criteria is displayed on the Create New Approval dialog box and you can select from the following links:
    - Edit Custom Filter. Allows you to edit the criteria based approval.
    - Clear Custom Filter. Allows you to clear the criteria and redefine the criteria based approval. You cannot save the approval without defining the criteria.
    - Evaluate Custom Filter. Allows you to preview the clients or entities in the approval via the Entities/Clients dialog box.

  6. Click Finish.
    The entities or clients that match the criteria are automatically included in the approval when the batch is submitted for processing.

The next section describes how to preview the entities and clients specified in a criteria based batch. If the list is not what you expect, you can modify the criteria until the clients or entities are included.

Preview the Entities and Clients

Use the Evaluate Custom Filter link on the Create New/Edit Batch dialog box to preview the entities and clients you specified for a criteria based approval.

When you click the Evaluate Custom Filter link, the Clients dialog box is displayed if you created a criteria based client approval, or the Entities dialog box is displayed if you created a criteria based entity approval. The Entities/Clients dialog box lists the clients/entities that meet the criteria you defined in the criteria based batch.

To sort the clients or entities on the dialog box in ascending order, single click the column heading. To sort the clients or entities in descending order, double click a column heading. You can customize the columns on the Clients/Entities dialog box using the Configure Fields link. Click Configure Fields to display the Configure Fields dialog box.

Configure Fields Dialog Box

To select a field for display in the Entities/Clients dialog box:

  1. Double-click the field in the left pane of the Configure Fields dialog box or select the field and click the right arrow button. To select all fields, click the right double arrow button.

  2. Click OK to save the field selections.

To remove a field from display within the Entities/Clients dialog box:

  1. Double-click the field in the right pane of the Configure Fields dialog box or select the field and click the left arrow button. To remove all fields, click the left double arrow button.

  2. Click OK to save the field selections.

To re-order fields:

  1. Select the fields in the right pane and use the Move Down and Move Up links to change the order of the selected fields.

  2. Click OK to save the field selections.

Create Dynamic Approvals

Dynamic approvals provide an easier way to synchronize the entities or clients in a batch and the entities or clients in an approval. When an approval is created and you select the Dynamic Batches button, the batches in the system are displayed on the dialog box.

Create New Approval Dialog Box - Dynamic Approvals

You select batches for a dynamic approval. However, a dynamic approval is executed for the entities or clients contained in the selected batches.

If an entity or client is removed from one of the selected batches, the entity or client is dynamically removed from the dynamic approval. This change takes affect the next time that batch is submitted and does not affect historical batch records. Similarly, if an entity or client is added to one of the selected batches, then the entity or client is dynamically added to the dynamic approval.

For example, if batch 1 contains client 1 and client 2 and a dynamic approval contains batch 1, approval status records for the dynamic approval are created for client 1 and client 2 when batch 1 is submitted. The enumeration of the dynamic approval from the batch to the client or entity level occurs when the batch is submitted. So, if client 2 were removed from batch 1 before the batch was submitted, a dynamic approval status record would only be created for client 1.

Similarly, if client 3 were added to batch 1 before batch 1 was submitted, then approvals status records for the dynamic approval would be created for client 1, client 2 and client 3.

The relationship between the dynamic approval and the client does not extend beyond the batch selected within the dynamic approval. For example, if batch 2 also contains client 1, but the dynamic approval only contains batch 1, an approval status record for the dynamic approval would not be generated when batch 2 was submitted.

The Define Approval Dependencies link in the Create New/Edit Batch dialog box recognizes dynamic approvals.

The Approval Dependencies dialog box displays approvals defined against the current batch, as well as those defined directly against the entities or clients contained in the batch.

Dynamic Approvals - Approval Dependencies

To retrieve the dynamic approvals associated with the batch, click the Fetch All button. Like other approvals, dynamic approvals can have their Order value set or they can be ignored from the current batch.

A dynamic approval based on a batch that contains entities can also contain batches defined at the client level. For this reason, the Type column in the Approval Dependencies dialog box displays Dynamic for dynamic approvals.

Dynamic Approvals can also be defined against a criteria based batch. The Approval contains the entities or clients that meet the criteria specified in the selected batch.

Configure Approvals

You configure approvals via the Configure link on the Maintain Approvals dialog box.

  1. Click the Configure link on the Maintain Approvals dialog box.
    You see the Configure dialog box.

    Configure Dialog Box
  2. On the Maintain Approvals tab, you configure settings for the approvals displayed on the Maintain Approvals window. The following table describes the options on the Maintain Approvals tab.

Option

Description

Use this Custom View

Select a custom view for display, if defined.

Filter Approvals by Type

This option allows you to filter approvals on the Maintain Approvals window by entity, client, batch, and dynamic batch.

Filter Approvals by Stage

This option allows you to filter approvals on the Maintain Approvals window by stage. The approval stage defines where the approval resides in the workflow.

Filtering Approvals by Expiration

This option allows you to filter approvals on the Maintain Approvals window by approval expiration. The approval expiration defines how often the approval update history is refreshed.

Filtering Approvals by Update Date

This option allows you to filter approvals on the Maintain Approvals window by update date.

Displaying Only My Approvals

This check box allows you to display only your approvals on the Maintain Approvals window.

Displaying Approvals Assigned to Me

This check box allows you to display approvals that are assigned to you on the Maintain Approvals window.

Page Size

From this drop down list, you can specify how many items you want to display per page.

General Tab

The General tab in the Configure dialog box has a number of settings that apply to all Client Reporting functions. The following table describes the options on the General tab.

Option

Description

Use this as a Startup View

From this drop down, specify which window you want to view on start up.

Client Identification

The Client ID and Client Display Name check boxes allow you to display the client ID and client name on windows for identification purposes. The Display contacts using this color link allows you to display contacts in a different color for easy identification. The Select an additional Client column drop down list allows you to display additional client related columns.

Save Most Recent Settings when Closing

When this check box is selected, your most recent settings are automatically saved when you log out of Client Reporting.

Enable the Troubleshooter/Trace Window

Select this check box to display the Troubleshooter dialog box for troubleshooting assistance.

Resetting All Settings

When this button is selected, your saved preferences, including window filters and sort settings, grid control settings, and default view settings are automatically reset