ATC Scripts and Automatic Workflow

Concepts

sfPMS uses special ATC commands within workflow scripts as a means to tell the system to do specific things at specific times.  By creating ATC workflow scripts, you can set up automatic workflow to run at specific times, for a specific document, or for certain documents that use predefined routes.

Workflow refers to the set of relationships between all the activities in a project, from start to finish.  These activities are tracked by various Doc types, some of which trigger new activities during the course of their routing or when they are saved or their status changes to Pending, Approved or Closed.

Automatic workflows can include simple scripts to alter the workflow and even create new documents.  For example, you might want a Project Setup document to use automatic workflow to create one or more Punchlist documents, each routed to the correct person.  Or you might want your Pay Request document to create next month’s Pay Request with instructions not to send it to the appropriate person until three or four days before it is due.

Automatic workflows are started in one of three ways:

  1. When a document condition triggers a workflow script according to a event established in the Workflow Script tool;
  2. When a Spitfire document is routed to a special built-in user called Spitfire. The basic concept is that you can route something to “Spitfire” and set a due date.  When that due date is reached, “Spitfire” will send the document to the next sequence in the route, continuing the workflow.  You can even use “Spitfire” as the routee more than once in a route.
  3. [V2017] When a button in the browser is bound to a click event handler that calls sfRunWorkflowScript() with the name of a script in the workflow script library.

Permissions

We recommend that most, if not all, workflow scripts be created and managed through the Workflow Scripts tool, found on the System Admin Dashboard.  You must have the SYS | Global Access role capability or the PAGE | System Admin Dashboard and PART | Maintain Workflow Script Library role capabilities to access this tool. In order to create the actual workflow scripts, whether on the Workflow Scripts tool, the Routes tool (on the Manage Dashboard) or a document’s route, you must have the DOC | Can edit workflow role capability. [See the Designing User Roles technical white paper.]

For more information, see the links on the right sidebar.


Last updated: November 29, 2017 at 13:36 pm