如何在AEM WorkflowProcess中读取multiple=true多值字段数据

AEM表单中配置了multiple="true"的多值字段，最终存入JCR、传入工作流MetaDataMap时的实际存储类型是String[]（字符串数组），并非List<String>。传入List类型作为读取目标时类型不匹配，自然拿不到值。

直接读取为数组（推荐） #

直接指定String[].class作为目标类型读取即可，示例代码：

@Component(
    // 省略组件配置
)
public class TagStep implements WorkflowProcess {
    @Override
    public void execute(WorkItem workItem, WorkflowSession workflowSession, MetaDataMap processArguments) {
        try {
            // 多值字段直接按字符串数组类型读取
            String[] tags = processArguments.get("TAGS", String[].class);
            
            if (tags != null) {
                for (String tag : tags) {
                    LOG.info("读取到标签值：{}", tag);
                }
            }
        } catch (Exception e) {
            LOG.error("读取标签字段异常：{}", e.getMessage(), e);
        }
    }
}

需使用List的场景 #

如果业务逻辑必须用List结构接收，先读数组再手动转换即可：

String[] tagArray = processArguments.get("TAGS", String[].class);
List<String> tagsList = tagArray != null ? Arrays.asList(tagArray) : Collections.emptyList();

如果按上述写法还是读不到值，优先检查两点：

• 字段配置的存储路径是./metaData/TAGS，确认工作流参数映射时，确实将该节点下的TAGS属性映射到了processArguments的TAGS键，可先遍历processArguments的所有键确认参数是否正常传入
• Coral3的tagfield组件如果选择的是系统内置标签，存储的值是标签的仓库路径（格式类似/content/cq:tags/分类/标签名），不是前端展示的标签文本标题，不要用展示文本匹配取值

内容的提问来源于stack exchange，提问作者Bob