Introduction
You can attach files to actions when creating them, completing them, or adding progress notes. This allows you to include supporting documentation such as test results, referral letters, discharge summaries, or other relevant clinical documents with your action records.
Before You Start
No special permissions required. Any user who can create, complete, or update actions can also upload attachments to them.
Steps
There are three scenarios where you can upload attachments to actions:
When Creating a New Action
- Navigate to the patient for whom you need to create an action:
- Click My Patients in the sidebar
- Click on the patient's name to open their profile
- Click the action menu (⋮) in the top-right corner
- Select Create Action
- The "Create new action for patient [Name]" dialogue box appears
- Fill in the required fields:
- Enter the action Title
- Search for and select the Assignee
- Optionally set a Due date and Due time
- Scroll down to the Attachments section
- Click the Choose File button
- Select the file from your computer using the file picker
- The file uploads automatically and appears in the attachments list with a file icon and the original filename
- To remove an attachment, click the trash icon next to it
- To attach additional files, click Choose File again and repeat the process
- Optionally enter a Detailed Description
- Click Submit to create the action with all attachments
The Submit button will be disabled whilst files are uploading and requires both a Title and Assignee to be completed.
When Completing an Action
- Navigate to the action you want to complete:
- From a patient profile, click on the action in the Actions tab
- Or from My Actions in the sidebar, click the action row
- Click the action menu (⋮) in the top-right corner
- Select Complete action
- The "Complete action [ActionName] for patient [Name]" dialogue box appears
- Enter the Action result (optional description of the outcome)
- Scroll to the Attachments section
- Click the Choose File button
- Select the file from your computer
- The file uploads and appears in the attachments list
- Add more files if needed by clicking Choose File again
- Click Submit to complete the action with attachments
When Adding a Progress Note
- Navigate to the action where you want to add a note
- Click the action menu (⋮) in the top-right corner
- Select Update Progress
- The "Update progress on action [ActionName] for patient [Name]" dialogue box appears
- If there are existing notes, you'll see a Previous updates section showing all prior notes with their dates, times, and authors
- In the New update field (which has auto-focus), type your progress note
- Scroll to the Attachments section
- Click the Choose File button
- Select your file from your computer
- The file uploads and appears in the attachments list
- Add additional files if needed
- Click Submit to add the note with attachments
Note: You cannot submit a progress note without entering text in the New update field. The Submit button is disabled if the note is empty or files are uploading.
File Upload Behaviour
What Happens During Upload
- When you click Choose File, your computer's standard file picker opens
- After selecting a file, the system validates the file type using MIME type detection
- Valid files upload immediately to secure Azure cloud storage
- The filename appears in the Attachments list with a file icon
- A trash icon appears next to each attachment, allowing you to delete it before submitting the form
- The Choose File button shows a loading indicator whilst uploading
- The Submit button is disabled during uploads to prevent incomplete submissions
File Type Validation
If you select an unsupported file type, an error message appears: "Error: Unsupported file extension". This message disappears automatically after 3 seconds, and you can select a different file.
Managing Attachments
- Uploaded files display with their original filename and a file icon
- Click the trash icon to remove an attachment before submitting
- You can attach multiple files by clicking Choose File repeatedly
- Files remain in the dialogue if you make changes to other fields
Confirmation
After successfully submitting the form:
- The dialogue box closes automatically
- Your attachments are saved with the action
- The action detail page refreshes to show the updated information
- There is no separate confirmation message -- the dialogue closing indicates success
If there are validation errors with other form fields, error messages appear near the affected fields, the dialogue remains open, and you can correct the errors and resubmit.
Tips
- Attachments are stored securely using Azure cloud storage with Shared Access Signature (SAS) URLs
- Files are uploaded before you submit the form, so if you close the dialogue after uploading but before clicking Submit, the attachments will be lost
- Always wait for files to finish uploading before clicking Submit -- the loading indicator on the Choose File button will disappear when upload is complete
- The Submit button will automatically become enabled once all uploads are complete and required fields are filled
- You can upload multiple supporting documents to a single action by clicking Choose File multiple times
- Attachment metadata includes the original filename, file extension, upload timestamp, and action stage (create, update, or close)