🇬🇧

Documentation

Glossary

Collaborating on Rigging and Lighting Plans#

This example shows how two people work separately on an online project: Person A plans the rigging in the Production Assist desktop app. Person B works on the lighting plan with Production Assist for Vectorworks. Both transfer their changes to their own workspaces. The shared master plan changes only when the workspaces are merged. The Online Workflow guide explains the individual dialogs and access rights.

You need two Production Assist accounts, a connection to the server, and an online project that both people can access. Both need Edit rights to create workspaces and transfer changes. Approvals are required only if the project uses a Review Template. The integration guide explains how to open the Vectorworks plug-in.

The older screenshot shows the Production Assist palette in Vectorworks 2021. It shows an empty drawing and is for reference only; the text describes the menu labels and workflow.

Older Production Assist palette in an empty Vectorworks drawing

Prepare the project and workspaces#

  1. Person B creates an online project on the project website and adds Person A under Project Members with Edit rights. If approvals are required, Person B selects an approval template and checks that the intended people are project members.

  2. Person B prepares the initial drawing, for example with an imported stage DWG, a truss line, and spotlights. Person B links the drawing to the online project and transfers this initial state. On the project website, Person B checks that the state is visible in the desired workspace. This example uses the master as the shared starting point.

  3. Person A selects File → Open from PA Cloud... in the desktop app and opens the project's master. The dialog shows recently changed projects and a selection of all accessible projects. The screenshot shows an older English interface; the current workflow is described under Check out a project.

    Older desktop dialog for opening an online project

  4. Person A creates the rigging-start workspace using PA Cloud → Create Workspace. Person B creates a separate workspace for the lighting plan, for example licht-start. Both workspaces start from the selected initial state. Changes in a workspace do not yet appear in the master.

Work on and transfer changes separately#

  1. In the rigging-start workspace, Person A adds the suspension points and a prerig to the truss line. Person A creates the required worksheets, such as a material overview for the trusses.
  2. In the licht-start workspace, Person B adds fixture numbers and the lighting and power patch. Person B creates a worksheet for the lighting plan if needed.
  3. Both save their local drawing and then select PA Cloud → Transfer Changes.... In the dialog, they review the differences, select the changes to transfer, and enter a clear summary in the Description field. The commit is what makes the changes available in each online workspace. Saving locally alone does not publish them.
  4. On the project website, both open the Change Request for their workspace. They review the differences under Change to Master and see previous commits under Changes. They can resolve questions under Comments.

Update the shared master plan#

  1. If the project template requires approvals, the assigned people review the change requests and select Approve Changes or Reject Changes. Approval itself does not update the master. If automatic checks are configured, those must also pass.
  2. Once the button is available, an authorized person selects Merge Changes into Master... on the first change request. They then review the master plan. If the button is disabled, they check the displayed approvals, checks, and possible conflicts.
  3. Before merging the second change request, the person editing it can update their drawing from the new master state using PA Cloud → Update Current Workspace from Master.... They decide which value to keep for any displayed property conflicts, review the local result, and transfer it to their online workspace using PA Cloud → Transfer Changes.... An authorized person then merges this workspace too and checks the master plan again.

The project website and shared project links and QR codes show only transferred online states. Recipients need project access unless they have a public share link.

Extension for grandMA3#

A third person could then prepare a light show in grandMA3. However, this repository does not document checking out, creating a workspace, committing, or reviewing a change request for the current grandMA3 integration. Plan these steps only after testing the installed integration. The MVR workflow describes file-based exchange with applications that support MVR.