Kavi® Members Help

Chapter 33. Kavi Members FAQ

Table of Contents

Frequently Asked Questions

Frequently Asked Questions

Members, Companies and Users

1. Can't add member record

Q:

Why can't I add this person (or company)? I got a message that the record (or email address, etc.) already exists, but a search didn't find any record of this person (or company).

A:

This person or company has an application in a pending state and won't be added to the Kavi Members 'person' or 'company' tables unless the application is approved. A moderator or administrator may edit information in the pending application, or may handle any required billing or moderation processes to expedite approval.

2. Company missing from signup form

Q:

Why isn't this company on the signup form?

A:

There are several reasons why a company that exists in the database may not appear on the Company Representative Signup form. Only active member companies that haven't opted out of being displayed on the form will be available. If the company is inactive or has opted out, it won't be displayed.

If accepted domains are enforced for the Web site and a member company is added without any accepted domains, the company will not appear on the signup form. To remedy the situation, simply add accepted domains for this company and the company will become available on the signup form immediately.

Admin Tools

1. Response Time

Q:

This tool seems to respond slowly at times. Is there anything wrong?

A:

Kavi Members Admin Tools that include a search feature are affected by the size of the database that has to be searched and the amount of the data that is retrieved and displayed. This especially applies to tools for managing or reporting on users.

The larger the number of users in the organization's database, the longer it takes to search through all that data. The effect usually doesn't present any issues beyond a mildly annoying slowdown in performance until the number of users in the database approaches 100,000. When it reaches this level, searches may occasionally time out, especially if the site is processing a heavy load from some other source, such as a large email attachment moving through a mailing list (which is why Kavi recommends posting large documents to a document repository and sending a link rather than an attachment...but I digress). Company and membership data can also be unwieldy, though this is less common.

Admins can optimize tool performance by narrowing search operations to retrieve just the information that is actually needed. The extra time you take to set specific search criteria that returns a leaner, more refined data set can easily be recouped by the reduction in tool response times. An Admin running an extensive search operation can inadvertantly create such a drain on system resources that it affects other users on the site, so it is good to make this practice a habit.

Membership

1. "Duration" versus "term"

Q:

What is the difference between a membership duration and a membership term?

A:

The duration of a membership is the length of time that a membership lasts, regardless of start or end dates. The term of a membership is the range of dates during which a membership is current.

There are three types of membership durations: 'Fixed Dates', 'Fixed Duration' and 'Lifetime'. Here are examples of each to help illustrate the distinction between duration and term.

Fixed Dates

Fixed dates membership types have a fixed start date and fixed expiration date. The standard term of this type of membership is defined by these fixed dates, and the duration is equal to the number of days (or other period of time) that elapse during this term. Memberships acquired after the fixed start date will have a term that begins on the date the membership is approved, but will expire on the fixed expiration date, so the duration of these memberships will be shorter in actuality than the duration defined for the membership type.

Fixed Duration

If a membership type has a fixed duration of one year, all memberships of this type last one year, but the terms of the memberships would vary depending on the date the membership is approved, as the start date and expiration date of each membership would be based on this date (e.g., a one-year fixed-duration membership approved on Jan 1st would have a term of Jan 1st to Dec 31st, whereas a one-year fixed-duration membership approved on June 1st would have a term of Jun 1st to May 31st of the following year).

Lifetime

Lifetime memberships have no end date. The duration of a lifetime membership is indefinite. The term's start date is set to the same date that the membership is approved, and the term has no expiration date.

See also Membership Setup.

2. Renewal intentions

Q:

How I record a member's renewal intentions?

A:

Administrators can store this information for any membership that is eligible for renewal.

  1. First, find the member. If this is a company membership, use the Manage a Company tool. If this is an individual membership, use the Manage a User tool.

  2. Scroll down to the Membership section and find the membership in which you are interested.

  3. If this membership is eligible for renewal, the 'Renew' link will be visible.

  4. Click the 'Edit' button to go to the Edit a Company Membership or Edit an Individual Membership tool. Scroll down to the Renewal Information section. Select the appropriate setting in the the 'Renewal Intention' pulldown menu (e.g., 'Undeclared', 'Intending to renew', 'Not intending to renew').

  5. You may also add comments in the 'Activity Note' field that can be retrieved from this members's Activity Record by administrators.

  6. Click 'Preview' at the bottom of the page. The information you added is displayed for you to review. Click 'Save' when you are ready to commit your changes.

Important

When a membership is designated as 'Not intending to renew', the member will not be sent any automated email renewal notifications.

3. State versus status

Q:

What is the difference between "state" and "status"?

A:

State

State refers to the state of a membership in the membership workflow.

After an application has been submitted but before it becomes 'current' it is in one of the pending states, such as 'pending moderation', 'pending_billing' or 'pending start date'. When a membership term ends, the membership moves from the 'current' state to 'expired' and eventually to 'archived'.

Status

Status indicates whether a company or user is 'active' or 'inactive'. Users whose status is 'active' can log into the Web site if they have types that convey access, whereas users whose status is 'inactive' cannot login under any circumstances. Status is sometimes referred to as a "switch" because changing from 'active to 'inactive' and back again is an instant way to revoke or enable login privileges. Active companies and users may also appear on rosters, whereas inactive ones do not.

Data Upload and Data File Management

1. Slow Upload

Q:

Why is this upload taking so long to complete?

A:

The time it takes to perform a batch upload is directly dependent on the quantity of data being uploaded. The larger the data file, the more time it takes the Upload Data tool to validate all that data. Each field in the data file is validated as thoroughly as possible to help ensure a safe upload process and minimize the chances that the upload will corrupt the database.

2. Unescaped single quote

Q:

What do I do to fix an "Unescaped single quote" error in my data file?

A:

The Upload Data tool responds with this error message when it encounters a single quote (') in a data file contains, such as when a name contains an apostrophe. The data field that contains that single quote must be escaped by enclosing the data string in double quotes. For example, if the data field contained a company named:

Top O'Morning Coffee

You'd place the double quotes around the entire data field (and not just around the part with the single quote), like this:

"Top O'Morning Coffee"

3. OO and .xls

Q:

Open Office won't open this .xls file (Microsoft Excel Spreadsheet) properly.

A:

This is a known file format compatibility issue that people sometimes encounter when using the Upload Data tool. There is a simple work-around for this problem: use the universally compatible .csv (Comma-separated value) format instead. If you are using the Upload Data tool, you can download the file in .csv format and save it locally. Open OpenOffice Calc then open the .csv file, which will automatically open properly for you. You can export the file back to .csv format when you save your changes, since the Upload Data tool requires this format.

If you aren't using the Upload Data tool, see this same procedure will work as long as a .csv version of the file is available. If someone using Excel wants to send you a spreadsheet, they can export the file to .csv. You can edit the file and also export it to .csv to work around the compatibility issue.

4. Leading Zeros Missing

Q:

Why are the leading zeros missing in the CSV data file or report that I just downloaded?

A:

There are some spreadsheet applications that remove leading zeros from the values in a column that has been interpreted as containing integer values. This most commonly occurs with postal codes.

If this happens to you, you have two options: you can use a different application, or force the application to allow you to manually re-add the zeros.

Use a different application

The values in the database do contain the leading zeros, so if you close the file without saving the zeros will still be in your data file. If you have inadvertantly saved the file, the saved local version of the file will be corrupt, so you'll have to download the report or other data file again to get a valid version.

Now open the data file in a different application and check to be sure the leading zeros are properly displayed. This could be a different spreadsheet application or a text editor.

Manually re-add the leading zeros

If you have a small amount of data that needs to be fixed, you may be willing to subject yourself to the drudgery of manually re-adding the missing zeros.

If this is report data that won't need to be uploaded into the database, you should be able to do this in your spreadsheet application. Most spreadsheet applications can handle zeros in cells that contain 'text', so select the column and set the data type to 'text'. Now type the missing zeros into the first cell and make sure the zeros are retained as you tab off the field. If the application does retain the leading zeros, fix any other fields with corrupt values and save the file in spreadsheet format (you wouldn't want to save the report as a .csv or you'd have to go through all this again the next time you import it back into this application).

If this is a data file that you need to prepare for upload, you should remove the column with the corrupt values entirely unless you need to add or edit values in that column. If you do need to include this column, follow the procedure described for manually re-adding leading zeros to reports, but go ahead and save it as a .csv file (just make sure your changes are all in place before you save it. You wouldn't want to reimport it into the spreadsheet application again before upload or you'd have to repeat this process). For more information, see Preparing CSV Files for Upload Data.

Configuration

1. Non-unique accepted domains

Q:

Can I enforce accepted domains without requiring them to be unique?

A:

If you want to have email domain matching on the signup form, but allow multiple companies to use the same email domain:

  1. Use the Configure Kavi Members: All Options tool to set the 'unique_accepted_domains' option to 'no'.

  2. Use the Configure Company Representative Signup tool to:

    • Set 'Check Accepted Domains' to any setting except for 'Never check domains'.

    • Set 'Select Company From List' to 'Yes, display a list of member companies'.

Integration with Kavi® Billing

1. Deleted or replaced memberships

Q:

What happens to a bill when I delete or replace a membership?

A:

Bills are never deleted, even if the billed membership is deleted or replaced.

2. Billing communication

Q:

How do I send a link to a member so they can pay their membership fees?

A:

Organization Admins can copy the 'Public Membership Status Page' link and paste it into an email so the recipient can use the link to view the Membership Status page and pay their bill.

Reports, Logs and Activity Histories

1. Report Takes Time to Run

Q:

Why does it take so long to run this report when others are much faster?

A:

Behind every report is a database query, so the time it takes to run a report is directly affected by the amount of data that is searched and retrieved by the query. The larger the data set being queried (the larger the number of companies and users the organization has in its database) and the broader the query results (all companies or users as opposed to a select group of companies or users), the more time it takes the database to process the query.

The best way to minimize the time it takes to generate a report is to narrow the results by setting the search criteria so the report retrieves just the information you actually need.

2. Activity history versus log

Q:

When should I view the activity history and when should I view the log?

A:

An activity history is designed to provide a human-readable overview of changes to user or company data, and is generally the quickest and easiest way to get information that will allow you to review the type of change that occured, when it occurred and the entity driving the change.

When you require highly detailed and technical information about data changes, it sometimes becomes necessary to examine the Full Activity Log for information that isn't available in more readable formats. This might include the names of the specific database fields that were changed and the new field values.

3. Fixed and Searchable Fields

Q:

What are 'fixed' and 'searchable' fields in reports?

A:

Some reports need to include fixed search criteria so that a certain set of data is always preselected for the report. For example, many organizations have reports that retrieve a list of primary contacts. To create a Primary Contact Report, the 'Contact Type' field would be fixed and set to the value of 'Primary Contact'. You don't want to be able to change the value of this field because the whole purpose of the report is to retrieve information about primary contacts.

In this Primary Contact Report example, the 'Contact Type' field would be the only fixed field, but the report could include many 'searchable' fields. The values of searchable fields can be set by Report Admins when running a report. Fields must be searchable if they are needed to create meaningful reports for the organization. Primary email addresses are very important for Primary Contacts, so this should be a searchable field. Company Name is another example of a field that would be searchable in this kind of report.

Back to top