FAQ: Can I create a custom URL for a pre-filtered view of the Course Catalog?

Yes, certain parameters can be added to the end of the CE Catalog URL to display a pre-filtered view of the catalog. The catalog can be pre-filtered based on the following criteria: 

URL Format: https://[Your Domain]/s/catalog?[Parameter]
Example: https://universityclinic.rievent.com/s/catalog?specid=4

To combine multiple filters, use commas to separate ID’s for the same filter type, and use the "&" symbol to add additional items for filtering. When combining multiple filters, the order in the URL does not matter. For example, in the URL below, we have filtered by the Cardiology (id=4) and Endocrinology (id=10) specialties, the Enduring activity type (id=3), and ordered the results by newest activities first (order=startdate):

Example: https://universityclinic.rievent.com/s/catalog?specid=4,10&atid=3&order=startdate

Follow the links below for more detailed instructions on how to pre-filter the CE Catalog:

• Pre-Filtering Based on a Keyword
• Pre-Filtering Based on Order
• Pre-Filtering Based on Activity Metadata
• Combining Multiple Filters
• Filter Examples

Pre-Filtering the CE Catalog based on a Keyword

You can pre-filter the CE Catalog by a specific search term by using the URL parameter below:

• Parameter: search=[keyword]
• URL Format: https://[Your Domain]/s/catalog?search=[Keyword]
• Example: https://universityclinic.rievent.com/s/catalog?search=ischemic

Pre-Filtering the CE Catalog based on Order

You can pre-sort the catalog based on newest, expiring soonest, credit, and name using the URL parameters below:

• Parameter: order=[ORDER TERM]
• URL Format: https://[Your Domain]/s/catalog?[URL Order Parameter]
• Example 1: https://universityclinic.rievent.com/s/catalog?order=enddate 
• Example 2: https://universityclinic.rievent.com/s/catalog?specid=4,10&atid=3&order=startdate 

Pre-Filtering the CE Catalog based on Activity Metadata

In order to create the pre-filtered URL, you first need to find the available metadata and corresponding IDs for your specific organization.

The following steps will show the existing metadata IDs for published activities.  If you have a metadata term that has not been used by an activity yet, you will not see it listed.  

1. Open the JSON Formatter and Validator by going to the the following URL: http://jsonformatter.curiousconcept.com
   
   
2. In a separate browser tab, open up the CE Catalog for your organization and copy the URL.
   
   IMPORTANT: If the URL includes any parameters after the /s/catalog portion be sure NOT to include them.  The URL that you copy should be in the following format: https://universityclinic.rievent.com/s/catalog
   
   
   
   
3. Go back to browser tab with the JSON Formatter and Validator and paste the URL into the field.
   
   
4. Add /metadata.json to the end of the URL and click Process.
   
   Example: https://universityclinic.rievent.com/s/catalog/metadata.json
   
   
   
   
5. You will now see the translation of your CE Catalog’s metadata broken down in line items. Scroll through the list and identify the ID for the specific metadata term you want to filter by. 
   
   
   
   
6. For this example, we will create a filter based on one specialty, Cardiology.  Scroll down through the JSON translator until you find the ID number for Cardiology. In this case (still using University Clinic's metadata), the ID is 4. 
   
   Use the chart below to figure out the correct parameter for the metadata category you would like to filter by. Then, replace the [ID of metadata term] with the ID you identified in step 5. 
   

   Metadata Category	URL Parameter
   Therapeutic Area/Specialty	specid=[ID of metadata term]
   Topic	topid=[ID of metadata term]
   Audience/Profession	profid=[ID of metadata term]
   Category	catid=[ID of metadata term]
   Audience Category	acid=[ID of metadata term]
   Media Format	mfid=[ID of metadata term]
   Activity Type	atid=[ID of metadata term]
   Publication	jid=[ID of metadata term]

   
   URL Format: https://[Your Domain]/s/catalog?[Parameter]
   Example: https://universityclinic.rievent.com/s/catalog?specid=4
   
   Formatting the URL to only show "Cardiology" tagged activities would be done in the following way: https://universityclinic.rievent.com/s/catalog?specid=4
   
   
   
   

Combining Multiple Filters

URL Format: https://[Your Domain]/s/catalog?[Parameter=ID#1,ID#2]&[Parameter 2]&[Parameter 3]

To combine multiple filters, use commas to separate ID’s for the same filter type, and use the "&" symbol to add additional items for filtering. When combining multiple filters, the order in the URL does not matter. For example, in the URL below, we have filtered by the Cardiology (id=4) and Endocrinology (id=10) specialties and the Enduring activity type (id=3):

Example: https://universityclinic.rievent.com/s/catalog?specid=4,10&atid=3
Example 2: https://universityclinic.rievent.com/s/catalog?atid=3&specid=10,4