Biztalk 端口/编排文档 [关闭]答案

【问题标题】：Biztalk port/orchestration documentation [closed]Biztalk 端口/编排文档 [关闭]
【发布时间】：2010-11-10 09:06:39
【问题描述】：

我们有一个大型的 biztalk EAI 设置（+- 70 个编排，200 个发送端口，...）。几乎所有的编排/端口都没有直接绑定。每条路由都是通过过滤器配置的。

不幸的是，现在是时候记录非 biztalk 技术人员可以理解的集成场景了。

我想知道是否有任何工具/word-excel-visio-...模板来记录这种情况。不需要记录 orchestrain/map/code 技术细节，只需要记录消息流。 (rcvport/location(with maps) -> orchestration(filter) -> sendport(s)(with filter, maps)

谢谢；巴特

【问题讨论】：

我认为您尝试过 BizTalk Documenter？ (biztalkdocumenter.codeplex.com) - 我不确定它是否能满足你的要求。
是的，我有，但它以技术为重点。它没有描述消息流......
好问题 - 我自己还没有找到解决方案，需要为相同大小的 BTS 设置更新文档（发送端口少一点）。我在 Visio 中尝试过 UML-Sequence，但我不是真正的 UML 专业人士，所以我一直在处理所有建模问题。

标签： documentation biztalk

【解决方案1】：

您可以使用业务流程建模表示法 (BPMN)。我一直使用它来设计和记录编排。

访问http://www.bpmn.org/documents.htm

向下滚动到其他文档。是 Visio 的模具。

【讨论】：

【解决方案2】：

在我的公司，我们设计了一种基于UML 的消息流文档样式。

我们将BizTalk 应用程序表示为组件，并在这些组件上使用Ports 和Interfaces 来表示连接点。然后我们在这些接口之间使用Information flow 连接。

我们使用来自 Sparx Systems 的 Enterprise Architect 来创建这些工件和视图。此工具的好处是它使用基于存储库的方法，因此所有工件都可以重复用于多个视图。

这种方法的缺点是您需要自己创建所有视图。没有简单的方法可以从源代码或部署的 BizTalk 应用程序（我知道）生成此数据，因此您需要手动创建此文档。

【讨论】：

【解决方案3】：

我一直只是使用 Visio 来绘制自己的图表。在我看来，做这件事 10 年，你必须要有创造力，不要遵循任何一套标准。从一个客户到下一个客户，我并不总是以同样的方式做事。我正在努力改进，但我认为没有“一刀切”的答案。

与任何文档一样，首先，尝试做一些非常高级的事情。然后放大下图中的细节。

通常缺少的是如何描述进出端口的数据流。例如，如果您在接收端口中分批文件怎么办？我使用了标准的 Visio 流程图形状，例如管道的圆柱体、端口的框等……然后将它们与线连接起来。如果你只有一张地图，你可以把它放在线上。如果你有一堆，那么很难代表。我尝试将地图或管道放在箭头上。

我通常使用云符号向其他供应商或贸易伙伴发送数据。有时我使用 Visio 的服务器框，表示将数据发送到我们公司内的另一台服务器，甚至发送到另一家公司的 FTP 服务器或 Web 服务器。

我还显示“MessageBox”有一个端口。例如，接收端口是一个框，然后行到“消息框”，然后每个带有过滤器的发送都来自该消息框。（我最终通常为每个流绘制一个新的“MessageBox”，以保持它们分开。

对于编排，我使用了 SnagIt 来截屏文档，然后在图片之后在 Word 文档中使用标题和箭头以及文本进行注释。（问题是如果您有广泛或非常复杂的编排。）

不幸的是，我所做的大多数文档都不是自动化的，也没有连接到代码或绑定，因此它很快就会变得陈旧。我从来没有发现“BizTalkDocumenter”这么有用。

我有时会在 Word 中使用表格来显示开发人员工件及其相关性（地图、模式、管道...），并为每个工件提供口头描述/评论。

我同意上述 HSedidin 的观点，即 BPMN 可能值得一试，但即便如此，观众也必须学习。

这里有一个适用于 Vizio 的 BizTalk“模板”包：https://gallery.technet.microsoft.com/Collection-of-Visio-2013-0283d5f4，但我必须承认我还没有使用它。

【讨论】：