Biztalk端口/编排文档

Question

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

不幸的是，现在已经到了记录非biztalk技术人员可以理解的整合情景的时候了。

我想知道是否有任何工具/ word-excel-visio -...模板来记录这样的场景。 没有必要记录编排/映射/编码技术细节，只是消息流。 （rcvport /位置（与地图） - >配器（过滤器） - >发送端口（一个或多个）（带过滤器，地图）

THX; 巴特

Answer 1

你可以使用业务流程建模记法（BPMN）。我用它所有的时间来设计和文档的业务流程。

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

向下滚动到其他文件。该是Visio模具。

Answer 2

在我的公司，我们DESIG根据UML确定消息流的文档样式。

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

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

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

Answer 3

我一直只用Visio绘制自己的图。在我看来，这样做已经10年了，你必须有创意，不要遵循任何一套标准。而且从一个客户到另一个客户，我并不总是以同样的方式进行。我试图改善，但我不认为有一个“一刀切”的答案。

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

一般缺少的是如何描述端口之间的数据流。例如，如果您在接收端口中删除文件，该怎么办？我使用标准的Visio流程图形状，例如用于管道的圆柱体，用于端口的箱体等等，然后用线连接它们。如果你只有一张地图，你可以把它放在线上。如果你有一堆，那么很难代表。我尝试将地图或管道放在箭头上。

我通常使用Cloud Symbol将数据发送给其他供应商或贸易伙伴。 有时我使用Visio的服务器箱来指示将数据发送到我们公司内的另一台服务器，或者甚至发送到另一家公司的FTP服务器或Web服务器。

我还显示“MessageBox”有一个端口。例如，接收端口是一个盒子，然后连接到“MessageBox”，然后每个发送有一个过滤器的发送，从该MessageBox出来。 （我最终绘制新的“消息框”通常每个流，让他们分开。

对于业务流程，我用SnagIt的屏幕捕捉图像的文档，然后用Word文档中的标题和箭头和文本注释（问题是如果你有很多或非常复杂的业务流程）

不幸的是，我所做的大多数文档都不是自动的，并且没有连接到代码或绑定，所以它很快就会变成陈旧。我从来没有发现“BizTalkDocumenter”是有用的。

我有时使用Word中的表来显示开发人员工件以及它们如何相关（地图，模式，管道......），并包括一个口头descripti对每个评论。

我同意上面的HSedidin，BPMN可能值得尝试，但即使如此，观众也必须学习。

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