Projects

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:

FieldPurpose
Project assignment and Contract partnerConnects the contract to the project and a CRM contact.
Contract typeDistinguishes guest performance, fee, cooperation, and other contracts.
Comment / NoteStores supporting information outside the uploaded file.
Amount and currencyRecords the fee, contribution, or other value.
KSK-liable, Foreign tax, reverse chargeRecords relevant additional amounts and reasons.
Deadline dateShows when the document or next action is required.
Contract status and Contract status commentDocuments the processing stage.
Document access forSelects 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.

Select the responsible person who should provide the file (Assign to user). They receive a notification. If you leave the field empty, the request is listed under Unassigned.
Choose the project and contract partner. In the project component the open project is already filled in. You can only choose projects you are allowed to open. Enter the partner as text under Contract partner or take it from the CRM with Link CRM contact.
Prepare Contract value, Legal form, Contract type, tax-related details, Contract status, and comment where known.
Set a deadline and note. If you pick a project with a budget deadline via the project search, Artwork enters it as the Deadline date; it stays editable. When creating from the project component the field stays empty.
Send the request and monitor its status in your created requests.

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

NeedComponent
General file without special protectionProject documents
Contract file with amounts and restricted accessContracts
Ask a person to provide a missing contract fileDocument request
Accommodation, travel dates, and per-diem costsArtist residency
Issued equipment or custom materialMaterial issue
Short external reference instead of a fileLink or link list

On this page