访问 IRIS 终端：Visual Studio Code 用户综合指南

介绍

由于InterSystems最近宣布从2023.2版本开始停止对InterSystems Studio的支持，转而独家开发Visual Studio Code（VSC）IDE的扩展，相信后者比Studio提供了更优越的体验，我们很多开发者都已切换或开始使用 VSC。很多人可能想知道如何打开终端进行操作，因为VSC没有像Studio那样的输出面板，也没有集成的功能来打开IRIS终端，除非下载InterSystems开发的插件。

概括

• 介绍
• 解决方案
  • 对于至少具有 IRIS 2020.1 或 IRIS IRIS 2021.1.2 的用户– 使用 Web 终端
  • 对于至少具有 IRIS 2023.2 的用户 – 使用 WebSocket 终端
  • 对于使用基于 Docker 的 IRIS 的用户
  • 对于在本地计算机上使用 2023.2 之前的 IRIS 版本的用户
  • 对于使用 SSH 连接在基于远程服务器的 IRIS 上进行编码的用户

解决方案

在 VSC 中打开终端的方法有多种，具体取决于您使用的具体配置，我在这里总结了适合任何情况的最佳解决方案：

对于至少具有 IRIS 2020.1.1 或 IRIS 2021.1.2 的用户 – 使用 Web 终端

至少拥有 IRIS 2020.1.1 或 IRIS 2021.1.2 且被允许安装外部扩展的用户（某些人可能由于公司有关第三方应用程序的政策而不允许安装），可能会发现 VSC 的 Web 终端扩展很有用。谁不知道， Web 终端是一个基于 Web 的 InterSystems 产品终端，使用 ObjectScript（例如 IRIS、Caché、Ensemble、HealthShare、TrakCare）构建，允许在浏览器中使用更高级版本的终端（ 这里是项目页面）。通过此 VSC 扩展，只需单击一下即可直接从 VSC 启动基于 Web 的终端。

要打开 Web 终端，请单击： InterSystems Tools > 选择一个名称空间 > 单击以下图标之一 ( , ）在 VSC 终端面板或浏览器上打开 Web 终端（按 Alt 更改默认图标）：

对于至少具有 IRIS 2023.2 的用户 – 使用 WebSocket 终端

至少拥有 IRIS 2023.2 的用户可以利用最新版本的 VSC 扩展中包含的新“ WebSocket 终端”功能，并且不需要其他解决方法。

要打开 WebSocket 终端，请单击： InterSystems Tools > 选择一个名称空间 > 单击 Web 终端旁边的图标。

对于使用基于 Docker 的 IRIS 的用户

在 Docker 中使用 IRIS 环境并使用 VSC 的人员可以直接在 Docker 环境中启动终端会话。

单击状态栏中的 Docker 语音，然后选择Open Terminal in Docker 。

我要感谢@Evgeny.Shvarov   有关这一点的图片和解释。

对于在本地计算机上使用 2023.2 之前的 IRIS 版本的用户

对于使用在本地计算机上运行的 IRIS 版本的用户，可以在 VSC 中设置专用的 IRIS 终端：

1. 1. 打开设置.json  文件。您可以通过多种方式找到它，例如单击“视图”> “命令面板”> 输入：“设置”>打开用户设置 (JSON)
   2. 在“ terminal.integrated.profiles.windows ”下添加以下代码：

 "terminal.integrated.profiles.windows" :{ "IRIS Terminal" : { "path" : [ "C:\\InterSystems\\IRISHealth\\bin\\irissession.exe"    ], "args" : [ "IRISHEALTH" ], "icon" : "terminal-cmd" } }

注意：插入irissession.exe的正确路径。

C。要从 VSC 打开终端，请导航至：终端>新终端>启动配置文件... > IRIS 终端。

d.终端菜单中现在应该可以使用“IRIS Terminal”语音：

对于使用 SSH 连接在基于远程服务器的 IRIS 上进行编码的用户

对于使用基于可通过 SSH 连接（例如使用PuTTY ）访问的远程服务器（例如公司服务器）的 IRIS 版本的人员来说，可以使用远程 - SSH VSC扩展将 VSC 直接连接到服务器。为此：

1. 1. 安装远程 - SSH：编辑配置文件  VSC 扩展；
   2. 单击“远程资源管理器”图标 在侧边栏中；
   3. 选择“打开 SSH 配置文件”

并打开配置文件，路径为： C:\Users\<用户名>\.ssh\config

1. 4. 在配置文件中插入以下代码：

 Host my-putty-connection    HostName < IP address or server name >    User < username >    IdentityFile < private key path on your local machine >    Port < port >

IP 地址和端口对应于 PuTTY 中指定的主机名和端口，用户名是用于访问远程服务器的用户凭据，IdentityFile 是 PuTTY 私钥的文件路径。

注意：VSC 无法读取 PuTTY (.ppk) 生成的私钥的原始格式。要通过 PuTTY 在 VSC 和远程服务器之间建立连接，您必须复制原始私钥并将新版本转换为 .pem 格式。为了进行转换：

1. 启动 PuTTYgen 应用程序
2. 在“文件”菜单下，单击“加载私钥”
3. 选择 .ppk 格式的私钥，然后选择“打开”
4. 在“转换”菜单下，单击“导出 OpenSSH 密钥”（强制使用新文件格式）。
5. 设置扩展名为 .pem 的新名称，然后单击“保存”按钮。
6. 将此新 .pem 文件的路径链接到 VSC 中的IdentifyFile 参数
   1. 保存文件。几秒钟后，新连接应出现在“远程资源管理器”面板中；
   2. 单击“在新窗口中连接... ”以在新的 VSC 窗口中打开 SSH 连接：
7. 选择远程计算机的操作系统（仅在第一次访问时）
8. 在新窗口中，导航至：终端>新终端（或使用快捷键 Ctrl + ò 或 Ctrl + Shift + ò）。
9. 您现在已连接到远程计算机，并且可以在 VSC 中使用其 IRIS 终端。

注意：此操作仅在您之前通过 PuTTY 启动远程连接时有效，并且在 PuTTY 关闭或未连接到远程服务器时不起作用。此操作不会启动 PuTTY，它仅允许 VSC 连接到 PuTTY 建立的隧道。

要通过 VSC 启动 PuTTY 连接，您可以使用批处理文件（在 Windows 上）。提供的connect_remote.bat文件使用 PuTTY 附带的 Plink 命令来启动会话：

 @echo off set SESSION="<your saved session name>" plink -load %SESSION%

要启动会话，只需在 VSC 终端中键入.\connect_remote.bat以打开远程连接并插入您的凭据。

注意：后一种方法使您可以访问支持所有 VSC 快捷方式的终端版本！欢迎回来 Ctrl+V，再见 Shift+Insert 🎉