Documentation Biztalk端口/业务流程文档

Documentation Biztalk端口/业务流程文档,documentation,biztalk,Documentation,Biztalk,我们有一个大型biztalk EAI设置(+-70个业务流程,200个发送端口,…)。几乎没有任何业务流程/端口具有直接绑定。每个路由都是通过过滤器配置的 不幸的是,现在是记录非biztalk技术人员可以理解的集成场景的时候了 我想知道是否有任何工具/word excel visio-。。。用于记录此类场景的模板。 无需记录管弦乐队/地图/代码技术细节,只需记录信息流即可。 (RCV端口/位置(带映射)->业务流程(筛选器)->发送端口(带筛选器,映射) Thx; Bart您可以使用业务流程建模

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

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

我想知道是否有任何工具/word excel visio-。。。用于记录此类场景的模板。 无需记录管弦乐队/地图/代码技术细节,只需记录信息流即可。 (RCV端口/位置(带映射)->业务流程(筛选器)->发送端口(带筛选器,映射)

Thx;
Bart

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

拜访


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

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

我们将
BizTalk
应用程序表示为组件,并使用这些组件上的
端口
接口
表示连接点。然后使用这些接口之间的
信息流
连接

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


这种方法的缺点是,您需要自己创建所有视图。从源代码或已部署的BizTalk应用程序(我不知道)生成此数据并不容易,所以您需要手工创建此文档。

我一直使用Visio绘制自己的图表。在我看来,在这10年中,您必须具有创造性,并且不遵循任何一个既定标准。从一个客户到下一个客户,我不总是以同样的方式进行。我正在努力改进,但我认为没有什么好的方法“一刀切”的回答

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

通常缺少的是如何描述从端口到端口的数据流。例如,如果您在接收端口中对文件进行解包,该怎么办?我使用标准Visio流程图形状,例如管道的圆柱体、端口的长方体等。然后将它们与线条连接。如果您只有一个贴图,则可以将其放在线条上。如果您有一组我试着把地图或管道放在箭头上

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

我还显示了“MessageBox”有一个端口。例如,接收端口是一个框,然后行到“MessageBox”,然后每个带有过滤器的发送都从该MessageBox中出来。(我最后通常为每个流绘制一个新的“MessageBox”,以使它们分开

对于编排,我使用SnagIt截屏文档,然后用标题和箭头进行注释,并在图片后面的Word文档中添加文本(问题是如果您有广泛或非常复杂的编排)

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

我有时在Word中使用表格来显示开发人员工件以及它们之间的关系(映射、模式、管道…),并为每个工件提供口头描述/注释

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


这里有一个可供Vizio使用的BizTalk“模具”包:,但我必须承认我还没有使用过它。

我想您已经试用过BizTalk Documenter?()-我不确定它是否能完全满足您的要求。是的,我有,但它是以技术为重点的。它没有描述消息流…好问题-我自己还没有找到解决方案,需要为相同大小的BTS设置(更少的发送端口)更新文档.我在Visio中尝试了UML序列,但我不是一个真正的UML专业人士,所以我一直在偏离所有建模的方向。