SAP CPI 中点击 Deploy 之后：部署监视、包文档、系统全景和导出到 Excel 的 Value Mapping
了解 iFlow 何时 Started 或为何失败，选择 Cloud 或 Edge 运行时，运行新的设计检查，为整个包生成带系统全景的文档，把 Value Mapping 导出到 Excel，并关闭任何工具。
在 SAP Cloud Integration（SAP CPI）中点击 Deploy，就开始了等待：切换到 Monitor，找到 iFlow，不停刷新直到显示 Started 或 Error，然后再弄清楚错误是什么意思。而当一个接口完成后，总会有人来要文档、系统全景图，以及做成电子表格的 Value Mapping。
现在，Kitegra 在 SAP Integration Suite 设计器旁也承担起这部分工作：带测试调用的部署监视、面向带有 Edge Integration Cell 的 tenant 的运行时选择、新的设计检查、包含系统全景图和文档完备度的包文档、Excel 格式的 Value Mapping 工作表，以及用通俗的话解释 Groovy 脚本。每个工具都可以单独关闭。本文逐一介绍。
部署监视：不离开 iFlow 就知道是 Started 还是错误
像往常一样在设计器中点击 Deploy，并在 SAP 的对话框中确认。随后会出现一个部署通知，显示「正在部署…」和已用时间，您可以继续工作。Kitegra 会在三秒后向 SAP 查询状态，之后间隔逐渐拉长，最长每 20 秒一次。SAP 给出答复后，通知会变为：
- Started，并显示已部署的版本。如果 iFlow 有 HTTP 端点，发送测试调用会打开已准备好请求的 HTTP Runner，显示最新消息会重新打开消息面板。
- 错误，显示 SAP 的错误文本；如果是已知情况，还会说明通常意味着什么：另一个已部署的 iFlow 已在使用该发送方地址、某个脚本无法编译、某个外部化参数没有值，或者 SAP 无法构建该 iFlow。在 SAP 中打开已部署内容可查看详情。
- 仍在部署：十分钟后仍未完成时显示，并附上指向 SAP 中已部署内容的链接。
如果您取消了 SAP 的 Deploy 对话框，就不会进行任何监视。监视只读取部署状态；部署本身由 SAP 完成，由您自己的点击触发。之后如何跟踪一条消息在 iFlow 中的流转，请参见逐步跟踪消息；调用本身请参见用服务密钥测试 HTTPS iFlow。
运行时选择：Cloud 还是 Edge
带有 Edge Integration Cell 的 tenant 会在多个运行时上运行 iFlow。只有在这样的 tenant 上，Kitegra 工具框中才会显示运行时：Cloud（或 Edge 运行时的名称）。在这里选择运行时后，Message Monitor 会在该运行时上读取此 iFlow 的消息并设置其日志级别。选择器还会显示每个运行时上是否已部署以及部署的版本。只有一个运行时的 tenant 永远不会看到它。
iFlow Inspector 中的新设计检查
iFlow 审查清单新增了五项检查，并增加了新的「文档」类别：
| 检查 | 为什么重要 |
|---|---|
| 没有地址的接收方（错误） | iFlow 可以部署，但运行时对该接收方的每次调用都会失败。 |
| 使用默认地址的 HTTPS 发送方（警告） | 空地址、/ 或 /test 这样的占位地址对调用方毫无意义，而且两个 iFlow 可能因此冲突。 |
| 要求 CSRF 令牌的 HTTPS 发送方（信息） | 每个调用方都必须先获取 X-CSRF-Token，否则其 POST 会得到 403。 |
| 直接写在 iFlow 中的接收方地址（信息） | 在 DEV、QA 和 PROD 之间迁移就意味着要修改 iFlow；Externalize Parameters 一步即可解决。 |
| 保留默认名称的参与方（信息，文档） | 「Sender」和「Receiver」也会显示在监控中，没人能看出指的是哪个系统。 |
和其他检查一样，它们计入评分，也可以逐项关闭。查看是免费的；导出报告属于 Pro。Externalize Parameters 和其他新的 Helper 工具请参见 Externalize Parameters、步骤复制和 Hub 导入。
整个包的文档
在 Kitegra 菜单中，为此 iFlow 生成文档旁边现在多了包文档。它会逐个读取当前 iFlow 所在包中的每个 iFlow（「正在读取第 2 个 iFlow，共 5 个…」），您可以随时停止，并打开已读取的部分。无法读取的 iFlow 会被列出。文档在新标签页中打开，可以是 Word、PDF 或 HTML，也可以填入您自己的 Word 模板，与单个 iFlow 的技术设计文档相同。文档包含包的版本、供应商、标签和 iFlow 数量，然后是每个 iFlow，以及两个新部分：
- 系统全景：一张图，左边是发送方，中间是包中的 iFlow，右边是接收方。同名的参与方合并为一个框，每条连线都标出其适配器类型。
- 文档完备度：逐项检查读者需要的内容：包的描述和标签、每个 iFlow 的描述、已从 Sender 和 Receiver 改名的参与方，以及已外部化的接收方地址。它会显示通过了多少项检查、缺少什么，便于您在交付前补齐。
导出到 Excel 的 Value Mapping
在 iFlow Docs 页面的 Value Mapping 下，上传 Value Mapping 的 ZIP（从 SAP 中其所在的包下载）或其 value_mapping.xml。Kitegra 会列出这些值，并生成一个 Excel 工作簿，每个代理和标识符对一个工作表：源代理、标识符和值，然后是目标代理、标识符和值。文件在您的浏览器中读取；不会从 SAP 读取任何内容，也不会发送到任何地方。对于映射，Message Mapping 工作表的用法相同。
用通俗的话解释脚本
Kitegra 菜单中的解释脚本会列出 iFlow 中的每个 Groovy 脚本步骤。对每个脚本，它会显示作者的摘要注释、定义的函数、读取的内容（消息体、头、交换属性、附件）、设置和更改的内容、主要逻辑（解析或构建 XML 或 JSON、循环、判断、HTTP 调用、日期）、使用的 SAP API（如 Security Material、Value Mapping 或 Partner Directory），以及注意事项和风险。点击步骤名称即可在图表上选中它。解释是在您的浏览器中根据脚本文本得出的；脚本从不发送到任何地方。
关闭不用的工具
选项页面现在有一个工具部分，每个工具都有一个开关，并按模块归类：从 Helper 中的 XPath 检查、整理、Security Material、Externalize、步骤复制和 Hub 导入，到消息、运行时选择、日志查看器和部署监视、iFlow 信息、Inspector 和搜索、文档和脚本说明，再到 Toolbox 中的笔记、代码片段、对比、转换、生成和 HTTP Runner。关闭的工具会立即从设计器和弹出窗口中消失；您的数据会保留，全部开启可恢复一切。要关闭整个模块，请使用同一页面上的「模块」；参见选项页面。
部署监视、运行时选择、脚本说明和查看设计检查都是免费的。包文档、系统全景和 Value Mapping 工作表属于 iFlow Docs，在 Free 和 Starter 中也可使用几次。Kitegra 上线期间，所有工具向所有已登录用户开放。比较各套餐。
在下一个 iFlow 中试试
了解 Kitegra 为 SAP Integration Suite 设计器增加了哪些功能，或者看看编写 iFlow 的新工具。
常见问题
Kitegra 会部署我的 iFlow 吗？
不会。由您在 SAP 中点击 Deploy；部署监视只读取部署状态，并告诉您是已 Started 还是失败。
如何为整个 SAP CPI 包生成文档？
打开包中的任意一个 iFlow，在 Kitegra 菜单中选择「包文档」。它会读取每个 iFlow，并打开一份包含系统全景图和文档完备度的文档，格式为 Word、PDF 或 HTML。
可以把 Value Mapping 导出到 Excel 吗？
可以。从 SAP 中其所在的包下载 Value Mapping 的 ZIP，然后在 iFlow Docs 页面上传。每个代理和标识符对会生成一个工作表；文件从不离开您的浏览器。
为什么我看不到运行时选择？
它只出现在有多个运行时的 tenant 上，例如 Cloud 加 Edge Integration Cell。
关闭某个工具会删除我的数据吗？
不会。该工具会从设计器和弹出窗口中消失，数据仍会保留。可以在选项页面的「工具」部分重新开启。