Foundation
Attachments (record linkage over engine uploads)
This manual is a draft and may change.
What it does
Attachments keeps uploaded files private and tied to the customer, job or order they belong to. A file can be opened only by people allowed to see that record, or through a short-lived link.
Who uses it
Staff with the Attachments role view and archive files. Customers and members upload files and see what they uploaded.
Setup
- Ask your 1vsM contact to install Attachments (record linkage over engine uploads) on your site.
- It installs these first, automatically: Access, Companies / org units.
- Give your staff the Attachments role.
- Ask your web contact to confirm the private file folder and the link signing keys are set up.
- Test by uploading a file to a record and opening it as a staff member.
Admin tasks
The Files tab (under Apps, for admins) is a read-only overview. It lists the Latest files, the Download links with how many times each was used and whether it is Live, Expired, Used up or Revoked, and an Access log. Everything else happens in a Files panel that other apps show on their own record pages.
Viewing files on a record
- Open the record in the screen of the app that owns it.
- In its Files panel the files for that record are listed, oldest first, if you are allowed to see them.
- Click Download to open a file. This makes a one-use link that works for 5 minutes.
Adding a file
- Where the panel offers it, choose a file under Add a file and click Upload.
Archiving a file
- Click Archive next to a file you no longer need shown (staff with the Attachments role only). It is hidden but not erased.
Sharing one file by link
- Links for people outside your team are made by your web team: a time limit (default 5 minutes, at most 7 days) and a maximum number of opens (at most 1,000).
- A link can be switched off early; there is no button for this yet.
Member view
Members do not see this app directly. Where another screen allows uploads, they can add files and see their own uploads.
Styling it to your brand
Every app takes its colours, fonts and corners from the brand profile you enter once in the Brand intake on 1vsm.com. It applies to every app automatically, so there is nothing to set up for this one.
Troubleshooting
- A file cannot be opened and shows not found: it may be another site's, archived, or you may not be allowed to see its record.
- A file cannot be attached: the upload could not be found or did not match what was stored.
- Upload is refused: your site's private file folder may not be set up correctly.
- A link is refused: lifetime is limited to 7 days and 1,000 opens, and a signing key must be configured.
- A link stopped working: it expired, ran out of opens, or was switched off.
- A member cannot see a colleague's file: members see only their own uploads.
FAQ
Are files public? No. They are served only after permission checks.
Is archiving the same as deleting? No. The file stays on the server and is only hidden.
Can I send a link outside my team? Yes, a short-lived link for one file.
Why does an unauthorised person see not found? So nobody can tell whether a file exists.
What to connect
Nothing to connect: this app works with what is already on your site. Your brand colours, contact details and social links come from Set up your site.