Kavi® Members Help
Table of Contents
The characteristic that distinguishes Members Mailing Lists from other mailing lists is that subscribers are selected by a configurable query. This has many implications. Once the list has been created, subscriber information is maintained automatically, and updated in response to changes in Kavi Members or Kavi® Mailing List Manager.
Because most subscriber information is maintained automatically, Members Mailing Lists function as private, administrator-only lists that are hidden from users. Administrators manage Moderator, Allow and Deny Subscribers Lists and can switch subscriptions from Regular to Digest, but cannot remove these subscribers. Web archives are generally non-existent.
There is one default Members Mailing List created by default and this is the 'members' list, which is designed to distribute announcements to all account holders. Your organization may edit the 'members' list query to select a narrow set of users based on User Type or may add any number of custom Members Mailing Lists to serve different audiences and uses. Since query criteria is configurable, it is possible to distribute highly targeted messages or selectively populate private discussion groups. Queries can use time-dependent data such as Last Login Date or membership date ranges, so your organization can use Members Mailing Lists to send timely email to members or member representatives independent of regular Scheduled Email. Time-based queries that use date ranges can be used indefinitely without editing the query, but to use queries off-set from a specific calendar date, reset the month or year in the date fields whenever you are ready to post a message to the list.
Back to topThe query design is familiar to those who have used the Report Builder, except that all the fields are fixed, which means that a value has to be specified for each field and the database performs a query against that value depending on which operator is used. Operators can select or filter out users or companies based on the specified value of each field. Since you have to email people rather than companies, when you set criteria that retrieves companies, you are actually selecting users who belong to that company.
Query Components:
- Fixed Field
A fixed field provides static criteria that is used in the database query. The query looks at this field in the database to see whether the field value in each record meets the criteria, then selects or filters out records accordingly.
- Operator
The operators that are available for each field depend on what type of data that field contains. These may include 'is' or 'is not', or 'contains' or 'does not contain'. If the specified value is a date, operators may also include 'is before' and 'is after'.
- Default Value
Set the value for each field query. This value is used as a constant in the search function.
Like most searches, the query only retrieves users who meet all the criteria. For example, a query with two Fixed Fields, where the first Fixed Field is 'Company Type', using the 'Is' Operator and a Value of 'Sponsor'; and the second Fixed Field is 'Contact Type', using the 'Is' Operator and a Value of 'Primary Contact'; would populate the subscriber list with the email addresses of Primary Contacts for all Sponsor companies.
Figure 32.1. Query Criteria and Subscriber Selection

User accounts in the Kavi Members database are represented as colored shapes. There is a red square, a blue circle and a blue square. As each query criteria is applied, different shapes are filtered out of the selected set. In the first row the Fixed Field is 'Color', the Operator is 'Is Not' and the Value is 'Red', so any Red shapes are filtered out. In the second row the Fixed Field is 'Shape', the Operator is 'Is' and the Value is 'Square'. So only squares are selected. The blue square is the only colored shape that meets all the query criteria, so it is selected.
Back to top
A Members Mailing List query populates the Regular Subscriber List with the primary email address of the selected subscribers, and populates the Posters Subscriber List with whatever secondary, third or fourth email addresses are on file for these selected subscribers. The query doesn't populate the Moderator, Digest, Allow or Deny Subscriber Lists (although the 'listmoderator' alias is always subscribed as a default Moderator when Members Mailing Lists are created). These kinds of subscribers are added manually by administrators through the Kavi Mailing List Manager Edit Mailing List Subscribers tool. Moderator and Deny subscribers can also be added through Edit a Mailing List. It is possible to assign cross-poster privileges to other mailing lists. If the List Type supports this, the Edit Cross-Posters button is displayed on Mailing List Home.
- Regular
The Regular Subscriber List is populated with selected subscriber's primary email addresses by query, and once it is populated, it is automatically kept up to date by Kavi Members. Administrators can switch Regular subscriptions to Digest subscriptions, but cannot manually remove these subscribers from Members Mailing Lists. Subscribers cannot be added manually, either.
- Digest
Administrators can switch Regular subscribers to the Digest Subscriber List, but cannot manually remove these subscribers from Members Mailing Lists. Subscribers cannot be added manually, either.
- Posters
The Poster Subscriber List is populated with the selected subscribers' alternate, third and fourth email addresses and once it is populated, these addresses are automatically kept up to date by Kavi Members. The Posters Subscriber List is managed automatically and cannot be viewed or managed through Kavi webtools.
- Moderator
The 'listmoderator' alias is subscribed to Members Mailing Lists by default. Administrators can manage the Moderator Subscriber List through Kavi Mailing List Manager Edit Mailing List Subscribers.
- Allow
Administrators can add email addresses to the Allow Subscriber List to grant posting privileges if the List Type supports this (i.e., -u is set in the ezmlm-make argument string). These are the email addresses of list users who aren't allowed to subscribe but need to be able to post messages.
- Deny
Administrators can add email addresses to the Deny Subscriber List to block posts from these addresses. These are email addresses that would otherwise have posting privileges.
- Cross-Posters
Cross-posting privileges can be assigned to other mailing lists, so that everyone who is allowed to submit posts to the other list can also submit posts to this list. The normal posting rules apply.
Members Mailing Lists are added through Kavi Members, but you have to finish configuring your lists through Kavi Mailing List Manager tools. Once added, the mailing list query can be edited at any time to fine-tune or update the selection criteria for the subscriber list through Kavi Members Edit a Members Mailing List. Otherwise these lists are managed through Kavi Mailing List Manager tools that allow you to set moderators, add users to the deny list, view logs and generate reports, etc. These tools are all available through Mailing List Home.
The Members Mailing Lists tool displays all of your organization's Members Mailing Lists plus links you can use to manage these lists or add a new list. When you click the Manage link next to a Members Mailing List, you are taken to Manage a Members Mailing List where you are presented with the links you need to manage this list in Kavi Members and Kavi Mailing List Manager.
Super Admins can click here to visit the Kavi Members Members Mailing Lists tool.
Members Mailing Lists are displayed on the Manage Mailing Lists page along with all the other lists managed through Kavi Mailing List Manager.
Administrators can click here to visit the Kavi Mailing List Manager Manage Mailing Lists tool.
A Members Mailing List is added in Kavi Members, then you finish configuring the list in Kavi Mailing List Manager.
Use Kavi Members Add a Members Mailing List tool to set the list name and description, then define the subscriber list query in Kavi Members. When you save, the list is automatically generated using the 'Announce Only' List Type and the listmoderator alias as a placeholder for real moderator addresses.
Super Admins can click here to visit the Add a Members Mailing List tool.
At this point you click a button to go to Mailing List Home in Kavi Mailing List Manager where you can set textual details and add Moderators or other special kinds of subscribers. Click the link to Edit a Mailing List. This document doesn't cover every option available in these configuration tools, but only discusses those that have special considerations when configuring Members Mailing Lists. For information about options not mentioned here, consult the tool page help.
- List Type
By default, Members Mailing Lists are based on the 'Announce Only' default List Type, which is the best fit for most Members Mailing Lists. Since the mailing list is not yet in use, you may select a different List Type at this time if required. Since Members Mailing Lists do not allow subscribers to manage their own subscriptions, they are incompatible with List Types that have the -pS options set in the ezmlm-make argument string. This includes all the public default List Types (i.e., 'Newsletter', 'Public Discussion', 'Moderated Public Discussion').
- Web Availability and Web Archive Visibility
These options are set to the recommended levels by default. Because subscribers cannot manage their own subscriptions, Web Availability is set to 'Administrators Only'. This means that subscribers do not know that they are subscribed to these lists and cannot visit Mailing List Home. Web Archive Visibility is set to 'NO Web Archives', so Web archives are disabled. The raw ezmlm-idx archives may be available if enabled in the List Type.
- Assign Moderators
By default, the listmoderator alias is subscribed to a Members Mailing List when the list is created. This alias can receive moderation requests, but since it isn't the email address of an actual human moderator, it can't be used to post messages to the mailing list. If your mailing list uses a moderated List Type such as 'Announce Only', you need to add at least one moderator at this time through Edit Mailing List Subscribers so that this person can post messages to the mailing list.
- Set Textual Information
-
The Description was already set in Kavi Members, but you need to add the Policy and Usage statement. If you are a Super Admin, you may also want to edit the trailer text or other ezmlm text templates through Edit Mailing List Text.
Super Admins can click here to visit the Edit Mailing List Text Tool.
- Add Allow Subscribers and Cross-Posters
You can add subscribers to the Moderator and Deny Subscriber Lists through the Edit a Mailing List tool, but if you've selected a List Type that supports subscriber-level posting (i.e., -u is set in the ezmlm-make argument string), you will see the 'Cross-Posters' button that takes you to the Edit Cross-Posters tool where you can select other lists to which you want to grant subscriber-level posting privileges. To add email addresses to the Allow Subscriber List and grant posting privileges to users who are not otherwise subscribed to the list, click the link to the Edit Mailing List Subscribers tool.
When you want to edit the description or redefine the query for a Members Mailing List, return to Manage Mailing Lists and click the Manage link for the list you want to edit. You'll be taken to Manage a Members Mailing List where you can click the 'Edit' link to go to the Edit a Members Mailing List tool. Edit the query as desired and the next time a message is posted to the mailing list your revised query will be used to select subscribers.
Click here to visit the Kavi Members Members Mailing Lists tool.
If you want to edit other list-level settings or troubleshoot the list, use Kavi Mailing List Manager tools.
Back to topYou can select from an extensive set of user and company fields. Company fields are actually used to retrieve users from companies that meet the selection criteria. The query assumes that the criteria is in an 'Add' relationship, so it only retrieves users who meet all of the criteria. There is no performance penalty for selecting a lot of fields, as long as you have a clear understanding of the way that the criteria interact. If your query is complex, be sure your description provides a good explanation of what kinds of subscribers are selected. You can add more of this kind of information to the list's Policy and Usage Statement.
Tips and Tricks
- Edit the default 'members' list
The default 'members, list can be edited through the Members Mailing List tool if desired, so it can be fine-tuned to suit the organization's needs. For example, it can be configured to respect the email opt-out flag, or to select subscribers with Company Types or User Types that correspond to specific membership types.
- Lists that respect email opt-out settings
Consider selecting the 'Receive Email' User Field whenever you construct a query for an optional mailing list. Set the value of this field to 'No' and user's who have opted out of receiving email will not be selected as subscribers.
- Mandatory mailing lists
To create a mandatory mailing list, just have the query ignore the user's email preferences, so when creating this query you would not select the 'Receive Email' User Field.
- Targeted announcements
You can create a Members Mailing List to deliver announcements to users who meet a complex set of criteria, such as all active nonmembers who signed up before the year 2005.
- Primary-Contact-only mailing lists
Company-based organizations can create mailing lists that send messages to Primary Contacts only by selecting 'Contact Type' and setting it to 'Primary Contact'. These mailing lists are sometimes mandatory.
Here are some examples of how Members Mailing Lists can be used.
Create announcements lists or discussion groups for specific types of members. To create a 'sponsor_companies' mailing list, select Company Types as a fixed field, set the field value set to 'Sponsor' and all Company Representatives who belong to Sponsor companies will be subscribed to the list.
You can construct queries the exclude users or companies based on Purpose.
If your organization is strictly company-based, you only have to select Company Purpose as a fixed field, then select the 'Is' operator and set 'Member Company' as the field value.
If your organization is strictly individual-based, select User Purpose as a fixed field, then select the 'Is' operator and set 'Individual Member' as the field value.
-
If your organization is mixed (and most are), you have to select both Company Purpose and Individual Purpose to screen out nonmembers and staff.
Set the User Purpose field operator to 'Is' and select the values 'Company Representative' and 'Individual Member'. The Company Purpose field operator is also set to 'Is' and the values 'Member Company' and 'Company for Individuals' are selected.
Conversely, this could be accomplished by setting the User Purpose field operator to 'Is not' and selecting the values 'Individual Nonmember' and 'Staff Person'. The Company Purpose field operator is set to 'Is not' and the values 'Nonmember Company' and 'Staff Company' are selected.