Update index.md

CODE_OF_CONDUCT.md

@@ -60,8 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-[email protected].
-All complaints will be reviewed and investigated promptly and fairly.
+[email protected] or reach out to us through our [CHEFS Exchange Lab - Teams Channel](https://teams.microsoft.com/l/channel/19%3a34b9d4b4deb54eebaa9be8bc1ccf02f7%40thread.tacv2/CHEFS%2520(Exchange%2520Lab%2520Team)?groupId=bef8086f-20c7-43a4-bd07-29ce764e818c&tenantId=6fdb5200-3d0d-4a8a-b036-d3685e359adc). All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the
 reporter of any incident.

docs/About.md

@@ -88,7 +88,8 @@ Do you have a feature request for CHEFS? Post your ideas, leave a comment or vot
 <details>
   <summary><strong>Contact us</strong></summary>
 
-You also can reach out to the CHEFS team directly at [[email protected]](mailto:[email protected]).
+Join in the active discussions happening on our [CHEFS MS Teams Channel](https://teams.microsoft.com/l/channel/19%3A34b9d4b4deb54eebaa9be8bc1ccf02f7%40thread.tacv2/CHEFS%20(Exchange%20Lab%20Team)?groupId=bef8086f-20c7-43a4-bd07-29ce764e818c&tenantId=6fdb5200-3d0d-4a8a-b036-d3685e359adc) or drop by to say hi in our virtual office space on a publicly accessible 
+[Common Components Discord Server](https://discord.com/channels/942948086773321799/943046207872319498). 
 
 </details>
 
@@ -99,4 +100,4 @@ Take a tour of CHEFS to see it in action. **(Youtube)**
 <iframe width="560" height="315" src="https://www.youtube.com/embed/obOhyYusMjM?si=HEnwSYnd48BWTio8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
 
 ***
-[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)
+[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)

docs/About/SoAR-and-Compliance.md

@@ -18,7 +18,6 @@ CHEFS is on a two week sprint schedule, and this review happens every second spr
 - The `pr-external`, `test`, and `prod` Environments in GitHub have `Required reviewers` in the protection rules that must only be current users
 - The `RoleBindings` in the OpenShift `-tools`, `-dev`, `-test`, and `-prod` environments of the `a12c97` and `a191b5` namespaces must only be for current `User` and `ServiceAccount` subjects
 - SysDig access must only be for current team users (`oc -n a12c97-tools get sysdig-team a12c97-sysdigteam -o yaml`)
-- The SSO environments `dev`, `test`, and `prod` must only contain current users in the groups `Realm Administrator`, `Realm Viewer`, and `operations-team`
 - The [SSO CSS app](https://bcgov.github.io/sso-requests-preview) in the `My Teams` tab must only contain current users in the `CoCo Team`
 <!--
 #### TODO:
@@ -39,9 +38,9 @@ The SoAR section "Assessment", subsection "Vulnerability Management" states:
 CHEFS is on a two week sprint schedule, and this review happens before every sprint planning meeting. In [Red Hat ACS](https://acs.developer.gov.bc.ca) ensure that the top item in the `Images most at risk` has a JIRA item created for it. If not, create a JIRA item in the Backlog using the template:
 
 - _Type_: Task
-- _Title_: ACS Image most at risk: **[IMAGE_NAME]**
-- _Description_:<br>The Red Hat Advanced Cluster Security (ACS) application has identified the image **[IMAGE_NAME]** as being most at risk. To satisfy the requirements outlined in the Security Threat and Risk Assessment's (STRA) Statement of Acceptable Risks (SoAR), this image must be updated to resolve fixable vulnerabilities (or mitigated in some other way, if updating the image is not possible).
-- _Epic Link_: CHEFS DevOps
+- _Title_: ACS Image at risk: **[IMAGE_NAME]**
+- _Description_:<br>The Red Hat Advanced Cluster Security (ACS) application has identified the image **[IMAGE_NAME]** as having vulnerabilities that are fixable. To satisfy the requirements outlined in the Security Threat and Risk Assessment's (STRA) Statement of Acceptable Risks (SoAR), this image must be updated to resolve fixable vulnerabilities (or mitigated in some other way, if updating the image is not possible).
+- _Epic Link_: CHEFS Bugs and Defects
 
 Update the log at the end of this page to show that this step has been completed.
 
@@ -59,7 +58,7 @@ CHEFS is on a two week sprint schedule, and this review happens before every spr
 - _Title_: Dependabot Vulnerability Alert for **[PACKAGE_NAME]** in **[MANIFEST_DIR]**
 - _Description_:<br>The GitHub Dependabot process has created an alert for the **[PACKAGE_NAME]** dependency. To satisfy the requirements outlined in the Security Threat and Risk Assessment's (STRA) Statement of Acceptable Risks (SoAR), this vulnerability must be handled by updating the package version (or mitigated in some other way, if updating the package is not possible).<br>
   ht<workaround>tps://gi</workaround>thub.com/bcgov/common-hosted-form-service/security/dependabot/**[DEPENDABOT_ID]**
-- _Epic Link_: CHEFS DevOps
+- _Epic Link_: CHEFS Bugs and Defects
 
 Update the log at the end of this page to show that this step has been completed.
 
@@ -80,7 +79,7 @@ CHEFS is on a two week sprint schedule, and this review happens before every spr
 - _Description_:<br>The OWASP Zap Scan process has identified a **[VULNERABILITY_RISK_LEVEL]** risk level vulnerability:<br>
   \> **[VULNERABILITY_DESCRIPTION]**<br>
   To satisfy the requirements outlined in the Security Threat and Risk Assessment's (STRA) Statement of Acceptable Risks (SoAR), this vulnerability must be remediated.
-- _Epic Link_: CHEFS DevOps
+- _Epic Link_: CHEFS Bugs and Defects
 
 Update the log at the end of this page to show that this step has been completed.
 
@@ -91,11 +90,13 @@ During sprint planning arrange for the new JIRA item to be included in the sprin
 <!-- NOTE: The log is in reverse order by date (newest at top) -->
 |Date|Access Review|ACS|Dependabot|OWASP Zap Scan|
 |:---:|:---:|:---:|:---:|:---:|
-|2024-04-11|&check;|&check;|&check;|&check;|
-|2024-03-28|&check;|&check;|&check;|&check;|
-|2024-03-14|&check;|&check;|&check;|&check;|
-|2024-02-29|&check;|&check;|&check;|&check;|
-|2024-02-15|&check;|&check;|&check;|&check;|
+|2024-06-27|&check;|&check;|&check;|Broken|
+|2024-05-30|&check;|&check;|&check;|Broken|
+|2024-04-11|&check;|&check;|&check;|Broken|
+|2024-03-28|&check;|&check;|&check;|Broken|
+|2024-03-14|&check;|&check;|&check;|Broken|
+|2024-02-29|&check;|&check;|&check;|Broken|
+|2024-02-15|&check;|&check;|&check;|Broken|
 |2024-02-01|&check;|&check;|&check;|&check;|
 |2024-01-18|&check;|&check;|&check;|&check;|
 |2024-01-04|&check;|&check;|&check;|&check;|

docs/Archive/User-Comments-and-Monitoring.md

@@ -13,7 +13,6 @@ Everything reported by users or by automated systems will be used in our sprint
 
 | Channel                      | Purpose                       | Source    | Owner #1    | Owner #2     | Owner #3     |
 | ---------------------------- | ----------------------------- | --------- | ----------- | ------------ | ------------ |
-|[[email protected]](mailto:[email protected])|General comments|Users|[Matthew Hall](https://teams.microsoft.com/l/chat/0/[email protected]) |||
 |[Microsoft Teams](https://teams.microsoft.com/l/channel/19%3a34b9d4b4deb54eebaa9be8bc1ccf02f7%40thread.tacv2/CHEFS%2520(Exchange%2520Lab%2520Team)?groupId=bef8086f-20c7-43a4-bd07-29ce764e818c&tenantId=6fdb5200-3d0d-4a8a-b036-d3685e359adc) | General comments | Users | [Walter Moar](https://teams.microsoft.com/l/chat/0/[email protected])|||
 |[#common-components](https://chat.developer.gov.bc.ca/channel/common-components)|General comments|Users|[Walter Moar](https://teams.microsoft.com/l/chat/0/[email protected])|||
 |[Stack Overflow](https://stackoverflow.developer.gov.bc.ca/)|General comments|Users|[Ayobami Idowu](https://teams.microsoft.com/l/chat/0/[email protected])|||

docs/Capabilities/Accessibility.md

@@ -12,8 +12,7 @@ We are committed to meeting your needs no matter how you use the service. We und
 ### Tell us how we’re doing
 To tell us about accessibility issues on Submit, you can:
 
-* Reach out to us through our [CHEFS Exchange Lab - Teams Channel](https://teams.microsoft.com/l/channel/19%3a34b9d4b4deb54eebaa9be8bc1ccf02f7%40thread.tacv2/CHEFS%2520(Exchange%2520Lab%2520Team)?groupId=bef8086f-20c7-43a4-bd07-29ce764e818c&tenantId=6fdb5200-3d0d-4a8a-b036-d3685e359adc)   
-* Email us at [[email protected]](mailto:[email protected])  
+* Reach out to us through our [CHEFS Exchange Lab - Teams Channel](https://teams.microsoft.com/l/channel/19%3a34b9d4b4deb54eebaa9be8bc1ccf02f7%40thread.tacv2/CHEFS%2520(Exchange%2520Lab%2520Team)?groupId=bef8086f-20c7-43a4-bd07-29ce764e818c&tenantId=6fdb5200-3d0d-4a8a-b036-d3685e359adc)
 * Create an issue on our [public GitHub repository](https://github.com/bcgov/common-hosted-form-service/issues/new?assignees=&labels=&projects=&template=bug_report.md&title=)  
 
 We will work with you to:

docs/Capabilities/Integrations.md

@@ -5,6 +5,7 @@
 * [MS Teams Channel Integration](MS-Teams-Channel-Integration)
 * [Event Subscription](Event-Subscription) (Experimental)
 * [Excel Power Query Integration](Excel-Power-Query-Integration)
+* [Salesforce Integration](Salesforce-Integration)
 
 ***
-[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)
+[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)

docs/Capabilities/Integrations/Event-Subscription.md

@@ -15,7 +15,7 @@ This should add another expandable panel section where Event Subscription parame
 
     * submission of a form, including drafts
 
-   ```  
+   ```
     {
         "formId": "ed5f9b10-xxxx-xxxx-xxxx-a6133236564a",
         "formVersion": "1a62dec9-xxxx-xxxx-xxxx-342a1cc138cd",

docs/Capabilities/Integrations/Power-BI-Integration.md

@@ -7,16 +7,28 @@ Microsoft Power BI is one of many ways to work with form submission data. The we
 
 By creating a new Power BI query you can work with the submission data.
 
-### CHEFS Form Information
-
-You will need this information about your form:
-- The `formId` and `formVersionId`. One way to retrieve them is to "Manage" your form and in the table at the bottom click "Version 1" (or the version you want). The URL in the new browser window will contain ".../preview?f={formId}&v={formVersionId}"
-- Your form's [API Key](../Data-Management/Generating-API-keys)
-
-### Query Configuration: Submissions
-
-- In the ribbon at the top of Power BI click `Get data` and select `Web`
-- Use the URL `https://submit.digital.gov.bc.ca/app/api/v1/forms/{formId}/versions/{formVersionId}/submissions` to get the submissions for a version of your form - you will need to replace `{formId}` and `{formVersionId}` with the values for your form
+You will need this information about your CHEFS form:
+- `formId`   - To put in the datasource URL and to use as the username in for the basic authorization.  
+- `API Key`  - To use as the password for the basic authorization. Instructions are available for [Generating API Keys](../Data-Management/Generating-API-keys)  
+- `formVersionId` (optional) - If you want to filter to one version.
+- `formSubmissionId` (optional) - If you want to get just one submission of a form.  
+
+### To get all submissions for a CHEFS Form 
+For the datasource, use the URL: `https://submit.digital.gov.bc.ca/app/api/v1/forms/{formId}/export?format=json`
+replace `{formId}` with yours
+
+### To get submissions for just one form version
+- You will need the `formVersionId`. One way to retrieve them is to "Manage" your form and in the table at the bottom click "Version 1" (or the version you want).
+- The URL in the new browser window will contain ".../preview?f={formId}&v={formVersionId}"
+- to get the submissions for a version of your form - you will need to replace `{formId}` and `{formVersionId}` with these values from your form
+
+### Query Configuration: Submissions  
+__Open PowerBI Desktop version.__
+- In the ribbon at the top of Power BI click `Get data` and select `Web`  
+- depending on whether you want all submissions or just submission from one version, or just one submission, you will need to use a different URL for each:
+  - ALL Submissions: `https://submit.digital.gov.bc.ca/app/api/v1/forms/{formId}/export?format=json`
+  - Form Version Specific: `https://submit.digital.gov.bc.ca/app/api/v1/forms/{formId}/versions/{formVersionId}/submissions`
+  - Submission Specific: `https://submit.digital.gov.bc.ca/app/api/v1/submissions/{formSubmissionId}/
 - Choose "Basic" for the authorization type, with "User name" set to your `formId` and "Password" set to your API Key
 
 ### Query Configuration: Submission Statuses
@@ -28,4 +40,4 @@ It is also possible to get the list of statuses for each submission.
 - Choose "Basic" for the authorization type, with "User name" set to your `formId` and "Password" set to your API Key
 
 ***
-[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)
+[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)

docs/Capabilities/Integrations/Salesforce-Integration.md

@@ -0,0 +1,56 @@
+[Home](index) > [Capabilities](Capabilities) > [Integrations](Integrations) > **Salesforce Integration** 
+***
+
+Salesforce is one of many ways to work with form submission data.  
+
+## Salesforce Integration using Named Credentials and External Services
+
+By creating a new Salesforce External service you can work with the submission data.
+
+### CHEFS Form Information
+
+You will need this information about your form:
+- The `formId` and `formVersionId`. One way to retrieve them is to "Manage" your form and in the table at the bottom click "Version 1" (or the version you want). The URL in the new browser window will contain ".../preview?f={formId}&v={formVersionId}"
+- Your form's [API Key](../Data-Management/Generating-API-keys)
+
+### Named Credentials in salesforce
+
+**Named Credentials** allow Salesforce to manage authentication for calls to external systems. This simplifies the process of calling an external APIs by securely storing authentication details and abstracting the complexity of API authentication.
+
+**Steps to Create Named Credentials:**
+
+1. **Navigate to:** Setup > Named Credentials
+2. **Click on:** New Named Credential
+3. **Fill in the Details:**
+   - **Label:** Enter a name for the credential (e.g., "CHEFSAPICredential").
+   - **Name:** This is automatically populated based on the label.
+   - **URL:** Enter the base URL of the external API as `https://submit.digital.gov.bc.ca/app/api/v1`
+   - **Identity Type:** Select `Named Principal`
+   - **Authentication Protocol:** Select `Basic Authentication`.
+   - **Username:** Enter the API username. It will be `formId` in our case.
+   - **Password:** "Password" will be set to your form [API Key](../Data-Management/Generating-API-keys)
+
+4. **Save:** This securely stores the authentication details for accessing the external API.
+
+### External Services in salesforce 
+
+**External Services** in Salesforce allow you to connect to external APIs using a declarative approach.
+
+**Steps to Create an External Service:**
+
+1. **Navigate to:** Setup > External Services
+2. **Click on:** New External Service
+3. On the Select an API Source page, select whether you’re importing an API spec From Mulesoft Anypoint Platform, or From API Specification. Since we're using CHEFS spec here, select From API Specification.
+4. **Fill in the Details:**
+   - **Service Name:** Enter a name for the external service (e.g., "CHEFSAPIService").
+   - **Named Credential:** Select the named credential you created earlier i.e. `CHEFSAPICredential`
+   - **Service Schema:** Select `Relative URL`.
+   - **URL**: Enter `/api-spec.yaml`, provides the Open API specification for all CHEFS API's. Any API's with Authorization as Basic Auth can be integrated with the salesforce External Services. Following are some of useful API's
+        - Enter `/forms/{formId}/versions/{formVersionId}/submissions` to get the submissions for a version of your form - you will need to replace `{formId}` and `{formVersionId}` with the values for your form. 
+        - Enter `/submissions/{formSubmissionId}/status` to get the statuses for each submission - you will need to replace `{formSubmissionId}` with the `id` value for each submission.
+
+5. **Save & Next:** Salesforce will parse the OpenAPI specification and generate Apex actions.
+6. You can now integrate and work with CHEFS data using the newly added External Service in your Apex code, Flow Builder, Process Builder, or any other Salesforce components that support External Service.
+
+***
+[Terms of Use](Terms-of-Use) | [Privacy](Privacy) | [Security](Security) | [Service Agreement](Service-Agreement) | [Accessibility](Accessibility)

docs/Components/Custom/Advanced-Progress-Bar.md

@@ -3,9 +3,9 @@
 
 ## Examples
 > Try a working example<br>
-> [View Example: Progress Bar with Validation](https://submit.digital.gov.bc.ca/app/form/submit?f=4e702761-c6af-4b10-91d0-0950b964cf4d)
-> [View Example: Progress Bar Using Layout](https://submit.digital.gov.bc.ca/app/form/submit?f=f20ac79e-14a7-464f-8139-f5c5de9133e1)
-> [View Example: Progress Bar Using Layout with Validation](https://submit.digital.gov.bc.ca/app/form/submit?f=ba809aaa-f975-42a8-bc20-8de12c11ec22)
+> [View Example: Progress Bar with Validation](https://submit.digital.gov.bc.ca/app/form/submit?f=e7cb5ddd-1c24-4437-a7fd-85326713013f)
+> [View Example: Progress Bar Using Layout](https://submit.digital.gov.bc.ca/app/form/submit?f=cd5eb16b-1565-419c-bed6-387281c066fc)
+> [View Example: Progress Bar Using Layout with Validation](https://submit.digital.gov.bc.ca/app/form/submit?f=655438f6-40d9-475a-bc4f-bfe76d9a04b3)
 
 
 > Download this example file and [import](Importing-and-exporting-form-designs) it into your design<br>

docs/Components/Custom/Calculating-Values-with-Dates.md

@@ -3,7 +3,7 @@
 
 ## Examples
 > Try a working example<br>
-> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=506ccffb-b0c5-49b3-8f8f-8e5f9809e1a5)
+> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=ea72822f-209e-4509-85be-0ab525846969)
 
 > Download this example file and [import](Importing-and-exporting-form-designs) it into your design<br>
 > [example_counting_days_between_two_dates_schema.json](../examples/example_counting_days_between_two_dates_schema.json){:download="example_counting_days_between_two_dates_schema.json"}

docs/Components/Custom/Dynamic-Select-Lists.md

@@ -3,7 +3,7 @@
 
 ## Examples
 > Try a working example<br>
-> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=4ee726e0-f7a7-49a1-8454-7325d2593a7d)
+> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=29700227-dbaa-478b-b4c0-e39feeba3f43)
 
 > Download this example file and [import](Importing-and-exporting-form-designs) it into your design<br>
 > [example__dynamic_select_lists_schema.json](../examples/example_dynamic_select_lists_schema.json){:download="example_dynamic_select_lists_schema.json"}

docs/Components/Custom/Navigation-Buttons.md

@@ -3,7 +3,7 @@
 
 ## Examples
 > Try a working example<br>
-> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=3fe31d91-a802-44a4-8215-03110af26470)
+> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=e0aa0b29-72a9-4268-aff1-5446d0aa7b57)
 
 > Download this example file and [import](Importing-and-exporting-form-designs) it into your design<br>
 > [example_navigation_buttons_schema.json](../examples/example_navigation_buttons_schema.json){:download="example_navigation_buttons_schema.json"}

docs/Components/Custom/Progress-Bar.md

@@ -3,7 +3,7 @@
 
 ## Examples
 > Try a working example<br>
-> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=296cb105-16f8-4dda-8d49-c83456e51345)
+> [View example](https://submit.digital.gov.bc.ca/app/form/submit?f=d4f4a0d6-52f5-445b-a1b3-32cd1f43e72c)
 
 > Download this example file and [import](Importing-and-exporting-form-designs) it into your design<br>
 > [example_progress_bar_schema.json]../examples/example_progress_bar_schema.json){:download="example_progress_bar_schema.json"}