What are you looking for?

    Didn't find what you were looking for?

    Extend your Search in Community

    Got any questions?

    We're always happy to help with questions you might have. Contact Us

    Didn't find what you were looking for?

    Extend your Search in Community

    Got any questions?

    We're always happy to help with questions you might have. Contact Us

Manager Topics

Job Definitions

   Journey Manager (JM) Previously known as Transact Manager (TM).  |    System Manager / DevOps  |  v5.1 & Higher This feature is related to v5.1 and higher.

Manager allows you to define and configure a job services, which processes collaboration jobs, using a single JSONJSON (JavaScript Object Notation) is a syntax for storing and exchanging data and is used in Maestro to store forms. If a Form Builder wants to transfer their form to another system, they can do so by using the Download JSON file button. document. The job definition includes the list of steps that make up the collaboration job. Each of the individual steps has the list of actions to be performed when the step runs, and the routes property, which defines the next step transition by mapping the route name to the next step.

The job definition consists of the following properties:

jobDetails

The jobDetails property defines a collaboration job and how it is processed. The snippet of the jobDetails is shown below:

{
	"jobDetails": {
		"name": "2 Step Review Job",
		"processSubmitImmediate": "true",  
		"version": "4.1.0"
	},
	"steps":[
		{ .. step definition ...},
		{ .. step definition ...},
		...
	]
}

The jobDetails has the following attributes:

Attribute Name Description

name

The name of the collaboration job, which is set by the job controller service when the collaboration job has been saved.

processSubmitImmediate

The collaboration job processing mode. If this attribute is omitted or set to false, the job will use the standard mode. Otherwise, it will use the process immediate mode.

version

The version of Manager that the job was created in.

jobGroups

The jobGroups property lists collaboration job groups, so job coordinators can manage the collaboration job. The snippet of the jobGroups is shown below:

"jobGroups": {}

The jobGroups has the following attributes:

Attribute Name Description

name

The name of the job group, which will be displayed in the Job Groups dropdown from the Reviews tab of the form space.

description

The description for the job group.

The job groups can be created in one of the following ways:

  1. If a job group defined in a job definition, as in above, has not been created, then the job group will be automatically created the first time a user submits a form associated to this job. This is the preferred way to create job groups.
  2. Job groups can be manually created. By manually creating the job group, you must ensure that the job group names and descriptions match with the job definition. Any mismatch will not be subsequently updated to the job groups.

steps

The steps property is an JSON array that defines steps. The snippet of the steps property is shown below:

{
      "name": "Initial Review",
      "type": "",
      "expiryRule": "+5d"
      "expiryServiceName": "An Expiry Service"  
      "actions": [
        { ... Action 1 Definition ... },
        { ... Action 2 Definition ... }
      ],
      "routes": [
        { "name": "Approve",  "nextStep": "Application Delivery" },
        { "name": "Decline",  "nextStep": "Applicant Update" },
        { "name": "Exceeds Threshold",  "nextStep": "Additional Review",  "display": "false" },
        { "name": "Terminate",  "nextStep": "Terminated Initial" }
      ]
},

The steps has the following attributes:

Attribute Name Description

name

The name of the step, which is unique within a collaboration job.

type

The type of the step, that can be:

  • start - the first step for the collaboration job. "type":"start"
  • endpoint - the processing stops and the job completes. Endpoints do not specify actions, routes or customProperties. "type":"endpoint"
  • empty string. "type":""

expiryRule

The step scheduled completion time, the step expiry, calculation rule. If specified, the job_step.time_completion_scheduled is set as the step creation time plus the expiry rule value, for example, 2014-03-05 + 5d = 2014-03-10. The valid values are:

  • "expiryRule" : "+4h" (hours)
  • "expiryRule" : "+5d" (days)
  • "expiryRule" : "+4w (weeks)
  • "expiryRule" : "+4m".

This is an optional attribute.

expiryServiceName

Specifies a job expiry service to clean up any items, such as incomplete submissions. This service should specify a route. A route name doesn't have to include a work expiry.

Note

If the expiryRule is used, but the exprityServiceName is not specified, then expiry route must be provided.

actions

The actions property defines the list of actions for each step, which are executed sequentially. Actions are required for all steps except endpoints. The snippet of the actions property is shown below:

{
    "name": "Create Task",
    "type": "Job Task Assign",
    "properties": [
        { "name": "Process Message Send Email",  "value": "true" },
        { "name": "Process Message Submission Step",  "value": "Start" },
        { "name": "Process Message Text",  "value": "Your ${submission.formName} application is at the Initial Review Step" },
}

The actions has the following attributes:

Attribute Name Description

name

The name of the action, which is unique within a collaboration job.

type

The action service type, that must be:

  • listed above in the Standard Actions Services.
  • groovy action services can have a type of Job Action.

properties

The action specific properties, see the properties object definition below. This is an optional attribute.

The standard Action Property classes (com.avoka.fc.core.service.job.impl) define a fixed set of Action Properties. The JobTaskAssignService defines a broad range of separate properties, so you can add them to your script when creating a new job action. This makes a job action re-useable across a collaboration job and the whole form application. For example, if the job definition has this property:

"properties": [ 
   { "name": "ABC Widget Name",  "value": "Aplle Blue Catapillar" }, 
   ... 
 ]

Then, you can retrieve it using the Groovy code below:

def abcName = actionStepProperties.getProperty("ABC Widget Name")

However, you should consider the following:

  • There is no submission associated with the job actions, by default.
  • $formDataMap.name doesn't resolve as the job action doesn't have any concept of a submission.
  • $func.previousSubmission().formDataMap.name works as we have used the submission from the previous step.
  • $job.submission(0).name works as we have used the first submission linked to the collaboration job.
  • This is not supported in Fluent job action classes version 17.10.1.

You can use various job functions in a job definition as well.

properties

The properties property defines the job definition properties. The snippet of the properties property is shown below:

"properties": [
    { "name": "Task Assign Group",  "value": "$func.formProperty('Initial Review')" },    
    { "name": "Task Type",  "value": "Review" },
]

Properties can be used to pass information into an instance of the Action Service. In this case, they are called action properties and can be defined at the action, step or collaboration job level. Properties with the same name defined at an action level override properties defined at the step level. Step override properties of the same name at the job level. This is illustrated in the snippet below:

{
  "jobDetails": { ... },
  "properties": [
    { "name": "Task Form Code", "value": "$func.startFormCode()" }
  ],
  "steps":[
    {
      "name": "Initial Review",
      "type": "",
      "actions": [
        {
          "name": "Create Task",
          "type": "Job Task Assign",
          "properties": [
            { "name": "Process Message Text",  "value": "Your ${submission.formName} application is at the Initial Review Step" },
            { "name": "Task Assign Group",  "value": "$func.formProperty('Initial Review')" },
            { "name": "Task Message",  "value": "Please perform the initial review of the ${submission.formName} from ${formDataMap.firstName} ${formDataMap.lastName}." },
            { "name": "Task Review Previous Step",  "value": "true" },
            { "name": "Task Subject",  "value": "Initial review of ${submission.formName} from ${formDataMap.firstName} ${formDataMap.lastName}" },
            { "name": "Task Type",  "value": "Review" },
          ]
        },
        { ... }
      ],
      "properties": [
        { "name": "Task Form Code", "value": "$func.startFormCode()" }
      ],
      "routes": [
        { "name": "Approve",  "nextStep": "Application Delivery" },
        { "name": "Decline",  "nextStep": "Applicant Update" }
      ],
    },
    { ... }
  ]
}

The properties has the following attributes:

Attribute Name Description

name

The name of the property. The predefined action services, such as the job task assign service, have a set number of action properties

value

A property value that can include an Apache Velocity template. The action properties are templates that are evaluated when an action service is run. The templates can be:

  • static text values, for example, { "name": "Task Email Message", "value": "An Email Message" }
  • substitute values from the form data extract, for example, { "name": "Process Message Text", "value": "Your ${job.submission.formName} application is at the Initial Review Step" }

template

It evaluates the value as a velocity template and forces the return value to return a String. This can evaluate nested function calls. This is can be used with property values that start with "$func", these can return an object. For example, $func.startUser() will return a user.

{ "name": "Task Email Message", "value": "$func.getSubmission().formXml()", "template": "true" }

routes

The routes property defines the route mapping between the route name and the next step, which are required for all steps except endpoints. An action can return a route result name, as a string, which is listed in each step. If a valid name is returned, the step routes the collaboration job to the next step. However, if the action returns an invalid route name, an error is thrown. The snippet of the routes property is shown below:

"routes": [
   { "name": "Approve",  "nextStep": "Application Delivery" },
   { "name": "Decline",  "nextStep": "Applicant Update" },
   { "name": "Exceeds Threshold",  "nextStep": "Additional Review",  "display": "false" },
   { "name": "Terminate",  "nextStep": "Terminated Initial" }
]

The routes has the following attributes:

Attribute Name Description

name

The route name that can be any name except the following reserved names:

  • Default - If there is no step found with a route name or if the route name is empty, the default route is used.
  • Expiry - the route taken when the step has expired.

nextStep

The next step, that can be:

  • A valid step name contained in the job definition.
  • A special case is ##PREVIOUS_STEP the job processing assign the next step as the previous step name.

display

The collaboration job provides a list of available routes to the form. However, the "display": "false" removes the route from the available routes. This is an optional attribute.

You can see the complete example of a job definition here.

Next, learn how to configure job definition.

Feedback

Did this topic provide the information you need or leave you wanting to know more? Is there some way we can make this topic better? Let us know how we can improve this documentation.

Contact Us

Community

Our Community is a dynamic, user-driven source of information that provides a home for sharing Journey platform knowledge where you can ask questions and get answers quickly.

Explore Community

Support

Temenos is committed to supporting our customers with Journey platform solutions installed in the cloud or on premise. Learn more about our Customer Care Team, and its policies, procedures, and processes.

Learn More