Giter Site home page Giter Site logo

bcgov / common-hosted-form-service Goto Github PK

View Code? Open in Web Editor NEW
20.0 13.0 43.0 19.01 MB

Create, edit and publish forms

License: Apache License 2.0

JavaScript 63.10% HTML 0.94% Vue 25.74% SCSS 0.52% TypeScript 9.60% Dockerfile 0.04% Shell 0.06%
forms chefs bcgov formio microservice nodejs vue citz

common-hosted-form-service's Introduction

Common Hosted Form Service License img

Tests Maintainability Test Coverage

Create, edit and publish forms.

Directory Structure

.devcontainer              - Visual Studio Code devcontainer and local environment config
.github/                   - PR and Issue templates
.vscode/                   - Visual Studio Code's Launcher and Tasks
app/                       - Application Root
├── frontend/              - Frontend Root
│   ├── src/               - Vue.js frontend web application
│   └── tests/             - Vue.js frontend web application tests
├── src/                   - Node.js backend web application
│   ├── db/migrations      - data migration scripts
│   ├── docs/              - OpenAPI 3.0 Specification
│   └── forms/             - Models, Controllers, Routes for the forms
└── tests/                 - Node.js backend web application tests
components/                - Form.io Custom Components Library
openshift/                 - OpenShift-deployment and shared pipeline files
tests/                     - External test frameworks
├── functional/            - Supporting functional tests
│   └── cypress/           - Cypress functional test suite
└── load/                  - Supporting load tests
    └── load-test/         - Chefs API load test suite
CODE-OF-CONDUCT.md         - Code of Conduct
COMPLIANCE.yaml            - BCGov PIA/STRA compliance status
CONTRIBUTING.md            - Contributing Guidelines
LICENSE                    - License
SECURITY.md                - Security Policy and Reporting

Documentation

Help, Problems, and Feature Requests

Visit the CHEFS Wiki for help on using CHEFS.

To report a problem with CHEFS please create a GitHub Issue.

Feature requests can be found in the CHEFS Feedback - vote for a feature you want in CHEFS, or add a new feature that hasn't been requested.

How to Contribute

If you would like to contribute, please see our contributing guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

Copyright 2020 Province of British Columbia

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

common-hosted-form-service's People

Contributors

alex-struk avatar bcgov-citz-ccft avatar bcvesalink avatar bigvaimarcella avatar dependabot[bot] avatar evgeny-pluzhnikov avatar itsjasonc avatar jasonchung1871 avatar jimmypasta avatar jonathan-longe avatar jujaga avatar kamorel avatar loneil avatar michaelchung123 avatar nimya-aot avatar ptugger avatar repo-mountie[bot] avatar sai-citz avatar timcsaky avatar timisenco2015 avatar usingtechnology avatar vijaivir avatar waltermoar avatar

Stargazers

avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar avatar

Forkers

usingtechnology timcsaky jujaga loneil michaelchung123 bcgov-elmsd naomiaro kamorel jasonchung1871 timisenco2015 bcdevops djnunez-aot kloudstudent bigvaimarcella maurycupitt 2011sandeepraj ptugger worktest2022 jutsk bcgov-citz-ccft vijaivir jonathan-longe midhun-aot bcgov abilpraju-aot dev-thinks bcvesalink waltermoar jimmypasta sheaphillips alex-struk chrisonsimtian bcgov-elmsd poornima-sivanand sai-citz rickyharerri nimya-aot abhilash-aot brankoeisi ryanbirtch-aot vkantchev

common-hosted-form-service's Issues

ZAP Full Scan Report

View the following link to download the report.
RunnerID:4440696349

OWAP Baseline

View the following link to download the report.
RunnerID:4420687026

ZAP Full Scan Report

View the following link to download the report.
RunnerID:6085999162

Testing Github Jira integration

Is your feature request related to a problem? Please describe

FORMS-47

Describe the solution you'd like

Describe alternatives you've considered

Additional context

Maximum Character Setting

Is there a setting to set the maximum characters allowed? I can't find any documentation and our forms have no maximum which is causing issues.

Add missing topics

TL;DR

Topics greatly improve the discoverability of repos; please add the short code from the table below to the topics of your repo so that ministries can use GitHub's search to find out what repos belong to them and other visitors can find useful content (and reuse it!).

Why Topic

In short order we'll add our 800th repo. This large number clearly demonstrates the success of using GitHub and our Open Source initiative. This huge success means its critical that we work to make our content as discoverable as possible; Through discoverability, we promote code reuse across a large decentralized organization like the Government of British Columbia as well as allow ministries to find the repos they own.

What to do

Below is a table of abbreviation a.k.a short codes for each ministry; they're the ones used in all @gov.bc.ca email addresses. Please add the short codes of the ministry or organization that "owns" this repo as a topic.

add a topic

That's in, you're done!!!

How to use

Once topics are added, you can use them in GitHub's search. For example, enter something like org:bcgov topic:citz to find all the repos that belong to Citizens' Services. You can refine this search by adding key words specific to a subject you're interested in. To learn more about searching through repos check out GitHub's doc on searching.

Pro Tip 🤓

  • If your org is not in the list below, or the table contains errors, please create an issue here.

  • While you're doing this, add additional topics that would help someone searching for "something". These can be the language used javascript or R; something like opendata or data for data only repos; or any other key words that are useful.

  • Add a meaningful description to your repo. This is hugely valuable to people looking through our repositories.

  • If your application is live, add the production URL.

Ministry Short Codes

Short Code Organization Name
AEST Advanced Education, Skills & Training
AGRI Agriculture
ALC Agriculture Land Commission
AG Attorney General
MCF Children & Family Development
CITZ Citizens' Services
DBC Destination BC
EMBC Emergency Management BC
EAO Environmental Assessment Office
EDUC Education
EMPR Energy, Mines & Petroleum Resources
ENV Environment & Climate Change Strategy
FIN Finance
FLNR Forests, Lands, Natural Resource Operations & Rural Development
HLTH Health
FLNR Indigenous Relations & Reconciliation
JEDC Jobs, Economic Development & Competitiveness
LBR Labour Policy & Legislation
LDB BC Liquor Distribution Branch
MMHA Mental Health & Addictions
MAH Municipal Affairs & Housing
BCPC Pension Corporation
PSA Public Safety & Solicitor General & Emergency B.C.
SDPR Social Development & Poverty Reduction
TCA Tourism, Arts & Culture
TRAN Transportation & Infrastructure

NOTE See an error or omission? Please create an issue here to get it remedied.

Add project lifecycle badge

No Project Lifecycle Badge found in your readme!

Hello! I scanned your readme and could not find a project lifecycle badge. A project lifecycle badge will provide contributors to your project as well as other stakeholders (platform services, executive) insight into the lifecycle of your repository.

What is a Project Lifecycle Badge?

It is a simple image that neatly describes your project's stage in its lifecycle. More information can be found in the project lifecycle badges documentation.

What do I need to do?

I suggest you make a PR into your README.md and add a project lifecycle badge near the top where it is easy for your users to pick it up :). Once it is merged feel free to close this issue. I will not open up a new one :)

Update the Common Hosted Forms link on the Wiki Page

Describe the bug

Clicking the "Common Hosted Form Service (CHEFS)" link on the Wiki page results in a server not found error.

To Reproduce

Steps to reproduce the behavior:

  1. Click on the Wiki tab in this repo
  2. Click on 'Common Hosted Form Service (CHEFS)' link in the first sentence
  3. See error

Expected behavior

It should link to https://submit.digital.gov.bc.ca/app/

Screenshots

Page with link
Server not found screen

Desktop (please complete the following information)

  • OS: [macOS - Ventura 13.1 (22C65)]
  • Browser [safari]
  • Version [16.2]

Unviewed submissions - Can we please make them obvious?

Hello,

I am working with CHEFS a lot and I am hearing that submission reviewers of forms really, seriously, are wishing that unviewed submissions (i.e., submissions they have not opened themselves), were obvious. For example, like when you have an unread email, its bold, and when it is opened/viewed, it is automatically unbolded. Similarly there is the ability to mark an email read/unread.

Can a feature like this (especially the first one mentioned) please be added at your earliest convenience? It would make a huge difference and sizeable improvement in user efficiency, experience, and satisfaction.

Thank you for your time.

CSV Export places

Describe the bug

Data is not placed in the correct columns when exporting submissions to CSV. The columns affected are those that were conditionally displayed.

To Reproduce

Steps to reproduce the behavior:

  1. Create a form that contains fields that use conditional logic.
  2. Create form submissions where there are submissions that use the conditional fields and submissions that don't
  3. Export the data as CSV
  4. Open the CSV file. The conditional field data will be placed in the wrong column

Expected behavior

Data should appear in the correct columns

Screenshots

If you need example data I can share the exported CSV file.

Desktop (please complete the following information)

  • OS: MacOS Ventura 13.1
  • Browser: Safari
  • Version: 16.2

Additional context

I was able to get around the problem by exporting the data as json. I then used the jq command line tool to convert it to CSV via the following command:

cat submissions.json | jq -r '(. | map(leaf_paths) | unique) as $cols | map (. as $row | ($cols | map(. as $col | $row | getpath($col)))) as $rows | ([($cols | map(. | map(tostring) | join(".")))] + $rows) | map(@csv) | .[]' > output.csv

Reference

I wanted to share this work around incase anyone else needs it.

Create docker-compose.yml file for non-BCGov users

Hey, I've created a demo of CHEFS for the Government of Yukon. Are you interested in incorporating a pull request that adds a sub-directory containing a docker-compose.yml file, scripts and documentation for users outside the BCGov that want to either demo CHEFS or build a local development environment?

As I see it, the following services need to be available for organizations outside BCGov that want to use CHEFS.

  • a Postgres database instance;
  • a Keycloak instance; and,
  • a Common Hosted Email Service (CHES) instance

By making it easier for organizations to use CHEFS, you make it more likely that other organizations will adopt and contribute to CHEFS. However, I recognize that these changes will add a sub-directory and documentation that may not be of interest to your primary audience -- BCGov users.

As there's a bit of work to write the documentation and create the pull request, could I get you let me know if you're interested in this PR before I spend time and expense for my client?

Thanks for your consideration! CHEFS is a great tool. I so appreciate the time and effort you all have put into this software.

Time Out when adding team member permissions

When trying to add members to review forms i get time out issue

My forms/Manage/Team management

Steps to reproduce the behavior:

  1. Go to My Forms
  2. Click on Manage/Team Management
  3. See error
image

Desktop (please complete the following information)

Tried with and without vpn
Cleared Cache/opened in private mode

  • Browser edge and chrome
  • Version [e.g. 22]

EMCR has activated preoc's and these forms need to go live on Monday May 15

Couple minor UI issues (Export Submissions and Select Columns)

Describe the bug

Noticed a couple minor UI/UX issues on the Submissions screen when looking at a form I was creating.

1
On the Export Submissions to File popup there are 2 headers for "Select the submission date". Think the first one is a typo.

2
On the Select Columns popup there is a info circle icon on its own with blank area next to it. It doesn't seem to be tied to any action or text on the screen?

See screenshots below

To Reproduce

Steps to reproduce the behavior:

1

  • Go to your list of Submissions for a form
  • Click the Export Submissions button
  • See the popup

2

  • Go to your list of Submissions for a form
  • Click the Select Columns button
  • See the popup

Expected behavior

1
Probably means "Select Data"?

2
Not sure if there's supposed to be text next to this icon, or if it's meant to click or hover.

Screenshots

image

image

Hosting My Own / Local Dev Enviornment

Hi,

I am looking at demonstrating CHEFs for use by a non-provincial (local/ regional) BC government, however, I have run into a rather tough brick wall.

What I have determined I need for just wetting up a local development instance for demonstration is; an IDIR, plus some non-public files from a confluence page AND a Pathfinder Common Hosted Single Sign-On App from the BCGov.

While it is possible, through non-trivial effort, for me to remove these dependencies, I am concerned about the future flexibility of use of this Open Source application.

ZAP Full Scan Report

View the following link to download the report.
RunnerID:7388257287

Cannot remove "Panel" label from form

Describe the bug

The label "Panel" is displayed when a Panel is used in a Data Grid. I don't think it should be displayed as it does not provide any information to the user, and is a potential distraction.

To Reproduce

Steps to reproduce the behavior:

  1. Go to Common Hosted Forms
  2. Click on Create A Form
  3. Drag a Data Grid onto the screen ( I'm using a Data Grid because I'd like to use the "Add another" functionality)
  4. Drag a Panel into the Data Grid
  5. Give the Panel a name in the settings menu
  6. Add any field(s) to the panel
  7. Click Save
  8. Click Preview
  9. The label "Panel" appears above the Panel layout.

Expected behavior

I would like the word Panel to not be displayed above the panel. Just the text I entered into the Panel's name field.

Screenshots

Preview_Panel_Text_Displayed

Editor View

Editor_View

Panel Component's Settings:

Panel_Settings

Data Grid Component's Settings:
DataGrid.mov

Desktop (please complete the following information)

  • OS: macOS Ventura (13.1)
  • Browser: Safari
  • Version: 16.2

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.