什么是ICMExchange/WSExchange？

ICMExchange不是额外的应用程序，也不是InfoWorks ICM的附加模块。ICMExchange许可证仅激活默认隐藏的ICM的应用程序编程接口（API）。它就像是ICM的“后门”，一旦打开该门，由第三方编写的软件代码就可以指示ICM执行某些步骤、操作或者任务，而无需任何人需要坐在ICM软件本身之前。换句话说，ICM是在后台运行的；它是由第三方应用程序或者流程驱动的，从终端用户的角度来看是看不到任何东西的。

因此，提供类似于InfoWorks ICM界面内那样标准的软件演示是不可能的，ICMExchange在运行或者工作时是没有什么可看的。当通过API驱动时，ICM不再是桌面应用程序，它只是一个在更大的过程中的后台任务。

ICMExchange怎么工作&可以做什么？

随着API的开放，ICM通过以Ruby脚本的形式编写代码来控制。程序员需要高度熟悉Ruby以及面向对象编程的术语。ICMExchange通常会通过命令行或批处理文件来运行启动。Ruby脚本的文件名作为参数传递，然后脚本将运行并访问Scripting API的类和函数。在命令行中，指令看起来像这样：“C:\Program Files\Innovyze Workgroup Client 4.5\iexchange.exe”c:\myrubyscripts\icmnetwork.rb /ICM。

然后你就会看到：

图1：命令行启动ICMExchange

下一个阶段是使用批处理文件。这可以让ICMExchange按照计划自动运行（例如每天运行一次）。这项工作可能包括一个ruby脚本或多个脚本。如果以多个脚本运行，则每个脚本都将按顺序运行，即下一个脚本只有在上一个脚本完成时才会启动。

图2：批处理文件运行ICMExchange

Ruby脚本可以做些什么？

Ruby脚本的运行方法：

1. 在InfoWorks ICM和InfoNet的用户界面上直接运行。

2. 采用独立许可的ICMExchange产品，通过从命令行运行，不显示图形用户界面。

虽然从用户界面运行脚本的可用功能与ICMExchange产品中提供的功能之间存在很大程度的重叠，但某些功能仅可在一个或另一个中提供。

两者的区别大致如下：

1. 在用户界面中，脚本在GeoPlan打开时运行，显示网络，可能会加载访客网络。这些脚本可以处理网络中的数据，使用“打开数据导入和导出”中心执行导入和导出操作，提交和还原更改，并显示一些简单的用户界面功能。脚本不能操作除选择列表之外的树对象，并且可能无法打开和关闭数据库或设置和运行模拟。

2. 从ICMExchange应用程序中，用户具有操作数据库树对象，创建数据库以及设置和运行模拟的额外功能。但是，在ICM或InfoNet用户界面上这些是不可能做到的。

总而言之，ICMExchange可以将以下所有操作作为后台任务完成：

· 编辑，更新和查询数据库树对象

· 创建，复制和删除数据库树对象

· 创建网络场景

· 提交并验证网络

· 编辑网络对象

· 进行模拟

· 查询结果并提取数据

ICMExchange不允许访问InfoWorks ICM中可用的所有工具和菜单项，并且不会与ICM-TSDB交互或创建/导出图表和地图。

付费购买权限

要使用ICMExchange API，您需要购买许可证。这扇可以打开API的大门适用于InfoWorks ICM的任何特定实例。如果ICM的许可证没有可用的ICMExchange功能，它将不会接受任何命令。ICMExchange作为InfoWorks ICM Executive Suite的一部分提供。

ICMExchange相关的帮助/建议/支持

InfoWorks ICM和InfoNet的Ruby界面对于这两个应用程序来说都是通用的，但是许可证是独立。顾客如果需要帮助创建脚本以驱动InfoWorks/InfoNet，可以咨询HR Wallingford，了解相关合作方式。在幕后，开发团队里各种各样的成员可以提供关于创建成功脚本的关键的面向对象编程术语（例如“类”，“方法”等）的其他帮助和建议。

用户必须注意到，Ruby脚本语言的灵活性意味着该语言几乎是无限灵活的，InfoWorks ICM和InfoNet应用程序中的语言嵌入主要用于通过API来操纵数据。在InfoWorks或InfoNet中可能无法使用其他Ruby数据库，并且不可能为这些尝试提供支持。

示例Ruby脚本&运行模拟

下面的脚本是一个简单的例子，展示了如何从数据库中选择一个网络和各种随时间变化的文件，并为模拟定义参数。

 

图3：示例脚本

• Popular Articles

• 2020年华霖富水力网上公开课简介

  Ø  模型入门系列一：模型技术人员初阶课程系列（华霖富模型公开课系列一） n  1.1 模型建立基础课介绍篇：涉及管网、河道、二维积水等水力及水质等常见模型的建立等操作的基础培训 n  1.2 模型常见工具学习篇:建模过程中，各种常见的实用建模及分析辅助工具的实用的培训 Ø  模型技术进阶系列二：模型技术人员进阶课程（华霖富模型系列公开课系列二） n  2.1 模型工具及高级模块使用技巧篇：有机会了解如何利用各种工具或者高级模块来进行问题的分析，学会分析的思路和方法。 n  2.2 ...

• InfoWorks ICM 软件安装指南

  感谢您购买使用InfoWorks系列模型软件，请仔细阅读本文档，按需安装相关软件。 1        相关软件安装包 通常您会收到软件狗和一个U盘，软件狗为您提供使用InfoWorks系列软件的权限，U盘中存放当前最新的软件安装包和培训资料以及其它不必要文件如软件狗驱动。 ...

• HRW China网页端新人注册说明

  1、登录https://support.hrwallingford.com.cn/portal/zh/home，点击右上角的“注册”按钮进行注册，注意验证码要根据大小写录入： 2、注册后，您会在邮箱中收到邀请链接，点击接受邀请，进入如下界面，填入密码，点击注册： 3、最后一步，依次填入个人信息，注册成功。  

• HRW China网页端新建工单说明

  1、  已注册的用户，登陆https://support.hrwallingford.com.cn/portal/zh/home；并且登陆自己的账号，在“我的区域”内选择“添加工单”，如下界面： 2、  进行工单填报，依次按照如下方式填入工单内容，其中带星号为必填项： 3、选择提交，界面如下，我们将会在12个工作小时（即1.5个工作日）内予以答复，您可通过登录网页端或邮件等方式查看工单回复。

• 内存对InfoWorks ICM模拟重要吗？

  注：本文中所列举测试数据为ICM 3.0版本的结果，在每年两个版本的不断升级中，ICM对于计算机资源的利用，已有更好的提升。 InfoWorks ICM的模拟引擎是非常高效的，对于一维管网和渠道网络，仅需要非常少的内存资源。即使对于成千上万根管道和检查井的大模型，InfoWorks ...

• Recent Articles

• 【活动已结束】华霖富深圳线下研讨会（8月25日）

  华霖富深圳场研讨会即将于8月25日在深圳举办?。您可以和资深工程师面对面交流，近距离体验ICM最新功能，参与防洪排涝等热点话题和水力模型案例讨论。 时间：2023年8月25日 地点：深圳市罗湖区宝安北路3008号宝能环球汇3层句象书店 欢迎填写链接报名。 下一场研讨会在哪个城市举办，您希望听到哪些内容，由您决定！请在页面最后反馈您的建议，谢谢配合！ 联系人：王经理 15711323968

• 【活动已结束】CSO合流制溢流污染及黑臭水体评估课程（7/24-28）

  为了推进城市CSO污染和黑臭水体治理，华霖富借助76年历史的国内外项目实战和大量的ICM模型经验，在往年分别开设了两个课程。今年经过往期学员的充分调研，华霖富课程研发团队将CSO污染和黑臭水体评估课程合二为一，推出了升级版的《CSO合流制溢流污染及黑臭水体评估》课程，浓缩精华学习内容，旨在用最短的时间让学员全面掌握利用模型评估管网及河道污染物的方法。本课程将于7月24日-28日在上海开设第一期课程，欢迎有需求的学员报名。 培训时间：2023年7月24日-28日 培训地点：上海·华霖富总部 ...

• 【即将截止报名！】Infoworks ICM 城市防洪排涝规划模型课程（7/11-14）

  为了进一步加强城市排水防涝体系建设，推动城市内涝治理，华霖富依靠76年历史的国内外项目实战和大量的ICM模型经验，聚合专家团队智慧结晶研发出《Infoworks ICM 城市防洪排涝规划模型》课程，一经推出收获学员和模型业主单位无数好评。在今年4月举办的第一期课程上，华霖富帮助模型初级学员用四天的时间，快速学习到模型项目从构建到分析的典型流程，并且掌握了高阶模型技能。应广大用户要求，将于7月11日-14日在上海开设第二期课程，欢迎有需求的学员报名，一起认识更多志同道合的模型小伙伴。 ...

• 2023年度公开课课程日历与报名

  我们提供包括 城市防洪排涝模型、城市污水诊断模型、一维-二维河道排涝模型、合流制溢流污染及黑臭水体、水工构筑物的调度策略 等方面的专业培训课程，不论您的水平处于何种阶段，都可以找到合适的课程，实现自我提升，达成项目目标。 点击查看课程大纲和报名信息

• 华霖富HRW | 12月公开课延期公告

  致各位亲爱的华霖富用户： 因当前国内疫情形势反复多变，为了配合做好疫情防控工作，保障全体学员以及公司员工的健康，我们非常遗憾地决定：原定12月20日-23日举办的第二期城市防洪排涝规划模型公开课，将顺延合并至第三期（2023年3月21-24日）举办。对于已缴费的单位，我们会主动与您联系，沟通后续事宜安排。为此给您带来的不便，我们深表歉意，敬请谅解。 由于第二期和第三期公开课合并举办，名额有限，我们非常欢迎您提前报名预留位置。如您有任何疑问，请联系我们：蔡老师，139 1840 0920 ...