前言
Notion 简介
近几年,有一款叫 Notion 的产品异样火爆,它是集笔记、工作治理、Wiki、数据管理为一体的产品,他主打两个理念「模块化」和「All-in-one」,Notion 最有魅力的还是引进了 Database 和双向链的理念 Notion 也算是一个渐进式的工具产品,渐进式你能够了解为,能够简略的当笔记工具用,也能够当集体或小团队的工作知识库和工作管理工具用。
Notion 与 kintone
在理论应用 Notion 的过程中,我发现它的 Database 数据模式有着重要位置,它和 Notion 其余一些特色性能交融后,充沛放大了其扩展性,自由性,和灵活性。Notion 的 Database 属于关系型数据库的领域,我不禁想到,关系型数据库的模式也是 kintone App 的核心内容,所以那他们之间肯定是能够互通的。明天咱们就来探讨一下如何进行 Notion 和 kintone 之间的数据转换。
探讨范畴
本着抛砖引玉的理念,本文想要做的更多是启发开发思路,而非那种能够拿来即用成熟产品。所以探讨和演示的范畴不会八面玲珑。
数据对接
说到数据对接,本应该是双向的,但本文只探讨 Notion 向 kintone 的单向转换。因为反向转换的话,齐全能够反推出来,有需要的读者能够自行推演。
字段类型
Notion 和 kintone 的二维构造表格中的字段,都有本人类型的设计,有类似的,也有不同的。本文中所演示的,只是一部分字段的转换,而且字段的对应关系也非严格匹配。读者可依据理论需要,或减少更多转换字段,或更改的字段类型对应关系。譬如,Notion 中的字段类型“Text”,其实技术上能够叫“RichText”(带丰盛格局的文本),但我转换到 kintone 时,用的只是一般的“单行文本框”。
后期筹备
Notion 方面的筹备在 Notion 中建设一个 database,建设几个想要对接字段。这里我建设了一个书店的表格。
要应用 Notion 的 API,则先要创立一个 integration。integration 字面翻译叫做“融入”,这是 Notion 本人的叫法,咱们能够简略了解为平时常常说的 API Token。创立形式见官网文档。创立胜利后你会失去一个 Secrets 字符串。
有了 integration 之后,还要把它连贯到方才的 database 中,使得在调用 API 时,取得此 database 的拜访权限。在最右上角的三个点图标中,找到 Add connections,输出方才的 integration 名,确认后连贯胜利。
kintone 方面的筹备
建设一个 kintone App,用来承受 Notion 的 database 数据,所以字段类型必须抉择适合的。书名、ISBN、作者、能够抉择单行文本框,定价抉择数值,标签能够抉择复选框或是多选。
给每个字段设置好字段代码,以备在程序中应用。我以 json object 的模式给出,属性名是字段名,属性值是字段代码,未来程序里能间接用得上。
{
书名: 'book_name',
ISBN: 'isbn',
作者: 'author',
定价: 'price',
标签: 'label',
}
创立 token,以便未来程序中拜访此 App。
程序编写运行环境方面
本文中所演示的代码,都是在 nodejs 的 npm 模式下编写调试的,咱们也强烈建议您也在这种模式下来编写程序。而且咱们将别离应用 Notion 和 kintone 的 SDK,这种模式下援用库也会绝对不便一些。上面是 package.json 文件的一部分相干设置,供您参考。
{
"name": "notion2kintone",
"version": "1.0.0",
"type": "module",
"dependencies": {
"@kintone/rest-api-client": "^3.1.11",
"@notionhq/client": "^2.1.1"
}
}
代码范例和代码讲解:
开发者网站 – 数据对接:从 Notion Database 到低代码平台