什么是工业应用集成

• 交互框架集成：交互框架集成是指工业应用需要集成到数字工厂统一的门户中，需要通过完成以下几步，来实现统一交互：
  1. 通过功能页面集成，说明应用需要集成的功能。
  2. 账号集成，应用能获得数字工厂的账号、角色和权限相关信息。
  3. 日志集成，应用能够使用数字工厂的日志管理功能。
  4. 消息集成，应用能够使用数字工厂的消息功能。

  为保证工业应用的交互统一，组件层要求使用阿里云提供的标准组件库（基于可视化企业级中后台UI的解决方案 Fusion Design）和相关的视觉规范。前端工具链和数据层建议使用UmiJs，如果是Node应用，建议使用Egg。

• 基础数据集成：工业应用能直接使用数字工厂提供的主数据、工厂模型、工艺路径和库存地点，实现多应用的标准统一的基础数据来进行业务服务数据的交互：
  1. 元数据定义，可以通过接口定义本应用需要的元数据。
  2. 主数据集成，保证应用之间的主数据统一。
  3. 工厂模型集成，保证应用能同步数字工厂的工厂模型。
  4. 工艺路径集成，保证应用能同步数字工厂的工艺路径。
  5. 库存地点集成，保证应用能同步数字工厂的库存地点。
• 应用服务集成：工业应用可以集成数字工厂提供的服务，最终为数字工厂用户提供完整的业务功能，服务包括以下几类：
  1. OEE，数字工厂企业用户开通并使用数字工厂的OEE后，第三方工业应用可以通过OEE提供的服务来同步生产设备的状态变化也可以获得设备综合效率的计算结果。
  2. 生产过程追溯，数字工厂企业用户开通并使用数字工厂的生产过程追溯后，第三方工业应用可以通过生产过程追溯应用提供的服务来同步生产过程的产质耗数据。
  3. 获取工厂日历数据，应用能获得用户在数字工厂的工厂日历中进行排班和计划停产的数据。
  4. 获取经营数据，在获得企业用户授权后，应用能获取用户在经营驾驶舱中指标管理定义的经营指标数据以及资质管理中的营业执照信息、税务登记信息、营业办公信息、研发能力、质量管控能力、企业自有品牌以及其它资质能力。
• 业务数据集成：数字工厂提供以下标准经营分析功能，工业应用通过以下工业服务接口上报业务数据，用户可以直接通过经营驾驶舱查看对应经营分析结果：
  1. 通过接口上报生产成品入库和人员出勤，得到人均产量（能）分析的结果。
  2. 通过接口上报生产报工和过程质检数据，得到成品率分析的结果。
  3. 通过接口上报生产报工和过程质检数据，得到质量缺陷分析的结果。
  4. 通过接口上报设备综合效率，得到设备效率分析的结果。
  5. 通过接口上报生产成品入库和能源数据，得到能耗分析的结果。
  6. 通过接口上报人员出勤，得到人员出勤分析的结果。

在应用集成过程中需要使用工业云端服务，需要使用物联网平台服务的SDK，SDK支持以下语言：

• Java，SDK下载地址
• C#，SDK下载地址
• Nodejs，SDK下载地址
• Python2，SDK下载地址
• Python3，SDK下载地址

通过数字工厂的应用监控可以查看并设置应用相关的指标情况，帮助工业应用集成商进行应用运行健康状态的监控和使用情况分析。要获取实时监控的情况需要通过数字工厂开放的SDK进行相关指标的开发，指标包括三种类型：

• 应用JVM的CPU、磁盘、内存、网卡吞吐、线程池、GC情况
• 前端页面访问情况
• 免登接口心跳

/**
 * @ServletComponentScan 自动扫描我们SpringBoot项目内的有关Servlet配置，自动装配到我们的项目中。
 */
@ServletComponentScan(basePackages={"com.aliyun.iotx.industry.alimonitor.jmonitor.websuppert.items"})
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

第二步，初始化ServletContext，并传递参数servletContext.setInitParameter：

表 1. 参数说明

参数名称	是否必选	介绍
Jmonitor_OMP_AppKey	是	调用工业服务接口所使用的appKey
Jmonitor_OMP_AppSecret	是	调用工业服务接口所使用的appSecret
Jmonitor_OMP_Host	是	调用工业服务接口所使用的endpoint地址，线上环境是 api.link.aliyun.com
Jmonitor_Collect_Period	否	配置采集周期，单位秒，默认是60秒，配置该参数需要大于60秒
Jmonitor_Instance_Id	否	对于实例分发类型的应用，需要传instanceId用来区别应用实例

示例如下：

package com.aliyun.iotx;

import javax.servlet.ServletContext;
import javax.servlet.ServletException;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.web.servlet.ServletContextInitializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.env.Environment;

/**
 * @author zhengxiang.zzx
 * @version Id:WebContextConfiguration, v0.1 2020年06月23日 6:01 下午 zhengxiang.zzx Exp $
 */

@Configuration
public class WebContextConfiguration {

    @Value("${api.gateway.appkey:}")
    protected String appKey;

    @Value("${api.gateway.appsecret:}")
    protected String appSecret;

    @Value("${api.gateway.host:}")
    private String iotGatewayHost;

    @Value("${api.gateway.stage:}")
    private String iotGatewayStage;

    public final static String JMONITOR_OMP_APPKEY = "Jmonitor_OMP_AppKey";
    public final static String JMONITOR_OMP_APPSECRET = "Jmonitor_OMP_AppSecret";
    public final static String JMONITOR_OMP_HOST = "Jmonitor_OMP_Host";
    public final static String JMONITOR_OMP_STAGE = "Jmonitor_OMP_Stage";
    public final static String JMONITOR_COLLECT_PERIOD = "Jmonitor_Collect_Period";
    public final static String JMONITOR_INSTANCE_ID = "Jmonitor_Instance_Id";

    @Autowired
    private Environment env;

    @Bean
    public ServletContextInitializer servletContextInitializer() {

        return new ServletContextInitializer() {

            @Override
            public void onStartup(ServletContext servletContext) throws ServletException {

                // 优先使用环境变量传入的参数
                String key = env.getProperty("iot.hosting.appKey", appKey);
                String secret = env.getProperty("iot.hosting.appSecret", appSecret);
                String host = env.getProperty("iot.hosting.api.domain", iotGatewayHost);
                String stage = env.getProperty("api.gateway.stage", iotGatewayStage);

                servletContext.setInitParameter(JMONITOR_OMP_APPKEY, key);
                servletContext.setInitParameter(JMONITOR_OMP_APPSECRET, secret);
                servletContext.setInitParameter(JMONITOR_OMP_HOST, host);
                servletContext.setInitParameter(JMONITOR_OMP_STAGE, stage);

                // 采集周期 60 秒
                servletContext.setInitParameter(JMONITOR_COLLECT_PERIOD, "60");

                // test
                servletContext.setInitParameter(JMONITOR_INSTANCE_ID, "Rock-PC");
            }
        };
    }
}

    <!-- 在dependencies中添加dependency -->
    <dependencies>
        <dependency>
            <groupId>com.aliyun.iotx</groupId>
            <artifactId>iotx-industry-alimonitor-client</artifactId>
            <version>1.0.0</version>
            <scope>system</scope>
            <systemPath>${pom.basedir}/libs/iotx-industry-alimonitor-client-1.0.0.jar</systemPath>
        </dependency>
    </dependencies>

<!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.82</version>
</dependency>
<dependency>
    <groupId>com.aliyun.api.gateway</groupId>
    <artifactId>sdk-core-java</artifactId>
    <version>1.1.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun.iotx</groupId>
    <artifactId>iotx-api-gateway-client</artifactId>
    <version>1.0.3</version>
</dependency>

在前端代码用引入数字工厂前端监控js文件，引入后可以有两种方式上报并监控前端页面访问量：

• 针对SPA⻚⾯，⽀持⾃动监听上报数据，⻚⾯切换即时上报
• 主动上报接⼝，⽤户可以⾃定义上报数据

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
</head>
<body>
    <script src="https://g.alicdn.com/iotx-industry-fe/iotx-fe-logger/1.0.0/index.aio.min.js"></script>
    <script>
        // 引入Logger
          const Logger = window['iotx-fe-logger'].default;
                
                // 初始化Logger
        const log = new Logger({
          autoSendPv: true, // 是否自动上报
          appType: 'THIRD_APP',
          appKey: '25219625', //三方应用appKey
        });

        // 调用主动上报接口
        log.api({
          // appconfig 定义每个页面的pageId
          pageId: '/dashboard',
        });
    </script>
</body>
</html>