SaaS应用开发指南

​

1 低代码开发SaaS应用全链路流程说明

参考合作全流程指引 - 开放平台

​

1.1 前置准备

​

1.2 如何进入SaaS研发工作台

​

1.3 aPaaS底座功能支持范围

• 平台功能：

​

2 主应用设计

在完成前置准备工作后，您可以研发SaaS应用，如果您在现有其他宜搭组织下已经有完备的解决方案，希望直接切换成SaaS模式，可联系宜搭产研申请应用迁移至SaaS环境。

1. 您可以基于SaaS研发工作台并且根据目前平台提供的能力，按照业务诉求设计您的应用，如设计：

2. 如果您的SaaS品有相关业务底表数据且希望用户在订阅SaaS应用后，能看到相关示例数据， 请录入“基础数据”并统一维护至一个目录文件夹内，文件命名“ 基础业务数据 ”（示例如下图）

​

3 酷应用设计

​

4 应用发布

1

步骤 1

主应用和酷应用都开发完毕后，您可以进入“发布&上架”界面，创建一个新的版本，用于SaaS应用的功能测试，测试完毕后申请上架。

2

点击新建版本，填写SaaS应用的版本信息，包括版本号、版本描述内容

​

4.1 应用版本管理

• 应用功能发生变化之后，您可以随时创建一个新的版本，默认版本状态为“未发布”状态。可以点击发布，发布该版本。

​

4.2 应用申请上架-关联第三方应用

​

step1 关联第三方应用

SaaS研发工作台	钉钉开放平台>企业第三方应用
1. 创建完至少一个应用版本后，可在 上架到钉钉应用中心内 提交上架申请 2. 选择在开放平台注册的第三方应用，在此关联选择即可。	1. 在钉钉开放平台内 > 企业第三方应用 类目下 创建H5微应用，填写应用基础信息 2. 生成应用凭证

​

step2 填写SaaS应用开发信息

SaaS研发工作台	钉钉开放平台>企业第三方应用
1. 完成步骤1后，点击“复制”，将上述链接复制到开放平台，如右图	1. 在钉钉开放平台内 > 企业第三方应用 选择注册的三方应用，点击“开发管理”，填写：

​

step3 检查SaaS应用配置项

（1）确认应用开发信息

1. 在钉钉开放平台内 > 企业第三方应用 选择注册的三方应用，如上图确认功能配置项是否均已完成，遗漏的需要继续配置。

（2）权限管理配置

1. 选择“权限管理”菜单， 标准SaaS品均需要勾选以下权限信息，勾选后点击“批量申请”。

2. 如果当前您搭建的SaaS品在“集成自动化>连接器节点”使用了“钉钉官方”连接器，请联系宜搭同学，确认需要勾选一方连接器的权限。

连接器	对应的权限分类	对应的权限点
	智能会议室	视频会议应用会议写权限
	项目管理	项目应用任务写权限

​

step4 自助申请跳过安全自检

1. 应用跳过自检，需要设置“事件与回调”，如下图：

private static final char[] HEX_ARRAY = "0123456789abcdef".toCharArray();

public static String bytesToHex(byte[] bytes) {
        char[] hexChars = new char[bytes.length * 2];
        for (int i = 0; i < bytes.length; i++) {
            int v = bytes[i] & 0xFF;
            hexChars[i * 2] = HEX_ARRAY[v >>> 4];
            hexChars[i * 2 + 1] = HEX_ARRAY[v & 0x0F];
        }
        return new String(hexChars);
    }

private static String decrypt(String input) throws NoSuchAlgorithmException {
        MessageDigest digest = MessageDigest.getInstance("SHA-256");
        byte[] hash = digest.digest(input.getBytes(StandardCharsets.UTF_8));
        // 将散列码转换成43位加密串
        return bytesToHex(hash).substring(0, 43);
}

2. 填写应用自检《安全审核》相关内容，安全准入评估参考 📎宜搭酷SaaS安全准入指南-ISV .pdf

​

4.3 体验组织管理

1

步骤 1

选择对应的SaaS应用版本，点击”体验组织管理“，选择体验组织，如果无，可点击 ”创建“ ，前往开放平台进行创建体验组织。

2

步骤 2

体验组织创建完毕后，可将需要测试的应用版本关联授权到该组织即可，授权成功后，可在该体验组织的工作台>未分组 下查看该应用。

​

4.3.1 体验测试主应用

1

步骤 1

通过工作台访问该应用后，当体验测试组织人非“通讯录的管理员”或”应用主管理员“时，可联系组织管理员或应用管理员添加进入应用后台的管理权限。

2

拥有进入应用管理后台的权限后，可查看订阅的SaaS应用后台配置，特定功能支持修改

通用逻辑说明：一旦修改后，后续ISV升级版本后，对应功能有变更，客户侧订阅后将以本地修改的配置为主，不会同步更新主应用的变更到子应用；如果未修改，主应用增量资源变更将会同步至子应用。 审批流程修改变更逻辑说明：

1. 如果子应用订阅了V0版本，如果主应用有未发布的V1版本，在子应用历史版本中不予展示
2. 如果子应用订阅了V0版本，并未进行自定义，后续主应用升级到V1版本，子应用也应该按订阅的V0版本进行展示和运行
3. 如果子应用订阅了V0版本，并进行自定义，会创建一份自己内部的V0历史版本，然后创建一份V1的草稿态，同时子应用订阅新版本应用后，当前流程不再跟随主应用升级
4. 以上流程版本包括版本内的所有业务规则和公式

3. 默认会将主应用内“基础业务数据”表单数据携带至子应用，保障底表数据开箱即用，支持修改。

​

4.3.2 体验测试酷应用

1

步骤 1

主应用测试通过后，可测试酷应用，首先提交酷应用相关信息。点击“上架到钉钉酷应用市场>提交上架申请”，填写酷应用上架信息，包括酷应用基础信息、访问入口（最多可配置3个）及打开方式、机器人信息等。

2

相关信息填写完毕后，点击保存并发布，会生成coolappcode

3

您可以复制该酷应用的coolappcode，在当前体验组织下创建内部群，前往移动端按照下图进行安装测试

​

5 应用运维

​

5.1 版本升级

1. 默认可升级的版本功能范围为当前已发布之后迭代的最新版本列表
2. 支持针对多个付费组织进行批量版本升级

远程运维敬请期待

​

5.2 应用开通授权背景页设置

• 分别上传PC端/移动端开通授权背景页面（仅支持上传一张）

• 上传完毕后复制“试用访问地址”后前往 伙伴自运营平台 > 第三方企业应用 > 商品上架管理 > 应用详情 > 管理 “应用内授权设置”信息 ，接入完成且自行验收通过后 （ 👉 详细了解验收流程 ） ，该SaaS应用可在钉钉线上更多渠道进行推广（如钉钉搜索等场域）

移动端效果	PC端效果

​

6 常见FAQ