Biztalk端口/编排文档

时间:2010-11-10 09:06:39

标签: documentation biztalk

我们有一个大型的biztalk EAI设置(+ - 70个编排,200个发送端口,......)。几乎所有业务流程/端口都没有直接绑定。每条路线都是通过过滤器配置的。

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

我想知道是否有任何工具/ word-excel-visio -...模板来记录这种情况。 没有必要记录orchestrain / map / code技术细节,只记录消息流。 (rcvport / location(with maps) - >业务流程(过滤器) - > sendport(s)(带过滤器,地图)

THX; 巴特

3 个答案:

答案 0 :(得分:0)

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

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

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

答案 1 :(得分:0)

在我的公司,我们根据UML为消息流设计了一种文档样式。

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

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

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

答案 2 :(得分:0)

我总是只使用Visio绘制自己的图表。在我看来,这已经做了10年,你必须要有创意,不要遵循任何一套标准。从一个客户到另一个客户,我并不总是这样做。我试图改进,但我认为没有一个适合所有人的尺寸"回答。

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

一般缺少的是如何描述到/从端口到端口的数据流。例如,如果您在接收端口中分配文件该怎么办?我使用标准的Visio流程图形状,例如管道的圆柱体,端口的盒子等......然后用线条连接它们。如果您只有一张地图,则可以将其放在线上。如果你有很多,那么它很难代表。我尝试将地图或管道放在箭头上。

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

我还会显示" MessageBox"有一个港口。例如,接收端口是一个框,然后行到" MessageBox",然后每个Send上面都有一个过滤器,来自该MessageBox。 (我最终绘制了一个新的" MessageBox"通常用于每个流程,以使它们分开。

对于业务流程,我使用SnagIt来屏幕捕获文档,然后使用标题和箭头注释,并在图片后面的Word文档中添加文本。 (问题是如果你有广泛或非常复杂的业务流程。)

不幸的是,我所做的大部分文档都不是自动化的,也没有连接到代码或绑定,所以它很快就会变得陈旧。我从未找到过" BizTalkDocumenter"是有用的。

我有时会使用Word中的表来显示开发人员工件以及它们之间的关系(地图,模式,管道......),并为每个工件包含一个口头描述/评论。

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

有一个" Stencil"在这里为Vizio提供的BizTalk包:https://gallery.technet.microsoft.com/Collection-of-Visio-2013-0283d5f4,但我必须承认我还没有使用它。