SAP 官方帮助文档,help.sap.com 是一座宝库。
笔者之前的文章,介绍了如何通过 DeepSeek 和 ChatGPT 等 AI 工具,将 SAP 官网帮助文档的纯文字版本,提炼并转换成思维导图和 PPT.
如此图文结合的方式,更容易理解。
前一篇文章有朋友留言,询问能否支持转换成流程图。
这当然没有问题,思路也如出一辙。
以使用 ABAP Development Tool 登录 SAP Business Technology Platform ABAP 编程环境的帮助文档为例。原始文档链接:
https://help.sap.com/docs/btp/sap-business-technology-platform/sap-business-technology-platform
本文会演示如何把这个文档的内容,转换成 Mermaid 里的流程图。
Mermaid 是一种基于文本的图表生成工具,采用特定的语法,将代码转化为图表,帮助开发人员将抽象的逻辑关系和系统结构以视觉形式呈现。
我们先重温一下在 ABAP Development Tool 里登录 SAP BTP ABAP 编程环境的具体操作。
笔者之前的文章曾经介绍过,开发人员有两种方式来指定,到底要登录 SAP BTP 上的哪一个 ABAP 环境。
一种方法是直接指定要登录的 ABAP Service Instance URL(下图图例1),另一种方法是导入一个 JSON 格式的 Service Key 文件(下图图例2)。
该 Service Key 文件的获取方式:浏览器登录 SAP BTP,找到 ABAP 环境的 Service Instance,点击 Download 即可把 Service Key 导出到本地。
然后将其内容拷贝出来,粘贴到下图的对话框即可:
所以基于这个文档生成的流程图,在指定登录的 ABAP 环境这个步骤,会产生一个分支。用 Mermaid 流程图的专业术语来讲,会产生一个 decision node 即决策节点。
同样,指定 ABAP 环境完毕,进行实际登录,需要提供用户 credentials 时,也有两种方式,如下图所示:
因此最后生成的 Mermaid 流程图,我们会期望看到两个决策节点。
下面开始进入正式的生成步骤。
和之前将 SAP 文档转换成思维导图和 PPT 思路类似,无非也就两个步骤。
第一步,使用 DeepSeek 或者 ChatGPT 将 SAP 帮助文档转换成 Mermaid 格式。
第二步,使用 Mermaid 渲染工具呈现内容即可。
我们可以把整个网页的内容手动复制下来发给 DeepSeek,也可以利用 SAP 官网的标准功能,把网页导出成 PDF.
笔者选择了后者。
选择 Download PDF,然后 Create Custom PDF,就可以把当前网页导出成 PDF 文件。
然后向 DeepSeek 发出指令:
请你仔细阅读这个 PDF 的内容,充分理解各个步骤之间的关系,用 Mermaid 绘制一个流程图,确保流程图内各步骤前后依赖关系准确。
下面是 DeepSeek 的思考过程。
从第一页开始,主要是关于 SAP BTP 的说明和警告,不涉及具体步骤,可以忽略。
通过 SAP 官网自带的导出功能生成的 PDF,第一页都具有如下图所示的固定格式,标注了 PDF 所含内容的原始链接,以及不能用于生产用途的声明。
DeepSeek 成功地将这一页和流程图无关的内容过滤了出去,给它点个赞。
第二页开始详细描述连接 ABAP 系统的步骤,包括前提条件和具体操作流程。第三页继续详细步骤。
接下来,我需要将文本中的步骤转化为流程图的节点,并确定它们的顺序和分支。例如,前提条件中的角色分配、安装 ADT 等是流程的起点。然后,在 Eclipse 中创建新项目,选择连接方式(Cloud Foundry 环境或 JSON 服务密钥),每个选项下有各自的子步骤。例如,选择 Cloud Foundry 环境需要输入地区、邮箱和密码,而 JSON 方式需要导入服务密钥。之后是登录选项,包括使用集成浏览器或复制 URL 到其他浏览器。最后是项目命名、添加包和完成项目创建。
需要特别注意步骤之间的条件分支,比如两种不同的服务实例连接方式,以及不同的登录方式。此外,验证结果的步骤也需要包含在流程图中。可能还需要处理可选步骤,比如更改项目名称或添加工作集。
在绘制 Mermaid 流程图时,使用适当的符号表示开始、结束、操作步骤、条件分支(菱形框)以及并行路径。确保所有步骤按照正确的顺序排列,并且分支逻辑清晰。可能需要多次检查文本,确保没有遗漏任何步骤或依赖关系。
最后,生成流程图代码后,需要验证其准确性,确保每个步骤的前后顺序正确,条件分支正确反映文档中的选项。如果有不确定的地方,可能需要重新查阅原始文本确认细节。
从 DeepSeek 的思考过程能看出,它成功将 PDF 文档第一页仅包含 SAP 声明的无关内容进行排除,没有收到干扰,给它点个赞。
将 DeepSeek 生成的 Mermaid 源代码保存下来。
然后登录 Mermaid 在线编辑器 https://mermaid.live/edit,将上图的 Mermaid 源代码粘贴进去,即可得到渲染出的流程图。
可以看到,流程图中确实包含了两个菱形的决策节点,和我们的预期一致。图中第三个决策节点,即创建 ABAP 项目时是选用默认名称还是使用自定义名称。
原始的 SAP 帮助文档,有密密麻麻的三页英文内容,绘制成流程图后,用 ABAP Development Tool 连接 SAP BTP ABAP 编程环境的要点,以图形的方式呈现出来,关键步骤一目了然。
领取专属 10元无门槛券
私享最新 技术干货