在您进入integrationadvisor世界的这个阶段，我希望您已经开始理解消息实现指南（MIGs）的重要性。在这篇博文中，我提供了详细的说明，说明如何通过自定义文档丰富您的消息实现指南，以确保生成文档时，它是完全全面的，并且专门针对您的客户需求进行定制。

如果您还不熟悉MIGs，并且首先希望了解有关MIGs的更多信息什么是MIG以及如何创建MIG，我建议您阅读integrationadvisor的博客文章：使用MIG编辑器创建一个定制的界面。如果您对Integration Advisor完全陌生，并且希望全面了解该产品，我建议您从标题为Integration content Advisor:组件概述和进一步阅读的博客文章开始。从这篇博客文章中，您将能够访问许多其他博客，并按逻辑顺序阅读它们。

Integration Advisor引入的一个主要范式转变是，不再将映射练习作为技术开发人员的领域。Integration Advisor的目标是让您这个业务领域的专家能够在技术人员很少或根本没有帮助的情况下进行端到端的设计和实现。

使用Integration Advisor，我们还打算摆脱使用市场上传统的电子表格或文档编辑器以手动方式持续维护接口文档的"苦差事"。

Integration Advisor被设计为"一站式服务"，您可以在这里设计接口，全面地记录它们，然后同时生成映射…

具有在工具本身中记录接口的内置功能，确保文档始终与接口定义紧密相连，并且可以在任何时间点更改和重新生成。接口文档存储在某个共享驱动器上的典型情况（最终会丢失，因为没有人记得它们在哪里！）被淘汰了。如果您的Live Services团队需要访问文档，他们只需登录到Integration Advisor并立即访问文档。

标准文档的可用性

正如在描述Integration Advisor标准库的博客文章中所全面讨论的，mig基于从类型系统导入的消息定义。这些消息定义已经用这些类型系统的作者提供的标准信息进行了充分的记录。因此，在许多情况下，Integration Advisor已经为您满足了大多数文档要求。

但是，在某些情况下，您可能需要调整或增强文档以满足您的特定需求。这篇博客文章的下一部分将解释在哪里以及如何在消息实现指南中添加或更改文档。

如何在MIG中添加自定义文档

可以在消息实现指南的多个位置添加或增强文档。这些是：

MIG概述中的摘要部分MIG概述中的定义部分MIG级别的注释字段或段的名称单个领域或部门级别的详细文档单个领域或分系统层面的注释

以下将讨论每种类型，并说明这些文件类型在生成文件中的位置。

MIG概述中的文件

MIG概述中可规定定义目的的摘要。这里的建议是提供有关MIG的关键行政信息，包括其定义的版本、发布日期等。如果MIG计划提供给外部贸易伙伴，也可以提供联系信息。

MIG概述中还可以输入更详细和全面的MIG定义。如果作为类型系统的一部分提供标准定义，则该定义将自动复制到MIG中。您可以选择替换或增强定义，以使其适应特定的需求。MIG定义可用于提供有关MIG所属业务流程的相关信息，以及使用MIG的程序和原则。支持文本的一些基本格式，以提高可读性。

在生成的文档中，懒懒淘客，MIG摘要和定义位于PDF或RTF文件的概述页上。

MIG级别的注释

在MIG编辑器的注释选项卡上，可以添加一个或多个注释。这些说明的目的是支持添加有关MIG的更详细的技术或业务特定信息。可以添加以下类型的注释：

用法约束条件评论示例

要添加新注释，请单击上面屏幕截图中所示的添加按钮。在出现的对话框中，选择要添加的注释类型：

输入注释编号和注释文本。然后您可以按应用按钮：

此过程可以根据需要重复多次。如下图所示，为了提高可读性，对不同的注释类型进行了分组：

在生成的文档中，注释同样位于PDF或RTF文件的概述页上。

详细字段或段级别的名称和文档

许多更老和更"传统"的消息类型定义基于提供的字段名称，这些字段名称完全是技术性的，不可供人阅读。这可能是由于过去对字段名长度的限制（例如，数据库允许表列名的长度非常有限）。

使用这些技术名称意味着典型的消息映射工具只能由技术开发人员使用。integrationadvisor（IA）通过增强任何MIG定义来解决这个问题，每个字段都有一个可读的名称。除此之外，如果不同类型系统的作者提供了现场或分系统级的详细文件，集成顾问也将其纳入MIG中。

如前所述，在许多情况下，使用这些消息定义的客户可能希望根据个人需要增强和定制这些名称或描述。

在Integration Advisor MIG编辑器中，编辑这些名称或文档非常简单。