Kitchen & Bath edition only allows selection 1 floor for IFC import

IFC import only allows selecting 1 floor for import now when using the Kitchen & Bath edition. Also no floor is initially selected on import. Other editions (CI, MH) still allow importing multifloors for IFC (all floors selected by default).

Easier override of hasRealConfig

In 16.5 Major we introduced MhSnapper.hasRealConfig() to determine if a snapper should own a non-temporary MhConfigRef and is treated as a "config owner" (see 16.5 Major migration guide "Changes to spread tools and dimension propagation"). In 17.0 Major you can now override the logic of this method through the MhConfigBehavior behavior.

public class MhSnapper extends Snapper {

    Old:
    /**
     * Check whether this snapper has config that is not temp.
     */
    extend public bool hasRealConfig() {
        if (config) return !config.temp;
        return false;
    }


    New:
    /**
     * Check whether this snapper has config that is not temp.
     */
    extend public bool hasRealConfig() {
        if (MhConfigBehavior b = configBehavior()) return b.hasRealConfig(this);
        return false;
    }
}


public class MhConfigBehavior extends MhBehavior {

    New:
    /**
     * Return true if this snapper hold a valid config.
     */
    extend public bool hasRealConfig(MhSnapper a) {
        if (MhConfigRef config = a.config) return !config.temp;
        return false;
    }
}

Preconfigurator better support for multiple compartments

Previously the preconfigurator is built mainly to support having the same compartment throughout the entire system. We are now adding additional support to have different compartments within a single bay for the preconfigurator.

To use this new workflow, add the classes MhCompartmentOverviewConfigurationItem and MhCompartmentTypeConfigurationItem to your configuration. They do not work with MhCompartmentConfigurationItem.

Each level/compartment is represent by a MhCompartmentType object in the MhCompartmentOverviewConfigurationItem class. Unique MhCompartmentType objects can be created in the MhCompartmentTypeConfigurationItem class.

Interfaces to override:

public class MhStorageConfiguration extends MhSystemConfiguration {
    extend public str->Object compartmentCreationProps(Class compPropClass) {
}

public class MhCompartmentTypeConfigurationItem extends MhStorageConfigurationItem {
    extend public MhCompartmentType createCompartmentType() {
    extend public str defaultCompartmentTypeName() {
}

public class MhCompartmentType extends CorePropObj {
    extend public SubSet compartmentPropsClassDomain() { }
}

How the snappers get generated is MhStorageConfiguration has a method MhEngineConstructionEntryInfo[] levelCreationInfos() that returns a sequence of infos that each represent a level. This method is used in MhBaySpawner.entryLayout(MhEntryLayoutEnv env) to generate level entries based on those info objects.

public class MhStorageConfiguration extends MhSystemConfiguration {
    extend public MhEngineConstructionEntryInfo[] levelCreationInfos() {
}


public class MhBaySpawner extends MhStorageSpawner {
    public MhEntryLayout entryLayout(MhEntryLayoutEnv env) {
        ...
        MhEngineConstructionEntryInfo[] levelCreationInfos;
        if (?MhStorageConfiguration config = env.configuration) {
            levelCreationInfos = config.levelCreationInfos();
        }
        ...
    }
}

Engine visualiser easier function debug navigation

The engine visualiser now has a new button that will allow you to do one of three actions. You can open the function class in your editor, open the function call location in your editor, or inspect the function object.

class AOElecNode

cm.abstract.office now exposes a small reusable node type for node-based electrical routing. This is the office-side abstraction that the new custom.fika electrical system builds on.

Added: public const symbol cAOElecPathPurpose = #path;
Added: public const symbol cAOElecJumperPurpose = #jumper;
Added: public const symbol cAOElecInternalPurpose = #internal;
Added: public class AOElecNode extends AStarNode

AOElecNode gives implementations a shared node owner/key/position/rotation model while leaving neighbor lookup, path shaping, and routing rules to package-specific subclasses such as custom.fika.office.FOElecNode.

New Ind. Tag hooks for row adjustments and legacy adjustment migration

cm.abstract.part now registers two public hooks to support the new 17.0 Ind. Tag system in Calculations and when loading older drawings.

Added: public void indTagAdjustmentHook(PartRowAdjustmentDialog dialog, PartColumnAdjustment adjustment)
Added: public Part[] fixCET17Adjustments(Part[] list)

New ProdPart import environments

cm.abstract.part.import is a new package in CET 17.0. It adds ProdPart-specific importer environments on top of the shared framework in cm.core.part.import.

Added: public class ProdPartSIFImporterEnv
Added: public class ProdPartPMXImporterEnv
Added: public class ProdPartOFDAImporterEnv

PMX export now writes more project-level information

PMXExporter still lives in cm.abstract.pmx, but in 17.0 it now writes the richer PMX header/project payload exposed from the new shared PMX core layer.

Added effective export usage: public class NotesTable
Added effective export usage: public class OrderInformation
Added effective export usage: public class ShipToInformation
Added effective export usage: public class SoldToInformation

The exporter now initializes those records from ProjectInfo and inserts them through Database before item rows are written.

Stacked unit load.

To support the representation of stacking loads on palletized unit loads, a new class named UnitLoadStackedPallet will be introduced. This class will serve as the new base class for pallet-related functionality. Consequently, all existing pallet classes will be refactored to inherit from UnitLoadStackedPallet instead of their current parent class. This enhancement ensures a consistent and extensible model for managing stack patterns and load behaviors on pallets. This currently only available for certain CET edition.

    Old: public class MhCustomPallet extends UnitLoadPallet
    New: public class MhCustomPallet extends UnitLoadStackedPallet

    Old: public class MhSysPallet extends UnitLoadPallet : abstract
    New: public class MhSysPallet extends UnitLoadStackedPallet : abstract 

class DoFeatureSearchInstruction

Performs a feature search for the given search line and arguments and stores the result on the blackboard.

class ValidateFeatureSearchInstruction

Checks that a feature search result from the blackboard has found the expected feature.

class SetGraphicalSnappingInstruction

Sets the global graphical snapping, for example to 'all', 'basicPoint', 'custom', or a specific feature. By default, all InstructionTestCases set graphical snapping to 'all', allowing snapping to any type of feature.

New package-specific migrator example

custom.fika now includes a concrete 17.0 migrator example for packages with older custom part-special key histories.

Added: public class FikaDsPartSpecialMigrator extends DsPartSpecialMigrator
Added/important usage: PartSpecialMigrator "partSpecialMigrator"