 Add2Group v1.0
Table of Contents
Add2Group License Agreement:
Distribution of this software: Add2Group is Shareware. You are hereby licensed to make any number of backup copies of this software and documentation. You can give the copy of the software to anyone or distribute the unlicenced version of the software providing that no additional fee is charged and the package files are not modified in any way.
Disclaimer of Warranty: This software and the accompanying files are supplied as is and without warranties as to performance or merchantability or any other warranties whether expressed or implied. Because of the various configuration options and purposes for which this tool may be used, no warranty of fitness for a particular purpose is offered. Any liability of the seller will be limited exclusively to product replacement.
Acceptance of Terms: Installing and using Add2Group means the acceptance of these terms and conditions of the license. If you do not agree with the terms of this license you must remove Add2Group files from your storage devices and cease to use the product.
July 2003
What Is Add2Group?
Add2Group is a RAD application. Add2Group allows you to select a Privilege Group and displays users who are members of the group. Non-members are also displayed - up to 1,200 (registered version) users can be displayed in either list at any one time. The unregistered version will display up to 10 users per list at any one time. Users can then be individually or bulk selected and added to or removed from the group.
Requirements
Add2Group requires:
- FirstClass Server version 7.0 or higher
- RAD 2.50 Build 2352 or higher
- UserBase 1.30 or higher
FirstClass Server version 7.1 and UserBase 2.50 are recommended.
What Is UserBase?
UserBase is a server RAD application. There is no user interaction with the application directly, although the various features and options can be configured using the UserBase Monitor tool, which is installed in the Monitors folder (FirstClass Services folder on pre-FC7.0 servers).
What Does UserBase Do?
Every time a user account is created or changed, every piece of information contained on the user profile form is extracted out and recorded in an Access database.
When a user logs in, a check is made to see if they already have a record in the database; if not they are added. When a user is deleted, they are removed from the database. Add2Group pulls the information about which groups users belong to out of the UserBase database.
Installing Add2Group
Follow the steps outlined below to install Add2Group:
1. Check the above requirements section to ensure you met them.
2. Stop your FirstClass Server
3. Run (double-click) on the Add2Group Setup.exe application program and follow the on-screen prompts.
4. When prompted for the location to install the application, select the root of the volume containing the primary FirstClass Post Office folder (FCPO). \FCPO\ will automatically be appended to the installation path by the installer.
5. When the installation process has completed, restart your FirstClass Server. Several batch files will be processed. A short-cut to the Add2Group application will be created in the FirstClass RAD\Built Applications folder, and this manual created in the Online Books area of the Online Help. Online help is also added to the Forms section of the Online Help.
Registering Add2Group
The unregistered version of Add2Group will display a maximum of 10 users in each list. The registered version can display up to a maximum of 1,200 users in each list. A registration key can be purchased from www.myaddons.com.
Configuring Add2Group
Once installed, Add2Group can be customised. You might want to allow some users access to more Privilege Groups than other users, or display fewer users in a list. You can also customise several of the descriptive titles in the application itself. The Registration Key also gets added to the configuration (.ini) file.
When you installed Add2Group, a document called "Add2Group.ini" was created in the "FirstClass RAD\Settings Files" folder. By default, the "FirstClass RAD" folder is on the Admins Desktop.
The .ini file is separated into three sections - [Setup], [Groups] and [Labels]. If an .ini file cannot be found, the default value is used.
[Setup]
The following keywords are supported in the [Setup] section:
Keyword: MembersOnly
Possible Values: 0 or 1
Default: 0
Description: Controls the list of groups available for selection. If set to 0, then all the groups on the server will be available. If set to 1, only the groups that the person running the application is a member of will be available. This setting works in conjunction with the [Groups] section of the .ini file.
Keyword: MaxListSize
Possible Values: 1 - 1,200
Default: 1,200
Description: The maximum number of names that can be displayed in each list. If the application is not registered, this setting is ignored.
Keyword: Registration
Possible Values: Valid Registration Key
Default: 0 (Unregistered)
Description: Activates the application an enables larger numbers of user accounts to be configured at the same time.
Keyword: LogLevel
Possible Values: 0 - 3
Default: 1
Description: The level of detail to display on the Server Console:
0 = no logging
1 = Detail who has changed the group membership
2 = Level 1 + Detail who has run the application
3 = Level 2 + all individual additions/removals from a group
Keyword: WriteToLogs
Possible Values: 0 or 1
Default: 0
Description: If set to 1, the logging is also written to the Statics Log files; otherwise it is just written to the server console.
Keyword: UserBasePath
Possible Values: A valid path to the UserBase database
Default: FCPO\FCRAD\DATA\USERBASEDB.MDB
Description: If you have installed the UserBase database in an alternative path, you need to supply the full path to the database, enclosed in quotes e.g.
"E:\Userbase\UserBasedb.mdb"
[Groups]
The [Groups] section can be used to control the list of Privilege Groups the user has access to. Put the names of the groups you want to include and/or exclude under the [Groups] heading, one group to a line. A + in front of the group name means you want the group included, while a - means you want the group excluded e.g.
[Groups]
+WebMasters
-All Users
The above list would include the WebMasters group, but exclude the All Users group.
The Groups section works in conjunction with the MembersOnly setting above. If MembersOnly = 1 groups with a + sign in front of them will be added to the list of available groups, even if the user isn't a member of the group.
[Labels]
The following keywords are supported in the [Labels] section:
Keyword: Title
Default: Add2Group
Possible Values: Anything
Description: Changes the title window and application title displayed while running the application
Keyword: Search
Default: S E A R C H I N G
Possible Values: Anything
Description: The text displayed while the list of users is being loaded.
Multiple .ini Files
Multiple .ini files can be created. This is particularly useful for giving different users access to different Privilege Groups to manage.
To specify a different .ini file to the default, you need to add a startup switch in the application stationary item that you use to launch the application.
Unprotect the stationary item and double-click on it to open it. In the "Application Name" field, you should see Add2Group. At the end of this, enter a space, followed by +I:"<.ini file name goes here>" e.g. if you've created a new document called "Jimmys Setup" Add2Group becomes Add2Group +I:"Jimmys Setup"
The document needs to be created in the "FirstClass RAD\Settings Files" folder.
| 