Toggle menu

Case Type - Member Enquiries

Introduction

This plugin handles cases raised by a councillor or other elected official, usually on behalf of a constituent. The form used to raise the case captures the councillor's details (or the details of the person raising the case if different), information about the case, optionally records the contact details of the constituent, allows the councillor to set a priority, and has privacy options that lets the case be shared with other members in the ward or party.

Raising Cases

Details

The first page of the form behaves differently, depending on who is raising the case. The form is able to calculate who is raising the enquiry by comparing the details of the current user to those of the councillors found in "lookups" (see Councillor Details).

If a councillor is raising the case themselves their details will be displayed on the first page of the form.

ME Councillor Details

If the case is being raised by someone other than a registered councillor, the user will have to enter their details then pick a councillor from the drop-down field.

ME Pick a Councillor

The type enquiry will be one of the subjects defined in the Member Enquiries Configuration. This configuration directs different types of enquiry to different case manager user groups.

A case can also be assigned a priority, which is visible to the case manager when they view the case details.

Constituent

The constituent details are optional. They let the person raising the case enter the constituent's name and address.

Privacy

Member Enquiries have three privacy options which restrict who can see information about the case in the dashboards.

  1. Do not share - Only the councillor can view this case on the dashboard
  2. Share with members in my ward - Any member assigned to your ward can view this case on the dashboard
  3. Share with members of my party in my ward - Only members who share both your party and ward can view this case on the dashboard

Configuration

End Points

There are four End Points in the goss.CaseManagement.v1.cases.memberenquiry namespace.

getCaseConfig

This End Point holds the main case configuration and has the same options as described in the core Case Management documentation.

getDashboardData

This End Point is used by the dashboards and shouldn't be edited.

getMetadata

This End Point retrieves the metadata values related to articles and shouldn't be edited.

getMetaDataConfig

This End Point maps the type of enquiry to the case manager user groups responsible for them. Update the keys and values to match your needs and user groups.

"subjectTypes": {
    "Rehousing": "CM-ME-HOUSING",
    "Council Housing": "CM-ME-HOUSING",
    "Housing Benefit": "CM-ME-HOUSING",
    "Rent": "CM-ME-HOUSING",
    "Waste Management": "CM-ME-WASTE",
    "Highways Management": "CM-ME-HIGHWAYS"
}

There are two versions of the form used to raise member enquiries. One simply displays a drop-down of subjects that can be picked. The other uses metadata values related to articles in iCM.

Metadata Values and Articles

Member Enquiries can be set up to use metadata in the same way as the Complaints and Feedback plugin.

In this mode, you should create an article in iCM for each type of enquiry that could be made.

Each article should have the appropriate metadata value related to it:

Metadata Example

These values correspond to subjectTypes in the case configuration, which will map cases to the user groups responsible for them.

Then relate the form used to raise member enquiries to each article. 

Councillor Details

Councillors and their political parties are set up using the "Lookups" section of the Configuration Manager.

Political parties have a name and auto-generated ID.

Councillors have a name, auto-generated ID, a party chosen from those set up above, a ward taken from the goss.Lookups.getWards End Point, an email address and a phone number.

Councillor Config

The email address you enter for a councillor must match the email address in their user profile. When a councillor raises a case the address stored in their profile is compared to those entered here to determine which form fields they see.

Last modified on March 22, 2023

Share this page

Facebook icon Twitter icon email icon

Print

print icon