华为云开天集成工作台MSSI完全对接指南：从零搭建企业自动化集成体系

1. 开天集成工作台MSSI：企业集成的下一代平台

在数字化转型的浪潮中，企业面临的核心挑战之一是如何打通纷繁复杂的业务系统，让数据与流程在不同应用之间顺畅流转。传统的点对点集成方式不仅开发周期长、维护成本高，而且难以应对业务需求的快速变化。华为云开天集成工作台（MacroVerse SmartStage for Integrators，简称MSSI）正是为解决这一系列痛点而生的新一代集成平台。

MSSI是一个基于元数据的可配置集成框架，它汇聚了丰富的集成资产与开发工具，帮助企业以低代码甚至零代码的方式完成系统对接、业务流程自动化以及创新应用的快速构建。简单来说，MSSI不仅仅是一个集成工具，更是一个集连接器市场、流编排引擎、应用模型管理、业务可视化能力于一体的综合性集成工作台。

通过MSSI，开发者可以图形化地编排工作流，无需深入了解每个系统的API调用细节。平台预置了大量的公共连接器和流模板，实现了开箱即用的集成体验。同时，MSSI还提供了高效的业务可视化构建能力，支持一次开发、多屏使用。更为重要的是，MSSI深度整合了华为云的AI服务能力，让业务流程可以轻松获得智能化的处理能力。

MSSI的核心价值可以概括为三个层面：连接企业软件，以无代码方式实现多系统对接；构建企业自动化的业务流程，提升运营效率；基于可复用的组件如数据模型和连接器，以低代码方式快速创建企业应用。无论你是希望打通ERP与CRM系统的数据鸿沟，还是想要构建一个自动化的审批流，抑或是需要快速搭建一个业务数据看板，MSSI都能提供相应的能力支撑。

需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联

2. 服务开通与初始化配置

在开始使用MSSI的各项功能之前，首先需要完成服务的开通与初始化配置。这一过程虽然步骤不多，但每一步都关系到后续功能的正常使用，尤其是服务授权环节，直接决定了MSSI能否顺利调用依赖的云服务。

2.1 开通并购买MSSI服务

登录华为云控制台后，在服务列表中找到"开天集成工作台MSSI"，进入产品页面。首次使用需要单击"立即开通"，进入服务开通界面。在这里，你需要选择所属行业、填写企业名称与企业简称，然后根据业务需求选择相应的规格和购买时长。

MSSI提供了包年包月和按需计费两种计费模式。包年包月适合长期稳定的集成项目，能够获得更优惠的单价；按需计费则适合短期项目或初期探索阶段，用多少付多少，灵活度更高。在规格选择上，MSSI提供了不同套餐，主要差异体现在可使用的连接器数量、流运行实例数、屏幕与卡片数量等资源配额上。建议根据企业的实际集成规模进行选择，如果只是小规模试用，可以先从基础套餐开始。

勾选"我已阅读并同意《开天企业工作台服务协议》和《开天集成工作台服务协议》"后，单击"立即开通"即可完成服务购买。开通成功后，即可进入开天集成工作台的管理控制台首页。

2.2 配置服务授权

服务授权是MSSI使用过程中一个容易被忽略但至关重要的环节。MSSI在运行过程中需要与多个华为云服务进行交互，包括对象存储服务OBS、消息通知服务SMN、函数工作流FunctionGraph、应用运维管理AOM、人证核身服务IVS等。首次使用MSSI服务时，必须配置服务授权，允许MSSI访问这些依赖服务。

配置方法非常直观：进入开天集成工作台管理控制台后，系统通常会引导你完成授权配置。如果未自动弹出授权引导，也可以在控制台的"权限管理"相关页面手动触发授权流程。授权的本质是在IAM（统一身份认证）中为MSSI服务创建委托，赋予其调用其他云服务API的权限。完成授权后，MSSI才能在执行流编排时正常读写OBS文件、发送SMN通知、触发FunctionGraph函数等。

需要特别注意的是，服务授权一旦配置完成，建议不要随意修改或删除相关委托，否则可能导致已创建的流或连接器无法正常运行。

2.3 权限管理：创建并授权使用MSSI

对于企业级使用场景，通常需要为不同的团队成员分配不同的操作权限。MSSI的权限管理基于华为云的IAM体系，管理员可以创建子账号并授予特定的MSSI操作权限。

MSSI预置了多种系统策略，涵盖了从只读查看到完全控制的不同权限级别。除了使用系统预置策略外，管理员还可以创建自定义策略，实现更精细的权限控制。例如，可以创建一个自定义策略，允许某团队只能管理连接器而不能操作流编排，或者只允许查看特定项目的资源。

自定义策略的编写采用JSON格式，通过指定Action（操作）和Resource（资源）来定义权限范围。下面是一个简单的自定义策略示例，仅允许用户查看流列表和流详情：

{
  "Version": "1.1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "mssi:flow:list",
        "mssi:flow:get"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

在实际生产环境中，建议遵循最小权限原则，只为每个用户或用户组授予完成其工作所需的最小权限集合，避免因权限过大带来的安全风险。

3. 核心概念深度解析

在深入使用MSSI之前，理解其核心概念至关重要。MSSI的架构围绕四个核心模块展开：连接器、流编排、应用模型与业务可视化。这四个模块相互配合，构成了一个完整的集成工作台生态。

3.1 连接器：系统对接的桥梁

连接器是MSSI中最基础的集成单元，它本质上是API的集合，每一个执行动作就是一个API或一个函数。连接器封装了与外部系统交互的细节，包括认证方式、请求格式、响应解析等，让开发者无需关心底层API的调用复杂性。

从来源上划分，连接器分为公共连接器和私有连接器两类。公共连接器是平台预置的，所有开通了MSSI服务的用户均可使用，涵盖了华为云服务类（如OBS、短信、会议、人脸识别等）、生活服务类（如天气查询、热搜榜等）以及各种常用协议类（如HTTP、MySQL、Kafka、Redis等）。私有连接器则是用户自行创建，仅创建者本人可用，但可以通过共享功能授权给其他用户使用。

从状态上划分，连接器有不可用、未发布、已发布、审核中、已上架五种状态。创建出来的连接器如果还未添加任何触发事件或执行动作，则处于不可用状态；添加了触发事件或执行动作后变为未发布状态；发布后才具备实际使用能力，可以在流编排中被调用。已发布的连接器可以提交上架申请，审核通过后成为公共连接器，供所有用户使用。

3.2 流编排：自动化流程的引擎

流编排是MSSI的核心能力之一，它通过图形化的方式将不同的连接器串联起来，形成完整的自动化业务流程。一个流由触发事件和一个或多个执行动作组成，触发事件是流的起点，执行动作是流的具体操作步骤。

触发事件决定了流何时开始执行。MSSI支持多种触发方式，包括手动触发、定时触发（计划）、轮询触发以及Webhook触发等。手动触发流需要用户在界面点击运行；定时触发流可以设置在每天的特定时间执行；轮询触发流会以指定的频率调用服务检查是否有新数据；Webhook触发流则会在外部系统通过Webhook发送事件时被动触发。

执行动作是流中的具体操作，每个执行动作对应连接器中的一个API调用。开发者可以通过拖拽的方式添加执行动作，并配置相应的输入参数。执行动作之间可以传递数据，前一个动作的输出可以作为后一个动作的输入，从而实现复杂的数据流转和处理逻辑。

流编排的另一个重要特性是支持条件判断、循环、变量等控制逻辑，使得流的构建能够应对各种复杂的业务场景。对于需要自定义复杂逻辑的场景，MSSI还提供了Code代码连接器，允许开发者编写JavaScript脚本实现定制化的数据处理。

3.3 应用模型：数据资产的规范化管理

应用模型是MSSI中用于管理企业数据资产的模块，它以元数据为基础，帮助用户将抽象的业务概念具体化、规范化。通过应用模型，用户可以定义信息架构、创建业务模型实例，并对模型实例进行统一维护与管理。

模型采集是应用模型的重要功能之一，系统预置了多种常用数据源适配器，可以采集MySQL、Oracle等数据库中的技术模型。用户只需配置采集任务，系统即可自动从数据源中抽取元数据信息，生成对应的模型实例。这一能力极大地降低了数据资产梳理的工作量，让企业能够快速建立起自己的数据资产目录。

模型目录则是应用模型的展示与检索入口，用户可以在模型目录中浏览、搜索和管理各类模型实例。MSSI提供了搜索引擎界面，支持索引类管理，同时还能根据用户搜索行为生成搜索热词，从多个维度提高模型搜索的效率和准确性。

3.4 业务可视化：数据的直观呈现

业务可视化模块让用户能够快速构建数据展示页面，将集成后的数据以图表、卡片等形式直观地呈现出来。MSSI支持一次开发、多屏使用的理念，构建好的屏幕可以在大屏、中屏、小屏等多种设备上展示。

业务可视化的基本单元是卡片，用户可以通过创建卡片模板来复用常见的展示样式。多个卡片可以组合成一个屏幕模板，进而生成最终的屏幕。屏幕轮播功能则允许用户在多个屏幕之间自动切换展示。这一套体系使得企业可以快速搭建运营看板、数据监控大屏等可视化应用。

4. 连接器的创建与使用实战

连接器是MSSI对接外部系统的核心组件，掌握连接器的创建与使用方法，是熟练运用MSSI的基础。本节将详细介绍从零创建连接器的完整流程，包括触发事件和执行动作的开发。

4.1 连接器创建流程概览

创建连接器的完整流程包括以下步骤：创建连接器、创建触发事件、创建执行动作、发布连接器。其中，触发事件和执行动作的创建顺序可以根据实际需求灵活调整，但两者至少需要完成一个，连接器才能从不可用状态变为未发布状态。

4.2 创建连接器

在开天集成工作台管理控制台中，选择左侧导航栏的"连接器 > 我的连接器"，然后单击"创建连接器"。在创建页面中，需要填写连接器的基本信息，包括名称、描述、图标等。最关键的一步是选择认证方式，MSSI支持多种身份验证类型：

• 无验证：不需要任何身份验证即可建立连接
• 基本认证：使用用户名和密码进行认证
• API Key：通过API密钥进行认证
• OAuth 2.0：包括通用OAuth 2.0和适用于特定服务的OAuth 2.0
• IAM：华为云统一身份认证
• AK/SK：Access Key/Secret Key认证
• 自定义：用户自定义认证方式

认证方式的选择取决于目标系统的API要求，选择正确的认证方式是连接器能够正常工作的前提。

4.3 创建触发事件

触发事件定义了流开始执行的时机。在连接器详情页面，选择"触发事件"页签，单击"创建触发事件"。创建触发事件时需要配置以下核心信息：

• 触发事件名称：描述性的名称，便于在流编排中识别
• 触发类型：选择轮询触发事件或Webhook触发事件
• 时间间隔：如果选择轮询触发，需要设置轮询的时间间隔，最小为1分钟
• 接口路径与输入参数：配置调用接口的URL路径和请求参数
• 响应体结构：配置接口返回数据的结构，后续流编排中如需引用响应体中的数据，必须在此提前定义好数据结构

响应体结构的配置尤为关键，它决定了在流的后续执行动作中能否正确解析和使用触发事件返回的数据。如果响应体结构定义不完整，后续节点将无法获取到所需的数据字段。

4.4 创建执行动作

执行动作是连接器对外提供的具体功能。在连接器详情页面，选择"执行动作"页签，单击"创建执行动作"。配置执行动作时需要定义输入参数和输出参数：

• 基本信息：执行动作的名称和描述
• 接口信息：请求方法（GET/POST/PUT/DELETE等）、接口路径
• 输入参数：调用该执行动作时需要传入的参数列表，包括参数名称、类型、是否必填、描述等
• 输出参数：执行动作返回的数据结构定义

执行动作创建完成后，需要先发布连接器才能进行测试。发布后，在连接器的执行动作页面可以进行测试，配置连接和输入参数后提交测试，系统会返回调用结果。如果测试通过，表示执行动作创建成功；如果测试不通过，可以编辑修改后重新发布再测试。

4.5 连接器的共享与上架

私有连接器可以通过共享功能授权给其他华为云租户使用。在"我的连接器"列表中，单击目标连接器的"共享"按钮，在共享管理界面中输入需要共享的账号（其他华为云租户账号），即可完成共享。

如果希望将连接器开放给所有MSSI用户使用，可以提交上架申请。上架流程需要经过管理员审批，审批通过后连接器将变为公共连接器。上架时需要设置连接器上架后的名称、图标等信息。

5. 流编排的完整实践

连接器创建完成并发布后，就可以在流编排中使用它们来构建自动化业务流程了。本节将从使用流模板创建流、从空白创建流、以及使用API接口创建流三个角度，全面介绍流的创建与使用方法。

5.1 使用流模板创建流

对于初学者或者业务场景与已有模板高度匹配的情况，使用流模板是最快捷的创建方式。MSSI提供了丰富的公共流模板，覆盖了常见的企业集成场景。

操作步骤如下：在控制台左侧导航栏选择"流编排 > 公共流模板"或"流编排 > 我的流"中的"从模板创建流"页签，浏览并筛选需要的流模板，单击"创建流"。如果模板中包含了配置项，系统会进入配置管理界面，用户需要根据实际情况配置连接、设置参数、进行扩展配置等。

配置管理界面会智能地引导用户完成所有必要的配置步骤：配置连接（为需要认证的连接器选择或创建连接）、设置参数（修改全局配置项的默认值）、扩展配置（修改连接器的输入和输出参数）、创建函数（如果模板使用了函数）。完成所有配置后单击"创建"，流即创建成功。

成功创建流后，用户还可以继续编辑流，在原有模板的基础上添加或修改触发事件和执行动作，以适应更具体的业务需求。

5.2 从空白开始创建流

当业务场景比较特殊，没有现成的模板可用时，可以从空白开始创建流。操作路径为：选择"流编排 > 我的流"，单击"创建流"。

创建流的第一步是配置触发事件。在左侧画布中，从连接器列表中选择合适的连接器及其对应的触发事件。例如，如果希望流在每天固定时间执行，可以选择"计划"连接器的"重复执行"触发事件；如果需要通过外部调用触发，可以选择"手动触发流"。配置触发事件时，需要设置相应的参数，如定时触发的执行时间、手动触发的输入参数等。

配置完触发事件后，需要添加执行动作。在画布中单击"添加执行动作"，从连接器列表中选择目标连接器及其对应的执行动作。配置执行动作的输入参数，这些参数可以来自触发事件的输出，也可以是用户手动输入的固定值。多个执行动作可以依次串联，形成完整的数据处理链路。

完成所有配置后，单击"保存"即可保存流。保存成功后可以选择开启流，开启后的流将按照触发事件的配置自动运行。

5.3 通过API接口创建流

对于需要将流编排能力集成到自有系统中的场景，MSSI提供了完整的API接口。开发者可以通过调用API来创建流、运行流、查看流运行记录等。

使用API接口创建流的基本思路是：首先通过API创建连接器（或使用已有连接器），然后通过API创建流并配置触发事件与执行动作。具体操作可以参考MSSI的API参考文档，文档中详细说明了每个接口的请求参数和返回格式。

API调用的前提是已开通MSSI服务并获取了API调用所需的认证凭证。对于初次使用API的用户，建议先在控制台中通过界面方式创建并测试流，确认流程正确后再通过API进行自动化创建和管理。

6. 应用模型与业务可视化

除了连接器和流编排这两个核心功能外，MSSI的应用模型和业务可视化模块为企业提供了数据资产管理和数据展示的完整能力。

6.1 应用模型的采集与使用

应用模型的核心功能是数据资产的采集与管理。在控制台中选择"应用模型 > 实例管理"，进入实例控制台后选择"模型采集 > 采集任务"。在这里可以创建新的采集任务，选择数据源类型（如MySQL），配置数据源连接信息，然后设置采集任务的执行周期。

采集任务创建后，系统会按照设定的周期自动从数据源中抽取元数据，生成模型实例。这些模型实例会出现在模型目录中，用户可以通过模型目录进行浏览和检索。对于已经采集的模型数据，如果源数据发生了变更，可以通过编辑采集任务来刷新数据。

模型目录支持"数据资产信息架构"视图，用户可以在其中管理基础对象，构建企业的数据资产体系。

6.2 业务可视化的构建流程

业务可视化的构建遵循从卡片到屏幕的递进式流程。首先创建卡片模板，定义卡片的基本样式和数据绑定方式；然后基于卡片模板创建具体的卡片实例；接着将多个卡片组合成屏幕模板；最后基于屏幕模板创建最终的屏幕。

屏幕轮播功能允许将多个屏幕按照设定的顺序自动切换展示，非常适合在运营大屏等场景中使用。控制台的首页提供了资源的快速入口，用户可以方便地查看和管理自己的流、连接器、屏幕、卡片等各类资源。

7. Java SDK集成与API调用实践

对于希望将MSSI能力深度集成到自有Java应用中的开发者，MSSI提供了官方SDK。SDK封装了API调用的细节，让开发者可以更便捷地操作MSSI的各项功能。

7.1 SDK获取与引入

MSSI SDK托管在GitHub仓库中，开发者可以在仓库中查看SDK的更新历史、获取安装包以及查看详细的指导文档。由于GitHub服务器部署在海外，国内用户访问时可能会遇到网络问题，建议切换网络环境后重试。

对于Java开发者，SDK通常以Maven依赖的方式引入项目。具体的GroupId和ArtifactId请参考官方文档中的SDK列表。

7.2 使用API Explorer生成SDK代码

华为云提供了API Explorer工具，能够根据用户的API调用需求动态生成SDK代码，极大降低了SDK的使用门槛。开发者可以在API Explorer中搜索MSSI的相关API，填写请求参数后，系统会自动生成对应编程语言的调用代码，开发者可以直接复制使用。

7.3 Java SDK调用示例

以下是一个使用Java SDK调用MSSI API创建连接的示例代码：

import com.huaweicloud.sdk.mssi.v1.MssiClient;
import com.huaweicloud.sdk.mssi.v1.model.CreateConnectionInfoRequest;
import com.huaweicloud.sdk.mssi.v1.model.CreateConnectionInfoResponse;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.http.HttpConfig;

public class CreateConnectionExample {
    public static void main(String[] args) {
        // 配置认证信息
        BasicCredentials credentials = new BasicCredentials()
            .withAk(System.getenv("HUAWEICLOUD_SDK_AK"))
            .withSk(System.getenv("HUAWEICLOUD_SDK_SK"));
        
        // 创建客户端
        MssiClient client = MssiClient.newBuilder()
            .withCredentials(credentials)
            .withRegion("cn-north-4")
            .build();
        
        // 构建请求
        CreateConnectionInfoRequest request = new CreateConnectionInfoRequest();
        // 设置连接器ID、连接名称、认证参数等
        // request.setConnectorId("your-connector-id");
        // request.setName("my-connection");
        // ... 设置其他参数
        
        // 发送请求
        CreateConnectionInfoResponse response = client.createConnectionInfo(request);
        System.out.println(response.toString());
    }
}

上述代码展示了使用Java SDK调用MSSI API的基本模式：配置AK/SK认证、创建客户端、构建请求对象、发送请求并处理响应。实际使用时，需要根据具体的API接口替换相应的请求类和参数设置。

7.4 运行流与查看活动记录

通过API不仅可以创建流，还可以运行流并查看其活动记录。运行流的API允许开发者从外部系统触发流的执行，而查看活动记录的API则可以帮助开发者监控流的运行状态，及时发现和排查问题。

在流编排过程中，如果遇到运行失败的情况，可以通过查看活动记录获取详细的错误信息，定位问题根因。对于复杂的错误，可以结合API Explorer工具分析错误原因。

8. 安全与权限管理

在企业级应用中，安全与权限管理是不可忽视的重要环节。MSSI在这方面提供了多层次的保障机制。

8.1 IAM权限体系

MSSI的权限管理建立在华为云统一的IAM体系之上。管理员可以通过IAM创建用户组，为用户组授予特定的MSSI权限策略，然后将用户加入用户组即可完成权限分配。

除了使用系统预置的策略外，管理员还可以创建自定义策略来实现更精细的权限控制。自定义策略可以精确到具体的操作和资源，例如只允许某个用户管理特定的流或连接器。

8.2 数据保护与安全合规

MSSI在数据传输和存储方面采用了业界标准的加密技术，保障用户数据的安全性。同时，华为云遵循责任共担的安全模型，华为云负责平台层面的安全，用户负责自身应用和数据的安全。

在使用连接器时，认证信息（如API Key、密码等）在MSSI中会进行加密存储，避免明文泄露的风险。对于涉及敏感数据的流，建议在流编排中采用加密传输、脱敏处理等额外的安全措施。

9. 成本优化与计费管理

合理规划MSSI的使用方式，可以有效控制成本，让有限的预算发挥最大的价值。

9.1 计费模式选择

MSSI提供包年包月和按需计费两种模式。包年包月适合长期稳定的集成项目，单价更低，但需要预付费用；按需计费适合短期项目或探索性试用，用多少付多少，灵活性更高。

两种计费模式可以互相切换，但需要注意切换时的费用处理规则。如果在包年包月期间切换为按需计费，已预付的费用会按照剩余时长进行折算退还。

9.2 资源配额与成本控制

不同的套餐规格对应不同的资源配额，包括流的数量、连接器的数量、屏幕和卡片的数量等。在选择套餐时，建议根据实际的业务规模进行估算，避免资源浪费或因配额不足影响业务。

对于暂时不使用的流，可以将其关闭以节省资源消耗。同时，MSSI支持将流分配给不同的企业项目，便于进行成本分摊和资源管理。

9.3 常见计费问题

有些用户可能会发现"没有使用集成工作台却产生了费用"，这种情况通常是因为存在已开启但未使用的流，或者订阅了某些收费的连接器。建议定期检查流的开启状态，及时关闭不再使用的流。此外，套餐包到期后如果没有续费，会自动转为按需计费，也可能产生意料之外的费用。

10. 常见问题解答

问1：MSSI服务开通后，为什么有些功能无法使用？

答：最常见的原因是未完成服务授权配置。MSSI需要授权访问OBS、SMN、FunctionGraph等依赖服务才能正常工作。请进入控制台检查服务授权状态，按照引导完成授权配置。

问2：私有连接器和公共连接器有什么区别？

答：私有连接器由用户自行创建，仅创建者本人可用，但可以通过共享功能授权给其他用户。公共连接器是平台预置或由其他用户上架并通过审核的连接器，所有开通MSSI服务的用户均可使用。

问3：创建连接器时，认证方式应该如何选择？

答：认证方式的选择取决于目标系统的API要求。如果API使用用户名密码认证，选择基本认证；如果使用API Key，选择API Key认证；如果使用华为云AK/SK，选择AK/SK认证。选择错误的认证方式会导致连接失败。

问4：流运行失败后如何定位问题？

答：可以在流的监控与日志页面查看运行记录和详细错误信息。每个执行节点的输入输出都可以查看，便于定位具体是哪个环节出了问题。也可以结合API Explorer工具分析错误原因。

问5：MSSI支持哪些编程语言的SDK？

答：MSSI提供了多种编程语言的SDK，包括Java、.Net等。具体的SDK列表和获取方式请参考官方文档中的SDK概述页面。此外，API Explorer支持在线生成多种语言的SDK代码。

问6：包年包月和按需计费如何选择？

答：包年包月适合长期稳定的项目，单价更优惠；按需计费适合短期项目或初期探索阶段，灵活性更高。两种模式可以互相切换。建议根据项目的预计持续时间和预算灵活选择。