Bắt đầu quy trình với Timer Start Event

1. Timer Start Event là gì?

Khác với Start Event thông thường mà chúng ta đã sử dụng (cần một hành động thủ công để bắt đầu), Timer Start Event là một loại sự kiện khởi đầu đặc biệt, được kích hoạt bởi một bộ đếm thời gian do process engine quản lý.

Khi bạn deploy một quy trình có chứa Timer Start Event, Camunda engine sẽ đọc cấu hình của nó và lên một lịch trình (schedule). Khi thời gian định sẵn tới, engine sẽ tự động tạo một thực thể quy trình mới (new process instance) mà không cần bất kỳ sự can thiệp nào.

Để có một cái nhìn tổng quan, hãy xem video ngắn sau đây.

Như video đã đề cập, đây là một công cụ cực kỳ hữu ích cho các tác vụ lặp đi lặp lại theo lịch. Bây giờ, hãy tìm hiểu cách mô hình hóa và cấu hình nó.

2. Mô hình hóa và Cấu hình Timer Start Event

Việc tạo và cấu hình một Timer Start Event trong Camunda Modeler khá đơn giản và trực quan.

Bước 1: Chuyển đổi Start Event

Đầu tiên, bạn bắt đầu với một Start Event thông thường, sau đó chuyển đổi nó sang loại Timer.

Bạn chỉ cần chọn Start Event, nhấp vào biểu tượng cờ lê, và chọn "Timer Start Event". Biểu tượng của sự kiện sẽ thay đổi thành hình đồng hồ.

Bước 2: Tìm hiểu các loại định nghĩa Timer

Sau khi có Timer Start Event, bạn cần cho nó biết khi nào cần kích hoạt. Trong bảng thuộc tính (Properties Panel) ở bên phải, bạn sẽ thấy mục Timer Definition. Camunda hỗ trợ ba loại định nghĩa chính, dựa trên tiêu chuẩn ISO 8601.

Hãy tóm tắt lại những điểm quan trọng nhất cho một developer:

• Time Date: Một thời điểm cụ thể.

  • Định dạng: YYYY-MM-DDTHH:mm:ssZ (Z là múi giờ UTC).
  • Ví dụ: 2025-01-01T00:00:00Z - Bắt đầu vào đúng nửa đêm ngày 1/1/2025 (giờ UTC).
  • Sử dụng: Kích hoạt một lần vào một ngày giờ chính xác.

• Time Duration: Một khoảng thời gian kể từ lúc quy trình được deploy.

  • Định dạng: PTnHnMnS (Period, Time, n Hours, n Minutes, n Seconds).
  • Ví dụ: PT5M - Bắt đầu sau 5 phút kể từ khi deploy.
  • Sử dụng: Hữu ích để kích hoạt một tác vụ trì hoãn một lần. Ít phổ biến hơn cho Start Event.

• Time Cycle: Một chu kỳ lặp lại. Đây là loại mạnh mẽ và được sử dụng nhiều nhất.

  • Định dạng: R[n]/[start_time]/P...
    • R hoặc R/: Lặp lại vô hạn.
    • R5/: Lặp lại 5 lần.
    • P...: Khoảng thời gian giữa các lần lặp (theo định dạng Time Duration).
  • Ví dụ:
    • R/PT1M: Lặp lại vô hạn, mỗi phút một lần. Rất hữu ích để kiểm thử!
    • R/P1D: Lặp lại vô hạn, mỗi ngày một lần.
  • Cron Expressions: Camunda cũng hỗ trợ Cron, một định dạng rất quen thuộc với các developer.
    • Ví dụ: 0 15 10 ? * * - Chạy vào lúc 10:15 sáng mỗi ngày. Đây là cách rất linh hoạt để định nghĩa các lịch trình phức tạp (ví dụ: "vào 9 giờ sáng mỗi thứ Hai").

Bước 3: Cấu hình trong Properties Panel

Bây giờ hãy áp dụng kiến thức trên vào Modeler.

Để xem trực tiếp cách cấu hình, video sau sẽ minh họa các bước thiết lập một Time Cycle.

3. Ví dụ Thực hành: Quy trình Gửi Báo cáo Hàng ngày

Hãy cùng nhau xây dựng một quy trình đơn giản để củng cố kiến thức.

Kịch bản: Chúng ta cần một quy trình tự động chạy vào lúc 8 giờ sáng mỗi ngày để tạo và gửi một báo cáo tổng kết. Để đơn giản hóa, chúng ta sẽ chỉ ghi log ra console.

Bước 1: Mô hình hóa quy trình

1. Trong Camunda Modeler, tạo một quy trình mới.
2. Chuyển Start Event thành Timer Start Event.
3. Nối nó với một Service Task có tên "Generate Daily Report".
4. Nối Service Task với một End Event.

Bước 2: Cấu hình Timer

1. Chọn Timer Start Event.
2. Trong Properties Panel:
   • Timer Definition Type: Chọn Cycle.
   • Timer Definition: Để dễ dàng kiểm thử, hãy nhập R/PT1M. Điều này sẽ làm quy trình khởi động mỗi phút một lần.
     • Lưu ý thực tế: Khi deploy lên môi trường production, bạn sẽ đổi giá trị này thành một biểu thức Cron như 0 0 8 * * ? để chạy vào 8 giờ sáng hàng ngày.

Bước 3: Cấu hình Service Task

1. Chọn Service Task "Generate Daily Report".
2. Trong Properties Panel, dưới mục Implementation:
   • Type: Chọn Java Class.
   • Java Class: Nhập tên lớp delegate của bạn, ví dụ: com.example.camunda.delegates.ReportGeneratorDelegate.

Bước 4: Viết mã Java Delegate

Tạo một lớp Java delegate đơn giản để mô phỏng việc tạo báo cáo.

package com.example.camunda.delegates;

import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.camunda.bpm.engine.delegate.JavaDelegate;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Component;

import java.time.LocalDateTime;

@Component("ReportGeneratorDelegate")
public class ReportGeneratorDelegate implements JavaDelegate {

    private final static Logger LOGGER = LoggerFactory.getLogger(ReportGeneratorDelegate.class);

    @Override
    public void execute(DelegateExecution execution) throws Exception {
        LOGGER.info("==============================================");
        LOGGER.info("Bắt đầu tạo báo cáo hàng ngày lúc: {}", LocalDateTime.now());
        LOGGER.info("Process Instance ID: {}", execution.getProcessInstanceId());
        // ... logic tạo báo cáo thực tế sẽ ở đây ...
        Thread.sleep(2000); // Giả lập công việc
        LOGGER.info("Tạo báo cáo thành công!");
        LOGGER.info("==============================================");
    }
}

Bước 5: Deploy và Quan sát

1. Deploy quy trình của bạn từ Modeler hoặc bằng cách đóng gói trong ứng dụng Spring Boot.
2. Khởi chạy ứng dụng.
3. Quan sát Console/Logs: Bạn sẽ thấy thông điệp từ ReportGeneratorDelegate được in ra mỗi phút.
4. Quan sát trong Camunda Cockpit:
   • Truy cập Cockpit.
   • Chọn định nghĩa quy trình của bạn.
   • Bạn sẽ thấy một danh sách các process instance mới được tạo ra liên tục, mỗi phút một instance.

Để hình dung hiệu ứng này, video sau cho thấy một timer lặp lại đang hoạt động. Mặc dù nó là một Boundary Event, hiệu ứng "kích hoạt lặp lại" là tương tự.

Tổng kết

Trong bài học này, bạn đã học được cách tự động hóa việc khởi chạy quy trình, một khả năng cốt lõi trong BPM.

Những điểm chính cần ghi nhớ:

• Timer Start Event dùng để khởi tạo quy trình theo lịch trình mà không cần can thiệp thủ công.
• Việc cấu hình được thực hiện qua Timer Definition với ba loại chính: Date (thời điểm cụ thể), Duration (khoảng thời gian), và Cycle (chu kỳ lặp lại).
• Time Cycle là loại linh hoạt nhất, hỗ trợ cả định dạng lặp lại của ISO 8601 và Cron expressions.
• Khi phát triển và kiểm thử, hãy sử dụng chu kỳ ngắn (ví dụ: R/PT1M) để dễ dàng quan sát kết quả.

Xem trước bài học tiếp theo

Chúng ta đã biết cách khởi động quy trình bằng timer. Nhưng điều gì sẽ xảy ra nếu chúng ta cần tạo một sự trì hoãn bên trong một quy trình đang chạy? Ví dụ: chờ 24 giờ sau khi gửi email cho khách hàng trước khi thực hiện hành động tiếp theo. Bài học kế tiếp, "Sử dụng Intermediate Timer Event để tạo độ trễ trong một quy trình", sẽ giải quyết chính xác vấn đề này.