描述

MES 模块是一个用于与 MES（Manufacturing Execution System，制造执行系统）进行交互的工具模块，它提供了方便的接口来进行数据的获取和提交操作，有助于在相关应用程序中实现与 MES 系统的集成，从而更好地管理和监控生产过程中的各种数据和流程。

安装

使用npm进行安装： npm i messerver

使用方法

• 引入模块与实例化

• 在项目中引入模块后，需要通过以下方式实例化MesService类： 引入模块后

  new MesService(url)  

• 其中，url是接口地址，用于指定与 MES 系统进行通信的基础路径。例如，如果 MES 系统部署在本地服务器的192.168.0.1地址上，监听8080端口，那么url的值应为http://192.168.0.1:8080。这个地址是与 MES 系统进行交互的入口，所有的请求都将基于此地址进行构建和发送。

• 接口说明

  • get请求

    • 功能描述：

    • 用于向 MES 系统发送GET请求，以获取指定接口的数据。GET请求通常用于从服务器获取资源或信息，在 MES 系统中，可能用于获取生产订单信息、设备状态、库存数据等。

    • 参数：

    • interfaceName（字符串）：接口名称。这是 MES 系统中具体的接口路径的一部分，用于确定要获取的数据资源。例如，如果 MES 系统中有一个获取当前生产任务列表的接口，可能interfaceName为/productionTasks，那么完整的请求 URL 将是http://192.168.0.1:8080/productionTasks（假设基础url是http://192.168.0.1:8080）。

  • 返回值：

  • 返回一个Promise，这意味着该方法返回的是一个异步操作的结果。在异步操作完成后，Promise 将被解析为获取到的数据。数据的具体类型是any，实际使用中需要根据 MES 系统接口的返回数据结构进行适当的类型转换和处理。例如，如果接口返回的是 JSON 格式的生产任务列表数据，可能需要将其解析为对应的数组或对象结构以便进一步使用。

  • 示例代码：

       const mesService = new MesService('http://192.168.0.1:8080');
   async function getProductionTasks() {
     try {
       const tasks = await mesService.get('/productionTasks');
       console.log('获取到的生产任务：', tasks);
       // 在这里可以对获取到的任务数据进行进一步的处理，如显示在界面上或进行数据分析等。
     } catch (error) {
       console.error('获取生产任务失败：', error);
     }
   }
  

• post请求

  • 功能描述：

  * 用于向 MES 系统发送POST请求，以提交数据或执行某些操作，如创建新的生产订单、更新设备状态等。POST请求通常用于向服务器发送数据以进行创建、更新等操作。

  • 参数：

  * interfaceName（字符串）：与get请求中的interfaceName类似，用于确定要访问的 MES 系统中的具体接口路径。例如，如果要创建一个新的生产订单，interfaceName可能为/orders/create。
  * data（任何类型）：请求参数，即要发送到 MES 系统的数据。这可以是一个对象，包含创建订单所需的信息，如产品类型、数量、预计交付日期等；也可以是其他格式的数据，具体取决于 MES 系统接口的要求。
  * contentType（字符串，默认值为'application/json'）：请求的内容类型。它指定了发送给服务器的数据格式。默认情况下是application/json，表示数据以 JSON 格式发送。但有些 MES 系统可能也支持其他格式，如application/x-www-form-urlencoded等。如果要使用其他格式，需要手动指定contentType的值，并确保data的数据格式与指定的contentType相匹配。

  • 返回值：

  • 同样返回一个Promise，在异步操作完成后，Promise 将被解析为服务器返回的响应数据。响应数据的类型和含义取决于 MES 系统接口的设计，可能是操作成功的确认信息、创建的资源的详细信息或其他相关数据。

  • 示例代码：

           const mesService = new MesService('http://192.168.0.1:8080');
   async function createOrder(orderData: any) {
     try {
       const response = await mesService.post('/orders/create', orderData);
       console.log('订单创建成功，响应：', response);
       // 可以根据响应进行进一步的处理，如显示创建成功的提示信息或更新界面状态等。
     } catch (error) {
       console.error('订单创建失败：', error);
     }
   }
   // 假设创建一个订单的数据如下
   const orderToCreate = {
     productType: 'ProductA',
     quantity: 100,
     expectedDeliveryDate: '2024-12-31'
   };
   createOrder(orderToCreate);
  

  • 通过以上详细的说明，希望能够帮助开发者更好地理解和使用 MES 模块，实现与 MES 系统的有效交互，从而满足生产管理相关应用程序的开发需求。在实际使用过程中，还需要根据 MES 系统的具体接口规范和业务逻辑进行适当的调整和错误处理。同时，要注意网络环境的稳定性和安全性，确保数据的准确传输和保护。