Visit Frequency Rules

This article describes how admins can set up Visit Frequency Rules for their pantry

Definition

In PantrySoft, a Visit Frequency Rule is a prescription describing how often Clients may visit your pantry under certain circumstances. A single Visit Frequency Rule couples a frequency (say, once per month) with a set of circumstances (one or more Visit Types and one or more Client Statuses).

By default, PantrySoft has a single Visit Frequency Rule governing all Visits. That default frequency is one Visit per month.

Adjusting Visit Frequency Rules

Perform the following steps to edit Visit Frequency Rules:

1. Log in as an Admin
   Log in with a Dashboard role that sees/ has access to the Setup menu.
   
   
2. Go to Visit Frequency Rules
   Go to Setup->Visit Frequency Rules.
   
   

Creating a New Frequency Rule

A Visit Frequency Rule is a group of "visit circumstances" assigned to a single frequency. Those circumstances are:

- A specific detail about the intended Client— the Client Status. 

- A specific detail about the intended Visit— the Visit Type.

Admins use the Visit Frequency rules to dictate that a Client of a certain type or types (Client Status)— visiting under a certain "program" or "programs" (Visit Type)— can only visit that way a certain amount of times in a given period.

"It's really a Frequency Rule Group..." A single Visit Frequency Rule applies to all of its circumstances... as a group. For instance, if a "once per week" rule included both the Hot Meal Visit Type and the Sack Lunch Visit Type, a Client logging a Hot Meal Visit one week could not then log a Sack Lunch Visit until the next Monday after their Hot Meal. If the admins wanted to permit these two visit types separately— each one with their own 1 week frequency— they should make a different Frequency Rule for each Visit Type.

Perform the following steps to create a new Visit Frequency Rule from the Visit Frequency Rules screen:

1. New Rule
   Click Create New Visit Frequency Rule button.
   
   
2. Name the Rule
   Enter a name for the new Rule in Rule Name field, for instance, Counseling Visit Frequency.
   
   
3. Select a Client Status (default is All)
   Select a particular Client Status for this rule. For instance, a pantry might have several Client Statuses like Light Service, Moderate Service, Full Service. Such a pantry may wish to tie different Visit frequency rules to each of their three Client Statuses (Client types, basically).
   
   (NOTE: Leave this setting on All if your pantry doesn't intend Client Status to dictate Visit Frequency.)
   
   
4. Select Visit Type(s)
   Select a particular Visit Type or set of Visit Types to which this rule will apply.
   
   For instance, a pantry with Counseling Visit and a Pantry Visit Visit Types might want to create a visit frequency rule that applies only to their "counseling visits". They would then create a new rule and select only Counseling Visit Visit Type from the list.
   
   
5. Create a Frequency
   Use the Allowed Visits Per Interval, Visit Interval, and Visit Interval Unit fields to create a Visit frequency for this rule.
   
   For instance, "2 Visits every 1 Month" is expressed like this:
   - Allowed Visits per Interval: 2
   - Visit Interval: 1
   - Visit Interval Unit: Month.
   
   (NOTE: "Weeks" reset on Sundays, and "Months" reset on the first of every month. If you intend to set up a rolling frequency, like "every 7 days," or "every 30 days," use Days for your Visit Interval Unit instead of Weeks or Months)
   
   
6. Confirm / Edit Alert Text
   Change the Visit Frequency Alert Text if desired. This is the language displayed on the popup when a User is in danger of violating this rule upon Saving and Exiting.
   
   
7. Save and Exit
   Click Save and Exit.

Encountering a Visit Frequency Limitation

Visit Frequency Rules behave differently depending on the PantrySoft interface (Dashboard, Kiosk, or Online Portal). Every User set up in PantrySoft has access to the app through a single interface; for more information on setting up a User, see User: Roles.

Simple Visit Frequency warning (single or default Visit Frequency Rules)

Complex Dashboard Visit Frequency warning (multiple Visit Frequency Rules)

Following are the different presentations of the Visit Frequency Rules for each of the three interfaces:

Dashboard

In the Dashboard interface, a Visit Frequency Rule popup will warn you about a possible violation. If your pantry has a complex (multiple) Visit Frequency scheme, the popup will educate you about your pantry's various Visit Frequency Rules— specifically as they pertain to this Client at the current date and time (see Complex Dashboard Visit Frequency warning popup above for an example).

Inside the Visit screen, red Visit Types in the Visit Type field indicate the Visit Types this Client would violate, should you make one for the current date and time.

Only in the Dashboard interface can you choose a red/ "forbidden" Visit Type and still Save and Exit. 

Kiosk

The Kiosk interface offers the same experience as the Dashboard Visit Frequency warnings (see Dashboard section immediately above), with the following exceptions:

• The Kiosk interface will not let you open a Visit screen at all if there are no black/ "authorized" Visit Types available to this Client at this time.
• You cannot Save and Exit a Visit if you have chosen a red/ "forbidden" Visit Type.

Online Portal (special)

At the time of this writing, Online Portal customers can only reserve one future appointment at a time.

For this reason, Online Portal customers will only encounter frequency rules if they try to schedule an appointment too soon after a recent, past appointment. In this case, the screen will simply neglect to show them appointments which would violate the pantry's Visit Frequency Rules.