Create Control IDs and Control Groups

The first thing you do to set up Controls Security is create Control IDs and Control Groups. VPME uses Control Groups to link controls that have Controls Security to the forms that contain the controls. Here’s how you create Control IDs and Control Groups:

1.   Select Forms and Controls: Select the forms and controls in your application that should have Controls Security. On paper or in Word or Excel, create a Controls Security Setup List that includes the forms and controls that will have Controls Security. Your list might look like this:

Form

Control

Control ID

Control Group ID

Benefits

Contributions button

CB

BENEFITS

Startup

Contributions button

CB

STARTUP

Startup

Job Status button

JS

STARTUP

   We’ll explain the Control ID and Control Group ID columns below.

Tip: The VPME Form Toolbar controls are considered to be form controls for the purpose of Controls Security. The VPME Form Toolbar controls are already set up in the TOOLBAR_ALL Control Group for you.

Tip: The child grid buttons on one-to-many forms are already set up in the ONE-TO-MANY Control Group for you.

2.   Assign Control ID’s: Assign 1 or 2 character  alphanumeric ID codes to each control you’ve selected. Alpha must be upper case. Enter the Control ID’s in your Controls Security Setup List. The ID’s must be unique within a form. If you are including Toolbar controls or one-to-many child grid buttons in Controls Security for a form, you must not use a Toolbar or child grid button Control ID for any other control on the form. The Toolbar and child grid button controls have the following Control ID’s.

Control

Control ID

Control Group ID

Edit Mode

EM

EDIT_MODE

Child Copy

CC

ONE-TO-MANY

Child Delete

CD

ONE-TO-MANY

Child New

CN

ONE-TO-MANY

Copy

C

TOOLBAR_ALL

Delete

D

TOOLBAR_ALL

Filter

FL

TOOLBAR_ALL

Find

FN

TOOLBAR_ALL

Group Delete

GD

TOOLBAR_ALL

List

LI

TOOLBAR_ALL

Locate

LO

TOOLBAR_ALL

New

N

TOOLBAR_ALL

Order

O

TOOLBAR_ALL

Parent Mode

PM

TOOLBAR_ALL

3.   Create Control Groups: Create Control Groups by assigning your Control ID’s to Control Group ID codes. VPME uses the Control Group ID’s to identify which forms and controls have Controls Security. Because there will normally be more than one control on a form with Controls Security, you can assign all the controls on a form to the same Control Group. Enter a Control Group ID in your Controls Security Setup List for each Control ID in the list. Control Group ID’s can be up to 12 alphanumeric characters. Alpha characters must be upper case.

4.   Create Control Groups Records: Select the Control Group Definition option from the Security Builder menu on the VPME Tools menu. VPME displays the Control Group Definitions form.

   Use the Control Group Definitions form to add a new Control Group Definition record for each control in your Controls Security Setup List. The Control Descriptions you enter are used to identify the controls for application users on the Control Permissions dialog. So, enter user-friendly Control Descriptions.

   You’ll see three Control Groups already on the Control Group Definitions form:

·       ONE-TO-MANY: This is the Control Group for the child grid buttons on one-to-many forms. As you will learn later, you can include the child grid buttons in Controls Security for a form by simply entering the Control Group ID “ONE-TO-MANY” for the form on the Control Security Forms form.

·       EDIT_MODE: This is a Control Group with one control. The control is the Edit button in the Toolbar_All_Edit class that you use when you implement an Edit Mode for forms. You can include the Edit button in Controls Security for a form by simply entering the Control Group ID “EDIT_MODE” for the form on the Control Security Forms form.

·       TOOLBAR_ALL: This is the Control Group for the VPME Form Toolbar controls. As you will learn later, you can include the Toolbar controls in Controls Security for a form by simply entering the Control Group ID “TOOLBAR_ALL” for the form on the Control Security Forms form.

   When you’ve created a record on the Control Groups form for every control in your Controls Security Setup List, you are ready to start setting up your forms and controls for Controls Security. The next section shows you how.

Tip: The Control Group Definitions are stored in the SVPMControlGroupDefinitions.DBF table.

More:

Set Up Forms for Controls Security