前页 | 后页 |
MDG_合并
Add-Ins可以使用MDG_Merge共同处理对模型分支和模型分支所连接的代码项目的更改。
每当用户要求将其模型分支与其连接的代码项目合并,或者每当用户建立与代码项目的新连接时,都应调用此事件。
此事件的目的是使Add-In与用户交互,以在模型分支和连接的项目之间执行合并。
句法
功能MDG_Merge(存储库为EA.Repository,PackageGuid作为字符串,SynchObjects作为变量,SynchType作为字符串,ExportObjects作为变量,ExportFiles作为变量,ImportFiles作为变量,IgnoreLocked作为字符串,Language作为字符串)
MDG_Merge函数语法包含这些参数。
参数 |
类型 |
也可以看看 |
---|---|---|
资料库 |
EA仓库 方向:IN 说明:EA.Repository对象,代表当前打开的Enterprise Architect模型。轮询其成员以检索模型数据和用户界面状态信息。 |
储存库类 |
包向导 |
串 方向:IN 说明:GUID标识由Add-In控制的Enterprise Architect Package子树。 |
|
同步对象 |
变体 方向:OUT 说明:一个字符串数组,其中包含要在模型分支和项目之间共同同步的对象列表(对象ID格式)。 有关对象ID的格式 ,请参见对象ID格式 。 |
|
同步类型 |
串 方向:OUT 说明:该值确定要进行的用户选择的同步类型。 有关有效值的列表,请参见同步类型 。 |
|
导出对象 |
变体 方向:OUT 说明:字符串数组,其中包含要由Enterprise Architect导出到代码项目的新模型对象(对象ID格式)的列表。 |
|
导出文件 |
变体 方向:OUT 描述:一个字符串数组,其中包含每个由Add-In选择导出的模型对象的文件列表。 该数组中的每个条目都必须在相同数组索引的ExportObjects参数中具有一个对应的条目,因此ExportFiles(2)必须包含ExportObjects(2)的对象的文件名。 |
|
导入文件 |
变体 方向:OUT 描述:一个字符串数组,其中包含可用于代码项目的代码文件列表,这些代码文件将被新导入到模型中。 Enterprise Architect导入此阵列中列出的每个文件,以导入到连接的模型分支中。 |
|
忽略锁定 |
串 方向:OUT 描述:一个值,该值指示是否忽略代码项目锁定的任何文件(即“ True”或“ False”)。 |
|
语言 |
串 方向:OUT 说明:字符串值,包含连接到模型分支的代码项目支持的代码语言的名称。 |
对象ID格式
“ SynchObjects”字符串数组中列出的每个对象ID均应采用以下格式:
(@namespace)*(#class)*($ attribute |%operation |:property)*
返回值
如果合并操作成功完成,则返回非零值;如果合并操作失败,则返回零值。
合并
合并包括三个主要操作:
- 导出:将新创建的模型对象导出到代码中,并提供给代码项目
- 导入:将新创建的代码对象,类等内容导入模型中
- 同步:模型和代码中可用的对象被联合更新,以反映模型,代码项目或两者中所做的更改
同步类型
同步操作可以通过四种不同方式之一进行。这些方式中的每一个都对应于'SynchType'返回的值:
- 无:(SynchType'= 0)不执行同步
- 转发:('SynchType'= 1)在模型分支和代码项目之间进行转发同步
- 反向:('SynchType = 2)在代码项目和模型分支之间进行反向同步
- 两者:('SynchType'= 3)反向,然后将发生正向同步