Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Current »

Emakin performs most of the heavy operations in the background to achieve scalable and high performance outputs. These background operations are executed by emakin service agent without any user interaction.

When a new process is started by the user, workflow state is recorded in the database without any further processing, and creates a couple of background jobs. Service agents pull the jobs from the queue and try to process in the background. If an error occurs while processing the job, transaction state is rollbacked and error state is reported to the system administrators. When an administrator resolves the issue, job is re-queued in the system, from the job manager, to the process again. Some of the errors are automatically recovered by the system and queued again with time delay.

8.png

Service agents use multiple threads, and can also be deployed to any number of hardware instances to perform parallel execution. Jobs are executed in order of priority, and a single service agent can complete 600 jobs per minute for the basic workflow operations. This number is highly dependent on the job definition and hardware specifications.

Job Details

Each job has the following properties:

Type
Type of a job. 

Created At
Date and time when a job is created.

Delete After
Date and time after which the job will be deleted.

Started At
Start date and time of a job.

Completed At
Completion date and time of a job.

Duration
Duration of execution if a job is completed, or duration of wait time in a queue.

Score
Calculated priority score. This value is calculated from a job type priority and a workflow instance priority.

State
State of a job. Can be one of the following values; Waiting, Processing, Error, Completed, Aborted.

State Transition

Every job is created in the "Waiting" state.

When a service agent pulls the job from the queue, agent locks the job and changes state to the "Processing".

If the job is successfully completed, the state changes to "Completed".

If the job generates an error, state changes to "Error", and system administrator is notified. Some of the job errors are automatically handled. For example, e-mail sending job errors are ignored and re-scheduled, and state changes to "Waiting" to try again later. If maximum try count limit is exceeded, the state is changed to the "Error" or "Aborted" by the configuration settings.

For "Aborted" and "Completed" states, job is automatically deleted from the system if the "Delete After" date passed. 

3.png

Job Log

Each job contains a log about detailed information of what is performed in the background. Each log line has an in log level like Debug, Information, Warning, Error.

1.png

Job Types

Workflow Jobs

Scheduled Task

Time based generic job. This job usually creates another jobs if any action required.

Task Evaluation

Created when the initiate type workflow task is scheduled to start periodically. Created by the Scheduled Task per task definition. You can find more details in the Task Evaluation section. 

Work Item Evaluation

Created when the normal type workflow task is scheduled to check periodically. Created by the Scheduled Task per work item instance. You can find more details in the Task Evaluation section.

Work Item Processing

Created when a user or a system completes a work item. This job advances to the next step in the workflow, and executes the scripts in the workflow, calculates the role scripts which should be assigned to the task.

Deadlined Work Item

Created when a work item's deadline occurs. This job is similar to the "Work Item Processing" job, but created when the deadline date is missed.

Work Item Reminder

Created when a task reminder needs to be sent.

Xml Database Jobs

Form Data Xml Database Replication

Created when the workflow data needs to be replicated on an xml database. This job is usually created when a workflow data is modified.

Instance Xml Database Replication

Created when a workflow history is changed and needs to be replicated on an xml database.

Xml Database Removal

Created when a workflow data is removed. This job is usually created when a process version is deleted from the system.

Full Text Indexing Jobs

Work Item Full Text Indexing

Created when a workflow data is modified and updates the full text catalog.

Document Full Text Indexing

Created when a document content is modified and updates the full text catalog.

Full Text Removal

Created when a previously added document is removed from the full text catalog.

Domain Jobs

E-Mail Message Send

Created when an email message is sent. Email content may be automatically generated from the workflow templates or scripting environment.

Domain Upgrade

Created periodically to upgrade installed processes from the market store.

Domain Deletion

Created when a domain is expired and no longer active.

Default Job Configuration

Emakin uses following default configuration to manage the job queue.

Name

Internal Name

Priority

Delete After (days)
(No) 

Retry Duration (min)
(No) 

Max Retry
(No) 

Max Retry Result
(Abort) 

Error Result
(Error) 

Alert Error
(True) 

Alert Abort
(False) 

Timeout (min)

Alert To
(Domain Admin)

Document Full Text Indexing

Workflow.Document.FullText

Low

2

60

20





10

System Admin

Domain Deletion

Workflow.Domain.Delete

Low








None

System Admin

Domain Upgrade

Workflow.Domain.Upgrade

Low

180






True

10

System Admin

Form Data Xml Database Replication

Workflow.FormData.XmlDatabase

Normal

2

60

10





10

System Admin

Xml Database Removal

Workflow.FormData.XmlDatabaseRemover

Normal

2

60

10





10

System Admin

Full Text Removal

Workflow.FullText.Remover

Low

2

60

10





10

System Admin

Instance Xml Database Replication

Workflow.Instance.XmlDatabase

Normal

2

60

10





10

System Admin

E-Mail Message Send

Workflow.Message.Send

Low

90

5

10



False

False

10


Scheduled Task

Workflow.ScheduledTask

High

10







10


Deadlined Work Item

Workflow.WorkItem.Deadline

High

180

10

20




True

60


Instance Full Text Indexing

Workflow.Instance.FullText

Low

2

10

10





10

System Admin

Work Item Processing

Workflow.WorkItem.Process

High

180

10

20

Error



True

60


Work Item Reminder

Workflow.WorkItem.Reminder

High

60







10

System Admin

Work Item Evaluation

Workflow.WorkItem.Evaluate

High

180

10

20





60


Task Evaluation

Workflow.Task.Evaluate

High

180







60


File Replication

Workflow.File.Replication

Normal

30

1440

10





10

System Admin

Instance Terminate

Workflow.Instance.Terminate

Low

180







60


Channel Synchronization

Workflow.Channel.MailSync

Normal

20

10

3





60


Case Full Text Indexing

Workflow.Case.FullText

Low

20







10

System Admin

Case Deadline Notification

Workflow.Case.Deadline

High

180







60

System Admin

Case Reminder

Workflow.Case.Reminder

Normal

60







60

System Admin

Case Violation Notification

Workflow.Case.Violation

Normal

60







10

System Admin



  • No labels