基本概念
文件、用户、权限
文件:文件存储在业务系统,每个文件都需要有一个文件id。id的命名规则由业务系统决定,要求同一个文件同一个id,不同文件不同id(支持多版本的文件系统除外)。业务系统调用在线编辑/预览时,需要提供文件id。Filez文档中台根据文件id回调业务系统获取相应文件。
用户:Filez文档中台不需要同步业务系统的组织和用户。在线编辑和在线预览时,需要调用方(业务系统)提供当前用户信息。这些用户信息会记录在文档中台,并且体现在文件中,比如:修订记录,批注,协作记录中。
权限:只有业务系统知道某个用户在某一时刻是否可以在线编辑/预览某个文件。这些信息无需同步到文档中台。文档中台每次提供在线编辑/预览服务时,都会向业务系统询问当前用户是否有权限。
重要术语
文档ID (docId)
即docId。三方系统中的每一个文件都必须要有唯一的文档id。同一个文件,同一个id。三方系统请求在线编辑/预览服务时,需要指定编辑/预览的docId。
业务系统ID (appId/repoId)
Filez文档中台可以支持多个业务系统中文件的在线预览/编辑。每个业务系统需要在中台中注册一个唯一的appId。三方系统请求在线编辑/预览服务时,需要提供当前请求的appId。
三方业务系统回调Context
三方业务系统需要在服务端实现回调API,其回调地址的context(服务的endpoint)需要在Filez文档中台配置,至少要配置业务系统回调host。