Skip to main content
Relay’s automated trigger-and-outcome design is ideal for workflows in which task assignees do not vary from case to case, so you can “set and forget” the process.  But what about workflows in which the assignees or details vary per iteration?  Or workflows you want someone else to initiate?  For these, you can use a manual start. With a manual start, the workflow does not kick off automatically, with no intervention on your part.  Instead, any folder owner, co-owner, or editor manually initiates a partially pre-configured workflow, directly from a document or set of documents that already exist in Box.  The workflow runs once.  It does not repeat.  But it can be modified and re-used.  For example, manual starts appropriate for workflows based on a single document might include
  • A contract must be reviewed by different sets of corporate executives who are assigned by different department heads
  • A loan application needs approval from any combination of underwriters and loan officers who someone else must designate
  • Product design and packaging must be completed by designers, artists, and copywriters who vary with each product
You can also establish a manual start with multiple files, such that workflow participants review all of the documents as a discrete package.  This enables you to apply the same workflow to groups of files en masse; you don’t need a separate workflow for every file in the group.  There are many reasons you may wish to do this; typically this involves either onboarding or review and approval.  For example: 
  • A marketer requiring approval for a set of brand assets for a new campaign
  • A budget proposal involving multiple supporting documents, such as a sales forecast, R&D specs, and so on, from different submitters that all most follow the same approval workflow.
  • A new head count requisition that must be approved in concert with the external-facing job description and internal-facing head count justification.
For manual starts with multiple files, all files must reside in the same folder.    Finally, for processes that require multiple folders, you can configure Relay to apply one workflow to all folders in a hierarchy (parent folders, child folders, grandchild folders, and so on).  You do not have to rebuild the same workflow each time for each folder. Examples of a multi-folder workflow include:
  • A consent form routes to key stakeholders for review and approval; each stakeholder can begin the workflow from their discrete dedicated folder.
  • Digital assets for multiple product lines are copied into one discrete folder per product line.
  • Employees submit monthly business trip expenses that must be reviewed by HR, then by Finance. A single workflow created on a top-level Employee Expense folder can cascade down to each employee’s sub-folder; within each sub-folder is to a sub-sub-folder per month or quarter.
  • New suppliers with dedicated sub-folders can on-board themselves by starting te same workflow that was applied to a top-level Suppliers folder.
In all cases, workflow creators enjoy great flexibility around the steps they’re assembling, because they can account for any combination of variables.  And before they start the process, workflow starters can add collaborators and task assignees. Important You can only create workflows that involve folders you own, co-own, or edit.  If when you identify a folder for your workflow you receive the following error message: 
You do not have sufficient permissions on a file or folder in this workflow.
Contact your Box Admin to change the Relay setting to allow editors to build workflows. Only the admin who created the workflow receives notifications. Working with manual starts Broadly, here’s how a manual start operates:
  1. The workflow creator builds and saves the workflow, setting up the various workflow steps.
  2. At any point thereafter, the workflow starter selects one or more files, then chooses the workflow around that file.
    • They can see details of the workflow before starting it, to ensure it’s the process they want.
  3. The workflow starter completes any steps the creator may have required (such as designating tasks and assignees, or inviting collaborators).
  4. The starter initiates the workflow.
The procedures for the workflow creator and the workflow starter differ, though there are similarities. Creating a workflow for someone to start manually
  1. Begin a new workflow in Relay.
  2. Under Trigger, click Manual Start.
  3. Specify the folder from which the workflow can be triggered.
    • Whoever starts the workflow can finish configuring and then initiate the workflow only from a file contained in this folder.
  4. (OPTIONAL) To cascade this workflow down to child folders, select Apply workflow to all subfolders.
relay-trigger-manual-start-event-all-subfolders-png
The workflow applies both to existing sub-folders and to any sub-folders you create after the fact.  However, if you move a sub-folder outside of its hierarchy, the workflow no longer applies.
  1. If there are tasks associated with this workflow, under Outcome, click Assign a Task.
    1. To configure this workflow with pre-assigned task assignees, enter the names of the people you want.
    2. To enable whoever starts the workflow to designate task assignees, click to move the Specify when started slider to the right. In the Assignee(s) box, Relay displays an advisory that the workflow cannot start until at least one person is assigned the task.
creating-and-running-a-manual-start-workflow2-png
  1. Complete the rest of the task outcome. (See below for a link to more details on creating outcomes and assigning tasks and task assignees in Relay.)
  2. Now add collaborators. To do this:
    1. Specify the file or folders to whom you want to add collaborators.
    2. Specify collaborators. For this, do one of the following:
      • To add collaborators to a file, under Outcome, click A File Action.
      • To add collaborators to a folder, under Outcome, click A Folder Action.
  3. If you want the workflow starter to specify collaborators, click to move the Specify when started slider to the right. In the Who would you like to share the file/folder with? box, Relay displays an advisory that the workflow cannot start until at least one collaborator is identified.  When using the Specify when started feature to specify external users, you can specify only external users who have been previously collaborated.
  4. Click Save Draft. This workflow displays in three places:
    1. In the Workflows page of Relay
    2. In the More Actions drop-down menu for the file or folder assigned in the workflow
    3. In the righthand pane, under the Details tab.
In the workflow’s tracking page, Relay displays all executions of the workflow.  It does distinguish cascading workflows — that is, it does not indicate whether it was started from a sub-folder (or from which sub-folder).  The workflow also displays in the Details tab in the right sidebar of each sub-folder, again with no indication whether it is a cascading workflow. Removing a collaborator from a workflow If a collaborator is no longer needed for a workflow, you can remove them from either the shared file/folder or the file/folder that launched the workflow.
mceclip0-png
To remove collaborators from a file or folder, under Outcome:
  1. Click either A File Action or A Folder Action.
  2. Select Remove Collaborator.
  3. Choose which file to remove collaborator from.
  4. Enter the name of the collaborator.
Starting a workflow manually
  1. Open the folder that contains the file or files you want to use to start the workflow.
    • For a single file, hover over the file you want, then click the ellipsis (…) to display the More Options menu.
    • For all files, select them all and then click the ellipsis (…) to display the More Options menu.
  2. Click Start a Workflow. The Select a Workflow window opens.
  3. Click the workflow you want. The Review Workflow window opens.  From here you can review the steps of the workflow.  If any step requires your input, it displays with a small Incomplete banner, and also prompts you to Add Assignees or Add Collaborators.
  4. When you’re done, click Start. The workflow begins, and Relay sends a notice to the workflow creator that the workflow has begun.
Notes on manual start with multiple files 
  • You cannot create a manual start on more than 20 files at a time.
  • In a multi-file manual start, when you initiate the workflow you cannot change any of the documents.  If you included a file in error or forgot a file, you must make your change and then re-initiate the workflow.
  • Acting on one file means acting on each and every one of them; you can’t create different actions for each individual file in the set, or approve some documents and not others.  In other words, creating a file copy event causes each file to be copied, adding a collaborator to one file adds that collaborator to them all, applying a metadata value to one file applies that value to all, approving one document approves them all, and so on.
To track the status of a workflow, from the Workflows page hover over the workflow you want, and then click Tracking.  The tracking page displays the status of the files in the workflow, including any files that have failed.