EZDML导入导出Excel功能详解

EZDML之前支持批量导出到Excel，最近EZDML又增加了批量导入Excel的功能，这里简单说明一下。

批量导入Excel

这里所谓批量，就是一次能导入多个表的意思。大概要求格式是：表名独占一行，注释（可选）占一行，列头占一行，然后是字段属性内容（一行一个字段，注释可多行），每个表之间至少有一行空行。

新版EZDML在模型菜单下增加了“导入Excel…”命令：

点击后弹出一个对话框：

左边是要粘贴Excel内容，我们打开一个Excel示例文件，这个是我之前用EZDML导出来的，我们直接全选并复制：

然后粘贴到EZDML的导入文本框中：

由于都是自家的格式，因此EZDML能自动识别所有内容，直接“确定”就可以了，程序弹出提示：

再次“确定”，就可以完成导入：

导入第三方文档

上面导入的是EZDML自己的格式，左手导右手，没什么挑战性。而大部分情况我们可能是拿到的是别人提供的数据字典文档，甚至有时就是接口文档，因此下面我们来导一个实际一点复杂一点的。

这里我们以艺龙的接口为例，这个接口是公开的，假设我要导入的是下面这个链接的文档：

https://open.elong.com/doc/info/cn-api-meta-hotel_data_rp

输入参数我们不管，我们要导入的是响应结果：

从Hotel节点开始选中内容，直到最后一个表格，右键复制内容：

打开Excel新建空白表格，粘贴（注意这一步不可省略，我们需要Excel中转一下）：

在Excel中再次全选、复制，并到EZDML的导入Excel文本框中粘贴：

这次大家可能会发现有点不一样了，有些列EZDML并没有正确地识别出来，比如第一列和第二列就错了，我们点一下“C1”：

我们选择“字段名”，将第一列设置为字段名；同样地，我们把第二列改成逻辑名：

点击“确定”，弹出确认框：

可以看到，表名都有一个“节点”的后缀，这个我们一会处理。先点确定：

这个GuaranteeRule节点大宽了，原因是有个字段的逻辑名太长，我们改一下，把多出来的内容移到注释里：

再看就差不多了，只是“节点”这个后缀有点不顺眼：

在模型图上右键执行脚本，切换到JAVASCRIPT（点新建直到标题显示JAVASCRIPT），输入以下内容：

//Java Script

for(var i=0; i<allModels.count; i++)
{
  var md=allModels.getItem(i);
  for(var j=0; j<md.tables.count; j++)
  {
    var tb = md.tables.getItem(j);
    if(tb.name.indexOf('节点') > 0){
       tb.name=tb.name.substring(0,tb.name.indexOf('节点'));
       curOut.add('table renamed: '+ tb.name);
    }
  }
}

运行：

回到模型图，刷新，表名里的节点就去掉了：

扩展属性导入

如上所述，批量导入时，EZDML能自动识别大部分的内容，如字段名、逻辑名、数据类型、大小、精度、可为空、必填、唯一、约束、缺省值、注释。如果识别失败或错误，也可以手工辅助更正。

但自动识别的内容毕竟有限，如果还有其它属性（如是否只读等）需要导入，或者对自动识别的效果不满意，这时我们可在导入时勾选“保存值内容到字段参数”：

确定导入后，我们得到表内容，表面上跟之前没什么区别：

我们选中member的username字段，右键运行脚本，切换到JAVASCRIPT（点新建直到标题显示JavaScript），执行以下脚本：

1	alert(curField.paramList.text);

我们可以看到，原始内容一字不落地全保存下来了。这样，我们就可以根据需要写脚本来赋值了，比如我们运行以下脚本：

//Java Script
for(var i=0; i<allModels.count; i++) //遍历所有模型
{
  var md=allModels.getItem(i);
  for(var j=0; j<md.tables.count; j++) //遍历所有表
  {
    var tb = md.tables.getItem(j);
    for(var k=0; k<tb.metaFields.count; k++) //遍历字段
    {
      var fd = tb.metaFields.getItem(k);
      if(fd.getParam('C5')=='Y'){ //判断导入列C5的值“是否只读”
        fd.editorReadOnly=true;
        curOut.add('    Field readOnly: '+tb.name+'.'+fd.nameCaption);
      }
    }
  }
}