Documents, contracts & additional project data
Manage files, document requests, contracts, artist residencies, and material issues
Projects can contain different specialist components. What you see depends on the configuration and your permissions. This chapter covers the standard workflows for project documents, contracts and document requests, artist residencies, and material issues.
Project documents
Documents can belong to a particular tab or appear in an All documents component that combines files from across the project. Common examples are production plans, technical riders, press materials, quotations, and approvals.
Depending on the file type and permissions, you can upload, download, preview (images and PDFs), print or delete a document. Visible in defines in which upload areas of the project a file appears. This setting only exists if the project has several upload areas; people with write access to the component and the project management can change it. An uploaded file cannot be renamed or replaced here: delete it and upload the new version.
Tab-specific documents keep specialist areas separate; the combined view supports handover and helps prevent files in another tab from being missed.
If a tab is shared via an external access, invited people can view and download the tab's documents — and, if file upload for externals is allowed, upload their own files. Such files carry the badge Uploaded externally by … in the component.
Contracts
Contracts are protected project documents with additional structured data:
| Field | Purpose |
|---|---|
| Project assignment and Contract partner | Connects the contract to the project and a CRM contact. |
| Contract type | Distinguishes guest performance, fee, cooperation, and other contracts. |
| Comment / Note | Stores supporting information outside the uploaded file. |
| Amount and currency | Records the fee, contribution, or other value. |
| KSK-liable, Foreign tax, reverse charge | Records relevant additional amounts and reasons. |
| Deadline date | Shows when the document or next action is required. |
| Contract status and Contract status comment | Documents the processing stage. |
| Document access for | Selects individual users and teams allowed to view the contract. |
When uploading, you can also create tasks and assign them to a person who has document access. Project management automatically sees the contracts of its project without being released individually.
Check access before assigning tasks
Only assign a contract task to someone who can also access its document. Contract access and general project access are separate safeguards.
Document requests
A document request starts the process before the contract file exists. The Contracts & documents component separates five tabs:
- Assigned to me: open requests for which you should provide a file,
- Created by me: requests whose progress you follow,
- Unassigned: requests of this project without a responsible person,
- Assigned to others: open requests of this project assigned to other people, with Requested by, Assigned to, status and deadline,
- Completed requests: finished requests with the uploaded file.
The tabs Unassigned and Assigned to others are visible to people with the permission to create or edit document requests, and to admins. The cross-project overview is described under Document requests.
Creating a request
The button Create document request is shown to people with the permission Create document requests and to admins. No field of the window is mandatory.
The responsible person chooses Upload document in the menu of the request. The upload window is prefilled with the prepared contract data; only the contract value is not carried over and has to be entered there again. The requesting person is already entered for document access, and further people can be added. With the upload the request moves to Completed requests and links to the resulting contract.
Requests can be edited and deleted via their menu. Both require the permission Edit document requests and then apply to all requests, not only to those you created. Use View details to check the responsible person, deadline, amounts and current status.
Artist residencies
The Artist residencies component documents an artist's or CRM contact's stay and its costs. At least one accommodation must exist first; without one the dialog only shows a notice that points to the CRM and, with the permission Use CRM, the link Open accommodations in the CRM Coming with the next update. The CRM contacts of the Accommodation type with their room types and cost per night are offered for selection (see Accommodation and room types). You can also create accommodations on the Accommodations page and store the defaults Daily allowance and Deduction per breakfast per accommodation there.
The Accommodations page has no menu item
No menu entry leads to the Accommodations page. You
open it by appending /accommodation to the address of your artwork
instance. Two links lead to the page of a single accommodation
Coming with the next update: in the residency dialog below the selected
accommodation, Edit daily allowance and breakfast deduction of this
accommodation (opens a new tab, the entries in the dialog are kept),
and on the CRM detail page of the accommodation, Open accommodation
page. Both only appear if you may open the page. It can be viewed by anyone with the permission Use CRM or
with access to at least one project; creating and changing requires
Manage CRM or write access to at least one project.
In the residency you can then record:
- artist or CRM contact,
- accommodation and room type,
- arrival and departure dates and times,
- cost per night,
- Daily allowance and Additional daily allowance,
- Number of breakfasts and Deduction per breakfast,
- description and organisation-specific CRM fields.
The number of nights results from the arrival and departure dates. From this Artwork calculates:
- costs for overnight stays: nights × cost per night,
- daily allowance entitlement: daily allowance × (nights + additional days),
- breakfast deduction: number of breakfasts × deduction per breakfast,
- payout per diem: daily allowance entitlement minus breakfast deduction.
The totals are updated with every change. Review arrival/departure days and breakfast deductions before exporting.
Daily allowance and Deduction per breakfast are prefilled. If the selected accommodation has its own defaults, these apply; otherwise the general default from the artist residency settings applies. If you change the accommodation while creating a residency, both fields are overwritten with its defaults. For a residency that is already saved, the entered values stay when you open it.
Do not save artist in database records a residency without creating a permanent record for the person. If you change details of a linked person in the dialog, Apply changes to artist in CRM decides whether they are written back to the CRM contact.
The export offers three types: PDF-Export, Excel-Export and Per Diem Export (per diem statement as PDF), each in German or English.
You change the name of a residency directly in the table: a click on the name opens an input field in the cell, Enter saves, Escape discards. This applies to all residencies; a linked CRM record remains untouched.
Material issues
A material issue connects the project with inventory. It can contain inventory items, custom items, quantities, period, room, responsible people, notes, tags, images, and other files. In the project view you can expand issues, filter them by tags and check their article details, images and files.
If the period of an issue differs from the project period, a warning icon appears next to its name. The Material issue log (history icon above the list) records changes and helps trace adjustments to quantities, dates, or assignments. It opens set to the current project and can be narrowed down by project, period, search term and issue type. Only people with the permission Material issue log and admins see the icon.
Material issues are visible to everyone who may read the project. Team members with write permission in the project can create and edit the material issues of their project in the project tab, even without the inventory permission for material issues.
Project view and inventory overview
The project shows the issues of this production. The central material-issue overview is better for searching or filtering across projects and rooms.
Choosing the right component
| Need | Component |
|---|---|
| General file without special protection | Project documents |
| Contract file with amounts and restricted access | Contracts |
| Ask a person to provide a missing contract file | Document request |
| Accommodation, travel dates, and per-diem costs | Artist residency |
| Issued equipment or custom material | Material issue |
| Short external reference instead of a file | Link or link list |
Last updated on