ims-API-Tool 4.1.0

ims-API-Tool是一款专为iTAC.MES集成人员设计的强大VSCode扩展工具，旨在提升您的开发和测试效率。通过集成所有9.50版本的API函数，提供自动补全JavaScript代码的功能，帮助您快速编写和调试代码。该扩展将持续更新，带来更多新功能。

主要功能：

• 自动补全JavaScript代码： 内置所有9.50版本的API函数，简化您的编码过程。
• 自定义函数测试工具： 需要访问iTAC.MES应用服务器，进行自定义函数的测试。
• 配置文件自动生成： 扩展会自动生成最小的配置文件，您只需更新正确的设置即可连接到iTAC.MES服务。

配置示例：

在imsConfig.json中，您可以设置如下参数：

{
    "clusterNode": "https://hostname:8181/mes",
    "scriptName": "vsc",
    "scriptFile": "js/script.js",
    "resultFile": "result.out",
    "defaultStation": "01010010",
    "userId": "VSCODE",
    "userPw": "******",
    "client": "01",
    "sysIdentifier": "VSC Test",
    "logPath": "C:/iTAC.MES.Suite",
    "defaultLocale": "en_EN",
    "majorVersion": 1,
    "minorVersion": -1,
    "upload": true,
    "test": false
}

测试场景设置：

测试场景文件存放在Test文件夹中，结构如下：

./
 L test/
     L usecase1/
         L before_<use_case_name>.json 
         L totest_<use_case_name>.json 
     L usecase2/
         L before_<use_case_name>.json 
         L totest_<use_case_name>.json 

每个子文件夹包含before_和totest_前缀的测试场景文件。before_文件用于初始化MES系统中的测试数据，totest_文件在数据初始化后执行，并根据测试场景中的断言约束返回执行结果和数据验证。

测试场景示例：

在imsScenarios.json中，您可以定义测试场景：

{
    "project": "Project name",
    "description": "Test scenarios for custom script",
    "default": {
        "scenario": "",
        "name": "Default Test Use Case",
        "method": "Test_GEN",
        "args": []
    },
    "scenarios": [
        {
            "scenario": "Scenario 1: Get stations settings",
            "name": "Test Use Case 1",
            "method": "cfGetStationSettings",
            "args": [
                "01010010"
            ],
            "outErrorCode": {
                "assertGreaterOrEquals": -5,
                "assertSmaller": 10
            },
            "outErrorString": {
                "assertEquals": ""
            },
            "outArgSize": {
                "assertEquals": 1
            },
            "outArgs": [
                {
                    "assertMatches": {
                        "stationNumber": "",
                        "workOrderNumber": "",
                        "partNumber": "",
                        "serialNumberArray": []
                    }
                }
            ],
            "outCustomErrorString": {
                "assertEquals": ""
            }
        }, 
        {
            "scenario": "Scenario 1: Activate workorder",
            "name": "Test Use Case 2",
            "method": "cfActivateWorkOrder",
            "args": [
                "01010010",
                "WO100"
            ],
            "outErrorCode": {
                "assertEquals": 0
            },
            "outErrorString": {
                "assertEquals": ""
            },
            "outArgSize": {
                "assertEquals": 1
            },
            "outArgs": [
                {
                    "assertMatches": {
                        "stationNumber": "",
                        "workOrderNumber": "",
                        "quantity": ""
                    }
                }
            ],
            "outCustomErrorString": {
                "assertEqualsx": ""
            }
        }
    ]
}

断言条件：

您可以使用以下断言条件构建验证条件：

扩展设置：

• IMS API System login：更新与iTAC MES API服务的连接。
• IMS API Get MES information：获取当前iTAC MES版本。
• IMS API Execute default function：执行默认函数。
• IMS API Execute scenario function：执行场景函数。
• IMS API Execute scenario function with test validation：执行带测试验证的场景函数（增强版）。
• IMS API Convert script file to Hex：将脚本文件转换为可读的十六进制代码。
• IMS API Generate config file：生成模板配置文件。
• IMS API Minify JS script：生成压缩的JS脚本。
• IMS API Open imsAPI log file：打开imsAPI日志文件。
• IMS API Parse imsAPI log file：解析imsAPI日志文件。

发布说明：

• 1.0.0 (2020年10月)：初始发布。
• 2.0.0 (2021年8月)：添加会话上下文ID的自动生成；在输出窗口中记录默认测试结果（作为IMS-Output）；添加将脚本文件转换为可读十六进制代码的功能；自动生成模板配置文件；添加场景测试和显示；添加脚本压缩功能；添加场景测试验证。
• 3.0.0 (2021年9月)：添加imsAPI日志文件的自动检查；更新使用测试文件夹的场景测试；添加测试文件夹和模板场景文件的自动生成；添加测试场景中全局变量的处理。
• 4.0.0 (2022年2月)：修复MDA上传的错误。

享受与iTAC MES的合作！