cds-snc / cds-snc/platform-forms-client
Update "Departments" dropdown/searchable list form component with latest source of truth
- Dominant language
- TypeScript
- Stars
- 46
- Forks
- 16
- Avg merge
- 1d 8h
- Merged PRs (30d)
- 85
Description
## User story
As a **GC Forms client** building a form,
I need confidence that if I add a "Departments" component to my form,
That the list is complete, accurate, and comprehensive for end users filling out the form, including that my own organization is there as well as ALL of the GC organizations one would expect.
As a **person filling out a form** with a "Departments" question,
I need to be able to find the relevant GC Organization that I need,
So that I can answer the form accurately and submit the form if the question is required.
> Comparison of `all.csv` from `cds-snc/gc-organisations` and the `reference standard`: **https://drive.google.com/file/d/1qsk3I6PhOBEqj0y7JpyhWopf6fAJeSy3/view?usp=sharing**
---
## Description
Update our [GC Forms JSON list](https://github.com/cds-snc/platform-forms-client/blob/main/lib/managedData/data/organizations.json) that gets pulled into the managed "Departments" dropdown component to use the latest/full list from TBS [Reference data on Government of Canada organization names](https://open.canada.ca/data/en/datastore/dump/cb5b5566-f599-4d12-abae-8279a0230928?format=json) -- there is also a usable GitHub repo [GCOrgName](https://github.com/CPDI-CPDI/GCOrgName) we can use.
Ensure it includes agencies and crown corporations, such as "Canada Water Agency" (Support tickets [#26294](https://cds-snc.freshdesk.com/a/tickets/26294) and [#28742](https://cds-snc.freshdesk.com/a/tickets/28742)).
> For the component added to a form, it does not matter whether CDS can serve the organizations in the list or not, because it is for clients' use. We might want to understand the use cases a bit better here to offer the most helpful list(s). Main flag here is that we should be sure to classify the organizations properly (e.g. make sure departmental corporations are not listed as crown corporations).
---
## Other follow-ups / opportunities
- Allowing form fillers to search the list based on departmental acronyms #5985
- Allowing a way to configure the list for what a client would like to include, for instance filtering based on an accurate classification, such as [FAA schedules](https://www.canada.ca/en/treasury-board-secretariat/services/reporting-government-spending/inventory-government-organizations/overview-institutional-forms-definitions.html) #6721
> Ministerial departments (Schedule I)
> Departmental agencies (Schedule I.1)
> Departmental corporations, including Service agencies (Schedule II)
> Parent crown corporations (Schedule III), as well as 9 additional parent crown corporations
> Portions of the Core Public Administration (Schedule IV)
> Separate Agencies (Schedule V)
---
## Acceptance criteria
- [ ] Update EN/FR JSON organizations lists
- [ ] Add acronyms to search
- [ ] Ensure list includes all past organizations as well as new updates
- [ ] Make component customizable by organization type
- [ ] QA testing as form builder/form filler
Contributor guide
Assessment
This issue has not been assessed yet.