DMAS 302 Forms
Executive Summary
DMAS 302 Forms produces the weekly DMAS 302 attendance and activity form for clients of a day-centre facility. Staff start a report for a branch, facility, year and attestation period. They then open that report and build a form for every client who had visits at the facility during the period, or for one client at a time. Each form shows, for Monday to Sunday, the times the client was clocked in and out, the hours, the activities that were completed, and any weekly comments, all taken from AlayaCare. Staff can view a form, open it for signature and sign it by typing a name or drawing a signature, rebuild a form when visits change, and download or print the forms.
Key Features
- Start a new report for a branch, facility, year and attestation cycle period
- Filter the list of reports by branch (all branches when permitted)
- Build forms for all clients at once, for a single client, or for the forms you select
- Build each form from the client's AlayaCare visits, work sessions, completed interventions and comments for the week
- Hold back a form as Pending when a visit in the week is not yet complete
- View a form, open it for signature, and sign it by typing a name or drawing a signature
- Rebuild a form from current AlayaCare data
- Download the listed forms as a zip file or print them as combined PDFs
- Choose the default cycle and DMAS template in the page settings
Typical Workflow
- Choose a Branch if needed and click Apply.
- Click Start A New Report, choose the Year, Select An Attestation Cycle Period, Branch and Facility, then click Ok.
- Open the new report with Edit.
- Click Process Forms - All Clients (or Process Form - Single Client) and wait for Creating Forms to finish.
- On the All Forms tab, review the Status and Pending Reason columns. Use the row icons or right-click menu to view a form, rebuild it, or open it to sign.
- Use Download Selected Forms or Print Selected Forms to get the forms as files.
Report Output
Each form is produced as a PDF from the DMAS 302 form layout and stored with the form. The PDF is rebuilt whenever the form is processed, refreshed, opened To Sign, or signed. Forms can be viewed in the View Form window, downloaded together as a zip file named DMAS302Forms_{date}.zip (one PDF per form, named Client_{last name}{first name}{form ID}.pdf), or printed together as one or more combined PDFs named DMAS302Forms_{date}From{first}To{last}.pdf. When more than 400 forms are printed, the combined PDFs are split into groups of 400.
Report Contents
| Content | How it is determined |
|---|---|
| Form ID | The form number. |
| Agency logo | The agency logo from the agency settings, when one has been uploaded. |
| Facility name | The facility the report was started for. |
| Recipient name | The client's last name, first name from the client's visits in the week. |
| ADHC staff name | The staff name saved on the DMAS template chosen in the page settings. |
| Medicaid ID | The client's value for the form context field that the DMAS template names as the Medicaid ID, when one is set. |
| Weekday dates | Seven dates, starting with the period start date and running Monday to Sunday (month-day-year). |
| Time in / time out (each day) | The visit's closed work sessions, in your time zone. When there are two or more closed sessions, the first two are shown (in and out times for each); when there is one, that session is shown. Days with no closed work session are left blank. |
| Number of hours (each day) | The total length of the work session or sessions shown, in hours with two decimals. |
| Activities | The tasks listed on the DMAS template. For each day, an X is printed when the client had a completed intervention that day that the template assigns to that task. |
| Weekly comments | The comments on completed interventions, listed with the service date. Automatically added text (the "completed:" and "added:" user email stamps and "Please verify: comment added automatically.") is removed, and comments that are empty after that are left out. |
| Staff signature | The staff signature image saved on the DMAS template. |
| Recipient signature and dates | The signature given when the form was signed, and the signed date (year-month-day), once the form has been signed. |
Configurable Settings
Open View Settings or Edit Settings from this screen (when permitted) to change these options.
| Group | Setting | Type | Purpose |
|---|---|---|---|
| General | DMAS 302 Cycle | Dropdown | Attestation cycle used when a new report is started. It is shown read-only in the Start A New Report dialog. |
| General | DMAS 302 Template | Dropdown | DMAS template used to build the forms (staff name and signature, Medicaid ID field, tasks and the interventions that belong to each task). |
Available Permissions
The following permissions are available to be assigned to AlayaCare Roles:
| Attribute | What It Controls |
|---|---|
| View | Open the page and the report details |
| All Branches | Show every branch in the Branch filter and in Start A New Report. Without it you only see your own branch. |
| Settings View | Open View Settings to see the page configuration |
| Settings Edit | Open Edit Settings and change the page configuration |
Main Grid
The grid lists the DMAS 302 reports that have been started, newest first (9 rows per page), for the selected branch.
| Column | Description |
|---|---|
| ID | Report number. |
| Facility | Facility the report was started for. |
| Cycle | Attestation cycle. |
| Year | Period year. |
| Period | Period number. |
| Period From | First day of the period. |
| Period To | Last day of the period. |
| Added | Date and time the report was started, in your time zone. |
| Added By | User who started the report. |
| Processing Start | When processing began. |
| Processing End | When processing finished. |
| Duration | Time taken to process. |
| Branch | Branch the report belongs to. |
| Template | DMAS template used for the report. |
| Manage Records | Edit icon that opens the report. |
Main Grid Filters
| Filter | Purpose |
|---|---|
| Branch | Limits the list to reports for that branch. If you only have one branch it is shown but cannot be changed. |
Click Apply to refresh the list. Use Clear to reset the branch filter to your own branch.
Actions
| Button | Description |
|---|---|
| Start A New Report | Opens the Start A New Report dialog. A warning ("Please select a valid cycle in settings") is shown instead if no cycle has been chosen in the page settings. |
| Reset For Testing | Shown only in test environments. After confirmation, deletes every report and form. |
| Apply | Applies the branch filter. |
| Clear | Resets the branch filter. |
| View Settings | Opens the page settings in read-only mode (when settings view is permitted and settings edit is not). |
| Edit Settings | Opens the page settings for editing (when settings edit is permitted). |
| Edit (row icon, or right-click a row) | Opens the report details. |
Dialog Components
Start A New Report
Opens from Start A New Report.
| Field | Purpose |
|---|---|
| Attestation Cycle | The cycle from the page settings (read-only). |
| Year | The period year. Defaults to the current year. The previous year is also offered in January and February. |
| Select An Attestation Cycle Period | The period (with its start and end dates) for the cycle and year. Required. |
| Branch | Branch whose facilities are offered. |
| Facility | Facility to build forms for. Required. |
| Ok | Creates the report. |
Warnings are shown when no facility or period is selected, or when the facility has already been started for that period ("The facility has already been processed for this period"). Ok only creates the report record with the template from the page settings; the forms themselves are built from the report details page.
DMAS 302 Forms (report details)
Opens from Edit on a report. Use the back arrow next to the title to return to the list. The top of the page shows the Billing Cycle, Year, Period and Facility (read-only) and counts of forms that are Pending, Waiting For Distribution, Cancelled and Complete.
| Button | Description |
|---|---|
| Refresh | Reloads the forms and counts. |
| Process Form - Single Client | Opens the Process Form For Client dialog to build the form for one client. |
| Process Forms - All Clients | Builds forms for every client with visits at the facility during the period, after you confirm ("Are you sure you want to process all clients?"). Clients who already have a form that is not cancelled are skipped. |
Tabs
| Tab | Purpose |
|---|---|
| All Forms | Every form in the report, with the buttons for downloading, printing and processing selected forms. |
| Pending Forms | Forms that are still Pending. |
All Forms — Grid
The grid is paged 10 rows at a time and sorted by client last name then first name. The first three columns stay in view while scrolling. Tick the check box at the start of a row to select it.
| Column | Description |
|---|---|
| ID | Form number. |
| Client Name | Client name, last name first. |
| Facility Name | Facility the form is for. |
| Status | Pending, Waiting For Signature, Complete or Cancelled. |
| Pending Reason | Why the form is Pending (for example "Visits Not Complete"). |
| Added | Date and time the form was created, in your time zone. |
| Signed On | Date and time the form was signed. |
| Upload Status | Upload result, when one has been recorded. |
| Uploaded On | Date the form was uploaded, when one has been recorded. |
| Actions | Icons for View Form, View To Sign and Refresh. Refresh is not shown for Complete or Cancelled forms. |
All Forms — Grid Filters
| Filter | Purpose |
|---|---|
| Filter Client Name | Limits the list to clients whose first or last name contains the text (not case-sensitive). |
| Filter ID Includes | Limits the list to form numbers containing the text. |
| Filter Status | Limits the list to one or more statuses: Pending, Cancelled, Complete or Waiting For Signature. |
Click Apply Filter to refresh the list. Use Clear Filter to reset filters and reload.
All Forms — Grid Actions
| Button | Description |
|---|---|
| Download Selected Forms | Downloads the forms currently listed (after filters) as one zip file. Forms that have no PDF yet are skipped. |
| Print Selected Forms | Combines the forms currently listed (after filters) into PDF files for printing. |
| Process Selected Forms | Rebuilds the forms whose check boxes are ticked from current AlayaCare data. A warning ("Please select at least one form") is shown if none are ticked. |
| Apply Filter | Applies the filters. |
| Clear Filter | Clears the filters. |
| View (right-click a row, or View Form icon) | Shows the stored PDF of the form in the View Form window. A warning is shown for Cancelled forms. |
| View To Sign (right-click a row, or View To Sign icon) | Rebuilds the form from current AlayaCare data, then shows it with a Sign This Form button. A warning is shown for Pending forms ("Form cannot be signed when the status is 'Pending'") and Cancelled forms. |
| Refresh Form (right-click a row, or Refresh icon) | Rebuilds the form from current AlayaCare data. Not available for Complete or Cancelled forms. |
Pending Forms — Grid
| Column | Description |
|---|---|
| ID | Form number. |
| Client Name | Client name. |
Right-click a row for View or Refresh Form.
Process Form For Client
Opens from Process Form - Single Client. Type at least three characters of a client's name or number in the client box and pick the client, then click Ok. A warning ("Please select a client") is shown if no client is picked. The form for that client is then built in a Create Form panel. If the client already has a form that is not Complete or Cancelled it is rebuilt in place. If the existing form is Complete, it is cancelled and a new form is created. Cancel closes the dialog.
View Form
Opens when you view a form. It shows the form as a PDF with a Close button. When opened from View To Sign it also has a Sign This Form button.
Signature
Opens from Sign This Form.
Tabs
| Tab | Purpose |
|---|---|
| Type Name | Type your Full Name. A signature-style image of the name is shown as you type. At least two words are required ("Please enter your full name"). |
| Draw Signature | Draw the signature with a mouse or touch. A warning is shown if the box is empty ("Signature Required") or the drawing is too small to be a real signature ("Please Sign With a Proper Signature"). |
Click Ok to sign or Cancel to close without signing. Signing marks the form Complete, records the signed date and rebuilds the PDF with the signature.
Dependencies
The following tables must be configured for lookups on this view to work:
| Table | Description |
|---|---|
| AttestationCycles | Cycles offered in the page settings. Also covers its attestation cycle periods: periods offered in Select An Attestation Cycle Period. |
| Branches | Branches offered in Branch and in Start A New Report. |
| DMASFormTemplates | DMAS templates offered in the page settings: staff name and signature, the Medicaid ID field, the tasks, and the interventions that belong to each task. |
| Facilities | Facilities offered in Facility. |
| FormContextFields | Form context fields that a DMAS template can name as the Medicaid ID field. |
Processing Overviews
This section describes what happens after you confirm a processing action.
Start A New Report (Ok)
- Requires a facility, a period, and a cycle chosen in the page settings.
- Stops with a warning if the facility has already been started for that cycle, year and period.
- Saves a new report with the user, the cycle, year, period dates, branch, facility and the template from the page settings. No forms are built at this point.
Process Forms - All Clients / Process Form - Single Client / Process Selected Forms / Refresh Form
- For every day of the period, loads the facility's visits for that day from AlayaCare (only the chosen client's visits when working on one client). Cancelled visits are ignored, and so are visits with no client.
- For each remaining visit, loads the visit details, the client details, the work sessions and the interventions.
- Groups the visits by client and facility, in client name order. For each client:
- For Process Forms - All Clients, a client who already has a form that is not cancelled is skipped.
- Otherwise, an existing form that is not cancelled is reused and updated, except that a Complete form is cancelled and replaced by a new one.
- Fills in the form: recipient and facility name, the ADHC staff name from the template, the Medicaid ID, the seven weekday dates, the time in, time out and hours for each day, the weekly comments, and an X for each task on each day that had a matching completed intervention.
- Sets the status to Waiting For Signature. If any of the client's visits is not completed, the status is Pending with the reason "Visits Not Complete".
- Saves the form and creates its PDF, with the agency logo and the staff signature from the template.
View To Sign
- Rebuilds the form from current AlayaCare data using the same rules as above, without changing the saved status.
- Opens the PDF with the Sign This Form button.
Sign This Form (Ok)
- Requires a typed full name or a drawn signature.
- Saves the signature, sets the status to Complete and records the signed date.
- Rebuilds the PDF with the recipient signature and the signed date.
Download Selected Forms / Print Selected Forms
- Takes the forms currently listed after the filters are applied.
- Skips any form that has no PDF yet.
- Download builds one zip file with a PDF per form. Print merges the PDFs into combined PDF files of up to 400 forms each. The files are then downloaded by the browser.