The Personal Community Form Builder allows organizations to create digital forms that can be flagged for public use. Public forms can be accessed and submitted by users without having to authenticate with Personal Community.

These forms can be made available on the unauthenticated home page, either using the existing content files, or a custom application.

With this option, the submitted response is returned to the Workbench as a task. These tasks are routed to particular workflow group where the assigned Workbench Agent can claim and complete the task.

To use this mode you must:

• Create at least one workflow group.
• Assign Workbench Agents to this workflow group.

Form more information on workflow groups and workflow group agents, refer to the HealthShare Personal Community Workflow, Agents, and Tasks User Guide.

2.2. Custom Submission Route

With this option, the submitted response is routed to a custom submission route.  This allows sites to send the submitted form to a trusted external system. Using this route requires a site to create a transform and a business operation to create the appropriate format for the submitted form, and deliver to the external system.

2.2.1. Form Submission Transform

The transform is responsible for taking the incoming HSPortal.Production.Message.TemplateFormSubmissionRequest  and transforming it into the correct format for the final destination.  The  HSPortal.Production.Message.TemplateFormSubmissionRequest contains the following properties:

• FormData - An instance of  HSPortal.Templates.DataMart.Form.Form.
• FormCompletedbyUserMRN  - This will be empty for public form submission.
• FormAssignedToUserMRN  - This will be empty for public form submission.
• SubmissionTime  - The time the form was submitted.

HSPortal.Templates.DataMart.Form.Form  contains the following properties:

• Template - An instance of  HSPortal.Templates.Datamart.Template.   This class provides all the information about the form that the patient completed.
• Answers - An array of  HSPortal.Templates.DataMart.Form.Answer .  This is the list of answers that a patient provided.
• FDNBlob - An array of  HSPortal.Templates.DataMart.Form.JSON .  This is a JSON blob that contains the answers with a reference to their question identifier.

To create a new submission transform, follow the following steps:

1. Create a new class that extends Ens.DataTransform
2. Select  HSPortal.Production.Message.TemplateFormSubmissionRequest  as your source.
3. Select your desired target format. Note that this  is likely a custom format you've defined.
4. Map the appropriate Template FormSubmissionRequest properties to the appropriate location in the target message.
5. Compile the class

Personal Community provides a helper method that can generate an HTML document of the completed for.  This can then be passed to a PDF generator to create a PDF version of the completed document. The code samples below illustrate how to create the HTML and PDF versions of the form.

Set tHTML = ##class(%Stream.GlobalCharacter).%New()
Do ##class(HSPortal.Templates.Utils).WriteFormContainerHTML(.tHTML,pSubmittedForm.FormData.Answers,pSubmittedForm.FormData.Language,pSubmittedForm.FormData.Template)
Do tHTML.Rewind()

Set tHTMLRequest = ##class(HSMOD.HTMLtoPDF.API.Auxil.HTMLRequest).%New()
Do tHTMLRequest.AddHTMLFileFromStream(tHTML, "temp.html")
Do $classmethod("HSPortal.Forms.Transform.PDF","GetHTMLToPDFOptions",.tOptions,pSubmittedForm.FormAssignedToUserMRN,pSubmittedForm.FormCompletedbyUserMRN,pSubmittedForm.FormData.Template.Name,pSubmittedForm.FormData.Template.TemplateVersion)
Set tStatus = ##class(HSMOD.HTMLtoPDF.API).CreatePDFFile(tHTMLRequest,,.tOptions,,.tPDFStream)
$$$ThrowOnError(tStatus)	

2.2.2. Form Submission Target

Public forms can be accessed by unauthenticated users through the following routes in Personal Community:

• A link to the public form on the unauthenticated home page content file or footer content files
• A custom application that has a link to the form

3.1. Configuring a Public Form link on a Content File

A public form link can be added to any of the following content files that are accessible without authenticating with a Personal Community account.

3.1.1. Modifying Page Content