不知道小伙伴們有沒有留意過，在 Flowable 流程圖的繪制過程中，我們可以編寫一個名為 dataObject 的元素，這個元素可以指定變量的 id、名稱以及數(shù)據(jù)類型等各種屬性，并且在流程實例啟動的時候，會自動將 dataObject 元素的信息轉(zhuǎn)換為流程實例變量，這個東西也蠻好玩的，今天松哥就帶領(lǐng)小伙伴們來捋一捋 Flowable 中的 dataObject。

1. 添加 dataObject

首先我們來看下，在流程繪制的過程中，如何去添加 dataObject 對象。

IDEA 上的 Flowable 流程圖繪制插件中還不能添加 dataObject 屬性，這個需要我們?nèi)?flowable-ui 中去添加。

我們來隨便繪制一個如下這樣簡單的流程圖：

看過松哥之前幾篇文章的小伙伴應(yīng)該對這張圖很熟悉了，松哥這里也不多說。

我現(xiàn)在就想給這個流程圖，添加 dataObject 屬性，方式如下：

首先打開流程圖，不要選擇任何節(jié)點，在下方可以找到數(shù)據(jù)對象屬性，如下圖：

點擊之后，就可以添加 dataObject 了，如下：

配置完成之后，點擊保存按鈕。然后我們下載這個流程圖，下載之后，打開，我們會發(fā)現(xiàn)這次的 XMl 節(jié)點比之前的 XML 節(jié)點多出來了如下一些內(nèi)容：

<dataObject id="name" name="流程繪制人" itemSubjectRef="xsd:string">
  <extensionElements>
    <flowable:value>javaboy</flowable:value>
  </extensionElements>
</dataObject>
<dataObject id="site" name="流程作者網(wǎng)站" itemSubjectRef="xsd:string">
  <extensionElements>
    <flowable:value>www.javaboy.org</flowable:value>
  </extensionElements>
</dataObject>
<dataObject id="date" name="流程繪制時間" itemSubjectRef="xsd:datetime">
  <extensionElements>
    <flowable:value>2022-09-23T00:00:00</flowable:value>
  </extensionElements>
</dataObject>

2. 查詢 dataObject

接下來，按照之前文章介紹的方式，我們先來部署并啟動這個流程圖。

當(dāng)流程部署成功之后，我們可以在 ACT_RU_VARIABLE 表中查看到 dataObject 中的數(shù)據(jù)，如下圖：

可以看到，dataObject 的數(shù)據(jù)是和執(zhí)行實例 ID 以及流程實例 ID 相關(guān)的。

接下來，我們可以通過如下方式來查詢 ACT_RU_VARIABLE 表中的數(shù)據(jù)：

@Test
void test08() {
    List<Execution> list = runtimeService.createExecutionQuery().list();
    for (Execution execution : list) {
        DataObject data = runtimeService.getDataObject(execution.getId(), "流程繪制人");
        logger.info("key:{},name:{},value:{}",data.getDataObjectDefinitionKey(),data.getName(),data.getValue());
    }
}

這里打印出來的信息就是我們剛剛在定義的時候配置的所有流程信息了。

我們來看看這里查詢的表：

可以看到，這里先去 ACT_RU_EXECUTION 表中查詢執(zhí)行實例 ID，然后再根據(jù)拿到的執(zhí)行實例 ID 去 ACT_RU_VARIABLE 表中查詢 dataObject 信息。

這就是 dataObject 的使用，其實非常 Easy！dataObject 平時主要可以用來定義一些全局的屬性。

3. 租戶

說到這里，就順便再來和小伙伴們聊一聊 Flowable 中的租戶。

租戶這個其實好理解，舉個栗子：

假設(shè)我們現(xiàn)在有 A、B、C、D 四個子系統(tǒng)，四個子系統(tǒng)都要部署同一個名為 leave 的流程，如何區(qū)分四個不同子系統(tǒng)的的流程呢？通過租戶可以解決這個問題。

Flowable 中的租戶其實很好理解，其實就是在流程中，多一個一個 TenantID 加以區(qū)分每一個流程屬于哪個租戶。

我舉個簡單的例子，假設(shè)我現(xiàn)在想要根據(jù)不同的子系統(tǒng)來部署流程，那么我可以按照如下方式來設(shè)計接口：

@RestController
public class ProcessDeployController {

    @Autowired
    RepositoryService repositoryService;

    @PostMapping("/deploy")
    public RespBean deploy(MultipartFile file,String tenantId) throws IOException {
        DeploymentBuilder deploymentBuilder = repositoryService.createDeployment()
                .category("javaboy的工作流分類")
                .name("javaboy的工作流名稱")
                .addInputStream("fff.bpmn", file.getInputStream())
                .tenantId(tenantId)
                .key("javaboy的工作流key666");
        Deployment deployment = deploymentBuilder
                .deploy();
        return RespBean.ok("部署成功",deployment.getId());
    }
}

接下來我們通過 POSTMAN 來發(fā)送一個 POST 請求，提交流程圖和租戶 ID 這兩個參數(shù)，如下圖：

小伙伴們注意，我這里提交了兩個參數(shù)，一個是流程圖本身，還有一個是租戶 ID。

當(dāng)這個流程圖部署成功之后，我們在流程定義表 ACT_RE_PROCDEF 中可以看到剛剛設(shè)置的租戶 ID：

接下來我們需要啟動流程實例的時候，就不能單純拿著流程部署的 ID 去啟動了，還得拿上流程的租戶 ID。如果只拿流程本身的信息去啟動，會拋出如下異常：

正確的啟動方式如下：

@Test
void test09() {
    identityService.setAuthenticatedUserId("wangwu");
    ProcessInstance pi = runtimeService.startProcessInstanceByKeyAndTenantId("leave","A");
    logger.info("id:{},activityId:{}", pi.getId(), pi.getActivityId());
}

在后續(xù)的 Task 查詢中，我們也可以根據(jù)具體的租戶 ID 來查詢，這個就看具體情況了。