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.

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.

More:

Set Up Forms for Controls Security