后端代码示例

约 2750 字大约 9 分钟

2025-02-17

[通用]批量创建/更新/删除业务对象

可用位置：✔表单 / ✔列表 / ✔定时器 / ✔自定义接口

提示

下面这个示例只演示批量创建，若是批量更新改成bo.Update(commit);，批量删除改成bo.Remove(commit);。

H3.IEngine engine = this.Engine;
H3.DataModel.BizObjectSchema schema = engine.BizObjectManager.GetPublishedSchema("表单编码");//获取表单实例

H3.DataModel.BulkCommit commit = new H3.DataModel.BulkCommit();
for(int i = 0;i < 500; i++)
{
    H3.DataModel.BizObject bo = new H3.DataModel.BizObject(engine, schema, H3.Organization.User.SystemUserId);
    bo.CreatedBy = H3.Organization.User.SystemUserId;
    bo.OwnerId = H3.Organization.User.SystemUserId;
    bo.Status = H3.DataModel.BizObjectStatus.Effective;
    bo["F000001"] = 1;
    bo["F000002"] = "xxx";

    //注意：这里不能直接用 bo.Create()，而是将批量提交实例传入
    bo.Create(commit);
}
//注意：虽然是批量提交，但是建议一次Commit最多500条数据，否则还是很容易造成超时
string errorMsg = null;
commit.Commit(engine.BizObjectManager, out errorMsg);
if(!string.IsNullOrEmpty(errorMsg)) 
{
    throw new Exception("批量操作失败：" + errorMsg);
}

[通用]正则

可用位置：✔表单 / ✔列表 / ✔定时器 / ✔自定义接口

string input = "1851 1999 1958 1905 2003";
string pattern = @"(?<=19)\d{2}\b";

// 遍历所有匹配到的结果，并对每个匹配项进行处理
foreach(System.Text.RegularExpressions.Match match in System.Text.RegularExpressions.Regex.Matches(input, pattern))
{
	string a = match.Value.ToString();
}

[通用]目标已有附件保留，追加新增的附件

可用位置：✔表单 / ✔列表 / ✔定时器 / ✔自定义接口

当目标表的附件控件是由多个源表复制过去的，此时只用 CopyFiles 接口的覆盖模式，会把其他源表附件覆盖。
换成 CopyFiles 接口的追加模式，本条源数据上次追加的附件又不会被清理，就无法显示更新的效果。

所以，本示例先将本条源数据上次追加的附件删除，后追加上本条源数据的所有附件，就完美解决了以上两个问题。

public void AddFileToBo(H3.IEngine engine, H3.DataModel.BizObject sourBo, string sourFieldCode, string toBoSchemaCode, string toBoId, string toFieldCode)
{
    //第一步：删除 目标 中由本条数据带过去的附件
    System.Data.DataTable dt = engine.Query.QueryTable(
        "SELECT objectid FROM H_BizObjectFile WHERE fileflag = 0 AND schemacode = @toBoSchemaCode AND propertyname = @toFieldCode AND bizobjectid = @toBoId AND sourcebizobjectid = @sourBoId AND sourcepropertyname = @sourFieldCode", new H3.Data.Database.Parameter[]{
            new H3.Data.Database.Parameter("@toBoSchemaCode", System.Data.DbType.String, toBoSchemaCode),
            new H3.Data.Database.Parameter("@toFieldCode", System.Data.DbType.String, toFieldCode),
            new H3.Data.Database.Parameter("@toBoId", System.Data.DbType.String, toBoId),
            new H3.Data.Database.Parameter("@sourBoId", System.Data.DbType.String, sourBo.ObjectId),
            new H3.Data.Database.Parameter("@sourFieldCode", System.Data.DbType.String, sourFieldCode)
        });
    if(dt != null && dt.Rows.Count > 0)
    {
        foreach(System.Data.DataRow row in dt.Rows) 
        {
            string fId = row["objectid"] + string.Empty;
            if(!string.IsNullOrWhiteSpace(fId))
            {
                engine.BizObjectManager.RemoveFile(fId, true);
            }
        }
    }

    //第二步：将本条数据的附件以追加的方式赋值到 目标
    engine.BizObjectManager.CopyFiles(
        sourBo.Schema.SchemaCode, "", sourFieldCode, sourBo.ObjectId,
        toBoSchemaCode, "", toFieldCode, toBoId, false, false
    );
}

[通用]CopyFiles图片到目标数据，图片在移动端列表中显示

可用位置：✔表单 / ✔列表 / ✔定时器 / ✔自定义接口

H3.DataModel.BizObject sourceBo = （省略）;//源数据业务对象
H3.DataModel.BizObject toBo = （省略）;//目标数据业务对象

//将源数据中某图片控件下的图片，复制到目标数据的某图片控件中，并得到复制后的图片信息数组
H3.DataModel.BizObjectFileHeader[] files = this.Engine.BizObjectManager.CopyFiles(sourceBo.Schema.SchemaCode, "", "源数据图片控件编码", sourceBo.ObjectId, toBo.Schema.SchemaCode, "", "目标数据图片控件编码", toBo.ObjectId, true, true);
//将控件中第一张图片设置为移动端列表上的数据图片
toBo.IconId = files[0].FileId;
//更新目标业务对象，提交以上设置
toBo.Update();

[通用]获取控件的H3.DataModel.PropertySchema实例

可用位置：✔表单 / ✔列表 / ✔定时器 / ✔自定义接口

H3.DataModel.PropertySchema 的具体说明请查看：H3.DataModel.PropertySchema

//总控实例
H3.IEngine engine = this.Engine;

//表单结构实例
H3.DataModel.BizObjectSchema schema = engine.BizObjectManager.GetPublishedSchema("表单编码");

//获取 F0000004 控件实例
H3.DataModel.PropertySchema property = schema.GetProperty("F0000004");

//获取 F0000004 控件的标题名
string fieldLabelName = property.DisplayName;