接入DTable API
DTable介绍
DTable （https://dtable.cloud/）是易知微内部孵化的一款低代码数据协作平台产品（在线协作效率表格），帮助企业轻松搭建个性化业务应用。EasyV数据源新增DTable接口，所有产品有效期内用户均可使用EasyV X DTable轻松搞定业务数据化。
在EasyV中使用DTable需进行3步操作：
- DTable收集数据
前往DTable 注册账号，并创建相应的表格应用。在工作中使用DTable中能轻松实现项目管理、广告投放、门店管理、招聘管理等业务场景，或开始制定个人的减肥计划、阅读计划、存款计划等。
- EasyV接入数据源
在EasyV中创建DTable数据源，仅需填写相应API Key。
- EasyV可视化呈现
跟往常一样使用EasyV搭建可视化应用并使用DTable数据源，由你定义数字化生活方式。
本文档假设您已经开通了EasyV和DTable账号进行数据接入环节，如您还未开通相关账号请您参考以下链接。
1、DTable创建测试表
在DTable中点击“+”号即可创建新的表单，可以通过模板或者空白应用创建。
本文档以模板中表单“疫情防控”为例，点击“疫情防控”表单即可创建。
2、DTable API Key/TableID/ViewID
先我们来了解下DTable中的关键名词：
1、【API Key】DTable中每个账号都有颁发的对应API Key，通过API Key可访问账号下的数据表信息。
在DTable用户账号管理界面（https://apps.dtable.cloud/user）或在DTable首页点击左下角点击账号管理进入账号管理界面。
在账号管理界面 "API"页面中可查看到API Key，API Key可按情况重新生成。
2、【TableID】DTable中创建的每一个数据表都有唯一ID，需要在表单数据页中查看。
3、【ViewID】DTable中可创建表格、看板、相册、表单、相册等视图，每个视图都有唯一ViewID与相应的数据返回格式，需要在表单数据页中查看。
如以下链接
https://apps.dtable.cloud/app/basBJSYoNxoqHyjO9/tblq2X9uKsTzNRRUa/viwYpzVmrQf9hFymN
链接中倒数第二个字段 "tblq2X9uKsTzNRRUa" 为Table ID
链接中倒数第一个字段 "viwYpzVmrQf9hFymN" 为View ID
这里需要注意一点，每个视图都有唯一ViewID与相应的数据返回格式，即同一张总表生成的不同视图都会生成相应的View ID。
4、【Records】DTable API返回条数，默认返回1000条数据，可在EasyV中根据需求进行调整。
数据接入
1、添加数据源
在EasyV工作台内点击 “我的数据”-->“添加数据源”，随后在添加数据源弹窗中填写数据源信息。
- 类型选择位DTable API
- 数据源名称可按情况填写，比如“DTable测试数据源”
- 描述示例：“测试DTable数据源”
- API Key：这里需要用到之前在DTable中生成的API Key。
2、EasyV组件接入数据
以EasyV内轮播表格为例，点击“数据”接入数据。
- 数据源类型：选择DTable API
- 数据源：选择DTable API 中创建的数据源
- Table ID：填写DTable ID
- View ID：填写View ID
- Records：DTable API返回条数，默认返回1000条数据，可按需调整。
3、查看数据响应结果
在接入数据源页面最下侧可以查看到DTable接入数据源响应结果。
4、字段映射
EasyV内组件自有字段格式与DTable用户创建的表头名称不一致时需要进行字段映射，即将DTable内字段通过选择字段名与EasyV内"column"列进行字段映射。
映射后数据即显示在组件对应列中。
