Split and merge project files

To split or merge a project file, use the methods of the IProjectUnitManager object. The IProjectUnitManager object can be obtained using the UnitManager property of the IProject object.

Caution

When you perform split and merge, the changes are saved. Be sure to check the changes before splitting and merging.

Split project files

To split model units from a project file, use the SplitModelUnits method of the IProjectUnitManager object.

public void SplitModelUnits(ICommandContext c, ICommandParams p)
{
    //Get the model selected in the current navigator
    var currentNavigator = c.App.Window.EditorPage.CurrentNavigator;
    var targetModels = currentNavigator.SelectedItems.OfType<IModel>();

    //Split the retrieved model into model units
    IProjectUnitManager unitManager = c.App.Workspace.CurrentProject.UnitManager;
    unitManager.SplitModelUnits(targetModels);< br />
}

To specify the file name of the model unit when splitting, use the SplitModelUnit method of the IProjectUnitManager object.

public void SplitModelUnit(ICommandContext c, ICommandParams p)
{
    //Get the current model selected in the model navigator
    var targetModel = c.App.Workspace.CurrentModel;

    //Split the retrieved model into model units
    IProjectUnitManager unitManager = c.App.Workspace.CurrentProject.UnitManager;

    //Determine the unit file name
    //Here, as an example, we will create an abbreviated file name if the file name is longer than 8 characters
    //You can also specify any file name, such as including the owning model name in the file name
    var unitName = targetModel.Name;
    if (unitName.Length > 8)
    {
        unitName = $"{unitName.Substring(0, 7)}_";
    }

    //Specify the unit file name and split it
    unitManager.SplitModelUnit(targetModel, unitName);< br />
}

Note

When specifying a unit file name, make sure it is unique within the project.

Integrating project files

To integrate model units into a project file, use the UnifyModelUnits method of the IProjectUnitManager object.

public void UnifyModelUnits(ICommandContext c, ICommandParams p)
{
    //Get the models selected in the current navigator
    var currentNavigator = c.App.Window.EditorPage.CurrentNavigator;
    var targetModels = currentNavigator.SelectedItems.OfType<IModel>();

    //Get the model units to which the retrieved models belong
    IEnumerable<IModelUnit> modelUnits = targetModels.Select(model => model.ModelUnit).Distinct();

    //Integrate the retrieved model units into the project file
    IProjectUnitManager unitManager = c.App.Workspace.CurrentProject.UnitManager;
    unitManager.UnifyModelUnits(modelUnits);< br />
}