[首次使用InterSystems IRIS] 互操作性: 一个Production是什么?
这篇文章是前面文章[首次使用InterSystems IRIS] 互操作性: 它是如何工作的?的延续。
在上一篇文章中,解释了互操作性菜单如何用于系统集成。
在本文中,我想解释如何用互操作菜单开发系统集成。
首先,您想创建什么样的业务流程? 请一边思考,一边开始以下内容。
- Production(生产)
- 消息
- 组件
- 业务服务
- 业务流程
- 业务运营
Production被定义和用作指定系统集成所需的组件及存储组件的配置,这些配置通过管理门户界面使用(内部被存储为生产的类定义)。
例如,假设您正在创建一个业务服务,该服务定期处理放置在指定目录中的文件。 在这种情况下,有必要准确配置要监测的目录和要处理的文件。 一个生产就是预先准备好用于存储这些配置。
这些配置取决于发送和接收数据的组件所使用的适配器。
适配器是用于简化与外部系统连接的类,有些是协议特定的,如 Mail/File/SOAP/FTP/HTTP/SQL/TCP,有些是标准特定的,如 HL7。
有关适配器的更多信息,请参阅文档(protocol-specific adapters and adapters related to EDI documentation)
由于我们将必要的组件定义为Production,“启动Production”将启动系统集成,而“停止Production”将停止系统集成。
完成Production需要的开发是系统集成所需组件的创建,具体包括以下内容:
• 信息
• 组件(业务服务、业务流程、业务运营)
• 数据转换等。
上面的内容会在后面的文章中慢慢讲解。
首先,让我们使用Production示例来启动Production,并在检查配置的同时通过查询数据来检查消息处理的流程。
模版可以从这里下载https://github.com/Intersystems-jp/selflearning-interoperability。
如使用容器,请使用 git 克隆 下载示例代码,导航到克隆的目录,然后运行 docker-compose up -d 就这么简单!
请在此处参考流程here (创建容器需要一些时间)。
如果不使用容器,下载示例后新建一个命名空间,并将src文件夹下的所有类定义文件(extension .cls)导入创建的命名空间。
更多关于创建命名空间的过程,请参考本文this article.07:03之后的视频。
有关示例代码的更多详细信息,请参阅README。
准备就绪后,访问管理门户(更改 Web 服务器的端口号以匹配您的环境)。
http://localhost:52773/csp/sys/UtilHome.csp
进入管理门户 > 互操作性 > 配置 > 生产。
如果您使用的是容器以外的方法,请连接到您导入源代码的命名空间,访问[[配置] > [生产],,单击[打开] 按钮,选择[开始] > [生产],,然后单击 [开始] 按钮。
※ 如果您使用容器以外的东西,则需要进行一些初始设置。 请在尝试以下内容之前设置以下描述的内容contents described below。
生产页面将为每一个 “服务”、“流程”和“操作”组件显示为[● 组件名称] ]。
单击组件名称可更改屏幕右侧“设置”选项卡的内容。
例如点击Start.GetKionOperation(单击),显示如下。
组件有[HTTP Server] 和 [URL] 配置来连接Web API.
配置底部有一个 [appid] 字段,您可以在其中输入您获得的 API 密钥。
[appid] 附近有一个 [lang] 字段,设置为“ja”(“ja”=日语)。 [lang] 设置来自 OpenWeather 的响应语言。 如用英语,设置为“en”。
完成设置这些配置后,单击“应用”按钮。
如果您使用的是容器,则该配置完成。 欲了解更多信息,请点击here。
如果您正在尝试容器以外的其他配置
请提前做好以下两项设置:
1) 配置SSL客户端。
由于要连接的 Web API 将使用 HTTPS 进行通信,因此请提前在 IRIS 端配置 SSL 客户端。
为了匹配生产模版的设置,我们将使用名称 [openweather]。 生产中的设置如下:
单击管理门户 > [系统管理] > [安全] > [SSL/TLS 配置] > [新建配置] 按钮,在“配置名称”字段中输入“openweather”,然后单击“保存”按钮 结束。
2) 为 REST 创建一个基本 URL
在示例制作中,为使能够通过 REST 输入信息,我们已经进行了配置,基本 的URL for REST配置需要在 IRIS 端。
在生产示例中,我们将配置 /启动设置为基本 的URL。 由于 Start.REST 类存在于导入示例的命名空间中,因此我们将指定该类作为调度类,并添加 %All 作为应用程序角色,以在访问时省去身份验证。
管理门户 > 系统管理 > 安全 > 应用程序 > Web 应用程序路径 > 单击“创建新的 Web 应用程序”按钮。
在名称字段中,指定 /start; 在命名空间字段中,指定从中导入样本的命名空间; 在 Dispatch Class 字段中,指定 Start.REST; 在允许的身份验证方法字段中,选择“未Unauthenticated”,然后保存文件。
保存后,将 %All 角色添加到“application role ”选项卡上的应用程序角色中。
尝试发送数据
全部配置好后,尝试用业务服务通过 REST 发送信息并让它运行。
http://localhost:52773/start/weather/Takoyaki/Osaka
上面的例子是假设某人在大阪购买了“章鱼烧”的 URL。
运行后画面如下。
检查已发送到生产的消息。
在管理门户 > 互操作性 > 配置 > 生产中,单击以下服务:
选择屏幕右侧的“消息”选项卡,然后单击标题字段列下方的任意数字。 如果您没有看到它,请重新加载您的浏览器。
使用 Visual Trace 页面,您可以看到组件之间发送和接收的消息信息。 您可以看到天气信息是从 Web API 检索并在浅蓝色框架中发送回来的。
通过这种方式,您可以使用跟踪来查看当时正在发送和接收哪些数据以及以什么顺序。
在整篇文章中,我们已经确认了Production已经定义了需要的组件和参考示例代码设置的系统集成
我们还确认,我们可以使用 Visual Trace 页面按时间顺序参考通过 Production 的消息。
在下一篇文章中,我们将讨论创建此跟踪中显示的“消息”背后的概念以及如何实际定义它。