cerneam/eam-wshub

Infor EAM 简化集成门面 Web 应用

镜像概述

本Docker镜像包含一个Web应用程序，专为Infor EAM（企业资产管理系统）提供简化的REST和SOAP协议门面服务。其核心功能是将Infor EAM的原生接口转换为更易于使用的标准化API，帮助企业快速实现与外部系统（如ERP、CRM、BI工具等）的集成，减少集成开发工作量。

核心功能与特性

• 多协议支持：同时提供REST和SOAP两种接口，满足不同系统的集成需求
• 接口简化：对Infor EAM复杂的原生接口进行封装，提供更直观、易用的API
• 标准化交互：统一数据格式和错误处理机制，降低跨系统集成的复杂度
• 轻量级部署：基于Docker容器化部署，支持快速启动和横向扩展

使用场景

• 企业系统集成：需将Infor EAM与ERP、HR系统、采购系统等企业内部系统对接时
• 第三方应用开发：开发人员需要通过API访问Infor EAM数据进行定制化应用开发
• 数据同步需求：需定期从Infor EAM同步数据至BI工具或数据仓库时
• ** legacy系统对接**：帮助仅支持SOAP协议的旧系统与Infor EAM建立连接

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name infor-eam-facade \
  -p 8080:8080 \
  -e INFOR_EAM_URL="https://your-infor-eam-instance.com" \
  -e EAM_USERNAME="your-eam-username" \
  -e EAM_PASSWORD="your-eam-password" \
  -e LOG_LEVEL="INFO" \
  infor-eam-facade:latest

Docker Compose 配置

yaml
version: '3'
services:
  infor-eam-facade:
    image: infor-eam-facade:latest
    container_name: infor-eam-facade
    ports:
      - "8080:8080"
    environment:
      - INFOR_EAM_URL=https://your-infor-eam-instance.com
      - EAM_USERNAME=your-eam-username
      - EAM_PASSWORD=your-eam-password
      - LOG_LEVEL=INFO
      - CACHE_TTL=300  # 接口响应缓存时间(秒)
    restart: unless-stopped

环境变量配置

验证部署

服务启动后，可通过以下方式验证：

1. 访问REST API根路径：http://localhost:8080/api/v1，应返回API文档或状态信息
2. 访问SOAP服务WSDL：http://localhost:8080/soap/eam?wsdl，应返回WSDL文档
3. 检查容器日志：docker logs infor-eam-facade，确认无错误信息

接口说明

REST API

REST接口采用标准RESTful设计，主要端点包括：

• GET /api/v1/assets - 获取资产列表
• GET /api/v1/assets/{id} - 获取单个资产详情
• POST /api/v1/workorders - 创建工作订单
• GET /api/v1/inventory - 查询库存信息

SOAP服务

SOAP服务提供与REST接口对应的功能，WSDL地址为/soap/eam?wsdl，主要操作包括：

• GetAssetDetails - 获取资产详情
• ListWorkOrders - 列出工作订单
• CreateInventoryTransaction - 创建库存交易