Creating ProgramAtSite records as a Link Only

Resources that are organized and have a hierarchical structure are going to be much easier to navigate, whether you are a Resource Manager looking to make updates, or an I&R Specialist finding referrals for a client. In iCarol we follow the structure put forth by the Alliance of Information and Referral Systems (AIRS) called Agency, Program, Site structure. You can read more about this structure here.
The most detailed and complex way of organizing your referral database is to include the ProgramAtSite record in your hierarchy. This record connects exactly one Program to exactly one Site. That is to say, at a particular Site location for an Agency, a Program may be offered at that Site. And details about the way this Program operates at this Site may vary from the way that Program operates at a different Site.
ProgramAtSite records can include detailed, nuanced information about the way this Program operates at this Site. Conversely, a ProgramAtSite record may simply contain only the information that this Program is offered at that Site, and nothing more. When you go into your iCarol system, edit a Program record, and designate which Sites offer this Program, you’re essentially creating ProgramAtSite records.
But sometimes these ProgramAtSite entries that describe a simple link between a Site and the Programs offered there may not be considered true, fully fledged ProgramAtSite records depending on your organization’s policies, and having them treated as such in your helpline software may unintentional skew your results when analyzing the number of records you maintain, the staff hours needed to keep records up-to-date, etc.
In a recent release to iCarol, we created the ability for our users to say whether a ProgramAtSite record is a Link Only, meaning it is not edited or maintained by your resource managers or editors. Link Only ProgramAtSite records cannot be edited and will not contain detailed information about how this Program operates at this Site, just that the Program is offered at the Site.
This feature is currently available to any of our users who employ the ProgramAtSite record level to their resource database. If you’re not yet using an Agency, Program, Site structure in your iCarol resource database, please contact our support team for assistance.
Initial Set Up
First you need to be sure you have ProgramAtSite records turned on for editing, and turn on the Link Only feature. To do this, take the following steps:
- Log into iCarol as an Admin
- Click on “Admin Tools” from the left menu
- Click on the “Resources” tab
- If not already enabled, click on the checkbox for “Can edit ProgramAtSite records”
- Click on the checkbox for the “Enable LinkOnly ProgramAtSites”
- Click the “Save all settings” button

Creating Link Only Records
Now that you’ve turned on this feature, you can start creating these Link Only records. To do that, take the following steps:
- Click on “Resources” from the left menu
- Find or create a new Agency, Program, and Site record
- From the Program record, select a Site from the “Available sites” list
- Click the “Create ProgramAtSite as a Link Only record. Editing will be restricted” checkbox
- Then click “Add >>”
- Click the “Save” button

Converting Records
Now that you’ve created these records that are Links Only, you may find from time to time that you’ll need to convert them back to being full, editable ProgramAtSite records. Link Only and Standard ProgramAtSites can be converted from one to the other when editing the ProgramAtSite record. When converting from a Standard to Link Only ProgramAtSite all field values on the record will be cleared, and editing of the Link Only record will be restricted.
- From the Edit page of the ProgramAtSite record
- Click on the “Convert to [record type] ProgramAtSite” link above the ProgramAtSite Name field.
- Click “Ok” from the confirmation dialogue window that opens, and the record will automatically convert.
- Click the “Save” button

Impact on Automated Verification
You may be asking, how does this new enhancement impact my Automated Verification requests? Link Only ProgramAtSites will be sent merged with the Program record, even when the Automated Verification Request, Setting #6 “Send verification request to ProgramAtSite contact if one exists, otherwise Program Contacts” is selected. If Standard and Link Only ProgramAtSites exists for a Program, both separate and merged ProgramAtSite records will be sent to verifiers.
Example: Program “Fruit Collection”, is offered at three sites: 5221 60 Street (Standard), Southeast Community Centre (Link Only), and Northeast Family Centre (Link Only). When the AVR request is sent for “Fruit Collection” and setting 6 “Send verification request to ProgramAtSite Contact if one exists…” is selected, the Program verifier receives the Program and both Link Only ProgramAtSite merged, and the Standard ProgramAtSite separately to the verifier listd on the ProgramAtSite record (if available).
Reporting and Other Changes
For a number of reasons you may want to exclude Link Only ProgramAtSite records when running certain reports or other queries inside of iCarol. Here’s a quick breakdown of the areas where you can choose to do that, and ways to otherwise be aware of these records when analyzing your database.
- From the “Manage Resources”, “List all Resources” tool LinkOnly ProgramAtSites can be excluded from the list by clicking “Exclude LinkOnly ProgramAtSites”.
- From the “Statistics”, “Resources” reports LinkOnly ProgramAtSites can be excluded from results by clicking the “Exclude LinkOnly ProgramAtSites.”
- In Resource Exports, LinkOnly ProgramAtSites are flagged as LinkOnly in the “IsLinkOnly” column.
- LinkOnly records can also be excluded from Resource API results
We hope that this new ability to create ProgramAtSite records as Links Only rather than full, standard records will be useful to your agency. Should you have additional questions about this feature, please contact our Support Team.
Tags: AIRS, Automated Verification, Helpline software, iCarol Features, information and referral, Resource Management